@isaacriehm/cairn-core 0.1.10 → 0.2.0

package/dist/init/phases/3b-seed.js

@@ -0,0 +1,149 @@
+/**
+ * Phase 3b-seed — write `.cairn/` skeleton + project overlay +
+ * grandfather pre-adoption commits.
+ *
+ * Bridges 3-mapper and 4-pilot. Without this phase the v0.2.0 init
+ * pipeline produced an `.cairn/` populated only by side effects of
+ * downstream phases (events/, baseline/, ground/decisions/_inbox/)
+ * but never wrote `config.yaml`, `git-hooks/`, or the brand /
+ * canonical-map / capabilities skeleton — leaving the project in a
+ * "half-adopted" shape that subsequent SessionStarts could not
+ * detect as adopted.
+ *
+ * Steps:
+ *   1. seedCairnLayout (templates → .cairn/)
+ *   2. updateWorkflowSlugBlock (mapper output → workflow.md)
+ *   3. write .cairn/config.yaml + .cairn/ground/scope-index.yaml
+ *   4. seed .cairn/.attested-commits with every reachable HEAD SHA
+ *      so the Stop-hook bypass detector grandfathers pre-adoption
+ *      history (otherwise the very next assistant turn flags every
+ *      pre-adoption commit as a `--no-verify` bypass).
+ *
+ * No operator input. Always advances. Idempotent — re-running on a
+ * project that already has .cairn/ keeps existing files (collisions
+ * recorded in seed.collisions but not fatal).
+ */
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { stringify as stringifyYaml } from "yaml";
+import { scopeIndexPath, writeScopeIndex, } from "../../ground/scope-index.js";
+import { seedAttestedCommits } from "../../hooks/seed-attested.js";
+import { buildProjectOverlay } from "../overlay.js";
+import { seedCairnLayout } from "../seed.js";
+import { updateWorkflowSlugBlock } from "../workflow-block.js";
+import { advancePhase } from "./orchestrator.js";
+export async function runPhase3bSeed(state) {
+    const detection = state.outputs["1-detect"];
+    const mapperResult = state.outputs["3-mapper"];
+    if (detection === undefined) {
+        return {
+            status: "error",
+            error: {
+                code: "missing-prereqs",
+                message: "Phase 3b-seed needs phase 1-detect output",
+            },
+            state,
+        };
+    }
+    const projectSlug = detection.project_slug;
+    const mapperOutput = mapperResult?.output;
+    try {
+        // Step 1 — seed templates into .cairn/.
+        const seed = seedCairnLayout({ repoRoot: state.repoRoot, projectSlug });
+        // Step 2 — patch <slug>: workflow.md block when workflow.md was
+        // freshly seeded (existing workflow stays untouched on re-run).
+        const wfRel = ".cairn/config/workflow.md";
+        const wfWasSeeded = seed.written_files.includes(wfRel);
+        let workflowSlugPatched = false;
+        let workflowPatchError = null;
+        if (mapperOutput !== undefined && wfWasSeeded) {
+            try {
+                updateWorkflowSlugBlock({
+                    workflowMdPath: join(state.repoRoot, wfRel),
+                    slug: projectSlug,
+                    update: {
+                        pilot_module: mapperOutput.pilot_module,
+                        route_handler_globs: mapperOutput.route_handler_globs,
+                        dto_globs: mapperOutput.dto_globs,
+                        generator_source_globs: mapperOutput.generator_source_globs,
+                        high_stakes_globs: mapperOutput.high_stakes_globs,
+                        off_limits_append: mapperOutput.off_limits_globs,
+                    },
+                });
+                workflowSlugPatched = true;
+            }
+            catch (err) {
+                // Soft fail — record the error and continue. config.yaml +
+                // scope-index still get written below; the operator can
+                // hand-edit workflow.md after init if needed.
+                workflowPatchError =
+                    err instanceof Error ? err.stack ?? err.message : String(err);
+            }
+        }
+        // Step 3 — write .cairn/config.yaml.
+        const configPath = join(state.repoRoot, ".cairn", "config.yaml");
+        mkdirSync(join(state.repoRoot, ".cairn"), { recursive: true });
+        if (!existsSync(configPath)) {
+            const config = buildProjectOverlay({
+                detection,
+                decidedSlug: projectSlug,
+                ...(mapperOutput !== undefined ? { mapperOutput } : {}),
+            });
+            writeFileSync(configPath, stringifyYaml(config), "utf8");
+        }
+        // Step 4 — write .cairn/ground/scope-index.yaml from mapper.
+        const scopeFile = scopeIndexPath(state.repoRoot);
+        if (!existsSync(scopeFile)) {
+            const seedFiles = {};
+            const mapperFiles = mapperOutput?.scope_index?.files ?? {};
+            for (const [path, e] of Object.entries(mapperFiles)) {
+                const entry = {
+                    decisions: e.decisions,
+                    invariants: e.invariants,
+                };
+                if (e.unscoped === true)
+                    entry.unscoped = true;
+                seedFiles[path] = entry;
+            }
+            writeScopeIndex(state.repoRoot, {
+                generated: new Date().toISOString(),
+                files: seedFiles,
+            });
+        }
+        // Step 5 — grandfather pre-adoption commits in
+        // `.cairn/.attested-commits` so the Stop-hook bypass detector
+        // doesn't flag every pre-existing SHA on the next turn.
+        const attestedSeed = seedAttestedCommits(state.repoRoot);
+        const out = {
+            written_files: seed.written_files,
+            collisions: seed.collisions,
+            config_path: ".cairn/config.yaml",
+            scope_index_path: ".cairn/ground/scope-index.yaml",
+            workflow_slug_patched: workflowSlugPatched,
+            workflow_patch_error: workflowPatchError,
+            attested_seeded: attestedSeed.count ?? 0,
+            attested_seed_status: attestedSeed.status,
+        };
+        const next = {
+            ...state,
+            outputs: { ...state.outputs, "3b-seed": out },
+        };
+        return {
+            status: "complete",
+            nextPhase: "4-pilot",
+            state: advancePhase(next),
+        };
+    }
+    catch (err) {
+        return {
+            status: "error",
+            error: {
+                code: "seed-failed",
+                message: "Failed to seed .cairn/ skeleton",
+                detail: err instanceof Error ? err.stack ?? err.message : String(err),
+            },
+            state,
+        };
+    }
+}
+//# sourceMappingURL=3b-seed.js.map

