seatmesh 1.2.4 → 1.3.0

package/dist/setup/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/setup/install.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/setup/install.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seatmesh",
-  "version": "1.2.4",
+  "version": "1.3.0",
   "engines": {
     "node": ">=22"
   },
@@ -26,13 +26,14 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.8.0",
-    "@seat-mesh/connectivity": "file:../connectivity",
-    "@seat-mesh/core": "file:../core",
-    "@seat-mesh/daemon": "file:../daemon",
-    "@seat-mesh/providers": "file:../providers",
-    "@seat-mesh/tmux": "file:../tmux",
+    "@seat-mesh/connectivity": "^1.3.0",
+    "@seat-mesh/core": "^1.3.0",
+    "@seat-mesh/daemon": "^1.3.0",
+    "@seat-mesh/providers": "^1.3.0",
+    "@seat-mesh/tmux": "^1.3.0",
     "boxen": "^8.0.1",
     "cfonts": "^3.3.1",
-    "commander": "^15.0.0"
+    "commander": "^15.0.0",
+    "yaml": "^2.7.0"
   }
 }

package/profiles/minimal/mesh.config.yaml

@@ -16,6 +16,7 @@ state:
 daemon:
   port: 31671
   portScope: workspace
+  autoRevive: false
   managerPromptPrefix: "[agent-manager]"
 
 ports:

package/templates/cursor/rules/seatmesh-agent.mdc

@@ -0,0 +1,40 @@
+---
+description: Seatmesh pane agent — whoami every turn, enqueue-only mesh CLI
+alwaysApply: true
+---
+
+# Seatmesh agent (always on)
+
+Engine-owned mesh CLI. Do not invent alternate CLIs.
+
+## Every turn
+
+```bash
+sm agent whoami
+sm agent          # can / cannot for THIS pane
+```
+
+Default config is workspace `.sm/` (walk-up). Run work only via `sm agent <cmd> …`.
+
+## Hard rules
+
+- Enqueue only — never raw `tmux send-keys` for mesh mail.
+- `[mesh-inbox]` / DIGEST = daemon steering, not a new human task.
+- Chat prose does **not** clear ACK or cancel checkback — use `ack` / `cb cancel`.
+- Inject copy = mesh-copy consts. Never paste `patterns.md` into a pane.
+- Operator eyes / decide → `agent notify` (not chat for a toast).
+- NO CONFIRM — act; chat is a status line after action.
+
+## Vocal (pane CLIs)
+
+| Need | Command |
+|------|---------|
+| Empty shell → agent | `spawn <target> <cli>` |
+| Replace live agent | `switch <target> <cli>` |
+| Resume configured | `launch <target>` |
+| Rebuild engine + labels | `rebuild` (alias: `reload` — not “reload config”) |
+
+## Dig deeper
+
+- Skill: `seatmesh-agent` · notify: `seatmesh-notify`
+- Canonical brief: `.sm/AGENTS.md`

package/templates/docs/RELEASE.md

@@ -1,10 +1,12 @@
 # npm release schedule
 
-**Gate:** `seatmesh@1.2.0` cutover — Adonis hub on `:3190` is the operator console; daemon `/act/card` + `/ui` proxy to hub. See [NOW.md](../NOW.md).
-
 | Date (Asia/Manila) | Package | Notes |
 |--------------------|---------|--------|
