sensorium-mcp 3.1.2 → 3.1.3-board.2

package/dist/services/board/orchestrator.service.js

@@ -0,0 +1,198 @@
+/**
+ * Board orchestrator — the server-side loop that drains the board (design §3).
+ *
+ * Tick (default 30 s): for each CONNECTED lane, while the lane has free
+ * concurrency slots (default 1) and the global cap (default 3) is not reached,
+ * dispatch the top-priority Backlog card: spawn a stateless card-worker,
+ * move the card to In Progress, and emit the STARTED signal. No idle-gate on
+ * the lane thread — workers are independent processes; the lane may be dormant.
+ *
+ * Spawn failure is an immediate BLOCKED (reason on the card) — the operator
+ * hears about it once, on the card, per the fire-and-forget metric.
+ *
+ * Report capture / exit reconciliation / recurrence land in Phases 5 and 7.
+ */
+import { log } from "../../lib/logger.js";
+import { errorMessage } from "../../lib/utils.js";
+import { archiveDoneOlderThan, bindWorkerToCard, claimCardForDispatch, countInProgress, createCard, getCard, getNextDispatchableCard, listCards, listDueRecurrences, updateCard, } from "../../data/board/card.repository.js";
+import { reconcileInProgressCards } from "./report-capture.js";
+import { addComment, listComments } from "../../data/board/comment.repository.js";
+import { listConnectedLanes } from "../../data/board/lane.repository.js";
+import { sendBoardSignal } from "./board-signals.js";
+import { spawnCardWorker } from "./worker-spawn.js";
+// Board env knobs are read PER CALL, consistently with BOARD_SIGNAL_DELIVERY /
+// BOARD_MAIN_THREAD_ID in board-signals (a load-time snapshot for some knobs
+// and live reads for others was a review nit — and per-call lets the cap be
+// changed without a restart). The tick interval alone is bound at start().
+export function boardTickMs() {
+    const s = Number(process.env.BOARD_TICK_SECONDS);
+    return Number.isFinite(s) && s >= 5 ? s * 1000 : 30_000;
+}
+export function boardGlobalMaxConcurrent() {
+    const n = Number(process.env.BOARD_MAX_CONCURRENT);
+    return Number.isInteger(n) && n > 0 ? n : 3;
+}
+/** Kill-switch: BOARD_ENABLED=false skips orchestrator start entirely (the
+ *  board stays a dormant UI/API). Default: enabled. */
+export function boardEnabled() {
+    return process.env.BOARD_ENABLED !== "false";
+}
+export class BoardOrchestrator {
+    deps;
+    timer = null;
+    tickInFlight = false;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    start() {
+        if (this.timer)
+            return;
+        if (!boardEnabled()) {
+            log.info("[board] orchestrator disabled via BOARD_ENABLED=false — board is UI/API only");
+            return;
+        }
+        const tickMs = boardTickMs();
+        this.timer = setInterval(() => void this.tick(), tickMs);
+        this.timer.unref();
+        void this.tick();
+        log.info(`[board] orchestrator started (tick ${tickMs / 1000}s, global cap ${boardGlobalMaxConcurrent()})`);
+    }
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+    }
+    async tick() {
+        if (this.tickInFlight)
+            return; // a slow spawn must not stack ticks
+        this.tickInFlight = true;
+        try {
+            // Backstop first (covers server restarts and silent worker deaths), so a
+            // freed lane slot can be re-used by the dispatch pass in the same tick.
+            const db = this.deps.getMemoryDb();
+            const blocked = await reconcileInProgressCards(db, () => listCards(db, { status: "in_progress" }));
+            if (blocked > 0)
+                log.warn(`[board] reconciled ${blocked} orphaned in_progress card(s) → blocked`);
+            this.respawnDueRecurrences(db);
+            await this.dispatchDueCards();
+            // Done-column hygiene: hide (never delete) finished one-shots after 14 days.
+            const archived = archiveDoneOlderThan(db, 14);
+            if (archived > 0)
+                log.info(`[board] auto-archived ${archived} old done card(s)`);
+        }
+        catch (err) {
+            log.error(`[board] tick failed: ${errorMessage(err)}`);
+        }
+        finally {
+            this.tickInFlight = false;
+        }
+    }
+    /**
+     * Board-owned recurrence (design §4): a Done recurring card whose delay has
+     * elapsed — and whose group has no live instance (enforced in SQL) — puts a
+     * fresh identical copy back into Backlog. The original's next_spawn_at is
+     * cleared so it never respawns twice; the copy carries the group id forward.
+     * schedule_wake_up is untouched — this is a different mechanism by design.
+     */
+    respawnDueRecurrences(db) {
+        // One respawn per group per tick even if the query returns several due
+        // done rows of the same group (crash legacy can leave two rows with
+        // next_spawn_at set — see the group-wide clear below, which heals that).
+        const seenGroups = new Set();
+        const nowIso = new Date().toISOString();
+        for (const original of listDueRecurrences(db, nowIso)) {
+            const groupId = original.recurGroupId ?? original.cardId;
+            if (seenGroups.has(groupId))
+                continue;
+            seenGroups.add(groupId);
+            // Copy-insert and spawn-time clear are one atomic unit: a crash between
+            // them must never leave BOTH a live copy and a still-due original (H3).
+            const respawn = db.transaction(() => {
+                // M6: the group-wide clear runs FIRST as a compare-and-set — its WHERE
+                // carries the due predicate, so it updates rows only while a due
+                // original still exists. Two overlapping orchestrators that both read
+                // the same due original race here; exactly one wins (changes > 0) and
+                // creates the copy — the loser sees changes === 0 and skips, so no
+                // duplicate copy is inserted. The group-wide (not one-row) scope also
+                // heals legacy state where a crash left several due rows in the group.
+                const cleared = db
+                    .prepare(`UPDATE board_cards SET next_spawn_at = NULL
+             WHERE recur_group_id = ? AND status = 'done'
+               AND next_spawn_at IS NOT NULL AND next_spawn_at <= ?`)
+                    .run(groupId, nowIso);
+                if (cleared.changes === 0)
+                    return undefined;
+                const copy = createCard(db, {
+                    title: original.title,
+                    description: original.description,
+                    acceptance: original.acceptance,
+                    type: original.type,
+                    laneThreadId: original.laneThreadId,
+                    priority: original.priority,
+                    profile: original.profile,
+                    escalate: original.escalate,
+                    recurDelayMin: original.recurDelayMin ?? undefined,
+                    recurGroupId: groupId,
+                });
+                addComment(db, copy.cardId, "board", `Respawned from recurring card #${original.cardId}.`);
+                addComment(db, original.cardId, "board", `Recurring: fresh copy #${copy.cardId} queued.`);
+                return copy;
+            })();
+            if (respawn)
+                log.info(`[board] recurring card ${original.cardId} respawned as ${respawn.cardId}`);
+        }
+    }
+    async dispatchDueCards() {
+        const db = this.deps.getMemoryDb();
+        const globalCap = boardGlobalMaxConcurrent();
+        let totalInProgress = countInProgress(db);
+        for (const lane of listConnectedLanes(db)) {
+            while (totalInProgress < globalCap) {
+                if (countInProgress(db, lane.threadId) >= lane.maxConcurrent)
+                    break;
+                const card = getNextDispatchableCard(db, lane.threadId);
+                if (!card)
+                    break;
+                // Atomic compare-and-set claim BEFORE the (slow, async) spawn: a
+                // concurrent orchestrator (self-update overlap) or an operator move
+                // loses or wins here exactly once — never both spawning (H1).
+                if (!claimCardForDispatch(db, card.cardId))
+                    continue;
+                const spawn = await (this.deps.spawnFn ?? spawnCardWorker)({
+                    db,
+                    telegram: this.deps.telegram,
+                    chatId: this.deps.chatId,
+                    threadLifecycle: this.deps.threadLifecycle,
+                }, card, listComments(db, card.cardId));
+                if ("error" in spawn) {
+                    // One BLOCKED touch instead of a silent retry loop: the reason is on
+                    // the card; a later operator resume re-dispatches cleanly.
+                    log.warn(`[board] dispatch of card ${card.cardId} failed: ${spawn.error}`);
+                    addComment(db, card.cardId, "board", `Dispatch failed: ${spawn.error}`);
+                    const blocked = updateCard(db, card.cardId, {
+                        status: "blocked",
+                        blockedReason: `Dispatch failed: ${spawn.error}`,
+                    });
+                    if (blocked)
+                        sendBoardSignal(blocked, "BLOCKED", spawn.error);
+                    continue;
+                }
+                // Guarded bind: only while the claim still stands. If the operator
+                // moved/deleted the card during the spawn, their action wins — log the
+                // orphaned worker instead of clobbering the card (TOCTOU close).
+                if (!bindWorkerToCard(db, card.cardId, spawn.workerThreadId)) {
+                    log.warn(`[board] card ${card.cardId} changed during spawn — worker ${spawn.workerThreadId} left to idle out (worker TTL reaps it)`);
+                    continue;
+                }
+                addComment(db, card.cardId, "board", `Worker ${spawn.workerThreadId} spawned.`);
+                const updated = getCard(db, card.cardId);
+                if (updated)
+                    sendBoardSignal(updated, "STARTED");
+                totalInProgress++;
+            }
+            if (totalInProgress >= globalCap)
+                break;
+        }
+    }
+}
+//# sourceMappingURL=orchestrator.service.js.map

