@isaacriehm/cairn-core 0.1.0

package/dist/init/rules-merge/index.d.ts

@@ -0,0 +1,10 @@
+export { discoverRuleSources } from "./discover.js";
+export type { RuleSourceFile } from "./discover.js";
+export { KEEP_END_MARKER, KEEP_START_MARKER, extractKeepBlocks, reapplyKeepBlocks, renderKeepBlock, } from "./keep-markers.js";
+export type { KeepBlock } from "./keep-markers.js";
+export { parseRuleSections } from "./parse-sections.js";
+export type { RuleSection } from "./parse-sections.js";
+export { regenerateRulesFiles } from "./regenerate.js";
+export type { RegenerateRulesArgs, RegenerateRulesResult, } from "./regenerate.js";
+export { runRulesMerge } from "./ingest.js";
+export type { RuleClassKind, RuleClassification, RunRulesMergeArgs, RunRulesMergeResult, } from "./ingest.js";

package/dist/init/rules-merge/index.js

@@ -0,0 +1,6 @@
+export { discoverRuleSources } from "./discover.js";
+export { KEEP_END_MARKER, KEEP_START_MARKER, extractKeepBlocks, reapplyKeepBlocks, renderKeepBlock, } from "./keep-markers.js";
+export { parseRuleSections } from "./parse-sections.js";
+export { regenerateRulesFiles } from "./regenerate.js";
+export { runRulesMerge } from "./ingest.js";
+//# sourceMappingURL=index.js.map

package/dist/init/rules-merge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/init/rules-merge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAKvD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/init/rules-merge/ingest.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Phase 7c orchestrator — discover + parse + Haiku classify + persist.
+ *
+ * Ingests CLAUDE.md, AGENTS.md, .claude/CLAUDE.md, and `.claude/rules/**.md`
+ * during init. Each H2/H3 section is classified by Haiku as:
+ *
+ *   - "rule-net-new"  — section states a rule cairn doesn't have yet (DEC draft to inbox)
+ *   - "rule-conflict" — section conflicts with existing cairn state (soft-conflict to attention)
+ *   - "informational" — TOC, history, walkthrough — no action
+ *   - "operator-keep" — already inside keep-marker block (skipped pre-classification)
+ *
+ * Net-new rules become DEC drafts in `.cairn/ground/decisions/_inbox/`.
+ * Soft conflicts append to `.cairn/baseline/rule-conflicts-<ISO>.yaml`.
+ *
+ * Resilient: a single Haiku failure marks the section "informational" and
+ * continues. All output paths captured in the result so the skill can surface
+ * them.
+ */
+import type { RuleSourceFile } from "./discover.js";
+import type { RuleSection } from "./parse-sections.js";
+export type RuleClassKind = "rule-net-new" | "rule-conflict" | "informational" | "operator-keep";
+export interface RuleClassification {
+    source: string;
+    level: 2 | 3 | 0;
+    title: string;
+    startOffset: number;
+    kind: RuleClassKind;
+    proposedDecTitle: string;
+    proposedRationale: string;
+    conflictsWith: string;
+    failed: boolean;
+    errorMessage?: string;
+}
+export interface RunRulesMergeArgs {
+    repoRoot: string;
+    /** When set, every section is classified by this fn — bypasses Haiku. */
+    mockClassify?: (section: RuleSection, source: RuleSourceFile) => RuleClassification;
+    dryRun?: boolean;
+    nowIso?: string;
+}
+export interface RunRulesMergeResult {
+    sources: RuleSourceFile[];
+    sectionsTotal: number;
+    classifications: RuleClassification[];
+    decDraftsWritten: {
+        id: string;
+        path: string;
+        sourceFile: string;
+    }[];
+    conflictsRecorded: number;
+    conflictsPath: string | null;
+    auditPath: string;
+    auditRelPath: string;
+    kindCounts: Record<RuleClassKind, number>;
+}
+export declare function runRulesMerge(args: RunRulesMergeArgs): Promise<RunRulesMergeResult>;