-| **2026-09-15** | `seatmesh@1.2.0` | Operator hub cutover: Adonis 7 + Nuxt UI; act/card hub proxy; SessionChrome; mobile drawer; agent forum/golf; contract simplify; LAN/QR; terminals preview-first |
+| **2026-09-18** | `seatmesh@1.2.5` | CLI declares `yaml` dep — fixes npx/global `ERR_MODULE_NOT_FOUND` on merge-mesh-config |
+| **2026-09-17** | `seatmesh@1.2.4` | Open agent kinds (`kindBase`/`extends`); opencode-cpe extends opencode; prove/satisfy/recovery; act/card hub; wave OC relaunch; Orca credit CONTINUE; cross-mesh inbox restart |
+| **2026-09-17** | `seatmesh@1.2.3` | Republish after connectivity@1.2.2 npm staging E409; same surface as 1.2.2 |
+| **2026-09-17** | `seatmesh@1.2.2` | `npx seatmesh web up\|down\|restart\|status`; `agent mds hosted\|agent-self\|agent <kind>`; hub `/mds` live; OC-V2 supervisor health rescue + oc-credit CONTINUE |
+| **2026-09-16** | `seatmesh@1.2.0` | opencode-cpe CliType + runners; `sm pane resume`; OC-LIMIT `scripts/oc-reset.sh` + daemon relaunch; todo-check remaining TASKS DIGEST bulk; `sm web status\|open\|url`; `config upgrade` (npm i -g first); human help + patterns modular `docs/patterns/` |
 | **2026-09-15** | `seatmesh@1.1.5` | Notify Info/Yes/No native buttons; local Info cards GFM+Mermaid (zoom/pan/expand); session check/repair; CB workspace scope; policy config; agent help/COMMANDS |
 | **2026-09-15** | `seatmesh@1.1.4` | Early-adopter UX: `start` idempotent create-or-attach; `session down`; manager terminal welcome (whoami/switch); `sessions` documented |
 | **2026-09-15** | `seatmesh@1.1.3` | Cursor/Claude respawn prove: agent --trust; composer-ready verify+retry (OC parity); fresh whoami on success expected |
@@ -29,4 +31,8 @@ Skip check: `SEATMESH_SKIP_VERSION_CHECK=1`.
 
 Publish: `bash scripts/publish-npm.sh` from repo root (after `npm login`).
 
+**GitHub Releases:** yes — notes in `docs/releases/vX.Y.Z.md` + row in this file.
+Create/update: `bash scripts/gh-release.sh 1.2.0` (needs `gh auth login`).
+Optional: `bash scripts/gh-release.sh 1.2.0 --publish` (npm then release).
+
 Inbox blips (2026-09-13 prove): daemon `/health` flaps and `checkback ack` 404 while inbox is up (cancel still works). Drain can wedge on `peer_unsent` if coord holds are not backlogged. Not a ship blocker after `seatmesh@1.0.0`; cancel orphan checkbacks instead of retrying ack.

package/templates/docs/cli/README.md

@@ -1,22 +1,120 @@
-# seatmesh CLI verbs (one md each)
+# seatmesh CLI — by job
 
-Greppable per-command docs. Generated from `packages/cli/src/commands/help-text.ts`.
+Not an A–Z API list. One command per need. Grep stubs when you know the name.
 
 ```bash
-ls docs/cli | rg peer
-rg -n . docs/cli/peer.md
-rg -n "^## " docs/COMMANDS.md
-seatmesh help peer
+seatmesh help <verb>
+rg "^## peer$" docs/COMMANDS.md
 ```
 
