Skip to content

docs(README): fix unmatched commands in Identity & billing and Cloud blocks - #15

Merged
zeekay merged 1 commit into
hanzoai:mainfrom
immoney1:fix-readme-identity-cloud-commands
Oct 28, 2026
Merged

zeekay merged 1 commit into
hanzoai:mainfrom
immoney1:fix-readme-identity-cloud-commands

Conversation

@immoney1

Copy link
Copy Markdown
Contributor

Fixes #11

Every command in the two fenced blocks (Identity & billing, Cloud) now resolves to a real subcommand — verified against a build of this repo's main (965a056).

Replacements

README line (was) Why it failed Now
hanzo connector add|list|verify|rm --provider cloudflare no connector product; --provider is not a flag on the real ops hanzo provider connect|verify|disconnect <provider> + hanzo connection list|rm [id]
hanzo billing balance | deposit no deposit under billing hanzo billing balance | topup (topup create charges a saved card and credits the balance)
hanzo agents run <agent> product is agent (singular) hanzo agent run <ref>
hanzo clusters create|list|pools|rm no top-level clusters hanzo compute clusters create|list|rm + hanzo compute clusters pools create|rm|scale
hanzo cloud list|accounts no cloud product hanzo compute fleet get (every unit you bring: BYO machines + clusters, DO/AWS/GCP kubeconfigs)
graph doc link docs.hanzo.ai/docs/services/graph → 404 docs.hanzo.ai/docs/openapi/graph → 200

Acceptance

  1. All 24 command sequences in the two blocks: hanzo <words> --help → exit 0, that command's own help, never the root Usage: hanzo [OPTIONS] [TASK] page (scripted against target/debug/hanzo built from this branch).
  2. Documented flags as written also pass: auth login --provider/--token/-/--account/--choose, auth logout [identity] [--all], auth use [owner/name], up [--link <cluster>].
  3. No line in either block falls through to the task launcher (every first word exists).
  4. Graph link returns HTTP 200.
  5. cargo test: 394 unit + 28 integration tests pass; spec_drift's 2 failures (genproduct / driftgate NotFound) pre-exist on clean main — reproduced identically with the change stashed (this PR is docs-only).

Line numbers cited in the issue are +14 off current main (README gained lines since 5ce6db4); the same four commands are at 134–135 / 154–156 now.

…blocks

- connector line: no 'connector' product exists -> real ops are
  'provider connect|verify|disconnect <provider>' and 'connection list|rm [id]'
  (also drops the nonexistent --provider flag on those ops)
- billing 'deposit' does not exist -> 'billing topup' (topup create credits the balance)
- 'agents run' -> 'agent run <ref>' (product is 'agent')
- 'clusters ...' -> 'compute clusters create|list|rm' + pools create|rm|scale
- 'cloud list|accounts' -> 'compute fleet get' (BYO machines + clusters, DO/AWS/GCP)
- graph docs link: /docs/services/graph 404s -> /docs/openapi/graph (200)

Verified against a build of main: all 24 command sequences in both blocks
return exit 0 with the command's own help (never the root usage page),
and no line falls through to the task launcher. cargo test unaffected
(docs-only; spec_drift's 2 failures pre-exist on clean main).
@zeekay
zeekay merged commit 1902384 into hanzoai:main Oct 28, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Fix README commands that match no hanzo subcommand

2 participants