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

package/dist/lifecycle/handlers/quality-chain-handlers.js

@@ -0,0 +1,189 @@
+import { pickReviewer, pickEscalation } from '../../escalation/policy.js';
+import { ReviewerParseError } from '../../review/reviewer-engine.js';
+import { delegateWithEscalation } from '../../escalation/delegate-with-escalation.js';
+import { runWithFallback, TRANSPORT_FAILURES, isReviewTransportFailure, makeSyntheticRunResult, } from '../../escalation/fallback.js';
+import { makeSkippedReviewResult } from '../../review/skipped-result.js';
+import { makeRunnerShell } from '../../providers/make-runner-shell.js';
+async function runQualityReviewRound(input) {
+    const { state, ctx, round } = input;
+    const last = state.lastRunResult;
+    if (!last)
+        return null;
+    const implReport = last.implementationReport ?? last.structuredReport;
+    if (!implReport)
+        return null;
+    const baseTier = ctx.assignedTier;
+    const reviewerTier = pickReviewer({ loop: 'quality', attemptIndex: round - 1, baseTier });
+    const task = state.task;
+    if (!task)
+        return null;
+    const route = (state.route ?? ctx.route);
+    const isArtifactProducing = state.toolCategory === 'artifact_producing';
+    const fileContents = {};
+    const toolCallLog = last.toolCalls ?? [];
+    const filesWritten = last.filesWritten ?? [];
+    state.qualityUnavailable ??= new Map();
+    const qualityUnavailable = state.qualityUnavailable;
+    const reviewerCall = await runWithFallback({
+        assigned: reviewerTier,
+        providerFor: (tier) => ctx.providers[tier],
+        unavailableTiers: qualityUnavailable,
+        isTransportFailure: (r) => isReviewTransportFailure(r),
+        getStatus: (r) => r.status,
+        makeSyntheticFailure: () => makeSkippedReviewResult('all_tiers_unavailable'),
+        call: async (provider) => {
+            const shell = makeRunnerShell(provider);
+            if (isArtifactProducing) {
+                const engine = ctx.reviewerEngine;
+                if (!engine)
+                    throw new Error('reviewerEngine not configured');
+                try {
+                    return engine.runQualityAP(shell, {
+                        workerOutput: last.output,
+                        brief: task.prompt ?? '',
+                        cwd: ctx.cwd,
+                        route,
+                        fileContents,
+                        toolCallLog,
+                        filesWritten,
+                        abortSignal: ctx.stall.controller.signal,
+                        deadlineMs: ctx.timing.deadlineMs,
+                    });
+                }
+                catch (err) {
+                    if (err instanceof ReviewerParseError) {
+                        return { verdict: 'error', concerns: [] };
+                    }
+                    throw err;
+                }
+            }
+            const annotator = ctx.annotatorEngine;
+            if (!annotator)
+                throw new Error('annotatorEngine not configured');
+            return annotator.annotate(shell, {
+                workerOutput: last.output,
+                brief: task.prompt ?? '',
+                cwd: ctx.cwd,
+                route: route,
+                abortSignal: ctx.stall.controller.signal,
+                deadlineMs: ctx.timing.deadlineMs,
+            });
+        },
+    });
+    if (reviewerCall.bothUnavailable)
+        return null;
+    const out = reviewerCall.result;
+    if ('status' in out && out.status === 'skipped')
+        return null;
+    return out;
+}
+async function runQualityRework(state, ctx, attemptIndex) {
+    const task = state.task;
+    if (!task)
+        return null;
+    const baseTier = ctx.assignedTier;
+    const decision = pickEscalation({ loop: 'quality', attemptIndex, baseTier });
+    state.qualityChainAttemptIndex = attemptIndex;
+    state.qualityUnavailable ??= new Map();
+    const qualityUnavailable = state.qualityUnavailable;
+    const reworkPrompt = (task.prompt ?? '') + '\n\n[quality rework — address the prior reviewer feedback]';
+    const reworkCall = await runWithFallback({
+        assigned: decision.impl,
+        providerFor: (tier) => ctx.providers[tier],
+        unavailableTiers: qualityUnavailable,
+        isTransportFailure: (r) => TRANSPORT_FAILURES.has(r.status) && r.incompleteReason === undefined,
+        getStatus: (r) => r.status,
+        makeSyntheticFailure: (assigned) => makeSyntheticRunResult(assigned, 'all_tiers_unavailable'),
+        call: (provider) => delegateWithEscalation({
+            prompt: reworkPrompt,
+            cwd: ctx.cwd,
+            agentType: decision.impl,
+            briefQualityPolicy: 'off',
+            timeoutMs: ctx.timing.timeoutMs,
+        }, [provider], {
+            explicitlyPinned: true,
+            taskDeadlineMs: ctx.timing.deadlineMs,
+            abortSignal: ctx.stall.controller.signal,
+            assignedTier: decision.impl,
+        }),
+    });
+    if (reworkCall.bothUnavailable)
+        return null;
+    const result = reworkCall.result;
+    if (result.status !== 'ok')
+        return null;
+    return result;
+}
+function mapQualityVerdict(result) {
+    if ('status' in result && result.status === 'skipped')
+        return 'skipped';
+    return result.verdict;
+}
+function makeQualityReviewHandler(round) {
+    const slot = `qualityReviewRound${round}Verdict`;
+    return async function qualityReviewRoundHandler(state) {
+        if (state[slot])
+            return;
+        const ctx = state.executionContext;
+        if (!ctx)
+            return;
+        const result = await runQualityReviewRound({ state, ctx, round });
+        if (!result)
+            return;
+        state[slot] = mapQualityVerdict(result);
+    };
+}
+function makeQualityReworkHandler(reworkIndex) {
+    // rework_1 → attemptIndex 1 (quality index 0 has impl: null and would throw)
+    // rework_2 → attemptIndex 2
+    const attemptIndex = reworkIndex === 1 ? 1 : 2;
+    return async function qualityReworkHandler(state) {
+        const ctx = state.executionContext;
+        if (!ctx)
+            return;
+        const newResult = await runQualityRework(state, ctx, attemptIndex);
+        if (!newResult)
+            return;
+        state.lastRunResult = newResult;
+    };
+}
+export const qualityReviewRound1Handler = makeQualityReviewHandler(1);
+export const qualityReviewRound2Handler = makeQualityReviewHandler(2);
+export const qualityReviewRound3Handler = makeQualityReviewHandler(3);
+export const qualityReworkRound1Handler = makeQualityReworkHandler(1);
+export const qualityReworkRound2Handler = makeQualityReworkHandler(2);
+/**
+ * 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 function settleQualityChainHandler(state) {
+    if (typeof state.qualityChainPassed === 'boolean')
+        return;
+    const v1 = state.qualityReviewRound1Verdict;
+    const v2 = state.qualityReviewRound2Verdict;
+    const v3 = state.qualityReviewRound3Verdict;
+    if (v1 === undefined && v2 === undefined && v3 === undefined)
+        return;
+    const passy = (v) => v === 'approved' || v === 'annotated' || v === 'skipped';
+    if (passy(v1) || passy(v2) || passy(v3)) {
+        state.qualityChainPassed = true;
+        return;
+    }
+    if (v1 === 'error' || v2 === 'error' || v3 === 'error') {
+        state.qualityChainPassed = false;
+        state.terminal = true;
+        return;
+    }
+    state.qualityChainPassed = false;
+}
+//# sourceMappingURL=quality-chain-handlers.js.map

package/dist/lifecycle/handlers/quality-chain-handlers.js.map

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

package/dist/lifecycle/handlers/register-context-block-handlers.d.ts

@@ -0,0 +1,3 @@
+import type { LifecycleState } from '../stage-plan-types.js';
+export declare function registerToBlockStoreHandler(state: LifecycleState): void;
+//# sourceMappingURL=register-context-block-handlers.d.ts.map

package/dist/lifecycle/handlers/register-context-block-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-context-block-handlers.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/register-context-block-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAevE"}

package/dist/lifecycle/handlers/register-context-block-handlers.js

@@ -0,0 +1,18 @@
+export function registerToBlockStoreHandler(state) {
+    if (state.terminal)
+        return;
+    const pc = state.projectContext;
+    const req = state.request;
+    if (!pc || !req?.content) {
+        state.terminal = true;
+        state.errorCode = 'invalid_request';
+        return;
+    }
+    const registered = pc.contextBlocks.register(req.content);
+    state.blockRegistration = {
+        id: registered.id,
+        size: Buffer.byteLength(req.content, 'utf8'),
+        ttlMs: pc.contextBlocks.ttlMs,
+    };
+}
+//# sourceMappingURL=register-context-block-handlers.js.map

package/dist/lifecycle/handlers/register-context-block-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-context-block-handlers.js","sourceRoot":"","sources":["../../../src/lifecycle/handlers/register-context-block-handlers.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,2BAA2B,CAAC,KAAqB;IAC/D,IAAI,KAAK,CAAC,QAAQ;QAAE,OAAO;IAC3B,MAAM,EAAE,GAAG,KAAK,CAAC,cAA4C,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAK,CAAC,OAA0C,CAAC;IAC7D,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;QACzB,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;QACtB,KAAK,CAAC,SAAS,GAAG,iBAAiB,CAAC;QACpC,OAAO;IACT,CAAC;IACD,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1D,KAAK,CAAC,iBAAiB,GAAG;QACxB,EAAE,EAAE,UAAU,CAAC,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC;QAC5C,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK;KAC9B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { LifecycleState } from '../stage-plan-types.js';
+/**
+ * StageHandler for row 4.13 (review_diff).
+ *
+ * Reads from state:
+ *   - state.task / state.executionContext for cwd, providers, timing
+ *   - state.verifyResult: VerifyStageResult required by reviewerEngine.runDiff
+ *   - state.diffReviewVerdict: idempotency guard
+ *
+ * Writes to state:
+ *   - state.diffReviewKind: raw verdict from reviewerEngine.runDiff
+ *   - state.diffReviewVerdict: envelope-mapped status
+ *   - state.terminal = true on 'changes_required' (reject) or 'error'
+ *
+ * Verdict mapping:
+ *   kind: 'approve'           → envelope 'approved'
+ *   kind: 'concerns'          → envelope 'approved' (concerns are flagged
+ *                                but non-blocking by design)
+ *   kind: 'reject'            → envelope 'changes_required'
+ *   kind: 'transport_failure' → envelope 'error'
+ *
+ * Both slots are written so downstream telemetry can distinguish 'approve'
+ * from 'concerns' (both map to envelope 'approved').
+ *
+ * Defensive no-op when state.executionContext, state.verifyResult, or the
+ * reviewer provider for the picked tier is missing. Diff is computed via
+ * `git diff HEAD~..HEAD` against the cwd; if git fails, the handler
+ * records an envelope 'error' and sets terminal.
+ */
+export declare function reviewDiffHandler(state: LifecycleState): Promise<void>;
+//# sourceMappingURL=review-diff-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review-diff-handler.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/review-diff-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAgB7D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAuE5E"}