-Full catalog: [../COMMANDS.md](../COMMANDS.md)
+Full dump (last resort): [../COMMANDS.md](../COMMANDS.md)
+
+---
+
+## Agent (`sm agent …`)
+
+### Identity & map
+
+| Verb | File |
+|------|------|
+| `agent` | [agent.md](agent.md) |
+| `whoami` | [whoami.md](whoami.md) |
+| `contexts` | [contexts.md](contexts.md) |
+| `hub` | [hub.md](hub.md) |
+| `kind` | [kind.md](kind.md) |
+| `peek` | [peek.md](peek.md) |
+| `ppa` | [ppa.md](ppa.md) |
+
+### Work
+
+| Verb | File |
+|------|------|
+| `todo` | [todo.md](todo.md) |
+| `seat` | [seat.md](seat.md) |
+| `assign` | [assign.md](assign.md) — prefer `todo give` |
+
+### Comms (inject)
+
+| Verb | File |
+|------|------|
+| `peer` | [peer.md](peer.md) — prefer this |
+| `ack` | [ack.md](ack.md) |
+| `cb` | [cb.md](cb.md) |
+| `room` | [room.md](room.md) |
+| `notify` | [notify.md](notify.md) |
+| `remote` | [remote.md](remote.md) |
+| `sessions` | [sessions.md](sessions.md) |
+| `reply` | [reply.md](reply.md) |
+
+### Read (not inject)
+
+| Verb | File |
+|------|------|
+| `chat` | [chat.md](chat.md) |
+| `mds` | [mds.md](mds.md) |
+| `preview` | [preview.md](preview.md) |
+| `read-history` | [read-history.md](read-history.md) — prefer `hub chat` |
+
+### Shorthands → collapse to `peer` / `todo`
+
+| Verb | Prefer |
+|------|--------|
+| [ask](ask.md) · [msg](msg.md) · [tell](tell.md) | `peer` |
+| [ackmsg](ackmsg.md) | `peer --ack` |
+| [prompt](prompt.md) | `peer` |
+| [to-slot](to-slot.md) · [to-mini](to-mini.md) | `peer slot-N` / `peer mini-N` |
+| [to-master](to-master.md) | DEPRECATED — `room` / chat |
+
+---
+
+## Operator (outside `agent`)
+
+| Verb | File |
+|------|------|
+| `human` | [human.md](human.md) — cheat sheet |
+| `session` | [session.md](session.md) |
+| `layout` | [layout.md](layout.md) |
+| `spawn` | [spawn.md](spawn.md) — empty→CLI |
+| `switch` | [switch.md](switch.md) — replace live |
+| `launch` | [launch.md](launch.md) |
+| `pane` | [pane.md](pane.md) |
+| `save` · `auto` | [save.md](save.md) · [auto.md](auto.md) |
+| `reload` · `rebuild` · `verify` · `realign` | [reload.md](reload.md) · [rebuild.md](rebuild.md) · [verify.md](verify.md) · [realign.md](realign.md) |
+| `inbox` | [inbox.md](inbox.md) |
+| `web` | [web.md](web.md) |
+| `contract` | [contract.md](contract.md) |
+| `balance` | [balance.md](balance.md) |
+| `init` · `update` | [init.md](init.md) · [update.md](update.md) |
+| `config` · `providers` | [config.md](config.md) · [providers.md](providers.md) |
+| `target` | [target.md](target.md) |
+
+### Occasional / niche
+
+| Verb | File |
+|------|------|
+| `mini` · `secretary` | [mini.md](mini.md) · [secretary.md](secretary.md) |
+| `base` · `stack` · `labels` | [base.md](base.md) · [stack.md](stack.md) · [labels.md](labels.md) |
+| `set` · `tag` · `swap` · `title` | [set.md](set.md) · [tag.md](tag.md) · [swap.md](swap.md) · [title.md](title.md) |
+| `ops` · `limit` · `proxy` | [ops.md](ops.md) · [limit.md](limit.md) · [proxy.md](proxy.md) |
+| `night` · `continue` · `flush` · `remind` | [night.md](night.md) · [continue.md](continue.md) · [flush.md](flush.md) · [remind.md](remind.md) |
+| `slot-advice` | [slot-advice.md](slot-advice.md) |
+| `cold-start` · `completion` · `migrate-runtime` | [cold-start.md](cold-start.md) · [completion.md](completion.md) · [migrate-runtime.md](migrate-runtime.md) |
+| `func` · `profile` · `roles` · `report` · `status` · `start` · `test` · `version` · `help` · `index` · `pane-meta` | see files |
+
+---
+
+## A–Z (grep only)
+
+When you already know the name — do not browse this as the guide.
+
+<details>
+<summary>All stubs</summary>
 
 | Verb | File |
 |------|------|
 | `ack` | [ack.md](ack.md) |
 | `ackmsg` | [ackmsg.md](ackmsg.md) |
 | `agent` | [agent.md](agent.md) |
