@isaacriehm/cairn-core 0.9.7 → 0.10.0

package/dist/mcp/tools/mission-resume.js

@@ -0,0 +1,219 @@
+/**
+ * `cairn_mission_resume` — return the mission-frame priming body the
+ * `cairn-resume` skill chains in front of the existing task journal
+ * frame after `/clear`.
+ *
+ * Budget: ≤ 2500 tokens total (~10000 chars, conservative). Phase
+ * spec slice hard-capped at 1500 tokens (~6000 chars); falls back to
+ * title + exit_criteria + first paragraph when over.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { countDonePhases, findActiveMission, locateMission, readMissionSpec, readMissionState, readRoadmap, slicePhaseSection, } from "@isaacriehm/cairn-state";
+import { requireBootstrap } from "../bootstrap-guard.js";
+import { mcpError } from "../errors.js";
+import { missionResumeInput } from "../schemas.js";
+const MAX_PHASE_SLICE_CHARS = 6_000;
+const MAX_GRADUATED_TASKS = 3;
+const MAX_IN_FLIGHT_TASKS = 5;
+async function handler(ctx, input) {
+    const block = requireBootstrap(ctx.repoRoot);
+    if (block !== null)
+        return block;
+    const missionId = input.mission_id ?? findActiveMission(ctx.repoRoot);
+    if (missionId === null) {
+        return { ok: true, active: false };
+    }
+    if (locateMission(ctx.repoRoot, missionId) !== "active") {
+        return mcpError("MISSION_NOT_FOUND", `Mission ${missionId} is not active on this clone`);
+    }
+    const roadmap = readRoadmap(ctx.repoRoot, missionId);
+    const state = readMissionState(ctx.repoRoot, missionId);
+    if (roadmap === null || state === null) {
+        return mcpError("MISSION_NOT_FOUND", `Mission ${missionId} state or roadmap unreadable`);
+    }
+    const cursorPhaseId = state.cursor.active_phase;
+    const cursorPhase = cursorPhaseId === null
+        ? null
+        : roadmap.frontmatter.phases.find((p) => p.id === cursorPhaseId) ?? null;
+    const spec = readMissionSpec(ctx.repoRoot, missionId) ?? "";
+    let phaseSlice = null;
+    if (cursorPhase !== null) {
+        phaseSlice = slicePhaseSection(spec, cursorPhase);
+        if (phaseSlice !== null && phaseSlice.length > MAX_PHASE_SLICE_CHARS) {
+            const firstParagraph = phaseSlice.split(/\n\n/, 2)[0]?.slice(0, MAX_PHASE_SLICE_CHARS) ?? "";
+            phaseSlice = `${firstParagraph}\n\n…(truncated; full section in .cairn/missions/${missionId}/spec.md)`;
+        }
+    }
+    const recentGraduated = collectRecentGraduatedTasks(ctx.repoRoot, missionId, MAX_GRADUATED_TASKS);
+    const inFlight = collectInFlightTasks(ctx.repoRoot, missionId);
+    const upcoming = roadmap.frontmatter.phases
+        .filter((p) => {
+        const progress = state.phase_progress[p.id];
+        return (progress?.state ?? "pending") === "pending" && p.id !== cursorPhaseId;
+    })
+        .slice(0, 2);
+    const donePhases = countDonePhases(state);
+    const totalPhases = roadmap.frontmatter.phases.length;
+    const lines = [];
+    lines.push(`# Mission frame — ${roadmap.frontmatter.title}`);
+    lines.push("");
+    lines.push(`- mission: \`${missionId}\``);
+    lines.push(`- spec: \`${roadmap.frontmatter.spec_path}\``);
+    lines.push(`- progress: ${donePhases}/${totalPhases} phases`);
+    lines.push(`- exit_gate: ${roadmap.frontmatter.exit_gate}`);
+    if (cursorPhase !== null) {
+        lines.push(`- cursor: \`${cursorPhase.id}\` — ${cursorPhase.title}`);
+        lines.push(`  - exit_criteria: ${cursorPhase.exit_criteria}`);
+    }
+    else {
+        lines.push(`- cursor: (no active phase — mission may be near close)`);
+    }
+    lines.push("");
+    if (recentGraduated.length > 0) {
+        lines.push("## Recent graduated tasks");
+        for (const t of recentGraduated) {
+            lines.push(`- \`${t.task_id}\` — ${t.title} (${t.outcome})`);
+        }
+        lines.push("");
+    }
+    if (inFlight.length > 0) {
+        lines.push("## In-flight tasks (current phase)");
+        for (const t of inFlight) {
+            lines.push(`- \`${t.task_id}\` — ${t.title} (phase=${t.phase})`);
+        }
+        lines.push("");
+    }
+    if (cursorPhase !== null && phaseSlice !== null) {
+        lines.push(`## Spec section — ${cursorPhase.title}`);
+        lines.push("");
+        lines.push(phaseSlice);
+        lines.push("");
+    }
+    else if (cursorPhase !== null) {
+        lines.push(`## Spec section — ${cursorPhase.title}`);
+        lines.push("");
+        lines.push(cursorPhase.exit_criteria);
+        lines.push("");
+    }
+    if (upcoming.length > 0) {
+        lines.push("## Upcoming phases");
+        for (const p of upcoming) {
+            lines.push(`- \`${p.id}\` — ${p.title}`);
+        }
+        lines.push("");
+    }
+    return {
+        ok: true,
+        active: true,
+        mission_id: missionId,
+        title: roadmap.frontmatter.title,
+        cursor_phase: cursorPhase?.id ?? null,
+        progress: { done: donePhases, total: totalPhases },
+        body: lines.join("\n").trim(),
+    };
+}
+function parseStatusYaml(path) {
+    if (!existsSync(path))
+        return null;
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch {
+        return null;
+    }
+    if (parsed === null || typeof parsed !== "object")
+        return null;
+    const obj = parsed;
+    return {
+        mission_id: typeof obj["mission_id"] === "string" ? obj["mission_id"] : null,
+        phase_id: typeof obj["phase_id"] === "string" ? obj["phase_id"] : null,
+        title: typeof obj["title"] === "string" ? obj["title"] : null,
+        phase: typeof obj["phase"] === "string" ? obj["phase"] : null,
+    };
+}
+function collectRecentGraduatedTasks(repoRoot, missionId, cap) {
+    const doneDir = join(repoRoot, ".cairn", "tasks", "done");
+    if (!existsSync(doneDir))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(doneDir, { withFileTypes: true, encoding: "utf8" });
+    }
+    catch {
+        return [];
+    }
+    const matches = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const statusPath = join(doneDir, entry.name, "status.yaml");
+        const status = parseStatusYaml(statusPath);
+        if (status === null || status.mission_id !== missionId)
+            continue;
+        let mtime = 0;
+        try {
+            mtime = statSync(statusPath).mtimeMs;
+        }
+        catch {
+            continue;
+        }
+        matches.push({
+            task_id: entry.name,
+            title: status.title ?? entry.name,
+            outcome: status.phase ?? "succeeded",
+            mtime,
+        });
+    }
+    matches.sort((a, b) => b.mtime - a.mtime);
+    return matches.slice(0, cap).map((m) => ({
+        task_id: m.task_id,
+        title: m.title,
+        outcome: m.outcome,
+    }));
+}
+function collectInFlightTasks(repoRoot, missionId) {
+    const activeDir = join(repoRoot, ".cairn", "tasks", "active");
+    if (!existsSync(activeDir))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(activeDir, { withFileTypes: true, encoding: "utf8" });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const statusPath = join(activeDir, entry.name, "status.yaml");
+        const status = parseStatusYaml(statusPath);
+        if (status === null || status.mission_id !== missionId)
+            continue;
+        out.push({
+            task_id: entry.name,
+            title: status.title ?? entry.name,
+            phase: status.phase ?? "unknown",
+        });
+        if (out.length >= MAX_IN_FLIGHT_TASKS)
+            break;
+    }
+    return out;
+}
+export const missionResumeTool = {
+    name: "cairn_mission_resume",
+    description: "Return the mission-frame priming body the cairn-resume skill chains before the existing task journal frame after `/clear`. Includes mission id + title, cursor phase + exit_criteria, last 3 graduated tasks (mission-anchored), in-flight tasks under the cursor phase, the spec.md section sliced by phase heading (≤6000 chars), and the next 1-2 upcoming phases. Returns `{ active: false }` when no active mission exists.",
+    inputSchema: missionResumeInput,
+    handler,
+};
+//# sourceMappingURL=mission-resume.js.map

package/dist/mcp/tools/mission-resume.js.map

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

package/dist/mcp/tools/mission-resync-accept.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `cairn_mission_resync_accept` — apply or reject the pending resync
+ * marker (`.cairn/missions/<id>/_resync.json`) written by
+ * `cairn_mission_resync`. On accept: rewrite roadmap.md with the
+ * proposed phases (preserving mission_id, title, exit_gate,
+ * created_at), refresh spec.md from the live spec doc, reconcile
+ * `phase_progress` (added phases → pending entries; removed phases →
+ * dropped with journal note), and reposition the cursor when the
+ * active phase was deleted.
+ *
+ * Reject just deletes the marker; roadmap.md and state.json stay
+ * untouched.
+ */
+import type { ToolDef } from "./types.js";
+interface Input {
+    outcome: "accept" | "reject";
+}
+export declare const missionResyncAcceptTool: ToolDef<Input>;
+export {};

