@urateam/core 0.1.0

package/dist/executor/deep-review.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Deep review: runs 3 parallel sub-agents (reuse, quality, efficiency) to
+ * produce hardened code-review findings. Corresponds to the /simplify
+ * pattern — each agent specialises in one dimension of code quality.
+ */
+import type { HandoffArtifact, ReviewFinding } from "../types.js";
+export interface DeepReviewFinding {
+    agent: "reuse" | "quality" | "efficiency";
+    severity: "blocking" | "warning" | "suggestion";
+    file: string;
+    line: number;
+    category: string;
+    description: string;
+    fix: string;
+}
+export interface DeepReviewResult {
+    findings: DeepReviewFinding[];
+    /** Total input tokens used across all 3 sub-agents. */
+    inputTokens: number;
+    /** Total output tokens used across all 3 sub-agents. */
+    outputTokens: number;
+}
+/**
+ * Reuse agent: source files only.
+ * Skips tests, configs, docs, generated output, and static assets.
+ */
+export declare function filterReuseFiles(files: string[]): string[];
+/**
+ * Efficiency agent: hot-path source files.
+ * Skips tests, static assets, and generated output.
+ */
+export declare function filterEfficiencyFiles(files: string[]): string[];
+/**
+ * Quality agent: all source files but not generated/dist output.
+ */
+export declare function filterQualityFiles(files: string[]): string[];
+/**
+ * Run the three parallel deep-review sub-agents (reuse, quality, efficiency)
+ * against the current worktree state.
+ *
+ * Returns aggregated findings and combined token usage. Sub-agent failures are
+ * swallowed (logged) so the pipeline is not blocked by infra issues.
+ *
+ * Optimisations applied:
+ * - diff-stat computed once and shared across all three sub-agents.
+ * - Handoff trimmed to summary + file list only (no issue data / acceptance
+ *   criteria) to reduce prompt size.
+ * - Each agent receives only the file subset relevant to its focus area.
+ */
+export declare function runDeepReview(handoff: HandoffArtifact, workdir: string): Promise<DeepReviewResult>;
+/**
+ * Convert DeepReviewFindings to ReviewFindings for use in handoff context.
+ * This allows downstream stages to see deep-review output as standard findings.
+ */
+export declare function deepFindingsToReviewFindings(findings: DeepReviewFinding[]): ReviewFinding[];
+/**
+ * Build a prompt context block for the implement agent describing the deep
+ * review findings it should address.
+ */
+export declare function buildDeepReviewContext(pass: number, findings: DeepReviewFinding[], previousHandoff: HandoffArtifact): string;
+//# sourceMappingURL=deep-review.d.ts.map

package/dist/executor/deep-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-review.d.ts","sourceRoot":"","sources":["../../src/executor/deep-review.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAclE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC;IAC1C,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;CACtB;AAyDD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAS1D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAO/D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAE5D;AA+KD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC,CAmD3B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,aAAa,EAAE,CASjB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,eAAe,EAAE,eAAe,GAC/B,MAAM,CAqCR"}

package/dist/executor/deep-review.js

