@isaacriehm/cairn 0.1.0

package/dist/voice/model.d.ts

@@ -0,0 +1,23 @@
+import { Whisper } from "smart-whisper";
+/**
+ * Whisper model spec is locked at L11: large-v3-turbo Q5_0. Hardcoded path
+ * (operator hates env vars; only secrets/brand/domain go in env).
+ *
+ * Operator install:
+ *   brew install whisper-cpp
+ *   curl -L -o ~/.local/harness/models/ggml-large-v3-turbo-q5_0.bin \
+ *     "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo-q5_0.bin?download=true"
+ *
+ * Phase 16 init script automates the curl.
+ */
+export declare const WHISPER_MODEL_FILE = "ggml-large-v3-turbo-q5_0.bin";
+export declare const WHISPER_MODELS_DIR: string;
+export declare const WHISPER_MODEL_PATH: string;
+export declare function whisperModelExists(): boolean;
+/**
+ * Lazy-singleton Whisper. smart-whisper's `offload` parameter offloads the
+ * model from RAM after N idle seconds; loading on next call. Default 60s
+ * keeps the model warm during a burst of voice notes.
+ */
+export declare function getWhisper(): Whisper;
+export declare function freeWhisper(): Promise<void>;

package/dist/voice/model.js

@@ -0,0 +1,46 @@
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { Whisper } from "smart-whisper";
+import { logger } from "../logger.js";
+const log = logger("voice.model");
+/**
+ * Whisper model spec is locked at L11: large-v3-turbo Q5_0. Hardcoded path
+ * (operator hates env vars; only secrets/brand/domain go in env).
+ *
+ * Operator install:
+ *   brew install whisper-cpp
+ *   curl -L -o ~/.local/harness/models/ggml-large-v3-turbo-q5_0.bin \
+ *     "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo-q5_0.bin?download=true"
+ *
+ * Phase 16 init script automates the curl.
+ */
+export const WHISPER_MODEL_FILE = "ggml-large-v3-turbo-q5_0.bin";
+export const WHISPER_MODELS_DIR = join(homedir(), ".local", "harness", "models");
+export const WHISPER_MODEL_PATH = join(WHISPER_MODELS_DIR, WHISPER_MODEL_FILE);
+export function whisperModelExists() {
+    return existsSync(WHISPER_MODEL_PATH);
+}
+let _whisper;
+/**
+ * Lazy-singleton Whisper. smart-whisper's `offload` parameter offloads the
+ * model from RAM after N idle seconds; loading on next call. Default 60s
+ * keeps the model warm during a burst of voice notes.
+ */
+export function getWhisper() {
+    if (_whisper)
+        return _whisper;
+    if (!whisperModelExists()) {
+        throw new Error(`whisper model not found at ${WHISPER_MODEL_PATH} — run \`harness init\` or download manually`);
+    }
+    log.info({ path: WHISPER_MODEL_PATH }, "loading whisper model");
+    _whisper = new Whisper(WHISPER_MODEL_PATH, { gpu: true, offload: 60 });
+    return _whisper;
+}
+export async function freeWhisper() {
+    if (_whisper) {
+        await _whisper.free();
+        _whisper = undefined;
+    }
+}
+//# sourceMappingURL=model.js.map

package/dist/voice/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/voice/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAElC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;AAE/E,MAAM,UAAU,kBAAkB;IAChC,OAAO,UAAU,CAAC,kBAAkB,CAAC,CAAC;AACxC,CAAC;AAED,IAAI,QAA6B,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACxB,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,8BAA8B,kBAAkB,8CAA8C,CAC/F,CAAC;IACJ,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,uBAAuB,CAAC,CAAC;IAChE,QAAQ,GAAG,IAAI,OAAO,CAAC,kBAAkB,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACvE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,QAAQ,GAAG,SAAS,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/voice/pipe.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Pipe arbitrary audio bytes through ffmpeg → 16 kHz mono Float32 PCM.
+ *
+ * Audio bytes flow stdin→stdout; nothing touches disk (L12).
+ *
+ * `ffmpeg` must be on PATH. macOS: `brew install ffmpeg`. Phase 16 init
+ * script verifies and prompts to install.
+ */
+export declare function audioToPcm(audio: Buffer): Promise<Float32Array>;

package/dist/voice/pipe.js

