@isaacriehm/cairn-core 0.1.10 → 0.3.0

package/dist/frontend-types.d.ts

@@ -1,243 +0,0 @@
-/**
- * Frontend adapter contract per `docs/WORKFLOW_GUIDE.md` §0.1.
- *
- * The orchestrator + grounding daemon + MCP server are frontend-agnostic.
- * The operator console is a swappable adapter that consumes a uniform
- * task/run/UAT bundle and renders/listens via its native primitive.
- *
- * Adapters live in `cairn/src/frontend/<name>/`. Each implements
- * `FrontendAdapter`. The `cairn run --frontend <name>` CLI loads + starts
- * registered adapters; on operator events, adapters drop normalized JSON rows
- * to `.cairn/inbox/<ts>-<source>-<slug>.json`. The orchestrator (Phase 8)
- * picks them up. Phase 5 lands ingress-only — no orchestrator yet.
- */
-export type NotifyLevel = "info" | "warn" | "error";
-/**
- * A normalized inbox entry kind. Adapters drop one of these to
- * `.cairn/inbox/`. The orchestrator multiplexes on `kind`.
- */
-export type InboxKind = "task" | "slash" | "free_text" | "voice" | "interaction";
-export interface FrontendTask {
-    source: string;
-    intent: string;
-    rawText: string;
-    authorId: string;
-    channelId?: string;
-    guildId?: string;
-    messageId?: string;
-    receivedAt: string;
-}
-export interface VoiceMessage {
-    source: string;
-    attachmentUrl: string;
-    mime?: string;
-    authorId: string;
-    channelId: string;
-    guildId?: string;
-    messageId: string;
-    receivedAt: string;
-}
-export interface SlashEvent {
-    source: string;
-    command: string;
-    options: Record<string, string | number | boolean>;
-    authorId: string;
-    channelId?: string;
-    guildId?: string;
-    messageId?: string;
-    receivedAt: string;
-}
-export interface FreeTextEvent {
-    source: string;
-    intent: string;
-    rawText: string;
-    authorId: string;
-    channelId?: string;
-    guildId?: string;
-    messageId?: string;
-    receivedAt: string;
-}
-export interface InteractionEvent {
-    source: string;
-    bundleId: string;
-    choiceId: string;
-    freeText?: string;
-    authorId: string;
-    channelId?: string;
-    guildId?: string;
-    messageId?: string;
-    receivedAt: string;
-}
-export interface DialogChoice {
-    /** Stable id ("a" | "b" | ... | "e_other"). */
-    id: string;
-    label: string;
-}
-export interface DialogSpec {
-    /** Origin run / task id used to correlate adapter responses. */
-    bundleId: string;
-    prompt: string;
-    /**
-     * 2-5 choices. Last MUST be `E) Other` per WORKFLOW_GUIDE §1.4.
-     * If more than 4 orthogonal questions arise, caller MUST collapse to a
-     * single tightened-spec proposal per §1.0 (cap = 2 questions/turn).
-     */
-    choices: DialogChoice[];
-    channelId?: string;
-    timeoutMs?: number;
-    /**
-     * When true, the adapter notifies authorized operators (push, mention,
-     * etc. — adapter-defined) so they see the run is paused. Used for
-     * agent-initiated `cairn_ask_operator`; routine confirmations leave
-     * this false to avoid noise.
-     */
-    pingOperators?: boolean;
-    /**
-     * §3.4 win 1 — multi-step walks (per-question tightener resolution,
-     * /oops branches) edit one message in place instead of posting N+1
-     * messages. Set this to the previous step's `bundleId`; the adapter
-     * looks it up in its dialog-message map and edits that message
-     * (same channel, new prompt + buttons). When the bundleId is
-     * unknown (gone, never registered) the adapter falls back to a
-     * fresh send.
-     */
-    replaceBundleId?: string;
-    /**
-     * Terminal-dialog flag. When true (default), the adapter compacts
-     * the message on click — strips buttons, appends an "Answered" line
-     * — so the channel scrollback shows what was chosen. Walk steps
-     * that intend to be replaced by a follow-on dialog (per-Q tightener)
-     * MUST pass false: otherwise the compaction race-edits the message
-     * the next step is about to overwrite, and either the answer
-     * annotation or the next prompt loses depending on REST ordering.
-     * Adapter still fires `deferUpdate` so the click acknowledges.
-     */
-    compactOnAnswer?: boolean;
-}
-export interface DialogResponse {
-    bundleId: string;
-    choiceId: string;
-    /** Populated only when `choiceId` is the `E) Other` option. */
-    freeText?: string;
-    timedOut?: boolean;
-}
-export interface ApprovalArtifact {
-    kind: "gif" | "screenshot" | "table" | "diff" | "log" | "url" | "text";
-    label?: string;
-    path?: string;
-    url?: string;
-    content?: string;
-}
-export interface ApprovalBundle {
-    bundleId: string;
-    runId: string;
-    taskId?: string;
-    goal: string;
-    diffSummary?: string;
-    acceptance?: {
-        id: string;
-        status: "pass" | "fail" | "pending";
-        note?: string;
-    }[];
-    artifacts?: ApprovalArtifact[];
-    channelId?: string;
-    timeoutMs?: number;
-}
-export interface Approval {
-    bundleId: string;
-    decision: "approve" | "reject" | "ask";
-    reason?: string;
-    timedOut?: boolean;
-}
-export interface PostUpdate {
-    taskId: string;
-    runId?: string;
-    status: string;
-    /**
-     * Free-form body. ≤1024 chars renders as inline embed `details` field
-     * (§3.3 win 3 — drops the live-status + content-message split). >1024
-     * chars falls back to the chunked secondary-embed path.
-     */
-    body?: string;
-    /**
-     * Original task spec (the operator's verbatim ask). Replaces the
-     * standalone `🆕 Task` drop card — the body lives on the same live
-     * status embed as everything else, so the channel only ever shows
-     * one self-updating message per task. Truncated at 1024 chars.
-     */
-    taskBody?: string;
-    channelId?: string;
-    /**
-     * Tier-0 (Haiku) summary of what the agent is doing right now —
-     * one-line, present-progressive ("Reading core/src/X", "Editing
-     * platform/Y"). Surfaces inside the live status embed so the
-     * operator sees ongoing activity instead of a static "running" badge.
-     * Set on a throttled cadence by the orchestrator during the
-     * implementer phase.
-     */
-    activity?: string;
-    /**
-     * Second-source visibility — extracted from claude stream-json events.
-     * Independent of the Tier-0 summary; renders even when the Tier-0 call
-     * fails. Each list capped + deduped at the source.
-     */
-    tools?: {
-        files?: string[];
-        bash?: string[];
-        searches?: string[];
-    };
-    /**
-     * Curated narrative tail from `.cairn/runs/active/<run_id>/log.jsonl`
-     * (§3.3 win 1) — last N transitions, pre-formatted. Renders inside the
-     * live status embed's description so operator sees actual progress
-     * instead of a static "phase: running" line.
-     */
-    recentEvents?: string[];
-    /**
-     * §3.4 win 3 — when status === "failed", the orchestrator classifies
-     * which gate eject the run so the embed renders class-colored title +
-     * emoji. Operator can route differently per class.
-     */
-    failureClass?: "sensor" | "reviewer" | "uat" | "hard" | "halt";
-    /**
-     * §3.4 win 2 — failure remediation guidance surfaced as a dedicated
-     * embed field. `reason` is a one-liner; `suggestedActions` are the
-     * operator's next moves (`/ship-anyway`, re-submit, open thread).
-     */
-    remediation?: {
-        reason: string;
-        suggestedActions: string[];
-    };
-}
-export type IngestHandler<T> = (item: T) => void | Promise<void>;
-export interface FrontendAdapter {
-    readonly name: string;
-    /** Connects, registers commands, prepares to ingest events. */
-    start(): Promise<void>;
-    /** Disconnects + cleans up. Idempotent. */
-    stop(): Promise<void>;
-    onTask(handler: IngestHandler<FrontendTask>): void;
-    onVoice(handler: IngestHandler<VoiceMessage>): void;
-    onSlash(handler: IngestHandler<SlashEvent>): void;
-    onFreeText(handler: IngestHandler<FreeTextEvent>): void;
-    onInteraction(handler: IngestHandler<InteractionEvent>): void;
-    postTaskUpdate(update: PostUpdate): Promise<void>;
-    requestApproval(bundle: ApprovalBundle): Promise<Approval>;
-    requestDialog(spec: DialogSpec): Promise<DialogResponse>;
-    notify(level: NotifyLevel, message: string): Promise<void>;
-    /**
-     * Show a "typing" / activity indicator on the given channel until the
-     * returned stop fn is called. Adapters without a native typing
-     * indicator should no-op.
-     */
-    startTyping?(channelId: string): () => void;
-    /**
-     * Pre-flight check: is this channel still reachable + writable?
-     * Adapters that maintain channels MUST return false when the channel
-     * has been deleted or the adapter lacks access. The orchestrator uses
-     * this to skip dispatching a queued task whose channel is gone.
-     * Adapters without channels should leave this undefined; the
-     * orchestrator treats undefined as "always alive".
-     */
-    isChannelAlive?(channelId: string): Promise<boolean>;
-}

