strengthen repo verification and runtime coverage

Add clearer app docs plus targeted desktop, CLI, web, and worker tests so cross-surface regressions are caught earlier and the repo is easier to navigate.

apps/cli/README.md

@@ -0,0 +1,45 @@
+# Rowboat CLI And Local Runtime
+
+`apps/cli` contains the npm-distributed `@rowboatlabs/rowboatx` package and the local HTTP runtime used by the newer frontend.
+
+## What Lives Here
+
+- Hono server for runs, messages, permissions, and SSE streaming
+- Model and MCP configuration repositories under `~/.rowboat`
+- Workflow import and export helpers
+- Packaged CLI entrypoint in `bin/app.js`
+
+## Local Development
+
+Install and build:
+
+```bash
+npm install
+npm run verify
+```
+
+Run the local server:
+
+```bash
+npm run server
+```
+
+## Key Commands
+
+- `npm run build` - compile TypeScript into `dist/`
+- `npm run lint` - run CLI lint checks
+- `npm run typecheck` - run TypeScript checks without emitting
+- `npm run server` - start the local Hono runtime
+- `npm run verify` - run lint, typecheck, and tests together
+- `npm run migrate-agents` - run bundled agent migration script
+
+## Data Location
+
+The CLI/runtime stores configuration and runtime state in `~/.rowboat` by default.
+
+## Related Surfaces
+
+- `apps/rowboatx` provides the newer frontend that talks to this runtime
+- `apps/x` has its own local-first desktop runtime and is the primary desktop product
+
+See the root `ARCHITECTURE.md` for the repo-level map.