@zhixuan92/multi-model-agent-core 4.3.0 → 4.4.0

package/dist/lifecycle/handlers/files-written-cross-check.js

@@ -63,9 +63,15 @@ export function crossCheckFilesWritten(inputs) {
     let workerStatus;
     let errorCode;
     let errorMessage;
+    // When the caller can prove the worker never tried to write (no rejected
+    // paths, no successful writes, no shell heredocs), skip the downgrade —
+    // it's a false positive for chat-only responses. Default = true (preserve
+    // pre-existing callers that don't pass the flag).
+    const attempted = inputs.writeAttempted ?? true;
     if (real.length === 0 &&
         inputs.workerSelfAssessment === 'done' &&
-        inputs.toolsMode === 'full') {
+        inputs.toolsMode === 'full' &&
+        attempted) {
         workerStatus = 'error';
         errorCode = 'writes_unverifiable';
         errorMessage = WRITES_UNVERIFIABLE_MESSAGE;

package/dist/lifecycle/handlers/files-written-cross-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"files-written-cross-check.js","sourceRoot":"","sources":["../../../src/lifecycle/handlers/files-written-cross-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAuBlC,MAAM,2BAA2B,GAC/B,uEAAuE;IACvE,0EAA0E;IAC1E,uEAAuE,CAAC;AAE1E,MAAM,UAAU,sBAAsB,CAAC,MAAwB;IAC7D,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxC,iEAAiE;QACjE,iEAAiE;QACjE,+DAA+D;QAC/D,mEAAmE;QACnE,gCAAgC;QAChC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,IAAI,YAAiC,CAAC;IACtC,IAAI,SAA4C,CAAC;IACjD,IAAI,YAAgC,CAAC;IACrC,IACE,IAAI,CAAC,MAAM,KAAK,CAAC;QACjB,MAAM,CAAC,oBAAoB,KAAK,MAAM;QACtC,MAAM,CAAC,SAAS,KAAK,MAAM,EAC3B,CAAC;QACD,YAAY,GAAG,OAAO,CAAC;QACvB,SAAS,GAAG,qBAAqB,CAAC;QAClC,YAAY,GAAG,2BAA2B,CAAC;IAC7C,CAAC;IAED,oEAAoE;IACpE,qEAAqE;IACrE,2DAA2D;IAC3D,KAAK,MAAM,CAAC,UAAU,CAAC;IAEvB,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,mBAAmB,EAAE,OAAO;QAC5B,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,CAAC;QACnD,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"files-written-cross-check.js","sourceRoot":"","sources":["../../../src/lifecycle/handlers/files-written-cross-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AA6BlC,MAAM,2BAA2B,GAC/B,uEAAuE;IACvE,0EAA0E;IAC1E,uEAAuE,CAAC;AAE1E,MAAM,UAAU,sBAAsB,CAAC,MAAwB;IAC7D,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxC,iEAAiE;QACjE,iEAAiE;QACjE,+DAA+D;QAC/D,mEAAmE;QACnE,gCAAgC;QAChC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,IAAI,YAAiC,CAAC;IACtC,IAAI,SAA4C,CAAC;IACjD,IAAI,YAAgC,CAAC;IACrC,yEAAyE;IACzE,wEAAwE;IACxE,0EAA0E;IAC1E,kDAAkD;IAClD,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC;IAChD,IACE,IAAI,CAAC,MAAM,KAAK,CAAC;QACjB,MAAM,CAAC,oBAAoB,KAAK,MAAM;QACtC,MAAM,CAAC,SAAS,KAAK,MAAM;QAC3B,SAAS,EACT,CAAC;QACD,YAAY,GAAG,OAAO,CAAC;QACvB,SAAS,GAAG,qBAAqB,CAAC;QAClC,YAAY,GAAG,2BAA2B,CAAC;IAC7C,CAAC;IAED,oEAAoE;IACpE,qEAAqE;IACrE,2DAA2D;IAC3D,KAAK,MAAM,CAAC,UAAU,CAAC;IAEvB,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,mBAAmB,EAAE,OAAO;QAC5B,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,CAAC;QACnD,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC"}

package/dist/lifecycle/handlers/git-commit-handler.d.ts

@@ -1,19 +1,4 @@
 import type { LifecycleState } from '../stage-plan-types.js';
-/**
- * StageHandler for row 5.2 (git_commit).
- *
- * Reads from state:
- *   - state.task: TaskSpec (for commit metadata)
- *   - state.executionContext: cwd
- *   - state.lastRunResult.filesWritten: which paths to commit
- *   - state.commits: idempotency guard — skip if already populated
- *
- * Writes to state:
- *   - state.commits: array of CommitStageResult
- *   - state.commitError: string when commit failed
- *
- * Defensive-no-ops on missing state slots so re-runs (retry path) don't
- * double-commit.
- */
+export type CommitSkipReason = 'no_repo' | 'no_diff' | 'validation_failed' | 'validation_stale' | 'worker_committed_out_of_band' | 'hook_failed';
 export declare function gitCommitHandler(state: LifecycleState): Promise<void>;
 //# sourceMappingURL=git-commit-handler.d.ts.map

package/dist/lifecycle/handlers/git-commit-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-commit-handler.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/git-commit-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAM7D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC3E"}
+{"version":3,"file":"git-commit-handler.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/git-commit-handler.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAQ7D,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,SAAS,GACT,mBAAmB,GACnB,kBAAkB,GAClB,8BAA8B,GAC9B,aAAa,CAAC;AAsClB,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA0H3E"}

package/dist/lifecycle/handlers/git-commit-handler.js

@@ -1,52 +1,159 @@
-import { runCommitStage } from './commit-stage.js';
-/**
- * StageHandler for row 5.2 (git_commit).
- *
- * Reads from state:
- *   - state.task: TaskSpec (for commit metadata)
- *   - state.executionContext: cwd
- *   - state.lastRunResult.filesWritten: which paths to commit
- *   - state.commits: idempotency guard — skip if already populated
- *
- * Writes to state:
- *   - state.commits: array of CommitStageResult
- *   - state.commitError: string when commit failed
- *
- * Defensive-no-ops on missing state slots so re-runs (retry path) don't
- * double-commit.
- */
+// v4.4.x — Committing stage.
+//
+// Gate logic per the spec:
+//   no_repo, no_diff, validation_failed, validation_stale,
+//   worker_committed_out_of_band, hook_failed
+//
+// Worker-supplied commitMessage (from WorkerOutput) is preferred; if
+// absent, generate one via a single turn on the standard session
+// using the staged diff as input.
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { mergeStageStats } from '../merge-stage-stats.js';
+import { HUMAN_LABEL } from '../stage-labels.js';
+const execFileP = promisify(execFile);
+async function gitC(cwd, args) {
+    try {
+        const { stdout, stderr } = await execFileP('git', ['-C', cwd, ...args]);
+        return { stdout, stderr, code: 0 };
+    }
+    catch (err) {
+        const e = err;
+        return {
+            stdout: e.stdout ?? '',
+            stderr: e.stderr ?? e.message ?? String(err),
+            code: typeof e.code === 'number' ? e.code : 1,
+        };
+    }
+}
+async function isInsideWorkTree(cwd) {
+    const r = await gitC(cwd, ['rev-parse', '--is-inside-work-tree']);
+    return r.code === 0 && r.stdout.trim() === 'true';
+}
+async function currentHead(cwd) {
+    const r = await gitC(cwd, ['rev-parse', 'HEAD']);
+    return r.code === 0 ? r.stdout.trim() : null;
+}
+function setSkip(state, reason, extra = {}) {
+    const last = state.lastRunResult ?? {};
+    state.lastRunResult = {
+        ...last,
+        committed: false,
+        commitSha: null,
+        commitMessage: null,
+        commitSkipReason: reason,
+        ...extra,
+    };
+}
 export async function gitCommitHandler(state) {
-    // Idempotency: skip if state.commits is already populated. Prevents
-    // double-commit on retry paths or when the runner pre-populated commits.
-    if (Array.isArray(state.commits) && state.commits.length > 0)
+    // Idempotency: skip if already settled
+    if (state.lastRunResult?.commitSkipReason !== undefined)
         return;
-    if (typeof state.commitError === 'string')
+    if (state.lastRunResult?.committed === true)
         return;
-    const task = state.task;
     const ctx = state.executionContext;
-    const last = state.lastRunResult;
-    // Defensive no-op when data flow isn't ready (Steps 1 + 5 populate these).
-    if (!task || !ctx || !last)
+    const cwd = state.cwd ?? ctx?.cwd;
+    if (!cwd)
         return;
-    const filesWritten = Array.isArray(last.filesWritten) ? last.filesWritten : [];
-    if (filesWritten.length === 0)
+    const result = state.lastRunResult;
+    if (!result)
+        return;
+    const startMs = Date.now();
+    // Fast pre-gate: worker reported no file changes — skip before any
+    // git work. Prevents `git add -A .` from staging stray working-tree
+    // edits, and short-circuits when the worker errored without producing
+    // artifacts (zero filesChanged).
+    const filesChanged = result.filesChanged ?? [];
+    if (filesChanged.length === 0) {
+        setSkip(state, 'no_diff');
         return;
-    const commitFields = last.parsedFindings?.commit ?? {
-        type: 'feat',
-        subject: 'automated commit',
-        body: '',
-    };
-    try {
-        const result = await runCommitStage({
-            cwd: ctx.cwd,
-            filesWritten,
-            commit: commitFields,
-        });
-        state.commits = [result];
     }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        state.commitError = message;
+    // Gate 1: no_repo
+    if (!await isInsideWorkTree(cwd)) {
+        setSkip(state, 'no_repo');
+        return;
     }
+    // Gate 2: worker_committed_out_of_band
+    const currentSha = await currentHead(cwd);
+    const preSha = state.preTaskHeadSha;
+    if (preSha && currentSha && currentSha !== preSha) {
+        setSkip(state, 'worker_committed_out_of_band', { detectedHeadSha: currentSha });
+        return;
+    }
+    // Gate 3: validation_failed
+    const validations = result.validationsRun ?? [];
+    if (validations.some((v) => !v.passed)) {
+        setSkip(state, 'validation_failed');
+        return;
+    }
+    // Gate 4: validation_stale (Rework ran but produced no fresh validations)
+    if (state.reworkApplied === true && validations.length === 0) {
+        setSkip(state, 'validation_stale');
+        return;
+    }
+    // Stage scoped to cwd
+    const addR = await gitC(cwd, ['add', '-A', '.']);
+    if (addR.code !== 0) {
+        setSkip(state, 'hook_failed');
+        return;
+    }
+    // Gate 6: no_diff (post-stage)
+    const diffR = await gitC(cwd, ['diff', '--cached', '--quiet', '--', '.']);
+    if (diffR.code === 0) {
+        setSkip(state, 'no_diff');
+        return;
+    }
+    // Resolve commit message: worker-supplied or model-generated.
+    let commitMessage = result.commitMessage;
+    if (!commitMessage) {
+        try {
+            const session = ctx.getSession('standard');
+            const diffOut = await gitC(cwd, ['diff', '--cached', '--', '.']);
+            const truncated = diffOut.stdout.slice(0, 8000);
+            const summary = result.summary ?? '';
+            const turn = await session.send(`Generate a one-line Conventional Commits message for this diff.\n\nTask summary: ${summary}\n\nDiff:\n${truncated}`, { stageLabel: HUMAN_LABEL.committing });
+            commitMessage = turn.output.split('\n')[0].trim();
+        }
+        catch {
+            /* fall through to template */
+        }
+        if (!commitMessage) {
+            const summary = result.summary ?? 'update';
+            commitMessage = `chore: ${summary.slice(0, 60)}`;
+        }
+    }
+    // Commit
+    const commitR = await gitC(cwd, ['commit', '-m', commitMessage]);
+    if (commitR.code !== 0) {
+        setSkip(state, 'hook_failed');
+        return;
+    }
+    const newSha = await currentHead(cwd);
+    state.lastRunResult = {
+        ...result,
+        committed: true,
+        commitSha: newSha,
+        commitMessage,
+        commitSkipReason: null,
+    };
+    // Back-compat for downstream consumers (baseline-handlers + event-builder).
+    state.commits = [{
+            sha: newSha ?? '',
+            subject: commitMessage,
+            body: '',
+            filesChanged: (result.filesChanged ?? []),
+            authoredAt: new Date().toISOString(),
+        }];
+    mergeStageStats(state, 'committing', {
+        inputTokens: 0,
+        outputTokens: 0,
+        cachedReadTokens: 0,
+        cachedNonReadTokens: 0,
+        turnCount: 0,
+        toolCallCount: 0,
+        costUSD: null,
+        durationMs: Date.now() - startMs,
+        filesWrittenCount: (result.filesChanged ?? []).length,
+    }, { tier: 'standard', model: null });
 }
 //# sourceMappingURL=git-commit-handler.js.map

package/dist/lifecycle/handlers/git-commit-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"git-commit-handler.js","sourceRoot":"","sources":["../../../src/lifecycle/handlers/git-commit-handler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAA0B,MAAM,mBAAmB,CAAC;AAG3E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAqB;IAC1D,oEAAoE;IACpE,yEAAyE;IACzE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO;IACrE,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO;IAElD,MAAM,IAAI,GAAG,KAAK,CAAC,IAA4B,CAAC;IAChD,MAAM,GAAG,GAAG,KAAK,CAAC,gBAAgD,CAAC;IACnE,MAAM,IAAI,GAAG,KAAK,CAAC,aAAsC,CAAC;IAE1D,2EAA2E;IAC3E,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI;QAAE,OAAO;IAEnC,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEtC,MAAM,YAAY,GAAkB,IAAI,CAAC,cAAmD,EAAE,MAAM,IAAI;QACtG,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,kBAAkB;QAC3B,IAAI,EAAE,EAAE;KACT,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAsB,MAAM,cAAc,CAAC;YACrD,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,YAAY;YACZ,MAAM,EAAE,YAAY;SACrB,CAAC,CAAC;QACH,KAAK,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC;IAC9B,CAAC;AACH,CAAC"}
+{"version":3,"file":"git-commit-handler.js","sourceRoot":"","sources":["../../../src/lifecycle/handlers/git-commit-handler.ts"],"names":[],"mappings":"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"}

package/dist/lifecycle/handlers/read-route-implementer.d.ts

@@ -0,0 +1,41 @@
+import type { Session } from '../../types/run-result.js';
+import { type Finding } from '../findings-parser.js';
+interface Criterion {
+    id: string;
+    title: string;
+    description: string;
+}
+export interface ReadRouteImplementerInput {
+    session: Session;
+    cachedPrefix: string;
+    criteria: readonly Criterion[];
+    buildSuffix: (c: Criterion) => string;
+}
+export interface ReadRouteImplementerResult {
+    findings: Finding[];
+    criteriaErrors: {
+        criterionId: string;
+        error: string;
+    }[];
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        cachedReadTokens: number;
+        cachedNonReadTokens: number;
+    };
+    turns: number;
+    costUSD: number | null;
+    durationMs: number;
+    /** Joined per-criterion narrative — used by downstream parsers that
+     *  read raw text (annotator fallback, terminal-block renderers). */
+    synthesizedOutput: string;
+}
+/**
+ * Run the sequential read-route criteria loop on a single session.
+ * Prefix is sent once with the first criterion (cached after); each
+ * subsequent criterion sends only its suffix and benefits from the
+ * model's prior tool calls retained in the session.
+ */
+export declare function runReadRouteImplementer(input: ReadRouteImplementerInput): Promise<ReadRouteImplementerResult>;
+export {};
+//# sourceMappingURL=read-route-implementer.d.ts.map

package/dist/lifecycle/handlers/read-route-implementer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-route-implementer.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/read-route-implementer.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAIpE,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;IAC/B,WAAW,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,cAAc,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzD,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5G,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB;wEACoE;IACpE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC,CAiErC"}

package/dist/lifecycle/handlers/read-route-implementer.js

@@ -0,0 +1,84 @@
+// v4.4.x — Read-route Implementing stage.
+//
+// One complex session per task, sequential for-loop over criteria.
+// Each iteration: build a per-criterion prompt, send, parse findings.
+// Earlier criteria's tool results carry forward in the session context
+// so the model doesn't re-discover the same files across criteria —
+// the token win over the old N-parallel-sub-workers approach.
+//
+// Failures are recorded as criteriaErrors entries (not findings) so
+// the read-route findings list stays clean of internal-error noise.
+import { parseFindings } from '../findings-parser.js';
+import { HUMAN_LABEL } from '../stage-labels.js';
+import { buildWarmFollowupMessage } from '../warm-followup.js';
+/**
+ * Run the sequential read-route criteria loop on a single session.
+ * Prefix is sent once with the first criterion (cached after); each
+ * subsequent criterion sends only its suffix and benefits from the
+ * model's prior tool calls retained in the session.
+ */
+export async function runReadRouteImplementer(input) {
+    const findings = [];
+    const criteriaErrors = [];
+    const perCriterionOutputs = [];
+    let totalInput = 0, totalOutput = 0, totalCachedRead = 0, totalCachedNonRead = 0;
+    let totalCost = null;
+    let totalDuration = 0;
+    let totalTurns = 0;
+    for (let i = 0; i < input.criteria.length; i++) {
+        const c = input.criteria[i];
+        const suffix = input.buildSuffix(c);
+        // Turn 0 sends cachedPrefix + suffix (cold open into the implementer's
+        // session). Turns 1..N go through the warm-follow-up helper so the
+        // model knows the document + earlier tool results are already in
+        // thread history and skips re-grepping them.
+        const prompt = i === 0
+            ? `${input.cachedPrefix}\n\n${suffix}`
+            : buildWarmFollowupMessage(suffix);
+        try {
+            const turn = await input.session.send(prompt, { stageLabel: HUMAN_LABEL.implementing });
+            totalInput += turn.usage?.inputTokens ?? 0;
+            totalOutput += turn.usage?.outputTokens ?? 0;
+            totalCachedRead += turn.usage?.cachedReadTokens ?? 0;
+            totalCachedNonRead += turn.usage?.cachedNonReadTokens ?? 0;
+            totalDuration += turn.durationMs ?? 0;
+            totalTurns += turn.turns ?? 1;
+            if (turn.costUSD !== null && turn.costUSD !== undefined) {
+                totalCost = (totalCost ?? 0) + turn.costUSD;
+            }
+            if (turn.terminationReason !== 'ok') {
+                // Cap hit, stall, error, etc. — the turn produced no usable findings
+                // even though it did not throw. Record as a criterion error so the
+                // route's headline + status correctly reflect partial completion.
+                criteriaErrors.push({
+                    criterionId: c.id,
+                    error: turn.errorMessage ?? `turn ended with ${turn.terminationReason}`,
+                });
+                continue;
+            }
+            findings.push(...parseFindings(turn.output, c.id));
+            perCriterionOutputs.push(`--- ${c.title} (criterion ${c.id}) ---\n${turn.output}`);
+        }
+        catch (err) {
+            criteriaErrors.push({
+                criterionId: c.id,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return {
+        findings,
+        criteriaErrors,
+        usage: {
+            inputTokens: totalInput,
+            outputTokens: totalOutput,
+            cachedReadTokens: totalCachedRead,
+            cachedNonReadTokens: totalCachedNonRead,
+        },
+        turns: totalTurns,
+        costUSD: totalCost,
+        durationMs: totalDuration,
+        synthesizedOutput: perCriterionOutputs.join('\n\n'),
+    };
+}
+//# sourceMappingURL=read-route-implementer.js.map

package/dist/lifecycle/handlers/read-route-implementer.js.map

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

package/dist/lifecycle/handlers/review-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review-handler.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/review-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAgE7D,wBAAsB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAiGxE"}
+{"version":3,"file":"review-handler.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/review-handler.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA4C7D,wBAAsB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsIxE"}