package/dist/frontend-types.js

@@ -1,15 +0,0 @@
-/**
- * Frontend adapter contract per `docs/WORKFLOW_GUIDE.md` §0.1.
- *
- * The orchestrator + grounding daemon + MCP server are frontend-agnostic.
- * The operator console is a swappable adapter that consumes a uniform
- * task/run/UAT bundle and renders/listens via its native primitive.
- *
- * Adapters live in `cairn/src/frontend/<name>/`. Each implements
- * `FrontendAdapter`. The `cairn run --frontend <name>` CLI loads + starts
- * registered adapters; on operator events, adapters drop normalized JSON rows
- * to `.cairn/inbox/<ts>-<source>-<slug>.json`. The orchestrator (Phase 8)
- * picks them up. Phase 5 lands ingress-only — no orchestrator yet.
- */
-export {};
-//# sourceMappingURL=frontend-types.js.map

package/dist/frontend-types.js.map

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

package/dist/hooks/index.d.ts

@@ -1,12 +0,0 @@
-/**
- * Claude Code hooks — runner functions + bin entrypoints.
- *
- * Bin entrypoints live at `dist/hooks/<event>.js` (one per event) so
- * the plugin manifest can invoke them via
- * `node ${CLAUDE_PLUGIN_ROOT}/../cairn-core/dist/hooks/<event>.js`
- * without depending on the `cairn` umbrella CLI being on PATH.
- *
- * The umbrella CLI's `cairn hook <event>` calls the same runners.
- */
-export * from "./runners/index.js";
-export * from "./post-tool-use/index.js";

