@miller-tech/uap 1.155.0 → 1.156.0

package/dist/delivery/mission-acceptance.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Mission acceptance gate — the per-turn judge composition extracted from
+ * deliver.ts (the spec registry's consumer twin): execution + visual gates in
+ * primary mode, spec resolution per root, judge invocation with runtime
+ * evidence, and the secondary-mode churn breaker. deliver.ts keeps only the
+ * wiring decision (acceptance on? primary or secondary?).
+ *
+ * Modes:
+ * - PRIMARY (no real project gates): the judge IS the convergence target, so
+ *   the artifact must actually RUN before completeness is judged — the
+ *   execution gate closes the gap where a 1-turn build could be declared
+ *   delivered on the judge alone, and the visual gate watches it run (blank
+ *   canvas / static rAF scene / runtime errors block acceptance).
+ * - SECONDARY (objective gates exist): this gate is reached ONLY on turns
+ *   whose objective gates all passed; that fact is handed to the judge as
+ *   evidence, and a bounded number of consecutive judge rejections hands the
+ *   verdict back to the gates (churn breaker) instead of wedging.
+ */
+import type { AcceptanceGate, LoopExecutor } from './convergence-loop.js';
+import { runAcceptanceGate, type AcceptanceResult } from './acceptance-judge.js';
+import { runExecutionGate } from './execution-gate.js';
+import { runVisualGate } from './visual-gate.js';
+import { buildUserPathsNote } from './user-validation.js';
+import type { SpecRegistry } from './spec-registry.js';
+/**
+ * Fold a raw judge result into the loop-facing verdict, honoring primary vs
+ * secondary mode. PURE — unit-tested in isolation from the model call.
+ *
+ * - Genuine fully-met verdict → pass.
+ * - PRIMARY (acceptance is the sole convergence target): an inconclusive /
+ *   no-evidence verdict is NOT "done" — fail so the loop keeps building.
+ *   A parse error also omits the score: runAcceptanceGate reports score:1 on
+ *   its fail-open paths, which would otherwise saturate the loop's
+ *   acceptance-progress (bestAcceptance) and mask real per-criterion gains.
+ * - SECONDARY (real objective gates exist): fail OPEN on judge flakiness — a
+ *   green objective delivery is never blocked by the judge's nondeterminism.
+ */
+export declare function resolveAcceptanceVerdict(r: AcceptanceResult, acceptancePrimary: boolean): {
+    passed: boolean;
+    feedback: string;
+    score?: number;
+};
+export interface MissionAcceptanceDeps {
+    /** Primary mode: the judge is the convergence target (no real gates). */
+    primary: boolean;
+    /** Spec + evidence + churn-breaker owner (see spec-registry.ts). */
+    specs: SpecRegistry;
+    /** The judge model call (JSON-verdict executor). */
+    judgeExecutor: LoopExecutor;
+    /** Breaker-override warning line — the one operator signal that the judge
+     * was overruled. Defaults to console.log; callers decorate with chalk. */
+    note?: (line: string) => void;
+    /** Test seams — default to the real gates. */
+    executionGate?: typeof runExecutionGate;
+    visualGate?: typeof runVisualGate;
+    judge?: typeof runAcceptanceGate;
+    userPathsNote?: typeof buildUserPathsNote;
+}
+/** Build the per-turn acceptance gate the convergence loop calls with a root. */
+export declare function buildMissionAcceptanceGate(deps: MissionAcceptanceDeps): AcceptanceGate;
+//# sourceMappingURL=mission-acceptance.d.ts.map

package/dist/delivery/mission-acceptance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-acceptance.d.ts","sourceRoot":"","sources":["../../src/delivery/mission-acceptance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EACL,iBAAiB,EAEjB,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAqB,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,CAAC,EAAE,gBAAgB,EACnB,iBAAiB,EAAE,OAAO,GACzB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAavD;AAED,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,KAAK,EAAE,YAAY,CAAC;IACpB,oDAAoD;IACpD,aAAa,EAAE,YAAY,CAAC;IAC5B;8EAC0E;IAC1E,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,OAAO,gBAAgB,CAAC;IACxC,UAAU,CAAC,EAAE,OAAO,aAAa,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,iBAAiB,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,kBAAkB,CAAC;CAC3C;AAED,iFAAiF;AACjF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,qBAAqB,GAAG,cAAc,CAwDtF"}

package/dist/delivery/mission-acceptance.js

@@ -0,0 +1,107 @@
+/**
+ * Mission acceptance gate — the per-turn judge composition extracted from
+ * deliver.ts (the spec registry's consumer twin): execution + visual gates in
+ * primary mode, spec resolution per root, judge invocation with runtime
+ * evidence, and the secondary-mode churn breaker. deliver.ts keeps only the
+ * wiring decision (acceptance on? primary or secondary?).
+ *
+ * Modes:
+ * - PRIMARY (no real project gates): the judge IS the convergence target, so
+ *   the artifact must actually RUN before completeness is judged — the
+ *   execution gate closes the gap where a 1-turn build could be declared
+ *   delivered on the judge alone, and the visual gate watches it run (blank
+ *   canvas / static rAF scene / runtime errors block acceptance).
+ * - SECONDARY (objective gates exist): this gate is reached ONLY on turns
+ *   whose objective gates all passed; that fact is handed to the judge as
+ *   evidence, and a bounded number of consecutive judge rejections hands the
+ *   verdict back to the gates (churn breaker) instead of wedging.
+ */
+import { runAcceptanceGate, formatAcceptanceReport, } from './acceptance-judge.js';
+import { runExecutionGate } from './execution-gate.js';
+import { runVisualGate, visualRuntimeNote } from './visual-gate.js';
+import { buildUserPathsNote } from './user-validation.js';
+/**
+ * Fold a raw judge result into the loop-facing verdict, honoring primary vs
+ * secondary mode. PURE — unit-tested in isolation from the model call.
+ *
+ * - Genuine fully-met verdict → pass.
+ * - PRIMARY (acceptance is the sole convergence target): an inconclusive /
+ *   no-evidence verdict is NOT "done" — fail so the loop keeps building.
+ *   A parse error also omits the score: runAcceptanceGate reports score:1 on
+ *   its fail-open paths, which would otherwise saturate the loop's
+ *   acceptance-progress (bestAcceptance) and mask real per-criterion gains.
+ * - SECONDARY (real objective gates exist): fail OPEN on judge flakiness — a
+ *   green objective delivery is never blocked by the judge's nondeterminism.
+ */
+export function resolveAcceptanceVerdict(r, acceptancePrimary) {
+    if (r.passed && !r.parseError)
+        return { passed: true, score: r.score, feedback: '' };
+    const gaps = `ACCEPTANCE GAPS — implement these to complete the spec:\n${formatAcceptanceReport(r)}`;
+    if (acceptancePrimary) {
+        if (r.parseError) {
+            return {
+                passed: false,
+                feedback: `Acceptance inconclusive (${r.parseError}). Keep implementing the spec — ensure the source files exist and are complete.`,
+            };
+        }
+        return { passed: false, score: r.score, feedback: gaps };
+    }
+    return { passed: r.passed, score: r.score, feedback: r.passed ? '' : gaps };
+}
+/** Build the per-turn acceptance gate the convergence loop calls with a root. */
+export function buildMissionAcceptanceGate(deps) {
+    const executionGate = deps.executionGate ?? runExecutionGate;
+    const visualGate = deps.visualGate ?? runVisualGate;
+    const judge = deps.judge ?? runAcceptanceGate;
+    const userPathsNote = deps.userPathsNote ?? buildUserPathsNote;
+    // eslint-disable-next-line no-console
+    const note = deps.note ?? ((line) => console.log(line));
+    return async (root) => {
+        // Primary mode: the only objective rung is the trivial bootstrap, and the
+        // real execution gate joins via redetect only on the NEXT turn (one-turn
+        // lag). So gate the artifact's runtime HERE too — idempotent with the
+        // redetected execution rung on later turns.
+        let visualNote = '';
+        if (deps.primary) {
+            const exec = await executionGate(root);
+            if (!exec.passed) {
+                return {
+                    passed: false,
+                    feedback: `EXECUTION FAILED — the code must run before it can be accepted:\n${exec.outputTail}`,
+                };
+            }
+            // Visual gate: watch the artifact RUN — the observation summary becomes
+            // judge evidence (a code-evidence judge cannot see a never-started
+            // animation; this can).
+            const visual = await visualGate(root);
+            if (!visual.skipped && !visual.passed) {
+                return { passed: false, feedback: visual.feedback };
+            }
+            visualNote = visualRuntimeNote(visual);
+        }
+        const resolvedSpec = deps.specs.resolve(root);
+        const uvNote = userPathsNote(root);
+        const baseNote = deps.primary
+            ? visualNote
+            : 'Objective project gates (build/test suite) ALL PASSED on this turn — treat test/build-related requirements as objectively verified.';
+        const runtimeNote = [baseNote, uvNote?.note].filter(Boolean).join(' ');
+        const r = await judge({
+            spec: resolvedSpec,
+            projectRoot: root,
+            executor: deps.judgeExecutor,
+            ...(runtimeNote ? { runtimeNote } : {}),
+        });
+        const verdict = resolveAcceptanceVerdict(r, deps.primary);
+        // Secondary mode only: bounded consecutive judge rejections of
+        // objectively-green turns hand the verdict back to the gates.
+        if (!deps.primary) {
+            const checked = deps.specs.breaker(resolvedSpec, root).check(resolvedSpec, verdict);
+            if (checked.overridden) {
+                note('⚖ acceptance: judge rejected consecutive objectively-green turns — accepting on gates (raise UAP_DELIVER_ACCEPTANCE_FLIP_LIMIT to let the judge argue longer)');
+            }
+            return checked;
+        }
+        return verdict;
+    };
+}
+//# sourceMappingURL=mission-acceptance.js.map

package/dist/delivery/mission-acceptance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-acceptance.js","sourceRoot":"","sources":["../../src/delivery/mission-acceptance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EACL,iBAAiB,EACjB,sBAAsB,GAEvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CACtC,CAAmB,EACnB,iBAA0B;IAE1B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,UAAU;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACrF,MAAM,IAAI,GAAG,4DAA4D,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IACrG,IAAI,iBAAiB,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YACjB,OAAO;gBACL,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,4BAA4B,CAAC,CAAC,UAAU,iFAAiF;aACpI,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9E,CAAC;AAmBD,iFAAiF;AACjF,MAAM,UAAU,0BAA0B,CAAC,IAA2B;IACpE,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,gBAAgB,CAAC;IAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,aAAa,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,iBAAiB,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,kBAAkB,CAAC;IAC/D,sCAAsC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAY,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE;QACpB,0EAA0E;QAC1E,yEAAyE;QACzE,sEAAsE;QACtE,4CAA4C;QAC5C,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,OAAO;oBACL,MAAM,EAAE,KAAK;oBACb,QAAQ,EAAE,oEAAoE,IAAI,CAAC,UAAU,EAAE;iBAChG,CAAC;YACJ,CAAC;YACD,wEAAwE;YACxE,mEAAmE;YACnE,wBAAwB;YACxB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACtC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtD,CAAC;YACD,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO;YAC3B,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,qIAAqI,CAAC;QAC1I,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvE,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC;YACpB,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,IAAI;YACjB,QAAQ,EAAE,IAAI,CAAC,aAAa;YAC5B,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,wBAAwB,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1D,+DAA+D;QAC/D,8DAA8D;QAC9D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACpF,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,IAAI,CACF,+JAA+J,CAChK,CAAC;YACJ,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miller-tech/uap",
-  "version": "1.155.0",
+  "version": "1.156.0",
   "description": "Autonomous AI agent memory system with CLAUDE.md protocol enforcement",
   "type": "module",
   "main": "dist/index.js",