CLI Reference Generation

The CLI reference page at /cli is auto-generated, never hand-edited. It combines two data sources:

SPORT F02 (.claude/docs/sport/F02-COMMAND-INVENTORY.md) : the single source of truth for every top-level command name, subcommand list, and short description.
CLI wiki pages (cli/.github/wiki/cmd-*.md) - extended per-command documentation. When a wiki page exists, its first paragraph is used as the command description.

Running the generator

node scripts/gen-cli-ref.mjs

This writes src/app/cli/page.tsx. The file is committed to the repo so the build does not need SPORT access at build time on Vercel.

The generator also runs automatically as part of the prebuild script:

pnpm --filter web-docs prebuild

When to re-run

After any CLI command is added, renamed, or removed.
After SPORT F02 is regenerated.
After a wiki page for a command is created or updated.

Diff test

CI runs a diff test that checks the generated page matches what would be produced by running the generator against current SPORT. If the generated file is out of date, the CI build fails with a drift error.

# Local check
node scripts/gen-cli-ref.mjs
git diff --exit-code src/app/cli/page.tsx

Plugin reference generation

The plugin catalog at /plugins is generated by the same pattern from SPORT F03 (free) and F04 (pro):

node scripts/gen-plugin-index.mjs

Writes src/app/plugins/page.tsx.

SPORT is read-only

Never edit SPORT files directly. They are code-verified snapshots. To update the CLI reference, update the CLI code and re-run the SPORT generator, then re-run the docs generator.