@cat-factory/orchestration 0.128.0 → 0.129.1

package/dist/modules/execution/RunRepoOpsController.js

@@ -0,0 +1,251 @@
+import { resolveAprioriWorkingBranch } from '@cat-factory/contracts';
+import { blueprintPostOp, runRepoOps, specPostOp } from '@cat-factory/agents';
+import { BLUEPRINTS_AGENT_KIND, MERGER_AGENT_KIND, SPEC_WRITER_AGENT_KIND } from './ci.logic.js';
+/**
+ * Whether a run delivers a committing kind's artifact through a PULL REQUEST rather than a
+ * direct commit — true when the pipeline carries a `merger` step to merge that PR. Threaded to
+ * the pre/post-op {@link RepoOpContext} so a delivering kind (e.g. `spike`) follows the chosen
+ * pipeline's shape (PR tail ⇒ open a PR; no tail ⇒ commit direct) with no separate per-task flag
+ * to drift. Mirrors {@link RunStateMachine.finalizeBlock}'s `hasMerger` distinction.
+ */
+function runOpensPr(instance) {
+    return instance.steps.some((s) => s.agentKind === MERGER_AGENT_KIND);
+}
+/**
+ * Runs a registered / built-in agent kind's deterministic backend repo hooks (`preOps` /
+ * `postOps`) over a checkout-free {@link RepoFiles}, resolving the concrete branch each hook
+ * reads or writes so it operates on the SAME branch the container agent does. Extracted from
+ * {@link RunDispatcher} as a cohesive collaborator (the branch-resolution + hook-execution
+ * seam); the dispatcher delegates its pre/post-op call sites here.
+ */
+export class RunRepoOpsController {
+    blockRepository;
+    contextBuilder;
+    agentKindRegistry;
+    resolveRunRepoContext;
+    issueWriteback;
+    constructor(deps) {
+        this.blockRepository = deps.blockRepository;
+        this.contextBuilder = deps.contextBuilder;
+        this.agentKindRegistry = deps.agentKindRegistry;
+        this.resolveRunRepoContext = deps.resolveRunRepoContext;
+        this.issueWriteback = deps.issueWriteback;
+    }
+    /**
+     * Resolve the concrete branch a registered kind's pre/post-op reads or writes, from
+     * its declared clone target — mirroring the container executor's mapping so a backend
+     * op and the container agent operate on the SAME branch:
+     *   - `base` → the repo default branch (the ONLY way a committing op targets `main`).
+     *   - `pr`   → the block's PR branch (the coder's branch); when no PR is open, the
+     *              per-block work branch (created from base if missing) — NOT base, so a
+     *              committing post-op can't silently land on the default branch.
+     *   - `work` (default) → the per-block work branch, ENSURED to exist exactly as
+     *              {@link ContainerAgentExecutor}'s `ensureWorkBranch` does. The old code
+     *              returned base here whenever no PR was open yet, diverging from the
+     *              container agent (which clones `cat-factory/<blockId>`) and letting a
+     *              post-op commit onto the default branch.
+     * The work-branch name (`cat-factory/<blockId>`) is the same convention
+     * {@link ContainerAgentExecutor} uses.
+     */
+    async resolveRepoOpBranch(step, block, runRepo) {
+        const { repo, baseBranch } = runRepo;
+        const prBranch = block.pullRequest?.branch;
+        // An apriori WORKING branch overrides the deterministic work branch: the backend op must
+        // read/write the SAME branch the container agent builds inside. It is probe-only (a
+        // missing branch fails loudly, never a silent create — the mirror of the executor).
+        const aprioriWork = this.aprioriWorkBranch(block, baseBranch);
+        const workBranch = aprioriWork ?? `cat-factory/${block.id}`;
+        switch (step?.clone?.branch) {
+            case 'base':
+                return baseBranch;
+            case 'pr':
+            // `pr-or-work` reads/writes the PR branch when one exists (amend in place), else the work
+            // branch — the same resolution as `pr`, so it shares this arm.
+            case 'pr-or-work':
+                return prBranch ?? (await this.ensureWorkBranch(repo, workBranch, baseBranch, aprioriWork));
+            default:
+                // 'work' (or unspecified): the work branch the container agent operates on. A PR
+                // is normally opened on that branch, but even before one exists we ensure it so
+                // the backend op and the container agent share the same branch.
+                return prBranch && prBranch !== workBranch
+                    ? prBranch
+                    : await this.ensureWorkBranch(repo, workBranch, baseBranch, aprioriWork);
+        }
+    }
+    /**
+     * The task's apriori WORKING branch (an existing branch it names as the run's starting
+     * point), or undefined when none is set. Rejects the degenerate case where it equals the
+     * repo base — the run would have nothing to diff / no PR to open — via the same shared
+     * `resolveAprioriWorkingBranch` guard the executor uses, so the two rejections can't drift.
+     */
+    aprioriWorkBranch(block, baseBranch) {
+        return resolveAprioriWorkingBranch(block.aprioriBranches, baseBranch);
+    }
+    /**
+     * Ensure the per-block work branch `cat-factory/<blockId>` exists — creating it from the
+     * repo default branch's head when absent — and return it. The checkout-free analogue of
+     * {@link ContainerAgentExecutor}'s `ensureWorkBranch`, so a backend pre/post-op writes
+     * the SAME branch the container agent does instead of the default branch. Falls back to
+     * the base branch only when the repo has no default-branch head to fork from (an empty
+     * repo), so the caller always gets a real branch.
+     *
+     * `apriori` (the resolved apriori working branch name, when this run has one) flips the
+     * behaviour to PROBE-ONLY: an apriori branch must pre-exist, so a missing one throws
+     * loudly rather than being silently created off base (the mirror of the executor's rule).
+     */
+    async ensureWorkBranch(repo, workBranch, baseBranch, apriori) {
+        if (await repo.headSha(workBranch))
+            return workBranch;
+        if (apriori) {
+            throw new Error(`Apriori working branch '${workBranch}' does not exist on the target repo; ` +
+                `push it before starting the run (the platform never creates an apriori branch).`);
+        }
+        const baseSha = await repo.headSha(baseBranch);
+        if (!baseSha)
+            return baseBranch;
+        await repo.createBranch(workBranch, baseSha);
+        return workBranch;
+    }
+    /**
+     * Run a registered kind's PRE-op hooks before its agent step dispatches: deterministic
+     * backend work (read a baseline artifact into the prompt, etc.) over a checkout-free
+     * {@link RepoFiles}. No-op for built-in / unregistered kinds, when the kind declares no
+     * pre-ops, or when GitHub isn't wired (no `resolveRunRepoContext`) — so the engine runs
+     * unchanged without the feature. A throwing op propagates to fail the step.
+     */
+    async runRegisteredPreOps(workspaceId, instance, block, step, context) {
+        const ops = this.agentKindRegistry.preOps(step.agentKind);
+        if (ops.length === 0)
+            return;
+        const runRepo = await this.resolveRunRepo(workspaceId, block.id);
+        if (!runRepo)
+            return;
+        const branch = await this.resolveRepoOpBranch(this.agentKindRegistry.agentStep(step.agentKind), block, runRepo);
+        await runRepoOps(ops, { repo: runRepo.repo, context, branch, opensPr: runOpensPr(instance) });
+    }
+    /**
+     * Resolve a block's run-repo context for its pre/post-op hooks. Returns null only when
+     * the resolver is UNWIRED (tests / GitHub not connected) so a deployment without the
+     * feature simply skips the hooks. When the resolver IS wired, its result — including a
+     * THROW from `resolveRepoTarget` for a block that isn't under a linked service — is
+     * propagated as-is: a registered kind with repo hooks run on a misconfigured block fails
+     * the run loudly rather than silently committing nothing (or guessing a repo), the same
+     * way a container custom kind fails at dispatch.
+     */
+    async resolveRunRepo(workspaceId, blockId) {
+        if (!this.resolveRunRepoContext)
+            return null;
+        return this.resolveRunRepoContext(workspaceId, blockId);
+    }
+    /**
+     * Run a registered kind's POST-op hooks after its agent step's result is recorded:
+     * deterministic backend work that consumes the agent's structured output (coerce its
+     * JSON, render artifact files, commit them via {@link RepoFiles}) — the
+     * blueprint/spec rendering that used to live in the harness. Same gating + symmetry as
+     * {@link runRegisteredPreOps}; the agent's {@link AgentRunResult} is threaded through.
+     */
+    async runRegisteredPostOps(workspaceId, instance, step, isFinalStep, result) {
+        const registered = this.agentKindRegistry.postOps(step.agentKind);
+        const builtIn = this.builtInPostOps(step.agentKind);
+        if (registered.length === 0 && builtIn.length === 0)
+            return;
+        const block = await this.blockRepository.get(workspaceId, instance.blockId);
+        if (!block)
+            return;
+        const runRepo = await this.resolveRunRepo(workspaceId, block.id);
+        if (!runRepo)
+            return;
+        const context = await this.contextBuilder.buildContext(workspaceId, instance, step, isFinalStep, block);
+        const opensPr = runOpensPr(instance);
+        // Registered (custom) kinds resolve their branch from their declared clone target.
+        if (registered.length > 0) {
+            const branch = await this.resolveRepoOpBranch(this.agentKindRegistry.agentStep(step.agentKind), block, runRepo);
+            const opResult = await runRepoOps(registered, {
+                repo: runRepo.repo,
+                context,
+                branch,
+                opensPr,
+                result,
+            });
+            // A delivering kind (e.g. `spike` in PR mode) opened a PR for the findings; record it on
+            // the block so the downstream conflicts/CI/human-review/merge tail acts on it — the SAME
+            // linkage a container-coding step's `result.pullRequest` produces (see recordStepResult).
+            if (opResult.pullRequest) {
+                await this.recordPostOpPullRequest(workspaceId, block.id, opResult.pullRequest);
+            }
+        }
+        // Built-in (migrated) kinds resolve their branch to MATCH their container dispatch
+        // exactly (see {@link builtInRepoOpBranch}), which differs from the generic clone
+        // resolution for the no-PR case — so the post-op commits where the agent read.
+        if (builtIn.length > 0) {
+            const branch = await this.builtInRepoOpBranch(step.agentKind, block, runRepo);
+            await runRepoOps(builtIn, { repo: runRepo.repo, context, branch, opensPr, result });
+        }
+    }
+    /**
+     * Record a pull request a registered post-op opened onto the block, mirroring the
+     * container-coding path in {@link recordStepResult}: set `block.pullRequest`, and (when newly
+     * opened) fire the best-effort tracker-issue writeback. Idempotent — re-recording the same PR
+     * (a durable-driver replay) writes the same ref and skips the non-idempotent writeback.
+     */
+    async recordPostOpPullRequest(workspaceId, blockId, pullRequest) {
+        const priorBlock = await this.blockRepository.get(workspaceId, blockId);
+        if (priorBlock?.pullRequest?.url === pullRequest.url)
+            return;
+        await this.blockRepository.update(workspaceId, blockId, { pullRequest });
+        if (this.issueWriteback && priorBlock) {
+            await this.issueWriteback
+                .onPullRequestOpened(workspaceId, priorBlock, pullRequest)
+                .catch(() => { });
+        }
+    }
+    /**
+     * The BUILT-IN (non-registry) post-ops for a migrated built-in kind, keyed by agent
+     * kind — the deterministic render + commit lifted out of the executor-harness. Kept
+     * OUT of the agent-kind registry on purpose: registering the built-ins would leak them
+     * into `customAgentKinds` / the SPA palette. Empty for every other kind.
+     */
+    builtInPostOps(agentKind) {
+        return RunRepoOpsController.BUILT_IN_POST_OPS[agentKind] ?? [];
+    }
+    /**
+     * The built-in (NON-registry) post-ops keyed by kind. A small map rather than an
+     * `if`-chain so each migrated built-in is one entry as the strangler converts more
+     * kinds; deliberately NOT the agent-kind registry (that would leak the built-ins into
+     * `customAgentKinds` / the SPA palette).
+     */
+    static BUILT_IN_POST_OPS = {
+        [BLUEPRINTS_AGENT_KIND]: [blueprintPostOp],
+        [SPEC_WRITER_AGENT_KIND]: [specPostOp],
+    };
+    /**
+     * The branch a built-in kind's post-op reads/commits, resolved to MATCH the kind's
+     * container dispatch (so the post-op commits onto exactly the branch the explore agent
+     * cloned).
+     *  - blueprints clones the PR branch when one is open, else the repo's default branch —
+     *    so the initial bootstrap map lands directly on the default branch, mirroring
+     *    {@link ContainerAgentExecutor}'s `pr`-clone resolution (`prBranch ?? baseBranch`).
+     *    Deliberately NOT {@link resolveRepoOpBranch}, whose `pr` case ensures a work branch
+     *    for the no-PR case — correct for a committing CUSTOM kind, wrong for the blueprint.
+     *  - spec-writer commits onto the per-block WORK branch (`cat-factory/<blockId>`), created
+     *    from base when absent. It is a WRITER (not read-only), so its container dispatch
+     *    always ensures + clones that work branch ({@link ContainerAgentExecutor}'s
+     *    `workBranchReady ? workBranch : …` resolves to the work branch). We mirror that
+     *    DETERMINISTICALLY here — NOT via {@link resolveRepoOpBranch}'s `work` case, whose
+     *    PR-preferring branch would commit onto a divergent PR branch (read one tree, write
+     *    another) if a PR were ever open on a branch other than `cat-factory/<blockId>`.
+     */
+    async builtInRepoOpBranch(agentKind, block, runRepo) {
+        if (agentKind === SPEC_WRITER_AGENT_KIND) {
+            // The spec-writer commits onto the run's WORK branch — the apriori working branch when
+            // the task names one (probe-only, must pre-exist), else the deterministic per-block
+            // branch. Miss this swap and the spec lands on a phantom `cat-factory/<blockId>` while
+            // the agent explored the apriori branch.
+            const aprioriWork = this.aprioriWorkBranch(block, runRepo.baseBranch);
+            const workBranch = aprioriWork ?? `cat-factory/${block.id}`;
+            return this.ensureWorkBranch(runRepo.repo, workBranch, runRepo.baseBranch, aprioriWork);
+        }
+        return block.pullRequest?.branch ?? runRepo.baseBranch;
+    }
+}
+//# sourceMappingURL=RunRepoOpsController.js.map

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

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

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

