@warmdrift/kgauto-compiler 2.0.0-alpha.83 → 2.0.0-alpha.85

package/dist/{chunk-VVRDFE6T.mjs → chunk-FD3NFXDC.mjs}

@@ -1666,6 +1666,9 @@ function _setProfileBrainHook(hook) {
 function canonicalId(id) {
   return brainHook.resolveAlias?.(id) ?? ALIASES[id] ?? id;
 }
+function resolveModelAlias(id) {
+  return canonicalId(id);
+}
 var PROFILE_INDEX = new Map(
   PROFILES_RAW.map((p) => [p.id, p])
 );
@@ -1699,6 +1702,7 @@ export {
   latencyTierOf,
   ALIASES,
   _setProfileBrainHook,
+  resolveModelAlias,
   getProfile,
   tryGetProfile,
   allProfiles,

package/dist/{chunk-XPD4I3Q5.mjs → chunk-LO2JXTGG.mjs}

@@ -1,7 +1,8 @@
 import {
   allProfiles,
+  resolveModelAlias,
   tryGetProfile
-} from "./chunk-VVRDFE6T.mjs";
+} from "./chunk-FD3NFXDC.mjs";
 
 // src/brain-query.ts
 var FRESH_SNAPSHOT = {
@@ -407,6 +408,17 @@ function isSameModelRetryEnabledFromEnv(envSource = defaultEnv()) {
   return raw === "1" || raw === "true";
 }
 
+// src/policy-match.ts
+function canonicalPolicySet(ids) {
+  const set = /* @__PURE__ */ new Set();
+  for (const id of ids ?? []) set.add(resolveModelAlias(id));
+  return set;
+}
+function policySetHas(set, modelId) {
+  if (set.size === 0) return false;
+  return set.has(resolveModelAlias(modelId));
+}
+
 // src/fallback.ts
 var COST_RANKING_REFERENCE_SHAPE = {
   inputTokens: 4e3,
@@ -599,8 +611,8 @@ function getDefaultFallbackChain(opts) {
     chain = [...starter];
   }
   if (policy?.blockedModels && policy.blockedModels.length > 0) {
-    const blocked = new Set(policy.blockedModels);
-    chain = chain.filter((id) => !blocked.has(id));
+    const blocked = canonicalPolicySet(policy.blockedModels);
+    chain = chain.filter((id) => !policySetHas(blocked, id));
   }
   const seen = /* @__PURE__ */ new Set();
   const deduped = [];
@@ -703,8 +715,8 @@ function getDefaultFallbackChainWithGrounding(opts) {
     chain = [...starter];
   }
   if (policy?.blockedModels && policy.blockedModels.length > 0) {
-    const blocked = new Set(policy.blockedModels);
-    chain = chain.filter((e) => !blocked.has(e.id));
+    const blocked = canonicalPolicySet(policy.blockedModels);
+    chain = chain.filter((e) => !policySetHas(blocked, e.id));
   }
   const seen = /* @__PURE__ */ new Set();
   const deduped = [];
@@ -803,6 +815,8 @@ export {
   ARCHETYPE_FLOOR_DEFAULT,
   ABSOLUTE_FLOOR,
   getModelCompatibility,
+  canonicalPolicySet,
+  policySetHas,
   loadArchetypePerfFromBrain,
   loadArchetypePerfNFromBrain,
   MEASURED_GROUNDING_MIN_N,

package/dist/{chunk-QEFIAAE7.mjs → chunk-WXN7FNXP.mjs}

@@ -1,5 +1,5 @@
 // src/version.ts
-var LIBRARY_VERSION = "2.0.0-alpha.83";
+var LIBRARY_VERSION = "2.0.0-alpha.85";
 
 // src/key-health.ts
 var JSON_HEADERS = { "Content-Type": "application/json" };

package/dist/glassbox/index.d.mts

@@ -1,6 +1,6 @@
-import { G as GlassboxEvent } from '../types-CRXaR7nJ.mjs';
-export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-CRXaR7nJ.mjs';
-import '../ir-D4S9R816.mjs';
+import { G as GlassboxEvent } from '../types-y42mwdvM.mjs';
+export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-y42mwdvM.mjs';
+import '../ir-JUoybVM-.mjs';
 import '../dialect.mjs';
 
 /**

package/dist/glassbox/index.d.ts

@@ -1,6 +1,6 @@
-import { G as GlassboxEvent } from '../types-CAs9-0S4.js';
-export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-CAs9-0S4.js';
-import '../ir-Cx9hJj0B.js';
+import { G as GlassboxEvent } from '../types-BqTKRECa.js';
+export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-BqTKRECa.js';
+import '../ir-DfrM71pA.js';
 import '../dialect.js';
 
 /**

package/dist/glassbox-routes/format.d.mts

@@ -1,5 +1,5 @@
-import { T as TraceHealth } from '../types-DHi4FcUu.mjs';
-import '../ir-D4S9R816.mjs';
+import { T as TraceHealth } from '../types-BGH_KAHu.mjs';
+import '../ir-JUoybVM-.mjs';
 import '../dialect.mjs';
 
 /**

package/dist/glassbox-routes/format.d.ts

@@ -1,5 +1,5 @@
-import { T as TraceHealth } from '../types-Cvd6kRNv.js';
-import '../ir-Cx9hJj0B.js';
+import { T as TraceHealth } from '../types-DLDJbCha.js';
+import '../ir-DfrM71pA.js';
 import '../dialect.js';
 
 /**

package/dist/glassbox-routes/index.d.mts

@@ -1,7 +1,7 @@
-import { G as GlassboxEvent } from '../types-CRXaR7nJ.mjs';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-DHi4FcUu.mjs';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-DHi4FcUu.mjs';
-import '../ir-D4S9R816.mjs';
+import { G as GlassboxEvent } from '../types-y42mwdvM.mjs';
+import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-BGH_KAHu.mjs';
+export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-BGH_KAHu.mjs';
+import '../ir-JUoybVM-.mjs';
 import '../dialect.mjs';
 
 /**

package/dist/glassbox-routes/index.d.ts

@@ -1,7 +1,7 @@
-import { G as GlassboxEvent } from '../types-CAs9-0S4.js';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-Cvd6kRNv.js';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-Cvd6kRNv.js';
-import '../ir-Cx9hJj0B.js';
+import { G as GlassboxEvent } from '../types-BqTKRECa.js';
+import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-DLDJbCha.js';
+export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-DLDJbCha.js';
+import '../ir-DfrM71pA.js';
 import '../dialect.js';
 
 /**

package/dist/glassbox-routes/index.js

@@ -1717,6 +1717,9 @@ var brainHook = {};
 function canonicalId(id) {
   return brainHook.resolveAlias?.(id) ?? ALIASES[id] ?? id;
 }
+function resolveModelAlias(id) {
+  return canonicalId(id);
+}
 var PROFILE_INDEX = new Map(
   PROFILES_RAW.map((p) => [p.id, p])
 );
@@ -1891,6 +1894,17 @@ var loadChainsFromBrain = createBrainQueryCache({
   bundledFallback: getAllStarterChains
 });
 
+// src/policy-match.ts
+function canonicalPolicySet(ids) {
+  const set = /* @__PURE__ */ new Set();
+  for (const id of ids ?? []) set.add(resolveModelAlias(id));
+  return set;
+}
+function policySetHas(set, modelId) {
+  if (set.size === 0) return false;
+  return set.has(resolveModelAlias(modelId));
+}
+
 // src/archetype-perf-brain.ts
 function isPerfRow(x) {
   if (!x || typeof x !== "object") return false;
@@ -2135,8 +2149,8 @@ function getDefaultFallbackChain(opts) {
     chain = [...starter];
   }
   if (policy?.blockedModels && policy.blockedModels.length > 0) {
-    const blocked = new Set(policy.blockedModels);
-    chain = chain.filter((id) => !blocked.has(id));
+    const blocked = canonicalPolicySet(policy.blockedModels);
+    chain = chain.filter((id) => !policySetHas(blocked, id));
   }
   const seen = /* @__PURE__ */ new Set();
   const deduped = [];

package/dist/glassbox-routes/index.mjs

@@ -1,10 +1,10 @@
 import {
   ARCHETYPE_FLOOR_DEFAULT,
   getDefaultFallbackChain
-} from "../chunk-XPD4I3Q5.mjs";
+} from "../chunk-LO2JXTGG.mjs";
 import {
   tryGetProfile
-} from "../chunk-VVRDFE6T.mjs";
+} from "../chunk-FD3NFXDC.mjs";
 import {
   subscribe,
   subscribeApp

package/dist/glassbox-routes/react/index.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { a as TraceDetail } from '../../types-DHi4FcUu.mjs';
-import '../../ir-D4S9R816.mjs';
+import { a as TraceDetail } from '../../types-BGH_KAHu.mjs';
+import '../../ir-JUoybVM-.mjs';
 import '../../dialect.mjs';
 
 /**

package/dist/glassbox-routes/react/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { a as TraceDetail } from '../../types-Cvd6kRNv.js';
-import '../../ir-Cx9hJj0B.js';
+import { a as TraceDetail } from '../../types-DLDJbCha.js';
+import '../../ir-DfrM71pA.js';
 import '../../dialect.js';
 
 /**

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, F as FallbackReason, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-D4S9R816.mjs';
-export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as hasMutation, K as mutationId, L as parseGoldenCaptureRate, Q as resolveGoldenCaptureRate, U as shouldCaptureGolden } from './ir-D4S9R816.mjs';
+import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, F as FallbackReason, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-JUoybVM-.mjs';
+export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as hasMutation, K as mutationId, L as parseGoldenCaptureRate, Q as resolveGoldenCaptureRate, U as shouldCaptureGolden } from './ir-JUoybVM-.mjs';
 import { ModelProfile, ArchetypeConvention } from './profiles.mjs';
-export { ALIASES, CacheStrategy, CliffRule, LATENCY_TIER_MS, LatencyTier, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, latencyTierOf, profilesByProvider, tryGetProfile } from './profiles.mjs';
+export { ALIASES, CacheStrategy, CliffRule, LATENCY_TIER_MS, LatencyTier, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, latencyTierOf, profilesByProvider, resolveModelAlias, tryGetProfile } from './profiles.mjs';
 export { BrainForwardConfig, BrainForwardRoutes, createBrainForwardRoutes } from './brain-proxy.mjs';
 export { KEY_FINGERPRINT_DOMAIN, KEY_FINGERPRINT_LENGTH, KeyHealthConfig, KeyHealthProvider, KeyHealthResponseBody, KeyHealthResult, KeyHealthRoute, createKeyHealthRoute, keyFingerprint } from './key-health.mjs';
 import { IntentArchetypeName, OutputMode } from './dialect.mjs';
@@ -1226,7 +1226,7 @@ declare function runStrategyEvalWithAttribution(opts: Omit<GoldenEvalOptions, 'a
  * guard in `tests/version.test.ts` fails the suite (and therefore
  * `prepublishOnly`) when they diverge — a stale constant cannot reach npm.
  */
-declare const LIBRARY_VERSION = "2.0.0-alpha.83";
+declare const LIBRARY_VERSION = "2.0.0-alpha.85";
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.
@@ -1645,6 +1645,218 @@ declare function deriveOwnership(code: string, selfDeclared?: 'consumer-actionab
  */
 declare function runAdvisor(ir: PromptIR, result: AdvisorContext, profile: ModelProfile, policy?: CompilePolicy, phase2?: RunAdvisorPhase2Context): BestPracticeAdvisory[];
 
+/**
+ * promote-ready-brain — alpha.41 substrate.
+ *
+ * Per-tenant SWR cache for the `promote_ready_findings` table populated by
+ * the autonomous `promotion-probe-watcher` (Mode 2). Mirrors
+ * `exclusion-findings-brain.ts` shape byte-for-byte where applicable; this
+ * is the read-side substrate for the compile-time `promote-ready` advisor
+ * rule.
+ *
+ * Architecture (mirror of exclusion-findings-brain):
+ *
+ * - **Sync API surface.** `getPromoteReadyFindings({ appId, archetype,
+ *   family })` returns `PromoteReadyFindingRow[]` immediately. First call
+ *   returns the bundled fallback (empty array); async refresh fires in
+ *   background; subsequent calls within TTL return brain data.
+ *
+ * - **Per-appId snapshot.** Each appId gets its own cache entry. One fetch
+ *   per appId per TTL window. Tests reset between cases via
+ *   `_testResetPromoteReadyFindings()`.
+ *
+ * - **Tolerant.** Brain down / endpoint misconfigured / unexpected shape →
+ *   silent bundled fallback (empty array). Never throws. Warns once per
+ *   process per error to avoid log spam.
+ *
+ * - **Opt-in.** Activation gated on `configurePromoteReadyBrain()` having
+ *   been called with a runtime. The public `configureBrain()` in brain.ts
+ *   wires this up automatically when
+ *   `BrainConfig.brainQuery.findingsPromoteReady !== false`.
+ *
+ * Plus: `markPromoteReadyHandled` — direct PostgREST PATCH against the
+ * brain (no kgauto proxy). Mirrors `markExclusionFindingHandled` shape
+ * byte-for-byte. Idempotent on `resolved_at=is.null` filter.
+ *
+ * Default endpoint:
+ *   `https://kgauto-dashboard.vercel.app/api/kgauto-v2/findings/promote-ready`
+ *   The route accepts `?app_id=X` and returns a JSON array of findings
+ *   for that app filtered to `resolved_at IS NULL`.
+ */
+
+/**
+ * Shape of one row from the `promote_ready_findings` cache table. Mirrors
+ * the snake_case JSONB returned by the brain endpoint, mapped to camelCase
+ * at the boundary (rowToFinding) so the in-memory shape stays consistent
+ * with the rest of the library.
+ */
+interface PromoteReadyFindingRow {
+    /** Intent archetype the finding applies to. */
+    archetype: string;
+    /** Model family (e.g. 'claude-opus', 'gemini-flash'). */
+    family: string;
+    /** The candidate model that the probe validated. */
+    candidateModel: string;
+    /** The current production model the candidate was compared against. */
+    currentModel: string;
+    /** Sample size of the probe run (typically 10). */
+    sampleN: number;
+    /** Fraction of probes where the judge verdict was 'candidate-better' or
+     *  'tied'. 0.000 to 1.000. */
+    judgePassRate: number;
+    /** Mean judge score across the probe sample. 1.00 to 5.00. */
+    judgeAvgScore: number;
+    /** Signed cost delta as a fraction (negative = candidate is cheaper).
+     *  Null when pricing data was incomplete at probe time. */
+    costDeltaPct: number | null;
+    /** ISO timestamp of detection (when the probe wrote the row). */
+    detectedAt: string;
+}
+/**
+ * Resolution sources supported by alpha.41 `markPromoteReadyHandled`. The
+ * three values map to the three CHECK-constrained resolution values on
+ * `promote_ready_findings.resolution`:
+ *
+ * - `'promoted'`         — consumer migrated to the candidate model. Strong
+ *                          positive signal; the probe was right.
+ * - `'declined'`         — consumer evaluated and chose not to promote.
+ *                          Strong negative signal; revisit only on new
+ *                          family entries or material score swings.
+ * - `'still-evaluating'` — consumer acknowledges the finding but defers
+ *                          the decision. Acknowledges-without-deciding;
+ *                          finding silences this cycle but next probe may
+ *                          re-surface.
+ */
+type PromoteReadyResolution = 'promoted' | 'declined' | 'still-evaluating';
+interface MarkPromoteReadyHandledOptions {
+    /** App id the finding belongs to. Required (RLS scopes writes by this). */
+    appId: string;
+    /** Archetype the finding applies to (e.g. 'hunt', 'classify'). */
+    archetype: IntentArchetypeName | string;
+    /** Model family the finding applies to (e.g. 'claude-opus'). */
+    family: string;
+    /** Resolution semantics — see `PromoteReadyResolution`. */
+    resolution: PromoteReadyResolution;
+    /** Optional free-form note explaining the decision. */
+    resolutionNote?: string;
+    /** Brain Supabase URL base (e.g. `https://<project>.supabase.co`). */
+    brainEndpoint: string;
+    /** Consumer-scoped JWT carrying the `app_id` claim. */
+    brainJwt: string;
+    /** Supabase anon key for the `apikey` header. */
+    brainAnonKey: string;
+    /** Injected fetch for tests. Defaults to global fetch. */
+    fetch?: typeof fetch;
+}
+/**
+ * Mark a probe-validated promote-ready finding as handled. Returns an
+ * `ok/reason` envelope matching `markExclusionFindingHandled`.
+ *
+ * Idempotent: if no row matches the (app_id, archetype, family) tuple
+ * (already resolved, never existed, watcher not yet UPSERTed), PostgREST
+ * returns 200/204 with zero affected rows and we return `{ ok: true }`.
+ *
+ * Reasons surfaced on failure:
+ *   - `app_id_required` / `archetype_required` / `family_required`
+ *   - `resolution_invalid` — not one of the three documented values
+ *   - `brain_auth_misconfig` — 401/403
+ *   - `brain_unavailable` — 5xx
+ *   - `network_error:<message>` — fetch threw
+ *   - `patch_failed:<status>` — anything else non-2xx
+ */
+declare function markPromoteReadyHandled(opts: MarkPromoteReadyHandledOptions): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+}>;
+
+/**
+ * blocked-model-drift — advisor rule for the two ways a consumer's
+ * `CompilePolicy.blockedModels` can stop meaning what the consumer meant,
+ * without anything anywhere reporting a problem.
+ *
+ * ── The incidents this is grounded in (tt-intel s113 + s119) ─────────────
+ *
+ * (Correction, s83: an earlier draft cited "claude-sonnet-5 served 30% of
+ * tt-intel's ask traffic" as the motivating incident. That number was a
+ * FOSSIL — tt-intel's own L-188 traced all 11 calls to a 29-second burst
+ * from their own prior spend-gate experiment, fixed minutes later, and
+ * their block was in fact working. Do not resurrect it.)
+ *
+ * The real, verified incidents:
+ *
+ * 1. alpha.72 retargeted the curated `claude-sonnet` family primary from
+ *    `claude-sonnet-4-6` (now `legacy`) to `claude-sonnet-5` (now
+ *    `current`), and tt-intel's literal-id gate STOPPED MATCHING the
+ *    family's routed traffic — their s113 response was to build
+ *    consumer-side family→concrete-id resolution (`parseBlockedModels`)
+ *    before ids reach kgauto. Every consumer without that local machinery
+ *    is exposed to the same silent retarget: `blockedModels` is matched by
+ *    exact id, so a block written against yesterday's primary says nothing
+ *    about today's.
+ *
+ * 2. tt-intel s119 (2026-07-29 filing): a blocked model SERVED when an
+ *    unblocked ALIAS of it sat in the candidate set (`deepseek-chat` ≡
+ *    `deepseek-v4-flash`). That one was a kgauto correctness bug, fixed in
+ *    alpha.85 by canonical matching (`policy-match.ts`) — but it proved
+ *    the class: a block-list meaning drifts whenever the roster's id
+ *    surface moves under it, and no layer errors.
+ *
+ * ── What this rule is NOT ────────────────────────────────────────────────
+ *
+ * It does not change matching semantics. Exact-ID matching is arguably the
+ * correct contract: family-glob matching would silently widen every
+ * existing consumer's block-list, which is a breaking semantic change and
+ * not kgauto's to make unilaterally. The gap here is silence, not
+ * semantics — so the fix is a signal, not a behavior change. Selection is
+ * untouched; a consumer who blocked one exact id still gets exactly that
+ * id blocked and nothing else.
+ *
+ * ── The two branches ─────────────────────────────────────────────────────
+ *
+ * (a) `blocked-model-not-in-roster` — a `blockedModels` entry resolves to
+ *     no model in the current roster (after alias resolution). The block is
+ *     inert: it can never match anything. Causes are a typo, a model
+ *     retired out of the roster, or a stale env var carried forward. There
+ *     is no reading under which an entry matching nothing is what the
+ *     consumer wanted, so this is unambiguous.
+ *
+ * (b) `blocked-model-family-sibling-served` — the model selected for THIS
+ *     call is in the same family as a blocked entry but is a different
+ *     exact id. This is the tt-intel shape. Unlike (a) it IS ambiguous:
+ *     "block `claude-sonnet-4-6` specifically, `claude-sonnet-5` is fine"
+ *     is a legitimate and common intent. So the message states both
+ *     readings and says how to act on either. It escalates its wording —
+ *     not its level — when the blocked sibling is `legacy`/`deprecated` and
+ *     the served sibling is `current`, because that combination is the
+ *     signature of a roster lifecycle move rather than a deliberate
+ *     per-generation block.
+ *
+ * Both fire at `warn`, and both fire regardless of `policy.posture`.
+ * `posture: 'locked'` means "do not recommend models to me" — these are not
+ * recommendations, they are reports that the consumer's own declared
+ * constraint is not doing what its author expects. Same reasoning as the
+ * alpha.28 `archetype-perf-floor-breach` cliff advisor, which is also
+ * posture-independent because it reports a structural fact rather than a
+ * preference.
+ *
+ * Companion watcher: `v2/scripts/blocked-model-drift-watch.mjs` rolls the
+ * same two branches up across a consumer's recent traffic from the brain,
+ * so the signal survives a consumer who never reads `result.advisories[]`.
+ *
+ * L-073 family ("no errors = healthy"): as with DeepSeek's `deepseek-chat`
+ * compat alias and the alpha.47/.43 field-drop chain, nothing errored,
+ * nothing 404'd, latency did not move — and the cached intent was wrong for
+ * an unknown duration. The detection loop has to be built deliberately
+ * because the failure emits no natural signal.
+ */
+
+/** Stable rule code — branch (a). Written to `compile_outcome_advisories.code`. */
+declare const BLOCKED_MODEL_NOT_IN_ROSTER_CODE = "blocked-model-not-in-roster";
+/** Stable rule code — branch (b). Written to `compile_outcome_advisories.code`. */
+declare const BLOCKED_MODEL_FAMILY_SIBLING_SERVED_CODE = "blocked-model-family-sibling-served";
+
 /**
  * Translator primitive — alpha.31.
  *
@@ -3241,132 +3453,6 @@ declare function deriveFamilyFromModelId(modelId: string): string | null;
  */
 declare function getRecommendedPrimary(opts: GetRecommendedPrimaryOptions): string;
 
-/**
- * promote-ready-brain — alpha.41 substrate.
- *
- * Per-tenant SWR cache for the `promote_ready_findings` table populated by
- * the autonomous `promotion-probe-watcher` (Mode 2). Mirrors
- * `exclusion-findings-brain.ts` shape byte-for-byte where applicable; this
- * is the read-side substrate for the compile-time `promote-ready` advisor
- * rule.
- *
- * Architecture (mirror of exclusion-findings-brain):
- *
- * - **Sync API surface.** `getPromoteReadyFindings({ appId, archetype,
- *   family })` returns `PromoteReadyFindingRow[]` immediately. First call
- *   returns the bundled fallback (empty array); async refresh fires in
- *   background; subsequent calls within TTL return brain data.
- *
- * - **Per-appId snapshot.** Each appId gets its own cache entry. One fetch
- *   per appId per TTL window. Tests reset between cases via
- *   `_testResetPromoteReadyFindings()`.
- *
- * - **Tolerant.** Brain down / endpoint misconfigured / unexpected shape →
- *   silent bundled fallback (empty array). Never throws. Warns once per
- *   process per error to avoid log spam.
- *
- * - **Opt-in.** Activation gated on `configurePromoteReadyBrain()` having
- *   been called with a runtime. The public `configureBrain()` in brain.ts
- *   wires this up automatically when
- *   `BrainConfig.brainQuery.findingsPromoteReady !== false`.
- *
- * Plus: `markPromoteReadyHandled` — direct PostgREST PATCH against the
- * brain (no kgauto proxy). Mirrors `markExclusionFindingHandled` shape
- * byte-for-byte. Idempotent on `resolved_at=is.null` filter.
- *
- * Default endpoint:
- *   `https://kgauto-dashboard.vercel.app/api/kgauto-v2/findings/promote-ready`
- *   The route accepts `?app_id=X` and returns a JSON array of findings
- *   for that app filtered to `resolved_at IS NULL`.
- */
-
-/**
- * Shape of one row from the `promote_ready_findings` cache table. Mirrors
- * the snake_case JSONB returned by the brain endpoint, mapped to camelCase
- * at the boundary (rowToFinding) so the in-memory shape stays consistent
- * with the rest of the library.
- */
-interface PromoteReadyFindingRow {
-    /** Intent archetype the finding applies to. */
-    archetype: string;
-    /** Model family (e.g. 'claude-opus', 'gemini-flash'). */
-    family: string;
-    /** The candidate model that the probe validated. */
-    candidateModel: string;
-    /** The current production model the candidate was compared against. */
-    currentModel: string;
-    /** Sample size of the probe run (typically 10). */
-    sampleN: number;
-    /** Fraction of probes where the judge verdict was 'candidate-better' or
-     *  'tied'. 0.000 to 1.000. */
-    judgePassRate: number;
-    /** Mean judge score across the probe sample. 1.00 to 5.00. */
-    judgeAvgScore: number;
-    /** Signed cost delta as a fraction (negative = candidate is cheaper).
-     *  Null when pricing data was incomplete at probe time. */
-    costDeltaPct: number | null;
-    /** ISO timestamp of detection (when the probe wrote the row). */
-    detectedAt: string;
-}
-/**
- * Resolution sources supported by alpha.41 `markPromoteReadyHandled`. The
- * three values map to the three CHECK-constrained resolution values on
- * `promote_ready_findings.resolution`:
- *
- * - `'promoted'`         — consumer migrated to the candidate model. Strong
- *                          positive signal; the probe was right.
- * - `'declined'`         — consumer evaluated and chose not to promote.
- *                          Strong negative signal; revisit only on new
- *                          family entries or material score swings.
- * - `'still-evaluating'` — consumer acknowledges the finding but defers
- *                          the decision. Acknowledges-without-deciding;
- *                          finding silences this cycle but next probe may
- *                          re-surface.
- */
-type PromoteReadyResolution = 'promoted' | 'declined' | 'still-evaluating';
-interface MarkPromoteReadyHandledOptions {
-    /** App id the finding belongs to. Required (RLS scopes writes by this). */
-    appId: string;
-    /** Archetype the finding applies to (e.g. 'hunt', 'classify'). */
-    archetype: IntentArchetypeName | string;
-    /** Model family the finding applies to (e.g. 'claude-opus'). */
-    family: string;
-    /** Resolution semantics — see `PromoteReadyResolution`. */
-    resolution: PromoteReadyResolution;
-    /** Optional free-form note explaining the decision. */
-    resolutionNote?: string;
-    /** Brain Supabase URL base (e.g. `https://<project>.supabase.co`). */
-    brainEndpoint: string;
-    /** Consumer-scoped JWT carrying the `app_id` claim. */
-    brainJwt: string;
-    /** Supabase anon key for the `apikey` header. */
-    brainAnonKey: string;
-    /** Injected fetch for tests. Defaults to global fetch. */
-    fetch?: typeof fetch;
-}
-/**
- * Mark a probe-validated promote-ready finding as handled. Returns an
- * `ok/reason` envelope matching `markExclusionFindingHandled`.
- *
- * Idempotent: if no row matches the (app_id, archetype, family) tuple
- * (already resolved, never existed, watcher not yet UPSERTed), PostgREST
- * returns 200/204 with zero affected rows and we return `{ ok: true }`.
- *
- * Reasons surfaced on failure:
- *   - `app_id_required` / `archetype_required` / `family_required`
- *   - `resolution_invalid` — not one of the three documented values
- *   - `brain_auth_misconfig` — 401/403
- *   - `brain_unavailable` — 5xx
- *   - `network_error:<message>` — fetch threw
- *   - `patch_failed:<status>` — anything else non-2xx
- */
-declare function markPromoteReadyHandled(opts: MarkPromoteReadyHandledOptions): Promise<{
-    ok: true;
-} | {
-    ok: false;
-    reason: string;
-}>;
-
 /**
  * promotions-brain — alpha.64 Stage-2 substrate.
  *
@@ -3929,4 +4015,4 @@ declare function planDecomposition(args: PlanDecompositionArgs): DecompositionPl
  */
 declare function compile(ir: PromptIR, opts?: CompileOptions): CompileResult;
 
-export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ALT_BLIND_TOKEN_BUDGET_BREACH, ALT_STRATEGY_IDS, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryEvidenceWindow, type AdvisoryResolutionSource, type AdvisorySeverity, type AdvisoryStatus, type AdvisorySuggestedFix, ApiKeys, type AppOracle, type ApplySectionRewritesArgs, type ApplySectionRewritesResult, ArchetypeConvention, type ArchetypeFamilyFit, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, type AttachCacheControlResult, BRAIN_READ_ENV_NAMES, BURST_SPAN_MS, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, COACH_CFG, COST_RANKING_REFERENCE_SHAPE, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type CreateDelegateOpts, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DELEGATE_TOOL_DEFINITION, DISCIPLINE_GATES_V1_ALT_BLIND_HEADER, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, type DelegateHandle, type DelegateRefusalReason, type DelegateResult, type DelegateToolArgs, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type ExecutorCandidate, type FallbackPosture, FallbackReason, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetMeasuredFailureOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalAxis, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenEvalStrategyId, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, type LLMJudgeOptions, MEASURED_FAILURE_CFG, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type MeasuredFailureRuntime, type MeasuredFailureVerdict, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, OutputMode, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PlannedStep, type PricingRow, type ProbeShadowOptions, type ProbeShadowServed, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, ROLLBACK_SUPPRESSION_WINDOW_DAYS, RULE_DISCIPLINE_GATES_V1, RULE_DISCIPLINE_GATES_V1_STRUCTURED, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, STRATEGY_AUTHORSHIP_INDEPENDENT, STRATEGY_AUTHORSHIP_LIMITATION, SectionRewrite, type ShadowProbeRecordInput, type StrategyAttribution, type StrategyAttributionResult, type StrategyOutcome, type SupportedProvider, type SurfaceFailureRow, type SurfaceStats, SystemModelMessage, TRANSLATOR_FLOOR, _testResetMeasuredFailure, _testResetPromotions, _testWaitForMeasuredFailureRefresh, _testWaitForPromotionsRefresh, altBlindGatesBlockFor, altGatesBlockFor, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, awaitMeasuredFailureReady, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, burstCaveat, call, chainProviderSpread, classifyEvidenceWindow, classifyStrategyOutcome, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configureMeasuredFailureBrain, configurePromotionsBrain, countTokens, createDelegate, deriveFamilyFromModelId, deriveOwnership, estimateChainCostUsd, estimateModelCostUsd, execute, findBetterFit, flushBrainDeadLetter, formatEvidenceSpan, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecentRollback, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAltStrategy, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isDelegateEnabledFromEnv, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, mapMeasuredFailureRows, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, planDecomposition, prefetchMeasuredFailure, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rowToAdvisory, rubricFor, runAdvisor, runGoldenEval, runStrategyEvalWithAttribution, setTokenizer, wilsonLowerBound, withAltBlindDisciplineContract, withAltDisciplineContract, withDisciplineContract };
+export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ALT_BLIND_TOKEN_BUDGET_BREACH, ALT_STRATEGY_IDS, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryEvidenceWindow, type AdvisoryResolutionSource, type AdvisorySeverity, type AdvisoryStatus, type AdvisorySuggestedFix, ApiKeys, type AppOracle, type ApplySectionRewritesArgs, type ApplySectionRewritesResult, ArchetypeConvention, type ArchetypeFamilyFit, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, type AttachCacheControlResult, BLOCKED_MODEL_FAMILY_SIBLING_SERVED_CODE, BLOCKED_MODEL_NOT_IN_ROSTER_CODE, BRAIN_READ_ENV_NAMES, BURST_SPAN_MS, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, COACH_CFG, COST_RANKING_REFERENCE_SHAPE, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type CreateDelegateOpts, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DELEGATE_TOOL_DEFINITION, DISCIPLINE_GATES_V1_ALT_BLIND_HEADER, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, type DelegateHandle, type DelegateRefusalReason, type DelegateResult, type DelegateToolArgs, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type ExecutorCandidate, type FallbackPosture, FallbackReason, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetMeasuredFailureOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalAxis, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenEvalStrategyId, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, type LLMJudgeOptions, MEASURED_FAILURE_CFG, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type MeasuredFailureRuntime, type MeasuredFailureVerdict, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, OutputMode, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PlannedStep, type PricingRow, type ProbeShadowOptions, type ProbeShadowServed, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, ROLLBACK_SUPPRESSION_WINDOW_DAYS, RULE_DISCIPLINE_GATES_V1, RULE_DISCIPLINE_GATES_V1_STRUCTURED, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, STRATEGY_AUTHORSHIP_INDEPENDENT, STRATEGY_AUTHORSHIP_LIMITATION, SectionRewrite, type ShadowProbeRecordInput, type StrategyAttribution, type StrategyAttributionResult, type StrategyOutcome, type SupportedProvider, type SurfaceFailureRow, type SurfaceStats, SystemModelMessage, TRANSLATOR_FLOOR, _testResetMeasuredFailure, _testResetPromotions, _testWaitForMeasuredFailureRefresh, _testWaitForPromotionsRefresh, altBlindGatesBlockFor, altGatesBlockFor, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, awaitMeasuredFailureReady, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, burstCaveat, call, chainProviderSpread, classifyEvidenceWindow, classifyStrategyOutcome, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configureMeasuredFailureBrain, configurePromotionsBrain, countTokens, createDelegate, deriveFamilyFromModelId, deriveOwnership, estimateChainCostUsd, estimateModelCostUsd, execute, findBetterFit, flushBrainDeadLetter, formatEvidenceSpan, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecentRollback, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAltStrategy, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isDelegateEnabledFromEnv, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, mapMeasuredFailureRows, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, planDecomposition, prefetchMeasuredFailure, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rowToAdvisory, rubricFor, runAdvisor, runGoldenEval, runStrategyEvalWithAttribution, setTokenizer, wilsonLowerBound, withAltBlindDisciplineContract, withAltDisciplineContract, withDisciplineContract };