@zhixuan92/multi-model-agent-core 3.12.6 → 4.0.0

package/dist/lifecycle/handlers/baseline-handlers.js

@@ -0,0 +1,193 @@
+import { parseStructuredReport } from '../../reporting/structured-report.js';
+import { runVerifyCommandHandler } from './run-verify-command-handler.js';
+import { gitCommitHandler } from './git-commit-handler.js';
+import { specReviewRound1Handler, specReviewRound2Handler, specReviewRound3Handler, specReworkRound1Handler, specReworkRound2Handler, settleSpecChainHandler, } from './spec-chain-handlers.js';
+import { qualityReviewRound1Handler, qualityReviewRound2Handler, qualityReviewRound3Handler, qualityReworkRound1Handler, qualityReworkRound2Handler, settleQualityChainHandler, } from './quality-chain-handlers.js';
+import { reviewDiffHandler } from './review-diff-handler.js';
+import { prepareExecutionContextHandler } from './prepare-execution-context-handler.js';
+import { registerToBlockStoreHandler } from './register-context-block-handlers.js';
+import { registerTerminalBlockHandler, emitTaskTerminalHandler, persistToBatchRegistryHandler, flushTelemetryHandler, } from './terminal-handlers.js';
+const noop = () => { };
+export function buildStageHandlers(deps) {
+    const runInitialImpl = async (state) => {
+        const route = state.route;
+        if (typeof route !== 'string') {
+            throw new Error('run_initial_impl: state.route must be a string');
+        }
+        const executor = state.executor;
+        if (!executor) {
+            throw new Error(`run_initial_impl: state.executor is not set for route ${route}`);
+        }
+        const result = await executor(state.request, state);
+        state.executorResult = result;
+    };
+    const composeResponse = (state) => {
+        if (state.route === 'register-context-block' && state.blockRegistration) {
+            state.responseEnvelope = { id: state.blockRegistration.id };
+            return;
+        }
+        if (state.executorResult !== undefined) {
+            state.responseEnvelope = state.executorResult;
+            return;
+        }
+        if (state.lastRunResult !== undefined) {
+            const last = state.lastRunResult;
+            const enriched = { ...last };
+            const specVerdicts = [state.specReviewRound1Verdict, state.specReviewRound2Verdict, state.specReviewRound3Verdict];
+            if (specVerdicts.some((v) => v === 'approved')) {
+                enriched.specReviewStatus = 'approved';
+            }
+            else if (specVerdicts.some((v) => v === 'error')) {
+                enriched.specReviewStatus = 'error';
+            }
+            else if (specVerdicts.some((v) => v === 'changes_required')) {
+                enriched.specReviewStatus = 'changes_required';
+            }
+            else {
+                enriched.specReviewStatus = 'not_applicable';
+            }
+            const qualVerdicts = [state.qualityReviewRound1Verdict, state.qualityReviewRound2Verdict, state.qualityReviewRound3Verdict];
+            if (qualVerdicts.some((v) => v === 'annotated')) {
+                enriched.qualityReviewStatus = 'annotated';
+            }
+            else if (qualVerdicts.some((v) => v === 'approved')) {
+                enriched.qualityReviewStatus = 'approved';
+            }
+            else if (qualVerdicts.some((v) => v === 'error')) {
+                enriched.qualityReviewStatus = 'error';
+            }
+            else if (qualVerdicts.some((v) => v === 'changes_required')) {
+                enriched.qualityReviewStatus = 'changes_required';
+            }
+            else {
+                enriched.qualityReviewStatus = 'not_applicable';
+            }
+            if (state.diffReviewVerdict !== undefined) {
+                enriched.diffReviewStatus = state.diffReviewVerdict;
+            }
+            else if (state.reviewPolicy === 'full' || state.reviewPolicy === 'diff_only') {
+                enriched.diffReviewStatus = 'skipped';
+            }
+            else {
+                enriched.diffReviewStatus = 'not_applicable';
+            }
+            if (state.verifyResult !== undefined && enriched.verification === undefined) {
+                enriched.verification = state.verifyResult;
+            }
+            if (Array.isArray(state.commits) && enriched.commits === undefined) {
+                enriched.commits = state.commits;
+            }
+            else if (enriched.commits === undefined) {
+                enriched.commits = [];
+            }
+            if (typeof state.commitError === 'string' && enriched.commitError === undefined) {
+                enriched.commitError = state.commitError;
+            }
+            const ctx = state.executionContext;
+            if (ctx && enriched.agents === undefined) {
+                const specReviewerTier = enriched.specReviewStatus === 'approved' || enriched.specReviewStatus === 'changes_required'
+                    ? (ctx.assignedTier === 'standard' ? 'complex' : 'standard')
+                    : (enriched.specReviewStatus === 'not_applicable' ? 'not_applicable' : 'skipped');
+                const qualityReviewerTier = enriched.qualityReviewStatus === 'approved'
+                    || enriched.qualityReviewStatus === 'changes_required'
+                    || enriched.qualityReviewStatus === 'annotated'
+                    ? (ctx.assignedTier === 'standard' ? 'complex' : 'standard')
+                    : (enriched.qualityReviewStatus === 'not_applicable' ? 'not_applicable' : 'skipped');
+                enriched.agents = {
+                    implementer: ctx.assignedTier,
+                    implementerToolMode: ctx.implementerToolMode ?? 'full',
+                    specReviewer: specReviewerTier,
+                    qualityReviewer: qualityReviewerTier,
+                };
+            }
+            if (enriched.fileArtifactsMissing === undefined) {
+                enriched.fileArtifactsMissing = false;
+            }
+            if (enriched.specReviewReason === undefined) {
+                enriched.specReviewReason = enriched.specReviewStatus === 'not_applicable'
+                    ? 'task produced no file artifacts to review'
+                    : '';
+            }
+            if (enriched.qualityReviewReason === undefined) {
+                enriched.qualityReviewReason = enriched.qualityReviewStatus === 'not_applicable'
+                    ? 'task produced no file artifacts to review'
+                    : '';
+            }
+            const fallbackReport = (last.output
+                ? parseStructuredReport(last.output)
+                : { summary: '', filesChanged: [], validationsRun: [], deviationsFromBrief: [], unresolved: [], extraSections: {} });
+            if (enriched.implementationReport === undefined) {
+                enriched.implementationReport = fallbackReport;
+            }
+            if (enriched.structuredReport === undefined) {
+                enriched.structuredReport = fallbackReport;
+            }
+            if (enriched.workerStatus === undefined) {
+                const summary = (fallbackReport?.summary ?? '').toLowerCase();
+                if (last.status === 'error') {
+                    enriched.workerStatus = 'failed';
+                }
+                else if (summary.includes('changes_required') || summary.includes('blocked')) {
+                    enriched.workerStatus = 'blocked';
+                }
+                else if (summary.length > 0 || last.status === 'ok') {
+                    enriched.workerStatus = 'done';
+                }
+                else {
+                    enriched.workerStatus = 'failed';
+                }
+            }
+            if (ctx && enriched.models === undefined) {
+                const implModel = ctx.implementerProvider?.config?.model ?? '';
+                const otherTier = ctx.assignedTier === 'standard' ? 'complex' : 'standard';
+                const otherProvider = ctx.providers[otherTier];
+                const otherModel = otherProvider?.config?.model ?? null;
+                enriched.models = {
+                    implementer: implModel,
+                    specReviewer: enriched.specReviewStatus === 'approved' || enriched.specReviewStatus === 'changes_required' ? otherModel : null,
+                    qualityReviewer: enriched.qualityReviewStatus === 'approved' || enriched.qualityReviewStatus === 'changes_required' || enriched.qualityReviewStatus === 'annotated' ? otherModel : null,
+                };
+            }
+            state.responseEnvelope = enriched;
+            return;
+        }
+        state.responseEnvelope = undefined;
+    };
+    return {
+        accept_http_request: noop,
+        verify_loopback: noop,
+        validate_workspace: noop,
+        load_project_state: noop,
+        parse_brief: noop,
+        verify_referenced_blocks: noop,
+        apply_defaults: noop,
+        mark_intake_complete: noop,
+        prepare_execution_context: prepareExecutionContextHandler,
+        run_initial_impl: runInitialImpl,
+        check_files_written: noop,
+        spec_review_round_1: specReviewRound1Handler,
+        rework_for_spec_round_1: specReworkRound1Handler,
+        spec_review_round_2: specReviewRound2Handler,
+        rework_for_spec_round_2: specReworkRound2Handler,
+        spec_review_round_3: specReviewRound3Handler,
+        settle_spec_chain: settleSpecChainHandler,
+        quality_review_round_1: qualityReviewRound1Handler,
+        rework_for_quality_round_1: qualityReworkRound1Handler,
+        quality_review_round_2: qualityReviewRound2Handler,
+        rework_for_quality_round_2: qualityReworkRound2Handler,
+        quality_review_round_3: qualityReviewRound3Handler,
+        settle_quality_chain: settleQualityChainHandler,
+        review_diff: reviewDiffHandler,
+        register_to_block_store: registerToBlockStoreHandler,
+        run_verify_command: runVerifyCommandHandler,
+        git_commit: gitCommitHandler,
+        compose_response: composeResponse,
+        register_terminal_block: registerTerminalBlockHandler,
+        emit_task_terminal: emitTaskTerminalHandler,
+        persist_to_batch_registry: persistToBatchRegistryHandler,
+        flush_telemetry: flushTelemetryHandler,
+        project_idle_cleanup_tick: noop,
+        batch_retention_sweep_tick: noop,
+    };
+}
+//# sourceMappingURL=baseline-handlers.js.map