package/dist/services/board/orchestrator.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.service.js","sourceRoot":"","sources":["../../../src/services/board/orchestrator.service.ts"],"names":[],"mappings":"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"}

package/dist/services/board/release-worker.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Board-side "release worker" (R1) — the single decommission path the board
+ * owns (design §2 R1). Whenever an operator action moves a card OUT of
+ * in_progress by ANY path (Stop, re-run→backlog, →done, delete), the bound
+ * worker must be killed AND torn down first, or the next tick spawns a second
+ * worker on the same card → duplicate branch/PR/push and a lost report.
+ *
+ * The route layer has DB pointers but not the telegram/threadLifecycle deps
+ * `decommissionWorker` needs; those are carried on DashboardContext so this one
+ * function can wire them through. It is idempotent and safe to call for a card
+ * with no live worker (already reported/dead) — decommission just does teardown.
+ */
+import type { initMemoryDb } from "../../data/memory/index.js";
+import type { ThreadLifecycleService } from "../thread-lifecycle.service.js";
+export interface ReleaseWorkerDeps {
+    db: ReturnType<typeof initMemoryDb>;
+    telegram: {
+        deleteForumTopic(chatId: string, threadId: number): Promise<void>;
+    };
+    chatId: string;
+    threadLifecycle: ThreadLifecycleService;
+}
+/**
+ * Decommission (kill + full teardown) the worker bound to a card, if any.
+ * Pass the card's current workerThreadId; a null/undefined value is a no-op.
+ *
+ * Resolves the live PID via findAliveThread so the kill actually lands — passing
+ * only { threadId } would make decommissionWorker treat the process as already
+ * gone and skip the kill, leaving a live worker running (the exact B1 bug).
+ */
+export declare function releaseWorkerForCard(deps: ReleaseWorkerDeps, workerThreadId: number | null | undefined): Promise<void>;
+//# sourceMappingURL=release-worker.d.ts.map