package/dist/init/rules-merge/ingest.js

@@ -0,0 +1,336 @@
+/**
+ * Phase 7c orchestrator — discover + parse + Haiku classify + persist.
+ *
+ * Ingests CLAUDE.md, AGENTS.md, .claude/CLAUDE.md, and `.claude/rules/**.md`
+ * during init. Each H2/H3 section is classified by Haiku as:
+ *
+ *   - "rule-net-new"  — section states a rule cairn doesn't have yet (DEC draft to inbox)
+ *   - "rule-conflict" — section conflicts with existing cairn state (soft-conflict to attention)
+ *   - "informational" — TOC, history, walkthrough — no action
+ *   - "operator-keep" — already inside keep-marker block (skipped pre-classification)
+ *
+ * Net-new rules become DEC drafts in `.cairn/ground/decisions/_inbox/`.
+ * Soft conflicts append to `.cairn/baseline/rule-conflicts-<ISO>.yaml`.
+ *
+ * Resilient: a single Haiku failure marks the section "informational" and
+ * continues. All output paths captured in the result so the skill can surface
+ * them.
+ */
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { stringify as stringifyYaml } from "yaml";
+import { runClaude } from "../../claude/index.js";
+import { allocateDecisionId, scanExistingDecisionIds, } from "../../decision-capture/id.js";
+import { decisionsDir } from "../../ground/paths.js";
+import { logger } from "../../logger.js";
+import { discoverRuleSources } from "./discover.js";
+import { parseRuleSections } from "./parse-sections.js";
+const log = logger("init.rules-merge.ingest");
+const PER_SECTION_TIMEOUT_MS = 60_000;
+const SECTION_BODY_CAP = 4_000;
+const CONCURRENCY = 4;
+/* -------------------------------------------------------------------------- */
+/* Schema + prompt                                                            */
+/* -------------------------------------------------------------------------- */
+const CLASSIFY_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    required: ["kind"],
+    properties: {
+        kind: {
+            type: "string",
+            enum: ["rule-net-new", "rule-conflict", "informational", "operator-keep"],
+        },
+        proposed_dec_title: { type: "string" },
+        proposed_rationale: { type: "string" },
+        conflicts_with: { type: "string" },
+    },
+};
+const CLASSIFY_SYSTEM = `You classify markdown sections of project-rule files for Cairn adoption.
+
+Each section comes from one of: CLAUDE.md, AGENTS.md, .claude/CLAUDE.md, or a .claude/rules/*.md file.
+
+Return JSON matching the schema. \`kind\` must be exactly one of:
+  - "rule-net-new"   the section states a binding rule cairn doesn't yet have
+  - "rule-conflict"  the section contradicts an existing cairn rule (provide conflicts_with id when known)
+  - "informational"  TOC, walkthrough, history, formatting notes — nothing to ingest
+  - "operator-keep"  the section is wrapped in keep-markers (rare — caller usually filters first)
+
+Optional fields:
+  - proposed_dec_title  5-10 word imperative title (only when kind = "rule-net-new")
+  - proposed_rationale  2-3 sentence summary (only when kind = "rule-net-new")
+  - conflicts_with      DEC-NNNN or §V<N> id (only when kind = "rule-conflict")
+
+Be conservative. When in doubt, "informational".`;
+/* -------------------------------------------------------------------------- */
+/* Public                                                                     */
+/* -------------------------------------------------------------------------- */
+export async function runRulesMerge(args) {
+    const repoRoot = args.repoRoot;
+    const nowIso = args.nowIso ?? new Date().toISOString();
+    const tsSlug = nowIso.replace(/[:.]/g, "-").slice(0, 19);
+    const sources = discoverRuleSources(repoRoot);
+    const allClassifications = [];
+    const jobs = [];
+    for (const source of sources) {
+        let body;
+        try {
+            body = readFileSync(source.absPath, "utf8");
+        }
+        catch (err) {
+            log.warn({ source: source.path, err: err instanceof Error ? err.message : String(err) }, "rule source unreadable; skipping");
+            continue;
+        }
+        const sections = parseRuleSections(body);
+        for (const section of sections) {
+            if (section.level === 0)
+                continue; // skip preamble
+            if (section.protectedByKeepMarker) {
+                allClassifications.push({
+                    source: source.path,
+                    level: section.level,
+                    title: section.title,
+                    startOffset: section.startOffset,
+                    kind: "operator-keep",
+                    proposedDecTitle: "",
+                    proposedRationale: "",
+                    conflictsWith: "",
+                    failed: false,
+                });
+                continue;
+            }
+            jobs.push({ source, section });
+        }
+    }
+    if (args.mockClassify !== undefined) {
+        for (const job of jobs) {
+            allClassifications.push(args.mockClassify(job.section, job.source));
+        }
+    }
+    else {
+        let cursor = 0;
+        const worker = async () => {
+            while (cursor < jobs.length) {
+                const idx = cursor++;
+                const job = jobs[idx];
+                if (job === undefined)
+                    continue;
+                const cls = await classifySection(job.source, job.section);
+                allClassifications.push(cls);
+            }
+        };
+        const workers = Array.from({ length: Math.min(CONCURRENCY, jobs.length) }, () => worker());
+        await Promise.all(workers);
+    }
+    // Persist DEC drafts + conflicts.
+    const decDraftsWritten = [];
+    const conflictRows = [];
+    const existingIds = scanExistingDecisionIds(repoRoot);
+    for (const cls of allClassifications) {
+        if (cls.kind === "rule-net-new" && cls.proposedDecTitle.length > 0) {
+            const id = allocateDecisionId(repoRoot, existingIds);
+            existingIds.add(id);
+            if (args.dryRun !== true) {
+                const written = writeDecDraft({
+                    repoRoot,
+                    id,
+                    classification: cls,
+                    generatedAt: nowIso,
+                });
+                decDraftsWritten.push({ id, path: written.relPath, sourceFile: cls.source });
+            }
+            else {
+                decDraftsWritten.push({
+                    id,
+                    path: `.cairn/ground/decisions/_inbox/${id}.draft.md`,
+                    sourceFile: cls.source,
+                });
+            }
+        }
+        if (cls.kind === "rule-conflict") {
+            conflictRows.push({
+                source_file: cls.source,
+                section_title: cls.title,
+                section_offset: cls.startOffset,
+                conflicts_with: cls.conflictsWith,
+            });
+        }
+    }
+    const auditRelPath = `.cairn/baseline/rules-merge-${tsSlug}.yaml`;
+    const auditPath = join(repoRoot, auditRelPath);
+    let conflictsPath = null;
+    const kindCounts = {
+        "rule-net-new": 0,
+        "rule-conflict": 0,
+        informational: 0,
+        "operator-keep": 0,
+    };
+    for (const c of allClassifications) {
+        kindCounts[c.kind] = (kindCounts[c.kind] ?? 0) + 1;
+    }
+    if (args.dryRun !== true) {
+        writeYaml(auditPath, {
+            run_at: nowIso,
+            sources: sources.map((s) => ({ path: s.path, kind: s.kind, size: s.size })),
+            sections_total: allClassifications.length,
+            kind_counts: kindCounts,
+            classifications: allClassifications.map((c) => ({
+                source: c.source,
+                title: c.title,
+                level: c.level,
+                kind: c.kind,
+                start_offset: c.startOffset,
+                proposed_dec_title: c.proposedDecTitle,
+                proposed_rationale: c.proposedRationale,
+                conflicts_with: c.conflictsWith,
+                failed: c.failed,
+                ...(c.errorMessage !== undefined ? { error: c.errorMessage } : {}),
+            })),
+        });
+        if (conflictRows.length > 0) {
+            const rel = `.cairn/baseline/rule-conflicts-${tsSlug}.yaml`;
+            conflictsPath = join(repoRoot, rel);
+            writeYaml(conflictsPath, {
+                run_at: nowIso,
+                conflicts: conflictRows,
+            });
+        }
+    }
+    log.info({
+        sources: sources.length,
+        sections: allClassifications.length,
+        kindCounts,
+        decDrafts: decDraftsWritten.length,
+        conflicts: conflictRows.length,
+    }, "rules merge complete");
+    return {
+        sources,
+        sectionsTotal: allClassifications.length,
+        classifications: allClassifications,
+        decDraftsWritten,
+        conflictsRecorded: conflictRows.length,
+        conflictsPath,
+        auditPath,
+        auditRelPath,
+        kindCounts,
+    };
+}
+/* -------------------------------------------------------------------------- */
+/* Classify single section (Haiku)                                            */
+/* -------------------------------------------------------------------------- */
+async function classifySection(source, section) {
+    const body = section.body.length > SECTION_BODY_CAP
+        ? `${section.body.slice(0, SECTION_BODY_CAP)}\n…[truncated]`
+        : section.body;
+    const prompt = [
+        `Source: ${source.path}`,
+        `Section title: ${section.title || "(preamble)"}`,
+        `Heading level: ${section.level}`,
+        "",
+        "Body:",
+        body,
+    ].join("\n");
+    try {
+        const result = await runClaude({
+            tier: "haiku",
+            system: CLASSIFY_SYSTEM,
+            prompt,
+            jsonSchema: CLASSIFY_SCHEMA,
+            timeoutMs: PER_SECTION_TIMEOUT_MS,
+        });
+        const parsed = result.parsed;
+        if (typeof parsed !== "object" || parsed === null) {
+            return informational({
+                source: source.path,
+                section,
+                failed: true,
+                errorMessage: "non-object response",
+            });
+        }
+        const r = parsed;
+        const kindRaw = r["kind"];
+        const kind = kindRaw === "rule-net-new" ||
+            kindRaw === "rule-conflict" ||
+            kindRaw === "operator-keep"
+            ? kindRaw
+            : "informational";
+        return {
+            source: source.path,
+            level: section.level,
+            title: section.title,
+            startOffset: section.startOffset,
+            kind,
+            proposedDecTitle: typeof r["proposed_dec_title"] === "string" ? r["proposed_dec_title"] : "",
+            proposedRationale: typeof r["proposed_rationale"] === "string" ? r["proposed_rationale"] : "",
+            conflictsWith: typeof r["conflicts_with"] === "string" ? r["conflicts_with"] : "",
+            failed: false,
+        };
+    }
+    catch (err) {
+        return informational({
+            source: source.path,
+            section,
+            failed: true,
+            errorMessage: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+function informational(args) {
+    return {
+        source: args.source,
+        level: args.section.level,
+        title: args.section.title,
+        startOffset: args.section.startOffset,
+        kind: "informational",
+        proposedDecTitle: "",
+        proposedRationale: "",
+        conflictsWith: "",
+        failed: args.failed,
+        ...(args.errorMessage !== undefined ? { errorMessage: args.errorMessage } : {}),
+    };
+}
+function writeDecDraft(args) {
+    const dir = decisionsDir(args.repoRoot);
+    const inboxDir = join(dir, "_inbox");
+    mkdirSync(inboxDir, { recursive: true });
+    const filename = `${args.id}.draft.md`;
+    const abs = join(inboxDir, filename);
+    const rel = `.cairn/ground/decisions/_inbox/${filename}`;
+    const fm = {
+        id: args.id,
+        title: args.classification.proposedDecTitle || `(untitled — from ${args.classification.source})`,
+        type: "adr",
+        status: "draft-from-rules-merge",
+        audience: "dual",
+        generated: args.generatedAt,
+        "verified-at": args.generatedAt,
+        decided_at: args.generatedAt,
+        decided_by: "cairn-init",
+        capture_source: "init-rules-merge",
+        capture_confidence: "medium",
+        sourceFile: args.classification.source,
+        sectionTitle: args.classification.title,
+    };
+    const lines = [];
+    lines.push("---");
+    lines.push(stringifyYaml(fm).trimEnd());
+    lines.push("---");
+    lines.push("");
+    lines.push(`# ${args.id} — ${fm["title"]}`);
+    lines.push("");
+    lines.push("## Source section");
+    lines.push("");
+    lines.push(`From \`${args.classification.source}\`, section "${args.classification.title}".`);
+    lines.push("");
+    lines.push("## Proposed rationale");
+    lines.push("");
+    lines.push(args.classification.proposedRationale);
+    lines.push("");
+    writeFileSync(abs, lines.join("\n"), "utf8");
+    return { absPath: abs, relPath: rel };
+}
+function writeYaml(path, payload) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, stringifyYaml(payload), "utf8");
+}
+//# sourceMappingURL=ingest.js.map

package/dist/init/rules-merge/ingest.js.map

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

package/dist/init/rules-merge/keep-markers.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Phase 7c — operator keep-section preservation.
+ *
+ * After adoption, cairn regenerates CLAUDE.md / AGENTS.md from ground state
+ * on each sweep. Operator-written sections survive only when wrapped in a pair
+ * of HTML comment markers:
+ *
+ *     <!-- cairn:keep-start -->
+ *     ... operator content (preserved verbatim) ...
+ *     <!-- cairn:keep-end -->
+ *
+ * These helpers parse + render those blocks.
+ */
+export declare const KEEP_START_MARKER = "<!-- cairn:keep-start -->";
+export declare const KEEP_END_MARKER = "<!-- cairn:keep-end -->";
+export interface KeepBlock {
+    /** Optional operator label after the start marker (e.g. `:custom-flow`). */
+    label: string;
+    /** Body between the markers (markers excluded). */
+    body: string;
+    /** Byte offset in the source file where the block starts. */
+    startOffset: number;
+    /** Byte offset where the block (incl. closing marker) ends. */
+    endOffset: number;
+}
+export declare function extractKeepBlocks(source: string): KeepBlock[];
+/**
+ * Wraps `body` with the keep markers. Adds an optional label.
+ */
+export declare function renderKeepBlock(body: string, label?: string): string;
+/**
+ * Replace any cairn-rendered region of `existing` with `regenerated`, while
+ * preserving every keep-block from `existing` at its original logical anchor:
+ * the regenerator inserts a placeholder marker `<!-- cairn:keep-anchor:N -->`
+ * for each keep block; this helper substitutes those anchors back to the real
+ * keep blocks. If a keep block has no matching anchor it is appended at the
+ * end of the file under a "## Operator-preserved sections" heading.
+ */
+export declare function reapplyKeepBlocks(regenerated: string, keepBlocks: KeepBlock[]): string;

package/dist/init/rules-merge/keep-markers.js

@@ -0,0 +1,97 @@
+/**
+ * Phase 7c — operator keep-section preservation.
+ *
+ * After adoption, cairn regenerates CLAUDE.md / AGENTS.md from ground state
+ * on each sweep. Operator-written sections survive only when wrapped in a pair
+ * of HTML comment markers:
+ *
+ *     <!-- cairn:keep-start -->
+ *     ... operator content (preserved verbatim) ...
+ *     <!-- cairn:keep-end -->
+ *
+ * These helpers parse + render those blocks.
+ */
+export const KEEP_START_MARKER = "<!-- cairn:keep-start -->";
+export const KEEP_END_MARKER = "<!-- cairn:keep-end -->";
+const START_RE = /<!--\s*cairn:keep-start(?::([^\s]+))?\s*-->/g;
+const END_TOKEN = "<!-- cairn:keep-end -->";
+export function extractKeepBlocks(source) {
+    const blocks = [];
+    let match;
+    START_RE.lastIndex = 0;
+    while ((match = START_RE.exec(source)) !== null) {
+        const startOffset = match.index;
+        const afterStart = match.index + match[0].length;
+        // Find a matching end. We look for the literal token to keep parsing tight.
+        const endIdx = source.indexOf(END_TOKEN, afterStart);
+        if (endIdx === -1)
+            break;
+        const endOffset = endIdx + END_TOKEN.length;
+        let body = source.slice(afterStart, endIdx);
+        body = body.replace(/^\n/, "").replace(/\n$/, "");
+        blocks.push({
+            label: match[1] ?? "",
+            body,
+            startOffset,
+            endOffset,
+        });
+        START_RE.lastIndex = endOffset;
+    }
+    return blocks;
+}
+/**
+ * Wraps `body` with the keep markers. Adds an optional label.
+ */
+export function renderKeepBlock(body, label) {
+    const labelPart = label && label.length > 0 ? `:${label}` : "";
+    return [
+        `<!-- cairn:keep-start${labelPart} -->`,
+        body,
+        KEEP_END_MARKER,
+    ].join("\n");
+}
+/**
+ * Replace any cairn-rendered region of `existing` with `regenerated`, while
+ * preserving every keep-block from `existing` at its original logical anchor:
+ * the regenerator inserts a placeholder marker `<!-- cairn:keep-anchor:N -->`
+ * for each keep block; this helper substitutes those anchors back to the real
+ * keep blocks. If a keep block has no matching anchor it is appended at the
+ * end of the file under a "## Operator-preserved sections" heading.
+ */
+export function reapplyKeepBlocks(regenerated, keepBlocks) {
+    if (keepBlocks.length === 0)
+        return regenerated;
+    let out = regenerated;
+    const consumed = new Set();
+    for (let i = 0; i < keepBlocks.length; i++) {
+        const block = keepBlocks[i];
+        if (block === undefined)
+            continue;
+        const anchor = `<!-- cairn:keep-anchor:${i} -->`;
+        if (out.includes(anchor)) {
+            out = out.replace(anchor, renderKeepBlock(block.body, block.label));
+            consumed.add(i);
+        }
+    }
+    const orphans = keepBlocks
+        .map((b, idx) => ({ b, idx }))
+        .filter(({ idx, b }) => !consumed.has(idx) && b !== undefined);
+    if (orphans.length === 0)
+        return out;
+    const trailer = [
+        "",
+        "<!-- cairn:appendix-start -->",
+        "## Operator-preserved sections",
+        "",
+    ];
+    for (const o of orphans) {
+        if (o.b === undefined)
+            continue;
+        trailer.push(renderKeepBlock(o.b.body, o.b.label));
+        trailer.push("");
+    }
+    trailer.push("<!-- cairn:appendix-end -->");
+    trailer.push("");
+    return `${out.trimEnd()}\n${trailer.join("\n")}`;
+}
+//# sourceMappingURL=keep-markers.js.map

package/dist/init/rules-merge/keep-markers.js.map

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

package/dist/init/rules-merge/parse-sections.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Markdown section splitter for rules-merge.
+ *
+ * Splits a markdown body into H2/H3-headed sections. Each section keeps the
+ * original heading line + body until the next heading at the same or lower
+ * level. Front-matter (everything before the first heading) is returned as a
+ * synthetic section with `level: 0` and `title: ""`.
+ *
+ * Operator-preserved blocks (between `<!-- cairn:keep-start -->` and
+ * `<!-- cairn:keep-end -->`) are tagged so the classifier can skip them.
+ */
+export interface RuleSection {
+    /** 0 = preamble, 2 = H2, 3 = H3 (we ignore deeper levels — too granular). */
+    level: 0 | 2 | 3;
+    /** Heading text without leading hashes. Empty for the preamble. */
+    title: string;
+    /** Body markdown including the heading line itself. */
+    body: string;
+    /** Byte offset of section start in the original file. */
+    startOffset: number;
+    /** True when section overlaps a keep-block. */
+    protectedByKeepMarker: boolean;
+}
+export declare function parseRuleSections(source: string): RuleSection[];