@isaacriehm/cairn-core 0.25.0 → 0.31.0

package/dist/mcp/tools/resync.js

@@ -0,0 +1,109 @@
+/**
+ * `cairn_resync` — operator-initiated re-discovery that resolves config drift.
+ *
+ * The config-drift sensor (24h GC) surfaces the gap between declared config and
+ * the grown tree as `baseline_finding` nudges; this tool is the verb that turns
+ * them into concrete `config.yaml` edits. It writes COMMITTED config, so it is
+ * review-class: preview first (default), summarize the proposed edits, get the
+ * operator's OK, then call again with `apply: true`. Apply archives the
+ * pre-resync config to `.cairn/ground/.archive/` and is idempotent.
+ */
+import { cairnDir } from "@isaacriehm/cairn-state";
+import { runResync, runResyncRecluster } from "../../resync/index.js";
+import { runCuratorEmit, runCuratorWalker } from "../../init/index.js";
+import { requireBootstrap } from "../bootstrap-guard.js";
+import { resyncInput } from "../schemas.js";
+const RECURATE_CAPTURE_SOURCE = "resync-curator";
+export const resyncTool = {
+    name: "cairn_resync",
+    description: "Resolve surfaced config drift (the config-drift baseline findings) by proposing concrete .cairn/config.yaml edits: add a grown dir to componentDirs, add a new file type to extensions, add an ignored path to off_limits, or drop a dead componentDir. Default previews the edits (mutates nothing) — summarize them and get the operator's OK, then call with apply:true. Apply archives the pre-resync config to .cairn/ground/.archive/ and is idempotent. Pass `area` to scope to one subtree. Pass recluster:true to instead run the LLM re-cluster pass (re-walk prose, Haiku-judge new semantic collisions, rebuild topic-index + anchor-map) — opt-in, spends Haiku on new prose only; preview first, then apply:true to overwrite the (archived) maps. Pass recurate:'walk' (with `area`) to build the curator corpus for re-curation, then — after the cairn-resync skill dispatches curator-map/reduce subagents — recurate:'emit' to write the resulting DEC/INV drafts to _inbox/ (drained via cairn-attention). recurate is skill-driven; don't call it directly.",
+    inputSchema: resyncInput,
+    handler: async (ctx, input) => {
+        const block = requireBootstrap(ctx.repoRoot);
+        if (block !== null)
+            return block;
+        const apply = input.apply === true;
+        if (input.recurate === "walk") {
+            const w = await runCuratorWalker({
+                repoRoot: ctx.repoRoot,
+                ...(input.area !== undefined ? { area: input.area } : {}),
+            });
+            return {
+                ok: true,
+                mode: "recurate-walk",
+                area: input.area ?? null,
+                curator_dir: cairnDir(ctx.repoRoot, "init", "curator"),
+                shards_path: w.shards_path,
+                corpus_path: w.corpus_path,
+                records_total: w.records_total,
+                records_by_kind: w.records_by_kind,
+                shards: w.shards,
+                note: w.shards === 0
+                    ? "no curatable prose in this area — nothing to dispatch; skip emit"
+                    : "dispatch curator-map (rounds of 4) + curator-reduce over the shard plan, then call again with recurate:'emit'",
+            };
+        }
+        if (input.recurate === "emit") {
+            const e = await runCuratorEmit({
+                repoRoot: ctx.repoRoot,
+                draft: true,
+                captureSource: RECURATE_CAPTURE_SOURCE,
+            });
+            return {
+                ok: true,
+                mode: "recurate-emit",
+                dec_drafts: e.decsWritten.map((d) => ({ id: d.id, path: d.path, title: d.title })),
+                inv_drafts: e.invsWritten.map((d) => ({ id: d.id, path: d.path, title: d.title })),
+                dropped: e.dropped,
+                drop_reasons: e.dropReasons,
+                note: "DEC/INV drafts written to _inbox/ — drain via cairn-attention (accept graduates; reject archives)",
+            };
+        }
+        if (input.recluster === true) {
+            const r = await runResyncRecluster({ repoRoot: ctx.repoRoot, dryRun: !apply });
+            return {
+                ok: true,
+                mode: "recluster",
+                dry_run: r.dryRun,
+                applied: r.applied,
+                topics_before: r.topicsBefore,
+                topics_after: r.topicsAfter,
+                block_count: r.blockCount,
+                judge_calls: r.judgeCalls,
+                judge_calls_fresh: r.judgeFresh,
+                judge_calls_cached: r.judgeCached,
+                judge_calls_errors: r.judgeErrors,
+                archived_maps: r.archivedMaps,
+                note: r.dryRun
+                    ? "preview only — re-walked + judged but wrote no map; call again with apply:true (and recluster:true) to overwrite the archived maps"
+                    : undefined,
+            };
+        }
+        const result = runResync({
+            repoRoot: ctx.repoRoot,
+            dryRun: !apply,
+            ...(input.area !== undefined ? { area: input.area } : {}),
+        });
+        return {
+            ok: true,
+            dry_run: result.dryRun,
+            applied: result.applied,
+            proposals: result.proposals.map((p) => ({
+                kind: p.kind,
+                workspace: p.workspace,
+                value: p.value,
+                from: p.from,
+                detail: p.detail,
+            })),
+            skipped: result.skipped,
+            archived_config: result.archivedConfig,
+            archived_entities: result.archivedEntities,
+            note: result.proposals.length === 0
+                ? "no config drift to resolve — config is in sync with the tree"
+                : result.dryRun
+                    ? "preview only — call again with apply:true to write these edits"
+                    : undefined,
+        };
+    },
+};
+//# sourceMappingURL=resync.js.map

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

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

