@staix/agent-hub 0.12.44 → 0.12.45

package/docs/verification/2026-10-22-0.12.45.md

@@ -0,0 +1,60 @@
+# 0.12.45 release verification
+
+This record covers release preparation and source review. It does not claim publication, installation, a running-hub restart or a live TUI launch.
+
+## Candidate
+
+Version 0.12.45, from merged main at 0612e5d5. The person directed on 2026-10-22 to finish the work in progress and release it.
+
+- Dashboard redesign (#469): tokens (#649), app shell and view keys (#650), board cards with detail and Plan sheets (#651), view restyle and Office colours (#659), keyed rendering, motion and loading, empty, disconnected and toast states (#660), and follow-ups (#662, #664).
+- External adapter modules and the conformance kit (#451 A4, #648, #653); the A5 guide and adapters note pass (#668).
+- Peer lists and the CLI surface derived from adapter definitions (#625, #656), and PeerAdapter capability members (#625 phase 6 slice 1, #667).
+- Structured review findings with an Important gate (#481 S3, #652, #657) and plan conformance with person-only departure acceptance (#481 S2, #665).
+- #230 S10 review-readiness rulings (#641, #643, #644), #428 racy same-size rewrites of large files (#646), #221 channel hints (#647), #225 stale roster keys and the shared git budget (#663), #654 Kimi TUI retained-command diagnostic (#658), and #661 held snapshot clocks for runner-speed-dependent daemon tests (#666, #669).
+- Still open: #655 (dependency-ready auto-assignment ignores the owner's WIP cap), board task #287 (external-kind instances), the later #625 phase 6 slices and #481 S4-S7.
+
+## Reviews
+
+| PR | Final head | Review | CI |
+| --- | --- | --- | --- |
+| #641, #643, #644 (#230) | see PRs | Spec ruling, then code review with red-first regressions | exact head, success |
+| #646 (#428) | e4b3fb9a | Two rounds with an independent reviewer (unbounded hashing and the atHead regression fixed) | exact head, success |
+| #647 (#221) | 0b1ae257 | Reviewer read; a connector P2 (legacy nudge under a held hint) fixed by the reviewer | exact head, success |
+| #648, #653 (#451 A4) | 222a5839, 4a271455 | Two rounds with independent security and packaging reviews; project-cwd SDK resolution, whole-daemon refusal and offline roster fixed; follow-ups in #653 | exact head, success |
+| #649, #650, #651, #659, #660 (#469) | see PRs | Reviewer read per phase; R3 seed rot re-anchored; connector findings fixed or tracked (#293, #296) | exact head, success (R6 after one Ubuntu rerun of the #661 flake) |
+| #652, #657 (#481 S3) | d60d5bd6, ecc4b39f | Two rounds with an independent reviewer (unbound-head bypass and head carry-forward fixed); a connector P1 (supplied head) fixed in #657 | exact head, success |
+| #656 (#625) | d803de2b | Reviewer read against the projection ruling; fixture correction (#294); bundle rebuilt after #658 | exact head, success |
+| #658 (#654) | a6409371 | Reviewer read; root cause reproduced by delay | exact head, success |
+| #662 | f46cb77f | Main-red fix after #656 and #660 crossed | exact head, success |
+| #663 (#225) | fd71191b | Reviewer read; three connector findings (instance eligibility, shared-config removal, result text) fixed red-first | exact head, success |
+| #664 (#296) | 0d21de7a | Reviewer read; fixes two connector P2s from #660 | exact head, success |
+| #665 (#481 S2) | 88bec9ab | Three rounds with an independent reviewer (rename and root-entry bypasses, status writes, off-mode, queue rename regression fixed); a connector P1 (departure scope) fixed red-first (#298) | exact head, success |
+| #666, #669 (#661) | 948b6afd, 389262df | Reviewer read; red-first with a slowed-git stand-in; a connector P1 (20 s per-test ceiling) fixed | exact head, success |
+| #667 (#625) | 17ab88d2 | Reviewer read against the phase 6 rulings | exact head, success |
+| #668 (#451 A5) | fc052e89 | Reviewer read; two connector P2s fixed by the reviewer | exact head, success |
+
+## Document review
+
+Fourteen documents were stale against the 0.12.44 stamps. Each was checked against `git log <stamp>..HEAD` over its paths (with PR #665's diff) by read-only reviewers in four groups, and corrected where a merged change made a statement wrong or missing.
+
+| Document | Result | Checked claims and correction |
+| --- | --- | --- |
+| `README.md` | corrected | Status 0.12.45; dashboard, adapter modules, review findings and plan conformance, stale roster key removal; verification link. |
+| `docs/quickstart.md` | corrected | Install pin `v0.12.45`; "Upgrading to 0.12.45" (dashboard, modules, findings, plan conformance and `accept-departure`, Kimi diagnostic, channel hints, #428). |
+| `docs/operations.md` | corrected | New "External adapter modules" section; recovery floor; conditional source refusal; shared git budget; stale roster keys; SDLC S3 and S2 with pointers to `docs/sdlc.md`. |
+| `docs/security.md` | corrected | A4 trust paragraph (a pin authorizes code, not a sandbox); delegated-CLI refusals include departure acceptance; metadata-only plan conformance reads; stale roster keys grant nothing. |
+| `src/cli/help.ts` | corrected | `release-assign <reason...>`; roster remove deletes a stale instance key; `plan-review` flag grouping; native usage rendered from definitions matches each entry parser. |
+| `docs/agent-notes/tasks.md` | corrected | Supplied-head binding, id-only settlement, hub-proposed recurrence markers, S2 conformance and departure consent rules; `plan-conformance.ts` in scope. |
+| `docs/agent-notes/daemon.md` | corrected | Module recovery floor, conditional source refusal, historical receipt reads, stale keys, external catalog, retained `kimi_cmd` diagnostic. |
+| `docs/agent-notes/adapters.md` | corrected | PeerAdapter capability ports (#667). |
+| `docs/agent-notes/tests.md` | corrected | Held snapshot clocks, the 20 s per-test ceiling, seed re-anchoring, CI tests the PR head, kit and fakes under `src/adapters/conformance/`. |
+| `docs/agent-notes/local-worker.md` | corrected | #428 racy large-file rule. |
+| `docs/agent-notes/budget.md` | corrected | `Budget.report` skips external module kinds. |
+| `docs/agent-notes/README.md` | corrected | Background section holding the rationale moved out of the notes. |
+| `docs/agent-notes/benchmarks.md`, `bus.md` | no change | Rules checked against the diffs; no contradiction. |
+
+`AGENTS.md` and `docs/verified.json` gain the new task-board and test paths, and the pre-0.7.7 issue-numbering note is removed from `AGENTS.md` at the person's request.
+
+## Release mechanics
+
+Merge the release PR with a merge commit (the stamps name release-branch commits), run `node scripts/check-docs.mjs --require-fresh` on the merged main, then tag `v0.12.45`.

package/docs/verified.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "documents": {
     "README.md": {
-      "verifiedAgainst": "e185b9e62bd96aa0638f8e694628eeb698e38649",
+      "verifiedAgainst": "864dc1db576c21909bfe403897248756f8825a5b",
       "paths": [
         "package.json",
         "src/",
@@ -11,14 +11,14 @@
       ]
     },
     "docs/security.md": {
-      "verifiedAgainst": "e185b9e62bd96aa0638f8e694628eeb698e38649",
+      "verifiedAgainst": "864dc1db576c21909bfe403897248756f8825a5b",
       "paths": [
         "src/",
         "templates/"
       ]
     },
     "docs/operations.md": {
-      "verifiedAgainst": "e185b9e62bd96aa0638f8e694628eeb698e38649",
+      "verifiedAgainst": "864dc1db576c21909bfe403897248756f8825a5b",
       "paths": [
         "package.json",
         "src/",
@@ -35,7 +35,7 @@
       ]
     },
     "docs/quickstart.md": {
-      "verifiedAgainst": "e185b9e62bd96aa0638f8e694628eeb698e38649",
+      "verifiedAgainst": "864dc1db576c21909bfe403897248756f8825a5b",
       "paths": [
         "package.json",
         "src/",
@@ -43,7 +43,7 @@
       ]
     },
     "docs/agent-notes/adapters.md": {
-      "verifiedAgainst": "e185b9e62bd96aa0638f8e694628eeb698e38649",
+      "verifiedAgainst": "864dc1db576c21909bfe403897248756f8825a5b",
       "paths": [
         "src/adapters/",
         "src/pi/",
@@ -73,7 +73,7 @@
       ]
     },
     "docs/agent-notes/benchmarks.md": {
-      "verifiedAgainst": "e185b9e62bd96aa0638f8e694628eeb698e38649",
+      "verifiedAgainst": "864dc1db576c21909bfe403897248756f8825a5b",
       "paths": [
         "scripts/benchmarks/",
         "test/benchmarks/",
@@ -85,7 +85,7 @@
       ]
     },
     "docs/agent-notes/budget.md": {
-      "verifiedAgainst": "e185b9e62bd96aa0638f8e694628eeb698e38649",
+      "verifiedAgainst": "864dc1db576c21909bfe403897248756f8825a5b",
       "paths": [
         "src/hub/budget.ts",
         "src/cli/statusline-tee.ts",
@@ -103,7 +103,7 @@
       ]
     },
     "docs/agent-notes/bus.md": {
-      "verifiedAgainst": "e185b9e62bd96aa0638f8e694628eeb698e38649",
+      "verifiedAgainst": "864dc1db576c21909bfe403897248756f8825a5b",
       "paths": [
         "src/hub/bus.ts",
         "src/hub/envelope.ts",
@@ -118,7 +118,7 @@
       ]
     },
     "docs/agent-notes/daemon.md": {
-      "verifiedAgainst": "e185b9e62bd96aa0638f8e694628eeb698e38649",
+      "verifiedAgainst": "864dc1db576c21909bfe403897248756f8825a5b",
       "paths": [
         "src/hub/daemon.ts",
         "src/hub/control-client.ts",
@@ -179,7 +179,7 @@
       ]
     },
     "docs/agent-notes/local-worker.md": {
-      "verifiedAgainst": "e185b9e62bd96aa0638f8e694628eeb698e38649",
+      "verifiedAgainst": "864dc1db576c21909bfe403897248756f8825a5b",
       "paths": [
         "src/adapters/local-worker.ts",
         "src/local/",
@@ -199,7 +199,7 @@
       ]
     },
     "docs/agent-notes/tasks.md": {
-      "verifiedAgainst": "e185b9e62bd96aa0638f8e694628eeb698e38649",
+      "verifiedAgainst": "864dc1db576c21909bfe403897248756f8825a5b",
       "paths": [
         "src/hub/tasks.ts",
         "src/hub/board.ts",
@@ -224,11 +224,13 @@
         "src/hub/checks.ts",
         "src/hub/task-repository.ts",
         "src/hub/no-writes.ts",
-        "src/adapters/registry.ts"
+        "src/adapters/registry.ts",
+        "src/hub/review-findings.ts",
+        "src/hub/plan-conformance.ts"
       ]
     },
     "docs/agent-notes/tests.md": {
-      "verifiedAgainst": "e185b9e62bd96aa0638f8e694628eeb698e38649",
+      "verifiedAgainst": "864dc1db576c21909bfe403897248756f8825a5b",
       "paths": [
         "test/",
         "scripts/check.sh",
@@ -242,11 +244,12 @@
         "src/hub/child-process.ts",
         "src/local/sandbox.ts",
         "src/models/mlx.ts",
-        "src/cli/upgrade-interactive.ts"
+        "src/cli/upgrade-interactive.ts",
+        "src/adapters/conformance/"
       ]
     },
     "docs/agent-notes/README.md": {
-      "verifiedAgainst": "e185b9e62bd96aa0638f8e694628eeb698e38649",
+      "verifiedAgainst": "864dc1db576c21909bfe403897248756f8825a5b",
       "paths": [
         "src/cli/console-state.ts",
         "src/cli/attention.ts",
@@ -255,7 +258,7 @@
       ]
     },
     "src/cli/help.ts": {
-      "verifiedAgainst": "e185b9e62bd96aa0638f8e694628eeb698e38649",
+      "verifiedAgainst": "864dc1db576c21909bfe403897248756f8825a5b",
       "paths": [
         "src/cli/main.ts",
         "src/cli/launch.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@staix/agent-hub",
-  "version": "0.12.44",
+  "version": "0.12.45",
   "description": "Native multi-agent hub: Claude Code, Codex, Kimi Code, Pi and local inference as peers in one project",
   "license": "MIT",
   "type": "module",
@@ -46,5 +46,9 @@
   "homepage": "https://github.com/STAIxBWLB/agent-hub",
   "publishConfig": {
     "access": "public"
+  },
+  "exports": {
+    "./adapter": "./src/adapters/public.ts",
+    "./conformance": "./src/adapters/conformance/index.ts"
   }
 }

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

@@ -1,6 +1,6 @@
 {
   "name": "agent-hub",
-  "version": "0.12.44",
+  "version": "0.12.45",
   "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",