@isaacriehm/cairn-core 0.1.0

package/dist/init/walker.js.map

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

package/dist/init/workflow-block.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Mutate the `<slug>:` extension block inside `.cairn/config/workflow.md`.
+ *
+ * The init mapper proposes per-project globs that have to land in TWO places:
+ *   1. `.cairn/config.yaml` — the project overlay (built by `init.ts` directly)
+ *   2. `.cairn/config/workflow.md` — the `<slug>:` block in YAML frontmatter
+ *
+ * (2) is shipped as a template with placeholder values (pilot_module: ALL,
+ * empty arrays). After seed substitutes `<project_name>:` → `<slug>:`, this
+ * module patches the slug block with the mapper's outputs while preserving
+ * the rest of the frontmatter (comments, key order, sibling keys) and the
+ * markdown body below the closing `---`.
+ *
+ * Round-trip uses `yaml`'s `parseDocument` API so comments outside the slug
+ * block survive. Comments inside the slug block are dropped on the keys we
+ * mutate; that's acceptable because the placeholder block is comment-light.
+ */
+export interface WorkflowSlugBlockUpdate {
+    pilot_module?: string;
+    route_handler_globs?: string[];
+    dto_globs?: string[];
+    generator_source_globs?: string[];
+    high_stakes_globs?: string[];
+    off_limits_append?: string[];
+}
+export interface UpdateResult {
+    applied_keys: string[];
+    off_limits_added: string[];
+}
+export declare function updateWorkflowSlugBlock(args: {
+    workflowMdPath: string;
+    slug: string;
+    update: WorkflowSlugBlockUpdate;
+}): UpdateResult;

package/dist/init/workflow-block.js