package/dist/hooks/index.js

@@ -1,13 +0,0 @@
-/**
- * Claude Code hooks — runner functions + bin entrypoints.
- *
- * Bin entrypoints live at `dist/hooks/<event>.js` (one per event) so
- * the plugin manifest can invoke them via
- * `node ${CLAUDE_PLUGIN_ROOT}/../cairn-core/dist/hooks/<event>.js`
- * without depending on the `cairn` umbrella CLI being on PATH.
- *
- * The umbrella CLI's `cairn hook <event>` calls the same runners.
- */
-export * from "./runners/index.js";
-export * from "./post-tool-use/index.js";
-//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC"}

package/dist/inbox.d.ts

@@ -1,17 +0,0 @@
-import type { InboxKind } from "./frontend-types.js";
-/**
- * Append a normalized event row to `.cairn/inbox/`.
- *
- * The orchestrator (Phase 8) tails this directory and acts on each row.
- * Phase 5 just lands rows — no orchestrator yet. Inbox is a write-allowed
- * path per `cairn/src/mcp/path-allowlist.ts` (`APPEND_ALLOWLIST`).
- *
- * Filename pattern: `<ts>-<source>-<kind>-<slug>.json`. Sortable, scannable,
- * collision-resistant under concurrent writers.
- */
-export declare function writeInboxRow(args: {
-    repoRoot: string;
-    source: string;
-    kind: InboxKind;
-    payload: object;
-}): Promise<string>;