package/dist/migrate/config-io.d.ts

@@ -18,6 +18,16 @@ export declare function loadConfigDoc(repoRoot: string): Document | null;
 export declare function readConfigPin(repoRoot: string, doc?: Document | null): string | null;
 /** Set the `cairn_version` pin. No-op (returns false) when already equal. */
 export declare function writeConfigPin(repoRoot: string, version: string): boolean;
+/**
+ * Write a mutated config `Document` back to disk. The migration system was
+ * built for top-level key edits (drop a dead key, set the pin); content
+ * migrations that need to repair a NESTED structure (e.g. collapse a
+ * workspace's `componentDirs`) mutate the `Document` via `loadConfigDoc` +
+ * `doc.getIn` / `doc.setIn` and persist with this. Whole-file rewrite under
+ * the caller's migrate lock; key order + comments are preserved by the yaml
+ * Document API. Returns false when the config is absent.
+ */
+export declare function writeConfigDoc(repoRoot: string, doc: Document): boolean;
 /** Which of `keys` are present as top-level config keys. */
 export declare function configHasKeys(repoRoot: string, keys: readonly string[], doc?: Document | null): string[];
 /** Delete top-level `keys`; returns the keys actually removed. */

package/dist/migrate/config-io.js

@@ -46,6 +46,22 @@ export function writeConfigPin(repoRoot, version) {
     writeFileSync(p, doc.toString(), "utf8");
     return true;
 }
