A command the CLI-surface document never names is invisible to every prose guard

What is wrong¶

Every guard over docir's own prose asks the same question: does a line the text carries resolve? cli_oracle introspects the live command tree and checks each docir ... span against it, across six surfaces.

A command the prose never mentions carries no line. It is invisible to all of them.

Measured¶

Doc-Index CLI — the CLI surface states its job in its first sentence — "Every command below exists in docir --help" — and its table had 34 rows, every one of which resolved. Compared against the tree in the other direction it was missing doctor, daemon status and daemon stop. doctor has an ADR of its own and is the command an adopter runs when something is wrong.

Found by reading the document against its code, not by a guard, during the code-changed pass. Nothing would have found it otherwise: a table cannot be checked for what is not in it by looking at what is.

What would fix it¶

Assert the reverse — every command in the tree appears in the document whose stated job is the CLI surface — and make the document claim both directions rather than one.

Hidden commands are exempt. daemon serve is how the client respawns the daemon, not something a reader should ever type, so demanding it be documented would be demanding the wrong thing. That needs the oracle to know which commands are hidden, which it did not.