intercomm-aimfp 0.4.0

package/dist/orchestrate.d.ts.map

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

package/dist/orchestrate.js

@@ -0,0 +1,226 @@
+// Multi-agent lifecycle sequences — the glue that retires spawn/scan/kill-workers.sh.
+//
+// This module SEQUENCES IO: it composes the tmux/git wrappers (raw IO), the pure
+// claude-tui dialog decisions, the config path helpers, and the store registry
+// into the operations the master drives (spawn / wake / scan / approve / teardown).
+// It owns no pure logic of its own beyond pacing — dialog detection/keystrokes
+// live in claude-tui, path math in config, persistence in store. Functions return
+// plain report data; mcp-server formats it into tool results.
+import { execSync } from "node:child_process";
+import { dirname } from "node:path";
+import { worktreePath } from "./config.js";
+import { ensureDir } from "./fs-wrapper.js";
+import { addWorktree, removeWorktree } from "./git-wrapper.js";
+import * as tmux from "./tmux-wrapper.js";
+import { detectPaneState, clearKeystrokes, isBlocking, isBooted, } from "./claude-tui.js";
+import * as store from "./store.js";
+// --- Private pacing helpers (untracked) ---
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+// Type a literal line into a pane and submit it. Claude Code's TUI needs a second
+// Enter to actually send (the first just inserts a newline), so callers targeting
+// the chat box pass doubleEnter=true; a shell prompt uses a single Enter.
+const typeLine = async (target, text, doubleEnter = false) => {
+    tmux.sendKeys(target, [text], true);
+    await sleep(400);
+    tmux.sendKeys(target, ["Enter"]);
+    if (doubleEnter) {
+        await sleep(400);
+        tmux.sendKeys(target, ["Enter"]);
+    }
+};
+// --- Pure-ish helpers ---
+// The first `count` free `<prefix>-N` session names (N from 1), skipping any that
+// tmux already has. IO: probes tmux.hasSession.
+export const pickSessionNames = (prefix, count) => {
+    const chosen = [];
+    let n = 1;
+    while (chosen.length < count) {
+        const name = `${prefix}-${n}`;
+        if (!tmux.hasSession(name).ok)
+            chosen.push(name);
+        n += 1;
+    }
+    return chosen;
+};
+// The register prompt pushed to a freshly-booted worker (ported from
+// spawn-workers.sh wake_prompt). Pure string assembly.
+export const wakePromptText = (session, worktrees) => {
+    const wt = worktrees
+        ? " You are in your OWN git worktree (isolated checkout, detached HEAD) — if your task lists required_directives, run the AIMFP git tools (e.g. git_create_branch) INSIDE this worktree and report your branch name back to the master via intercomm_send."
+        : "";
+    return (`You are an InterComm AIMFP worker running in tmux session '${session}'. ` +
+        `Do NOT interact with the user — all communication goes through InterComm to the master. ` +
+        `Steps: (1) Call intercomm_register() to get your worker id. ` +
+        `(2) Call intercomm_send(to: "master", type: "status", message: "registered as <your worker id> in tmux session ${session}") so the master can map you. ` +
+        `(3) Call intercomm_read() to get your task and begin. If there is no task yet, stop and wait — the master will wake you.${wt}`);
+};
+// The wake prompt pushed to the MASTER when a worker escalates (worker -> master,
+// the inverse of wakePromptText). The persisted `question` on the bus is the source
+// of truth; this text only nudges the master to DRAIN the bus (so a missed/garbled
+// wake is still recovered), confer with the user when needsUser, then answer + wake
+// the worker. Pure string assembly.
+export const escalationWakeText = (fromId, kind, needsUser, message) => {
+    const verb = kind === "decision" ? "needs a DECISION" : "has a QUESTION";
+    const user = needsUser
+        ? " It is flagged needs_user — confer with the USER before answering."
+        : "";
+    return (`InterComm escalation from ${fromId}: it ${verb}. ` +
+        `Call intercomm_read to drain the bus, then reply via ` +
+        `intercomm_send(to: "${fromId}", type: "answer", message: ...) and ` +
+        `intercomm_wake("${fromId}", ...) to resume it.${user} ` +
+        `(Escalated message: ${message})`);
+};
+// Resolve a worker id OR a raw tmux target to a tmux target string. A registered
+// instance's stored tmux_target wins; otherwise the input is treated as a session
+// name (covers freshly-spawned workers that have not registered yet). IO: store read.
+export const resolveTarget = (idOrTarget) => {
+    const inst = store.getInstance(idOrTarget);
+    return inst && inst.tmuxTarget ? inst.tmuxTarget : idOrTarget;
+};
+// --- Sequences ---
+// Bounded dialog-clear loop: repeatedly capture the pane, and while it sits on a
+// clearable first-run/permission dialog, send the keystrokes claude-tui prescribes.
+// Returns as soon as the pane has booted (ready/running) or the deadline passes —
+// it never waits on the worker REGISTERING (that stays async / no-poll).
+export const clearDialogs = async (target, deadlineMs) => {
+    const start = Date.now();
+    let state = "idle";
+    while (Date.now() - start < deadlineMs) {
+        const cap = tmux.capturePane(target);
+        state = cap.ok ? detectPaneState(cap.stdout) : "idle";
+        if (isBooted(state))
+            return state;
+        if (isBlocking(state)) {
+            for (const group of clearKeystrokes(state)) {
+                tmux.sendKeys(target, group);
+                await sleep(800);
+            }
+        }
+        else {
+            await sleep(700);
+        }
+    }
+    return state;
+};
+// Spawn `count` workers in detached tmux sessions, non-blocking. Per worker:
+// optionally provision an isolated git worktree (registered + bootstrapped),
+// launch claude with INTERCOMM_DB_ROOT pinned to the shared root, clear first-run
+// dialogs within the bounded window, then (if wake) push the register prompt.
+// Returns one report per session; workers self-register asynchronously afterward.
+export const spawnWorkers = async (opts) => {
+    const names = pickSessionNames(opts.prefix, opts.count);
+    const reports = [];
+    // Launch phase: create each session + start claude (sequential, stable order).
+    const launched = [];
+    for (const session of names) {
+        let launchDir = opts.root;
+        let worktree = "";
+        if (opts.worktrees) {
+            const path = worktreePath(opts.root, session);
+            ensureDir(dirname(path));
+            const res = addWorktree(opts.root, path, opts.worktreeBase);
+            // Reuse an existing checkout if `add` failed because it is already there.
+            if (res.ok || tmux.hasSession(session).ok === false) {
+                store.upsertWorktree(session, path, opts.worktreeBase);
+                worktree = path;
+                launchDir = path;
+                if (opts.bootstrap) {
+                    try {
+                        execSync(opts.bootstrap, { cwd: path, stdio: "ignore", shell: "/bin/bash" });
+                    }
+                    catch { /* best effort — a failed bootstrap should not abort the spawn */ }
+                }
+            }
+        }
+        tmux.newSession(session, launchDir);
+        const envPrefix = `INTERCOMM_DB_ROOT='${opts.root}' `;
+        await typeLine(session, `${envPrefix}${opts.claudeCmd} --permission-mode ${opts.permMode}`);
+        launched.push({ session, worktree });
+    }
+    // Boot phase: clear dialogs + wake each (sequential, so registration order is stable).
+    for (const { session, worktree } of launched) {
+        const state = await clearDialogs(session, opts.readyTimeoutMs);
+        const ready = isBooted(state);
+        let woken = false;
+        if (opts.wake && ready) {
+            await typeLine(session, wakePromptText(session, opts.worktrees), true);
+            woken = true;
+        }
+        reports.push({ session, state, ready, woken, worktree });
+    }
+    return reports;
+};
+// Push a prompt to a single worker pane (master -> worker). Symmetric to the
+// designed escalate (worker -> master). Resolves the target, verifies the pane
+// still exists, then types + submits with the TUI double-Enter.
+export const wakeWorker = async (idOrTarget, message) => {
+    const target = resolveTarget(idOrTarget);
+    const session = target.split(":")[0] ?? target;
+    if (!tmux.hasSession(session).ok)
+        return { resolved: false, woke: false, target };
+    await typeLine(target, message, true);
+    return { resolved: true, woke: true, target };
+};
+// Poll every `<prefix>-` session once and classify its pane. The master uses this
+// to find workers frozen on a permission dialog (which cannot report over the bus).
+export const scanWorkers = (prefix) => {
+    const list = tmux.listSessions();
+    if (!list.ok)
+        return [];
+    return tmux.splitLines(list.stdout)
+        .filter((s) => s.startsWith(`${prefix}-`))
+        .map((session) => {
+        const cap = tmux.capturePane(session);
+        const state = cap.ok ? detectPaneState(cap.stdout) : "idle";
+        return { session, state, needsAttention: isBlocking(state) };
+    });
+};
+// Clear one worker's blocking dialog (trust / MCP-approval / bypass / permission).
+// Captures before + after so the caller can report whether the block actually lifted.
+export const approveWorker = async (idOrTarget, deadlineMs) => {
+    const target = resolveTarget(idOrTarget);
+    const session = target.split(":")[0] ?? target;
+    const first = tmux.capturePane(session);
+    if (!first.ok) {
+        return { target, resolved: false, before: "idle", after: "idle", cleared: false };
+    }
+    const before = detectPaneState(first.stdout);
+    const after = await clearDialogs(session, deadlineMs);
+    const cleared = isBlocking(before) && !isBlocking(after);
+    return { target, resolved: true, before, after, cleared };
+};
+// Tear down every `<prefix>-` worker in one shot: kill the tmux sessions, remove
+// their git worktrees (when in worktree mode) and mark them removed, then REAP the
+// instance rows so a never-run exit-cleanup cannot leave stale active=1 drift.
+export const teardownWorkers = (root, prefix, worktrees) => {
+    const list = tmux.listSessions();
+    const sessions = list.ok
+        ? tmux.splitLines(list.stdout).filter((s) => s.startsWith(`${prefix}-`))
+        : [];
+    const killed = [];
+    for (const s of sessions) {
+        if (tmux.killSession(s).ok)
+            killed.push(s);
+    }
+    const worktreesRemoved = [];
+    if (worktrees) {
+        for (const wt of store.getAllWorktrees()) {
+            if (wt.status === "removed" || !killed.includes(wt.workerId))
+                continue;
+            if (removeWorktree(root, wt.path, true).ok) {
+                store.markWorktreeRemoved(wt.workerId);
+                worktreesRemoved.push(wt.workerId);
+            }
+        }
+    }
+    // Reap any registered instance whose session we just killed (id == session name).
+    const reaped = [];
+    for (const inst of store.getAllInstances()) {
+        if (killed.includes(inst.id)) {
+            store.reapInstance(inst.id);
+            reaped.push(inst.id);
+        }
+    }
+    return { killed, worktreesRemoved, reaped };
+};
+//# sourceMappingURL=orchestrate.js.map