@@ -0,0 +1,110 @@
+/**
+ * Mutate the `<slug>:` extension block inside `.cairn/config/workflow.md`.
+ *
+ * The init mapper proposes per-project globs that have to land in TWO places:
+ *   1. `.cairn/config.yaml` — the project overlay (built by `init.ts` directly)
+ *   2. `.cairn/config/workflow.md` — the `<slug>:` block in YAML frontmatter
+ *
+ * (2) is shipped as a template with placeholder values (pilot_module: ALL,
+ * empty arrays). After seed substitutes `<project_name>:` → `<slug>:`, this
+ * module patches the slug block with the mapper's outputs while preserving
+ * the rest of the frontmatter (comments, key order, sibling keys) and the
+ * markdown body below the closing `---`.
+ *
+ * Round-trip uses `yaml`'s `parseDocument` API so comments outside the slug
+ * block survive. Comments inside the slug block are dropped on the keys we
+ * mutate; that's acceptable because the placeholder block is comment-light.
+ */
+import { readFileSync, writeFileSync } from "node:fs";
+import { isMap, isSeq, parseDocument, Scalar, YAMLMap, YAMLSeq, } from "yaml";
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---/;
+export function updateWorkflowSlugBlock(args) {
+    const text = readFileSync(args.workflowMdPath, "utf8");
+    const fmMatch = FRONTMATTER_RE.exec(text);
+    if (fmMatch === null || fmMatch[1] === undefined) {
+        throw new Error(`workflow.md missing YAML frontmatter at ${args.workflowMdPath}`);
+    }
+    const frontmatter = fmMatch[1];
+    const body = text.slice(fmMatch[0].length);
+    const doc = parseDocument(frontmatter);
+    const docRoot = doc.contents;
+    if (!isMap(docRoot)) {
+        throw new Error(`workflow.md frontmatter is not a YAML map at ${args.workflowMdPath}`);
+    }
+    // Drop the ParsedNode narrowing; the rest of this fn writes plain values.
+    const rootMap = docRoot;
+    const existingBlock = rootMap.get(args.slug, true);
+    let slugBlock;
+    if (isMap(existingBlock)) {
+        slugBlock = existingBlock;
+    }
+    else {
+        slugBlock = new YAMLMap();
+        rootMap.set(args.slug, slugBlock);
+    }
+    const applied = [];
+    const u = args.update;
+    if (u.pilot_module !== undefined) {
+        slugBlock.set("pilot_module", u.pilot_module);
+        applied.push("pilot_module");
+    }
+    if (u.route_handler_globs !== undefined) {
+        slugBlock.set("route_handler_globs", doc.createNode(u.route_handler_globs));
+        applied.push("route_handler_globs");
+    }
+    if (u.dto_globs !== undefined) {
+        slugBlock.set("dto_globs", doc.createNode(u.dto_globs));
+        applied.push("dto_globs");
+    }
+    if (u.generator_source_globs !== undefined) {
+        slugBlock.set("generator_source_globs", doc.createNode(u.generator_source_globs));
+        applied.push("generator_source_globs");
+    }
+    if (u.high_stakes_globs !== undefined) {
+        slugBlock.set("high_stakes_globs", doc.createNode(u.high_stakes_globs));
+        applied.push("high_stakes_globs");
+    }
+    const offLimitsAdded = [];
+    if (u.off_limits_append !== undefined && u.off_limits_append.length > 0) {
+        const existingOffLimits = slugBlock.get("off_limits", true);
+        let seq;
+        if (isSeq(existingOffLimits)) {
+            seq = existingOffLimits;
+        }
+        else {
+            seq = new YAMLSeq();
+            slugBlock.set("off_limits", seq);
+        }
+        const existingValues = new Set();
+        for (const item of seq.items) {
+            const value = scalarValue(item);
+            if (typeof value === "string")
+                existingValues.add(value);
+        }
+        for (const candidate of u.off_limits_append) {
+            if (!existingValues.has(candidate)) {
+                seq.add(candidate);
+                existingValues.add(candidate);
+                offLimitsAdded.push(candidate);
+            }
+        }
+        if (offLimitsAdded.length > 0)
+            applied.push("off_limits");
+    }
+    const out = `---\n${stringifyDoc(doc)}---${body}`;
+    writeFileSync(args.workflowMdPath, out, "utf8");
+    return { applied_keys: applied, off_limits_added: offLimitsAdded };
+}
+function scalarValue(item) {
+    if (item instanceof Scalar)
+        return item.value;
+    if (typeof item === "string" || typeof item === "number" || typeof item === "boolean") {
+        return item;
+    }
+    return undefined;
+}
+function stringifyDoc(doc) {
+    const out = doc.toString({ lineWidth: 0 });
+    return out.endsWith("\n") ? out : `${out}\n`;
+}
+//# sourceMappingURL=workflow-block.js.map

package/dist/init/workflow-block.js.map

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

package/dist/join/index.d.ts

