@warmdrift/kgauto-compiler 2.0.0-alpha.70 → 2.0.0-alpha.71

package/dist/{chunk-FR4DNGLW.mjs → chunk-URFQR3SB.mjs}

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

package/dist/glassbox/index.d.mts

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

package/dist/glassbox/index.d.ts

@@ -1,6 +1,6 @@
-import { G as GlassboxEvent } from '../types-Bon96eyc.js';
-export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-Bon96eyc.js';
-import '../ir-Bvlkw5ja.js';
+import { G as GlassboxEvent } from '../types-B--CYzMo.js';
+export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-B--CYzMo.js';
+import '../ir-BEQ28muo.js';
 import '../dialect.js';
 
 /**

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

@@ -1,5 +1,5 @@
-import { T as TraceHealth } from '../types-CwGhacGT.mjs';
-import '../ir-Bqn1RVdV.mjs';
+import { T as TraceHealth } from '../types-DeGRCTlJ.mjs';
+import '../ir-CnnJST_N.mjs';
 import '../dialect.mjs';
 
 /**

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

@@ -1,5 +1,5 @@
-import { T as TraceHealth } from '../types-DIxRZ3Dj.js';
-import '../ir-Bvlkw5ja.js';
+import { T as TraceHealth } from '../types-DSeJJ6tt.js';
+import '../ir-BEQ28muo.js';
 import '../dialect.js';
 
 /**

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

@@ -1,7 +1,7 @@
-import { G as GlassboxEvent } from '../types-DsEq35WY.mjs';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-CwGhacGT.mjs';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-CwGhacGT.mjs';
-import '../ir-Bqn1RVdV.mjs';
+import { G as GlassboxEvent } from '../types-BDFrJkma.mjs';
+import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-DeGRCTlJ.mjs';
+export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-DeGRCTlJ.mjs';
+import '../ir-CnnJST_N.mjs';
 import '../dialect.mjs';
 
 /**

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

@@ -1,7 +1,7 @@
-import { G as GlassboxEvent } from '../types-Bon96eyc.js';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-DIxRZ3Dj.js';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-DIxRZ3Dj.js';
-import '../ir-Bvlkw5ja.js';
+import { G as GlassboxEvent } from '../types-B--CYzMo.js';
+import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-DSeJJ6tt.js';
+export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-DSeJJ6tt.js';
+import '../ir-BEQ28muo.js';
 import '../dialect.js';
 
 /**

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

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { a as TraceDetail } from '../../types-CwGhacGT.mjs';
-import '../../ir-Bqn1RVdV.mjs';
+import { a as TraceDetail } from '../../types-DeGRCTlJ.mjs';
+import '../../ir-CnnJST_N.mjs';
 import '../../dialect.mjs';
 
 /**

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

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { a as TraceDetail } from '../../types-DIxRZ3Dj.js';
-import '../../ir-Bvlkw5ja.js';
+import { a as TraceDetail } from '../../types-DSeJJ6tt.js';
+import '../../ir-BEQ28muo.js';
 import '../../dialect.js';
 
 /**

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-Bqn1RVdV.mjs';
-export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, F as FallbackReason, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as parseGoldenCaptureRate, K as resolveGoldenCaptureRate, L as shouldCaptureGolden } from './ir-Bqn1RVdV.mjs';
+import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-CnnJST_N.mjs';
+export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, F as FallbackReason, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as parseGoldenCaptureRate, K as resolveGoldenCaptureRate, L as shouldCaptureGolden } from './ir-CnnJST_N.mjs';
 import { ModelProfile, ArchetypeConvention } from './profiles.mjs';
 export { ALIASES, CacheStrategy, CliffRule, LATENCY_TIER_MS, LatencyTier, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, latencyTierOf, profilesByProvider, tryGetProfile } from './profiles.mjs';
 export { BrainForwardConfig, BrainForwardRoutes, createBrainForwardRoutes } from './brain-proxy.mjs';
@@ -649,6 +649,12 @@ interface OutcomePayload {
     system_prompt_chars?: number;
     fell_over_from?: string;
     fallback_reason?: 'rate_limit' | 'provider_auth_failed' | 'provider_error' | 'cliff' | 'cost_cap' | 'contract_violation';
+    /**
+     * alpha.71 (migration 044) — the precise `errorCode` behind
+     * `fallback_reason`. Key OMITTED when no fallback fired, so brains that
+     * haven't applied 044 never see it.
+     */
+    fell_over_error_code?: string;
     /**
      * True when the same-model retry (CallOptions.sameModelRetry) fired
      * during this call. Key OMITTED (not false) when no retry fired — safe
@@ -1003,7 +1009,7 @@ declare function runGoldenEval(opts: GoldenEvalOptions): Promise<GoldenEvalRunRe
  * guard in `tests/version.test.ts` fails the suite (and therefore
  * `prepublishOnly`) when they diverge — a stale constant cannot reach npm.
  */
