instar 1.3.780 → 1.3.782

package/dashboard/index.html

@@ -2752,6 +2752,7 @@
           <button class="tab" data-tab="resources" onclick="switchTab('resources')">Resource Usage</button>
           <button class="tab" data-tab="llm-activity" onclick="switchTab('llm-activity')">LLM Activity</button>
           <button class="tab" data-tab="routing-map" onclick="switchTab('routing-map')">Routing Map</button>
+          <button class="tab" data-tab="spend" onclick="switchTab('spend')">Spend</button>
           <button class="tab" data-tab="threadline" onclick="switchTab('threadline')">Threadline</button>
           <button class="tab" data-tab="evidence" onclick="switchTab('evidence')">Evidence</button>
           <button class="tab" data-tab="process-health" onclick="switchTab('process-health')">Process Health</button>
@@ -3373,6 +3374,56 @@
       </div>
     </div>
 
+    <!-- Spend tab — the read-only Routing Control Room spend/caps view (Increment A,
+         docs/specs/routing-control-room-spend-alerts.md). Immutable token usage priced ON
+         READ + every metered paid-door key with its caps and honest not-live/$0 state.
+         Read-only: data from /routing-spend/summary + /routing-spend/caps. No money controls
+         (caps adjust, go-live, alerts are later, dark increments). -->
+    <div id="spendPanel" style="display:none;flex-direction:column;padding:20px;gap:16px;overflow-y:auto">
+      <div style="display:flex;justify-content:space-between;align-items:center;gap:12px;flex-wrap:wrap">
+        <h2 style="margin:0">Spend</h2>
+        <div style="display:flex;gap:8px;align-items:center">
+          <select id="spendGrain" onchange="loadRoutingSpend()" style="padding:6px 8px">
+            <option value="day" selected>Daily</option>
+            <option value="hour">Hourly (30d)</option>
+            <option value="month">Monthly</option>
+            <option value="total">Total</option>
+          </select>
+          <button onclick="loadRoutingSpend()" style="padding:6px 12px">Refresh</button>
+        </div>
+      </div>
+      <div style="font-size:12px;color:var(--text-dim);line-height:1.4">
+        What the internal AI calls cost, and where the paid-door caps sit. The dollar figures are a
+        <b>reporting</b> view — immutable token counts priced against a reviewed price list on read, so a
+        price correction reflows automatically. <b>No paid door is live yet</b>, so metered spend is $0;
+        subscription/CLI doors are <b>$0 (not per-token billed)</b>. This is read-only — money caps and the
+        go-live control are a later increment.
+      </div>
+
+      <!-- Headline totals -->
+      <div id="spendHeadlineCard" style="border:1px solid var(--border);border-radius:8px;padding:16px">
+        <div id="spendHeadlineBody" style="font-size:13px;overflow-x:auto">
+          <div style="color:var(--text-dim)">Loading...</div>
+        </div>
+      </div>
+
+      <!-- Per door/model spend -->
+      <div style="border:1px solid var(--border);border-radius:8px;padding:16px;display:flex;flex-direction:column;gap:8px">
+        <div style="font-weight:600">By door &amp; model</div>
+        <div id="spendRowsBody" style="font-size:13px;overflow-x:auto">
+          <div style="color:var(--text-dim)">Loading...</div>
+        </div>
+      </div>
+
+      <!-- Paid-door caps -->
+      <div style="border:1px solid var(--border);border-radius:8px;padding:16px;display:flex;flex-direction:column;gap:8px">
+        <div style="font-weight:600">Paid-door caps</div>
+        <div id="spendCapsBody" style="font-size:13px;overflow-x:auto">
+          <div style="color:var(--text-dim)">Loading...</div>
+        </div>
+      </div>
+    </div>
+
     <!-- Evidence Tab (WikiClaim Phase 4) — per-entity evidence + reverse "what cites this?" view.
          Spec: docs/specs/OPENCLAW-IMPORT-WIKICLAIM-EVIDENCE-SPEC.md § Phase 4 (line 343). -->
     <!-- process-health tab -->
@@ -5046,6 +5097,12 @@
         display: ['flex'],
         onActivate: () => { if (typeof loadRoutingMap === 'function') loadRoutingMap(); },
       },
+      {
+        id: 'spend',
+        panels: ['spendPanel'],
+        display: ['flex'],
+        onActivate: () => { if (typeof loadRoutingSpend === 'function') loadRoutingSpend(); },
+      },
       {
         id: 'threadline',
         panels: ['threadlineTab'],
@@ -5810,6 +5867,110 @@
       }
     }
 