@@ -0,0 +1,67 @@
+/**
+ * `cairn join` — per-clone bootstrap.
+ *
+ * Spec: PLUGIN_ARCHITECTURE §17 Layer 2.
+ *
+ * Idempotent. Safe to re-run on every install (the package.json `prepare`
+ * script runs it on every `npm install` / `pnpm install`).
+ *
+ * Steps:
+ *   1. Locate the cairn-adopted repo root (walk up from cwd for `.cairn/`).
+ *   2. Verify the local CLI's version against `.cairn/config.yaml`'s
+ *      `cairn_version`. Strict-equal for now (no semver spread); a mismatch
+ *      returns kind="version-mismatch" without blocking — caller decides.
+ *   3. `git config core.hooksPath .cairn/git-hooks` (per-clone activation).
+ *   4. chmod +x the three git hooks (best-effort; FS may not support).
+ *   5. Ensure `.cairn/sessions/` exists (per-clone session-state dir).
+ *
+ * Returns a structured result so the CLI / plugin can render exactly what
+ * happened. Never throws on recoverable issues — every step has a status.
+ */
+export type JoinStepStatus = "ok" | "skipped" | "error" | "warn";
+export interface JoinStep {
+    step: string;
+    status: JoinStepStatus;
+    detail: string;
+}
+export interface JoinResult {
+    /** Repo root we acted on, or null when none was found. */
+    repoRoot: string | null;
+    /** True iff every step is "ok" or "skipped". */
+    bootstrapped: boolean;
+    steps: JoinStep[];
+    /** Convenience: from `.cairn/config.yaml`'s cairn_version. */
+    projectCairnVersion: string | null;
+    /** Convenience: this CLI's VERSION. */
+    cliVersion: string;
+}
+export interface RunJoinArgs {
+    /** Override starting directory; default = process.cwd(). */
+    cwd?: string;
+    /** Explicit repo root — skips the upward walk. */
+    repoRoot?: string;
+    /** When true, no filesystem / git side-effects (still reports detection). */
+    dryRun?: boolean;
+    /**
+     * When true, exits with a non-zero status if a recoverable warning fires
+     * (e.g. version mismatch). Default false: print + continue.
+     */
+    strict?: boolean;
+}
+export declare function runJoin(args?: RunJoinArgs): JoinResult;
+export interface InspectJoinStateArgs {
+    repoRoot: string;
+}
+export interface JoinState {
+    /** True when `git config core.hooksPath` reports `.cairn/git-hooks`. */
+    hooksPathSet: boolean;
+    /** Raw value reported by git, or null when git failed / unset. */
+    hooksPathValue: string | null;
+    /** From `.cairn/config.yaml` — null if absent / unreadable. */
+    projectCairnVersion: string | null;
+    /** True when projectCairnVersion === current CLI VERSION. */
+    versionMatches: boolean;
+    /** True when sessions dir exists. */
+    sessionsDirReady: boolean;
+}
+export declare function inspectJoinState(args: InspectJoinStateArgs): JoinState;

package/dist/join/index.js

