@isaacriehm/cairn-core 0.9.8 → 0.10.0

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

@@ -0,0 +1,102 @@
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { isAbsolute, resolve } from "node:path";
+import { appendMissionJournal, deriveMissionId, findActiveMission, initialPhaseProgress, missionRuntimeDir, missionsGroundRoot, nextPendingPhase, writeMissionSpec, writeMissionState, writeRoadmap, } from "@isaacriehm/cairn-state";
+import { requireBootstrap } from "../bootstrap-guard.js";
+import { mcpError } from "../errors.js";
+import { missionAcceptDraftInput } from "../schemas.js";
+async function handler(ctx, input) {
+    const block = requireBootstrap(ctx.repoRoot);
+    if (block !== null)
+        return block;
+    if (findActiveMission(ctx.repoRoot) !== null) {
+        return mcpError("MISSION_ALREADY_ACTIVE", "An active mission already exists. Close or abort it before starting another.");
+    }
+    const absSpec = isAbsolute(input.spec_path)
+        ? input.spec_path
+        : resolve(ctx.repoRoot, input.spec_path);
+    if (!absSpec.startsWith(ctx.repoRoot)) {
+        return mcpError("PATH_OUTSIDE_REPO", `${input.spec_path} resolves outside the repo`);
+    }
+    if (!existsSync(absSpec)) {
+        return mcpError("FILE_NOT_FOUND", `Spec doc not found: ${input.spec_path}`);
+    }
+    let specSource;
+    try {
+        specSource = readFileSync(absSpec, "utf8");
+    }
+    catch (err) {
+        return mcpError("INTERNAL_ERROR", `Failed to read spec doc: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const startedAt = new Date().toISOString();
+    const missionId = deriveMissionId({
+        title: input.title,
+        spec_path: input.spec_path,
+        started_at: startedAt,
+    });
+    const phases = input.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 frontmatter = {
+        mission_id: missionId,
+        title: input.title,
+        spec_path: input.spec_path,
+        created_at: startedAt,
+        exit_gate: input.exit_gate,
+        phases,
+    };
+    // Roadmap dir + per-clone runtime dir.
+    mkdirSync(missionsGroundRoot(ctx.repoRoot), { recursive: true });
+    mkdirSync(missionRuntimeDir(ctx.repoRoot, missionId), { recursive: true });
+    writeRoadmap(ctx.repoRoot, missionId, frontmatter, `# Mission — ${input.title}\n\nSpec: \`${input.spec_path}\`. Phase list above is the canonical structure.\n`);
+    writeMissionSpec(ctx.repoRoot, missionId, specSource);
+    const phaseProgress = initialPhaseProgress(frontmatter);
+    const firstPhase = nextPendingPhase(frontmatter, {
+        mission_id: missionId,
+        started_at: startedAt,
+        cursor: { active_phase: null, active_phase_started_at: null },
+        phase_progress: phaseProgress,
+        outcome: "active",
+    });
+    if (firstPhase !== null) {
+        phaseProgress[firstPhase.id] = {
+            state: "in_progress",
+            task_ids: [],
+        };
+    }
+    writeMissionState(ctx.repoRoot, missionId, {
+        mission_id: missionId,
+        started_at: startedAt,
+        cursor: {
+            active_phase: firstPhase?.id ?? null,
+            active_phase_started_at: firstPhase !== null ? startedAt : null,
+        },
+        phase_progress: phaseProgress,
+        outcome: "active",
+    });
+    // Empty journal + initial entry.
+    appendMissionJournal(ctx.repoRoot, missionId, {
+        ts: startedAt,
+        kind: "started",
+        detail: `${phases.length} phases, exit_gate=${input.exit_gate}`,
+    });
+    return {
+        ok: true,
+        mission_id: missionId,
+        roadmap_path: `.cairn/ground/missions/${missionId}/roadmap.md`,
+        state_path: `.cairn/missions/${missionId}/state.json`,
+        spec_path: `.cairn/missions/${missionId}/spec.md`,
+        cursor: { active_phase: firstPhase?.id ?? null },
+        total_phases: phases.length,
+    };
+}
+export const missionAcceptDraftTool = {
+    name: "cairn_mission_accept_draft",
+    description: "Commit an operator-approved roadmap draft. Generates the mission id (MIS-<slug>-<hash7>), writes `.cairn/ground/missions/<id>/roadmap.md` (committed), `.cairn/missions/<id>/state.json` + `spec.md` (per-clone), and seeds the mission journal. Sets the cursor to the first phase whose `depends_on` is empty.",
+    inputSchema: missionAcceptDraftInput,
+    handler,
+};
+//# sourceMappingURL=mission-accept-draft.js.map

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

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

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

@@ -0,0 +1,8 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    phase_id: string;
+    choice: "exit" | "not_yet" | "defer" | "force" | "drop";
+    defer_hours?: number;
+}
+export declare const missionAdvanceTool: ToolDef<Input>;
+export {};

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

@@ -0,0 +1,124 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { appendMissionJournal, findActiveMission, readMissionState, readRoadmap, writeMissionState, } from "@isaacriehm/cairn-state";
+import { requireBootstrap } from "../bootstrap-guard.js";
+import { mcpError } from "../errors.js";
+import { missionAdvanceInput } from "../schemas.js";
+import { advanceMissionPhase as advancePhase } from "../../missions/index.js";
+function writeMissionPhaseDefer(repoRoot, missionId, phaseId, hours) {
+    const now = new Date();
+    const until = new Date(now.getTime() + hours * 60 * 60 * 1000);
+    const payload = {
+        mission_id: missionId,
+        phase_id: phaseId,
+        deferred_at: now.toISOString(),
+        deferred_until: until.toISOString(),
+    };
+    const path = join(repoRoot, ".cairn", ".mission-phase-deferred-until");
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(payload, null, 2), "utf8");
+    return until.toISOString();
+}
+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 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 phaseInRoadmap = roadmap.frontmatter.phases.some((p) => p.id === input.phase_id);
+    // choice=drop is the drift resolver — phase_id intentionally NOT in
+    // roadmap.md anymore (operator deleted it mid-mission). Removes the
+    // phase from phase_progress and journals the drift resolution.
+    if (input.choice === "drop") {
+        if (phaseInRoadmap) {
+            return mcpError("VALIDATION_FAILED", `phase ${input.phase_id} is still in roadmap.md; choice=drop only resolves drifted ids. Use choice=exit/force to advance an in-roadmap phase.`);
+        }
+        if (!(input.phase_id in state.phase_progress)) {
+            return mcpError("MISSION_PHASE_NOT_FOUND", `phase ${input.phase_id} not present in phase_progress (nothing to drop)`);
+        }
+        const taskIds = state.phase_progress[input.phase_id]?.task_ids ?? [];
+        delete state.phase_progress[input.phase_id];
+        writeMissionState(ctx.repoRoot, missionId, state);
+        appendMissionJournal(ctx.repoRoot, missionId, {
+            ts: new Date().toISOString(),
+            kind: "drift-detected",
+            phase_id: input.phase_id,
+            detail: `dropped — ${taskIds.length} graduated task(s) orphaned`,
+        });
+        return {
+            ok: true,
+            action: "dropped",
+            mission_id: missionId,
+            phase_id: input.phase_id,
+            orphaned_task_ids: taskIds,
+        };
+    }
+    if (!phaseInRoadmap) {
+        return mcpError("MISSION_PHASE_NOT_FOUND", `phase ${input.phase_id} not in roadmap`);
+    }
+    if (input.choice === "not_yet") {
+        appendMissionJournal(ctx.repoRoot, missionId, {
+            ts: new Date().toISOString(),
+            kind: "phase-deferred",
+            phase_id: input.phase_id,
+            detail: "operator chose not_yet",
+        });
+        return { ok: true, action: "deferred", mission_id: missionId, phase_id: input.phase_id };
+    }
+    if (input.choice === "defer") {
+        const hours = input.defer_hours ?? 24;
+        const deferredUntil = writeMissionPhaseDefer(ctx.repoRoot, missionId, input.phase_id, hours);
+        appendMissionJournal(ctx.repoRoot, missionId, {
+            ts: new Date().toISOString(),
+            kind: "phase-deferred",
+            phase_id: input.phase_id,
+            detail: `defer ${hours}h`,
+        });
+        return {
+            ok: true,
+            action: "deferred",
+            mission_id: missionId,
+            phase_id: input.phase_id,
+            deferred_until: deferredUntil,
+        };
+    }
+    // choice === "exit" || "force"
+    if (input.choice === "exit") {
+        const progress = state.phase_progress[input.phase_id];
+        if (progress === undefined || progress.task_ids.length === 0) {
+            return mcpError("VALIDATION_FAILED", `phase ${input.phase_id} has no linked tasks. Pass choice="force" to advance an empty phase.`);
+        }
+    }
+    const result = advancePhase(ctx.repoRoot, missionId, input.phase_id);
+    if (!result.ok) {
+        return mcpError(result.code === "PHASE_NOT_FOUND"
+            ? "MISSION_PHASE_NOT_FOUND"
+            : result.code === "MISSION_NOT_FOUND"
+                ? "MISSION_NOT_FOUND"
+                : "VALIDATION_FAILED", result.message);
+    }
+    return {
+        ok: true,
+        action: result.closed ? "closed" : "advanced",
+        mission_id: missionId,
+        phase_advanced: result.phase_advanced,
+        next_phase: result.next_phase?.id ?? null,
+        next_phase_title: result.next_phase?.title ?? null,
+        progress: { done: result.donePhases, total: result.totalPhases },
+        closed: result.closed,
+    };
+}
+export const missionAdvanceTool = {
+    name: "cairn_mission_advance",
+    description: "Resolve a phase-exit prompt (or manually advance the mission). `choice=exit` marks the named phase done and advances the cursor; refused when the phase has zero linked tasks (use force). `choice=force` advances even when the phase has zero linked tasks. `choice=not_yet` keeps the cursor — next code-change task gets attached to the same phase. `choice=defer` suppresses the phase-exit prompt for `defer_hours` (default 24). `choice=drop` removes a drifted phase id from `phase_progress` (the id was deleted from roadmap.md mid-mission); refuses if the phase is still present in roadmap.md. When the advance hits the last pending phase, the mission is auto-closed and archived.",
+    inputSchema: missionAdvanceInput,
+    handler,
+};
+//# sourceMappingURL=mission-advance.js.map

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

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

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