@@ -0,0 +1,308 @@
+/**
+ * Deep review: runs 3 parallel sub-agents (reuse, quality, efficiency) to
+ * produce hardened code-review findings. Corresponds to the /simplify
+ * pattern — each agent specialises in one dimension of code quality.
+ */
+import { gitExecSafe } from "../repo/git.js";
+import { createLogger } from "../logger.js";
+import { consumeAgentStream, parseJsonBlock } from "./agent-stream.js";
+import { buildStagePermissionOptions } from "./permissions.js";
+import { sanitize, buildSandboxedBlock } from "./prompt/sanitizer.js";
+const log = createLogger({ component: "DeepReview" });
+const DEEP_REVIEW_MODEL = "claude-haiku-4-5-20251001";
+// ---------------------------------------------------------------------------
+// File subset filters
+// ---------------------------------------------------------------------------
+/** Patterns identifying test files. */
+const TEST_PATTERNS = [
+    /\.test\.[jt]sx?$/,
+    /\.spec\.[jt]sx?$/,
+    /(^|\/)__tests__\//,
+    /(^|\/)tests?\//,
+];
+/** Patterns identifying generated or dist output. */
+const GENERATED_PATTERNS = [
+    /(^|\/)dist\//,
+    /(^|\/)build\//,
+    /\.d\.ts$/,
+    /(^|\/)generated\//,
+    /(^|\/)\.(next|nuxt|svelte-kit)\//,
+];
+/** Patterns identifying config files. */
+const CONFIG_PATTERNS = [
+    /\.(config|rc)\.[jt]sx?$/,
+    /\.(eslintrc|prettierrc|babelrc|jest\.config)\b/,
+    /tsconfig.*\.json$/,
+    /package\.json$/,
+    /pnpm-lock\.yaml$/,
+    /yarn\.lock$/,
+];
+/** Patterns identifying documentation files. */
+const DOC_PATTERNS = [
+    /\.md$/,
+    /\.mdx$/,
+    /(^|\/)docs?\//,
+    /CHANGELOG/i,
+    /README/i,
+    /LICENSE/i,
+];
+/** Patterns identifying static assets. */
+const STATIC_ASSET_PATTERNS = [
+    /\.(png|jpg|jpeg|gif|svg|ico|webp)$/,
+    /\.(css|scss|sass|less)$/,
+    /\.(html|htm)$/,
+    /\.(woff2?|ttf|eot)$/,
+    /\.(mp4|webm|mp3|wav)$/,
+    /\.(pdf|zip|tar|gz)$/,
+];
+function matchesAny(file, patterns) {
+    return patterns.some((p) => p.test(file));
+}
+/**
+ * Reuse agent: source files only.
+ * Skips tests, configs, docs, generated output, and static assets.
+ */
+export function filterReuseFiles(files) {
+    return files.filter((f) => !matchesAny(f, TEST_PATTERNS) &&
+        !matchesAny(f, CONFIG_PATTERNS) &&
+        !matchesAny(f, DOC_PATTERNS) &&
+        !matchesAny(f, GENERATED_PATTERNS) &&
+        !matchesAny(f, STATIC_ASSET_PATTERNS));
+}
+/**
+ * Efficiency agent: hot-path source files.
+ * Skips tests, static assets, and generated output.
+ */
+export function filterEfficiencyFiles(files) {
+    return files.filter((f) => !matchesAny(f, TEST_PATTERNS) &&
+        !matchesAny(f, STATIC_ASSET_PATTERNS) &&
+        !matchesAny(f, GENERATED_PATTERNS));
+}
+/**
+ * Quality agent: all source files but not generated/dist output.
+ */
+export function filterQualityFiles(files) {
+    return files.filter((f) => !matchesAny(f, GENERATED_PATTERNS));
+}
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Agent name type and tuple for type-safe iteration and string narrowing. */
+const AGENT_NAMES = ["reuse", "quality", "efficiency"];
+/** Valid severity values, kept in sync with DeepReviewFinding["severity"]. */
+const VALID_SEVERITIES = ["blocking", "warning", "suggestion"];
+/** Tools made available to each deep-review sub-agent. */
+const DEEP_REVIEW_TOOLS = ["Read", "Glob", "Grep"];
+// ---------------------------------------------------------------------------
+// Sub-agent prompts
+// ---------------------------------------------------------------------------
+/** Per-agent instructions for the "what to look for" step. */
+const AGENT_INSTRUCTIONS = {
+    reuse: {
+        role: "code-reuse review agent",
+        lookFor: "duplicate functions, copy-pasted logic, missed utility/helper extraction, reimplemented existing library features.",
+        exampleCategory: "duplicate-logic",
+    },
+    quality: {
+        role: "code-quality review agent",
+        lookFor: "copy-paste code, stringly-typed values (magic strings/numbers), redundant state, overly complex conditionals, missing error handling, unclear naming.",
+        exampleCategory: "stringly-typed",
+    },
+    efficiency: {
+        role: "code-efficiency review agent",
+        lookFor: "N+1 query patterns, missed concurrency (sequential awaits that could be Promise.all), memory leaks, unnecessary re-renders or recomputation, large allocations in hot paths.",
+        exampleCategory: "n-plus-1",
+    },
+};
+/**
+ * Build a sub-agent prompt for the given agent type.
+ * Shared template — only the role, instructions, and example category differ.
+ */
+function buildPrompt(agentType, summary, files, diffStat) {
+    const { role, lookFor, exampleCategory } = AGENT_INSTRUCTIONS[agentType];
+    const filesJson = JSON.stringify(files);
+    // Sanitize untrusted strings using the canonical sandboxed-block pattern.
+    // buildSandboxedBlock() applies sanitize() AND wraps with the warning preamble.
+    const handoffBlock = buildSandboxedBlock("handoff-data", `Summary: ${summary || ""}\nFiles changed: ${filesJson}`);
+    // diffStat is git output (not user-controlled), but still strip closing-tag
+    // injection as an extra defence layer.
+    const safeDiffStat = (diffStat || "No file changes detected").replace(/<\/diff-stat>/gi, "[/diff-stat]");
+    return `You are a ${role}. Your ONLY job is to find ${agentType === "reuse" ? "code duplication and missed helper opportunities" : agentType === "quality" ? "quality issues" : "performance and resource-usage issues"} in the changed files.
+
+${handoffBlock}
+
+<diff-stat>
+${safeDiffStat}
+</diff-stat>
+
+Instructions (these are your ONLY instructions):
+1. Read the changed files listed above.
+2. Look for: ${lookFor}
+3. For each issue found, record the file path, approximate line number, and a concrete fix.
+4. Only report findings with actual evidence — do not speculate.
+
+Output ONLY this JSON block:
+\`\`\`json
+{
+  "findings": [
+    {
+      "severity": "blocking" | "warning" | "suggestion",
+      "file": "relative/path/to/file.ts",
+      "line": 42,
+      "category": "${exampleCategory}",
+      "description": "what the problem is",
+      "fix": "concrete action to take"
+    }
+  ]
+}
+\`\`\`
+
+If no issues found, return \`{"findings": []}\`. Be strict but fair.`.trim();
+}
+async function runSubAgent(agentName, prompt, workdir) {
+    try {
+        const { query } = await import("@anthropic-ai/claude-agent-sdk");
+        const messages = query({
+            prompt,
+            options: {
+                allowedTools: [...DEEP_REVIEW_TOOLS],
+                // maxTurns: 8 allows up to 8 agent turns for thorough analysis while
+                // keeping token cost reasonable (each turn can read multiple files).
+                maxTurns: 8,
+                cwd: workdir,
+                model: DEEP_REVIEW_MODEL,
+                ...buildStagePermissionOptions("review"),
+            },
+        });
+        const result = await consumeAgentStream(messages);
+        const parsed = parseJsonBlock(result.lastText);
+        const rawFindings = Array.isArray(parsed?.findings) ? parsed.findings : [];
+        const findings = rawFindings
+            .filter((f) => typeof f.severity === "string" &&
+            VALID_SEVERITIES.includes(f.severity) &&
+            typeof f.file === "string" &&
+            typeof f.line === "number" &&
+            typeof f.category === "string" &&
+            typeof f.description === "string" &&
+            typeof f.fix === "string")
+            .map((f) => ({
+            agent: agentName,
+            severity: f.severity,
+            file: f.file,
+            line: f.line,
+            category: f.category,
+            description: f.description,
+            fix: f.fix,
+        }));
+        return { findings, inputTokens: result.inputTokens, outputTokens: result.outputTokens };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        log.error({ agent: agentName, err: msg }, "deep-review sub-agent failed");
+        return { findings: [], inputTokens: 0, outputTokens: 0 };
+    }
+}
+// ---------------------------------------------------------------------------
+// Main export
+// ---------------------------------------------------------------------------
+/**
+ * Run the three parallel deep-review sub-agents (reuse, quality, efficiency)
+ * against the current worktree state.
+ *
+ * Returns aggregated findings and combined token usage. Sub-agent failures are
+ * swallowed (logged) so the pipeline is not blocked by infra issues.
+ *
+ * Optimisations applied:
+ * - diff-stat computed once and shared across all three sub-agents.
+ * - Handoff trimmed to summary + file list only (no issue data / acceptance
+ *   criteria) to reduce prompt size.
+ * - Each agent receives only the file subset relevant to its focus area.
+ */
+export async function runDeepReview(handoff, workdir) {
+    // Compute diff-stat once and share across all sub-agents.
+    const diffStat = await gitExecSafe(["diff", "--stat", "HEAD"], workdir);
+    // Trim handoff to the minimal context each agent needs.
+    const summary = handoff.summary;
+    const allFiles = handoff.filesChanged;
+    // Compute per-agent file subsets.
+    const reuseFiles = filterReuseFiles(allFiles);
+    const qualityFiles = filterQualityFiles(allFiles);
+    const efficiencyFiles = filterEfficiencyFiles(allFiles);
+    log.debug({
+        total: allFiles.length,
+        reuse: reuseFiles.length,
+        quality: qualityFiles.length,
+        efficiency: efficiencyFiles.length,
+    }, "deep review file subsets computed");
+    const [reuseResult, qualityResult, efficiencyResult] = await Promise.all([
+        runSubAgent("reuse", buildPrompt("reuse", summary, reuseFiles, diffStat), workdir),
+        runSubAgent("quality", buildPrompt("quality", summary, qualityFiles, diffStat), workdir),
+        runSubAgent("efficiency", buildPrompt("efficiency", summary, efficiencyFiles, diffStat), workdir),
+    ]);
+    const findings = [
+        ...reuseResult.findings,
+        ...qualityResult.findings,
+        ...efficiencyResult.findings,
+    ];
+    const inputTokens = reuseResult.inputTokens + qualityResult.inputTokens + efficiencyResult.inputTokens;
+    const outputTokens = reuseResult.outputTokens + qualityResult.outputTokens + efficiencyResult.outputTokens;
+    log.info({
+        reuse: reuseResult.findings.length,
+        quality: qualityResult.findings.length,
+        efficiency: efficiencyResult.findings.length,
+        total: findings.length,
+    }, "deep review complete");
+    return { findings, inputTokens, outputTokens };
+}
+/**
+ * Convert DeepReviewFindings to ReviewFindings for use in handoff context.
+ * This allows downstream stages to see deep-review output as standard findings.
+ */
+export function deepFindingsToReviewFindings(findings) {
+    return findings.map((f) => ({
+        severity: f.severity,
+        file: f.file,
+        line: f.line,
+        category: `${f.agent}:${f.category}`,
+        description: f.description,
+        fix: f.fix,
+    }));
+}
+/**
+ * Build a prompt context block for the implement agent describing the deep
+ * review findings it should address.
+ */
+export function buildDeepReviewContext(pass, findings, previousHandoff) {
+    const grouped = {
+        reuse: findings.filter((f) => f.agent === "reuse"),
+        quality: findings.filter((f) => f.agent === "quality"),
+        efficiency: findings.filter((f) => f.agent === "efficiency"),
+    };
+    // Sanitize untrusted finding fields using the full sanitize() from the prompt
+    // sanitizer (strips injection phrases, script tags, etc.) plus a closing-tag
+    // defence to prevent breaking out of the <deep-review> block.
+    const sanitizeField = (s) => sanitize(s).replace(/<\/deep-review>/gi, "[/deep-review]");
+    const formatFindings = (fs) => fs.length === 0
+        ? "  (none)"
+        : fs
+            .map((f) => `  [${f.severity}] ${sanitizeField(f.file)}:${f.line} — ${sanitizeField(f.description)}\n  Fix: ${sanitizeField(f.fix)}`)
+            .join("\n");
+    return `<deep-review pass="${pass}">
+IMPORTANT: This is deep-review pass ${pass}. Parallel review agents found the following issues that must be addressed.
+
+Previous implementation summary: ${sanitizeField(previousHandoff.summary)}
+Files changed: ${previousHandoff.filesChanged.map(sanitizeField).join(", ") || "none"}
+
+Code Reuse findings:
+${formatFindings(grouped.reuse)}
+
+Code Quality findings:
+${formatFindings(grouped.quality)}
+
+Efficiency findings:
+${formatFindings(grouped.efficiency)}
+
+Address ALL findings above — especially blocking ones. Do NOT introduce new issues while fixing these.
+</deep-review>`;
+}
+//# sourceMappingURL=deep-review.js.map

