@cat-factory/server 0.323.0 → 0.325.0

package/dist/modules/publicApi/openapiDocument.generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"openapiDocument.generated.js","sourceRoot":"","sources":["../../../src/modules/publicApi/openapiDocument.generated.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,EAAE;AACF,0FAA0F;AAC1F,8FAA8F;AAC9F,8FAA8F;AAC9F,8EAA8E;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG,8y9vBAA8y9vB,CAAA"}
+{"version":3,"file":"openapiDocument.generated.js","sourceRoot":"","sources":["../../../src/modules/publicApi/openapiDocument.generated.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,EAAE;AACF,0FAA0F;AAC1F,8FAA8F;AAC9F,8FAA8F;AAC9F,8EAA8E;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG,yizxBAAyizxB,CAAA"}

package/dist/modules/publicApi/publicApiAdmission.d.ts

@@ -98,7 +98,7 @@ export declare const PUBLIC_TASK_STOP_PATH = "POST /api/v1/tasks/:taskId/stop";
  * decision surface admits it cannot answer are one decision. See
  * `backend/docs/adr/0043-public-decision-surface.md`.
  */
-export declare const PUBLICLY_ANSWERABLE_PARK_SURFACES: Map<string, "agent-decision" | "approval-gate" | "brainstorm" | "clarity-review" | "follow-ups" | "fork" | "human-test" | "input-gate" | "interview" | "judge" | "pr-review" | "requirements-review" | "visual-confirmation">;
+export declare const PUBLICLY_ANSWERABLE_PARK_SURFACES: Map<string, "agent-decision" | "approval-gate" | "brainstorm" | "bug-fishing" | "clarity-review" | "follow-ups" | "fork" | "human-test" | "input-gate" | "interview" | "judge" | "pr-review" | "requirements-review" | "visual-confirmation">;
 /** The pipeline shape admission reasons about: the step chain plus its parallel flag arrays. */
 export interface AdmissiblePipelineShape {
     agentKinds: string[];

package/dist/modules/publicApi/publicApiAdmission.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publicApiAdmission.d.ts","sourceRoot":"","sources":["../../../src/modules/publicApi/publicApiAdmission.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,KAAK,iBAAiB,EAUvB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,oBAAoB,aAK/B,CAAA;AASF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,eAAe,CAAA;AAuBnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,6BAA6B,sBAAsB,CAAA;AAkDhE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,iCAAiC,CAAA;AACpE,eAAO,MAAM,qBAAqB,oCAAoC,CAAA;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,iCAAiC,+NAW5C,CAAA;AAEF,gGAAgG;AAChG,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;IACjB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;QAAE,YAAY,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,OAAO,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAA;CACjG;AASD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,uBAAuB,EACjC,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAIT;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,UAAU,EAAE,iBAAiB,CAAA;IAC7B,2GAA2G;IAC3G,KAAK,EAAE,YAAY,CAAA;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,YAAY,EAAE,YAAY,CAAA;CAC3B,GAAG,mBAAmB,CAEtB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,uBAAuB,EACjC,UAAU,EAAE,mBAAmB,GAC9B,OAAO,CAET;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,uBAAuB,EACjC,UAAU,EAAE,mBAAmB,GAC9B,MAAM,EAAE,CAwBV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA2BjG;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,uBAAuB,EACjC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE;IAAE,eAAe,EAAE,OAAO,CAAA;CAAE,GACpC,MAAM,EAAE,CAKV;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,uBAAuB,EACjC,UAAU,EAAE,mBAAmB,GAC9B,OAAO,CAIT"}
+{"version":3,"file":"publicApiAdmission.d.ts","sourceRoot":"","sources":["../../../src/modules/publicApi/publicApiAdmission.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,KAAK,iBAAiB,EAWvB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,oBAAoB,aAK/B,CAAA;AASF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,eAAe,CAAA;AAuBnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,6BAA6B,sBAAsB,CAAA;AAkDhE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,iCAAiC,CAAA;AACpE,eAAO,MAAM,qBAAqB,oCAAoC,CAAA;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,iCAAiC,+OAe5C,CAAA;AAEF,gGAAgG;AAChG,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;IACjB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;QAAE,YAAY,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,OAAO,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAA;CACjG;AASD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,uBAAuB,EACjC,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAIT;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,UAAU,EAAE,iBAAiB,CAAA;IAC7B,2GAA2G;IAC3G,KAAK,EAAE,YAAY,CAAA;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,YAAY,EAAE,YAAY,CAAA;CAC3B,GAAG,mBAAmB,CAEtB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,uBAAuB,EACjC,UAAU,EAAE,mBAAmB,GAC9B,OAAO,CAET;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,uBAAuB,EACjC,UAAU,EAAE,mBAAmB,GAC9B,MAAM,EAAE,CAwBV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA2BjG;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,uBAAuB,EACjC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE;IAAE,eAAe,EAAE,OAAO,CAAA;CAAE,GACpC,MAAM,EAAE,CAKV;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,uBAAuB,EACjC,UAAU,EAAE,mBAAmB,GAC9B,OAAO,CAIT"}

package/dist/modules/publicApi/publicApiAdmission.js

@@ -10,7 +10,7 @@
 // cross-runtime conformance suite.
 //
 // See backend/docs/adr/0047-headless-clarification-loop.md (D1).
-import { ARCHITECTURE_BRAINSTORM_AGENT_KIND, CLARITY_REVIEW_AGENT_KIND, CURATION_GATE_TRAIT, INTERVIEW_GATE_TRAIT, isInlineModelStep, PR_REVIEWER_KIND, REQUIREMENTS_BRAINSTORM_AGENT_KIND, REQUIREMENTS_REVIEW_AGENT_KIND, traitsFor, } from '@cat-factory/agents';
+import { ARCHITECTURE_BRAINSTORM_AGENT_KIND, BUG_FISHER_KIND, CLARITY_REVIEW_AGENT_KIND, CURATION_GATE_TRAIT, INTERVIEW_GATE_TRAIT, isInlineModelStep, PR_REVIEWER_KIND, REQUIREMENTS_BRAINSTORM_AGENT_KIND, REQUIREMENTS_REVIEW_AGENT_KIND, traitsFor, } from '@cat-factory/agents';
 /**
  * Inline agent kinds that PARK a run on a human/gate decision. This MUST list every
  * inline-and-parking kind: the two review gates AND the two brainstorm dialogues (all four set the
@@ -197,6 +197,10 @@ export const PUBLICLY_ANSWERABLE_PARK_SURFACES = new Map([
     // The PR deep review's finding curation: `…/decisions/pr-review/resolve` (finish / fix / post),
     // plus per-finding dismiss, challenge and resume.
     [PR_REVIEWER_KIND, 'pr-review'],
+    // The bug-fishing expedition's triage: `…/decisions/bug-fishing/address` (one bug-fix task per
+    // marked finding), plus per-finding dismiss and `…/resolve` to finish. The second curating kind
+    // to gain verbs, which is why `curationWait` now names only a deployment's OWN curating kinds.
+    [BUG_FISHER_KIND, 'bug-fishing'],
 ]);
 /** The enabled steps of a pipeline, paired with their ORIGINAL index (gates are index-aligned). */
 function enabledSteps(pipeline) {

package/dist/modules/publicApi/publicApiAdmission.js.map

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

package/dist/modules/publicApi/publicApiStream.d.ts

@@ -1,4 +1,4 @@
-import type { ExecutionStatus, PublicRun } from '@cat-factory/contracts';
+import type { ExecutionStatus, PublicDecisionList, PublicRun } from '@cat-factory/contracts';
 /**
  * Whether a run is PARKED: waiting on a human decision and unable to move until one is answered.
  *
@@ -21,6 +21,25 @@ export declare function createParkAnnouncer(): {
     /** Feed each poll's status; true exactly on the tick a NEW park should be announced. */
     shouldAnnounce: (status: ExecutionStatus) => boolean;
 };
+/**
+ * Tracks the last DECISION payload written, so a `decision-state` frame is emitted only when the
+ * run's decision list actually moved.
+ *
+ * The counterpart of {@link createParkAnnouncer}, and it fails the same two invisible ways. A
+ * detector that always fires turns a park into an unbounded stream of identical payloads, since a
+ * park lasts as long as a human takes and the projection is rebuilt every tick. One that latches
+ * and never re-arms delivers the first state and then goes quiet, which is the failure the channel
+ * exists to prevent: a review whose slices report one by one would report the first and nothing
+ * after it, and a caller cannot tell that from a reviewer that stopped.
+ *
+ * Compared on the SERIALIZED payload rather than a field of it, for the reason the progress frames
+ * beside it are: what counts as "moved" is decided by the whole projection, so a decision kind that
+ * grows a field is covered with no edit here.
+ */
+export declare function createDecisionAnnouncer(): {
+    /** Feed each tick's serialized decision list; true exactly when it should be written. */
+    shouldAnnounce: (payload: string) => boolean;
+};
 /**
  * Per-step character cap on the deliverable a STREAM frame carries, applied to `output` and to
  * `data`'s serialized size alike.
@@ -49,4 +68,34 @@ export declare const STREAM_DELIVERABLE_PREVIEW_CHARS = 2000;
  * then absent in a way that reads as never written.
  */
 export declare function reduceRunForStream(run: PublicRun): PublicRun;
+/**
+ * Per-string character cap on the model-authored text a DECISION frame carries.
+ *
+ * Smaller than {@link STREAM_DELIVERABLE_PREVIEW_CHARS}, which bounds the same class of content on
+ * the run streams, and the difference is what the cap is paid PER. The run stream pays it once per
+ * step, so a pipeline's length bounds the frame; a decision list pays it once per string in a list
+ * the RUN sizes (a deep review parks with one finding per issue it found, each carrying a detail,
+ * an evidence quote and a suggested fix), so the same number would still let one frame reach
+ * hundreds of kilobytes and be re-sent on every change.
+ *
+ * Sized as a preview a caller can act on: enough to recognise what a finding is about and decide
+ * whether to fetch it whole, which is what `GET /api/v1/runs/{runId}/decisions` is for.
+ */
+export declare const STREAM_DECISION_TEXT_PREVIEW_CHARS = 1000;
+/**
+ * Reduce a decision list for an SSE frame: clip every over-long string to a preview and report the
+ * clip on the list's own `truncated` flag.
+ *
+ * Kind-AGNOSTIC by construction, for the same reason {@link createDecisionAnnouncer} compares the
+ * serialized payload rather than a field of it: what a decision kind carries is decided by that
+ * kind, so a rule written per kind is one a new kind (or a new field on an old one) silently
+ * escapes. Clipping by LENGTH wherever the text sits covers all fourteen with no edit, and the ids,
+ * statuses, counts and enums a caller routes on are short by construction, so nothing it acts on
+ * is what gets clipped.
+ *
+ * What is NEVER reduced is the list itself. Every decision the run is asking is in every frame,
+ * because an empty `decisions` that means "this payload was narrowed" and one that means "nothing
+ * is being asked" are opposite facts, and telling them apart is the whole job of this surface.
+ */
+export declare function reduceDecisionsForStream(list: PublicDecisionList): PublicDecisionList;
 //# sourceMappingURL=publicApiStream.d.ts.map

package/dist/modules/publicApi/publicApiStream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publicApiStream.d.ts","sourceRoot":"","sources":["../../../src/modules/publicApi/publicApiStream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAiB,MAAM,wBAAwB,CAAA;AAUvF;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAEzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI;IACrC,wFAAwF;IACxF,cAAc,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAA;CACrD,CAaA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,gCAAgC,OAAQ,CAAA;AAErD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAE5D"}
+{"version":3,"file":"publicApiStream.d.ts","sourceRoot":"","sources":["../../../src/modules/publicApi/publicApiStream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,SAAS,EAEV,MAAM,wBAAwB,CAAA;AAa/B;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAEzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI;IACrC,wFAAwF;IACxF,cAAc,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAA;CACrD,CAaA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,IAAI;IACzC,yFAAyF;IACzF,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAA;CAC7C,CASA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,gCAAgC,OAAQ,CAAA;AAErD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAE5D;AAkBD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kCAAkC,OAAQ,CAAA;AAEvD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAiBrF"}

package/dist/modules/publicApi/publicApiStream.js

@@ -1,9 +1,12 @@
-// Park announcement for the public SSE streams (`/api/v1/jobs/:id/events` and the board task
-// stream). Extracted from `PublicApiController` because BOTH streams need identical behaviour and
-// the state is exactly the kind that drifts when copy-pasted: one loop re-arming on resume and the
-// other not is invisible in review and only shows up as a second park nobody was told about.
+// The pure decisions the public SSE streams share: when a park is announced, when a decision list
+// counts as moved, and how a frame is reduced for the wire. The loops themselves are in
+// `publicApiStreamRoutes.ts`.
 //
-// It is also the only part of the stream loop that is unit-testable at all — everything around it
+// Split out because BOTH streams need identical behaviour and this is exactly the kind of state
+// that drifts when copy-pasted: one loop re-arming on resume and the other not is invisible in
+// review and only shows up as a second park nobody was told about.
+//
+// It is also the only part of the stream loop that is unit-testable at all: everything around it
 // is a live poll over the store behind a hijacked response.
 /**
  * Whether a run is PARKED: waiting on a human decision and unable to move until one is answered.
@@ -40,6 +43,32 @@ export function createParkAnnouncer() {
         },
     };
 }
+/**
+ * Tracks the last DECISION payload written, so a `decision-state` frame is emitted only when the
+ * run's decision list actually moved.
+ *
+ * The counterpart of {@link createParkAnnouncer}, and it fails the same two invisible ways. A
+ * detector that always fires turns a park into an unbounded stream of identical payloads, since a
+ * park lasts as long as a human takes and the projection is rebuilt every tick. One that latches
+ * and never re-arms delivers the first state and then goes quiet, which is the failure the channel
+ * exists to prevent: a review whose slices report one by one would report the first and nothing
+ * after it, and a caller cannot tell that from a reviewer that stopped.
+ *
+ * Compared on the SERIALIZED payload rather than a field of it, for the reason the progress frames
+ * beside it are: what counts as "moved" is decided by the whole projection, so a decision kind that
+ * grows a field is covered with no edit here.
+ */
+export function createDecisionAnnouncer() {
+    let last = null;
+    return {
+        shouldAnnounce(payload) {
+            if (payload === last)
+                return false;
+            last = payload;
+            return true;
+        },
+    };
+}
 /**
  * Per-step character cap on the deliverable a STREAM frame carries, applied to `output` and to
  * `data`'s serialized size alike.
@@ -85,4 +114,53 @@ function reduceStepForStream(step) {
         truncated: true,
     };
 }
+/**
+ * Per-string character cap on the model-authored text a DECISION frame carries.
+ *
+ * Smaller than {@link STREAM_DELIVERABLE_PREVIEW_CHARS}, which bounds the same class of content on
+ * the run streams, and the difference is what the cap is paid PER. The run stream pays it once per
+ * step, so a pipeline's length bounds the frame; a decision list pays it once per string in a list
+ * the RUN sizes (a deep review parks with one finding per issue it found, each carrying a detail,
+ * an evidence quote and a suggested fix), so the same number would still let one frame reach
+ * hundreds of kilobytes and be re-sent on every change.
+ *
+ * Sized as a preview a caller can act on: enough to recognise what a finding is about and decide
+ * whether to fetch it whole, which is what `GET /api/v1/runs/{runId}/decisions` is for.
+ */
+export const STREAM_DECISION_TEXT_PREVIEW_CHARS = 1_000;
+/**
+ * Reduce a decision list for an SSE frame: clip every over-long string to a preview and report the
+ * clip on the list's own `truncated` flag.
+ *
+ * Kind-AGNOSTIC by construction, for the same reason {@link createDecisionAnnouncer} compares the
+ * serialized payload rather than a field of it: what a decision kind carries is decided by that
+ * kind, so a rule written per kind is one a new kind (or a new field on an old one) silently
+ * escapes. Clipping by LENGTH wherever the text sits covers all fourteen with no edit, and the ids,
+ * statuses, counts and enums a caller routes on are short by construction, so nothing it acts on
+ * is what gets clipped.
+ *
+ * What is NEVER reduced is the list itself. Every decision the run is asking is in every frame,
+ * because an empty `decisions` that means "this payload was narrowed" and one that means "nothing
+ * is being asked" are opposite facts, and telling them apart is the whole job of this surface.
+ */
+export function reduceDecisionsForStream(list) {
+    let clipped = false;
+    const clip = (value) => {
+        if (typeof value === 'string') {
+            if (value.length <= STREAM_DECISION_TEXT_PREVIEW_CHARS)
+                return value;
+            clipped = true;
+            return value.slice(0, STREAM_DECISION_TEXT_PREVIEW_CHARS);
+        }
+        if (Array.isArray(value))
+            return value.map(clip);
+        if (value && typeof value === 'object') {
+            return Object.fromEntries(Object.entries(value).map(([key, v]) => [key, clip(v)]));
+        }
+        return value;
+    };
+    const decisions = clip(list.decisions);
+    const unanswerable = clip(list.unanswerable);
+    return { ...list, decisions, unanswerable, truncated: clipped };
+}
 //# sourceMappingURL=publicApiStream.js.map

package/dist/modules/publicApi/publicApiStream.js.map

@@ -1 +1 @@
-{"version":3,"file":"publicApiStream.js","sourceRoot":"","sources":["../../../src/modules/publicApi/publicApiStream.ts"],"names":[],"mappings":"AAEA,6FAA6F;AAC7F,kGAAkG;AAClG,mGAAmG;AACnG,6FAA6F;AAC7F,EAAE;AACF,kGAAkG;AAClG,4DAA4D;AAE5D;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAuB;IAC9C,OAAO,MAAM,KAAK,SAAS,CAAA;AAC7B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB;IAIjC,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,OAAO;QACL,cAAc,CAAC,MAAuB;YACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtB,SAAS,GAAG,KAAK,CAAA;gBACjB,OAAO,KAAK,CAAA;YACd,CAAC;YACD,IAAI,SAAS;gBAAE,OAAO,KAAK,CAAA;YAC3B,SAAS,GAAG,IAAI,CAAA;YAChB,OAAO,IAAI,CAAA;QACb,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,KAAK,CAAA;AAErD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAc;IAC/C,OAAO,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAA;AAC9D,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAmB;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC1B,MAAM,OAAO,GAAG,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,GAAG,gCAAgC,CAAA;IACnF,6FAA6F;IAC7F,mEAAmE;IACnE,MAAM,QAAQ,GACZ,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,gCAAgC,CAAA;IAC1F,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IACtC,OAAO;QACL,GAAG,IAAI;QACP,MAAM,EAAE,OAAO,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,gCAAgC,CAAC,CAAC,CAAC,CAAC,MAAM;QAC/F,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;QACjC,SAAS,EAAE,IAAI;KAChB,CAAA;AACH,CAAC"}
+{"version":3,"file":"publicApiStream.js","sourceRoot":"","sources":["../../../src/modules/publicApi/publicApiStream.ts"],"names":[],"mappings":"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"}

package/dist/modules/publicApi/publicApiStreamRoutes.d.ts

@@ -0,0 +1,30 @@
+import type { Hono } from 'hono';
+import type { AppEnv } from '../../http/env.js';
+/**
+ * `GET /api/v1/runs/:runId/decision-events`: the run's whole `PublicDecisionList`, pushed as a
+ * `decision-state` frame whenever it changes.
+ *
+ * This is what makes a chunked operation legible without polling. A run's progress lives on the
+ * execution, but what a PR deep review or a bug-fishing expedition is DOING lives on state the run
+ * projection does not carry (`step.prReview`, `step.bugFishing`): its own status, how many slices
+ * have reported, a challenge verdict landing. None of that moves `publicRun`, so on the two run
+ * streams beside this one a review emits no frame at all for its entire duration and then a single
+ * `decision` at the park. The documentation told a caller to poll `/runs/:runId/decisions` for
+ * exactly the progress those streams could not give it; this serves the same payload by push.
+ *
+ * ITS OWN ROUTE rather than a flag on the run streams, and the reason is the published SDKs rather
+ * than taste. A query parameter added to an existing operation is emitted as a positional argument
+ * ahead of the trailing options bag, so `stream(id, options)` becomes `stream(id, query, options)`
+ * in TypeScript and `Stream(ctx, id)` grows an argument in Go: an in-place retype of four released
+ * clients, which this surface does not do. A NEW operation is the additive shape, and it turns out
+ * to be the better one anyway. It is keyed by RUN like the decision list it streams, so one route
+ * serves a board task and a headless job where a flag needed adding to two; and the run streams
+ * stay what they are, which is progress channels.
+ *
+ * `read` scope, matching `GET /api/v1/runs/:runId/decisions`: knowing what a run is waiting on is a
+ * monitoring concern, and answering is what needs `decide`.
+ */
+export declare function registerRunDecisionStreamRoute(app: Hono<AppEnv>): void;
+export declare function registerJobStreamRoute(app: Hono<AppEnv>): void;
+export declare function registerTaskRunStreamRoute(app: Hono<AppEnv>): void;
+//# sourceMappingURL=publicApiStreamRoutes.d.ts.map

package/dist/modules/publicApi/publicApiStreamRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicApiStreamRoutes.d.ts","sourceRoot":"","sources":["../../../src/modules/publicApi/publicApiStreamRoutes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAEhC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAoC/C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAgEtE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAqF9D;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAgFlE"}

package/dist/modules/publicApi/publicApiStreamRoutes.js

@@ -0,0 +1,275 @@
+import { streamSSE } from 'hono/streaming';
+import { projectDecisionList } from './decisions/projection.js';
+import { loadScopedRun } from './decisions/scope.js';
+import { authorize } from './publicApiAuth.js';
+import { createDecisionAnnouncer, createParkAnnouncer, isParked, reduceDecisionsForStream, reduceRunForStream, } from './publicApiStream.js';
+import { loadPublicJob, toPublicJob, toPublicRun } from './runProjection.js';
+// The public SSE routes: the two RUN streams (`GET /api/v1/jobs/:id/events` and
+// `GET /api/v1/tasks/:taskId/events`) and the DECISION stream beside them
+// (`GET /api/v1/runs/:runId/decision-events`).
+//
+// Both are BOUNDED POLLS over the persisted run rather than a subscription to an event hub, which
+// is what makes them runtime-symmetric by construction: there is nothing per-facade to wire, so
+// the Worker and Node serve the identical stream. Frames are de-duplicated on the serialized
+// payload, so a quiet run produces a quiet stream.
+//
+// Neither is a JSON route contract (the response is `text/event-stream`), so both are raw Hono
+// routes documented by hand in `scripts/generate-openapi.mjs`. Their `read` scope literal lives
+// here and is restated there; keep the two in step.
+//
+// They live in their own module because they are the bulk of what `PublicApiController` used to
+// be and they share the decision channel below, which neither of that controller's other route
+// groups has anything to do with.
+/** How often a stream re-reads the run, and the hard cap on how long the connection stays open. */
+const SSE_POLL_MS = 1000;
+const SSE_MAX_MS = 5 * 60 * 1000;
+/** Re-verify the caller's key at most this often on a live stream, so a mid-stream revoke cuts it. */
+const SSE_REAUTH_MS = 5000;
+/**
+ * `GET /api/v1/runs/:runId/decision-events`: the run's whole `PublicDecisionList`, pushed as a
+ * `decision-state` frame whenever it changes.
+ *
+ * This is what makes a chunked operation legible without polling. A run's progress lives on the
+ * execution, but what a PR deep review or a bug-fishing expedition is DOING lives on state the run
+ * projection does not carry (`step.prReview`, `step.bugFishing`): its own status, how many slices
+ * have reported, a challenge verdict landing. None of that moves `publicRun`, so on the two run
+ * streams beside this one a review emits no frame at all for its entire duration and then a single
+ * `decision` at the park. The documentation told a caller to poll `/runs/:runId/decisions` for
+ * exactly the progress those streams could not give it; this serves the same payload by push.
+ *
+ * ITS OWN ROUTE rather than a flag on the run streams, and the reason is the published SDKs rather
+ * than taste. A query parameter added to an existing operation is emitted as a positional argument
+ * ahead of the trailing options bag, so `stream(id, options)` becomes `stream(id, query, options)`
+ * in TypeScript and `Stream(ctx, id)` grows an argument in Go: an in-place retype of four released
+ * clients, which this surface does not do. A NEW operation is the additive shape, and it turns out
+ * to be the better one anyway. It is keyed by RUN like the decision list it streams, so one route
+ * serves a board task and a headless job where a flag needed adding to two; and the run streams
+ * stay what they are, which is progress channels.
+ *
+ * `read` scope, matching `GET /api/v1/runs/:runId/decisions`: knowing what a run is waiting on is a
+ * monitoring concern, and answering is what needs `decide`.
+ */
+export function registerRunDecisionStreamRoute(app) {
+    app.get('/api/v1/runs/:runId/decision-events', async (c) => {
+        const gate = await authorize(c, 'read');
+        if ('fail' in gate) {
+            return c.json({ error: { code: gate.fail.code, message: gate.fail.message } }, gate.fail.status);
+        }
+        const { auth } = gate;
+        const runId = c.req.param('runId');
+        const container = c.get('container');
+        // The same resolution the decision ROUTES use, so this streams exactly the population they
+        // answer: a board task run or a headless job anchor in the key's workspace, and anything else
+        // is a 404 indistinguishable from a run that never existed.
+        const scoped = await loadScopedRun(c, auth.workspaceId, runId);
+        if (!scoped) {
+            return c.json({ error: { code: 'not_found', message: 'Run not found' } }, 404);
+        }
+        const { blockId } = scoped;
+        const keys = container.publicApiKeys;
+        return streamSSE(c, async (stream) => {
+            const startedAt = Date.now();
+            let lastAuthCheck = Date.now();
+            // Change-detected on the serialized payload, like the progress frames on the run streams, so
+            // a park that lasts an hour costs one frame rather than 3,600 identical ones.
+            const changed = createDecisionAnnouncer();
+            for (;;) {
+                if (stream.aborted)
+                    break;
+                if (keys && Date.now() - lastAuthCheck > SSE_REAUTH_MS) {
+                    if (!(await keys.isActive(auth.keyId)))
+                        break;
+                    lastAuthCheck = Date.now();
+                }
+                const execution = await container.executionRepository.get(auth.workspaceId, runId);
+                if (!execution)
+                    break;
+                const list = await projectDecisionList(c, auth.workspaceId, blockId, execution);
+                // Reduced for the same reason `reduceRunForStream` reduces beside it: the frame carries the
+                // WHOLE list and is re-sent whenever any part of it moves, so a park holding eighty
+                // model-authored findings would repeat all of them for the rest of the run. The list itself
+                // is never narrowed: only the prose inside it is clipped, and `truncated` says so.
+                const data = JSON.stringify(reduceDecisionsForStream(list));
+                if (changed.shouldAnnounce(data)) {
+                    await stream.writeSSE({ event: 'decision-state', data });
+                }
+                // A finished run asks nothing, so the stream ends rather than holding a connection open
+                // over a list that can no longer move. The LAST frame is written above first, which is what
+                // makes the close readable: a caller sees the decisions empty out and then the terminal.
+                if (execution.status === 'done' || execution.status === 'failed') {
+                    await stream.writeSSE({ event: 'done', data });
+                    break;
+                }
+                if (Date.now() - startedAt > SSE_MAX_MS) {
+                    await stream.writeSSE({ event: 'timeout', data: '{}' });
+                    break;
+                }
+                await stream.sleep(SSE_POLL_MS);
+            }
+        });
+    });
+}
+export function registerJobStreamRoute(app) {
+    // Stream a job's progress + terminal completion over SSE. Authenticated by the API key header
+    // (an external client can set headers, unlike a browser `EventSource`).
+    app.get('/api/v1/jobs/:id/events', async (c) => {
+        const gate = await authorize(c, 'read');
+        if ('fail' in gate) {
+            return c.json({ error: { code: gate.fail.code, message: gate.fail.message } }, gate.fail.status);
+        }
+        const { auth } = gate;
+        const id = c.req.param('id');
+        const container = c.get('container');
+        // Same headless-job scoping as the poll read: only a headless run this surface created.
+        const initial = await loadPublicJob(c, auth.workspaceId, id);
+        if (!initial) {
+            return c.json({ error: { code: 'not_found', message: 'Job not found' } }, 404);
+        }
+        const keys = container.publicApiKeys;
+        return streamSSE(c, async (stream) => {
+            const startedAt = Date.now();
+            let lastAuthCheck = Date.now();
+            let last = '';
+            // Emit the initial state immediately, then poll until terminal / client-gone / revoked /
+            // timeout. A `blocked` run is a PARK awaiting a human decision, no longer a dead end, since
+            // a `decide`-scope caller can answer it over `/api/v1/runs/:runId/decisions`, so the stream
+            // announces the park and keeps watching rather than closing on it.
+            const parks = createParkAnnouncer();
+            for (;;) {
+                if (stream.aborted)
+                    break;
+                // Re-verify the key periodically so a mid-stream revoke cuts the connection (the key was
+                // only proven once, at open). Cheap non-hashing revocation check, throttled.
+                if (keys && Date.now() - lastAuthCheck > SSE_REAUTH_MS) {
+                    if (!(await keys.isActive(auth.keyId)))
+                        break;
+                    lastAuthCheck = Date.now();
+                }
+                const execution = await container.executionRepository.get(auth.workspaceId, id);
+                if (!execution)
+                    break;
+                const job = toPublicJob(execution, auth.externalIdentity);
+                const data = JSON.stringify(job);
+                if (data !== last) {
+                    await stream.writeSSE({
+                        event: job.status === 'succeeded' ? 'done' : job.status === 'failed' ? 'error' : 'progress',
+                        data,
+                    });
+                    last = data;
+                }
+                // A `blocked` run has PARKED on a human decision. Announce it once (so a caller learns of
+                // the park by push rather than by polling the decisions endpoint on a timer) and keep the
+                // stream open: the park is answerable, and answering resumes the very run being watched,
+                // which the caller should see through the SAME connection. Announced once per park rather
+                // than every tick, so a long park doesn't spam identical frames; re-armed when the run
+                // resumes, so a second park later in the pipeline is announced too.
+                if (parks.shouldAnnounce(execution.status)) {
+                    await stream.writeSSE({ event: 'decision', data });
+                }
+                // A `paused` run is NOT terminal: the spend gate pauses a run when the workspace budget
+                // is exhausted and RESUMES it once budget frees up (ExecutionService.evaluateStep), so keep
+                // polling (bounded by SSE_MAX_MS below) rather than signalling a false terminal stop.
+                // `blocked` is likewise non-terminal now (see above).
+                if (execution.status !== 'running' &&
+                    execution.status !== 'paused' &&
+                    !isParked(execution.status)) {
+                    // The run has stopped. When it ended in a terminal public status (succeeded/failed) the
+                    // event above already carried `done`/`error`. A raw status that maps to `running` but is
+                    // neither terminal nor a park (a `cancelled` stop lands as `failed`, so this is the
+                    // belt-and-braces arm) would otherwise close the stream after a `progress` frame, leaving
+                    // the client unable to tell "terminal" from "connection dropped". Emit an explicit
+                    // terminal `stopped` frame so every close is unambiguous.
+                    if (job.status === 'running')
+                        await stream.writeSSE({ event: 'stopped', data });
+                    break;
+                }
+                if (Date.now() - startedAt > SSE_MAX_MS) {
+                    // Bound the connection; the client can reconnect to keep watching.
+                    await stream.writeSSE({ event: 'timeout', data: '{}' });
+                    break;
+                }
+                await stream.sleep(SSE_POLL_MS);
+            }
+        });
+    });
+}
+export function registerTaskRunStreamRoute(app) {
+    // Stream a task's run over SSE: the same bounded-poll pattern as the jobs stream, re-reading the
+    // persisted run + its block each tick so a mid-run PR-open surfaces. Terminal on `done`/`failed`;
+    // a parked `blocked`/`paused` keeps polling until the run resumes or the connection hits
+    // SSE_MAX_MS.
+    app.get('/api/v1/tasks/:taskId/events', async (c) => {
+        const gate = await authorize(c, 'read');
+        if ('fail' in gate) {
+            return c.json({ error: { code: gate.fail.code, message: gate.fail.message } }, gate.fail.status);
+        }
+        const { auth } = gate;
+        const taskId = c.req.param('taskId');
+        const container = c.get('container');
+        const found = await container.boardService.getServiceTask(auth.workspaceId, taskId);
+        if (!found) {
+            return c.json({ error: { code: 'not_found', message: 'Task not found' } }, 404);
+        }
+        const run = await container.executionRepository.getByBlock(auth.workspaceId, taskId);
+        if (!run) {
+            return c.json({ error: { code: 'no_run', message: 'Task has not been started' } }, 404);
+        }
+        const runId = run.id;
+        const keys = container.publicApiKeys;
+        return streamSSE(c, async (stream) => {
+            const startedAt = Date.now();
+            let lastAuthCheck = Date.now();
+            let last = '';
+            // Announce a park once per park (see the jobs stream for the rationale); re-armed on resume
+            // so a later step's park is announced too.
+            const parks = createParkAnnouncer();
+            for (;;) {
+                if (stream.aborted)
+                    break;
+                if (keys && Date.now() - lastAuthCheck > SSE_REAUTH_MS) {
+                    if (!(await keys.isActive(auth.keyId)))
+                        break;
+                    lastAuthCheck = Date.now();
+                }
+                const execution = await container.executionRepository.get(auth.workspaceId, runId);
+                // Re-read the block for the current PR/branch: the run opens the PR mid-flight, so
+                // the block (not the execution) carries it.
+                const block = await container.boardService.getServiceTask(auth.workspaceId, taskId);
+                if (!execution || !block)
+                    break;
+                // Reduced for the wire: the frame carries the whole run, so an oversized step deliverable
+                // would be re-sent on every change for the rest of the run. See `reduceRunForStream`.
+                const runView = reduceRunForStream(toPublicRun(execution, block.block, auth.externalIdentity));
+                const data = JSON.stringify(runView);
+                if (data !== last) {
+                    await stream.writeSSE({
+                        event: runView.status === 'done'
+                            ? 'done'
+                            : runView.status === 'failed'
+                                ? 'error'
+                                : 'progress',
+                        data,
+                    });
+                    last = data;
+                }
+                // A `blocked` run has PARKED on a human decision (a requirements/clarity review, a
+                // brainstorm, an approval gate, a fork choice). Push it as a distinct `decision` frame so
+                // the caller reacts to the park instead of inferring it from a `progress` payload whose
+                // status happens to read `blocked`; `GET /api/v1/runs/:runId/decisions` then carries what
+                // is actually being asked. The stream stays open across the park: answering resumes this
+                // very run, and the caller should see that on the same connection.
+                if (parks.shouldAnnounce(execution.status)) {
+                    await stream.writeSSE({ event: 'decision', data });
+                }
+                if (execution.status === 'done' || execution.status === 'failed')
+                    break;
+                if (Date.now() - startedAt > SSE_MAX_MS) {
+                    await stream.writeSSE({ event: 'timeout', data: '{}' });
+                    break;
+                }
+                await stream.sleep(SSE_POLL_MS);
+            }
+        });
+    });
+}
+//# sourceMappingURL=publicApiStreamRoutes.js.map

package/dist/modules/publicApi/publicApiStreamRoutes.js.map

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

package/dist/modules/publicApi/runProjection.d.ts

@@ -0,0 +1,30 @@
+import type { Block, ExecutionInstance, PublicJob, PublicRun } from '@cat-factory/contracts';
+import type { Context } from 'hono';
+import type { AppEnv } from '../../http/env.js';
+/**
+ * Project a persisted execution onto the external job resource (no block/board internals).
+ *
+ * Takes the READING key's own identity because the run's pinned one is not visible to every key
+ * (`runIdentityVisibility.ts` holds the rule and why there is one). Passed as a parameter rather
+ * than read off the context here, so the projection stays a pure function of the run plus the
+ * caller and the SSE loops can render frame after frame without re-reading anything.
+ */
+export declare function toPublicJob(execution: ExecutionInstance, readerIdentity: string | null): PublicJob;
+/**
+ * Project a task's persisted run + its block onto the RICH external run resource: per-step
+ * state/progress/subtasks, the failure kind+message, and the PR (url + branch). The run's
+ * `status` is the raw execution status (`running`/`blocked`/`paused`/`done`/`failed`): the
+ * public run view deliberately surfaces the parked states (unlike the coarse `publicJob`), so
+ * a caller can tell an awaiting-a-human `blocked` from a still-`running` step. The PR branch
+ * lives on the BLOCK (`block.pullRequest`), not the run, so both are joined here.
+ */
+export declare function toPublicRun(execution: ExecutionInstance, block: Block, readerIdentity: string | null): PublicRun;
+/**
+ * Load a public JOB by id for an authenticated key: the persisted execution, but ONLY when it is
+ * anchored on a HEADLESS internal block (a run this public surface created). Returns null when no
+ * such run exists in the key's workspace OR the id points at a normal board execution, so an
+ * external key can never read an arbitrary in-workspace run's output, only its own headless jobs.
+ * Runtime-symmetric: one `executionRepository.get` + one `boardService.getInternalTask` point-read.
+ */
+export declare function loadPublicJob<E extends AppEnv>(c: Context<E>, workspaceId: string, id: string): Promise<ExecutionInstance | null>;
+//# sourceMappingURL=runProjection.d.ts.map