schema ls: list only the metas schema show can produce

[thedavidmeister]

Closes #181

The defect

schema ls iterated all 13 KnownMeta variants; schema show matched 4 of
them and answered the other 9 with Error: Unsupported for <name> meta. The
listing under a command group documented "command related to meta json schema"
was a list of known metas, not of the schemas show can produce.

The fix

The two surfaces now share one exhaustive KnownMeta -> Option<RootSchema> map
in cli::schema::json_schema. ls prints the variants it answers Some for;
show errors, with its existing message unchanged, on None. The match has no
wildcard arm, so a KnownMeta variant added later is a compile error in one
place rather than a name ls advertises and show rejects.

schema ls now prints op-v1, solidity-abi-v2, authoring-meta-v1,
interpreter-caller-meta-v1. The full meta enumeration is unchanged and still
available from magic ls.

QA

• Discriminating tests: schema_ls_lists_exactly_what_schema_show_accepts (new, crates/cli/tests/cli.rs) — walks every KnownMeta, asserts schema show <name> succeeds with parseable JSON for each name ls printed and exits non-zero for each name it did not; fails on base, verified by restoring the pre-fix unfiltered ls and running it: panicked at crates/cli/tests/cli.rs:79:13: listed but unsupported: dotrain-v1. schema_ls_prints_metas_that_have_a_schema and test_dispatch_schema_ls are the two pre-existing pinned listings, updated to the 4-name output; both fail on base by construction (base prints 13 lines).
• Mutations applied: ls.rs:5 drop .filter(|meta| super::json_schema(*meta).is_some()) (= restore the pre-fix body) -> killed by schema_ls_lists_exactly_what_schema_show_accepts ("listed but unsupported: dotrain-v1"). ls.rs:5 .is_some() -> .is_none() -> killed by schema_ls_lists_exactly_what_schema_show_accepts ("unlisted but supported: op-v1") and schema_ls_prints_metas_that_have_a_schema. schema.rs:31 KnownMeta::OpV1 => Some(schema_for!(...)) -> KnownMeta::OpV1 => None -> killed by cli::schema::show::tests::test_show_op_v1_schema_compact, test_show_pretty_print and test_show_supported_schemas_are_distinct. No surviving mutant; tree restored and re-verified green after each.
• Oracle: the issue's own intent statement — schema ls is documented "Print all known schemas." under a command group documented "command related to meta json schema", so the set it prints must be the set show produces a schema for. The new test derives its expectation from KnownMeta::iter() and from ls's own stdout at runtime, not from the json_schema match it is testing, so rewiring that match cannot make the test agree with itself. The four-name pinned lists come from the four schema_for! arms that existed before this change; no schema was added or removed.
• Category check: issue asks for one thing with two named remedies — align ls with show, or reword the help to "known metas". Covered by the first: ls is filtered, so the existing help text "Print all known schemas." is now true and needs no reword. The user-facing enumeration of all 13 metas is not lost; magic ls still prints every one.

Verification

Green locally: cargo test -p rain-metadata --test cli --test cli_dispatch -- schema (7 passed), cargo test -p rain-metadata --lib cli::schema (38 passed), cargo clippy -p rain-metadata --all-targets clean, cargo fmt --check --all clean. The full suite was not run locally.

🤖 Generated with Claude Code

[coderabbitai]

Warning

Review limit reached

Next included review available in 34 minutes.

View limit details

Limit details: You’ve used the included review currently available.

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

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 5923ecda-2f11-4df8-8a95-51c6c59d00e2

📥 Commits

Reviewing files that changed from the base of the PR and between 45ca96c and 09e81c4.

📒 Files selected for processing (5)

• crates/cli/src/cli/schema.rs
• crates/cli/src/cli/schema/ls.rs
• crates/cli/src/cli/schema/show.rs
• crates/cli/tests/cli.rs
• crates/cli/tests/cli_dispatch.rs

---

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.}