The published getting-started path documents several commands that don't exist or aren't wired up, so a new user following only the README cannot reach a working setup. Surfaced by our dogfooding agent installing 0.5.4 on a clean box and following the docs verbatim.
Documented but not implemented
tps agent create <id> — README quickstart step (README line ~34) and command reference (~198). Falls back to top-level help. This is the first action in the quickstart, so a new user is stuck at step 2.tps mail topic create / tps mail subscribe / tps mail publish (~119–121, 205–206). mail supports only send/check/watch/list/read/ack/nack/gc/search/log.tps flair status, tps soul show, tps memory list, tps memory write (~140–143, 208–210). All fall back to help.
Undocumented prerequisites
nono: every command emits two warnings about missing nono / nono profiles. --nonono suppresses them but is undocumented — a new user has to reverse-engineer it from the warning text. Docs should either state nono is a prereq (and how to install) or make the warnings quieter/opt-in.TPS_VAULT_KEY: tps identity init fails with "TPS_VAULT_KEY environment variable is required to unlock the identity vault." Not mentioned in the getting-started docs.
Ask
Either implement the documented commands or correct the docs to match the shipped surface, and document the nono / TPS_VAULT_KEY prerequisites. The quickstart should be walkable end-to-end by copy-paste.
Filed from an automated dogfood run (clean-box install of 0.5.4, docs-only path).
The published getting-started path documents several commands that don't exist or aren't wired up, so a new user following only the README cannot reach a working setup. Surfaced by our dogfooding agent installing 0.5.4 on a clean box and following the docs verbatim.
Documented but not implemented
tps agent create <id>— README quickstart step (README line ~34) and command reference (~198). Falls back to top-level help. This is the first action in the quickstart, so a new user is stuck at step 2.tps mail topic create/tps mail subscribe/tps mail publish(~119–121, 205–206).mailsupports onlysend/check/watch/list/read/ack/nack/gc/search/log.tps flair status,tps soul show,tps memory list,tps memory write(~140–143, 208–210). All fall back to help.Undocumented prerequisites
nono: every command emits two warnings about missingnono/ nono profiles.--nononosuppresses them but is undocumented — a new user has to reverse-engineer it from the warning text. Docs should either statenonois a prereq (and how to install) or make the warnings quieter/opt-in.TPS_VAULT_KEY:tps identity initfails with "TPS_VAULT_KEY environment variable is required to unlock the identity vault." Not mentioned in the getting-started docs.Ask
Either implement the documented commands or correct the docs to match the shipped surface, and document the
nono/TPS_VAULT_KEYprerequisites. The quickstart should be walkable end-to-end by copy-paste.Filed from an automated dogfood run (clean-box install of 0.5.4, docs-only path).