intercomm-aimfp 0.4.0

package/dist/task-contract.js

@@ -0,0 +1,111 @@
+// Task contract serialize/parse (Phase 2: directive-driven tasking).
+//
+// Thin-pointer model: a master serializes a TaskContract into a message's
+// content with buildTaskContract; a worker recovers it with parseTaskContract.
+// The contract is a POINTER to an AIMFP work entity, not a prose instruction —
+// the worker runs aimfp_run in its own clone and continues that entity normally.
+// InterComm stays AIMFP-agnostic: it never resolves aimfp_target and never reads
+// project.db; it only carries this string as opaque message content. Pure
+// functions only, no IO.
+// Discriminator + version embedded in the serialized JSON so parseTaskContract
+// can distinguish a task contract from arbitrary message content and reject the
+// superseded prose shape (v1) and any incompatible future shapes.
+const CONTRACT_KIND = "task_contract";
+const CONTRACT_VERSION = 2;
+// The AIMFP tables a pointer may reference (mirrors AimfpTargetType).
+const AIMFP_TARGET_TYPES = [
+    "task",
+    "milestone",
+    "subtask",
+    "sidequest",
+    "item",
+];
+const isStringArray = (value) => Array.isArray(value) && value.every((item) => typeof item === "string");
+const isNonEmptyString = (value) => typeof value === "string" && value.trim().length > 0;
+// Validate the pointer: a known type plus at least one of id (number) | slug
+// (non-empty string). Returns the typed target or an error reason.
+const parseAimfpTarget = (value) => {
+    if (typeof value !== "object" || value === null) {
+        return { ok: false, error: "aimfp_target must be an object" };
+    }
+    const obj = value;
+    if (!AIMFP_TARGET_TYPES.includes(obj.type)) {
+        return {
+            ok: false,
+            error: `aimfp_target.type must be one of ${AIMFP_TARGET_TYPES.join(", ")}`,
+        };
+    }
+    const hasId = typeof obj.id === "number" && Number.isInteger(obj.id);
+    const hasSlug = isNonEmptyString(obj.slug);
+    if (!hasId && !hasSlug) {
+        return {
+            ok: false,
+            error: "aimfp_target must have an integer id or a non-empty slug",
+        };
+    }
+    return {
+        ok: true,
+        target: {
+            type: obj.type,
+            ...(hasId ? { id: obj.id } : {}),
+            ...(hasSlug ? { slug: obj.slug } : {}),
+        },
+    };
+};
+// Master-side: serialize a thin-pointer contract into messages.content.
+export const buildTaskContract = (contract) => JSON.stringify({
+    kind: CONTRACT_KIND,
+    v: CONTRACT_VERSION,
+    role: contract.role,
+    role_instructions: contract.role_instructions,
+    aimfp_target: contract.aimfp_target,
+    reportBack: contract.reportBack,
+});
+// Worker-side: parse + validate a content string into a TaskContract. Never
+// throws — returns {ok:false, error} for any non-contract, malformed, or
+// superseded (v1) input.
+export const parseTaskContract = (content) => {
+    let raw;
+    try {
+        raw = JSON.parse(content);
+    }
+    catch {
+        return { ok: false, error: "content is not valid JSON" };
+    }
+    if (typeof raw !== "object" || raw === null) {
+        return { ok: false, error: "content is not a task contract object" };
+    }
+    const obj = raw;
+    if (obj.kind !== CONTRACT_KIND) {
+        return { ok: false, error: "content is not a task contract" };
+    }
+    if (obj.v !== CONTRACT_VERSION) {
+        return {
+            ok: false,
+            error: `unsupported task contract version: ${String(obj.v)}`,
+        };
+    }
+    if (!isNonEmptyString(obj.role)) {
+        return { ok: false, error: "role must be a non-empty string" };
+    }
+    if (!isNonEmptyString(obj.role_instructions)) {
+        return { ok: false, error: "role_instructions must be a non-empty string" };
+    }
+    if (!isStringArray(obj.reportBack)) {
+        return { ok: false, error: "reportBack must be an array of strings" };
+    }
+    const target = parseAimfpTarget(obj.aimfp_target);
+    if (!target.ok) {
+        return { ok: false, error: target.error };
+    }
+    return {
+        ok: true,
+        contract: {
+            role: obj.role,
+            role_instructions: obj.role_instructions,
+            aimfp_target: target.target,
+            reportBack: obj.reportBack,
+        },
+    };
+};
+//# sourceMappingURL=task-contract.js.map