@@ -1,4 +1,4 @@
-import type { CreateReviewInput, PrReviewAgentOutput, PrReviewFinding, PrReviewSeverity, PrReviewSlice } from '@cat-factory/kernel';
+import type { CreateReviewInput, PrReviewAgentOutput, PrReviewFinding, PrReviewSeverity, PrReviewSlice, PrReviewStepState } from '@cat-factory/kernel';
 /** The blocker-first rank of a severity (unknown → medium's rank, matching the fallback). */
 export declare function severityRank(severity: PrReviewSeverity): number;
 /** The coerced, id-stamped review the engine records onto `step.prReview`. */
@@ -7,6 +7,16 @@ export interface CoercedPrReview {
     slices: PrReviewSlice[];
     findings: PrReviewFinding[];
 }
+/**
+ * The in-flight review state seeded onto a `pr-reviewer` step the moment its container job is
+ * dispatched, so a review run surfaces a real `reviewing` phase in the deep-review window — the
+ * reviewed PR, the model, and (via the step's live todo subtasks) the slices-reviewed-so-far
+ * progress — instead of an empty panel until the findings land. It is superseded by
+ * {@link coercePrReview}'s result when the reviewer returns (`awaiting_selection`/`done`); the
+ * `recordFindings` interceptor treats this `reviewing` status as "not yet recorded" and coerces
+ * over it, while any later status short-circuits as already-settled.
+ */
+export declare function initialPrReviewState(prUrl: string | null, model: string | null): PrReviewStepState;
 /**
  * Coerce the reviewer's lenient output into the persisted review shape: mint stable ids for
  * every slice + finding, anchor each finding to the slice that lists its path (first match

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

@@ -1 +1 @@
-{"version":3,"file":"prReview.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/execution/prReview.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACd,MAAM,qBAAqB,CAAA;AAiB5B,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAE/D;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,WAAW,EAAE,MAAM,MAAM,EACzB,aAAa,EAAE,MAAM,MAAM,GAC1B,eAAe,CAoDjB;AAmBD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM,CAgB/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,eAAe,EAAE,EAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,iBAAiB,CAmCnB"}
+{"version":3,"file":"prReview.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/execution/prReview.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EAClB,MAAM,qBAAqB,CAAA;AAiB5B,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAE/D;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,iBAAiB,CAWnB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,WAAW,EAAE,MAAM,MAAM,EACzB,aAAa,EAAE,MAAM,MAAM,GAC1B,eAAe,CAoDjB;AAmBD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM,CAgB/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,eAAe,EAAE,EAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,iBAAiB,CAmCnB"}

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

@@ -15,6 +15,27 @@ const SEVERITY_RANK = {
 export function severityRank(severity) {
     return SEVERITY_RANK[severity] ?? SEVERITY_RANK.medium;
 }
+/**
+ * The in-flight review state seeded onto a `pr-reviewer` step the moment its container job is
+ * dispatched, so a review run surfaces a real `reviewing` phase in the deep-review window — the
+ * reviewed PR, the model, and (via the step's live todo subtasks) the slices-reviewed-so-far
+ * progress — instead of an empty panel until the findings land. It is superseded by
+ * {@link coercePrReview}'s result when the reviewer returns (`awaiting_selection`/`done`); the
+ * `recordFindings` interceptor treats this `reviewing` status as "not yet recorded" and coerces
+ * over it, while any later status short-circuits as already-settled.
+ */
+export function initialPrReviewState(prUrl, model) {
+    return {
+        status: 'reviewing',
+        summary: null,
+        slices: [],
+        findings: [],
+        selectedFindingIds: [],
+        resolution: null,
+        prUrl,
+        model,
+    };
+}
 /**
  * Coerce the reviewer's lenient output into the persisted review shape: mint stable ids for
  * every slice + finding, anchor each finding to the slice that lists its path (first match

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/orchestration",
-  "version": "0.128.0",
+  "version": "0.129.1",
   "description": "Delivery-workflow engine for the Agent Architecture Board (execution, bootstrap, pipelines, board, boardScan, requirements, and composition root).",
   "repository": {
     "type": "git",
@@ -25,20 +25,20 @@
   },
   "dependencies": {
     "ai": "^6.0.230",
-    "@cat-factory/agents": "0.65.3",
-    "@cat-factory/caching": "0.10.16",
-    "@cat-factory/contracts": "0.152.0",
-    "@cat-factory/integrations": "0.88.4",
-    "@cat-factory/kernel": "0.145.1",
-    "@cat-factory/prompt-fragments": "0.13.43",
-    "@cat-factory/sandbox": "0.9.112",
-    "@cat-factory/spend": "0.12.60",
-    "@cat-factory/workspaces": "0.17.3"
+    "@cat-factory/agents": "0.65.5",
+    "@cat-factory/caching": "0.10.17",
+    "@cat-factory/contracts": "0.152.1",
+    "@cat-factory/integrations": "0.88.5",
+    "@cat-factory/kernel": "0.146.0",
+    "@cat-factory/prompt-fragments": "0.13.44",
+    "@cat-factory/sandbox": "0.9.114",
+    "@cat-factory/spend": "0.12.61",
+    "@cat-factory/workspaces": "0.17.4"
   },
   "devDependencies": {
     "typescript": "7.0.2",
     "vitest": "^4.1.10",
-    "@cat-factory/sandbox-fixtures": "0.7.178"
+    "@cat-factory/sandbox-fixtures": "0.7.179"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",