package/dist/services/board/release-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-worker.d.ts","sourceRoot":"","sources":["../../../src/services/board/release-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAK7E,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACpC,QAAQ,EAAE;QAAE,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,sBAAsB,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,iBAAiB,EACvB,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACxC,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/services/board/release-worker.js

@@ -0,0 +1,49 @@
+/**
+ * Board-side "release worker" (R1) — the single decommission path the board
+ * owns (design §2 R1). Whenever an operator action moves a card OUT of
+ * in_progress by ANY path (Stop, re-run→backlog, →done, delete), the bound
+ * worker must be killed AND torn down first, or the next tick spawns a second
+ * worker on the same card → duplicate branch/PR/push and a lost report.
+ *
+ * The route layer has DB pointers but not the telegram/threadLifecycle deps
+ * `decommissionWorker` needs; those are carried on DashboardContext so this one
+ * function can wire them through. It is idempotent and safe to call for a card
+ * with no live worker (already reported/dead) — decommission just does teardown.
+ */
+import { log } from "../../lib/logger.js";
+import { errorMessage } from "../../lib/utils.js";
+import { findAliveThread } from "../process.service.js";
+import { getThread } from "../../data/memory/thread-registry.js";
+import { decommissionWorker } from "../worker-cleanup.service.js";
+/**
+ * Decommission (kill + full teardown) the worker bound to a card, if any.
+ * Pass the card's current workerThreadId; a null/undefined value is a no-op.
+ *
+ * Resolves the live PID via findAliveThread so the kill actually lands — passing
+ * only { threadId } would make decommissionWorker treat the process as already
+ * gone and skip the kill, leaving a live worker running (the exact B1 bug).
+ */
+export async function releaseWorkerForCard(deps, workerThreadId) {
+    if (workerThreadId == null)
+        return;
+    try {
+        const alive = await findAliveThread(workerThreadId);
+        const target = alive ?? {
+            threadId: workerThreadId,
+            name: getThread(deps.db, workerThreadId)?.name ?? `Thread ${workerThreadId}`,
+        };
+        await decommissionWorker(target, {
+            db: deps.db,
+            telegram: deps.telegram,
+            chatId: deps.chatId,
+            threadLifecycle: deps.threadLifecycle,
+        });
+    }
+    catch (err) {
+        // Never let a teardown hiccup abort the operator's move — the card is about
+        // to leave in_progress regardless; a stragging worker is caught by the TTL
+        // sweep / dead-worker reconcile. Surface it for diagnosis.
+        log.warn(`[board] releaseWorkerForCard(${workerThreadId}) failed: ${errorMessage(err)}`);
+    }
+}
+//# sourceMappingURL=release-worker.js.map