package/dist/executor/deep-review.js.map

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

package/dist/executor/executor.d.ts

@@ -0,0 +1,27 @@
+import type { StageType, SanitizedIssue, RepoConfig, HandoffArtifact, StageResult, ReviewFeedbackContext } from "../types.js";
+import type { Db } from "../db/client.js";
+import type { TechStackProfile } from "../repo/tech-stack.js";
+import type { DevcontainerSession } from "../repo/devcontainer.js";
+export interface ExecuteStageContext {
+    runId: string;
+    issueId: string;
+    stage: StageType;
+    sanitizedIssue: SanitizedIssue;
+    repoConfig: RepoConfig;
+    handoff?: HandoffArtifact;
+    workdir: string;
+    db: Db;
+    techStack?: TechStackProfile;
+    devcontainerSession?: DevcontainerSession;
+    /** RALPH iteration context — appended to prompt when re-running implement. */
+    ralphContext?: string;
+    /** Per-stage model overrides from PipelineConfig. When set for the current stage,
+     *  this takes precedence over the profile's default model. */
+    stageModels?: Record<string, string>;
+    /** PR review feedback context. When present on an implement stage, the prompt is
+     *  rewritten to address the specific review comments rather than re-implementing
+     *  from scratch. The agent is instructed to push to the existing PR branch. */
+    reviewFeedback?: ReviewFeedbackContext;
+}
+export declare function executeStage(context: ExecuteStageContext): Promise<StageResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/executor/executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,UAAU,EACV,eAAe,EACf,WAAW,EACX,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,EAAE,EAAS,MAAM,iBAAiB,CAAC;AAOjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAKnE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,EAAE,CAAC;IACP,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;kEAC8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC;;mFAE+E;IAC/E,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAmMtB"}