package/dist/lifecycle/handlers/review-diff-handler.js

@@ -0,0 +1,107 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { pickReviewer } from '../../escalation/policy.js';
+import { runWithFallback, isReviewTransportFailure, } from '../../escalation/fallback.js';
+import { makeSkippedReviewResult } from '../../review/skipped-result.js';
+import { makeRunnerShell } from '../../providers/make-runner-shell.js';
+const exec = promisify(execFile);
+/**
+ * StageHandler for row 4.13 (review_diff).
+ *
+ * Reads from state:
+ *   - state.task / state.executionContext for cwd, providers, timing
+ *   - state.verifyResult: VerifyStageResult required by reviewerEngine.runDiff
+ *   - state.diffReviewVerdict: idempotency guard
+ *
+ * Writes to state:
+ *   - state.diffReviewKind: raw verdict from reviewerEngine.runDiff
+ *   - state.diffReviewVerdict: envelope-mapped status
+ *   - state.terminal = true on 'changes_required' (reject) or 'error'
+ *
+ * Verdict mapping:
+ *   kind: 'approve'           → envelope 'approved'
+ *   kind: 'concerns'          → envelope 'approved' (concerns are flagged
+ *                                but non-blocking by design)
+ *   kind: 'reject'            → envelope 'changes_required'
+ *   kind: 'transport_failure' → envelope 'error'
+ *
+ * Both slots are written so downstream telemetry can distinguish 'approve'
+ * from 'concerns' (both map to envelope 'approved').
+ *
+ * Defensive no-op when state.executionContext, state.verifyResult, or the
+ * reviewer provider for the picked tier is missing. Diff is computed via
+ * `git diff HEAD~..HEAD` against the cwd; if git fails, the handler
+ * records an envelope 'error' and sets terminal.
+ */
+export async function reviewDiffHandler(state) {
+    if (state.diffReviewVerdict)
+        return;
+    const ctx = state.executionContext;
+    if (!ctx)
+        return;
+    const verifyResult = state.verifyResult;
+    if (!verifyResult)
+        return;
+    const baseTier = ctx.assignedTier;
+    const reviewerTier = pickReviewer({ loop: 'spec', attemptIndex: 0, baseTier });
+    let diff = '';
+    try {
+        const { stdout } = await exec('git', ['diff', 'HEAD~..HEAD'], { cwd: ctx.cwd });
+        const cap = 64 * 1024;
+        const bytes = Buffer.byteLength(stdout, 'utf8');
+        diff = bytes > cap
+            ? Buffer.from(stdout, 'utf8').subarray(0, cap).toString('utf8') + '\n[diff truncated]'
+            : stdout;
+    }
+    catch {
+        state.diffReviewVerdict = 'error';
+        state.terminal = true;
+        return;
+    }
+    state.diffUnavailable ??= new Map();
+    const diffUnavailable = state.diffUnavailable;
+    const diffCall = await runWithFallback({
+        assigned: reviewerTier,
+        providerFor: (tier) => ctx.providers[tier],
+        unavailableTiers: diffUnavailable,
+        isTransportFailure: (r) => isReviewTransportFailure(r),
+        getStatus: (r) => r.status,
+        makeSyntheticFailure: () => makeSkippedReviewResult('all_tiers_unavailable'),
+        call: async (provider) => {
+            const shell = makeRunnerShell(provider);
+            const engine = ctx.reviewerEngine;
+            if (!engine)
+                throw new Error('reviewerEngine not configured');
+            return engine.runDiff(shell, {
+                workerOutput: diff,
+                brief: `verification: ${verifyResult.status}\n${verifyResult.steps.map(s => `- ${s.command} → ${s.status}`).join('\n')}`,
+                cwd: ctx.cwd,
+                abortSignal: ctx.stall.controller.signal,
+                deadlineMs: ctx.timing.deadlineMs,
+            });
+        },
+    });
+    if (diffCall.bothUnavailable) {
+        state.diffReviewVerdict = 'skipped';
+        return;
+    }
+    const verdictOrSkipped = diffCall.result;
+    if ('status' in verdictOrSkipped && verdictOrSkipped.status === 'skipped') {
+        state.diffReviewVerdict = 'skipped';
+        return;
+    }
+    const result = verdictOrSkipped;
+    state.diffReviewKind = result.verdict;
+    if (result.verdict === 'approve' || result.verdict === 'concerns') {
+        state.diffReviewVerdict = 'approved';
+    }
+    else if (result.verdict === 'reject') {
+        state.diffReviewVerdict = 'changes_required';
+        state.terminal = true;
+    }
+    else {
+        state.diffReviewVerdict = 'error';
+        state.terminal = true;
+    }
+}
+//# sourceMappingURL=review-diff-handler.js.map

