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

package/dist/lifecycle/stage-io.js

@@ -0,0 +1,20 @@
+// One canonical place for stage I/O contracts. Imported by stage-plan-builder,
+// lifecycle-driver, every handler, and compose.
+// All routes that flow through the per-task lifecycle (implement → review →
+// rework → commit → annotate → compose → terminal). `retry` and `research`
+// share the same flow as their underlying route — retry re-runs a prior
+// batch's tasks; research is an alias for explore's worker shape.
+export const ALL_TASK_ROUTES = ['delegate', 'execute-plan', 'retry', 'audit', 'review', 'debug', 'investigate', 'explore', 'research'];
+export const WRITE_ROUTES = ['delegate', 'execute-plan', 'retry'];
+// ───── Helpers ─────
+/** Canonical "current work artifact" lookup used by commit/annotate/compose. */
+export function currentWork(state) {
+    const rework = state.gates['rework'];
+    if (rework?.outcome === 'advance')
+        return rework.payload;
+    const implement = state.gates['implement'];
+    if (implement?.outcome === 'advance')
+        return implement.payload;
+    return null;
+}
+//# sourceMappingURL=stage-io.js.map

package/dist/lifecycle/stage-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-io.js","sourceRoot":"","sources":["../../src/lifecycle/stage-io.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gDAAgD;AAOhD,4EAA4E;AAC5E,2EAA2E;AAC3E,wEAAwE;AACxE,kEAAkE;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AAEhJ,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAU,CAAC;AA2I3E,sBAAsB;AAEtB,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,KAAoD;IAG9E,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,MAAM,EAAE,OAAO,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,OAAwB,CAAC;IAC1E,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,SAAS,EAAE,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC,OAA2B,CAAC;IACnF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lifecycle/stage-plan-builder.d.ts

@@ -1,4 +1,4 @@
-import type { StagePlan } from './stage-plan-types.js';
-import type { ToolCategory } from '../escalation/escalation-policy.js';
-export declare function buildStagePlan(category: ToolCategory): StagePlan;
+import type { StageDefinition } from './stage-io.js';
+/** v5 canonical stage plan — single source of truth for stage order + gates. */
+export declare const STAGE_PLAN: StageDefinition<unknown>[];
 //# sourceMappingURL=stage-plan-builder.d.ts.map

