@cat-factory/orchestration 0.109.0 → 0.111.0

package/dist/modules/execution/PrReviewController.js

@@ -0,0 +1,203 @@
+import { ConflictError } from '@cat-factory/kernel';
+import { PR_REVIEWER_KIND } from '@cat-factory/agents';
+import { coercePrReview } from './prReview.logic.js';
+/** The step kind the PR-review park loop runs on (the read-only reviewer agent). */
+export const PR_REVIEW_STEP_KIND = PR_REVIEWER_KIND;
+/**
+ * Drives the human-facing half of the PR deep-review flow. The read-only `pr-reviewer`
+ * container agent slices an open PR's diff and returns prioritized findings; rather than
+ * finishing the run the moment it returns, {@link recordFindings} (run as the completion
+ * interceptor's body) records the sliced findings onto `step.prReview` and PARKS the run for a
+ * human to SELECT which findings matter through the dedicated window, then {@link resolve}
+ * records the selection and advances past the gate. A clean PR (no findings) — or an unwired
+ * reviewer — passes through: `recordFindings` records an empty `done` review and lets the
+ * normal completion finish the step.
+ *
+ * All state rides the run's `pr-reviewer` step (`step.prReview`) — no side table — so it is
+ * runtime-symmetric by construction, exactly like the fork-decision flow. {@link resolve}
+ * supports three terminal actions: `finish` (advance past the gate), `fix` (re-arm the step so
+ * the driver re-dispatches it as the Fixer against the reviewed PR's head branch) and `post`
+ * (re-arm so the driver publishes the selected findings as inline PR comments). The `fix`/`post`
+ * driver-side work lives in {@link RunDispatcher.handlePrReviewResolution}.
+ */
+export class PrReviewController {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Record the completed reviewer's findings onto the `pr-reviewer` step and decide the flow.
+     * Runs as the completion interceptor's body (short-circuiting `recordStepResult` when it
+     * parks). With findings: coerce + record them (`awaiting_selection`), raise the
+     * `pr_review_ready` card, and park on a durable decision-wait. With none (clean PR / degenerate
+     * output): record an empty `done` review in place and return `null` so the normal
+     * finish/advance spine completes the read-only step. Idempotent: a step already carrying a
+     * recorded review is left alone — an already-parked review stays parked (no re-coercion,
+     * which would re-mint the finding ids the human may be mid-selection on, nor a duplicate
+     * card), and a resolved/clean review falls through to the normal spine.
+     */
+    async recordFindings(workspaceId, instance, step, output, model, block) {
+        // A double-fire of the completion interceptor (a durable retry/replay) must not re-coerce:
+        // re-minting finding ids would strand the human's in-flight selection and re-raise the card.
+        // Keep an unresolved review parked; leave a resolved/clean one to the normal spine.
+        if (step.prReview && step.prReview.status !== 'reviewing') {
+            if (step.prReview.status === 'awaiting_selection') {
+                return this.deps.stateMachine.parkStepOnDecision(workspaceId, instance, step);
+            }
+            // This completion is the FIXER the `fix` resolution re-dispatched on this step (it pushed
+            // its fixes onto the PR branch): mark the review resolved, then fall through so the normal
+            // finish/advance spine completes the step. Any other terminal status (done / posting /
+            // skipped) already settled — leave it alone.
+            if (step.prReview.status === 'fixing') {
+                step.prReview = { ...step.prReview, status: 'done' };
+            }
+            return null;
+        }
+        const prUrl = block?.taskTypeFields?.prUrl?.trim() || null;
+        const { summary, slices, findings } = coercePrReview(output, () => this.deps.idGenerator.next('prs'), () => this.deps.idGenerator.next('prf'));
+        if (findings.length === 0) {
+            // A clean PR (or an unwired/degenerate reviewer): nothing to select. Record the review in
+            // place and let the normal completion spine finish the read-only step (no park).
+            step.prReview = {
+                status: 'done',
+                summary,
+                slices,
+                findings: [],
+                selectedFindingIds: [],
+                resolution: 'finish',
+                prUrl: prUrl ?? null,
+                model: model ?? null,
+            };
+            return null;
+        }
+        step.prReview = {
+            status: 'awaiting_selection',
+            summary,
+            slices,
+            findings,
+            selectedFindingIds: [],
+            resolution: null,
+            prUrl: prUrl ?? null,
+            model: model ?? null,
+        };
+        await this.raisePrReviewReady(workspaceId, instance, block, findings.length, slices.length);
+        return this.deps.stateMachine.parkStepOnDecision(workspaceId, instance, step);
+    }
+    /**
+     * Resolve a parked PR review: record the human's curated selection (`findingIds`, validated
+     * against the live findings) + the resolution, then act on it.
+     *
+     * - `finish` — mark the review `done` and advance the run past the gate. Mirrors the review
+     *   gate's resolved-gate advance: the pure in-memory advance runs inside the CAS, its side
+     *   effects (finalize / signal / emit) run once after, on the winning snapshot.
+     * - `fix` / `post` — RE-ARM the same `pr-reviewer` step (mirroring the fork-decision `choose`
+     *   phase-B re-dispatch) so the durable driver, on re-entry, either dispatches the Fixer
+     *   against the reviewed PR's head branch (`fix` → `status: 'fixing'`) or posts the selected
+     *   findings as inline PR comments (`post` → `status: 'posting'` + the `pendingPrReviewPost`
+     *   at-most-once marker). Both require ≥1 selected finding. `prReview` survives
+     *   `resetStepForRerun`, exactly like `forkDecision`.
+     */
+    async resolve(workspaceId, executionId, input) {
+        const action = input.action ?? 'finish';
+        let stepIndex = -1;
+        let approvalId;
+        let state;
+        const instance = await this.deps.stateMachine.mutateInstance(workspaceId, executionId, (inst) => {
+            stepIndex = inst.steps.findIndex((s) => s.agentKind === PR_REVIEW_STEP_KIND &&
+                s.state === 'waiting_decision' &&
+                s.approval?.status === 'pending' &&
+                s.prReview?.status === 'awaiting_selection');
+            const step = stepIndex === -1 ? undefined : inst.steps[stepIndex];
+            if (!step?.approval || !step.prReview) {
+                throw new ConflictError('The run is no longer awaiting a PR-review selection');
+            }
+            const known = new Set(step.prReview.findings?.map((f) => f.id) ?? []);
+            const selectedFindingIds = (input.findingIds ?? []).filter((id) => known.has(id));
+            if ((action === 'fix' || action === 'post') && selectedFindingIds.length === 0) {
+                throw new ConflictError(`Select at least one finding to ${action}.`);
+            }
+            if (action === 'finish') {
+                step.prReview = {
+                    ...step.prReview,
+                    status: 'done',
+                    resolution: 'finish',
+                    selectedFindingIds,
+                };
+                step.approval.status = 'approved';
+                this.deps.stateMachine.advanceRunPastGate(inst, stepIndex);
+                state = step.prReview;
+                return;
+            }
+            // fix / post: re-arm the SAME step for a second dispatch (the driver's pr-review
+            // resolution handler picks it up by status). Capture the approval id BEFORE the reset
+            // (which clears `step.approval`) so we can signal the parked driver afterwards.
+            approvalId = step.approval.id;
+            step.prReview = {
+                ...step.prReview,
+                status: action === 'fix' ? 'fixing' : 'posting',
+                resolution: action,
+                selectedFindingIds,
+            };
+            if (action === 'post')
+                step.pendingPrReviewPost = true;
+            this.deps.stepGraph.resetStepForRerun(step);
+            this.deps.stepGraph.startStep(step);
+            if (inst.status === 'blocked')
+                inst.status = 'running';
+            state = step.prReview;
+        });
+        await this.deps.stateMachine.clearWaitingNotification(workspaceId, instance);
+        if (action === 'finish') {
+            if (stepIndex !== -1) {
+                await this.deps.stateMachine.settleAdvancedGate(workspaceId, instance, stepIndex);
+            }
+            return state;
+        }
+        // fix / post: drive the re-armed step. The block is back in progress; wake the parked
+        // driver on the captured approval id so it re-enters and dispatches / posts (mirrors the
+        // fork-decision `choose` settle).
+        await this.deps.stateMachine.updateBlockProgress(workspaceId, instance, 'in_progress');
+        await this.deps.stateMachine.emitInstance(workspaceId, instance);
+        if (approvalId) {
+            await this.deps.workRunner.signalDecision(workspaceId, instance.id, approvalId, 'approved');
+        }
+        return state;
+    }
+    /** The active PR-review state for a run's GET, or null when no `pr-reviewer` step carries one. */
+    async getActive(workspaceId, executionId) {
+        const instance = await this.deps.executionRepository.get(workspaceId, executionId);
+        if (!instance)
+            return null;
+        return this.activePrReviewStep(instance)?.prReview ?? null;
+    }
+    /**
+     * The run's "active" PR-review step: prefer the step the run is currently on, else the latest
+     * `pr-reviewer` step that carries review state. Mirrors {@link ForkDecisionController.activeForkStep}.
+     */
+    activePrReviewStep(instance) {
+        const current = instance.steps[instance.currentStep];
+        if (current?.agentKind === PR_REVIEW_STEP_KIND && current.prReview)
+            return current;
+        for (let i = instance.steps.length - 1; i >= 0; i--) {
+            const s = instance.steps[i];
+            if (s.agentKind === PR_REVIEW_STEP_KIND && s.prReview)
+                return s;
+        }
+        return undefined;
+    }
+    /** Raise the "select PR-review findings" inbox card when the run parks. */
+    async raisePrReviewReady(workspaceId, instance, block, findingCount, sliceCount) {
+        if (!this.deps.notificationService || !block)
+            return;
+        await this.deps.notificationService.raise(workspaceId, {
+            type: 'pr_review_ready',
+            blockId: block.id,
+            executionId: instance.id,
+            title: `"${block.title}" — ${findingCount} review finding${findingCount === 1 ? '' : 's'} to triage`,
+            body: 'The PR reviewer sliced the pull request and surfaced prioritized findings. Open the ' +
+                'task to select which findings to act on.',
+            payload: { pipelineName: instance.pipelineName, findingCount, sliceCount },
+        });
+    }
+}
+//# sourceMappingURL=PrReviewController.js.map

