@warmdrift/kgauto-compiler 2.0.0-alpha.79 → 2.0.0-alpha.80

package/dist/index.mjs

@@ -16,17 +16,22 @@ import {
 import {
   LIBRARY_VERSION,
   createKeyHealthRoute
-} from "./chunk-DRYCOR6G.mjs";
+} from "./chunk-CIBHU67M.mjs";
 import {
   ABSOLUTE_FLOOR,
   ARCHETYPE_FLOOR_DEFAULT,
   BRAIN_READ_ENV_NAMES,
+  COST_RANKING_REFERENCE_SHAPE,
+  MEASURED_GROUNDING_MIN_N,
   PROVIDER_ENV_KEYS,
+  chainProviderSpread,
   configureBrainQuery,
   createBrainQueryCache,
   ensureCrossProviderTail,
+  estimateChainCostUsd,
   getAllStarterChains,
   getAllStarterChainsWithGrounding,
+  getArchetypePerfScore,
   getDefaultFallbackChain,
   getDefaultFallbackChainWithGrounding,
   getModelCompatibility,
@@ -40,10 +45,12 @@ import {
   isModelReachable,
   isProviderReachable,
   isSameModelRetryEnabledFromEnv,
+  loadArchetypePerfFromBrain,
+  loadArchetypePerfNFromBrain,
   loadChainsFromBrain,
   readBrainReadEnv,
   resolveProviderKey
-} from "./chunk-FT2FN6ZP.mjs";
+} from "./chunk-PMTT4H5W.mjs";
 import {
   ALIASES,
   LATENCY_TIER_MS,
@@ -1533,63 +1540,6 @@ function setNestedField(obj, path, value) {
   cursor[parts[parts.length - 1]] = value;
 }
 
-// src/archetype-perf-brain.ts
-function isPerfRow(x) {
-  if (!x || typeof x !== "object") return false;
-  const r = x;
-  return typeof r.model_id === "string" && typeof r.archetype === "string" && typeof r.perf_score === "number";
-}
-function mapRowsToPerfMap(rows) {
-  const out = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    if (!isPerfRow(row)) continue;
-    const existing = out.get(row.model_id) ?? {};
-    existing[row.archetype] = row.perf_score;
-    out.set(row.model_id, existing);
-  }
-  return out;
-}
-function mapRowsToNMap(rows) {
-  const out = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    if (!isPerfRow(row)) continue;
-    if (typeof row.n !== "number") continue;
-    const existing = out.get(row.model_id) ?? {};
-    existing[row.archetype] = row.n;
-    out.set(row.model_id, existing);
-  }
-  return out;
-}
-function bundledArchetypePerf() {
-  const out = /* @__PURE__ */ new Map();
-  for (const profile of allProfiles()) {
-    if (profile.archetypePerf) out.set(profile.id, profile.archetypePerf);
-  }
-  return out;
-}
-function bundledArchetypePerfN() {
-  return /* @__PURE__ */ new Map();
-}
-var loadArchetypePerfFromBrain = createBrainQueryCache({
-  table: "kgauto_archetype_perf",
-  mapRows: mapRowsToPerfMap,
-  bundledFallback: bundledArchetypePerf
-});
-var loadArchetypePerfNFromBrain = createBrainQueryCache(
-  {
-    table: "kgauto_archetype_perf",
-    mapRows: mapRowsToNMap,
-    bundledFallback: bundledArchetypePerfN
-  }
-);
-var MEASURED_GROUNDING_MIN_N = 10;
-function getArchetypePerfScore(modelId, archetype) {
-  const score = loadArchetypePerfFromBrain().get(modelId)?.[archetype] ?? 5;
-  const n = loadArchetypePerfNFromBrain().get(modelId)?.[archetype] ?? 0;
-  const grounding = n >= MEASURED_GROUNDING_MIN_N ? "measured" : "judgment";
-  return { score, n, grounding };
-}
-
 // src/measured-failure-brain.ts
 function coerceCount(v) {
   if (typeof v === "number") return Number.isFinite(v) ? v : null;
@@ -2542,11 +2492,37 @@ function detectSingleModelArray(ir, policy) {
       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.",
+      // alpha.80: `posture: 'preferred'` keeps the consumer's current model at
+      // position 0 and is therefore cost-neutral; `'open'` re-picks the
+      // primary and is NOT. This rule is about reliability, not cost, so both
+      // stay on offer — but the cost consequence of the second is now stated,
+      // since a reliability fix should not silently become a repricing.
+      suggestion: "Use `getDefaultFallbackChain({ archetype: ir.intent.archetype, primary: '" + only + "', posture: 'preferred' })` for a user-anchored chain \u2014 this keeps `" + only + "` as your primary and only adds fallbacks, so your cost profile is unchanged. `getDefaultFallbackChain({ archetype, posture: 'open' })` instead lets the library pick the PRIMARY, ordered by archetype performance rather than cost \u2014 check what it returns before adopting it. 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 openPostureRemedyClause(archetype, recommended, resolveProfile) {
+  const openChain = getDefaultFallbackChain({ archetype, posture: "open" });
+  const openPrimaryId = openChain[0];
+  if (!openPrimaryId) return void 0;
+  const openPrimary = resolveProfile(openPrimaryId);
+  if (!openPrimary) return void 0;
+  const openCost = estimateChainCostUsd(openPrimary);
+  const recommendedCost = estimateChainCostUsd(recommended);
+  if (openCost >= recommendedCost) return void 0;
+  const ratio = recommendedCost / openCost;
+  return ` Relaxing to \`policy.posture = 'open'\` is also viable here \u2014 it selects \`${openPrimaryId}\`, which is ${ratio >= 1.1 ? `about ${ratio.toFixed(1)}x cheaper than` : "priced comparably to"} \`${recommended.id}\` at a reference call shape. Note the library chain is ordered by archetype performance, not cost; it happens to agree with the cost recommendation for this archetype.`;
+}
+function openPostureCostWarningClause(archetype, recommended, resolveProfile) {
+  const openChain = getDefaultFallbackChain({ archetype, posture: "open" });
+  const openPrimaryId = openChain[0];
+  const openPrimary = openPrimaryId ? resolveProfile(openPrimaryId) : void 0;
+  if (!openPrimary || !openPrimaryId) return "";
+  const ratio = estimateChainCostUsd(openPrimary) / estimateChainCostUsd(recommended);
+  if (ratio < 1) return "";
+  return ` Do NOT reach for \`posture = 'open'\` as a cost fix here: the library chain is ordered by archetype performance, not cost, and would select \`${openPrimaryId}\` \u2014 roughly ${ratio.toFixed(1)}x the cost of \`${recommended.id}\`. Pass \`getDefaultFallbackChain({ archetype: '${archetype}', posture: 'open', optimizeFor: 'cost' })\` if you want a library-picked chain that is actually cost-ordered.`;
+}
 function detectCostMismatchedArchetype(ir, profile, phase2) {
   if (!phase2 || phase2.fallbackChain.length === 0) return [];
   if (!phase2.profileResolver) return [];
@@ -2596,7 +2572,12 @@ function detectCostMismatchedArchetype(ir, profile, phase2) {
       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.`,
+      // alpha.80 (tt-intel's `chain-builder-and-cost-advisories-give-opposite-answers`):
+      // this field used to offer `posture='open'` unconditionally, alongside
+      // the cheap-model swap, as if the two were equivalent remedies. They
+      // point in opposite directions. Both branches are now computed from
+      // the chain builder rather than assumed.
+      suggestion: `Consider declaring \`${bestAlt.id}\` as the primary model for this archetype.` + (openPostureRemedyClause(archetype, bestAlt.profile, phase2.profileResolver) ?? openPostureCostWarningClause(archetype, bestAlt.profile, phase2.profileResolver)) + ` 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"
     }
@@ -2675,7 +2656,12 @@ function detectArchetypePerfFloorBreach(ir, profile) {
       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.`,
+      // alpha.80: this rule's advice is correct on the QUALITY axis and was
+      // silent on cost, so a consumer reading it as a general "let the
+      // library pick" endorsement could land on a materially pricier
+      // primary. The floor recommendation stands; the axis is now named,
+      // and the cost-ordered variant is offered alongside it.
+      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 \u2014 note that chain is ordered by archetype performance, NOT cost, so it may select a pricier primary than you run today. Add \`optimizeFor: 'cost'\` for a chain that clears the same floor cheapest-first.`,
       recommendationType: "model-swap",
       docsUrl: "https://github.com/stue/command-center/blob/main/interfaces/kgauto.md#best-practice-advisories"
     }
@@ -7100,6 +7086,7 @@ export {
   ARCHETYPE_FLOOR_DEFAULT,
   BRAIN_READ_ENV_NAMES,
   COACH_CFG,
+  COST_RANKING_REFERENCE_SHAPE,
   CallError,
   DECOMPOSITION_TEMPLATES,
   DECOMPOSITION_TEMPLATES_VERSION,
@@ -7144,6 +7131,7 @@ export {
   buildShadowProbeRow,
   call,
   captureGoldenIr,
+  chainProviderSpread,
   classifyStrategyOutcome,
   clearBrain,
   combineOrderSwappedVerdicts,
@@ -7158,6 +7146,7 @@ export {
   createKeyHealthRoute,
   deriveFamilyFromModelId,
   deriveOwnership,
+  estimateChainCostUsd,
   execute,
   findBetterFit,
   flushBrainDeadLetter,

package/dist/key-health.js

@@ -25,7 +25,7 @@ __export(key_health_exports, {
 module.exports = __toCommonJS(key_health_exports);
 
 // src/version.ts
-var LIBRARY_VERSION = "2.0.0-alpha.79";
+var LIBRARY_VERSION = "2.0.0-alpha.80";
 
 // src/key-health.ts
 var JSON_HEADERS = { "Content-Type": "application/json" };

package/dist/key-health.mjs

@@ -1,6 +1,6 @@
 import {
   createKeyHealthRoute
-} from "./chunk-DRYCOR6G.mjs";
+} from "./chunk-CIBHU67M.mjs";
 export {
   createKeyHealthRoute
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmdrift/kgauto-compiler",
-  "version": "2.0.0-alpha.79",
+  "version": "2.0.0-alpha.80",
   "description": "Prompt compiler with executable provider knowledge for multi-model AI apps: normalized multi-provider transport with fallback chains, compile-time cliff guards, a curated model registry, and a telemetry flight recorder. Swap models without rewriting prompts.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",