package/dist/lifecycle/handlers/baseline-handlers.js.map

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

package/dist/lifecycle/handlers/commit-stage.d.ts

@@ -0,0 +1,16 @@
+import type { CommitFields } from '../../reporting/structured-report.js';
+export interface CommitStageInput {
+    cwd: string;
+    filesWritten: string[];
+    commit: CommitFields;
+}
+export interface CommitStageResult {
+    sha: string;
+    subject: string;
+    body: string;
+    filesChanged: string[];
+    authoredAt: string;
+}
+export declare function readbackCommit(sha: string, cwd: string): Promise<CommitStageResult>;
+export declare function runCommitStage(input: CommitStageInput): Promise<CommitStageResult>;
+//# sourceMappingURL=commit-stage.d.ts.map

package/dist/lifecycle/handlers/commit-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-stage.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/commit-stage.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAIzE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AA0BD,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAQzF;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAcxF"}

package/dist/lifecycle/handlers/commit-stage.js

@@ -0,0 +1,52 @@
+import { execFile } from 'node:child_process';
+import { isAbsolute, normalize, relative, sep } from 'node:path';
+import { promisify } from 'node:util';
+import { composeCommitMessage } from '../../lifecycle/auto-commit.js';
+const exec = promisify(execFile);
+function validatePaths(cwd, paths) {
+    const out = [];
+    for (const p of paths) {
+        if (/[\x00-\x1f]/.test(p))
+            throw new Error(`commit-stage: path contains control chars: ${JSON.stringify(p)}`);
+        let candidate;
+        if (isAbsolute(p)) {
+            const rel = relative(cwd, normalize(p));
+            if (rel === '' || rel === '..' || rel.startsWith(`..${sep}`) || isAbsolute(rel)) {
+                throw new Error(`commit-stage: absolute path outside cwd rejected: ${p}`);
+            }
+            candidate = rel;
+        }
+        else {
+            const norm = normalize(p);
+            const rel = relative(cwd, normalize(`${cwd}/${norm}`));
+            if (rel.startsWith('..'))
+                throw new Error(`commit-stage: path escapes cwd: ${p}`);
+            candidate = norm;
+        }
+        out.push(candidate);
+    }
+    return out;
+}
+export async function readbackCommit(sha, cwd) {
+    const { stdout: meta } = await exec('git', ['log', '-1', sha, '--format=%H%n%cI%n%s%n%b'], { cwd });
+    const lines = meta.split('\n');
+    const [shaOut, isoCi, subject, ...bodyLines] = lines;
+    const { stdout: names } = await exec('git', ['log', '-1', sha, '--name-only', '--format='], { cwd });
+    const filesChanged = names.split('\n').map(s => s.trim()).filter(Boolean);
+    const authoredAt = new Date(isoCi).toISOString();
+    return { sha: shaOut, subject, body: bodyLines.join('\n').trimEnd(), filesChanged, authoredAt };
+}
+export async function runCommitStage(input) {
+    if (input.filesWritten.length === 0) {
+        throw new Error('commit-stage: filesWritten must not be empty (call only when treeDirty)');
+    }
+    const safePaths = validatePaths(input.cwd, input.filesWritten);
+    await exec('git', ['add', '--', ...safePaths], { cwd: input.cwd });
+    const message = composeCommitMessage(input.commit);
+    const [subjectFull, body] = message.split(/\n\n([\s\S]*)/, 2);
+    const commitArgs = ['commit', '-q', '-m', subjectFull, ...(body ? ['-m', body] : [])];
+    await exec('git', commitArgs, { cwd: input.cwd });
+    const { stdout: head } = await exec('git', ['rev-parse', 'HEAD'], { cwd: input.cwd });
+    return readbackCommit(head.trim(), input.cwd);
+}
+//# sourceMappingURL=commit-stage.js.map

