@afokapu/atdd-bun 0.10.24 → 0.10.26

package/conventions/delivery/delivery.board.convention.yaml

@@ -27,11 +27,12 @@ terms:
     atdd-bun chat post writes the header: from, to, participants and conversation always; kind (task, result, review-request, verdict, rebuttal, status, blocked, heartbeat), stage, reply-to, repo, branch, worktree, goal, base and sha when they apply. The body carries the whole instruction or answer, however long: the thread is the history. A heartbeat carries nothing else; anything that needs an answer goes as blocked, never inside a heartbeat.
 - term_id: commands
   text: >-
-    Post with the body on standard input; read what is on a topic; wait for the next message addressed to you on one or several topics (comma-separated), skipping kinds you do not act on (--skip heartbeat), bounded by --timeout so a tool call ends (exit 2: nothing yet). wait remembers where each identity stopped on each set of topics (~/.atdd-board/cursors), so re-arming a watcher is always the same command; --since still overrides it; and, for a human, atdd-bun chat alone opens the board: every topic on the left, the selected conversation on the right, live.
+    Post with the body on standard input; read what is on a topic; wait for the next message addressed to you on one or several topics (comma-separated), skipping kinds you do not act on (--skip heartbeat), bounded by --timeout so a tool call ends (exit 2: nothing yet). wait remembers where each identity stopped on each set of topics (~/.atdd-board/cursors), so re-arming a watcher is always the same command; --since still overrides it; follow is the listener for a host that wakes its agent on each line a running process prints (Claude Code's Monitor tool): it streams every message addressed to the identity as it arrives and keeps running, keeping the same saved place; a host that wakes its agent only when a process exits runs wait and re-arms it after each wake-up. One listener per identity. And, for a human, atdd-bun chat alone opens the board: every topic on the left, the selected conversation on the right, live.
   values:
     post: atdd-bun chat post <topic> --to <agent> --kind <kind> [--reply-to <id>] < message.md
     read: atdd-bun chat read <topic> [--mine]
     wait: atdd-bun chat wait <topic>[,<topic>...] [--since <id>] [--skip heartbeat] --timeout 540
+    follow: atdd-bun chat follow <topic>[,<topic>...] [--skip heartbeat,progress] [--timeout <seconds>]
     board: atdd-bun chat
 - term_id: server
   text: >-

package/detectors/bun_green_traceability_detector/urn_header.mjs

@@ -30,6 +30,7 @@
 //      is content, so neither may displace the URN from "first real line" — the
 //      Vite parser counts a shebang as the first non-empty line and fails such a
 //      file for a header it actually has. `firstMeaningfulNo` skips both.
+import { excludedPath } from "../../lib/scan.mjs";
 import { readFileSync, statSync, readdirSync, writeFileSync } from "node:fs";
 import { join, extname, sep } from "node:path";
 
@@ -50,8 +51,7 @@ export function parseJsonEnv(name, fallback) {
 }
 
 export function isExcluded(path, excludes) {
-  const segs = path.split(sep);
-  return excludes.some((ex) => segs.includes(ex) || path.includes(ex));
+  return excludedPath(path, excludes);
 }
 
 function isScannable(file) {

package/detectors/bun_interlocking_binding/detect.mjs

@@ -21,6 +21,7 @@
 // Zero third-party deps: Node and Bun builtins only. The plan/_trains interlocking YAML route space is
 // stack-neutral planner data (snake_case, core #1248); the runtime + JOURNEY_MAP + trace are Bun/TS.
 
+import { excludedPath } from "../../lib/scan.mjs";
 import { parseInterlocking as parseInterlockingDoc } from "../../lib/interlocking.mjs";
 import { readFileSync, writeFileSync, statSync, readdirSync } from "node:fs";
 import { scanExecution } from "./checks/interlocking_runtime_executes.mjs";
@@ -112,8 +113,7 @@ const SCAN_EXCLUDES = (() => {
 })();
 
 function isExcluded(path) {
-  const segments = path.split(sep);
-  return SCAN_EXCLUDES.some((ex) => segments.includes(ex) || path.includes(ex));
+  return excludedPath(path, SCAN_EXCLUDES);
 }
 
 function hasChildDir(dir, name) {

package/detectors/bun_interlocking_coverage/_shared/interlocking.mjs

@@ -6,6 +6,7 @@
 // ZERO third-party deps — node builtins only. The interlocking route space is stack-neutral planner
 // data (snake_case, plan/_trains/_interlockings/**); the e2e tests are Bun/TS under e2e/**.
 
+import { excludedPath } from "../../../lib/scan.mjs";
 import { readFileSync, statSync, readdirSync, writeFileSync } from "node:fs";
 import { join, sep } from "node:path";
 
@@ -184,8 +185,7 @@ const SCAN_EXCLUDES = (() => {
 })();
 
 function isExcluded(path) {
-  const segments = path.split(sep);
-  return SCAN_EXCLUDES.some((ex) => segments.includes(ex) || path.includes(ex));
+  return excludedPath(path, SCAN_EXCLUDES);
 }
 
 function hasChildDir(dir, name) {

package/detectors/bun_interlocking_infrastructure/_shared/interlocking.mjs

@@ -21,6 +21,7 @@
 //                        Mirrors python/<wagon>/wagon.py and convex/<wagon>/wagon.ts;
 //                        `wagon.ts` is already vocabulary in coder.bun.composition-root.
 
+import { excludedPath } from "../../../lib/scan.mjs";
 import { readFileSync, statSync, readdirSync, writeFileSync } from "node:fs";
 import { join, sep, basename } from "node:path";
 
@@ -88,8 +89,7 @@ const SCAN_EXCLUDES = (() => {
 })();
 
 function isExcluded(path) {
-  const segments = path.split(sep);
-  return SCAN_EXCLUDES.some((ex) => segments.includes(ex) || path.includes(ex));
+  return excludedPath(path, SCAN_EXCLUDES);
 }
 
 function hasChildDir(dir, name) {

package/detectors/bun_telemetry_test/_shared.mjs

@@ -6,6 +6,7 @@
 // kind segment (-TELEMETRY- / -EVENT- / -METRIC-), or by *.telemetry.test.*
 // colocation — the same identification tester.bun.telemetry-emit uses, plus the
 // binding header this profile adds.
+import { excludedPath } from "../../lib/scan.mjs";
 import { readFileSync, statSync, readdirSync } from "node:fs";
 import { join, extname, sep } from "node:path";
 import { loadTelemetryFiles, CONCRETE_URN } from "../../src/telemetry-plan.ts";
@@ -14,8 +15,7 @@ const TEST_RE = /\.(test|spec)\.[cm]?[jt]sx?$/;
 const DEFAULT_EXCLUDES = ["node_modules", "dist", "build", ".next", ".git", "_generated"];
 
 function isExcluded(path, excludes) {
-  const segs = path.split(sep);
-  return excludes.some((ex) => segs.includes(ex) || path.includes(ex));
+  return excludedPath(path, excludes);
 }
 
 export function* walkTests(root, excludes) {

package/detectors/bun_tester_discipline_detector/test_header.mjs

@@ -23,6 +23,7 @@
 // per-file rename: one spec file is wagon-level and legitimately covers many
 // acceptances, so a one-acceptance-per-file naming rule would fragment a real
 // suite. Both levels are parsed here.
+import { excludedPath } from "../../lib/scan.mjs";
 import { readFileSync, statSync, readdirSync, writeFileSync } from "node:fs";
 import { dirname, join, extname, sep } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -50,8 +51,7 @@ export function parseJsonEnv(name, fallback) {
 }
 
 function isExcluded(path, excludes) {
-  const segs = path.split(sep);
-  return excludes.some((ex) => segs.includes(ex) || path.includes(ex));
+  return excludedPath(path, excludes);
 }
 
 // Walks TEST FILES ONLY. The tester persona governs the suite; source files are

package/integrity.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.10.24",
+  "version": "0.10.26",
   "files": {
     "HOOK_AUDIT.md": "5329d840db37671b1918f688ead26865473b87db73dbc75f7c8b2a8bbe8d6d43",
     "PLANNER_PORT.md": "fb5935bac8b7ac18994de21e43ace3a5ef8cd55f85b0e3349fca261280054f11",
@@ -93,7 +93,7 @@
     "conventions/coder.htmx/coder.htmx.verb-endpoint-same-origin.convention.yaml": "2128d26153e2d1f19c65a1e1665d4f82c78395daedb336d6ef1256e82b74aedb",
     "conventions/coder.htmx/coder.htmx.verb-mutation-signals-progress.convention.yaml": "ae85c5ea01a09a3c41b939988088a8e5da91848d2710a1f0a1e0c86308638ac9",
     "conventions/delivery/delivery.approved-sha-resolves.convention.yaml": "68f2ecc10870e780abb05bb31d211b1923d47b56672df4b3950f437aa9cf8ca8",
-    "conventions/delivery/delivery.board.convention.yaml": "51ff4c16dddf20504f34accc5ddcd150108fab70e4e6f5bdb36cec71d0c905a8",
+    "conventions/delivery/delivery.board.convention.yaml": "4c544f51de80b09961a8df41028867023ab802aa4b31dcb0a1ce29e890552e6d",
     "conventions/delivery/delivery.config-schema.convention.yaml": "4c7b449074a8bd9f89b70c702ab3e0df229105ddb4458772f894f0bf37813e9f",
     "conventions/delivery/delivery.evidence-schema.convention.yaml": "9c6a22495dfb3e2fcbca700392866c3b5660084b1f5594230eb320b499d5e5cb",
     "conventions/delivery/delivery.findings-resolved.convention.yaml": "f6574e93a9a2d4bdd6d6f5645720b1a647fc0048d95f7675fe783d2ddb62c05b",
@@ -326,10 +326,10 @@
     "detectors/bun_green_traceability_detector/fixtures/dirty/green_urn_pattern/OrderRow.ts": "841349cf639b8322558c5e004c38f81cb82180af9a69cc5c3ed9ea35d39249fb",
     "detectors/bun_green_traceability_detector/fixtures/dirty/green_urn_side/OrderRow.ts": "e08bc0fba889b2008bb528ee86f3bfaf6c6756fefc17780da843bbaf5d00ac06",
     "detectors/bun_green_traceability_detector/fixtures/dirty/green_urn_wagon_feature/OrderRow.ts": "eed3e99b3a582a41e7179228ca8c33987fdf0ca1c06d78710951057a2355d902",
-    "detectors/bun_green_traceability_detector/urn_header.mjs": "004b0ed1f71ec476fb57a959d302da4b5869ff91be049865a806bedca40f55b9",
+    "detectors/bun_green_traceability_detector/urn_header.mjs": "ec43ef492e405d31b30617646e41617aaef7de8eebc2f153ce8d4e8f6c2de1b2",
     "detectors/bun_interlocking_binding/atdd.implementation.yaml": "8df233a7c337d38ab4fc92a309273b91fe713b27507a4b2cfa66ffc7a948d520",
     "detectors/bun_interlocking_binding/checks/interlocking_runtime_executes.mjs": "ea4c32914a007962012e9062cc64063fa939ff0a59c07960c34872d058720955",
-    "detectors/bun_interlocking_binding/detect.mjs": "ec48b90b14e9c8a4e15bb50cf196af2fc673532f449e884e3c454dc57a2b06b1",
+    "detectors/bun_interlocking_binding/detect.mjs": "7e381c8c875b4cd3693a5388b9aeba6d0fc0d89435f3a480765458c6b9497e8b",
     "detectors/bun_interlocking_binding/fixtures/clean/e2e/interlockings/match-resolution/trace.test.ts": "5dadc041ca9825f404340ca428e14bbff5e00824ca6c25464f21cd2ce56044d8",
     "detectors/bun_interlocking_binding/fixtures/clean/plan/_trains/_interlockings/match-resolution.yaml": "11884309beb9bcceccfeda7917ea73d51a530366db5eb60772b03cf5eeb239cd",
     "detectors/bun_interlocking_binding/fixtures/clean/plan/_trains/train:match:match-resolution-standard.yaml": "a7067661a723e02e0e844e6b90ad187f620dd328e1b9be45163c04db1919ce77",
@@ -379,7 +379,7 @@
     "detectors/bun_interlocking_binding/fixtures/dirty_transcribed_runtime/server.ts": "d5bc34c5b1b2b0a511e0c4604ce6f9c77491dca9aee994be720540f3052babc1",
     "detectors/bun_interlocking_binding/fixtures/dirty_transcribed_runtime/src/trains/interlocking.ts": "9bcfdb4ecff6efd1f658b9fd587342615179924e25468c75daa07c2626d4d8ab",
     "detectors/bun_interlocking_binding/fixtures/dirty_transcribed_runtime/src/trains/runner.ts": "0e4b885e50f12cc2a8c8f6740bf83e7b2e7137a28e1e143586e9a8550ea5bd45",
-    "detectors/bun_interlocking_coverage/_shared/interlocking.mjs": "4946e582f1ddee7346a6d546bd8309f622ffeb383f9f8ac1a02de9d20a72723d",
+    "detectors/bun_interlocking_coverage/_shared/interlocking.mjs": "99983d159528c7ef4e0a72f39f0dcc9977ffdcce728d52b83c4ef5bc70f2a3ec",
     "detectors/bun_interlocking_coverage/atdd.implementation.yaml": "f160517a8138ba3ca05e3d130e6fbfb796e643376f25743fdef4fc210196525b",
     "detectors/bun_interlocking_coverage/checks/_map.json": "0a218ea319cc6258af7bd721c2154cb9561fe67e80d80ef32d08fc77bc9403c3",
     "detectors/bun_interlocking_coverage/checks/interlocking_production_runner.mjs": "a1edd5aa15892564aa8d46a93dca2d17001901e90085cd660be192a2ec747c1f",
@@ -427,7 +427,7 @@
     "detectors/bun_interlocking_coverage/fixtures/dirty/interlocking_train_sequence/plan/_trains/_interlockings/match-resolution.yaml": "9e0f02cb0889826f2ac2fb88cd8c118c97d4321dcc5fccc0b767a511606841e6",
     "detectors/bun_interlocking_coverage/fixtures/dirty/interlocking_train_sequence/plan/_trains/train:match:match-resolution-standard.yaml": "9ea90f674e5fc565d8893e74ad2e47f273c971ca29284dbce58a366a3e832428",
     "detectors/bun_interlocking_coverage/fixtures/dirty/interlocking_train_sequence/plan/_trains/train:match:match-resolution-timeout.yaml": "aa1b7682f99f3a9a25ec0d3d03f3798ddda8c74eb728e148b38197ddab292493",
-    "detectors/bun_interlocking_infrastructure/_shared/interlocking.mjs": "433977b3b8242c0f061924c53e9f7488cd5cc7368edacbe007c14d749cc805f4",
+    "detectors/bun_interlocking_infrastructure/_shared/interlocking.mjs": "fa99c71ce8431e99af87efd31db9196516c44b0a42211764b421bf9b73c68ea6",
     "detectors/bun_interlocking_infrastructure/atdd.implementation.yaml": "fa7a1de97b19dff6515100131a3b6fc2dacf2766cd2bd44bc9dd792f6b01590d",
     "detectors/bun_interlocking_infrastructure/checks/_map.json": "5f86408f98de8f1562e679e2bd3a2194a8eb297fecf677ca774f19905942ec71",
     "detectors/bun_interlocking_infrastructure/checks/interlocking_delegates.mjs": "1aa4c87e234643e99ba5a2ff1fab3db8bfc7cbc9618c8e1a014eef2c11cce9c7",
@@ -558,7 +558,7 @@
     "detectors/bun_telemetry_code/fixtures/dirty/telemetry/commons/response-invocation-accepted/event.be.json": "cbf0ca07f717745edd88876a1c75880d7ae5755292cae4af10e1f9a2b8fccc9a",
     "detectors/bun_telemetry_code/fixtures/dirty/tests/wagons/commons/features/ingress/unit/probe.test.ts": "4dca357fbeb14c6423975e422a047b6bec3e352b2b687a809fb6d59b8f66ee0c",
     "detectors/bun_telemetry_code/registry.mjs": "ccb169a31f02d7a6af379a8c1d6a548ef688a7885e925826a43c1e0bcf670097",
-    "detectors/bun_telemetry_test/_shared.mjs": "425340b41f958c4164f4e808633d8f5b27533280f516b7b176f58f1531da9e6c",
+    "detectors/bun_telemetry_test/_shared.mjs": "bb2ad89de8ff8e683efbdc5dc43bab4214cc469ad998f3477abc0a28c999f746",
     "detectors/bun_telemetry_test/atdd.implementation.yaml": "0bbe065a0cdebdf581b4a9a17b258421cb3619070d21fe44f0dbc7e765f47681",
     "detectors/bun_telemetry_test/checks/t_captured_sink.mjs": "bc616b5fbf76cde18dc6a70256a8293a2cfad98bd6a656b11608ebb1befe0d0f",
     "detectors/bun_telemetry_test/checks/t_identity_assertion.mjs": "10f089ac696cc1bb6024c6dea831d928843037395458f5a6882ecd72041b7f2d",
@@ -643,7 +643,7 @@
     "detectors/bun_tester_discipline_detector/fixtures/dirty/unresolvable_binding.test.ts": "fd878356127cd66c05a1ab2c461982366f3a757895decf19cf24634f2c476d44",
     "detectors/bun_tester_discipline_detector/fixtures/dirty/vacuous.red.test.ts": "deea6befc7f87aa54b52df40f1032e4b547cb1336da3aec985c76aeb5097364a",
     "detectors/bun_tester_discipline_detector/fixtures/dirty/wrongruntime.test.ts": "041e421ef2b2810545020b5945733822dcae416d3360657217d3bab901cc2cdd",
-    "detectors/bun_tester_discipline_detector/test_header.mjs": "f4b5934bb08cfc3b3c0b4fc33b4136662c6643f1cad9e47d270214b5b2b48cd4",
+    "detectors/bun_tester_discipline_detector/test_header.mjs": "f66c371c6428eccc88b2d336e5960b44dbe3b3e81bc3eb48d3ba78d889ba6a70",
     "detectors/bun_ts_metrics_detector/atdd.implementation.yaml": "6ced804a5fdc82b6cd52be21ebacefa5d3261fca03a391178b2bf21186776364",
     "detectors/bun_ts_metrics_detector/checks/_map.json": "ed7c198564a80252f92e8ba2f50352daa1476ea88a23bfc0b3630e58c688f95d",
     "detectors/bun_ts_metrics_detector/checks/ts_complexity_cyclomatic.mjs": "56640b3a0f565c45a73b7c174adb1d6b4b6ac24d286a907bc1426f013cd6039e",
@@ -971,7 +971,7 @@
     "lib/frontend.mjs": "d6d9b29c3d7f2d162cda03bb34b20a3224a82887b6be3db7cab375510913c9a3",
     "lib/imports.mjs": "3db4979269488fa26f6e7aefded6ece9c646be6587a10e249821a5a208109962",
     "lib/interlocking.mjs": "d0803d080ac7d7477c51be70112df1e85213d339fd3c6b71f75f26145fa8accd",
-    "lib/scan.mjs": "8aa21e400ec415e23d49e0cc90fba2744822b8855261c85614e89c7cf35c4700",
+    "lib/scan.mjs": "925847f91a46c8ca1bdcfd44a047e67c68441a047c51ff496b253b422baddb97",
     "planner-nodes/ENFORCEMENT_SCOPE.yaml": "d8ec7039c219857f3d77af5d4d84612b533b69c1a5fcef935fbf46470adafed4",
     "planner-nodes/nodes/planner.acceptance.abstract-fields-required.convention.yaml": "bd565693f0ae861f0561ad2f7a91a8c55f9a209c3acd59c5750cfcffd96a85d8",
     "planner-nodes/nodes/planner.acceptance.authoring-guidelines.convention.yaml": "16348dceed5868041b832bde766e9c8d4a950d4032f1f3066b357644081a3b17",
@@ -1196,9 +1196,9 @@
     "relationships.yaml": "1cb713364aff54fb6e299e0737fe75a5d7b2e1dbd0a79b16b793aa1d269207b5",
     "src/agent.ts": "65e4579adb5a54977f557f8c783aba0e2a2a1d5cf3cea9f017b67ffe598b2f65",
     "src/board-ui.ts": "16a843705552f8f18e0e328e90e4a2a9148d771ca69f2708fe4a91302947dfad",
-    "src/board.ts": "a3a8efe923858b9b5cf5ca3682dacfceb5557f8303d818687eb1325a15fa1782",
+    "src/board.ts": "72893289118461fbcee460d43f91e93fe4b078cabf171c03152c447eb8b71bb9",
     "src/ci.ts": "67e54d2cbfc44a9e42837d5e750af526d6255c539d3c452a4d5fca3226c0d9ac",
-    "src/cli.ts": "e45f2666334503a91eb65b1b5ee4dd8acab6b99f62d333e2ee2b65963db6358b",
+    "src/cli.ts": "c1a7becd490ef9bf024569a869abc3b62ef48c0382897455e40fac9142d5ce46",
     "src/delivery.ts": "f6bb6a7c42693d795b964c77b6186e1ca3a1556fd43932911a0ad42e72e7e441",
     "src/docs-capability.ts": "115cf27049a5cf19c133bac5ec237072be6f969a59a2ef6767e054108a21dc5c",
     "src/enforce.ts": "41a6f8c058a2a034996c817f224191403cc66ccc4ed4e04bbefc430014c783d8",

package/lib/scan.mjs

@@ -13,7 +13,7 @@
 // their actual detection logic — and keeps them under the duplication convention
 // the coder extension itself enforces.
 import { readFileSync, writeFileSync, statSync, readdirSync } from "node:fs";
-import { join, extname, sep } from "node:path";
+import { join, extname, sep, resolve, relative } from "node:path";
 
 // Build output and vendored trees are never source-under-inspection. `.atdd` is
 // excluded by the adapter, not here, because a consumer's `.atdd/config.yaml` is
@@ -41,9 +41,29 @@ export function parseJsonEnv(name, fallback) {
   }
 }
 
+// Excludes are matched against the path RELATIVE to the scan root that contains it, as whole consecutive segments:
+// `build` excludes a folder named build, never `building`, and `.atdd/workspaces` still matches its two segments.
+// Matching the absolute path by substring excluded every file of a checkout living under, say,
+// ~/Github/frg-workstation-building-profile-activation, so every profile passed blind (FWS #U3vqdzo2RwFa).
+const SCAN_ROOT_PATHS = (() => {
+  try {
+    const v = JSON.parse(process.env.ATDD_SCAN_ROOTS || "[]");
+    return Array.isArray(v) ? v.filter((x) => typeof x === "string").map((r) => resolve(r)) : [];
+  } catch { return []; }
+})();
+export function excludedPath(path, excludes) {
+  const abs = resolve(path);
+  const root = SCAN_ROOT_PATHS.filter((r) => abs === r || abs.startsWith(r + sep)).sort((a, b) => b.length - a.length)[0];
+  const segs = (root ? relative(root, abs) : abs).split(/[\\/]+/).filter(Boolean);
+  return excludes.some((ex) => {
+    const parts = String(ex).split(/[\\/]+/).filter(Boolean);
+    for (let i = 0; parts.length && i + parts.length <= segs.length; i++) if (parts.every((part, j) => segs[i + j] === part)) return true;
+    return false;
+  });
+}
+
 function isExcluded(path, excludes) {
-  const segments = path.split(sep);
-  return excludes.some((ex) => segments.includes(ex) || path.includes(ex));
+  return excludedPath(path, excludes);
 }
 
 // Yield every file under `root` whose extension is in `exts`. `includeTests`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@afokapu/atdd-bun",
-  "version": "0.10.24",
+  "version": "0.10.26",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/afokapu/atdd-bun.git"

package/src/board.ts

@@ -164,6 +164,19 @@ export async function chat(args: string[], env: Record<string, string | undefine
       console.log(format(message, topics.length > 1));
       return 0;
     }
+    if (command === "follow") {
+      // The listener for a host that wakes its agent on each line a running process prints: every message addressed to
+      // this identity, as it arrives, until --timeout (seconds; none = until stopped). Same place-keeping as wait.
+      const file = cursorFile(me, topics, env), skip = list(flag("skip")), total = Number(flag("timeout") ?? 0);
+      const deadline = total > 0 ? Date.now() + total * 1000 : Infinity;
+      let since = flag("since") || loadCursor(file) || "all";
+      for (;;) {
+        const left = Math.ceil((deadline - Date.now()) / 1000);
+        if (left <= 0) return 0;
+        const message = await waitFor(url, topics, me, since, Math.min(60, left), skip, 500, id => { since = id; saveCursor(file, id); });
+        if (message) console.log(format(message, topics.length > 1));
+      }
+    }
     if (topics.length !== 1) throw new Error(`${command} takes one topic`);
     const topic = topics[0];
     if (command === "post") {

package/src/cli.ts

@@ -26,6 +26,7 @@ const usage = {
     "atdd-bun chat post <topic> --to <agent,...> [--kind K] [--stage S] [--reply-to ID] [--repo R] [--branch B] [--worktree W] [--goal G]  (body on stdin)",
     "atdd-bun chat read <topic> [--mine] [--since ID]",
     "atdd-bun chat wait <topic[,topic...]> [--since ID] [--skip KIND,...] [--timeout SECONDS]",
+    "atdd-bun chat follow <topic[,topic...]> [--since ID] [--skip KIND,...] [--timeout SECONDS]",
     "atdd-bun chat                      (the board: every topic on the left, the conversation on the right)",
   ],
   profiles: profileNames,