package/dist/modules/execution/PrReviewController.js.map

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

package/dist/modules/execution/RunDispatcher.d.ts

@@ -1,4 +1,4 @@
-import type { AgentExecutor, AgentRunContext, AgentRunResult, Block, BlockRepository, BrainstormSession, ClarityReview, Clock, ExecutionEventPublisher, ExecutionInstance, ExecutionRepository, FollowUpsStepState, ForkDecisionStepState, ChooseForkInput, ForkChatRequestInput, GateDefinition, IdGenerator, IssueWritebackProvider, PipelineStep, ProviderCapabilities, ProvisionContext, RequirementConcernLevel, StepGating, RequirementReview, ResolveRunRepoContext, RunInitiatorScope, TicketTrackerProvider, WorkRunner } from '@cat-factory/kernel';
+import type { AgentExecutor, AgentRunContext, AgentRunResult, Block, BlockRepository, BrainstormSession, ClarityReview, Clock, ExecutionEventPublisher, ExecutionInstance, ExecutionRepository, FollowUpsStepState, ForkDecisionStepState, ChooseForkInput, ForkChatRequestInput, PrReviewStepState, ResolvePrReviewInput, GateDefinition, IdGenerator, IssueWritebackProvider, PipelineStep, ProviderCapabilities, ProvisionContext, RequirementConcernLevel, StepGating, RequirementReview, ResolveRunRepoContext, RunInitiatorScope, TicketTrackerProvider, WorkRunner } from '@cat-factory/kernel';
 import type { AgentKindRegistry } from '@cat-factory/agents';
 import type { BugIntakeService, EnvironmentProvisioningService } from '@cat-factory/integrations';
 import { AgentContextBuilder } from './AgentContextBuilder.js';