package/dist/lifecycle/handlers/commit-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-stage.js","sourceRoot":"","sources":["../../../src/lifecycle/handlers/commit-stage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAGtE,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAgBjC,SAAS,aAAa,CAAC,GAAW,EAAE,KAAe;IACjD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAE9G,IAAI,SAAiB,CAAC;QACtB,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChF,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,EAAE,CAAC,CAAC;YAC5E,CAAC;YACD,SAAS,GAAG,GAAG,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;YACvD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,EAAE,CAAC,CAAC;YAClF,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,GAAW;IAC3D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,0BAA0B,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACpG,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,GAAG,KAAK,CAAC;IACrD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACrG,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AAClG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAuB;IAC1D,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAC/D,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAEnE,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtF,MAAM,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAElD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IACtF,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;AAChD,CAAC"}

package/dist/lifecycle/handlers/derive-terminal-status.d.ts

@@ -0,0 +1,10 @@
+import type { LifecycleState } from '../stage-plan-types.js';
+import type { TerminalStatusDeriver } from '../../reporting/terminal-status-deriver.js';
+import type { ShutdownCoordinator } from '../../cleanup/shutdown-coordinator.js';
+export declare class DeriveTerminalStatusHandler {
+    private deriver;
+    private coordinator;
+    constructor(deriver: TerminalStatusDeriver, coordinator: ShutdownCoordinator);
+    handler: (state: LifecycleState) => void;
+}
+//# sourceMappingURL=derive-terminal-status.d.ts.map