package/dist/lifecycle/handlers/review-diff-handler.js.map

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

package/dist/lifecycle/handlers/run-verify-command-handler.d.ts

@@ -0,0 +1,25 @@
+import type { LifecycleState } from '../stage-plan-types.js';
+/**
+ * StageHandler for row 5.1 (run_verify_command).
+ *
+ * Reads from state:
+ *   - state.task: TaskSpec with verifyCommand + cwd + timeoutMs
+ *   - state.executionContext: timing budgets, bus, stageStats
+ *   - state.verifyResult: idempotency guard — if an upstream stage already
+ *     populated it (e.g., a verify-tool route running its own verification),
+ *     this handler skips so verify doesn't run twice.
+ *
+ * Writes to state:
+ *   - state.verifyResult: VerifyStageResult
+ *   - state.stageStats: aggregated via endVerifyStage()
+ *
+ * Emits via ctx.bus:
+ *   - 'verify_step' per step
+ *   - 'verify_skipped' when no command or skipped
+ *
+ * The runCondition on row 5.1 (toolCategory==='artifact_producing' &&
+ * route!=='verify' && reviewPolicy!=='none' && !terminal) gates entry; once
+ * inside, the handler defensively no-ops on missing state slots.
+ */
+export declare function runVerifyCommandHandler(state: LifecycleState): Promise<void>;
+//# sourceMappingURL=run-verify-command-handler.d.ts.map

