feat(kernel): ✨ Improve environment schema validation

[haskou]

Summary

• Add typed environment schema choices with runtime validation and literal TypeScript inference.
• Document environment schema metadata and adapter-specific install/import paths.
• Keep coverage focused on runtime kernel files instead of excluding all src/kernel.
• Narrow Kernel type imports to concrete adapter base classes instead of adapter barrels.

Validation

• yarn typecheck
• yarn lint
• yarn build
• yarn test:coverage
• yarn docs:build
• yarn format:check
• yarn --cwd example typecheck

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a740a0c43a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Bind choices to the declared variable type

When a schema is passed through KernelEnvironmentSchema/new Kernel, TType defaults to the full union, so choices?: TChoices accepts any KernelEnvironmentValue[] rather than choices that match the entry's type. For example, { HTTP_PORT: { type: 'number', choices: ['3000'] } } type-checks, but the runtime parses HTTP_PORT=3000 to the number 3000 and then includes compares it with the string choice, so validation always throws for that config. Please correlate choices with KernelEnvironmentVariablePrimitive<TType> so invalid schemas are rejected at compile time.

Useful? React with 👍 / 👎.

[haskou]

Replaced by the breaking-change branch and PR because the kernel registration contract changes are intentionally breaking.