-declare const LIBRARY_VERSION = "2.0.0-alpha.70";
+declare const LIBRARY_VERSION = "2.0.0-alpha.71";
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-Bvlkw5ja.js';
-export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, F as FallbackReason, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as parseGoldenCaptureRate, K as resolveGoldenCaptureRate, L as shouldCaptureGolden } from './ir-Bvlkw5ja.js';
+import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-BEQ28muo.js';
+export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, F as FallbackReason, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as parseGoldenCaptureRate, K as resolveGoldenCaptureRate, L as shouldCaptureGolden } from './ir-BEQ28muo.js';
 import { ModelProfile, ArchetypeConvention } from './profiles.js';
 export { ALIASES, CacheStrategy, CliffRule, LATENCY_TIER_MS, LatencyTier, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, latencyTierOf, profilesByProvider, tryGetProfile } from './profiles.js';
 export { BrainForwardConfig, BrainForwardRoutes, createBrainForwardRoutes } from './brain-proxy.js';
@@ -649,6 +649,12 @@ interface OutcomePayload {
     system_prompt_chars?: number;
     fell_over_from?: string;
     fallback_reason?: 'rate_limit' | 'provider_auth_failed' | 'provider_error' | 'cliff' | 'cost_cap' | 'contract_violation';
+    /**
+     * alpha.71 (migration 044) — the precise `errorCode` behind
+     * `fallback_reason`. Key OMITTED when no fallback fired, so brains that
+     * haven't applied 044 never see it.
+     */
+    fell_over_error_code?: string;
     /**
      * True when the same-model retry (CallOptions.sameModelRetry) fired
      * during this call. Key OMITTED (not false) when no retry fired — safe
@@ -1003,7 +1009,7 @@ declare function runGoldenEval(opts: GoldenEvalOptions): Promise<GoldenEvalRunRe
  * guard in `tests/version.test.ts` fails the suite (and therefore
  * `prepublishOnly`) when they diverge — a stale constant cannot reach npm.
  */
-declare const LIBRARY_VERSION = "2.0.0-alpha.70";
+declare const LIBRARY_VERSION = "2.0.0-alpha.71";
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.

package/dist/index.js

@@ -5548,6 +5548,10 @@ function buildPayload(input, reg) {
     system_prompt_chars: input.systemPromptChars ?? reg?.systemPromptChars,
     fell_over_from: fellOverFrom,
     fallback_reason: fallbackReason,
+    // alpha.71 — migration 044. The PRECISE code behind `fallback_reason`,
+    // which collapses two opposite-remedy failures into 'cliff'. Omitted
+    // (not null) when no fallback fired, so pre-044 brains never see the key.
+    fell_over_error_code: fellOverFrom ? input.fellOverErrorCode : void 0,
     // alpha.66 — omitted-undefined keeps the key out of the JSON body
     // entirely for non-retry rows (pre-migration-039 brain safety).
     retried_same_model: input.retriedSameModel,
@@ -7353,6 +7357,7 @@ async function call(ir, opts = {}) {
       );
       const fellOver = targetModel !== initial.target;
       const fallbackReason = fellOver ? normalizeFallbackReason(attempts) : void 0;
+      const fellOverErrorCode = fellOver ? firstFailureErrorCode(attempts) : void 0;
       const goldenRate = resolveGoldenCaptureRate(opts.goldenCapture?.sampleRate);
       const goldenShapeKey = goldenRate > 0 ? peekRegisteredShapeKey(initial.handle) : void 0;
       await record({
@@ -7379,6 +7384,9 @@ async function call(ir, opts = {}) {
         totalMs: latencyMs2,
         fellOverFrom: fellOver ? initial.target : void 0,
         fallbackReason,
+        // alpha.71 — migration 044. Omitted when no fallback fired, so
+        // pre-044 brains never see the key.
+        fellOverErrorCode,
         // alpha.66 — migration 039. Omitted (not false) when no retry fired
         // so pre-039 brains never see the key.
         retriedSameModel: retriedSameModel || void 0
@@ -7439,6 +7447,7 @@ async function call(ir, opts = {}) {
         servedBy: targetModel,
         fellOverFrom: fellOver ? initial.target : void 0,
         fallbackReason,
+        fellOverErrorCode,
         retriedSameModel: retriedSameModel || void 0,
         unreachableFiltered,
         policyBlockedFiltered,
@@ -7774,6 +7783,9 @@ function raiseOutputBudget(request, profile) {
   }
   return request;
 }
+function firstFailureErrorCode(attempts) {
+  return attempts.find((a) => a.status !== "success")?.errorCode;
+}
 function normalizeFallbackReason(attempts) {
   const first = attempts.find((a) => a.status !== "success");
   if (!first) return void 0;
@@ -8159,7 +8171,20 @@ async function runGoldenEval(opts) {
         })
       },
       models: [judgeModel],
-      constraints: { forceModel: judgeModel }
+      // alpha.70 — declare the judge's output shape truthfully. The role
+      // section says "You output only JSON" and `parseJudgeVerdict` parses
+      // exactly that, but nothing in the IR SAID so: no `structuredOutput`,
+      // no tools ⇒ `resolveOutputMode` inferred 'text'. That made the judge
+      // eligible for the alpha.68 shape-altering discipline gates — inside
+      // the very engine Release B would use to measure those gates, where a
+      // gate-induced parse failure would be attributed to the gates.
+      //
+      // Deliberately `outputMode`, NOT `structuredOutput: true`: the latter
+      // would switch on kgauto's structured-output validation and change the
+      // lowered wire contract (response_format), altering judge behaviour.
+      // This declares the shape for screening purposes only — which is the
+      // exact reason the alpha.69 hatch is a separate field.
+      constraints: { forceModel: judgeModel, outputMode: "json" }
     };
     try {
       const compiled = compile(judgeIr);
@@ -8602,7 +8627,7 @@ function createBrainForwardRoutes(config) {
 }
 
 // src/version.ts
-var LIBRARY_VERSION = "2.0.0-alpha.70";
+var LIBRARY_VERSION = "2.0.0-alpha.71";
 
 // src/key-health.ts
 var JSON_HEADERS2 = { "Content-Type": "application/json" };

package/dist/index.mjs

@@ -16,7 +16,7 @@ import {
 import {
   LIBRARY_VERSION,
   createKeyHealthRoute
-} from "./chunk-FR4DNGLW.mjs";
+} from "./chunk-URFQR3SB.mjs";
 import {
   ABSOLUTE_FLOOR,
   ARCHETYPE_FLOOR_DEFAULT,
@@ -3515,6 +3515,10 @@ function buildPayload(input, reg) {
     system_prompt_chars: input.systemPromptChars ?? reg?.systemPromptChars,
     fell_over_from: fellOverFrom,
     fallback_reason: fallbackReason,
+    // alpha.71 — migration 044. The PRECISE code behind `fallback_reason`,
+    // which collapses two opposite-remedy failures into 'cliff'. Omitted
+    // (not null) when no fallback fired, so pre-044 brains never see the key.
+    fell_over_error_code: fellOverFrom ? input.fellOverErrorCode : void 0,
     // alpha.66 — omitted-undefined keeps the key out of the JSON body
     // entirely for non-retry rows (pre-migration-039 brain safety).
     retried_same_model: input.retriedSameModel,
@@ -4581,6 +4585,7 @@ async function call(ir, opts = {}) {
       );
       const fellOver = targetModel !== initial.target;
       const fallbackReason = fellOver ? normalizeFallbackReason(attempts) : void 0;
+      const fellOverErrorCode = fellOver ? firstFailureErrorCode(attempts) : void 0;
       const goldenRate = resolveGoldenCaptureRate(opts.goldenCapture?.sampleRate);
       const goldenShapeKey = goldenRate > 0 ? peekRegisteredShapeKey(initial.handle) : void 0;
       await record({
@@ -4607,6 +4612,9 @@ async function call(ir, opts = {}) {
         totalMs: latencyMs2,
         fellOverFrom: fellOver ? initial.target : void 0,
         fallbackReason,
+        // alpha.71 — migration 044. Omitted when no fallback fired, so
+        // pre-044 brains never see the key.
+        fellOverErrorCode,
         // alpha.66 — migration 039. Omitted (not false) when no retry fired
         // so pre-039 brains never see the key.
         retriedSameModel: retriedSameModel || void 0
@@ -4667,6 +4675,7 @@ async function call(ir, opts = {}) {
         servedBy: targetModel,
         fellOverFrom: fellOver ? initial.target : void 0,
         fallbackReason,
+        fellOverErrorCode,
         retriedSameModel: retriedSameModel || void 0,
         unreachableFiltered,
         policyBlockedFiltered,
@@ -5002,6 +5011,9 @@ function raiseOutputBudget(request, profile) {
   }
   return request;
 }
+function firstFailureErrorCode(attempts) {
+  return attempts.find((a) => a.status !== "success")?.errorCode;
+}
 function normalizeFallbackReason(attempts) {
   const first = attempts.find((a) => a.status !== "success");
   if (!first) return void 0;
@@ -5387,7 +5399,20 @@ async function runGoldenEval(opts) {
         })
       },
       models: [judgeModel],
-      constraints: { forceModel: judgeModel }
+      // alpha.70 — declare the judge's output shape truthfully. The role
+      // section says "You output only JSON" and `parseJudgeVerdict` parses
+      // exactly that, but nothing in the IR SAID so: no `structuredOutput`,
+      // no tools ⇒ `resolveOutputMode` inferred 'text'. That made the judge
+      // eligible for the alpha.68 shape-altering discipline gates — inside
+      // the very engine Release B would use to measure those gates, where a
+      // gate-induced parse failure would be attributed to the gates.
+      //
+      // Deliberately `outputMode`, NOT `structuredOutput: true`: the latter
+      // would switch on kgauto's structured-output validation and change the
+      // lowered wire contract (response_format), altering judge behaviour.
+      // This declares the shape for screening purposes only — which is the
+      // exact reason the alpha.69 hatch is a separate field.
+      constraints: { forceModel: judgeModel, outputMode: "json" }
     };
     try {
       const compiled = compile(judgeIr);

package/dist/{ir-Bvlkw5ja.d.ts → ir-BEQ28muo.d.ts}

@@ -1212,6 +1212,24 @@ interface CallResult {
     fellOverFrom?: string;
     /** Set only when fallback fired. Normalized cause. */
     fallbackReason?: FallbackReason;
+    /**
+     * alpha.71 — the PRECISE `errorCode` of the attempt that drove the chain,
+     * unnormalized. `fallbackReason` is a six-value summary and one of its
+     * values, `'cliff'`, absorbs two failures with OPPOSITE remedies:
+     *
+     *   - `max_tokens_on_structured_output` — the output budget was too small
+     *     for the requested shape ⇒ raise the cap / add an output-budget cliff.
+     *   - `structured_output_parse_failed`  — the model emitted non-JSON ⇒ its
+     *     declared `structuredOutput` capability is wrong for this shape.
+     *
+     * The code was already computed in `attempts[]` and thrown away at record
+     * time, so a surface could accumulate a dozen identical `'cliff'` rows that
+     * still could not tell an operator which fix applies. (Found diagnosing
+     * claude-haiku-4-5's 12-of-12 failures on playbacksam/summarize, where the
+     * measured-failure gate correctly stopped the bleeding but the evidence
+     * could not name the cause.)
+     */
+    fellOverErrorCode?: string;
     /**
      * alpha.66 — true when the one-shot same-model retry
      * (CallOptions.sameModelRetry) fired during this call, regardless of
@@ -1424,6 +1442,13 @@ interface RecordInput {
      * how often the retry rescued the call vs the chain walking anyway.
      */
     retriedSameModel?: boolean;
+    /**
+     * alpha.71 — the precise `errorCode` of the attempt that drove the chain
+     * (migration 044). Set automatically by `call()`; a consumer driving
+     * `record()` by hand may pass it. See `CallResult.fellOverErrorCode` for
+     * why the normalized `fallbackReason` is insufficient on its own.
+     */
+    fellOverErrorCode?: string;
 }
 /**
  * alpha.20 Entry 4: kinds of consumer-declared outcomes feeding the quality

package/dist/{ir-Bqn1RVdV.d.mts → ir-CnnJST_N.d.mts}

@@ -1212,6 +1212,24 @@ interface CallResult {
     fellOverFrom?: string;
     /** Set only when fallback fired. Normalized cause. */
     fallbackReason?: FallbackReason;
+    /**
+     * alpha.71 — the PRECISE `errorCode` of the attempt that drove the chain,
+     * unnormalized. `fallbackReason` is a six-value summary and one of its
+     * values, `'cliff'`, absorbs two failures with OPPOSITE remedies:
+     *
+     *   - `max_tokens_on_structured_output` — the output budget was too small
+     *     for the requested shape ⇒ raise the cap / add an output-budget cliff.
+     *   - `structured_output_parse_failed`  — the model emitted non-JSON ⇒ its
+     *     declared `structuredOutput` capability is wrong for this shape.
+     *
+     * The code was already computed in `attempts[]` and thrown away at record
+     * time, so a surface could accumulate a dozen identical `'cliff'` rows that
+     * still could not tell an operator which fix applies. (Found diagnosing
+     * claude-haiku-4-5's 12-of-12 failures on playbacksam/summarize, where the
+     * measured-failure gate correctly stopped the bleeding but the evidence
+     * could not name the cause.)
+     */
+    fellOverErrorCode?: string;
     /**
      * alpha.66 — true when the one-shot same-model retry
      * (CallOptions.sameModelRetry) fired during this call, regardless of
@@ -1424,6 +1442,13 @@ interface RecordInput {
      * how often the retry rescued the call vs the chain walking anyway.
      */
     retriedSameModel?: boolean;
+    /**
+     * alpha.71 — the precise `errorCode` of the attempt that drove the chain
+     * (migration 044). Set automatically by `call()`; a consumer driving
+     * `record()` by hand may pass it. See `CallResult.fellOverErrorCode` for
+     * why the normalized `fallbackReason` is insufficient on its own.
+     */
+    fellOverErrorCode?: string;
 }
 /**
  * alpha.20 Entry 4: kinds of consumer-declared outcomes feeding the quality

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.70";
+var LIBRARY_VERSION = "2.0.0-alpha.71";
 
 // src/key-health.ts
 var JSON_HEADERS = { "Content-Type": "application/json" };

package/dist/key-health.mjs

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

package/dist/profiles.d.mts

@@ -1,4 +1,4 @@
-import { k as Provider } from './ir-Bqn1RVdV.mjs';
+import { k as Provider } from './ir-CnnJST_N.mjs';
 import { IntentArchetypeName } from './dialect.mjs';
 
 /**

package/dist/profiles.d.ts

@@ -1,4 +1,4 @@
-import { k as Provider } from './ir-Bvlkw5ja.js';
+import { k as Provider } from './ir-BEQ28muo.js';
 import { IntentArchetypeName } from './dialect.js';
 
 /**

package/dist/{types-Bon96eyc.d.ts → types-B--CYzMo.d.ts}

@@ -1,4 +1,4 @@
-import { s as MutationApplied, B as BestPracticeAdvisory, F as FallbackReason, m as CallAttempt } from './ir-Bvlkw5ja.js';
+import { s as MutationApplied, B as BestPracticeAdvisory, F as FallbackReason, m as CallAttempt } from './ir-BEQ28muo.js';
 
 /**
  * Glass-Box observability types (alpha.17).

package/dist/{types-DsEq35WY.d.mts → types-BDFrJkma.d.mts}

@@ -1,4 +1,4 @@
-import { s as MutationApplied, B as BestPracticeAdvisory, F as FallbackReason, m as CallAttempt } from './ir-Bqn1RVdV.mjs';
+import { s as MutationApplied, B as BestPracticeAdvisory, F as FallbackReason, m as CallAttempt } from './ir-CnnJST_N.mjs';
 
 /**
  * Glass-Box observability types (alpha.17).

package/dist/{types-DIxRZ3Dj.d.ts → types-DSeJJ6tt.d.ts}

@@ -1,4 +1,4 @@
-import { i as Adapter, x as SectionKind } from './ir-Bvlkw5ja.js';
+import { i as Adapter, x as SectionKind } from './ir-BEQ28muo.js';
 
 /**
  * Internal config + hook types for createGlassboxRoutes().

package/dist/{types-CwGhacGT.d.mts → types-DeGRCTlJ.d.mts}

@@ -1,4 +1,4 @@
-import { i as Adapter, x as SectionKind } from './ir-Bqn1RVdV.mjs';
+import { i as Adapter, x as SectionKind } from './ir-CnnJST_N.mjs';
 
 /**
  * Internal config + hook types for createGlassboxRoutes().

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmdrift/kgauto-compiler",
-  "version": "2.0.0-alpha.70",
+  "version": "2.0.0-alpha.71",
   "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",