package/dist/lifecycle/stage-plan-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stage-plan-builder.d.ts","sourceRoot":"","sources":["../../src/lifecycle/stage-plan-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAkIhE"}
+{"version":3,"file":"stage-plan-builder.d.ts","sourceRoot":"","sources":["../../src/lifecycle/stage-plan-builder.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAEO,MAAM,eAAe,CAAC;AAmB1D,gFAAgF;AAChF,eAAO,MAAM,UAAU,EAAE,eAAe,CAAC,OAAO,CAAC,EAyIhD,CAAC"}

package/dist/lifecycle/stage-plan-builder.js

@@ -1,130 +1,159 @@
-export function buildStagePlan(category) {
-    const isAP = category === 'artifact_producing';
-    const isRO = category === 'read_only';
-    // Research category has no per-row gate constant (unlike isAP/isRO). Instead,
-    // explore tasks inject reviewPolicy: 'none' (explore.ts:445), which causes
-    // all review-linked rows (4.1, 4.6, 4.10.x, 4.11, 5.1, 5.2) to skip —
-    // reviewPolicy is the general-purpose review-skip mechanism, not per-category
-    // booleans. See workflow-matrix.md appendix #4. The void expression exists
-    // solely to satisfy the ESLint no-unused-vars rule for the 'category' param.
-    const rows = [
-        // Stage 1 — Ingress (rows 1.1–1.4; spec C10 lines 1284–1290)
-        { rowId: '1.1', stageName: 'accept_http_request', runCondition: () => true, isRework: false, handlerKey: 'accept_http_request' },
-        { rowId: '1.2', stageName: 'verify_loopback', runCondition: () => true, isRework: false, handlerKey: 'verify_loopback' },
-        { rowId: '1.3', stageName: 'validate_workspace', runCondition: () => true, isRework: false, handlerKey: 'validate_workspace' },
-        { rowId: '1.4', stageName: 'load_project_state', runCondition: () => true, isRework: false, handlerKey: 'load_project_state' },
-        // Stage 2 — Intake (rows 2.1–2.5; spec C10 lines 1291–1295)
-        { rowId: '2.1', stageName: 'parse_brief', runCondition: () => true, isRework: false, handlerKey: 'parse_brief' },
-        { rowId: '2.2', stageName: 'verify_referenced_blocks', runCondition: (s) => Array.isArray(s.contextBlockIds) && s.contextBlockIds.length > 0,
-            isRework: false, handlerKey: 'verify_referenced_blocks' },
-        { rowId: '2.3', stageName: 'apply_defaults', runCondition: () => true, isRework: false, handlerKey: 'apply_defaults' },
-        { rowId: '2.4', stageName: 'mark_intake_complete', runCondition: () => true, isRework: false, handlerKey: 'mark_intake_complete' },
-        // 2.5: prepare_execution_context — runs after intake so cwd/userMessage/systemPrompt are available
-        { rowId: '2.5', stageName: 'prepare_execution_context', runCondition: () => true, isRework: false, handlerKey: 'prepare_execution_context' },
-        // Stage 3 — Initial Run (row 3.1; route 'register-context-block' skips this)
-        { rowId: '3.1', stageName: 'run_initial_impl', schemaStage: 'implementing',
-            runCondition: (s) => !s.terminal && s.route !== 'register-context-block',
-            isRework: false, handlerKey: 'run_initial_impl' },
-        // 3.5: check_files_written — early-exit when artifact-producing impl wrote zero files.
-        // When fired, the handler sets state.terminal=true so review chains, verify, and
-        // commit short-circuit.
-        {
-            rowId: '3.5', stageName: 'check_files_written',
-            runCondition: (s) => isAP
-                && s.reviewPolicy !== 'quality_only'
-                && !!s.lastRunResult
-                && Array.isArray(s.lastRunResult.filesWritten)
-                && (s.lastRunResult.filesWritten?.length ?? 0) === 0
-                && !s.terminal,
-            isRework: false, handlerKey: 'check_files_written',
-        },
-        // ── Stage 4 — v4.4.x five-stage pipeline ───────────────────────────────
-        //   Implementing → Review → Rework → Committing → Annotating
-        //
-        // 4.1: review (single complex session: spec then quality sequentially).
-        //      Emits state.reviewVerdict + state.reviewConcerns.
-        // 4.2: rework (standard tier, full tools, single pass). Skipped when
-        //      reviewVerdict === 'approved'.
-        // 4.3: committing (write routes only; per-task git commit with full
-        //      gate logic: no_repo / no_diff / validation_failed /
-        //      validation_stale / worker_committed_out_of_band / hook_failed).
-        // 4.4: annotating (pure transform; builds the unified StructuredReport
-        //      from lastRunResult + review state + commit outcome).
-        { rowId: '4.1', stageName: 'review', schemaStage: 'review',
-            runCondition: (s) => isAP && s.reviewPolicy !== 'none' && !s.terminal,
-            isRework: false, handlerKey: 'review' },
-        { rowId: '4.2', stageName: 'rework', schemaStage: 'rework',
-            runCondition: (s) => isAP
-                && s.reviewPolicy !== 'none'
-                && s.reviewVerdict === 'changes_required'
-                && !s.terminal,
-            isRework: true, handlerKey: 'rework' },
-        // 4.3: committing — fires before annotating so the commit outcome
-        // (sha / message / skipReason) is available to the annotator's report.
-        // Gate is permissive at the stage-plan level; the handler enforces
-        // no_repo / no_diff / validation_failed / etc. internally.
-        { rowId: '4.3', stageName: 'git_commit', schemaStage: 'committing',
-            runCondition: (s) => {
-                if (s.autoCommit !== true)
-                    return false;
-                if (s.readOnlyTask)
-                    return false;
-                if (s.terminal)
-                    return false;
-                // After review: only commit when reviewer approved, or when there
-                // was no review at all (reviewPolicy === 'none').
-                if (s.reviewPolicy !== 'none' && s.reviewVerdict !== 'approved')
-                    return false;
-                return true;
-            },
-            isRework: false, handlerKey: 'git_commit' },
-        // 4.4: annotating — unified pure transform for read + write routes.
-        { rowId: '4.4', stageName: 'annotating', schemaStage: 'annotating',
-            runCondition: (s) => !s.terminal,
-            isRework: false, handlerKey: 'annotating' },
-        // 5.3.rcb: register_to_block_store — fires for register-context-block
-        // route only, before compose_response. Sets state.blockRegistration
-        // which compose_response reads to emit {id, size, ttlMs}.
-        { rowId: '5.3.rcb', stageName: 'register_to_block_store',
-            runCondition: (s) => s.route === 'register-context-block' && !s.terminal,
-            isRework: false, handlerKey: 'register_to_block_store' },
-        // 5.3: compose_response — always fires (even after terminal=true) so the
-        // response envelope reflects the failure shape correctly.
-        { rowId: '5.3', stageName: 'compose_response',
-            runCondition: () => true, isRework: false, handlerKey: 'compose_response',
-            runOnTerminal: true },
-        // 5.3.5: register_terminal_block — every task except register_context_block.
-        // Must fire on terminal=true so failed tasks still get a terminal context block.
-        { rowId: '5.3.5', stageName: 'register_terminal_block',
-            runCondition: (s) => s.route !== 'register-context-block',
-            isRework: false, handlerKey: 'register_terminal_block', runOnTerminal: true },
-        // 5.4: emit_task_terminal — fires the per-task terminal event after register_terminal_block
-        { rowId: '5.4', stageName: 'emit_task_terminal',
-            runCondition: () => true, isRework: false, handlerKey: 'emit_task_terminal',
-            runOnTerminal: true },
-        // 5.5: persist_to_batch_registry — always
-        { rowId: '5.5', stageName: 'persist_to_batch_registry',
-            runCondition: () => true, isRework: false, handlerKey: 'persist_to_batch_registry',
-            runOnTerminal: true },
-        // 5.6: record_task_completed — server-only; calls ctx.recorder.recordTaskCompleted
-        //      to enqueue the cloud task.completed wire event. No-ops on CLI/test paths
-        //      (no recorder). Must run on terminal so failures still record.
-        { rowId: '5.6', stageName: 'record_task_completed',
-            runCondition: () => true, isRework: false, handlerKey: 'record_task_completed',
-            runOnTerminal: true },
-        // Stage 6 — emit + cleanup (rows 6.1–6.3)
-        // 6.1: flush_telemetry — always; fires on terminal so failure events drain
-        { rowId: '6.1', stageName: 'flush_telemetry',
-            runCondition: () => true, isRework: false, handlerKey: 'flush_telemetry',
-            runOnTerminal: true },
-        // 6.2: project_idle_cleanup_tick — TIMER-DRIVEN (per spec C14); the row exists for plan completeness
-        //      but never fires from per-request iteration. Returns false so LifecycleDriver skips it.
-        { rowId: '6.2', stageName: 'project_idle_cleanup_tick',
-            runCondition: () => false, isRework: false, handlerKey: 'project_idle_cleanup_tick' },
-        // 6.3: batch_retention_sweep_tick — TIMER-DRIVEN; same
-        { rowId: '6.3', stageName: 'batch_retention_sweep_tick',
-            runCondition: () => false, isRework: false, handlerKey: 'batch_retention_sweep_tick' },
-    ];
-    return { toolCategory: category, rows };
+// ─── v5 STAGE_PLAN ────────────────────────────────────────────────────────────
+//
+// Canonical 9-stage definition array per spec §3-4. Each stage declares static
+// route applicability (Layer 1: applicableRoutes) and dynamic state-level
+// participation (Layer 2: shouldRun). The new driver walks this in order.
+import { ALL_TASK_ROUTES, WRITE_ROUTES, currentWork } from './stage-io.js';
+// We import handler functions where they exist as exports; this is fine for
+// modules with no circular deps. Where the v5 handler is gated to opt-in,
+// the wrapper falls back to a no-op.
+import { prepareExecutionContextHandler } from './handlers/prepare-execution-context-handler.js';
+import { registerToBlockStoreHandler } from './handlers/register-context-block-handlers.js';
+const ALL_TASK_ROUTES_ARR = ALL_TASK_ROUTES;
+const WRITE_ROUTES_ARR = WRITE_ROUTES;
+function alwaysRun() { return { run: true }; }
+// Lazy import to avoid bootstrap-time circular deps.
+async function loadHandler(loader) {
+    return await loader();
 }
+/** v5 canonical stage plan — single source of truth for stage order + gates. */
+export const STAGE_PLAN = [
+    {
+        name: 'prepare',
+        runOnHalt: false,
+        applicableRoutes: 'all',
+        shouldRun: alwaysRun,
+        handler: async (state) => {
+            const t0 = Date.now();
+            try {
+                await prepareExecutionContextHandler(state);
+                return {
+                    outcome: 'advance',
+                    payload: null,
+                    telemetry: { stageLabel: 'prepare', durationMs: Date.now() - t0, costUSD: 0, turnsUsed: 0, stopReason: 'normal' },
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                const code = /brief schema|invalid brief/i.test(msg) ? 'brief_invalid'
+                    : /workspace|traversal|sandbox/i.test(msg) ? 'workspace_violation'
+                        : /context_block|missing/i.test(msg) ? 'context_block_missing'
+                            : 'prepare_failed';
+                return {
+                    outcome: 'halt',
+                    comment: `${code}: ${msg}`,
+                    payload: null,
+                    telemetry: { stageLabel: 'prepare', durationMs: Date.now() - t0, costUSD: 0, turnsUsed: 0, stopReason: 'transport_error' },
+                };
+            }
+        },
+    },
+    {
+        name: 'register-block',
+        runOnHalt: false,
+        applicableRoutes: ['register-context-block'],
+        shouldRun: alwaysRun,
+        handler: async (state) => {
+            return await registerToBlockStoreHandler(state);
+        },
+    },
+    {
+        name: 'implement',
+        runOnHalt: false,
+        applicableRoutes: ALL_TASK_ROUTES_ARR,
+        shouldRun: alwaysRun,
+        handler: async (state) => {
+            const mod = await loadHandler(() => import('./handlers/task-executor.js'));
+            return mod.implementHandler(state);
+        },
+    },
+    {
+        name: 'review',
+        runOnHalt: false,
+        applicableRoutes: WRITE_ROUTES_ARR,
+        shouldRun: (state) => {
+            const impl = state.gates?.['implement'];
+            if (impl?.outcome !== 'advance') {
+                return { run: false, comment: 'review skipped because implement did not advance' };
+            }
+            if (state.reviewPolicy === 'none') {
+                return { run: false, comment: 'review skipped because reviewPolicy=none' };
+            }
+            return { run: true };
+        },
+        handler: async (state) => {
+            const mod = await loadHandler(() => import('./handlers/review-handler.js'));
+            return mod.reviewHandler(state);
+        },
+    },
+    {
+        name: 'rework',
+        runOnHalt: false,
+        applicableRoutes: WRITE_ROUTES_ARR,
+        shouldRun: (state) => {
+            const review = state.gates?.['review'];
+            if (review?.outcome !== 'advance') {
+                return { run: false, comment: 'rework skipped because review did not produce a verdict' };
+            }
+            const verdict = review.payload?.verdict;
+            if (verdict === 'approved') {
+                return { run: false, comment: 'rework skipped because review approved' };
+            }
+            return { run: true };
+        },
+        handler: async (state) => {
+            const mod = await loadHandler(() => import('./handlers/rework-handler.js'));
+            return mod.reworkHandler(state);
+        },
+    },
+    {
+        name: 'commit',
+        runOnHalt: false,
+        applicableRoutes: WRITE_ROUTES_ARR,
+        shouldRun: (state) => {
+            if (state.autoCommit === false) {
+                return { run: false, comment: 'commit skipped because autoCommit disabled' };
+            }
+            const work = currentWork({ gates: (state.gates ?? {}) });
+            if (!work || work.filesChanged?.length === 0) {
+                return { run: false, comment: 'commit skipped because no files changed' };
+            }
+            return { run: true };
+        },
+        handler: async (state) => {
+            const mod = await loadHandler(() => import('./handlers/git-commit-handler.js'));
+            return mod.commitHandler(state);
+        },
+    },
+    {
+        name: 'annotate',
+        runOnHalt: false,
+        applicableRoutes: ALL_TASK_ROUTES_ARR,
+        shouldRun: alwaysRun,
+        handler: async (state) => {
+            const mod = await loadHandler(() => import('./handlers/annotator.js'));
+            return mod.annotator(state);
+        },
+    },
+    {
+        name: 'compose',
+        runOnHalt: true,
+        applicableRoutes: 'all',
+        shouldRun: alwaysRun,
+        handler: async (state) => {
+            const mod = await loadHandler(() => import('./handlers/baseline-handlers.js'));
+            return mod.composeHandler(state);
+        },
+    },
+    {
+        name: 'terminal',
+        runOnHalt: true,
+        applicableRoutes: 'all',
+        shouldRun: alwaysRun,
+        handler: async (state) => {
+            const mod = await loadHandler(() => import('./handlers/terminal-handlers.js'));
+            return mod.terminalHandler(state);
+        },
+    },
+];
 //# sourceMappingURL=stage-plan-builder.js.map

package/dist/lifecycle/stage-plan-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"stage-plan-builder.js","sourceRoot":"","sources":["../../src/lifecycle/stage-plan-builder.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,cAAc,CAAC,QAAsB;IACnD,MAAM,IAAI,GAAG,QAAQ,KAAK,oBAAoB,CAAC;IAC/C,MAAM,IAAI,GAAG,QAAQ,KAAK,WAAW,CAAC;IACtC,8EAA8E;IAC9E,2EAA2E;IAC3E,sEAAsE;IACtE,8EAA8E;IAC9E,2EAA2E;IAC3E,6EAA6E;IAE7E,MAAM,IAAI,GAAe;QACvB,6DAA6D;QAC7D,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAQ,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE;QACtI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAY,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE;QAClI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAS,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE;QACrI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAS,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE;QAErI,4DAA4D;QAC5D,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAgB,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE;QAC9H,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,0BAA0B,EAAG,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;YAC3I,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,0BAA0B,EAAE;QAC3D,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAa,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE;QACjI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAO,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE;QACvI,mGAAmG;QACnG,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,2BAA2B,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,2BAA2B,EAAE;QAE5I,6EAA6E;QAC7E,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc;YACxE,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,wBAAwB;YACxE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE;QAEnD,uFAAuF;QACvF,iFAAiF;QACjF,wBAAwB;QACxB;YACE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,qBAAqB;YAC9C,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI;mBACpB,CAAC,CAAC,YAAY,KAAK,cAAc;mBACjC,CAAC,CAAC,CAAC,CAAC,aAAa;mBACjB,KAAK,CAAC,OAAO,CAAE,CAAC,CAAC,aAA4C,CAAC,YAAY,CAAC;mBAC3E,CAAE,CAAC,CAAC,aAA8C,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC;mBACnF,CAAC,CAAC,CAAC,QAAQ;YAChB,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,qBAAqB;SACnD;QAED,0EAA0E;QAC1E,6DAA6D;QAC7D,EAAE;QACF,wEAAwE;QACxE,yDAAyD;QACzD,qEAAqE;QACrE,qCAAqC;QACrC,oEAAoE;QACpE,2DAA2D;QAC3D,uEAAuE;QACvE,uEAAuE;QACvE,4DAA4D;QAC5D,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ;YACxD,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,YAAY,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,QAAQ;YACrE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE;QACzC,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ;YACxD,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI;mBACpB,CAAC,CAAC,YAAY,KAAK,MAAM;mBACzB,CAAC,CAAC,aAAa,KAAK,kBAAkB;mBACtC,CAAC,CAAC,CAAC,QAAQ;YAChB,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE;QACxC,kEAAkE;QAClE,uEAAuE;QACvE,mEAAmE;QACnE,2DAA2D;QAC3D,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY;YAChE,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE;gBAClB,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI;oBAAE,OAAO,KAAK,CAAC;gBACxC,IAAI,CAAC,CAAC,YAAY;oBAAE,OAAO,KAAK,CAAC;gBACjC,IAAI,CAAC,CAAC,QAAQ;oBAAE,OAAO,KAAK,CAAC;gBAC7B,kEAAkE;gBAClE,kDAAkD;gBAClD,IAAI,CAAC,CAAC,YAAY,KAAK,MAAM,IAAI,CAAC,CAAC,aAAa,KAAK,UAAU;oBAAE,OAAO,KAAK,CAAC;gBAC9E,OAAO,IAAI,CAAC;YACd,CAAC;YACD,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE;QAC7C,oEAAoE;QACpE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY;YAChE,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ;YAChC,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE;QAC7C,sEAAsE;QACtE,oEAAoE;QACpE,0DAA0D;QAC1D,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,yBAAyB;YACtD,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,wBAAwB,IAAI,CAAC,CAAC,CAAC,QAAQ;YACxE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,yBAAyB,EAAE;QAC1D,yEAAyE;QACzE,0DAA0D;QAC1D,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,kBAAkB;YAC3C,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,kBAAkB;YACzE,aAAa,EAAE,IAAI,EAAE;QACvB,6EAA6E;QAC7E,iFAAiF;QACjF,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,yBAAyB;YACpD,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,wBAAwB;YACzD,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,yBAAyB,EAAE,aAAa,EAAE,IAAI,EAAE;QAC/E,4FAA4F;QAC5F,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,oBAAoB;YAC7C,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,oBAAoB;YAC3E,aAAa,EAAE,IAAI,EAAE;QACvB,0CAA0C;QAC1C,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,2BAA2B;YACpD,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,2BAA2B;YAClF,aAAa,EAAE,IAAI,EAAE;QACvB,mFAAmF;QACnF,gFAAgF;QAChF,qEAAqE;QACrE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,uBAAuB;YAChD,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,uBAAuB;YAC9E,aAAa,EAAE,IAAI,EAAE;QAEvB,0CAA0C;QAC1C,2EAA2E;QAC3E,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,iBAAiB;YAC1C,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,iBAAiB;YACxE,aAAa,EAAE,IAAI,EAAE;QACvB,qGAAqG;QACrG,8FAA8F;QAC9F,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,2BAA2B;YACpD,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,2BAA2B,EAAE;QACvF,uDAAuD;QACvD,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,4BAA4B;YACrD,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,4BAA4B,EAAE;KACzF,CAAC;IACF,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"stage-plan-builder.js","sourceRoot":"","sources":["../../src/lifecycle/stage-plan-builder.ts"],"names":[],"mappings":"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"}

package/dist/lifecycle/stage-plan-types.d.ts

@@ -1,25 +1,5 @@
 import type { ToolCategory } from '../escalation/escalation-policy.js';
 import type { ProjectContext } from '../stores/project-context-registry.js';
-export interface StageRow {
-    rowId: string;
-    stageName: string;
-    schemaStage?: string;
-    runCondition: (state: LifecycleState) => boolean;
-    isRework: boolean;
-    handlerKey: string;
-    /**
-     * When true, this row's handler runs even after a prior row set
-     * `state.terminal = true`. Used by settle/compose/terminal/persist/flush
-     * rows that must populate authoritative chain-pass + envelope state on
-     * hard-fail paths. The driver loop honors this attribute; non-terminal-safe
-     * rows (the default) short-circuit when `state.terminal` is set.
-     */
-    runOnTerminal?: boolean;
-}
-export interface StagePlan {
-    toolCategory: ToolCategory;
-    rows: StageRow[];
-}
 /**
  * Per-round review verdict shape. Matches the verdict values that
  * spec-reviewer.ts and quality-reviewer.ts actually produce. `'concerns'` was
@@ -31,8 +11,13 @@ type SpecRoundVerdict = 'approved' | 'changes_required' | 'error' | 'skipped';
 type QualityRoundVerdict = 'approved' | 'changes_required' | 'annotated' | 'error' | 'skipped';
 type DiffEnvelopeVerdict = 'approved' | 'changes_required' | 'error' | 'skipped';
 type DiffReviewKind = 'approve' | 'concerns' | 'reject' | 'transport_failure';
+import type { StageGate } from './stage-io.js';
 export interface LifecycleState {
     terminal: boolean;
+    /** v5: per-stage gate record written by the driver. Empty until prepare runs. */
+    gates?: Record<string, StageGate<unknown>>;
+    /** v5: halted flag set when any stage returns outcome:'halt'. Driver-only. */
+    halted?: boolean;
     workerStatus?: string;
     reviewVerdict?: 'approved' | 'concerns' | 'changes_required' | 'error' | 'skipped';
     attemptIndex: number;
@@ -59,7 +44,6 @@ export interface LifecycleState {
     specUnavailable?: import('../escalation/fallback.js').UnavailableMap;
     qualityUnavailable?: import('../escalation/fallback.js').UnavailableMap;
     diffUnavailable?: import('../escalation/fallback.js').UnavailableMap;
-    executor?: (rawRequest: unknown, state: LifecycleState) => Promise<unknown>;
     executorResult?: unknown;
     responseEnvelope?: unknown;
     autoCommit?: boolean;

package/dist/lifecycle/stage-plan-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stage-plan-types.d.ts","sourceRoot":"","sources":["../../src/lifecycle/stage-plan-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stage-plan-types.d.ts","sourceRoot":"","sources":["../../src/lifecycle/stage-plan-types.ts"],"names":[],"mappings":"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"}

package/dist/lifecycle/stage-progression.d.ts

@@ -1,20 +1,8 @@
-/** Build the user-facing stage label list for a route by simulating each
- *  StagePlan row's runCondition under the route's defaults. Distinct
- *  schemaStages whose runCondition returns true become the user-facing
- *  stages, in plan order. Route-specific label overrides + a tail
- *  "Finalizing" slot give the agent a stable bracket. */
+/** Build the user-facing stage label list for a route by walking STAGE_PLAN
+ *  and including each stage whose Layer-1 (applicableRoutes) AND Layer-2
+ *  (shouldRun under simulated state) both pass. */
 export declare function stageOrderForRoute(route: string): string[];
-/** Public accessor mirroring the legacy `STAGE_ORDER_BY_ROUTE[route]` shape
- *  but driven by the StagePlan. Returns an empty array (treated as "1/1")
- *  for unknown routes. */
 export declare const STAGE_ORDER_BY_ROUTE: Record<string, readonly string[]>;
-/** Normalize a runtime stageLabel ("Spec rework round 1") to a coarse
- *  label that exists in `stageOrderForRoute(route)`. Reworks map to their
- *  own coarse slot ("Spec rework" / "Quality rework"), not back to the
- *  review slot — the StagePlan-derived order DOES contain a rework slot
- *  (because spec_rework / quality_rework are distinct schemaStages), so
- *  the bracket advances correctly when a rework fires. */
 export declare function normalizeStageLabel(label: string): string;
-/** "(X/Y)" stage-progress bracket for a route + current stageLabel. */
 export declare function stageProgress(route: string, stageLabel: string | undefined): string;
 //# sourceMappingURL=stage-progression.d.ts.map

package/dist/lifecycle/stage-progression.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stage-progression.d.ts","sourceRoot":"","sources":["../../src/lifecycle/stage-progression.ts"],"names":[],"mappings":"AAqHA;;;;yDAIyD;AACzD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA2B1D;AAOD;;0BAE0B;AAC1B,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAa7B,CAAC;AAEvC;;;;;0DAK0D;AAC1D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CASnF"}
+{"version":3,"file":"stage-progression.d.ts","sourceRoot":"","sources":["../../src/lifecycle/stage-progression.ts"],"names":[],"mappings":"AA4EA;;mDAEmD;AACnD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAyB1D;AAID,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAa7B,CAAC;AAEvC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CASnF"}