@isaacriehm/cairn-core 0.22.6 → 0.23.0

package/dist/invariants/prune.js

@@ -0,0 +1,113 @@
+/**
+ * `cairn invariants prune` — retire junk invariants the Layer A sot-align
+ * hook minted before the creation gate landed.
+ *
+ * Pre-gate, the runtime hook ran a Haiku "creation judge" on every prose
+ * block and over-labeled descriptions as `constraint`, so section banners,
+ * box-drawing separators, class/endpoint descriptions and test-fixture
+ * notes all became "active invariants". This sweep archives them.
+ *
+ * Scope is deliberately narrow: ONLY invariants stamped
+ * `capture_source: layer-a-sot-align` are eligible. Curated invariants
+ * (init, curator, manual `record`/`propose`) are never touched.
+ *
+ *   surgical (default) — archive a sot-align invariant whose statement
+ *                        carries no constraint shape (no modal/marker).
+ *                        This mirrors the new creation gate: anything that
+ *                        couldn't be minted today gets retired.
+ *   all                — archive every sot-align invariant (full reset).
+ *
+ * Retirement reuses `archiveEntity` (move to `.cairn/ground/.archive/`,
+ * flip status, drop from the SoT cache) but defers the per-entity ledger
+ * rebuild so a 700-entity sweep rebuilds once instead of O(n²).
+ */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { archiveEntity, deleteSotCacheEntry, invariantsDir, parseFrontmatterRecord, readSotCache, writeInvariantsLedger, writeSotCache, } from "@isaacriehm/cairn-state";
+import { hasConstraintShape } from "../hooks/sot-align-common.js";
+/** The runtime hook's stamp — the only capture_source this sweep retires. */
+const SOT_ALIGN_SOURCE = "layer-a-sot-align";
+export function pruneInvariants(opts) {
+    const mode = opts.mode ?? "surgical";
+    const dryRun = opts.dryRun ?? false;
+    const dir = invariantsDir(opts.repoRoot);
+    const result = {
+        scanned: 0,
+        sotAlignTotal: 0,
+        pruned: [],
+        kept: 0,
+        dryRun,
+    };
+    if (!existsSync(dir))
+        return result;
+    const files = readdirSync(dir).filter((n) => n.endsWith(".md"));
+    let archivedAny = false;
+    for (const file of files) {
+        result.scanned += 1;
+        const id = file.replace(/\.md$/, "");
+        let fm;
+        let body;
+        try {
+            ({ fm, body } = parseFrontmatterRecord(readFileSync(join(dir, file), "utf8")));
+        }
+        catch {
+            continue; // unreadable / malformed — leave it for the doctor to flag
+        }
+        const capture = typeof fm["capture_source"] === "string" ? fm["capture_source"] : "";
+        if (capture !== SOT_ALIGN_SOURCE)
+            continue; // never touch curated invariants
+        result.sotAlignTotal += 1;
+        const title = typeof fm["title"] === "string" ? fm["title"] : "";
+        let prune = false;
+        let reason = "";
+        if (mode === "all") {
+            prune = true;
+            reason = "full reset of sot-align invariants";
+        }
+        else if (!hasConstraintShape(`${title}\n${body}`)) {
+            prune = true;
+            reason = "no constraint shape — not a real invariant under the creation gate";
+        }
+        if (!prune) {
+            result.kept += 1;
+            continue;
+        }
+        if (!dryRun) {
+            const r = archiveEntity({
+                repoRoot: opts.repoRoot,
+                id,
+                reason: `cairn invariants prune — ${reason}`,
+                deferDerivedRebuild: true,
+                ...(opts.now !== undefined ? { now: opts.now } : {}),
+            });
+            if (!r.ok) {
+                // Couldn't move it (already gone / unreadable) — don't claim a prune.
+                result.kept += 1;
+                continue;
+            }
+            archivedAny = true;
+        }
+        result.pruned.push({ id, title: title.slice(0, 100), reason });
+    }
+    // One derived-state rebuild for the whole batch (archiveEntity deferred it).
+    if (archivedAny && !dryRun) {
+        const prunedIds = new Set(result.pruned.map((p) => p.id));
+        try {
+            let cache = readSotCache(opts.repoRoot);
+            for (const id of prunedIds)
+                cache = deleteSotCacheEntry(cache, id);
+            writeSotCache(opts.repoRoot, cache);
+        }
+        catch {
+            /* best-effort — cache self-heals on next sweep */
+        }
+        try {
+            writeInvariantsLedger({ repoRoot: opts.repoRoot });
+        }
+        catch {
+            /* best-effort — `cairn fix` rebuilds it */
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=prune.js.map

package/dist/invariants/prune.js.map

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

package/dist/uninstall/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `cairn uninstall` — remove Cairn from a repo, cleanly.
+ *
+ * The inverse of adoption (`cairn init`) + per-clone bootstrap
+ * (`cairn join`). The install footprint is:
+ *
+ *   - `.cairn/`                       the ground state + config + hooks
+ *   - `.claude/rules/cairn.md`        the plugin-absent onboarding notice
+ *   - an `@.claude/rules/cairn.md`    import block in CLAUDE.md / AGENTS.md
+ *   - `git config core.hooksPath`     pointed at `.cairn/git-hooks`
+ *   - in-source `// §DEC-/§INV-`       citations from sot-align strip-replace
+ *
+ * Uninstall reverses these in dependency order. Cites are expanded FIRST
+ * (while `.cairn/ground/` still exists to resolve them), so removing
+ * `.cairn/` doesn't leave dangling `§` references — the source ends up
+ * self-documenting. `core.hooksPath` is only unset when it is Cairn's own
+ * value (a foreign husky/lefthook path is never clobbered).
+ *
+ * Every step reports a status; nothing throws on a recoverable issue. The
+ * machine-level Claude Code plugin (`/plugin install`) is user-scoped, not
+ * repo-scoped — uninstall can't remove it and says so.
+ */
+export type UninstallStepStatus = "ok" | "skipped" | "warn";
+export interface UninstallStep {
+    step: string;
+    status: UninstallStepStatus;
+    detail: string;
+}
+export interface UninstallOptions {
+    repoRoot: string;
+    /** Expand DEC/INV cites to inline comments first. Default true. */
+    expandCites?: boolean;
+    /** Report what would happen; change nothing. */
+    dryRun?: boolean;
+}
+export interface UninstallResult {
+    repoRoot: string;
+    steps: UninstallStep[];
+    /** True when `.cairn/` was (or would be) removed. */
+    removed: boolean;
+}
+export declare function uninstallCairn(opts: UninstallOptions): UninstallResult;
+/** Remove the marker + import lines, then collapse the blank-line run they left. */
+export declare function stripImportBlock(content: string): string;

package/dist/uninstall/index.js

@@ -0,0 +1,185 @@
+/**
+ * `cairn uninstall` — remove Cairn from a repo, cleanly.
+ *
+ * The inverse of adoption (`cairn init`) + per-clone bootstrap
+ * (`cairn join`). The install footprint is:
+ *
+ *   - `.cairn/`                       the ground state + config + hooks
+ *   - `.claude/rules/cairn.md`        the plugin-absent onboarding notice
+ *   - an `@.claude/rules/cairn.md`    import block in CLAUDE.md / AGENTS.md
+ *   - `git config core.hooksPath`     pointed at `.cairn/git-hooks`
+ *   - in-source `// §DEC-/§INV-`       citations from sot-align strip-replace
+ *
+ * Uninstall reverses these in dependency order. Cites are expanded FIRST
+ * (while `.cairn/ground/` still exists to resolve them), so removing
+ * `.cairn/` doesn't leave dangling `§` references — the source ends up
+ * self-documenting. `core.hooksPath` is only unset when it is Cairn's own
+ * value (a foreign husky/lefthook path is never clobbered).
+ *
+ * Every step reports a status; nothing throws on a recoverable issue. The
+ * machine-level Claude Code plugin (`/plugin install`) is user-scoped, not
+ * repo-scoped — uninstall can't remove it and says so.
+ */
+import { execFileSync } from "node:child_process";
+import { existsSync, readFileSync, readdirSync, rmSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+import { cairnDir, COMMITTED_HOOKS_PATH } from "@isaacriehm/cairn-state";
+import { expandCitesInRepo } from "../cites/expand.js";
+import { CAIRN_RULE_IMPORT, IMPORT_MARKER } from "../init/claude-rule.js";
+export function uninstallCairn(opts) {
+    const root = opts.repoRoot;
+    const dryRun = opts.dryRun ?? false;
+    const doExpand = opts.expandCites ?? true;
+    const steps = [];
+    // 1. Expand cites FIRST — needs `.cairn/ground/` to resolve bodies.
+    if (doExpand) {
+        const r = expandCitesInRepo({ repoRoot: root, dryRun });
+        const bits = [`${r.expanded} citation(s) inlined across ${r.filesChanged} file(s)`];
+        if (r.danglingSkipped > 0)
+            bits.push(`${r.danglingSkipped} dangling left in place`);
+        if (r.inlineSkipped > 0)
+            bits.push(`${r.inlineSkipped} inline left in place`);
+        steps.push({ step: "expand-cites", status: "ok", detail: bits.join("; ") });
+    }
+    else {
+        steps.push({
+            step: "expand-cites",
+            status: "skipped",
+            detail: "--keep-cites: in-source §DEC-/§INV- tokens will dangle after removal",
+        });
+    }
+    // 2. Remove the `@.claude/rules/cairn.md` import block from the memory file.
+    steps.push(unwireRuleImport(root, dryRun));
+    // 3. Remove `.claude/rules/cairn.md` and prune the dirs if they empty out.
+    steps.push(removeRuleFile(root, dryRun));
+    // 4. Unset `core.hooksPath` — only when it is Cairn's own value.
+    steps.push(unsetHooksPath(root, dryRun));
+    // 5. Remove `.cairn/`.
+    const cairnPath = cairnDir(root);
+    let removed = false;
+    if (existsSync(cairnPath)) {
+        removed = true;
+        if (!dryRun)
+            rmSync(cairnPath, { recursive: true, force: true });
+        steps.push({ step: "remove-cairn-dir", status: "ok", detail: `${dryRun ? "would remove" : "removed"} .cairn/` });
+    }
+    else {
+        steps.push({ step: "remove-cairn-dir", status: "skipped", detail: ".cairn/ not present" });
+    }
+    // 6. Advisory — the machine-level plugin is user-scoped.
+    steps.push({
+        step: "plugin",
+        status: "skipped",
+        detail: "Claude Code plugin is machine-scoped — remove with `/plugin uninstall cairn` if no other repo uses it",
+    });
+    return { repoRoot: root, steps, removed };
+}
+/* -------------------------------------------------------------------------- */
+function unwireRuleImport(root, dryRun) {
+    for (const rel of ["CLAUDE.md", "AGENTS.md"]) {
+        const abs = join(root, rel);
+        if (!existsSync(abs))
+            continue;
+        let content;
+        try {
+            content = readFileSync(abs, "utf8");
+        }
+        catch {
+            continue;
+        }
+        if (!content.includes(CAIRN_RULE_IMPORT))
+            continue;
+        const next = stripImportBlock(content);
+        if (!dryRun)
+            writeFileSync(abs, next, "utf8");
+        return {
+            step: "unwire-import",
+            status: "ok",
+            detail: `${dryRun ? "would remove" : "removed"} the cairn rule import from ${rel}`,
+        };
+    }
+    return { step: "unwire-import", status: "skipped", detail: "no cairn rule import found in CLAUDE.md / AGENTS.md" };
+}
+/** Remove the marker + import lines, then collapse the blank-line run they left. */
+export function stripImportBlock(content) {
+    const lines = content.split(/\r?\n/);
+    const kept = lines.filter((l) => l.trim() !== IMPORT_MARKER && l.trim() !== CAIRN_RULE_IMPORT);
+    // Collapse 3+ consecutive blank lines (the import block was fenced by blanks)
+    // down to a single blank, then normalize the trailing newline.
+    const collapsed = [];
+    let blanks = 0;
+    for (const l of kept) {
+        if (l.trim() === "") {
+            blanks += 1;
+            if (blanks >= 2)
+                continue;
+        }
+        else {
+            blanks = 0;
+        }
+        collapsed.push(l);
+    }
+    return `${collapsed.join("\n").replace(/\s*$/, "")}\n`;
+}
+function removeRuleFile(root, dryRun) {
+    const ruleAbs = join(root, ".claude", "rules", "cairn.md");
+    if (!existsSync(ruleAbs)) {
+        return { step: "remove-rule", status: "skipped", detail: ".claude/rules/cairn.md not present" };
+    }
+    if (!dryRun) {
+        rmSync(ruleAbs, { force: true });
+        pruneIfEmpty(join(root, ".claude", "rules"));
+        pruneIfEmpty(join(root, ".claude"));
+    }
+    return { step: "remove-rule", status: "ok", detail: `${dryRun ? "would remove" : "removed"} .claude/rules/cairn.md` };
+}
+function pruneIfEmpty(dir) {
+    try {
+        if (existsSync(dir) && readdirSync(dir).length === 0)
+            rmSync(dir, { recursive: true, force: true });
+    }
+    catch {
+        /* best-effort */
+    }
+}
+function unsetHooksPath(root, dryRun) {
+    if (!existsSync(join(root, ".git"))) {
+        return { step: "unset-hooks", status: "skipped", detail: "not a git repo" };
+    }
+    const current = readGitConfig(root, "core.hooksPath");
+    if (current === null) {
+        return { step: "unset-hooks", status: "skipped", detail: "core.hooksPath not set" };
+    }
+    const ours = current === COMMITTED_HOOKS_PATH || current === cairnDir(root, "git-hooks");
+    if (!ours) {
+        return {
+            step: "unset-hooks",
+            status: "warn",
+            detail: `core.hooksPath is '${current}' (not Cairn's) — left untouched`,
+        };
+    }
+    if (!dryRun) {
+        try {
+            execFileSync("git", ["config", "--unset", "core.hooksPath"], { cwd: root, stdio: "ignore" });
+        }
+        catch {
+            return { step: "unset-hooks", status: "warn", detail: "failed to unset core.hooksPath" };
+        }
+    }
+    return { step: "unset-hooks", status: "ok", detail: `${dryRun ? "would unset" : "unset"} core.hooksPath` };
+}
+function readGitConfig(root, key) {
+    try {
+        const out = execFileSync("git", ["config", "--get", key], {
+            cwd: root,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        const trimmed = out.trim();
+        return trimmed.length === 0 ? null : trimmed;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/uninstall/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isaacriehm/cairn-core",
-  "version": "0.22.6",
+  "version": "0.23.0",
   "description": "Cairn core — state + context layer. Curated `.cairn/ground/` (decisions, §INV invariants, canonical-map, brand, quality-grades), MCP server, init wizard, hook runners, sensors, GC drift sweep.",
   "author": "Isaac Riehm",
   "license": "MIT",
@@ -39,7 +39,7 @@
     "simple-git": "^3.36.0",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
-    "@isaacriehm/cairn-state": "0.22.6"
+    "@isaacriehm/cairn-state": "0.23.0"
   },
   "devDependencies": {
     "@types/cli-progress": "^3.11.6",

package/templates/.cairn/config/sensors.yaml

@@ -36,16 +36,23 @@ sensors:
       - every_run
     fail_severity: hard
 
-  # ── §INV invariant sensors (auto-registered by backprop) ────────────────
+  # ── §INV invariant sensors ───────────────────────────────────────────────
+  # PLANNED — not yet wired. No runner reads this entry: the pre-commit sweep
+  # executes only stub-pattern-catalog + decision-assertions. Invariants are
+  # curated (§INV pillar) but enforcement (an assertions[] array on each
+  # invariant routed through the assertion evaluator, like decisions) is a
+  # gap, not a live gate. Kept `soft` so it reads as a roadmap item, NOT a
+  # hard gate that silently passes because nothing runs it.
   - id: invariant-suite
     layer: invariants
     kind: invariant_runner
-    description: "Runs every active §INV invariant's linked sensor script. Active invariants accumulate over time; superseded ones are skipped."
+    status: planned
+    description: "PLANNED (not wired): would run every active §INV invariant's linked assertion. Today no runner reads this; invariant enforcement is unimplemented."
     triggers:
       - every_run
     sources:
       - .cairn/ground/invariants/
-    fail_severity: hard
+    fail_severity: soft
 
   # ── Frontmatter freshness (nightly GC pass) ──────────────────────────────
   - id: frontmatter-freshness