@@ -0,0 +1,47 @@
+import { spawn } from "node:child_process";
+/**
+ * Pipe arbitrary audio bytes through ffmpeg → 16 kHz mono Float32 PCM.
+ *
+ * Audio bytes flow stdin→stdout; nothing touches disk (L12).
+ *
+ * `ffmpeg` must be on PATH. macOS: `brew install ffmpeg`. Phase 16 init
+ * script verifies and prompts to install.
+ */
+export async function audioToPcm(audio) {
+    return new Promise((resolve, reject) => {
+        const ff = spawn("ffmpeg", [
+            "-loglevel",
+            "error",
+            "-i",
+            "pipe:0",
+            "-ar",
+            "16000",
+            "-ac",
+            "1",
+            "-f",
+            "f32le",
+            "pipe:1",
+        ]);
+        const chunks = [];
+        let stderr = "";
+        ff.stdout.on("data", (chunk) => chunks.push(chunk));
+        ff.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        ff.on("error", (err) => reject(err));
+        ff.on("close", (code) => {
+            if (code !== 0) {
+                reject(new Error(`ffmpeg exited ${code}: ${stderr.trim()}`));
+                return;
+            }
+            const concat = Buffer.concat(chunks);
+            // Float32Array requires a 4-byte-aligned ArrayBuffer; copy to ensure.
+            const aligned = new ArrayBuffer(concat.length);
+            new Uint8Array(aligned).set(concat);
+            resolve(new Float32Array(aligned));
+        });
+        ff.stdin.write(audio);
+        ff.stdin.end();
+    });
+}
+//# sourceMappingURL=pipe.js.map

package/dist/voice/pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../../src/voice/pipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAa;IAC5C,OAAO,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnD,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE;YACzB,WAAW;YACX,OAAO;YACP,IAAI;YACJ,QAAQ;YACR,KAAK;YACL,OAAO;YACP,KAAK;YACL,GAAG;YACH,IAAI;YACJ,OAAO;YACP,QAAQ;SACT,CAAC,CAAC;QACH,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5D,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACrC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACtB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC7D,OAAO;YACT,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrC,sEAAsE;YACtE,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/C,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpC,OAAO,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/voice/transcribe.d.ts

@@ -0,0 +1,3 @@
+import type { TranscribeOptions, TranscriptionResult } from "./types.js";
+export declare function transcribeBuffer(audio: Buffer, opts?: TranscribeOptions): Promise<TranscriptionResult>;
+export declare function transcribeUrl(attachmentUrl: string, opts?: TranscribeOptions): Promise<TranscriptionResult>;

package/dist/voice/transcribe.js

@@ -0,0 +1,43 @@
+import { logger } from "../logger.js";
+import { getWhisper } from "./model.js";
+import { audioToPcm } from "./pipe.js";
+const log = logger("voice.transcribe");
+export async function transcribeBuffer(audio, opts = {}) {
+    const startedAt = Date.now();
+    const pcm = await audioToPcm(audio);
+    const language = opts.language ?? "en";
+    const whisper = getWhisper();
+    const task = await whisper.transcribe(pcm, {
+        language,
+        format: "detail",
+        no_timestamps: false,
+        print_progress: false,
+        print_realtime: false,
+        print_special: false,
+        print_timestamps: false,
+        suppress_blank: true,
+        ...(opts.initialPrompt !== undefined ? { initial_prompt: opts.initialPrompt } : {}),
+    });
+    const detailed = await task.result;
+    const segments = detailed.map((d) => ({
+        from: d.from,
+        to: d.to,
+        text: d.text.trim(),
+        confidence: typeof d.confidence === "number" ? d.confidence : 0,
+    }));
+    const text = segments.map((s) => s.text).join(" ").trim();
+    const avgLogprob = segments.length > 0
+        ? segments.reduce((sum, s) => sum + s.confidence, 0) / segments.length
+        : 0;
+    const durationMs = Date.now() - startedAt;
+    log.info({ chars: text.length, segments: segments.length, avgLogprob, durationMs }, "transcribed");
+    return { text, avgLogprob, segments, language, durationMs };
+}
+export async function transcribeUrl(attachmentUrl, opts = {}) {
+    const res = await fetch(attachmentUrl);
+    if (!res.ok)
+        throw new Error(`attachment fetch ${res.status} for ${attachmentUrl}`);
+    const buf = Buffer.from(await res.arrayBuffer());
+    return transcribeBuffer(buf, opts);
+}
+//# sourceMappingURL=transcribe.js.map

