@zhixuan92/multi-model-agent-core 4.5.4 → 4.6.0

package/dist/lifecycle/handlers/enrich-runtime-result.js

@@ -0,0 +1,191 @@
+// Back-compat enrichment of state.lastRunResult after the v5 lifecycle runs.
+//
+// The wire envelope (ComposePayload, 8 fields) is the v5 boundary, but
+// downstream consumers (recorder, headline composer, batch envelope) still
+// expect the runtime-mirror RuntimeRunResult with v4 fields:
+//   - specReviewStatus / qualityReviewStatus / diffReviewStatus
+//   - agents (tier mapping per role)
+//   - models (per-role model names)
+//   - implementationReport (fallback parse of last.output)
+//   - structuredReport (canonical from annotator, else fallback parser)
+//   - fileArtifactsMissing
+//   - reviewerNotes / errors / verdict slots
+//   - actualCostUSD (sum across entered stages)
+//   - status / errorCode / terminationReason (v5 M3/M4 fixes)
+//
+// composeHandler calls this AFTER assembling its ComposePayload so that
+// terminal-handlers/recorder/headline-composer downstream see the enriched
+// runtime mirror exactly as the legacy composeResponse did.
+import { parseStructuredReport } from '../../reporting/structured-report.js';
+import { sumStageCosts } from '../shared-compute.js';
+const READ_ONLY_ROUTES = new Set(['audit', 'review', 'debug', 'investigate', 'research']);
+export function enrichRuntimeResult(state) {
+    if (state.lastRunResult === undefined)
+        return;
+    const last = state.lastRunResult;
+    const enriched = { ...last };
+    // ── actualCostUSD: sum across entered stages ────────────────────────────────
+    if (enriched.actualCostUSD === undefined) {
+        const stageStats = (last.stageStats ?? undefined);
+        enriched.actualCostUSD = sumStageCosts(stageStats) ?? 0;
+    }
+    const e = enriched;
+    // ── Review-status fields ────────────────────────────────────────────────────
+    if (state.specReviewError !== undefined)
+        e.specReviewStatus = 'error';
+    else if (state.specReviewVerdict !== undefined)
+        e.specReviewStatus = state.specReviewVerdict;
+    else
+        e.specReviewStatus = 'not_applicable';
+    if (state.qualityReviewError !== undefined)
+        e.qualityReviewStatus = 'error';
+    else if (state.qualityReviewVerdict !== undefined)
+        e.qualityReviewStatus = state.qualityReviewVerdict;
+    else
+        e.qualityReviewStatus = 'not_applicable';
+    if (state.diffReviewVerdict !== undefined)
+        e.diffReviewStatus = state.diffReviewVerdict;
+    else if (state.reviewPolicy === 'full' || state.reviewPolicy === 'diff_only')
+        e.diffReviewStatus = 'skipped';
+    else
+        e.diffReviewStatus = 'not_applicable';
+    // ── verification, commits, commitError ──────────────────────────────────────
+    if (state.verifyResult !== undefined && e.verification === undefined) {
+        e.verification = state.verifyResult;
+    }
+    if (Array.isArray(state.commits) && e.commits === undefined) {
+        e.commits = state.commits;
+    }
+    else if (e.commits === undefined) {
+        e.commits = [];
+    }
+    if (typeof state.commitError === 'string' && e.commitError === undefined) {
+        e.commitError = state.commitError;
+    }
+    // ── agents map (tier per role) ──────────────────────────────────────────────
+    const ctx = state.executionContext;
+    if (ctx && e.agents === undefined) {
+        const specReviewerTier = e.specReviewStatus === 'approved' || e.specReviewStatus === 'changes_required'
+            ? (ctx.assignedTier === 'standard' ? 'complex' : 'standard')
+            : (e.specReviewStatus === 'not_applicable' ? 'not_applicable' : 'skipped');
+        const qualityReviewerTier = e.qualityReviewStatus === 'approved' || e.qualityReviewStatus === 'changes_required'
+            ? (ctx.assignedTier === 'standard' ? 'complex' : 'standard')
+            : (e.qualityReviewStatus === 'not_applicable' ? 'not_applicable' : 'skipped');
+        e.agents = {
+            implementer: ctx.assignedTier,
+            implementerToolMode: ctx.implementerToolMode ?? 'full',
+            specReviewer: specReviewerTier,
+            qualityReviewer: qualityReviewerTier,
+        };
+    }
+    if (e.fileArtifactsMissing === undefined)
+        e.fileArtifactsMissing = false;
+    // ── reviewReason text fields ────────────────────────────────────────────────
+    if (e.specReviewReason === undefined) {
+        e.specReviewReason = e.specReviewStatus === 'not_applicable' ? 'task produced no file artifacts to review' : '';
+    }
+    if (e.qualityReviewReason === undefined) {
+        e.qualityReviewReason = e.qualityReviewStatus === 'not_applicable' ? 'task produced no file artifacts to review' : '';
+    }
+    // ── implementationReport + structuredReport (annotator wins; else fallback) ─
+    const fallbackReport = (last.output
+        ? parseStructuredReport(last.output)
+        : { summary: '', filesChanged: [], validationsRun: [], deviationsFromBrief: [], unresolved: [], extraSections: {} });
+    if (e.implementationReport === undefined)
+        e.implementationReport = fallbackReport;
+    const annotatorReport = state.structuredReport;
+    if (annotatorReport && typeof annotatorReport === 'object') {
+        enriched.structuredReport = annotatorReport;
+    }
+    else if (enriched.structuredReport === undefined) {
+        enriched.structuredReport = fallbackReport;
+    }
+    // ── workerStatus derivation from output summary ─────────────────────────────
+    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';
+    }
+    // ── models map ──────────────────────────────────────────────────────────────
+    if (ctx && e.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;
+        e.models = {
+            implementer: implModel,
+            specReviewer: e.specReviewStatus === 'approved' || e.specReviewStatus === 'changes_required' ? otherModel : null,
+            qualityReviewer: e.qualityReviewStatus === 'approved' || e.qualityReviewStatus === 'changes_required' ? otherModel : null,
+        };
+    }
+    // ── A4b: chain-failed and read-only routes are exempt from artifact downgrade
+    const chainAlreadyFailed = state.reviewPolicy !== 'none' && state.reviewVerdict === 'changes_required';
+    const route = typeof state.route === 'string' ? state.route : '';
+    const _isReadOnlyRoute = READ_ONLY_ROUTES.has(route);
+    void chainAlreadyFailed;
+    void _isReadOnlyRoute;
+    // ── envelope-level reviewer notes / verdicts / errors / rework state ────────
+    if (state.specReviewerNotes !== undefined)
+        enriched.specReviewerNotes = state.specReviewerNotes;
+    if (state.qualityReviewerNotes !== undefined)
+        enriched.qualityReviewerNotes = state.qualityReviewerNotes;
+    if (state.reviewVerdict !== undefined)
+        enriched.reviewVerdict = state.reviewVerdict;
+    if (state.reviewFindings !== undefined)
+        enriched.reviewFindings = state.reviewFindings;
+    if (state.specReviewError !== undefined)
+        enriched.specReviewError = state.specReviewError;
+    if (state.qualityReviewError !== undefined)
+        enriched.qualityReviewError = state.qualityReviewError;
+    if (state.reviewError !== undefined)
+        enriched.reviewError = state.reviewError;
+    if (state.reworkError !== undefined)
+        enriched.reworkError = state.reworkError;
+    if (state.reworkOutput !== undefined)
+        enriched.reworkOutput = state.reworkOutput;
+    if (state.reworkApplied !== undefined)
+        enriched.reworkApplied = state.reworkApplied;
+    if (state.verifyResult !== undefined)
+        enriched.verifyResult = state.verifyResult;
+    // ── v5 M3 / M4 fixes: truthful workerSelfAssessment and rework-clears-up promo ─
+    const commitsExist = Array.isArray(state.commits) && state.commits.length > 0;
+    const reworkCleanedUp = state.reworkApplied === true && state.reworkError === undefined;
+    const reviewRejected = state.reviewPolicy !== 'none' && state.reviewVerdict === 'changes_required' && !reworkCleanedUp;
+    if (last.status === 'error') {
+        enriched.status = 'error';
+    }
+    else if (reviewRejected) {
+        enriched.status = 'incomplete';
+        enriched.errorCode = 'review_rejected';
+        const priorTr = (typeof enriched.terminationReason === 'object' && enriched.terminationReason !== null)
+            ? enriched.terminationReason
+            : undefined;
+        enriched.terminationReason = {
+            cause: 'incomplete',
+            turnsUsed: priorTr?.turnsUsed ?? last.turns ?? 0,
+            hasFileArtifacts: priorTr?.hasFileArtifacts ?? (Array.isArray(last.filesWritten) && last.filesWritten.length > 0),
+            usedShell: priorTr?.usedShell ?? false,
+            workerSelfAssessment: (last.workerStatus ?? state.workerStatus ?? null),
+            wasPromoted: false,
+        };
+    }
+    else if (commitsExist) {
+        enriched.status = 'ok';
+    }
+    else if (reworkCleanedUp && state.reviewPolicy !== 'none') {
+        enriched.status = 'ok';
+    }
+    // Mirror the enriched object back into state.lastRunResult AND
+    // state.responseEnvelope (legacy compose-target). emit_task_terminal +
+    // recorder + headline composer read state.lastRunResult; the wire envelope
+    // in DispatchOutput.finalState.lastRunResult ends up at the same place.
+    state.lastRunResult = enriched;
+    state.responseEnvelope = enriched;
+}
+//# sourceMappingURL=enrich-runtime-result.js.map