-| `apply` | [apply.md](apply.md) |
 | `ask` | [ask.md](ask.md) |
 | `assign` | [assign.md](assign.md) |
 | `auto` | [auto.md](auto.md) |
@@ -31,9 +129,7 @@ Full catalog: [../COMMANDS.md](../COMMANDS.md)
 | `continue` | [continue.md](continue.md) |
 | `contract` | [contract.md](contract.md) |
 | `flush` | [flush.md](flush.md) |
-| `forum` | [forum.md](forum.md) |
 | `func` | [func.md](func.md) |
-| `golf` | [golf.md](golf.md) |
 | `help` | [help.md](help.md) |
 | `hub` | [hub.md](hub.md) |
 | `human` | [human.md](human.md) |
@@ -45,11 +141,13 @@ Full catalog: [../COMMANDS.md](../COMMANDS.md)
 | `launch` | [launch.md](launch.md) |
 | `layout` | [layout.md](layout.md) |
 | `limit` | [limit.md](limit.md) |
+| `mds` | [mds.md](mds.md) |
 | `migrate-runtime` | [migrate-runtime.md](migrate-runtime.md) |
 | `mini` | [mini.md](mini.md) |
 | `night` | [night.md](night.md) |
 | `notify` | [notify.md](notify.md) |
 | `ops` | [ops.md](ops.md) |
+| `pane` | [pane.md](pane.md) |
 | `pane-meta` | [pane-meta.md](pane-meta.md) |
 | `peek` | [peek.md](peek.md) |
 | `peer` | [peer.md](peer.md) |
@@ -68,7 +166,6 @@ Full catalog: [../COMMANDS.md](../COMMANDS.md)
 | `report` | [report.md](report.md) |
 | `roles` | [roles.md](roles.md) |
 | `room` | [room.md](room.md) |
-| `run` | [run.md](run.md) |
 | `save` | [save.md](save.md) |
 | `seat` | [seat.md](seat.md) |
 | `secretary` | [secretary.md](secretary.md) |
@@ -92,5 +189,7 @@ Full catalog: [../COMMANDS.md](../COMMANDS.md)
 | `update` | [update.md](update.md) |
 | `verify` | [verify.md](verify.md) |
 | `version` | [version.md](version.md) |
+| `web` | [web.md](web.md) |
 | `whoami` | [whoami.md](whoami.md) |
 
+</details>

package/templates/docs/cli/chat.md

@@ -2,9 +2,10 @@
 
 ```text
 chat tail [--slot key] [--lines N] [--json]
-  chat query […] — history of prompt/response CHAT.jsonl (read-only ledger)
-  Not a live group chat. Live A2A = room say/tail · peer ask/msg
-  append|record = engine/session writers — agents rarely need these
+  chat query [--slot|--session|--model|--since|--limit] [--json]
+  chat put <slot> "<human>" [--response "<text>"]  (positional upsert, dedupe by turnHash)
+  chat get <id> [--slot key] [--json]  (id or turnHash, full or 8-char prefix)
+  chat append|record  — per-slot prompt/response CHAT.jsonl
 ```
 
 - CLI: `seatmesh chat --help`

package/templates/docs/cli/contract.md

@@ -1,25 +1,25 @@
 # seatmesh contract
 
 ```text
-contract [status|on|off|open]
-  Simple harness locks — one path for agents (prefer over apply / raw supervise).
+contract [status]
+  contract show <id>
+  contract on|off <id> [--agent <seat>]
+  contract create|open <slug>
+```
 
-  status                 show supervise/balance ON|OFF
-  on [supervise|balance] arm lock + room + tick (default: supervise)
-  off [supervise|balance]
-  open <slug> --scope "…"   named room (CLAIMED/DONE) — not a lock
+Easy locks under `.sm/contracts/`:
 