package/dist/lifecycle/handlers/derive-terminal-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-terminal-status.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/derive-terminal-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAqF,MAAM,4CAA4C,CAAC;AAC3K,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAEjF,qBAAa,2BAA2B;IAC1B,OAAO,CAAC,OAAO;IAAyB,OAAO,CAAC,WAAW;gBAAnD,OAAO,EAAE,qBAAqB,EAAU,WAAW,EAAE,mBAAmB;IAE5F,OAAO,GAAI,OAAO,cAAc,KAAG,IAAI,CAyBrC;CACH"}

package/dist/lifecycle/handlers/derive-terminal-status.js

@@ -0,0 +1,35 @@
+export class DeriveTerminalStatusHandler {
+    deriver;
+    coordinator;
+    constructor(deriver, coordinator) {
+        this.deriver = deriver;
+        this.coordinator = coordinator;
+    }
+    handler = (state) => {
+        const inputs = {
+            shutdownInProgress: this.coordinator.isShutdownInProgress(),
+            workerStatus: state.workerStatus || 'done',
+            overallReviewVerdict: state.reviewVerdict || 'not_applicable',
+            artifactsCheck: state.artifactsCheck || 'not_applicable',
+            verifyOutcome: state.verifyOutcome || 'not_applicable',
+            guardFires: state.guardFires || [],
+            errorCode: state.errorCode || null,
+        };
+        const decision = this.deriver.derive(inputs);
+        state.terminalStatus = decision.terminalStatus;
+        state.terminationReason = decision.errorCode;
+        // CRITICAL: do NOT set state.terminal=true here. This handler is wired as
+        // the compose_response row (5.3); rows 5.3.5 (register_terminal_block),
+        // 5.4 (emit_task_terminal), 5.5 (persist_to_batch_registry), and 6.1
+        // (flush_telemetry) MUST still fire after this handler runs. The
+        // LifecycleDriver short-circuits on state.terminal === true, so setting
+        // it here would prevent terminal-block registration, telemetry flush, and
+        // batch persistence — silently breaking every task's tail.
+        //
+        // terminalStatus is the system-verdict field (caller-facing); terminal
+        // is the lifecycle-driver short-circuit flag — they are different things.
+        // Only error-path handlers (intake errors, guard fires) set
+        // state.terminal = true to skip the rest of the lifecycle.
+    };
+}
+//# sourceMappingURL=derive-terminal-status.js.map

