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

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

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

package/dist/index.d.mts

@@ -965,7 +965,11 @@ type GoldenEvalAxis = 'model' | 'strategy';
  * measurable against its exact frozen bytes. The `-alt` wording is
  * EVAL-ONLY: it exists to attribute a v1 loss to wording vs mechanism
  * (§6) and never ships in a production compile. */
-type GoldenEvalStrategyId = 'discipline-gates-v1' | 'discipline-gates-v1-alt';
+type GoldenEvalStrategyId = 'discipline-gates-v1' | 'discipline-gates-v1-alt' | 'discipline-gates-v1-alt-blind';
+/** Both re-wordings of v1. Dispatch keys on this, never on a string prefix,
+ * so adding a fourth arm is one edit rather than a grep. */
+declare const ALT_STRATEGY_IDS: readonly GoldenEvalStrategyId[];
+declare function isAltStrategy(id: GoldenEvalStrategyId | undefined): boolean;
 interface GoldenEvalOptions {
     appId: string;
     archetype: string;
@@ -1085,6 +1089,45 @@ declare function altGatesBlockFor(args: {
     outputMode: 'text' | 'json' | 'tool_call';
     hasTools: boolean;
 }): string;
+declare const ALT_BLIND_TOKEN_BUDGET_BREACH: {
+    readonly ceilingTokens: 264;
+    readonly measuredTokensTextWithTools: 285;
+    readonly note: string;
+};
+declare const DISCIPLINE_GATES_V1_ALT_BLIND_HEADER = "Before stating any conclusion, run this check:";
+/**
+ * The variant matrix — and this is the ONE place this seat's judgment enters
+ * the blind arm, so it is stated rather than buried.
+ *
+ * cc's instruction: adapt MECHANICALLY where the injection format demands it,
+ * note the diff, never edit semantics. Choosing which gates to drop per
+ * surface is a selection, not an edit — the bytes of every retained gate are
+ * untouched — but the selection is still mine, so:
+ *
+ *   NO TOOLS   drops `toolPredict`. Forced, not chosen: the string opens
+ *              "When using tools" and is literally inapplicable without them.
+ *              Mirrors v1 dropping its compressed-item bullet.
+ *   STRUCTURED drops `markAssumed` ONLY. It is the sole gate whose entire
+ *              function is text in the final answer ('mark anything unchecked
+ *              as "assumed"'), which a JSON/tool_call schema has no field for
+ *              and which would corrupt the parse.
+ *
+ * The judgment call worth flagging: v1 drops TWO bullets on structured
+ * surfaces, and a stricter reading would also drop `falsify` ("state in one
+ * line") and `deviation` ("say so explicitly"), since both demand output
+ * text. I kept them. Their output demand is incidental (and conditional, for
+ * `deviation`) while their primary effect is on reasoning before the answer
+ * exists — whereas v1's dropped pair (`label`, `gap`) are purely
+ * output-shaping. Dropping three of five would leave a two-gate arm that no
+ * longer tests the same mechanism, and an arm crippled by my formatting
+ * choice would read as a wording loss that was actually a scoping loss.
+ * If the structured surface shows anomalous results, this is the first
+ * thing to re-examine.
+ */
+declare function altBlindGatesBlockFor(args: {
+    outputMode: 'text' | 'json' | 'tool_call';
+    hasTools: boolean;
+}): string;
 /**
  * The alt arm injects its block DIRECTLY as an untagged section — it must
  * not carry `kind: 'discipline_contract'`, or the translator would prepend
@@ -1094,6 +1137,14 @@ declare function altGatesBlockFor(args: {
  * no-ops — the attribution is about WORDING, and everything else is held.
  */
 declare function withAltDisciplineContract(ir: PromptIR): PromptIR;
+/**
+ * Same injection contract as `withAltDisciplineContract` — untagged section,
+ * so the translator never prepends the v1 bytes on top and the arm measures
+ * exactly one wording. Same variant inputs, so the blind arm no-ops nowhere
+ * v1 fires and fires nowhere v1 no-ops; the comparison is about WORDING and
+ * everything else is held.
+ */
+declare function withAltBlindDisciplineContract(ir: PromptIR): PromptIR;
 declare function runGoldenEval(opts: GoldenEvalOptions): Promise<GoldenEvalRunResult>;
 /**
  * Aggregate outcome of one strategy run, in gates-on terms. 'loses' is the
@@ -1107,25 +1158,54 @@ declare function classifyStrategyOutcome(r: GoldenEvalRunResult): StrategyOutcom
  * recorded as a mechanism failure would let Factor B permanently disable a
  * real capability on evidence about one author's prose.
  *
- *   v1 vs off | alt vs off | attribution
- *   ----------+------------+----------------------------------------------
- *   wins      | (not run)  | mechanism-works — ship
- *   ties      | (not run)  | no-lift — inconclusive at this n, re-eval later
- *   loses     | wins       | wording-failure — do NOT disable the mechanism
- *   loses     | loses      | mechanism-failure — well-evidenced; Factor B may disable
- *   loses     | ties/inc.  | wording-inconclusive — no disable on ambiguity
+ * THREE arms since 2026-07-29. Both re-wordings run on a v1 loss, and a win
+ * by EITHER is enough to acquit the mechanism — the question "does some
+ * wording of this work?" is answered by one existence proof, so there is no
+ * reason to require agreement between the alts.
+ *
+ *   v1 vs off | alt / alt-blind vs off | attribution
+ *   ----------+------------------------+------------------------------------
+ *   wins      | (not run)              | mechanism-works — ship
+ *   ties      | (not run)              | no-lift — inconclusive at n, re-eval
+ *   loses     | either wins            | wording-failure — do NOT disable
+ *   loses     | BOTH lose              | mechanism-failure — Factor B may disable
+ *   loses     | neither wins, not both lose | wording-inconclusive — no disable
+ *
+ * The `mechanism-failure` cell is the one that changed character. It used to
+ * rest on two wordings by one author, so a shared blind spot (the principles
+ * being the wrong principles) was invisible and the verdict was hedged. The
+ * blind arm was authored by a context-free subagent with no knowledge of this
+ * repo, the experiment, or who was asking — so a both-lose verdict now spans
+ * independent authorship and is strong on its own terms. That is exactly the
+ * gap `STRATEGY_AUTHORSHIP_LIMITATION` was written to confess, which is why
+ * the limitation text is now conditional on whether the blind arm ran.
  */
 type StrategyAttribution = 'mechanism-works' | 'no-lift' | 'wording-failure' | 'mechanism-failure' | 'wording-inconclusive' | 'inconclusive';
 interface StrategyAttributionResult {
     attribution: StrategyAttribution;
     primary: GoldenEvalRunResult;
-    /** Present ONLY when the primary lost (the loss-triggered third arm). */
+    /** Present ONLY when the primary lost (the loss-triggered arms). */
     alt?: GoldenEvalRunResult;
+    /** The independently-authored arm. Present ONLY when the primary lost. */
+    altBlind?: GoldenEvalRunResult;
     /** The authorship limitation, restated on every result so no downstream
-     * reader can cite an attribution without it. */
+     * reader can cite an attribution without it. Which string this carries
+     * depends on whether the blind arm actually ran — see below. */
     limitation: string;
 }
+/**
+ * Carried when the blind arm did NOT run — i.e. v1 won or tied, so no
+ * re-wording was measured at all and any claim about wording is unevidenced.
+ */
 declare const STRATEGY_AUTHORSHIP_LIMITATION: string;
+/**
+ * Carried when both re-wording arms ran. The shared-author caveat is GONE by
+ * construction, and saying so is the point: the previous version of this
+ * string confessed a gap that has since been closed, and a stale confession
+ * is its own kind of false statement — a reader would discount a verdict
+ * that no longer deserves discounting.
+ */
+declare const STRATEGY_AUTHORSHIP_INDEPENDENT: string;
 /**
  * Run the strategy eval with loss-triggered wording attribution: v1 first;
  * the alt arm replays ONLY on a v1 loss (mirrors the engine's retry
@@ -1146,7 +1226,7 @@ declare function runStrategyEvalWithAttribution(opts: Omit<GoldenEvalOptions, 'a
  * guard in `tests/version.test.ts` fails the suite (and therefore
  * `prepublishOnly`) when they diverge — a stale constant cannot reach npm.
  */
-declare const LIBRARY_VERSION = "2.0.0-alpha.82";
+declare const LIBRARY_VERSION = "2.0.0-alpha.83";
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.
@@ -1795,6 +1875,77 @@ interface AdvisorySuggestedFix {
  * view's snake_case columns to camelCase. See `feedback_typed_boundary_transformers.md`
  * (L-118) for the rationale.
  */
+/**
+ * The window of evidence a finding was computed from — migration 054.
+ *
+ * READ THE DISTINCTION BEFORE USING THIS. It is NOT `openedAt` /
+ * `lastObservedAt` / `observationCount`, which describe the ADVISORY (how
+ * long it has been firing, how many times the watcher ran and still saw the
+ * condition). This describes what the generator LOOKED AT.
+ *
+ * A daily cron that keeps firing on a single 29-second burst reports
+ * `observationCount: 11` spanning 11 days — the most standing-looking of
+ * standing conditions — while its evidence is one event from 11 days ago.
+ * Separating the two is the entire point.
+ *
+ * `null` when the generator did not state its window. Honest unknown; it
+ * must never be read as "not a burst". Compile-time library rules carry
+ * null legitimately — they fire on ONE call, so their evidence is the call
+ * in hand and there is no window to state.
+ */
+interface AdvisoryEvidenceWindow {
+    firstAt: string;
+    lastAt: string;
+    n: number;
+    /** `lastAt - firstAt`, precomputed so no caller re-derives it wrong. */
+    spanMs: number;
+    /**
+     * `true` when the evidence is clustered tightly enough to be ONE EVENT
+     * rather than a standing rate. See `classifyEvidenceWindow`.
+     */
+    isBurst: boolean;
+}
+/**
+ * Burst-vs-rate, computed rather than judged.
+ *
+ * Origin: tt-intel s118. A cost query showed `claude-sonnet-5` at 30% of
+ * their `ask` traffic and 80% of ask spend. Every number true, every
+ * mechanism check correct, and every correct check made them more certain
+ * the spend gate had regressed. All eleven calls sat in a 29-second window —
+ * their own prior experiment, fixed six minutes after the last one. Their
+ * formulation: **a cluster is an event, not a rate.**
+ *
+ * The rule, deliberately crude because a subtle one would need tuning per
+ * rule and would then be wrong per rule: evidence is a burst when it spans
+ * less than `BURST_SPAN_MS` (5 minutes). Multiple observations inside five
+ * minutes are one incident — a deploy, a retry storm, a test run, a
+ * benchmark — not a pattern of behavior over time.
+ *
+ * Two deliberate non-features:
+ *
+ * - **n is not in the test.** Two rows 4 minutes apart are as much a single
+ *   event as eleven are. Requiring a minimum n would let the smallest, least
+ *   evidenced findings skip the check.
+ * - **It does not try to detect fossils.** A burst is not necessarily stale;
+ *   it is merely not a rate. Only the consumer's own deploy log can turn
+ *   "one event" into "an event we already fixed", and this library cannot
+ *   see that. Claiming otherwise would be the same over-reach the rule
+ *   exists to correct.
+ */
+declare const BURST_SPAN_MS: number;
+declare function classifyEvidenceWindow(row: {
+    evidence_first_at?: string | null;
+    evidence_last_at?: string | null;
+    evidence_n?: number | null;
+}): AdvisoryEvidenceWindow | null;
+/** Human-readable span for advisory text. Terse by design — it sits inline. */
+declare function formatEvidenceSpan(spanMs: number): string;
+/**
+ * The sentence that travels with a burst-shaped finding. Written to be
+ * usable verbatim in advisory text, and to say what the library CAN claim
+ * (one event) rather than what it cannot (that the event is stale).
+ */
+declare function burstCaveat(w: AdvisoryEvidenceWindow): string;
 interface ActionableAdvisory {
     id: string;
     rule: string;
@@ -1802,6 +1953,18 @@ interface ActionableAdvisory {
     openedAt: string;
     lastObservedAt: string;
     observationCount: number;
+    /**
+     * Migration 054. `null` when the generator did not state a window — an
+     * honest unknown, NOT an assertion that the evidence is well-spread.
+     */
+    evidenceWindow: AdvisoryEvidenceWindow | null;
+    /**
+     * The severity the rule ASKED for, present only when this advisory's
+     * effective `severity` was downgraded because its evidence is burst-shaped.
+     * Kept so a consumer can see the downgrade happened rather than silently
+     * receiving a quieter advisory than the generator wrote.
+     */
+    severityBeforeBurstDowngrade?: AdvisorySeverity;
     appliesTo: {
         archetype?: IntentArchetypeName;
         model?: string;
@@ -1853,6 +2016,12 @@ interface MarkAdvisoryResolvedOptions {
     brainAnonKey?: string;
     fetch?: typeof fetch;
 }
+/**
+ * Map a single `actionable_advisories_v` row (snake_case, Postgres
+ * native) to the public `ActionableAdvisory` shape (camelCase). Single
+ * canonical mapping site for this boundary (L-118).
+ */
+declare function rowToAdvisory(row: Record<string, unknown>): ActionableAdvisory;
 /**
  * Query the open advisory set for an app. Pulls from
  * `actionable_advisories_v` (per-(app_id, code) rollup with stable ids
@@ -3760,4 +3929,4 @@ declare function planDecomposition(args: PlanDecompositionArgs): DecompositionPl
  */
 declare function compile(ir: PromptIR, opts?: CompileOptions): CompileResult;
 
-export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryResolutionSource, type AdvisorySeverity, type AdvisoryStatus, type AdvisorySuggestedFix, ApiKeys, type AppOracle, type ApplySectionRewritesArgs, type ApplySectionRewritesResult, ArchetypeConvention, type ArchetypeFamilyFit, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, type AttachCacheControlResult, BRAIN_READ_ENV_NAMES, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, COACH_CFG, COST_RANKING_REFERENCE_SHAPE, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type CreateDelegateOpts, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DELEGATE_TOOL_DEFINITION, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, type DelegateHandle, type DelegateRefusalReason, type DelegateResult, type DelegateToolArgs, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type ExecutorCandidate, type FallbackPosture, FallbackReason, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetMeasuredFailureOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalAxis, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenEvalStrategyId, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, type LLMJudgeOptions, MEASURED_FAILURE_CFG, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type MeasuredFailureRuntime, type MeasuredFailureVerdict, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, OutputMode, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PlannedStep, type PricingRow, type ProbeShadowOptions, type ProbeShadowServed, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, ROLLBACK_SUPPRESSION_WINDOW_DAYS, RULE_DISCIPLINE_GATES_V1, RULE_DISCIPLINE_GATES_V1_STRUCTURED, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, STRATEGY_AUTHORSHIP_LIMITATION, SectionRewrite, type ShadowProbeRecordInput, type StrategyAttribution, type StrategyAttributionResult, type StrategyOutcome, type SupportedProvider, type SurfaceFailureRow, type SurfaceStats, SystemModelMessage, TRANSLATOR_FLOOR, _testResetMeasuredFailure, _testResetPromotions, _testWaitForMeasuredFailureRefresh, _testWaitForPromotionsRefresh, altGatesBlockFor, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, awaitMeasuredFailureReady, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, call, chainProviderSpread, classifyStrategyOutcome, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configureMeasuredFailureBrain, configurePromotionsBrain, countTokens, createDelegate, deriveFamilyFromModelId, deriveOwnership, estimateChainCostUsd, estimateModelCostUsd, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecentRollback, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isDelegateEnabledFromEnv, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, mapMeasuredFailureRows, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, planDecomposition, prefetchMeasuredFailure, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rubricFor, runAdvisor, runGoldenEval, runStrategyEvalWithAttribution, setTokenizer, wilsonLowerBound, withAltDisciplineContract, withDisciplineContract };
+export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ALT_BLIND_TOKEN_BUDGET_BREACH, ALT_STRATEGY_IDS, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryEvidenceWindow, type AdvisoryResolutionSource, type AdvisorySeverity, type AdvisoryStatus, type AdvisorySuggestedFix, ApiKeys, type AppOracle, type ApplySectionRewritesArgs, type ApplySectionRewritesResult, ArchetypeConvention, type ArchetypeFamilyFit, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, type AttachCacheControlResult, BRAIN_READ_ENV_NAMES, BURST_SPAN_MS, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, COACH_CFG, COST_RANKING_REFERENCE_SHAPE, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type CreateDelegateOpts, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DELEGATE_TOOL_DEFINITION, DISCIPLINE_GATES_V1_ALT_BLIND_HEADER, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, type DelegateHandle, type DelegateRefusalReason, type DelegateResult, type DelegateToolArgs, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type ExecutorCandidate, type FallbackPosture, FallbackReason, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetMeasuredFailureOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalAxis, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenEvalStrategyId, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, type LLMJudgeOptions, MEASURED_FAILURE_CFG, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type MeasuredFailureRuntime, type MeasuredFailureVerdict, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, OutputMode, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PlannedStep, type PricingRow, type ProbeShadowOptions, type ProbeShadowServed, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, ROLLBACK_SUPPRESSION_WINDOW_DAYS, RULE_DISCIPLINE_GATES_V1, RULE_DISCIPLINE_GATES_V1_STRUCTURED, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, STRATEGY_AUTHORSHIP_INDEPENDENT, STRATEGY_AUTHORSHIP_LIMITATION, SectionRewrite, type ShadowProbeRecordInput, type StrategyAttribution, type StrategyAttributionResult, type StrategyOutcome, type SupportedProvider, type SurfaceFailureRow, type SurfaceStats, SystemModelMessage, TRANSLATOR_FLOOR, _testResetMeasuredFailure, _testResetPromotions, _testWaitForMeasuredFailureRefresh, _testWaitForPromotionsRefresh, altBlindGatesBlockFor, altGatesBlockFor, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, awaitMeasuredFailureReady, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, burstCaveat, call, chainProviderSpread, classifyEvidenceWindow, classifyStrategyOutcome, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configureMeasuredFailureBrain, configurePromotionsBrain, countTokens, createDelegate, deriveFamilyFromModelId, deriveOwnership, estimateChainCostUsd, estimateModelCostUsd, execute, findBetterFit, flushBrainDeadLetter, formatEvidenceSpan, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecentRollback, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAltStrategy, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isDelegateEnabledFromEnv, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, mapMeasuredFailureRows, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, planDecomposition, prefetchMeasuredFailure, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rowToAdvisory, rubricFor, runAdvisor, runGoldenEval, runStrategyEvalWithAttribution, setTokenizer, wilsonLowerBound, withAltBlindDisciplineContract, withAltDisciplineContract, withDisciplineContract };

package/dist/index.d.ts

@@ -965,7 +965,11 @@ type GoldenEvalAxis = 'model' | 'strategy';
  * measurable against its exact frozen bytes. The `-alt` wording is
  * EVAL-ONLY: it exists to attribute a v1 loss to wording vs mechanism
  * (§6) and never ships in a production compile. */
-type GoldenEvalStrategyId = 'discipline-gates-v1' | 'discipline-gates-v1-alt';
+type GoldenEvalStrategyId = 'discipline-gates-v1' | 'discipline-gates-v1-alt' | 'discipline-gates-v1-alt-blind';
+/** Both re-wordings of v1. Dispatch keys on this, never on a string prefix,
+ * so adding a fourth arm is one edit rather than a grep. */
+declare const ALT_STRATEGY_IDS: readonly GoldenEvalStrategyId[];
+declare function isAltStrategy(id: GoldenEvalStrategyId | undefined): boolean;
 interface GoldenEvalOptions {
     appId: string;
     archetype: string;
@@ -1085,6 +1089,45 @@ declare function altGatesBlockFor(args: {
     outputMode: 'text' | 'json' | 'tool_call';
     hasTools: boolean;
 }): string;
+declare const ALT_BLIND_TOKEN_BUDGET_BREACH: {
+    readonly ceilingTokens: 264;
+    readonly measuredTokensTextWithTools: 285;
+    readonly note: string;
+};
+declare const DISCIPLINE_GATES_V1_ALT_BLIND_HEADER = "Before stating any conclusion, run this check:";
+/**
+ * The variant matrix — and this is the ONE place this seat's judgment enters
+ * the blind arm, so it is stated rather than buried.
+ *
+ * cc's instruction: adapt MECHANICALLY where the injection format demands it,
+ * note the diff, never edit semantics. Choosing which gates to drop per
+ * surface is a selection, not an edit — the bytes of every retained gate are
+ * untouched — but the selection is still mine, so:
+ *
+ *   NO TOOLS   drops `toolPredict`. Forced, not chosen: the string opens
+ *              "When using tools" and is literally inapplicable without them.
+ *              Mirrors v1 dropping its compressed-item bullet.
+ *   STRUCTURED drops `markAssumed` ONLY. It is the sole gate whose entire
+ *              function is text in the final answer ('mark anything unchecked
+ *              as "assumed"'), which a JSON/tool_call schema has no field for
+ *              and which would corrupt the parse.
+ *
+ * The judgment call worth flagging: v1 drops TWO bullets on structured
+ * surfaces, and a stricter reading would also drop `falsify` ("state in one
+ * line") and `deviation` ("say so explicitly"), since both demand output
+ * text. I kept them. Their output demand is incidental (and conditional, for
+ * `deviation`) while their primary effect is on reasoning before the answer
+ * exists — whereas v1's dropped pair (`label`, `gap`) are purely
+ * output-shaping. Dropping three of five would leave a two-gate arm that no
+ * longer tests the same mechanism, and an arm crippled by my formatting
+ * choice would read as a wording loss that was actually a scoping loss.
+ * If the structured surface shows anomalous results, this is the first
+ * thing to re-examine.
+ */
+declare function altBlindGatesBlockFor(args: {
+    outputMode: 'text' | 'json' | 'tool_call';
+    hasTools: boolean;
+}): string;
 /**
  * The alt arm injects its block DIRECTLY as an untagged section — it must
  * not carry `kind: 'discipline_contract'`, or the translator would prepend
@@ -1094,6 +1137,14 @@ declare function altGatesBlockFor(args: {
  * no-ops — the attribution is about WORDING, and everything else is held.
  */
 declare function withAltDisciplineContract(ir: PromptIR): PromptIR;
+/**
+ * Same injection contract as `withAltDisciplineContract` — untagged section,
+ * so the translator never prepends the v1 bytes on top and the arm measures
+ * exactly one wording. Same variant inputs, so the blind arm no-ops nowhere
+ * v1 fires and fires nowhere v1 no-ops; the comparison is about WORDING and
+ * everything else is held.
+ */
+declare function withAltBlindDisciplineContract(ir: PromptIR): PromptIR;
 declare function runGoldenEval(opts: GoldenEvalOptions): Promise<GoldenEvalRunResult>;
 /**
  * Aggregate outcome of one strategy run, in gates-on terms. 'loses' is the
@@ -1107,25 +1158,54 @@ declare function classifyStrategyOutcome(r: GoldenEvalRunResult): StrategyOutcom
  * recorded as a mechanism failure would let Factor B permanently disable a
  * real capability on evidence about one author's prose.
  *
- *   v1 vs off | alt vs off | attribution
- *   ----------+------------+----------------------------------------------
- *   wins      | (not run)  | mechanism-works — ship
- *   ties      | (not run)  | no-lift — inconclusive at this n, re-eval later
- *   loses     | wins       | wording-failure — do NOT disable the mechanism
- *   loses     | loses      | mechanism-failure — well-evidenced; Factor B may disable
- *   loses     | ties/inc.  | wording-inconclusive — no disable on ambiguity
+ * THREE arms since 2026-07-29. Both re-wordings run on a v1 loss, and a win
+ * by EITHER is enough to acquit the mechanism — the question "does some
+ * wording of this work?" is answered by one existence proof, so there is no
+ * reason to require agreement between the alts.
+ *
+ *   v1 vs off | alt / alt-blind vs off | attribution
+ *   ----------+------------------------+------------------------------------
+ *   wins      | (not run)              | mechanism-works — ship
+ *   ties      | (not run)              | no-lift — inconclusive at n, re-eval
+ *   loses     | either wins            | wording-failure — do NOT disable
+ *   loses     | BOTH lose              | mechanism-failure — Factor B may disable
+ *   loses     | neither wins, not both lose | wording-inconclusive — no disable
+ *
+ * The `mechanism-failure` cell is the one that changed character. It used to
+ * rest on two wordings by one author, so a shared blind spot (the principles
+ * being the wrong principles) was invisible and the verdict was hedged. The
+ * blind arm was authored by a context-free subagent with no knowledge of this
+ * repo, the experiment, or who was asking — so a both-lose verdict now spans
+ * independent authorship and is strong on its own terms. That is exactly the
+ * gap `STRATEGY_AUTHORSHIP_LIMITATION` was written to confess, which is why
+ * the limitation text is now conditional on whether the blind arm ran.
  */
 type StrategyAttribution = 'mechanism-works' | 'no-lift' | 'wording-failure' | 'mechanism-failure' | 'wording-inconclusive' | 'inconclusive';
 interface StrategyAttributionResult {
     attribution: StrategyAttribution;
     primary: GoldenEvalRunResult;
-    /** Present ONLY when the primary lost (the loss-triggered third arm). */
+    /** Present ONLY when the primary lost (the loss-triggered arms). */
     alt?: GoldenEvalRunResult;
+    /** The independently-authored arm. Present ONLY when the primary lost. */
+    altBlind?: GoldenEvalRunResult;
     /** The authorship limitation, restated on every result so no downstream
-     * reader can cite an attribution without it. */
+     * reader can cite an attribution without it. Which string this carries
+     * depends on whether the blind arm actually ran — see below. */
     limitation: string;
 }
+/**
+ * Carried when the blind arm did NOT run — i.e. v1 won or tied, so no
+ * re-wording was measured at all and any claim about wording is unevidenced.
+ */
 declare const STRATEGY_AUTHORSHIP_LIMITATION: string;
+/**
+ * Carried when both re-wording arms ran. The shared-author caveat is GONE by
+ * construction, and saying so is the point: the previous version of this
+ * string confessed a gap that has since been closed, and a stale confession
+ * is its own kind of false statement — a reader would discount a verdict
+ * that no longer deserves discounting.
+ */
+declare const STRATEGY_AUTHORSHIP_INDEPENDENT: string;
 /**
  * Run the strategy eval with loss-triggered wording attribution: v1 first;
  * the alt arm replays ONLY on a v1 loss (mirrors the engine's retry
@@ -1146,7 +1226,7 @@ declare function runStrategyEvalWithAttribution(opts: Omit<GoldenEvalOptions, 'a
  * guard in `tests/version.test.ts` fails the suite (and therefore
  * `prepublishOnly`) when they diverge — a stale constant cannot reach npm.
  */
-declare const LIBRARY_VERSION = "2.0.0-alpha.82";
+declare const LIBRARY_VERSION = "2.0.0-alpha.83";
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.
@@ -1795,6 +1875,77 @@ interface AdvisorySuggestedFix {
  * view's snake_case columns to camelCase. See `feedback_typed_boundary_transformers.md`
  * (L-118) for the rationale.
  */
+/**
+ * The window of evidence a finding was computed from — migration 054.
+ *
+ * READ THE DISTINCTION BEFORE USING THIS. It is NOT `openedAt` /
+ * `lastObservedAt` / `observationCount`, which describe the ADVISORY (how
+ * long it has been firing, how many times the watcher ran and still saw the
+ * condition). This describes what the generator LOOKED AT.
+ *
+ * A daily cron that keeps firing on a single 29-second burst reports
+ * `observationCount: 11` spanning 11 days — the most standing-looking of
+ * standing conditions — while its evidence is one event from 11 days ago.
+ * Separating the two is the entire point.
+ *
+ * `null` when the generator did not state its window. Honest unknown; it
+ * must never be read as "not a burst". Compile-time library rules carry
+ * null legitimately — they fire on ONE call, so their evidence is the call
+ * in hand and there is no window to state.
+ */
+interface AdvisoryEvidenceWindow {
+    firstAt: string;
+    lastAt: string;
+    n: number;
+    /** `lastAt - firstAt`, precomputed so no caller re-derives it wrong. */
+    spanMs: number;
+    /**
+     * `true` when the evidence is clustered tightly enough to be ONE EVENT
+     * rather than a standing rate. See `classifyEvidenceWindow`.
+     */
+    isBurst: boolean;
+}
+/**
+ * Burst-vs-rate, computed rather than judged.
+ *
+ * Origin: tt-intel s118. A cost query showed `claude-sonnet-5` at 30% of
+ * their `ask` traffic and 80% of ask spend. Every number true, every
+ * mechanism check correct, and every correct check made them more certain
+ * the spend gate had regressed. All eleven calls sat in a 29-second window —
+ * their own prior experiment, fixed six minutes after the last one. Their
+ * formulation: **a cluster is an event, not a rate.**
+ *
+ * The rule, deliberately crude because a subtle one would need tuning per
+ * rule and would then be wrong per rule: evidence is a burst when it spans
+ * less than `BURST_SPAN_MS` (5 minutes). Multiple observations inside five
+ * minutes are one incident — a deploy, a retry storm, a test run, a
+ * benchmark — not a pattern of behavior over time.
+ *
+ * Two deliberate non-features:
+ *
+ * - **n is not in the test.** Two rows 4 minutes apart are as much a single
+ *   event as eleven are. Requiring a minimum n would let the smallest, least
+ *   evidenced findings skip the check.
+ * - **It does not try to detect fossils.** A burst is not necessarily stale;
+ *   it is merely not a rate. Only the consumer's own deploy log can turn
+ *   "one event" into "an event we already fixed", and this library cannot
+ *   see that. Claiming otherwise would be the same over-reach the rule
+ *   exists to correct.
+ */
+declare const BURST_SPAN_MS: number;
+declare function classifyEvidenceWindow(row: {
+    evidence_first_at?: string | null;
+    evidence_last_at?: string | null;
+    evidence_n?: number | null;
+}): AdvisoryEvidenceWindow | null;
+/** Human-readable span for advisory text. Terse by design — it sits inline. */
+declare function formatEvidenceSpan(spanMs: number): string;
+/**
+ * The sentence that travels with a burst-shaped finding. Written to be
+ * usable verbatim in advisory text, and to say what the library CAN claim
+ * (one event) rather than what it cannot (that the event is stale).
+ */
+declare function burstCaveat(w: AdvisoryEvidenceWindow): string;
 interface ActionableAdvisory {
     id: string;
     rule: string;
@@ -1802,6 +1953,18 @@ interface ActionableAdvisory {
     openedAt: string;
     lastObservedAt: string;
     observationCount: number;
+    /**
+     * Migration 054. `null` when the generator did not state a window — an
+     * honest unknown, NOT an assertion that the evidence is well-spread.
+     */
+    evidenceWindow: AdvisoryEvidenceWindow | null;
+    /**
+     * The severity the rule ASKED for, present only when this advisory's
+     * effective `severity` was downgraded because its evidence is burst-shaped.
+     * Kept so a consumer can see the downgrade happened rather than silently
+     * receiving a quieter advisory than the generator wrote.
+     */
+    severityBeforeBurstDowngrade?: AdvisorySeverity;
     appliesTo: {
         archetype?: IntentArchetypeName;
         model?: string;
@@ -1853,6 +2016,12 @@ interface MarkAdvisoryResolvedOptions {
     brainAnonKey?: string;
     fetch?: typeof fetch;
 }
+/**
+ * Map a single `actionable_advisories_v` row (snake_case, Postgres
+ * native) to the public `ActionableAdvisory` shape (camelCase). Single
+ * canonical mapping site for this boundary (L-118).
+ */
+declare function rowToAdvisory(row: Record<string, unknown>): ActionableAdvisory;
 /**
  * Query the open advisory set for an app. Pulls from
  * `actionable_advisories_v` (per-(app_id, code) rollup with stable ids
@@ -3760,4 +3929,4 @@ declare function planDecomposition(args: PlanDecompositionArgs): DecompositionPl
  */
 declare function compile(ir: PromptIR, opts?: CompileOptions): CompileResult;
 
-export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryResolutionSource, type AdvisorySeverity, type AdvisoryStatus, type AdvisorySuggestedFix, ApiKeys, type AppOracle, type ApplySectionRewritesArgs, type ApplySectionRewritesResult, ArchetypeConvention, type ArchetypeFamilyFit, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, type AttachCacheControlResult, BRAIN_READ_ENV_NAMES, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, COACH_CFG, COST_RANKING_REFERENCE_SHAPE, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type CreateDelegateOpts, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DELEGATE_TOOL_DEFINITION, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, type DelegateHandle, type DelegateRefusalReason, type DelegateResult, type DelegateToolArgs, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type ExecutorCandidate, type FallbackPosture, FallbackReason, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetMeasuredFailureOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalAxis, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenEvalStrategyId, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, type LLMJudgeOptions, MEASURED_FAILURE_CFG, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type MeasuredFailureRuntime, type MeasuredFailureVerdict, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, OutputMode, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PlannedStep, type PricingRow, type ProbeShadowOptions, type ProbeShadowServed, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, ROLLBACK_SUPPRESSION_WINDOW_DAYS, RULE_DISCIPLINE_GATES_V1, RULE_DISCIPLINE_GATES_V1_STRUCTURED, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, STRATEGY_AUTHORSHIP_LIMITATION, SectionRewrite, type ShadowProbeRecordInput, type StrategyAttribution, type StrategyAttributionResult, type StrategyOutcome, type SupportedProvider, type SurfaceFailureRow, type SurfaceStats, SystemModelMessage, TRANSLATOR_FLOOR, _testResetMeasuredFailure, _testResetPromotions, _testWaitForMeasuredFailureRefresh, _testWaitForPromotionsRefresh, altGatesBlockFor, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, awaitMeasuredFailureReady, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, call, chainProviderSpread, classifyStrategyOutcome, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configureMeasuredFailureBrain, configurePromotionsBrain, countTokens, createDelegate, deriveFamilyFromModelId, deriveOwnership, estimateChainCostUsd, estimateModelCostUsd, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecentRollback, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isDelegateEnabledFromEnv, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, mapMeasuredFailureRows, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, planDecomposition, prefetchMeasuredFailure, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rubricFor, runAdvisor, runGoldenEval, runStrategyEvalWithAttribution, setTokenizer, wilsonLowerBound, withAltDisciplineContract, withDisciplineContract };
+export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ALT_BLIND_TOKEN_BUDGET_BREACH, ALT_STRATEGY_IDS, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryEvidenceWindow, type AdvisoryResolutionSource, type AdvisorySeverity, type AdvisoryStatus, type AdvisorySuggestedFix, ApiKeys, type AppOracle, type ApplySectionRewritesArgs, type ApplySectionRewritesResult, ArchetypeConvention, type ArchetypeFamilyFit, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, type AttachCacheControlResult, BRAIN_READ_ENV_NAMES, BURST_SPAN_MS, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, COACH_CFG, COST_RANKING_REFERENCE_SHAPE, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type CreateDelegateOpts, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DELEGATE_TOOL_DEFINITION, DISCIPLINE_GATES_V1_ALT_BLIND_HEADER, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, type DelegateHandle, type DelegateRefusalReason, type DelegateResult, type DelegateToolArgs, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type ExecutorCandidate, type FallbackPosture, FallbackReason, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetMeasuredFailureOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalAxis, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenEvalStrategyId, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, type LLMJudgeOptions, MEASURED_FAILURE_CFG, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type MeasuredFailureRuntime, type MeasuredFailureVerdict, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, OutputMode, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PlannedStep, type PricingRow, type ProbeShadowOptions, type ProbeShadowServed, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, ROLLBACK_SUPPRESSION_WINDOW_DAYS, RULE_DISCIPLINE_GATES_V1, RULE_DISCIPLINE_GATES_V1_STRUCTURED, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, STRATEGY_AUTHORSHIP_INDEPENDENT, STRATEGY_AUTHORSHIP_LIMITATION, SectionRewrite, type ShadowProbeRecordInput, type StrategyAttribution, type StrategyAttributionResult, type StrategyOutcome, type SupportedProvider, type SurfaceFailureRow, type SurfaceStats, SystemModelMessage, TRANSLATOR_FLOOR, _testResetMeasuredFailure, _testResetPromotions, _testWaitForMeasuredFailureRefresh, _testWaitForPromotionsRefresh, altBlindGatesBlockFor, altGatesBlockFor, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, awaitMeasuredFailureReady, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, burstCaveat, call, chainProviderSpread, classifyEvidenceWindow, classifyStrategyOutcome, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configureMeasuredFailureBrain, configurePromotionsBrain, countTokens, createDelegate, deriveFamilyFromModelId, deriveOwnership, estimateChainCostUsd, estimateModelCostUsd, execute, findBetterFit, flushBrainDeadLetter, formatEvidenceSpan, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecentRollback, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAltStrategy, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isDelegateEnabledFromEnv, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, mapMeasuredFailureRows, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, planDecomposition, prefetchMeasuredFailure, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rowToAdvisory, rubricFor, runAdvisor, runGoldenEval, runStrategyEvalWithAttribution, setTokenizer, wilsonLowerBound, withAltBlindDisciplineContract, withAltDisciplineContract, withDisciplineContract };

package/dist/index.js

@@ -23,9 +23,12 @@ __export(index_exports, {
   ABSOLUTE_FLOOR: () => ABSOLUTE_FLOOR,
   ALIASES: () => ALIASES,
   ALL_ARCHETYPES: () => ALL_ARCHETYPES,
+  ALT_BLIND_TOKEN_BUDGET_BREACH: () => ALT_BLIND_TOKEN_BUDGET_BREACH,
+  ALT_STRATEGY_IDS: () => ALT_STRATEGY_IDS,
   ARCHETYPE_FAMILY_FITS: () => ARCHETYPE_FAMILY_FITS,
   ARCHETYPE_FLOOR_DEFAULT: () => ARCHETYPE_FLOOR_DEFAULT,
   BRAIN_READ_ENV_NAMES: () => BRAIN_READ_ENV_NAMES,
+  BURST_SPAN_MS: () => BURST_SPAN_MS,
   COACH_CFG: () => COACH_CFG,
   COST_RANKING_REFERENCE_SHAPE: () => COST_RANKING_REFERENCE_SHAPE,
   CallError: () => CallError,
@@ -36,6 +39,7 @@ __export(index_exports, {
   DEFAULT_PROMOTIONS_ENDPOINT: () => DEFAULT_PROMOTIONS_ENDPOINT,
   DELEGATE_TOOL_DEFINITION: () => DELEGATE_TOOL_DEFINITION,
   DIALECT_VERSION: () => DIALECT_VERSION,
+  DISCIPLINE_GATES_V1_ALT_BLIND_HEADER: () => DISCIPLINE_GATES_V1_ALT_BLIND_HEADER,
   DISCIPLINE_GATES_V1_ALT_HEADER: () => DISCIPLINE_GATES_V1_ALT_HEADER,
   FamilyResolutionError: () => FamilyResolutionError,
   INTENT_ARCHETYPES: () => INTENT_ARCHETYPES,
@@ -52,6 +56,7 @@ __export(index_exports, {
   RULE_DISCIPLINE_GATES_V1: () => RULE_DISCIPLINE_GATES_V1,
   RULE_DISCIPLINE_GATES_V1_STRUCTURED: () => RULE_DISCIPLINE_GATES_V1_STRUCTURED,
   RULE_SEQUENTIAL_TOOL_CLIFF: () => RULE_SEQUENTIAL_TOOL_CLIFF,
+  STRATEGY_AUTHORSHIP_INDEPENDENT: () => STRATEGY_AUTHORSHIP_INDEPENDENT,
   STRATEGY_AUTHORSHIP_LIMITATION: () => STRATEGY_AUTHORSHIP_LIMITATION,
   TRANSLATOR_FLOOR: () => TRANSLATOR_FLOOR,
   _testResetMeasuredFailure: () => _testResetMeasuredFailure,
@@ -59,6 +64,7 @@ __export(index_exports, {
   _testWaitForMeasuredFailureRefresh: () => _testWaitForMeasuredFailureRefresh,
   _testWaitForPromotionsRefresh: () => _testWaitForPromotionsRefresh,
   allProfiles: () => allProfiles,
+  altBlindGatesBlockFor: () => altBlindGatesBlockFor,
   altGatesBlockFor: () => altGatesBlockFor,
   applyArchetypeConvention: () => applyArchetypeConvention,
   applySectionRewrites: () => applySectionRewrites,
@@ -72,9 +78,11 @@ __export(index_exports, {
   buildLLMJudge: () => buildLLMJudge,
   buildPairwiseJudgePrompt: () => buildPairwiseJudgePrompt,
   buildShadowProbeRow: () => buildShadowProbeRow,
+  burstCaveat: () => burstCaveat,
   call: () => call,
   captureGoldenIr: () => captureGoldenIr,
   chainProviderSpread: () => chainProviderSpread,
+  classifyEvidenceWindow: () => classifyEvidenceWindow,
   classifyStrategyOutcome: () => classifyStrategyOutcome,
   clearBrain: () => clearBrain,
   combineOrderSwappedVerdicts: () => combineOrderSwappedVerdicts,
@@ -94,6 +102,7 @@ __export(index_exports, {
   execute: () => execute,
   findBetterFit: () => findBetterFit,
   flushBrainDeadLetter: () => flushBrainDeadLetter,
+  formatEvidenceSpan: () => formatEvidenceSpan,
   getActionableAdvisories: () => getActionableAdvisories,
   getAllStarterChains: () => getAllStarterChains,
   getAllStarterChainsWithGrounding: () => getAllStarterChainsWithGrounding,
@@ -115,6 +124,7 @@ __export(index_exports, {
   getStarterChainWithGrounding: () => getStarterChainWithGrounding,
   hasMutation: () => hasMutation,
   hashShape: () => hashShape,
+  isAltStrategy: () => isAltStrategy,
   isArchetype: () => isArchetype,
   isAutoPromoteEnabledFromEnv: () => isAutoPromoteEnabledFromEnv,
   isBrainQueryActiveFor: () => isBrainQueryActiveFor,
@@ -160,6 +170,7 @@ __export(index_exports, {
   resolveGoldenCaptureRate: () => resolveGoldenCaptureRate,
   resolvePricingAt: () => resolvePricingAt,
   resolveProviderKey: () => resolveProviderKey,
+  rowToAdvisory: () => rowToAdvisory,
   rubricFor: () => rubricFor,
   runAdvisor: () => runAdvisor,
   runGoldenEval: () => runGoldenEval,
@@ -168,6 +179,7 @@ __export(index_exports, {
   shouldCaptureGolden: () => shouldCaptureGolden,
   tryGetProfile: () => tryGetProfile,
   wilsonLowerBound: () => wilsonLowerBound,
+  withAltBlindDisciplineContract: () => withAltBlindDisciplineContract,
   withAltDisciplineContract: () => withAltDisciplineContract,
   withDisciplineContract: () => withDisciplineContract
 });
@@ -5853,7 +5865,7 @@ function validateFinalFit(ir, profile, tokens) {
 }
 
 // src/version.ts
-var LIBRARY_VERSION = "2.0.0-alpha.82";
+var LIBRARY_VERSION = "2.0.0-alpha.83";
 
 // src/pricing-brain.ts
 function isPricingRow(x) {
@@ -8636,6 +8648,13 @@ function combineOrderSwappedVerdicts(run1, run2) {
   if (run1 === run2) return run1;
   return "tied";
 }
+var ALT_STRATEGY_IDS = [
+  "discipline-gates-v1-alt",
+  "discipline-gates-v1-alt-blind"
+];
+function isAltStrategy(id) {
+  return id !== void 0 && ALT_STRATEGY_IDS.includes(id);
+}
 function replayRetryDelayMs(errorCode) {
   return errorCode === "rate_limit" ? 65e3 : 2e3;
 }
@@ -8689,7 +8708,34 @@ function altGatesBlockFor(args) {
     ...shapeAltering
   ]);
 }
+var ALT_BLIND_TOKEN_BUDGET_BREACH = {
+  ceilingTokens: 264,
+  measuredTokensTextWithTools: 285,
+  note: "Blind arm exceeds the stated 264-token ceiling on text+tools (285) and costs ~2.4x the v1-alt arm. Not corrected: compressing it would require editing prose the arm depends on NOT having been edited by this seat. Read a blind-arm LOSS as confounded by token tax; a WIN is unaffected."
+};
+var DISCIPLINE_GATES_V1_ALT_BLIND_HEADER = "Before stating any conclusion, run this check:";
+var ALT_BLIND_BULLETS = {
+  falsify: "- Before committing to an approach, state in one line what evidence would prove it wrong and how you would notice it. If nothing could falsify the approach, you hold a preference, not a plan \u2014 rework it until something could.",
+  deviation: "- When you choose not to follow an applicable instruction, say so explicitly: name the instruction, why you are deviating, and what you are doing instead. Silent deviation is forbidden \u2014 an override is only legitimate when it is visible.",
+  toolPredict: "- When using tools: before each call, state the result you expect. On mismatch, treat the gap as evidence your model of the system is wrong \u2014 revise the model before acting again; never silently retry.",
+  verifyDelegated: "- Verify every delegated or sub-agent result before composing it into an answer: spot-check it against the source or an independent probe. An unverified sub-result is a claim you are repeating, not a fact you know.",
+  markAssumed: '- In the final answer, keep verified claims and assumptions visibly distinct: mark anything unchecked as "assumed" or "unverified". Never let an assumption borrow the confidence of the verified claims beside it.'
+};
+function altBlindGatesBlockFor(args) {
+  const parts = [
+    "falsify",
+    "deviation",
+    ...args.hasTools ? ["toolPredict"] : [],
+    "verifyDelegated",
+    ...args.outputMode === "text" ? ["markAssumed"] : []
+  ];
+  return [
+    DISCIPLINE_GATES_V1_ALT_BLIND_HEADER,
+    ...parts.map((p) => ALT_BLIND_BULLETS[p])
+  ].join("\n");
+}
 var STRATEGY_ALT_SECTION_ID = "__kgauto_strategy_eval_gates_alt__";
+var STRATEGY_ALT_BLIND_SECTION_ID = "__kgauto_strategy_eval_gates_alt_blind__";
 function withAltDisciplineContract(ir) {
   const outputMode = resolveOutputMode({
     declared: ir.constraints?.outputMode,
@@ -8708,6 +8754,28 @@ function withAltDisciplineContract(ir) {
     ]
   };
 }
+function withAltBlindDisciplineContract(ir) {
+  const outputMode = resolveOutputMode({
+    declared: ir.constraints?.outputMode,
+    structuredOutput: ir.constraints?.structuredOutput,
+    toolCount: ir.tools?.length ?? 0
+  });
+  const hasTools = (ir.tools?.length ?? 0) > 0;
+  return {
+    ...ir,
+    sections: [
+      ...ir.sections ?? [],
+      {
+        id: STRATEGY_ALT_BLIND_SECTION_ID,
+        text: altBlindGatesBlockFor({ outputMode, hasTools })
+      }
+    ]
+  };
+}
+var ALT_SECTION_ID_BY_STRATEGY = {
+  "discipline-gates-v1-alt": STRATEGY_ALT_SECTION_ID,
+  "discipline-gates-v1-alt-blind": STRATEGY_ALT_BLIND_SECTION_ID
+};
 async function runGoldenEval(opts) {
   const fetchFn = opts.fetchImpl ?? fetch;
   const progress = opts.onProgress ?? (() => {
@@ -8775,7 +8843,9 @@ async function runGoldenEval(opts) {
   }
   const armBIr = (ir) => {
     if (axis !== "strategy") return ir;
-    return strategyId === "discipline-gates-v1-alt" ? withAltDisciplineContract(ir) : withDisciplineContract(ir);
+    if (strategyId === "discipline-gates-v1-alt") return withAltDisciplineContract(ir);
+    if (strategyId === "discipline-gates-v1-alt-blind") return withAltBlindDisciplineContract(ir);
+    return withDisciplineContract(ir);
   };
   const replay = async (ir, model, captureGates = false) => {
     let gates;
@@ -8787,13 +8857,14 @@ async function runGoldenEval(opts) {
       };
       const compiled = compile(evalIr);
       if (captureGates) {
-        if (strategyId === "discipline-gates-v1-alt") {
+        if (isAltStrategy(strategyId)) {
+          const altSectionId = ALT_SECTION_ID_BY_STRATEGY[strategyId];
           const altSection = (evalIr.sections ?? []).find(
-            (s) => s.id === STRATEGY_ALT_SECTION_ID
+            (s) => s.id === altSectionId
           );
           gates = {
             fired: altSection !== void 0 && altSection.text.length > 0,
-            rule: "discipline-gates-v1-alt",
+            rule: strategyId,
             gateTokens: altSection ? countTokens(`${altSection.text}
 
 `) : 0
@@ -9224,7 +9295,8 @@ function classifyStrategyOutcome(r) {
   if (r.losses > r.wins) return "loses";
   return "ties";
 }
-var STRATEGY_AUTHORSHIP_LIMITATION = "Both gate wordings share one author (kgauto-Cairn); a shared blind spot is invisible to this experiment. Strong verdicts: both-lose (mechanism) and v1-loses/alt-wins (wording). An independently-authored alt would strengthen every other cell.";
+var STRATEGY_AUTHORSHIP_LIMITATION = "Only the v1 wording was measured on this run; no re-wording arm was triggered, so this result says nothing about whether the wording or the mechanism produced it.";
+var STRATEGY_AUTHORSHIP_INDEPENDENT = "Three arms: v1 and one re-wording by this seat, plus an independently authored arm (context-free subagent, no repo access, no knowledge of the experiment). A both-lose verdict therefore spans independent authorship and is not explained by one author's blind spot. Residual limitation: all three arms encode a similar set of underlying principles, so a wrong CHOICE of principles remains harder to see than a wrong wording of them.";
 async function runStrategyEvalWithAttribution(opts) {
   const primary = await runGoldenEval({
     ...opts,
@@ -9241,9 +9313,20 @@ async function runStrategyEvalWithAttribution(opts) {
     axis: "strategy",
     strategy: "discipline-gates-v1-alt"
   });
-  const altOutcome = classifyStrategyOutcome(alt);
-  const attribution = altOutcome === "wins" ? "wording-failure" : altOutcome === "loses" ? "mechanism-failure" : "wording-inconclusive";
-  return { attribution, primary, alt, limitation: STRATEGY_AUTHORSHIP_LIMITATION };
+  const altBlind = await runGoldenEval({
+    ...opts,
+    axis: "strategy",
+    strategy: "discipline-gates-v1-alt-blind"
+  });
+  const outcomes = [classifyStrategyOutcome(alt), classifyStrategyOutcome(altBlind)];
+  const attribution = outcomes.includes("wins") ? "wording-failure" : outcomes.every((o) => o === "loses") ? "mechanism-failure" : "wording-inconclusive";
+  return {
+    attribution,
+    primary,
+    alt,
+    altBlind,
+    limitation: STRATEGY_AUTHORSHIP_INDEPENDENT
+  };
 }
 
 // src/brain-proxy.ts
@@ -9875,6 +9958,30 @@ function createDelegate(opts) {
 }
 
 // src/advisories-api.ts
+var BURST_SPAN_MS = 5 * 60 * 1e3;
+function classifyEvidenceWindow(row) {
+  const { evidence_first_at: first, evidence_last_at: last, evidence_n: n } = row;
+  if (typeof first !== "string" || typeof last !== "string") return null;
+  if (typeof n !== "number" || !Number.isFinite(n) || n <= 0) return null;
+  const t0 = Date.parse(first);
+  const t1 = Date.parse(last);
+  if (Number.isNaN(t0) || Number.isNaN(t1)) return null;
+  const spanMs = Math.max(0, t1 - t0);
+  return { firstAt: first, lastAt: last, n, spanMs, isBurst: spanMs < BURST_SPAN_MS };
+}
+function formatEvidenceSpan(spanMs) {
+  if (spanMs < 1e3) return `${spanMs}ms`;
+  const s = Math.round(spanMs / 1e3);
+  if (s < 90) return `${s}s`;
+  const m = Math.round(s / 60);
+  if (m < 90) return `${m}m`;
+  const h = Math.round(m / 60);
+  if (h < 48) return `${h}h`;
+  return `${Math.round(h / 24)}d`;
+}
+function burstCaveat(w) {
+  return `Evidence is ${w.n} observation${w.n === 1 ? "" : "s"} spanning ${formatEvidenceSpan(w.spanMs)} (${w.firstAt} \u2192 ${w.lastAt}) \u2014 that is a single burst, not a standing rate. Check it against your own deploy log before acting: a cluster this tight is usually one incident, and may already be fixed.`;
+}
 var SEVERITY_SET = /* @__PURE__ */ new Set(["info", "warn", "critical"]);
 var STATUS_SET = /* @__PURE__ */ new Set(["open", "snoozed", "resolved"]);
 var RESOLUTION_SOURCE_SET = /* @__PURE__ */ new Set([
@@ -9914,10 +10021,18 @@ function rowToAdvisory(row) {
     if (docsLink) suggestedFix.docsLink = docsLink;
     if (suggestion) suggestedFix.before = suggestion;
   }
+  const evidenceWindow = classifyEvidenceWindow(
+    row
+  );
+  const declaredSeverity = asSeverity(row.severity);
+  const downgraded = evidenceWindow?.isBurst === true && declaredSeverity === "critical";
+  const effectiveSeverity = downgraded ? "warn" : declaredSeverity;
   const out = {
     id: typeof row.id === "string" ? row.id : "",
     rule: typeof row.rule === "string" ? row.rule : "",
-    severity: asSeverity(row.severity),
+    severity: effectiveSeverity,
+    evidenceWindow,
+    ...downgraded ? { severityBeforeBurstDowngrade: declaredSeverity } : {},
     openedAt: typeof row.opened_at === "string" ? row.opened_at : "",
     lastObservedAt: typeof row.last_observed_at === "string" ? row.last_observed_at : "",
     observationCount: typeof row.observation_count === "number" ? row.observation_count : 0,
@@ -9925,7 +10040,13 @@ function rowToAdvisory(row) {
       ...archetype ? { archetype } : {},
       ...model ? { model } : {}
     },
-    message: typeof row.message === "string" ? row.message : "",
+    // The caveat goes INLINE in the message, not only in `evidenceWindow`.
+    // A structured field a consumer must think to read is the same defect
+    // one layer along: the substrate knowing and not telling. The whole
+    // point is that the check costs a glance rather than a query.
+    message: (typeof row.message === "string" ? row.message : "") + (evidenceWindow?.isBurst ? `
+
+${burstCaveat(evidenceWindow)}` : ""),
     suggestedFix,
     autoApplicable: false,
     // reserved — alpha.30+
@@ -10463,9 +10584,12 @@ function compile2(ir, opts) {
   ABSOLUTE_FLOOR,
   ALIASES,
   ALL_ARCHETYPES,
+  ALT_BLIND_TOKEN_BUDGET_BREACH,
+  ALT_STRATEGY_IDS,
   ARCHETYPE_FAMILY_FITS,
   ARCHETYPE_FLOOR_DEFAULT,
   BRAIN_READ_ENV_NAMES,
+  BURST_SPAN_MS,
   COACH_CFG,
   COST_RANKING_REFERENCE_SHAPE,
   CallError,
@@ -10476,6 +10600,7 @@ function compile2(ir, opts) {
   DEFAULT_PROMOTIONS_ENDPOINT,
   DELEGATE_TOOL_DEFINITION,
   DIALECT_VERSION,
+  DISCIPLINE_GATES_V1_ALT_BLIND_HEADER,
   DISCIPLINE_GATES_V1_ALT_HEADER,
   FamilyResolutionError,
   INTENT_ARCHETYPES,
@@ -10492,6 +10617,7 @@ function compile2(ir, opts) {
   RULE_DISCIPLINE_GATES_V1,
   RULE_DISCIPLINE_GATES_V1_STRUCTURED,
   RULE_SEQUENTIAL_TOOL_CLIFF,
+  STRATEGY_AUTHORSHIP_INDEPENDENT,
   STRATEGY_AUTHORSHIP_LIMITATION,
   TRANSLATOR_FLOOR,
   _testResetMeasuredFailure,
@@ -10499,6 +10625,7 @@ function compile2(ir, opts) {
   _testWaitForMeasuredFailureRefresh,
   _testWaitForPromotionsRefresh,
   allProfiles,
+  altBlindGatesBlockFor,
   altGatesBlockFor,
   applyArchetypeConvention,
   applySectionRewrites,
@@ -10512,9 +10639,11 @@ function compile2(ir, opts) {
   buildLLMJudge,
   buildPairwiseJudgePrompt,
   buildShadowProbeRow,
+  burstCaveat,
   call,
   captureGoldenIr,
   chainProviderSpread,
+  classifyEvidenceWindow,
   classifyStrategyOutcome,
   clearBrain,
   combineOrderSwappedVerdicts,
@@ -10534,6 +10663,7 @@ function compile2(ir, opts) {
   execute,
   findBetterFit,
   flushBrainDeadLetter,
+  formatEvidenceSpan,
   getActionableAdvisories,
   getAllStarterChains,
   getAllStarterChainsWithGrounding,
@@ -10555,6 +10685,7 @@ function compile2(ir, opts) {
   getStarterChainWithGrounding,
   hasMutation,
   hashShape,
+  isAltStrategy,
   isArchetype,
   isAutoPromoteEnabledFromEnv,
   isBrainQueryActiveFor,
@@ -10600,6 +10731,7 @@ function compile2(ir, opts) {
   resolveGoldenCaptureRate,
   resolvePricingAt,
   resolveProviderKey,
+  rowToAdvisory,
   rubricFor,
   runAdvisor,
   runGoldenEval,
@@ -10608,6 +10740,7 @@ function compile2(ir, opts) {
   shouldCaptureGolden,
   tryGetProfile,
   wilsonLowerBound,
+  withAltBlindDisciplineContract,
   withAltDisciplineContract,
   withDisciplineContract
 });

package/dist/index.mjs

@@ -19,7 +19,7 @@ import {
   LIBRARY_VERSION,
   createKeyHealthRoute,
   keyFingerprint
-} from "./chunk-L246YOV7.mjs";
+} from "./chunk-QEFIAAE7.mjs";
 import {
   ABSOLUTE_FLOOR,
   ARCHETYPE_FLOOR_DEFAULT,
@@ -5652,6 +5652,13 @@ function combineOrderSwappedVerdicts(run1, run2) {
   if (run1 === run2) return run1;
   return "tied";
 }
+var ALT_STRATEGY_IDS = [
+  "discipline-gates-v1-alt",
+  "discipline-gates-v1-alt-blind"
+];
+function isAltStrategy(id) {
+  return id !== void 0 && ALT_STRATEGY_IDS.includes(id);
+}
 function replayRetryDelayMs(errorCode) {
   return errorCode === "rate_limit" ? 65e3 : 2e3;
 }
@@ -5705,7 +5712,34 @@ function altGatesBlockFor(args) {
     ...shapeAltering
   ]);
 }
+var ALT_BLIND_TOKEN_BUDGET_BREACH = {
+  ceilingTokens: 264,
+  measuredTokensTextWithTools: 285,
+  note: "Blind arm exceeds the stated 264-token ceiling on text+tools (285) and costs ~2.4x the v1-alt arm. Not corrected: compressing it would require editing prose the arm depends on NOT having been edited by this seat. Read a blind-arm LOSS as confounded by token tax; a WIN is unaffected."
+};
+var DISCIPLINE_GATES_V1_ALT_BLIND_HEADER = "Before stating any conclusion, run this check:";
+var ALT_BLIND_BULLETS = {
+  falsify: "- Before committing to an approach, state in one line what evidence would prove it wrong and how you would notice it. If nothing could falsify the approach, you hold a preference, not a plan \u2014 rework it until something could.",
+  deviation: "- When you choose not to follow an applicable instruction, say so explicitly: name the instruction, why you are deviating, and what you are doing instead. Silent deviation is forbidden \u2014 an override is only legitimate when it is visible.",
+  toolPredict: "- When using tools: before each call, state the result you expect. On mismatch, treat the gap as evidence your model of the system is wrong \u2014 revise the model before acting again; never silently retry.",
+  verifyDelegated: "- Verify every delegated or sub-agent result before composing it into an answer: spot-check it against the source or an independent probe. An unverified sub-result is a claim you are repeating, not a fact you know.",
+  markAssumed: '- In the final answer, keep verified claims and assumptions visibly distinct: mark anything unchecked as "assumed" or "unverified". Never let an assumption borrow the confidence of the verified claims beside it.'
+};
+function altBlindGatesBlockFor(args) {
+  const parts = [
+    "falsify",
+    "deviation",
+    ...args.hasTools ? ["toolPredict"] : [],
+    "verifyDelegated",
+    ...args.outputMode === "text" ? ["markAssumed"] : []
+  ];
+  return [
+    DISCIPLINE_GATES_V1_ALT_BLIND_HEADER,
+    ...parts.map((p) => ALT_BLIND_BULLETS[p])
+  ].join("\n");
+}
 var STRATEGY_ALT_SECTION_ID = "__kgauto_strategy_eval_gates_alt__";
+var STRATEGY_ALT_BLIND_SECTION_ID = "__kgauto_strategy_eval_gates_alt_blind__";
 function withAltDisciplineContract(ir) {
   const outputMode = resolveOutputMode({
     declared: ir.constraints?.outputMode,
@@ -5724,6 +5758,28 @@ function withAltDisciplineContract(ir) {
     ]
   };
 }
+function withAltBlindDisciplineContract(ir) {
+  const outputMode = resolveOutputMode({
+    declared: ir.constraints?.outputMode,
+    structuredOutput: ir.constraints?.structuredOutput,
+    toolCount: ir.tools?.length ?? 0
+  });
+  const hasTools = (ir.tools?.length ?? 0) > 0;
+  return {
+    ...ir,
+    sections: [
+      ...ir.sections ?? [],
+      {
+        id: STRATEGY_ALT_BLIND_SECTION_ID,
+        text: altBlindGatesBlockFor({ outputMode, hasTools })
+      }
+    ]
+  };
+}
+var ALT_SECTION_ID_BY_STRATEGY = {
+  "discipline-gates-v1-alt": STRATEGY_ALT_SECTION_ID,
+  "discipline-gates-v1-alt-blind": STRATEGY_ALT_BLIND_SECTION_ID
+};
 async function runGoldenEval(opts) {
   const fetchFn = opts.fetchImpl ?? fetch;
   const progress = opts.onProgress ?? (() => {
@@ -5791,7 +5847,9 @@ async function runGoldenEval(opts) {
   }
   const armBIr = (ir) => {
     if (axis !== "strategy") return ir;
-    return strategyId === "discipline-gates-v1-alt" ? withAltDisciplineContract(ir) : withDisciplineContract(ir);
+    if (strategyId === "discipline-gates-v1-alt") return withAltDisciplineContract(ir);
+    if (strategyId === "discipline-gates-v1-alt-blind") return withAltBlindDisciplineContract(ir);
+    return withDisciplineContract(ir);
   };
   const replay = async (ir, model, captureGates = false) => {
     let gates;
@@ -5803,13 +5861,14 @@ async function runGoldenEval(opts) {
       };
       const compiled = compile(evalIr);
       if (captureGates) {
-        if (strategyId === "discipline-gates-v1-alt") {
+        if (isAltStrategy(strategyId)) {
+          const altSectionId = ALT_SECTION_ID_BY_STRATEGY[strategyId];
           const altSection = (evalIr.sections ?? []).find(
-            (s) => s.id === STRATEGY_ALT_SECTION_ID
+            (s) => s.id === altSectionId
           );
           gates = {
             fired: altSection !== void 0 && altSection.text.length > 0,
-            rule: "discipline-gates-v1-alt",
+            rule: strategyId,
             gateTokens: altSection ? countTokens(`${altSection.text}
 
 `) : 0
@@ -6240,7 +6299,8 @@ function classifyStrategyOutcome(r) {
   if (r.losses > r.wins) return "loses";
   return "ties";
 }
-var STRATEGY_AUTHORSHIP_LIMITATION = "Both gate wordings share one author (kgauto-Cairn); a shared blind spot is invisible to this experiment. Strong verdicts: both-lose (mechanism) and v1-loses/alt-wins (wording). An independently-authored alt would strengthen every other cell.";
+var STRATEGY_AUTHORSHIP_LIMITATION = "Only the v1 wording was measured on this run; no re-wording arm was triggered, so this result says nothing about whether the wording or the mechanism produced it.";
+var STRATEGY_AUTHORSHIP_INDEPENDENT = "Three arms: v1 and one re-wording by this seat, plus an independently authored arm (context-free subagent, no repo access, no knowledge of the experiment). A both-lose verdict therefore spans independent authorship and is not explained by one author's blind spot. Residual limitation: all three arms encode a similar set of underlying principles, so a wrong CHOICE of principles remains harder to see than a wrong wording of them.";
 async function runStrategyEvalWithAttribution(opts) {
   const primary = await runGoldenEval({
     ...opts,
@@ -6257,9 +6317,20 @@ async function runStrategyEvalWithAttribution(opts) {
     axis: "strategy",
     strategy: "discipline-gates-v1-alt"
   });
-  const altOutcome = classifyStrategyOutcome(alt);
-  const attribution = altOutcome === "wins" ? "wording-failure" : altOutcome === "loses" ? "mechanism-failure" : "wording-inconclusive";
-  return { attribution, primary, alt, limitation: STRATEGY_AUTHORSHIP_LIMITATION };
+  const altBlind = await runGoldenEval({
+    ...opts,
+    axis: "strategy",
+    strategy: "discipline-gates-v1-alt-blind"
+  });
+  const outcomes = [classifyStrategyOutcome(alt), classifyStrategyOutcome(altBlind)];
+  const attribution = outcomes.includes("wins") ? "wording-failure" : outcomes.every((o) => o === "loses") ? "mechanism-failure" : "wording-inconclusive";
+  return {
+    attribution,
+    primary,
+    alt,
+    altBlind,
+    limitation: STRATEGY_AUTHORSHIP_INDEPENDENT
+  };
 }
 
 // src/oracle.ts
@@ -6516,6 +6587,30 @@ function createDelegate(opts) {
 }
 
 // src/advisories-api.ts
+var BURST_SPAN_MS = 5 * 60 * 1e3;
+function classifyEvidenceWindow(row) {
+  const { evidence_first_at: first, evidence_last_at: last, evidence_n: n } = row;
+  if (typeof first !== "string" || typeof last !== "string") return null;
+  if (typeof n !== "number" || !Number.isFinite(n) || n <= 0) return null;
+  const t0 = Date.parse(first);
+  const t1 = Date.parse(last);
+  if (Number.isNaN(t0) || Number.isNaN(t1)) return null;
+  const spanMs = Math.max(0, t1 - t0);
+  return { firstAt: first, lastAt: last, n, spanMs, isBurst: spanMs < BURST_SPAN_MS };
+}
+function formatEvidenceSpan(spanMs) {
+  if (spanMs < 1e3) return `${spanMs}ms`;
+  const s = Math.round(spanMs / 1e3);
+  if (s < 90) return `${s}s`;
+  const m = Math.round(s / 60);
+  if (m < 90) return `${m}m`;
+  const h = Math.round(m / 60);
+  if (h < 48) return `${h}h`;
+  return `${Math.round(h / 24)}d`;
+}
+function burstCaveat(w) {
+  return `Evidence is ${w.n} observation${w.n === 1 ? "" : "s"} spanning ${formatEvidenceSpan(w.spanMs)} (${w.firstAt} \u2192 ${w.lastAt}) \u2014 that is a single burst, not a standing rate. Check it against your own deploy log before acting: a cluster this tight is usually one incident, and may already be fixed.`;
+}
 var SEVERITY_SET = /* @__PURE__ */ new Set(["info", "warn", "critical"]);
 var STATUS_SET = /* @__PURE__ */ new Set(["open", "snoozed", "resolved"]);
 var RESOLUTION_SOURCE_SET = /* @__PURE__ */ new Set([
@@ -6555,10 +6650,18 @@ function rowToAdvisory(row) {
     if (docsLink) suggestedFix.docsLink = docsLink;
     if (suggestion) suggestedFix.before = suggestion;
   }
+  const evidenceWindow = classifyEvidenceWindow(
+    row
+  );
+  const declaredSeverity = asSeverity(row.severity);
+  const downgraded = evidenceWindow?.isBurst === true && declaredSeverity === "critical";
+  const effectiveSeverity = downgraded ? "warn" : declaredSeverity;
   const out = {
     id: typeof row.id === "string" ? row.id : "",
     rule: typeof row.rule === "string" ? row.rule : "",
-    severity: asSeverity(row.severity),
+    severity: effectiveSeverity,
+    evidenceWindow,
+    ...downgraded ? { severityBeforeBurstDowngrade: declaredSeverity } : {},
     openedAt: typeof row.opened_at === "string" ? row.opened_at : "",
     lastObservedAt: typeof row.last_observed_at === "string" ? row.last_observed_at : "",
     observationCount: typeof row.observation_count === "number" ? row.observation_count : 0,
@@ -6566,7 +6669,13 @@ function rowToAdvisory(row) {
       ...archetype ? { archetype } : {},
       ...model ? { model } : {}
     },
-    message: typeof row.message === "string" ? row.message : "",
+    // The caveat goes INLINE in the message, not only in `evidenceWindow`.
+    // A structured field a consumer must think to read is the same defect
+    // one layer along: the substrate knowing and not telling. The whole
+    // point is that the check costs a glance rather than a query.
+    message: (typeof row.message === "string" ? row.message : "") + (evidenceWindow?.isBurst ? `
+
+${burstCaveat(evidenceWindow)}` : ""),
     suggestedFix,
     autoApplicable: false,
     // reserved — alpha.30+
@@ -7103,9 +7212,12 @@ export {
   ABSOLUTE_FLOOR,
   ALIASES,
   ALL_ARCHETYPES,
+  ALT_BLIND_TOKEN_BUDGET_BREACH,
+  ALT_STRATEGY_IDS,
   ARCHETYPE_FAMILY_FITS,
   ARCHETYPE_FLOOR_DEFAULT,
   BRAIN_READ_ENV_NAMES,
+  BURST_SPAN_MS,
   COACH_CFG,
   COST_RANKING_REFERENCE_SHAPE,
   CallError,
@@ -7116,6 +7228,7 @@ export {
   DEFAULT_PROMOTIONS_ENDPOINT,
   DELEGATE_TOOL_DEFINITION,
   DIALECT_VERSION,
+  DISCIPLINE_GATES_V1_ALT_BLIND_HEADER,
   DISCIPLINE_GATES_V1_ALT_HEADER,
   FamilyResolutionError,
   INTENT_ARCHETYPES,
@@ -7132,6 +7245,7 @@ export {
   RULE_DISCIPLINE_GATES_V1,
   RULE_DISCIPLINE_GATES_V1_STRUCTURED,
   RULE_SEQUENTIAL_TOOL_CLIFF,
+  STRATEGY_AUTHORSHIP_INDEPENDENT,
   STRATEGY_AUTHORSHIP_LIMITATION,
   TRANSLATOR_FLOOR,
   _testResetMeasuredFailure,
@@ -7139,6 +7253,7 @@ export {
   _testWaitForMeasuredFailureRefresh,
   _testWaitForPromotionsRefresh,
   allProfiles,
+  altBlindGatesBlockFor,
   altGatesBlockFor,
   applyArchetypeConvention,
   applySectionRewrites,
@@ -7152,9 +7267,11 @@ export {
   buildLLMJudge,
   buildPairwiseJudgePrompt,
   buildShadowProbeRow,
+  burstCaveat,
   call,
   captureGoldenIr,
   chainProviderSpread,
+  classifyEvidenceWindow,
   classifyStrategyOutcome,
   clearBrain,
   combineOrderSwappedVerdicts,
@@ -7174,6 +7291,7 @@ export {
   execute,
   findBetterFit,
   flushBrainDeadLetter,
+  formatEvidenceSpan,
   getActionableAdvisories,
   getAllStarterChains,
   getAllStarterChainsWithGrounding,
@@ -7195,6 +7313,7 @@ export {
   getStarterChainWithGrounding,
   hasMutation,
   hashShape,
+  isAltStrategy,
   isArchetype,
   isAutoPromoteEnabledFromEnv,
   isBrainQueryActiveFor,
@@ -7240,6 +7359,7 @@ export {
   resolveGoldenCaptureRate,
   resolvePricingAt,
   resolveProviderKey,
+  rowToAdvisory,
   rubricFor,
   runAdvisor,
   runGoldenEval,
@@ -7248,6 +7368,7 @@ export {
   shouldCaptureGolden,
   tryGetProfile,
   wilsonLowerBound,
+  withAltBlindDisciplineContract,
   withAltDisciplineContract,
   withDisciplineContract
 };

package/dist/key-health.js

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

package/dist/key-health.mjs

@@ -3,7 +3,7 @@ import {
   KEY_FINGERPRINT_LENGTH,
   createKeyHealthRoute,
   keyFingerprint
-} from "./chunk-L246YOV7.mjs";
+} from "./chunk-QEFIAAE7.mjs";
 export {
   KEY_FINGERPRINT_DOMAIN,
   KEY_FINGERPRINT_LENGTH,

package/package.json

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