@miller-tech/uap 1.154.0 → 1.155.0

package/dist/cli/deliver.d.ts.map

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

package/dist/cli/deliver.js

@@ -20,7 +20,8 @@ import { RoutingPresets, resolvePresetModel } from '../models/types.js';
 import { measureQueryComplexity } from '../utils/query-complexity.js';
 import { authorAcceptanceGate } from '../delivery/self-gate.js';
 import { applyPendingIntents } from '../delivery/pending-intents.js';
-import { runAcceptanceGate, formatAcceptanceReport, createAcceptanceChurnBreaker } from '../delivery/acceptance-judge.js';
+import { runAcceptanceGate, formatAcceptanceReport } from '../delivery/acceptance-judge.js';
+import { createSpecRegistry } from '../delivery/spec-registry.js';
 import { runExecutionGate } from '../delivery/execution-gate.js';
 import { runVisualGate, visualRuntimeNote } from '../delivery/visual-gate.js';
 /**
@@ -1247,46 +1248,13 @@ async function runDeliver(instruction, options) {
     }
     // Phased missions re-point the judge at the current phase's goal — judging
     // phase 1 against the FULL mission would fail every phase by construction.
-    let acceptanceSpec = instruction;
-    // Parallel orchestrated tasks run in ISOLATED worktree roots; each loop's
-    // judge must grade against ITS task's spec, not a shared mutable. The
-    // acceptance gate resolves by the root it is invoked with; the phased and
-    // epic paths (single loop at a time) keep using the shared variable.
-    const acceptanceSpecByRoot = new Map();
-    // Secondary-judge churn breaker: bounds consecutive judge rejections of
-    // objectively-green turns per spec (env UAP_DELIVER_ACCEPTANCE_FLIP_LIMIT,
-    // default 2), after which the objective gates win. Primary mode is exempt.
-    // Change-evidence for the breaker's zero-diff guard: files applied since the
-    // current acceptance spec (epic) began. Incremented by the iteration hook,
-    // reset wherever acceptanceSpec is re-pointed.
-    // Per-ROOT under parallel dispatch: concurrent loops must not zero or
-    // inflate each other's evidence (an inflated count could let the breaker
-    // accept a task with zero writes of its own). projectRoot's entry is the
-    // historic shared counter the phased/epic paths keep using.
-    const writesByRoot = new Map();
-    const evidenceFor = (root) => {
-        let e = writesByRoot.get(root);
-        if (!e) {
-            e = { writes: 0 };
-            writesByRoot.set(root, e);
-        }
-        return e;
-    };
-    const specChangeEvidence = evidenceFor(projectRoot);
-    // Breaker state is per SPEC: one shared instance thrashes its current-spec
-    // slot under parallel dispatch and can then never trip.
-    const acceptanceFlipLimit = Number(process.env.UAP_DELIVER_ACCEPTANCE_FLIP_LIMIT ?? 2);
-    const acceptanceBreakers = new Map();
-    const breakerFor = (spec, root) => {
-        let b = acceptanceBreakers.get(spec);
-        if (!b) {
-            if (acceptanceBreakers.size > 100)
-                acceptanceBreakers.clear(); // runaway guard
-            b = createAcceptanceChurnBreaker(acceptanceFlipLimit, () => evidenceFor(root).writes > 0);
-            acceptanceBreakers.set(spec, b);
-        }
-        return b;
-    };
+    // Per-root specs, write evidence, and churn breakers live in the registry
+    // (see src/delivery/spec-registry.ts for the parallel-dispatch semantics).
+    const specs = createSpecRegistry({
+        initialSpec: instruction,
+        sharedRoot: projectRoot,
+        flipLimit: Number(process.env.UAP_DELIVER_ACCEPTANCE_FLIP_LIMIT ?? 2),
+    });
     const acceptanceGate = options.acceptance && !skipJudgeForSimple
         ? async (root) => {
             // Primary mode: the only objective rung is the trivial bootstrap, and the
@@ -1318,7 +1286,7 @@ async function runDeliver(instruction, options) {
             // gates all passed — hand the judge that fact as evidence, so
             // requirements like "make the tests pass" are graded on the gate
             // result instead of speculated about from static code.
-            const resolvedSpec = acceptanceSpecByRoot.get(root) ?? acceptanceSpec;
+            const resolvedSpec = specs.resolve(root);
             const uvNote = buildUserPathsNote(root);
             const baseNote = acceptancePrimary
                 ? visualNote
@@ -1335,7 +1303,7 @@ async function runDeliver(instruction, options) {
             // objective gates ALL passed, so a bounded number of consecutive judge
             // rejections hands the verdict back to the gates instead of wedging.
             if (!acceptancePrimary) {
-                const checked = breakerFor(resolvedSpec, root).check(resolvedSpec, verdict);
+                const checked = specs.breaker(resolvedSpec, root).check(resolvedSpec, verdict);
                 if (checked.overridden) {
                     console.log(chalk.yellow('  ⚖ acceptance: judge rejected consecutive objectively-green turns — accepting on gates (raise UAP_DELIVER_ACCEPTANCE_FLIP_LIMIT to let the judge argue longer)'));
                 }
@@ -1368,8 +1336,7 @@ async function runDeliver(instruction, options) {
             : undefined;
         return composeIterationHooks((record) => printProgress(record), (record) => {
             // Feed the acceptance breaker's zero-diff guard.
-            if (record.filesApplied.length > 0)
-                evidenceFor(evidenceRoot).writes += record.filesApplied.length;
+            specs.recordWrites(evidenceRoot, record.filesApplied.length);
             return undefined;
         }, (record) => haloTracer.onIteration(record), repair ? (record) => repair.onIteration(record) : undefined, coordinator ? (record) => coordinator.onIteration(record) : undefined, escalation ? (record) => escalation.onIteration(record) : undefined);
     };
@@ -1474,9 +1441,13 @@ async function runDeliver(instruction, options) {
     // single-session context thrash — and a trivial mission simply decomposes to
     // one epic, so the wrapper is cheap. Disable per-run with --no-epics /
     // UAP_DELIVER_EPICS=0 / `.uap.json` deliver.epics false|'off'. Never on
-    // self-gate or resume (those are special single-pass modes).
+    // self-gate. A resume re-enters the epic path ONLY when the interrupted
+    // run was epic-kind: completed epics carry forward as prior summaries and
+    // the mid-epic loop checkpoint is discarded (epics restart at the epic
+    // boundary). Non-epic resumes stay on the cursor-honoring paths below.
     const cfgEpics = cfgRaw.deliver?.epics;
-    const epicsEnabled = !needsSelfGate && !resumeState &&
+    const epicsEnabled = !needsSelfGate &&
+        (!resumeState || resumeState.runnerKind === 'epic') &&
         options.epics !== false &&
         process.env.UAP_DELIVER_EPICS !== '0' &&
         cfgEpics !== false && cfgEpics !== 'off';
@@ -1573,7 +1544,10 @@ async function runDeliver(instruction, options) {
     // a silent de-escalation. Falls back to the normal executor when no
     // stronger model is configured in this environment.
     let runExecutor = executor;
-    if (resumeCheckpoint?.modelEscalated) {
+    // Epic-kind resumes never use runExecutor (fresh epic loops re-escalate on
+    // their own) and discard the checkpoint at the dispatch — a re-bind message
+    // here would falsely claim the escalation carried over.
+    if (resumeCheckpoint?.modelEscalated && !epicsEnabled) {
         if (escalateExecutor && !agentic) {
             // Agentic runs keep their tool-loop executor: the blind escalation
             // executor pairs with the noop applier and would never touch the repo.
@@ -1640,20 +1614,10 @@ async function runDeliver(instruction, options) {
                     : line.includes('parallel tasks:') || line.includes('post-merge verification')
                         ? chalk.cyan(line)
                         : chalk.dim(line)),
-            beginTaskSpec: (root, spec) => {
-                acceptanceSpecByRoot.set(root, spec);
-                if (root === projectRoot)
-                    acceptanceSpec = spec;
-                evidenceFor(root).writes = 0;
-            },
-            endTaskSpec: (root) => {
-                acceptanceSpecByRoot.delete(root);
-                // An in-tree task re-pointed the shared spec; restore the mission-
-                // level spec so a later watch-ci re-converge never judges against a
-                // stale task prompt.
-                if (root === projectRoot)
-                    acceptanceSpec = missionText;
-            },
+            beginTaskSpec: (root, spec) => specs.begin(root, spec),
+            // Restore the mission-level spec after an in-tree task so a later
+            // watch-ci re-converge never judges against a stale task prompt.
+            endTaskSpec: (root) => specs.end(root, missionText),
             openTask: (title) => openDeliveryTask(title, projectRoot, parentTaskId),
             completeTask: (record, r) => completeDeliveryTask(record, r),
             // P3 — per-task memory retrieval: pull the few most relevant established
@@ -1764,10 +1728,7 @@ async function runDeliver(instruction, options) {
                     resumeCheckpoint = undefined; // consumed by this loop
                 return loop.deliver(prompt);
             },
-            setPhaseSpec: (spec) => {
-                acceptanceSpec = spec;
-                specChangeEvidence.writes = 0;
-            },
+            setPhaseSpec: (spec) => specs.setShared(spec),
             openTask: (title) => openDeliveryTask(title, projectRoot, missionTask?.id),
             completeTask: (record, r) => completeDeliveryTask(record, r),
             persistCursor: (index) => {
@@ -1821,15 +1782,32 @@ async function runDeliver(instruction, options) {
                 thoughtExperiment: false,
             }),
             epicParallelTasks,
+            // Deterministic epic-boundary resume: reuse the PERSISTED plan and
+            // accepted-epic set — replanning on resume would mint new epic ids
+            // (resetting the completion ledger's done marks) and draw new
+            // boundaries over already-built work, which the anti-no-op rail then
+            // refuses to accept (a wedge).
+            initialEpics: resumeState?.runnerKind === 'epic' ? resumeState.phases : undefined,
+            initialDone: resumeState?.runnerKind === 'epic' ? (resumeState.completedEpicIds ?? []) : [],
+            initialPriorSummaries: resumeState?.runnerKind === 'epic' ? (resumeState.phaseSummaries ?? []) : [],
+            persistPlan: (plan) => {
+                runState.phases = plan;
+                saveRunState(runState);
+            },
+            persistCompleted: ({ summaries, completed }) => {
+                runState.phaseSummaries = [...summaries];
+                runState.completedEpicIds = [...completed];
+                // The checkpoint belongs to the finished epic (phased-path parity) —
+                // never seed a later loop with a completed epic's session state.
+                runState.checkpoint = undefined;
+                saveRunState(runState);
+            },
             runOrchestrated: (missionText, plan, parentTaskId) => runOrchestratedMissionCore(buildOrchestratedDeps(missionText, plan, epicParallelTasks, parentTaskId)),
             runEpicLoop: async (scoped) => {
                 const loop = new ConvergenceLoop({ ...loopConfig, baselineCheck: false, resumeFrom: undefined, onIteration: makeIterationHook() }, executor, seams);
                 return loop.deliver(scoped);
             },
-            setEpicSpec: (spec) => {
-                acceptanceSpec = spec;
-                specChangeEvidence.writes = 0; // fresh epic — breaker needs fresh diff evidence
-            },
+            setEpicSpec: (spec) => specs.setShared(spec), // fresh epic — breaker needs fresh diff evidence
             judgeEpic: options.acceptance && !skipJudgeForSimple
                 ? async (spec) => {
                     try {
@@ -1937,15 +1915,15 @@ async function runDeliver(instruction, options) {
                 console.log(chalk.dim('  lazy attempt did not pass — engaging the full convergence stack'));
             }
         }
-        // Resume downgrade warning: resumes always take a cursor-honoring
-        // sequential path — phased when a phase plan was persisted, otherwise the
-        // single flat loop — but the ORIGINAL run may have executed as epic or
-        // orchestrated: different prompts, no contract publication, DAG flattened
-        // to linear order. Loud, never silent — and NOT gated on the phases
-        // array, because epic runs never persist one and interrupted epic runs
-        // are the most common resume case.
+        // Resume routing: an epic-kind resume re-enters the epic path (fidelity —
+        // completed epics carry forward as prior summaries). Everything else takes
+        // a cursor-honoring sequential path — phased when a phase plan was
+        // persisted, otherwise the single flat loop. When that CHANGES the
+        // execution model (e.g. an epic run resumed under --no-epics), warn
+        // loudly, never silently: different prompts, no contract publication,
+        // DAG flattened to linear order.
         if (resumeState?.runnerKind) {
-            const resumeTarget = phases && phases.length >= 2 ? 'phased' : 'single';
+            const resumeTarget = epicsEnabled ? 'epic' : phases && phases.length >= 2 ? 'phased' : 'single';
             if (resumeState.runnerKind !== resumeTarget) {
                 const targetDesc = resumeTarget === 'phased'
                     ? 'sequential phased path (the only cursor-honoring runner)'
@@ -1959,6 +1937,10 @@ async function runDeliver(instruction, options) {
             result = result;
         }
         else if (epicsEnabled) {
+            if (resumeState && resumeCheckpoint) {
+                console.log(chalk.dim('  resume: mid-epic loop checkpoint discarded — epic missions resume at the epic boundary (completed epics carry forward as summaries).'));
+                resumeCheckpoint = undefined;
+            }
             runState.runnerKind = 'epic';
             saveRunState(runState);
             result = await runEpicMission();
@@ -1991,8 +1973,7 @@ async function runDeliver(instruction, options) {
             // Re-point the judge at the MISSION: epic/phased runners leave
             // acceptanceSpec on the LAST epic/phase spec, and a re-converge pass
             // would otherwise be judged against that stale slice.
-            acceptanceSpec = instruction;
-            specChangeEvidence.writes = 0; // evidence resets wherever the spec re-points
+            specs.setShared(instruction); // evidence resets wherever the spec re-points
             const branch = currentBranch(projectRoot) ?? undefined;
             result = await runCiReconverge({
                 instruction,