-  Examples:
-    seatmesh agent contract
-    seatmesh agent contract on
-    seatmesh agent contract on balance
-    seatmesh agent contract off
-    seatmesh agent contract open slice-a --scope "landing CTA"
+| Command | Effect |
+|---------|--------|
+| `contract` / `status` | Vendor contracts + ON/off |
+| `show <id>` | Merged `_vendor` + extend yaml |
+| `on <id>` | Arm lock (agent defaults from yaml) |
+| `off <id>` | Disarm |
+| `create <slug>` | Ad-hoc contract **room** (not vendor) |
 
-  Day-to-day work: todo give / peer / room — contracts optional.
-  (agent apply … still works for power users; prefer contract on/off.)
-```
+Defaults: `supervise` → `supervisor` (secretary); `balance` → `balance_lead`.
 
 - CLI: `seatmesh contract --help`
 - Agent: `seatmesh agent help contract`
 - Catalog: [../COMMANDS.md#contract](../COMMANDS.md#contract)
+- Hub: `/mds/…/contracts-easy`

package/templates/docs/cli/host.md

@@ -0,0 +1,12 @@
+# seatmesh host
+
+```text
+host up|down|status
+  Opt-in single host-supervisor: one process watches all meshes registered in
+  ~/.config/seatmesh/sessions.json instead of each spawning its own supervisor.
+  Does not affect meshes that haven't opted in (Phase 1, see NOW.md).
+```
+
+- CLI: `seatmesh host --help`
+- Agent: `seatmesh agent help host`
+- Catalog: [../COMMANDS.md#host](../COMMANDS.md#host)

package/templates/docs/cli/human.md

@@ -3,13 +3,17 @@
 ```text
 human — put an agent CLI on a pane (operator)
 
-  Empty terminal → agent:
-    switch <target> <opencode|claude|agent|kiro>
+  Empty terminal → agent (prefer spawn):
+    spawn <target> <opencode|opencode-cpe|claude|agent|kiro>
     Examples:
-      seatmesh switch slot-1 opencode
-      seatmesh switch secretary claude
-      seatmesh switch here agent          # this pane (Cursor)
-      npx seatmesh switch mini-1 opencode
+      seatmesh spawn slot-1 opencode
+      seatmesh spawn secretary opencode-cpe --keep-resume
+      seatmesh spawn here agent          # this pane (Cursor)
+      seatmesh spawn mini-1 opencode-cpe --keep-resume
+
+  Replace a live agent with another CLI:
+    switch <target> <opencode|opencode-cpe|claude|agent|kiro> [reason...]
+    Alias: handoff
 
   Back to plain shell:
     switch <target> empty
@@ -17,15 +21,19 @@ human — put an agent CLI on a pane (operator)
   Start/resume the seat's configured CLI (no type pick):
     launch <target|all|manager|secretary>
 
+  Resume known session on a pane (autodetect ses_* / resume id):
+    pane resume [here|secretary|slot-N|…]
+
   Check agent vs shell:
     kind <target>     # aliases: what | typeof
 
-  Give the seat WORK / a todo (does NOT install a CLI — different from switch):
+  Give the seat WORK / a todo (does NOT install a CLI — different from spawn/switch):
     todo give <target> "do the thing"     # preferred
     todo <target> "do the thing"          # shorthand
     assign <target> "do the thing"        # same engine
 
   Targets: manager | secretary | slot-N | mini-N | here
+  Operator help: seatmesh help (human) · seatmesh --agents help (full)
   Aliases for this topic: help put-agent | help panes | help operator
 ```
 

package/templates/docs/cli/kind.md

@@ -1,8 +1,10 @@
 # seatmesh kind
 
 ```text