@@ -7,6 +7,7 @@ import { HumanTestController } from './HumanTestController.js';
 import { MergeResolver } from './MergeResolver.js';
 import { ReviewGateController, type ReviewKind } from './ReviewGateController.js';
 import { ForkDecisionController } from './ForkDecisionController.js';
+import { PrReviewController } from './PrReviewController.js';
 import type { InterviewGateController } from './InterviewGateController.js';
 import { RunStateMachine } from './RunStateMachine.js';
 import { StepGraph } from './StepGraph.js';
@@ -57,6 +58,7 @@ export interface RunDispatcherDeps {
     visualConfirmationController: VisualConfirmationController;
     reviewGate: ReviewGateController;
     forkDecisionController: ForkDecisionController;
+    prReviewController: PrReviewController;
     requirementsKind: ReviewKind<RequirementReview>;
     clarityKind: ReviewKind<ClarityReview>;
     requirementsBrainstormKind: ReviewKind<BrainstormSession>;
@@ -120,6 +122,7 @@ export declare class RunDispatcher {
     private readonly visualConfirmationController;
     private readonly reviewGate;
     private readonly forkDecisionController;
+    private readonly prReviewController;
     private readonly requirementsKind;
     private readonly clarityKind;
     private readonly requirementsBrainstormKind;
@@ -678,12 +681,52 @@ export declare class RunDispatcher {
      * completion is intercepted. A re-drive while `proposing` re-attaches to the running job.
      */
     private handleForkDecisionPhase;
+    /**
+     * Drive a re-armed PR-review step's RESOLUTION (PR 3). The human resolved a parked review with
+     * `fix` or `post`; {@link PrReviewController.resolve} re-armed this step and woke the driver.
+     * - `fixing`: dispatch the Fixer against the reviewed PR's head branch with the selected
+     *   findings folded in (parks on the job; its completion marks the review `done`).
+     * - `posting`: publish the selected findings as inline PR review comments, then finish the step.
+     */
+    private handlePrReviewResolution;
+    /**
+     * Dispatch the Fixer for a PR-review `fix` resolution. A `review` task carries no own work
+     * branch — it reviews an EXISTING PR — so resolve the PR's head branch (via the checkout-free
+     * `RepoFiles`) and point the Fixer's clone/push at it: fold a synthetic `pullRequest` + an
+     * apriori WORKING branch into the dispatch context so the shared `container-coding` +
+     * `clone:{branch:'pr'}` fixer body clones + pushes that branch (no new PR), and hand it the
+     * selected findings as a prior output (the same injection point the gate helpers use). Fails
+     * the run loudly when the PR branch can't be resolved (nothing to push to) rather than pushing
+     * blind. On a replay (jobId already set) it re-attaches without re-resolving.
+     */
+    private dispatchPrReviewFixer;
+    /**
+     * Post a PR-review `post` resolution: publish the human-selected findings as a single advisory
+     * (`COMMENT`) inline review on the reviewed PR via the checkout-free `RepoFiles.createReview`,
+     * then finish the step. At-most-once: the `pendingPrReviewPost` marker is consumed (cleared +
+     * persisted) BEFORE the (side-effecting) post so a Workflows retry can't submit it twice. When
+     * no VCS review write is wired (tests / no GitHub) the findings are still recorded and the step
+     * finishes — the review pipeline never reaches this without GitHub in practice.
+     *
+     * If `createReview` itself throws (GitHub rejects the batched review — e.g. a finding anchored
+     * to a line outside the PR diff 422s the WHOLE review — or a transient network/5xx error), the
+     * marker is already consumed, so a driver retry would NOT re-post. Rather than silently
+     * completing the step as `done` with nothing actually posted (the human would believe the
+     * comments landed), fail the step LOUDLY so the failure surfaces on the board — mirroring the
+     * `fix` resolution's loud preflight failure. `post` is a fallback resolution, so a hard failure
+     * is visible and the human can re-run or choose `fix`/`finish` instead.
+     */
+    private postPrReview;
     /** Read a run's active implementation-fork decision state, or null. */
     getForkDecision(workspaceId: string, executionId: string): Promise<ForkDecisionStepState | null>;
     /** Resolve the human's implementation-fork choice, re-running the Coder with it folded in. */
     chooseFork(workspaceId: string, executionId: string, input: ChooseForkInput): Promise<ForkDecisionStepState>;
     /** Send a grounded chat message about the surfaced forks (the reply arrives via the stream). */
     forkChat(workspaceId: string, executionId: string, input: ForkChatRequestInput): Promise<ForkDecisionStepState>;
+    /** Read a run's active PR deep-review state, or null. */
+    getPrReview(workspaceId: string, executionId: string): Promise<PrReviewStepState | null>;
+    /** Resolve a parked PR review: record the human's finding selection and advance the run. */
+    resolvePrReview(workspaceId: string, executionId: string, input: ResolvePrReviewInput): Promise<PrReviewStepState>;
     /**
      * Locate the run + the Coder step that OWNS the addressed item + the item, throwing 404
      * when absent. Routes by item id (not "the first enabled step") so a pipeline carrying more

package/dist/modules/execution/RunDispatcher.d.ts.map

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

package/dist/modules/execution/RunDispatcher.js

@@ -1,6 +1,6 @@
-import { ConflictError, DEFAULT_RISK_POLICY, failureKindFromHarnessCause, getErrorMessage, getErrorReason, getProvider, INITIATIVE_ANALYST_AGENT_KIND, INITIATIVE_COMMITTER_AGENT_KIND, INITIATIVE_PLANNER_AGENT_KIND, isAsyncAgentExecutor, NotFoundError, parseLocalModelId, recordGateAttempt, registeredGateFactories, registeredStepResolverFactories, requireProvider, RunContendedError, sameSubtasks, } from '@cat-factory/kernel';
+import { ConflictError, DEFAULT_RISK_POLICY, failureKindFromHarnessCause, FIXER_AGENT_KIND, getErrorMessage, getErrorReason, getProvider, INITIATIVE_ANALYST_AGENT_KIND, INITIATIVE_COMMITTER_AGENT_KIND, INITIATIVE_PLANNER_AGENT_KIND, isAsyncAgentExecutor, NotFoundError, parseLocalModelId, recordGateAttempt, registeredGateFactories, registeredStepResolverFactories, requireProvider, RunContendedError, sameSubtasks, } from '@cat-factory/kernel';
 import { frameProfile, frontendOriginsForService, parseBlueprintService, parseSpecDoc, resolveAprioriWorkingBranch, } from '@cat-factory/contracts';
-import { blueprintPostOp, commitInitiativeTracker, FORK_PROPOSER_KIND, hasTrait, isCompanionKind, isContainerBackedCompanion, INTERVIEW_GATE_TRAIT, moduleSlug, runRepoOps, specPostOp, TASK_ESTIMATOR_AGENT_KIND, } from '@cat-factory/agents';
+import { blueprintPostOp, commitInitiativeTracker, FORK_PROPOSER_KIND, PR_REVIEWER_KIND, hasTrait, isCompanionKind, isContainerBackedCompanion, INTERVIEW_GATE_TRAIT, moduleSlug, runRepoOps, specPostOp, TASK_ESTIMATOR_AGENT_KIND, } from '@cat-factory/agents';
 import { DEPLOYER_AGENT_KIND, isDeployStep } from '@cat-factory/integrations';
 import { BUG_INTAKE_AGENT_KIND } from '../pipelines/pipelineShape.js';
 import { coerceTaskEstimate, summarizeEstimate } from '../estimation/estimate.logic.js';
@@ -18,6 +18,8 @@ import { HumanTestController } from './HumanTestController.js';
 import { MergeResolver } from './MergeResolver.js';
 import { ReviewGateController } from './ReviewGateController.js';
 import { ForkDecisionController } from './ForkDecisionController.js';
+import { PrReviewController, PR_REVIEW_STEP_KIND } from './PrReviewController.js';
+import { buildPrReviewPost, renderPrReviewFixerFeedback } from './prReview.logic.js';
 import { DEFAULT_FORK_MAX_CHAT_TURNS, forkPhasePending, resolveForkTriState, shouldProposeForkAuto, } from './forkDecision.logic.js';
 import { RunStateMachine } from './RunStateMachine.js';
 import { StepGraph } from './StepGraph.js';
@@ -57,6 +59,19 @@ function parseRepoFromPullUrl(url) {
         return undefined;
     return { owner: match[1], repo: match[2] };
 }
+/**
+ * The PR number a `review` task targets: the explicit `prNumber` field wins, else parse it from
+ * the `prUrl` (`…/pull/42` on GitHub, `…/merge_requests/42` on GitLab). Undefined when neither
+ * yields one — the PR-review `fix`/`post` resolutions then report the PR unresolvable.
+ */
+function reviewPrNumber(block) {
+    const fields = block?.taskTypeFields;
+    if (typeof fields?.prNumber === 'number')
+        return fields.prNumber;
+    const url = fields?.prUrl?.trim();
+    const match = url ? /\/(?:pull|merge_requests)\/(\d+)/.exec(url) : null;
+    return match ? Number(match[1]) : undefined;
+}
 /**
  * The `peerEnvUrls` provision input for the frame about to be provisioned: a comma-joined set of
  * `slug=url` pairs for every target frame whose env is ALREADY ready this run — so a later
@@ -118,6 +133,7 @@ export class RunDispatcher {
     visualConfirmationController;
     reviewGate;
     forkDecisionController;
+    prReviewController;
     requirementsKind;
     clarityKind;
     requirementsBrainstormKind;
@@ -164,6 +180,7 @@ export class RunDispatcher {
         this.visualConfirmationController = deps.visualConfirmationController;
         this.reviewGate = deps.reviewGate;
         this.forkDecisionController = deps.forkDecisionController;
+        this.prReviewController = deps.prReviewController;
         this.requirementsKind = deps.requirementsKind;
         this.clarityKind = deps.clarityKind;
         this.requirementsBrainstormKind = deps.requirementsBrainstormKind;
@@ -212,7 +229,7 @@ export class RunDispatcher {
      * what the dispatch chain falls through to; all the deterministic / gate / inline-review
      * kinds are claimed earlier by their own handlers (see {@link buildStepHandlerRegistry}).
      */
-    async handleAgentStep(ctx, dispatchKind) {
+    async handleAgentStep(ctx, dispatchKind, augmentContext) {
         const { workspaceId, instance, step, block, isFinalStep, options } = ctx;
         // Async (container) steps don't block: dispatch the job and park. The durable
         // driver polls `pollAgentJob` between sleeps so the run can span far longer
@@ -225,6 +242,10 @@ export class RunDispatcher {
         // job as a HELPER off the coder step (Phase A). The completion still records against the
         // coder step, and the fork-proposal interceptor keys on `step.agentKind` + the fork state.
         const context = await this.contextBuilder.buildContext(workspaceId, instance, step, isFinalStep, block, dispatchKind ? { agentKind: dispatchKind } : undefined);
+        // A caller re-dispatching this step under an overriding kind can fold extra context in
+        // (e.g. the PR-review `fix` resolution points the Fixer at the reviewed PR's head branch and
+        // hands it the selected findings). Runs before pre-ops / dispatch so the job body sees it.
+        augmentContext?.(context);
         // A registered custom kind's PRE-ops run deterministic backend repo work before the
         // agent dispatches (e.g. read a baseline `spec/` shard into the prompt). Gated on the
         // step not having dispatched yet so a Workflows replay (jobId already set) doesn't
@@ -2277,6 +2298,19 @@ export class RunDispatcher {
                 canHandle: ({ step, block }) => forkPhasePending(step, resolveForkTriState(block.agentConfig)),
                 handle: (ctx) => this.handleForkDecisionPhase(ctx),
             },
+            // The PR deep-review RESOLUTION phase (PR 3): after the human resolved a parked review with
+            // `fix` / `post`, `PrReviewController.resolve` re-armed this `pr-reviewer` step and woke the
+            // driver. Claim it by the re-armed status so it re-dispatches as the Fixer (`fixing`) or
+            // posts the selected findings as inline PR comments (`posting`) — never the generic
+            // pr-reviewer clone the fallthrough would run. A `reviewing`/`awaiting_selection`/resolved
+            // step falls through (this handler doesn't claim it). See {@link handlePrReviewResolution}.
+            {
+                kind: 'pr-review-resolution',
+                order: 175,
+                canHandle: ({ step }) => step.agentKind === PR_REVIEW_STEP_KIND &&
+                    (step.prReview?.status === 'fixing' || step.prReview?.status === 'posting'),
+                handle: (ctx) => this.handlePrReviewResolution(ctx),
+            },
             // The generic container/inline-agent step — claims every step no more-specific handler
             // did. Highest order so it always runs last. See {@link handleAgentStep}.
             {
@@ -2347,6 +2381,23 @@ export class RunDispatcher {
                     return this.forkDecisionController.recordProposal(workspaceId, instance, step, proposal, step.model);
                 },
             },
+            // The read-only `pr-reviewer` deep-review job just finished on a review task's step. Its
+            // structured `result.custom` is the sliced, prioritized findings; record them onto the
+            // step's `prReview` and PARK for the human to select which findings matter (≥1 finding),
+            // rather than the normal completion. A clean PR (no findings) returns null and falls
+            // through to the normal finish. Keyed on the `pr-reviewer` step kind.
+            {
+                kind: 'pr-review',
+                order: 106,
+                canIntercept: ({ step }) => step.agentKind === PR_REVIEW_STEP_KIND,
+                intercept: async ({ workspaceId, instance, step, result }) => {
+                    const output = this.agentKindRegistry
+                        .structuredOutput(PR_REVIEWER_KIND)
+                        ?.safeParse(result.custom);
+                    const block = await this.blockRepository.get(workspaceId, instance.blockId);
+                    return this.prReviewController.recordFindings(workspaceId, instance, step, output, result.model ?? step.model, block);
+                },
+            },
             // A `tester` step returned a structured report. On a withheld greenlight we do NOT
             // finish the step: loop the `fixer` (within the attempt budget) and re-test, mirroring
             // the CI gate. A greenlight (or no provider) returns null and falls through to the
@@ -2883,6 +2934,122 @@ export class RunDispatcher {
         // Dispatch (or re-attach to) the proposer as a helper off this coder step.
         return this.handleAgentStep(ctx, FORK_PROPOSER_KIND);
     }
+    /**
+     * Drive a re-armed PR-review step's RESOLUTION (PR 3). The human resolved a parked review with
+     * `fix` or `post`; {@link PrReviewController.resolve} re-armed this step and woke the driver.
+     * - `fixing`: dispatch the Fixer against the reviewed PR's head branch with the selected
+     *   findings folded in (parks on the job; its completion marks the review `done`).
+     * - `posting`: publish the selected findings as inline PR review comments, then finish the step.
+     */
+    async handlePrReviewResolution(ctx) {
+        const { step } = ctx;
+        if (step.prReview?.status === 'posting')
+            return this.postPrReview(ctx);
+        return this.dispatchPrReviewFixer(ctx);
+    }
+    /**
+     * Dispatch the Fixer for a PR-review `fix` resolution. A `review` task carries no own work
+     * branch — it reviews an EXISTING PR — so resolve the PR's head branch (via the checkout-free
+     * `RepoFiles`) and point the Fixer's clone/push at it: fold a synthetic `pullRequest` + an
+     * apriori WORKING branch into the dispatch context so the shared `container-coding` +
+     * `clone:{branch:'pr'}` fixer body clones + pushes that branch (no new PR), and hand it the
+     * selected findings as a prior output (the same injection point the gate helpers use). Fails
+     * the run loudly when the PR branch can't be resolved (nothing to push to) rather than pushing
+     * blind. On a replay (jobId already set) it re-attaches without re-resolving.
+     */
+    async dispatchPrReviewFixer(ctx) {
+        const { workspaceId, instance, step, block } = ctx;
+        const review = step.prReview;
+        const selected = (review.findings ?? []).filter((f) => review.selectedFindingIds?.includes(f.id));
+        let headRef = null;
+        let prNumber;
+        if (!step.jobId) {
+            prNumber = reviewPrNumber(block);
+            const runRepo = prNumber != null ? await this.resolveRunRepoContext?.(workspaceId, block.id) : null;
+            const repo = runRepo?.repo;
+            headRef =
+                prNumber != null && repo?.pullRequestHeadRef
+                    ? await this.runInitiatorScope(instance.initiatedBy, () => repo.pullRequestHeadRef(prNumber))
+                    : null;
+            if (prNumber == null || !headRef) {
+                return {
+                    kind: 'job_failed',
+                    failureKind: 'preflight',
+                    error: "Can't resolve the reviewed pull request's head branch to push fixes to. The " +
+                        "'fix' resolution needs a same-repo pull request on this service's linked repository " +
+                        '(a cross-repo or fork PR is not yet supported — post the findings as comments instead).',
+                };
+            }
+        }
+        const resolvedHeadRef = headRef;
+        const resolvedPrNumber = prNumber;
+        return this.handleAgentStep(ctx, FIXER_AGENT_KIND, (context) => {
+            if (resolvedHeadRef && resolvedPrNumber != null) {
+                context.block.pullRequest = {
+                    number: resolvedPrNumber,
+                    branch: resolvedHeadRef,
+                    url: review.prUrl ?? '',
+                };
+                // Build inside the PR head branch (probed, never created) so the work-branch machinery
+                // targets it rather than minting a stray `cat-factory/<blockId>` off base.
+                context.aprioriBranches = [{ name: resolvedHeadRef, mode: 'working' }];
+            }
+            context.priorOutputs = [
+                ...context.priorOutputs,
+                { agentKind: FIXER_AGENT_KIND, output: renderPrReviewFixerFeedback(selected) },
+            ];
+        });
+    }
+    /**
+     * Post a PR-review `post` resolution: publish the human-selected findings as a single advisory
+     * (`COMMENT`) inline review on the reviewed PR via the checkout-free `RepoFiles.createReview`,
+     * then finish the step. At-most-once: the `pendingPrReviewPost` marker is consumed (cleared +
+     * persisted) BEFORE the (side-effecting) post so a Workflows retry can't submit it twice. When
+     * no VCS review write is wired (tests / no GitHub) the findings are still recorded and the step
+     * finishes — the review pipeline never reaches this without GitHub in practice.
+     *
+     * If `createReview` itself throws (GitHub rejects the batched review — e.g. a finding anchored
+     * to a line outside the PR diff 422s the WHOLE review — or a transient network/5xx error), the
+     * marker is already consumed, so a driver retry would NOT re-post. Rather than silently
+     * completing the step as `done` with nothing actually posted (the human would believe the
+     * comments landed), fail the step LOUDLY so the failure surfaces on the board — mirroring the
+     * `fix` resolution's loud preflight failure. `post` is a fallback resolution, so a hard failure
+     * is visible and the human can re-run or choose `fix`/`finish` instead.
+     */
+    async postPrReview(ctx) {
+        const { workspaceId, instance, step, block, isFinalStep } = ctx;
+        const review = step.prReview;
+        const selected = (review.findings ?? []).filter((f) => review.selectedFindingIds?.includes(f.id));
+        let posted = false;
+        if (step.pendingPrReviewPost) {
+            step.pendingPrReviewPost = null;
+            await this.runStateMachine.casPersist(workspaceId, instance);
+            const prNumber = reviewPrNumber(block);
+            const runRepo = prNumber != null ? await this.resolveRunRepoContext?.(workspaceId, block.id) : null;
+            const repo = runRepo?.repo;
+            if (prNumber != null && repo?.createReview) {
+                try {
+                    await this.runInitiatorScope(instance.initiatedBy, () => repo.createReview(prNumber, buildPrReviewPost(selected, review.summary)));
+                }
+                catch (error) {
+                    return {
+                        kind: 'job_failed',
+                        failureKind: 'agent',
+                        error: `Failed to post the ${selected.length} selected finding` +
+                            `${selected.length === 1 ? '' : 's'} as a pull-request review: ${getErrorMessage(error)}. ` +
+                            'GitHub rejects a review whose inline comment anchors a line outside the PR diff — ' +
+                            "try the 'fix' resolution, or re-run to post again.",
+                    };
+                }
+                posted = true;
+            }
+        }
+        step.prReview = { ...review, status: 'done' };
+        const output = posted
+            ? `Posted ${selected.length} review comment${selected.length === 1 ? '' : 's'} to the pull request.`
+            : `Recorded ${selected.length} selected finding${selected.length === 1 ? '' : 's'}.`;
+        return this.recordStepResult(workspaceId, instance, step, isFinalStep, { output });
+    }
     /** Read a run's active implementation-fork decision state, or null. */
     getForkDecision(workspaceId, executionId) {
         return this.forkDecisionController.getActive(workspaceId, executionId);
@@ -2895,6 +3062,14 @@ export class RunDispatcher {
     forkChat(workspaceId, executionId, input) {
         return this.forkDecisionController.chat(workspaceId, executionId, input);
     }
+    /** Read a run's active PR deep-review state, or null. */
+    getPrReview(workspaceId, executionId) {
+        return this.prReviewController.getActive(workspaceId, executionId);
+    }
+    /** Resolve a parked PR review: record the human's finding selection and advance the run. */
+    resolvePrReview(workspaceId, executionId, input) {
+        return this.prReviewController.resolve(workspaceId, executionId, input);
+    }
     /**
      * Locate the run + the Coder step that OWNS the addressed item + the item, throwing 404
      * when absent. Routes by item id (not "the first enabled step") so a pipeline carrying more