@warmdrift/kgauto-compiler 2.0.0-alpha.41 → 2.0.0-alpha.43

package/dist/index.mjs

@@ -31,8 +31,9 @@ import {
   isModelReachable,
   isProviderReachable,
   loadChainsFromBrain,
+  readBrainReadEnv,
   resolveProviderKey
-} from "./chunk-XJZRDGHF.mjs";
+} from "./chunk-6MSJQCAP.mjs";
 import {
   ALIASES,
   _setProfileBrainHook,
@@ -41,7 +42,7 @@ import {
   getProfile,
   profilesByProvider,
   tryGetProfile
-} from "./chunk-JQGRWJZO.mjs";
+} from "./chunk-ZHUD3I52.mjs";
 import {
   emitAdvisoryFired,
   emitCompileDone,
@@ -51,123 +52,497 @@ import {
   emitFallbackWalked
 } from "./chunk-NBO4R5PC.mjs";
 
-// src/tokenizer.ts
-var tokenizerImpl = defaultCharBasedCounter;
-function defaultCharBasedCounter(text) {
-  if (!text) return 0;
-  return Math.max(1, Math.ceil(text.length / 4));
-}
-function setTokenizer(impl) {
-  tokenizerImpl = impl;
+// src/models-brain.ts
+function isModelRow(x) {
+  if (!x || typeof x !== "object") return false;
+  const r = x;
+  return typeof r.model_id === "string" && typeof r.provider === "string";
 }
-function resetTokenizer() {
-  tokenizerImpl = defaultCharBasedCounter;
+function isAliasRow(x) {
+  if (!x || typeof x !== "object") return false;
+  const r = x;
+  return typeof r.alias_id === "string" && typeof r.canonical_id === "string";
 }
-function countTokens(text) {
-  if (!text) return 0;
+function rowToProfile(row) {
   try {
-    const n = tokenizerImpl(text);
-    return Number.isFinite(n) && n >= 0 ? n : defaultCharBasedCounter(text);
+    if (row.cliffs !== void 0 && row.cliffs !== null && !Array.isArray(row.cliffs)) {
+      return null;
+    }
+    if (row.recovery !== void 0 && row.recovery !== null && !Array.isArray(row.recovery)) {
+      return null;
+    }
+    if (row.lowering !== void 0 && row.lowering !== null && (typeof row.lowering !== "object" || Array.isArray(row.lowering))) {
+      return null;
+    }
+    return {
+      id: row.model_id,
+      provider: row.provider,
+      status: row.status ?? "current",
+      maxContextTokens: row.max_context_tokens ?? 0,
+      maxOutputTokens: row.max_output_tokens ?? 0,
+      maxTools: row.max_tools ?? 0,
+      parallelToolCalls: row.parallel_tool_calls ?? false,
+      structuredOutput: row.structured_output ?? "none",
+      systemPromptMode: row.system_prompt_mode ?? "inline",
+      streaming: row.streaming ?? true,
+      cliffs: row.cliffs ?? [],
+      costInputPer1m: row.cost_input_per_1m ?? 0,
+      costOutputPer1m: row.cost_output_per_1m ?? 0,
+      lowering: row.lowering ?? { system: { mode: "inline" }, cache: { strategy: "unsupported" } },
+      recovery: row.recovery ?? [],
+      strengths: row.strengths ?? [],
+      weaknesses: row.weaknesses ?? [],
+      notes: row.notes ?? void 0,
+      verifiedAgainstDocs: row.verified_against_docs ?? void 0,
+      archetypePerf: row.archetype_perf ?? void 0,
+      // alpha.41 — family-resolution fields. `family` may be null pre-
+      // migration 024; runtime falls back to deriveFamilyFromModelId at
+      // resolution time (see family-resolution.ts, G1).
+      family: row.family ?? void 0,
+      versionAdded: row.version_added ?? void 0,
+      active: row.active ?? void 0
+    };
   } catch {
-    return defaultCharBasedCounter(text);
+    return null;
   }
 }
-function countToolTokens(tool) {
-  const namePart = countTokens(tool.name);
-  const descPart = tool.description ? countTokens(tool.description) : 0;
-  const paramPart = tool.parameters ? countTokens(JSON.stringify(tool.parameters)) : 0;
-  return namePart + descPart + paramPart + 8;
+function profileToRow(profile, opts = {}) {
+  const row = {
+    model_id: profile.id,
+    provider: profile.provider,
+    status: profile.status,
+    max_context_tokens: profile.maxContextTokens,
+    max_output_tokens: profile.maxOutputTokens,
+    max_tools: profile.maxTools,
+    parallel_tool_calls: profile.parallelToolCalls,
+    structured_output: profile.structuredOutput,
+    system_prompt_mode: profile.systemPromptMode,
+    streaming: profile.streaming,
+    cliffs: profile.cliffs,
+    cost_input_per_1m: profile.costInputPer1m,
+    cost_output_per_1m: profile.costOutputPer1m,
+    lowering: profile.lowering,
+    recovery: profile.recovery,
+    strengths: profile.strengths,
+    weaknesses: profile.weaknesses,
+    notes: profile.notes ?? null,
+    archetype_perf: profile.archetypePerf ?? null,
+    active: opts.active ?? profile.active ?? true,
+    // alpha.41 — round-trip family + version_added when present on profile.
+    // version_added is operator-controlled via opts; profile-side value is
+    // used only when opts didn't override.
+    family: profile.family ?? null
+  };
+  if (opts.verifiedAgainstDocs !== void 0) {
+    row.verified_against_docs = opts.verifiedAgainstDocs;
+  } else if (profile.verifiedAgainstDocs !== void 0) {
+    const v = profile.verifiedAgainstDocs;
+    row.verified_against_docs = /^\d{4}-\d{2}-\d{2}/.test(v) ? v : null;
+  }
+  if (opts.versionAdded !== void 0) row.version_added = opts.versionAdded;
+  else if (profile.versionAdded !== void 0) row.version_added = profile.versionAdded;
+  if (opts.versionRemoved !== void 0) row.version_removed = opts.versionRemoved;
+  return row;
 }
-function countMessagesTokens(messages) {
-  let total = 0;
-  for (const m of messages) {
-    total += countTokens(m.content) + 4;
+function mapRowsToModels(rows) {
+  const out = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    if (!isModelRow(row)) continue;
+    const profile = rowToProfile(row);
+    if (profile) out.set(profile.id, profile);
   }
-  return total;
+  return out;
+}
+function mapRowsToAliases(rows) {
+  const out = {};
+  for (const row of rows) {
+    if (!isAliasRow(row)) continue;
+    out[row.alias_id] = row.canonical_id;
+  }
+  return out;
+}
+function bundledModels() {
+  return new Map(allProfilesRaw().map((p) => [p.id, p]));
 }
+function bundledAliases() {
+  return { ...ALIASES };
+}
+var loadModelsFromBrain = createBrainQueryCache({
+  table: "kgauto_models",
+  mapRows: mapRowsToModels,
+  bundledFallback: bundledModels
+});
+var loadAliasesFromBrain = createBrainQueryCache({
+  table: "kgauto_aliases",
+  mapRows: mapRowsToAliases,
+  bundledFallback: bundledAliases
+});
+_setProfileBrainHook({
+  getProfile: (canonical) => loadModelsFromBrain().get(canonical),
+  resolveAlias: (id) => loadAliasesFromBrain()[id]
+});
 
-// src/passes.ts
-function passSlice(ir) {
-  const intent = ir.intent.archetype;
-  const before = ir.sections.length;
-  const kept = ir.sections.filter((s) => !s.intents || s.intents.length === 0 || s.intents.includes(intent));
-  const dropped = before - kept.length;
-  if (dropped === 0) return { value: ir, mutations: [] };
-  return {
-    value: { ...ir, sections: kept },
-    mutations: [
-      {
-        id: `slice-${dropped}`,
-        source: "static_pass",
-        passName: "slice",
-        description: `Dropped ${dropped} of ${before} sections not tagged for intent=${intent}`
-      }
-    ]
-  };
+// src/exclusion-findings-brain.ts
+function isValidVerdict(v) {
+  return v === "recommend-probe" || v === "unblock" || v === "stay-excluded" || v === "inconclusive";
 }
-function passDedupe(ir) {
-  const seen = /* @__PURE__ */ new Map();
-  const order = [];
-  for (const s of ir.sections) {
-    const key = simpleHash(s.text.trim());
-    if (!seen.has(key)) {
-      seen.set(key, s);
-      order.push(key);
-    }
-  }
-  const deduped = order.map((k) => seen.get(k));
-  const dropped = ir.sections.length - deduped.length;
-  if (dropped === 0) return { value: ir, mutations: [] };
-  return {
-    value: { ...ir, sections: deduped },
-    mutations: [
-      {
-        id: `dedupe-${dropped}`,
-        source: "static_pass",
-        passName: "dedupe",
-        description: `Removed ${dropped} duplicate section(s) (by text hash)`
-      }
-    ]
-  };
+function isValidConfidence(v) {
+  return v === "high" || v === "medium" || v === "low";
 }
-function passToolRelevance(ir, opts = {}) {
-  if (!ir.tools || ir.tools.length === 0) return { value: ir, mutations: [] };
-  const threshold = opts.threshold ?? 0.2;
-  const intent = ir.intent.archetype;
-  const scored = ir.tools.map((t) => {
-    const score = t.relevanceByIntent?.[intent] ?? 0.5;
-    return { tool: t, score };
-  });
-  const kept = scored.filter((s) => s.score >= threshold).sort((a, b) => b.score - a.score).map((s) => s.tool);
-  const limited = opts.maxKeep ? kept.slice(0, opts.maxKeep) : kept;
-  const dropped = ir.tools.length - limited.length;
-  if (dropped === 0) return { value: ir, mutations: [] };
-  return {
-    value: { ...ir, tools: limited },
-    mutations: [
-      {
-        id: `tool-relevance-${dropped}`,
-        source: "static_pass",
-        passName: "tool_relevance",
-        description: `Dropped ${dropped} of ${ir.tools.length} tools below relevance ${threshold} for intent=${intent}`
-      }
-    ]
-  };
+function isRawFindingRow(x) {
+  if (!x || typeof x !== "object") return false;
+  const r = x;
+  return typeof r.intent_archetype === "string" && typeof r.excluded_model === "string" && typeof r.excluded_provider === "string" && typeof r.verdict === "string" && typeof r.message === "string" && typeof r.suggestion === "string" && typeof r.confidence === "string";
 }
-function totalHistoryTokens(history) {
-  let total = 0;
-  for (const m of history) {
-    if (typeof m.content === "string") total += countTokens(m.content);
+function mapRowsToFindings(rows) {
+  const out = [];
+  for (const row of rows) {
+    if (!isRawFindingRow(row)) continue;
+    if (!isValidVerdict(row.verdict)) continue;
+    if (!isValidConfidence(row.confidence)) continue;
+    let savings = null;
+    if (typeof row.estimated_savings_usd_30d === "number") {
+      savings = Number.isFinite(row.estimated_savings_usd_30d) ? row.estimated_savings_usd_30d : null;
+    } else if (typeof row.estimated_savings_usd_30d === "string") {
+      const n = Number(row.estimated_savings_usd_30d);
+      savings = Number.isFinite(n) ? n : null;
+    }
+    out.push({
+      archetype: row.intent_archetype,
+      excludedModel: row.excluded_model,
+      excludedProvider: row.excluded_provider,
+      verdict: row.verdict,
+      estimatedSavingsUsd30d: savings,
+      message: row.message,
+      suggestion: row.suggestion,
+      confidence: row.confidence,
+      evidence: row.evidence && typeof row.evidence === "object" ? row.evidence : void 0
+    });
   }
-  return total;
+  return out;
 }
-function passCompressHistory(ir, opts = {}) {
-  const history = ir.history;
-  if (!history || history.length === 0) {
-    return { value: ir, mutations: [], historyTokensTotal: 0 };
-  }
-  const keepRecent = opts.keepRecent ?? 4;
-  const summarizeOlderThan = opts.summarizeOlderThan ?? 8;
+var snapshots = /* @__PURE__ */ new Map();
+var runtime;
+var warnedOnce = false;
+var DEFAULT_FINDINGS_ENDPOINT = "https://kgauto-dashboard.vercel.app/api/kgauto-v2/findings/exclusions";
+function configureExclusionFindingsBrain(rt) {
+  runtime = rt;
+  snapshots.clear();
+  warnedOnce = false;
+}
+function isExclusionFindingsBrainActive() {
+  return runtime !== void 0;
+}
+function getStaleExclusionFindings(opts) {
+  const rt = runtime;
+  if (!rt) return [];
+  const appId = opts.appId;
+  if (!appId) return [];
+  let snap = snapshots.get(appId);
+  if (!snap) {
+    snap = { data: [], expiresAt: 0, refreshing: false };
+    snapshots.set(appId, snap);
+  }
+  const now = Date.now();
+  const stale = snap.expiresAt <= now;
+  if (stale && !snap.refreshing) {
+    snap.refreshing = true;
+    void asyncRefresh(rt, appId);
+  }
+  if (opts.archetype) {
+    return snap.data.filter((f) => f.archetype === opts.archetype);
+  }
+  return snap.data;
+}
+var pendingRefreshes = /* @__PURE__ */ new Map();
+async function asyncRefresh(rt, appId) {
+  const promise = doRefresh(rt, appId);
+  pendingRefreshes.set(appId, promise);
+  try {
+    await promise;
+  } finally {
+    if (pendingRefreshes.get(appId) === promise) {
+      pendingRefreshes.delete(appId);
+    }
+  }
+}
+async function doRefresh(rt, appId) {
+  const url = `${rt.endpoint}?app_id=${encodeURIComponent(appId)}`;
+  let snap = snapshots.get(appId);
+  if (!snap) {
+    snap = { data: [], expiresAt: 0, refreshing: false };
+    snapshots.set(appId, snap);
+  }
+  try {
+    const res = await rt.fetchImpl(url, { method: "GET" });
+    if (!res.ok) {
+      throw new Error(`findings ${res.status}: ${res.statusText}`);
+    }
+    const body = await res.json();
+    if (runtime !== rt) return;
+    const rows = Array.isArray(body) ? mapRowsToFindings(body) : [];
+    snap.data = rows;
+    snap.expiresAt = Date.now() + rt.ttlMs;
+    snap.refreshing = false;
+  } catch (err) {
+    if (runtime !== rt) return;
+    snap.refreshing = false;
+    snap.expiresAt = Date.now() + rt.ttlMs;
+    if (!warnedOnce) {
+      warnedOnce = true;
+      (rt.onError ?? defaultOnError)(err);
+    }
+  }
+}
+function defaultOnError(err) {
+  console.warn(
+    "[kgauto] exclusion-findings fetch failed (using empty fallback):",
+    err
+  );
+}
+
+// src/family-resolution.ts
+var FamilyResolutionError = class extends Error {
+  family;
+  cause;
+  constructor(family, cause) {
+    super(
+      `Family "${family}" did not resolve to any current+active model. ${cause}. Pass a literal model id in ir.models, or call getRecommendedPrimary({ family, fallback }) at IR-construction time.`
+    );
+    this.name = "FamilyResolutionError";
+    this.family = family;
+    this.cause = cause;
+  }
+};
+function deriveFamilyFromModelId(modelId) {
+  if (typeof modelId !== "string" || modelId.length === 0) return null;
+  if (modelId.startsWith("claude-opus-")) return "claude-opus";
+  if (modelId.startsWith("claude-sonnet-")) return "claude-sonnet";
+  if (modelId.startsWith("claude-haiku-")) return "claude-haiku";
+  if (modelId.startsWith("gemini-") && modelId.includes("flash-lite")) {
+    return "gemini-flash-lite";
+  }
+  if (modelId.startsWith("gemini-") && modelId.includes("flash")) {
+    return "gemini-flash";
+  }
+  if (modelId.startsWith("gemini-") && modelId.includes("pro")) {
+    return "gemini-pro";
+  }
+  if (modelId.startsWith("deepseek-") && modelId.includes("pro")) {
+    return "deepseek-reasoner";
+  }
+  if (modelId.startsWith("deepseek-")) return "deepseek-chat";
+  if (modelId.startsWith("gpt-")) return "openai-gpt";
+  return null;
+}
+function familyOf(profile) {
+  return profile.family ?? deriveFamilyFromModelId(profile.id);
+}
+function archetypePerfFor(profile, archetype) {
+  if (!archetype) return 0;
+  const score = profile.archetypePerf?.[archetype];
+  return typeof score === "number" ? score : 5;
+}
+function selectCandidates(registry, family, archetype, appId) {
+  const out = [];
+  const excluded = /* @__PURE__ */ new Set();
+  if (appId && archetype) {
+    const findings = getStaleExclusionFindings({ appId, archetype });
+    for (const f of findings) {
+      if (f.verdict === "stay-excluded") excluded.add(f.excludedModel);
+    }
+  }
+  for (const profile of registry.values()) {
+    if (familyOf(profile) !== family) continue;
+    if (profile.status !== "current") continue;
+    if (profile.active === false) continue;
+    if (archetype) {
+      if (archetypePerfFor(profile, archetype) < ARCHETYPE_FLOOR_DEFAULT) continue;
+    }
+    if (excluded.has(profile.id)) continue;
+    out.push(profile);
+  }
+  return out;
+}
+function sortCandidates(candidates, archetype) {
+  const sorted = [...candidates];
+  sorted.sort((a, b) => {
+    const perfA = archetypePerfFor(a, archetype);
+    const perfB = archetypePerfFor(b, archetype);
+    if (perfA !== perfB) return perfB - perfA;
+    const vA = a.versionAdded ?? "";
+    const vB = b.versionAdded ?? "";
+    if (vA !== vB) return vA < vB ? 1 : -1;
+    return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+  });
+  return sorted;
+}
+function getRecommendedPrimary(opts) {
+  if (opts.posture === "locked") return opts.fallback;
+  const registry = loadModelsFromBrain();
+  const candidates = selectCandidates(
+    registry,
+    opts.family,
+    opts.archetype,
+    opts.appId
+  );
+  if (candidates.length === 0) return opts.fallback;
+  const sorted = sortCandidates(candidates, opts.archetype);
+  return sorted[0]?.id ?? opts.fallback;
+}
+function resolveFamilyEntry(family, ctx) {
+  if (typeof family !== "string" || family.length === 0) {
+    throw new FamilyResolutionError(
+      String(family),
+      "Family tag must be a non-empty string"
+    );
+  }
+  const registry = loadModelsFromBrain();
+  const candidates = selectCandidates(
+    registry,
+    family,
+    ctx.archetype,
+    ctx.appId
+  );
+  if (candidates.length === 0) {
+    let anyInFamily = false;
+    for (const profile of registry.values()) {
+      if (familyOf(profile) === family) {
+        anyInFamily = true;
+        break;
+      }
+    }
+    const cause = anyInFamily ? `Family has registered models but none are current+active${ctx.archetype ? ` at archetype-perf >= ${ARCHETYPE_FLOOR_DEFAULT} for "${ctx.archetype}"` : ""}${ctx.appId ? ` and not excluded for app "${ctx.appId}"` : ""}` : `No models in brain registry carry family="${family}". Check the taxonomy table in family-resolution.ts or migration 024`;
+    throw new FamilyResolutionError(family, cause);
+  }
+  const sorted = sortCandidates(candidates, ctx.archetype);
+  const winner = sorted[0];
+  if (!winner) {
+    throw new FamilyResolutionError(
+      family,
+      "Candidates non-empty but sort returned undefined \u2014 internal invariant violation"
+    );
+  }
+  return winner.id;
+}
+
+// src/tokenizer.ts
+var tokenizerImpl = defaultCharBasedCounter;
+function defaultCharBasedCounter(text) {
+  if (!text) return 0;
+  return Math.max(1, Math.ceil(text.length / 4));
+}
+function setTokenizer(impl) {
+  tokenizerImpl = impl;
+}
+function resetTokenizer() {
+  tokenizerImpl = defaultCharBasedCounter;
+}
+function countTokens(text) {
+  if (!text) return 0;
+  try {
+    const n = tokenizerImpl(text);
+    return Number.isFinite(n) && n >= 0 ? n : defaultCharBasedCounter(text);
+  } catch {
+    return defaultCharBasedCounter(text);
+  }
+}
+function countToolTokens(tool) {
+  const namePart = countTokens(tool.name);
+  const descPart = tool.description ? countTokens(tool.description) : 0;
+  const paramPart = tool.parameters ? countTokens(JSON.stringify(tool.parameters)) : 0;
+  return namePart + descPart + paramPart + 8;
+}
+function countMessagesTokens(messages) {
+  let total = 0;
+  for (const m of messages) {
+    total += countTokens(m.content) + 4;
+  }
+  return total;
+}
+
+// src/passes.ts
+function passSlice(ir) {
+  const intent = ir.intent.archetype;
+  const before = ir.sections.length;
+  const kept = ir.sections.filter((s) => !s.intents || s.intents.length === 0 || s.intents.includes(intent));
+  const dropped = before - kept.length;
+  if (dropped === 0) return { value: ir, mutations: [] };
+  return {
+    value: { ...ir, sections: kept },
+    mutations: [
+      {
+        id: `slice-${dropped}`,
+        source: "static_pass",
+        passName: "slice",
+        description: `Dropped ${dropped} of ${before} sections not tagged for intent=${intent}`
+      }
+    ]
+  };
+}
+function passDedupe(ir) {
+  const seen = /* @__PURE__ */ new Map();
+  const order = [];
+  for (const s of ir.sections) {
+    const key = simpleHash(s.text.trim());
+    if (!seen.has(key)) {
+      seen.set(key, s);
+      order.push(key);
+    }
+  }
+  const deduped = order.map((k) => seen.get(k));
+  const dropped = ir.sections.length - deduped.length;
+  if (dropped === 0) return { value: ir, mutations: [] };
+  return {
+    value: { ...ir, sections: deduped },
+    mutations: [
+      {
+        id: `dedupe-${dropped}`,
+        source: "static_pass",
+        passName: "dedupe",
+        description: `Removed ${dropped} duplicate section(s) (by text hash)`
+      }
+    ]
+  };
+}
+function passToolRelevance(ir, opts = {}) {
+  if (!ir.tools || ir.tools.length === 0) return { value: ir, mutations: [] };
+  const threshold = opts.threshold ?? 0.2;
+  const intent = ir.intent.archetype;
+  const scored = ir.tools.map((t) => {
+    const score = t.relevanceByIntent?.[intent] ?? 0.5;
+    return { tool: t, score };
+  });
+  const kept = scored.filter((s) => s.score >= threshold).sort((a, b) => b.score - a.score).map((s) => s.tool);
+  const limited = opts.maxKeep ? kept.slice(0, opts.maxKeep) : kept;
+  const dropped = ir.tools.length - limited.length;
+  if (dropped === 0) return { value: ir, mutations: [] };
+  return {
+    value: { ...ir, tools: limited },
+    mutations: [
+      {
+        id: `tool-relevance-${dropped}`,
+        source: "static_pass",
+        passName: "tool_relevance",
+        description: `Dropped ${dropped} of ${ir.tools.length} tools below relevance ${threshold} for intent=${intent}`
+      }
+    ]
+  };
+}
+function totalHistoryTokens(history) {
+  let total = 0;
+  for (const m of history) {
+    if (typeof m.content === "string") total += countTokens(m.content);
+  }
+  return total;
+}
+function passCompressHistory(ir, opts = {}) {
+  const history = ir.history;
+  if (!history || history.length === 0) {
+    return { value: ir, mutations: [], historyTokensTotal: 0 };
+  }
+  const keepRecent = opts.keepRecent ?? 4;
+  const summarizeOlderThan = opts.summarizeOlderThan ?? 8;
   const summarizeAboveTokens = opts.summarizeAboveTokens;
   const historyTokensTotal = totalHistoryTokens(history);
   const countThresholdHit = history.length > summarizeOlderThan;
@@ -449,6 +824,175 @@ function simpleHash(s) {
   }
   return (h >>> 0).toString(36);
 }
+function resolveConventionsForProfile(profile) {
+  const own = profile.archetypeConventions ?? [];
+  const family = profile.family ?? deriveFamilyFromModelId(profile.id);
+  if (!family) return own;
+  return own;
+}
+function applyArchetypeConvention(promptText, archetype, family) {
+  if (typeof promptText !== "string" || promptText.length === 0) return promptText;
+  const repId = familyRepId(family);
+  if (!repId) return promptText;
+  const profile = tryGetProfile(repId);
+  if (!profile || !profile.archetypeConventions) return promptText;
+  const conventions = profile.archetypeConventions.filter((c) => c.archetype === archetype);
+  if (conventions.length === 0) return promptText;
+  let next = promptText;
+  for (const c of conventions) {
+    if (c.promptPrefix) {
+      if (!next.startsWith(c.promptPrefix)) {
+        next = c.promptPrefix + next;
+      }
+    }
+    if (c.promptSuffix) {
+      if (!next.endsWith(c.promptSuffix)) {
+        next = next + c.promptSuffix;
+      }
+    }
+  }
+  return next;
+}
+function familyRepId(family) {
+  switch (family) {
+    case "deepseek-reasoner":
+      return "deepseek-v4-pro";
+    case "deepseek-chat":
+      return "deepseek-v4-flash";
+    default:
+      return void 0;
+  }
+}
+function passApplyConventions(ir, profile) {
+  const mutations = [];
+  const cliffWarnings = [];
+  const structuredOutputHints = [];
+  const own = profile.archetypeConventions ?? [];
+  let effective = own;
+  if (effective.length === 0) {
+    const family2 = profile.family ?? deriveFamilyFromModelId(profile.id);
+    if (family2) {
+      const repId = familyRepId(family2);
+      if (repId && repId !== profile.id) {
+        const repProfile = tryGetProfile(repId);
+        if (repProfile && repProfile.archetypeConventions) {
+          effective = repProfile.archetypeConventions;
+        }
+      }
+    }
+  }
+  if (effective.length === 0) {
+    return {
+      value: { ir, cliffWarnings, structuredOutputHints },
+      mutations
+    };
+  }
+  const archetype = ir.intent.archetype;
+  const matching = effective.filter((c) => c.archetype === archetype);
+  if (matching.length === 0) {
+    return {
+      value: { ir, cliffWarnings, structuredOutputHints },
+      mutations
+    };
+  }
+  const family = profile.family ?? deriveFamilyFromModelId(profile.id) ?? "unknown";
+  let nextIR = ir;
+  for (const convention of matching) {
+    let touched = false;
+    if (convention.promptPrefix) {
+      const sections = nextIR.sections ?? [];
+      const alreadyPresent = sections.some(
+        (s) => s.text.includes(convention.promptPrefix)
+      );
+      if (!alreadyPresent) {
+        const prefixSection = {
+          id: `convention-prefix-${family}-${archetype}`,
+          text: convention.promptPrefix
+        };
+        nextIR = { ...nextIR, sections: [prefixSection, ...sections] };
+        touched = true;
+      }
+    }
+    if (convention.promptSuffix) {
+      const history = nextIR.history ?? [];
+      let lastUserIdx = -1;
+      for (let i = history.length - 1; i >= 0; i--) {
+        if (history[i]?.role === "user") {
+          lastUserIdx = i;
+          break;
+        }
+      }
+      if (lastUserIdx >= 0) {
+        const target = history[lastUserIdx];
+        if (!target.content.endsWith(convention.promptSuffix)) {
+          const newHistory = history.slice();
+          newHistory[lastUserIdx] = {
+            ...target,
+            content: target.content + convention.promptSuffix
+          };
+          nextIR = { ...nextIR, history: newHistory };
+          touched = true;
+        }
+      } else if (nextIR.currentTurn && nextIR.currentTurn.role === "user") {
+        const target = nextIR.currentTurn;
+        if (!target.content.endsWith(convention.promptSuffix)) {
+          nextIR = {
+            ...nextIR,
+            currentTurn: {
+              ...target,
+              content: target.content + convention.promptSuffix
+            }
+          };
+          touched = true;
+        }
+      } else {
+        nextIR = {
+          ...nextIR,
+          currentTurn: {
+            role: "user",
+            content: convention.promptSuffix.trim()
+          }
+        };
+        touched = true;
+      }
+    }
+    if (convention.structuredOutputHint) {
+      const wantsStructured = !!nextIR.constraints?.structuredOutput;
+      const shouldSurface = convention.structuredOutputHint === "avoid" && wantsStructured || convention.structuredOutputHint === "enforce" && !wantsStructured;
+      if (shouldSurface) {
+        structuredOutputHints.push({
+          archetype,
+          hint: convention.structuredOutputHint,
+          reason: convention.reason
+        });
+        if (convention.cliffWarning) {
+          cliffWarnings.push(`${profile.id}: ${convention.cliffWarning}`);
+        }
+        touched = true;
+      }
+    }
+    if (convention.cliffWarning && !convention.structuredOutputHint) {
+      const toolCount = nextIR.tools?.length ?? 0;
+      const thresholdOk = convention.whenToolCountAtLeast === void 0 || toolCount >= convention.whenToolCountAtLeast;
+      if (thresholdOk) {
+        cliffWarnings.push(`${profile.id}: ${convention.cliffWarning}`);
+        touched = true;
+      }
+    }
+    if (touched) {
+      mutations.push({
+        id: `apply-convention-${family}-${archetype}`,
+        source: "archetype_convention",
+        passName: "apply_conventions",
+        description: `${profile.id}: applied ${family}-family convention for archetype=${archetype} \u2014 ${convention.reason}`
+      });
+    }
+  }
+  return {
+    value: { ir: nextIR, cliffWarnings, structuredOutputHints },
+    mutations
+  };
+}
 
 // src/lower.ts
 function lower(ir, profile, hints = {}) {
@@ -826,125 +1370,6 @@ function getArchetypePerfScore(modelId, archetype) {
   return { score, n, grounding };
 }
 
-// src/exclusion-findings-brain.ts
-function isValidVerdict(v) {
-  return v === "recommend-probe" || v === "unblock" || v === "stay-excluded" || v === "inconclusive";
-}
-function isValidConfidence(v) {
-  return v === "high" || v === "medium" || v === "low";
-}
-function isRawFindingRow(x) {
-  if (!x || typeof x !== "object") return false;
-  const r = x;
-  return typeof r.intent_archetype === "string" && typeof r.excluded_model === "string" && typeof r.excluded_provider === "string" && typeof r.verdict === "string" && typeof r.message === "string" && typeof r.suggestion === "string" && typeof r.confidence === "string";
-}
-function mapRowsToFindings(rows) {
-  const out = [];
-  for (const row of rows) {
-    if (!isRawFindingRow(row)) continue;
-    if (!isValidVerdict(row.verdict)) continue;
-    if (!isValidConfidence(row.confidence)) continue;
-    let savings = null;
-    if (typeof row.estimated_savings_usd_30d === "number") {
-      savings = Number.isFinite(row.estimated_savings_usd_30d) ? row.estimated_savings_usd_30d : null;
-    } else if (typeof row.estimated_savings_usd_30d === "string") {
-      const n = Number(row.estimated_savings_usd_30d);
-      savings = Number.isFinite(n) ? n : null;
-    }
-    out.push({
-      archetype: row.intent_archetype,
-      excludedModel: row.excluded_model,
-      excludedProvider: row.excluded_provider,
-      verdict: row.verdict,
-      estimatedSavingsUsd30d: savings,
-      message: row.message,
-      suggestion: row.suggestion,
-      confidence: row.confidence,
-      evidence: row.evidence && typeof row.evidence === "object" ? row.evidence : void 0
-    });
-  }
-  return out;
-}
-var snapshots = /* @__PURE__ */ new Map();
-var runtime;
-var warnedOnce = false;
-var DEFAULT_FINDINGS_ENDPOINT = "https://kgauto-dashboard.vercel.app/api/kgauto-v2/findings/exclusions";
-function configureExclusionFindingsBrain(rt) {
-  runtime = rt;
-  snapshots.clear();
-  warnedOnce = false;
-}
-function isExclusionFindingsBrainActive() {
-  return runtime !== void 0;
-}
-function getStaleExclusionFindings(opts) {
-  const rt = runtime;
-  if (!rt) return [];
-  const appId = opts.appId;
-  if (!appId) return [];
-  let snap = snapshots.get(appId);
-  if (!snap) {
-    snap = { data: [], expiresAt: 0, refreshing: false };
-    snapshots.set(appId, snap);
-  }
-  const now = Date.now();
-  const stale = snap.expiresAt <= now;
-  if (stale && !snap.refreshing) {
-    snap.refreshing = true;
-    void asyncRefresh(rt, appId);
-  }
-  if (opts.archetype) {
-    return snap.data.filter((f) => f.archetype === opts.archetype);
-  }
-  return snap.data;
-}
-var pendingRefreshes = /* @__PURE__ */ new Map();
-async function asyncRefresh(rt, appId) {
-  const promise = doRefresh(rt, appId);
-  pendingRefreshes.set(appId, promise);
-  try {
-    await promise;
-  } finally {
-    if (pendingRefreshes.get(appId) === promise) {
-      pendingRefreshes.delete(appId);
-    }
-  }
-}
-async function doRefresh(rt, appId) {
-  const url = `${rt.endpoint}?app_id=${encodeURIComponent(appId)}`;
-  let snap = snapshots.get(appId);
-  if (!snap) {
-    snap = { data: [], expiresAt: 0, refreshing: false };
-    snapshots.set(appId, snap);
-  }
-  try {
-    const res = await rt.fetchImpl(url, { method: "GET" });
-    if (!res.ok) {
-      throw new Error(`findings ${res.status}: ${res.statusText}`);
-    }
-    const body = await res.json();
-    if (runtime !== rt) return;
-    const rows = Array.isArray(body) ? mapRowsToFindings(body) : [];
-    snap.data = rows;
-    snap.expiresAt = Date.now() + rt.ttlMs;
-    snap.refreshing = false;
-  } catch (err) {
-    if (runtime !== rt) return;
-    snap.refreshing = false;
-    snap.expiresAt = Date.now() + rt.ttlMs;
-    if (!warnedOnce) {
-      warnedOnce = true;
-      (rt.onError ?? defaultOnError)(err);
-    }
-  }
-}
-function defaultOnError(err) {
-  console.warn(
-    "[kgauto] exclusion-findings fetch failed (using empty fallback):",
-    err
-  );
-}
-
 // src/promote-ready-brain.ts
 function isRawPromoteReadyRow(x) {
   if (!x || typeof x !== "object") return false;
@@ -970,964 +1395,795 @@ function mapRowsToFindings2(rows) {
     out.push({
       archetype: row.intent_archetype,
       family: row.family,
-      candidateModel: row.candidate_model,
-      currentModel: row.current_model,
-      sampleN,
-      judgePassRate: passRate,
-      judgeAvgScore: avgScore,
-      costDeltaPct: coerceNumber(row.cost_delta_pct),
-      detectedAt: row.detected_at
-    });
-  }
-  return out;
-}
-var snapshots2 = /* @__PURE__ */ new Map();
-var runtime2;
-var warnedOnce2 = false;
-function isPromoteReadyBrainActive() {
-  return runtime2 !== void 0;
-}
-function loadPromoteReadyFindings(opts) {
-  const rt = runtime2;
-  if (!rt) return [];
-  const appId = opts.appId;
-  if (!appId) return [];
-  let snap = snapshots2.get(appId);
-  if (!snap) {
-    snap = { data: [], expiresAt: 0, refreshing: false };
-    snapshots2.set(appId, snap);
-  }
-  const now = Date.now();
-  const stale = snap.expiresAt <= now;
-  if (stale && !snap.refreshing) {
-    snap.refreshing = true;
-    void asyncRefresh2(rt, appId);
-  }
-  let rows = snap.data;
-  if (opts.archetype) {
-    rows = rows.filter((f) => f.archetype === opts.archetype);
-  }
-  if (opts.family) {
-    rows = rows.filter((f) => f.family === opts.family);
-  }
-  return rows;
-}
-var pendingRefreshes2 = /* @__PURE__ */ new Map();
-async function asyncRefresh2(rt, appId) {
-  const promise = doRefresh2(rt, appId);
-  pendingRefreshes2.set(appId, promise);
-  try {
-    await promise;
-  } finally {
-    if (pendingRefreshes2.get(appId) === promise) {
-      pendingRefreshes2.delete(appId);
-    }
-  }
-}
-async function doRefresh2(rt, appId) {
-  const url = `${rt.endpoint}?app_id=${encodeURIComponent(appId)}`;
-  let snap = snapshots2.get(appId);
-  if (!snap) {
-    snap = { data: [], expiresAt: 0, refreshing: false };
-    snapshots2.set(appId, snap);
-  }
-  try {
-    const res = await rt.fetchImpl(url, { method: "GET" });
-    if (!res.ok) {
-      throw new Error(`promote-ready ${res.status}: ${res.statusText}`);
-    }
-    const body = await res.json();
-    if (runtime2 !== rt) return;
-    const rows = Array.isArray(body) ? mapRowsToFindings2(body) : [];
-    snap.data = rows;
-    snap.expiresAt = Date.now() + rt.ttlMs;
-    snap.refreshing = false;
-  } catch (err) {
-    if (runtime2 !== rt) return;
-    snap.refreshing = false;
-    snap.expiresAt = Date.now() + rt.ttlMs;
-    if (!warnedOnce2) {
-      warnedOnce2 = true;
-      (rt.onError ?? defaultOnError2)(err);
-    }
-  }
-}
-function defaultOnError2(err) {
-  console.warn(
-    "[kgauto] promote-ready fetch failed (using empty fallback):",
-    err
-  );
-}
-function resolveFetchImpl(injected) {
-  return injected ?? ((...args) => globalThis.fetch(...args));
-}
-function normalizeEndpoint(endpoint) {
-  return endpoint.replace(/\/+$/, "");
-}
-async function markPromoteReadyHandled(opts) {
-  const {
-    appId,
-    archetype,
-    family,
-    resolution,
-    resolutionNote,
-    brainEndpoint,
-    brainJwt,
-    brainAnonKey,
-    fetch: injectedFetch
-  } = opts;
-  if (!appId) return { ok: false, reason: "app_id_required" };
-  if (!archetype) return { ok: false, reason: "archetype_required" };
-  if (!family) return { ok: false, reason: "family_required" };
-  if (resolution !== "promoted" && resolution !== "declined" && resolution !== "still-evaluating") {
-    return { ok: false, reason: "resolution_invalid" };
-  }
-  const doFetch = resolveFetchImpl(injectedFetch);
-  const base = normalizeEndpoint(brainEndpoint);
-  const url = `${base}/rest/v1/promote_ready_findings?app_id=eq.${encodeURIComponent(appId)}&intent_archetype=eq.${encodeURIComponent(archetype)}&family=eq.${encodeURIComponent(family)}&resolved_at=is.null`;
-  const patchBody = {
-    resolved_at: (/* @__PURE__ */ new Date()).toISOString(),
-    resolution
-  };
-  if (resolutionNote !== void 0) {
-    patchBody.resolution_note = resolutionNote;
-  }
-  let res;
-  try {
-    res = await doFetch(url, {
-      method: "PATCH",
-      headers: {
-        Authorization: `Bearer ${brainJwt}`,
-        apikey: brainAnonKey,
-        "Content-Type": "application/json",
-        Accept: "application/json",
-        Prefer: "return=minimal"
-      },
-      body: JSON.stringify(patchBody)
-    });
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    return { ok: false, reason: `network_error:${msg}` };
-  }
-  if (res.status === 401 || res.status === 403) {
-    return { ok: false, reason: "brain_auth_misconfig" };
-  }
-  if (res.status >= 500) {
-    return { ok: false, reason: "brain_unavailable" };
-  }
-  if (!res.ok) {
-    return { ok: false, reason: `patch_failed:${res.status}` };
-  }
-  return { ok: true };
-}
-
-// src/advisor-rules/promote-ready.ts
-var PROMOTE_READY_THRESHOLDS = {
-  minPassRate: 0.8,
-  minAvgScore: 4
-};
-function shouldFirePromoteReady(finding, resolvedPrimary) {
-  if (finding.currentModel !== resolvedPrimary) return false;
-  if (finding.judgePassRate < PROMOTE_READY_THRESHOLDS.minPassRate) return false;
-  if (finding.judgeAvgScore < PROMOTE_READY_THRESHOLDS.minAvgScore) return false;
-  return true;
-}
-function deriveFamilyLocal(modelId) {
-  if (modelId.startsWith("claude-opus-")) return "claude-opus";
-  if (modelId.startsWith("claude-sonnet-")) return "claude-sonnet";
-  if (modelId.startsWith("claude-haiku-")) return "claude-haiku";
-  if (/^gemini-.*-flash-lite/.test(modelId)) return "gemini-flash-lite";
-  if (/^gemini-.*-flash/.test(modelId)) return "gemini-flash";
-  if (/^gemini-.*-pro/.test(modelId)) return "gemini-pro";
-  if (/^deepseek-.*-pro/.test(modelId)) return "deepseek-reasoner";
-  if (modelId.startsWith("deepseek-")) return "deepseek-chat";
-  if (modelId.startsWith("gpt-")) return "openai-gpt";
-  return null;
-}
-function advisorRulePromoteReady(ctx) {
-  if (!isPromoteReadyBrainActive()) return [];
-  if (!ctx.appId) return [];
-  if (!ctx.resolvedPrimary) return [];
-  const family = deriveFamilyLocal(ctx.resolvedPrimary);
-  if (!family) return [];
-  const findings = loadPromoteReadyFindings({
-    appId: ctx.appId,
-    archetype: ctx.archetype,
-    family
-  });
-  if (findings.length === 0) return [];
-  const qualifying = findings.filter(
-    (f) => shouldFirePromoteReady(f, ctx.resolvedPrimary)
-  );
-  if (qualifying.length === 0) return [];
-  qualifying.sort((a, b) => {
-    if (a.judgeAvgScore !== b.judgeAvgScore) {
-      return b.judgeAvgScore - a.judgeAvgScore;
-    }
-    return b.judgePassRate - a.judgePassRate;
-  });
-  const top = qualifying[0];
-  const pctPass = Math.round(top.judgePassRate * 100);
-  const score = top.judgeAvgScore.toFixed(2);
-  let costClause = "";
-  if (top.costDeltaPct !== null) {
-    const sign = top.costDeltaPct < 0 ? "cheaper" : "more expensive";
-    const magnitude = Math.abs(top.costDeltaPct * 100).toFixed(1);
-    costClause = `, cost ${magnitude}% ${sign}`;
-  }
-  const message = `Probe found ${top.candidateModel} produces equivalent-or-better outputs vs ${top.currentModel} on ${top.sampleN} recent ${top.archetype} prompts (pass rate ${pctPass}%, avg score ${score}/5${costClause}). Consider promoting via markPromoteReadyHandled.`;
-  return [
-    {
-      level: "info",
-      code: "promote-ready",
-      message,
-      suggestion: `Migrate ${top.archetype} traffic from ${top.currentModel} to ${top.candidateModel}, then call markPromoteReadyHandled({ appId, archetype: '${top.archetype}', family: '${top.family}', resolution: 'promoted' }) to silence this advisory.`,
-      // alpha.36 architectural field — not a no-ai-needed case.
-      recommendedArchitecture: void 0,
-      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
-    }
-  ];
-}
-
-// src/advisor-rules/consumer-on-stale-model.ts
-function isStaleStatus(v) {
-  return v === "legacy" || v === "deprecated";
-}
-function asString(v) {
-  return typeof v === "string" && v.length > 0 ? v : void 0;
-}
-function mapRowsToFindings3(rows) {
-  const out = [];
-  for (const raw of rows) {
-    if (!raw || typeof raw !== "object") continue;
-    const r = raw;
-    const archetype = asString(r.intent_archetype) ?? asString(r.applies_to_archetype);
-    const staleModel = asString(r.stale_model) ?? asString(r.applies_to_model);
-    const staleProvider = asString(r.stale_provider);
-    const recommendedModel = asString(r.recommended_model);
-    const family = asString(r.family);
-    const message = asString(r.message);
-    if (!archetype || !staleModel || !recommendedModel || !family || !message) {
-      continue;
-    }
-    if (!isStaleStatus(r.stale_status)) continue;
-    const row = {
-      archetype,
-      staleModel,
-      staleProvider: staleProvider ?? "unknown",
-      staleStatus: r.stale_status,
-      recommendedModel,
-      family,
-      message
-    };
-    const suggestion = asString(r.suggestion);
-    if (suggestion) row.suggestion = suggestion;
-    if (typeof r.observation_count === "number" && Number.isFinite(r.observation_count)) {
-      row.observationCount = r.observation_count;
-    }
-    out.push(row);
+      candidateModel: row.candidate_model,
+      currentModel: row.current_model,
+      sampleN,
+      judgePassRate: passRate,
+      judgeAvgScore: avgScore,
+      costDeltaPct: coerceNumber(row.cost_delta_pct),
+      detectedAt: row.detected_at
+    });
   }
   return out;
 }
-var snapshots3 = /* @__PURE__ */ new Map();
-var runtime3;
-var warnedOnce3 = false;
-var pendingRefreshes3 = /* @__PURE__ */ new Map();
-function isStaleModelFindingsBrainActive() {
-  return runtime3 !== void 0;
+var snapshots2 = /* @__PURE__ */ new Map();
+var runtime2;
+var warnedOnce2 = false;
+function isPromoteReadyBrainActive() {
+  return runtime2 !== void 0;
 }
-function getStaleModelFindings(opts) {
-  const rt = runtime3;
+function loadPromoteReadyFindings(opts) {
+  const rt = runtime2;
   if (!rt) return [];
   const appId = opts.appId;
   if (!appId) return [];
-  let snap = snapshots3.get(appId);
+  let snap = snapshots2.get(appId);
   if (!snap) {
     snap = { data: [], expiresAt: 0, refreshing: false };
-    snapshots3.set(appId, snap);
+    snapshots2.set(appId, snap);
   }
   const now = Date.now();
   const stale = snap.expiresAt <= now;
   if (stale && !snap.refreshing) {
     snap.refreshing = true;
-    void asyncRefresh3(rt, appId);
+    void asyncRefresh2(rt, appId);
   }
+  let rows = snap.data;
   if (opts.archetype) {
-    return snap.data.filter((f) => f.archetype === opts.archetype);
+    rows = rows.filter((f) => f.archetype === opts.archetype);
   }
-  return snap.data;
+  if (opts.family) {
+    rows = rows.filter((f) => f.family === opts.family);
+  }
+  return rows;
 }
-async function asyncRefresh3(rt, appId) {
-  const promise = doRefresh3(rt, appId);
-  pendingRefreshes3.set(appId, promise);
+var pendingRefreshes2 = /* @__PURE__ */ new Map();
+async function asyncRefresh2(rt, appId) {
+  const promise = doRefresh2(rt, appId);
+  pendingRefreshes2.set(appId, promise);
   try {
     await promise;
   } finally {
-    if (pendingRefreshes3.get(appId) === promise) {
-      pendingRefreshes3.delete(appId);
-    }
-  }
-}
-async function doRefresh3(rt, appId) {
-  const url = `${rt.endpoint}?app_id=${encodeURIComponent(appId)}`;
-  let snap = snapshots3.get(appId);
-  if (!snap) {
-    snap = { data: [], expiresAt: 0, refreshing: false };
-    snapshots3.set(appId, snap);
-  }
-  try {
-    const res = await rt.fetchImpl(url, { method: "GET" });
-    if (!res.ok) {
-      throw new Error(`stale-model findings ${res.status}: ${res.statusText}`);
-    }
-    const body = await res.json();
-    if (runtime3 !== rt) return;
-    const rows = Array.isArray(body) ? mapRowsToFindings3(body) : [];
-    snap.data = rows;
-    snap.expiresAt = Date.now() + rt.ttlMs;
-    snap.refreshing = false;
-  } catch (err) {
-    if (runtime3 !== rt) return;
-    snap.refreshing = false;
-    snap.expiresAt = Date.now() + rt.ttlMs;
-    if (!warnedOnce3) {
-      warnedOnce3 = true;
-      (rt.onError ?? defaultOnError3)(err);
-    }
-  }
-}
-function defaultOnError3(err) {
-  console.warn(
-    "[kgauto] stale-model findings fetch failed (using empty fallback):",
-    err
-  );
-}
-var CONSUMER_ON_STALE_MODEL_RULE_CODE = "consumer-on-stale-model";
-function advisorRuleConsumerOnStaleModel(ir) {
-  if (!isStaleModelFindingsBrainActive()) return [];
-  if (!ir.appId) return [];
-  const findings = getStaleModelFindings({
-    appId: ir.appId,
-    archetype: ir.intent.archetype
-  });
-  if (findings.length === 0) return [];
-  const ranked = [...findings].sort((a, b) => {
-    if (a.staleStatus !== b.staleStatus) {
-      return a.staleStatus === "deprecated" ? -1 : 1;
-    }
-    return a.staleModel.localeCompare(b.staleModel);
-  });
-  const top = ranked[0];
-  const extraCount = findings.length - 1;
-  const extraNote = extraCount > 0 ? ` (+ ${extraCount} more stale model${extraCount === 1 ? "" : "s"} for this archetype)` : "";
-  return [
-    {
-      level: "warn",
-      code: CONSUMER_ON_STALE_MODEL_RULE_CODE,
-      message: `${top.message}${extraNote}`,
-      suggestion: top.suggestion ?? `Migrate ${top.staleModel} \u2192 ${top.recommendedModel} for archetype "${top.archetype}". The newer model is the current latest in the "${top.family}" family; the stale one is ${top.staleStatus}.`,
-      recommendationType: "model-swap",
-      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
-    }
-  ];
-}
-
-// src/advisor.ts
-var QUALITY_FLOOR_FOR_RECOMMENDATION = 6;
-var TIER_DOWN_COST_RATIO = 0.5;
-var COST_MISMATCHED_CHOSEN_SCORE_CEILING = 7;
-function runAdvisor(ir, result, profile, policy, phase2) {
-  const out = [];
-  out.push(...detectCachingOff(ir, profile));
-  out.push(...detectSingleChunkSystem(ir, profile));
-  out.push(...detectToolBloat(ir, result));
-  out.push(...detectHistoryUncached(ir, profile));
-  out.push(...detectSingleModelArray(ir, policy));
-  if (policy?.posture !== "locked") {
-    out.push(...detectCostMismatchedArchetype(ir, profile, phase2));
-    out.push(...detectModelStaleEvidence(ir, profile));
-    out.push(...detectTierDown(ir, profile, phase2));
-  }
-  if (!translatorClearedToolCallCliff(phase2)) {
-    out.push(...detectArchetypePerfFloorBreach(ir, profile));
-  }
-  if (policy?.posture !== "locked") {
-    out.push(...detectStaleExclusionCandidate(ir));
-  }
-  if (policy?.posture !== "locked" && ir.appId) {
-    out.push(
-      ...advisorRulePromoteReady({
-        appId: ir.appId,
-        archetype: ir.intent.archetype,
-        resolvedPrimary: profile.id
-      })
-    );
-    out.push(...advisorRuleConsumerOnStaleModel(ir));
-  }
-  return out;
-}
-function translatorClearedToolCallCliff(phase2) {
-  const rewrites = phase2?.sectionRewritesApplied;
-  if (!rewrites || rewrites.length === 0) return false;
-  for (const rw of rewrites) {
-    if (rw.kind === "tool_call_contract") return true;
-  }
-  return false;
-}
-function detectCachingOff(ir, profile) {
-  if (profile.provider !== "anthropic") return [];
-  const totalChars = ir.sections.reduce((s, sec) => s + sec.text.length, 0);
-  if (totalChars < 2e3) return [];
-  const anyCacheable = ir.sections.some((s) => s.cacheable === true);
-  if (anyCacheable) return [];
-  return [
-    {
-      level: "warn",
-      code: "caching-off-on-claude",
-      message: `System prompt is ${totalChars} chars on Anthropic but no PromptSection has cacheable=true. Anthropic prompt caching cuts cached-prefix input cost by ~90% on subsequent calls; without it, every turn re-pays full price for the static system context.`,
-      suggestion: "Mark stable system sections (role, persona, tool policy) with `cacheable: true`. The lowering pass concatenates cacheable sections into a single cache-controlled block before the dynamic ones.",
-      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
-    }
-  ];
-}
-function detectSingleChunkSystem(ir, profile) {
-  if (profile.provider !== "anthropic") return [];
-  if (ir.sections.length !== 1) return [];
-  const only = ir.sections[0];
-  if (!only || only.text.length <= 1e3) return [];
-  return [
-    {
-      level: "info",
-      code: "single-chunk-system",
-      message: `System prompt is a single ${only.text.length}-char chunk. Splitting into NamedChunks (static role/persona vs dynamic context) gives the lowering pass a finer cache-marker boundary \u2014 only the static portion needs to be byte-stable for the cache to hit.`,
-      suggestion: "Refactor the system builder to return an array of `PromptSection` shaped { id, text, cacheable?: boolean }. Static chunks (role, persona, tool policy) get `cacheable: true`; dynamic ones (current context, today's date) don't.",
-      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
-    }
-  ];
-}
-function detectToolBloat(ir, result) {
-  const SHORT_OUTPUT = /* @__PURE__ */ new Set([
-    "classify",
-    "extract",
-    "summarize",
-    "transform",
-    "critique"
-  ]);
-  if (!ir.tools || ir.tools.length === 0) return [];
-  const toolsKept = result.diagnostics.toolsKept;
-  if (toolsKept <= 10) return [];
-  if (!SHORT_OUTPUT.has(ir.intent.archetype)) return [];
-  return [
-    {
-      level: "warn",
-      code: "tool-bloat",
-      message: `${toolsKept} tools kept after the relevance pass for archetype="${ir.intent.archetype}" (consumer declared ${ir.tools.length}). This archetype is short-output and rarely needs more than 3 tools; each tool definition eats ~350 tokens of context budget.`,
-      suggestion: "Tighten `relevanceByIntent: { [archetype]: 0..1 }` per ToolDefinition. Tools below `toolRelevanceThreshold` (default 0.2) get dropped. Without `relevanceByIntent`, every tool defaults to neutral (0.5) and stays.",
-      docsUrl: "https://github.com/stue/kgauto/blob/main/v2/README.md#tools"
-    }
-  ];
-}
-function detectHistoryUncached(ir, profile) {
-  if (profile.provider !== "anthropic") return [];
-  if (!ir.history || ir.history.length < 2) return [];
-  if (ir.historyCachePolicy && ir.historyCachePolicy.strategy !== "none") {
-    return [];
-  }
-  return [
-    {
-      level: "warn",
-      code: "history-uncached-on-claude",
-      message: `${ir.history.length} history messages on Anthropic with no historyCachePolicy. Every turn re-pays for the full conversation context; with caching, subsequent turns hit the cache at ~10% the input cost.`,
-      suggestion: "Set `historyCachePolicy: { strategy: 'all-but-latest' }` on this IR. The lowering pass marks the message immediately preceding currentTurn with cache_control; subsequent turns whose history prefix matches byte-for-byte hit the cache.",
-      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
-    }
-  ];
-}
-function detectSingleModelArray(ir, policy) {
-  if (ir.models.length !== 1) return [];
-  if (policy?.posture === "locked") return [];
-  const only = ir.models[0];
-  return [
-    {
-      level: "warn",
-      code: "single-model-array",
-      message: `\`ir.models\` has length 1 (only "${only}") and posture is not 'locked'. A single-model chain has no safety net \u2014 the first 429 / 5xx / cliff hits the user as a failure. Master plan \xA71.2 closes the reliability gap with a 2-step minimum.`,
-      suggestion: "Use `getDefaultFallbackChain({ archetype: ir.intent.archetype, primary: '" + only + "', posture: 'preferred' })` for a user-anchored chain, or `getDefaultFallbackChain({ archetype, posture: 'open' })` for library-picked. If single-model is intentional (compliance/brand promise), set `policy.posture = 'locked'` to silence this rule.",
-      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#single-model-array"
-    }
-  ];
-}
-function detectCostMismatchedArchetype(ir, profile, phase2) {
-  if (!phase2 || phase2.fallbackChain.length === 0) return [];
-  if (!phase2.profileResolver) return [];
-  const archetype = ir.intent.archetype;
-  const chosenScore = getArchetypePerfScore(profile.id, archetype);
-  const chosenHasRoomToGrow = chosenScore.grounding === "judgment" || chosenScore.score < COST_MISMATCHED_CHOSEN_SCORE_CEILING;
-  if (!chosenHasRoomToGrow) return [];
-  let bestAlt = null;
-  for (const altId of phase2.fallbackChain) {
-    const altProfile = phase2.profileResolver(altId);
-    if (!altProfile) continue;
-    if (altProfile.id === profile.id) continue;
-    const altScore = getArchetypePerfScore(altProfile.id, archetype);
-    if (altScore.score < QUALITY_FLOOR_FOR_RECOMMENDATION) continue;
-    if (altScore.score < chosenScore.score) continue;
-    if (altProfile.costInputPer1m >= profile.costInputPer1m) continue;
-    if (!bestAlt || altScore.score > bestAlt.score.score || altScore.score === bestAlt.score.score && altProfile.costInputPer1m < bestAlt.profile.costInputPer1m) {
-      bestAlt = { id: altId, profile: altProfile, score: altScore };
+    if (pendingRefreshes2.get(appId) === promise) {
+      pendingRefreshes2.delete(appId);
     }
   }
-  if (!bestAlt) return [];
-  const tierDownWouldFire = bestAlt.score.grounding === "measured" && bestAlt.profile.costInputPer1m <= profile.costInputPer1m * TIER_DOWN_COST_RATIO;
-  if (tierDownWouldFire) return [];
-  const chosenGrounding = chosenScore.grounding === "judgment" ? `archetypePerf.${archetype}=judgment` : `archetypePerf.${archetype}=${chosenScore.score}`;
-  const altGrounding = bestAlt.score.grounding === "measured" ? `archetypePerf.${archetype}=${bestAlt.score.score}, measured, n=${bestAlt.score.n}` : `archetypePerf.${archetype}=${bestAlt.score.score}, judgment`;
-  return [
-    {
-      level: "warn",
-      code: "cost-mismatched-archetype",
-      message: `Cost-mismatched-archetype: target=${profile.id} (${chosenGrounding}) selected for ${archetype}. Alternative ${bestAlt.id} (${altGrounding}) is cheaper ($${bestAlt.profile.costInputPer1m}/$${bestAlt.profile.costOutputPer1m} vs $${profile.costInputPer1m}/$${profile.costOutputPer1m} per 1M) at equal-or-better quality.`,
-      suggestion: `Consider declaring \`${bestAlt.id}\` as the primary model for this archetype, or relax to posture='open' to let kgauto select among the chain. If the chosen model is required for compliance/brand reasons, set \`policy.posture = 'locked'\` to silence this rule.`,
-      recommendationType: profile.provider === bestAlt.profile.provider ? "tier-down" : "model-swap",
-      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
-    }
-  ];
 }
-function detectModelStaleEvidence(ir, profile) {
-  if (!isBrainQueryActiveFor("kgauto_archetype_perf")) return [];
-  const archetype = ir.intent.archetype;
-  const chosen = getArchetypePerfScore(profile.id, archetype);
-  if (chosen.grounding !== "judgment") return [];
-  return [
-    {
-      level: "info",
-      code: "model-stale-evidence",
-      message: `Model-stale-evidence: target=${profile.id} archetype=${archetype} is judgment-grounded (n=${chosen.n}) despite brain-query mode being active. Measurement substrate is wired but the brain hasn't accumulated >=10 outcomes for this (model, archetype) tuple yet \u2014 routing decisions remain pre-measured for this slot.`,
-      suggestion: "Verify that `record()` is being called on every call() outcome with the appropriate `actualModel` and `mutationsApplied` fields. Once the brain accumulates n>=10 rows on this tuple, the score promotes from judgment to measured automatically (5-min SWR cache). No code change required from your side \u2014 this is the substrate signaling the gap.",
-      recommendationType: "prompt-fix",
-      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
+async function doRefresh2(rt, appId) {
+  const url = `${rt.endpoint}?app_id=${encodeURIComponent(appId)}`;
+  let snap = snapshots2.get(appId);
+  if (!snap) {
+    snap = { data: [], expiresAt: 0, refreshing: false };
+    snapshots2.set(appId, snap);
+  }
+  try {
+    const res = await rt.fetchImpl(url, { method: "GET" });
+    if (!res.ok) {
+      throw new Error(`promote-ready ${res.status}: ${res.statusText}`);
     }
-  ];
-}
-function detectTierDown(ir, profile, phase2) {
-  if (!phase2 || phase2.fallbackChain.length === 0) return [];
-  if (!phase2.profileResolver) return [];
-  const archetype = ir.intent.archetype;
-  const chosenScore = getArchetypePerfScore(profile.id, archetype);
-  const chosenCost = profile.costInputPer1m;
-  let bestAlt = null;
-  for (const altId of phase2.fallbackChain) {
-    const altProfile = phase2.profileResolver(altId);
-    if (!altProfile) continue;
-    if (altProfile.id === profile.id) continue;
-    const altScore = getArchetypePerfScore(altProfile.id, archetype);
-    if (altScore.grounding !== "measured") continue;
-    if (altScore.score < QUALITY_FLOOR_FOR_RECOMMENDATION) continue;
-    if (altScore.score < chosenScore.score) continue;
-    if (altProfile.costInputPer1m > chosenCost * TIER_DOWN_COST_RATIO) continue;
-    if (!bestAlt || altProfile.costInputPer1m < bestAlt.profile.costInputPer1m || altProfile.costInputPer1m === bestAlt.profile.costInputPer1m && altScore.score > bestAlt.score.score) {
-      bestAlt = { id: altId, profile: altProfile, score: altScore };
+    const body = await res.json();
+    if (runtime2 !== rt) return;
+    const rows = Array.isArray(body) ? mapRowsToFindings2(body) : [];
+    snap.data = rows;
+    snap.expiresAt = Date.now() + rt.ttlMs;
+    snap.refreshing = false;
+  } catch (err) {
+    if (runtime2 !== rt) return;
+    snap.refreshing = false;
+    snap.expiresAt = Date.now() + rt.ttlMs;
+    if (!warnedOnce2) {
+      warnedOnce2 = true;
+      (rt.onError ?? defaultOnError2)(err);
     }
   }
-  if (!bestAlt) return [];
-  const chosenDesc = chosenScore.grounding === "measured" ? `archetypePerf.${archetype}=${chosenScore.score} (measured, n=${chosenScore.n})` : `archetypePerf.${archetype}=${chosenScore.score} (${chosenScore.grounding})`;
-  return [
-    {
-      level: "warn",
-      code: "tier-down",
-      message: `Tier-down: target=${profile.id} (${chosenDesc}) selected for ${archetype}. Brain shows ${bestAlt.id} delivers equal-or-better quality (archetypePerf.${archetype}=${bestAlt.score.score}, measured, n=${bestAlt.score.n}) at $${bestAlt.profile.costInputPer1m}/$${bestAlt.profile.costOutputPer1m} per 1M vs $${profile.costInputPer1m}/$${profile.costOutputPer1m} \u2014 a measured tier-down opportunity.`,
-      suggestion: `Move \`${bestAlt.id}\` to primary for this archetype. The brain has n=${bestAlt.score.n} measured outcomes backing the recommendation; this is data, not opinion. If posture='locked' is required (compliance/brand promise), set it explicitly to silence this rule.`,
-      recommendationType: "tier-down",
-      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
-    }
-  ];
 }
-function detectArchetypePerfFloorBreach(ir, profile) {
-  const compat = getModelCompatibility(profile.id, {
-    archetype: ir.intent.archetype,
-    toolOrchestration: ir.constraints?.toolOrchestration
-  });
-  if (compat.status === "compatible") return [];
-  if (compat.status === "requires-adapter") {
-    return [
-      {
-        level: "warn",
-        code: "archetype-perf-floor-breach",
-        message: `${profile.id} sits below the archetype floor for ${ir.intent.archetype} (score ${compat.archetypePerf}/10, floor ${6}). A known adapter would lift it: ${compat.adapter.parameter}=${compat.adapter.value}. ${compat.adapter.consequence}`,
-        suggestion: `Pass \`ir.constraints.${compat.adapter.parameter} = '${compat.adapter.value}'\` for this call, OR pick a model whose archetypePerf for ${ir.intent.archetype} already clears the floor (call \`getModelCompatibility(modelId, { archetype: '${ir.intent.archetype}' })\` to check). Estimated post-adapter score: ${compat.archetypePerfWithAdapter}/10.`,
-        recommendationType: "prompt-fix",
-        suggestedAdaptation: compat.adapter,
-        docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
-      }
-    ];
+function defaultOnError2(err) {
+  console.warn(
+    "[kgauto] promote-ready fetch failed (using empty fallback):",
+    err
+  );
+}
+function resolveFetchImpl(injected) {
+  return injected ?? ((...args) => globalThis.fetch(...args));
+}
+function normalizeEndpoint(endpoint) {
+  return endpoint.replace(/\/+$/, "");
+}
+async function markPromoteReadyHandled(opts) {
+  const {
+    appId,
+    archetype,
+    family,
+    resolution,
+    resolutionNote,
+    brainEndpoint,
+    brainJwt,
+    brainAnonKey,
+    fetch: injectedFetch
+  } = opts;
+  if (!appId) return { ok: false, reason: "app_id_required" };
+  if (!archetype) return { ok: false, reason: "archetype_required" };
+  if (!family) return { ok: false, reason: "family_required" };
+  if (resolution !== "promoted" && resolution !== "declined" && resolution !== "still-evaluating") {
+    return { ok: false, reason: "resolution_invalid" };
   }
-  return [
-    {
-      level: "critical",
-      code: "archetype-perf-floor-breach",
-      message: `${profile.id} sits below the archetype floor for ${ir.intent.archetype} (score ${compat.archetypePerf}/10, floor ${6}) and no known adapter would lift it. ${compat.reason}`,
-      suggestion: `Swap to a model whose archetypePerf for ${ir.intent.archetype} clears the floor. Use \`getModelCompatibility(candidateId, { archetype: '${ir.intent.archetype}' })\` to vet candidates, or \`getDefaultFallbackChain({ archetype: '${ir.intent.archetype}', posture: 'open' })\` for a library-picked chain that respects the floor by construction.`,
-      recommendationType: "model-swap",
-      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
-    }
-  ];
+  const doFetch = resolveFetchImpl(injectedFetch);
+  const base = normalizeEndpoint(brainEndpoint);
+  const url = `${base}/rest/v1/promote_ready_findings?app_id=eq.${encodeURIComponent(appId)}&intent_archetype=eq.${encodeURIComponent(archetype)}&family=eq.${encodeURIComponent(family)}&resolved_at=is.null`;
+  const patchBody = {
+    resolved_at: (/* @__PURE__ */ new Date()).toISOString(),
+    resolution
+  };
+  if (resolutionNote !== void 0) {
+    patchBody.resolution_note = resolutionNote;
+  }
+  let res;
+  try {
+    res = await doFetch(url, {
+      method: "PATCH",
+      headers: {
+        Authorization: `Bearer ${brainJwt}`,
+        apikey: brainAnonKey,
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        Prefer: "return=minimal"
+      },
+      body: JSON.stringify(patchBody)
+    });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return { ok: false, reason: `network_error:${msg}` };
+  }
+  if (res.status === 401 || res.status === 403) {
+    return { ok: false, reason: "brain_auth_misconfig" };
+  }
+  if (res.status >= 500) {
+    return { ok: false, reason: "brain_unavailable" };
+  }
+  if (!res.ok) {
+    return { ok: false, reason: `patch_failed:${res.status}` };
+  }
+  return { ok: true };
 }
-function detectStaleExclusionCandidate(ir) {
-  if (!isExclusionFindingsBrainActive()) return [];
-  if (!ir.appId) return [];
-  const findings = getStaleExclusionFindings({
-    appId: ir.appId,
-    archetype: ir.intent.archetype
+
+// src/advisor-rules/promote-ready.ts
+var PROMOTE_READY_THRESHOLDS = {
+  minPassRate: 0.8,
+  minAvgScore: 4
+};
+function shouldFirePromoteReady(finding, resolvedPrimary) {
+  if (finding.currentModel !== resolvedPrimary) return false;
+  if (finding.judgePassRate < PROMOTE_READY_THRESHOLDS.minPassRate) return false;
+  if (finding.judgeAvgScore < PROMOTE_READY_THRESHOLDS.minAvgScore) return false;
+  return true;
+}
+function deriveFamilyLocal(modelId) {
+  if (modelId.startsWith("claude-opus-")) return "claude-opus";
+  if (modelId.startsWith("claude-sonnet-")) return "claude-sonnet";
+  if (modelId.startsWith("claude-haiku-")) return "claude-haiku";
+  if (/^gemini-.*-flash-lite/.test(modelId)) return "gemini-flash-lite";
+  if (/^gemini-.*-flash/.test(modelId)) return "gemini-flash";
+  if (/^gemini-.*-pro/.test(modelId)) return "gemini-pro";
+  if (/^deepseek-.*-pro/.test(modelId)) return "deepseek-reasoner";
+  if (modelId.startsWith("deepseek-")) return "deepseek-chat";
+  if (modelId.startsWith("gpt-")) return "openai-gpt";
+  return null;
+}
+function advisorRulePromoteReady(ctx) {
+  if (!isPromoteReadyBrainActive()) return [];
+  if (!ctx.appId) return [];
+  if (!ctx.resolvedPrimary) return [];
+  const family = deriveFamilyLocal(ctx.resolvedPrimary);
+  if (!family) return [];
+  const findings = loadPromoteReadyFindings({
+    appId: ctx.appId,
+    archetype: ctx.archetype,
+    family
   });
   if (findings.length === 0) return [];
-  const ranked = [...findings].sort((a, b) => {
-    const sa = a.estimatedSavingsUsd30d ?? -Infinity;
-    const sb = b.estimatedSavingsUsd30d ?? -Infinity;
-    if (sa !== sb) return sb - sa;
-    return confidenceRank(b.confidence) - confidenceRank(a.confidence);
+  const qualifying = findings.filter(
+    (f) => shouldFirePromoteReady(f, ctx.resolvedPrimary)
+  );
+  if (qualifying.length === 0) return [];
+  qualifying.sort((a, b) => {
+    if (a.judgeAvgScore !== b.judgeAvgScore) {
+      return b.judgeAvgScore - a.judgeAvgScore;
+    }
+    return b.judgePassRate - a.judgePassRate;
   });
-  const top = ranked[0];
-  const extraCount = findings.length - 1;
-  const extraNote = extraCount > 0 ? ` (+ ${extraCount} more excluded model${extraCount === 1 ? "" : "s"} for this archetype)` : "";
+  const top = qualifying[0];
+  const pctPass = Math.round(top.judgePassRate * 100);
+  const score = top.judgeAvgScore.toFixed(2);
+  let costClause = "";
+  if (top.costDeltaPct !== null) {
+    const sign = top.costDeltaPct < 0 ? "cheaper" : "more expensive";
+    const magnitude = Math.abs(top.costDeltaPct * 100).toFixed(1);
+    costClause = `, cost ${magnitude}% ${sign}`;
+  }
+  const message = `Probe found ${top.candidateModel} produces equivalent-or-better outputs vs ${top.currentModel} on ${top.sampleN} recent ${top.archetype} prompts (pass rate ${pctPass}%, avg score ${score}/5${costClause}). Consider promoting via markPromoteReadyHandled.`;
   return [
     {
       level: "info",
-      code: "stale-exclusion-candidate",
-      message: `${top.message}${extraNote}`,
-      suggestion: top.suggestion,
-      recommendationType: "tier-down",
+      code: "promote-ready",
+      message,
+      suggestion: `Migrate ${top.archetype} traffic from ${top.currentModel} to ${top.candidateModel}, then call markPromoteReadyHandled({ appId, archetype: '${top.archetype}', family: '${top.family}', resolution: 'promoted' }) to silence this advisory.`,
+      // alpha.36 architectural field — not a no-ai-needed case.
+      recommendedArchitecture: void 0,
       docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
     }
   ];
 }
-function confidenceRank(c) {
-  if (c === "high") return 3;
-  if (c === "medium") return 2;
-  return 1;
-}
 
-// src/translator.ts
-var TRANSLATOR_FLOOR = ARCHETYPE_FLOOR_DEFAULT;
-var RULE_SEQUENTIAL_TOOL_CLIFF = "sequential-tool-cliff-below-floor";
-var RULE_NARRATION_DRIFT_ANTHROPIC = "narration-drift-anthropic";
-var RULE_NARRATION_THINKING_LEAK_DEEPSEEK = "narration-thinking-leak-deepseek";
-var SEQUENTIAL_TOOL_PREAMBLE = "IMPORTANT: Use one tool call per response. Wait for the tool result before deciding the next tool. Do NOT batch tool calls in parallel.";
-var NARRATION_DRIFT_ANTHROPIC_PREAMBLE = "Output ONLY the requested content. Do not narrate your thought process. Each line \u2264 12 words.";
-var NARRATION_THINKING_LEAK_DEEPSEEK_PREAMBLE = "Reasoning is internal. Output ONLY the requested content; do not emit <thinking> blocks or internal monologue as user-facing text.";
-function matchRule(kind, profile, archetype) {
-  if (kind === "tool_call_contract") {
-    if (!profile.archetypePerf) return null;
-    const archetypeScore = profile.archetypePerf[archetype];
-    if (typeof archetypeScore !== "number" || archetypeScore >= TRANSLATOR_FLOOR) {
-      return null;
+// src/advisor-rules/consumer-on-stale-model.ts
+function isStaleStatus(v) {
+  return v === "legacy" || v === "deprecated";
+}
+function asString(v) {
+  return typeof v === "string" && v.length > 0 ? v : void 0;
+}
+function mapRowsToFindings3(rows) {
+  const out = [];
+  for (const raw of rows) {
+    if (!raw || typeof raw !== "object") continue;
+    const r = raw;
+    const archetype = asString(r.intent_archetype) ?? asString(r.applies_to_archetype);
+    const staleModel = asString(r.stale_model) ?? asString(r.applies_to_model);
+    const staleProvider = asString(r.stale_provider);
+    const recommendedModel = asString(r.recommended_model);
+    const family = asString(r.family);
+    const message = asString(r.message);
+    if (!archetype || !staleModel || !recommendedModel || !family || !message) {
+      continue;
     }
-    return {
-      id: RULE_SEQUENTIAL_TOOL_CLIFF,
-      preamble: SEQUENTIAL_TOOL_PREAMBLE,
-      wireOverrides: { parallelToolCalls: false }
+    if (!isStaleStatus(r.stale_status)) continue;
+    const row = {
+      archetype,
+      staleModel,
+      staleProvider: staleProvider ?? "unknown",
+      staleStatus: r.stale_status,
+      recommendedModel,
+      family,
+      message
     };
-  }
-  if (kind === "narration_contract") {
-    if (profile.provider === "anthropic") {
-      return {
-        id: RULE_NARRATION_DRIFT_ANTHROPIC,
-        preamble: NARRATION_DRIFT_ANTHROPIC_PREAMBLE
-      };
-    }
-    if (profile.provider === "deepseek") {
-      return {
-        id: RULE_NARRATION_THINKING_LEAK_DEEPSEEK,
-        preamble: NARRATION_THINKING_LEAK_DEEPSEEK_PREAMBLE
-      };
+    const suggestion = asString(r.suggestion);
+    if (suggestion) row.suggestion = suggestion;
+    if (typeof r.observation_count === "number" && Number.isFinite(r.observation_count)) {
+      row.observationCount = r.observation_count;
     }
-    return null;
+    out.push(row);
   }
-  return null;
+  return out;
 }
-function applySectionRewrites(args) {
-  const { ir, profile, archetype } = args;
-  if (!Array.isArray(ir.sections) || ir.sections.length === 0) {
-    return { rewrittenIR: ir, rewrites: [] };
+var snapshots3 = /* @__PURE__ */ new Map();
+var runtime3;
+var warnedOnce3 = false;
+var pendingRefreshes3 = /* @__PURE__ */ new Map();
+function isStaleModelFindingsBrainActive() {
+  return runtime3 !== void 0;
+}
+function getStaleModelFindings(opts) {
+  const rt = runtime3;
+  if (!rt) return [];
+  const appId = opts.appId;
+  if (!appId) return [];
+  let snap = snapshots3.get(appId);
+  if (!snap) {
+    snap = { data: [], expiresAt: 0, refreshing: false };
+    snapshots3.set(appId, snap);
   }
-  const rewrites = [];
-  const newSections = ir.sections.map((section) => {
-    if (!section.kind || section.kind === "arbitrary") return section;
-    const rule = matchRule(section.kind, profile, archetype);
-    if (!rule) return section;
-    const originalText = section.text;
-    const transformedText = `${rule.preamble}
-
-${originalText}`;
-    rewrites.push({
-      sectionId: section.id,
-      kind: section.kind,
-      rule: rule.id,
-      originalText,
-      transformedText,
-      ...rule.wireOverrides ? { wireOverrides: rule.wireOverrides } : {}
-    });
-    return { ...section, text: transformedText };
-  });
-  if (rewrites.length === 0) {
-    return { rewrittenIR: ir, rewrites: [] };
+  const now = Date.now();
+  const stale = snap.expiresAt <= now;
+  if (stale && !snap.refreshing) {
+    snap.refreshing = true;
+    void asyncRefresh3(rt, appId);
   }
-  const rewrittenIR = { ...ir, sections: newSections };
-  return { rewrittenIR, rewrites };
-}
-
-// src/models-brain.ts
-function isModelRow(x) {
-  if (!x || typeof x !== "object") return false;
-  const r = x;
-  return typeof r.model_id === "string" && typeof r.provider === "string";
-}
-function isAliasRow(x) {
-  if (!x || typeof x !== "object") return false;
-  const r = x;
-  return typeof r.alias_id === "string" && typeof r.canonical_id === "string";
+  if (opts.archetype) {
+    return snap.data.filter((f) => f.archetype === opts.archetype);
+  }
+  return snap.data;
 }
-function rowToProfile(row) {
+async function asyncRefresh3(rt, appId) {
+  const promise = doRefresh3(rt, appId);
+  pendingRefreshes3.set(appId, promise);
   try {
-    if (row.cliffs !== void 0 && row.cliffs !== null && !Array.isArray(row.cliffs)) {
-      return null;
+    await promise;
+  } finally {
+    if (pendingRefreshes3.get(appId) === promise) {
+      pendingRefreshes3.delete(appId);
     }
-    if (row.recovery !== void 0 && row.recovery !== null && !Array.isArray(row.recovery)) {
-      return null;
+  }
+}
+async function doRefresh3(rt, appId) {
+  const url = `${rt.endpoint}?app_id=${encodeURIComponent(appId)}`;
+  let snap = snapshots3.get(appId);
+  if (!snap) {
+    snap = { data: [], expiresAt: 0, refreshing: false };
+    snapshots3.set(appId, snap);
+  }
+  try {
+    const res = await rt.fetchImpl(url, { method: "GET" });
+    if (!res.ok) {
+      throw new Error(`stale-model findings ${res.status}: ${res.statusText}`);
     }
-    if (row.lowering !== void 0 && row.lowering !== null && (typeof row.lowering !== "object" || Array.isArray(row.lowering))) {
-      return null;
+    const body = await res.json();
+    if (runtime3 !== rt) return;
+    const rows = Array.isArray(body) ? mapRowsToFindings3(body) : [];
+    snap.data = rows;
+    snap.expiresAt = Date.now() + rt.ttlMs;
+    snap.refreshing = false;
+  } catch (err) {
+    if (runtime3 !== rt) return;
+    snap.refreshing = false;
+    snap.expiresAt = Date.now() + rt.ttlMs;
+    if (!warnedOnce3) {
+      warnedOnce3 = true;
+      (rt.onError ?? defaultOnError3)(err);
     }
-    return {
-      id: row.model_id,
-      provider: row.provider,
-      status: row.status ?? "current",
-      maxContextTokens: row.max_context_tokens ?? 0,
-      maxOutputTokens: row.max_output_tokens ?? 0,
-      maxTools: row.max_tools ?? 0,
-      parallelToolCalls: row.parallel_tool_calls ?? false,
-      structuredOutput: row.structured_output ?? "none",
-      systemPromptMode: row.system_prompt_mode ?? "inline",
-      streaming: row.streaming ?? true,
-      cliffs: row.cliffs ?? [],
-      costInputPer1m: row.cost_input_per_1m ?? 0,
-      costOutputPer1m: row.cost_output_per_1m ?? 0,
-      lowering: row.lowering ?? { system: { mode: "inline" }, cache: { strategy: "unsupported" } },
-      recovery: row.recovery ?? [],
-      strengths: row.strengths ?? [],
-      weaknesses: row.weaknesses ?? [],
-      notes: row.notes ?? void 0,
-      verifiedAgainstDocs: row.verified_against_docs ?? void 0,
-      archetypePerf: row.archetype_perf ?? void 0,
-      // alpha.41 — family-resolution fields. `family` may be null pre-
-      // migration 024; runtime falls back to deriveFamilyFromModelId at
-      // resolution time (see family-resolution.ts, G1).
-      family: row.family ?? void 0,
-      versionAdded: row.version_added ?? void 0,
-      active: row.active ?? void 0
-    };
-  } catch {
-    return null;
   }
 }
-function profileToRow(profile, opts = {}) {
-  const row = {
-    model_id: profile.id,
-    provider: profile.provider,
-    status: profile.status,
-    max_context_tokens: profile.maxContextTokens,
-    max_output_tokens: profile.maxOutputTokens,
-    max_tools: profile.maxTools,
-    parallel_tool_calls: profile.parallelToolCalls,
-    structured_output: profile.structuredOutput,
-    system_prompt_mode: profile.systemPromptMode,
-    streaming: profile.streaming,
-    cliffs: profile.cliffs,
-    cost_input_per_1m: profile.costInputPer1m,
-    cost_output_per_1m: profile.costOutputPer1m,
-    lowering: profile.lowering,
-    recovery: profile.recovery,
-    strengths: profile.strengths,
-    weaknesses: profile.weaknesses,
-    notes: profile.notes ?? null,
-    archetype_perf: profile.archetypePerf ?? null,
-    active: opts.active ?? profile.active ?? true,
-    // alpha.41 — round-trip family + version_added when present on profile.
-    // version_added is operator-controlled via opts; profile-side value is
-    // used only when opts didn't override.
-    family: profile.family ?? null
-  };
-  if (opts.verifiedAgainstDocs !== void 0) {
-    row.verified_against_docs = opts.verifiedAgainstDocs;
-  } else if (profile.verifiedAgainstDocs !== void 0) {
-    const v = profile.verifiedAgainstDocs;
-    row.verified_against_docs = /^\d{4}-\d{2}-\d{2}/.test(v) ? v : null;
-  }
-  if (opts.versionAdded !== void 0) row.version_added = opts.versionAdded;
-  else if (profile.versionAdded !== void 0) row.version_added = profile.versionAdded;
-  if (opts.versionRemoved !== void 0) row.version_removed = opts.versionRemoved;
-  return row;
+function defaultOnError3(err) {
+  console.warn(
+    "[kgauto] stale-model findings fetch failed (using empty fallback):",
+    err
+  );
+}
+var CONSUMER_ON_STALE_MODEL_RULE_CODE = "consumer-on-stale-model";
+function advisorRuleConsumerOnStaleModel(ir) {
+  if (!isStaleModelFindingsBrainActive()) return [];
+  if (!ir.appId) return [];
+  const findings = getStaleModelFindings({
+    appId: ir.appId,
+    archetype: ir.intent.archetype
+  });
+  if (findings.length === 0) return [];
+  const ranked = [...findings].sort((a, b) => {
+    if (a.staleStatus !== b.staleStatus) {
+      return a.staleStatus === "deprecated" ? -1 : 1;
+    }
+    return a.staleModel.localeCompare(b.staleModel);
+  });
+  const top = ranked[0];
+  const extraCount = findings.length - 1;
+  const extraNote = extraCount > 0 ? ` (+ ${extraCount} more stale model${extraCount === 1 ? "" : "s"} for this archetype)` : "";
+  return [
+    {
+      level: "warn",
+      code: CONSUMER_ON_STALE_MODEL_RULE_CODE,
+      message: `${top.message}${extraNote}`,
+      suggestion: top.suggestion ?? `Migrate ${top.staleModel} \u2192 ${top.recommendedModel} for archetype "${top.archetype}". The newer model is the current latest in the "${top.family}" family; the stale one is ${top.staleStatus}.`,
+      recommendationType: "model-swap",
+      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
+    }
+  ];
 }
-function mapRowsToModels(rows) {
-  const out = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    if (!isModelRow(row)) continue;
-    const profile = rowToProfile(row);
-    if (profile) out.set(profile.id, profile);
+
+// src/archetype-fits.ts
+var ARCHETYPE_FAMILY_FITS = Object.freeze([
+  {
+    archetype: "plan",
+    betterFitFamily: "deepseek-reasoner",
+    reason: "Plan archetype is reasoning-shaped (multi-step chains, hypothesis-and-check, sub-goal decomposition) \u2014 exactly where reasoner-family models excel. Sonnet/Opus produce plans but at higher cost; reasoners produce equivalent-or-better plans at 7-17x lower cost at current promo pricing (deepseek-v4-pro $0.435/$0.87 per 1M promo through 2026-05-31 vs sonnet $3/$15).",
+    costGuidance: "substantially cheaper at current pricing (deepseek-v4-pro promo: ~7-17x cheaper than sonnet)"
+  },
+  {
+    archetype: "critique",
+    betterFitFamily: "deepseek-reasoner",
+    reason: "Critique archetype rewards epistemic humility and explicit reasoning \u2014 reasoner-family default behavior. Sonnet/Opus over-confident on critique tasks; reasoners surface uncertainty productively.",
+    costGuidance: "comparable or cheaper at current pricing"
   }
-  return out;
+]);
+function findBetterFit(archetype, currentFamily) {
+  for (const fit of ARCHETYPE_FAMILY_FITS) {
+    if (fit.archetype !== archetype) continue;
+    if (fit.betterFitFamily === currentFamily) return null;
+    return fit;
+  }
+  return null;
 }
-function mapRowsToAliases(rows) {
-  const out = {};
-  for (const row of rows) {
-    if (!isAliasRow(row)) continue;
-    out[row.alias_id] = row.canonical_id;
+
+// src/advisor-rules/cross-family-fit.ts
+function familyHasCurrentActiveModel(family) {
+  for (const profile of allProfiles()) {
+    const profileFamily = profile.family ?? deriveFamilyFromModelId(profile.id);
+    if (profileFamily !== family) continue;
+    if (profile.status !== "current") continue;
+    if (profile.active === false) continue;
+    return true;
   }
-  return out;
+  return false;
 }
-function bundledModels() {
-  return new Map(allProfilesRaw().map((p) => [p.id, p]));
+function listCandidatesInFamily(family) {
+  const candidates = [];
+  for (const profile of allProfiles()) {
+    const profileFamily = profile.family ?? deriveFamilyFromModelId(profile.id);
+    if (profileFamily !== family) continue;
+    if (profile.status !== "current") continue;
+    if (profile.active === false) continue;
+    candidates.push(profile.id);
+    if (candidates.length >= 3) break;
+  }
+  return candidates;
 }
-function bundledAliases() {
-  return { ...ALIASES };
+function advisorRuleCrossFamilyFit(ctx) {
+  if (!ctx.resolvedPrimary) return [];
+  const currentFamily = deriveFamilyFromModelId(ctx.resolvedPrimary);
+  if (!currentFamily) return [];
+  const fit = findBetterFit(ctx.archetype, currentFamily);
+  if (!fit) return [];
+  if (!familyHasCurrentActiveModel(fit.betterFitFamily)) return [];
+  const candidates = listCandidatesInFamily(fit.betterFitFamily);
+  if (candidates.length === 0) return [];
+  const candidateStr = candidates.join(", ");
+  const message = `Your ${currentFamily} call on ${ctx.archetype} could shift to ${fit.betterFitFamily} \u2014 typically better quality + ${fit.costGuidance}. Suggested candidates: ${candidateStr}.`;
+  return [
+    {
+      level: "info",
+      code: "cross-family-fit-candidate",
+      ownership: "consumer-actionable",
+      message,
+      suggestion: `Swap the model literal in \`ir.models\` to one of: ${candidateStr}. Or call \`getRecommendedPrimary({ family: '${fit.betterFitFamily}', archetype: '${ctx.archetype}', fallback: { id: '${candidates[0]}', reason: 'cross-family-fit-recommendation' } })\` to let kgauto resolve to the current+active family member.`,
+      recommendationType: "model-swap",
+      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
+    }
+  ];
 }
-var loadModelsFromBrain = createBrainQueryCache({
-  table: "kgauto_models",
-  mapRows: mapRowsToModels,
-  bundledFallback: bundledModels
-});
-var loadAliasesFromBrain = createBrainQueryCache({
-  table: "kgauto_aliases",
-  mapRows: mapRowsToAliases,
-  bundledFallback: bundledAliases
-});
-_setProfileBrainHook({
-  getProfile: (canonical) => loadModelsFromBrain().get(canonical),
-  resolveAlias: (id) => loadAliasesFromBrain()[id]
-});
 
-// src/family-resolution.ts
-var FamilyResolutionError = class extends Error {
-  family;
-  cause;
-  constructor(family, cause) {
-    super(
-      `Family "${family}" did not resolve to any current+active model. ${cause}. Pass a literal model id in ir.models, or call getRecommendedPrimary({ family, fallback }) at IR-construction time.`
-    );
-    this.name = "FamilyResolutionError";
-    this.family = family;
-    this.cause = cause;
+// src/advisor.ts
+var QUALITY_FLOOR_FOR_RECOMMENDATION = 6;
+var TIER_DOWN_COST_RATIO = 0.5;
+var COST_MISMATCHED_CHOSEN_SCORE_CEILING = 7;
+var PRODUCER_OWNED_RULE_CODES = Object.freeze(
+  /* @__PURE__ */ new Set(["model-stale-evidence", "promote-ready"])
+);
+function deriveOwnership(code, selfDeclared) {
+  if (selfDeclared) return selfDeclared;
+  return PRODUCER_OWNED_RULE_CODES.has(code) ? "producer-owned" : "consumer-actionable";
+}
+function runAdvisor(ir, result, profile, policy, phase2) {
+  const out = [];
+  out.push(...detectCachingOff(ir, profile));
+  out.push(...detectSingleChunkSystem(ir, profile));
+  out.push(...detectToolBloat(ir, result));
+  out.push(...detectHistoryUncached(ir, profile));
+  out.push(...detectSingleModelArray(ir, policy));
+  if (policy?.posture !== "locked") {
+    out.push(...detectCostMismatchedArchetype(ir, profile, phase2));
+    out.push(...detectModelStaleEvidence(ir, profile));
+    out.push(...detectTierDown(ir, profile, phase2));
   }
-};
-function deriveFamilyFromModelId(modelId) {
-  if (typeof modelId !== "string" || modelId.length === 0) return null;
-  if (modelId.startsWith("claude-opus-")) return "claude-opus";
-  if (modelId.startsWith("claude-sonnet-")) return "claude-sonnet";
-  if (modelId.startsWith("claude-haiku-")) return "claude-haiku";
-  if (modelId.startsWith("gemini-") && modelId.includes("flash-lite")) {
-    return "gemini-flash-lite";
+  if (!translatorClearedToolCallCliff(phase2)) {
+    out.push(...detectArchetypePerfFloorBreach(ir, profile));
   }
-  if (modelId.startsWith("gemini-") && modelId.includes("flash")) {
-    return "gemini-flash";
+  if (policy?.posture !== "locked") {
+    out.push(...detectStaleExclusionCandidate(ir));
   }
-  if (modelId.startsWith("gemini-") && modelId.includes("pro")) {
-    return "gemini-pro";
+  if (policy?.posture !== "locked" && ir.appId) {
+    out.push(
+      ...advisorRulePromoteReady({
+        appId: ir.appId,
+        archetype: ir.intent.archetype,
+        resolvedPrimary: profile.id
+      })
+    );
+    out.push(...advisorRuleConsumerOnStaleModel(ir));
   }
-  if (modelId.startsWith("deepseek-") && modelId.includes("pro")) {
-    return "deepseek-reasoner";
+  if (policy?.posture !== "locked") {
+    out.push(
+      ...advisorRuleCrossFamilyFit({
+        archetype: ir.intent.archetype,
+        resolvedPrimary: profile.id
+      })
+    );
   }
-  if (modelId.startsWith("deepseek-")) return "deepseek-chat";
-  if (modelId.startsWith("gpt-")) return "openai-gpt";
-  return null;
+  return out;
 }
-function familyOf(profile) {
-  return profile.family ?? deriveFamilyFromModelId(profile.id);
+function translatorClearedToolCallCliff(phase2) {
+  const rewrites = phase2?.sectionRewritesApplied;
+  if (!rewrites || rewrites.length === 0) return false;
+  for (const rw of rewrites) {
+    if (rw.kind === "tool_call_contract") return true;
+  }
+  return false;
+}
+function detectCachingOff(ir, profile) {
+  if (profile.provider !== "anthropic") return [];
+  const totalChars = ir.sections.reduce((s, sec) => s + sec.text.length, 0);
+  if (totalChars < 2e3) return [];
+  const anyCacheable = ir.sections.some((s) => s.cacheable === true);
+  if (anyCacheable) return [];
+  return [
+    {
+      level: "warn",
+      code: "caching-off-on-claude",
+      message: `System prompt is ${totalChars} chars on Anthropic but no PromptSection has cacheable=true. Anthropic prompt caching cuts cached-prefix input cost by ~90% on subsequent calls; without it, every turn re-pays full price for the static system context.`,
+      suggestion: "Mark stable system sections (role, persona, tool policy) with `cacheable: true`. The lowering pass concatenates cacheable sections into a single cache-controlled block before the dynamic ones.",
+      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
+    }
+  ];
+}
+function detectSingleChunkSystem(ir, profile) {
+  if (profile.provider !== "anthropic") return [];
+  if (ir.sections.length !== 1) return [];
+  const only = ir.sections[0];
+  if (!only || only.text.length <= 1e3) return [];
+  return [
+    {
+      level: "info",
+      code: "single-chunk-system",
+      message: `System prompt is a single ${only.text.length}-char chunk. Splitting into NamedChunks (static role/persona vs dynamic context) gives the lowering pass a finer cache-marker boundary \u2014 only the static portion needs to be byte-stable for the cache to hit.`,
+      suggestion: "Refactor the system builder to return an array of `PromptSection` shaped { id, text, cacheable?: boolean }. Static chunks (role, persona, tool policy) get `cacheable: true`; dynamic ones (current context, today's date) don't.",
+      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
+    }
+  ];
+}
+function detectToolBloat(ir, result) {
+  const SHORT_OUTPUT = /* @__PURE__ */ new Set([
+    "classify",
+    "extract",
+    "summarize",
+    "transform",
+    "critique"
+  ]);
+  if (!ir.tools || ir.tools.length === 0) return [];
+  const toolsKept = result.diagnostics.toolsKept;
+  if (toolsKept <= 10) return [];
+  if (!SHORT_OUTPUT.has(ir.intent.archetype)) return [];
+  return [
+    {
+      level: "warn",
+      code: "tool-bloat",
+      message: `${toolsKept} tools kept after the relevance pass for archetype="${ir.intent.archetype}" (consumer declared ${ir.tools.length}). This archetype is short-output and rarely needs more than 3 tools; each tool definition eats ~350 tokens of context budget.`,
+      suggestion: "Tighten `relevanceByIntent: { [archetype]: 0..1 }` per ToolDefinition. Tools below `toolRelevanceThreshold` (default 0.2) get dropped. Without `relevanceByIntent`, every tool defaults to neutral (0.5) and stays.",
+      docsUrl: "https://github.com/stue/kgauto/blob/main/v2/README.md#tools"
+    }
+  ];
+}
+function detectHistoryUncached(ir, profile) {
+  if (profile.provider !== "anthropic") return [];
+  if (!ir.history || ir.history.length < 2) return [];
+  if (ir.historyCachePolicy && ir.historyCachePolicy.strategy !== "none") {
+    return [];
+  }
+  return [
+    {
+      level: "warn",
+      code: "history-uncached-on-claude",
+      message: `${ir.history.length} history messages on Anthropic with no historyCachePolicy. Every turn re-pays for the full conversation context; with caching, subsequent turns hit the cache at ~10% the input cost.`,
+      suggestion: "Set `historyCachePolicy: { strategy: 'all-but-latest' }` on this IR. The lowering pass marks the message immediately preceding currentTurn with cache_control; subsequent turns whose history prefix matches byte-for-byte hit the cache.",
+      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
+    }
+  ];
+}
+function detectSingleModelArray(ir, policy) {
+  if (ir.models.length !== 1) return [];
+  if (policy?.posture === "locked") return [];
+  const only = ir.models[0];
+  return [
+    {
+      level: "warn",
+      code: "single-model-array",
+      message: `\`ir.models\` has length 1 (only "${only}") and posture is not 'locked'. A single-model chain has no safety net \u2014 the first 429 / 5xx / cliff hits the user as a failure. Master plan \xA71.2 closes the reliability gap with a 2-step minimum.`,
+      suggestion: "Use `getDefaultFallbackChain({ archetype: ir.intent.archetype, primary: '" + only + "', posture: 'preferred' })` for a user-anchored chain, or `getDefaultFallbackChain({ archetype, posture: 'open' })` for library-picked. If single-model is intentional (compliance/brand promise), set `policy.posture = 'locked'` to silence this rule.",
+      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#single-model-array"
+    }
+  ];
+}
+function detectCostMismatchedArchetype(ir, profile, phase2) {
+  if (!phase2 || phase2.fallbackChain.length === 0) return [];
+  if (!phase2.profileResolver) return [];
+  const archetype = ir.intent.archetype;
+  const chosenScore = getArchetypePerfScore(profile.id, archetype);
+  const chosenHasRoomToGrow = chosenScore.grounding === "judgment" || chosenScore.score < COST_MISMATCHED_CHOSEN_SCORE_CEILING;
+  if (!chosenHasRoomToGrow) return [];
+  let bestAlt = null;
+  for (const altId of phase2.fallbackChain) {
+    const altProfile = phase2.profileResolver(altId);
+    if (!altProfile) continue;
+    if (altProfile.id === profile.id) continue;
+    const altScore = getArchetypePerfScore(altProfile.id, archetype);
+    if (altScore.score < QUALITY_FLOOR_FOR_RECOMMENDATION) continue;
+    if (altScore.score < chosenScore.score) continue;
+    if (altProfile.costInputPer1m >= profile.costInputPer1m) continue;
+    if (!bestAlt || altScore.score > bestAlt.score.score || altScore.score === bestAlt.score.score && altProfile.costInputPer1m < bestAlt.profile.costInputPer1m) {
+      bestAlt = { id: altId, profile: altProfile, score: altScore };
+    }
+  }
+  if (!bestAlt) return [];
+  const tierDownWouldFire = bestAlt.score.grounding === "measured" && bestAlt.profile.costInputPer1m <= profile.costInputPer1m * TIER_DOWN_COST_RATIO;
+  if (tierDownWouldFire) return [];
+  const chosenGrounding = chosenScore.grounding === "judgment" ? `archetypePerf.${archetype}=judgment` : `archetypePerf.${archetype}=${chosenScore.score}`;
+  const altGrounding = bestAlt.score.grounding === "measured" ? `archetypePerf.${archetype}=${bestAlt.score.score}, measured, n=${bestAlt.score.n}` : `archetypePerf.${archetype}=${bestAlt.score.score}, judgment`;
+  return [
+    {
+      level: "warn",
+      code: "cost-mismatched-archetype",
+      message: `Cost-mismatched-archetype: target=${profile.id} (${chosenGrounding}) selected for ${archetype}. Alternative ${bestAlt.id} (${altGrounding}) is cheaper ($${bestAlt.profile.costInputPer1m}/$${bestAlt.profile.costOutputPer1m} vs $${profile.costInputPer1m}/$${profile.costOutputPer1m} per 1M) at equal-or-better quality.`,
+      suggestion: `Consider declaring \`${bestAlt.id}\` as the primary model for this archetype, or relax to posture='open' to let kgauto select among the chain. If the chosen model is required for compliance/brand reasons, set \`policy.posture = 'locked'\` to silence this rule.`,
+      recommendationType: profile.provider === bestAlt.profile.provider ? "tier-down" : "model-swap",
+      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
+    }
+  ];
 }
-function archetypePerfFor(profile, archetype) {
-  if (!archetype) return 0;
-  const score = profile.archetypePerf?.[archetype];
-  return typeof score === "number" ? score : 5;
+function detectModelStaleEvidence(ir, profile) {
+  if (!isBrainQueryActiveFor("kgauto_archetype_perf")) return [];
+  const archetype = ir.intent.archetype;
+  const chosen = getArchetypePerfScore(profile.id, archetype);
+  if (chosen.grounding !== "judgment") return [];
+  return [
+    {
+      level: "info",
+      code: "model-stale-evidence",
+      message: `Model-stale-evidence: target=${profile.id} archetype=${archetype} is judgment-grounded (n=${chosen.n}) despite brain-query mode being active. Measurement substrate is wired but the brain hasn't accumulated >=10 outcomes for this (model, archetype) tuple yet \u2014 routing decisions remain pre-measured for this slot.`,
+      suggestion: "Verify that `record()` is being called on every call() outcome with the appropriate `actualModel` and `mutationsApplied` fields. Once the brain accumulates n>=10 rows on this tuple, the score promotes from judgment to measured automatically (5-min SWR cache). No code change required from your side \u2014 this is the substrate signaling the gap.",
+      recommendationType: "prompt-fix",
+      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
+    }
+  ];
 }
-function selectCandidates(registry, family, archetype, appId) {
-  const out = [];
-  const excluded = /* @__PURE__ */ new Set();
-  if (appId && archetype) {
-    const findings = getStaleExclusionFindings({ appId, archetype });
-    for (const f of findings) {
-      if (f.verdict === "stay-excluded") excluded.add(f.excludedModel);
+function detectTierDown(ir, profile, phase2) {
+  if (!phase2 || phase2.fallbackChain.length === 0) return [];
+  if (!phase2.profileResolver) return [];
+  const archetype = ir.intent.archetype;
+  const chosenScore = getArchetypePerfScore(profile.id, archetype);
+  const chosenCost = profile.costInputPer1m;
+  let bestAlt = null;
+  for (const altId of phase2.fallbackChain) {
+    const altProfile = phase2.profileResolver(altId);
+    if (!altProfile) continue;
+    if (altProfile.id === profile.id) continue;
+    const altScore = getArchetypePerfScore(altProfile.id, archetype);
+    if (altScore.grounding !== "measured") continue;
+    if (altScore.score < QUALITY_FLOOR_FOR_RECOMMENDATION) continue;
+    if (altScore.score < chosenScore.score) continue;
+    if (altProfile.costInputPer1m > chosenCost * TIER_DOWN_COST_RATIO) continue;
+    if (!bestAlt || altProfile.costInputPer1m < bestAlt.profile.costInputPer1m || altProfile.costInputPer1m === bestAlt.profile.costInputPer1m && altScore.score > bestAlt.score.score) {
+      bestAlt = { id: altId, profile: altProfile, score: altScore };
     }
   }
-  for (const profile of registry.values()) {
-    if (familyOf(profile) !== family) continue;
-    if (profile.status !== "current") continue;
-    if (profile.active === false) continue;
-    if (archetype) {
-      if (archetypePerfFor(profile, archetype) < ARCHETYPE_FLOOR_DEFAULT) continue;
+  if (!bestAlt) return [];
+  const chosenDesc = chosenScore.grounding === "measured" ? `archetypePerf.${archetype}=${chosenScore.score} (measured, n=${chosenScore.n})` : `archetypePerf.${archetype}=${chosenScore.score} (${chosenScore.grounding})`;
+  return [
+    {
+      level: "warn",
+      code: "tier-down",
+      message: `Tier-down: target=${profile.id} (${chosenDesc}) selected for ${archetype}. Brain shows ${bestAlt.id} delivers equal-or-better quality (archetypePerf.${archetype}=${bestAlt.score.score}, measured, n=${bestAlt.score.n}) at $${bestAlt.profile.costInputPer1m}/$${bestAlt.profile.costOutputPer1m} per 1M vs $${profile.costInputPer1m}/$${profile.costOutputPer1m} \u2014 a measured tier-down opportunity.`,
+      suggestion: `Move \`${bestAlt.id}\` to primary for this archetype. The brain has n=${bestAlt.score.n} measured outcomes backing the recommendation; this is data, not opinion. If posture='locked' is required (compliance/brand promise), set it explicitly to silence this rule.`,
+      recommendationType: "tier-down",
+      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
     }
-    if (excluded.has(profile.id)) continue;
-    out.push(profile);
+  ];
+}
+function detectArchetypePerfFloorBreach(ir, profile) {
+  const compat = getModelCompatibility(profile.id, {
+    archetype: ir.intent.archetype,
+    toolOrchestration: ir.constraints?.toolOrchestration
+  });
+  if (compat.status === "compatible") return [];
+  if (compat.status === "requires-adapter") {
+    return [
+      {
+        level: "warn",
+        code: "archetype-perf-floor-breach",
+        message: `${profile.id} sits below the archetype floor for ${ir.intent.archetype} (score ${compat.archetypePerf}/10, floor ${6}). A known adapter would lift it: ${compat.adapter.parameter}=${compat.adapter.value}. ${compat.adapter.consequence}`,
+        suggestion: `Pass \`ir.constraints.${compat.adapter.parameter} = '${compat.adapter.value}'\` for this call, OR pick a model whose archetypePerf for ${ir.intent.archetype} already clears the floor (call \`getModelCompatibility(modelId, { archetype: '${ir.intent.archetype}' })\` to check). Estimated post-adapter score: ${compat.archetypePerfWithAdapter}/10.`,
+        recommendationType: "prompt-fix",
+        suggestedAdaptation: compat.adapter,
+        docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
+      }
+    ];
   }
-  return out;
+  return [
+    {
+      level: "critical",
+      code: "archetype-perf-floor-breach",
+      message: `${profile.id} sits below the archetype floor for ${ir.intent.archetype} (score ${compat.archetypePerf}/10, floor ${6}) and no known adapter would lift it. ${compat.reason}`,
+      suggestion: `Swap to a model whose archetypePerf for ${ir.intent.archetype} clears the floor. Use \`getModelCompatibility(candidateId, { archetype: '${ir.intent.archetype}' })\` to vet candidates, or \`getDefaultFallbackChain({ archetype: '${ir.intent.archetype}', posture: 'open' })\` for a library-picked chain that respects the floor by construction.`,
+      recommendationType: "model-swap",
+      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
+    }
+  ];
 }
-function sortCandidates(candidates, archetype) {
-  const sorted = [...candidates];
-  sorted.sort((a, b) => {
-    const perfA = archetypePerfFor(a, archetype);
-    const perfB = archetypePerfFor(b, archetype);
-    if (perfA !== perfB) return perfB - perfA;
-    const vA = a.versionAdded ?? "";
-    const vB = b.versionAdded ?? "";
-    if (vA !== vB) return vA < vB ? 1 : -1;
-    return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+function detectStaleExclusionCandidate(ir) {
+  if (!isExclusionFindingsBrainActive()) return [];
+  if (!ir.appId) return [];
+  const findings = getStaleExclusionFindings({
+    appId: ir.appId,
+    archetype: ir.intent.archetype
   });
-  return sorted;
+  if (findings.length === 0) return [];
+  const ranked = [...findings].sort((a, b) => {
+    const sa = a.estimatedSavingsUsd30d ?? -Infinity;
+    const sb = b.estimatedSavingsUsd30d ?? -Infinity;
+    if (sa !== sb) return sb - sa;
+    return confidenceRank(b.confidence) - confidenceRank(a.confidence);
+  });
+  const top = ranked[0];
+  const extraCount = findings.length - 1;
+  const extraNote = extraCount > 0 ? ` (+ ${extraCount} more excluded model${extraCount === 1 ? "" : "s"} for this archetype)` : "";
+  return [
+    {
+      level: "info",
+      code: "stale-exclusion-candidate",
+      message: `${top.message}${extraNote}`,
+      suggestion: top.suggestion,
+      recommendationType: "tier-down",
+      docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
+    }
+  ];
 }
-function getRecommendedPrimary(opts) {
-  if (opts.posture === "locked") return opts.fallback;
-  const registry = loadModelsFromBrain();
-  const candidates = selectCandidates(
-    registry,
-    opts.family,
-    opts.archetype,
-    opts.appId
-  );
-  if (candidates.length === 0) return opts.fallback;
-  const sorted = sortCandidates(candidates, opts.archetype);
-  return sorted[0]?.id ?? opts.fallback;
+function confidenceRank(c) {
+  if (c === "high") return 3;
+  if (c === "medium") return 2;
+  return 1;
 }
-function resolveFamilyEntry(family, ctx) {
-  if (typeof family !== "string" || family.length === 0) {
-    throw new FamilyResolutionError(
-      String(family),
-      "Family tag must be a non-empty string"
-    );
+
+// src/translator.ts
+var TRANSLATOR_FLOOR = ARCHETYPE_FLOOR_DEFAULT;
+var RULE_SEQUENTIAL_TOOL_CLIFF = "sequential-tool-cliff-below-floor";
+var RULE_NARRATION_DRIFT_ANTHROPIC = "narration-drift-anthropic";
+var RULE_NARRATION_THINKING_LEAK_DEEPSEEK = "narration-thinking-leak-deepseek";
+var SEQUENTIAL_TOOL_PREAMBLE = "IMPORTANT: Use one tool call per response. Wait for the tool result before deciding the next tool. Do NOT batch tool calls in parallel.";
+var NARRATION_DRIFT_ANTHROPIC_PREAMBLE = "Output ONLY the requested content. Do not narrate your thought process. Each line \u2264 12 words.";
+var NARRATION_THINKING_LEAK_DEEPSEEK_PREAMBLE = "Reasoning is internal. Output ONLY the requested content; do not emit <thinking> blocks or internal monologue as user-facing text.";
+function matchRule(kind, profile, archetype) {
+  if (kind === "tool_call_contract") {
+    if (!profile.archetypePerf) return null;
+    const archetypeScore = profile.archetypePerf[archetype];
+    if (typeof archetypeScore !== "number" || archetypeScore >= TRANSLATOR_FLOOR) {
+      return null;
+    }
+    return {
+      id: RULE_SEQUENTIAL_TOOL_CLIFF,
+      preamble: SEQUENTIAL_TOOL_PREAMBLE,
+      wireOverrides: { parallelToolCalls: false }
+    };
   }
-  const registry = loadModelsFromBrain();
-  const candidates = selectCandidates(
-    registry,
-    family,
-    ctx.archetype,
-    ctx.appId
-  );
-  if (candidates.length === 0) {
-    let anyInFamily = false;
-    for (const profile of registry.values()) {
-      if (familyOf(profile) === family) {
-        anyInFamily = true;
-        break;
-      }
+  if (kind === "narration_contract") {
+    if (profile.provider === "anthropic") {
+      return {
+        id: RULE_NARRATION_DRIFT_ANTHROPIC,
+        preamble: NARRATION_DRIFT_ANTHROPIC_PREAMBLE
+      };
     }
-    const cause = anyInFamily ? `Family has registered models but none are current+active${ctx.archetype ? ` at archetype-perf >= ${ARCHETYPE_FLOOR_DEFAULT} for "${ctx.archetype}"` : ""}${ctx.appId ? ` and not excluded for app "${ctx.appId}"` : ""}` : `No models in brain registry carry family="${family}". Check the taxonomy table in family-resolution.ts or migration 024`;
-    throw new FamilyResolutionError(family, cause);
+    if (profile.provider === "deepseek") {
+      return {
+        id: RULE_NARRATION_THINKING_LEAK_DEEPSEEK,
+        preamble: NARRATION_THINKING_LEAK_DEEPSEEK_PREAMBLE
+      };
+    }
+    return null;
   }
-  const sorted = sortCandidates(candidates, ctx.archetype);
-  const winner = sorted[0];
-  if (!winner) {
-    throw new FamilyResolutionError(
-      family,
-      "Candidates non-empty but sort returned undefined \u2014 internal invariant violation"
-    );
+  return null;
+}
+function applySectionRewrites(args) {
+  const { ir, profile, archetype } = args;
+  if (!Array.isArray(ir.sections) || ir.sections.length === 0) {
+    return { rewrittenIR: ir, rewrites: [] };
   }
-  return winner.id;
+  const rewrites = [];
+  const newSections = ir.sections.map((section) => {
+    if (!section.kind || section.kind === "arbitrary") return section;
+    const rule = matchRule(section.kind, profile, archetype);
+    if (!rule) return section;
+    const originalText = section.text;
+    const transformedText = `${rule.preamble}
+
+${originalText}`;
+    rewrites.push({
+      sectionId: section.id,
+      kind: section.kind,
+      rule: rule.id,
+      originalText,
+      transformedText,
+      ...rule.wireOverrides ? { wireOverrides: rule.wireOverrides } : {}
+    });
+    return { ...section, text: transformedText };
+  });
+  if (rewrites.length === 0) {
+    return { rewrittenIR: ir, rewrites: [] };
+  }
+  const rewrittenIR = { ...ir, sections: newSections };
+  return { rewrittenIR, rewrites };
 }
 
 // src/compile.ts
@@ -1974,6 +2230,9 @@ function compile(ir, opts = {}) {
   const cliffs = passApplyCliffs(workingIR, profile, inputTokens);
   workingIR = cliffs.value.ir;
   accumulatedMutations.push(...cliffs.mutations);
+  const conventions = passApplyConventions(workingIR, profile);
+  workingIR = conventions.value.ir;
+  accumulatedMutations.push(...conventions.mutations);
   const translated = applySectionRewrites({
     ir: workingIR,
     profile,
@@ -2025,7 +2284,15 @@ function compile(ir, opts = {}) {
     toolOrchestration: ir.constraints?.toolOrchestration,
     // alpha.33 — see top-of-block comment.
     historyCacheMarkIndex,
-    systemCacheMarkIndex
+    systemCacheMarkIndex,
+    // alpha.43 — cliff-style warnings emitted by passApplyConventions.
+    // Merge convention-pass cliffWarnings with any cliff-guard quality
+    // warnings the cliff pass surfaced (the same shape — informational
+    // text the consumer can route on without changing behavior).
+    cliffWarnings: [
+      ...cliffs.value.loweringHints.qualityWarning ?? [],
+      ...conventions.value.cliffWarnings
+    ]
   };
   if (ir.intent.archetype === "hunt" && ir.constraints?.toolOrchestration === "sequential") {
     accumulatedMutations.push({
@@ -2042,7 +2309,7 @@ function compile(ir, opts = {}) {
       return void 0;
     }
   } : tryGetProfile;
-  const advisories = runAdvisor(
+  const rawAdvisories = runAdvisor(
     ir,
     {
       target: profile.id,
@@ -2063,6 +2330,11 @@ function compile(ir, opts = {}) {
       sectionRewritesApplied
     }
   );
+  const advisories = rawAdvisories.map((a) => ({
+    ...a,
+    kgautoRequestId: handle,
+    ownership: deriveOwnership(a.code, a.ownership)
+  }));
   return {
     handle,
     target: profile.id,
@@ -3904,6 +4176,7 @@ export {
   ABSOLUTE_FLOOR,
   ALIASES,
   ALL_ARCHETYPES,
+  ARCHETYPE_FAMILY_FITS,
   ARCHETYPE_FLOOR_DEFAULT,
   CallError,
   DEFAULT_FINDINGS_ENDPOINT,
@@ -3911,10 +4184,12 @@ export {
   FamilyResolutionError,
   INTENT_ARCHETYPES,
   MEASURED_GROUNDING_MIN_N,
+  PRODUCER_OWNED_RULE_CODES,
   PROVIDER_ENV_KEYS,
   RULE_SEQUENTIAL_TOOL_CLIFF,
   TRANSLATOR_FLOOR,
   allProfiles,
+  applyArchetypeConvention,
   applySectionRewrites,
   attachCacheControlToStreamTextInput,
   bucketContext,
@@ -3927,7 +4202,9 @@ export {
   configureBrain,
   countTokens,
   deriveFamilyFromModelId,
+  deriveOwnership,
   execute,
+  findBetterFit,
   getActionableAdvisories,
   getAllStarterChains,
   getAllStarterChainsWithGrounding,
@@ -3962,9 +4239,11 @@ export {
   markPromoteReadyHandled,
   profileToRow,
   profilesByProvider,
+  readBrainReadEnv,
   record,
   recordOutcome,
   resetTokenizer,
+  resolveConventionsForProfile,
   resolvePricingAt,
   resolveProviderKey,
   runAdvisor,