package/dist/voice/transcribe.js.map

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

package/dist/voice/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Voice transcription contract.
+ *
+ * Audio NEVER touches disk per L12. Buffers flow:
+ *   discord attachment → fetch → Buffer → ffmpeg pipe → Float32Array (16k mono)
+ *   → smart-whisper → TranscriptionResult.
+ */
+export interface TranscriptionSegment {
+    from: number;
+    to: number;
+    text: string;
+    /** smart-whisper's "confidence" — average per-token probability. */
+    confidence: number;
+}
+export interface TranscriptionResult {
+    text: string;
+    /** Average per-segment confidence. Used as `avg_logprob`-equivalent gate. */
+    avgLogprob: number;
+    segments: TranscriptionSegment[];
+    language: string;
+    durationMs: number;
+}
+export interface TranscribeOptions {
+    language?: string;
+    initialPrompt?: string;
+}

package/dist/voice/types.js

@@ -0,0 +1,9 @@
+/**
+ * Voice transcription contract.
+ *
+ * Audio NEVER touches disk per L12. Buffers flow:
+ *   discord attachment → fetch → Buffer → ffmpeg pipe → Float32Array (16k mono)
+ *   → smart-whisper → TranscriptionResult.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/voice/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/voice/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/watch/daemon.d.ts

@@ -0,0 +1,21 @@
+import { type FSWatcher } from "chokidar";
+import type { Profile } from "../profiles/index.js";
+export interface DaemonOptions {
+    projectName: string;
+    repoRoot: string;
+    /** Debounce milliseconds before triggering regen (default 500). */
+    debounceMs?: number;
+    /** Override profile (default: detected from repo). */
+    profile?: Profile;
+    /** Disable PID file (used by tests). */
+    noPidFile?: boolean;
+}
+export interface DaemonHandle {
+    watcher: FSWatcher;
+    /** Force a regen immediately (ignores debounce). Resolves when complete. */
+    flush: () => Promise<void>;
+    /** Stop the watcher and remove the PID file. */
+    stop: () => Promise<void>;
+}
+export declare function pidFilePath(projectName: string): string;
+export declare function startDaemon(opts: DaemonOptions): Promise<DaemonHandle>;

package/dist/watch/daemon.js