package/dist/init/phases/3b-seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"3b-seed.js","sourceRoot":"","sources":["../../../src/init/phases/3b-seed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAClD,OAAO,EACL,cAAc,EACd,eAAe,GAGhB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAcjD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAiB;IACpD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAgC,CAAC;IAC3E,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAA6B,CAAC;IAC3E,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO;YACL,MAAM,EAAE,OAAO;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,2CAA2C;aACrD;YACD,KAAK;SACN,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GAAG,SAAS,CAAC,YAAY,CAAC;IAC3C,MAAM,YAAY,GAAG,YAAY,EAAE,MAAM,CAAC;IAE1C,IAAI,CAAC;QACH,wCAAwC;QACxC,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QAExE,gEAAgE;QAChE,gEAAgE;QAChE,MAAM,KAAK,GAAG,2BAA2B,CAAC;QAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,mBAAmB,GAAG,KAAK,CAAC;QAChC,IAAI,kBAAkB,GAAkB,IAAI,CAAC;QAC7C,IAAI,YAAY,KAAK,SAAS,IAAI,WAAW,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,uBAAuB,CAAC;oBACtB,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC;oBAC3C,IAAI,EAAE,WAAW;oBACjB,MAAM,EAAE;wBACN,YAAY,EAAE,YAAY,CAAC,YAAY;wBACvC,mBAAmB,EAAE,YAAY,CAAC,mBAAmB;wBACrD,SAAS,EAAE,YAAY,CAAC,SAAS;wBACjC,sBAAsB,EAAE,YAAY,CAAC,sBAAsB;wBAC3D,iBAAiB,EAAE,YAAY,CAAC,iBAAiB;wBACjD,iBAAiB,EAAE,YAAY,CAAC,gBAAgB;qBACjD;iBACF,CAAC,CAAC;gBACH,mBAAmB,GAAG,IAAI,CAAC;YAC7B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,2DAA2D;gBAC3D,wDAAwD;gBACxD,8CAA8C;gBAC9C,kBAAkB;oBAChB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAED,qCAAqC;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QACjE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,mBAAmB,CAAC;gBACjC,SAAS;gBACT,WAAW,EAAE,WAAW;gBACxB,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD,CAAC,CAAC;YACH,aAAa,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3D,CAAC;QAED,6DAA6D;QAC7D,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAoC,EAAE,CAAC;YACtD,MAAM,WAAW,GAAG,YAAY,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC;YAC3D,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBACpD,MAAM,KAAK,GAAoB;oBAC7B,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,UAAU,EAAE,CAAC,CAAC,UAAU;iBACzB,CAAC;gBACF,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI;oBAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;gBAC/C,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YAC1B,CAAC;YACD,eAAe,CAAC,KAAK,CAAC,QAAQ,EAAE;gBAC9B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC;QAED,+CAA+C;QAC/C,8DAA8D;QAC9D,wDAAwD;QACxD,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEzD,MAAM,GAAG,GAAoB;YAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,WAAW,EAAE,oBAAoB;YACjC,gBAAgB,EAAE,gCAAgC;YAClD,qBAAqB,EAAE,mBAAmB;YAC1C,oBAAoB,EAAE,kBAAkB;YACxC,eAAe,EAAE,YAAY,CAAC,KAAK,IAAI,CAAC;YACxC,oBAAoB,EAAE,YAAY,CAAC,MAAM;SAC1C,CAAC;QACF,MAAM,IAAI,GAAe;YACvB,GAAG,KAAK;YACR,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE;SAC9C,CAAC;QACF,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC;SAC1B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,MAAM,EAAE,OAAO;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,iCAAiC;gBAC1C,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACtE;YACD,KAAK;SACN,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/init/phases/4-pilot.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Phase 4-pilot — operator picks the seed module.
+ *
+ * The mapper's `pilot_module` field is the model's first guess; this
+ * phase surfaces it alongside the next 2 strongest `key_modules` so
+ * the operator can override. Picking the pilot determines which
+ * module's globs flow into `.cairn/config.yaml.project_globs` first.
+ */
+import type { PhaseResult, PhaseState } from "./types.js";
+export declare function runPhase4Pilot(state: PhaseState): Promise<PhaseResult>;

package/dist/init/phases/4-pilot.js

@@ -0,0 +1,70 @@
+/**
+ * Phase 4-pilot — operator picks the seed module.
+ *
+ * The mapper's `pilot_module` field is the model's first guess; this
+ * phase surfaces it alongside the next 2 strongest `key_modules` so
+ * the operator can override. Picking the pilot determines which
+ * module's globs flow into `.cairn/config.yaml.project_globs` first.
+ */
+import { advancePhase } from "./orchestrator.js";
+const MAX_OPTIONS = 3;
+export async function runPhase4Pilot(state) {
+    const mapper = state.outputs["3-mapper"];
+    if (mapper === undefined) {
+        return {
+            status: "error",
+            error: {
+                code: "missing-prereqs",
+                message: "Phase 4 needs phase 3-mapper output",
+            },
+            state,
+        };
+    }
+    // Operator already picked → consume + advance.
+    if (state.answer !== undefined && state.answer.length > 0) {
+        const next = {
+            ...state,
+            outputs: { ...state.outputs, "4-pilot": { picked: state.answer } },
+            answer: undefined,
+        };
+        return {
+            status: "complete",
+            nextPhase: "5-brand",
+            state: advancePhase(next),
+        };
+    }
+    const out = mapper.output;
+    const candidates = [];
+    // Pilot first.
+    if (out.pilot_module.length > 0) {
+        candidates.push({
+            id: out.pilot_module,
+            label: out.pilot_module,
+            detail: "Mapper's first pick",
+        });
+    }
+    // Top 2 key_modules other than pilot.
+    for (const km of out.key_modules) {
+        if (candidates.length >= MAX_OPTIONS)
+            break;
+        if (km.path === out.pilot_module)
+            continue;
+        candidates.push({
+            id: km.path,
+            label: km.path,
+            detail: km.purpose,
+        });
+    }
+    // Fallback if mapper produced nothing.
+    if (candidates.length === 0) {
+        candidates.push({ id: "ALL", label: "ALL", detail: "Whole repo as the pilot scope" });
+    }
+    const question = {
+        id: "4-pilot",
+        prompt: "Which module should Cairn seed first?",
+        options: candidates,
+        default: candidates[0].id,
+    };
+    return { status: "needs_input", question, state };
+}
+//# sourceMappingURL=4-pilot.js.map

package/dist/init/phases/4-pilot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"4-pilot.js","sourceRoot":"","sources":["../../../src/init/phases/4-pilot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjD,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAiB;IACpD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAA6B,CAAC;IACrE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO;YACL,MAAM,EAAE,OAAO;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,qCAAqC;aAC/C;YACD,KAAK;SACN,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAe;YACvB,GAAG,KAAK;YACR,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE;YAClE,MAAM,EAAE,SAAS;SAClB,CAAC;QACF,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1B,MAAM,UAAU,GAAkB,EAAE,CAAC;IACrC,eAAe;IACf,IAAI,GAAG,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,UAAU,CAAC,IAAI,CAAC;YACd,EAAE,EAAE,GAAG,CAAC,YAAY;YACpB,KAAK,EAAE,GAAG,CAAC,YAAY;YACvB,MAAM,EAAE,qBAAqB;SAC9B,CAAC,CAAC;IACL,CAAC;IACD,sCAAsC;IACtC,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACjC,IAAI,UAAU,CAAC,MAAM,IAAI,WAAW;YAAE,MAAM;QAC5C,IAAI,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,YAAY;YAAE,SAAS;QAC3C,UAAU,CAAC,IAAI,CAAC;YACd,EAAE,EAAE,EAAE,CAAC,IAAI;YACX,KAAK,EAAE,EAAE,CAAC,IAAI;YACd,MAAM,EAAE,EAAE,CAAC,OAAO;SACnB,CAAC,CAAC;IACL,CAAC;IACD,uCAAuC;IACvC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,QAAQ,GAAkB;QAC9B,EAAE,EAAE,SAAS;QACb,MAAM,EAAE,uCAAuC;QAC/C,OAAO,EAAE,UAAU;QACnB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAE,CAAC,EAAE;KAC3B,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACpD,CAAC"}

package/dist/init/phases/5-brand.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Phase 5-brand — adopt brand DEC drafts inline.
+ *
+ * Emits ONE A/B/C choice. `auto-fill` substitutes positioning + voice
+ * from the mapper's domain summary; `skip` leaves status: draft for
+ * later editing; `manual` hands off to the operator (drafts stay
+ * draft, summary surfaces the file paths to edit).
+ */
+import type { PhaseResult, PhaseState } from "./types.js";
+export declare function runPhase5Brand(state: PhaseState): Promise<PhaseResult>;

package/dist/init/phases/5-brand.js

@@ -0,0 +1,66 @@
+/**
+ * Phase 5-brand — adopt brand DEC drafts inline.
+ *
+ * Emits ONE A/B/C choice. `auto-fill` substitutes positioning + voice
+ * from the mapper's domain summary; `skip` leaves status: draft for
+ * later editing; `manual` hands off to the operator (drafts stay
+ * draft, summary surfaces the file paths to edit).
+ */
+import { applyBrandAnswers } from "../brand-setup.js";
+import { advancePhase } from "./orchestrator.js";
+export async function runPhase5Brand(state) {
+    // Pending operator answer → execute the chosen path.
+    if (state.answer !== undefined && state.answer.length > 0) {
+        const choice = state.answer;
+        let result = null;
+        if (choice === "auto-fill") {
+            const mapper = state.outputs["3-mapper"];
+            if (mapper !== undefined) {
+                const answers = {
+                    whatItDoes: mapper.output.domain_summary,
+                    mainUsers: "",
+                    voice: "",
+                    avoid: "",
+                };
+                result = applyBrandAnswers(state.repoRoot, answers);
+            }
+        }
+        const next = {
+            ...state,
+            outputs: {
+                ...state.outputs,
+                "5-brand": { choice, applied: result },
+            },
+            answer: undefined,
+        };
+        return {
+            status: "complete",
+            nextPhase: "6-docs-ingest",
+            state: advancePhase(next),
+        };
+    }
+    const question = {
+        id: "5-brand",
+        prompt: "Brand DEC drafts — how should Cairn populate them?",
+        options: [
+            {
+                id: "skip",
+                label: "skip — keep drafts blank",
+                detail: ".cairn/ground/brand/* stays status: draft",
+            },
+            {
+                id: "auto-fill",
+                label: "auto-fill from mapper summary",
+                detail: "positioning.md gets the mapper's summary, status flips to current",
+            },
+            {
+                id: "manual",
+                label: "manual — edit drafts first",
+                detail: "Drafts stay status: draft; you can populate them later",
+            },
+        ],
+        default: "skip",
+    };
+    return { status: "needs_input", question, state };
+}
+//# sourceMappingURL=5-brand.js.map

package/dist/init/phases/5-brand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"5-brand.js","sourceRoot":"","sources":["../../../src/init/phases/5-brand.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAqB,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAQjD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAiB;IACpD,qDAAqD;IACrD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,MAAM,GAAqD,IAAI,CAAC;QACpE,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAA6B,CAAC;YACrE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAiB;oBAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc;oBACxC,SAAS,EAAE,EAAE;oBACb,KAAK,EAAE,EAAE;oBACT,KAAK,EAAE,EAAE;iBACV,CAAC;gBACF,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAe;YACvB,GAAG,KAAK;YACR,OAAO,EAAE;gBACP,GAAG,KAAK,CAAC,OAAO;gBAChB,SAAS,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;aACvC;YACD,MAAM,EAAE,SAAS;SAClB,CAAC;QACF,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,eAAe;YAC1B,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAkB;QAC9B,EAAE,EAAE,SAAS;QACb,MAAM,EAAE,oDAAoD;QAC5D,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,0BAA0B;gBACjC,MAAM,EAAE,2CAA2C;aACpD;YACD;gBACE,EAAE,EAAE,WAAW;gBACf,KAAK,EAAE,+BAA+B;gBACtC,MAAM,EAAE,mEAAmE;aAC5E;YACD;gBACE,EAAE,EAAE,QAAQ;gBACZ,KAAK,EAAE,4BAA4B;gBACnC,MAAM,EAAE,wDAAwD;aACjE;SACF;QACD,OAAO,EAAE,MAAM;KAChB,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACpD,CAAC"}

package/dist/init/phases/6-docs-ingest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Phase 6-docs-ingest — Haiku batch over README + docs/ → DEC drafts
+ * + canonical-map topics + voice rewrites.
+ *
+ * Wraps `runDocsIngestion`; no operator input. The skill driver
+ * surfaces the resulting `decDraftsWritten` count in the post-init
+ * summary so the operator knows how much pending attention they
+ * have.
+ */
+import type { PhaseResult, PhaseState } from "./types.js";
+export declare function runPhase6DocsIngest(state: PhaseState): Promise<PhaseResult>;

package/dist/init/phases/6-docs-ingest.js

@@ -0,0 +1,39 @@
+/**
+ * Phase 6-docs-ingest — Haiku batch over README + docs/ → DEC drafts
+ * + canonical-map topics + voice rewrites.
+ *
+ * Wraps `runDocsIngestion`; no operator input. The skill driver
+ * surfaces the resulting `decDraftsWritten` count in the post-init
+ * summary so the operator knows how much pending attention they
+ * have.
+ */
+import { runDocsIngestion } from "../ingest-docs.js";
+import { advancePhase } from "./orchestrator.js";
+export async function runPhase6DocsIngest(state) {
+    try {
+        const result = await runDocsIngestion({
+            repoRoot: state.repoRoot,
+        });
+        const next = {
+            ...state,
+            outputs: { ...state.outputs, "6-docs-ingest": result },
+        };
+        return {
+            status: "complete",
+            nextPhase: "7b-source-comments",
+            state: advancePhase(next),
+        };
+    }
+    catch (err) {
+        return {
+            status: "error",
+            error: {
+                code: "docs-ingest-failed",
+                message: "Docs ingestion pipeline failed",
+                detail: err instanceof Error ? err.stack ?? err.message : String(err),
+            },
+            state,
+        };
+    }
+}
+//# sourceMappingURL=6-docs-ingest.js.map

package/dist/init/phases/6-docs-ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"6-docs-ingest.js","sourceRoot":"","sources":["../../../src/init/phases/6-docs-ingest.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAwB,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAiB;IACzD,IAAI,CAAC;QACH,MAAM,MAAM,GAAoB,MAAM,gBAAgB,CAAC;YACrD,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QACH,MAAM,IAAI,GAAe;YACvB,GAAG,KAAK;YACR,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE;SACvD,CAAC;QACF,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,oBAAoB;YAC/B,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC;SAC1B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,MAAM,EAAE,OAAO;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,gCAAgC;gBACzC,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACtE;YACD,KAAK;SACN,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/init/phases/7b-source-comments.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Phase 7b-source-comments — walk every source file's docblock-class
+ * comment, classify via Haiku, write DEC drafts / invariant proposals.
+ */
+import type { PhaseResult, PhaseState } from "./types.js";
+export declare function runPhase7bSourceComments(state: PhaseState): Promise<PhaseResult>;

package/dist/init/phases/7b-source-comments.js

@@ -0,0 +1,34 @@
+/**
+ * Phase 7b-source-comments — walk every source file's docblock-class
+ * comment, classify via Haiku, write DEC drafts / invariant proposals.
+ */
+import { runSourceCommentsIngestion, } from "../source-comments/index.js";
+import { advancePhase } from "./orchestrator.js";
+export async function runPhase7bSourceComments(state) {
+    try {
+        const result = await runSourceCommentsIngestion({
+            repoRoot: state.repoRoot,
+        });
+        const next = {
+            ...state,
+            outputs: { ...state.outputs, "7b-source-comments": result },
+        };
+        return {
+            status: "complete",
+            nextPhase: "7c-rules-merge",
+            state: advancePhase(next),
+        };
+    }
+    catch (err) {
+        return {
+            status: "error",
+            error: {
+                code: "source-comments-failed",
+                message: "Source-comment ingestion failed",
+                detail: err instanceof Error ? err.stack ?? err.message : String(err),
+            },
+            state,
+        };
+    }
+}
+//# sourceMappingURL=7b-source-comments.js.map

package/dist/init/phases/7b-source-comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"7b-source-comments.js","sourceRoot":"","sources":["../../../src/init/phases/7b-source-comments.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,0BAA0B,GAE3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,KAAiB;IAC9D,IAAI,CAAC;QACH,MAAM,MAAM,GAA+B,MAAM,0BAA0B,CAAC;YAC1E,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QACH,MAAM,IAAI,GAAe;YACvB,GAAG,KAAK;YACR,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE;SAC5D,CAAC;QACF,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,gBAAgB;YAC3B,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC;SAC1B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,MAAM,EAAE,OAAO;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,wBAAwB;gBAC9B,OAAO,EAAE,iCAAiC;gBAC1C,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACtE;YACD,KAAK;SACN,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/init/phases/7c-rules-merge.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Phase 7c-rules-merge — walk CLAUDE.md / AGENTS.md / .claude/rules/*
+ * sections, classify via Haiku, propose net-new rules + flag conflicts.
+ */
+import type { PhaseResult, PhaseState } from "./types.js";
+export declare function runPhase7cRulesMerge(state: PhaseState): Promise<PhaseResult>;

package/dist/init/phases/7c-rules-merge.js

@@ -0,0 +1,34 @@
+/**
+ * Phase 7c-rules-merge — walk CLAUDE.md / AGENTS.md / .claude/rules/*
+ * sections, classify via Haiku, propose net-new rules + flag conflicts.
+ */
+import { runRulesMerge, } from "../rules-merge/index.js";
+import { advancePhase } from "./orchestrator.js";
+export async function runPhase7cRulesMerge(state) {
+    try {
+        const result = await runRulesMerge({
+            repoRoot: state.repoRoot,
+        });
+        const next = {
+            ...state,
+            outputs: { ...state.outputs, "7c-rules-merge": result },
+        };
+        return {
+            status: "complete",
+            nextPhase: "8-baseline",
+            state: advancePhase(next),
+        };
+    }
+    catch (err) {
+        return {
+            status: "error",
+            error: {
+                code: "rules-merge-failed",
+                message: "Rules merge failed",
+                detail: err instanceof Error ? err.stack ?? err.message : String(err),
+            },
+            state,
+        };
+    }
+}
+//# sourceMappingURL=7c-rules-merge.js.map

package/dist/init/phases/7c-rules-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"7c-rules-merge.js","sourceRoot":"","sources":["../../../src/init/phases/7c-rules-merge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,aAAa,GAEd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAiB;IAC1D,IAAI,CAAC;QACH,MAAM,MAAM,GAAwB,MAAM,aAAa,CAAC;YACtD,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QACH,MAAM,IAAI,GAAe;YACvB,GAAG,KAAK;YACR,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE;SACxD,CAAC;QACF,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,YAAY;YACvB,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC;SAC1B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,MAAM,EAAE,OAAO;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,oBAAoB;gBAC7B,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACtE;YACD,KAAK;SACN,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/init/phases/8-baseline.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Phase 8-baseline — first sensor sweep against the synthetic
+ * full-tree diff. Stamps the audit row counts under outputs so the
+ * skill driver can summarize "N findings across M sensors".
+ *
+ * Reads the mapper's globs (route handlers, DTOs, etc.) from phase 3
+ * if available. Falls back to baseline-audit's defaults otherwise.
+ */
+import type { PhaseResult, PhaseState } from "./types.js";
+export declare function runPhase8Baseline(state: PhaseState): Promise<PhaseResult>;

package/dist/init/phases/8-baseline.js

@@ -0,0 +1,52 @@
+/**
+ * Phase 8-baseline — first sensor sweep against the synthetic
+ * full-tree diff. Stamps the audit row counts under outputs so the
+ * skill driver can summarize "N findings across M sensors".
+ *
+ * Reads the mapper's globs (route handlers, DTOs, etc.) from phase 3
+ * if available. Falls back to baseline-audit's defaults otherwise.
+ */
+import { defaultBaselineLanguages, runBaselineAudit, } from "../baseline-audit.js";
+import { advancePhase } from "./orchestrator.js";
+export async function runPhase8Baseline(state) {
+    const detection = state.outputs["1-detect"];
+    const mapper = state.outputs["3-mapper"];
+    const globs = mapper
+        ? {
+            route_handler_globs: mapper.output.route_handler_globs,
+            dto_globs: mapper.output.dto_globs,
+            generator_source_globs: mapper.output.generator_source_globs,
+            high_stakes_globs: mapper.output.high_stakes_globs,
+            off_limits: mapper.output.off_limits_globs,
+        }
+        : {};
+    const languages = defaultBaselineLanguages((detection?.stack_signatures ?? []).map((s) => s.kind));
+    try {
+        const result = await runBaselineAudit({
+            repoRoot: state.repoRoot,
+            projectGlobs: globs,
+            languages,
+        });
+        const next = {
+            ...state,
+            outputs: { ...state.outputs, "8-baseline": result },
+        };
+        return {
+            status: "complete",
+            nextPhase: "10-strip",
+            state: advancePhase(next),
+        };
+    }
+    catch (err) {
+        return {
+            status: "error",
+            error: {
+                code: "baseline-failed",
+                message: "Baseline sensor sweep failed",
+                detail: err instanceof Error ? err.stack ?? err.message : String(err),
+            },
+            state,
+        };
+    }
+}
+//# sourceMappingURL=8-baseline.js.map

package/dist/init/phases/8-baseline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"8-baseline.js","sourceRoot":"","sources":["../../../src/init/phases/8-baseline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,wBAAwB,EACxB,gBAAgB,GAEjB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAiB;IACvD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAgC,CAAC;IAC3E,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAA6B,CAAC;IACrE,MAAM,KAAK,GAAiB,MAAM;QAChC,CAAC,CAAC;YACE,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,mBAAmB;YACtD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS;YAClC,sBAAsB,EAAE,MAAM,CAAC,MAAM,CAAC,sBAAsB;YAC5D,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB;YAClD,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB;SAC3C;QACH,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,SAAS,GAAG,wBAAwB,CACxC,CAAC,SAAS,EAAE,gBAAgB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC,CACjE,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAwB,MAAM,gBAAgB,CAAC;YACzD,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,YAAY,EAAE,KAAK;YACnB,SAAS;SACV,CAAC,CAAC;QACH,MAAM,IAAI,GAAe;YACvB,GAAG,KAAK;YACR,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE;SACpD,CAAC;QACF,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,UAAU;YACrB,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC;SAC1B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,MAAM,EAAE,OAAO;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,8BAA8B;gBACvC,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACtE;YACD,KAAK;SACN,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/init/phases/index.d.ts

@@ -0,0 +1,15 @@
+export { PHASE_IDS, type PhaseId, type PhaseState, type PhaseOutputs, type PhaseResult, type PhaseQuestion, type PhaseOption, type PhaseError, type ResumeReport, } from "./types.js";
+export { INIT_STATE_PATH, phaseStateAbsPath, readPhaseState, writePhaseState, clearPhaseState, } from "./state-io.js";
+export { freshPhaseState, resumePhases, nextPhaseAfter, advancePhase, } from "./orchestrator.js";
+export { runPhase1Detect } from "./1-detect.js";
+export { runPhase2Walker } from "./2-walker.js";
+export { runPhase3Mapper } from "./3-mapper.js";
+export { runPhase3bSeed } from "./3b-seed.js";
+export { runPhase4Pilot } from "./4-pilot.js";
+export { runPhase5Brand } from "./5-brand.js";
+export { runPhase6DocsIngest } from "./6-docs-ingest.js";
+export { runPhase7bSourceComments } from "./7b-source-comments.js";
+export { runPhase7cRulesMerge } from "./7c-rules-merge.js";
+export { runPhase8Baseline } from "./8-baseline.js";
+export { runPhase10Strip } from "./10-strip.js";
+export { runPhase12Multidev } from "./12-multidev.js";

package/dist/init/phases/index.js

@@ -0,0 +1,16 @@
+export { PHASE_IDS, } from "./types.js";
+export { INIT_STATE_PATH, phaseStateAbsPath, readPhaseState, writePhaseState, clearPhaseState, } from "./state-io.js";
+export { freshPhaseState, resumePhases, nextPhaseAfter, advancePhase, } from "./orchestrator.js";
+export { runPhase1Detect } from "./1-detect.js";
+export { runPhase2Walker } from "./2-walker.js";
+export { runPhase3Mapper } from "./3-mapper.js";
+export { runPhase3bSeed } from "./3b-seed.js";
+export { runPhase4Pilot } from "./4-pilot.js";
+export { runPhase5Brand } from "./5-brand.js";
+export { runPhase6DocsIngest } from "./6-docs-ingest.js";
+export { runPhase7bSourceComments } from "./7b-source-comments.js";
+export { runPhase7cRulesMerge } from "./7c-rules-merge.js";
+export { runPhase8Baseline } from "./8-baseline.js";
+export { runPhase10Strip } from "./10-strip.js";
+export { runPhase12Multidev } from "./12-multidev.js";
+//# sourceMappingURL=index.js.map

package/dist/init/phases/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/init/phases/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,GASV,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/init/phases/orchestrator.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Orchestrator entry points for the MCP-native init pipeline.
+ *
+ * `resumePhases(repoRoot)` is the single readable surface for the
+ * cairn-adopt skill — it reads any persisted state, returns the next
+ * phase id, and (for fresh starts) constructs the initial PhaseState.
+ *
+ * Phase functions live in sibling files (one per id, see types.ts
+ * PHASE_IDS). The orchestrator does not invoke them directly; the
+ * skill driver calls each phase's MCP tool with the state returned
+ * from `resumePhases` and threads results forward.
+ */
+import { type PhaseId, type PhaseState, type ResumeReport } from "./types.js";
+/**
+ * Construct the fresh state for a brand-new init run. No filesystem
+ * IO — the caller persists this via `writePhaseState` once phase
+ * 1-detect has created `.cairn/`.
+ */
+export declare function freshPhaseState(repoRoot: string): PhaseState;
+/**
+ * Read whatever init state is on disk for `repoRoot` and return the
+ * next phase the skill driver should invoke. If no state exists, the
+ * first phase becomes "ready".
+ *
+ * The persisted `state.currentPhase` IS the next phase to run:
+ *   - On "complete", the phase function calls `advancePhase` to
+ *     increment `currentPhase` to the successor before persisting.
+ *   - On "needs_input", `currentPhase` stays put — the operator's
+ *     answer feeds back into the same phase.
+ *
+ * The init-phases MCP tool clears the state file as soon as the final
+ * phase returns nextPhase=null, so a "done" report only fires when
+ * cleanup itself failed. We model that as "ready" pointing at the last
+ * phase id; the skill re-invokes (idempotent) and then clearPhaseState
+ * runs again.
+ */
+export declare function resumePhases(repoRoot: string): ResumeReport;
+/**
+ * Compute the phase id that follows `current` in PHASE_IDS, or null
+ * when `current` is already the last id. Pure function — useful from
+ * inside individual phase functions when stamping their PhaseResult.
+ */
+export declare function nextPhaseAfter(current: PhaseId): PhaseId | null;
+/**
+ * Advance `state.currentPhase` to the next phase id. Returns a new
+ * state; does not mutate the input. Used by phase functions when
+ * stamping a "complete" result that hands off to the next phase.
+ */
+export declare function advancePhase(state: PhaseState): PhaseState;