@@ -0,0 +1,8 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    mission_id: string;
+    outcome: "done" | "aborted";
+    reason?: string;
+}
+export declare const missionCloseTool: ToolDef<Input>;
+export {};

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

@@ -0,0 +1,48 @@
+import { appendMissionJournal, archiveMission, locateMission, readMissionState, writeMissionState, } from "@isaacriehm/cairn-state";
+import { requireBootstrap } from "../bootstrap-guard.js";
+import { mcpError } from "../errors.js";
+import { missionCloseInput } from "../schemas.js";
+async function handler(ctx, input) {
+    const block = requireBootstrap(ctx.repoRoot);
+    if (block !== null)
+        return block;
+    const scope = locateMission(ctx.repoRoot, input.mission_id);
+    if (scope !== "active") {
+        return mcpError("MISSION_NOT_FOUND", `Mission ${input.mission_id} not active (scope=${scope ?? "missing"})`);
+    }
+    const state = readMissionState(ctx.repoRoot, input.mission_id);
+    if (state === null) {
+        return mcpError("MISSION_NOT_FOUND", `state.json missing for ${input.mission_id}`);
+    }
+    const closedAt = new Date().toISOString();
+    state.outcome = input.outcome;
+    state.cursor.active_phase = null;
+    state.cursor.active_phase_started_at = null;
+    state.closed_at = closedAt;
+    if (input.outcome === "aborted" && input.reason !== undefined) {
+        state.abort_reason = input.reason;
+    }
+    writeMissionState(ctx.repoRoot, input.mission_id, state);
+    appendMissionJournal(ctx.repoRoot, input.mission_id, {
+        ts: closedAt,
+        kind: "closed",
+        detail: input.outcome === "aborted"
+            ? `aborted${input.reason !== undefined ? `: ${input.reason}` : ""}`
+            : "manual close",
+    });
+    archiveMission(ctx.repoRoot, input.mission_id);
+    return {
+        ok: true,
+        mission_id: input.mission_id,
+        outcome: input.outcome,
+        closed_at: closedAt,
+        archived_to: `.cairn/ground/missions/_done/${input.mission_id}/`,
+    };
+}
+export const missionCloseTool = {
+    name: "cairn_mission_close",
+    description: "Close a mission and archive its dirs. `outcome=done` is the manual analogue of auto-close on last phase complete; `outcome=aborted` is the operator-driven cancel path (with optional `reason`). Roadmap moves to `.cairn/ground/missions/_done/<id>/`; per-clone runtime moves to `.cairn/missions/_done/<id>/`. Reversible via cairn_mission_reopen.",
+    inputSchema: missionCloseInput,
+    handler,
+};
+//# sourceMappingURL=mission-close.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mission-close.js","sourceRoot":"","sources":["../../../src/mcp/tools/mission-close.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AASlD,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,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5D,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,QAAQ,CACb,mBAAmB,EACnB,WAAW,KAAK,CAAC,UAAU,sBAAsB,KAAK,IAAI,SAAS,GAAG,CACvE,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,QAAQ,CAAC,mBAAmB,EAAE,0BAA0B,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,KAAK,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,MAAM,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC3B,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9D,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC;IACpC,CAAC;IACD,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAEzD,oBAAoB,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE;QACnD,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,QAAQ;QACd,MAAM,EACJ,KAAK,CAAC,OAAO,KAAK,SAAS;YACzB,CAAC,CAAC,UAAU,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YACnE,CAAC,CAAC,cAAc;KACrB,CAAC,CAAC;IAEH,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAE/C,OAAO;QACL,EAAE,EAAE,IAAI;QACR,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,gCAAgC,KAAK,CAAC,UAAU,GAAG;KACjE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,wVAAwV;IAC1V,WAAW,EAAE,iBAAiB;IAC9B,OAAO;CACR,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { ToolDef } from "./types.js";
+interface Input {
+    mission_id?: string;
+}
+export declare const missionGetTool: ToolDef<Input>;
+export {};

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

