@miller-tech/uap 1.213.0 → 1.215.0

package/dist/delivery/capability-profile.js

@@ -0,0 +1,392 @@
+/**
+ * Capability profile — a RUNTIME measurement of how much the deliverable
+ * actually does, persisted like a visual baseline and compared across a run.
+ *
+ * WHY THIS EXISTS. Every other rung asks "does it run cleanly?". None asks
+ * "does it still do as much?", and those are different questions with opposite
+ * failure modes: a build can buy a clean verdict by doing LESS. Measured on
+ * octopus_invaders_v4 (2026-08-19) — one run took the gate score 0% -> 100%
+ * while the deliverable lost most of its function:
+ *
+ *     draw calls   12 -> 3       rAF loops    6 -> 2
+ *     listeners     8 -> 3       frames/7s  419 -> 25
+ *     bundle    65.8KB -> 25.8KB
+ *
+ * The acceptance judge scored that 8/9. The execution gate passed it: it DOES
+ * render, it DOES tick, no console errors. `--keep-best`/no-regress
+ * (src/delivery/snapshot.ts) could not catch it either, because that rolls back
+ * on the GATE SCORE and the gate score went UP.
+ *
+ * WHAT THIS FILE IS AND IS NOT. It is the PURE half: the profile shape, the
+ * comparison, the feedback, and the on-disk baseline. The MEASUREMENT lives in
+ * execution-gate.ts, inside the browser session that rung already opens — see
+ * the note on ordering below. Splitting it that way is deliberate and was the
+ * main finding of architecture review:
+ *
+ *  - Ordering becomes STRUCTURAL rather than a convention. A profile only
+ *    exists as a byproduct of a page that loaded and ticked, so it is
+ *    impossible to grade the capability of a build that did not run. The old
+ *    arrangement enforced that by putting a call in the right place, which is
+ *    the kind of rule that survives exactly until someone moves the call.
+ *  - It stops duplicating a browser launch, a 1.5s settle, and a verbatim copy
+ *    of the start-click selector block. That copy had ALREADY drifted on
+ *    introduction (it gained an ArrowLeft the execution gate does not send), and
+ *    a drifted start-click means both sides measure the menu, agree, and the
+ *    rung goes silently inert. This repo has shipped inert probes twice.
+ *  - It makes the reading reachable from `uap verify`, not just from deliver. A
+ *    deliver-only bar re-creates the Generator!=Evaluator divergence this
+ *    codebase already records: the sessions that edit files directly never go
+ *    through the convergence loop at all, and a direct-edit session is exactly
+ *    what produced the recorded regression.
+ *
+ * FAILS OPEN, always. An unmeasurable page, an absent browser, a baseline that
+ * never rendered — all return "no regression". You cannot regress from broken,
+ * and a capability check that guesses is worse than none: it blocks working
+ * deliveries on browser noise. Every threshold is deliberately loose; this
+ * catches gutting, not drift.
+ *
+ * WHAT THIS IS NOT: a defence against a page that is deliberately lying.
+ *
+ * Say it plainly, because the numbers look like evidence and will be trusted as
+ * evidence. The counters live INSIDE the page's own realm and count API
+ * INVOCATIONS, not rendered output — so a page that wants a rich profile can
+ * simply call the instrumented APIs. Measured against this exact code: a page
+ * drawing a single 40x40 rect, by adding 64 no-op listeners, calling
+ * `useProgram` 64 times on a null context, and issuing 5000 zero-area
+ * `fillRect`s per frame, reported 5001 draws/frame, 64 shader programs, 64 event
+ * types and 60fps. Nothing here detects that, and sealing more surfaces does not
+ * converge: you cannot instrument a realm the adversary controls from inside it.
+ * Closing that needs an out-of-realm oracle — screenshot pixels captured
+ * host-side over CDP, which the visual gate already collects.
+ *
+ * So the honest claim is narrower than the motivating incident makes it sound.
+ * The octopus regression was a model SIMPLIFYING under gate pressure, not a
+ * model gaming a metric it knew about, and that is the case this catches: an
+ * unintentional loss of function that every other rung reads as success. Treat a
+ * clean capability verdict as "nothing obviously fell off", never as "the
+ * deliverable was not gutted".
+ *
+ * What the hardening here DOES buy is that the gate cannot be turned off by
+ * accident or by one line: the hooks are sealed under a per-run random key, the
+ * pristine `querySelector`/`performance.now` are captured at install time (a
+ * one-line override of either used to disable the whole reading), the baseline
+ * is in the integrity capture, and no value from the page or from disk reaches a
+ * threshold without coercion.
+ */
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+export function unmeasured(reason, driver) {
+    return {
+        measured: false,
+        reason,
+        elapsedMs: 0,
+        frames: 0,
+        drawCalls: 0,
+        glDrawCalls: 0,
+        ctx2dDrawCalls: 0,
+        programsUsed: 0,
+        listenerTypes: 0,
+        listeners: 0,
+        canvas: false,
+        ...(driver ? { driver } : {}),
+    };
+}
+/** Frames per second, from the page's own measured interval. */
+export const fpsOf = (p) => p.elapsedMs > 0 ? (p.frames * 1000) / p.elapsedMs : 0;
+/** Draw calls per frame — a property of the SCENE, invariant to frame rate. */
+export const drawsPerFrame = (p) => p.frames > 0 ? p.drawCalls / p.frames : 0;
+// ---------------------------------------------------------------------------
+// Thresholds
+// ---------------------------------------------------------------------------
+/**
+ * Scene-content ratios. Loose on purpose: the target is a build that lost most
+ * of its function, not one that lost a little. A tight threshold fails ordinary
+ * refactors (batching draws, merging two shader programs) and teaches the loop
+ * to pad its numbers back up, which is worse than not checking.
+ */
+const DRAW_RATIO = 0.6;
+const PROGRAM_RATIO = 0.6;
+const LISTENER_RATIO = 0.6;
+/**
+ * Frame rate is judged as an ABSOLUTE LIVENESS FLOOR, not a ratio — this is the
+ * single most important calibration decision in the file.
+ *
+ * A ratio cannot work here. The baseline is taken before the run's first model
+ * call; the candidate is taken minutes later on a box that is simultaneously
+ * decoding tokens on the same GPU, under software WebGL, possibly alongside
+ * other concurrent deliver tasks. Contention alone plausibly moves frame rate
+ * by 2-4x. The ratio this file originally used (0.4) trips at 2.5x — inside the
+ * noise, so it WOULD have misfired, blocking healthy turns and then telling the
+ * model to "restore the missing behaviour" that was never missing.
+ *
+ * A floor is load-invariant in the way that matters. On the measured octopus
+ * numbers — 59.9 fps healthy, 3.6 fps gutted — this fires with 2.8x of margin,
+ * while a healthy page would have to fall below 10 fps (6x contention) to
+ * false-fire. Same catch, 2.4x more headroom.
+ */
+const DEAD_FPS = 10;
+const ALIVE_FPS = 30;
+/** Below these, a metric is too small for a ratio to mean anything. */
+const MIN_DRAWS_PER_FRAME = 0.5;
+const MIN_PROGRAMS = 2;
+const MIN_LISTENER_TYPES = 3;
+/**
+ * How many metrics must drop before the turn is BLOCKED.
+ *
+ * One is too few. Each metric has a legitimate way to fall on its own: merging
+ * five shaders into an uber-shader takes programs 5->1; switching a per-entity
+ * draw path to an instanced one legitimately collapses draws-per-frame; moving
+ * to delegated event handling collapses listener types. Blocking on any single
+ * one of those, with feedback that says "restore the missing behaviour", asks
+ * the model to undo a correct optimisation.
+ *
+ * Two is enough to catch the thing this exists for: the recorded regression
+ * dropped ALL FOUR at once. A lone drop is still reported — as a note the judge
+ * sees, not a block.
+ */
+const BLOCK_AT_FINDINGS = 2;
+/**
+ * Compare a post-run profile against the pre-run baseline. PURE — unit-tested
+ * without a browser.
+ */
+export function compareCapability(baseline, current) {
+    const none = (skipped) => ({ regressed: false, skipped, findings: [], table: [] });
+    if (!capabilityEnabled())
+        return none('capability check disabled (UAP_CAPABILITY=0)');
+    if (!baseline?.measured)
+        return none('no capability baseline to compare against');
+    // A vanished entry page is the MOST complete regression possible, and the
+    // naive "either side unmeasured -> skip" rule forgave it outright: delete
+    // index.html and the reading becomes 'no-entry', which used to read as
+    // "cannot measure". Everything else that cannot be measured is an
+    // ENVIRONMENT failure and must still fail open.
+    if (!current?.measured) {
+        // Corroborated: the baseline must itself name the page that has vanished.
+        // Otherwise a single string written to current.json asserts the existence of
+        // something that was never measured, and that assertion bypasses the
+        // two-finding rule to block every turn.
+        if (current?.reason === 'no-entry' && baseline.entry) {
+            return {
+                regressed: true,
+                findings: ['the web entry page is GONE — there is no longer a page to run'],
+                table: [`entry: ${baseline.entry ?? '(a page)'} -> (none)`],
+            };
+        }
+        return none(`capability not measurable now (${current?.reason ?? 'unknown'})`);
+    }
+    // Two drivers have different frame-rate regimes and the fallback is silent.
+    if (baseline.driver && current.driver && baseline.driver !== current.driver) {
+        return none(`different browser drivers (${baseline.driver} then ${current.driver}) — not comparable`);
+    }
+    // You cannot regress from broken. A baseline that never rendered and never
+    // ticked gives every candidate an infinite improvement ratio.
+    if (baseline.frames === 0 && baseline.drawCalls === 0) {
+        return none('baseline never rendered — nothing to regress from');
+    }
+    const bFps = fpsOf(baseline);
+    const cFps = fpsOf(current);
+    const bDpf = drawsPerFrame(baseline);
+    const cDpf = drawsPerFrame(current);
+    const table = [
+        `frame rate: ${bFps.toFixed(1)} -> ${cFps.toFixed(1)} fps (${baseline.frames} frames in ${baseline.elapsedMs}ms -> ${current.frames} in ${current.elapsedMs}ms)`,
+        `draw calls per frame: ${bDpf.toFixed(2)} -> ${cDpf.toFixed(2)} (${baseline.drawCalls} -> ${current.drawCalls} total)`,
+        `shader programs used: ${baseline.programsUsed} -> ${current.programsUsed}`,
+        `event types handled: ${baseline.listenerTypes} -> ${current.listenerTypes}`,
+    ];
+    const findings = [];
+    const fmt = (n) => (Number.isInteger(n) ? String(n) : n.toFixed(2));
+    const ratioCheck = (label, base, cur, floor, ratio, unit) => {
+        if (!Number.isFinite(base) || !Number.isFinite(cur))
+            return;
+        if (base < floor)
+            return; // too small to judge
+        if (cur >= base * ratio)
+            return;
+        const pct = Math.round((1 - cur / base) * 100);
+        findings.push(`${label} dropped ${pct}%: ${fmt(base)} -> ${fmt(cur)} ${unit}`);
+    };
+    // Liveness: an absolute floor, not a ratio (see DEAD_FPS).
+    if (Number.isFinite(bFps) && Number.isFinite(cFps) && bFps >= ALIVE_FPS && cFps < DEAD_FPS) {
+        findings.push(`the render loop is no longer running at a usable rate: ${bFps.toFixed(1)} -> ${cFps.toFixed(1)} fps`);
+    }
+    // Draws-per-frame is only meaningful when BOTH sides actually drove rAF. A
+    // page whose loop is setInterval never touches requestAnimationFrame, so it
+    // reads 0 frames while still drawing — and dividing by a floored 1 turned
+    // draws-per-frame into draws-per-window, a number ~300x too large. Measured:
+    // a setInterval -> rAF refactor (an IMPROVEMENT) reported "draw calls per
+    // frame dropped 100%: 6300 -> 21".
+    if (baseline.frames > 0 && current.frames > 0) {
+        ratioCheck('draw calls per frame', bDpf, cDpf, MIN_DRAWS_PER_FRAME, DRAW_RATIO, 'per frame');
+    }
+    ratioCheck('distinct shader programs', baseline.programsUsed, current.programsUsed, MIN_PROGRAMS, PROGRAM_RATIO, 'programs');
+    ratioCheck('distinct event types handled', baseline.listenerTypes, current.listenerTypes, MIN_LISTENER_TYPES, LISTENER_RATIO, 'types');
+    return { regressed: findings.length >= BLOCK_AT_FINDINGS, findings, table };
+}
+/**
+ * The sentence the model is given. Verbatim numbers, no score: a percentage is
+ * what stalled the run this whole class of gate came from — the model needs to
+ * know WHAT it deleted, not how badly it is doing.
+ */
+export function capabilityFeedback(cmp) {
+    if (!cmp.regressed)
+        return '';
+    return [
+        'CAPABILITY REGRESSION — the app still runs, but it now DOES LESS than the build you started from.',
+        '',
+        ...cmp.findings.map((f) => `- ${f}`),
+        '',
+        'Measured before your changes vs now:',
+        ...cmp.table.map((t) => `  ${t}`),
+        '',
+        'This is not a rendering-cleanliness problem: a smaller, emptier app renders perfectly cleanly.',
+        'Something that used to be drawn, animated, or responded to is no longer there. Restore the',
+        'missing behaviour — the features, entities, effects and input handling from the original build —',
+        'without reintroducing errors. Do NOT simplify the app further to make gates pass.',
+    ].join('\n');
+}
+/**
+ * What to say when the check did NOT block: a single-metric drop, or the reason
+ * it declined to judge at all.
+ *
+ * The skip half is the important half. `skipped` used to be returned and read by
+ * nobody — not the acceptance gate, not the keep-best veto, not verify — so a
+ * check that had silently disarmed itself (a driver swap mid-run, a vanished
+ * baseline, an unmeasurable page) was indistinguishable from one that ran and
+ * found nothing. That is exactly the inert-rung failure this module's header
+ * warns about, reproduced in the module's own output.
+ */
+export function capabilityNote(cmp) {
+    if (cmp.skipped)
+        return `Capability check did not run: ${cmp.skipped}.`;
+    if (cmp.regressed || cmp.findings.length === 0)
+        return '';
+    return `Capability note (not blocking): ${cmp.findings.join('; ')}.`;
+}
+/** True when the check produced no opinion — callers should SAY so, not assume health. */
+export const capabilityInactive = (cmp) => Boolean(cmp.skipped);
+// ---------------------------------------------------------------------------
+// Persistence
+// ---------------------------------------------------------------------------
+/**
+ * On-disk layout, mirroring `.uap/visual/` (see visual-baseline.ts):
+ *   .uap/capability/current.json   written by the execution gate every run
+ *   .uap/capability/baseline.json  pinned pre-run, or by `uap verify --approve`
+ *
+ * Disk is what makes this reachable from BOTH sides. The execution gate often
+ * runs in a spawned runner (synthesizeExecutionRung), so a return value does
+ * not cross that boundary — the visual gate has the same constraint and solves
+ * it the same way, with files. It also survives `--resume`, where an in-memory
+ * baseline would be re-taken from the already-modified tree.
+ */
+/** Opt-out, matching every other gate in this subsystem. Off means the profile
+ *  is never written and every comparison declines. */
+export const capabilityEnabled = () => !['0', 'false', 'off', 'no'].includes((process.env.UAP_CAPABILITY ?? '').trim().toLowerCase());
+export const CAPABILITY_DIR = join('.uap', 'capability');
+export const currentPath = (root) => join(root, CAPABILITY_DIR, 'current.json');
+export const baselinePath = (root) => join(root, CAPABILITY_DIR, 'baseline.json');
+function readProfile(path) {
+    try {
+        if (!existsSync(path))
+            return null;
+        const raw = JSON.parse(readFileSync(path, 'utf-8'));
+        return sanitizeProfile(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function writeProfile(path, profile) {
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, `${JSON.stringify(profile, null, 2)}\n`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Drop any previous run's reading. Called at the START of every execution-gate
+ * run so `current.json` exists only when THIS run measured something — see the
+ * comment at that call site for what staleness cost.
+ */
+export function invalidateCapabilityCurrent(root) {
+    try {
+        if (existsSync(currentPath(root)))
+            rmSync(currentPath(root), { force: true });
+    }
+    catch {
+        /* fail-soft: a stale reading is better than a crashed gate */
+    }
+}
+/**
+ * Drop a baseline this run could not re-pin.
+ *
+ * A baseline is only meaningful for the tree it was taken from. Left in place
+ * across runs it becomes a reading of a DIFFERENT app: a run that pins 14
+ * draws/frame on a rich game, followed later by an unrelated run on a
+ * deliberately simpler project, blocks every turn against a stale number — and
+ * the operator has to know about an --approve flag to escape. Better to have no
+ * opinion than a confidently wrong one.
+ */
+export function invalidateCapabilityBaseline(root) {
+    try {
+        if (existsSync(baselinePath(root)))
+            rmSync(baselinePath(root), { force: true });
+    }
+    catch {
+        /* fail-soft */
+    }
+}
+export const readCapabilityBaseline = (root) => readProfile(baselinePath(root));
+export const readCapabilityCurrent = (root) => readProfile(currentPath(root));
+export const writeCapabilityCurrent = (root, p) => writeProfile(currentPath(root), p);
+export const writeCapabilityBaseline = (root, p) => writeProfile(baselinePath(root), p);
+/**
+ * Coerce an untrusted reading into a profile, or null.
+ *
+ * EVERY number here is attacker-controllable: the page under test is code a
+ * model just wrote, and it can replace the read-back hook. `typeof x ===
+ * 'number'` is not validation — `typeof NaN` and `typeof Infinity` are both
+ * 'number', and a NaN baseline propagates through every threshold comparison
+ * (`NaN < floor` is false, `NaN >= base*ratio` is false) to produce
+ * "dropped NaN%" findings on EVERY turn: a permanent, unactionable block.
+ * Measured before this guard existed.
+ */
+const REASONS = ['no-entry', 'no-browser', 'not-installed', 'no-reading', 'error'];
+export function sanitizeProfile(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const o = raw;
+    // A page cannot be trusted to report a plausible magnitude either; the cap is
+    // far above any real reading (60fps for a minute is 3600 frames).
+    const CAP = 10_000_000;
+    const num = (k) => {
+        const v = o[k];
+        return typeof v === 'number' && Number.isFinite(v) && v >= 0 ? Math.min(v, CAP) : 0;
+    };
+    if (typeof o.measured !== 'boolean')
+        return null;
+    const gl = num('glDrawCalls');
+    const ctx = num('ctx2dDrawCalls');
+    return {
+        measured: o.measured,
+        // Validated against the union, not cast into it. This is the only string
+        // read from disk that steers control flow (see the no-entry branch in
+        // compareCapability), so an unrecognised value must become "no reason"
+        // rather than a verdict.
+        ...(REASONS.includes(o.reason) ? { reason: o.reason } : {}),
+        elapsedMs: num('elapsedMs'),
+        frames: num('frames'),
+        drawCalls: gl + ctx,
+        glDrawCalls: gl,
+        ctx2dDrawCalls: ctx,
+        programsUsed: num('programsUsed'),
+        listenerTypes: num('listenerTypes'),
+        listeners: num('listeners'),
+        canvas: o.canvas === true,
+        ...(typeof o.driver === 'string' ? { driver: o.driver } : {}),
+        ...(typeof o.entry === 'string' ? { entry: o.entry } : {}),
+    };
+}
+//# sourceMappingURL=capability-profile.js.map

package/dist/delivery/capability-profile.js.map

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

package/dist/delivery/convergence-loop.d.ts

@@ -345,6 +345,44 @@ export interface ConvergenceConfig {
      * Bounded by the ceiling and the stagnation guard so it cannot loop forever.
      */
     untilDelivered?: boolean;
+    /**
+     * End this run after N consecutive turns that moved NEITHER the gate score
+     * nor the acceptance score. Off (undefined) unless a caller sets it.
+     *
+     * WHY THIS IS OPT-IN, AND WHY IT IS NOT A SECOND STAGNATION RAIL
+     * A previous attempt at plateau detection lived here unconditionally and was
+     * removed: `untilDelivered` already stops EXTENDING at STAGNATION_LIMIT, and
+     * an always-on rail was measured unreachable (its streak can never exceed
+     * `stagnantTurns`) or redundant. Nothing about that changed.
+     *
+     * What changed is the CALLER. An epic attempt has somewhere better to spend
+     * the time — a fresh attempt on the same epic — and the epic controller is
+     * the only layer that knows whether one is left. So this is set only when a
+     * retry remains, and the decision it encodes is "yield to a fresh attempt",
+     * not "give up on the mission". On the LAST attempt it stays off and the run
+     * plays out exactly as before.
+     *
+     * MEASURED (2026-08-20, rust-pg-ext, qwen3.8-27b), four flat attempts:
+     *   fix-bioband-derive  a1: 5 turns flat @60%  -> a2 PASSED in 2 turns
+     *   fix-slope-arithmetic a1: 5 turns flat @40%, a2: 5 turns flat @40%
+     * At the shipped threshold those three attempts give back 21.2 minutes of
+     * wall clock. What that buys is narrower than it first looks, and the first
+     * draft of this comment overstated it twice:
+     *
+     *   - No turn budget is TRANSFERRED. Every attempt gets its own `maxTurns`
+     *     regardless, so a fresh attempt is not lengthened by an earlier one
+     *     ending sooner; the epic's total exploration shrinks. Wall clock is the
+     *     saving, and the only one.
+     *   - That run did not die on its clock one epic short. All seven epics were
+     *     attempted; `fix-slope-arithmetic` failed on merit after three attempts
+     *     and a re-plan ("epic controller incomplete — failed epic(s): …").
+     *     Reclaiming its minutes would not have changed that outcome.
+     *
+     * The real case is still good: time spent on turns whose score is provably
+     * not moving is time no longer available to the other epics, to the re-plan,
+     * or to the run's wall-clock budget.
+     */
+    abortOnFlatTurns?: number;
     /**
      * Hard upper bound on turns when untilDelivered is set. Library default 50;
      * the `uap deliver --until-delivered` CLI defaults it to 30 (override with

package/dist/delivery/convergence-loop.d.ts.map

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

package/dist/delivery/convergence-loop.js

@@ -16,7 +16,7 @@
  */
 import { join } from 'node:path';
 import { execSync } from 'child_process';
-import { statSync } from 'fs';
+import { existsSync, statSync } from 'fs';
 import { ENDPOINT_UNREACHABLE } from '../models/long-fetch.js';
 /**
  * Consecutive unreachable-endpoint turns before the run gives up. Two, so a
@@ -25,6 +25,7 @@ import { ENDPOINT_UNREACHABLE } from '../models/long-fetch.js';
  */
 const UNREACHABLE_ABORT_LIMIT = 2;
 import { bindFrozenFragments, resolveBoundVariant, } from '../self-tuning/prompt-variants.js';
+import { baselinePath } from './capability-profile.js';
 import { mergeRedetectedRungs, detectRungs, runLadder } from './verifier-ladder.js';
 import { applyFileBlocks, listGateConfigFiles } from './applier.js';
 import { snapshotProtection } from './spec-imports.js';
@@ -606,6 +607,26 @@ export class ConvergenceLoop {
         // run must not read as turn-1 movement.
         let lastTurnFingerprint = null;
         let bestScoreSeen = -1;
+        // Yield-rail state (opt-in; see abortOnFlatTurns). Sanitised once here so
+        // a caller-supplied value cannot be NaN/fractional/negative downstream.
+        const rawFlatLimit = this.config.abortOnFlatTurns;
+        const flatTurnLimit = typeof rawFlatLimit === 'number' && Number.isFinite(rawFlatLimit) && rawFlatLimit >= 1
+            // SCALED to the turn budget, never below what the caller asked for.
+            //
+            // A fixed count is wrong across budgets. Replaying this rail over 157
+            // deliver logs (51 attempts where it would arm), every breakthrough it
+            // still destroys at the default is a LONG attempt — 6 to 8 turns, from
+            // runs whose maxTurns is 20, where three flat turns is a much weaker
+            // signal than it is out of five. Quartering the budget tracks that:
+            // maxTurns 5 -> 3 (the floor), maxTurns 20 -> 5.
+            ? Math.max(Math.floor(rawFlatLimit), Math.ceil(maxTurns / 4))
+            : undefined;
+        let flatTurnStreak = 0;
+        // Acceptance high-water for the yield rail only — NOT bestAcceptance, which
+        // untilDelivered advances in a block ABOVE this one (comparing against it
+        // here is always false) and never advances at all without untilDelivered
+        // (making every judged turn look like progress). Both readings were wrong.
+        let bestAcceptanceSeen = -1;
         let stallReason;
         let executor = this.executor;
         let explorerSettings = this.config.explorer;
@@ -686,6 +707,25 @@ export class ConvergenceLoop {
                 /* fail-soft: capture stays as it was */
             }
         }
+        // The capability BASELINE joins the capture for the same reason as the gate
+        // script and the runner configs: it is a trust anchor that run_bash can
+        // reach. It lived in `.uap/`, which the applier protects but the bash sweep
+        // SKIPS by design (the harness writes there constantly) and this capture did
+        // not cover — so `echo '{}' > .uap/capability/baseline.json`, or simply
+        // deleting it, silently disarmed both the acceptance check AND the keep-best
+        // veto that stops a gutted tree becoming the run's best snapshot.
+        //
+        // `current.json` is deliberately NOT protected: the gate rewrites it every
+        // run, so it is an output, not an anchor.
+        try {
+            const capBaseline = baselinePath(this.config.projectRoot);
+            if (existsSync(capBaseline)) {
+                protectedList = [...new Set([...(protectedList ?? []), capBaseline])];
+            }
+        }
+        catch {
+            /* fail-soft */
+        }
         const applyOptions = protectTests
             ? { protectedFiles, protectGateConfigs: true }
             : undefined;
@@ -1127,6 +1167,63 @@ export class ConvergenceLoop {
                         `reproduce this result.`;
                 break;
             }
+            // The YIELD rail (opt-in — see abortOnFlatTurns). Deliberately unlike the
+            // rail above: it does NOT require provablyIdle, because the attempts it
+            // exists for wrote real edits on every turn and were invisible to that
+            // check. Acceptance movement counts as progress for the same reason
+            // untilDelivered counts it — an objective-green run pins the gate score
+            // at 1.0 while a multi-criterion spec completes criterion by criterion.
+            //
+            // Escalation does NOT reset it, and that is the one exemption this rail
+            // drops. In all FOUR flat attempts measured, `↑ turn 3: enable critic`
+            // fired and the score did not move once afterwards. Yielding to a fresh
+            // attempt is a bigger change of approach than enabling a critic inside
+            // the attempt that is already failing — and the fresh attempt gets the
+            // escalation ladder too.
+            if (flatTurnLimit !== undefined) {
+                const acceptanceMoved = acceptanceMet !== undefined && acceptanceMet > bestAcceptanceSeen;
+                if (acceptanceMoved)
+                    bestAcceptanceSeen = acceptanceMet;
+                // A directive that REPLACES THE EXECUTOR is exempt — and only that.
+                //
+                // The first version of this rail exempted no escalation at all, on the
+                // evidence that `↑ turn 3: enable critic` fired in four measured flat
+                // attempts and moved the score in none. That evidence is about the
+                // CRITIC tier and does not reach the tier above it: with a stronger
+                // model configured, `defaultEscalationLadder` appends a `switchExecutor`
+                // tier at turn 5, and `createRepairEscalation` returns one whenever
+                // compile errors are RISING — i.e. on exactly the flat turn this rail
+                // fires. Measured against the real ladder: unexempted, an attempt that
+                // master delivers on turn 6 with the stronger model was abandoned on
+                // turn 3, and the one-shot repair pass never ran once.
+                //
+                // A directive is decided on THIS turn and consumed by the NEXT one, so
+                // breaking here discards it. Give a new executor the single turn it
+                // needs to prove itself; the critic and reseed tiers stay unexempted,
+                // because those are the ones the measurement found worthless.
+                const executorChanged = Boolean(directive.switchExecutor);
+                // `inconclusive` stays exempt: a turn that never reached a model is
+                // missing data, not a flat result, and flaky turns must not burn an
+                // attempt.
+                if (inconclusive || scoreMoved || acceptanceMoved || executorChanged)
+                    flatTurnStreak = 0;
+                else
+                    flatTurnStreak++;
+                if (flatTurnStreak >= flatTurnLimit) {
+                    // SHORT by design. This is prepended to finalFeedback, and
+                    // epic-mission slices that to 400 chars to build the next attempt's
+                    // `lastFailure` — so every character here evicts a character of real
+                    // gate feedback from the retry's steering. The 339-char first draft
+                    // left ~58 chars of gate output and cut the actionable line, which
+                    // defeated the recovery the rail depends on. Rationale lives above,
+                    // not on the wire. Deliberately does NOT claim the tree changed: this
+                    // rail never consults `provablyIdle` or `filesApplied`.
+                    stallReason =
+                        `plateau: ${flatTurnStreak} turns with no gate (best ` +
+                            `${(bestScoreSeen * 100).toFixed(0)}%) or acceptance progress — yielding to a fresh attempt.`;
+                    break;
+                }
+            }
             // Phase 3: structured critique of the failed turn (fail-soft). Skipped
             // on the last turn — prevContext is never consumed, so it would waste
             // a model call.