+    // Routing Control Room — read-only spend/caps view (Increment A). Data from
+    // /routing-spend/summary + /routing-spend/caps. Honest $0 / not-live-yet labelling.
+    async function loadRoutingSpend() {
+      const headEl = document.getElementById('spendHeadlineBody');
+      const rowsEl = document.getElementById('spendRowsBody');
+      const capsEl = document.getElementById('spendCapsBody');
+      const grain = (document.getElementById('spendGrain') || {}).value || 'day';
+      const usd = (n) => '$' + (Number(n) || 0).toFixed(4);
+      const num = (n) => (Number(n) || 0).toLocaleString();
+      const th = (t, right) => '<th style="padding:6px 8px;' + (right ? 'text-align:right' : 'text-align:left') + '">' + t + '</th>';
+      const td = (v, right) => '<td style="padding:6px 8px;vertical-align:top;' + (right ? 'text-align:right' : '') + '">' + v + '</td>';
+      try {
+        const [summary, caps] = await Promise.all([
+          apiFetch('/routing-spend/summary?grain=' + encodeURIComponent(grain)),
+          apiFetch('/routing-spend/caps'),
+        ]);
+
+        // Headline totals
+        const t = summary.totals || {};
+        const unpriced = (Number(t.unpricedTokensIn) || 0) + (Number(t.unpricedTokensOut) || 0);
+        const stat = (label, val) => '<div style="min-width:120px"><div style="font-size:11px;color:var(--text-dim)">' + label + '</div><div style="font-size:18px;font-weight:600">' + val + '</div></div>';
+        headEl.innerHTML =
+          '<div style="display:flex;gap:20px;flex-wrap:wrap">' +
+            stat('Gross', usd(t.grossUsd)) +
+            stat('Net (of subsidy/credits)', usd(t.netUsd)) +
+            stat('Committed (cap-enforced)', usd(t.committedUsd)) +
+            stat('Tokens in', num(t.tokensIn)) +
+            stat('Tokens out', num(t.tokensOut)) +
+            (unpriced > 0 ? stat('Unpriced tokens', num(unpriced)) : '') +
+          '</div>' +
+          '<div style="font-size:11px;color:var(--text-dim);margin-top:10px;line-height:1.4">' +
+            escapeHtml(String(summary.note || '')) + '<br>' +
+            escapeHtml(String(summary.horizonNote || '')) +
+            (summary.providerGroundingNote ? '<br>' + escapeHtml(String(summary.providerGroundingNote)) : '') +
+            (summary.reportingBasis ? '<br>Basis: ' + escapeHtml(String(summary.reportingBasis.note || '')) : '') +
+          '</div>';
+
+        // Per door/model rows
+        const rows = summary.rows || [];
+        if (rows.length === 0) {
+          rowsEl.innerHTML = '<div style="color:var(--text-dim)">No internal-LLM usage recorded in this window yet.</div>';
+        } else {
+          rowsEl.innerHTML =
+            '<table style="width:100%;border-collapse:collapse;font-size:12px;min-width:720px">' +
+            '<thead><tr style="color:var(--text-dim)">' +
+              th('Door') + th('Model') + th('Class') + th('Tokens in', true) + th('Tokens out', true) +
+              th('Gross', true) + th('Net', true) + th('Price basis') +
+            '</tr></thead><tbody>' +
+            rows.map((r) => {
+              const cls = r.doorClass === 'metered'
+                ? 'metered' + (r.notLiveYet ? ' · not live' : '')
+                : escapeHtml(String(r.doorClass));
+              let basis;
+              if (r.priceBasis === 'subscription-zero') basis = '<span style="color:var(--text-dim)">subscription — not per-token billed</span>';
+              else if (r.priceBasis === 'no-matching-point') basis = '<span style="color:var(--red)">unpriced (no matching price)</span>';
+              else basis = escapeHtml(String(r.priceBasis)) + (r.priceStale ? ' <span style="color:var(--red)">(stale)</span>' : '');
+              const netCell = r.priceBasis === 'subscription-zero' ? '<span style="color:var(--text-dim)">$0 (subscription)</span>' : usd(r.netUsd);
+              return '<tr style="border-top:1px solid var(--border)">' +
+                td('<b>' + escapeHtml(String(r.door)) + '</b>') +
+                td(escapeHtml(String(r.modelId))) +
+                td(escapeHtml(cls)) +
+                td(num(r.tokensIn), true) +
+                td(num(r.tokensOut), true) +
+                td(usd(r.grossUsd), true) +
+                td(netCell, true) +
+                td(basis) +
+              '</tr>';
+            }).join('') +
+            '</tbody></table>';
+        }
+
+        // Paid-door caps
+        const keys = caps.keys || [];
+        capsEl.innerHTML =
+          '<div style="font-size:11px;color:var(--text-dim);margin-bottom:8px">' + escapeHtml(String(caps.note || '')) + '</div>' +
+          '<table style="width:100%;border-collapse:collapse;font-size:12px;min-width:640px">' +
+          '<thead><tr style="color:var(--text-dim)">' +
+            th('Key') + th('Provider') + th('Door') + th('Daily cap', true) + th('Lifetime cap', true) +
+            th('Committed', true) + th('Status') +
+          '</tr></thead><tbody>' +
+          keys.map((k) =>
+            '<tr style="border-top:1px solid var(--border)">' +
+            td('<b>' + escapeHtml(String(k.keyRef)) + '</b>') +
+            td(escapeHtml(String(k.provider))) +
+            td(escapeHtml(String(k.door))) +
+            td(usd(k.dailyCapUsd), true) +
+            td(usd(k.lifetimeCapUsd), true) +
+            td(usd(k.committedDayUsd) + ' / ' + usd(k.committedLifetimeUsd), true) +
+            td('<span style="color:var(--text-dim)">' + escapeHtml(String(k.goLiveState)) + (k.frozen ? ' · frozen' : '') + '</span>') +
+            '</tr>').join('') +
+          '</tbody></table>' +
+          '<div style="font-size:11px;color:var(--text-dim);margin-top:8px">' + escapeHtml(String(caps.singleMachineNote || '')) + '</div>';
+      } catch (err) {
+        const m = err && err.message ? String(err.message) : String(err);
+        if (/503|not enabled|unavailable/i.test(m)) {
+          headEl.innerHTML = '<div style="color:var(--text-dim)">The spend view isn\'t enabled on this agent (it\'s a development-agent surface, dark on the fleet).</div>';
+        } else {
+          headEl.innerHTML = '<div style="color:var(--red)">Error: ' + escapeHtml(m) + '</div>';
+        }
+        rowsEl.innerHTML = '';
+        capsEl.innerHTML = '';
+      }
+    }
+
     async function loadResources() {
       const headlineEl = document.getElementById('resourcesHeadlineBody');
       const sourcesEl = document.getElementById('resourcesSourcesBody');

package/dist/core/IntelligenceRouter.d.ts

@@ -164,15 +164,18 @@ export interface IntelligenceRouterOptions {
      * (resolved at the construction boundary, like `ladder`). Absent OR `enabled:false`
      * ⇒ the nature router is inert and routing is BYTE-IDENTICAL to today. When enabled +
      * dryRun (the dev-agent default) the resolver OBSERVES (computes + logs the plan via
-     * `onNatureRoutePlan`) and still passes through to today's selection. Enforcing
-     * selection (dryRun:false) is a tracked A2.2 remainder.
+     * `onNatureRoutePlan`) and still passes through to today's selection. When enabled +
+     * `dryRun:false` (the operator's deliberate post-soak flip — A2.2) the resolved plan
+     * REPLACES today's selection: the primary `(door, model)` is used and the swapTail feeds
+     * the existing failure-swap loop.
      */
     resolveNatureRouting?: () => NatureRoutingRuntime | undefined;
     /**
-     * S4 A2 — the dryRun observation sink (FD11 readable canary). Invoked with the resolved
-     * plan when nature routing is enabled + dryRun. No-op downstream by default; the router
-     * calls it freely. The durable `logs/nature-routing.jsonl` + `GET /intelligence/routing`
-     * surfaces that consume this are a tracked A2.2 remainder.
+     * S4 A2 — the resolved-plan observation sink (FD11 readable canary). Invoked with the
+     * resolved plan on EVERY nature-routing call (dryRun AND enforcing) so the plan is always
+     * observable. No-op downstream by default; the router calls it freely. The durable
+     * `logs/nature-routing.jsonl` + `GET /intelligence/routing` surfaces that consume this,
+     * and the FD6 critical-gate drift notice / baseline, are tracked follow-ups.
      */
     onNatureRoutePlan?: (plan: NatureRoutePlan) => void;
 }
@@ -446,8 +449,6 @@ export declare class IntelligenceRouter implements IntelligenceProvider {
     private providerFor;
     /** Default framework → shared provider; else the cached per-framework provider (null if binary missing). */
     private resolveProvider;
-    /** Already warned that nature-routing enforcing mode is not yet wired (warn ONCE). */
-    private warnedNatureEnforceNotWired;
     /**
      * S4 A2 — CLI-door reachability probe for the nature router (FD5 availability walk).
      * CLI doors coincide 1:1 with `IntelligenceFramework`. `resolveRoute` skips metered
@@ -456,12 +457,6 @@ export declare class IntelligenceRouter implements IntelligenceProvider {
      * builds (binary present). Result is cached by `providerFor`.
      */
     private isCliDoorReachable;
-    /**
-     * S4 A2 — enforcing-mode honesty guard. Flipping `dryRun:false` in A2.1 does NOT re-route
-     * (the selection integration is a tracked A2.2 remainder); routing stays byte-identical.
-     * Warn ONCE so the flip is an honest no-op rather than a silent dead switch.
-     */
-    private warnNatureEnforceNotWired;
     /** Chains already warned about as rejected (warn ONCE per chain, never per call). */
     private warnedRejectedChains?;
     /**

package/dist/core/IntelligenceRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IntelligenceRouter.d.ts","sourceRoot":"","sources":["../../src/core/IntelligenceRouter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"IntelligenceRouter.d.ts","sourceRoot":"","sources":["../../src/core/IntelligenceRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EACL,KAAK,iBAAiB,EAGvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EAOzB,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,yBAAyB;IACxC,iGAAiG;IACjG,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,8DAA8D;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,CAAC,CAAC;IACvE,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAClD,6GAA6G;IAC7G,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC9B;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,EAAE,EAAE,qBAAqB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CACL,IAAI,EAAE,aAAa,GAAG,YAAY,EAClC,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,EAC5C,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,6HAA6H;IAC7H,eAAe,EAAE,oBAAoB,CAAC;IACtC,8CAA8C;IAC9C,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,sHAAsH;IACtH,aAAa,EAAE,MAAM,yBAAyB,GAAG,SAAS,CAAC;IAC3D;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;;OAOG;IACH,+BAA+B,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC;IACjF;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B;;;;OAIG;IACH,aAAa,EAAE,CAAC,SAAS,EAAE,qBAAqB,KAAK,oBAAoB,GAAG,IAAI,CAAC;IACjF,wGAAwG;IACxG,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC9C;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACxE,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE;QACP,mGAAmG;QACnG,oBAAoB,EAAE,MAAM,CAAC;QAC7B,sEAAsE;QACtE,cAAc,EAAE,OAAO,CAAC;QACxB,OAAO,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QACvG,kGAAkG;QAClG,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,iGAAiG;QACjG,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;IACF;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,EAAE,MAAM,oBAAoB,GAAG,SAAS,CAAC;IAC9D;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;CACrD;AAmCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,qBAAqB,EAC7B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,EACvE,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,GAAG,SAAS,CAMpB;AAuCD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,qBAAqB,EAC7B,SAAS,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAAG,SAAS,GAClD;IAAE,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAKvE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAMzF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAKT;AAiBD;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,SAAS,EAAE,MAAM,GAAG,SAAS;aAC7B,aAAa,EAAE,YAAY;gBAD3B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,aAAa,EAAE,YAAY;CAQ9C;AAED,uFAAuF;AACvF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,yFAAyF;AACzF,MAAM,MAAM,eAAe,GACvB;IACE,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,UAAU,CAAC;IAC3B,aAAa,EAAE,YAAY,CAAC;IAC5B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC,GACD;IAAE,OAAO,EAAE,cAAc,CAAA;CAAE,GAC3B;IAAE,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAc5B;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,cAAc,CAAC,EAAE,OAAO,GACvB;IAAE,cAAc,EAAE,UAAU,CAAC;IAAC,aAAa,EAAE,YAAY,CAAA;CAAE,GAAG,SAAS,CAUzE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAEjE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,qBAAqB,EAC1B,aAAa,EAAE,YAAY,GAC1B,qBAAqB,CAKvB;AAmBD,8FAA8F;AAC9F,MAAM,MAAM,kBAAkB,GAC1B,yBAAyB,GACzB,wBAAwB,GACxB,cAAc,GACd,6BAA6B,GAC7B,2BAA2B,GAC3B,2BAA2B,GAC3B,yBAAyB,CAAC;AAE9B,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,MAAM,GACZ,oBAAoB,GAAG,IAAI,CAiD7B;AAED,iEAAiE;AACjE,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,aAAa,CAAC,aAAa,CAAC,GACtC,oBAAoB,EAAE,CAOxB;AAED,iGAAiG;AACjG,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,GAAG,oBAAoB,EAAE,CAM/F;AAED,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAE/E;AA2BD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,MAAM,GACZ,oBAAoB,GAAG,IAAI,CAoD7B;AAED,oFAAoF;AACpF,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,aAAa,CAAC,aAAa,CAAC,GACtC,oBAAoB,EAAE,CAOxB;AAED,mGAAmG;AACnG,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,aAAa,CAAC,aAAa,CAAC,GACtC,oBAAoB,EAAE,CAKxB;AAQD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,cAAc,CAAC,EAAE,OAAO,GACvB,OAAO,CAET;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,cAAc,EAAE,OAAO,EACvB,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE;IACJ,eAAe,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC;IAChD,kGAAkG;IAClG,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,KAAK,IAAI,CAAC;IACnF;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC;CACjE,GACA,eAAe,CAuDjB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,EACjF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,KAAK,IAAI,GAC3E,mBAAmB,CAwBrB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,4FAA4F;IAC5F,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CACtE;AAED,0FAA0F;AAC1F,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,kBAAmB,YAAW,oBAAoB;IAMjD,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqD;IAE3E,yFAAyF;IACzF,OAAO,CAAC,oBAAoB,CAAC,CAAc;gBAEd,IAAI,EAAE,yBAAyB;IAE5D;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;;OAKG;IACH,IAAI,gBAAgB,IAAI,qBAAqB,CAE5C;IAED,8EAA8E;IAC9E,gBAAgB,CACd,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,iBAAiB,EAC3B,GAAG,EAAE,yBAAyB,GAAG,SAAS,GACzC,qBAAqB;IAQxB;;;OAGG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,iBAAiB,GAAG;QAC5D,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,iBAAiB,CAAC;QAC5B,SAAS,EAAE,qBAAqB,CAAC;QACjC,SAAS,EAAE,OAAO,CAAC;KACpB;IAQD,+FAA+F;IAC/F,OAAO,CAAC,WAAW;IAcnB,4GAA4G;IAC5G,OAAO,CAAC,eAAe;IAIvB;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAI1B,qFAAqF;IACrF,OAAO,CAAC,oBAAoB,CAAC,CAAoB;IAEjD;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAWzB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IA8V9E;;;;;;;;;;OAUG;YACW,kBAAkB;CAoCjC"}

package/dist/core/IntelligenceRouter.js

@@ -175,16 +175,17 @@ export function isBoundedGatingDegrade(component, options) {
     return row.chain !== 'WRITE'; // WRITE is the sanctioned Opus-CLI lane; everything else is bounded/gating
 }
 /* ────────────────────────────────────────────────────────────────────────────
- * S4 Increment A2 — the nature-axis routing RESOLVER (dark/dryRun mechanism).
+ * S4 Increment A2 — the nature-axis routing RESOLVER.
  *
  * `resolveRoute` is a PURE, side-effect-free evaluator (spec CR2-5): a stateless
  * fold `component → resolvedNature → ordered eligible positions → { primary, swapTail }
  * | 'fall-through' | 'no-route' | throw`. It owns no retry/backoff/breaker/budget
  * machinery — those stay in the existing IntelligenceRouter primitives. Wired into
  * `evaluate()` ONLY when `sessions.natureRouting.enabled` (dev-gated dark). In dryRun
- * (the dev-agent default) it OBSERVES: computes + logs the plan, then passes through to
- * today's routing (byte-identical selection). Enforcing selection (dryRun:false) is a
- * tracked A2.2 remainder — see the honest guard in `evaluate()`.
+ * (the dev-agent default, A2.1) it OBSERVES: computes + logs the plan, then passes through
+ * to today's routing (byte-identical selection). When `dryRun:false` (A2.2, the operator's
+ * deliberate post-soak flip) the resolved plan REPLACES today's selection — the primary
+ * `(door, model)` is used and the swapTail feeds the existing failure-swap loop verbatim.
  * Spec: docs/specs/nature-axis-routing.md §Resolver / FD3 / FD4 / FD9.
  * ──────────────────────────────────────────────────────────────────────────── */
 /**
@@ -643,8 +644,6 @@ export class IntelligenceRouter {
     resolveProvider(framework) {
         return framework === this.opts.defaultFramework ? this.opts.defaultProvider : this.providerFor(framework);
     }
-    /** Already warned that nature-routing enforcing mode is not yet wired (warn ONCE). */
-    warnedNatureEnforceNotWired = false;
     /**
      * S4 A2 — CLI-door reachability probe for the nature router (FD5 availability walk).
      * CLI doors coincide 1:1 with `IntelligenceFramework`. `resolveRoute` skips metered
@@ -655,20 +654,6 @@ export class IntelligenceRouter {
     isCliDoorReachable(door) {
         return this.resolveProvider(door) !== null;
     }
-    /**
-     * S4 A2 — enforcing-mode honesty guard. Flipping `dryRun:false` in A2.1 does NOT re-route
-     * (the selection integration is a tracked A2.2 remainder); routing stays byte-identical.
-     * Warn ONCE so the flip is an honest no-op rather than a silent dead switch.
-     */
-    warnNatureEnforceNotWired() {
-        if (this.warnedNatureEnforceNotWired)
-            return;
-        this.warnedNatureEnforceNotWired = true;
-        console.warn('IntelligenceRouter: sessions.natureRouting.dryRun is false, but nature-routing ENFORCING ' +
-            'selection is not wired in this build (Increment A2.1 ships the dark/dryRun observation ' +
-            'mechanism; enforcing selection is the tracked A2.2 remainder). Routing stays byte-identical — ' +
-            'the resolver plan is logged but not applied.');
-    }
     /** Chains already warned about as rejected (warn ONCE per chain, never per call). */
     warnedRejectedChains;
     /**
@@ -695,13 +680,21 @@ export class IntelligenceRouter {
             ? explicitCategory
             : categoryForComponent(component);
         const cfg = this.opts.resolveConfig();
-        // ── S4 A2 — nature-axis routing OBSERVATION (dev-gated dark; dryRun-first). ──
+        // ── S4 A2 — nature-axis routing (dev-gated dark; dryRun-first). ──
         // Byte-identical when unset/off: when the feature is absent OR `enabled:false` this
         // whole block is skipped and NOTHING about selection changes. In dryRun (the dev-agent
         // default) it OBSERVES only — computes + logs the plan via `onNatureRoutePlan` — and
-        // still falls through to today's selection below. Enforcing SELECTION (dryRun:false) is
-        // a tracked A2.2 remainder; guarded here so a flip is an HONEST no-op, never a silent
-        // dead switch and never a mis-route. A resolver error can never break routing here.
+        // still falls through to today's selection below. When ENFORCING (`dryRun:false`, the
+        // operator's deliberate flip after the dryRun soak — A2.2) the resolved plan REPLACES
+        // today's selection (spec §Resolver steps 8-9): the primary `(door, model)` becomes the
+        // selection and the `swapTail` feeds the EXISTING failure-swap loop verbatim. A resolver
+        // error can never break routing here — the DESIGNED critical-gate fail-closed throw
+        // (`RouterFailClosedError`) propagates on the real path so the gate caller applies its
+        // own fail-closed semantics; any UNEXPECTED resolver error falls through to today's
+        // selection (fail-safe). In dryRun EVERY outcome (route / no-route / throw) is recorded
+        // only — nothing is ever withheld or re-routed.
+        let enforced;
+        let enforcedNoRoute = false;
         const natureRt = this.opts.resolveNatureRouting?.();
         if (natureRt?.enabled) {
             const dryRun = natureRt.dryRun !== false; // default true on first enable
@@ -713,26 +706,69 @@ export class IntelligenceRouter {
                     isInjectionExposed: (comp) => isComponentInjectionExposed(comp, options?.attribution?.injectionExposed === true),
                 });
                 this.opts.onNatureRoutePlan?.({ component, category, dryRun, resolution });
+                if (!dryRun) {
+                    // ENFORCE (A2.2): the resolved plan becomes the actual selection.
+                    if (resolution.outcome === 'route') {
+                        enforced = { primary: resolution.primary, swapTail: resolution.swapTail };
+                    }
+                    else if (resolution.outcome === 'no-route') {
+                        // Low-stakes mapped, all chain doors down ⇒ the caller's OWN non-gating heuristic
+                        // (the ordinary provider-down contract) — NEVER legacy category routing, so the
+                        // harness door can't re-open for a nature-routed component (spec §573-581).
+                        enforcedNoRoute = true;
+                    }
+                    // 'fall-through' (unmapped) ⇒ leave enforcement unset → today's category routing below.
+                }
             }
             catch (e) {
                 if (e instanceof RouterFailClosedError) {
                     this.opts.onNatureRoutePlan?.({ component, category, dryRun, failClosed: true });
+                    // ENFORCE (A2.2): a mapped FD6 critical gate with no available door FAILS CLOSED on
+                    // the real path — the caller applies its gating fail-closed semantics (block/deny),
+                    // never legacy routing and never the harness door. In dryRun the throw is swallowed
+                    // (observe-and-record only), never surfaced to the call path.
+                    if (!dryRun)
+                        throw e;
                 }
                 else {
+                    // An UNEXPECTED resolver error (the pure fold only THROWS `RouterFailClosedError` by
+                    // design). Record it and fall through to today's selection — an unexpected error must
+                    // never break routing (fail-safe); a real empty-set critical gate is the typed error
+                    // above, never this branch.
                     this.opts.onNatureRoutePlan?.({ component, category, dryRun });
                 }
             }
-            if (!dryRun)
-                this.warnNatureEnforceNotWired();
         }
-        // Unconfigured ⇒ exactly today's behavior.
-        if (!cfg)
-            return this.opts.defaultProvider.evaluate(prompt, options);
-        const framework = this.resolveFramework(component, category, cfg);
+        // ENFORCE 'no-route': raise the ordinary non-gating error the caller already catches into
+        // its heuristic (tracked never-silent). NEVER legacy category routing (harness-door re-open).
+        if (enforcedNoRoute) {
+            this.opts.onHeuristicFallthrough?.(component ?? '(none)', this.opts.defaultFramework);
+            throw new Error(`IntelligenceRouter: nature-routing 'no-route' — no available door for low-stakes ` +
+                `'${component ?? '(none)'}' (all chain doors unreachable); caller uses its heuristic.`);
+        }
+        // Selection: an enforced nature plan supersedes category routing (its primary door is
+        // guaranteed reachable — the resolver only emits reachable CLI doors). Otherwise today's
+        // behavior: unconfigured componentFrameworks ⇒ the default provider verbatim.
+        let framework;
+        let evalOptions = options;
+        if (enforced) {
+            framework = enforced.primary.door; // resolver emits CLI doors only
+            // The resolved primary's CONCRETE model id REPLACES the caller's tier hint (spec step 8).
+            // It is already reserve-clamped by the resolver (clampToReserveOnCleanDoor); a concrete id
+            // rides `options.model` verbatim to the provider (the adapters resolve tier-or-id).
+            evalOptions = { ...(options ?? {}), model: enforced.primary.modelId };
+        }
+        else {
+            if (!cfg)
+                return this.opts.defaultProvider.evaluate(prompt, options);
+            framework = this.resolveFramework(component, category, cfg);
+        }
         const primary = this.resolveProvider(framework);
         // Provider unavailable (binary missing / not built) — unchanged: degrade or error.
+        // (`cfg?.` because an enforced nature plan may have superseded category routing with a
+        // null `cfg`; an enforced primary door is always reachable, so this branch stays legacy.)
         if (!primary) {
-            if ((cfg.fallback ?? 'default') === 'none') {
+            if ((cfg?.fallback ?? 'default') === 'none') {
                 throw new Error(`IntelligenceRouter: framework '${framework}' for component '${component ?? '(none)'}' ` +
                     `is unavailable and fallback is 'none'.`);
             }
@@ -785,13 +821,21 @@ export class IntelligenceRouter {
         const deferrable = !gating && options?.attribution?.deferrable === true;
         const ladder = this.opts.ladder;
         // Framework-swap applies to a gating OR a deferrable call (both ladder paths include it).
-        const swapTargets = (gating || deferrable) && cfg.failureSwap ? cfg.failureSwap : [];
+        // An enforced nature plan supplies the resolved `swapTail` (each a door + concrete model,
+        // already reserve-clamped); the legacy path supplies the config `failureSwap` frameworks
+        // (each taking the caller's tier, clamped per-door in the loop). BOTH ride the SAME
+        // gating||deferrable gate and the SAME loop below — the spec's "reuse verbatim".
+        const swapPositions = gating || deferrable
+            ? enforced
+                ? enforced.swapTail.map((p) => ({ door: p.door, model: p.modelId }))
+                : (cfg?.failureSwap ?? []).map((fw) => ({ door: fw }))
+            : [];
         // GATING budget: a single hard wall-clock deadline over the whole gating failure path so an
         // awaited gate stays responsive (no stacking rungs). Deferrable calls are not budgeted this way.
         const gatingDeadlineAt = gating && ladder ? Date.now() + ladder.gatingLadderBudgetMs : undefined;
         let err;
         try {
-            const mainResult = await primary.evaluate(prompt, options);
+            const mainResult = await primary.evaluate(prompt, evalOptions);
             this.opts.onResolved?.(component ?? '(none)', framework); // a real answer → auto-resolve any open degradation
             return mainResult;
         }
@@ -807,7 +851,7 @@ export class IntelligenceRouter {
                     const delay = Math.min(b.baseMs * Math.pow(b.factor, attempt), b.ceilingMs);
                     const jittered = Math.min(Math.floor(delay * (0.5 + Math.random() * 0.5)), b.maxWaitMs);
                     try {
-                        const boResult = await primary.evaluate(prompt, { ...(options ?? {}), rateLimitWaitMs: jittered });
+                        const boResult = await primary.evaluate(prompt, { ...(evalOptions ?? {}), rateLimitWaitMs: jittered });
                         this.opts.onResolved?.(component ?? '(none)', framework); // recovered on backoff → auto-resolve
                         return boResult;
                     }
@@ -818,12 +862,12 @@ export class IntelligenceRouter {
                     }
                 }
             }
-            if (swapTargets.length === 0) {
+            if (swapPositions.length === 0) {
                 // RUNG (c) — DEFERRABLE queue: no swap configured, but a deferrable call can WAIT for capacity
                 // in the LlmQueue before dropping to its heuristic. gating can never reach here (deferrable =
                 // !gating && …) — the D5 queue-skip invariant is structural.
                 if (deferrable) {
-                    const q = await this.tryDeferrableQueue(primary, prompt, options, component ?? '(none)', framework, category);
+                    const q = await this.tryDeferrableQueue(primary, prompt, evalOptions, component ?? '(none)', framework, category);
                     if (q.ok)
                         return q.result;
                 }
@@ -850,7 +894,8 @@ export class IntelligenceRouter {
             const budgetMs = isValidMs(this.opts.swapTotalBudgetMs) ? this.opts.swapTotalBudgetMs : undefined;
             const monotonicNow = this.opts.monotonicNow ?? (() => performance.now());
             const swapStartedAt = monotonicNow();
-            for (const target of swapTargets) {
+            for (const t of swapPositions) {
+                const target = t.door;
                 // GATING budget: if the awaited gate's total wall-clock budget is consumed, stop swapping
                 // and fail closed now (responsiveness over completeness — spec §3a). Deferrable calls have
                 // no such deadline (gatingDeadlineAt is undefined for them).
@@ -873,30 +918,46 @@ export class IntelligenceRouter {
                     // otherwise-UNcapped attempt (no per-target cap, global ≤0/unset).
                     cap = cap === undefined ? remaining : Math.min(cap, remaining);
                 }
-                // SAFETY (S2, R1/R2): a bounded/gating swap onto claude-code that requests
-                // the `capable` tier would resolve to Opus-via-Claude-CLI — the measured-banned
-                // door (81.7% vs 99.1% API). Clamp it down to `balanced` (Sonnet CLI reserve).
-                // Only ever narrows a dangerous fallback; never upgrades/blocks a call.
-                const { model: clampedModel, clamped: modelClamped } = clampClaudeCliSwapModel(target, options?.model);
-                if (modelClamped) {
-                    this.opts.onDegrade?.({
-                        component: component ?? '(none)',
-                        category,
-                        from: framework,
-                        to: target,
-                        reason: `failure-swap-model-clamp: '${target}' capable→balanced ` +
-                            `(Opus-via-Claude-CLI is banned for bounded/gating verdicts — R1/R2)`,
-                    });
+                // Model for this swap attempt:
+                //  - NATURE-enforced position (`t.model` set): its OWN concrete model id, already
+                //    reserve-clamped by the resolver (`clampToReserveOnCleanDoor`) — so it always
+                //    overrides the base options.model, and the A1 tier-clamp below is a no-op on it.
+                //  - LEGACY position (`t.model` undefined): the caller's tier, clamped per SAFETY
+                //    (S2, R1/R2) — a bounded/gating swap onto claude-code requesting `capable` would
+                //    resolve to Opus-via-Claude-CLI (the measured-banned door, 81.7% vs 99.1%); clamp
+                //    it down to `balanced` (Sonnet CLI reserve). Only ever narrows; never upgrades.
+                let attemptModel;
+                let overrideModel;
+                if (t.model !== undefined) {
+                    attemptModel = t.model;
+                    overrideModel = true;
+                }
+                else {
+                    const clamp = clampClaudeCliSwapModel(target, options?.model);
+                    attemptModel = clamp.model;
+                    overrideModel = clamp.clamped;
+                    if (clamp.clamped) {
+                        this.opts.onDegrade?.({
+                            component: component ?? '(none)',
+                            category,
+                            from: framework,
+                            to: target,
+                            reason: `failure-swap-model-clamp: '${target}' capable→balanced ` +
+                                `(Opus-via-Claude-CLI is banned for bounded/gating verdicts — R1/R2)`,
+                        });
+                    }
                 }
                 // Pass the cap through as the provider's per-call timeout so the subprocess
                 // self-terminates at the bound (no AbortSignal exists on IntelligenceOptions).
-                const attemptOptions = cap !== undefined || modelClamped
+                // Base is `evalOptions` (byte-identical to `options` on the legacy path); an enforced
+                // position's model always overrides it below.
+                const attemptOptions = cap !== undefined || overrideModel
                     ? {
-                        ...(options ?? {}),
+                        ...(evalOptions ?? {}),
                         ...(cap !== undefined ? { timeoutMs: cap } : {}),
-                        ...(modelClamped ? { model: clampedModel } : {}),
+                        ...(overrideModel ? { model: attemptModel } : {}),
                     }
-                    : options;
+                    : evalOptions;
                 try {
                     // withSwapTimeout keeps the shipped, crash-safe Promise.race pattern
                     // (InputGuard precedent): it attaches a settlement handler to EACH input,
@@ -938,7 +999,7 @@ export class IntelligenceRouter {
             // for capacity in the LlmQueue before dropping to its heuristic (the gentle order, §3b.3). A
             // gating call NEVER reaches here (deferrable = !gating && …) — D5 queue-skip is structural.
             if (deferrable) {
-                const q = await this.tryDeferrableQueue(primary, prompt, options, component ?? '(none)', framework, category);
+                const q = await this.tryDeferrableQueue(primary, prompt, evalOptions, component ?? '(none)', framework, category);
                 if (q.ok)
                     return q.result;
             }