@isaacriehm/cairn 0.1.0

package/dist/uat/persistent.js

@@ -0,0 +1,206 @@
+/**
+ * Persistent UAT.md per task — survives context resets.
+ *
+ * Per UAT_PIPELINE.md §8 + GSD pattern. One file per task at
+ * `.harness/tasks/<task_id>/uat.md`. Carries:
+ *   - status: pending | passing | passed | failed | blocked | abandoned
+ *   - acceptance criteria checklist (per AC, status icon)
+ *   - cold-start smoke status
+ *   - blocked_by (env issues) — NEVER folded into Gaps
+ *   - Gaps from prior rejections
+ *   - related run ids
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { logger } from "../logger.js";
+const log = logger("uat.persistent");
+function uatTaskFile(repoRoot, taskId) {
+    return join(repoRoot, ".harness", "tasks", taskId, "uat.md");
+}
+const FENCE_RE = /^---\s*\r?\n([\s\S]*?)\r?\n---\s*\r?\n?([\s\S]*)$/;
+export function readUatTaskFile(repoRoot, taskId) {
+    const path = uatTaskFile(repoRoot, taskId);
+    if (!existsSync(path))
+        return null;
+    const raw = readFileSync(path, "utf8");
+    const m = raw.match(FENCE_RE);
+    if (!m)
+        return null;
+    try {
+        const fm = parseYaml(m[1] ?? "");
+        return normalizeRecord(fm);
+    }
+    catch (err) {
+        log.warn({ err: String(err), path }, "uat.md frontmatter parse failed");
+        return null;
+    }
+}
+function normalizeRecord(fm) {
+    return {
+        status: (() => {
+            const v = fm["status"];
+            return typeof v === "string" && isStatus(v) ? v : "pending";
+        })(),
+        generated: typeof fm["generated"] === "string" ? fm["generated"] : new Date().toISOString(),
+        last_updated: typeof fm["last_updated"] === "string" ? fm["last_updated"] : new Date().toISOString(),
+        attempt: typeof fm["attempt"] === "number" ? fm["attempt"] : 1,
+        related_run_ids: Array.isArray(fm["related_run_ids"])
+            ? fm["related_run_ids"].map(String)
+            : [],
+        acceptance: Array.isArray(fm["acceptance"])
+            ? fm["acceptance"].map((row) => ({
+                id: String(row["id"] ?? ""),
+                text: String(row["text"] ?? ""),
+                status: (() => {
+                    const v = row["status"];
+                    return v === "pass" || v === "fail" || v === "skipped" ? v : "pending";
+                })(),
+            }))
+            : [],
+        ...(fm["cold_start_smoke"] !== undefined
+            ? {
+                cold_start_smoke: {
+                    status: (() => {
+                        const v = fm["cold_start_smoke"]["status"];
+                        return v === "pass" || v === "fail" ? v : "skipped";
+                    })(),
+                },
+            }
+            : {}),
+        blocked_by: Array.isArray(fm["blocked_by"]) ? fm["blocked_by"].map(String) : [],
+        gaps_resolved: Array.isArray(fm["gaps_resolved"])
+            ? fm["gaps_resolved"].map((row) => ({
+                run_id: String(row["run_id"] ?? ""),
+                description: String(row["description"] ?? ""),
+            }))
+            : [],
+        gaps_open: Array.isArray(fm["gaps_open"])
+            ? fm["gaps_open"].map((row) => ({
+                run_id: String(row["run_id"] ?? ""),
+                description: String(row["description"] ?? ""),
+            }))
+            : [],
+        ...(typeof fm["notes"] === "string" ? { notes: fm["notes"] } : {}),
+    };
+}
+function isStatus(s) {
+    return ["pending", "passing", "passed", "failed", "blocked", "abandoned"].includes(s);
+}
+/** Create or update the per-task UAT.md. Idempotent. */
+export async function upsertUatTask(args) {
+    const path = uatTaskFile(args.repoRoot, args.taskId);
+    const existing = readUatTaskFile(args.repoRoot, args.taskId);
+    const now = new Date().toISOString();
+    const next = existing
+        ? {
+            ...existing,
+            status: args.status,
+            last_updated: now,
+            attempt: existing.attempt + (existing.related_run_ids.includes(args.runId) ? 0 : 1),
+            related_run_ids: existing.related_run_ids.includes(args.runId)
+                ? existing.related_run_ids
+                : [...existing.related_run_ids, args.runId],
+        }
+        : {
+            status: args.status,
+            generated: now,
+            last_updated: now,
+            attempt: 1,
+            related_run_ids: [args.runId],
+            acceptance: [],
+            blocked_by: [],
+            gaps_resolved: [],
+            gaps_open: [],
+        };
+    // Acceptance status from summary.
+    next.acceptance = args.summary.acceptance_results.map((r) => ({
+        id: r.id,
+        text: r.text,
+        status: r.status,
+    }));
+    if (args.summary.cold_start_smoke) {
+        next.cold_start_smoke = { status: args.summary.cold_start_smoke.status };
+    }
+    if (args.blockedBy && !next.blocked_by.includes(args.blockedBy)) {
+        next.blocked_by.push(args.blockedBy);
+    }
+    if (args.newGap) {
+        next.gaps_open.push(args.newGap);
+    }
+    if (args.resolveGaps && args.resolveGaps.length > 0) {
+        const toResolve = new Set(args.resolveGaps);
+        const stillOpen = [];
+        for (const g of next.gaps_open) {
+            if (toResolve.has(g.description)) {
+                next.gaps_resolved.push({ run_id: args.runId, description: g.description });
+            }
+            else {
+                stillOpen.push(g);
+            }
+        }
+        next.gaps_open = stillOpen;
+    }
+    if (args.notes !== undefined)
+        next.notes = args.notes;
+    const body = renderBody(next);
+    const content = `---\n${stringifyYaml(stripBodyFromRecord(next)).trim()}\n---\n\n${body}`;
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, content, "utf8");
+    log.info({ task_id: args.taskId, status: args.status, path }, "uat.md upserted");
+    return path;
+}
+/** Frontmatter doesn't include the rendered body's prose; strip it for serialization. */
+function stripBodyFromRecord(r) {
+    return {
+        type: "uat",
+        status: r.status,
+        generated: r.generated,
+        last_updated: r.last_updated,
+        attempt: r.attempt,
+        related_run_ids: r.related_run_ids,
+        acceptance: r.acceptance,
+        ...(r.cold_start_smoke !== undefined ? { cold_start_smoke: r.cold_start_smoke } : {}),
+        blocked_by: r.blocked_by,
+        gaps_resolved: r.gaps_resolved,
+        gaps_open: r.gaps_open,
+    };
+}
+function renderBody(r) {
+    const lines = [];
+    lines.push(`# UAT — status: ${r.status} (attempt ${r.attempt})`);
+    lines.push("");
+    lines.push("## Acceptance criteria");
+    if (r.acceptance.length === 0)
+        lines.push("(none)");
+    for (const a of r.acceptance) {
+        const icon = a.status === "pass" ? "✓" : a.status === "fail" ? "✗" : a.status === "skipped" ? "⊘" : "·";
+        lines.push(`- [${icon}] ${a.id} — ${a.text}`);
+    }
+    if (r.cold_start_smoke) {
+        lines.push("");
+        lines.push(`## Cold-start smoke: ${r.cold_start_smoke.status}`);
+    }
+    lines.push("");
+    lines.push("## Blocked-by (env issues, NEVER folded into Gaps)");
+    if (r.blocked_by.length === 0)
+        lines.push("(none)");
+    for (const b of r.blocked_by)
+        lines.push(`- ${b}`);
+    lines.push("");
+    lines.push("## Gaps from prior rejections");
+    if (r.gaps_resolved.length === 0 && r.gaps_open.length === 0)
+        lines.push("(none)");
+    for (const g of r.gaps_resolved)
+        lines.push(`- [resolved in ${g.run_id}] ${g.description}`);
+    for (const g of r.gaps_open)
+        lines.push(`- [open · ${g.run_id}] ${g.description}`);
+    if (r.notes) {
+        lines.push("");
+        lines.push("## Notes");
+        lines.push(r.notes);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=persistent.js.map

package/dist/uat/persistent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent.js","sourceRoot":"","sources":["../../src/uat/persistent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC,MAAM,GAAG,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AA2BrC,SAAS,WAAW,CAAC,QAAgB,EAAE,MAAc;IACnD,OAAO,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,QAAQ,GAAG,mDAAmD,CAAC;AAErE,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,MAAc;IAC9D,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAA4B,CAAC;QAC5D,OAAO,eAAe,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,iCAAiC,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,EAA2B;IAClD,OAAO;QACL,MAAM,EAAE,CAAC,GAAkB,EAAE;YAC3B,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;YACvB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,CAAC,CAAC,EAAE;QACJ,SAAS,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC3F,YAAY,EACV,OAAO,EAAE,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACxF,OAAO,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC;YACnD,CAAC,CAAE,EAAE,CAAC,iBAAiB,CAAe,CAAC,GAAG,CAAC,MAAM,CAAC;YAClD,CAAC,CAAC,EAAE;QACN,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;YACzC,CAAC,CAAE,EAAE,CAAC,YAAY,CAA+B,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC5D,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC3B,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC/B,MAAM,EAAE,CAAC,GAA4C,EAAE;oBACrD,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACxB,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACzE,CAAC,CAAC,EAAE;aACL,CAAC,CAAC;YACL,CAAC,CAAC,EAAE;QACN,GAAG,CAAC,EAAE,CAAC,kBAAkB,CAAC,KAAK,SAAS;YACtC,CAAC,CAAC;gBACE,gBAAgB,EAAE;oBAChB,MAAM,EAAE,CAAC,GAAgC,EAAE;wBACzC,MAAM,CAAC,GAAI,EAAE,CAAC,kBAAkB,CAA6B,CAAC,QAAQ,CAAC,CAAC;wBACxE,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;oBACtD,CAAC,CAAC,EAAE;iBACL;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,YAAY,CAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;QAC9F,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC;YAC/C,CAAC,CAAE,EAAE,CAAC,eAAe,CAA+B,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC/D,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;aAC9C,CAAC,CAAC;YACL,CAAC,CAAC,EAAE;QACN,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;YACvC,CAAC,CAAE,EAAE,CAAC,WAAW,CAA+B,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC3D,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;aAC9C,CAAC,CAAC;YACL,CAAC,CAAC,EAAE;QACN,GAAG,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACxF,CAAC;AAmBD,wDAAwD;AACxD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAuB;IACzD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,IAAI,GAAkB,QAAQ;QAClC,CAAC,CAAC;YACE,GAAG,QAAQ;YACX,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,GAAG;YACjB,OAAO,EAAE,QAAQ,CAAC,OAAO,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnF,eAAe,EAAE,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;gBAC5D,CAAC,CAAC,QAAQ,CAAC,eAAe;gBAC1B,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC;SAC9C;QACH,CAAC,CAAC;YACE,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,GAAG;YACd,YAAY,EAAE,GAAG;YACjB,OAAO,EAAE,CAAC;YACV,eAAe,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;YAC7B,UAAU,EAAE,EAAE;YACd,UAAU,EAAE,EAAE;YACd,aAAa,EAAE,EAAE;YACjB,SAAS,EAAE,EAAE;SACd,CAAC;IAEN,kCAAkC;IAClC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5D,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM;KACjB,CAAC,CAAC,CAAC;IACJ,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAClC,IAAI,CAAC,gBAAgB,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC;IAC3E,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5C,MAAM,SAAS,GAA0B,EAAE,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YAC9E,CAAC;iBAAM,CAAC;gBACN,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAEtD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,QAAQ,aAAa,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,YAAY,IAAI,EAAE,CAAC;IAC1F,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,iBAAiB,CAAC,CAAC;IACjF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yFAAyF;AACzF,SAAS,mBAAmB,CAAC,CAAgB;IAC3C,OAAO;QACL,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,eAAe,EAAE,CAAC,CAAC,eAAe;QAClC,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,GAAG,CAAC,CAAC,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,SAAS,EAAE,CAAC,CAAC,SAAS;KACvB,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,CAAgB;IAClC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,MAAM,aAAa,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,GACR,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7F,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACjE,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnF,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa;QAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5F,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/uat/probes/cli.d.ts

@@ -0,0 +1,11 @@
+/**
+ * cli probe — spawns a child process and asserts on exit_code/stdout/stderr.
+ *
+ * For ACs that assert CLI behavior. No shell, no globbing — `command` and
+ * `args` are passed directly to spawn so injection isn't a concern unless
+ * the agent literally puts a shell-redirect into args.
+ */
+import type { CliProbe, ProbeRunResult } from "../types.js";
+export declare function runCliProbe(args: {
+    probe: CliProbe;
+}): Promise<ProbeRunResult>;

package/dist/uat/probes/cli.js

@@ -0,0 +1,107 @@
+/**
+ * cli probe — spawns a child process and asserts on exit_code/stdout/stderr.
+ *
+ * For ACs that assert CLI behavior. No shell, no globbing — `command` and
+ * `args` are passed directly to spawn so injection isn't a concern unless
+ * the agent literally puts a shell-redirect into args.
+ */
+import { spawn } from "node:child_process";
+import { logger } from "../../logger.js";
+const log = logger("uat.probe.cli");
+export async function runCliProbe(args) {
+    const startedAt = Date.now();
+    const probe = args.probe;
+    const result = await new Promise((resolve) => {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), probe.timeout_ms ?? 30_000);
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        const child = spawn(probe.command, probe.args, {
+            cwd: probe.cwd,
+            env: probe.env ? { ...process.env, ...probe.env } : process.env,
+            signal: ctrl.signal,
+        });
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString("utf8");
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            const msg = String(err);
+            if (/aborted/i.test(msg))
+                timedOut = true;
+            stderr += `\n[spawn-error] ${msg}`;
+            resolve({ exitCode: -1, stdout, stderr, timedOut });
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            resolve({ exitCode: code ?? -1, stdout, stderr, timedOut });
+        });
+    });
+    const failures = evaluateExpectations({
+        probe,
+        exitCode: result.exitCode,
+        stdout: result.stdout,
+        stderr: result.stderr,
+        timedOut: result.timedOut,
+    });
+    const passed = failures.length === 0;
+    log.debug({
+        probe_id: probe.id,
+        command: probe.command,
+        exit_code: result.exitCode,
+        passed,
+        failures: failures.length,
+    }, "cli probe complete");
+    return {
+        probe_id: probe.id,
+        probe_kind: "cli",
+        passed,
+        evidence: `${probe.command} ${probe.args.join(" ")} → exit=${result.exitCode}; stdout[0..200]=${result.stdout.slice(0, 200)}`,
+        duration_ms: Date.now() - startedAt,
+        ...(passed ? {} : { failure_reason: failures.join("; ") }),
+    };
+}
+function evaluateExpectations(args) {
+    const failures = [];
+    const e = args.probe.expect;
+    if (args.timedOut) {
+        failures.push(`timed out after ${args.probe.timeout_ms ?? 30_000}ms`);
+    }
+    if (e.exit_code !== undefined && args.exitCode !== e.exit_code) {
+        failures.push(`expected exit_code ${e.exit_code}; got ${args.exitCode}`);
+    }
+    if (e.stdout_contains !== undefined) {
+        for (const needle of e.stdout_contains) {
+            if (!args.stdout.includes(needle)) {
+                failures.push(`stdout missing expected substring: ${needle.slice(0, 60)}`);
+            }
+        }
+    }
+    if (e.stdout_matches_regex !== undefined) {
+        try {
+            const re = new RegExp(e.stdout_matches_regex);
+            if (!re.test(args.stdout)) {
+                failures.push(`stdout did not match /${e.stdout_matches_regex}/`);
+            }
+        }
+        catch {
+            failures.push(`stdout_matches_regex unparseable: /${e.stdout_matches_regex}/`);
+        }
+    }
+    if (e.stderr_empty === true && args.stderr.trim().length > 0) {
+        failures.push(`expected stderr empty; got ${args.stderr.length} bytes`);
+    }
+    if (e.stderr_contains !== undefined) {
+        for (const needle of e.stderr_contains) {
+            if (!args.stderr.includes(needle)) {
+                failures.push(`stderr missing expected substring: ${needle.slice(0, 60)}`);
+            }
+        }
+    }
+    return failures;
+}
+//# sourceMappingURL=cli.js.map