package/dist/lifecycle/handlers/derive-terminal-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-terminal-status.js","sourceRoot":"","sources":["../../../src/lifecycle/handlers/derive-terminal-status.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,2BAA2B;IAClB;IAAwC;IAA5D,YAAoB,OAA8B,EAAU,WAAgC;QAAxE,YAAO,GAAP,OAAO,CAAuB;QAAU,gBAAW,GAAX,WAAW,CAAqB;IAAG,CAAC;IAEhG,OAAO,GAAG,CAAC,KAAqB,EAAQ,EAAE;QACxC,MAAM,MAAM,GAAmB;YAC7B,kBAAkB,EAAE,IAAI,CAAC,WAAW,CAAC,oBAAoB,EAAE;YAC3D,YAAY,EAAG,KAAK,CAAC,YAA6B,IAAI,MAAM;YAC5D,oBAAoB,EAAG,KAAK,CAAC,aAAsC,IAAI,gBAAgB;YACvF,cAAc,EAAG,KAAK,CAAC,cAAiC,IAAI,gBAAgB;YAC5E,aAAa,EAAG,KAAK,CAAC,aAA+B,IAAI,gBAAgB;YACzE,UAAU,EAAG,KAAK,CAAC,UAAuB,IAAI,EAAE;YAChD,SAAS,EAAG,KAAK,CAAC,SAAoB,IAAI,IAAI;SAC/C,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,CAAC,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC;QAC/C,KAAK,CAAC,iBAAiB,GAAG,QAAQ,CAAC,SAAS,CAAC;QAC7C,0EAA0E;QAC1E,wEAAwE;QACxE,qEAAqE;QACrE,iEAAiE;QACjE,wEAAwE;QACxE,0EAA0E;QAC1E,2DAA2D;QAC3D,EAAE;QACF,uEAAuE;QACvE,0EAA0E;QAC1E,4DAA4D;QAC5D,2DAA2D;IAC7D,CAAC,CAAC;CACH"}

package/dist/lifecycle/handlers/execution-context-builder.d.ts

@@ -0,0 +1,5 @@
+import type { LifecycleState } from '../stage-plan-types.js';
+export declare class ExecutionContextBuilder {
+    handler: (state: LifecycleState) => void;
+}
+//# sourceMappingURL=execution-context-builder.d.ts.map

package/dist/lifecycle/handlers/execution-context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context-builder.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/execution-context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D,qBAAa,uBAAuB;IAClC,OAAO,GAAI,OAAO,cAAc,KAAG,IAAI,CAUrC;CACH"}

package/dist/lifecycle/handlers/execution-context-builder.js

@@ -0,0 +1,16 @@
+import { makeToolDefinitions } from '../../providers/tool-definitions.js';
+import { CallCache } from '../../providers/call-cache.js';
+export class ExecutionContextBuilder {
+    handler = (state) => {
+        const cwd = state.cwd;
+        state.runInput = {
+            systemPrompt: state.systemPrompt,
+            userMessage: state.userMessage,
+            toolDefinitions: makeToolDefinitions({ cwd }),
+            maxTurns: state.maxTurns ?? 50,
+            cwd,
+        };
+        state.callCache = new CallCache();
+    };
+}
+//# sourceMappingURL=execution-context-builder.js.map

