docs: sync README with source of truth (#3026)

* docs: sync README commands table with help.ts source of truth

remove 5 command rows from the README commands table that are not present
in packages/cli/src/commands/help.ts getHelpUsageSection():
- spawn list --flat
- spawn list --json
- spawn tree
- spawn tree --json
- spawn history export

these commands exist in code (index.ts, list.ts) but are not listed in the
canonical help section, which is the Gate 2 source of truth per qa/record-keeper
protocol.

* fix: restore documentation for working commands (spawn tree, list --flat, --json, history export)

Agent: pr-maintainer
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix: add 5 missing commands to help.ts getHelpUsageSection()

Add spawn tree, spawn tree --json, spawn list --flat, spawn list --json,
and spawn history export to the help text. These commands are implemented
in the codebase but were missing from --help output.

Addresses reviewer feedback to add commands to help.ts source of truth
rather than removing them from README.

Bump version 0.26.6 -> 0.26.7

Agent: pr-maintainer
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

---------

Co-authored-by: spawn-qa-bot <qa@openrouter.ai>
Co-authored-by: B <6723574+louisgv@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
A 2026-03-26 16:13:44 -07:00 committed by GitHub
parent aafdb8655f
commit a7b1596b98
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -27,6 +27,8 @@ function getHelpUsageSection(): string {
spawn list <filter> Filter history by agent or cloud name
spawn list -a <agent> Filter spawn history by agent (or --agent)
spawn list -c <cloud> Filter spawn history by cloud (or --cloud)
spawn list --flat Show flat list (disable tree view)
spawn list --json Output history as JSON
spawn list --clear Clear all spawn history
spawn delete Delete a previously spawned server (aliases: rm, destroy, kill)
spawn delete -a <agent> Filter servers by agent
@ -45,6 +47,9 @@ function getHelpUsageSection(): string {
spawn matrix Full availability matrix (alias: m)
spawn agents List all agents with descriptions
spawn clouds List all cloud providers
spawn tree Show recursive spawn tree (parent/child relationships)
spawn tree --json Output spawn tree as JSON
spawn history export Dump history as JSON to stdout
spawn feedback "message" Send feedback to the Spawn team
spawn uninstall Uninstall spawn CLI and optionally remove data
spawn update Check for CLI updates