package/dist/task-contract.js.map

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

package/dist/tmux-wrapper.d.ts

@@ -0,0 +1,17 @@
+export type TmuxResult = {
+    readonly ok: true;
+    readonly stdout: string;
+} | {
+    readonly ok: false;
+    readonly error: string;
+};
+export declare const newSession: (name: string, cwd: string, width?: number, height?: number) => TmuxResult;
+export declare const sendKeys: (target: string, keys: readonly string[], literal?: boolean) => TmuxResult;
+export declare const capturePane: (target: string) => TmuxResult;
+export declare const hasSession: (name: string) => TmuxResult;
+export declare const listSessions: () => TmuxResult;
+export declare const killSession: (name: string) => TmuxResult;
+export declare const displayMessage: (target: string, format: string) => TmuxResult;
+export declare const splitLines: (stdout: string) => readonly string[];
+export declare const currentPaneTarget: () => string;
+//# sourceMappingURL=tmux-wrapper.d.ts.map

package/dist/tmux-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux-wrapper.d.ts","sourceRoot":"","sources":["../src/tmux-wrapper.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAsBnD,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EACZ,KAAK,MAAM,EACX,QAAO,MAAY,EACnB,SAAQ,MAAW,KAClB,UAOC,CAAC;AAKL,eAAO,MAAM,QAAQ,GACnB,QAAQ,MAAM,EACd,MAAM,SAAS,MAAM,EAAE,EACvB,UAAS,OAAe,KACvB,UAGwC,CAAC;AAG5C,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,KAAG,UACE,CAAC;AAIhD,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,UACE,CAAC;AAI7C,eAAO,MAAM,YAAY,QAAO,UACqB,CAAC;AAGtD,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,UACJ,CAAC;AAIxC,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,EAAE,QAAQ,MAAM,KAAG,UACN,CAAC;AAG3D,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,KAAG,SAAS,MAAM,EACU,CAAC;AAMtE,eAAO,MAAM,iBAAiB,QAAO,MAKpC,CAAC"}

package/dist/tmux-wrapper.js

@@ -0,0 +1,66 @@
+// Thin IO wrappers around the tmux CLI.
+//
+// Every function shells out (side effect) and returns data — no logic. Mirrors
+// git-wrapper.ts in shape: each call returns a TmuxResult discriminated union and
+// never throws. The pure decisions about WHAT to send (which keys clear which
+// dialog) live in claude-tui.ts; this module only carries them to tmux.
+import { execFileSync } from "node:child_process";
+const runTmux = (args) => {
+    try {
+        const stdout = execFileSync("tmux", [...args], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "pipe"],
+        }).trim();
+        return { ok: true, stdout };
+    }
+    catch (err) {
+        const msg = err && typeof err === "object" && "stderr" in err && err.stderr
+            ? String(err.stderr).trim()
+            : err instanceof Error
+                ? err.message
+                : String(err);
+        return { ok: false, error: msg };
+    }
+};
+// `tmux new-session -d -s <name> -x <w> -y <h> -c <cwd>` — detached session,
+// fixed geometry so capture-pane output is stable for dialog detection.
+export const newSession = (name, cwd, width = 220, height = 50) => runTmux([
+    "new-session", "-d",
+    "-s", name,
+    "-x", String(width),
+    "-y", String(height),
+    "-c", cwd,
+]);
+// `tmux send-keys -t <target> [-l] <keys...>`. With literal=true the keys are
+// sent as raw text (the `-l` flag, for prompt strings); otherwise each entry is
+// a tmux key NAME (e.g. "Enter", "1"), so callers can mix characters and keys.
+export const sendKeys = (target, keys, literal = false) => runTmux(literal
+    ? ["send-keys", "-t", target, "-l", ...keys]
+    : ["send-keys", "-t", target, ...keys]);
+// `tmux capture-pane -t <target> -p` — dump the pane's visible text.
+export const capturePane = (target) => runTmux(["capture-pane", "-t", target, "-p"]);
+// `tmux has-session -t =<name>` — ok:true iff a session with exactly this name
+// exists (the `=` forces an exact match, not a prefix match).
+export const hasSession = (name) => runTmux(["has-session", "-t", `=${name}`]);
+// `tmux list-sessions -F '#{session_name}'` — ok carries newline-joined names
+// ("" when the server has no sessions). Use splitLines to get an array.
+export const listSessions = () => runTmux(["list-sessions", "-F", "#{session_name}"]);
+// `tmux kill-session -t <name>`.
+export const killSession = (name) => runTmux(["kill-session", "-t", name]);
+// `tmux display-message -p -t <target> <format>` — resolve a format string
+// (e.g. '#S:#I.#P' -> 'worker-1:0.0') for the given pane/target.
+export const displayMessage = (target, format) => runTmux(["display-message", "-p", "-t", target, format]);
+// Pure: split list-sessions stdout into trimmed, non-empty session names.
+export const splitLines = (stdout) => stdout.split("\n").map((l) => l.trim()).filter((l) => l.length > 0);
+// IO: resolve THIS process's own pane target ('<session>:<window>.<pane>') from
+// $TMUX_PANE, so an instance can record where it lives at register time. Returns
+// '' when not running inside tmux (or the lookup fails) — a non-tmux instance
+// simply has no wakeable target.
+export const currentPaneTarget = () => {
+    const pane = process.env.TMUX_PANE;
+    if (!pane)
+        return "";
+    const res = displayMessage(pane, "#S:#I.#P");
+    return res.ok ? res.stdout : "";
+};
+//# sourceMappingURL=tmux-wrapper.js.map