@@ -0,0 +1,64 @@
+import { countDonePhases, detectRoadmapDrift, findActiveMission, locateMission, readMissionState, readRoadmap, } from "@isaacriehm/cairn-state";
+import { requireBootstrap } from "../bootstrap-guard.js";
+import { mcpError } from "../errors.js";
+import { missionGetInput } from "../schemas.js";
+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 };
+    }
+    const scope = locateMission(ctx.repoRoot, missionId);
+    if (scope === null) {
+        return mcpError("MISSION_NOT_FOUND", `Mission ${missionId} not found in active or done sets`);
+    }
+    // Reading roadmap from `_done/` happens via `locateMission` returning
+    // "done"; the schema-validated reader looks at the live roadmap path
+    // for active missions only. For now `mission_get` is scoped to active
+    // missions; closed-mission inspection is a separate `cairn timeline`
+    // surface.
+    if (scope === "done") {
+        return mcpError("MISSION_NOT_FOUND", `Mission ${missionId} is archived (use cairn_mission_reopen to inspect)`);
+    }
+    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 drift = detectRoadmapDrift(roadmap.frontmatter, state);
+    const cursorPhaseId = state.cursor.active_phase;
+    const cursorPhase = cursorPhaseId === null
+        ? null
+        : roadmap.frontmatter.phases.find((p) => p.id === cursorPhaseId) ?? null;
+    return {
+        ok: true,
+        active: true,
+        mission_id: missionId,
+        title: roadmap.frontmatter.title,
+        spec_path: roadmap.frontmatter.spec_path,
+        exit_gate: roadmap.frontmatter.exit_gate,
+        cursor: {
+            active_phase: cursorPhaseId,
+            active_phase_started_at: state.cursor.active_phase_started_at,
+            active_phase_title: cursorPhase?.title ?? null,
+            active_phase_exit_criteria: cursorPhase?.exit_criteria ?? null,
+            active_phase_exit_gate: cursorPhase?.exit_gate ?? roadmap.frontmatter.exit_gate,
+        },
+        progress: {
+            done: countDonePhases(state),
+            total: roadmap.frontmatter.phases.length,
+        },
+        drift_phase_ids: drift,
+        phase_progress: state.phase_progress,
+        phases: roadmap.frontmatter.phases,
+    };
+}
+export const missionGetTool = {
+    name: "cairn_mission_get",
+    description: "Return the active mission's state — title, spec_path, exit_gate, cursor (active_phase + exit_criteria), N/M phase progress, full phase_progress map, the ordered phase array, and any drift_phase_ids that no longer appear in roadmap.md (operator removed them mid-mission). Returns `{ active: false }` when no active mission exists.",
+    inputSchema: missionGetInput,
+    handler,
+};
+//# sourceMappingURL=mission-get.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * `cairn_mission_reopen` — un-archive a closed mission. Moves the
+ * `_done/<id>/` dirs back to live locations and clears the
+ * `outcome: done|aborted` stamp so the cursor (whatever it was at
+ * close) drives the next session. Does NOT re-execute graduated
+ * phase tasks.
+ */
+import type { ToolDef } from "./types.js";
+interface Input {
+    mission_id: string;
+}
+export declare const missionReopenTool: ToolDef<Input>;
+export {};

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

