@cat-factory/server 0.215.0 → 0.217.0

package/dist/modules/publicApi/decisions/projection.js

@@ -0,0 +1,489 @@
+import { ARCHITECTURE_BRAINSTORM_AGENT_KIND, CLARITY_REVIEW_AGENT_KIND, REQUIREMENTS_BRAINSTORM_AGENT_KIND, } from '@cat-factory/agents';
+import { dedicatedParkSurface } from '@cat-factory/orchestration';
+// The run → `PublicDecisionList` projection: what a parked run is currently asking a human, as
+// external resources. One `to*Decision` + one `isLive*` predicate per park kind, and the assembly
+// that decides which reads a given run even needs.
+//
+// Two rules hold across every kind here:
+//
+//  1. **A settled park is not a decision.** A predicate lists the park's own waiting state plus
+//     the in-flight states either side of it, so a poller sees progress rather than an empty list
+//     that reads as "nothing is happening" — but never a terminal state, which would put a
+//     question in front of a caller with nothing left to answer.
+//  2. **Project as data, never as prose.** Every one of these carries model-authored text
+//     (a proposal, a finding, an agent's question). It crosses the wire as its own field so a
+//     consumer can render it in its own surface; nothing here composes it into markdown.
+/** Project a live requirements review onto the external decision resource. */
+export function toRequirementsDecision(review) {
+    return {
+        kind: 'requirements-review',
+        reviewId: review.id,
+        taskId: review.blockId,
+        status: review.status,
+        iteration: review.iteration ?? 1,
+        maxIterations: review.maxIterations ?? 1,
+        findings: review.items.map(toFinding),
+        incorporatedRequirements: review.incorporatedRequirements,
+    };
+}
+/** Project a live clarity (bug-triage) review — the requirements twin over its own document. */
+export function toClarityDecision(review) {
+    return {
+        kind: 'clarity-review',
+        reviewId: review.id,
+        taskId: review.blockId,
+        status: review.status,
+        iteration: review.iteration ?? 1,
+        maxIterations: review.maxIterations ?? 1,
+        findings: review.items.map(toFinding),
+        clarifiedReport: review.clarifiedReport,
+    };
+}
+/** Project a live brainstorm session for one stage. */
+export function toBrainstormDecision(session) {
+    return {
+        kind: 'brainstorm',
+        sessionId: session.id,
+        stage: session.stage,
+        taskId: session.blockId,
+        status: session.status,
+        iteration: session.iteration ?? 1,
+        maxIterations: session.maxIterations ?? 1,
+        options: session.items.map(toFinding),
+        convergedDirection: session.convergedDirection,
+    };
+}
+/**
+ * The shared item projection for all three iterative-review kinds. They persist the SAME item
+ * shape (`requirementReviewItemSchema`) on purpose, so one projection is the honest expression of
+ * that rather than three copies waiting to drift. The internal `autoAnswerable` classification and
+ * the Requirement-Writer recommendation machinery stay off it: both drive in-app affordances.
+ */
+function toFinding(item) {
+    return {
+        itemId: item.id,
+        category: item.category,
+        severity: item.severity,
+        title: item.title,
+        detail: item.detail,
+        status: item.status,
+        reply: item.reply,
+    };
+}
+/** Project a run's fork-decision step state onto the external decision resource. */
+export function toForkDecision(state) {
+    return {
+        kind: 'fork',
+        status: state.status,
+        seamSummary: state.seamSummary ?? null,
+        forks: state.forks ?? [],
+    };
+}
+/**
+ * Project a run's JUDGE step state onto the external decision resource. The rubric body is
+ * deliberately omitted (see `publicJudgeDecisionSchema`) — a caller answers the findings.
+ */
+export function toJudgeDecision(stepKind, state) {
+    return {
+        kind: 'judge',
+        stepKind,
+        status: state.status,
+        rubricId: state.rubricId ?? null,
+        rubricName: state.rubricName ?? null,
+        threshold: state.threshold ?? null,
+        verdict: state.verdict ?? null,
+        bounces: state.bounces ?? 0,
+        maxBounces: state.maxBounces ?? 0,
+    };
+}
+/**
+ * Project a step's APPROVAL GATE. `exceeded` is read off the step's companion state rather than
+ * the approval itself, because that is where the engine records it — and it is what tells a caller
+ * to answer with `resolve-exceeded` instead of `approve`. Reading it as a plain boolean (rather
+ * than only when a companion exists) means an ordinary pipeline gate reports `false`, which is the
+ * true statement, not an omission.
+ */
+export function toApprovalDecision(step, stepIndex, approval) {
+    return {
+        kind: 'approval-gate',
+        approvalId: approval.id,
+        stepKind: step.agentKind,
+        stepIndex,
+        status: approval.status,
+        proposal: approval.proposal,
+        feedback: approval.feedback ?? null,
+        exceeded: step.companion?.exceeded === true,
+    };
+}
+/** Project a decision an agent raised mid-work. */
+export function toAgentDecision(step, decision) {
+    return {
+        kind: 'agent-decision',
+        decisionId: decision.id,
+        stepKind: step.agentKind,
+        question: decision.question,
+        options: decision.options,
+    };
+}
+/**
+ * Project a parked PR deep review's curation state.
+ *
+ * The slices and findings go through their own projections rather than crossing the wire as the
+ * engine holds them: the internal shapes are mid-evolution (per-slice resume reports) while the
+ * published ones must not move, and the `optional | null` internals collapse to always-present
+ * nullables so four generated clients have one shape to check.
+ */
+export function toPrReviewDecision(state) {
+    return {
+        kind: 'pr-review',
+        status: state.status,
+        summary: state.summary ?? null,
+        prUrl: state.prUrl ?? null,
+        slices: (state.slices ?? []).map(toPrReviewSlice),
+        findings: (state.findings ?? []).map(toPrReviewFinding),
+        selectedFindingIds: state.selectedFindingIds ?? [],
+    };
+}
+/** One reviewed slice, externally. */
+function toPrReviewSlice(slice) {
+    return {
+        sliceId: slice.id,
+        title: slice.title,
+        rationale: slice.rationale,
+        paths: slice.paths,
+    };
+}
+/**
+ * One review finding, externally. The challenge is projected rather than passed through so a
+ * caller sees the VERDICT and its justification without the engine's job bookkeeping.
+ */
+function toPrReviewFinding(finding) {
+    const challenge = finding.challenge;
+    return {
+        findingId: finding.id,
+        sliceId: finding.sliceId ?? null,
+        path: finding.path,
+        line: finding.line ?? null,
+        side: finding.side ?? null,
+        severity: finding.severity,
+        category: finding.category,
+        title: finding.title,
+        detail: finding.detail,
+        suggestedFix: finding.suggestedFix ?? null,
+        challenge: challenge
+            ? {
+                status: challenge.status,
+                question: challenge.question ?? null,
+                justification: challenge.justification ?? null,
+            }
+            : null,
+    };
+}
+/** Project a parked human-test gate: what to test against, and how much fix budget is left. */
+export function toHumanTestDecision(state) {
+    const env = state.environment;
+    return {
+        kind: 'human-test',
+        phase: state.phase,
+        environment: env
+            ? { url: env.url, status: env.status, expiresAt: env.expiresAt ?? null }
+            : null,
+        degradedReason: state.degradedReason ?? null,
+        attempts: state.attempts,
+        maxAttempts: state.maxAttempts,
+    };
+}
+/** Project a parked visual-confirmation gate: the pairings awaiting a verdict. */
+export function toVisualConfirmDecision(state) {
+    return {
+        kind: 'visual-confirmation',
+        phase: state.phase,
+        pairs: (state.pairs ?? []).map((pair) => ({
+            view: pair.view,
+            actualArtifactId: pair.actualArtifactId ?? null,
+            referenceArtifactId: pair.referenceArtifactId ?? null,
+        })),
+        degradedReason: state.degradedReason ?? null,
+        attempts: state.attempts,
+        maxAttempts: state.maxAttempts,
+    };
+}
+/**
+ * Whether a judge state is something the caller can still act on. `awaiting_decision` is the
+ * park; `evaluating`/`bouncing` are in flight and worth surfacing so a poller sees progress
+ * rather than an empty list that reads as "nothing is happening". A `passed`/`failed`/`skipped`
+ * judge is settled and carries no question.
+ */
+function isLiveJudge(state) {
+    return (state.status === 'awaiting_decision' ||
+        state.status === 'evaluating' ||
+        state.status === 'bouncing');
+}
+/**
+ * Whether an iterative review (requirements / clarity / brainstorm — one lifecycle, one
+ * predicate) is something the caller can still act on. A settled review (`incorporated`) is
+ * history: it is the document downstream agents implement, not a question, so it is dropped from
+ * the list rather than presented as answerable. `incorporating`/`reviewing` ARE listed: the driver
+ * is mid-cycle and the caller should see that its answers are in flight.
+ */
+function isLiveReview(review) {
+    return review.status !== 'incorporated';
+}
+/**
+ * Whether the fork state is something the caller can still act on. `awaiting_choice` is the park;
+ * `proposing`/`answering` are in-flight and worth surfacing so a poller sees progress. A `chosen`,
+ * `single_path` or `skipped` state is settled and carries no question.
+ */
+function isLiveFork(state) {
+    return (state.status === 'awaiting_choice' ||
+        state.status === 'proposing' ||
+        state.status === 'answering');
+}
+/**
+ * Whether a PR deep review still wants a human. `awaiting_selection` is the park; `reviewing`,
+ * `challenging`, `fixing` and `posting` are work in flight a poller should see. `done`/`skipped`
+ * are settled.
+ */
+function isLivePrReview(state) {
+    return state.status !== 'done' && state.status !== 'skipped';
+}
+/**
+ * Whether a human-test gate still wants a person. `awaiting_human` is the park; `provisioning`,
+ * `fixing` and `resolving_conflicts` are work in flight a poller should see; `passed` is settled.
+ *
+ * An EXHAUSTIVE switch rather than `phase !== 'passed'`, because the interesting direction is the
+ * one a negative test gets silently wrong: a phase added later (a `failed`, an `expired`) is
+ * terminal more often than not, and `!== 'passed'` would list it as a live question forever with
+ * nothing failing. Routed through {@link unclassifiedPhase} so the build breaks until somebody
+ * says which side the new phase is on.
+ */
+function isLiveHumanTest(state) {
+    switch (state.phase) {
+        case 'awaiting_human':
+        case 'provisioning':
+        case 'fixing':
+        case 'resolving_conflicts':
+            return true;
+        case 'passed':
+            return false;
+        default:
+            return unclassifiedPhase(state.phase);
+    }
+}
+/**
+ * Whether a visual-confirmation gate still wants a person. `awaiting_human` is the park, `fixing`
+ * is in flight, `approved` is settled. Exhaustive for the reason {@link isLiveHumanTest} is, and
+ * the pending phase is not hypothetical here: the internal schema's own comment records a
+ * `capturing` phase deferred until the re-capture loop is wired.
+ */
+function isLiveVisualConfirm(state) {
+    switch (state.phase) {
+        case 'awaiting_human':
+        case 'fixing':
+            return true;
+        case 'approved':
+            return false;
+        default:
+            return unclassifiedPhase(state.phase);
+    }
+}
+/**
+ * A gate phase this projection has no verdict for. Unreachable by TYPE: reaching it means a
+ * member was added to the picklist without being classified above, which is a build failure at the
+ * call site rather than a runtime branch.
+ *
+ * It still answers at runtime, because the type is total against the SCHEMA and only partial
+ * against the DATA: a row persisted by a newer build lands here. `false` is the safe answer, as a
+ * phase nobody classified is not something to put in front of a caller as an open question.
+ */
+function unclassifiedPhase(_phase) {
+    return false;
+}
+/**
+ * Project the PRE-DISPATCH INPUT GATE's verdict for an external caller. The issue CODES are the same
+ * closed vocabulary the SPA renders, so an integration maps them to its own copy (or hands them to
+ * whoever filed the ticket) rather than parsing our prose.
+ */
+export function toInputGateDecision(gate) {
+    return {
+        kind: 'input-gate',
+        status: gate.status,
+        mode: gate.mode,
+        issues: gate.issues,
+        checkedAt: gate.checkedAt,
+    };
+}
+/**
+ * Whether the gate's verdict is something the caller still has to act on. ONLY `blocked`, which is
+ * narrower than the other predicates here on purpose: `off`, `not_applicable` and `passed`
+ * are recorded facts about a run that was never held up, and `overridden` is a park somebody
+ * already answered. Listing any of them would put a decision in front of a caller with nothing to
+ * decide, and `parked` is read off the run's own status rather than from this list, so a settled
+ * verdict has nothing to add to it.
+ */
+function isLiveInputGate(gate) {
+    return gate.status === 'blocked';
+}
+/**
+ * Build the run's decision list: whatever it is currently asking a human, plus the run status so a
+ * caller can distinguish "parked, answer me" from "still working".
+ *
+ * The run is RE-READ rather than taken from the `ScopedRun` the caller was gated with, because
+ * every mutating route builds its response through here AFTER acting: a `proceed` that advanced the
+ * run, or an `incorporate` that flipped it out of `blocked`, must not report the pre-action status.
+ * A run that vanished between the gate and here (a concurrent delete) falls back to the gated
+ * snapshot rather than 500-ing on an action that already succeeded.
+ *
+ * Everything that rides the run's STEPS is read off the instance already in hand; only the
+ * separately-stored iterative reviews cost a round-trip, and those are bounded by what the run's
+ * own step chain can produce (see {@link liveDialogueDecisions}).
+ */
+export async function buildDecisionList(c, workspaceId, scoped) {
+    const container = c.get('container');
+    const execution = (await container.executionRepository.get(workspaceId, scoped.execution.id)) ?? scoped.execution;
+    // The dialogue reads and the fork read are INDEPENDENT point lookups in separate stores, so they
+    // are issued together: this projection is on the poll path AND rebuilt after every answer, and
+    // awaiting them in sequence made its latency the sum of every park kind a run could carry rather
+    // than the slowest one. The concatenation order below is still deterministic.
+    const [dialogue, fork] = await Promise.all([
+        liveDialogueDecisions(c, workspaceId, scoped.blockId, execution),
+        liveForkDecisions(c, workspaceId, execution),
+    ]);
+    const decisions = [
+        ...dialogue,
+        ...fork,
+        ...liveStepDecisions(execution, container.agentKindRegistry),
+    ];
+    // The input gate parks BEFORE the first dispatch, so when it is live it is the only thing the
+    // run is asking. Listed first for that reason: it is the earliest question, and the steps whose
+    // decisions follow have not run.
+    if (execution.inputGate && isLiveInputGate(execution.inputGate)) {
+        decisions.unshift(toInputGateDecision(execution.inputGate));
+    }
+    return {
+        runId: execution.id,
+        taskId: scoped.blockId,
+        status: execution.status,
+        // `blocked` IS the parked state — the run is waiting on a human and will not move until one
+        // of these decisions is answered. Read from the run itself rather than inferred from the
+        // decisions, so a run parked on a surface this projection doesn't model (`human-review`,
+        // whose answer is a person approving the PR on the VCS host) still reports `parked: true`
+        // with an empty list rather than silently claiming all is well.
+        parked: execution.status === 'blocked',
+        decisions,
+    };
+}
+/**
+ * The block-scoped iterative reviews a run can be parked on: requirements, clarity, and a
+ * brainstorm session per stage.
+ *
+ * Each of these lives in its OWN store, so each is a point read. Clarity and the brainstorms are
+ * fetched only when the run's step chain actually carries the kind that creates them: a run with
+ * no `clarity-review` step cannot be parked on a clarity review, and paying for the read on every
+ * poll of every run would make the cost of this endpoint a function of how many park kinds exist
+ * rather than of what the run can ask.
+ *
+ * Requirements is deliberately NOT step-gated. It has been read unconditionally since this surface
+ * shipped, which also serves a review run off-path from the block inspector; narrowing it now
+ * would take capability away from a live integration, and `/api/v1` does not do that.
+ */
+async function liveDialogueDecisions(c, workspaceId, blockId, execution) {
+    const container = c.get('container');
+    const kinds = new Set(execution.steps.map((s) => s.agentKind));
+    const { requirements, clarity, brainstorm } = container;
+    // Each read is against a different store with nothing to say to the others, so they are issued
+    // together rather than chained. The RESULT order is fixed by the tuple, not by which store
+    // answered first, so a caller's decision list does not reshuffle between two polls of one run.
+    const [requirementsReview, clarityReview, brainstormSessions] = await Promise.all([
+        requirements ? requirements.service.getForBlock(workspaceId, blockId) : null,
+        clarity && kinds.has(CLARITY_REVIEW_AGENT_KIND)
+            ? clarity.service.getForBlock(workspaceId, blockId)
+            : null,
+        brainstorm
+            ? Promise.all(liveBrainstormStages(kinds).map((stage) => brainstorm.services[stage].getForBlock(workspaceId, blockId)))
+            : [],
+    ]);
+    const decisions = [];
+    if (requirementsReview && isLiveReview(requirementsReview)) {
+        decisions.push(toRequirementsDecision(requirementsReview));
+    }
+    if (clarityReview && isLiveReview(clarityReview)) {
+        decisions.push(toClarityDecision(clarityReview));
+    }
+    for (const session of brainstormSessions) {
+        if (session && isLiveReview(session))
+            decisions.push(toBrainstormDecision(session));
+    }
+    return decisions;
+}
+/**
+ * The brainstorm stages this run's step chain can park on. A block may hold one live session per
+ * stage at once, so this returns a LIST: a pipeline running both dialogues puts two brainstorm
+ * decisions in front of the caller, and collapsing them to one would hide whichever came second.
+ */
+function liveBrainstormStages(kinds) {
+    const stages = [];
+    if (kinds.has(REQUIREMENTS_BRAINSTORM_AGENT_KIND))
+        stages.push('requirements');
+    if (kinds.has(ARCHITECTURE_BRAINSTORM_AGENT_KIND))
+        stages.push('architecture');
+    return stages;
+}
+/** The run's implementation-fork park, which the engine stores behind its own service read. */
+async function liveForkDecisions(c, workspaceId, execution) {
+    const fork = await c.get('container').executionService.getForkDecision(workspaceId, execution.id);
+    return fork && isLiveFork(fork) ? [toForkDecision(fork)] : [];
+}
+/**
+ * Every park that rides the run's own STEPS — no repository round-trip, since all of this state
+ * lives on the instance already in hand (the whole reason none of it has a side table).
+ *
+ * Scanned over the WHOLE step chain rather than `currentStep` alone: the engine parks a run by
+ * leaving the step waiting, and which index that is depends on the park (a companion gate sits on
+ * the companion's step, an approval gate on the producer's), so keying off the cursor would report
+ * an empty list for a run that is plainly stopped.
+ */
+function liveStepDecisions(execution, registry) {
+    const decisions = [];
+    execution.steps.forEach((step, index) => {
+        const approval = step.approval;
+        if (approval?.status === 'pending' && isGenericApprovalPark(execution, step, registry)) {
+            decisions.push(toApprovalDecision(step, index, approval));
+        }
+        if (step.decision && step.decision.chosen == null) {
+            decisions.push(toAgentDecision(step, step.decision));
+        }
+        if (step.judge && isLiveJudge(step.judge)) {
+            decisions.push(toJudgeDecision(step.agentKind, step.judge));
+        }
+        if (step.prReview && isLivePrReview(step.prReview)) {
+            decisions.push(toPrReviewDecision(step.prReview));
+        }
+        if (step.humanTest && isLiveHumanTest(step.humanTest)) {
+            decisions.push(toHumanTestDecision(step.humanTest));
+        }
+        if (step.visualConfirm && isLiveVisualConfirm(step.visualConfirm)) {
+            decisions.push(toVisualConfirmDecision(step.visualConfirm));
+        }
+    });
+    return decisions;
+}
+/**
+ * Whether a step's pending approval is an ORDINARY approval gate — the one the approve /
+ * request-changes / reject routes answer.
+ *
+ * `step.approval` is the engine's generic parking mechanism, so a review gate, a brainstorm, a
+ * human-verdict gate and a fork choice all carry a pending approval too. Reporting those as
+ * `approval-gate` would be the worst kind of wrong here: the caller would be offered verbs the
+ * engine refuses (`assertNotIterativeGate`), so a well-behaved integration would sit in a 409 loop
+ * against a park it was told it could answer. The classifier is the ENGINE's own, so what this
+ * surface offers and what the engine accepts cannot disagree.
+ *
+ * `companion-cap` is admitted rather than excluded: it IS answered here, by `resolve-exceeded`,
+ * and the projection flags it as `exceeded` so a caller reaches for that verb instead of approve.
+ */
+function isGenericApprovalPark(execution, step, registry) {
+    const surface = dedicatedParkSurface(execution, step, registry);
+    return surface === null || surface === 'companion-cap';
+}
+//# sourceMappingURL=projection.js.map