package/dist/lifecycle/handlers/run-verify-command-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-verify-command-handler.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/run-verify-command-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAM7D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BlF"}

package/dist/lifecycle/handlers/run-verify-command-handler.js

@@ -0,0 +1,75 @@
+import { runVerifyStage } from './verify-stage.js';
+/**
+ * StageHandler for row 5.1 (run_verify_command).
+ *
+ * Reads from state:
+ *   - state.task: TaskSpec with verifyCommand + cwd + timeoutMs
+ *   - state.executionContext: timing budgets, bus, stageStats
+ *   - state.verifyResult: idempotency guard — if an upstream stage already
+ *     populated it (e.g., a verify-tool route running its own verification),
+ *     this handler skips so verify doesn't run twice.
+ *
+ * Writes to state:
+ *   - state.verifyResult: VerifyStageResult
+ *   - state.stageStats: aggregated via endVerifyStage()
+ *
+ * Emits via ctx.bus:
+ *   - 'verify_step' per step
+ *   - 'verify_skipped' when no command or skipped
+ *
+ * The runCondition on row 5.1 (toolCategory==='artifact_producing' &&
+ * route!=='verify' && reviewPolicy!=='none' && !terminal) gates entry; once
+ * inside, the handler defensively no-ops on missing state slots.
+ */
+export async function runVerifyCommandHandler(state) {
+    // Idempotency: if a prior stage already populated verifyResult, skip so
+    // verify doesn't run twice.
+    if (state.verifyResult)
+        return;
+    const task = state.task;
+    const ctx = state.executionContext;
+    // Defensive no-op when state.task / state.executionContext aren't set.
+    if (!task || !ctx)
+        return;
+    const verifyCommand = task.verifyCommand;
+    const cwd = ctx.cwd;
+    const taskTimeoutMs = ctx.timing.timeoutMs;
+    const taskStartMs = ctx.timing.startMs;
+    const verification = await runVerifyStage({
+        cwd,
+        verifyCommand,
+        taskTimeoutMs,
+        taskStartMs,
+    });
+    state.verifyResult = verification;
+    emitVerifyEvents(ctx.bus, verification);
+    // Stage stats integration deferred: endVerifyStage takes cost meter +
+    // agent info + idle stats that don't yet flow through ExecutionContext.
+    // Step 6 (terminal handlers) will fold verify outcome into stageStats once
+    // cost-rollup and idle tracking are part of the context.
+}
+function emitVerifyEvents(bus, verification) {
+    if (!bus)
+        return;
+    for (const step of verification.steps) {
+        bus.emit({
+            event: 'verify_step',
+            ts: new Date().toISOString(),
+            command: step.command,
+            status: step.status,
+            ...(step.exitCode !== null && { exitCode: step.exitCode }),
+            ...(step.signal !== null && { signal: step.signal }),
+            durationMs: step.durationMs,
+            ...(step.errorMessage !== null && { errorMessage: step.errorMessage }),
+        });
+    }
+    if (verification.status === 'skipped') {
+        bus.emit({
+            event: 'verify_skipped',
+            ts: new Date().toISOString(),
+            reason: verification.skipReason ?? 'no_command',
+            stage: 'verifying',
+        });
+    }
+}
+//# sourceMappingURL=run-verify-command-handler.js.map