package/dist/inbox.js

@@ -1,30 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { randomBytes } from "node:crypto";
-import { join } from "node:path";
-/**
- * Append a normalized event row to `.cairn/inbox/`.
- *
- * The orchestrator (Phase 8) tails this directory and acts on each row.
- * Phase 5 just lands rows — no orchestrator yet. Inbox is a write-allowed
- * path per `cairn/src/mcp/path-allowlist.ts` (`APPEND_ALLOWLIST`).
- *
- * Filename pattern: `<ts>-<source>-<kind>-<slug>.json`. Sortable, scannable,
- * collision-resistant under concurrent writers.
- */
-export async function writeInboxRow(args) {
-    const { repoRoot, source, kind, payload } = args;
-    const dir = join(repoRoot, ".cairn", "inbox");
-    await mkdir(dir, { recursive: true });
-    const ts = Date.now();
-    const slug = randomBytes(4).toString("hex");
-    const file = join(dir, `${ts}-${source}-${kind}-${slug}.json`);
-    const row = {
-        kind,
-        source,
-        received_at: new Date().toISOString(),
-        ...payload,
-    };
-    await writeFile(file, `${JSON.stringify(row, null, 2)}\n`, "utf8");
-    return file;
-}
-//# sourceMappingURL=inbox.js.map