+/**
+ * Write a mutated config `Document` back to disk. The migration system was
+ * built for top-level key edits (drop a dead key, set the pin); content
+ * migrations that need to repair a NESTED structure (e.g. collapse a
+ * workspace's `componentDirs`) mutate the `Document` via `loadConfigDoc` +
+ * `doc.getIn` / `doc.setIn` and persist with this. Whole-file rewrite under
+ * the caller's migrate lock; key order + comments are preserved by the yaml
+ * Document API. Returns false when the config is absent.
+ */
+export function writeConfigDoc(repoRoot, doc) {
+    const p = configPath(repoRoot);
+    if (!existsSync(p))
+        return false;
+    writeFileSync(p, doc.toString(), "utf8");
+    return true;
+}
 /** Which of `keys` are present as top-level config keys. */
 export function configHasKeys(repoRoot, keys, doc) {
     const d = doc !== undefined ? doc : loadConfigDoc(repoRoot);

package/dist/migrate/config-io.js.map

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

package/dist/migrate/migrations/0005-demote-autofilled-brand.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 0005 — demote auto-filled brand drafts back to `status: draft`.
+ *
+ * Before 0.25.0, the adoption brand step DEFAULTED to auto-fill and, on
+ * apply, flipped each written file `draft → current`. SessionStart then
+ * injected every `current` brand file as authoritative voice — so a
+ * generic, machine-written first draft (or the mechanical fallback when
+ * the Haiku derive timed out) burned context every session as if the
+ * operator had confirmed it.
+ *
+ * 0.25.0 fixed this going forward (auto-fill writes `draft`; SessionStart
+ * injects only confirmed brand). This migration repairs EXISTING repos:
+ * it finds brand/product docs that are provably auto-generated yet marked
+ * `current`/`accepted`, and demotes them to `draft` so they stop being
+ * injected. Operator-written brand is left alone; a demoted file is one
+ * frontmatter edit (or a re-run of brand setup) away from `current` again.
+ *
+ * The 0.26.0 detection only caught the mechanical fallback (fixed marker
+ * strings) and the byte-identical overview/positioning pair — it missed
+ * Haiku-derived auto-fill (voice.md / personas.yaml), which is worded
+ * freshly each run. 0.27.0 adds a co-generation cohort channel: once the
+ * overview≡positioning identity proves the pass auto-filled brand, every
+ * confirmed doc stamped with the same `generated` timestamp is demoted too.
+ *
+ * `review`-class: it rewrites committed ground state, so it surfaces for
+ * the operator and applies via `cairn migrate` — never silently.
+ *
+ * The cohort channel ships in 0.27.0, so `introducedIn` advances to 0.27.0:
+ * a repo that already ran the 0.26.0 pass (demoting only the pair) must
+ * re-evaluate to catch the co-generated siblings. `detect()` carries
+ * correctness.
+ */
+import type { Migration } from "../types.js";
+export declare const demoteAutofilledBrand: Migration;

package/dist/migrate/migrations/0005-demote-autofilled-brand.js

@@ -0,0 +1,199 @@
+/**
+ * 0005 — demote auto-filled brand drafts back to `status: draft`.
+ *
+ * Before 0.25.0, the adoption brand step DEFAULTED to auto-fill and, on
+ * apply, flipped each written file `draft → current`. SessionStart then
+ * injected every `current` brand file as authoritative voice — so a
+ * generic, machine-written first draft (or the mechanical fallback when
+ * the Haiku derive timed out) burned context every session as if the
+ * operator had confirmed it.
+ *
+ * 0.25.0 fixed this going forward (auto-fill writes `draft`; SessionStart
+ * injects only confirmed brand). This migration repairs EXISTING repos:
+ * it finds brand/product docs that are provably auto-generated yet marked
+ * `current`/`accepted`, and demotes them to `draft` so they stop being
+ * injected. Operator-written brand is left alone; a demoted file is one
+ * frontmatter edit (or a re-run of brand setup) away from `current` again.
+ *
+ * The 0.26.0 detection only caught the mechanical fallback (fixed marker
+ * strings) and the byte-identical overview/positioning pair — it missed
+ * Haiku-derived auto-fill (voice.md / personas.yaml), which is worded
+ * freshly each run. 0.27.0 adds a co-generation cohort channel: once the
+ * overview≡positioning identity proves the pass auto-filled brand, every
+ * confirmed doc stamped with the same `generated` timestamp is demoted too.
+ *
+ * `review`-class: it rewrites committed ground state, so it surfaces for
+ * the operator and applies via `cairn migrate` — never silently.
+ *
+ * The cohort channel ships in 0.27.0, so `introducedIn` advances to 0.27.0:
+ * a repo that already ran the 0.26.0 pass (demoting only the pair) must
+ * re-evaluate to catch the co-generated siblings. `detect()` carries
+ * correctness.
+ */
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { cairnDir, parseFrontmatter } from "@isaacriehm/cairn-state";
+/** Distinctive substrings only the pre-0.25.0 mechanical fallback emits. */
+const VOICE_MARKER = "Match the existing tone in CLAUDE.md / AGENTS.md if those files set a register";
+const AVOID_MARKER = 'Marketing fluff ("world-class", "revolutionary", "game-changing")';
+const PERSONAS_MARKER = "Refine when adding consumer-facing or external personas";
+function brandDocs(repoRoot) {
+    return [
+        { rel: "brand/overview.md", abs: cairnDir(repoRoot, "ground", "brand", "overview.md") },
+        { rel: "brand/voice.md", abs: cairnDir(repoRoot, "ground", "brand", "voice.md") },
+        { rel: "product/positioning.md", abs: cairnDir(repoRoot, "ground", "product", "positioning.md") },
+        { rel: "product/personas.yaml", abs: cairnDir(repoRoot, "ground", "product", "personas.yaml") },
+    ];
+}
+function readDoc(abs) {
+    if (!existsSync(abs))
+        return null;
+    let raw;
+    try {
+        raw = readFileSync(abs, "utf8");
+    }
+    catch {
+        return null;
+    }
+    // personas.yaml is pure YAML (status as a top-level key, no `---` fence);
+    // the brand .md files use frontmatter. parseFrontmatter handles the .md;
+    // for the .yaml fall back to a status-line scan over the whole text.
+    const parsed = parseFrontmatter(raw);
+    const fm = (parsed.frontmatter ?? {});
+    let status = typeof fm["status"] === "string" ? fm["status"] : null;
+    if (status === null) {
+        const m = raw.match(/^status:\s*(\S+)\s*$/m);
+        status = m?.[1] ?? null;
+    }
+    let generated = typeof fm["generated"] === "string" ? fm["generated"] : null;
+    if (generated === null) {
+        const g = raw.match(/^generated:\s*(\S+)\s*$/m);
+        generated = g?.[1] ?? null;
+    }
+    return { status, generated, body: parsed.body, raw };
+}
+const CONFIRMED = new Set(["current", "accepted"]);
+/** Strip headings + collapse whitespace, matching SessionStart's dedup. */
+function normalize(s) {
+    return s
+        .replace(/^\s*#{1,6}\s+.*$/gm, "")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/**
+ * Repo-relative labels of confirmed brand docs that are provably the
+ * pre-0.25.0 auto-fill output. Two evidence channels:
+ *
+ *   1. Per-doc markers — voice.md / personas.yaml carrying a mechanical
+ *      fallback's distinctive string. Precise but narrow: it ONLY catches
+ *      the timeout fallback, never the Haiku-derived auto-fill (which is
+ *      worded freshly each run and so carries no fixed marker).
+ *
+ *   2. Co-generation cohort — overview.md and positioning.md with
+ *      byte-identical bodies is near-certain auto-fill proof (a hand-author
+ *      doesn't write the exact same domain summary into two files). When
+ *      that fires, every confirmed brand doc stamped with the SAME
+ *      `generated` timestamp came out of the same automated pass and is
+ *      demoted too. This is what catches a Haiku-derived voice.md the
+ *      marker channel misses. The identity check is status-independent —
+ *      an earlier run may have already demoted the pair to draft, yet its
+ *      still-confirmed siblings must follow.
+ *
+ * A demoted file is one frontmatter edit from `current` again, so the
+ * asymmetry favors demoting: a false demote costs one keystroke, a false
+ * keep burns context every session as machine-written "authoritative" voice.
+ */
+function autofilledConfirmed(repoRoot) {
+    const docs = brandDocs(repoRoot);
+    const byRel = new Map();
+    for (const d of docs)
+        byRel.set(d.rel, readDoc(d.abs));
+    const hits = new Set();
+    const get = (rel) => byRel.get(rel) ?? null;
+    const confirmed = (rel) => {
+        const p = get(rel);
+        return p !== null && p.status !== null && CONFIRMED.has(p.status) ? p : null;
+    };
+    // Channel 1 — per-doc mechanical-fallback markers.
+    const voice = confirmed("brand/voice.md");
+    if (voice && (voice.body.includes(VOICE_MARKER) || voice.body.includes(AVOID_MARKER))) {
+        hits.add("brand/voice.md");
+    }
+    const personas = confirmed("product/personas.yaml");
+    if (personas && personas.raw.includes(PERSONAS_MARKER)) {
+        hits.add("product/personas.yaml");
+    }
+    // Channel 2 — co-generation cohort, proven by the overview≡positioning
+    // identity (checked regardless of either doc's current status).
+    const overviewAny = get("brand/overview.md");
+    const positioningAny = get("product/positioning.md");
+    const pairAutofilled = overviewAny !== null &&
+        positioningAny !== null &&
+        normalize(overviewAny.body).length > 0 &&
+        normalize(overviewAny.body) === normalize(positioningAny.body);
+    if (pairAutofilled) {
+        // Cohort timestamp — the pass stamps every co-generated doc identically.
+        const cohortGen = overviewAny.generated ?? positioningAny.generated;
+        // overview/positioning are themselves cohort members; demote if still confirmed.
+        if (confirmed("brand/overview.md"))
+            hits.add("brand/overview.md");
+        if (confirmed("product/positioning.md"))
+            hits.add("product/positioning.md");
+        // A confirmed voice.md sharing the cohort timestamp is the same pass's
+        // output — the timestamp guard spares a voice the operator hand-wrote later.
+        if (voice && cohortGen !== null && voice.generated === cohortGen) {
+            hits.add("brand/voice.md");
+        }
+        // personas.yaml carries no `generated`; it's the lowest-value, most
+        // placeholder-prone doc, so the pair-proof alone demotes a confirmed one.
+        if (personas)
+            hits.add("product/personas.yaml");
+    }
+    return [...hits];
+}
+/** Rewrite the first `status: current|accepted` line to `status: draft`. */
+function demoteToDraft(abs) {
+    let raw;
+    try {
+        raw = readFileSync(abs, "utf8");
+    }
+    catch {
+        return false;
+    }
+    const next = raw.replace(/^status:\s*(current|accepted)\s*$/m, "status: draft");
+    if (next === raw)
+        return false;
+    try {
+        writeFileSync(abs, next, "utf8");
+    }
+    catch {
+        return false;
+    }
+    return true;
+}
+export const demoteAutofilledBrand = {
+    id: "0005-demote-autofilled-brand",
+    introducedIn: "0.27.0",
+    describe: "Demote auto-generated brand (marked confirmed before 0.25.0) back to status: draft so machine-written voice/positioning/personas stops being injected every session — now catches the full co-generated cohort, not just the mechanical fallback",
+    class: "review",
+    detect(repoRoot) {
+        return autofilledConfirmed(repoRoot).length > 0;
+    },
+    apply(repoRoot) {
+        const docs = brandDocs(repoRoot);
+        const relToAbs = new Map(docs.map((d) => [d.rel, d.abs]));
+        const targets = autofilledConfirmed(repoRoot);
+        const demoted = [];
+        for (const rel of targets) {
+            const abs = relToAbs.get(rel);
+            if (abs !== undefined && demoteToDraft(abs))
+                demoted.push(rel);
+        }
+        return {
+            changed: demoted.length > 0,
+            detail: demoted.length > 0
+                ? `demoted ${demoted.length} auto-generated brand doc(s) to draft: ${demoted.join(", ")} — review and set status: current on any you actually wrote`
+                : "no auto-generated confirmed brand docs found",
+        };
+    },
+};
+//# sourceMappingURL=0005-demote-autofilled-brand.js.map

package/dist/migrate/migrations/0005-demote-autofilled-brand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"0005-demote-autofilled-brand.js","sourceRoot":"","sources":["../../../src/migrate/migrations/0005-demote-autofilled-brand.ts"],"names":[],"mappings":"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"}

package/dist/migrate/migrations/0006-prune-sot-align-invariants.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 0006 — prune junk Layer-A (sot-align) invariants from existing repos.
+ *
+ * The sot-align hook minted an "invariant" from almost any prose block —
+ * banners, separators, class/endpoint descriptions, test notes. The 0.23.0
+ * creation gate cut the worst of it, but a modal buried anywhere in a
+ * multi-line block still slipped through, so even post-gate repos accreted
+ * box-drawing-titled artifacts and test-fixture comments as "active
+ * invariants". 0.27.0 sharpens both the gate (skip test files) and this
+ * prune (statement-scoped shape + test-source + separator-title rejects).
+ *
+ * `detect`/`apply` wrap the same `pruneInvariants` surgical core the CLI
+ * uses: it touches ONLY `capture_source: layer-a-sot-align` invariants —
+ * archiving those captured from a test/fixture file, titled with a
+ * separator, or with no constraint shape in their statement — to
+ * `.cairn/ground/.archive/` (recoverable), rebuilding the ledger once at
+ * the end. Curated DEC/INV are never touched. For a full reset of the
+ * legacy corpus the operator can run `cairn invariants prune --all`.
+ *
+ * `review`-class: it archives committed ground state, so it surfaces for
+ * the operator and applies via `cairn migrate`. The sharpened gate ships
+ * in 0.27.0, so `introducedIn` advances to 0.27.0 — a repo that already
+ * ran the weaker 0.26.0 pass must re-evaluate; `detect()` carries
+ * correctness.
+ */
+import type { Migration } from "../types.js";
+export declare const pruneSotAlignInvariants: Migration;

package/dist/migrate/migrations/0006-prune-sot-align-invariants.js

@@ -0,0 +1,55 @@
+/**
+ * 0006 — prune junk Layer-A (sot-align) invariants from existing repos.
+ *
+ * The sot-align hook minted an "invariant" from almost any prose block —
+ * banners, separators, class/endpoint descriptions, test notes. The 0.23.0
+ * creation gate cut the worst of it, but a modal buried anywhere in a
+ * multi-line block still slipped through, so even post-gate repos accreted
+ * box-drawing-titled artifacts and test-fixture comments as "active
+ * invariants". 0.27.0 sharpens both the gate (skip test files) and this
+ * prune (statement-scoped shape + test-source + separator-title rejects).
+ *
+ * `detect`/`apply` wrap the same `pruneInvariants` surgical core the CLI
+ * uses: it touches ONLY `capture_source: layer-a-sot-align` invariants —
+ * archiving those captured from a test/fixture file, titled with a
+ * separator, or with no constraint shape in their statement — to
+ * `.cairn/ground/.archive/` (recoverable), rebuilding the ledger once at
+ * the end. Curated DEC/INV are never touched. For a full reset of the
+ * legacy corpus the operator can run `cairn invariants prune --all`.
+ *
+ * `review`-class: it archives committed ground state, so it surfaces for
+ * the operator and applies via `cairn migrate`. The sharpened gate ships
+ * in 0.27.0, so `introducedIn` advances to 0.27.0 — a repo that already
+ * ran the weaker 0.26.0 pass must re-evaluate; `detect()` carries
+ * correctness.
+ */
+import { pruneInvariants } from "../../invariants/prune.js";
+export const pruneSotAlignInvariants = {
+    id: "0006-prune-sot-align-invariants",
+    // 0.27.0: the surgical gate was sharpened (statement-scoped shape +
+    // test-source + separator-title rejects). A repo that already ran the
+    // weaker 0.26.0 pass must re-evaluate, so `introducedIn` advances to the
+    // ship version — `detect()` (a dry-run prune) stays the correctness floor.
+    introducedIn: "0.27.0",
+    describe: "Archive junk Layer-A (sot-align) invariants the creation gate would reject today — test/fixture captures, separator-titled artifacts, and entries with no rule in their statement; curated DEC/INV untouched",
+    class: "review",
+    detect(repoRoot) {
+        try {
+            return pruneInvariants({ repoRoot, dryRun: true }).pruned.length > 0;
+        }
+        catch {
+            return false;
+        }
+    },
+    apply(repoRoot) {
+        const result = pruneInvariants({ repoRoot });
+        const n = result.pruned.length;
+        return {
+            changed: n > 0,
+            detail: n > 0
+                ? `archived ${n} shapeless sot-align invariant(s) of ${result.sotAlignTotal} eligible (${result.kept} kept) → .cairn/ground/.archive/`
+                : "no junk sot-align invariants found",
+        };
+    },
+};
+//# sourceMappingURL=0006-prune-sot-align-invariants.js.map

package/dist/migrate/migrations/0006-prune-sot-align-invariants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"0006-prune-sot-align-invariants.js","sourceRoot":"","sources":["../../../src/migrate/migrations/0006-prune-sot-align-invariants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,MAAM,CAAC,MAAM,uBAAuB,GAAc;IAChD,EAAE,EAAE,iCAAiC;IACrC,oEAAoE;IACpE,sEAAsE;IACtE,yEAAyE;IACzE,2EAA2E;IAC3E,YAAY,EAAE,QAAQ;IACtB,QAAQ,EACN,8MAA8M;IAChN,KAAK,EAAE,QAAQ;IACf,MAAM,CAAC,QAAgB;QACrB,IAAI,CAAC;YACH,OAAO,eAAe,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,KAAK,CAAC,QAAgB;QACpB,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE,CAAC,GAAG,CAAC;YACd,MAAM,EACJ,CAAC,GAAG,CAAC;gBACH,CAAC,CAAC,YAAY,CAAC,wCAAwC,MAAM,CAAC,aAAa,cAAc,MAAM,CAAC,IAAI,kCAAkC;gBACtI,CAAC,CAAC,oCAAoC;SAC3C,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/migrate/migrations/0007-collapse-component-dirs.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 0007 — collapse redundant nested `componentDirs`.
+ *
+ * The pre-0.22.4 component-layout detector could enumerate a directory AND
+ * its sub-directories (and even individual leaf component folders) as
+ * separate `componentDirs`. On a repo adopted in that era a workspace's
+ * `componentDirs` can carry dozens of entries where a directory is already
+ * covered by an ancestor that is also listed — e.g. both `a/b` and
+ * `a/b/c`, plus `a/b/c/Leaf`.
+ *
+ * The component walk recurses (`walkFs`) and collection dedups visited
+ * files (`collectComponents`'s `seen` set), so the redundant entries change
+ * nothing at runtime — they are pure config bloat. This migration removes
+ * any `componentDir` that is a descendant (or exact duplicate) of another
+ * `componentDir` in the same workspace, keeping only the shallowest
+ * ancestors. The collected component set is byte-identical afterward.
+ *
+ * `review`-class: it rewrites the operator's curated `config.yaml`, so it
+ * surfaces the count and applies via `cairn migrate` rather than silently
+ * rewriting their list. Ships in 0.26.0 → `introducedIn` 0.26.0; `detect()`
+ * carries correctness for any older pin.
+ */
+import type { Migration } from "../types.js";
+export declare const collapseComponentDirs: Migration;