package/dist/mcp/tools/mission-resync-accept.js

@@ -0,0 +1,192 @@
+/**
+ * `cairn_mission_resync_accept` — apply or reject the pending resync
+ * marker (`.cairn/missions/<id>/_resync.json`) written by
+ * `cairn_mission_resync`. On accept: rewrite roadmap.md with the
+ * proposed phases (preserving mission_id, title, exit_gate,
+ * created_at), refresh spec.md from the live spec doc, reconcile
+ * `phase_progress` (added phases → pending entries; removed phases →
+ * dropped with journal note), and reposition the cursor when the
+ * active phase was deleted.
+ *
+ * Reject just deletes the marker; roadmap.md and state.json stay
+ * untouched.
+ */
+import { existsSync, readFileSync, rmSync } from "node:fs";
+import { isAbsolute, join, resolve as pathResolve } from "node:path";
+import { z } from "zod";
+import { appendMissionJournal, findActiveMission, missionRuntimeDir, nextPendingPhase, readMissionState, readRoadmap, writeMissionSpec, writeMissionState, writeRoadmap, } from "@isaacriehm/cairn-state";
+import { requireBootstrap } from "../bootstrap-guard.js";
+import { mcpError } from "../errors.js";
+import { missionResyncAcceptInput } from "../schemas.js";
+const ResyncMarkerSchema = z.object({
+    generated_at: z.string(),
+    spec_path: z.string(),
+    proposed_phases: z.array(z.object({
+        id: z.string(),
+        title: z.string(),
+        depends_on: z.array(z.string()).default([]),
+        exit_criteria: z.string(),
+        exit_gate: z.enum(["prompt", "auto", "manual"]).optional(),
+    })),
+    diff: z
+        .object({
+        added: z.array(z.string()),
+        removed: z.array(z.string()),
+        renamed: z.array(z.object({ from: z.string(), to: z.string() })),
+        exit_criteria_changed: z.array(z.object({ id: z.string(), before: z.string(), after: z.string() })),
+    })
+        .passthrough(),
+});
+async function handler(ctx, input) {
+    const block = requireBootstrap(ctx.repoRoot);
+    if (block !== null)
+        return block;
+    const missionId = findActiveMission(ctx.repoRoot);
+    if (missionId === null) {
+        return mcpError("MISSION_NOT_FOUND", "No active mission");
+    }
+    const markerPath = join(missionRuntimeDir(ctx.repoRoot, missionId), "_resync.json");
+    if (!existsSync(markerPath)) {
+        return mcpError("FILE_NOT_FOUND", `No pending resync for ${missionId} (_resync.json not present)`);
+    }
+    let raw;
+    try {
+        raw = readFileSync(markerPath, "utf8");
+    }
+    catch (err) {
+        return mcpError("INTERNAL_ERROR", `Failed to read resync marker: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        return mcpError("INTERNAL_ERROR", `Resync marker malformed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const markerResult = ResyncMarkerSchema.safeParse(parsed);
+    if (!markerResult.success) {
+        return mcpError("VALIDATION_FAILED", `Resync marker invalid: ${markerResult.error.message}`);
+    }
+    const marker = markerResult.data;
+    const ts = new Date().toISOString();
+    if (input.outcome === "reject") {
+        rmSync(markerPath, { force: true });
+        appendMissionJournal(ctx.repoRoot, missionId, {
+            ts,
+            kind: "resync-applied",
+            detail: "rejected by operator",
+        });
+        return {
+            ok: true,
+            mission_id: missionId,
+            outcome: "rejected",
+        };
+    }
+    // outcome === "accept"
+    const roadmap = readRoadmap(ctx.repoRoot, missionId);
+    const state = readMissionState(ctx.repoRoot, missionId);
+    if (roadmap === null || state === null) {
+        return mcpError("MISSION_NOT_FOUND", `Mission ${missionId} state or roadmap unreadable`);
+    }
+    // Build new roadmap frontmatter — preserve mission_id, title,
+    // exit_gate, created_at, spec_path. Replace phases with the
+    // operator-approved proposed_phases.
+    const newPhases = marker.proposed_phases.map((p) => ({
+        id: p.id,
+        title: p.title,
+        depends_on: p.depends_on,
+        exit_criteria: p.exit_criteria,
+        ...(p.exit_gate !== undefined ? { exit_gate: p.exit_gate } : {}),
+    }));
+    const newFrontmatter = {
+        mission_id: roadmap.frontmatter.mission_id,
+        title: roadmap.frontmatter.title,
+        spec_path: marker.spec_path,
+        created_at: roadmap.frontmatter.created_at,
+        exit_gate: roadmap.frontmatter.exit_gate,
+        phases: newPhases,
+    };
+    writeRoadmap(ctx.repoRoot, missionId, newFrontmatter, roadmap.prose);
+    // Refresh spec.md from the live spec doc.
+    const absSpec = isAbsolute(marker.spec_path)
+        ? marker.spec_path
+        : pathResolve(ctx.repoRoot, marker.spec_path);
+    if (existsSync(absSpec)) {
+        try {
+            const liveSpec = readFileSync(absSpec, "utf8");
+            writeMissionSpec(ctx.repoRoot, missionId, liveSpec);
+        }
+        catch {
+            // best-effort spec refresh; resync still applies even if spec read fails
+        }
+    }
+    // Reconcile phase_progress.
+    // - Added phases: insert a `pending` entry with no task_ids.
+    // - Removed phases (in marker.diff.removed): drop from phase_progress;
+    //   journal each drop with the orphaned task ids.
+    // - Surviving phases keep their state + task_ids.
+    const orphanedByPhase = {};
+    for (const removed of marker.diff.removed) {
+        const taskIds = state.phase_progress[removed]?.task_ids ?? [];
+        if (taskIds.length > 0)
+            orphanedByPhase[removed] = taskIds;
+        delete state.phase_progress[removed];
+    }
+    for (const added of marker.diff.added) {
+        if (!(added in state.phase_progress)) {
+            state.phase_progress[added] = { state: "pending", task_ids: [] };
+        }
+    }
+    // Cursor: if the current active phase was removed, recompute via
+    // nextPendingPhase against the new roadmap. If no phase remains
+    // pending, leave cursor null (mission may auto-close on next
+    // advance).
+    const cursorPhaseId = state.cursor.active_phase;
+    if (cursorPhaseId !== null && !newPhases.some((p) => p.id === cursorPhaseId)) {
+        const nextPhase = nextPendingPhase(newFrontmatter, state);
+        if (nextPhase !== null) {
+            state.cursor.active_phase = nextPhase.id;
+            state.cursor.active_phase_started_at = ts;
+            const existing = state.phase_progress[nextPhase.id];
+            state.phase_progress[nextPhase.id] = {
+                state: "in_progress",
+                task_ids: existing?.task_ids ?? [],
+            };
+        }
+        else {
+            state.cursor.active_phase = null;
+            state.cursor.active_phase_started_at = null;
+        }
+    }
+    writeMissionState(ctx.repoRoot, missionId, state);
+    appendMissionJournal(ctx.repoRoot, missionId, {
+        ts,
+        kind: "resync-applied",
+        detail: `+${marker.diff.added.length} −${marker.diff.removed.length} ↻${marker.diff.renamed.length} criteria${marker.diff.exit_criteria_changed.length}`,
+    });
+    for (const [phaseId, ids] of Object.entries(orphanedByPhase)) {
+        appendMissionJournal(ctx.repoRoot, missionId, {
+            ts,
+            kind: "drift-detected",
+            phase_id: phaseId,
+            detail: `dropped via resync — ${ids.length} graduated task(s) orphaned`,
+        });
+    }
+    rmSync(markerPath, { force: true });
+    return {
+        ok: true,
+        mission_id: missionId,
+        outcome: "applied",
+        diff: marker.diff,
+        new_phase_count: newPhases.length,
+        cursor_phase: state.cursor.active_phase,
+        orphaned_tasks_by_phase: orphanedByPhase,
+    };
+}
+export const missionResyncAcceptTool = {
+    name: "cairn_mission_resync_accept",
+    description: "Apply or reject the pending resync marker written by cairn_mission_resync. `outcome=accept` rewrites roadmap.md with the proposed phases, refreshes spec.md from the live spec, reconciles phase_progress (adds/drops), and repositions the cursor when the active phase was deleted. `outcome=reject` deletes the marker without touching anything else. Idempotent — once applied, the marker is gone.",
+    inputSchema: missionResyncAcceptInput,
+    handler,
+};
+//# sourceMappingURL=mission-resync-accept.js.map

package/dist/mcp/tools/mission-resync-accept.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-resync-accept.js","sourceRoot":"","sources":["../../../src/mcp/tools/mission-resync-accept.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EAGjB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAOzD,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,eAAe,EAAE,CAAC,CAAC,KAAK,CACtB,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;QACzB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC3D,CAAC,CACH;IACD,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChE,qBAAqB,EAAE,CAAC,CAAC,KAAK,CAC5B,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACpE;KACF,CAAC;SACD,WAAW,EAAE;CACjB,CAAC,CAAC;AAEH,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;IAEjC,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,cAAc,CAAC,CAAC;IACpF,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,QAAQ,CACb,gBAAgB,EAChB,yBAAyB,SAAS,6BAA6B,CAChE,CAAC;IACJ,CAAC;IAED,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,QAAQ,CACb,gBAAgB,EAChB,iCAAiC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACpF,CAAC;IACJ,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,QAAQ,CACb,gBAAgB,EAChB,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC/E,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAG,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1D,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC1B,OAAO,QAAQ,CAAC,mBAAmB,EAAE,0BAA0B,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC;IAEjC,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEpC,IAAI,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,oBAAoB,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE;YAC5C,EAAE;YACF,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,sBAAsB;SAC/B,CAAC,CAAC;QACH,OAAO;YACL,EAAE,EAAE,IAAI;YACR,UAAU,EAAE,SAAS;YACrB,OAAO,EAAE,UAAU;SACpB,CAAC;IACJ,CAAC;IAED,uBAAuB;IACvB,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACxD,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACvC,OAAO,QAAQ,CAAC,mBAAmB,EAAE,WAAW,SAAS,8BAA8B,CAAC,CAAC;IAC3F,CAAC;IAED,8DAA8D;IAC9D,4DAA4D;IAC5D,qCAAqC;IACrC,MAAM,SAAS,GAAmB,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnE,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,GAAG,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC,CAAC,CAAC;IACJ,MAAM,cAAc,GAA8B;QAChD,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,UAAU;QAC1C,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK;QAChC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,UAAU;QAC1C,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,SAAS;QACxC,MAAM,EAAE,SAAS;KAClB,CAAC;IACF,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAErE,0CAA0C;IAC1C,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC;QAC1C,CAAC,CAAC,MAAM,CAAC,SAAS;QAClB,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC/C,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,yEAAyE;QAC3E,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,6DAA6D;IAC7D,uEAAuE;IACvE,kDAAkD;IAClD,kDAAkD;IAClD,MAAM,eAAe,GAA6B,EAAE,CAAC;IACrD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC;QAC9D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;QAC3D,OAAO,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACtC,IAAI,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QACnE,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,gEAAgE;IAChE,6DAA6D;IAC7D,YAAY;IACZ,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC;IAChD,IAAI,aAAa,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,aAAa,CAAC,EAAE,CAAC;QAC7E,MAAM,SAAS,GAAG,gBAAgB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QAC1D,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,KAAK,CAAC,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,EAAE,CAAC;YACzC,KAAK,CAAC,MAAM,CAAC,uBAAuB,GAAG,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACpD,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG;gBACnC,KAAK,EAAE,aAAa;gBACpB,QAAQ,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE;aACnC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;YACjC,KAAK,CAAC,MAAM,CAAC,uBAAuB,GAAG,IAAI,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAElD,oBAAoB,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE;QAC5C,EAAE;QACF,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,YAAY,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE;KACzJ,CAAC,CAAC;IACH,KAAK,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAC7D,oBAAoB,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE;YAC5C,EAAE;YACF,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,OAAO;YACjB,MAAM,EAAE,wBAAwB,GAAG,CAAC,MAAM,6BAA6B;SACxE,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpC,OAAO;QACL,EAAE,EAAE,IAAI;QACR,UAAU,EAAE,SAAS;QACrB,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,eAAe,EAAE,SAAS,CAAC,MAAM;QACjC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,YAAY;QACvC,uBAAuB,EAAE,eAAe;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,0YAA0Y;IAC5Y,WAAW,EAAE,wBAAwB;IACrC,OAAO;CACR,CAAC"}

package/dist/mcp/tools/mission-resync.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `cairn_mission_resync` — operator amended the source spec doc and
+ * wants Cairn to pick up the changes.
+ *
+ * Re-parses the spec via Haiku (or `no_llm: true` stub fallback),
+ * diffs against the current roadmap.md, and writes a `mission_resync_pending`
+ * marker file under `.cairn/missions/<id>/_resync.json`. The operator
+ * resolves via `cairn-attention` — accepting the diff overwrites the
+ * roadmap and refreshes `spec.md`; rejecting drops the marker.
+ *
+ * No mutation of `roadmap.md` or `phase_progress` happens here — the
+ * operator gates the apply step via `cairn_mission_resync_accept`.
+ */
+import type { ToolDef } from "./types.js";
+interface Input {
+    spec_path?: string;
+    no_llm?: boolean;
+}
+export declare const missionResyncTool: ToolDef<Input>;
+export {};

package/dist/mcp/tools/mission-resync.js

@@ -0,0 +1,113 @@
+/**
+ * `cairn_mission_resync` — operator amended the source spec doc and
+ * wants Cairn to pick up the changes.
+ *
+ * Re-parses the spec via Haiku (or `no_llm: true` stub fallback),
+ * diffs against the current roadmap.md, and writes a `mission_resync_pending`
+ * marker file under `.cairn/missions/<id>/_resync.json`. The operator
+ * resolves via `cairn-attention` — accepting the diff overwrites the
+ * roadmap and refreshes `spec.md`; rejecting drops the marker.
+ *
+ * No mutation of `roadmap.md` or `phase_progress` happens here — the
+ * operator gates the apply step via `cairn_mission_resync_accept`.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { isAbsolute, join, resolve as pathResolve } from "node:path";
+import { appendMissionJournal, findActiveMission, missionRuntimeDir, readRoadmap, } from "@isaacriehm/cairn-state";
+import { requireBootstrap } from "../bootstrap-guard.js";
+import { mcpError } from "../errors.js";
+import { missionResyncInput } from "../schemas.js";
+import { draftRoadmapFromSpec, stubRoadmap } from "../../missions/index.js";
+async function handler(ctx, input) {
+    const block = requireBootstrap(ctx.repoRoot);
+    if (block !== null)
+        return block;
+    const missionId = findActiveMission(ctx.repoRoot);
+    if (missionId === null) {
+        return mcpError("MISSION_NOT_FOUND", "No active mission to resync");
+    }
+    const roadmap = readRoadmap(ctx.repoRoot, missionId);
+    if (roadmap === null) {
+        return mcpError("MISSION_NOT_FOUND", `Roadmap missing for ${missionId}`);
+    }
+    const specPath = input.spec_path ?? roadmap.frontmatter.spec_path;
+    const absSpec = isAbsolute(specPath) ? specPath : pathResolve(ctx.repoRoot, specPath);
+    if (!absSpec.startsWith(ctx.repoRoot)) {
+        return mcpError("PATH_OUTSIDE_REPO", `${specPath} resolves outside the repo`);
+    }
+    if (!existsSync(absSpec)) {
+        return mcpError("FILE_NOT_FOUND", `Spec doc not found: ${specPath}`);
+    }
+    let source;
+    try {
+        source = readFileSync(absSpec, "utf8");
+    }
+    catch (err) {
+        return mcpError("INTERNAL_ERROR", `Failed to read spec doc: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    let newPhases;
+    if (input.no_llm === true) {
+        newPhases = stubRoadmap();
+    }
+    else {
+        const draft = await draftRoadmapFromSpec({
+            repoRoot: ctx.repoRoot,
+            spec: source,
+            specPath,
+        });
+        if (draft === null) {
+            return mcpError("MISSION_DRAFT_FAILED", "Haiku failed to re-parse the spec. Retry, or pass `no_llm: true` for a stub fallback.");
+        }
+        newPhases = draft.phases;
+    }
+    const oldIds = new Set(roadmap.frontmatter.phases.map((p) => p.id));
+    const newIds = new Set(newPhases.map((p) => p.id));
+    const added = [...newIds].filter((id) => !oldIds.has(id));
+    const removed = [...oldIds].filter((id) => !newIds.has(id));
+    const renamed = [];
+    // crude rename detection — same title at different ids
+    for (const op of roadmap.frontmatter.phases) {
+        for (const np of newPhases) {
+            if (op.id !== np.id && op.title === np.title) {
+                renamed.push({ from: op.id, to: np.id });
+            }
+        }
+    }
+    const exit_criteria_changed = [];
+    for (const op of roadmap.frontmatter.phases) {
+        const np = newPhases.find((n) => n.id === op.id);
+        if (np !== undefined && np.exit_criteria !== op.exit_criteria) {
+            exit_criteria_changed.push({ id: op.id, before: op.exit_criteria, after: np.exit_criteria });
+        }
+    }
+    const ts = new Date().toISOString();
+    const resyncPath = join(missionRuntimeDir(ctx.repoRoot, missionId), "_resync.json");
+    mkdirSync(missionRuntimeDir(ctx.repoRoot, missionId), { recursive: true });
+    writeFileSync(resyncPath, JSON.stringify({
+        generated_at: ts,
+        spec_path: specPath,
+        proposed_phases: newPhases,
+        diff: { added, removed, renamed, exit_criteria_changed },
+    }, null, 2), "utf8");
+    appendMissionJournal(ctx.repoRoot, missionId, {
+        ts,
+        kind: "resync-pending",
+        detail: `+${added.length} −${removed.length} ↻${renamed.length} criteria${exit_criteria_changed.length}`,
+    });
+    return {
+        ok: true,
+        mission_id: missionId,
+        spec_path: specPath,
+        diff: { added, removed, renamed, exit_criteria_changed },
+        proposed_phases: newPhases,
+        resync_marker_path: `.cairn/missions/${missionId}/_resync.json`,
+        note: "Operator reviews via cairn-attention (kind: mission_resync_pending). Apply or reject via cairn_mission_resync_accept.",
+    };
+}
+export const missionResyncTool = {
+    name: "cairn_mission_resync",
+    description: "Re-parse the source spec doc, diff against the current roadmap.md, and write a `mission_resync_pending` marker. Does NOT mutate roadmap.md or phase_progress — the operator must accept the diff via cairn-attention. Use when the operator amended the live spec doc; the frozen `spec.md` snapshot stays untouched until the resync is accepted.",
+    inputSchema: missionResyncInput,
+    handler,
+};
+//# sourceMappingURL=mission-resync.js.map

package/dist/mcp/tools/mission-resync.js.map

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

package/dist/mcp/tools/mission-start.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    spec_path: string;
+    exit_gate: "prompt" | "auto" | "manual";
+    no_llm?: boolean;
+}
+export declare const missionStartTool: ToolDef<Input>;
+export {};