package/dist/services/board/release-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-worker.js","sourceRoot":"","sources":["../../../src/services/board/release-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AASlE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAuB,EACvB,cAAyC;IAEzC,IAAI,cAAc,IAAI,IAAI;QAAE,OAAO;IACnC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,cAAc,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,KAAK,IAAI;YACtB,QAAQ,EAAE,cAAc;YACxB,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,CAAC,EAAE,IAAI,IAAI,UAAU,cAAc,EAAE;SAC7E,CAAC;QACF,MAAM,kBAAkB,CAAC,MAAM,EAAE;YAC/B,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,4EAA4E;QAC5E,2EAA2E;QAC3E,2DAA2D;QAC3D,GAAG,CAAC,IAAI,CAAC,gCAAgC,cAAc,aAAa,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;AACH,CAAC"}

package/dist/services/board/report-capture.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Card-worker report capture (design §3.3–§3.4) — zero new MCP tools.
+ *
+ * A card-worker reports through the ordinary send_message_to_thread(reply)
+ * path; the board intercepts it server-side when (and only when) the sender is
+ * the bound worker of an in_progress card AND the target is that card's lane.
+ * The body becomes a card comment, the STATUS first line moves the card, the
+ * lane gets its single one-line DONE/BLOCKED signal — nothing reaches the lane
+ * mailbox. Any other send from the worker flows untouched.
+ *
+ * Safety nets: handleCardWorkerExit (idempotent) blocks a card whose worker
+ * died without a final report — fired from the worker teardown paths; and
+ * reconcileInProgressCards is the orchestrator-tick backstop that catches
+ * silent deaths across server restarts.
+ */
+import type { initMemoryDb } from "../../data/memory/index.js";
+import type { BoardCard } from "../../data/board/board-types.js";
+type Db = ReturnType<typeof initMemoryDb>;
+type ReportStatus = {
+    kind: "done";
+} | {
+    kind: "blocked";
+    reason: string;
+} | {
+    kind: "interim";
+};
+/** Parse the report contract's first non-empty line. */
+export declare function parseReportStatus(message: string): ReportStatus;
+/**
+ * Intercept a worker→lane send. Returns true when the board consumed the
+ * message (the caller must NOT write it to the lane's mailbox).
+ */
+export declare function captureCardWorkerReport(db: Db, senderThreadId: number, targetThreadId: number, message: string): boolean;
+/**
+ * Idempotent exit safety net: a card-worker died/teardown'd while its card is
+ * still in_progress and bound to it → the card is Blocked with the exit as the
+ * reason. No-op when the worker already reported (capture unbinds the worker).
+ */
+export declare function handleCardWorkerExit(db: Db, workerThreadId: number, exitCode: number | null): void;
+/**
+ * Orchestrator-tick backstop (covers server restarts, where no exit event ever
+ * fires): any in_progress card bound to a worker that is not running — and old
+ * enough that a spawn race is impossible — goes to Blocked. Also frees cards
+ * that were claimed but never bound a worker (dispatch died mid-flight).
+ */
+export declare function reconcileInProgressCards(db: Db, listInProgress: () => BoardCard[]): Promise<number>;
+export {};
+//# sourceMappingURL=report-capture.d.ts.map

