@isaacriehm/cairn-core 0.9.8 → 0.10.0

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

@@ -0,0 +1,76 @@
+import { existsSync, readFileSync } from "node:fs";
+import { isAbsolute, resolve } from "node:path";
+import { findActiveMission } from "@isaacriehm/cairn-state";
+import { requireBootstrap } from "../bootstrap-guard.js";
+import { mcpError } from "../errors.js";
+import { missionStartInput } 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;
+    if (findActiveMission(ctx.repoRoot) !== null) {
+        return mcpError("MISSION_ALREADY_ACTIVE", "An active mission already exists. Close or abort it before starting another (one active mission per repo).");
+    }
+    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 source;
+    try {
+        source = readFileSync(absSpec, "utf8");
+    }
+    catch (err) {
+        return mcpError("INTERNAL_ERROR", `Failed to read spec doc: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const proposedTitle = deriveTitleFromSpec(source, input.spec_path);
+    if (input.no_llm === true) {
+        return {
+            ok: true,
+            proposed_title: proposedTitle,
+            spec_path: input.spec_path,
+            exit_gate: input.exit_gate,
+            phases: stubRoadmap(),
+            truncated: false,
+            llm_used: false,
+        };
+    }
+    const draft = await draftRoadmapFromSpec({
+        repoRoot: ctx.repoRoot,
+        spec: source,
+        specPath: input.spec_path,
+    });
+    if (draft === null) {
+        return mcpError("MISSION_DRAFT_FAILED", "Haiku failed to parse the spec doc. Retry, or pass `no_llm: true` to write a single-phase stub roadmap and hand-edit it.");
+    }
+    return {
+        ok: true,
+        proposed_title: proposedTitle,
+        spec_path: input.spec_path,
+        exit_gate: input.exit_gate,
+        phases: draft.phases,
+        truncated: draft.truncated,
+        llm_used: true,
+    };
+}
+/**
+ * First H1 in the spec, or the spec's filename without extension.
+ * Capped at 60 chars so the slug fits within the statusline budget.
+ */
+function deriveTitleFromSpec(source, fallback) {
+    const m = source.match(/^#\s+(.+?)\s*$/m);
+    const raw = m?.[1] ?? fallback.replace(/^.*\//, "").replace(/\.[a-z]+$/i, "");
+    return raw.slice(0, 60);
+}
+export const missionStartTool = {
+    name: "cairn_mission_start",
+    description: "Read a planning spec doc and draft a mission roadmap via Haiku. Returns the draft (proposed_title + ordered phases + spec_path + exit_gate) for operator approval. Does NOT write anything to disk; the caller invokes cairn_mission_accept_draft once the operator confirms. Pass `no_llm: true` to skip Haiku and return a single-phase stub.",
+    inputSchema: missionStartInput,
+    handler,
+};
+//# sourceMappingURL=mission-start.js.map

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

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

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

@@ -11,6 +11,8 @@ interface Input {
     acceptance?: string[];
     module?: string;
     needs_review?: boolean;
+    mission_id?: string;
+    phase_id?: string;
 }
 export declare const taskCreateTool: ToolDef<Input>;
 export {};

package/dist/mcp/tools/task-create.js

@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { createHash, randomUUID } from "node:crypto";
 import { stringify as stringifyYaml } from "yaml";
+import { findActiveMission, readMissionState, readRoadmap, } from "@isaacriehm/cairn-state";
 import { requireBootstrap } from "../bootstrap-guard.js";
 import { mcpError } from "../errors.js";
 import { taskCreateInput } from "../schemas.js";
@@ -45,6 +46,36 @@ async function handler(ctx, input) {
     mkdirSync(taskDir, { recursive: true });
     const generatedAt = new Date().toISOString();
     const needsReview = input.needs_review ?? true;
+    // Mission anchor — explicit input wins; otherwise inherit from the
+    // active mission's cursor. Empty string means opt-out (side-task).
+    let missionId = null;
+    let phaseId = null;
+    if (input.mission_id === "") {
+        missionId = null;
+        phaseId = null;
+    }
+    else if (input.mission_id !== undefined && input.mission_id !== null) {
+        missionId = input.mission_id;
+        phaseId = input.phase_id ?? null;
+    }
+    else {
+        const activeMission = findActiveMission(ctx.repoRoot);
+        if (activeMission !== null) {
+            const state = readMissionState(ctx.repoRoot, activeMission);
+            const roadmap = readRoadmap(ctx.repoRoot, activeMission);
+            const cursorPhase = state?.cursor.active_phase ?? null;
+            if (cursorPhase !== null && roadmap?.frontmatter.phases.some((p) => p.id === cursorPhase)) {
+                missionId = activeMission;
+                phaseId = input.phase_id ?? cursorPhase;
+            }
+        }
+    }
+    if (missionId !== null && phaseId !== null) {
+        const roadmap = readRoadmap(ctx.repoRoot, missionId);
+        if (roadmap !== null && !roadmap.frontmatter.phases.some((p) => p.id === phaseId)) {
+            return mcpError("VALIDATION_FAILED", `phase_id ${phaseId} not present in roadmap of ${missionId}`);
+        }
+    }
     const specFrontmatter = {
         id: taskId,
         title: input.title,
@@ -77,13 +108,18 @@ async function handler(ctx, input) {
     const specContent = `---\n${stringifyYaml(specFrontmatter)}---\n\n${specBody}`;
     const specPath = join(taskDir, "spec.tightened.md");
     writeFileSync(specPath, specContent, "utf8");
-    const statusContent = stringifyYaml({
+    const statusFrame = {
         id: taskId,
         phase: "running",
         module: input.module ?? input.target_path_globs[0]?.split("/")[0] ?? ".",
         title: input.title,
         started_at: generatedAt,
-    });
+    };
+    if (missionId !== null && phaseId !== null) {
+        statusFrame["mission_id"] = missionId;
+        statusFrame["phase_id"] = phaseId;
+    }
+    const statusContent = stringifyYaml(statusFrame);
     const statusPath = join(taskDir, "status.yaml");
     writeFileSync(statusPath, statusContent, "utf8");
     return {
@@ -93,6 +129,8 @@ async function handler(ctx, input) {
         status_path: `.cairn/tasks/active/${taskId}/status.yaml`,
         in_scope_decisions: input.in_scope_decisions ?? [],
         in_scope_invariants: (input.in_scope_invariants ?? []).map(renderInvariantId),
+        mission_id: missionId,
+        phase_id: phaseId,
     };
 }
 export const taskCreateTool = {

package/dist/mcp/tools/task-create.js.map

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

package/dist/missions/cli.d.ts

@@ -0,0 +1,106 @@
+/**
+ * CLI wrappers around the mission MCP tools — `cairn mission ...`
+ * subcommands. Reuses the helper modules (cursor, draft, task-link)
+ * directly so the CLI stays in lock-step with the MCP surface.
+ */
+import { type MissionExitGate, type MissionPhase } from "@isaacriehm/cairn-state";
+export interface MissionStartArgs {
+    repoRoot: string;
+    specPath: string;
+    exitGate: MissionExitGate;
+    noLlm?: boolean;
+}
+export interface MissionStartResult {
+    proposed_title: string;
+    spec_path: string;
+    exit_gate: MissionExitGate;
+    phases: MissionPhase[];
+    llm_used: boolean;
+}
+export declare function runMissionStart(args: MissionStartArgs): Promise<MissionStartResult>;
+export interface MissionAcceptArgs {
+    repoRoot: string;
+    title: string;
+    specPath: string;
+    exitGate: MissionExitGate;
+    phases: MissionPhase[];
+}
+export interface MissionAcceptResult {
+    mission_id: string;
+    cursor: {
+        active_phase: string | null;
+    };
+    total_phases: number;
+}
+export declare function runMissionAccept(args: MissionAcceptArgs): MissionAcceptResult;
+export interface MissionGetResult {
+    active: boolean;
+    mission_id?: string;
+    title?: string;
+    cursor?: {
+        active_phase: string | null;
+    };
+    progress?: {
+        done: number;
+        total: number;
+    };
+    drift_phase_ids?: string[];
+}
+export declare function runMissionGet(repoRoot: string): MissionGetResult;
+export interface MissionAdvanceArgs {
+    repoRoot: string;
+    phaseId: string;
+    force?: boolean;
+    drop?: boolean;
+}
+export declare function runMissionAdvance(args: MissionAdvanceArgs): {
+    kind: "advanced";
+    phase_advanced: string;
+    next_phase: string | null;
+    closed: boolean;
+} | {
+    kind: "dropped";
+    phase_id: string;
+    orphaned_task_ids: string[];
+};
+export declare function runMissionClose(repoRoot: string, missionId: string, outcome: "done" | "aborted", reason?: string): {
+    mission_id: string;
+    outcome: string;
+    closed_at: string;
+};
+export declare function runMissionReopen(repoRoot: string, missionId: string): {
+    mission_id: string;
+    cursor: {
+        active_phase: string | null;
+    } | null;
+    reopened_at: string;
+};
+export declare function listMissions(repoRoot: string): {
+    active: string[];
+    done: string[];
+};
+/**
+ * Pretty-print a roadmap to a string for `cairn mission start --print`
+ * preview output. Matches the YAML-frontmatter shape Cairn writes to
+ * disk so the operator can copy + edit it before approval.
+ */
+export declare function previewRoadmap(args: {
+    title: string;
+    specPath: string;
+    exitGate: MissionExitGate;
+    phases: MissionPhase[];
+}): string;
+/** Used by `cairn mission accept --from <file>` to load a hand-edited roadmap draft. */
+export declare function loadDraftFromFile(path: string): {
+    title: string;
+    spec_path: string;
+    exit_gate: MissionExitGate;
+    phases: MissionPhase[];
+};
+/** Persist the proposed roadmap draft to a temp JSON file for hand-editing. */
+export declare function writeDraftToFile(path: string, draft: {
+    title: string;
+    spec_path: string;
+    exit_gate: MissionExitGate;
+    phases: MissionPhase[];
+}): void;

package/dist/missions/cli.js

@@ -0,0 +1,279 @@
+/**
+ * CLI wrappers around the mission MCP tools — `cairn mission ...`
+ * subcommands. Reuses the helper modules (cursor, draft, task-link)
+ * directly so the CLI stays in lock-step with the MCP surface.
+ */
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { isAbsolute, resolve as pathResolve } from "node:path";
+import { appendMissionJournal, archiveMission, countDonePhases, deriveMissionId, detectRoadmapDrift, findActiveMission, initialPhaseProgress, listActiveMissionIds, listDoneMissionIds, locateMission, nextPendingPhase, readMissionState, readRoadmap, restoreMission, writeMissionSpec, writeMissionState, writeRoadmap, } from "@isaacriehm/cairn-state";
+import { advancePhase } from "./cursor.js";
+import { draftRoadmapFromSpec, stubRoadmap } from "./draft.js";
+export async function runMissionStart(args) {
+    if (findActiveMission(args.repoRoot) !== null) {
+        throw new Error("An active mission already exists; close or abort it before starting another.");
+    }
+    const abs = isAbsolute(args.specPath) ? args.specPath : pathResolve(args.repoRoot, args.specPath);
+    if (!abs.startsWith(args.repoRoot)) {
+        throw new Error(`${args.specPath} resolves outside the repo`);
+    }
+    if (!existsSync(abs)) {
+        throw new Error(`Spec doc not found: ${args.specPath}`);
+    }
+    const source = readFileSync(abs, "utf8");
+    const proposedTitle = deriveTitleFromSpec(source, args.specPath);
+    if (args.noLlm === true) {
+        return {
+            proposed_title: proposedTitle,
+            spec_path: args.specPath,
+            exit_gate: args.exitGate,
+            phases: stubRoadmap(),
+            llm_used: false,
+        };
+    }
+    const draft = await draftRoadmapFromSpec({
+        repoRoot: args.repoRoot,
+        spec: source,
+        specPath: args.specPath,
+    });
+    if (draft === null) {
+        throw new Error("Haiku failed to parse the spec doc; retry or pass --no-llm");
+    }
+    return {
+        proposed_title: proposedTitle,
+        spec_path: args.specPath,
+        exit_gate: args.exitGate,
+        phases: draft.phases,
+        llm_used: true,
+    };
+}
+export function runMissionAccept(args) {
+    if (findActiveMission(args.repoRoot) !== null) {
+        throw new Error("An active mission already exists; close or abort it before starting another.");
+    }
+    const abs = isAbsolute(args.specPath) ? args.specPath : pathResolve(args.repoRoot, args.specPath);
+    if (!existsSync(abs)) {
+        throw new Error(`Spec doc not found: ${args.specPath}`);
+    }
+    const startedAt = new Date().toISOString();
+    const missionId = deriveMissionId({ title: args.title, spec_path: args.specPath, started_at: startedAt });
+    const frontmatter = {
+        mission_id: missionId,
+        title: args.title,
+        spec_path: args.specPath,
+        created_at: startedAt,
+        exit_gate: args.exitGate,
+        phases: args.phases,
+    };
+    writeRoadmap(args.repoRoot, missionId, frontmatter, `# Mission — ${args.title}\n\nSpec: \`${args.specPath}\`.\n`);
+    writeMissionSpec(args.repoRoot, missionId, readFileSync(abs, "utf8"));
+    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(args.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",
+    });
+    appendMissionJournal(args.repoRoot, missionId, {
+        ts: startedAt,
+        kind: "started",
+        detail: `${args.phases.length} phases, exit_gate=${args.exitGate}`,
+    });
+    return {
+        mission_id: missionId,
+        cursor: { active_phase: firstPhase?.id ?? null },
+        total_phases: args.phases.length,
+    };
+}
+export function runMissionGet(repoRoot) {
+    const id = findActiveMission(repoRoot);
+    if (id === null)
+        return { active: false };
+    const roadmap = readRoadmap(repoRoot, id);
+    const state = readMissionState(repoRoot, id);
+    if (roadmap === null || state === null)
+        return { active: false };
+    return {
+        active: true,
+        mission_id: id,
+        title: roadmap.frontmatter.title,
+        cursor: { active_phase: state.cursor.active_phase },
+        progress: { done: countDonePhases(state), total: roadmap.frontmatter.phases.length },
+        drift_phase_ids: detectRoadmapDrift(roadmap.frontmatter, state),
+    };
+}
+export function runMissionAdvance(args) {
+    const missionId = findActiveMission(args.repoRoot);
+    if (missionId === null)
+        throw new Error("No active mission");
+    const state = readMissionState(args.repoRoot, missionId);
+    if (state === null)
+        throw new Error(`state.json missing for ${missionId}`);
+    const roadmap = readRoadmap(args.repoRoot, missionId);
+    if (roadmap === null)
+        throw new Error(`roadmap.md missing for ${missionId}`);
+    if (args.drop === true) {
+        if (roadmap.frontmatter.phases.some((p) => p.id === args.phaseId)) {
+            throw new Error(`phase ${args.phaseId} is still in roadmap.md; --drop only resolves drifted ids`);
+        }
+        const progress = state.phase_progress[args.phaseId];
+        if (progress === undefined) {
+            throw new Error(`phase ${args.phaseId} not present in phase_progress`);
+        }
+        const taskIds = progress.task_ids;
+        delete state.phase_progress[args.phaseId];
+        writeMissionState(args.repoRoot, missionId, state);
+        appendMissionJournal(args.repoRoot, missionId, {
+            ts: new Date().toISOString(),
+            kind: "drift-detected",
+            phase_id: args.phaseId,
+            detail: `dropped — ${taskIds.length} graduated task(s) orphaned`,
+        });
+        return { kind: "dropped", phase_id: args.phaseId, orphaned_task_ids: taskIds };
+    }
+    if (args.force !== true) {
+        const progress = state.phase_progress[args.phaseId];
+        if (progress === undefined || progress.task_ids.length === 0) {
+            throw new Error(`phase ${args.phaseId} has no linked tasks; pass --force to advance`);
+        }
+    }
+    const r = advancePhase(args.repoRoot, missionId, args.phaseId);
+    if (!r.ok)
+        throw new Error(r.message);
+    return {
+        kind: "advanced",
+        phase_advanced: r.phase_advanced,
+        next_phase: r.next_phase?.id ?? null,
+        closed: r.closed,
+    };
+}
+export function runMissionClose(repoRoot, missionId, outcome, reason) {
+    if (locateMission(repoRoot, missionId) !== "active") {
+        throw new Error(`Mission ${missionId} is not active`);
+    }
+    const state = readMissionState(repoRoot, missionId);
+    if (state === null)
+        throw new Error(`state.json missing for ${missionId}`);
+    const closedAt = new Date().toISOString();
+    state.outcome = outcome;
+    state.cursor.active_phase = null;
+    state.cursor.active_phase_started_at = null;
+    state.closed_at = closedAt;
+    if (outcome === "aborted" && reason !== undefined)
+        state.abort_reason = reason;
+    writeMissionState(repoRoot, missionId, state);
+    appendMissionJournal(repoRoot, missionId, {
+        ts: closedAt,
+        kind: "closed",
+        detail: outcome === "aborted" ? `aborted${reason !== undefined ? `: ${reason}` : ""}` : "manual close",
+    });
+    archiveMission(repoRoot, missionId);
+    return { mission_id: missionId, outcome, closed_at: closedAt };
+}
+export function runMissionReopen(repoRoot, missionId) {
+    if (locateMission(repoRoot, missionId) !== "done") {
+        throw new Error(`Mission ${missionId} is not archived`);
+    }
+    if (findActiveMission(repoRoot) !== null) {
+        throw new Error("Another mission is already active");
+    }
+    if (!restoreMission(repoRoot, missionId)) {
+        throw new Error(`Could not restore archived dirs for ${missionId}`);
+    }
+    const state = readMissionState(repoRoot, missionId);
+    const reopenedAt = new Date().toISOString();
+    if (state !== null) {
+        state.outcome = "active";
+        delete state.closed_at;
+        delete state.abort_reason;
+        writeMissionState(repoRoot, missionId, state);
+    }
+    appendMissionJournal(repoRoot, missionId, {
+        ts: reopenedAt,
+        kind: "reopened",
+        detail: `cursor: ${state?.cursor.active_phase ?? "(none)"}`,
+    });
+    return {
+        mission_id: missionId,
+        cursor: state?.cursor ?? null,
+        reopened_at: reopenedAt,
+    };
+}
+export function listMissions(repoRoot) {
+    return {
+        active: listActiveMissionIds(repoRoot),
+        done: listDoneMissionIds(repoRoot),
+    };
+}
+function deriveTitleFromSpec(source, fallback) {
+    const m = source.match(/^#\s+(.+?)\s*$/m);
+    const raw = m?.[1] ?? fallback.replace(/^.*\//, "").replace(/\.[a-z]+$/i, "");
+    return raw.slice(0, 60);
+}
+/**
+ * Pretty-print a roadmap to a string for `cairn mission start --print`
+ * preview output. Matches the YAML-frontmatter shape Cairn writes to
+ * disk so the operator can copy + edit it before approval.
+ */
+export function previewRoadmap(args) {
+    const lines = [];
+    lines.push(`# Mission preview — ${args.title}`);
+    lines.push("");
+    lines.push(`spec_path: ${args.specPath}`);
+    lines.push(`exit_gate: ${args.exitGate}`);
+    lines.push("");
+    lines.push("Phases:");
+    for (const p of args.phases) {
+        lines.push(`  - ${p.id}: ${p.title}`);
+        if (p.depends_on.length > 0)
+            lines.push(`    depends_on: ${p.depends_on.join(", ")}`);
+        lines.push(`    exit_criteria: ${p.exit_criteria}`);
+    }
+    return lines.join("\n");
+}
+/** Used by `cairn mission accept --from <file>` to load a hand-edited roadmap draft. */
+export function loadDraftFromFile(path) {
+    if (!existsSync(path))
+        throw new Error(`Draft file not found: ${path}`);
+    const raw = readFileSync(path, "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed !== "object" || parsed === null)
+        throw new Error("Draft file must be a JSON object");
+    const obj = parsed;
+    if (typeof obj["title"] !== "string")
+        throw new Error("Draft missing title");
+    if (typeof obj["spec_path"] !== "string")
+        throw new Error("Draft missing spec_path");
+    if (typeof obj["exit_gate"] !== "string")
+        throw new Error("Draft missing exit_gate");
+    if (!Array.isArray(obj["phases"]))
+        throw new Error("Draft missing phases array");
+    const exitGate = obj["exit_gate"];
+    if (exitGate !== "prompt" && exitGate !== "auto" && exitGate !== "manual") {
+        throw new Error(`Invalid exit_gate: ${exitGate}`);
+    }
+    return {
+        title: obj["title"],
+        spec_path: obj["spec_path"],
+        exit_gate: exitGate,
+        phases: obj["phases"],
+    };
+}
+/** Persist the proposed roadmap draft to a temp JSON file for hand-editing. */
+export function writeDraftToFile(path, draft) {
+    writeFileSync(path, JSON.stringify(draft, null, 2) + "\n", "utf8");
+}
+//# sourceMappingURL=cli.js.map

package/dist/missions/cli.js.map

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

package/dist/missions/cursor.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Mission cursor advance helpers — shared logic between the explicit
+ * `cairn_mission_advance` MCP tool, the Stop hook auto-advance path
+ * (exit_gate=auto), and the Stop hook prompt path (exit_gate=prompt
+ * after operator picks `a`).
+ */
+import { type MissionPhase, type MissionRoadmapFrontmatter, type MissionState } from "@isaacriehm/cairn-state";
+export interface AdvanceResult {
+    ok: true;
+    phase_advanced: string;
+    next_phase: MissionPhase | null;
+    /** True when this advance closed the mission. */
+    closed: boolean;
+    donePhases: number;
+    totalPhases: number;
+}
+export interface AdvanceError {
+    ok: false;
+    code: "MISSION_NOT_FOUND" | "PHASE_NOT_FOUND" | "PHASE_ALREADY_DONE" | "ROADMAP_MISSING" | "STATE_MISSING";
+    message: string;
+}
+/**
+ * Mark `phaseId` as done in `phase_progress` and pick the next pending
+ * phase whose `depends_on` set is satisfied. When no eligible phase
+ * remains, set `cursor.active_phase = null`, mark `outcome: done`, and
+ * archive the mission dirs.
+ */
+export declare function advancePhase(repoRoot: string, missionId: string, phaseId: string, now?: Date): AdvanceResult | AdvanceError;
+/**
+ * Determine whether every linked task on a phase has graduated.
+ * Returns `false` when the phase has zero tasks (the operator has to
+ * `mission_advance --force` for empty phases — never auto-advance an
+ * empty phase silently).
+ */
+export declare function allPhaseTasksDone(state: MissionState, phaseId: string, taskIsDone: (taskId: string) => boolean): boolean;
+/**
+ * Resolve a roadmap phase by id from a mission's roadmap. Returns null
+ * when the id was deleted in a mid-mission roadmap edit (drift case).
+ */
+export declare function lookupPhase(roadmap: MissionRoadmapFrontmatter, phaseId: string): MissionPhase | null;