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

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

@@ -0,0 +1,289 @@
+// v4.4.x — unified Annotating stage.
+//
+// Pure transform: builds the canonical StructuredReport from
+// state.lastRunResult, the Review stage's verdict + concerns, the
+// Rework flag, and the Committing stage's outcome. Same handler for
+// read and write routes — route-specific fields hold empty arrays /
+// nulls on the other side so the orchestrator parses one shape.
+import { mergeStageStats } from '../merge-stage-stats.js';
+import { parseSourcesUsed, } from '../../reporting/report-parser-slots/research-report.js';
+import { applyAnnotatePreconditions } from '../annotate-parser.js';
+import { annotatePromptWrite, annotatePromptRead } from '../annotate-prompts.js';
+import { runAnnotatorTurn } from '../../providers/run-annotator-turn.js';
+const READ_ROUTES = new Set(['audit', 'review', 'debug', 'investigate', 'research']);
+function safeTracker(fn, ctx) {
+    try {
+        fn();
+    }
+    catch (e) {
+        ctx.logger?.error('heartbeat_call_failed', e);
+    }
+}
+export async function annotator(state) {
+    const annCtx = state.executionContext;
+    if (annCtx) {
+        safeTracker(() => annCtx.heartbeat?.transition({ stage: 'annotating' }), annCtx);
+    }
+    const t0 = Date.now();
+    const last = (state.lastRunResult ?? {});
+    const route = state.route;
+    const isRead = !!route && READ_ROUTES.has(route);
+    const findings = last.findings ?? [];
+    const summary = last.summary
+        ?? (isRead ? `produced ${findings.length} findings` : (last.output ?? '').slice(0, 200));
+    const report = {
+        summary,
+        workerStatus: last.workerStatus ?? (isRead ? 'done' : 'failed'),
+        unresolved: last.unresolved ?? [],
+        filesChanged: isRead ? [] : (last.filesChanged ?? []),
+        reviewVerdict: isRead ? null : ((state.reviewVerdict) ?? null),
+        reviewConcerns: isRead ? [] : ((state.reviewConcerns) ?? []),
+        reworkApplied: isRead ? false : Boolean(state.reworkApplied),
+        validationsRun: isRead ? [] : (last.validationsRun ?? []),
+        commitSha: isRead ? null : (last.commitSha ?? null),
+        commitMessage: isRead ? null : (last.commitMessage ?? null),
+        commitSkipReason: isRead ? null : (last.commitSkipReason ?? null),
+        findings: isRead ? findings : [],
+        criteriaErrors: isRead ? (last.criteriaErrors ?? []) : [],
+    };
+    if (route === 'research') {
+        const lastOutput = last.output ?? '';
+        report.sourcesUsed = parseSourcesUsed(lastOutput);
+    }
+    state.structuredReport = report;
+    // v5: prompt-budget truncation per spec §14 assumption 7 + AC-30 to AC-33.
+    // Three tiers, applied progressively when config.truncateAnnotatePromptTier
+    // signals overflow:
+    //   tier 1 → strip Finding.evidence
+    //   tier 2 → also strip summary fields (set to '')
+    //   tier 3 → fallback mode: emit deterministic AnnotatePayload with verbatim
+    //            spec-text message; completed=false; findings passthrough.
+    const cfg = state.config ?? {};
+    const tier = cfg.truncateAnnotatePromptTier ?? 0;
+    const bus = state.executionContext?.bus;
+    const reviewGate = state.gates?.['review'];
+    const implementGate = state.gates?.['implement'];
+    const aggregatedFindings = [
+        ...(last.findings ?? []),
+        ...((reviewGate?.outcome === 'advance' ? reviewGate.payload?.findings : undefined) ?? []),
+        ...((implementGate?.outcome === 'advance' ? implementGate.payload?.findings : undefined) ?? []),
+    ];
+    // Dedupe by claim+evidence (preserve first occurrence)
+    const seen = new Set();
+    const dedupedFindings = [];
+    for (const f of aggregatedFindings) {
+        const key = `${f.claim ?? ''}|${f.evidence ?? ''}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        dedupedFindings.push(f);
+    }
+    // Mechanical filesChanged + commitSha derivation (spec §5.7 rule 4)
+    const commitGate = state.gates?.['commit'];
+    const mechanicalFilesChanged = commitGate?.outcome === 'advance' &&
+        commitGate.payload?.kind === 'committed'
+        ? commitGate.payload.filesChanged ?? []
+        : (isRead ? [] : report.filesChanged);
+    const mechanicalCommitSha = commitGate?.outcome === 'advance' &&
+        commitGate.payload?.kind === 'committed'
+        ? (commitGate.payload.commitSha ?? null)
+        : (isRead ? null : (report.commitSha ?? null));
+    let truncatedFindings = dedupedFindings.slice();
+    let truncatedSummary = report.summary;
+    let fallbackMode = false;
+    if (tier >= 1) {
+        const droppedEvidenceCount = truncatedFindings.filter(f => f.evidence !== undefined).length;
+        truncatedFindings = truncatedFindings.map(f => {
+            const cp = { ...f };
+            delete cp.evidence;
+            return cp;
+        });
+        bus?.emit({ event: 'annotate_truncation', ts: new Date().toISOString(), tier: 1, droppedFieldCount: droppedEvidenceCount });
+    }
+    if (tier >= 2) {
+        const dropped = truncatedSummary ? 1 : 0;
+        truncatedSummary = '';
+        bus?.emit({ event: 'annotate_truncation', ts: new Date().toISOString(), tier: 2, droppedFieldCount: dropped });
+    }
+    if (tier >= 3) {
+        // Tier 3 = fallback mode per spec §5.7.3
+        fallbackMode = true;
+        bus?.emit({ event: 'annotate_truncation', ts: new Date().toISOString(), tier: 3, droppedFieldCount: 0 });
+    }
+    let annotated;
+    // LLM judge layer (spec §5.7.2). The annotator stage runs an LLM turn
+    // unless tier-3 truncation kicked us into fallback mode. The LLM is the
+    // proposer; the deterministic parser is the enforcer — applyAnnotatePreconditions
+    // always runs on the LLM-proposed payload and may flip completed=false. On
+    // transport error we fall back to mechanical synthesis (same path that ran
+    // before this layer was added).
+    let llmCostUSD = 0;
+    let llmDurationMs = 0;
+    let llmTurnsUsed = 0;
+    let llmTransportFailed = false;
+    let llmModel = null;
+    let llmInputTokens = 0;
+    let llmOutputTokens = 0;
+    let llmCachedReadTokens = 0;
+    let llmCachedNonReadTokens = 0;
+    if (fallbackMode) {
+        // Fallback findings: only gate-sourced findings flow through (gates.review,
+        // gates.implement). lastRunResult.findings are dropped as part of tier-3
+        // citation/non-gate-evidence clearing (spec §5.7.3 / AC-32).
+        const fallbackFindings = [];
+        const fbSeen = new Set();
+        const reviewFindings = (reviewGate?.outcome === 'advance' ? reviewGate.payload?.findings : undefined) ?? [];
+        const implementFindings = (implementGate?.outcome === 'advance' ? implementGate.payload?.findings : undefined) ?? [];
+        for (const f of [...reviewFindings, ...implementFindings]) {
+            const k = `${f.claim ?? ''}|${f.evidence ?? ''}`;
+            if (fbSeen.has(k))
+                continue;
+            fbSeen.add(k);
+            const cp = { ...f };
+            delete cp.evidence;
+            fallbackFindings.push(cp);
+        }
+        annotated = {
+            completed: false,
+            message: 'annotator prompt budget exceeded after tier-3 truncation; verdict computed mechanically from upstream gates',
+            findings: fallbackFindings,
+            summary: '',
+            filesChanged: mechanicalFilesChanged,
+            commitSha: mechanicalCommitSha,
+        };
+    }
+    else {
+        // Default mechanical proposal — used directly when LLM fails or returns
+        // unparseable output. The parser still gets the final say either way.
+        const mechanical = {
+            completed: true,
+            message: truncatedSummary || (isRead ? 'investigation completed' : 'task completed'),
+            findings: truncatedFindings,
+            summary: truncatedSummary,
+            filesChanged: mechanicalFilesChanged,
+            commitSha: mechanicalCommitSha,
+        };
+        let proposed = mechanical;
+        const ctx = state.executionContext;
+        if (ctx && typeof ctx.getSession === 'function') {
+            const prompt = isRead ? annotatePromptRead(state) : annotatePromptWrite(state);
+            const tres = await runAnnotatorTurn({ prompt, ctx: ctx, tier: 'standard' });
+            if (tres.kind === 'ok') {
+                llmCostUSD = tres.costUSD ?? 0;
+                llmModel = tres.model;
+                llmDurationMs = tres.ms;
+                llmTurnsUsed = tres.turnsUsed;
+                llmInputTokens = tres.inputTokens;
+                llmOutputTokens = tres.outputTokens;
+                llmCachedReadTokens = tres.cachedReadTokens;
+                llmCachedNonReadTokens = tres.cachedNonReadTokens;
+                const parsed = extractAnnotateJson(tres.text);
+                if (parsed) {
+                    // Authoritative fields come from upstream gates (mechanicalFilesChanged,
+                    // mechanicalCommitSha, dedupedFindings). The LLM gets to propose
+                    // completed + message + summary; everything mechanical we override.
+                    proposed = {
+                        completed: typeof parsed.completed === 'boolean' ? parsed.completed : mechanical.completed,
+                        message: typeof parsed.message === 'string' && parsed.message.length > 0 ? parsed.message : mechanical.message,
+                        summary: typeof parsed.summary === 'string' ? parsed.summary : mechanical.summary,
+                        findings: truncatedFindings,
+                        filesChanged: mechanicalFilesChanged,
+                        commitSha: mechanicalCommitSha,
+                    };
+                }
+                // parsed === null → keep mechanical (parser unaffected)
+            }
+            else {
+                // transport_error — fall through to mechanical synthesis
+                llmTransportFailed = true;
+                llmDurationMs = tres.ms;
+                bus?.emit({ event: 'annotate_llm_transport_error', ts: new Date().toISOString(), message: tres.message, durationMs: tres.ms });
+            }
+        }
+        annotated = applyAnnotatePreconditions(proposed, state);
+    }
+    state.annotatePayload = annotated;
+    mergeStageStats(state, 'annotating', {
+        inputTokens: llmInputTokens,
+        outputTokens: llmOutputTokens,
+        cachedReadTokens: llmCachedReadTokens,
+        cachedNonReadTokens: llmCachedNonReadTokens,
+        turnCount: llmTurnsUsed,
+        toolCallCount: 0,
+        costUSD: llmCostUSD,
+        durationMs: Date.now() - t0,
+        filesReadCount: 0,
+        filesWrittenCount: 0,
+    }, { tier: llmTurnsUsed > 0 ? 'standard' : null, model: llmModel });
+    // suppress unused-variable warning while keeping the durationMs field for
+    // diagnostics callers; mergeStageStats already captured the value above.
+    void llmDurationMs;
+    void llmTransportFailed;
+    const annotatingStats = state.lastRunResult
+        ?.stageStats?.annotating;
+    if (annotatingStats) {
+        annotatingStats.outcome = 'transformed';
+        annotatingStats.maxIdleMs = 0;
+        annotatingStats.totalIdleMs = 0;
+    }
+    return {
+        outcome: 'advance',
+        payload: annotated,
+        telemetry: {
+            stageLabel: 'annotate',
+            durationMs: Date.now() - t0,
+            costUSD: llmCostUSD,
+            turnsUsed: llmTurnsUsed,
+            stopReason: 'normal',
+        },
+    };
+}
+/**
+ * Extract a single JSON object from the LLM's response.
+ *
+ * Accepts:
+ *   - A fenced ```json …``` block (preferred form per annotate prompts)
+ *   - A fenced ``` …``` block (no language tag)
+ *   - The first balanced `{…}` substring in the text
+ *
+ * Returns `null` if no parseable JSON is found, signalling the caller to keep
+ * the mechanical proposal. This is intentional: a malformed LLM response
+ * should not cause stage failure — the parser already has a deterministic
+ * answer it can fall back on.
+ */
+function extractAnnotateJson(text) {
+    if (!text)
+        return null;
+    const fencedJson = text.match(/```(?:json)?\s*\n([\s\S]*?)\n```/i);
+    const candidate = fencedJson ? fencedJson[1] : firstBalancedBraces(text);
+    if (!candidate)
+        return null;
+    try {
+        const parsed = JSON.parse(candidate);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    return null;
+}
+function firstBalancedBraces(text) {
+    const start = text.indexOf('{');
+    if (start < 0)
+        return null;
+    let depth = 0;
+    for (let i = start; i < text.length; i++) {
+        const ch = text[i];
+        if (ch === '{')
+            depth++;
+        else if (ch === '}') {
+            depth--;
+            if (depth === 0)
+                return text.slice(start, i + 1);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=annotate-stage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"annotate-stage.js","sourceRoot":"","sources":["../../../src/lifecycle/handlers/annotate-stage.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,EAAE;AACF,6DAA6D;AAC7D,kEAAkE;AAClE,oEAAoE;AACpE,oEAAoE;AACpE,gEAAgE;AAGhE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EACL,gBAAgB,GAEjB,MAAM,wDAAwD,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAGzE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;AAErF,SAAS,WAAW,CAAC,EAAc,EAAE,GAAiE;IACpG,IAAI,CAAC;QAAC,EAAE,EAAE,CAAC;IAAC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC;IAAC,CAAC;AAC5E,CAAC;AAqBD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAqB;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,gBAAwM,CAAC;IAC9N,IAAI,MAAM,EAAE,CAAC;QACX,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,IAAI,GAAG,CAAE,KAAK,CAAC,aAAqD,IAAI,EAAE,CAAC,CAAC;IAClF,MAAM,KAAK,GAAI,KAA4B,CAAC,KAAK,CAAC;IAClD,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEjD,MAAM,QAAQ,GAAI,IAAI,CAAC,QAAqD,IAAI,EAAE,CAAC;IACnF,MAAM,OAAO,GAAI,IAAI,CAAC,OAA8B;WAC/C,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,QAAQ,CAAC,MAAM,WAAW,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,MAA6B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAEnH,MAAM,MAAM,GAAqB;QAC/B,OAAO;QACP,YAAY,EAAG,IAAI,CAAC,YAA6D,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QACjH,UAAU,EAAG,IAAI,CAAC,UAAmC,IAAI,EAAE;QAC3D,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,YAAqC,IAAI,EAAE,CAAC;QAC/E,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,KAA+D,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC;QACzH,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,KAAuC,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC/F,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAE,KAAqC,CAAC,aAAa,CAAC;QAC7F,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,cAAiE,IAAI,EAAE,CAAC;QAC7G,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,SAAuC,IAAI,IAAI,CAAC;QAClF,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,aAA2C,IAAI,IAAI,CAAC;QAC1F,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,gBAA8C,IAAI,IAAI,CAAC;QAChG,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QAChC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,cAAiE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;KAC9G,CAAC;IAEF,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACzB,MAAM,UAAU,GAAI,IAAI,CAAC,MAA6B,IAAI,EAAE,CAAC;QAC7D,MAAM,CAAC,WAAW,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC;IAEA,KAAwC,CAAC,gBAAgB,GAAG,MAAM,CAAC;IAEpE,2EAA2E;IAC3E,4EAA4E;IAC5E,oBAAoB;IACpB,oCAAoC;IACpC,mDAAmD;IACnD,6EAA6E;IAC7E,uEAAuE;IACvE,MAAM,GAAG,GAAI,KAA8D,CAAC,MAAM,IAAI,EAAE,CAAC;IACzF,MAAM,IAAI,GAAG,GAAG,CAAC,0BAA0B,IAAI,CAAC,CAAC;IACjD,MAAM,GAAG,GAAI,KAAK,CAAC,gBAAyE,EAAE,GAAG,CAAC;IAOlG,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,kBAAkB,GAAU;QAChC,GAAG,CAAE,IAAI,CAAC,QAA8B,IAAI,EAAE,CAAC;QAC/C,GAAG,CAAC,CAAC,UAAU,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAE,UAAU,CAAC,OAAuC,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC1H,GAAG,CAAC,CAAC,aAAa,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAE,aAAa,CAAC,OAAuC,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;KACjI,CAAC;IACF,uDAAuD;IACvD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,eAAe,GAAU,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,kBAAkB,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,IAAK,CAA2B,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC9E,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,oEAAoE;IACpE,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,sBAAsB,GAC1B,UAAU,EAAE,OAAO,KAAK,SAAS;QAChC,UAAU,CAAC,OAAoC,EAAE,IAAI,KAAK,WAAW;QACpE,CAAC,CAAE,UAAU,CAAC,OAAuC,CAAC,YAAY,IAAI,EAAE;QACxE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1C,MAAM,mBAAmB,GACvB,UAAU,EAAE,OAAO,KAAK,SAAS;QAChC,UAAU,CAAC,OAAoC,EAAE,IAAI,KAAK,WAAW;QACpE,CAAC,CAAC,CAAE,UAAU,CAAC,OAAkC,CAAC,SAAS,IAAI,IAAI,CAAC;QACpE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC;IAEnD,IAAI,iBAAiB,GAAG,eAAe,CAAC,KAAK,EAAE,CAAC;IAChD,IAAI,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC;IACtC,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QACd,MAAM,oBAAoB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAE,CAA2B,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;QACvH,iBAAiB,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAC5C,MAAM,EAAE,GAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;YACzB,OAAQ,EAA4B,CAAC,QAAQ,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;QACH,GAAG,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAC9H,CAAC;IACD,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,gBAAgB,GAAG,EAAE,CAAC;QACtB,GAAG,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,CAAC;IACjH,CAAC;IACD,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QACd,yCAAyC;QACzC,YAAY,GAAG,IAAI,CAAC;QACpB,GAAG,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED,IAAI,SAA0B,CAAC;IAC/B,sEAAsE;IACtE,wEAAwE;IACxE,kFAAkF;IAClF,2EAA2E;IAC3E,2EAA2E;IAC3E,gCAAgC;IAChC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,mBAAmB,GAAG,CAAC,CAAC;IAC5B,IAAI,sBAAsB,GAAG,CAAC,CAAC;IAC/B,IAAI,YAAY,EAAE,CAAC;QACjB,4EAA4E;QAC5E,yEAAyE;QACzE,6DAA6D;QAC7D,MAAM,gBAAgB,GAAU,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QACjC,MAAM,cAAc,GAClB,CAAC,UAAU,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAE,UAAU,CAAC,OAAuC,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACxH,MAAM,iBAAiB,GACrB,CAAC,aAAa,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAE,aAAa,CAAC,OAAuC,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC9H,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,EAAE,GAAG,iBAAiB,CAAC,EAAE,CAAC;YAC1D,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,IAAK,CAA2B,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YAC5E,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,GAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;YACzB,OAAQ,EAA4B,CAAC,QAAQ,CAAC;YAC9C,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,SAAS,GAAG;YACV,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,6GAA6G;YACtH,QAAQ,EAAE,gBAAgB;YAC1B,OAAO,EAAE,EAAE;YACX,YAAY,EAAE,sBAAsB;YACpC,SAAS,EAAE,mBAAmB;SAC/B,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,wEAAwE;QACxE,sEAAsE;QACtE,MAAM,UAAU,GAAoB;YAClC,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,gBAAgB,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,gBAAgB,CAAC;YACpF,QAAQ,EAAE,iBAAiB;YAC3B,OAAO,EAAE,gBAAgB;YACzB,YAAY,EAAE,sBAAsB;YACpC,SAAS,EAAE,mBAAmB;SAC/B,CAAC;QAEF,IAAI,QAAQ,GAAoB,UAAU,CAAC;QAC3C,MAAM,GAAG,GAAI,KAAwC,CAAC,gBACiF,CAAC;QACxI,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC/E,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,GAA+D,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;YACxI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACvB,UAAU,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;gBAC/B,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;gBACtB,aAAa,GAAG,IAAI,CAAC,EAAE,CAAC;gBACxB,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC9B,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC;gBAClC,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC;gBACpC,mBAAmB,GAAG,IAAI,CAAC,gBAAgB,CAAC;gBAC5C,sBAAsB,GAAG,IAAI,CAAC,mBAAmB,CAAC;gBAClD,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,MAAM,EAAE,CAAC;oBACX,yEAAyE;oBACzE,iEAAiE;oBACjE,oEAAoE;oBACpE,QAAQ,GAAG;wBACT,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS;wBAC1F,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO;wBAC9G,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO;wBACjF,QAAQ,EAAE,iBAAiB;wBAC3B,YAAY,EAAE,sBAAsB;wBACpC,SAAS,EAAE,mBAAmB;qBAC/B,CAAC;gBACJ,CAAC;gBACD,wDAAwD;YAC1D,CAAC;iBAAM,CAAC;gBACN,yDAAyD;gBACzD,kBAAkB,GAAG,IAAI,CAAC;gBAC1B,aAAa,GAAG,IAAI,CAAC,EAAE,CAAC;gBACxB,GAAG,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAA6B,CAAC,CAAC;YAC5J,CAAC;QACH,CAAC;QACD,SAAS,GAAG,0BAA0B,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;IACA,KAA+C,CAAC,eAAe,GAAG,SAAS,CAAC;IAE7E,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE;QACnC,WAAW,EAAE,cAAc;QAC3B,YAAY,EAAE,eAAe;QAC7B,gBAAgB,EAAE,mBAAmB;QACrC,mBAAmB,EAAE,sBAAsB;QAC3C,SAAS,EAAE,YAAY;QACvB,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,UAAU;QACnB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE;QAC3B,cAAc,EAAE,CAAC;QACjB,iBAAiB,EAAE,CAAC;KACrB,EAAE,EAAE,IAAI,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACpE,0EAA0E;IAC1E,yEAAyE;IACzE,KAAK,aAAa,CAAC;IACnB,KAAK,kBAAkB,CAAC;IAExB,MAAM,eAAe,GAAI,KAAK,CAAC,aAA4I;QACzK,EAAE,UAAU,EAAE,UAAU,CAAC;IAC3B,IAAI,eAAe,EAAE,CAAC;QACpB,eAAe,CAAC,OAAO,GAAG,aAAa,CAAC;QACxC,eAAe,CAAC,SAAS,GAAG,CAAC,CAAC;QAC9B,eAAe,CAAC,WAAW,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACL,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE;YACT,UAAU,EAAE,UAAU;YACtB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE;YAC3B,OAAO,EAAE,UAAU;YACnB,SAAS,EAAE,YAAY;YACvB,UAAU,EAAE,QAAQ;SACrB;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,mBAAmB,CAAC,IAAY;IACvC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACzE,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,OAAO,MAAuE,CAAC;QACjF,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;aACnB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACpB,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lifecycle/handlers/baseline-handlers.d.ts

@@ -1,7 +1,12 @@
-import type { StageHandler } from '../lifecycle-driver.js';
 import type { LifecycleState } from '../stage-plan-types.js';
-export type RouteExecutor = (rawRequest: unknown, state: LifecycleState) => Promise<unknown>;
-export interface DispatcherDeps {
-}
-export declare function buildStageHandlers(deps: DispatcherDeps): Record<string, StageHandler>;
+import type { ComposePayload, StageGate } from '../stage-io.js';
+/**
+ * v5 compose: pure serialization of the wire envelope from state.gates.
+ * Four paths (spec §5.8):
+ *  1. normal — annotate.payload copied verbatim
+ *  2. register-block — synthesize from register-block gate
+ *  3. pre-annotate halt — synthesize from halting gate
+ *  4. internal_state_corrupted — degenerate fallback
+ */
+export declare function composeHandler(state: LifecycleState): Promise<StageGate<ComposePayload>>;
 //# sourceMappingURL=baseline-handlers.d.ts.map

package/dist/lifecycle/handlers/baseline-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"baseline-handlers.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/baseline-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAsB7D,MAAM,MAAM,aAAa,GAAG,CAC1B,UAAU,EAAE,OAAO,EACnB,KAAK,EAAE,cAAc,KAClB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,WAAW,cAAc;CAC9B;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAqUrF"}
+{"version":3,"file":"baseline-handlers.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/baseline-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAyC,MAAM,gBAAgB,CAAC;AA6HvG;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAoG9F"}