-kind <target>
-  Agent CLI vs plain terminal. Aliases: what, typeof
+kind <target>  |  kind list  |  kind show <id>
+  <target>: agent CLI vs plain terminal (aliases: what, typeof)
+  list/show: dump resolved agent kinds (provider kindBase ⋂ agents.kinds overlay
+  ⋂ runners shim, extends flattened) — DX for custom-profile kinds
 ```
 
 - CLI: `seatmesh kind --help`

package/templates/docs/cli/nav.md

@@ -0,0 +1,12 @@
+# seatmesh nav
+
+```text
+nav log [-n N] [--json]
+  nav summary [-n N] [--json]
+  Navigation history — recent `peek <target>` events (which panes/seats you've
+  looked at). log = chronological, summary = grouped by target, most-recent first.
+```
+
+- CLI: `seatmesh nav --help`
+- Agent: `seatmesh agent help nav`
+- Catalog: [../COMMANDS.md#nav](../COMMANDS.md#nav)

package/templates/docs/cli/{oc-proxy.md → opencode-cpe.md}

@@ -1,14 +1,14 @@
-# sm oc-proxy
+# sm opencode-cpe
 
 ```text
 OpenCode via CPE proxy — spawn / relaunch any seat
 
-  sm switch <target> oc-proxy [--keep-resume|--fresh] [--queue]
+  sm switch <target> opencode-cpe [--keep-resume|--fresh] [--queue]
   sm launch minis | launch secretary | launch <slot-N>
 
   <target> = secretary | manager | mini-N | slot-N | here
 
-  oc-proxy  ≠  oc / opencode  (direct, no CPE script)
+  opencode-cpe  ≠  oc / opencode  (direct, no CPE script)
 ```
 
 ## Config (once)
@@ -16,7 +16,7 @@ OpenCode via CPE proxy — spawn / relaunch any seat
 ```yaml
 agents:
   runners:
-    oc-proxy: scripts/opencode-cpe.sh
+    opencode-cpe: scripts/opencode-cpe.sh
 connectivity:
   driver: cpe
   proxyPort: 18887
@@ -24,17 +24,17 @@ connectivity:
 
 | Default for… | Where |
 |--------------|--------|
-| Base columns | `layout.base.cli.<id>: oc-proxy` |
-| Minis / workers | `.sm/mesh-agents.json` → `conventions.miniDefaultCli: oc-proxy` |
+| Base columns | `layout.base.cli.<id>: opencode-cpe` |
+| Minis / workers | `.sm/mesh-agents.json` → `conventions.miniDefaultCli: opencode-cpe` |
 
 `sm config check`
 
 ## Examples
 
 ```bash
-sm switch secretary oc-proxy --keep-resume
-sm switch mini-3 oc-proxy --keep-resume
-sm launch minis                    # after miniDefaultCli = oc-proxy
+sm switch secretary opencode-cpe --keep-resume
+sm switch mini-3 opencode-cpe --keep-resume
+sm launch minis                    # after miniDefaultCli = opencode-cpe
 env -u TMUX_PANE sm switch …       # from plain shell (stale TMUX_PANE)
 ```
 
@@ -42,7 +42,7 @@ env -u TMUX_PANE sm switch …       # from plain shell (stale TMUX_PANE)
 
 Esc×3 → composer idle → `sm agent whoami`. Full relaunch only if needed: `--fresh`.
 
-All oc-proxy panes stuck / need CONTINUE without typing it: `./scripts/oc-proxy-atomics.sh`
+All opencode-cpe panes stuck / need CONTINUE without typing it: `./scripts/opencode-cpe-atomics.sh`
 (record → kill CPE OC → revive → CONTINUE across pia/zsign/seatmesh).
 
 - CLI: `sm switch --help` · `sm launch --help`

package/templates/docs/cli/rebuild.md

@@ -0,0 +1,3 @@
+# seatmesh rebuild
+
+Alias of [reload](reload.md) — preferred vocal (engine rebuild, not “reload config”).

package/templates/docs/cli/reload.md