package/dist/orchestrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrate.js","sourceRoot":"","sources":["../src/orchestrate.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,oFAAoF;AACpF,+EAA+E;AAC/E,kFAAkF;AAClF,8DAA8D;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,IAAI,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EACL,eAAe,EACf,eAAe,EACf,UAAU,EACV,QAAQ,GAET,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AA6CpC,6CAA6C;AAE7C,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAC1C,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAEpD,kFAAkF;AAClF,kFAAkF;AAClF,0EAA0E;AAC1E,MAAM,QAAQ,GAAG,KAAK,EACpB,MAAc,EACd,IAAY,EACZ,cAAuB,KAAK,EACb,EAAE;IACjB,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IACpC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IACjB,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACjC,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACnC,CAAC;AACH,CAAC,CAAC;AAEF,2BAA2B;AAE3B,kFAAkF;AAClF,gDAAgD;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAE,KAAa,EAAY,EAAE;IAC1E,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,qEAAqE;AACrE,uDAAuD;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAE,SAAkB,EAAU,EAAE;IAC5E,MAAM,EAAE,GAAG,SAAS;QAClB,CAAC,CAAC,yPAAyP;QAC3P,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,CACL,8DAA8D,OAAO,KAAK;QAC1E,0FAA0F;QAC1F,8DAA8D;QAC9D,kHAAkH,OAAO,gCAAgC;QACzJ,2HAA2H,EAAE,EAAE,CAChI,CAAC;AACJ,CAAC,CAAC;AAEF,kFAAkF;AAClF,oFAAoF;AACpF,mFAAmF;AACnF,oFAAoF;AACpF,oCAAoC;AACpC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAAc,EACd,IAA6B,EAC7B,SAAkB,EAClB,OAAe,EACP,EAAE;IACV,MAAM,IAAI,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACzE,MAAM,IAAI,GAAG,SAAS;QACpB,CAAC,CAAC,oEAAoE;QACtE,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,CACL,6BAA6B,MAAM,QAAQ,IAAI,IAAI;QACnD,uDAAuD;QACvD,uBAAuB,MAAM,uCAAuC;QACpE,mBAAmB,MAAM,wBAAwB,IAAI,GAAG;QACxD,uBAAuB,OAAO,GAAG,CAClC,CAAC;AACJ,CAAC,CAAC;AAEF,iFAAiF;AACjF,kFAAkF;AAClF,sFAAsF;AACtF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,UAAkB,EAAU,EAAE;IAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC3C,OAAO,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;AAChE,CAAC,CAAC;AAEF,oBAAoB;AAEpB,iFAAiF;AACjF,oFAAoF;AACpF,kFAAkF;AAClF,yEAAyE;AACzE,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,MAAc,EACd,UAAkB,EACE,EAAE;IACtB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,KAAK,GAAc,MAAM,CAAC;IAC9B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,UAAU,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACtD,IAAI,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,KAAK,MAAM,KAAK,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBAC7B,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,6EAA6E;AAC7E,6EAA6E;AAC7E,kFAAkF;AAClF,8EAA8E;AAC9E,kFAAkF;AAClF,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,IAAkB,EACM,EAAE;IAC1B,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,+EAA+E;IAC/E,MAAM,QAAQ,GAA4C,EAAE,CAAC;IAC7D,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,IAAI,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1B,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC9C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YACzB,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YAC5D,0EAA0E;YAC1E,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;gBACpD,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;gBACvD,QAAQ,GAAG,IAAI,CAAC;gBAChB,SAAS,GAAG,IAAI,CAAC;gBACjB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACnB,IAAI,CAAC;wBACH,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;oBAC/E,CAAC;oBAAC,MAAM,CAAC,CAAC,iEAAiE,CAAC,CAAC;gBAC/E,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,sBAAsB,IAAI,CAAC,IAAI,IAAI,CAAC;QACtD,MAAM,QAAQ,CAAC,OAAO,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,SAAS,sBAAsB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5F,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,uFAAuF;IACvF,KAAK,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,IAAI,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;YACvE,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,6EAA6E;AAC7E,+EAA+E;AAC/E,gEAAgE;AAChE,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,UAAkB,EAClB,OAAe,EACgD,EAAE;IACjE,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IAC/C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAClF,MAAM,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACtC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC,CAAC;AAEF,kFAAkF;AAClF,oFAAoF;AACpF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAc,EAAgB,EAAE;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IACjC,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;SAChC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;SACzC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/D,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,mFAAmF;AACnF,sFAAsF;AACtF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,UAAkB,EAClB,UAAkB,EACM,EAAE;IAC1B,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACpF,CAAC;IACD,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACzD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5D,CAAC,CAAC;AAEF,iFAAiF;AACjF,mFAAmF;AACnF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,IAAY,EACZ,MAAc,EACd,SAAkB,EACF,EAAE;IAClB,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE;QACtB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;QACxE,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,gBAAgB,GAAa,EAAE,CAAC;IACtC,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,eAAe,EAAE,EAAE,CAAC;YACzC,IAAI,EAAE,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACvE,IAAI,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC;gBAC3C,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;gBACvC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,kFAAkF;IAClF,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,eAAe,EAAE,EAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC;AAC9C,CAAC,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,3 @@
+export declare const protocolPath: () => string;
+export declare const loadProtocol: () => string;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,YAAY,QAAO,MACsC,CAAC;AAKvE,eAAO,MAAM,YAAY,QAAO,MAY/B,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,33 @@
+// InterComm coordination-protocol loader.
+//
+// The master/worker protocol is delivered to every connected instance via the
+// MCP server's `instructions` field (mirroring how AIMFP injects its rules) and
+// re-readable on demand via the intercomm_get_protocol tool. This module is the
+// single in-repo source: it loads system-prompt.md, the canonical protocol text.
+//
+// The path is resolved RELATIVE TO THIS MODULE (import.meta.url), never the cwd,
+// so it works whether the server runs from src/, dist/, or an installed
+// node_modules copy — system-prompt.md sits one level above the module dir in
+// every layout (package.json must ship it via "files").
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { readTextFile } from "./fs-wrapper.js";
+const PROTOCOL_SOURCE = "system-prompt.md";
+// On-disk path to the protocol source, anchored to this module's location.
+export const protocolPath = () => join(dirname(fileURLToPath(import.meta.url)), "..", PROTOCOL_SOURCE);
+// Load the protocol text. Read on each call (no mutable cache — called once at
+// startup and rarely thereafter). Degrades to a clear fallback rather than
+// throwing, so a missing/unreadable source can never crash server bootstrap.
+export const loadProtocol = () => {
+    try {
+        return readTextFile(protocolPath());
+    }
+    catch {
+        return ("InterComm AIMFP coordination protocol unavailable — the protocol source " +
+            `(${PROTOCOL_SOURCE}) could not be read. Register with intercomm_register, ` +
+            "and coordinate strictly through InterComm (master controls workers; " +
+            "workers never interact with the user). Reinstall the package to restore " +
+            "the full protocol.");
+    }
+};
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,gFAAgF;AAChF,iFAAiF;AACjF,EAAE;AACF,iFAAiF;AACjF,wEAAwE;AACxE,8EAA8E;AAC9E,wDAAwD;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAE3C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG,GAAW,EAAE,CACvC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;AAEvE,+EAA+E;AAC/E,2EAA2E;AAC3E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,YAAY,GAAG,GAAW,EAAE;IACvC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CACL,0EAA0E;YAC1E,IAAI,eAAe,yDAAyD;YAC5E,sEAAsE;YACtE,0EAA0E;YAC1E,oBAAoB,CACrB,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,26 @@
+import type { Instance, Message, MessageType, Role, Worktree, WorktreeStatus } from "./types.js";
+export declare const nowMs: () => number;
+export declare const isStale: (lastActive: number, now?: number) => boolean;
+export declare const formatMessageForDisplay: (msg: Message) => string;
+export declare const formatInstanceForDisplay: (inst: Instance, worktree?: Worktree | undefined) => string;
+export declare const findLowestAvailableWorkerName: (instances: readonly Instance[]) => string;
+export declare const registerInstance: (id: string, role: Role, sessionId: string, tmuxTarget?: string) => Instance;
+export declare const touchInstance: (id: string, tmuxTarget?: string) => void;
+export declare const setInstanceTmuxTarget: (id: string, target: string) => void;
+export declare const deactivateInstance: (id: string) => void;
+export declare const deactivateAll: () => void;
+export declare const reapInstance: (id: string) => void;
+export declare const getInstance: (id: string) => Instance | undefined;
+export declare const getAllInstances: () => readonly Instance[];
+export declare const getActiveMaster: () => Instance | undefined;
+export declare const registerAs: (role: Role, sessionId: string, tmuxTarget?: string) => Instance;
+export declare const insertMessage: (fromId: string, toId: string, type: MessageType, content: string) => Message;
+export declare const readNewMessages: (instanceId: string, readAll?: boolean) => readonly Message[];
+export declare const formatWorktreeForDisplay: (wt: Worktree) => string;
+export declare const upsertWorktree: (workerId: string, path: string, base: string) => Worktree;
+export declare const getWorktree: (workerId: string) => Worktree | undefined;
+export declare const getAllWorktrees: () => readonly Worktree[];
+export declare const setWorktreeStatus: (workerId: string, status: WorktreeStatus, branch?: string) => void;
+export declare const markWorktreeRemoved: (workerId: string) => void;
+export declare const clearOldMessages: (keep: number) => number;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,QAAQ,EAER,OAAO,EAEP,WAAW,EACX,IAAI,EAEJ,QAAQ,EAER,cAAc,EACf,MAAM,YAAY,CAAC;AAOpB,eAAO,MAAM,KAAK,QAAO,MAAoB,CAAC;AAE9C,eAAO,MAAM,OAAO,GAAI,YAAY,MAAM,EAAE,MAAK,MAAgB,KAAG,OAC7B,CAAC;AAExC,eAAO,MAAM,uBAAuB,GAAI,KAAK,OAAO,KAAG,MACqE,CAAC;AAE7H,eAAO,MAAM,wBAAwB,GACnC,MAAM,QAAQ,EACd,WAAW,QAAQ,GAAG,SAAS,KAC9B,MAaF,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,WAAW,SAAS,QAAQ,EAAE,KAAG,MAa9E,CAAC;AAIF,eAAO,MAAM,gBAAgB,GAC3B,IAAI,MAAM,EACV,MAAM,IAAI,EACV,WAAW,MAAM,EACjB,aAAY,MAAW,KACtB,QAaF,CAAC;AAOF,eAAO,MAAM,aAAa,GAAI,IAAI,MAAM,EAAE,aAAa,MAAM,KAAG,IAW/D,CAAC;AAMF,eAAO,MAAM,qBAAqB,GAAI,IAAI,MAAM,EAAE,QAAQ,MAAM,KAAG,IAElE,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,IAAI,MAAM,KAAG,IAE/C,CAAC;AAEF,eAAO,MAAM,aAAa,QAAO,IAEhC,CAAC;AAMF,eAAO,MAAM,YAAY,GAAI,IAAI,MAAM,KAAG,IAGzC,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,KAAG,QAAQ,GAAG,SAMnD,CAAC;AAEF,eAAO,MAAM,eAAe,QAAO,SAAS,QAAQ,EAE3B,CAAC;AAE1B,eAAO,MAAM,eAAe,QAAO,QAAQ,GAAG,SAO7C,CAAC;AAIF,eAAO,MAAM,UAAU,GACrB,MAAM,IAAI,EACV,WAAW,MAAM,EACjB,aAAY,MAAW,KACtB,QASF,CAAC;AAIF,eAAO,MAAM,aAAa,GACxB,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,MAAM,WAAW,EACjB,SAAS,MAAM,KACd,OAaF,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,YAAY,MAAM,EAClB,UAAS,OAAe,KACvB,SAAS,OAAO,EAgClB,CAAC;AAIF,eAAO,MAAM,wBAAwB,GAAI,IAAI,QAAQ,KAAG,MAIvD,CAAC;AAOF,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,MAAM,MAAM,EACZ,MAAM,MAAM,KACX,QAyBF,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,KAAG,QAAQ,GAAG,SAMzD,CAAC;AAEF,eAAO,MAAM,eAAe,QAAO,SAAS,QAAQ,EAE3B,CAAC;AAK1B,eAAO,MAAM,iBAAiB,GAC5B,UAAU,MAAM,EAChB,QAAQ,cAAc,EACtB,SAAS,MAAM,KACd,IAaF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,KAAG,IAEtD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAc/C,CAAC"}