package/dist/tmux-wrapper.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,92 @@
+export type Role = "master" | "worker";
+export type MessageType = "task" | "status" | "question" | "answer" | "announce" | "done";
+export type Instance = {
+    readonly id: string;
+    readonly role: Role;
+    readonly active: boolean;
+    readonly lastActive: number;
+    readonly registeredAt: number;
+    readonly sessionId: string;
+    readonly tmuxTarget: string;
+};
+export type Message = {
+    readonly id: string;
+    readonly fromId: string;
+    readonly toId: string;
+    readonly type: MessageType;
+    readonly content: string;
+    readonly ts: number;
+};
+export type ReadCursor = {
+    readonly instanceId: string;
+    readonly lastReadSeq: number;
+};
+export type InstanceRow = {
+    id: string;
+    role: string;
+    active: number;
+    last_active: number;
+    registered_at: number;
+    session_id: string;
+    tmux_target: string;
+};
+export type MessageRow = {
+    id: string;
+    from_id: string;
+    to_id: string;
+    type: string;
+    content: string;
+    ts: number;
+};
+export type CursorRow = {
+    instance_id: string;
+    last_read_seq: number;
+};
+export declare const instanceFromRow: (row: InstanceRow) => Instance;
+export declare const messageFromRow: (row: MessageRow) => Message;
+export type ParsedArgs = {
+    readonly command: string;
+    readonly positional: readonly string[];
+    readonly flags: Readonly<Record<string, string | boolean>>;
+};
+export type AimfpTargetType = "task" | "milestone" | "subtask" | "sidequest" | "item";
+export type AimfpTarget = {
+    readonly type: AimfpTargetType;
+    readonly id?: number;
+    readonly slug?: string;
+};
+export type TaskContract = {
+    readonly role: string;
+    readonly role_instructions: string;
+    readonly aimfp_target: AimfpTarget;
+    readonly reportBack: readonly string[];
+};
+export type ParsedTaskContract = {
+    readonly ok: true;
+    readonly contract: TaskContract;
+} | {
+    readonly ok: false;
+    readonly error: string;
+};
+export declare const WORKTREE_STATUSES: readonly ["active", "done", "queued", "merging", "verifying", "merged", "conflict", "failed", "removed"];
+export type WorktreeStatus = (typeof WORKTREE_STATUSES)[number];
+export type Worktree = {
+    readonly workerId: string;
+    readonly branch: string;
+    readonly path: string;
+    readonly base: string;
+    readonly status: WorktreeStatus;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+};
+export type WorktreeRow = {
+    worker_id: string;
+    branch: string;
+    path: string;
+    base: string;
+    status: string;
+    created_at: number;
+    updated_at: number;
+};
+export declare const worktreeFromRow: (row: WorktreeRow) => Worktree;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,56 @@
+// Data contracts for InterComm AIMFP
+// Conversion helpers (pure)
+export const instanceFromRow = (row) => ({
+    id: row.id,
+    role: row.role,
+    active: row.active === 1,
+    lastActive: row.last_active,
+    registeredAt: row.registered_at,
+    sessionId: row.session_id,
+    tmuxTarget: row.tmux_target,
+});
+export const messageFromRow = (row) => ({
+    id: row.id,
+    fromId: row.from_id,
+    toId: row.to_id,
+    type: row.type,
+    content: row.content,
+    ts: row.ts,
+});
+// --- Worktree registry (multi-agent parallelization addon) ---
+//
+// Single source of truth for the worktree lifecycle. The status set is a
+// superset informed by ctx's agent merge queue (queued / verifying / conflict)
+// layered onto the original design states. InterComm only TRACKS these — it
+// never merges; AIMFP git directives own the actual branch/merge semantics.
+//
+//   active    — worker is editing inside its worktree
+//   done      — worker reported its task complete (ready to submit)
+//   queued    — submitted to the master's merge queue, awaiting its turn
+//   merging   — master is merging the branch (AIMFP git_merge_branch)
+//   verifying — verification command running on the merged result (ctx gate)
+//   merged    — applied + verified; target branch advanced
+//   conflict  — could not apply cleanly on the latest target; back for revision
+//   failed    — applied but verification failed (or an execution error)
+//   removed   — worktree torn down
+export const WORKTREE_STATUSES = [
+    "active",
+    "done",
+    "queued",
+    "merging",
+    "verifying",
+    "merged",
+    "conflict",
+    "failed",
+    "removed",
+];
+export const worktreeFromRow = (row) => ({
+    workerId: row.worker_id,
+    branch: row.branch,
+    path: row.path,
+    base: row.base,
+    status: row.status,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at,
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,qCAAqC;AA6DrC,4BAA4B;AAC5B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAgB,EAAY,EAAE,CAAC,CAAC;IAC9D,EAAE,EAAE,GAAG,CAAC,EAAE;IACV,IAAI,EAAE,GAAG,CAAC,IAAY;IACtB,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,CAAC;IACxB,UAAU,EAAE,GAAG,CAAC,WAAW;IAC3B,YAAY,EAAE,GAAG,CAAC,aAAa;IAC/B,SAAS,EAAE,GAAG,CAAC,UAAU;IACzB,UAAU,EAAE,GAAG,CAAC,WAAW;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAe,EAAW,EAAE,CAAC,CAAC;IAC3D,EAAE,EAAE,GAAG,CAAC,EAAE;IACV,MAAM,EAAE,GAAG,CAAC,OAAO;IACnB,IAAI,EAAE,GAAG,CAAC,KAAK;IACf,IAAI,EAAE,GAAG,CAAC,IAAmB;IAC7B,OAAO,EAAE,GAAG,CAAC,OAAO;IACpB,EAAE,EAAE,GAAG,CAAC,EAAE;CACX,CAAC,CAAC;AAqDH,gEAAgE;AAChE,EAAE;AACF,yEAAyE;AACzE,+EAA+E;AAC/E,4EAA4E;AAC5E,4EAA4E;AAC5E,EAAE;AACF,sDAAsD;AACtD,oEAAoE;AACpE,yEAAyE;AACzE,sEAAsE;AACtE,6EAA6E;AAC7E,2DAA2D;AAC3D,gFAAgF;AAChF,wEAAwE;AACxE,mCAAmC;AACnC,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,SAAS;IACT,WAAW;IACX,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,SAAS;CACD,CAAC;AAwBX,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAgB,EAAY,EAAE,CAAC,CAAC;IAC9D,QAAQ,EAAE,GAAG,CAAC,SAAS;IACvB,MAAM,EAAE,GAAG,CAAC,MAAM;IAClB,IAAI,EAAE,GAAG,CAAC,IAAI;IACd,IAAI,EAAE,GAAG,CAAC,IAAI;IACd,MAAM,EAAE,GAAG,CAAC,MAAwB;IACpC,SAAS,EAAE,GAAG,CAAC,UAAU;IACzB,SAAS,EAAE,GAAG,CAAC,UAAU;CAC1B,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "intercomm-aimfp",
+  "version": "0.4.0",
+  "description": "Local intercommunication system for coordinating multiple Claude Code instances via SQLite",
+  "type": "module",
+  "main": "dist/cli.js",
+  "bin": {
+    "intercomm": "dist/cli.js",
+    "intercomm-mcp": "dist/mcp-entry.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "files": [
+    "dist",
+    "system-prompt.md"
+  ],
+  "keywords": [
+    "claude",
+    "ipc",
+    "coordination"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.3.3",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "better-sqlite3": "^12.6.2",
+    "zod": "^4.3.6"
+  }
+}