@@ -1,10 +1,13 @@
-# seatmesh reload
+# seatmesh reload / rebuild
 
 ```text
-reload [--layout]
-  Rebuild engine + labels (no session kill). --layout re-grids
+reload|rebuild [--layout]
+  Rebuild seatmesh packages (npm build) + refresh labels/borders/inbox.
+  Does NOT re-read config into live agents / does NOT replace pane CLIs
+  (that is spawn/switch/coordSync). --layout re-grids (disruptive).
+  Prefer vocal: rebuild
 ```
 
-- CLI: `seatmesh reload --help`
-- Agent: `seatmesh agent help reload`
+- CLI: `seatmesh rebuild --help` · `seatmesh reload --help`
+- Agent: `seatmesh agent help rebuild`
 - Catalog: [../COMMANDS.md#reload](../COMMANDS.md#reload)

package/templates/docs/cli/room.md

@@ -1,13 +1,11 @@
 # seatmesh room
 
 ```text
-room tail [-r slug] [-n N] | room say [-r slug] "<msg>"
-  Modern path: say/tail (+ contract open <slug> for named ledgers).
-  Prefer CLAIMED|DONE|FYI|STATUS lines over room call/accept (legacy A2A dial).
-  Also: room broadcast <msg> | room read | room create <slug>
-  Legacy: room call|accept|decline|pending (workers) — prefer peer ask/msg instead
-  Global default; -r managers|supervise
-  broadcast/say fan-out = daemon queue (POST /room-fanout)
+room tail [-r slug] [-n N] [--truncate N] [--json] | room get <id> [--json]
+  room say [-r slug] "<msg>"  (same sender+body within ~20s is deduped, not re-sent)
+  room broadcast <msg> | room read | room call|accept …
+  A2A ledger. Global default; -r managers|supervise
+  broadcast/say fan-out = daemon queue (POST /room-fanout) — not direct-inject storm
 ```
 
 - CLI: `seatmesh room --help`

package/templates/docs/cli/schedule.md

@@ -0,0 +1,13 @@
+# seatmesh schedule
+
+```text
+schedule <target> "<msg...>" --at <time>
+  Delayed one-shot peer — queues now, held out of drain until --at passes
+  (ISO time or relative duration: 10m, 2h, 1d). Fire-and-forget: no ACK
+  tracking opens until it's actually delivered.
+  Examples: schedule secretary "EOD digest" --at 6h · schedule slot-2 "follow up" --at 2026-09-20T09:00:00Z
+```
+
+- CLI: `seatmesh schedule --help`
+- Agent: `seatmesh agent help schedule`
+- Catalog: [../COMMANDS.md#schedule](../COMMANDS.md#schedule)

package/templates/docs/cli/secretary.md

@@ -1,7 +1,7 @@
 # seatmesh secretary
 
 ```text
-secretary start|status|digest|restart
+secretary start|stop|status|digest|restart
   secretary supervise on [10m]|run|off
   secretary switch <cli> [--keep-resume]
   Lead supervise path (secretary→manager)

package/templates/docs/cli/spawn.md

@@ -0,0 +1,13 @@
+# seatmesh spawn
+
+```text
+spawn <target> <agent|claude|opencode|kiro> [flags]
+  Empty shell → agent CLI (preferred vocal). Same engine as switch.
+  Replace live agent: switch. Resume configured: launch. See: help human
+  Examples: spawn slot-1 opencode · spawn here agent · spawn secretary opencode-cpe --keep-resume
+```
+
+- CLI: `seatmesh spawn --help`
+- Agent: `seatmesh agent help spawn`
+- Catalog: [../COMMANDS.md#spawn](../COMMANDS.md#spawn)
+- Related: [switch.md](switch.md) · [human.md](human.md) · [launch.md](launch.md)

package/templates/docs/cli/switch.md

@@ -2,13 +2,13 @@
 
 ```text
 switch <target> <agent|claude|opencode|kiro|empty> [flags] [reason...]
-  HUMAN: empty terminal → agent CLI (or empty = back to shell).
-  Alias: handoff. See: seatmesh help human
-  Examples: switch slot-1 opencode · switch here claude · switch mini-2 empty
+  Replace a LIVE agent CLI (or → empty shell). Empty pane → prefer spawn.
+  Alias: handoff. Empty→CLI alias: spawn. See: seatmesh help human
+  Examples: switch slot-1 claude · switch here agent · switch mini-2 empty
   Flags: --keep-resume --resume ID --queue
 ```
 
 - CLI: `seatmesh switch --help`
 - Agent: `seatmesh agent help switch`
 - Catalog: [../COMMANDS.md#switch](../COMMANDS.md#switch)
-- Aliases: `cc`, `handoff`
+- Related: [spawn.md](spawn.md) · [human.md](human.md)

package/templates/init/AGENTS.md

@@ -93,23 +93,23 @@ Aliases: `notify info` · `notify md` · `notify details`
 
 Lead-only extras (manager/secretary) appear on your `agent` card — spawn/assign/inbox restart are not universal.
 
-## OpenCode via CPE (`oc-proxy` kind)
+## OpenCode via CPE (`opencode-cpe` kind)
 
-**Kind** `oc-proxy` **extends** `opencode` — same inject provider, CPE launch wrapper.
+**Kind** `opencode-cpe` **extends** `opencode` — same inject provider, CPE launch wrapper.
 Not bare `opencode` (`oc` / `opencode` = direct).
 
 ### Config (once per mesh)
 
 ```yaml
-# mesh.config.yaml — engine already emits oc-proxy extends opencode;
+# mesh.config.yaml — engine already emits opencode-cpe extends opencode;
 # overlay only if you diverge:
 agents:
   kinds:
-    oc-proxy:
+    opencode-cpe:
       launch: { command: scripts/opencode-cpe.sh }
   # legacy also works:
   # runners:
-  #   oc-proxy: scripts/opencode-cpe.sh
+  #   opencode-cpe: scripts/opencode-cpe.sh
 connectivity:
   driver: cpe
   proxyPort: 18887
@@ -117,8 +117,8 @@ connectivity:
 
 | Default for… | Where |
 |--------------|--------|
-| Base columns (manager, secretary, …) | `layout.base.cli.<column-id>: oc-proxy` |
-| Minis / workers (launch default) | `.sm/mesh-agents.json` → `conventions.miniDefaultCli: oc-proxy` |
+| Base columns (manager, secretary, …) | `layout.base.cli.<column-id>: opencode-cpe` |
+| Minis / workers (launch default) | `.sm/mesh-agents.json` → `conventions.miniDefaultCli: opencode-cpe` |
 
 Validate: `sm config check`
 
@@ -127,8 +127,8 @@ Validate: `sm config check`
 **One path for every seat** — secretary, manager, `mini-N`, `slot-N`:
 
 ```bash
-sm switch <target> oc-proxy --keep-resume   # keep saved session
-sm switch <target> oc-proxy --fresh          # new session
+sm switch <target> opencode-cpe --keep-resume   # keep saved session
+sm switch <target> opencode-cpe --fresh          # new session
 sm launch minis                              # all minis (after miniDefaultCli set)
 sm launch secretary                          # coord (uses layout.base.cli)
 ```
@@ -140,7 +140,7 @@ Queue (inbox drains): add `--queue`.
 ### Stuck mid-build (`esc interrupt` / Build bar)
 
 **Do not** full pane restart. **Esc×3** → wait for composer idle → `sm agent whoami` or inbox cold-start.  
-Full relaunch only when you need a new session: `sm switch <target> oc-proxy --fresh`.
+Full relaunch only when you need a new session: `sm switch <target> opencode-cpe --fresh`.
 
 ## Outside `agent` (operator / shared)