package/dist/lifecycle/handlers/run-verify-command-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-verify-command-handler.js","sourceRoot":"","sources":["../../../src/lifecycle/handlers/run-verify-command-handler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAA0B,MAAM,mBAAmB,CAAC;AAG3E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAAqB;IACjE,wEAAwE;IACxE,4BAA4B;IAC5B,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO;IAE/B,MAAM,IAAI,GAAG,KAAK,CAAC,IAA4B,CAAC;IAChD,MAAM,GAAG,GAAG,KAAK,CAAC,gBAAgD,CAAC;IAEnE,uEAAuE;IACvE,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG;QAAE,OAAO;IAE1B,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IACzC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACpB,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;IAC3C,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;IAEvC,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC;QACxC,GAAG;QACH,aAAa;QACb,aAAa;QACb,WAAW;KACZ,CAAC,CAAC;IAEH,KAAK,CAAC,YAAY,GAAG,YAAY,CAAC;IAElC,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAExC,sEAAsE;IACtE,wEAAwE;IACxE,2EAA2E;IAC3E,yDAAyD;AAC3D,CAAC;AAED,SAAS,gBAAgB,CAAC,GAA6B,EAAE,YAA+B;IACtF,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC;YACP,KAAK,EAAE,aAAa;YACpB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1D,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YACpD,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;SAC5C,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,YAAY,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC;YACP,KAAK,EAAE,gBAAgB;YACvB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,MAAM,EAAE,YAAY,CAAC,UAAU,IAAI,YAAY;YAC/C,KAAK,EAAE,WAAW;SACQ,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,21 @@
+import type { LifecycleState } from '../stage-plan-types.js';
+export declare const specReviewRound1Handler: (state: LifecycleState) => Promise<void>;
+export declare const specReviewRound2Handler: (state: LifecycleState) => Promise<void>;
+export declare const specReviewRound3Handler: (state: LifecycleState) => Promise<void>;
+export declare const specReworkRound1Handler: (state: LifecycleState) => Promise<void>;
+export declare const specReworkRound2Handler: (state: LifecycleState) => Promise<void>;
+/**
+ * Settle handler (row 4.6). Reads the three round verdicts and writes
+ * state.specChainPassed.
+ *
+ * Cascade rule:
+ *   - Any 'approved' verdict in the chain ⇒ chain passed (true)
+ *   - '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: skips when state.specChainPassed is
+ * already populated.
+ */
+export declare function settleSpecChainHandler(state: LifecycleState): void;
+//# sourceMappingURL=spec-chain-handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-chain-handlers.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/spec-chain-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA+K7D,eAAO,MAAM,uBAAuB,UApBkB,cAAc,KAAG,OAAO,CAAC,IAAI,CAoBpB,CAAC;AAChE,eAAO,MAAM,uBAAuB,UArBkB,cAAc,KAAG,OAAO,CAAC,IAAI,CAqBpB,CAAC;AAChE,eAAO,MAAM,uBAAuB,UAtBkB,cAAc,KAAG,OAAO,CAAC,IAAI,CAsBpB,CAAC;AAChE,eAAO,MAAM,uBAAuB,UAZa,cAAc,KAAG,OAAO,CAAC,IAAI,CAYf,CAAC;AAChE,eAAO,MAAM,uBAAuB,UAba,cAAc,KAAG,OAAO,CAAC,IAAI,CAaf,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAkBlE"}