🤖 Generated by the Daily AI Engineer
Problem
docs/gen_docs.go walks c.Commands() without checking Hidden, so the generated docs/src/content/docs/cli-flags/ tree ships pages for commands that are deliberately kept out of --help and the MCP/toolgen surface: deprecated flat delegates (project add-environment, project list-environments, cluster add-environment), experimental-gated commands, and internal entrypoints (steer-agent). Docs advertising names we are actively retiring (or that refuse to run without --experimental) undercuts the deprecation/gating story. Observed repeatedly (632nd-run note; flagged again by review on #6059).
Proposed direction
Skip Hidden commands in gen_docs by default — or, if some hidden pages are wanted (e.g. experimental commands documented as opt-in), add an explicit allowlist/annotation so each hidden page is a deliberate choice rather than a fallthrough. Regenerate and prune orphaned pages in the same PR; verify Starlight's autogenerated sidebar/index no longer lists retired names.
Rough size
S — one condition in the walker + an annotation if the allowlist route is chosen, plus a regen and snapshot pass.
Problem
docs/gen_docs.gowalksc.Commands()without checkingHidden, so the generateddocs/src/content/docs/cli-flags/tree ships pages for commands that are deliberately kept out of--helpand the MCP/toolgen surface: deprecated flat delegates (project add-environment,project list-environments,cluster add-environment), experimental-gated commands, and internal entrypoints (steer-agent). Docs advertising names we are actively retiring (or that refuse to run without--experimental) undercuts the deprecation/gating story. Observed repeatedly (632nd-run note; flagged again by review on #6059).Proposed direction
Skip
Hiddencommands in gen_docs by default — or, if some hidden pages are wanted (e.g. experimental commands documented as opt-in), add an explicit allowlist/annotation so each hidden page is a deliberate choice rather than a fallthrough. Regenerate and prune orphaned pages in the same PR; verify Starlight's autogenerated sidebar/index no longer lists retired names.Rough size
S — one condition in the walker + an annotation if the allowlist route is chosen, plus a regen and snapshot pass.