[jdx]

https://entire.io/gh/jdx/mise/trails/875

The [env] and [vars] parts of schema/mise.json are now generated from declaration types in mise-config, instead of 490 lines of hand-written JSON beside the parser. Nothing changes for users: I compared the old and new schema/mise.json and schema/mise-task.json structurally and they are identical.

[env] accepts a plain value or a table that says what the value is (value, default, required, or an age-encrypted value), plus an _ table of modules (file, path, python, source). The parser reads these with visitors, which a derive can't describe, so the schema comes from types next to it. For example, a variable with an encrypted value:

/// [experimental] age-encrypted environment variable
Age(EnvAgeTable),

where the doc comment is the description editors show on hover.

What changes for maintainers

• crates/mise-config/src/env/decl.rs holds the types: one per table shape for [env] and [vars] (they differ: [vars] values are strings, integers or true, and a variable may carry a prompt), the _ modules, and the small shared definitions such as env_value and env_required.
• Nothing parses into them. The parser still reads the options of a variable into EnvDirectiveOptions, so a new test checks that the option keys the types declare (tools, redact, required, expand, find_up, prompt) are exactly that struct's fields. I checked that it fails when a key is declared that the parser does not read.
• The schema generator closes every typed object with additionalProperties: false, but several [env] shapes deliberately leave their other keys open. A new x-mise-open marker tells it to skip such an object, and it is removed from the output.
• AGENTS.md says where to change these.

Validation

• Structural comparison of the old and new schema/mise.json and schema/mise-task.json: no differences. schema/miserc.json is unchanged.
• cargo +1.95 clippy --workspace --all-features --all-targets -- -D warnings
• cargo test -p mise-config (schema_files_are_up_to_date and the new test) and cargo test -p mise --lib schema_matches_parser
• mise run test:e2e config/test_schema_ajv config/test_schema_tombi config/test_config_unknown_key env/test_env_default env/test_env_file env/test_env_path env/test_env_dotenv

Stacked on #14669.

AI-assisted — Tool: Claude Code; model: anthropic/claude-sonnet-5-5; version: 2.1.299.

🤖 Generated with Claude Code

---

Note

Low Risk
Schema-generation refactor only; parsing and runtime env behavior are untouched, with conformance tests and structural schema parity checks.

Overview
Refactors how schema/mise.json describes [env] and [vars] — no user-facing config behavior change; the regenerated schema is structurally equivalent to the hand-written version.

The ~490-line hand-written env/schema.rs is removed. [env] / [vars] JSON Schema is now derived from new Env* / Vars* types in crates/mise-config/src/env/decl.rs (doc comments become editor descriptions). The TOML parser is unchanged and still uses custom visitors in env.rs; the decl types only document accepted shapes.

Maintainability: schema.rs emits env, vars, and related $defs via fragment::<…> like other derived sections, instead of chaining hand-written defs. A unit test asserts declaration option keys match EnvDirectiveOptions so schema and parser stay aligned. x-mise-open on a few object shapes prevents the global reject_unknown_keys transform from incorrectly closing tables that must allow extra keys (e.g. env._.path / directives). AGENTS.md documents the new workflow.

^{Reviewed by Cursor Bugbot for commit 8a89911. Bugbot is set up for automated code reviews on this repo. Configure here.}

[coderabbitai]

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 15 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used all 10 included reviews currently available.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

• Configuration used: Repository YAML (base), Central YAML (inherited), Organization UI (inherited)
• Review profile: CHILL
• Plan: Advanced
• Run ID: 4f2618d7-8a9d-473c-b3ed-4a818aec0d76

📥 Commits

Reviewing files that changed from the base of the PR and between bc8e8e2 and 8a89911.

📒 Files selected for processing: 7

• AGENTS.md
• crates/mise-config/src/env.rs
• crates/mise-config/src/env/decl.rs
• crates/mise-config/src/env/schema.rs
• crates/mise-config/src/schema.rs
• schema/mise-task.json
• schema/mise.json

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[greptile-apps]

Confidence Score: 5/5

[Low impact] The PR appears safe to merge.

Summary

Moves the [env] and [vars] schemas from hand-written JSON into Rust declaration types.

• The [env] and [vars] schemas now come from declaration types.

No actionable issues found. Tests were not run during this review.

_{Reviews (1) · Last reviewed commit: "refactor(schema): generate the [env] and..." · Reviewed by Greptile}

[github-actions]

Instruction counts

The comparison never ran — an earlier step failed.

_{8a89911d86f1 vs `` · measured on the runner, not pushed to the history.}