package/dist/lifecycle/handlers/execution-context-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context-builder.js","sourceRoot":"","sources":["../../../src/lifecycle/handlers/execution-context-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,MAAM,OAAO,uBAAuB;IAClC,OAAO,GAAG,CAAC,KAAqB,EAAQ,EAAE;QACxC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAa,CAAC;QAChC,KAAK,CAAC,QAAQ,GAAG;YACf,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,eAAe,EAAE,mBAAmB,CAAC,EAAE,GAAG,EAAE,CAAC;YAC7C,QAAQ,EAAG,KAAK,CAAC,QAAmB,IAAI,EAAE;YAC1C,GAAG;SACJ,CAAC;QACF,KAAK,CAAC,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;IACpC,CAAC,CAAC;CACH"}

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

@@ -0,0 +1,19 @@
+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 declare function gitCommitHandler(state: LifecycleState): Promise<void>;
+//# sourceMappingURL=git-commit-handler.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,52 @@
+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.
+ */
+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)
+        return;
+    if (typeof state.commitError === 'string')
+        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)
+        return;
+    const filesWritten = Array.isArray(last.filesWritten) ? last.filesWritten : [];
+    if (filesWritten.length === 0)
+        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;
+    }
+}
+//# sourceMappingURL=git-commit-handler.js.map

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

@@ -0,0 +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"}

package/dist/lifecycle/handlers/prepare-execution-context-handler.d.ts

@@ -0,0 +1,19 @@
+import type { LifecycleState } from '../stage-plan-types.js';
+/**
+ * StageHandler for row 2.5 (prepare_execution_context).
+ *
+ * Reads from state:
+ *   - state.task / state.executionContext: idempotency guards. If callers
+ *     pre-populate them via DispatchInput.context (or a future intake step),
+ *     this handler is a structural acknowledgment.
+ *   - state.request: the rawRequest passed to dispatch. Used as a fallback
+ *     to surface the tasks list when callers haven't supplied state.task.
+ *
+ * Writes to state (only when slots are empty AND request is shaped for it):
+ *   - state.task: the first TaskSpec from a delegate-style request payload.
+ *     runTasks (in task-runner.ts) dispatches one StagePlan per TaskSpec,
+ *     so state.task is the per-dispatch task. This handler surfaces task[0]
+ *     as a fallback for downstream handlers that need a TaskSpec.
+ */
+export declare function prepareExecutionContextHandler(state: LifecycleState): void;
+//# sourceMappingURL=prepare-execution-context-handler.d.ts.map

package/dist/lifecycle/handlers/prepare-execution-context-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-execution-context-handler.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/prepare-execution-context-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAqB1E"}

package/dist/lifecycle/handlers/prepare-execution-context-handler.js

@@ -0,0 +1,38 @@
+/**
+ * StageHandler for row 2.5 (prepare_execution_context).
+ *
+ * Reads from state:
+ *   - state.task / state.executionContext: idempotency guards. If callers
+ *     pre-populate them via DispatchInput.context (or a future intake step),
+ *     this handler is a structural acknowledgment.
+ *   - state.request: the rawRequest passed to dispatch. Used as a fallback
+ *     to surface the tasks list when callers haven't supplied state.task.
+ *
+ * Writes to state (only when slots are empty AND request is shaped for it):
+ *   - state.task: the first TaskSpec from a delegate-style request payload.
+ *     runTasks (in task-runner.ts) dispatches one StagePlan per TaskSpec,
+ *     so state.task is the per-dispatch task. This handler surfaces task[0]
+ *     as a fallback for downstream handlers that need a TaskSpec.
+ */
+export function prepareExecutionContextHandler(state) {
+    // Fallback: if rawRequest carries a TaskSpec[] and state.task is empty,
+    // surface the first task so per-task handlers have something to read.
+    if (!state.task) {
+        const req = state.request;
+        const first = req?.tasks?.[0];
+        if (first)
+            state.task = first;
+    }
+    // #45 Step 7e: per-task reviewPolicy lives on TaskSpec, not on rawRequest's
+    // top-level. Override state.reviewPolicy from state.task when present so
+    // the per-row runConditions (gating spec/quality/diff chains) see the
+    // right value. This must run unconditionally — callers via
+    // runTaskViaDispatcher pre-populate state.task + state.executionContext but
+    // the dispatcher's initialState defaults state.reviewPolicy to 'full' since
+    // the per-task reviewPolicy isn't visible at top-level rawRequest.
+    const task = state.task;
+    if (task && task.reviewPolicy) {
+        state.reviewPolicy = task.reviewPolicy;
+    }
+}
+//# sourceMappingURL=prepare-execution-context-handler.js.map

