@staix/agent-hub 0.12.39 → 0.12.40

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/verified.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "documents": {
     "README.md": {
-      "verifiedAgainst": "09d85684a53322b816f47f37c61faeb8a359419c",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "package.json",
         "src/",
@@ -11,14 +11,14 @@
       ]
     },
     "docs/security.md": {
-      "verifiedAgainst": "09d85684a53322b816f47f37c61faeb8a359419c",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "src/",
         "templates/"
       ]
     },
     "docs/operations.md": {
-      "verifiedAgainst": "09d85684a53322b816f47f37c61faeb8a359419c",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "package.json",
         "src/",
@@ -35,7 +35,7 @@
       ]
     },
     "docs/quickstart.md": {
-      "verifiedAgainst": "09d85684a53322b816f47f37c61faeb8a359419c",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "package.json",
         "src/",
@@ -43,7 +43,7 @@
       ]
     },
     "docs/agent-notes/adapters.md": {
-      "verifiedAgainst": "09d85684a53322b816f47f37c61faeb8a359419c",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "src/adapters/",
         "src/pi/",
@@ -69,7 +69,7 @@
       ]
     },
     "docs/agent-notes/benchmarks.md": {
-      "verifiedAgainst": "09d85684a53322b816f47f37c61faeb8a359419c",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "scripts/benchmarks/",
         "test/benchmarks/",
@@ -81,7 +81,7 @@
       ]
     },
     "docs/agent-notes/budget.md": {
-      "verifiedAgainst": "09d85684a53322b816f47f37c61faeb8a359419c",
+      "verifiedAgainst": "e57b1936bd234fad65aded000c921f5c9d7a3718",
       "paths": [
         "src/hub/budget.ts",
         "src/cli/statusline-tee.ts",
@@ -98,7 +98,7 @@
       ]
     },
     "docs/agent-notes/bus.md": {
-      "verifiedAgainst": "09d85684a53322b816f47f37c61faeb8a359419c",
+      "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": "09d85684a53322b816f47f37c61faeb8a359419c",
+      "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": "09d85684a53322b816f47f37c61faeb8a359419c",
+      "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": "09d85684a53322b816f47f37c61faeb8a359419c",
+      "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": "09d85684a53322b816f47f37c61faeb8a359419c",
+      "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.39",
+  "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.39",
+  "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",