package/dist/services/board/report-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-capture.d.ts","sourceRoot":"","sources":["../../../src/services/board/report-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAW/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAEjE,KAAK,EAAE,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AAE1C,KAAK,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEjG,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAS/D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,EAAE,EACN,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAuCT;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,EAAE,EACN,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,IAAI,CAyBN;AA8BD;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,EAAE,EACN,cAAc,EAAE,MAAM,SAAS,EAAE,GAChC,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/dist/services/board/report-capture.js

@@ -0,0 +1,172 @@
+/**
+ * Card-worker report capture (design §3.3–§3.4) — zero new MCP tools.
+ *
+ * A card-worker reports through the ordinary send_message_to_thread(reply)
+ * path; the board intercepts it server-side when (and only when) the sender is
+ * the bound worker of an in_progress card AND the target is that card's lane.
+ * The body becomes a card comment, the STATUS first line moves the card, the
+ * lane gets its single one-line DONE/BLOCKED signal — nothing reaches the lane
+ * mailbox. Any other send from the worker flows untouched.
+ *
+ * Safety nets: handleCardWorkerExit (idempotent) blocks a card whose worker
+ * died without a final report — fired from the worker teardown paths; and
+ * reconcileInProgressCards is the orchestrator-tick backstop that catches
+ * silent deaths across server restarts.
+ */
+import { log } from "../../lib/logger.js";
+import { errorMessage } from "../../lib/utils.js";
+import { buildDonePatch, blockBoundWorkerCard, blockUnboundCard, findCardByWorkerThread, updateCard, } from "../../data/board/card.repository.js";
+import { addComment } from "../../data/board/comment.repository.js";
+import { isThreadAlive } from "../process.service.js";
+import { mirrorEscalatedUpdate, sendBoardSignal } from "./board-signals.js";
+/** Parse the report contract's first non-empty line. */
+export function parseReportStatus(message) {
+    const firstLine = message
+        .split("\n")
+        .map((l) => l.trim())
+        .find((l) => l.length > 0);
+    const match = firstLine ? /^STATUS:\s*(DONE|BLOCKED)\s*:?\s*(.*)$/i.exec(firstLine) : null;
+    if (!match)
+        return { kind: "interim" };
+    if (match[1].toUpperCase() === "DONE")
+        return { kind: "done" };
+    return { kind: "blocked", reason: match[2].trim() || "no reason given" };
+}
+/**
+ * Intercept a worker→lane send. Returns true when the board consumed the
+ * message (the caller must NOT write it to the lane's mailbox).
+ */
+export function captureCardWorkerReport(db, senderThreadId, targetThreadId, message) {
+    let card;
+    try {
+        card = findCardByWorkerThread(db, senderThreadId);
+    }
+    catch (err) {
+        log.warn(`[board] report-capture lookup failed: ${errorMessage(err)}`);
+        return false;
+    }
+    if (!card || card.laneThreadId !== targetThreadId)
+        return false;
+    try {
+        addComment(db, card.cardId, "worker", message);
+        mirrorEscalatedUpdate(card, message);
+        const status = parseReportStatus(message);
+        if (status.kind === "done") {
+            const updated = updateCard(db, card.cardId, buildDonePatch(card));
+            if (updated)
+                sendBoardSignal(updated, "DONE");
+            log.info(`[board] card ${card.cardId} DONE (worker ${senderThreadId} reported)`);
+        }
+        else if (status.kind === "blocked") {
+            const updated = updateCard(db, card.cardId, {
+                status: "blocked",
+                blockedReason: status.reason,
+                workerThreadId: null,
+            });
+            if (updated)
+                sendBoardSignal(updated, "BLOCKED", status.reason);
+            log.info(`[board] card ${card.cardId} BLOCKED (worker ${senderThreadId}): ${status.reason}`);
+        }
+        else {
+            // No STATUS line — an interim update. It lives on the card (its own
+            // inbox); the card stays in_progress and the worker stays bound so the
+            // exit safety net still applies.
+            log.info(`[board] card ${card.cardId} interim comment from worker ${senderThreadId}`);
+        }
+    }
+    catch (err) {
+        // The message was NOT durably captured — let it flow to the mailbox rather
+        // than vanish (the lane agent seeing one raw report beats losing it).
+        log.error(`[board] report capture failed for card ${card.cardId}: ${errorMessage(err)}`);
+        return false;
+    }
+    return true;
+}
+/**
+ * Idempotent exit safety net: a card-worker died/teardown'd while its card is
+ * still in_progress and bound to it → the card is Blocked with the exit as the
+ * reason. No-op when the worker already reported (capture unbinds the worker).
+ */
+export function handleCardWorkerExit(db, workerThreadId, exitCode) {
+    try {
+        const card = findCardByWorkerThread(db, workerThreadId);
+        if (!card)
+            return;
+        const reason = exitCode == null
+            ? "Worker is gone (exit code unknown — found dead by a sweep) without a final report."
+            : exitCode === 0
+                ? "Worker exited cleanly (code 0) WITHOUT posting its STATUS report — likely forgot the report contract."
+                : `Worker crashed (exit code ${exitCode}) without a final report.`;
+        // Compare-and-set: only this caller that actually flips the card (still
+        // in_progress AND still bound to this worker) emits the BLOCKED signal.
+        // A racing caller (worker teardown vs reconcile tick, cross-process) that
+        // changes 0 rows means another path already handled it → no-op.
+        const updated = blockBoundWorkerCard(db, card.cardId, workerThreadId, reason);
+        if (!updated)
+            return;
+        addComment(db, card.cardId, "board", reason);
+        mirrorEscalatedUpdate(updated, reason);
+        sendBoardSignal(updated, "BLOCKED", reason);
+        log.warn(`[board] card ${card.cardId}: ${reason} (worker ${workerThreadId})`);
+    }
+    catch (err) {
+        log.warn(`[board] card-worker exit handling failed for ${workerThreadId}: ${errorMessage(err)}`);
+    }
+}
+/** Ignore cards whose worker was spawned less than this long ago (spawn races). */
+const RECONCILE_MIN_AGE_MS = 2 * 60_000;
+/**
+ * A claimed-but-unbound card (in_progress, no worker) is only reconciled once
+ * it is well past the worst-case spawn latency — comfortably above the 2-min
+ * bound-worker liveness check so a still-in-flight dispatch is never mistaken
+ * for a wedged one.
+ */
+const RECONCILE_UNBOUND_MIN_AGE_MS = 15 * 60_000;
+/**
+ * Block a claimed-but-unbound card whose dispatch never completed (the claim
+ * set started_at + in_progress, then the process died or the spawn threw before
+ * bindWorkerToCard ran). Without this the card would eat a lane + global cap
+ * slot forever. CAS-guarded so a late bind / concurrent tick cannot double-block.
+ */
+function reconcileUnboundCard(db, card) {
+    const reason = "dispatch did not complete (no worker bound)";
+    const updated = blockUnboundCard(db, card.cardId, reason);
+    if (!updated)
+        return false;
+    addComment(db, card.cardId, "board", reason);
+    mirrorEscalatedUpdate(updated, reason);
+    sendBoardSignal(updated, "BLOCKED", reason);
+    log.warn(`[board] card ${card.cardId}: ${reason} (claimed but never bound a worker)`);
+    return true;
+}
+/**
+ * Orchestrator-tick backstop (covers server restarts, where no exit event ever
+ * fires): any in_progress card bound to a worker that is not running — and old
+ * enough that a spawn race is impossible — goes to Blocked. Also frees cards
+ * that were claimed but never bound a worker (dispatch died mid-flight).
+ */
+export async function reconcileInProgressCards(db, listInProgress) {
+    let blocked = 0;
+    for (const card of listInProgress()) {
+        const ageMs = card.startedAt ? Date.now() - Date.parse(card.startedAt) : Infinity;
+        if (card.workerThreadId == null) {
+            // Claimed-but-unbound: reconcile only well past worst-case spawn latency.
+            if (ageMs > RECONCILE_UNBOUND_MIN_AGE_MS && reconcileUnboundCard(db, card))
+                blocked++;
+            continue;
+        }
+        if (!(ageMs > RECONCILE_MIN_AGE_MS))
+            continue;
+        try {
+            if (await isThreadAlive(card.workerThreadId))
+                continue;
+        }
+        catch {
+            continue; // cannot confirm → never block on uncertainty
+        }
+        handleCardWorkerExit(db, card.workerThreadId, null);
+        blocked++;
+    }
+    return blocked;
+}
+//# sourceMappingURL=report-capture.js.map

