@isaacriehm/cairn 0.1.0

package/dist/cli/attention.js

@@ -0,0 +1,234 @@
+/**
+ * `cairn attention` — show pending operator review items.
+ *
+ * Reads two sources from the adopted project:
+ *   1. `.cairn/ground/decisions/_inbox/*.draft.md`  — DEC drafts awaiting confirm
+ *   2. `.cairn/baseline/sensor-audit-*.yaml` (latest) — pre-Cairn sensor findings
+ *
+ * Prints a structured summary; exits 0 when there are no pending items, 2 when
+ * any are present (so scripts can branch on attention).
+ */
+import { existsSync, readFileSync, readdirSync, } from "node:fs";
+import { join, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+const FINDINGS_PER_SENSOR = 3;
+function parseRepoFlag(argv) {
+    const idx = argv.indexOf("--repo");
+    if (idx === -1)
+        return process.cwd();
+    const candidate = argv[idx + 1];
+    if (candidate === undefined || candidate.startsWith("--")) {
+        console.error("--repo requires a path argument");
+        process.exit(2);
+    }
+    return resolve(candidate);
+}
+function ensureAdopted(repoRoot) {
+    if (!existsSync(repoRoot)) {
+        console.error(`cairn attention: repo root does not exist: ${repoRoot}`);
+        process.exit(2);
+    }
+    if (!existsSync(`${repoRoot}/.cairn`)) {
+        console.error(`cairn attention: ${repoRoot} is not cairn-adopted (no .cairn/). Run \`cairn init\` first.`);
+        process.exit(2);
+    }
+}
+function readFrontmatter(text) {
+    const m = text.match(/^---\n([\s\S]*?)\n---/);
+    if (!m || m[1] === undefined)
+        return {};
+    try {
+        const parsed = parseYaml(m[1]);
+        return typeof parsed === "object" && parsed !== null
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+function listDrafts(repoRoot) {
+    const dir = join(repoRoot, ".cairn", "ground", "decisions", "_inbox");
+    if (!existsSync(dir))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true, encoding: "utf8" });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const e of entries) {
+        if (!e.isFile() || !e.name.endsWith(".draft.md"))
+            continue;
+        const abs = join(dir, e.name);
+        let text;
+        try {
+            text = readFileSync(abs, "utf8");
+        }
+        catch {
+            continue;
+        }
+        const fm = readFrontmatter(text);
+        const id = typeof fm["id"] === "string"
+            ? fm["id"]
+            : e.name.replace(/\.draft\.md$/, "");
+        const title = typeof fm["title"] === "string"
+            ? fm["title"]
+            : "(untitled draft)";
+        const sourceFile = typeof fm["sourceFile"] === "string" ? fm["sourceFile"] : null;
+        const captureSource = typeof fm["capture_source"] === "string"
+            ? fm["capture_source"]
+            : null;
+        const rationale = typeof fm["proposedRationale"] === "string"
+            ? fm["proposedRationale"]
+            : null;
+        out.push({ id, title, sourceFile, captureSource, rationale });
+    }
+    out.sort((a, b) => a.id.localeCompare(b.id));
+    return out;
+}
+function readLatestBaseline(repoRoot) {
+    const dir = join(repoRoot, ".cairn", "baseline");
+    if (!existsSync(dir))
+        return null;
+    let entries;
+    try {
+        entries = readdirSync(dir, { encoding: "utf8" });
+    }
+    catch {
+        return null;
+    }
+    const matching = entries
+        .filter((name) => /^sensor-audit-.*\.yaml$/.test(name))
+        .sort();
+    const latest = matching.at(-1);
+    if (latest === undefined)
+        return null;
+    const abs = join(dir, latest);
+    let parsed;
+    try {
+        parsed = parseYaml(readFileSync(abs, "utf8"));
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return null;
+    const obj = parsed;
+    const runAt = typeof obj["run_at"] === "string" ? obj["run_at"] : null;
+    const totalFindings = typeof obj["total_findings"] === "number" ? obj["total_findings"] : 0;
+    const filesScanned = typeof obj["files_scanned"] === "number" ? obj["files_scanned"] : 0;
+    const bySensor = new Map();
+    if (Array.isArray(obj["sensors"])) {
+        for (const raw of obj["sensors"]) {
+            if (typeof raw !== "object" || raw === null)
+                continue;
+            const r = raw;
+            const sensorId = typeof r["sensor_id"] === "string" ? r["sensor_id"] : "";
+            if (sensorId.length === 0)
+                continue;
+            const findingsRaw = Array.isArray(r["findings"]) ? r["findings"] : [];
+            const findings = [];
+            for (const f of findingsRaw) {
+                if (typeof f !== "object" || f === null)
+                    continue;
+                const fr = f;
+                findings.push({
+                    sensor_id: sensorId,
+                    path: typeof fr["path"] === "string" ? fr["path"] : "",
+                    line: typeof fr["line"] === "number" ? fr["line"] : 0,
+                    message: typeof fr["message"] === "string" ? fr["message"] : "",
+                    severity: fr["severity"] === "hard" || fr["severity"] === "soft"
+                        ? fr["severity"]
+                        : "soft",
+                });
+            }
+            if (findings.length > 0)
+                bySensor.set(sensorId, findings);
+        }
+    }
+    return {
+        path: abs.startsWith(repoRoot) ? abs.slice(repoRoot.length + 1) : abs,
+        runAt,
+        totalFindings,
+        filesScanned,
+        bySensor,
+    };
+}
+function shortenAge(iso) {
+    if (iso === null)
+        return "";
+    const t = Date.parse(iso);
+    if (!Number.isFinite(t))
+        return "";
+    const minutes = Math.floor((Date.now() - t) / 60_000);
+    if (minutes < 60)
+        return ` (${minutes}m ago)`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return ` (${hours}h ago)`;
+    const days = Math.floor(hours / 24);
+    return ` (${days}d ago)`;
+}
+function renderDraftsSection(drafts) {
+    process.stdout.write(`  Decision drafts pending confirm — ${drafts.length}\n`);
+    for (const d of drafts) {
+        const tag = d.captureSource !== null ? ` [${d.captureSource}]` : "";
+        process.stdout.write(`    • ${d.id}${tag}  ${d.title}\n`);
+        if (d.sourceFile !== null) {
+            process.stdout.write(`        from ${d.sourceFile}\n`);
+        }
+        if (d.rationale !== null && d.rationale.length > 0) {
+            const cap = d.rationale.length > 140 ? `${d.rationale.slice(0, 137)}…` : d.rationale;
+            process.stdout.write(`        ${cap}\n`);
+        }
+    }
+    process.stdout.write("\n  Edit, accept, or discard each draft, then run `cairn attention` again.\n");
+}
+function renderBaselineSection(summary) {
+    const age = shortenAge(summary.runAt);
+    process.stdout.write(`  Baseline sensor findings — ${summary.totalFindings} (across ${summary.filesScanned} files)${age}\n`);
+    process.stdout.write(`    audit: ${summary.path}\n`);
+    for (const [sensorId, findings] of summary.bySensor) {
+        process.stdout.write(`    ${sensorId} — ${findings.length}\n`);
+        const head = findings.slice(0, FINDINGS_PER_SENSOR);
+        for (const f of head) {
+            const loc = f.line > 0 ? `:${f.line}` : "";
+            const msg = f.message.length > 80 ? `${f.message.slice(0, 77)}…` : f.message;
+            process.stdout.write(`      ${f.path}${loc}  ${msg}\n`);
+        }
+        if (findings.length > head.length) {
+            process.stdout.write(`      …${findings.length - head.length} more\n`);
+        }
+    }
+    process.stdout.write("\n  These are pre-Cairn violations. Address them before starting new work, or accept as debt.\n");
+}
+export async function attentionCli(argv) {
+    if (argv[0] === "--help" || argv[0] === "-h") {
+        process.stdout.write("Usage: cairn attention [--repo <path>]\n" +
+            "  Show DEC drafts pending confirm + latest baseline sensor findings.\n" +
+            "  Exit 0 when nothing pending; 2 when any items are pending.\n");
+        process.exit(0);
+    }
+    const repoRoot = parseRepoFlag(argv);
+    ensureAdopted(repoRoot);
+    const drafts = listDrafts(repoRoot);
+    const baseline = readLatestBaseline(repoRoot);
+    process.stdout.write(`  ⬡ cairn attention — ${repoRoot}\n\n`);
+    if (drafts.length === 0 && (baseline === null || baseline.totalFindings === 0)) {
+        process.stdout.write("  Nothing pending. Project brain is up to date.\n");
+        process.exit(0);
+    }
+    if (drafts.length > 0) {
+        renderDraftsSection(drafts);
+    }
+    if (baseline !== null && baseline.totalFindings > 0) {
+        if (drafts.length > 0)
+            process.stdout.write("\n");
+        renderBaselineSection(baseline);
+    }
+    process.exit(2);
+}
+//# sourceMappingURL=attention.js.map

package/dist/cli/attention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention.js","sourceRoot":"","sources":["../../src/cli/attention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEL,UAAU,EACV,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AA0B1C,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,SAAS,aAAa,CAAC,IAAc;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAChC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1D,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,8CAA8C,QAAQ,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,GAAG,QAAQ,SAAS,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,KAAK,CACX,oBAAoB,QAAQ,+DAA+D,CAC5F,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAY,CAAC;QAC1C,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAClD,CAAC,CAAE,MAAkC;YACrC,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACtE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAAE,SAAS;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,EAAE,GACN,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,QAAQ;YAC1B,CAAC,CAAE,EAAE,CAAC,IAAI,CAAY;YACtB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,KAAK,GACT,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ;YAC7B,CAAC,CAAE,EAAE,CAAC,OAAO,CAAY;YACzB,CAAC,CAAC,kBAAkB,CAAC;QACzB,MAAM,UAAU,GACd,OAAO,EAAE,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,EAAE,CAAC,YAAY,CAAY,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7E,MAAM,aAAa,GACjB,OAAO,EAAE,CAAC,gBAAgB,CAAC,KAAK,QAAQ;YACtC,CAAC,CAAE,EAAE,CAAC,gBAAgB,CAAY;YAClC,CAAC,CAAC,IAAI,CAAC;QACX,MAAM,SAAS,GACb,OAAO,EAAE,CAAC,mBAAmB,CAAC,KAAK,QAAQ;YACzC,CAAC,CAAE,EAAE,CAAC,mBAAmB,CAAY;YACrC,CAAC,CAAC,IAAI,CAAC;QACX,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO;SACrB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACtD,IAAI,EAAE,CAAC;IACV,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/D,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,QAAQ,CAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IACnF,MAAM,aAAa,GACjB,OAAO,GAAG,CAAC,gBAAgB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,gBAAgB,CAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,YAAY,GAChB,OAAO,GAAG,CAAC,eAAe,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,eAAe,CAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IACtD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;gBAAE,SAAS;YACtD,MAAM,CAAC,GAAG,GAA8B,CAAC;YACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,WAAW,CAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YACtF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACpC,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,MAAM,QAAQ,GAAsB,EAAE,CAAC;YACvC,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;gBAC5B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;oBAAE,SAAS;gBAClD,MAAM,EAAE,GAAG,CAA4B,CAAC;gBACxC,QAAQ,CAAC,IAAI,CAAC;oBACZ,SAAS,EAAE,QAAQ;oBACnB,IAAI,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,EAAE,CAAC,MAAM,CAAY,CAAC,CAAC,CAAC,EAAE;oBAClE,IAAI,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,EAAE,CAAC,MAAM,CAAY,CAAC,CAAC,CAAC,CAAC;oBACjE,OAAO,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,EAAE,CAAC,SAAS,CAAY,CAAC,CAAC,CAAC,EAAE;oBAC3E,QAAQ,EACN,EAAE,CAAC,UAAU,CAAC,KAAK,MAAM,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,MAAM;wBACpD,CAAC,CAAE,EAAE,CAAC,UAAU,CAAqB;wBACrC,CAAC,CAAC,MAAM;iBACb,CAAC,CAAC;YACL,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IACD,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;QACrE,KAAK;QACL,aAAa;QACb,YAAY;QACZ,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,GAAkB;IACpC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IACtD,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,KAAK,OAAO,QAAQ,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,KAAK,KAAK,QAAQ,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACpC,OAAO,KAAK,IAAI,QAAQ,CAAC;AAC3B,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAoB;IAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uCAAuC,MAAM,CAAC,MAAM,IAAI,CACzD,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,CAAC,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnD,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACrF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8EAA8E,CAC/E,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAwB;IACrD,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gCAAgC,OAAO,CAAC,aAAa,YAAY,OAAO,CAAC,YAAY,UAAU,GAAG,IAAI,CACvG,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;IACrD,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,QAAQ,MAAM,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;QACpD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,UAAU,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,SAAS,CACjD,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,iGAAiG,CAClG,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAc;IAC/C,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,0CAA0C;YACxC,wEAAwE;YACxE,gEAAgE,CACnE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACrC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAExB,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAE9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,QAAQ,MAAM,CAAC,CAAC;IAE9D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;QAC/E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;QACpD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClD,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/cli/daemon.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `harness daemon` — single supervisor process.
+ *
+ * Spawns and supervises three things in one cohesive long-lived process:
+ *   1. `harness watch --project <slug>` — grounding daemon (chokidar)
+ *   2. `harness run --project <slug> --frontend <adapters>` — orchestrator
+ *      + frontend adapters (Discord by default)
+ *   3. periodic `harness gc run --apply-classes safe` — nightly cleanup
+ *      (runs once on start + every 24h)
+ *
+ * Both child processes restart on crash with exponential backoff
+ * (1s → 2s → 4s, capped at 60s; reset on a clean run > 30s). All output
+ * tees into ~/.local/harness/logs/<slug>.{watch,run,gc}.log so launchd /
+ * journalctl users have a single tail target.
+ *
+ * SIGINT / SIGTERM cleanly stop both children + the gc cron, then exit.
+ *
+ * Used by `harness install` (launchd plist) so a friend can `harness
+ * install --project myapp` once and have everything come up on every
+ * reboot under one supervised process — no tmux / two-terminal dance.
+ */
+export type SupervisorEvent = {
+    kind: "started";
+    child: "watch" | "run";
+} | {
+    kind: "exited";
+    child: "watch" | "run";
+    code: number | null;
+    signal: NodeJS.Signals | null;
+} | {
+    kind: "restart-scheduled";
+    child: "watch" | "run";
+    delayMs: number;
+} | {
+    kind: "gc-tick";
+    ok: boolean;
+    durationMs: number;
+} | {
+    kind: "stopped";
+};
+export declare function daemonCli(argv: string[]): Promise<void>;
+/** Test seam — start a supervisor with custom event hook + return stop fn. */
+export declare function startSupervisorForTest(args: {
+    project: string;
+    frontends: string;
+    logDir: string;
+    harnessBin: string;
+    nodeBin: string;
+    onEvent: (event: SupervisorEvent) => void;
+    gcIntervalSec?: number | null;
+    once?: boolean;
+}): Promise<{
+    stop: () => Promise<void>;
+}>;

package/dist/cli/daemon.js

@@ -0,0 +1,351 @@
+/**
+ * `harness daemon` — single supervisor process.
+ *
+ * Spawns and supervises three things in one cohesive long-lived process:
+ *   1. `harness watch --project <slug>` — grounding daemon (chokidar)
+ *   2. `harness run --project <slug> --frontend <adapters>` — orchestrator
+ *      + frontend adapters (Discord by default)
+ *   3. periodic `harness gc run --apply-classes safe` — nightly cleanup
+ *      (runs once on start + every 24h)
+ *
+ * Both child processes restart on crash with exponential backoff
+ * (1s → 2s → 4s, capped at 60s; reset on a clean run > 30s). All output
+ * tees into ~/.local/harness/logs/<slug>.{watch,run,gc}.log so launchd /
+ * journalctl users have a single tail target.
+ *
+ * SIGINT / SIGTERM cleanly stop both children + the gc cron, then exit.
+ *
+ * Used by `harness install` (launchd plist) so a friend can `harness
+ * install --project myapp` once and have everything come up on every
+ * reboot under one supervised process — no tmux / two-terminal dance.
+ */
+import { spawn } from "node:child_process";
+import { mkdirSync, openSync, writeSync, closeSync } from "node:fs";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import { defaultStatusJson, logger, normalizeProjectName, writeStatusJsonForSlug, } from "@devplusllc/harness-core";
+const log = logger("cli.daemon");
+function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === undefined)
+            continue;
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("--")) {
+                flags[key] = next;
+                i += 1;
+            }
+            else {
+                flags[key] = true;
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, flags };
+}
+function usage() {
+    console.error("Usage: harness daemon --project <slug> [options]\n" +
+        "  --project       project slug (required)\n" +
+        "  --frontend      adapter list for `harness run` (default: discord)\n" +
+        "  --gc-interval   seconds between gc passes (default: 86400 = 24h)\n" +
+        "  --no-gc         disable the periodic gc tick\n" +
+        "  --log-dir       override log dir (default: ~/.local/harness/logs)\n" +
+        "  --once          run children once + exit when both die (no restart)\n" +
+        "\n" +
+        "Single supervised process running watch + run + nightly gc. Logs to\n" +
+        "<log-dir>/<slug>.{watch,run,gc}.log. SIGINT/SIGTERM stops everything.");
+    process.exit(1);
+}
+const RESET_BACKOFF_AFTER_MS = 30_000;
+const MAX_BACKOFF_MS = 60_000;
+function openLog(dir, slug, label) {
+    mkdirSync(dir, { recursive: true });
+    return openSync(resolve(dir, `${slug}.${label}.log`), "a");
+}
+function writeLine(fd, line) {
+    try {
+        writeSync(fd, `${line}\n`);
+    }
+    catch {
+        // best-effort
+    }
+}
+function spawnChild(child, shared) {
+    const proc = spawn(shared.nodeBin, [shared.harnessBin, ...child.args], {
+        stdio: ["ignore", "pipe", "pipe"],
+        env: process.env,
+    });
+    child.proc = proc;
+    child.startedAt = Date.now();
+    proc.stdout.on("data", (chunk) => {
+        writeSync(child.logFd, chunk);
+    });
+    proc.stderr.on("data", (chunk) => {
+        writeSync(child.logFd, chunk);
+    });
+    writeLine(child.logFd, `\n── [supervisor] ${new Date().toISOString()} spawned ${child.name} (pid ${proc.pid})`);
+}
+async function supervise(args) {
+    const watchLogFd = openLog(args.logDir, args.project, "watch");
+    const runLogFd = openLog(args.logDir, args.project, "run");
+    const gcLogFd = openLog(args.logDir, args.project, "gc");
+    const supervisorLogFd = openLog(args.logDir, args.project, "supervisor");
+    writeLine(supervisorLogFd, `── ${new Date().toISOString()} supervisor start · project=${args.project} · frontends=${args.frontends}`);
+    // Initialise status.json with a complete default — Claude Code's
+    // `harness status-line` reader does strict shape validation, so a partial
+    // patch on first start would render as the placeholder "daemon:down".
+    // Best-effort write; status line is cosmetic.
+    try {
+        writeStatusJsonForSlug(args.project, defaultStatusJson(true));
+    }
+    catch (err) {
+        log.warn({ err: String(err) }, "initial status.json write failed");
+    }
+    const children = [
+        {
+            name: "watch",
+            args: ["watch", "--project", args.project],
+            proc: undefined,
+            backoffMs: 1000,
+            startedAt: 0,
+            stopped: false,
+            logFd: watchLogFd,
+        },
+        {
+            name: "run",
+            args: [
+                "run",
+                "--project",
+                args.project,
+                "--frontend",
+                args.frontends,
+            ],
+            proc: undefined,
+            backoffMs: 1000,
+            startedAt: 0,
+            stopped: false,
+            logFd: runLogFd,
+        },
+    ];
+    let stopRequested = false;
+    let gcTimer;
+    let heartbeat;
+    const stopChild = async (child) => {
+        child.stopped = true;
+        if (child.proc !== undefined && child.proc.exitCode === null) {
+            try {
+                child.proc.kill("SIGTERM");
+            }
+            catch {
+                // best-effort
+            }
+            // Give it 10s grace then SIGKILL.
+            await new Promise((res) => {
+                const grace = setTimeout(() => {
+                    if (child.proc !== undefined && child.proc.exitCode === null) {
+                        try {
+                            child.proc.kill("SIGKILL");
+                        }
+                        catch {
+                            // best-effort
+                        }
+                    }
+                    res();
+                }, 10_000);
+                child.proc?.once("exit", () => {
+                    clearTimeout(grace);
+                    res();
+                });
+            });
+        }
+    };
+    const stopAll = async () => {
+        if (stopRequested)
+            return;
+        stopRequested = true;
+        if (gcTimer !== undefined)
+            clearInterval(gcTimer);
+        if (heartbeat !== undefined)
+            clearInterval(heartbeat);
+        writeLine(supervisorLogFd, `── ${new Date().toISOString()} stop signal received`);
+        await Promise.all(children.map((c) => stopChild(c)));
+        // Mark the status file so Claude Code's status line shows "down" before
+        // the LaunchAgent (or operator) restarts us.
+        try {
+            writeStatusJsonForSlug(args.project, {
+                daemon_alive: false,
+                updated_at: new Date().toISOString(),
+            });
+        }
+        catch {
+            // best-effort
+        }
+        writeLine(supervisorLogFd, `── ${new Date().toISOString()} supervisor exit`);
+        args.onEvent?.({ kind: "stopped" });
+        closeSync(watchLogFd);
+        closeSync(runLogFd);
+        closeSync(gcLogFd);
+        closeSync(supervisorLogFd);
+    };
+    process.on("SIGINT", () => {
+        void stopAll().then(() => process.exit(0));
+    });
+    process.on("SIGTERM", () => {
+        void stopAll().then(() => process.exit(0));
+    });
+    const launch = (child) => {
+        if (child.stopped || stopRequested)
+            return;
+        spawnChild(child, { nodeBin: args.nodeBin, harnessBin: args.harnessBin });
+        args.onEvent?.({ kind: "started", child: child.name });
+        log.info({ child: child.name, pid: child.proc?.pid, args: child.args }, "child spawned");
+        child.proc?.once("exit", (code, signal) => {
+            writeLine(child.logFd, `── [supervisor] ${new Date().toISOString()} ${child.name} exited code=${code ?? "null"} signal=${signal ?? "null"}`);
+            args.onEvent?.({
+                kind: "exited",
+                child: child.name,
+                code,
+                signal,
+            });
+            log.warn({ child: child.name, code, signal }, "child exited");
+            if (child.stopped || stopRequested)
+                return;
+            if (args.once)
+                return;
+            const ranLong = Date.now() - child.startedAt > RESET_BACKOFF_AFTER_MS;
+            if (ranLong)
+                child.backoffMs = 1000;
+            const delay = child.backoffMs;
+            child.backoffMs = Math.min(child.backoffMs * 2, MAX_BACKOFF_MS);
+            args.onEvent?.({
+                kind: "restart-scheduled",
+                child: child.name,
+                delayMs: delay,
+            });
+            writeLine(child.logFd, `── [supervisor] ${new Date().toISOString()} ${child.name} restart in ${delay}ms`);
+            setTimeout(() => launch(child), delay);
+        });
+    };
+    for (const c of children)
+        launch(c);
+    // Heartbeat — refresh `updated_at` every 30s so a crashed-without-shutdown
+    // daemon eventually appears stale to readers that check timestamp drift.
+    heartbeat = setInterval(() => {
+        try {
+            writeStatusJsonForSlug(args.project, {
+                daemon_alive: true,
+                updated_at: new Date().toISOString(),
+            });
+        }
+        catch {
+            // best-effort
+        }
+    }, 30_000);
+    // Allow process to exit if everything else is done — heartbeat shouldn't
+    // hold the event loop open on its own.
+    heartbeat.unref();
+    // Periodic GC tick.
+    if (args.gcIntervalSec !== null) {
+        const runGc = async () => {
+            const startedAt = Date.now();
+            writeLine(gcLogFd, `── ${new Date().toISOString()} gc tick start`);
+            try {
+                await new Promise((res, rej) => {
+                    const proc = spawn(args.nodeBin, [
+                        args.harnessBin,
+                        "gc",
+                        "run",
+                        "--apply-classes",
+                        "safe",
+                        "--repo-root",
+                        process.cwd(),
+                    ], { stdio: ["ignore", "pipe", "pipe"], env: process.env });
+                    proc.stdout.on("data", (chunk) => writeSync(gcLogFd, chunk));
+                    proc.stderr.on("data", (chunk) => writeSync(gcLogFd, chunk));
+                    proc.on("exit", (code) => {
+                        if (code === 0)
+                            res();
+                        else
+                            rej(new Error(`gc exited ${code}`));
+                    });
+                    proc.on("error", rej);
+                });
+                const dur = Date.now() - startedAt;
+                writeLine(gcLogFd, `── gc tick OK (${dur}ms)`);
+                args.onEvent?.({ kind: "gc-tick", ok: true, durationMs: dur });
+            }
+            catch (err) {
+                const dur = Date.now() - startedAt;
+                writeLine(gcLogFd, `── gc tick FAIL (${dur}ms): ${String(err)}`);
+                args.onEvent?.({ kind: "gc-tick", ok: false, durationMs: dur });
+            }
+        };
+        // Fire once on start (after a 60s warmup so children are settled).
+        setTimeout(() => void runGc(), 60_000);
+        gcTimer = setInterval(() => void runGc(), args.gcIntervalSec * 1000);
+    }
+}
+export async function daemonCli(argv) {
+    const { flags } = parseArgs(argv);
+    if (flags["help"] === true || flags["h"] === true)
+        usage();
+    const slugRaw = typeof flags["project"] === "string" ? flags["project"] : "";
+    if (slugRaw.length === 0) {
+        console.error("harness daemon: --project required\n");
+        usage();
+    }
+    const project = normalizeProjectName(slugRaw);
+    const frontends = typeof flags["frontend"] === "string" ? flags["frontend"] : "discord";
+    const logDir = typeof flags["log-dir"] === "string"
+        ? resolve(flags["log-dir"])
+        : resolve(homedir(), ".local", "harness", "logs");
+    const once = flags["once"] === true;
+    const gcIntervalSec = flags["no-gc"] === true
+        ? null
+        : typeof flags["gc-interval"] === "string"
+            ? Math.max(60, Number.parseInt(flags["gc-interval"], 10) || 86400)
+            : 86400;
+    // Resolve the harness CLI binary path. In normal operation argv[1] is the
+    // dist/cli/index.js file or a node_modules/.bin shim. We re-invoke it with
+    // the same node binary for cross-platform consistency.
+    const harnessBin = resolve(process.argv[1] ?? "");
+    const nodeBin = process.execPath;
+    await supervise({
+        project,
+        frontends,
+        logDir,
+        once,
+        gcIntervalSec,
+        harnessBin,
+        nodeBin,
+    });
+}
+/** Test seam — start a supervisor with custom event hook + return stop fn. */
+export async function startSupervisorForTest(args) {
+    let stopFn = async () => { };
+    await supervise({
+        ...args,
+        once: args.once ?? false,
+        gcIntervalSec: args.gcIntervalSec ?? null,
+        onEvent: (e) => {
+            args.onEvent(e);
+            if (e.kind === "stopped") {
+                // noop — actual stop fn drives this
+            }
+        },
+    });
+    // We can't easily expose the real stop without restructuring supervise.
+    // For test-time, send SIGTERM to ourselves is not appropriate. Instead,
+    // surface a kill helper via process events.
+    stopFn = async () => {
+        process.emit("SIGTERM");
+    };
+    return { stop: stopFn };
+}
+//# sourceMappingURL=daemon.js.map