package/dist/store.js

@@ -0,0 +1,186 @@
+// Core logic — SQLite-backed operations for all CRUD
+// Pure logic + IO operations via db.ts
+import { randomUUID } from "node:crypto";
+import { instanceFromRow, messageFromRow, worktreeFromRow } from "./types.js";
+import { STALE_THRESHOLD_MS } from "./config.js";
+import { execute, queryOne, queryAll } from "./db.js";
+// --- Pure helpers ---
+export const nowMs = () => Date.now();
+export const isStale = (lastActive, now = nowMs()) => now - lastActive > STALE_THRESHOLD_MS;
+export const formatMessageForDisplay = (msg) => `[${new Date(msg.ts).toLocaleTimeString()}] (${msg.type}) ${msg.fromId} → ${msg.toId}: ${msg.content} [msg_id: ${msg.id}]`;
+export const formatInstanceForDisplay = (inst, worktree) => {
+    const status = inst.active && !isStale(inst.lastActive) ? "active" : "inactive";
+    const seen = new Date(inst.lastActive).toLocaleTimeString();
+    // Surface the id <-> tmux-session <-> worktree mapping explicitly: InterComm ids are
+    // assigned in registration order and are DECOUPLED from the tmux session name (a
+    // worker-1 id can live in tmux session worker-4), which makes manual tmux/log
+    // inspection error-prone. tmuxTarget is the routing-truth; worktree (when present)
+    // ties the id to its on-disk checkout + branch.
+    const tmux = inst.tmuxTarget ? `, tmux: ${inst.tmuxTarget}` : "";
+    const wt = worktree
+        ? `, worktree: ${worktree.path}${worktree.branch ? ` @ ${worktree.branch}` : ""}`
+        : "";
+    return `  ${inst.id} [${inst.role}] — ${status} (last active: ${seen}, session: ${inst.sessionId.slice(0, 8)}${tmux}${wt})`;
+};
+export const findLowestAvailableWorkerName = (instances) => {
+    const usedNumbers = instances
+        .filter((i) => i.role === "worker" && i.active)
+        .map((i) => {
+        const match = i.id.match(/^worker-(\d+)$/);
+        return match ? parseInt(match[1], 10) : -1;
+    })
+        .filter((n) => n >= 0);
+    const usedSet = new Set(usedNumbers);
+    let n = 1;
+    while (usedSet.has(n))
+        n++;
+    return `worker-${n}`;
+};
+// --- IO: Instance operations ---
+export const registerInstance = (id, role, sessionId, tmuxTarget = "") => {
+    const now = nowMs();
+    execute(`INSERT OR REPLACE INTO instances (id, role, active, last_active, registered_at, session_id, tmux_target)
+     VALUES (?, ?, 1, ?, ?, ?, ?)`, id, role, now, now, sessionId, tmuxTarget);
+    return { id, role, active: true, lastActive: now, registeredAt: now, sessionId, tmuxTarget };
+};
+// Touch last_active on every authenticated tool call. When a non-empty tmuxTarget
+// is supplied (a tmux-backed instance re-resolving its OWN pane), refresh the
+// stored tmux_target in the same write so a moved/renamed pane stays wakeable —
+// this is what keeps the master's wake target fresh for worker escalations
+// (Phase 2.5b P1-b). Off-tmux callers pass '' / nothing and only last_active moves.
+export const touchInstance = (id, tmuxTarget) => {
+    if (tmuxTarget) {
+        execute(`UPDATE instances SET last_active = ?, tmux_target = ? WHERE id = ?`, nowMs(), tmuxTarget, id);
+    }
+    else {
+        execute(`UPDATE instances SET last_active = ? WHERE id = ?`, nowMs(), id);
+    }
+};
+// Unconditionally set (or clear, with '') an instance's stored tmux_target.
+// Distinct from touchInstance's refresh (which ignores '') so a failed escalation
+// wake can DOWNGRADE the master to message-only by clearing a pane that no longer
+// resolves (Phase 2.5b P1-b clear-on-failure).
+export const setInstanceTmuxTarget = (id, target) => {
+    execute(`UPDATE instances SET tmux_target = ? WHERE id = ?`, target, id);
+};
+export const deactivateInstance = (id) => {
+    execute(`UPDATE instances SET active = 0 WHERE id = ?`, id);
+};
+export const deactivateAll = () => {
+    execute(`UPDATE instances SET active = 0`);
+};
+// Hard-remove an instance row and its read cursor. deactivate only flips active=0
+// (preserving the worker-N slot); reap fully frees the name. teardown reaps killed
+// workers so a best-effort exit-cleanup that never ran cannot leave a stale
+// active=1 row that drifts the next worker's auto-assigned number (note #31).
+export const reapInstance = (id) => {
+    execute(`DELETE FROM instances WHERE id = ?`, id);
+    execute(`DELETE FROM read_cursors WHERE instance_id = ?`, id);
+};
+export const getInstance = (id) => {
+    const row = queryOne(`SELECT * FROM instances WHERE id = ?`, id);
+    return row ? instanceFromRow(row) : undefined;
+};
+export const getAllInstances = () => queryAll(`SELECT * FROM instances ORDER BY registered_at`)
+    .map(instanceFromRow);
+export const getActiveMaster = () => {
+    const now = nowMs();
+    const row = queryOne(`SELECT * FROM instances WHERE role = 'master' AND active = 1 AND last_active > ?`, now - STALE_THRESHOLD_MS);
+    return row ? instanceFromRow(row) : undefined;
+};
+// --- IO: Registration ---
+export const registerAs = (role, sessionId, tmuxTarget = "") => {
+    if (role === "master") {
+        deactivateAll();
+        return registerInstance("master", "master", sessionId, tmuxTarget);
+    }
+    const allInstances = getAllInstances();
+    const workerName = findLowestAvailableWorkerName(allInstances);
+    return registerInstance(workerName, "worker", sessionId, tmuxTarget);
+};
+// --- IO: Message operations ---
+export const insertMessage = (fromId, toId, type, content) => {
+    const id = randomUUID();
+    const ts = nowMs();
+    execute(`INSERT INTO messages (id, from_id, to_id, type, content, ts) VALUES (?, ?, ?, ?, ?, ?)`, id, fromId, toId, type, content, ts);
+    return { id, fromId, toId, type, content, ts };
+};
+export const readNewMessages = (instanceId, readAll = false) => {
+    const cursor = readAll
+        ? 0
+        : (queryOne(`SELECT * FROM read_cursors WHERE instance_id = ?`, instanceId)?.last_read_seq ?? 0);
+    const rows = queryAll(`SELECT rowid AS seq, * FROM messages
+     WHERE (to_id = ? OR to_id = 'all')
+       AND from_id != ?
+       AND rowid > ?
+     ORDER BY rowid`, instanceId, instanceId, cursor);
+    // Advance cursor to the highest rowid seen. rowid is monotonic per insert, so
+    // same-millisecond messages can no longer slip past a `ts >` boundary.
+    if (rows.length > 0) {
+        const maxSeq = rows[rows.length - 1].seq;
+        execute(`INSERT OR REPLACE INTO read_cursors (instance_id, last_read_seq) VALUES (?, ?)`, instanceId, maxSeq);
+    }
+    touchInstance(instanceId);
+    return rows.map(messageFromRow);
+};
+// --- Pure helpers: worktrees ---
+export const formatWorktreeForDisplay = (wt) => {
+    const seen = new Date(wt.updatedAt).toLocaleTimeString();
+    const branch = wt.branch || "(detached — no branch yet)";
+    return `  ${wt.workerId} [${wt.status}] — ${branch} @ ${wt.path} (base: ${wt.base}, updated: ${seen})`;
+};
+// --- IO: Worktree operations ---
+// Record an isolated worktree for a worker. Idempotent on worker_id (re-spawn
+// replaces the row). branch starts empty — the worker reports it back later
+// (Phase 2), at which point the master fills it via setWorktreeStatus.
+export const upsertWorktree = (workerId, path, base) => {
+    const now = nowMs();
+    execute(`INSERT INTO worktrees (worker_id, branch, path, base, status, created_at, updated_at)
+     VALUES (?, '', ?, ?, 'active', ?, ?)
+     ON CONFLICT(worker_id) DO UPDATE SET
+       path = excluded.path,
+       base = excluded.base,
+       status = 'active',
+       updated_at = excluded.updated_at`, workerId, path, base, now, now);
+    return {
+        workerId,
+        branch: "",
+        path,
+        base,
+        status: "active",
+        createdAt: now,
+        updatedAt: now,
+    };
+};
+export const getWorktree = (workerId) => {
+    const row = queryOne(`SELECT * FROM worktrees WHERE worker_id = ?`, workerId);
+    return row ? worktreeFromRow(row) : undefined;
+};
+export const getAllWorktrees = () => queryAll(`SELECT * FROM worktrees ORDER BY created_at`)
+    .map(worktreeFromRow);
+// Update lifecycle status, optionally also recording the branch the worker
+// reported (its AIMFP aimfp-worker-N-NNN branch). branch is only overwritten
+// when a non-empty value is supplied, so status-only updates preserve it.
+export const setWorktreeStatus = (workerId, status, branch) => {
+    execute(`UPDATE worktrees
+       SET status = ?,
+           branch = CASE WHEN ? <> '' THEN ? ELSE branch END,
+           updated_at = ?
+     WHERE worker_id = ?`, status, branch ?? "", branch ?? "", nowMs(), workerId);
+};
+export const markWorktreeRemoved = (workerId) => {
+    setWorktreeStatus(workerId, "removed");
+};
+export const clearOldMessages = (keep) => {
+    // Count total messages
+    const countRow = queryOne(`SELECT COUNT(*) as cnt FROM messages`);
+    const total = countRow?.cnt ?? 0;
+    if (total <= keep)
+        return 0;
+    const toDelete = total - keep;
+    execute(`DELETE FROM messages WHERE id IN (
+      SELECT id FROM messages ORDER BY ts ASC LIMIT ?
+    )`, toDelete);
+    return toDelete;
+};
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/task-contract.d.ts

@@ -0,0 +1,4 @@
+import type { TaskContract, ParsedTaskContract } from "./types.js";
+export declare const buildTaskContract: (contract: TaskContract) => string;
+export declare const parseTaskContract: (content: string) => ParsedTaskContract;
+//# sourceMappingURL=task-contract.d.ts.map

package/dist/task-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-contract.d.ts","sourceRoot":"","sources":["../src/task-contract.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAGnB,MAAM,YAAY,CAAC;AA4DpB,eAAO,MAAM,iBAAiB,GAAI,UAAU,YAAY,KAAG,MAQvD,CAAC;AAKL,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,KAAG,kBAgDnD,CAAC"}