@@ -0,0 +1,256 @@
+/**
+ * `cairn join` — per-clone bootstrap.
+ *
+ * Spec: PLUGIN_ARCHITECTURE §17 Layer 2.
+ *
+ * Idempotent. Safe to re-run on every install (the package.json `prepare`
+ * script runs it on every `npm install` / `pnpm install`).
+ *
+ * Steps:
+ *   1. Locate the cairn-adopted repo root (walk up from cwd for `.cairn/`).
+ *   2. Verify the local CLI's version against `.cairn/config.yaml`'s
+ *      `cairn_version`. Strict-equal for now (no semver spread); a mismatch
+ *      returns kind="version-mismatch" without blocking — caller decides.
+ *   3. `git config core.hooksPath .cairn/git-hooks` (per-clone activation).
+ *   4. chmod +x the three git hooks (best-effort; FS may not support).
+ *   5. Ensure `.cairn/sessions/` exists (per-clone session-state dir).
+ *
+ * Returns a structured result so the CLI / plugin can render exactly what
+ * happened. Never throws on recoverable issues — every step has a status.
+ */
+import { execFileSync } from "node:child_process";
+import { chmodSync, existsSync, mkdirSync, readFileSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { VERSION } from "../index.js";
+import { logger } from "../logger.js";
+const log = logger("join");
+const HOOK_FILES = ["pre-commit", "post-commit", "commit-msg"];
+export function runJoin(args = {}) {
+    const cwd = args.cwd ?? process.cwd();
+    const steps = [];
+    const repoRoot = args.repoRoot ?? findCairnRoot(cwd);
+    if (repoRoot === null) {
+        steps.push({
+            step: "locate-repo",
+            status: "error",
+            detail: "no .cairn/ found from cwd upward — run `cairn init` first or cd into a cairn-adopted project",
+        });
+        return {
+            repoRoot: null,
+            bootstrapped: false,
+            steps,
+            projectCairnVersion: null,
+            cliVersion: VERSION,
+        };
+    }
+    steps.push({
+        step: "locate-repo",
+        status: "ok",
+        detail: repoRoot,
+    });
+    const projectVersion = readProjectVersion(repoRoot);
+    if (projectVersion === null) {
+        steps.push({
+            step: "version-check",
+            status: "skipped",
+            detail: ".cairn/config.yaml missing cairn_version (legacy adoption?)",
+        });
+    }
+    else if (projectVersion !== VERSION) {
+        steps.push({
+            step: "version-check",
+            status: "warn",
+            detail: `project pinned to ${projectVersion}; this CLI is ${VERSION} — upgrade with \`npm install -g @isaacriehm/cairn@${projectVersion}\``,
+        });
+    }
+    else {
+        steps.push({
+            step: "version-check",
+            status: "ok",
+            detail: `cairn_version=${projectVersion}`,
+        });
+    }
+    if (args.dryRun === true) {
+        steps.push({
+            step: "dry-run",
+            status: "ok",
+            detail: "dry-run set — no filesystem or git side-effects performed",
+        });
+        return {
+            repoRoot,
+            bootstrapped: true,
+            steps,
+            projectCairnVersion: projectVersion,
+            cliVersion: VERSION,
+        };
+    }
+    const hooksDir = join(repoRoot, ".cairn", "git-hooks");
+    if (!existsSync(hooksDir)) {
+        steps.push({
+            step: "set-hooks-path",
+            status: "error",
+            detail: `${hooksDir} missing — run \`cairn init\` to seed hooks first`,
+        });
+        return {
+            repoRoot,
+            bootstrapped: false,
+            steps,
+            projectCairnVersion: projectVersion,
+            cliVersion: VERSION,
+        };
+    }
+    const setHooks = setGitHooksPath(repoRoot);
+    steps.push(setHooks);
+    const chmodStep = chmodHooks(hooksDir);
+    steps.push(chmodStep);
+    const sessionStep = ensureSessionDir(repoRoot);
+    steps.push(sessionStep);
+    const bootstrapped = steps.every((s) => s.status === "ok" || s.status === "skipped");
+    return {
+        repoRoot,
+        bootstrapped,
+        steps,
+        projectCairnVersion: projectVersion,
+        cliVersion: VERSION,
+    };
+}
+/* -------------------------------------------------------------------------- */
+/* Step helpers                                                               */
+/* -------------------------------------------------------------------------- */
+function findCairnRoot(start) {
+    let cur = resolve(start);
+    for (let i = 0; i < 80; i++) {
+        if (existsSync(join(cur, ".cairn")))
+            return cur;
+        const parent = dirname(cur);
+        if (parent === cur)
+            return null;
+        cur = parent;
+    }
+    return null;
+}
+function readProjectVersion(repoRoot) {
+    const path = join(repoRoot, ".cairn", "config.yaml");
+    if (!existsSync(path))
+        return null;
+    try {
+        const parsed = parseYaml(readFileSync(path, "utf8"));
+        const v = parsed?.["cairn_version"];
+        return typeof v === "string" ? v : null;
+    }
+    catch (err) {
+        log.warn({ err: err instanceof Error ? err.message : String(err) }, "config.yaml unreadable");
+        return null;
+    }
+}
+function setGitHooksPath(repoRoot) {
+    if (!existsSync(join(repoRoot, ".git"))) {
+        return {
+            step: "set-hooks-path",
+            status: "warn",
+            detail: "no .git/ at repoRoot — skipping git config (initialize git first?)",
+        };
+    }
+    try {
+        execFileSync("git", ["config", "core.hooksPath", ".cairn/git-hooks"], {
+            cwd: repoRoot,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        return {
+            step: "set-hooks-path",
+            status: "ok",
+            detail: "core.hooksPath = .cairn/git-hooks",
+        };
+    }
+    catch (err) {
+        return {
+            step: "set-hooks-path",
+            status: "error",
+            detail: `git config failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+function chmodHooks(hooksDir) {
+    let okCount = 0;
+    const failed = [];
+    for (const name of HOOK_FILES) {
+        const abs = join(hooksDir, name);
+        if (!existsSync(abs))
+            continue;
+        try {
+            chmodSync(abs, 0o755);
+            okCount += 1;
+        }
+        catch (err) {
+            failed.push(`${name} (${err instanceof Error ? err.message : String(err)})`);
+        }
+    }
+    if (failed.length > 0) {
+        return {
+            step: "chmod-hooks",
+            status: "warn",
+            detail: `chmod failed for: ${failed.join(", ")} — git may still execute via index mode`,
+        };
+    }
+    return {
+        step: "chmod-hooks",
+        status: "ok",
+        detail: `${okCount} hook${okCount === 1 ? "" : "s"} marked executable`,
+    };
+}
+function ensureSessionDir(repoRoot) {
+    const dir = join(repoRoot, ".cairn", "sessions");
+    try {
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+            return { step: "ensure-sessions-dir", status: "ok", detail: `created ${dir}` };
+        }
+        const st = statSync(dir);
+        if (!st.isDirectory()) {
+            return {
+                step: "ensure-sessions-dir",
+                status: "error",
+                detail: `${dir} exists but is not a directory`,
+            };
+        }
+        return { step: "ensure-sessions-dir", status: "skipped", detail: "exists" };
+    }
+    catch (err) {
+        return {
+            step: "ensure-sessions-dir",
+            status: "error",
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+export function inspectJoinState(args) {
+    const repoRoot = args.repoRoot;
+    const hooksPathValue = readGitConfigValue(repoRoot, "core.hooksPath");
+    const projectCairnVersion = readProjectVersion(repoRoot);
+    return {
+        hooksPathSet: hooksPathValue === ".cairn/git-hooks",
+        hooksPathValue,
+        projectCairnVersion,
+        versionMatches: projectCairnVersion === VERSION,
+        sessionsDirReady: existsSync(join(repoRoot, ".cairn", "sessions")),
+    };
+}
+function readGitConfigValue(repoRoot, key) {
+    if (!existsSync(join(repoRoot, ".git")))
+        return null;
+    try {
+        const out = execFileSync("git", ["config", "--get", key], {
+            cwd: repoRoot,
+            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/join/index.js.map

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

package/dist/lock.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Per-write filesystem lock for `.cairn/` global state.
+ *
+ * Per docs/PLUGIN_ARCHITECTURE.md §7 (Concurrency): every write to global
+ * state (`.cairn/ground/`, `.cairn/baseline/`, `.cairn/inbox/`) is
+ * serialized through `.cairn/.write-lock` so concurrent Claude Code
+ * sessions don't race. Reads are unlocked. Whole-operation locks
+ * (`.gc-lock`, `.audit-lock`) are separate — see acquireOperationLock.
+ *
+ * Design:
+ *   - `wx` (O_CREAT | O_EXCL) atomic-create on the lock file. PID written
+ *     inside so stale-holder detection can recover from crashes.
+ *   - Stale-lock recovery: if the holder PID is gone, claim the lock.
+ *   - Polling backoff with deadline. Brief contention; long waits indicate
+ *     deadlock and surface as timeout errors.
+ */
+export interface WithLockOptions {
+    /** Hard deadline. Default 30000ms. */
+    timeoutMs?: number;
+    /** Poll interval while waiting. Default 50ms. */
+    pollMs?: number;
+}
+/**
+ * Acquire `.cairn/.write-lock` for the lifetime of `fn`. Releases on
+ * success or error. Stale locks (holder PID is dead) are reclaimed.
+ */
+export declare function withWriteLock<T>(repoRoot: string, fn: () => Promise<T> | T, opts?: WithLockOptions): Promise<T>;
+/**
+ * Acquire a named operation lock (e.g. `.gc-lock`, `.audit-lock`) for the
+ * lifetime of `fn`. If the lock is held, this throws immediately rather
+ * than waiting — callers (sweep, audit) use this to bail with "another
+ * operation in progress".
+ */
+export declare function acquireOperationLock<T>(repoRoot: string, lockName: string, fn: () => Promise<T> | T): Promise<T>;
+export declare class OperationLockHeldError extends Error {
+    readonly lockName: string;
+    readonly holderPid: number | null;
+    constructor(lockName: string, holderPid: number | null);
+}