@@ -0,0 +1,56 @@
+/**
+ * `cairn_mission_reopen` — un-archive a closed mission. Moves the
+ * `_done/<id>/` dirs back to live locations and clears the
+ * `outcome: done|aborted` stamp so the cursor (whatever it was at
+ * close) drives the next session. Does NOT re-execute graduated
+ * phase tasks.
+ */
+import { appendMissionJournal, findActiveMission, locateMission, readMissionState, restoreMission, writeMissionState, } from "@isaacriehm/cairn-state";
+import { requireBootstrap } from "../bootstrap-guard.js";
+import { mcpError } from "../errors.js";
+import { missionReopenInput } from "../schemas.js";
+async function handler(ctx, input) {
+    const block = requireBootstrap(ctx.repoRoot);
+    if (block !== null)
+        return block;
+    const scope = locateMission(ctx.repoRoot, input.mission_id);
+    if (scope === null) {
+        return mcpError("MISSION_NOT_FOUND", `Mission ${input.mission_id} not found`);
+    }
+    if (scope === "active") {
+        return mcpError("VALIDATION_FAILED", `Mission ${input.mission_id} is already active (no reopen needed)`);
+    }
+    if (findActiveMission(ctx.repoRoot) !== null) {
+        return mcpError("MISSION_ALREADY_ACTIVE", "Another mission is already active; close it before reopening this one (one active mission per repo).");
+    }
+    const moved = restoreMission(ctx.repoRoot, input.mission_id);
+    if (!moved) {
+        return mcpError("MISSION_NOT_FOUND", `Could not move archived dirs for ${input.mission_id}`);
+    }
+    const state = readMissionState(ctx.repoRoot, input.mission_id);
+    if (state !== null) {
+        state.outcome = "active";
+        delete state.closed_at;
+        delete state.abort_reason;
+        writeMissionState(ctx.repoRoot, input.mission_id, state);
+    }
+    const reopenedAt = new Date().toISOString();
+    appendMissionJournal(ctx.repoRoot, input.mission_id, {
+        ts: reopenedAt,
+        kind: "reopened",
+        detail: `cursor: ${state?.cursor.active_phase ?? "(none)"}`,
+    });
+    return {
+        ok: true,
+        mission_id: input.mission_id,
+        cursor: state?.cursor ?? null,
+        reopened_at: reopenedAt,
+    };
+}
+export const missionReopenTool = {
+    name: "cairn_mission_reopen",
+    description: "Un-archive a closed mission. Moves `.cairn/ground/missions/_done/<id>/` and `.cairn/missions/_done/<id>/` back to their live locations, resets `outcome` to active, and preserves the cursor at close-time. Refuses when another mission is already active. Does NOT re-execute graduated phase tasks.",
+    inputSchema: missionReopenInput,
+    handler,
+};
+//# sourceMappingURL=mission-reopen.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mission-reopen.js","sourceRoot":"","sources":["../../../src/mcp/tools/mission-reopen.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAOnD,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,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,QAAQ,CAAC,mBAAmB,EAAE,WAAW,KAAK,CAAC,UAAU,YAAY,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,QAAQ,CACb,mBAAmB,EACnB,WAAW,KAAK,CAAC,UAAU,uCAAuC,CACnE,CAAC;IACJ,CAAC;IAED,IAAI,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,OAAO,QAAQ,CACb,wBAAwB,EACxB,sGAAsG,CACvG,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,QAAQ,CAAC,mBAAmB,EAAE,oCAAoC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC;QACzB,OAAO,KAAK,CAAC,SAAS,CAAC;QACvB,OAAO,KAAK,CAAC,YAAY,CAAC;QAC1B,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,oBAAoB,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE;QACnD,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,WAAW,KAAK,EAAE,MAAM,CAAC,YAAY,IAAI,QAAQ,EAAE;KAC5D,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,IAAI;QACR,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,IAAI;QAC7B,WAAW,EAAE,UAAU;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,wSAAwS;IAC1S,WAAW,EAAE,kBAAkB;IAC/B,OAAO;CACR,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * `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 type { ToolDef } from "./types.js";
+interface Input {
+    mission_id?: string;
+}
+export declare const missionResumeTool: ToolDef<Input>;
+export {};