Files
zeekayandhanzo-dev a291335081 README: it described a binary that was deleted, and a hanzo its own install line does not give you
Architecture. The headline said "one Go binary ... every subsystem mounted into a
single multi-org process". That binary is gone — it linked every subsystem's
graph into a ~3105-package build and went with `apps.Wire()`. What ships is
`cmd/cloud`, a light host that links zip + manifest + webui and NOTHING else,
with each of 116 subsystems as its own `plugin/<name>` process, started lazily
on the first request that reaches its prefix; 4 (pubsub, kafka, o11y,
catalogsync) own a listener and start with the host. Counted in
manifest/apps.go, which is also the answer to the next defect:
`apps/apps.go:Wire()` was named as "the one ordered list of everything mounted"
and that file does not exist in this repo. `manifest/apps.go` is the list.

The CLI section. Every verb in it is real for `cmd/hanzo` — I read the cobra
tree — but the section sat under a Quick start whose install line is
`curl hanzo.sh | sh`, which installs the RUST CLI, where `login`, `whoami`,
`apps`, `deploy`, `build` and `completion` do not exist and are read as a task
for the coding agent. Two programs answer to `hanzo`; the README now says which
one it is documenting and what the other one does with those words. It also had
the delegation backwards ("the Rust CLI installed alongside as hanzo-node"):
the Rust CLI is the primary `hanzo` on a developer's machine and writes
`hanzo-node` as a symlink to itself; the Go binary is the one that delegates.
Listed the eight verbs the section had omitted (auth, logout, run, agent, bot,
engine, runner, link/unlink, security, version).

Links. Every URL fetched. The HIP-0106 link 404'd and named a document that
does not exist — the real file is hip-0106-hanzo-plugin-contract.md, so the
line "Per HIP-0106" was pointing at a title someone invented. Same for the
Specs list: HIP-0037 is not in hanzoai/HIPs at all, HIP-0129 is "Eval — the
Judgment Plane" not "Open Cloud Planes", HIP-0302 is "Encrypted SQLite
Replication". Every entry now links its real filename and all 8 resolve 200.
`hanzoai/zip` 404s AND is the wrong repo — go.mod imports
github.com/zap-proto/zip v1.18.22, which is public.

Image tag: `:v1.801.206` was 149 builds stale. Any number written here rots, so
the try-it line is `:latest` (manifest 200) with a sentence saying to pin for
anything real.

docs/bring-your-gpu.md printed `hanzo login` with no hint which binary, and
shipped two `—` escapes as literal text.

Co-authored-by: Hanzo Dev <dev@hanzo.ai>
2026-08-01 13:46:36 -07:00
..