@staix/agent-hub 0.12.38 → 0.12.40

package/docs/verification/2026-10-20-0.12.39.md

@@ -0,0 +1,55 @@
+# 0.12.39 release verification
+
+This record covers release preparation and source review. It does not claim publication, installation, a running-hub restart or native/live acceptance.
+
+## Candidate
+
+Version 0.12.39, control protocol 16 (unchanged; the daemon adds the `native_tui_launch` feature), from merged main `f9df83d6`. The person directed the release on 2026-10-20 ("finish the open PRs and release the next version").
+
+- #464 (PR #557, hub task #246): `ahub jcode` opens jcode's native TUI by default, attached to the hub-driven ACP session.
+  - The console-only `native_tui_launch` hands the launch tuple only to the person's launcher, after a bounded read-only proof that the session is saved.
+  - The launcher waits with one fixed line and opens the TUI once the session is saved; Ctrl-C ends only the wait.
+  - Start mode resolves from the flag, then the accepted daemon mode, then file/default; `--mode headless` is unchanged.
+  - J1.4 is amended: jcode 0.98.1 saves a session only after its first real prompt.
+- #542 D4 (PR #547, hub task #245): an announced ACP tool call that has not completed or failed keeps the turn alive up to a 30 min tool ceiling (never below `watchdog_ms`). The watchdog re-arms only for the remaining ceiling.
+- #548 (PR #552, hub task #247): the MLX test fixtures take a free loopback port.
+- Still open (unchanged from 0.12.38): live native clients, installed managed-Pi #418 AC8 (#142), #438 AC7, the native console settings leg (#439 AC5), real upgrades with reattach (#463) and with a managed terminal and cancelled rows (#478), a live fresh Codex review with a real account, a live split of a real memory home (#536), the agy live TUI/account leg (#251), and Kimi's interactive-TUI coexistence and usage checks (#533).
+- New open legs:
+  - Jcode's TUI with a personal account, a real provider and hub-tool calls (#464). The receipt covers only an isolated HOME with a loopback fixture provider (docs/verification/2026-10-20-jcode-tui-0.98.1.md).
+  - A live Jcode tool call held past the inactivity watchdog (#542); only fake-ACP tests cover it.
+- Follow-ups: #559 (review nits of #557), #558 (macOS `runCheck` hang), #555 (agy native reads into Facts).
+
+## Reviews
+
+| PR | Final head | Review | CI |
+| --- | --- | --- | --- |
+| #552 (#548) | 28e37cf2 | codex approved hub task #247 | exact head, success |
+| #557 (#464) | 7c0475c3 | planner: full-diff read-only review of 26 paths, no Important findings; affected tests run by the planner (43 pass; the one failure only reproduces under macOS's symlinked default TMPDIR, follow-up #559 N6); nits in #559 | exact head, success on Ubuntu and macOS with all four seeded shards |
+| #547 (#542 D4) | 26ad11cb | round 1 changes requested by codex, fixed at 36015a76; codex re-review approved with no findings (109 ACP and daemon tests pass) | exact head, success; macOS passed on a rerun of the failed job after the unrelated #558 hang |
+
+## Document review
+
+Eleven documents were stale against the 0.12.38 stamps (`adf2d5fd`). Two fresh-context reviewers read them against the three PRs above, one the person-facing documents and the other the agent notes, and applied their own corrections. The planner spot-checked the claims against the code.
+
+| Document | Result | Checked claims and correction |
+| --- | --- | --- |
+| `README.md` | corrected | Status 0.12.39 (protocol 16 unchanged); the Jcode TUI default and how to keep headless (#464); the verification link; open legs add Jcode's live TUI with a real account and a live tool call held past the watchdog. |
+| `docs/quickstart.md` | corrected | Install pin `v0.12.39`; "Upgrading to 0.12.39": restart Claude sessions; `ahub jcode` opens the TUI after the first hub turn saves the session; hub-made starts open a terminal; how to keep headless. The 0.12.38 notes are kept for upgrades from 0.12.37 or earlier. |
+| `docs/operations.md` | corrected | Version line and upgrade commands 0.12.39 (protocol-16 range through 0.12.39); `hub_peer_start` includes Jcode; `peers.jcode.start_mode` in the settings and start-mode tables; the ACP tool-ceiling paragraph (#542). |
+| `docs/security.md` | corrected | `JCODE_NO_TELEMETRY` covers probe, serve, ACP and TUI (#559 N5); start words with `--mode tui` for Pi, Kimi and Jcode; Jcode was headless-only before 0.12.39. |
+| `docs/agent-notes/adapters.md` | corrected | New ACP tool-ceiling rule (re-arm for the remaining ceiling, reset per delivery, private-turn log latch); the Jcode TUI rule: saved-session proof only through `savedSession`, option drift refused, the tuple only to a person's launcher, previews resolve nothing, no synthesized save or prompt. |
+| `docs/agent-notes/daemon.md` | corrected | New `native_tui_launch` rule (console-only, refusals, binding, the tuple only in the console reply, feature-gated); a TUI start of an owned-ACP peer opens a terminal even while ACP is online. |
+| `docs/agent-notes/benchmarks.md` | corrected | The driver's Qwen `AcpPeer` now runs a silent open tool call to the ACP tool ceiling, which counts as a changed study condition. |
+| `docs/agent-notes/tests.md` | corrected | Fixtures that need a port take it from a free-port probe, never a fixed number (#548). |
+| `docs/agent-notes/budget.md` | no change | The changed paths touch no quota, pause or context rule. |
+| `docs/agent-notes/bus.md` | no change | Delivery, digest and steer code is unchanged; the Jcode TUI is not a pull-only peer. |
+| `docs/agent-notes/tasks.md` | no change | The changes are launch and preview only, with no task, board, routing or reviewer logic. |
+| `docs/agent-notes/README.md` | no change | Stale only because `daemon.md`, a tracked path, changed; its content is unaffected. |
+
+Found during the review, not changed here: `test/local-worker.test.ts` still derives Sidecar ports from the PID (removed with the sidecar under #553); older tests call `realpathSync` on temp dirs (`test/liveness.test.ts`, `test/peer-stop.test.ts`, `test/conflicts.test.ts`); `ahub upgrade` announces no Jcode default change, as it does for Kimi.
+
+## Checks
+
+- Each merged PR's exact-head CI passed (table above). The release branch is main `f9df83d6` plus the version, release notes and document corrections. The bundle is rebuilt with the pinned Bun 1.4.2 under host admission and is fresh; `tsc` is clean.
+- The stale stamps are restamped to the release commit `09d85684` (reviewed against main `f9df83d6`; the release commit adds only the version, notes and documents); `node scripts/check-docs.mjs --require-fresh` reports 0 stale documents and runs again on the merged main before the tag.
+- Exact-head CI on the release PR.

package/docs/verification/2026-10-20-0.12.40.md

@@ -0,0 +1,63 @@
+# 0.12.40 release verification
+
+This record covers release preparation and source review. It does not claim publication, installation, a running-hub restart or native/live acceptance.
+
+## Candidate
+
+Version 0.12.40, control protocol 16 (unchanged; the daemon adds the `terminal_owner` and `cli_audit_delegated` features), from merged main. The person directed a bug-fix release on 2026-10-20 ("find the bug-fix issues, assign and implement them; include every bug fix in this release", then "finish and merge every PR, then release").
+
+- Delivery and tasks: held task offers settle once the recipient owns and accepted the task (#434, PR #578); capacity-only declines are not lasting exclusions and planner-pull refusals name the cause (#531, PR #580); overlap findings stay within one repository, with `refs.repo` on propose and accept (#476, PR #583); Pi and the local worker report a hop-capped reply as not delivered (#550, PR #582).
+- Recovery and launch: terminal records bind the live native owner and connected orphaned panes get reattach guidance (#482, PR #573); the Jcode TUI launcher records no managed terminal (#564, PR #565); `--print-command` names a mismatched session option (#574, PR #577); Jcode TUI review follow-ups (#559, PR #568).
+- Jcode operations (#572, PR #575): a busy Jcode takes an `important` message into its running turn over its own socket (the hub never cancels a turn), an advisory when the main checkout is on a branch, an `ahub init` line that ends the turn after `hub_task_done`, and doctor lists the extra MCP servers the owned Jcode loads.
+- Runtime: the completion-check runner settles within a 1 s kill grace when a killed child's events never arrive, and ignores a late exit or a retained stop after settling (#558, PR #581); Claude's turn completion is found beyond the 4 MiB tail (#528, PR #566); a reconnect re-announces a changed tool list (#490, PR #569); delegated CLI audits need the daemon feature `cli_audit_delegated` (#410, PR #571); stale-launch Claude channel plugins are refused (#551, PR #560).
+- Config and models: the `pet` block is accepted by the schema and live reload (#483, PR #567); doctor names routing parse errors (#563, PR #570); the Switchyard sidecar is retired for in-process routes (#553, PR #561); `ahub memory profile-check` is split-aware (#536, PR #579).
+- Still open (unchanged from 0.12.39): live native clients, installed managed-Pi #418 AC8, #438 AC7, the native console settings leg (#439 AC5), real upgrades with reattach (#463) and with a managed terminal and cancelled rows (#478), a live fresh Codex review, a live split of a real memory home, the agy live TUI/account leg (#251), Kimi's interactive-TUI coexistence and usage checks (#533), Jcode's TUI with a personal account (#464) and a live Jcode tool call past the watchdog (#542).
+- New open legs: a live steer of a busy Jcode turn with a real provider (#572; fakes only) and a real upgrade that exercises the `terminal_owner` record (#482).
+- Not in this release: #576 (the daemon runs hot under open turns; profile first, hub task #263), #584 (a manager test can leak a process on Ubuntu CI), #434 T3 (live check).
+
+## Reviews
+
+| PR | Final head | Review | CI |
+| --- | --- | --- | --- |
+| #578 (#434) | b1c4071e | planner approved at c03f79a7; the head adds only a main merge (CHANGELOG) | exact head, success |
+| #573 (#482) | 1ff026c2 | planner: round 1 changes requested (synchronous `ps` per tick), approved at cc4ec070; the head adds a main merge (CHANGELOG, `DAEMON_FEATURES` union, bundle rebuilt) | exact head, success |
+| #575 (#572) | 8a93ebd3 | codex: changes requested twice, approved at 359b0ad2; the head adds a main merge (CHANGELOG, bundle rebuilt) | exact head, success |
+| #579 (#536) | 8215437b | codex approved at bd9b50be; the head adds a main merge (CHANGELOG) | exact head, success |
+| #581 (#558) | 743c191a | codex approved; its finding (late exit or retained stop after settlement) fixed red-first at 743c191a; 200 macOS reruns: 1200 pass, 0 fail | exact head, success |
+| #580 (#531) | 995bf1b2 | planner: changes requested (spec sentence, CHANGELOG placement), approved at a1ec66e4; the head adds a bundle rebuilt with the pinned Bun | exact head, success |
+| #582 (#550) | 8249813e | planner approved at 3a2b33d7 (5 focused tests run); the head adds a main merge (import line) | exact head, success |
+| #583 (#476) | 0e03675a | planner approved at d910d661 (19 focused tests run); the head adds a main merge (import union, bundle rebuilt) and a seed whose search text followed the changed line | exact head, success |
+| #577 (#574), #571 (#410), #570 (#563), #569 (#490), #568 (#559), #567 (#483), #566 (#528), #565 (#564), #561 (#553), #560 (#551) | merged before this train | reviewed and merged earlier on 2026-10-20 | exact head, success |
+
+## Document review
+
+Fifteen documents were stale against the 0.12.39 stamps (`09d85684`), including `src/cli/help.ts`, newly registered so that the release review checks the `ahub help` text against the commands. Three fresh-context reviewers read them against the PRs above: one the person-facing documents, one the agent notes and one the help text. Each applied its own corrections, and the planner spot-checked the claims against the code.
+
+| Document | Result | Checked claims and correction |
+| --- | --- | --- |
+| `README.md` | corrected | Status 0.12.40 (protocol 16); repository-scoped overlap (#476); the 0.12.39 Jcode TUI stop fixed (#564); delegated live-test commands need `cli_audit_delegated` (#410); open legs add the busy-Jcode steer (#572) and a real upgrade with `terminal_owner` (#482). |
+| `docs/quickstart.md` | corrected | Install pin `v0.12.40`; "Upgrading to 0.12.40" (plugin restart, Jcode fixes, Switchyard retirement, re-run `ahub init` for the new block line, capacity declines, `refs.repo`, hop-cap result, the two daemon features); the local worker routes through `hub/stage` with `fixed_model` as the fallback. |
+| `docs/operations.md` | corrected | Version and upgrade commands 0.12.40; capacity declines are not lasting and planner-pull refusals name the cause (#531); repository-scoped overlap (#476); the 1 s kill grace (#558); the main-checkout advisory (#572); tool-list re-announce (#490); the `routing.toml` defaults `ahub init` writes; doctor's routing parse-error row (#563); `--print-command` names a mismatched option (#574). |
+| `docs/security.md` | corrected | The Jcode busy steer is a soft interrupt over the private socket, never a cancel, with an uncertain steer held as `needs_review`; the owned Jcode loads the MCP servers in its four config files (doctor shows names only); `refs.repo` is metadata and grants no access. |
+| `src/cli/help.ts` | corrected | Added `ahub pet --palette`, `--as <instance>` for instance kinds, `ahub memory decay` and `ahub memory profile-check`; added missing flags (`pi --model`, `agy [args...]`, `settings get --json`, `task label --created`, `review --head`, `bench --json`, and `--json`, `--verbose`, `--color` on `upgrade` and `restart`). `test/help.test.ts`: 18 pass. |
+| `docs/agent-notes/adapters.md` | corrected | The Jcode steer and MCP-set rules (#575); `JcodeOptionMismatch` names only the flag (#568, #577); the Jcode TUI is never a managed terminal (#565); `terminalOwner(launchId)` for Codex and Pi (#573). |
+| `docs/agent-notes/bus.md` | corrected | A native peer's `onMessage` returns the hop-drop result and no off-roster note follows a hop drop (#582); an owner offer is moot only on the recipient's own acceptance (#578). Now tracks `src/hub/delivery-superseded.ts`. |
+| `docs/agent-notes/daemon.md` | corrected | Delegated CLI audits and `cli_audit_delegated` (#571); `pet` only through `validatePetConfig` (#567); split-aware profile-check (#579); stale-launch refusal (#560); tool-list re-announce (#569); `native_tui_launch` errors may name the flag (#568). |
+| `docs/agent-notes/models.md` | corrected | Switchyard removal checked (#561); the scope line fixed. |
+| `docs/agent-notes/tasks.md` | corrected | The main-checkout note is advisory and a branch name reaches task text only through `publicMetadataText` (#575); #583 adds the repository-key rule. Now tracks `src/hub/main-checkout.ts`, `src/hub/checks.ts` and `src/hub/task-repository.ts`. |
+| `docs/agent-notes/budget.md` | no change | No quota, pause or context rule changed; the 32 MiB line is already present. |
+| `docs/agent-notes/local-worker.md` | no change | The send outcome (#582) is covered in `bus.md`. |
+| `docs/agent-notes/benchmarks.md` | no change | The Jcode steer does not affect Qwen; #573 has no driver effect. |
+| `docs/agent-notes/tests.md` | no change | No new test-gate rule. |
+| `docs/agent-notes/README.md` | no change | Stale only through `daemon.md`. |
+
+`AGENTS.md`: the project's own hub block is synced to `templates/AGENTS.block.md` (it lagged four lines, including the #572 line), the release rule now names the help-text check, and the area list names the new source files.
+
+Found during the review, not changed here: `test/liveness.test.ts` and `test/conflicts.test.ts` still call `realpathSync` on temp dirs.
+
+## Checks
+
+- Each merged PR's exact-head CI passed (table above). The main run at `dc0ef55b` failed only on a leaked `ahub manager` process from the manager tests (4473 pass, 0 fail), filed as #584; the next main run passed.
+- The release branch is merged main plus the version, release notes and document corrections. The bundle is rebuilt with the pinned Bun 1.4.2 under host admission and is fresh; `tsc` is clean.
+- The stale stamps are restamped to the release commit `e57b1936` (reviewed against main `744a8ac9`; the release commit adds only the version, notes, bundle and documents); `node scripts/check-docs.mjs --require-fresh` reports 0 stale documents and runs again on the merged main before the tag.
+- Exact-head CI on the release PR.

package/docs/verification/2026-10-20-jcode-tui-0.98.1.md

@@ -0,0 +1,39 @@
+# Jcode 0.98.1 TUI native prerequisite (#464, task #246)
+
+The parent-sanitized native receipt `task246-native-evidence.json` records the prerequisite transport proof below. Installed Jcode was 0.98.1; the public native source revision was `1c7426eb1`. This record does not verify the pending hub implementation, its CI, or personal OAuth/account behavior. It supplements [the 0.98.1 contract record](2026-10-19-jcode-0.98.1.md).
+
+## Probe scope
+
+- Isolated `HOME`, `JCODE_HOME` and `TMPDIR`, with an owned private socket directory of mode `0700`; no real-home access.
+- The same fixture prefix, `-p anthropic-api -m claude-sonnet-4-6`, on `serve`, ACP and the top-level native TUI. The TUI did not use `connect`.
+- Only dummy per-run auth for a loopback provider fixture. No personal credentials or remote provider account proof; earlier failed OAuth fixture probes are not passes.
+- Actual native PTY TUI observations, with provider replies supplied by the loopback fixture. This proves native transport behavior under that fixture, not model quality, production provider behavior or hub-tool execution.
+
+## Recorded native results
+
+| Case | Evidence | Result and boundary |
+| --- | --- | --- |
+| First save | `session/new` left no saved native session JSON. The first real loopback-provider `session/prompt` ended normally, made one loopback request and produced a verified native save. | A new ACP session ID alone is insufficient evidence for opening the selected TUI conversation. |
+| J0-1 | The actual native PTY TUI displayed a new reply marker supplied only by the loopback provider after an ACP prompt. The native turn ended normally. | Passed the new ACP reply visibility prerequisite; the marker was not merely old transcript text. |
+| J0-4 | The TUI closed during an in-flight prompt. The owned server and ACP remained alive at detach; the original prompt completed. | Passed the detach independence prerequisite for that owned native runtime. |
+| J0-5 | The owned server restarted with the same home; `session/load` selected the same session ID. The top-level TUI displayed both the old transcript marker and a new ACP-turn marker. | Passed the native selected-session continuity prerequisite. The load response omitted the ID echo, so this is not automatic adapter recovery success. |
+| Cleanup | Seven owned process groups had cleanup confirmations. The final process table was available and showed zero survivors. | Cleanup confirmed for the probe's owned groups. |
+
+Native `session/load` still does not echo its selected session ID. The adapter's existing refusal of unproven automatic recovery remains unchanged; the observed native continuity does not satisfy that adapter identity contract.
+
+## Launcher contract (J1.4)
+
+The planner-approved correction follows the observed first-save boundary. While the same launch, socket and session lack saved native evidence, the launcher prints exactly:
+
+```text
+jcode's TUI opens after its first hub turn; send it work, or Ctrl-C
+```
+
+It waits for the native save and then opens the TUI. Ctrl-C ends only the launcher wait and retains ACP; a provider-opened terminal runs the same launcher. The implementation must not send artificial production prompts or create native session JSON on the hub's behalf. These are launcher requirements, not validation results of this native probe.
+
+## Accepted limits and remaining evidence
+
+- No single-writer guard: TUI input may join an ACP turn.
+- Native policy remains unmanaged, without hub approval or a hub sandbox.
+- Source implementation, focused regressions, the full local gate and exact-head CI require separate receipts. This document's author performed read-only/text checks only and did not rerun the native probe, tests or builds.
+- Personal account/OAuth behavior, real provider serving, project MCP discovery and real hub-tool calls remain unverified by this receipt.

package/docs/verified.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "documents": {
     "README.md": {
-      "verifiedAgainst": "adf2d5fd2fc2e9f5ce5b5e9daf594269de227238",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "package.json",
         "src/",
@@ -11,14 +11,14 @@
       ]
     },
     "docs/security.md": {
-      "verifiedAgainst": "adf2d5fd2fc2e9f5ce5b5e9daf594269de227238",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "src/",
         "templates/"
       ]
     },
     "docs/operations.md": {
-      "verifiedAgainst": "adf2d5fd2fc2e9f5ce5b5e9daf594269de227238",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "package.json",
         "src/",
@@ -35,7 +35,7 @@
       ]
     },
     "docs/quickstart.md": {
-      "verifiedAgainst": "adf2d5fd2fc2e9f5ce5b5e9daf594269de227238",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "package.json",
         "src/",
@@ -43,7 +43,7 @@
       ]
     },
     "docs/agent-notes/adapters.md": {
-      "verifiedAgainst": "adf2d5fd2fc2e9f5ce5b5e9daf594269de227238",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "src/adapters/",
         "src/pi/",
@@ -69,7 +69,7 @@
       ]
     },
     "docs/agent-notes/benchmarks.md": {
-      "verifiedAgainst": "adf2d5fd2fc2e9f5ce5b5e9daf594269de227238",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "scripts/benchmarks/",
         "test/benchmarks/",
@@ -81,7 +81,7 @@
       ]
     },
     "docs/agent-notes/budget.md": {
-      "verifiedAgainst": "adf2d5fd2fc2e9f5ce5b5e9daf594269de227238",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "src/hub/budget.ts",
         "src/cli/statusline-tee.ts",
@@ -98,7 +98,7 @@
       ]
     },
     "docs/agent-notes/bus.md": {
-      "verifiedAgainst": "adf2d5fd2fc2e9f5ce5b5e9daf594269de227238",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "src/hub/bus.ts",
         "src/hub/envelope.ts",
@@ -108,11 +108,12 @@
         "src/hub/inference.ts",
         "src/hub/daemon.ts",
         "src/hub/supervision.ts",
-        "src/cli/reset.ts"
+        "src/cli/reset.ts",
+        "src/hub/delivery-superseded.ts"
       ]
     },
     "docs/agent-notes/daemon.md": {
-      "verifiedAgainst": "adf2d5fd2fc2e9f5ce5b5e9daf594269de227238",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "src/hub/daemon.ts",
         "src/hub/control-client.ts",
@@ -167,7 +168,7 @@
       ]
     },
     "docs/agent-notes/local-worker.md": {
-      "verifiedAgainst": "03209040585a57c7c0a1f2b81f6be814df88267c",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "src/adapters/local-worker.ts",
         "src/local/",
@@ -179,16 +180,15 @@
       ]
     },
     "docs/agent-notes/models.md": {
-      "verifiedAgainst": "b91d2cacb80b58ec85fa4cf538cdb1f3ed6079cc",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "src/models/",
         "src/hub/inference.ts",
-        "src/omniroute/",
-        "src/switchyard/"
+        "src/omniroute/"
       ]
     },
     "docs/agent-notes/tasks.md": {
-      "verifiedAgainst": "adf2d5fd2fc2e9f5ce5b5e9daf594269de227238",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "src/hub/tasks.ts",
         "src/hub/board.ts",
@@ -208,11 +208,14 @@
         "src/hub/review-brief.ts",
         "src/hub/reviewer-pool.ts",
         "src/hub/reviewer-pool-config.ts",
-        "src/hub/release-admission.ts"
+        "src/hub/release-admission.ts",
+        "src/hub/main-checkout.ts",
+        "src/hub/checks.ts",
+        "src/hub/task-repository.ts"
       ]
     },
     "docs/agent-notes/tests.md": {
-      "verifiedAgainst": "adf2d5fd2fc2e9f5ce5b5e9daf594269de227238",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "test/",
         "scripts/check.sh",
@@ -224,20 +227,36 @@
         ".github/workflows/check.yml",
         ".github/workflows/release.yml",
         "src/hub/child-process.ts",
-        "src/switchyard/sidecar.ts",
         "src/local/sandbox.ts",
         "src/models/mlx.ts",
         "src/cli/upgrade-interactive.ts"
       ]
     },
     "docs/agent-notes/README.md": {
-      "verifiedAgainst": "adf2d5fd2fc2e9f5ce5b5e9daf594269de227238",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "src/cli/console-state.ts",
         "src/cli/attention.ts",
         "test/console-attention.test.ts",
         "docs/agent-notes/daemon.md"
       ]
+    },
+    "src/cli/help.ts": {
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
+      "paths": [
+        "src/cli/main.ts",
+        "src/cli/launch.ts",
+        "src/adapters/definitions/native-cli-entry-claude.ts",
+        "src/adapters/definitions/native-cli-entry-codex.ts",
+        "src/adapters/definitions/native-cli-entry-jcode.ts",
+        "src/adapters/definitions/native-cli-entry-kimi.ts",
+        "src/adapters/definitions/native-cli-entry-local.ts",
+        "src/adapters/definitions/native-cli-entry-pi.ts",
+        "src/adapters/definitions/native-cli-entry-qwen.ts",
+        "src/adapters/definitions/native-cli-entry-types.ts",
+        "src/adapters/definitions/native-cli-entry.ts",
+        "src/adapters/agy/entry.ts"
+      ]
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@staix/agent-hub",
-  "version": "0.12.38",
+  "version": "0.12.40",
   "description": "Native multi-agent hub: Claude Code, Codex, Kimi Code, Pi and local inference as peers in one project",
   "license": "MIT",
   "type": "module",

package/plugins/agent-hub/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-hub",
-  "version": "0.12.38",
+  "version": "0.12.40",
   "description": "Channel between Claude Code and the agent-hub daemon: peer messages from Codex, Kimi and the local worker arrive as channel events; hub_send replies.",
   "author": {
     "name": "Young Joon Lee",