seatmesh 1.2.3 → 1.2.5

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/notify.md

@@ -12,7 +12,7 @@ notify link|url|open "<title>" --url <https> [--check "…"]
     link-only   notify link "Staging" --url http://127.0.0.1:5080
                 → toast Open button → URL (no Info card). Same: notify "…" "…" --url
     Info only   notify info "Brief" --body "## Why\n\n…" [--url https://mdview.io/s/…]
-                → local /act/card. [--url] = Open button on card.
+                → hub /act/card (:3190). [--url] = Open button on card.
                   Bare https:// in body also autolinks. [label](url) works.
                 Mermaid → local Info card renders ```mermaid (mermaid.js). Optional: preview (mdview.io) then --url share.
     Info+Yes/No notify yesno "Ship?" "Need your call" --body "## Diff\n…" [--url https://…]

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/init/AGENTS.md

@@ -57,7 +57,7 @@ Ship A — matches brand." \
 | Shape | Command | Operator gets |
 |-------|---------|---------------|
 | Eyes | `notify "<session>" "<check>" [--url]` | Toast (+ link) |
-| Info | `notify info\|md "<title>" --md\|--body …` | Toast + `/act/card` markdown |
+| Info | `notify info\|md "<title>" --md\|--body …` | Toast + hub `/act/card` (`:3190`) |
 | Decide | `notify yesno "<title>" "<blurb>" --md\|--body …` | Toast **Info · Yes · No**; Yes/No peer to `--target` |
 
 **yesno:** `<title>` = decision name · `<blurb>` = short toast line · Info content via `--md` / `--body` (not the blurb alone).
@@ -93,17 +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`)
+## OpenCode via CPE (`opencode-cpe` kind)
 
-**Proxied OpenCode** — not bare `opencode`. Type **`oc-proxy`** only (`oc` / `opencode` = direct, no CPE script).
+**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
+# mesh.config.yaml — engine already emits opencode-cpe extends opencode;
+# overlay only if you diverge:
 agents:
-  runners:
-    oc-proxy: scripts/opencode-cpe.sh
+  kinds:
+    opencode-cpe:
+      launch: { command: scripts/opencode-cpe.sh }
+  # legacy also works:
+  # runners:
+  #   opencode-cpe: scripts/opencode-cpe.sh
 connectivity:
   driver: cpe
   proxyPort: 18887
@@ -111,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`
 
@@ -121,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)
 ```
@@ -134,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)
 

package/templates/init/README.md

@@ -1,24 +1,24 @@
 # .sm — seatmesh project config
 
-Generated by `npx seatmesh init`. The engine reads **only** files here (+ live
+Generated by `sm init` (or `npx seatmesh init`). The engine reads **only** files here (+ live
 `mesh-agents.json` state).
 
 | Path | Purpose |
 |------|---------|
 | `mesh.config.yaml` | Layout, daemon, connectivity, seat paths |
 | `mesh-agents.json` | Live CLI type + resume per slot |
-| `roles/_vendor/` | **LOCKED** role-pack (yaml + docs) — `seatmesh update` |
+| `roles/_vendor/` | **LOCKED** role-pack (yaml + docs) — `sm update` |
 | `roles/*.extend.yaml` | **USER** project POV — never overwritten |
 | `runtime/` | Daemon jsonl state (inbox, checkback) |
 
 **Seat files** (FOCUS/TASKS/REMINDER) live under `seats.root` in yaml — not deleted
-by init; `./sm.sh seat init` creates missing files only.
+by init; `sm seat init` creates missing files only.
 
 ```bash
-npx seatmesh init
-npx seatmesh roles status
-npx seatmesh roles migrate          # up to current role-pack
-npx seatmesh update                 # refresh _vendor + auto-migrate pack
+sm init
+sm roles status
+sm roles migrate          # up to current role-pack
+sm update                 # refresh _vendor + auto-migrate pack
 ```
 
 See `roles/_vendor/docs/EXTEND.md` for locked sections.

package/templates/init/mesh.config.yaml

@@ -52,13 +52,12 @@ providers:
   - cursor-agent
   - claude
   - opencode
-  - oc-proxy
   - empty
 
-# CPE OpenCode: layout.base.cli.<seat>: oc-proxy + this runner
+# CPE = kind opencode-cpe (extends opencode), not a providers[] entry
 agents:
   runners:
-    oc-proxy: scripts/opencode-cpe.sh
+    opencode-cpe: scripts/opencode-cpe.sh
 
 seats:
   root: {{seatsRoot}}