control-kody

1---2name: control-kody3description: >4  Drive and verify the Kody app with a Feature Map and one CLI. Use when5  changing UI, account routes, preview deploys, or proving a Cloud Agent change6  with a real origin, session, and /health SHA.7---8 9# control-kody10 11Do not invent a throwaway curl script, scrape PR comments by hand, or rediscover12account routes from `routes.ts`. Use the CLI and the Feature Map.13 14```bash15node tools/control-kody.ts doctor16node tools/control-kody.ts dev17node tools/control-kody.ts login18node tools/control-kody.ts request GET /account/waiting.json19node tools/control-kody.ts map waiting20node tools/control-kody.ts health --sha <merge-sha>21node tools/control-kody.ts preview -- --request 'GET /account/waiting.json' --check /account/waiting22node tools/control-kody.ts package-create --origin <preview> --package-name <leaf-or-@scope/leaf> [--head-ahead]23```24 25`--kody-id` is an alias for `--package-name`.26`npm run control-kody -- <command>` is the same entry.27 28## Feature Map29 30[references/features/README.md](./references/features/README.md) is the31human-readable index. `tools/control-kody/feature-catalog.ts` is the32machine-readable source. `map --check` (and its node test) fail when a listed33path leaves `routes.ts` or a required HTML route has no entry.34 35Load **one** feature file for the surface you are changing.36 37## Seed users38 39- Local: `jane@example.com` / `ilikecode` (non-admin)40- Preview: `me@kentcdodds.com` / `ilikecode` (non-admin, empty until you create41  data through JSON APIs, or `package-create` for a saved package)42- `/admin` 403 and `/mcp` 401 are expected for those seeds43 44## Proof45 46CI green is not enough for a user-visible account change. Prefer:47 481. `doctor` then `dev` or `preview`492. `request` / `--check` as the seed user **with data for this change**503. A computerUse video or screenshot of the same page514. After merge, `health --origin https://kody.codes --sha <merge>` (full SHA,52   unique short SHA, or a later descendant HEAD that contains the merge)53 54See55[docs/contributing/control-kody.md](../../../docs/contributing/control-kody.md)56and [preview-manual-test](../preview-manual-test/SKILL.md).57