@cat-factory/orchestration 0.306.0 → 0.307.0

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

@@ -1,33 +1,30 @@
 import { reproTestOutcome } from '@cat-factory/agents';
+import { renderStructuredDigest } from './structuredDigest.logic.js';
 // Pure rendering for the `repro-test` post-completion resolver: fold its STRUCTURED outcome
 // (`result.custom`, the `reproTestOutcome` schema) into a short prose digest that lands on
 // `step.output`. Downstream steps read only `step.output` via `priorOutputs` (the coder), so
 // this digest is how the reproduction result reaches them; the raw structured object stays on
 // `step.custom` for the `generic-structured` result view. Returns `undefined` for an
 // unparseable/empty result so the resolver leaves the agent's raw reply on `step.output`.
-/** Human-readable heading for each reproduction outcome. */
+/**
+ * Human-readable heading for each reproduction outcome, typed over the closed picklist so the
+ * lookup is total and the compiler refuses a new verdict until it has a heading.
+ */
 const OUTCOME_LABEL = {
-    reproduced: 'Reproduced — a failing test was committed',
+    reproduced: 'Reproduced: a failing test was committed',
     partial: 'Partially reproduced',
-    not_reproducible: 'Not reproducible — no failing test was committed',
+    not_reproducible: 'Not reproducible: no failing test was committed',
 };
 /** Render a repro-test's structured outcome into a human-readable digest, or undefined. */
 export function renderReproDigest(custom) {
     const parsed = reproTestOutcome.safeParse(custom);
     if (!parsed)
         return undefined;
-    const lines = [
-        '## Reproduction test',
-        '',
-        OUTCOME_LABEL[parsed.outcome] ?? parsed.outcome,
-    ];
-    const paths = parsed.testPaths.map((p) => p.trim()).filter((p) => p.length > 0);
-    if (paths.length) {
-        lines.push('', '### Tests', '', ...paths.map((p) => `- \`${p}\``));
-    }
-    const notes = parsed.notes?.trim();
-    if (notes)
-        lines.push('', '### Notes', '', notes);
-    return lines.join('\n');
+    return renderStructuredDigest({
+        heading: 'Reproduction test',
+        headline: OUTCOME_LABEL[parsed.outcome],
+        sections: [{ heading: 'Tests', values: parsed.testPaths, code: true }],
+        notes: parsed.notes,
+    });
 }
 //# sourceMappingURL=reproTest.logic.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"reproTest.logic.js","sourceRoot":"","sources":["../../../src/modules/execution/reproTest.logic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEtD,4FAA4F;AAC5F,2FAA2F;AAC3F,6FAA6F;AAC7F,8FAA8F;AAC9F,qFAAqF;AACrF,0FAA0F;AAE1F,4DAA4D;AAC5D,MAAM,aAAa,GAA2B;IAC5C,UAAU,EAAE,2CAA2C;IACvD,OAAO,EAAE,sBAAsB;IAC/B,gBAAgB,EAAE,kDAAkD;CACrE,CAAA;AAED,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACjD,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IAC7B,MAAM,KAAK,GAAa;QACtB,sBAAsB;QACtB,EAAE;QACF,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO;KAChD,CAAA;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC/E,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IACpE,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAA;IAClC,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,CAAC,CAAA;IAEjD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}