package/dist/lifecycle/handlers/prepare-execution-context-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-execution-context-handler.js","sourceRoot":"","sources":["../../../src/lifecycle/handlers/prepare-execution-context-handler.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,8BAA8B,CAAC,KAAqB;IAClE,wEAAwE;IACxE,sEAAsE;IACtE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,KAAK,CAAC,OAA6C,CAAC;QAChE,MAAM,KAAK,GAAG,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,KAAK;YAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC;IAChC,CAAC;IAED,4EAA4E;IAC5E,yEAAyE;IACzE,sEAAsE;IACtE,2DAA2D;IAC3D,4EAA4E;IAC5E,4EAA4E;IAC5E,mEAAmE;IACnE,MAAM,IAAI,GAAG,KAAK,CAAC,IAA4B,CAAC;IAChD,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QAC9B,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACzC,CAAC;AAEH,CAAC"}

package/dist/lifecycle/handlers/quality-chain-handlers.d.ts

@@ -0,0 +1,22 @@
+import type { LifecycleState } from '../stage-plan-types.js';
+export declare const qualityReviewRound1Handler: (state: LifecycleState) => Promise<void>;
+export declare const qualityReviewRound2Handler: (state: LifecycleState) => Promise<void>;
+export declare const qualityReviewRound3Handler: (state: LifecycleState) => Promise<void>;
+export declare const qualityReworkRound1Handler: (state: LifecycleState) => Promise<void>;
+export declare const qualityReworkRound2Handler: (state: LifecycleState) => Promise<void>;
+/**
+ * Settle handler. Reads the three round verdicts and writes
+ * state.qualityChainPassed.
+ *
+ * Cascade rule:
+ *   - 'approved' or 'annotated' in any round ⇒ chain passed (true)
+ *   - 'skipped' (e.g., no files written) treated as passed (true) — the
+ *     no-block path when there's nothing to review
+ *   - 'changes_required' through round 3 ⇒ chain failed (false)
+ *   - 'error' in any round ⇒ chain failed (false), state.terminal = true
+ *
+ * Runs runOnTerminal so the chain-pass slot is authoritative even on
+ * hard-fail paths. Idempotent on state.qualityChainPassed.
+ */
+export declare function settleQualityChainHandler(state: LifecycleState): void;
+//# sourceMappingURL=quality-chain-handlers.d.ts.map

package/dist/lifecycle/handlers/quality-chain-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-chain-handlers.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/quality-chain-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAsM7D,eAAO,MAAM,0BAA0B,UAvBkB,cAAc,KAAG,OAAO,CAAC,IAAI,CAuBjB,CAAC;AACtE,eAAO,MAAM,0BAA0B,UAxBkB,cAAc,KAAG,OAAO,CAAC,IAAI,CAwBjB,CAAC;AACtE,eAAO,MAAM,0BAA0B,UAzBkB,cAAc,KAAG,OAAO,CAAC,IAAI,CAyBjB,CAAC;AACtE,eAAO,MAAM,0BAA0B,UAZa,cAAc,KAAG,OAAO,CAAC,IAAI,CAYZ,CAAC;AACtE,eAAO,MAAM,0BAA0B,UAba,cAAc,KAAG,OAAO,CAAC,IAAI,CAaZ,CAAC;AAEtE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAmBrE"}