fix: every pointer to --spec is complete and runnable

[Max17190]

Why

Round-7 contract audit (F4, F7), both reproduced on a built binary. --spec settings exists and is load-bearing: every --check settings row ends with (openmax --spec settings) and --spec providers cross-references it. But --help listed ten surfaces without it, so a model confirming the spelling concluded the surface does not exist. Separately, the misplaced-file warning said see openmax --spec for where each surface lives, and bare --spec is a parse error that dumps the full help block into context.

Summary

• --help lists all eleven surfaces; help_names_every_spec_surface iterates spec::SURFACES against the --spec option block (scoped, since "settings" also appears in unrelated help prose), so surface twelve cannot repeat this.
• The frozen prompt's pointer stays a deliberate subset (it pays per byte; settings/recall/usage carry their own pointers at the moments that need them). the_guide_pointer_names_only_real_surfaces enforces both directions: every pointed surface exists, and the omission list is exactly {settings, recall, usage}, so a new surface must consciously join one list. The test comment that falsely claimed the pointer "names every surface" is corrected.
• The misplaced-file warning names a runnable command: run openmax --spec tools (or skills, prompts, hooks, permissions, memory). Its two sibling warnings already name exact target paths; this was the one row answering "where does this live?" with "go look it up".

Test Plan

• help_names_every_spec_surface: red with settings removed from the list (verified; the first unscoped version stayed green off unrelated prose, so the assertion is scoped to the option block).
• misplaced_files_are_reported_instead_of_looking_healthy extended to require openmax --spec tools in the warning: red against the old text (verified).
• the_guide_pointer_names_only_real_surfaces: tripwires surface twelve.
• Full workspace green (exit 0), clippy zero warnings.

Greptile Summary

The --spec help text now lists settings, diagnostics point to runnable surface-specific commands, and regression tests preserve the intended surface lists.

Confidence Score: 5/5

No blocking failure remains.

Runtime validation confirmed that the help enumeration matches the accepted spec surfaces and that openmax --spec settings successfully renders the Settings contract. The earlier test-order and help-list parsing concerns are fixed in the current code.

T-Rex Logs

What T-Rex did

• Built the current openmax binary and verified that the help surface list matches the spec surfaces.
• Ran the openmax --spec settings command and confirmed it exited successfully and rendered the Settings contract.
• Executed the focused test help_names_every_spec_surface and it passed.
• Identified where the surface list is published, dispatched, and where the source contract is defined in the codebase.

_{Ran code and verified through T-Rex}

_{Reviews (3): Last reviewed commit: "Merge remote-tracking branch 'origin/mai..." | Re-trigger Greptile}