@cat-factory/orchestration 0.137.0 → 0.139.0

package/dist/modules/execution/validation.logic.d.ts

@@ -0,0 +1,23 @@
+import type { PipelineStep, ValidationReport } from '@cat-factory/kernel';
+/**
+ * Fold a harness-produced validation report onto a step, returning whether anything changed.
+ *
+ * Applied on all three poll paths — the live `running` republish (so the repair loop is visible
+ * while it runs), the successful terminal result (the captured proof the checkout was green
+ * before the PR opened), and the failed terminal result (the evidence behind an exhausted
+ * budget). Lenient by construction: a malformed/absent payload leaves the step untouched rather
+ * than failing the run, since the report is observability, never a control signal — the harness
+ * already decided whether to open the PR.
+ */
+export declare function applyValidationReport(step: PipelineStep, raw: unknown): boolean;
+/** Parse a harness report defensively; `null` for absent/unparseable payloads. */
+export declare function coerceValidationReport(raw: unknown): ValidationReport | null;
+/**
+ * The failure detail for a step whose run died because pre-PR validation never went green:
+ * the one-line summary (which checks failed, with exit codes) followed by the last failing
+ * command's captured output. This is what the board's failure card shows, so the operator sees
+ * WHY without opening the run — the whole reason the output is captured rather than asserted.
+ * `null` when the report describes no failure (nothing to explain).
+ */
+export declare function validationFailureDetail(report: ValidationReport): string | null;
+//# sourceMappingURL=validation.logic.d.ts.map

package/dist/modules/execution/validation.logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/execution/validation.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAQzE;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAM/E;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAO5E;AAqBD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAS/E"}

package/dist/modules/execution/validation.logic.js

@@ -0,0 +1,72 @@
+import { parseValidationReport, summarizeValidationFailure } from '@cat-factory/contracts';
+// Pure helpers for the PRE-PR VALIDATION report the executor-harness produces (see
+// docs/initiatives/pre-pr-validation.md). NO repository access — the engine's only job here is
+// to fold the harness's verdict onto the step; the loop itself runs in the container, because
+// the commands must EXECUTE against a checkout.
+/**
+ * Fold a harness-produced validation report onto a step, returning whether anything changed.
+ *
+ * Applied on all three poll paths — the live `running` republish (so the repair loop is visible
+ * while it runs), the successful terminal result (the captured proof the checkout was green
+ * before the PR opened), and the failed terminal result (the evidence behind an exhausted
+ * budget). Lenient by construction: a malformed/absent payload leaves the step untouched rather
+ * than failing the run, since the report is observability, never a control signal — the harness
+ * already decided whether to open the PR.
+ */
+export function applyValidationReport(step, raw) {
+    const report = coerceValidationReport(raw);
+    if (!report)
+        return false;
+    if (sameValidationReport(step.validation ?? null, report))
+        return false;
+    step.validation = report;
+    return true;
+}
+/** Parse a harness report defensively; `null` for absent/unparseable payloads. */
+export function coerceValidationReport(raw) {
+    if (raw === undefined || raw === null)
+        return null;
+    try {
+        return parseValidationReport(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Whether two reports are the same publish. Compared on the attempt identity + verdict rather
+ * than deep-equality of the (potentially 40 KB of) output tails, so an idle poll re-offering the
+ * same attempt doesn't churn storage or the event stream.
+ */
+function sameValidationReport(a, b) {
+    if (!a)
+        return false;
+    return (a.attempts === b.attempts &&
+        a.passed === b.passed &&
+        a.at === b.at &&
+        a.outcomes.length === b.outcomes.length &&
+        a.outcomes.every((o, i) => {
+            const other = b.outcomes[i];
+            return other !== undefined && o.label === other.label && o.exitCode === other.exitCode;
+        }));
+}
+/**
+ * The failure detail for a step whose run died because pre-PR validation never went green:
+ * the one-line summary (which checks failed, with exit codes) followed by the last failing
+ * command's captured output. This is what the board's failure card shows, so the operator sees
+ * WHY without opening the run — the whole reason the output is captured rather than asserted.
+ * `null` when the report describes no failure (nothing to explain).
+ */
+export function validationFailureDetail(report) {
+    if (report.passed)
+        return null;
+    const failed = report.outcomes.filter((o) => !o.passed);
+    if (failed.length === 0)
+        return summarizeValidationFailure(report);
+    const last = failed[failed.length - 1];
+    const tail = last?.outputTail?.trim();
+    return tail
+        ? `${summarizeValidationFailure(report)}\n\n$ ${last?.command}\n${tail}`
+        : summarizeValidationFailure(report);
+}
+//# sourceMappingURL=validation.logic.js.map

package/dist/modules/execution/validation.logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.logic.js","sourceRoot":"","sources":["../../../src/modules/execution/validation.logic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAE1F,mFAAmF;AACnF,+FAA+F;AAC/F,8FAA8F;AAC9F,gDAAgD;AAEhD;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAkB,EAAE,GAAY;IACpE,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAA;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IACzB,IAAI,oBAAoB,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,EAAE,MAAM,CAAC;QAAE,OAAO,KAAK,CAAA;IACvE,IAAI,CAAC,UAAU,GAAG,MAAM,CAAA;IACxB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAClD,IAAI,CAAC;QACH,OAAO,qBAAqB,CAAC,GAAG,CAAC,CAAA;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,CAA0B,EAAE,CAAmB;IAC3E,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IACpB,OAAO,CACL,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;QACzB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QACrB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE;QACb,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM;QACvC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACxB,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;YAC3B,OAAO,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAAA;QACxF,CAAC,CAAC,CACH,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAwB;IAC9D,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;IACvD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,0BAA0B,CAAC,MAAM,CAAC,CAAA;IAClE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA;IACrC,OAAO,IAAI;QACT,CAAC,CAAC,GAAG,0BAA0B,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,OAAO,KAAK,IAAI,EAAE;QACxE,CAAC,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAA;AACxC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/orchestration",
-  "version": "0.137.0",
+  "version": "0.139.0",
   "description": "Delivery-workflow engine for the Agent Architecture Board (execution, bootstrap, pipelines, board, boardScan, requirements, and composition root).",
   "repository": {
     "type": "git",
@@ -25,20 +25,20 @@
   },
   "dependencies": {
     "ai": "^7.0.35",
-    "@cat-factory/agents": "0.69.4",
-    "@cat-factory/caching": "0.10.37",
-    "@cat-factory/contracts": "0.162.0",
-    "@cat-factory/integrations": "0.94.1",
-    "@cat-factory/kernel": "0.156.0",
-    "@cat-factory/prompt-fragments": "0.14.10",
-    "@cat-factory/sandbox": "0.9.142",
-    "@cat-factory/spend": "0.12.81",
-    "@cat-factory/workspaces": "0.17.24"
+    "@cat-factory/agents": "0.69.6",
+    "@cat-factory/caching": "0.10.39",
+    "@cat-factory/contracts": "0.164.0",
+    "@cat-factory/integrations": "0.96.0",
+    "@cat-factory/kernel": "0.158.0",
+    "@cat-factory/prompt-fragments": "0.14.12",
+    "@cat-factory/sandbox": "0.9.144",
+    "@cat-factory/spend": "0.12.83",
+    "@cat-factory/workspaces": "0.17.26"
   },
   "devDependencies": {
     "typescript": "7.0.2",
     "vitest": "^4.1.10",
-    "@cat-factory/sandbox-fixtures": "0.7.193"
+    "@cat-factory/sandbox-fixtures": "0.7.195"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",