package/dist/uat/probes/cli.js.map

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

package/dist/uat/probes/http.d.ts

@@ -0,0 +1,12 @@
+/**
+ * http probe — bare fetch.
+ *
+ * Verifies network endpoint behavior without spinning up a browser. The
+ * cheapest UAT probe; preferred for any AC that asserts status / body /
+ * shape / headers.
+ */
+import type { HttpProbe, ProbeRunResult } from "../types.js";
+export declare function runHttpProbe(args: {
+    probe: HttpProbe;
+    baseUrl?: string;
+}): Promise<ProbeRunResult>;

package/dist/uat/probes/http.js

@@ -0,0 +1,139 @@
+/**
+ * http probe — bare fetch.
+ *
+ * Verifies network endpoint behavior without spinning up a browser. The
+ * cheapest UAT probe; preferred for any AC that asserts status / body /
+ * shape / headers.
+ */
+import { logger } from "../../logger.js";
+const log = logger("uat.probe.http");
+export async function runHttpProbe(args) {
+    const startedAt = Date.now();
+    const url = resolveUrl(args.probe.request.url, args.baseUrl);
+    const init = {
+        method: args.probe.request.method,
+        signal: AbortSignal.timeout(args.probe.timeout_ms ?? 30_000),
+        ...(args.probe.request.headers !== undefined ? { headers: args.probe.request.headers } : {}),
+        ...(args.probe.request.body !== undefined ? { body: args.probe.request.body } : {}),
+    };
+    let response;
+    let body;
+    try {
+        response = await fetch(url, init);
+        body = await response.text();
+    }
+    catch (err) {
+        return {
+            probe_id: args.probe.id,
+            probe_kind: "http",
+            passed: false,
+            evidence: `fetch failed: ${String(err).slice(0, 200)}`,
+            duration_ms: Date.now() - startedAt,
+            failure_reason: `fetch threw: ${String(err)}`,
+        };
+    }
+    const failures = evaluateExpectations({
+        probe: args.probe,
+        response,
+        body,
+    });
+    const passed = failures.length === 0;
+    log.debug({
+        probe_id: args.probe.id,
+        url,
+        status: response.status,
+        passed,
+        failures: failures.length,
+    }, "http probe complete");
+    return {
+        probe_id: args.probe.id,
+        probe_kind: "http",
+        passed,
+        evidence: `${args.probe.request.method} ${url} → ${response.status}; body[0..200]=${body.slice(0, 200)}`,
+        duration_ms: Date.now() - startedAt,
+        ...(passed ? {} : { failure_reason: failures.join("; ") }),
+    };
+}
+function resolveUrl(target, baseUrl) {
+    if (/^https?:\/\//i.test(target))
+        return target;
+    if (baseUrl === undefined)
+        return target;
+    const trimmedBase = baseUrl.replace(/\/+$/, "");
+    const trimmedTarget = target.startsWith("/") ? target : `/${target}`;
+    return `${trimmedBase}${trimmedTarget}`;
+}
+function evaluateExpectations(args) {
+    const failures = [];
+    const e = args.probe.expect;
+    if (e.status !== undefined && args.response.status !== e.status) {
+        failures.push(`expected status ${e.status}; got ${args.response.status}`);
+    }
+    if (e.status_in !== undefined && !e.status_in.includes(args.response.status)) {
+        failures.push(`expected status ∈ {${e.status_in.join(", ")}}; got ${args.response.status}`);
+    }
+    if (e.body_contains !== undefined) {
+        for (const needle of e.body_contains) {
+            if (!args.body.includes(needle)) {
+                failures.push(`body missing expected substring: ${needle.slice(0, 60)}`);
+            }
+        }
+    }
+    if (e.body_matches_regex !== undefined) {
+        try {
+            const re = new RegExp(e.body_matches_regex);
+            if (!re.test(args.body)) {
+                failures.push(`body did not match /${e.body_matches_regex}/`);
+            }
+        }
+        catch {
+            failures.push(`body_matches_regex unparseable: /${e.body_matches_regex}/`);
+        }
+    }
+    if (e.json_path_equals !== undefined) {
+        let parsed;
+        try {
+            parsed = JSON.parse(args.body);
+        }
+        catch {
+            failures.push("response body is not JSON");
+            return failures;
+        }
+        for (const { path, value } of e.json_path_equals) {
+            const actual = jsonPathGet(parsed, path);
+            const expected = JSON.stringify(value);
+            const got = JSON.stringify(actual);
+            if (expected !== got) {
+                failures.push(`json path ${path}: expected ${expected}; got ${got}`);
+            }
+        }
+    }
+    if (e.header_present !== undefined) {
+        for (const name of e.header_present) {
+            if (args.response.headers.get(name) === null) {
+                failures.push(`expected header ${name} not present`);
+            }
+        }
+    }
+    return failures;
+}
+/**
+ * Minimal JSON-path getter. Supports dot + bracket notation:
+ *   "data.users[0].id", "rows[0].name". No wildcards, no slicing.
+ */
+function jsonPathGet(value, path) {
+    const parts = path
+        .replace(/\[(\d+)\]/g, ".$1")
+        .split(".")
+        .filter(Boolean);
+    let cursor = value;
+    for (const part of parts) {
+        if (cursor === null || cursor === undefined)
+            return undefined;
+        if (typeof cursor !== "object")
+            return undefined;
+        cursor = cursor[part];
+    }
+    return cursor;
+}
+//# sourceMappingURL=http.js.map

package/dist/uat/probes/http.js.map

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

package/dist/uat/probes/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Probe dispatcher — routes a UatProbe to the appropriate runner by kind.
+ */
+import type { ProbeRunResult, UatProbe } from "../types.js";
+import { runCliProbe } from "./cli.js";
+import { runHttpProbe } from "./http.js";
+import { runIntegrationProbe } from "./integration.js";
+import { runSqlProbe } from "./sql.js";
+import { runUiProbe } from "./ui.js";
+export interface ExecuteProbeOptions {
+    /** Probe to run. */
+    probe: UatProbe;
+    /** http base URL fallback. */
+    baseUrl?: string;
+    /** Output directory under .harness/runs/active/<id>/uat/ for ui artifacts. */
+    outputDir: string;
+    /** Repo root — used by sql/integration probes to load probe config. */
+    repoRoot?: string;
+}
+export declare function executeProbe(opts: ExecuteProbeOptions): Promise<ProbeRunResult>;
+export { runCliProbe, runHttpProbe, runIntegrationProbe, runSqlProbe, runUiProbe };

package/dist/uat/probes/index.js

@@ -0,0 +1,30 @@
+/**
+ * Probe dispatcher — routes a UatProbe to the appropriate runner by kind.
+ */
+import { runCliProbe } from "./cli.js";
+import { runHttpProbe } from "./http.js";
+import { runIntegrationProbe } from "./integration.js";
+import { runSqlProbe } from "./sql.js";
+import { runUiProbe } from "./ui.js";
+export async function executeProbe(opts) {
+    switch (opts.probe.kind) {
+        case "http":
+            return runHttpProbe({
+                probe: opts.probe,
+                ...(opts.baseUrl !== undefined ? { baseUrl: opts.baseUrl } : {}),
+            });
+        case "cli":
+            return runCliProbe({ probe: opts.probe });
+        case "ui":
+            return runUiProbe({ probe: opts.probe, outputDir: opts.outputDir });
+        case "sql":
+            return runSqlProbe({ probe: opts.probe, repoRoot: opts.repoRoot ?? process.cwd() });
+        case "integration":
+            return runIntegrationProbe({
+                probe: opts.probe,
+                ...(opts.repoRoot !== undefined ? { repoRoot: opts.repoRoot } : {}),
+            });
+    }
+}
+export { runCliProbe, runHttpProbe, runIntegrationProbe, runSqlProbe, runUiProbe };
+//# sourceMappingURL=index.js.map

package/dist/uat/probes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/uat/probes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAarC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAyB;IAC1D,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;gBAClB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjE,CAAC,CAAC;QACL,KAAK,KAAK;YACR,OAAO,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5C,KAAK,IAAI;YACP,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACtE,KAAK,KAAK;YACR,OAAO,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACtF,KAAK,aAAa;YAChB,OAAO,mBAAmB,CAAC;gBACzB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpE,CAAC,CAAC;IACP,CAAC;AACH,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC"}

package/dist/uat/probes/integration.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Integration probe — docker-compose orchestration.
+ *
+ * Pipeline:
+ *   1. `docker compose -f <file> up -d <service>` (or up -d if service unset)
+ *   2. Poll ready_check (http or cli) until pass or 60s timeout
+ *   3. Run nested test probe (http or cli)
+ *   4. `docker compose -f <file> down` (always — even on failure)
+ *
+ * Skips when `docker compose` not on PATH OR compose_file doesn't exist.
+ * Operator runs `harness setup:uat-docker` to provision the compose template
+ * and confirm docker availability.
+ */
+import type { IntegrationProbe, ProbeRunResult } from "../types.js";
+export declare function runIntegrationProbe(args: {
+    probe: IntegrationProbe;
+    repoRoot?: string;
+}): Promise<ProbeRunResult>;