@@ -0,0 +1,143 @@
+import chokidar from "chokidar";
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, relative, resolve } from "node:path";
+import { logger } from "../logger.js";
+import { projectStatePath } from "../mirror/index.js";
+import { selectProfile } from "../profiles/index.js";
+import { regenerateAll } from "./regenerate.js";
+const log = logger("watch.daemon");
+export function pidFilePath(projectName) {
+    return resolve(projectStatePath(projectName), "watch.pid");
+}
+export async function startDaemon(opts) {
+    const { projectName, repoRoot } = opts;
+    const debounceMs = opts.debounceMs ?? 500;
+    const profile = opts.profile ?? selectProfile(repoRoot);
+    if (opts.noPidFile !== true) {
+        writePidFile(projectName);
+    }
+    log.info({ projectName, repoRoot, profile: profile.id, debounceMs }, "daemon starting");
+    // Initial sweep so manifest exists before any change events.
+    await regenerateAll({ repoRoot, profile });
+    const watcher = chokidar.watch(repoRoot, {
+        ignored: (path) => isIgnored(path, repoRoot),
+        ignoreInitial: true,
+        awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 30 },
+    });
+    let pendingChanges = new Set();
+    let timer = null;
+    let inFlight = null;
+    const fire = async () => {
+        timer = null;
+        if (inFlight) {
+            // Coalesce: if a regen is in flight, wait then re-fire if more accumulated.
+            await inFlight;
+            if (pendingChanges.size === 0)
+                return;
+        }
+        const changedFiles = [...pendingChanges];
+        pendingChanges = new Set();
+        inFlight = (async () => {
+            try {
+                await regenerateAll({ repoRoot, profile, changedFiles });
+            }
+            catch (err) {
+                log.error({ err: String(err) }, "regenerate failed");
+            }
+        })();
+        await inFlight;
+        inFlight = null;
+    };
+    const onChange = (path) => {
+        const rel = relative(repoRoot, path).replace(/\\/g, "/");
+        if (rel === "" || rel.startsWith(".."))
+            return;
+        pendingChanges.add(rel);
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            void fire();
+        }, debounceMs);
+    };
+    watcher.on("add", onChange);
+    watcher.on("change", onChange);
+    watcher.on("unlink", onChange);
+    const handle = {
+        watcher,
+        flush: async () => {
+            if (timer) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            await fire();
+        },
+        stop: async () => {
+            if (timer)
+                clearTimeout(timer);
+            await watcher.close();
+            if (opts.noPidFile !== true) {
+                const path = pidFilePath(projectName);
+                if (existsSync(path))
+                    unlinkSync(path);
+            }
+            log.info({ projectName }, "daemon stopped");
+        },
+    };
+    log.info({ projectName, repoRoot }, "daemon ready");
+    return handle;
+}
+function writePidFile(projectName) {
+    const path = pidFilePath(projectName);
+    mkdirSync(dirname(path), { recursive: true });
+    if (existsSync(path)) {
+        const otherPid = Number.parseInt(readFileSync(path, "utf8"), 10);
+        if (Number.isFinite(otherPid) && isProcessAlive(otherPid)) {
+            throw new Error(`harness watch already running for "${projectName}" (pid ${otherPid}). ` +
+                "Stop the other process or remove the stale pid file.");
+        }
+        // Stale — overwrite.
+    }
+    writeFileSync(path, String(process.pid), "utf8");
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isIgnored(path, repoRoot) {
+    const rel = relative(repoRoot, path).replace(/\\/g, "/");
+    if (rel === "")
+        return false;
+    if (rel.startsWith(".."))
+        return true;
+    // Hot-path ignore — keep this list short. Heavier filtering in walk.ts.
+    return (rel === ".git" ||
+        rel.startsWith(".git/") ||
+        rel === "node_modules" ||
+        rel.startsWith("node_modules/") ||
+        rel === ".pnpm-store" ||
+        rel.startsWith(".pnpm-store/") ||
+        rel === "dist" ||
+        rel.startsWith("dist/") ||
+        rel === ".next" ||
+        rel.startsWith(".next/") ||
+        rel === ".turbo" ||
+        rel.startsWith(".turbo/") ||
+        rel === ".harness/runs" ||
+        rel.startsWith(".harness/runs/") ||
+        rel === ".harness/inbox" ||
+        rel.startsWith(".harness/inbox/") ||
+        rel === ".harness/transcripts" ||
+        rel.startsWith(".harness/transcripts/") ||
+        rel === ".harness/staleness/log.jsonl" ||
+        rel === ".harness/staleness/current.json" ||
+        rel === ".harness/ground/manifest.yaml" ||
+        rel === ".harness/ground/decisions/decisions.ledger.yaml" ||
+        rel === ".harness/ground/invariants/invariants.ledger.yaml" ||
+        rel === ".harness/ground/quality-grades.yaml");
+}
+//# sourceMappingURL=daemon.js.map

package/dist/watch/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/watch/daemon.ts"],"names":[],"mappings":"AAAA,OAAO,QAA4B,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,GAAG,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AAqBnC,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,OAAO,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAmB;IACnD,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;IAExD,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC5B,YAAY,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,IAAI,CACN,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,EAC1D,iBAAiB,CAClB,CAAC;IAEF,6DAA6D;IAC7D,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAE3C,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE;QACvC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC;QAC5C,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,EAAE,kBAAkB,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE;KAChE,CAAC,CAAC;IAEH,IAAI,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,IAAI,KAAK,GAA0B,IAAI,CAAC;IACxC,IAAI,QAAQ,GAAyB,IAAI,CAAC;IAE1C,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;QACrC,KAAK,GAAG,IAAI,CAAC;QACb,IAAI,QAAQ,EAAE,CAAC;YACb,4EAA4E;YAC5E,MAAM,QAAQ,CAAC;YACf,IAAI,cAAc,CAAC,IAAI,KAAK,CAAC;gBAAE,OAAO;QACxC,CAAC;QACD,MAAM,YAAY,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC;QACzC,cAAc,GAAG,IAAI,GAAG,EAAE,CAAC;QAC3B,QAAQ,GAAG,CAAC,KAAK,IAAmB,EAAE;YACpC,IAAI,CAAC;gBACH,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;YAC3D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC;YACvD,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,MAAM,QAAQ,CAAC;QACf,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAQ,EAAE;QACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACzD,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO;QAC/C,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,KAAK,IAAI,EAAE,CAAC;QACd,CAAC,EAAE,UAAU,CAAC,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE/B,MAAM,MAAM,GAAiB;QAC3B,OAAO;QACP,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,IAAI,KAAK,EAAE,CAAC;gBACV,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;YACD,MAAM,IAAI,EAAE,CAAC;QACf,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC/B,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;gBACtC,IAAI,UAAU,CAAC,IAAI,CAAC;oBAAE,UAAU,CAAC,IAAI,CAAC,CAAC;YACzC,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,EAAE,gBAAgB,CAAC,CAAC;QAC9C,CAAC;KACF,CAAC;IAEF,GAAG,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,cAAc,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,WAAmB;IACvC,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IACtC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACjE,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CACb,sCAAsC,WAAW,UAAU,QAAQ,KAAK;gBACtE,sDAAsD,CACzD,CAAC;QACJ,CAAC;QACD,qBAAqB;IACvB,CAAC;IACD,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,QAAgB;IAC/C,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACzD,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAC7B,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,wEAAwE;IACxE,OAAO,CACL,GAAG,KAAK,MAAM;QACd,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;QACvB,GAAG,KAAK,cAAc;QACtB,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC;QAC/B,GAAG,KAAK,aAAa;QACrB,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC;QAC9B,GAAG,KAAK,MAAM;QACd,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;QACvB,GAAG,KAAK,OAAO;QACf,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC;QACxB,GAAG,KAAK,QAAQ;QAChB,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;QACzB,GAAG,KAAK,eAAe;QACvB,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAChC,GAAG,KAAK,gBAAgB;QACxB,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC;QACjC,GAAG,KAAK,sBAAsB;QAC9B,GAAG,CAAC,UAAU,CAAC,uBAAuB,CAAC;QACvC,GAAG,KAAK,8BAA8B;QACtC,GAAG,KAAK,iCAAiC;QACzC,GAAG,KAAK,+BAA+B;QACvC,GAAG,KAAK,iDAAiD;QACzD,GAAG,KAAK,mDAAmD;QAC3D,GAAG,KAAK,qCAAqC,CAC9C,CAAC;AACJ,CAAC"}

package/dist/watch/index.d.ts

@@ -0,0 +1,4 @@
+export { regenerateAll } from "./regenerate.js";
+export type { RegenerateOptions, RegenerateResult } from "./regenerate.js";
+export { startDaemon, pidFilePath } from "./daemon.js";
+export type { DaemonHandle, DaemonOptions } from "./daemon.js";

package/dist/watch/index.js

@@ -0,0 +1,3 @@
+export { regenerateAll } from "./regenerate.js";
+export { startDaemon, pidFilePath } from "./daemon.js";
+//# sourceMappingURL=index.js.map

package/dist/watch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/watch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/watch/regenerate.d.ts

@@ -0,0 +1,25 @@
+import type { Profile } from "../profiles/index.js";
+export interface RegenerateOptions {
+    repoRoot: string;
+    /** Override profile selection (used by tests). */
+    profile?: Profile;
+    /** Optional list of changed file paths (relative to repoRoot). When given,
+     *  profile extractors only fire if their watch globs match a change.
+     *  When undefined, every extractor fires (full sweep). */
+    changedFiles?: string[];
+}
+export interface RegenerateResult {
+    manifestPath: string;
+    decisionsLedgerPath: string;
+    invariantsLedgerPath: string;
+    qualityGradesPath: string;
+    extractorsRan: string[];
+}
+/**
+ * Idempotent full regeneration of `.harness/ground/*` for the given repo.
+ *
+ * Generic outputs (manifest, ledgers, quality grades) are always written.
+ * Profile-specific extractors fire only when their watch globs intersect
+ * `changedFiles`, or always when `changedFiles` is undefined.
+ */
+export declare function regenerateAll(opts: RegenerateOptions): Promise<RegenerateResult>;

package/dist/watch/regenerate.js

@@ -0,0 +1,51 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { logger } from "../logger.js";
+import { matchAnyGlob, writeDecisionsLedger, writeInvariantsLedger, writeManifest, writeQualityGrades, } from "../ground/index.js";
+import { selectProfile } from "../profiles/index.js";
+const log = logger("watch.regenerate");
+/**
+ * Idempotent full regeneration of `.harness/ground/*` for the given repo.
+ *
+ * Generic outputs (manifest, ledgers, quality grades) are always written.
+ * Profile-specific extractors fire only when their watch globs intersect
+ * `changedFiles`, or always when `changedFiles` is undefined.
+ */
+export async function regenerateAll(opts) {
+    const { repoRoot } = opts;
+    const profile = opts.profile ?? selectProfile(repoRoot);
+    log.info({ repoRoot, profile: profile.id }, "regenerate start");
+    const manifest = writeManifest({ repoRoot, generator: "harness-watch" });
+    const decisions = writeDecisionsLedger({ repoRoot });
+    const invariants = writeInvariantsLedger({ repoRoot });
+    const quality = writeQualityGrades({ repoRoot });
+    const extractorsRan = [];
+    for (const extractor of profile.extractors) {
+        const triggered = opts.changedFiles === undefined ||
+            opts.changedFiles.some((p) => matchAnyGlob(p, extractor.watch));
+        if (!triggered)
+            continue;
+        try {
+            const content = await extractor.run({ repoRoot });
+            if (content === null)
+                continue;
+            const out = join(repoRoot, extractor.outputRelPath);
+            mkdirSync(dirname(out), { recursive: true });
+            writeFileSync(out, content, "utf8");
+            extractorsRan.push(extractor.id);
+            log.debug({ extractor: extractor.id, out }, "extractor wrote artifact");
+        }
+        catch (err) {
+            log.warn({ extractor: extractor.id, err: String(err) }, "extractor failed");
+        }
+    }
+    log.info({ repoRoot, profile: profile.id, files: manifest.manifest.files.length, extractorsRan }, "regenerate complete");
+    return {
+        manifestPath: manifest.path,
+        decisionsLedgerPath: decisions.path,
+        invariantsLedgerPath: invariants.path,
+        qualityGradesPath: quality.path,
+        extractorsRan,
+    };
+}
+//# sourceMappingURL=regenerate.js.map

package/dist/watch/regenerate.js.map

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

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@isaacriehm/cairn",
+  "version": "0.1.0",
+  "description": "Cairn — state + context-loading layer for AI coding agents.",
+  "author": "Isaac Riehm",
+  "license": "MIT",
+  "homepage": "https://github.com/isaacriehm/cairn",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/isaacriehm/cairn.git"
+  },
+  "bugs": {
+    "url": "https://github.com/isaacriehm/cairn/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "cairn": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "simple-git": "^3.36.0",
+    "yaml": "^2.8.4",
+    "@isaacriehm/cairn-core": "0.1.0",
+    "@isaacriehm/cairn-frontend-stub": "0.1.0"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@types/node": "^25.6.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b --noEmit",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "dev": "tsx src/cli/index.ts",
+    "check:layout": "tsx scripts/check-layout.ts",
+    "smoke:tier0": "tsx scripts/smoke-tier0.ts",
+    "smoke:gc": "tsx scripts/smoke-gc.ts",
+    "smoke:init": "tsx scripts/smoke-init.ts",
+    "smoke:session-start": "tsx scripts/smoke-session-start.ts",
+    "smoke:status-line": "tsx scripts/smoke-status-line.ts",
+    "smoke:handoff": "tsx scripts/smoke-handoff.ts",
+    "smoke:scope-index": "tsx scripts/smoke-scope-index.ts",
+    "smoke:read-enrich": "tsx scripts/smoke-read-enrich.ts",
+    "smoke:ingestion-baseline": "tsx scripts/smoke-ingestion-baseline.ts",
+    "smoke:lock": "tsx scripts/smoke-lock.ts",
+    "smoke:session-state": "tsx scripts/smoke-session-state.ts",
+    "smoke:events": "tsx scripts/smoke-events.ts",
+    "smoke:plugin-layout": "tsx scripts/smoke-plugin-layout.ts",
+    "smoke:resolve-attention": "tsx scripts/smoke-resolve-attention.ts",
+    "smoke:stop-hook": "tsx scripts/smoke-stop-hook.ts",
+    "smoke:source-comments": "tsx scripts/smoke-source-comments.ts",
+    "smoke:rules-merge": "tsx scripts/smoke-rules-merge.ts",
+    "smoke:join": "tsx scripts/smoke-join.ts",
+    "smoke:bypass-detection": "tsx scripts/smoke-bypass-detection.ts",
+    "smoke:bootstrap-guard": "tsx scripts/smoke-bootstrap-guard.ts",
+    "smoke:e2e-adoption": "tsx scripts/smoke-e2e-adoption.ts",
+    "smoke:e2e-daily-flow": "tsx scripts/smoke-e2e-daily-flow.ts"
+  }
+}