+{"version":3,"file":"reproTest.logic.js","sourceRoot":"","sources":["../../../src/modules/execution/reproTest.logic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAEpE,4FAA4F;AAC5F,2FAA2F;AAC3F,6FAA6F;AAC7F,8FAA8F;AAC9F,qFAAqF;AACrF,0FAA0F;AAE1F;;;GAGG;AACH,MAAM,aAAa,GAAgD;IACjE,UAAU,EAAE,0CAA0C;IACtD,OAAO,EAAE,sBAAsB;IAC/B,gBAAgB,EAAE,iDAAiD;CACpE,CAAA;AAED,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACjD,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IAC7B,OAAO,sBAAsB,CAAC;QAC5B,OAAO,EAAE,mBAAmB;QAC5B,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC;QACvC,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACtE,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,37 @@
+/** One bulleted section of a digest: a trusted heading over untrusted values. */
+export interface DigestSection {
+    /** Engine-authored, rendered as-is. */
+    heading: string;
+    /** Model-authored. Blank entries are dropped; an empty section is omitted entirely. */
+    values: readonly string[];
+    /**
+     * Render each value as a code span. For a path, a command or an identifier, where a reader
+     * needs the exact characters and markdown would otherwise eat the underscores in one.
+     */
+    code?: boolean;
+}
+/** What {@link renderStructuredDigest} composes. */
+export interface StructuredDigest {
+    /** Engine-authored `## ` heading for the whole digest. */
+    heading: string;
+    /** Engine-authored one-line verdict, straight under the heading. */
+    headline: string;
+    /**
+     * Engine-authored lines under the headline: what the PLATFORM found about the report, as
+     * opposed to what the report claims. Blank/absent entries are dropped, so a caller can compute
+     * one conditionally without branching at the call site.
+     */
+    caveats?: readonly (string | undefined)[];
+    sections?: readonly DigestSection[];
+    /** Model-authored closing prose. */
+    notes?: string | null | undefined;
+}
+/**
+ * Render a structured step outcome as the markdown digest for `step.output`.
+ *
+ * Sections with nothing in them are omitted rather than rendered empty: an empty "Not covered"
+ * heading reads as a gap nobody described, where its absence reads as no gap stated, and only the
+ * second one is true.
+ */
+export declare function renderStructuredDigest(digest: StructuredDigest): string;
+//# sourceMappingURL=structuredDigest.logic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structuredDigest.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/execution/structuredDigest.logic.ts"],"names":[],"mappings":"AAqBA,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAA;IACf,uFAAuF;IACvF,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAA;IACf,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAA;IACzC,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;IACnC,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAClC;AAQD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAevE"}

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

@@ -0,0 +1,33 @@
+import { hostMarkdown, redactSecrets } from '@cat-factory/kernel';
+/** Scrub, then neutralise: the order matters, see the module header. */
+function safeInline(value, code) {
+    const scrubbed = redactSecrets(value) ?? '';
+    return code ? hostMarkdown.inlineCode(scrubbed) : hostMarkdown.inline(scrubbed);
+}
+/**
+ * Render a structured step outcome as the markdown digest for `step.output`.
+ *
+ * Sections with nothing in them are omitted rather than rendered empty: an empty "Not covered"
+ * heading reads as a gap nobody described, where its absence reads as no gap stated, and only the
+ * second one is true.
+ */
+export function renderStructuredDigest(digest) {
+    const lines = [`## ${digest.heading}`, '', digest.headline];
+    for (const caveat of digest.caveats ?? []) {
+        if (caveat?.trim())
+            lines.push('', caveat.trim());
+    }
+    for (const section of digest.sections ?? []) {
+        const kept = section.values
+            .map((value) => value.trim())
+            .filter((value) => value.length > 0)
+            .map((value) => `- ${safeInline(value, section.code === true)}`);
+        if (kept.length)
+            lines.push('', `### ${section.heading}`, '', ...kept);
+    }
+    const notes = digest.notes?.trim();
+    if (notes)
+        lines.push('', '### Notes', '', hostMarkdown.prose(redactSecrets(notes) ?? ''));
+    return lines.join('\n');
+}
+//# sourceMappingURL=structuredDigest.logic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structuredDigest.logic.js","sourceRoot":"","sources":["../../../src/modules/execution/structuredDigest.logic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAmDjE,wEAAwE;AACxE,SAAS,UAAU,CAAC,KAAa,EAAE,IAAa;IAC9C,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;IAC3C,OAAO,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;AACjF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAwB;IAC7D,MAAM,KAAK,GAAa,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IACrE,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC1C,IAAI,MAAM,EAAE,IAAI,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IACnD,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM;aACxB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;aAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;aACnC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC,CAAA;QAClE,IAAI,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,CAAA;IACxE,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAA;IAClC,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAC1F,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/orchestration",
-  "version": "0.306.0",
+  "version": "0.307.0",
   "description": "Delivery-workflow engine for the Agent Architecture Board (execution, bootstrap, pipelines, board, boardScan, requirements, and composition root).",
   "repository": {
     "type": "git",
@@ -24,19 +24,19 @@
     "access": "public"
   },
   "dependencies": {
-    "@cat-factory/agents": "0.160.0",
-    "@cat-factory/caching": "0.20.77",
-    "@cat-factory/contracts": "0.350.0",
-    "@cat-factory/integrations": "0.172.12",
-    "@cat-factory/kernel": "0.342.1",
-    "@cat-factory/prompt-fragments": "1.1.39",
-    "@cat-factory/sandbox": "0.12.51",
-    "@cat-factory/spend": "0.21.1",
-    "@cat-factory/workspaces": "0.29.0",
+    "@cat-factory/agents": "0.161.0",
+    "@cat-factory/caching": "0.20.78",
+    "@cat-factory/contracts": "0.351.0",
+    "@cat-factory/integrations": "0.172.13",
+    "@cat-factory/kernel": "0.343.0",
+    "@cat-factory/prompt-fragments": "1.1.40",
+    "@cat-factory/sandbox": "0.12.52",
+    "@cat-factory/spend": "0.21.2",
+    "@cat-factory/workspaces": "0.29.1",
     "ai": "^7.0.93"
   },
   "devDependencies": {
-    "@cat-factory/sandbox-fixtures": "0.8.33",
+    "@cat-factory/sandbox-fixtures": "0.8.34",
     "typescript": "7.0.2",
     "vitest": "^4.1.11"
   },