package/dist/modules/publicApi/decisions/projection.js.map

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

package/dist/modules/publicApi/decisions/requirementsRoutes.d.ts

@@ -0,0 +1,11 @@
+import type { Hono } from 'hono';
+import type { AppEnv } from '../../../http/env.js';
+/**
+ * The REQUIREMENTS review loop. Each route is the external twin of a `RequirementReviewController`
+ * route, calling the same service method. The item-level routes are addressed by ITEM id (not
+ * review id): a headless caller reads the findings from `GET .../decisions`, and making it also
+ * thread a review id through would be ceremony over a value it never chose. The live review is
+ * resolved from the run's block, exactly as the SPA's block-scoped routes do.
+ */
+export declare function registerRequirementsDecisionRoutes(app: Hono<AppEnv>): void;
+//# sourceMappingURL=requirementsRoutes.d.ts.map

package/dist/modules/publicApi/decisions/requirementsRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirementsRoutes.d.ts","sourceRoot":"","sources":["../../../../src/modules/publicApi/decisions/requirementsRoutes.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAIlD;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAqG1E"}

package/dist/modules/publicApi/decisions/requirementsRoutes.js

@@ -0,0 +1,91 @@
+import { incorporatePublicRunRequirementsContract, proceedPublicRunRequirementsContract, replyPublicRunFindingContract, reReviewPublicRunRequirementsContract, resolvePublicRunRequirementsExceededContract, setPublicRunFindingStatusContract, } from '@cat-factory/contracts';
+import { buildHonoRoute } from '@toad-contracts/hono';
+import { buildDecisionList } from './projection.js';
+import { failureBody, gateRequirementsAction } from './scope.js';
+/**
+ * The REQUIREMENTS review loop. Each route is the external twin of a `RequirementReviewController`
+ * route, calling the same service method. The item-level routes are addressed by ITEM id (not
+ * review id): a headless caller reads the findings from `GET .../decisions`, and making it also
+ * thread a review id through would be ceremony over a value it never chose. The live review is
+ * resolved from the run's block, exactly as the SPA's block-scoped routes do.
+ */
+export function registerRequirementsDecisionRoutes(app) {
+    // Answer one finding.
+    buildHonoRoute(app, replyPublicRunFindingContract, async (c) => {
+        const { runId, itemId } = c.req.valid('param');
+        const gated = await gateRequirementsAction(c, runId);
+        if ('fail' in gated) {
+            return c.json(failureBody(gated.fail), gated.fail.status);
+        }
+        const { workspaceId, scoped, requirements, review } = gated;
+        await requirements.service.replyToItem(workspaceId, review.id, itemId, c.req.valid('json').reply);
+        return c.json(await buildDecisionList(c, workspaceId, scoped), 200);
+    });
+    // Dismiss a finding as not applicable, or reopen one dismissed by mistake.
+    buildHonoRoute(app, setPublicRunFindingStatusContract, async (c) => {
+        const { runId, itemId } = c.req.valid('param');
+        const gated = await gateRequirementsAction(c, runId);
+        if ('fail' in gated) {
+            return c.json(failureBody(gated.fail), gated.fail.status);
+        }
+        const { workspaceId, scoped, requirements, review } = gated;
+        await requirements.service.setItemStatus(workspaceId, review.id, itemId, c.req.valid('json').status);
+        return c.json(await buildDecisionList(c, workspaceId, scoped), 200);
+    });
+    // Fold the recorded answers into the standardized document. ASYNCHRONOUS: it records the intent
+    // on the parked step and signals the durable driver, which folds + re-reviews in the background —
+    // so the returned list shows the review `incorporating`, and the caller learns the outcome from
+    // the SSE stream or a follow-up read, exactly as the SPA does.
+    buildHonoRoute(app, incorporatePublicRunRequirementsContract, async (c) => {
+        const { runId } = c.req.valid('param');
+        const gated = await gateRequirementsAction(c, runId);
+        if ('fail' in gated) {
+            return c.json(failureBody(gated.fail), gated.fail.status);
+        }
+        const { workspaceId, scoped } = gated;
+        await c
+            .get('container')
+            .executionService.requirementsReview.incorporate(workspaceId, scoped.blockId, c.req.valid('json').feedback);
+        return c.json(await buildDecisionList(c, workspaceId, scoped), 200);
+    });
+    // One more reviewer pass over the incorporated document. On convergence the parked run advances.
+    buildHonoRoute(app, reReviewPublicRunRequirementsContract, async (c) => {
+        const { runId } = c.req.valid('param');
+        const gated = await gateRequirementsAction(c, runId);
+        if ('fail' in gated) {
+            return c.json(failureBody(gated.fail), gated.fail.status);
+        }
+        const { workspaceId, scoped } = gated;
+        await c
+            .get('container')
+            .executionService.requirementsReview.reReview(workspaceId, scoped.blockId);
+        return c.json(await buildDecisionList(c, workspaceId, scoped), 200);
+    });
+    // Settle the requirements phase and advance the parked run.
+    buildHonoRoute(app, proceedPublicRunRequirementsContract, async (c) => {
+        const { runId } = c.req.valid('param');
+        const gated = await gateRequirementsAction(c, runId);
+        if ('fail' in gated) {
+            return c.json(failureBody(gated.fail), gated.fail.status);
+        }
+        const { workspaceId, scoped } = gated;
+        await c
+            .get('container')
+            .executionService.requirementsReview.proceed(workspaceId, scoped.blockId);
+        return c.json(await buildDecisionList(c, workspaceId, scoped), 200);
+    });
+    // Resolve a review that hit its iteration cap (extra round / proceed / stop and reset).
+    buildHonoRoute(app, resolvePublicRunRequirementsExceededContract, async (c) => {
+        const { runId } = c.req.valid('param');
+        const gated = await gateRequirementsAction(c, runId);
+        if ('fail' in gated) {
+            return c.json(failureBody(gated.fail), gated.fail.status);
+        }
+        const { workspaceId, scoped } = gated;
+        await c
+            .get('container')
+            .executionService.requirementsReview.resolveExceeded(workspaceId, scoped.blockId, c.req.valid('json').choice);
+        return c.json(await buildDecisionList(c, workspaceId, scoped), 200);
+    });
+}
+//# sourceMappingURL=requirementsRoutes.js.map

package/dist/modules/publicApi/decisions/requirementsRoutes.js.map

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