package/dist/lifecycle/handlers/enrich-runtime-result.js.map

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

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

@@ -1,4 +1,5 @@
 import type { LifecycleState } from '../stage-plan-types.js';
-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>;
+import type { StageGate, CommitPayload } from '../stage-io.js';
+export declare function commitHandler(state: LifecycleState): Promise<StageGate<CommitPayload>>;
+export { commitHandler as gitCommitHandler };
 //# 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":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAS7D,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"}
+{"version":3,"file":"git-commit-handler.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/git-commit-handler.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAkG/D,wBAAsB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAmG5F;AAID,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,CAAC"}

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

@@ -1,16 +1,19 @@
-// v4.4.x — Committing stage.
+// Stage I/O standardization — commitHandler emits StageGate<CommitPayload>.
 //
 // Gate logic per the spec:
 //   no_repo, no_diff, validation_failed, validation_stale,
 //   worker_committed_out_of_band, hook_failed
+// DEBUG: SOURCE FILE LOADED AT $(date)
 //
-// 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.
+// The spec (Step 13) supersedes the v4.4.x behavior:
+//   - Returns StageGate<CommitPayload> (tagged union { committed | no_op })
+//   - Detached HEAD maps to kind: 'no_op', reason: 'no_repo'
+//   - Commit message includes 'rework left N findings unaddressed' annotation
+//     when applicable
+//   - Does NOT mutate state.lastRunResult or state.commits (those are retired
+//     from the new chain; compose reads state.gates instead)
 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';
 import { getRealFilesChanged } from '../real-diff.js';
 const execFileP = promisify(execFile);
 async function gitC(cwd, args) {
@@ -35,126 +38,152 @@ 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,
+// ─── Payload helpers ─────────────────────────────────────────────────────────
+function advanceNoOp(reason, t0, detail) {
+    return {
+        outcome: 'advance',
+        payload: { kind: 'no_op', reason, detail },
+        telemetry: {
+            stageLabel: 'committing',
+            durationMs: Date.now() - t0,
+            costUSD: 0,
+            turnsUsed: 0,
+            stopReason: 'normal',
+        },
     };
 }
-export async function gitCommitHandler(state) {
-    // Idempotency: skip if already settled
-    if (state.lastRunResult?.commitSkipReason !== undefined)
-        return;
-    if (state.lastRunResult?.committed === true)
-        return;
-    const ctx = state.executionContext;
-    const cwd = state.cwd ?? ctx?.cwd;
-    if (!cwd)
-        return;
-    const result = state.lastRunResult;
-    if (!result)
-        return;
-    const startMs = Date.now();
-    // Fast pre-gate: use git diff to determine if there are actual file changes.
-    // This replaces the worker self-report read, which may be empty even when
-    // the worker made real changes.
-    const realFiles = await getRealFilesChanged(state);
-    if (realFiles.files.length === 0) {
-        setSkip(state, 'no_diff');
-        return;
+function haltCommit(comment, t0) {
+    return {
+        outcome: 'halt',
+        comment,
+        payload: { kind: 'no_op', reason: 'no_diff' }, // placeholder; halt path
+        telemetry: {
+            stageLabel: 'committing',
+            durationMs: Date.now() - t0,
+            costUSD: 0,
+            turnsUsed: 0,
+            stopReason: 'transport_error',
+        },
+    };
+}
+function composeCommitMessage(state) {
+    const summary = state.gates?.['rework']?.payload?.summary ??
+        state.gates?.['implement']?.payload?.summary ??
+        '(no summary)';
+    const firstLine = summary.split('\n')[0].slice(0, 72);
+    const reviewVerdict = state.gates?.['review']?.payload?.verdict;
+    const unaddressed = (state.gates?.['rework']?.payload?.unaddressedFindingIds ??
+        []);
+    let msg = `implement: ${firstLine}\n\n${summary}`;
+    if (reviewVerdict === 'changes_required' && unaddressed.length > 0) {
+        msg += `\n\nRework left ${unaddressed.length} findings unaddressed: ${unaddressed.join(', ')}.`;
+    }
+    return msg;
+}
+function isHookFailure(err) {
+    if (err instanceof Error) {
+        return /pre-commit hook|hook failed|hook rejected/i.test(err.message);
+    }
+    // gitC result shape: { code, stdout, stderr }
+    if (typeof err === 'object' && err !== null) {
+        const r = err;
+        const text = `${r.stderr ?? ''} ${r.stdout ?? ''}`;
+        return /pre-commit hook|hook failed|hook rejected|hook script|\.git\/hooks\//i.test(text);
+    }
+    return false;
+}
+// ─── Main handler ─────────────────────────────────────────────────────────────
+export async function commitHandler(state) {
+    const t0 = Date.now();
+    const cwd = state.cwd ?? state.executionContext?.cwd;
+    if (!cwd) {
+        return advanceNoOp('no_repo', t0, 'no cwd available');
     }
-    const filesChanged = realFiles.files;
     // Gate 1: no_repo
     if (!await isInsideWorkTree(cwd)) {
-        setSkip(state, 'no_repo');
-        return;
+        return advanceNoOp('no_repo', t0);
     }
-    // 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 2: detached HEAD / no branch → no_repo
+    const head = await currentHead(cwd);
+    if (!head) {
+        return advanceNoOp('no_repo', t0, 'detached HEAD or no branch');
+    }
+    // Use the existing getRealFilesChanged() helper (lifecycle/real-diff.ts).
+    // Reconciliation: plan said `realChange.method === 'git_error'`; the actual
+    // field on RealFilesChanged is `realChange.source === 'git_error'`.
+    const realChange = await getRealFilesChanged(state);
+    if (realChange.source === 'git_error' || realChange.files.length === 0) {
+        return advanceNoOp('no_diff', t0);
     }
-    // Gate 3: validation_failed
-    const validations = result.validationsRun ?? [];
-    if (validations.some((v) => !v.passed)) {
-        setSkip(state, 'validation_failed');
-        return;
+    const filesChanged = realChange.files;
+    // Gate 3: worker out-of-band commit detection
+    const preSha = state.preTaskHeadSha;
+    if (preSha && head !== preSha && realChange.source === 'self_report') {
+        return advanceNoOp('worker_committed_out_of_band', t0);
     }
-    // Gate 4: validation_stale (Rework ran but produced no fresh validations)
-    if (state.reworkApplied === true && validations.length === 0) {
-        setSkip(state, 'validation_stale');
-        return;
+    // Stage: git add
+    // Always run `git add` on the files we know about from getRealFilesChanged.
+    // If getRealFilesChanged returned empty (no preTaskHeadSha/preTaskUntrackedFiles),
+    // fall back to staging the files the worker reported. This ensures untracked
+    // files are staged so `git diff --cached` can detect them.
+    const filesToStage = filesChanged.length > 0 ? filesChanged : ((state.lastRunResult?.filesChanged) ?? []);
+    if (filesToStage.length === 0) {
+        return advanceNoOp('no_diff', t0);
     }
-    // Stage scoped to cwd
-    const addR = await gitC(cwd, ['add', '-A', '.']);
+    const addR = await gitC(cwd, ['add', '--', ...filesToStage]);
     if (addR.code !== 0) {
-        setSkip(state, 'hook_failed');
-        return;
+        return advanceNoOp('hook_failed', t0, addR.stderr || 'git add failed');
     }
-    // Gate 6: no_diff (post-stage)
+    // Post-stage: confirm staged diff is non-empty.
+    // `git diff --cached --quiet` exits 0 when nothing is staged; 1 when staged.
     const diffR = await gitC(cwd, ['diff', '--cached', '--quiet', '--', '.']);
     if (diffR.code === 0) {
-        setSkip(state, 'no_diff');
-        return;
+        return advanceNoOp('no_diff', t0);
     }
-    // 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)}`;
+    const commitMessage = composeCommitMessage(state);
+    try {
+        const commitR = await gitC(cwd, ['commit', '-m', commitMessage]);
+        if (commitR.code !== 0) {
+            // Hook failure is the dominant case: we've already validated repo,
+            // diff, and HEAD; if `git commit` still fails, the most likely cause
+            // is a pre-commit hook (or other policy hook) rejecting the commit.
+            // We treat non-zero exit as hook_failed unless the stderr indicates
+            // something structurally worse (corrupted index, fs errors).
+            const stderr = commitR.stderr ?? '';
+            const looksStructural = /index|object|corrupt|permission denied|read-only/i.test(stderr);
+            if (!looksStructural) {
+                return advanceNoOp('hook_failed', t0, stderr || 'commit rejected (likely pre-commit hook)');
+            }
+            return haltCommit(`commit_failed: ${stderr || 'unknown error'}`, t0);
         }
+        const sha = (await currentHead(cwd)) ?? '';
+        const authoredAt = new Date().toISOString();
+        return {
+            outcome: 'advance',
+            payload: {
+                kind: 'committed',
+                commitSha: sha,
+                commitMessage,
+                filesChanged,
+                authoredAt,
+            },
+            telemetry: {
+                stageLabel: 'committing',
+                durationMs: Date.now() - t0,
+                costUSD: 0,
+                turnsUsed: 0,
+                stopReason: 'normal',
+            },
+        };
     }
-    // Commit
-    const commitR = await gitC(cwd, ['commit', '-m', commitMessage]);
-    if (commitR.code !== 0) {
-        setSkip(state, 'hook_failed');
-        return;
+    catch (err) {
+        if (isHookFailure(err)) {
+            return advanceNoOp('hook_failed', t0, err instanceof Error ? err.message : String(err));
+        }
+        return haltCommit(`commit_failed: ${err instanceof Error ? err.message : String(err)}`, t0);
     }
-    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,
-            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: filesChanged.length,
-    }, { tier: 'standard', model: null });
 }
+// ─── Exports (backwards compatibility alias) ─────────────────────────────────
+// The old export name from v4.4.x; new code should use commitHandler.
+export { commitHandler as gitCommitHandler };
 //# 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":"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"}
+{"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/prepare-execution-context-handler.d.ts

@@ -1,19 +1,13 @@
 import type { LifecycleState } from '../stage-plan-types.js';
+import type { StageGate } from '../stage-io.js';
 /**
- * StageHandler for row 2.5 (prepare_execution_context).
+ * Stage handler: 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.
+ * Seeding: populates state.task, state.reviewPolicy, state.diffTracker.
+ * This handler is the canonical "state was set up correctly" acknowledgment
+ * for downstream handlers that read from these slots.
  *
- * 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.
+ * §5.1 payload: null. Gate exists only for the per-stage telemetry slot.
  */
-export declare function prepareExecutionContextHandler(state: LifecycleState): Promise<void>;
+export declare function prepareExecutionContextHandler(state: LifecycleState): Promise<StageGate<null>>;
 //# sourceMappingURL=prepare-execution-context-handler.d.ts.map

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

@@ -1 +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;AAI7D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,8BAA8B,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCzF"}
+{"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;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD;;;;;;;;GAQG;AACH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CA0E1B"}