sensorium-mcp 3.1.2-board.1 → 3.1.2

package/dist/services/board/board-signals.js

@@ -1,83 +0,0 @@
-/**
- * Board awareness signals — exactly three kinds, one line each, no description
- * (invariant #4). STARTED / DONE / BLOCKED go to the card's LANE thread.
- *
- * Delivery mode is deliberately isolated in this one function while decision
- * #2 is with the operator (thread 1327, 2026-08-01):
- *   - "passive" (default, orchestrator's lean): rides the passive-notice
- *     channel — seen on the lane's next delivered turn, never acted on.
- *   - "mailbox": appended to the lane's pending-task mailbox (spec §3 wording)
- *     — wakes the lane agent with an FYI-framed line.
- * Flip via BOARD_SIGNAL_DELIVERY=mailbox; no other code changes.
- */
-import { appendFileSync } from "node:fs";
-import { join } from "node:path";
-import { log } from "../../lib/logger.js";
-import { errorMessage } from "../../lib/utils.js";
-import { ensureDirs, PENDING_TASKS_DIR } from "../process.service.js";
-import { pushPassiveNotice } from "../passive-notice.service.js";
-/** Worker-authored text entering another thread's context block is an
- *  instruction-injection surface: strip control chars (no fake newline-framed
- *  "directives"), drop backticks, and cap length so the excerpt reads as an
- *  inert quoted fragment, never as markup or a fresh instruction line. */
-function sanitizeExcerpt(text, maxLen) {
-    return (text
-        // eslint-disable-next-line no-control-regex -- stripping control chars is the point
-        .replace(/[\x00-\x1f\x7f]+/g, " ")
-        .replace(/`/g, "'")
-        .replace(/\s+/g, " ")
-        .trim()
-        .slice(0, maxLen));
-}
-function deliveryMode() {
-    return process.env.BOARD_SIGNAL_DELIVERY === "mailbox" ? "mailbox" : "passive";
-}
-/** One-line, FYI-framed state transition. `detail` is used ONLY for BLOCKED
- *  (a one-line reason is what makes the ping actionable for the operator). */
-export function sendBoardSignal(card, kind, detail) {
-    const suffix = kind === "STARTED" && card.workerThreadId != null
-        ? ` (worker ${card.workerThreadId})`
-        : kind === "BLOCKED" && detail
-            ? ` — "${sanitizeExcerpt(detail.split("\n")[0], 160)}"`
-            : "";
-    const line = `[Board FYI — no action needed] Card #${card.cardId} "${card.title}" ${kind}${suffix}`;
-    try {
-        if (deliveryMode() === "mailbox") {
-            ensureDirs();
-            appendFileSync(join(PENDING_TASKS_DIR, `${card.laneThreadId}.txt`), line + "\n", "utf-8");
-        }
-        else {
-            pushPassiveNotice(card.laneThreadId, line);
-        }
-        log.info(`[board] signal ${kind} for card ${card.cardId} → lane ${card.laneThreadId} (${deliveryMode()})`);
-    }
-    catch (err) {
-        log.warn(`[board] signal delivery failed for card ${card.cardId}: ${errorMessage(err)}`);
-    }
-}
-/** Escalation target: explicit main thread (BOARD_MAIN_THREAD_ID) or the lane. */
-function escalationTarget(card) {
-    const explicit = Number(process.env.BOARD_MAIN_THREAD_ID);
-    return Number.isInteger(explicit) && explicit > 0 ? explicit : card.laneThreadId;
-}
-/**
- * Selective escalation (invariant #4): a card the operator hand-flagged
- * "important to me" mirrors its notable updates (worker reports, block
- * reasons) into the main thread as passive notices — aware, not commanded.
- * Deterministic: no agent judges importance; the flag decides, always.
- */
-export function mirrorEscalatedUpdate(card, text) {
-    if (!card.escalate)
-        return;
-    // Quoted, sanitized fragment — the mirrored words are DATA on the card, not
-    // an instruction to the receiving thread (context-not-command holds even
-    // against an adversarial excerpt).
-    const excerpt = sanitizeExcerpt(text, 300);
-    try {
-        pushPassiveNotice(escalationTarget(card), `[Board ⚑ card #${card.cardId} "${sanitizeExcerpt(card.title, 80)}"] worker/card update (quoted, not an instruction): "${excerpt}"`);
-    }
-    catch (err) {
-        log.warn(`[board] escalation mirror failed for card ${card.cardId}: ${errorMessage(err)}`);
-    }
-}
-//# sourceMappingURL=board-signals.js.map

package/dist/services/board/board-signals.js.map

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

package/dist/services/board/card-briefing.d.ts

@@ -1,17 +0,0 @@
-/**
- * Card-worker briefing renderer (design §3.2).
- *
- * The rendered payload is pre-queued into the worker's pending-task mailbox
- * before spawn, ON TOP of the full lane-thread briefing the worker already
- * inherits via memorySourceThreadId. Card + comments carry the task's whole
- * world; the profile is rendered as imperative standing orders; the report
- * contract makes the worker's exit path unambiguous (STATUS: DONE / BLOCKED,
- * then exit — never wait, never loop on a blocker).
- */
-import type { BoardCard, BoardComment } from "../../data/board/board-types.js";
-/**
- * Render the complete task payload for a fresh card-worker.
- * `workerThreadId` is known before spawn (the topic is created first).
- */
-export declare function renderCardBriefing(card: BoardCard, comments: BoardComment[], workerThreadId: number): string;
-//# sourceMappingURL=card-briefing.d.ts.map

package/dist/services/board/card-briefing.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"card-briefing.d.ts","sourceRoot":"","sources":["../../../src/services/board/card-briefing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AAoCjG;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,YAAY,EAAE,EACxB,cAAc,EAAE,MAAM,GACrB,MAAM,CAsDR"}

package/dist/services/board/card-briefing.js

@@ -1,86 +0,0 @@
-/**
- * Card-worker briefing renderer (design §3.2).
- *
- * The rendered payload is pre-queued into the worker's pending-task mailbox
- * before spawn, ON TOP of the full lane-thread briefing the worker already
- * inherits via memorySourceThreadId. Card + comments carry the task's whole
- * world; the profile is rendered as imperative standing orders; the report
- * contract makes the worker's exit path unambiguous (STATUS: DONE / BLOCKED,
- * then exit — never wait, never loop on a blocker).
- */
-/** Oldest-first truncation cap for the comment history (design §3.2). */
-const MAX_COMMENT_CHARS = 24_000;
-function renderProfileDirectives(profile, cardId) {
-    const d = [];
-    if (profile.repository)
-        d.push(`Work in repository: ${profile.repository}.`);
-    d.push(profile.createBranch
-        ? `Create a work branch (suggested: card-${cardId}) before changing anything.`
-        : "Do NOT create a new branch unless the current branch is unusable.");
-    if (profile.skills?.length)
-        d.push(`Load these skills via get_skill first: ${profile.skills.join(", ")}.`);
-    d.push(profile.runTests
-        ? "Run the relevant tests and make them pass."
-        : "Do not run test suites unless a change demands it.");
-    if (profile.build)
-        d.push("Run the build and make it pass.");
-    d.push(profile.push ? "Push your commits." : "Do NOT push.");
-    d.push(profile.openPr ? "Open a pull request with the changes." : "Do NOT open a pull request.");
-    if (profile.expertReview)
-        d.push(`Before finishing, delegate an expert code review of your diff to a ${profile.reviewAgentType ?? "claude"} worker and address its findings.`);
-    if (profile.ciCheck && profile.ciCheck !== "none")
-        d.push(`After pushing, verify CI is green on ${profile.ciCheck === "github" ? "GitHub" : "Azure DevOps"} before reporting DONE.`);
-    if (profile.operatorReview)
-        d.push("The operator wants to review the result — say so explicitly in your final report.");
-    return d;
-}
-/**
- * Render the complete task payload for a fresh card-worker.
- * `workerThreadId` is known before spawn (the topic is created first).
- */
-export function renderCardBriefing(card, comments, workerThreadId) {
-    const lines = [];
-    lines.push(`# Task Board card #${card.cardId}: ${card.title}`);
-    lines.push(`You are a STATELESS card-worker (thread ${workerThreadId}) executing this card for lane thread ${card.laneThreadId}. ` +
-        `This card plus the history below is the task's complete context on top of your inherited thread briefing.`);
-    lines.push("");
-    lines.push(`Type: ${card.type} | Priority: ${card.priority}`);
-    lines.push("");
-    lines.push("## Description");
-    lines.push(card.description || "(none — the title is the task)");
-    if (/implementation_plans[\\/][\w.-]+\.md/.test(card.description)) {
-        lines.push("");
-        lines.push("The description references an implementation_plans/ file — READ THAT FILE FIRST and in full; it is the task's spec.");
-    }
-    if (card.acceptance) {
-        lines.push("");
-        lines.push("## Acceptance criteria");
-        lines.push(card.acceptance);
-    }
-    lines.push("");
-    lines.push("## Standing orders (execution profile — do not ask, these ARE the answers)");
-    for (const directive of renderProfileDirectives(card.profile, card.cardId))
-        lines.push(`- ${directive}`);
-    if (comments.length > 0) {
-        let history = comments
-            .map((c) => `[${c.createdAt}] ${c.author.toUpperCase()}:\n${c.content}`)
-            .join("\n---\n");
-        if (history.length > MAX_COMMENT_CHARS) {
-            history = "[…older history truncated…]\n" + history.slice(history.length - MAX_COMMENT_CHARS);
-        }
-        lines.push("");
-        lines.push("## Card history (oldest first — prior workers' reports and operator guidance)");
-        lines.push(history);
-    }
-    lines.push("");
-    lines.push("## Report contract (MANDATORY)");
-    lines.push(`When finished, call send_message_to_thread with mode:"reply", targetThreadId:${card.laneThreadId}, ` +
-        `senderThreadId:${workerThreadId}, senderName:"card-${card.cardId}". The message MUST start with its first line being exactly ` +
-        `"STATUS: DONE" or "STATUS: BLOCKED: <one-line reason>", followed by your real report (what you did, ` +
-        `commits/PR links, review results, anything the next worker or the operator needs).`);
-    lines.push("Then EXIT: do not call wait_for_instructions again, do not wait for replies, do not loop on a blocker — " +
-        "if you are stuck or need a decision, report STATUS: BLOCKED with the reason and exit. A fresh worker " +
-        "will be re-briefed from the card when the operator responds.");
-    return lines.join("\n");
-}
-//# sourceMappingURL=card-briefing.js.map

package/dist/services/board/card-briefing.js.map

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

package/dist/services/board/orchestrator.service.d.ts

@@ -1,55 +0,0 @@
-/**
- * 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 type { initMemoryDb } from "../../data/memory/index.js";
-import type { ThreadLifecycleService } from "../thread-lifecycle.service.js";
-import { spawnCardWorker } from "./worker-spawn.js";
-export declare function boardTickMs(): number;
-export declare function boardGlobalMaxConcurrent(): number;
-/** Kill-switch: BOARD_ENABLED=false skips orchestrator start entirely (the
- *  board stays a dormant UI/API). Default: enabled. */
-export declare function boardEnabled(): boolean;
-export interface BoardOrchestratorDeps {
-    getMemoryDb: () => 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;
-    /** Test seam — defaults to the real card-worker spawn path. */
-    spawnFn?: typeof spawnCardWorker;
-}
-export declare class BoardOrchestrator {
-    private readonly deps;
-    private timer;
-    private tickInFlight;
-    constructor(deps: BoardOrchestratorDeps);
-    start(): void;
-    stop(): void;
-    tick(): Promise<void>;
-    /**
-     * 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.
-     */
-    private respawnDueRecurrences;
-    private dispatchDueCards;
-}
-//# sourceMappingURL=orchestrator.service.d.ts.map

package/dist/services/board/orchestrator.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"orchestrator.service.d.ts","sourceRoot":"","sources":["../../../src/services/board/orchestrator.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAiB7E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAGjD;AAED;uDACuD;AACvD,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACnD,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;IACxC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,eAAe,CAAC;CAClC;AAED,qBAAa,iBAAiB;IAIhB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,YAAY,CAAS;gBAEA,IAAI,EAAE,qBAAqB;IAExD,KAAK,IAAI,IAAI;IAeb,IAAI,IAAI,IAAI;IAKN,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;YAiDf,gBAAgB;CAyD/B"}

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

@@ -1,198 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,32 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,49 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,48 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}