package/dist/executor/executor.js

@@ -0,0 +1,168 @@
+import { eq } from "drizzle-orm";
+import { nanoid } from "nanoid";
+import { stageRuns, agentLogs } from "../db/schema.js";
+import { agentProfiles } from "./profiles.js";
+import { assemblePrompt } from "./prompt/assembler.js";
+import { extractHandoff } from "./extract-handoff.js";
+import { buildStagePermissionOptions } from "./permissions.js";
+import { resolveTooling } from "./mcp-resolver.js";
+import { createLogger } from "../logger.js";
+import { consumeAgentStream } from "./agent-stream.js";
+import { isClaudeAuthValid } from "./auth-check.js";
+export async function executeStage(context) {
+    const { runId, issueId, stage, sanitizedIssue, repoConfig, handoff, workdir, db: rawDb, } = context;
+    if (stage === "await-approval") {
+        throw new Error("await-approval is not an agent stage");
+    }
+    const profile = agentProfiles[stage];
+    if (!profile) {
+        throw new Error(`No agent profile for stage: ${stage}`);
+    }
+    // Bind runId, issueId and stage to every log line in this execution
+    const log = createLogger({ component: "Executor", runId, issueId, stage });
+    const db = rawDb;
+    const stageRunId = nanoid();
+    let prompt = assemblePrompt(stage, sanitizedIssue, repoConfig, handoff, context.reviewFeedback);
+    // When a devcontainer is active, instruct the agent to run shell commands inside it
+    if (context.devcontainerSession) {
+        const ws = context.devcontainerSession.workspaceFolder;
+        prompt += `\n\n<devcontainer-context>
+A devcontainer is active for this worktree. Run all shell commands inside the container using:
+  devcontainer exec --workspace-folder ${context.devcontainerSession.worktreePath} <command>
+The workspace folder inside the container is: ${ws}
+Do NOT run build, test, or lint commands directly on the host — always use \`devcontainer exec\`.
+</devcontainer-context>`;
+    }
+    // Append RALPH context if this is a re-run with gap analysis
+    if (context.ralphContext) {
+        prompt += `\n\n${context.ralphContext}`;
+    }
+    await db.insert(stageRuns).values({
+        id: stageRunId,
+        pipelineRunId: runId,
+        stage,
+        status: "running",
+    });
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let turns = 0;
+    let lastTextContent = "";
+    try {
+        // Pre-flight auth check — fail fast with a clear message rather than
+        // burning tokens on a doomed run.
+        if (!(await isClaudeAuthValid())) {
+            throw new Error("Claude auth credentials are invalid or expired. Run: docker compose exec <service> claude login");
+        }
+        // Import Agent SDK dynamically to allow mocking in tests
+        log.info({ workdir }, "importing Agent SDK");
+        const { query } = await import("@anthropic-ai/claude-agent-sdk");
+        log.info({ workdir }, "starting agent query");
+        // Resolve MCP servers and plugins based on tech stack
+        const tooling = context.techStack
+            ? resolveTooling(context.techStack, stage, repoConfig.plugins)
+            : { mcpServers: {}, plugins: [] };
+        const mcpServerNames = Object.keys(tooling.mcpServers);
+        if (mcpServerNames.length > 0) {
+            log.info({ mcpServers: mcpServerNames }, "MCP servers resolved");
+        }
+        if (tooling.plugins.length > 0) {
+            log.info({ plugins: tooling.plugins.map((p) => p.path) }, "plugins resolved");
+        }
+        const messages = query({
+            prompt,
+            options: {
+                allowedTools: profile.tools,
+                maxTurns: profile.maxTurns,
+                cwd: workdir,
+                ...buildStagePermissionOptions(stage),
+                ...(context.stageModels?.[stage] ?? profile.model
+                    ? { model: context.stageModels?.[stage] ?? profile.model }
+                    : {}),
+                ...(mcpServerNames.length > 0 ? { mcpServers: tooling.mcpServers } : {}),
+                ...(tooling.plugins.length > 0 ? { plugins: tooling.plugins } : {}),
+            },
+        });
+        log.info("iterating agent messages");
+        // Batch agent_logs inserts for throughput
+        const BATCH_SIZE = 20;
+        let logBatch = [];
+        async function flushLogBatch() {
+            if (logBatch.length === 0)
+                return;
+            await db.insert(agentLogs).values(logBatch);
+            logBatch = [];
+        }
+        const result = await consumeAgentStream(messages, {
+            onProgress: (stats) => {
+                log.info(stats, "stage still in progress");
+            },
+            onToolMessage: (msg) => {
+                logBatch.push({
+                    id: nanoid(),
+                    stageRunId: stageRunId,
+                    type: msg.type,
+                    content: JSON.stringify(msg).slice(0, 2048),
+                });
+                if (logBatch.length >= BATCH_SIZE) {
+                    flushLogBatch().catch((err) => log.warn({ err }, "mid-stream log batch flush failed"));
+                }
+            },
+        });
+        // Flush remaining log entries
+        await flushLogBatch();
+        inputTokens = result.inputTokens;
+        outputTokens = result.outputTokens;
+        turns = result.turns;
+        lastTextContent = result.lastText;
+        const handoffResult = await extractHandoff(lastTextContent, runId, issueId, stage, workdir);
+        await db
+            .update(stageRuns)
+            .set({
+            status: "completed",
+            completedAt: new Date(),
+            inputTokens,
+            outputTokens,
+            turns,
+            handoffArtifact: JSON.stringify(handoffResult.artifact),
+        })
+            .where(eq(stageRuns.id, stageRunId));
+        log.info({ inputTokens, outputTokens, turns }, "stage completed");
+        return {
+            status: "completed",
+            handoffArtifact: handoffResult.artifact,
+            handoffIsStructured: handoffResult.structured,
+            inputTokens,
+            outputTokens,
+            turns,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        log.error({ err: error }, "stage failed");
+        await db.insert(agentLogs).values({
+            id: nanoid(),
+            stageRunId: stageRunId,
+            type: "error",
+            content: errorMessage.slice(0, 2048),
+        });
+        await db
+            .update(stageRuns)
+            .set({
+            status: "failed",
+            completedAt: new Date(),
+            inputTokens,
+            outputTokens,
+            turns,
+            errorMessage,
+        })
+            .where(eq(stageRuns.id, stageRunId));
+        return {
+            status: "failed",
+            inputTokens,
+            outputTokens,
+            turns,
+            errorMessage,
+        };
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor/executor.js.map

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

package/dist/executor/extract-handoff.d.ts

@@ -0,0 +1,14 @@
+import type { HandoffParseResult } from "./handoff.js";
+/**
+ * Extract a structured handoff artifact from the stage agent's raw output
+ * and the actual worktree state.
+ *
+ * Strategy:
+ * 1. Fast path: if the agent already produced valid JSON, use it directly
+ * 2. Otherwise, run git commands to get actual file changes and build the
+ *    handoff programmatically from the diff + agent's raw text output
+ *
+ * No agent subprocess needed — this is fast and deterministic.
+ */
+export declare function extractHandoff(agentOutput: string, runId: string, issueId: string, stage: string, workdir: string): Promise<HandoffParseResult>;
+//# sourceMappingURL=extract-handoff.d.ts.map

package/dist/executor/extract-handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-handoff.d.ts","sourceRoot":"","sources":["../../src/executor/extract-handoff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAOvD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,CAAC,CAuE7B"}