@isaacriehm/cairn-core 0.1.0

package/dist/init/rules-merge/parse-sections.js

@@ -0,0 +1,71 @@
+/**
+ * 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.
+ */
+import { extractKeepBlocks } from "./keep-markers.js";
+export function parseRuleSections(source) {
+    const keepBlocks = extractKeepBlocks(source);
+    const sections = [];
+    const lines = source.split("\n");
+    let cursor = 0;
+    let i = 0;
+    let currentStart = 0;
+    let currentLevel = 0;
+    let currentTitle = "";
+    let buffer = [];
+    const flush = (endCursor) => {
+        if (buffer.length === 0 && currentLevel === 0)
+            return;
+        const body = buffer.join("\n");
+        if (body.trim().length === 0)
+            return;
+        sections.push({
+            level: currentLevel,
+            title: currentTitle,
+            body,
+            startOffset: currentStart,
+            protectedByKeepMarker: rangeOverlapsKeep(currentStart, endCursor, keepBlocks),
+        });
+    };
+    for (; i < lines.length; i++) {
+        const line = lines[i] ?? "";
+        const lineLen = line.length + 1; // +1 for trailing \n
+        const heading = parseHeading(line);
+        if (heading !== null && (heading.level === 2 || heading.level === 3)) {
+            flush(cursor);
+            currentStart = cursor;
+            currentLevel = heading.level;
+            currentTitle = heading.title;
+            buffer = [line];
+        }
+        else {
+            buffer.push(line);
+        }
+        cursor += lineLen;
+    }
+    flush(cursor);
+    return sections;
+}
+function parseHeading(line) {
+    const match = /^(#{1,6})\s+(.+?)\s*#*\s*$/.exec(line);
+    if (!match)
+        return null;
+    const hashes = match[1] ?? "";
+    const title = match[2] ?? "";
+    return { level: hashes.length, title };
+}
+function rangeOverlapsKeep(startOffset, endOffset, keepBlocks) {
+    for (const k of keepBlocks) {
+        if (startOffset < k.endOffset && endOffset > k.startOffset)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=parse-sections.js.map

package/dist/init/rules-merge/parse-sections.js.map

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

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

@@ -0,0 +1,33 @@
+/**
+ * Phase 7c — regenerate CLAUDE.md and AGENTS.md from ground state.
+ *
+ * Per spec §6 Phase 7c: "post-adoption: cairn regenerates CLAUDE.md and
+ * AGENTS.md from ground state on each `cairn sweep`; operator-written
+ * sections preserved between `<!-- cairn:keep-start -->` and
+ * `<!-- cairn:keep-end -->` markers".
+ *
+ * This module owns the template rendering primitive. The sweep CLI (or skill
+ * driving it) calls `regenerateRulesFiles({ repoRoot })` and writes the
+ * returned content to disk under the per-write flock.
+ */
+import type { DecisionLedgerEntry, InvariantLedgerEntry } from "../../ground/schemas.js";
+export interface RegenerateRulesArgs {
+    repoRoot: string;
+    /** Optional brand name; when present, used in the CLAUDE.md heading. */
+    brandName?: string;
+    /** Optional 1-line positioning summary. */
+    positioning?: string;
+    /** Override `Date.now()` for deterministic output (smokes). */
+    nowIso?: string;
+}
+export interface RegenerateRulesResult {
+    claudeMdPath: string;
+    agentsMdPath: string;
+    claudeMdContent: string;
+    agentsMdContent: string;
+    decisions: DecisionLedgerEntry[];
+    invariants: InvariantLedgerEntry[];
+    keepBlocksClaudeMd: number;
+    keepBlocksAgentsMd: number;
+}
+export declare function regenerateRulesFiles(args: RegenerateRulesArgs): RegenerateRulesResult;

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

@@ -0,0 +1,163 @@
+/**
+ * Phase 7c — regenerate CLAUDE.md and AGENTS.md from ground state.
+ *
+ * Per spec §6 Phase 7c: "post-adoption: cairn regenerates CLAUDE.md and
+ * AGENTS.md from ground state on each `cairn sweep`; operator-written
+ * sections preserved between `<!-- cairn:keep-start -->` and
+ * `<!-- cairn:keep-end -->` markers".
+ *
+ * This module owns the template rendering primitive. The sweep CLI (or skill
+ * driving it) calls `regenerateRulesFiles({ repoRoot })` and writes the
+ * returned content to disk under the per-write flock.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { buildDecisionsLedger, buildInvariantsLedger, } from "../../ground/ledgers.js";
+import { extractKeepBlocks, reapplyKeepBlocks } from "./keep-markers.js";
+export function regenerateRulesFiles(args) {
+    const repoRoot = args.repoRoot;
+    const decisions = buildDecisionsLedger({ repoRoot });
+    const invariants = buildInvariantsLedger({ repoRoot });
+    const generatedAt = args.nowIso ?? new Date().toISOString();
+    const claudeMdPath = join(repoRoot, "CLAUDE.md");
+    const agentsMdPath = join(repoRoot, "AGENTS.md");
+    const existingClaudeMd = readIfExists(claudeMdPath);
+    const existingAgentsMd = readIfExists(agentsMdPath);
+    const keepClaudeMd = existingClaudeMd !== null ? extractKeepBlocks(existingClaudeMd) : [];
+    const keepAgentsMd = existingAgentsMd !== null ? extractKeepBlocks(existingAgentsMd) : [];
+    const claudeBody = renderClaudeMd({
+        brandName: args.brandName,
+        positioning: args.positioning,
+        decisions,
+        invariants,
+        keepCount: keepClaudeMd.length,
+        generatedAt,
+    });
+    const agentsBody = renderAgentsMd({
+        brandName: args.brandName,
+        decisions,
+        invariants,
+        keepCount: keepAgentsMd.length,
+        generatedAt,
+    });
+    const claudeFinal = reapplyKeepBlocks(claudeBody, keepClaudeMd);
+    const agentsFinal = reapplyKeepBlocks(agentsBody, keepAgentsMd);
+    return {
+        claudeMdPath,
+        agentsMdPath,
+        claudeMdContent: claudeFinal,
+        agentsMdContent: agentsFinal,
+        decisions,
+        invariants,
+        keepBlocksClaudeMd: keepClaudeMd.length,
+        keepBlocksAgentsMd: keepAgentsMd.length,
+    };
+}
+function renderClaudeMd(a) {
+    const lines = [];
+    const heading = a.brandName !== undefined ? `# ${a.brandName} — Project Rules` : "# Project Rules";
+    lines.push(heading);
+    lines.push("");
+    lines.push("<!--");
+    lines.push("  This file is regenerated from .cairn/ground/ on each sweep.");
+    lines.push(`  Generated at: ${a.generatedAt}.`);
+    lines.push("  Operator content lives between <!-- cairn:keep-start --> markers.");
+    lines.push("-->");
+    lines.push("");
+    if (a.positioning !== undefined && a.positioning.length > 0) {
+        lines.push(`> ${a.positioning}`);
+        lines.push("");
+    }
+    lines.push("## Authoritative state");
+    lines.push("");
+    lines.push("- Decisions ledger: `.cairn/ground/decisions/decisions.ledger.yaml`");
+    lines.push("- Invariants ledger: `.cairn/ground/invariants/invariants.ledger.yaml`");
+    lines.push("- Brand + voice: `.cairn/ground/brand/`");
+    lines.push("- Canonical map: `.cairn/ground/canonical-map/topics.yaml`");
+    lines.push("");
+    lines.push("Agents query the cairn MCP surface, not these files directly.");
+    lines.push("");
+    lines.push("## Active decisions");
+    lines.push("");
+    if (a.decisions.length === 0) {
+        lines.push("_(none yet — run `/cairn-direction` to capture one)_");
+    }
+    else {
+        for (const d of a.decisions) {
+            lines.push(`- **${d.id}** — ${escapeMd(d.title)}`);
+        }
+    }
+    lines.push("");
+    lines.push("## Active invariants");
+    lines.push("");
+    if (a.invariants.length === 0) {
+        lines.push("_(none yet)_");
+    }
+    else {
+        for (const v of a.invariants) {
+            lines.push(`- **${v.id}** — ${escapeMd(v.title)}`);
+        }
+    }
+    lines.push("");
+    lines.push("## Operator sections");
+    lines.push("");
+    for (let i = 0; i < a.keepCount; i++) {
+        lines.push(`<!-- cairn:keep-anchor:${i} -->`);
+        lines.push("");
+    }
+    if (a.keepCount === 0) {
+        lines.push("_(no operator-preserved sections — wrap content in `<!-- cairn:keep-start --> … <!-- cairn:keep-end -->` to preserve)_");
+        lines.push("");
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+function renderAgentsMd(a) {
+    const lines = [];
+    const heading = a.brandName !== undefined ? `# ${a.brandName} — Agent TOC` : "# Agent TOC";
+    lines.push(heading);
+    lines.push("");
+    lines.push("<!--");
+    lines.push("  Regenerated from .cairn/ground/ on each sweep.");
+    lines.push(`  Generated at: ${a.generatedAt}.`);
+    lines.push("-->");
+    lines.push("");
+    lines.push("## Locations");
+    lines.push("");
+    lines.push("| What | Where |");
+    lines.push("|------|-------|");
+    lines.push("| Decisions | `.cairn/ground/decisions/` |");
+    lines.push("| Invariants | `.cairn/ground/invariants/` |");
+    lines.push("| Brand | `.cairn/ground/brand/` |");
+    lines.push("| Canonical-map | `.cairn/ground/canonical-map/` |");
+    lines.push("| Tasks (active) | `.cairn/tasks/active/` |");
+    lines.push("");
+    lines.push(`Currently: ${a.decisions.length} active decision${a.decisions.length === 1 ? "" : "s"}, ` +
+        `${a.invariants.length} active invariant${a.invariants.length === 1 ? "" : "s"}.`);
+    lines.push("");
+    lines.push("## Operator sections");
+    lines.push("");
+    for (let i = 0; i < a.keepCount; i++) {
+        lines.push(`<!-- cairn:keep-anchor:${i} -->`);
+        lines.push("");
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+/* -------------------------------------------------------------------------- */
+/* Helpers                                                                    */
+/* -------------------------------------------------------------------------- */
+function readIfExists(p) {
+    if (!existsSync(p))
+        return null;
+    try {
+        return readFileSync(p, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+function escapeMd(s) {
+    return s.replace(/\|/g, "\\|").trim();
+}
+//# sourceMappingURL=regenerate.js.map

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

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

package/dist/init/secrets.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Secrets file — `~/.local/harness/.env`.
+ *
+ * Operator-scoped (not project-scoped) so a single Discord bot powers
+ * every adopted project. Init writes here; the CLI's dotenv loader reads
+ * here first.
+ *
+ * Format = standard dotenv (KEY=VALUE per line, # comments). Existing
+ * keys are preserved on append; only the named keys get rewritten.
+ */
+export declare function harnessEnvPath(): string;
+export declare function readHarnessEnv(): Record<string, string>;
+/**
+ * Merge `updates` into the on-disk env file, preserving every other key
+ * + comments + ordering of unchanged lines. Created with mode 0600 since
+ * it carries secrets.
+ */
+export declare function upsertHarnessEnv(updates: Record<string, string>): string;

package/dist/init/secrets.js

@@ -0,0 +1,76 @@
+/**
+ * Secrets file — `~/.local/harness/.env`.
+ *
+ * Operator-scoped (not project-scoped) so a single Discord bot powers
+ * every adopted project. Init writes here; the CLI's dotenv loader reads
+ * here first.
+ *
+ * Format = standard dotenv (KEY=VALUE per line, # comments). Existing
+ * keys are preserved on append; only the named keys get rewritten.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export function harnessEnvPath() {
+    return join(homedir(), ".local", "harness", ".env");
+}
+export function readHarnessEnv() {
+    const p = harnessEnvPath();
+    if (!existsSync(p))
+        return {};
+    const raw = readFileSync(p, "utf8");
+    return parseDotenv(raw);
+}
+/**
+ * Merge `updates` into the on-disk env file, preserving every other key
+ * + comments + ordering of unchanged lines. Created with mode 0600 since
+ * it carries secrets.
+ */
+export function upsertHarnessEnv(updates) {
+    const p = harnessEnvPath();
+    mkdirSync(dirname(p), { recursive: true });
+    const existing = existsSync(p) ? readFileSync(p, "utf8") : "";
+    const lines = existing.length === 0 ? [] : existing.split(/\r?\n/);
+    const seen = new Set();
+    const out = [];
+    for (const line of lines) {
+        const m = line.match(/^([A-Z_][A-Z0-9_]*)=/);
+        if (m && m[1] !== undefined && updates[m[1]] !== undefined) {
+            out.push(`${m[1]}=${updates[m[1]]}`);
+            seen.add(m[1]);
+        }
+        else {
+            out.push(line);
+        }
+    }
+    for (const [k, v] of Object.entries(updates)) {
+        if (!seen.has(k))
+            out.push(`${k}=${v}`);
+    }
+    while (out.length > 0 && out[out.length - 1] === "")
+        out.pop();
+    const text = out.join("\n") + "\n";
+    writeFileSync(p, text, { encoding: "utf8", mode: 0o600 });
+    return p;
+}
+function parseDotenv(text) {
+    const out = {};
+    for (const line of text.split(/\r?\n/)) {
+        if (line.length === 0 || line.startsWith("#"))
+            continue;
+        const eq = line.indexOf("=");
+        if (eq <= 0)
+            continue;
+        const key = line.slice(0, eq).trim();
+        let value = line.slice(eq + 1).trim();
+        // Strip wrapping quotes — match dotenv behavior.
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        if (/^[A-Z_][A-Z0-9_]*$/.test(key))
+            out[key] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=secrets.js.map

package/dist/init/secrets.js.map

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

package/dist/init/seed.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Seed an adopted project's .cairn/ + .archive/ from cairn/templates/.
+ *
+ * Walks the templates dir, copies every file to the target preserving
+ * directory layout. Files where the `<project_name>` YAML key needs
+ * substitution are passed through `applyPlaceholders`. Existing files
+ * collide-fail unless `force: true`.
+ */
+export interface SeedOptions {
+    repoRoot: string;
+    projectSlug: string;
+    /** Allow overwriting existing files. Default false (collide-fail). */
+    force?: boolean;
+}
+export interface SeedResult {
+    written_files: string[];
+    collisions: string[];
+}
+export declare function seedCairnLayout(opts: SeedOptions): SeedResult;
+/** Exposed for the smoke test — locate the templates root from runtime. */
+export declare function templatesRoot(): string;

package/dist/init/seed.js

@@ -0,0 +1,96 @@
+/**
+ * Seed an adopted project's .cairn/ + .archive/ from cairn/templates/.
+ *
+ * Walks the templates dir, copies every file to the target preserving
+ * directory layout. Files where the `<project_name>` YAML key needs
+ * substitution are passed through `applyPlaceholders`. Existing files
+ * collide-fail unless `force: true`.
+ */
+import { chmodSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync, } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+const HERE = dirname(fileURLToPath(import.meta.url));
+/** dist/init/seed.js → walk up to package root, then into templates/. */
+const TEMPLATES_ROOT = join(HERE, "..", "..", "templates");
+export function seedCairnLayout(opts) {
+    const written = [];
+    const collisions = [];
+    walk(TEMPLATES_ROOT, (absSrc) => {
+        const rel = relative(TEMPLATES_ROOT, absSrc);
+        const absDst = join(opts.repoRoot, rel);
+        if (existsSync(absDst) && opts.force !== true) {
+            collisions.push(rel);
+            return;
+        }
+        mkdirSync(dirname(absDst), { recursive: true });
+        const raw = readFileSync(absSrc, "utf8");
+        const out = applyPlaceholders({ content: raw, projectSlug: opts.projectSlug, relPath: rel });
+        writeFileSync(absDst, out, "utf8");
+        if (isExecutableTemplate(rel)) {
+            try {
+                chmodSync(absDst, 0o755);
+            }
+            catch {
+                // Filesystems that don't support chmod (e.g. some Windows volumes)
+                // — git itself will set the executable bit on tracked content via
+                // the index, and `cairn join` re-chmods on bootstrap.
+            }
+        }
+        written.push(rel);
+    });
+    return { written_files: written, collisions };
+}
+/**
+ * Substitute the `<project_name>` placeholder in shipped templates.
+ * Only `.cairn/config/workflow.md` and `.cairn/config/sensors.yaml`
+ * carry it today; the function is broad enough to safely no-op on other
+ * files.
+ *
+ * Two replacement targets:
+ *   1. `<project_name>:` YAML key → `<slug>:` (the per-project extension block)
+ *   2. Inline mentions in comments, e.g. ``<project_name>:` extension block``
+ *
+ * The Liquid-style `{{project_name}}` placeholders inside the agent
+ * prompt body are NOT touched here — those resolve at run time when the
+ * orchestrator renders the prompt.
+ */
+function applyPlaceholders(args) {
+    // Only mutate workflow.md / sensors.yaml; other files pass through.
+    const norm = args.relPath.split("\\").join("/");
+    if (norm !== ".cairn/config/workflow.md" &&
+        norm !== ".cairn/config/sensors.yaml") {
+        return args.content;
+    }
+    return args.content
+        .replace(/<project_name>:/g, `${args.projectSlug}:`)
+        .replace(/`<project_name>`/g, `\`${args.projectSlug}\``)
+        .replace(/<project_name>/g, args.projectSlug);
+}
+function walk(dir, onFile) {
+    for (const name of readdirSync(dir)) {
+        const abs = join(dir, name);
+        const s = statSync(abs);
+        if (s.isDirectory()) {
+            walk(abs, onFile);
+        }
+        else if (s.isFile()) {
+            onFile(abs);
+        }
+    }
+}
+/** Exposed for the smoke test — locate the templates root from runtime. */
+export function templatesRoot() {
+    return TEMPLATES_ROOT;
+}
+/**
+ * Templates that must land with 0755 so git hooks fire on commit. Tracked
+ * separately from the placeholder substitution list — the executable bit
+ * is metadata the seed function owns, not file content.
+ */
+function isExecutableTemplate(rel) {
+    const norm = rel.split("\\").join("/");
+    return (norm === ".cairn/git-hooks/pre-commit" ||
+        norm === ".cairn/git-hooks/post-commit" ||
+        norm === ".cairn/git-hooks/commit-msg");
+}
+//# sourceMappingURL=seed.js.map

package/dist/init/seed.js.map

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

package/dist/init/setup-runners.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Spawners for actually executing setup steps from `harness init`.
+ *
+ * Each function inherits stdio so the operator sees curl / pnpm / docker
+ * progress live. Returns success/failure; the caller surfaces the result
+ * in the wizard summary.
+ */
+export interface RunResult {
+    ok: boolean;
+    exit_code: number | null;
+    /** Optional human-readable note (skipped reason / failure summary). */
+    note?: string;
+}
+export declare function downloadWhisperModel(): Promise<RunResult>;
+export declare function runHarnessSetupScript(script: "setup-whisper" | "setup-uat-browsers" | "setup-uat-sql" | "setup-uat-docker", extraArgs?: string[]): Promise<RunResult>;