package/dist/services/board/report-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-capture.js","sourceRoot":"","sources":["../../../src/services/board/report-capture.ts"],"names":[],"mappings":"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"}

package/dist/services/board/worker-spawn.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Card-worker spawn path (design §3.1) — the board-side equivalent of
+ * handleStartThread's mode=worker branch (delegate-tool.ts), reusing the same
+ * primitives in the same order: topic create → agent-type set → pre-queue
+ * payload → dispatchSpawn(memorySourceThreadId=lane) → registerThread.
+ * The worker inherits the FULL lane-thread briefing via memorySourceThreadId
+ * (assembleBootstrap), with the card payload as its pre-queued task on top.
+ */
+import type { initMemoryDb } from "../../data/memory/index.js";
+import type { BoardCard, BoardComment } from "../../data/board/board-types.js";
+import type { ThreadLifecycleService } from "../thread-lifecycle.service.js";
+export interface CardWorkerSpawnDeps {
+    db: ReturnType<typeof initMemoryDb>;
+    telegram: {
+        createForumTopic(chatId: string, name: string): Promise<{
+            message_thread_id: number;
+        }>;
+        sendMessage(chatId: string, text: string, parseMode?: string, threadId?: number): Promise<unknown>;
+        deleteForumTopic(chatId: string, threadId: number): Promise<void>;
+    };
+    chatId: string;
+    threadLifecycle: ThreadLifecycleService;
+}
+export type CardWorkerSpawnResult = {
+    workerThreadId: number;
+} | {
+    error: string;
+};
+export declare function spawnCardWorker(deps: CardWorkerSpawnDeps, card: BoardCard, comments: BoardComment[]): Promise<CardWorkerSpawnResult>;
+//# sourceMappingURL=worker-spawn.d.ts.map

package/dist/services/board/worker-spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-spawn.d.ts","sourceRoot":"","sources":["../../../src/services/board/worker-spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAK/E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAG7E,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACpC,QAAQ,EAAE;QACR,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;YAAE,iBAAiB,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACvF,WAAW,CACT,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAAC;QACpB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnE,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,sBAAsB,CAAC;CACzC;AAED,MAAM,MAAM,qBAAqB,GAAG;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAKnF,wBAAsB,eAAe,CACnC,IAAI,EAAE,mBAAmB,EACzB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,YAAY,EAAE,GACvB,OAAO,CAAC,qBAAqB,CAAC,CAwFhC"}