package/dist/inbox.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"inbox.js","sourceRoot":"","sources":["../src/inbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAKnC;IACC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG;QACV,IAAI;QACJ,MAAM;QACN,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,GAAG,OAAO;KACX,CAAC;IACF,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/mcp/tools/append-run-note.d.ts

@@ -1,18 +0,0 @@
-/**
- * `cairn_append_run_note` — append a phase-tagged note to a task's notes.md.
- *
- * The handoff builder (CONTEXT_CONTINUITY_SPEC §2.2) reads notes.md when it
- * resumes an in-flight run, so notes survive context compaction by virtue of
- * being committed to disk. The MCP write surface is append-only and gated
- * by the path allowlist — see `mcp/path-allowlist.ts`.
- *
- * Spec: docs/CONTEXT_CONTINUITY_SPEC.md §2.3.
- */
-import type { ToolDef } from "./types.js";
-interface Input {
-    run_id: string;
-    phase: string;
-    note: string;
-}
-export declare const appendRunNoteTool: ToolDef<Input>;
-export {};

package/dist/mcp/tools/append-run-note.js

@@ -1,47 +0,0 @@
-/**
- * `cairn_append_run_note` — append a phase-tagged note to a task's notes.md.
- *
- * The handoff builder (CONTEXT_CONTINUITY_SPEC §2.2) reads notes.md when it
- * resumes an in-flight run, so notes survive context compaction by virtue of
- * being committed to disk. The MCP write surface is append-only and gated
- * by the path allowlist — see `mcp/path-allowlist.ts`.
- *
- * Spec: docs/CONTEXT_CONTINUITY_SPEC.md §2.3.
- */
-import { appendFileSync, existsSync } from "node:fs";
-import { join } from "node:path";
-import { mcpError } from "../errors.js";
-import { isAppendAllowed, relPosix, safeJoin } from "../path-allowlist.js";
-import { appendRunNoteInput } from "../schemas.js";
-const RUN_ID_RE = /^[A-Za-z0-9_-]+$/;
-async function handler(ctx, input) {
-    if (!RUN_ID_RE.test(input.run_id) || input.run_id.length > 80) {
-        return mcpError("VALIDATION_FAILED", `run_id must match path-safe pattern [A-Za-z0-9_-] (≤80 chars)`);
-    }
-    const rel = `.cairn/tasks/active/${input.run_id}/notes.md`;
-    const abs = safeJoin(ctx.repoRoot, rel);
-    if (typeof abs !== "string")
-        return abs; // error envelope
-    const relCanon = relPosix(ctx.repoRoot, abs);
-    if (!isAppendAllowed(relCanon)) {
-        return mcpError("PATH_NOT_ALLOWED", `Append-write is not allowed for "${relCanon}".`);
-    }
-    const taskDir = join(ctx.repoRoot, ".cairn", "tasks", "active", input.run_id);
-    if (!existsSync(taskDir)) {
-        return mcpError("RUN_NOT_FOUND", `No active task dir at .cairn/tasks/active/${input.run_id}/`);
-    }
-    const entry = `\n## ${new Date().toISOString()} [${input.phase}]\n${input.note}\n`;
-    appendFileSync(abs, entry, "utf8");
-    return {
-        ok: true,
-        path: relCanon,
-        bytes_written: Buffer.byteLength(entry, "utf8"),
-    };
-}
-export const appendRunNoteTool = {
-    name: "cairn_append_run_note",
-    description: "Append a phase-tagged note to .cairn/tasks/active/<run_id>/notes.md. The handoff builder reads notes.md so notes survive across sessions / context compaction. The run_id field must match the active task dir id (path-safe chars only).",
-    inputSchema: appendRunNoteInput,
-    handler,
-};
-//# sourceMappingURL=append-run-note.js.map

package/dist/mcp/tools/append-run-note.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"append-run-note.js","sourceRoot":"","sources":["../../../src/mcp/tools/append-run-note.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AASnD,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAErC,KAAK,UAAU,OAAO,CAAC,GAAe,EAAE,KAAY;IAClD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC9D,OAAO,QAAQ,CACb,mBAAmB,EACnB,+DAA+D,CAChE,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,uBAAuB,KAAK,CAAC,MAAM,WAAW,CAAC;IAC3D,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,CAAC,iBAAiB;IAE1D,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,OAAO,QAAQ,CACb,kBAAkB,EAClB,oCAAoC,QAAQ,IAAI,CACjD,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,QAAQ,CACb,eAAe,EACf,6CAA6C,KAAK,CAAC,MAAM,GAAG,CAC7D,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC;IACnF,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,QAAQ;QACd,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,2OAA2O;IAC7O,WAAW,EAAE,kBAAkB;IAC/B,OAAO;CACR,CAAC"}

package/dist/mcp/tools/append.d.ts

@@ -1,8 +0,0 @@
-import type { ToolDef } from "./types.js";
-interface Input {
-    path: string;
-    content: string;
-    newline_separator?: boolean;
-}
-export declare const appendTool: ToolDef<Input>;
-export {};

package/dist/mcp/tools/append.js

@@ -1,37 +0,0 @@
-import { appendFileSync, existsSync, mkdirSync } from "node:fs";
-import { dirname } from "node:path";
-import { requireBootstrap } from "../bootstrap-guard.js";
-import { mcpError } from "../errors.js";
-import { isAppendAllowed, relPosix, safeJoin } from "../path-allowlist.js";
-import { appendInput } from "../schemas.js";
-async function handler(ctx, input) {
-    const block = requireBootstrap(ctx.repoRoot);
-    if (block !== null)
-        return block;
-    const abs = safeJoin(ctx.repoRoot, input.path);
-    if (typeof abs !== "string")
-        return abs; // error envelope
-    const rel = relPosix(ctx.repoRoot, abs);
-    if (!isAppendAllowed(rel)) {
-        return mcpError("PATH_NOT_ALLOWED", `Append-write is not allowed for "${rel}". Allowlist limited to runs/active/<id>/{events,commands}.jsonl, staleness/log.jsonl, and inbox/**.`);
-    }
-    // For runs/active/<id>/* paths, the run id segment must exist as a directory.
-    const runMatch = rel.match(/^\.cairn\/runs\/active\/([^/]+)\//);
-    if (runMatch) {
-        const runDir = `${ctx.repoRoot}/.cairn/runs/active/${runMatch[1]}`;
-        if (!existsSync(runDir)) {
-            return mcpError("RUN_NOT_FOUND", `No active run dir at ${runDir}`);
-        }
-    }
-    mkdirSync(dirname(abs), { recursive: true });
-    const sep = input.newline_separator !== false ? "\n" : "";
-    appendFileSync(abs, input.content + sep, "utf8");
-    return { ok: true, path: rel, bytes_written: Buffer.byteLength(input.content + sep, "utf8") };
-}
-export const appendTool = {
-    name: "cairn_append",
-    description: "Append-only write to a path-allowlisted file. No read required. Allowlist: runs/active/<id>/{events,commands}.jsonl, staleness/log.jsonl, inbox/**.",
-    inputSchema: appendInput,
-    handler,
-};
-//# sourceMappingURL=append.js.map

package/dist/mcp/tools/append.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"append.js","sourceRoot":"","sources":["../../../src/mcp/tools/append.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAS5C,KAAK,UAAU,OAAO,CAAC,GAAe,EAAE,KAAY;IAClD,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,CAAC,iBAAiB;IAC1D,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,QAAQ,CACb,kBAAkB,EAClB,oCAAoC,GAAG,sGAAsG,CAC9I,CAAC;IACJ,CAAC;IACD,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAChE,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,uBAAuB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,OAAO,QAAQ,CAAC,eAAe,EAAE,wBAAwB,MAAM,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IACD,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,KAAK,CAAC,iBAAiB,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,GAAG,GAAG,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC;AAChG,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAmB;IACxC,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,qJAAqJ;IACvJ,WAAW,EAAE,WAAW;IACxB,OAAO;CACR,CAAC"}

package/dist/mcp/tools/ask-operator.d.ts

@@ -1,34 +0,0 @@
-/**
- * cairn_ask_operator — agent-initiated operator dialog mid-run.
- *
- * The implementer agent calls this when it hits an ambiguity, needs
- * permission for a non-recoverable action, gets stuck, or wants to
- * verify its interpretation. The flow:
- *
- *   1. Tool writes a question file under
- *      `.cairn/runs/active/<run_id>/questions/<question_id>.q.json`.
- *   2. The orchestrator's question-watcher (chokidar) picks it up,
- *      fires `adapter.requestDialog()` with the active operator
- *      pinged (so they see it on mobile push).
- *   3. Operator answers via Discord button (or free-form follow-up
- *      if no `options` were provided).
- *   4. The orchestrator writes the answer to
- *      `.cairn/runs/active/<run_id>/questions/<question_id>.a.json`.
- *   5. This tool polls for the answer file and returns its contents to
- *      the agent.
- *
- * The agent run continues with the operator's answer in context. If
- * `timeout_ms` elapses before the operator answers, the tool returns
- * `{ timed_out: true }` and the agent decides what to do (default:
- * abort with a remediation note).
- */
-import type { ToolDef } from "./types.js";
-interface Input {
-    run_id: string;
-    question: string;
-    options?: string[];
-    category?: "ambiguity" | "permission" | "stuck" | "verify";
-    timeout_ms?: number;
-}
-export declare const askOperatorTool: ToolDef<Input>;
-export {};

package/dist/mcp/tools/ask-operator.js

@@ -1,97 +0,0 @@
-/**
- * cairn_ask_operator — agent-initiated operator dialog mid-run.
- *
- * The implementer agent calls this when it hits an ambiguity, needs
- * permission for a non-recoverable action, gets stuck, or wants to
- * verify its interpretation. The flow:
- *
- *   1. Tool writes a question file under
- *      `.cairn/runs/active/<run_id>/questions/<question_id>.q.json`.
- *   2. The orchestrator's question-watcher (chokidar) picks it up,
- *      fires `adapter.requestDialog()` with the active operator
- *      pinged (so they see it on mobile push).
- *   3. Operator answers via Discord button (or free-form follow-up
- *      if no `options` were provided).
- *   4. The orchestrator writes the answer to
- *      `.cairn/runs/active/<run_id>/questions/<question_id>.a.json`.
- *   5. This tool polls for the answer file and returns its contents to
- *      the agent.
- *
- * The agent run continues with the operator's answer in context. If
- * `timeout_ms` elapses before the operator answers, the tool returns
- * `{ timed_out: true }` and the agent decides what to do (default:
- * abort with a remediation note).
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { randomBytes } from "node:crypto";
-import { join } from "node:path";
-import { requireBootstrap } from "../bootstrap-guard.js";
-import { mcpError } from "../errors.js";
-import { askOperatorInput } from "../schemas.js";
-const POLL_INTERVAL_MS = 500;
-const DEFAULT_TIMEOUT_MS = 10 * 60_000;
-async function handler(ctx, input) {
-    const block = requireBootstrap(ctx.repoRoot);
-    if (block !== null)
-        return block;
-    const runDir = join(ctx.repoRoot, ".cairn", "runs", "active", input.run_id);
-    if (!existsSync(runDir)) {
-        return mcpError("RUN_NOT_FOUND", `No active run dir at ${runDir}. ask_operator must be called from within an in-flight run.`);
-    }
-    const questionsDir = join(runDir, "questions");
-    mkdirSync(questionsDir, { recursive: true });
-    const questionId = `Q-${Date.now().toString(36)}-${randomBytes(2).toString("hex")}`;
-    const qPath = join(questionsDir, `${questionId}.q.json`);
-    const aPath = join(questionsDir, `${questionId}.a.json`);
-    const qPayload = {
-        id: questionId,
-        run_id: input.run_id,
-        asked_at: new Date().toISOString(),
-        question: input.question,
-        ...(input.options !== undefined && input.options.length > 0
-            ? { options: input.options }
-            : {}),
-        ...(input.category !== undefined ? { category: input.category } : {}),
-        timeout_ms: input.timeout_ms ?? DEFAULT_TIMEOUT_MS,
-    };
-    writeFileSync(qPath, JSON.stringify(qPayload, null, 2), "utf8");
-    // Poll for the answer file. The orchestrator's question-watcher
-    // observes the question, fires the dialog, writes the answer.
-    const deadline = Date.now() + (input.timeout_ms ?? DEFAULT_TIMEOUT_MS);
-    while (Date.now() < deadline) {
-        if (existsSync(aPath)) {
-            try {
-                const raw = readFileSync(aPath, "utf8");
-                const answer = JSON.parse(raw);
-                return {
-                    ok: true,
-                    question_id: questionId,
-                    answer: answer.answer,
-                    ...(answer.choice_id !== undefined ? { choice_id: answer.choice_id } : {}),
-                    ...(answer.free_text === true ? { free_text: true } : {}),
-                    ...(answer.timed_out === true ? { timed_out: true } : {}),
-                };
-            }
-            catch (err) {
-                return mcpError("VALIDATION_FAILED", `Failed to parse answer file ${aPath}: ${String(err)}`);
-            }
-        }
-        await sleep(POLL_INTERVAL_MS);
-    }
-    return {
-        ok: true,
-        question_id: questionId,
-        answer: "",
-        timed_out: true,
-    };
-}
-function sleep(ms) {
-    return new Promise((r) => setTimeout(r, ms));
-}
-export const askOperatorTool = {
-    name: "cairn_ask_operator",
-    description: "Stop and ask the operator a question. Use when the spec is genuinely ambiguous, you need permission for a non-recoverable action, you're stuck, or you want the operator to verify your interpretation. Provide 2-4 short option strings if the answer fits a closed set; omit `options` to invite a free-form reply. The tool blocks until the operator answers or `timeout_ms` (default 10 minutes) elapses.",
-    inputSchema: askOperatorInput,
-    handler,
-};
-//# sourceMappingURL=ask-operator.js.map

package/dist/mcp/tools/ask-operator.js.map

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

package/dist/mcp/tools/drop-task.d.ts

@@ -1,12 +0,0 @@
-import type { ToolDef } from "./types.js";
-interface Input {
-    title: string;
-    body: string;
-    intent: "run_pilot" | "review_module" | "fix_issue" | "eval" | "staleness_scan" | "unknown";
-    target_path_globs?: string[];
-    priority?: number;
-    parent_task_id?: string;
-    source?: string;
-}
-export declare const dropTaskTool: ToolDef<Input>;
-export {};