sensorium-mcp 3.1.2 → 3.1.3-board.2

package/dist/data/board/board-schema.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Agent Task Board — SQLite DDL + its OWN schema versioning.
+ *
+ * The board deliberately does NOT consume a number from the memory system's
+ * schema_version sequence (kernel review MED: a feature branch claiming main's
+ * next number means whichever line ships second gets silently skipped on DBs
+ * that rode the other). Board DDL versions live in board_schema_version and
+ * are applied by ensureBoardSchema() after the main migrations run.
+ *
+ * Design: implementation_plans/2026-08-01_agent-task-board-design.md §2.
+ * Single-writer invariant: only dashboard routes and the board orchestrator
+ * write these tables — there is no agent-facing (MCP tool) write path.
+ */
+import type { Database } from "../memory/db-types.js";
+export declare const BOARD_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS board_cards (\n  card_id            INTEGER PRIMARY KEY AUTOINCREMENT,\n  title              TEXT NOT NULL,\n  description        TEXT NOT NULL DEFAULT '',\n  acceptance         TEXT NOT NULL DEFAULT '',\n  type               TEXT NOT NULL DEFAULT 'chore',\n  lane_thread_id     INTEGER NOT NULL,\n  priority           INTEGER NOT NULL DEFAULT 0,\n  status             TEXT NOT NULL DEFAULT 'backlog'\n                     CHECK(status IN ('backlog','in_progress','blocked','done')),\n  profile_json       TEXT NOT NULL DEFAULT '{}',\n  escalate           INTEGER NOT NULL DEFAULT 0,\n  recur_delay_min    INTEGER,\n  recur_group_id     INTEGER,\n  next_spawn_at      TEXT,\n  worker_thread_id   INTEGER,\n  blocked_reason     TEXT,\n  archived_at        TEXT,\n  created_at         TEXT NOT NULL,\n  updated_at         TEXT NOT NULL,\n  started_at         TEXT,\n  finished_at        TEXT\n);\nCREATE INDEX IF NOT EXISTS idx_board_cards_lane_status ON board_cards(lane_thread_id, status);\nCREATE INDEX IF NOT EXISTS idx_board_cards_worker ON board_cards(worker_thread_id)\n  WHERE worker_thread_id IS NOT NULL;\nCREATE INDEX IF NOT EXISTS idx_board_cards_recur ON board_cards(recur_group_id)\n  WHERE recur_group_id IS NOT NULL;\n\nCREATE TABLE IF NOT EXISTS board_comments (\n  id          INTEGER PRIMARY KEY AUTOINCREMENT,\n  card_id     INTEGER NOT NULL REFERENCES board_cards(card_id),\n  author      TEXT NOT NULL CHECK(author IN ('operator','worker','board')),\n  content     TEXT NOT NULL,\n  created_at  TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS idx_board_comments_card ON board_comments(card_id, created_at);\n\nCREATE TABLE IF NOT EXISTS board_lanes (\n  thread_id      INTEGER PRIMARY KEY,\n  connected      INTEGER NOT NULL DEFAULT 1,\n  max_concurrent INTEGER NOT NULL DEFAULT 1,\n  created_at     TEXT NOT NULL\n);\n";
+/**
+ * Apply board schema migrations (own version table, independent of the memory
+ * system's schema_version). Called from initMemoryDb after runMigrations.
+ * Same transactional halt-on-failure contract as the main runner.
+ */
+export declare function ensureBoardSchema(db: Database): void;
+//# sourceMappingURL=board-schema.d.ts.map

package/dist/data/board/board-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-schema.d.ts","sourceRoot":"","sources":["../../../src/data/board/board-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAItD,eAAO,MAAM,gBAAgB,+0DA6C5B,CAAC;AAUF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CA6BpD"}

package/dist/data/board/board-schema.js

@@ -0,0 +1,103 @@
+/**
+ * Agent Task Board — SQLite DDL + its OWN schema versioning.
+ *
+ * The board deliberately does NOT consume a number from the memory system's
+ * schema_version sequence (kernel review MED: a feature branch claiming main's
+ * next number means whichever line ships second gets silently skipped on DBs
+ * that rode the other). Board DDL versions live in board_schema_version and
+ * are applied by ensureBoardSchema() after the main migrations run.
+ *
+ * Design: implementation_plans/2026-08-01_agent-task-board-design.md §2.
+ * Single-writer invariant: only dashboard routes and the board orchestrator
+ * write these tables — there is no agent-facing (MCP tool) write path.
+ */
+import { log } from "../../lib/logger.js";
+import { errorMessage } from "../../lib/utils.js";
+export const BOARD_SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS board_cards (
+  card_id            INTEGER PRIMARY KEY AUTOINCREMENT,
+  title              TEXT NOT NULL,
+  description        TEXT NOT NULL DEFAULT '',
+  acceptance         TEXT NOT NULL DEFAULT '',
+  type               TEXT NOT NULL DEFAULT 'chore',
+  lane_thread_id     INTEGER NOT NULL,
+  priority           INTEGER NOT NULL DEFAULT 0,
+  status             TEXT NOT NULL DEFAULT 'backlog'
+                     CHECK(status IN ('backlog','in_progress','blocked','done')),
+  profile_json       TEXT NOT NULL DEFAULT '{}',
+  escalate           INTEGER NOT NULL DEFAULT 0,
+  recur_delay_min    INTEGER,
+  recur_group_id     INTEGER,
+  next_spawn_at      TEXT,
+  worker_thread_id   INTEGER,
+  blocked_reason     TEXT,
+  archived_at        TEXT,
+  created_at         TEXT NOT NULL,
+  updated_at         TEXT NOT NULL,
+  started_at         TEXT,
+  finished_at        TEXT
+);
+CREATE INDEX IF NOT EXISTS idx_board_cards_lane_status ON board_cards(lane_thread_id, status);
+CREATE INDEX IF NOT EXISTS idx_board_cards_worker ON board_cards(worker_thread_id)
+  WHERE worker_thread_id IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_board_cards_recur ON board_cards(recur_group_id)
+  WHERE recur_group_id IS NOT NULL;
+
+CREATE TABLE IF NOT EXISTS board_comments (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  card_id     INTEGER NOT NULL REFERENCES board_cards(card_id),
+  author      TEXT NOT NULL CHECK(author IN ('operator','worker','board')),
+  content     TEXT NOT NULL,
+  created_at  TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_board_comments_card ON board_comments(card_id, created_at);
+
+CREATE TABLE IF NOT EXISTS board_lanes (
+  thread_id      INTEGER PRIMARY KEY,
+  connected      INTEGER NOT NULL DEFAULT 1,
+  max_concurrent INTEGER NOT NULL DEFAULT 1,
+  created_at     TEXT NOT NULL
+);
+`;
+const BOARD_SCHEMA_VERSION = 1;
+const BOARD_MIGRATIONS = {
+    1: (db) => {
+        db.exec(BOARD_SCHEMA_SQL);
+    },
+};
+/**
+ * Apply board schema migrations (own version table, independent of the memory
+ * system's schema_version). Called from initMemoryDb after runMigrations.
+ * Same transactional halt-on-failure contract as the main runner.
+ */
+export function ensureBoardSchema(db) {
+    db.exec(`CREATE TABLE IF NOT EXISTS board_schema_version (
+    version    INTEGER PRIMARY KEY,
+    applied_at TEXT NOT NULL
+  );`);
+    let current = 0;
+    try {
+        const row = db.prepare(`SELECT MAX(version) AS v FROM board_schema_version`).get();
+        current = row?.v ?? 0;
+    }
+    catch (err) {
+        log.warn(`[board-schema] version read failed (assuming 0): ${errorMessage(err)}`);
+    }
+    for (let v = current + 1; v <= BOARD_SCHEMA_VERSION; v++) {
+        const migration = BOARD_MIGRATIONS[v];
+        if (!migration)
+            continue;
+        try {
+            db.transaction(() => {
+                migration(db);
+                db.prepare(`INSERT OR REPLACE INTO board_schema_version (version, applied_at) VALUES (?, datetime('now'))`).run(v);
+            })();
+            log.info(`[board-schema] Migrated board schema to version ${v}`);
+        }
+        catch (err) {
+            log.error(`[board-schema] Migration ${v} failed: ${errorMessage(err)} — halting.`);
+            break;
+        }
+    }
+}
+//# sourceMappingURL=board-schema.js.map

package/dist/data/board/board-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-schema.js","sourceRoot":"","sources":["../../../src/data/board/board-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6C/B,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B,MAAM,gBAAgB,GAA2C;IAC/D,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE;QACR,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC5B,CAAC;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAY;IAC5C,EAAE,CAAC,IAAI,CAAC;;;KAGL,CAAC,CAAC;IACL,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,oDAAoD,CAAC,CAAC,GAAG,EAC9C,CAAC;QACnC,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,oDAAoD,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,OAAO,GAAG,CAAC,EAAE,CAAC,IAAI,oBAAoB,EAAE,CAAC,EAAE,EAAE,CAAC;QACzD,MAAM,SAAS,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,SAAS;YAAE,SAAS;QACzB,IAAI,CAAC;YACH,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;gBAClB,SAAS,CAAC,EAAE,CAAC,CAAC;gBACd,EAAE,CAAC,OAAO,CACR,+FAA+F,CAChG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACX,CAAC,CAAC,EAAE,CAAC;YACL,GAAG,CAAC,IAAI,CAAC,mDAAmD,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,4BAA4B,CAAC,YAAY,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACnF,MAAM;QACR,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/data/board/board-types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Agent Task Board — shared types.
+ *
+ * The card is the task's whole world: description + acceptance + execution
+ * profile + comment history form the complete briefing for a stateless
+ * card-worker (design §2, §3.2).
+ */
+export type CardStatus = "backlog" | "in_progress" | "blocked" | "done";
+export type CardType = "bug" | "feature" | "tech-debt" | "chore" | "research" | "recurring-ops";
+export type CommentAuthor = "operator" | "worker" | "board";
+/**
+ * Execution profile — the operator's standing orders for a task, declared
+ * once at card creation so the worker never has a question mid-run (spec §4).
+ * Every field optional; the card's type seeds defaults (profile-defaults.ts).
+ */
+export interface ExecutionProfile {
+    /** Repository to work in (path or URL). Blank → worker's cwd default. */
+    repository?: string;
+    /** Create a work branch (name auto-derived from the card when true). */
+    createBranch?: boolean;
+    /** Skills the worker must load via get_skill before starting. */
+    skills?: string[];
+    /** Operator must review the result before the card may be closed. */
+    operatorReview?: boolean;
+    /** Open a pull request with the changes. */
+    openPr?: boolean;
+    /** Spawn an expert code-review worker over the diff. */
+    expertReview?: boolean;
+    /** Reviewer provider when expertReview is on (operator amendment 2026-08-01:
+     *  review MAY use fable; the core build never fans out). */
+    reviewAgentType?: "claude" | "copilot" | "codex" | "fable";
+    /** Single worker or allow splitting into multiple workers. */
+    workerSplit?: "single" | "multi";
+    /** Provider that runs the card. Fable ONLY by explicit choice, never by size. */
+    agentType?: "claude" | "copilot" | "codex" | "fable";
+    /** Model bucket within the provider; blank → auto-classifier decides. */
+    size?: "operational" | "code";
+    runTests?: boolean;
+    build?: boolean;
+    push?: boolean;
+    /** Where to verify CI after pushing. */
+    ciCheck?: "none" | "github" | "azure";
+    /** RESERVED (v1 unimplemented): run inline in the lane thread instead of a worker. */
+    inline?: boolean;
+    /** Optional per-card hard TTL override (minutes) for the card-worker. Blank →
+     *  the WORKER_CARD_TTL_HOURS default; always clamped to WORKER_CARD_TTL_MAX_HOURS.
+     *  Anchored to created_at like every worker TTL (no idle/activity anchor). */
+    ttlMinutes?: number;
+}
+export interface BoardCard {
+    cardId: number;
+    title: string;
+    description: string;
+    acceptance: string;
+    type: string;
+    laneThreadId: number;
+    priority: number;
+    status: CardStatus;
+    profile: ExecutionProfile;
+    escalate: boolean;
+    recurDelayMin: number | null;
+    recurGroupId: number | null;
+    nextSpawnAt: string | null;
+    workerThreadId: number | null;
+    blockedReason: string | null;
+    archivedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    startedAt: string | null;
+    finishedAt: string | null;
+}
+export interface NewCard {
+    title: string;
+    description?: string;
+    acceptance?: string;
+    type?: string;
+    laneThreadId: number;
+    priority?: number;
+    profile?: ExecutionProfile;
+    escalate?: boolean;
+    recurDelayMin?: number;
+    /** Set by the recurrence respawner to link fresh copies to the original. */
+    recurGroupId?: number;
+}
+export interface CardPatch {
+    title?: string;
+    description?: string;
+    acceptance?: string;
+    type?: string;
+    laneThreadId?: number;
+    priority?: number;
+    status?: CardStatus;
+    profile?: ExecutionProfile;
+    escalate?: boolean;
+    recurDelayMin?: number | null;
+    recurGroupId?: number | null;
+    nextSpawnAt?: string | null;
+    workerThreadId?: number | null;
+    blockedReason?: string | null;
+    archivedAt?: string | null;
+    startedAt?: string | null;
+    finishedAt?: string | null;
+}
+export interface BoardComment {
+    id: number;
+    cardId: number;
+    author: CommentAuthor;
+    content: string;
+    createdAt: string;
+}
+export interface BoardLane {
+    threadId: number;
+    connected: boolean;
+    maxConcurrent: number;
+    createdAt: string;
+}
+//# sourceMappingURL=board-types.d.ts.map

package/dist/data/board/board-types.d.ts.map

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

package/dist/data/board/board-types.js

@@ -0,0 +1,9 @@
+/**
+ * Agent Task Board — shared types.
+ *
+ * The card is the task's whole world: description + acceptance + execution
+ * profile + comment history form the complete briefing for a stateless
+ * card-worker (design §2, §3.2).
+ */
+export {};
+//# sourceMappingURL=board-types.js.map

package/dist/data/board/board-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-types.js","sourceRoot":"","sources":["../../../src/data/board/board-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/data/board/card.repository.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Agent Task Board — card CRUD + orchestrator queries.
+ *
+ * Writers: dashboard routes (operator) and the board orchestrator only.
+ * Agents never touch these tables (single-writer invariant, design §2).
+ */
+import type { Database } from "../memory/db-types.js";
+import type { BoardCard, CardPatch, CardStatus, NewCard } from "./board-types.js";
+export declare function createCard(db: Database, card: NewCard): BoardCard;
+export declare function getCard(db: Database, cardId: number): BoardCard | undefined;
+export declare function listCards(db: Database, opts?: {
+    includeArchived?: boolean;
+    laneThreadId?: number;
+    status?: CardStatus;
+}): BoardCard[];
+export declare function updateCard(db: Database, cardId: number, patch: CardPatch): BoardCard | undefined;
+export declare function deleteCard(db: Database, cardId: number): boolean;
+/** Top-priority dispatchable Backlog card for a lane (priority DESC, oldest first). */
+export declare function getNextDispatchableCard(db: Database, laneThreadId: number): BoardCard | undefined;
+/**
+ * THE one DONE transition (single source — operator "Mark Done", worker
+ * STATUS: DONE, and any future path must all build the patch here; three
+ * hand-rolled copies had already drifted on blockedReason).
+ */
+export declare function buildDonePatch(card: BoardCard): CardPatch;
+/**
+ * Atomically claim a Backlog card for dispatch (compare-and-set on status).
+ * Returns false when another process/tick already claimed, archived, or moved
+ * it — the caller must NOT spawn in that case. This is the in-DB guard against
+ * double-dispatch across concurrent orchestrators (self-update overlap) and
+ * against operator moves racing an in-flight tick.
+ */
+export declare function claimCardForDispatch(db: Database, cardId: number): boolean;
+/** Bind the spawned worker to a card ONLY while it is still in_progress (an
+ *  operator move/delete during the async spawn must win, not be clobbered). */
+export declare function bindWorkerToCard(db: Database, cardId: number, workerThreadId: number): boolean;
+/**
+ * CAS block for a card still bound to a specific worker (exit safety net).
+ * Blocks ONLY when the card is in_progress AND its worker is still this exact
+ * thread — so two concurrent callers (worker teardown vs a reconcile tick,
+ * possibly cross-process) cannot both emit a BLOCKED signal. Returns the
+ * updated card when it changed exactly one row, else undefined (another path
+ * already handled it → the caller must no-op).
+ */
+export declare function blockBoundWorkerCard(db: Database, cardId: number, workerThreadId: number, reason: string): BoardCard | undefined;
+/**
+ * CAS block for a claimed-but-unbound card (dispatch died between claim and
+ * bind, leaving it in_progress with NO worker). Blocks ONLY while it is still
+ * in_progress AND worker_thread_id IS NULL, so a late bind or another reconcile
+ * tick cannot double-block. Returns the updated card when it changed exactly
+ * one row, else undefined.
+ */
+export declare function blockUnboundCard(db: Database, cardId: number, reason: string): BoardCard | undefined;
+export declare function countInProgress(db: Database, laneThreadId?: number): number;
+/** The in_progress card a live card-worker belongs to (report interception key). */
+export declare function findCardByWorkerThread(db: Database, workerThreadId: number): BoardCard | undefined;
+/**
+ * Done recurring cards whose respawn delay has elapsed AND whose group has no
+ * live instance outside Done (single-live-instance anti-clutter, design §4).
+ */
+export declare function listDueRecurrences(db: Database, nowIso: string): BoardCard[];
+/** Auto-archive Done cards older than `days` (hidden, never deleted — design §4). */
+export declare function archiveDoneOlderThan(db: Database, days: number): number;
+//# sourceMappingURL=card.repository.d.ts.map

package/dist/data/board/card.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.repository.d.ts","sourceRoot":"","sources":["../../../src/data/board/card.repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAItD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAoB,OAAO,EAAE,MAAM,kBAAkB,CAAC;AA4DpG,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,CA0CjE;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAI3E;AAED,wBAAgB,SAAS,CACvB,EAAE,EAAE,QAAQ,EACZ,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACnF,SAAS,EAAE,CAiBb;AAuBD,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAmBhG;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAOhE;AAID,uFAAuF;AACvF,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CASjG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAUzD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAS1E;AAED;+EAC+E;AAC/E,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAQ9F;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,GACb,SAAS,GAAG,SAAS,CASvB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,SAAS,GAAG,SAAS,CASvB;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAiB3E;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,QAAQ,EACZ,cAAc,EAAE,MAAM,GACrB,SAAS,GAAG,SAAS,CAOvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAe5E;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUvE"}

package/dist/data/board/card.repository.js

@@ -0,0 +1,272 @@
+/**
+ * Agent Task Board — card CRUD + orchestrator queries.
+ *
+ * Writers: dashboard routes (operator) and the board orchestrator only.
+ * Agents never touch these tables (single-writer invariant, design §2).
+ */
+import { nowISO } from "../memory/utils.js";
+import { log } from "../../lib/logger.js";
+import { errorMessage } from "../../lib/utils.js";
+function parseProfile(json) {
+    try {
+        const parsed = JSON.parse(json);
+        return typeof parsed === "object" && parsed !== null ? parsed : {};
+    }
+    catch (err) {
+        log.warn(`[board] Malformed profile_json — using empty profile: ${errorMessage(err)}`);
+        return {};
+    }
+}
+function mapRow(row) {
+    return {
+        cardId: row.card_id,
+        title: row.title,
+        description: row.description,
+        acceptance: row.acceptance,
+        type: row.type,
+        laneThreadId: row.lane_thread_id,
+        priority: row.priority,
+        status: row.status,
+        profile: parseProfile(row.profile_json),
+        escalate: row.escalate === 1,
+        recurDelayMin: row.recur_delay_min,
+        recurGroupId: row.recur_group_id,
+        nextSpawnAt: row.next_spawn_at,
+        workerThreadId: row.worker_thread_id,
+        blockedReason: row.blocked_reason,
+        archivedAt: row.archived_at,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        startedAt: row.started_at,
+        finishedAt: row.finished_at,
+    };
+}
+export function createCard(db, card) {
+    // Insert + group-anchor update are one atomic unit (a crash between them
+    // left a recurring card with no group — invisible to recurrence forever).
+    return db.transaction(() => {
+        const now = nowISO();
+        // Defense-in-depth floor (the API also validates): recurDelayMin < 1 —
+        // e.g. an empty input coerced to 0 — would be a tight respawn loop.
+        const recurDelayMin = card.recurDelayMin != null ? Math.max(1, Math.trunc(card.recurDelayMin)) : null;
+        const result = db
+            .prepare(`INSERT INTO board_cards (
+           title, description, acceptance, type, lane_thread_id, priority,
+           profile_json, escalate, recur_delay_min, recur_group_id, created_at, updated_at
+         ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(card.title, card.description ?? "", card.acceptance ?? "", card.type ?? "chore", card.laneThreadId, card.priority ?? 0, JSON.stringify(card.profile ?? {}), card.escalate ? 1 : 0, recurDelayMin, card.recurGroupId ?? null, now, now);
+        const created = getCard(db, Number(result.lastInsertRowid));
+        if (!created)
+            throw new Error("board_cards insert did not persist");
+        // A recurring original anchors its own group so fresh copies can find it.
+        if (created.recurDelayMin != null && created.recurGroupId == null) {
+            db.prepare(`UPDATE board_cards SET recur_group_id = ? WHERE card_id = ?`).run(created.cardId, created.cardId);
+            created.recurGroupId = created.cardId;
+        }
+        return created;
+    })();
+}
+export function getCard(db, cardId) {
+    const row = db.prepare(`SELECT * FROM board_cards WHERE card_id = ?`).get(cardId);
+    return row ? mapRow(row) : undefined;
+}
+export function listCards(db, opts = {}) {
+    const where = [];
+    const params = [];
+    if (!opts.includeArchived)
+        where.push("archived_at IS NULL");
+    if (opts.laneThreadId !== undefined) {
+        where.push("lane_thread_id = ?");
+        params.push(opts.laneThreadId);
+    }
+    if (opts.status !== undefined) {
+        where.push("status = ?");
+        params.push(opts.status);
+    }
+    const sql = `SELECT * FROM board_cards` +
+        (where.length > 0 ? ` WHERE ${where.join(" AND ")}` : "") +
+        ` ORDER BY priority DESC, created_at ASC`;
+    return db.prepare(sql).all(...params).map(mapRow);
+}
+/** Column-name map for the dynamically assembled UPDATE in updateCard. */
+const PATCH_COLUMNS = {
+    title: "title",
+    description: "description",
+    acceptance: "acceptance",
+    type: "type",
+    laneThreadId: "lane_thread_id",
+    priority: "priority",
+    status: "status",
+    profile: "profile_json",
+    escalate: "escalate",
+    recurDelayMin: "recur_delay_min",
+    recurGroupId: "recur_group_id",
+    nextSpawnAt: "next_spawn_at",
+    workerThreadId: "worker_thread_id",
+    blockedReason: "blocked_reason",
+    archivedAt: "archived_at",
+    startedAt: "started_at",
+    finishedAt: "finished_at",
+};
+export function updateCard(db, cardId, patch) {
+    const sets = [];
+    const params = [];
+    for (const [key, column] of Object.entries(PATCH_COLUMNS)) {
+        const value = patch[key];
+        // Test the VALUE, not key presence: `{ title: undefined }` must mean
+        // "unchanged", not "SET title = NULL" (which throws on NOT NULL columns).
+        // Nullable columns are cleared with an explicit null.
+        if (value === undefined)
+            continue;
+        sets.push(`${column} = ?`);
+        if (key === "profile")
+            params.push(JSON.stringify(value ?? {}));
+        else if (key === "escalate")
+            params.push(value ? 1 : 0);
+        else
+            params.push(value ?? null);
+    }
+    if (sets.length === 0)
+        return getCard(db, cardId);
+    sets.push("updated_at = ?");
+    params.push(nowISO(), cardId);
+    db.prepare(`UPDATE board_cards SET ${sets.join(", ")} WHERE card_id = ?`).run(...params);
+    return getCard(db, cardId);
+}
+export function deleteCard(db, cardId) {
+    // Atomic: never leave orphaned comments when the card delete fails mid-way.
+    return db.transaction(() => {
+        db.prepare(`DELETE FROM board_comments WHERE card_id = ?`).run(cardId);
+        const result = db.prepare(`DELETE FROM board_cards WHERE card_id = ?`).run(cardId);
+        return result.changes > 0;
+    })();
+}
+// ── Orchestrator queries (design §3) ────────────────────────────────────────
+/** Top-priority dispatchable Backlog card for a lane (priority DESC, oldest first). */
+export function getNextDispatchableCard(db, laneThreadId) {
+    const row = db
+        .prepare(`SELECT * FROM board_cards
+       WHERE lane_thread_id = ? AND status = 'backlog' AND archived_at IS NULL
+       ORDER BY priority DESC, created_at ASC LIMIT 1`)
+        .get(laneThreadId);
+    return row ? mapRow(row) : undefined;
+}
+/**
+ * THE one DONE transition (single source — operator "Mark Done", worker
+ * STATUS: DONE, and any future path must all build the patch here; three
+ * hand-rolled copies had already drifted on blockedReason).
+ */
+export function buildDonePatch(card) {
+    return {
+        status: "done",
+        finishedAt: nowISO(),
+        workerThreadId: null,
+        blockedReason: null,
+        ...(card.recurDelayMin != null
+            ? { nextSpawnAt: new Date(Date.now() + card.recurDelayMin * 60_000).toISOString() }
+            : {}),
+    };
+}
+/**
+ * Atomically claim a Backlog card for dispatch (compare-and-set on status).
+ * Returns false when another process/tick already claimed, archived, or moved
+ * it — the caller must NOT spawn in that case. This is the in-DB guard against
+ * double-dispatch across concurrent orchestrators (self-update overlap) and
+ * against operator moves racing an in-flight tick.
+ */
+export function claimCardForDispatch(db, cardId) {
+    const result = db
+        .prepare(`UPDATE board_cards
+       SET status = 'in_progress', started_at = ?, blocked_reason = NULL, updated_at = ?
+       WHERE card_id = ? AND status = 'backlog' AND archived_at IS NULL`)
+        .run(nowISO(), nowISO(), cardId);
+    return result.changes === 1;
+}
+/** Bind the spawned worker to a card ONLY while it is still in_progress (an
+ *  operator move/delete during the async spawn must win, not be clobbered). */
+export function bindWorkerToCard(db, cardId, workerThreadId) {
+    const result = db
+        .prepare(`UPDATE board_cards SET worker_thread_id = ?, updated_at = ?
+       WHERE card_id = ? AND status = 'in_progress' AND worker_thread_id IS NULL`)
+        .run(workerThreadId, nowISO(), cardId);
+    return result.changes === 1;
+}
+/**
+ * CAS block for a card still bound to a specific worker (exit safety net).
+ * Blocks ONLY when the card is in_progress AND its worker is still this exact
+ * thread — so two concurrent callers (worker teardown vs a reconcile tick,
+ * possibly cross-process) cannot both emit a BLOCKED signal. Returns the
+ * updated card when it changed exactly one row, else undefined (another path
+ * already handled it → the caller must no-op).
+ */
+export function blockBoundWorkerCard(db, cardId, workerThreadId, reason) {
+    const result = db
+        .prepare(`UPDATE board_cards
+       SET status = 'blocked', blocked_reason = ?, worker_thread_id = NULL, updated_at = ?
+       WHERE card_id = ? AND status = 'in_progress' AND worker_thread_id = ?`)
+        .run(reason, nowISO(), cardId, workerThreadId);
+    return result.changes === 1 ? getCard(db, cardId) : undefined;
+}
+/**
+ * CAS block for a claimed-but-unbound card (dispatch died between claim and
+ * bind, leaving it in_progress with NO worker). Blocks ONLY while it is still
+ * in_progress AND worker_thread_id IS NULL, so a late bind or another reconcile
+ * tick cannot double-block. Returns the updated card when it changed exactly
+ * one row, else undefined.
+ */
+export function blockUnboundCard(db, cardId, reason) {
+    const result = db
+        .prepare(`UPDATE board_cards
+       SET status = 'blocked', blocked_reason = ?, updated_at = ?
+       WHERE card_id = ? AND status = 'in_progress' AND worker_thread_id IS NULL`)
+        .run(reason, nowISO(), cardId);
+    return result.changes === 1 ? getCard(db, cardId) : undefined;
+}
+export function countInProgress(db, laneThreadId) {
+    const row = (laneThreadId !== undefined
+        ? db
+            .prepare(`SELECT COUNT(*) AS n FROM board_cards
+             WHERE status = 'in_progress' AND archived_at IS NULL AND lane_thread_id = ?`)
+            .get(laneThreadId)
+        : db
+            .prepare(`SELECT COUNT(*) AS n FROM board_cards
+             WHERE status = 'in_progress' AND archived_at IS NULL`)
+            .get());
+    return row.n;
+}
+/** The in_progress card a live card-worker belongs to (report interception key). */
+export function findCardByWorkerThread(db, workerThreadId) {
+    const row = db
+        .prepare(`SELECT * FROM board_cards WHERE worker_thread_id = ? AND status = 'in_progress' LIMIT 1`)
+        .get(workerThreadId);
+    return row ? mapRow(row) : undefined;
+}
+/**
+ * Done recurring cards whose respawn delay has elapsed AND whose group has no
+ * live instance outside Done (single-live-instance anti-clutter, design §4).
+ */
+export function listDueRecurrences(db, nowIso) {
+    const rows = db
+        .prepare(`SELECT * FROM board_cards c
+       WHERE c.status = 'done' AND c.recur_group_id IS NOT NULL
+         AND c.archived_at IS NULL
+         AND c.next_spawn_at IS NOT NULL AND c.next_spawn_at <= ?
+         AND NOT EXISTS (
+           SELECT 1 FROM board_cards o
+           WHERE o.recur_group_id = c.recur_group_id AND o.status != 'done'
+             AND o.archived_at IS NULL
+         )`)
+        .all(nowIso);
+    return rows.map(mapRow);
+}
+/** Auto-archive Done cards older than `days` (hidden, never deleted — design §4). */
+export function archiveDoneOlderThan(db, days) {
+    const cutoff = new Date(Date.now() - days * 86_400_000).toISOString();
+    const result = db
+        .prepare(`UPDATE board_cards SET archived_at = ?, updated_at = ?
+       WHERE status = 'done' AND archived_at IS NULL AND finished_at IS NOT NULL
+         AND finished_at < ? AND next_spawn_at IS NULL`)
+        .run(nowISO(), nowISO(), cutoff);
+    return result.changes;
+}
+//# sourceMappingURL=card.repository.js.map

package/dist/data/board/card.repository.js.map

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

package/dist/data/board/comment.repository.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Agent Task Board — card comments.
+ *
+ * All task chatter lives on the card (design §2): operator guidance, worker
+ * reports (written by the orchestrator from intercepted replies), and board
+ * lifecycle events. Comments are append-only.
+ */
+import type { Database } from "../memory/db-types.js";
+import type { BoardComment, CommentAuthor } from "./board-types.js";
+export declare function addComment(db: Database, cardId: number, author: CommentAuthor, content: string): BoardComment;
+export declare function listComments(db: Database, cardId: number): BoardComment[];
+//# sourceMappingURL=comment.repository.d.ts.map

package/dist/data/board/comment.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.repository.d.ts","sourceRoot":"","sources":["../../../src/data/board/comment.repository.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAoBpE,wBAAgB,UAAU,CACxB,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,GACd,YAAY,CAQd;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAKzE"}