@warmdrift/kgauto-compiler 2.0.0-alpha.91 → 2.0.0-alpha.93

package/dist/probe.mjs

@@ -0,0 +1,45 @@
+import {
+  compile
+} from "./chunk-BTP5WK3B.mjs";
+import "./chunk-S4PA2BDB.mjs";
+import "./chunk-FEMPY6EC.mjs";
+import {
+  deriveCliffEvidenceClass,
+  getProfile
+} from "./chunk-YO2ZLPSD.mjs";
+
+// src/probe.ts
+function compileSuppressing(ir, opts) {
+  const { suppress, profileResolver, ...rest } = opts;
+  const base = profileResolver ?? getProfile;
+  for (const sel of suppress) {
+    const p = base(sel.model);
+    const hit = p.cliffs.some(
+      (c) => c.metric === sel.metric && (sel.whenIntent === void 0 || c.whenIntent === sel.whenIntent)
+    );
+    if (!hit) {
+      throw new Error(
+        `compileSuppressing: no cliff {metric: ${sel.metric}${sel.whenIntent ? `, whenIntent: ${sel.whenIntent}` : ""}} on ${sel.model} \u2014 refusing to "suppress" a guard that does not exist`
+      );
+    }
+  }
+  const toolRelevanceThreshold = rest.toolRelevanceThreshold ?? 0;
+  const resolver = (id) => {
+    const p = base(id);
+    const sels = suppress.filter((s) => s.model === id || s.model === p.id);
+    if (sels.length === 0) return p;
+    return {
+      ...p,
+      cliffs: p.cliffs.filter(
+        (c) => !sels.some(
+          (s) => s.metric === c.metric && (s.whenIntent === void 0 || c.whenIntent === s.whenIntent)
+        )
+      )
+    };
+  };
+  return compile(ir, { ...rest, toolRelevanceThreshold, profileResolver: resolver });
+}
+export {
+  compileSuppressing,
+  deriveCliffEvidenceClass
+};

package/dist/profiles.d.mts

@@ -1,4 +1,4 @@
-import { l as Provider } from './ir-DeYMLWge.mjs';
+import { l as Provider } from './ir-DyMJ84je.mjs';
 import { IntentArchetypeName } from './dialect.mjs';
 
 /**
@@ -41,7 +41,35 @@ interface CliffRule {
     whenIntent?: IntentArchetypeName;
     /** Human-readable reason for digest reporting. */
     reason: string;
+    /**
+     * alpha.93 (guard-probe-suite Phase 1) — the evidence trail behind this
+     * guard. Provenance classes: 'observed' (a measured incident), 'assumed'
+     * (inherited from a sibling model), 'asserted' (stated without evidence),
+     * 'probed' (the probe suite exercised the bad shape deliberately).
+     * ABSENT renders as 'asserted' — absence is the worst class, deliberately
+     * (see deriveCliffEvidenceClass, which also reads legacy reason prose).
+     * Rides the cliffs JSONB verbatim through every transport layer.
+     */
+    evidence?: CliffEvidence;
+}
+/** See {@link CliffRule.evidence}. */
+interface CliffEvidence {
+    class: 'observed' | 'assumed' | 'asserted' | 'probed';
+    /** ISO date of the newest probe run touching this guard. */
+    lastProbed?: string;
+    verdict?: 'confirmed' | 'flagged' | 'knee-moved';
+    /** FK into kgauto_guard_probe_runs. */
+    probeRunId?: number;
 }
+/**
+ * alpha.93 — evidence class for a guard, derived when the rule predates the
+ * explicit field. Explicit `evidence.class` always wins; the legacy
+ * derivation reads the reason prose the rules have carried since birth
+ * (mechanical keyword classes, pinned by a sweep test over every bundled
+ * cliff — that sweep IS the Phase-1 backfill audit, executable). Anything
+ * unmatched is 'asserted': the worst class, deliberately.
+ */
+declare function deriveCliffEvidenceClass(rule: CliffRule): CliffEvidence['class'];
 /**
  * alpha.43 — per-family-per-archetype prompt-shape convention.
  *
@@ -349,4 +377,4 @@ declare function allProfiles(): readonly ModelProfile[];
 declare function allProfilesRaw(): readonly ModelProfile[];
 declare function profilesByProvider(provider: Provider): readonly ModelProfile[];
 
-export { ALIASES, type ArchetypeConvention, type CacheStrategy, type CliffRule, LATENCY_TIER_MS, type LatencyTier, type LoweringSpec, type ModelProfile, type RecoveryRule, type StructuredOutputCapability, type SystemPromptMode, _setProfileBrainHook, _testClearConsumerProfiles, allProfiles, allProfilesRaw, bestEffortProfile, getProfile, inferProviderFromId, latencyTierOf, profilesByProvider, registerProfiles, resolveModelAlias, tryGetProfile };
+export { ALIASES, type ArchetypeConvention, type CacheStrategy, type CliffEvidence, type CliffRule, LATENCY_TIER_MS, type LatencyTier, type LoweringSpec, type ModelProfile, type RecoveryRule, type StructuredOutputCapability, type SystemPromptMode, _setProfileBrainHook, _testClearConsumerProfiles, allProfiles, allProfilesRaw, bestEffortProfile, deriveCliffEvidenceClass, getProfile, inferProviderFromId, latencyTierOf, profilesByProvider, registerProfiles, resolveModelAlias, tryGetProfile };

package/dist/profiles.d.ts

@@ -1,4 +1,4 @@
-import { l as Provider } from './ir-CTx026t0.js';
+import { l as Provider } from './ir-DbvOFKF-.js';
 import { IntentArchetypeName } from './dialect.js';
 
 /**
@@ -41,7 +41,35 @@ interface CliffRule {
     whenIntent?: IntentArchetypeName;
     /** Human-readable reason for digest reporting. */
     reason: string;
+    /**
+     * alpha.93 (guard-probe-suite Phase 1) — the evidence trail behind this
+     * guard. Provenance classes: 'observed' (a measured incident), 'assumed'
+     * (inherited from a sibling model), 'asserted' (stated without evidence),
+     * 'probed' (the probe suite exercised the bad shape deliberately).
+     * ABSENT renders as 'asserted' — absence is the worst class, deliberately
+     * (see deriveCliffEvidenceClass, which also reads legacy reason prose).
+     * Rides the cliffs JSONB verbatim through every transport layer.
+     */
+    evidence?: CliffEvidence;
+}
+/** See {@link CliffRule.evidence}. */
+interface CliffEvidence {
+    class: 'observed' | 'assumed' | 'asserted' | 'probed';
+    /** ISO date of the newest probe run touching this guard. */
+    lastProbed?: string;
+    verdict?: 'confirmed' | 'flagged' | 'knee-moved';
+    /** FK into kgauto_guard_probe_runs. */
+    probeRunId?: number;
 }
+/**
+ * alpha.93 — evidence class for a guard, derived when the rule predates the
+ * explicit field. Explicit `evidence.class` always wins; the legacy
+ * derivation reads the reason prose the rules have carried since birth
+ * (mechanical keyword classes, pinned by a sweep test over every bundled
+ * cliff — that sweep IS the Phase-1 backfill audit, executable). Anything
+ * unmatched is 'asserted': the worst class, deliberately.
+ */
+declare function deriveCliffEvidenceClass(rule: CliffRule): CliffEvidence['class'];
 /**
  * alpha.43 — per-family-per-archetype prompt-shape convention.
  *
@@ -349,4 +377,4 @@ declare function allProfiles(): readonly ModelProfile[];
 declare function allProfilesRaw(): readonly ModelProfile[];
 declare function profilesByProvider(provider: Provider): readonly ModelProfile[];
 
-export { ALIASES, type ArchetypeConvention, type CacheStrategy, type CliffRule, LATENCY_TIER_MS, type LatencyTier, type LoweringSpec, type ModelProfile, type RecoveryRule, type StructuredOutputCapability, type SystemPromptMode, _setProfileBrainHook, _testClearConsumerProfiles, allProfiles, allProfilesRaw, bestEffortProfile, getProfile, inferProviderFromId, latencyTierOf, profilesByProvider, registerProfiles, resolveModelAlias, tryGetProfile };
+export { ALIASES, type ArchetypeConvention, type CacheStrategy, type CliffEvidence, type CliffRule, LATENCY_TIER_MS, type LatencyTier, type LoweringSpec, type ModelProfile, type RecoveryRule, type StructuredOutputCapability, type SystemPromptMode, _setProfileBrainHook, _testClearConsumerProfiles, allProfiles, allProfilesRaw, bestEffortProfile, deriveCliffEvidenceClass, getProfile, inferProviderFromId, latencyTierOf, profilesByProvider, registerProfiles, resolveModelAlias, tryGetProfile };

package/dist/profiles.js

@@ -27,6 +27,7 @@ __export(profiles_exports, {
   allProfiles: () => allProfiles,
   allProfilesRaw: () => allProfilesRaw,
   bestEffortProfile: () => bestEffortProfile,
+  deriveCliffEvidenceClass: () => deriveCliffEvidenceClass,
   getProfile: () => getProfile,
   inferProviderFromId: () => inferProviderFromId,
   latencyTierOf: () => latencyTierOf,
@@ -36,6 +37,15 @@ __export(profiles_exports, {
   tryGetProfile: () => tryGetProfile
 });
 module.exports = __toCommonJS(profiles_exports);
+function deriveCliffEvidenceClass(rule) {
+  if (rule.evidence?.class) return rule.evidence.class;
+  const r = rule.reason.toLowerCase();
+  if (/inherited|conservative|assume|likely degrades|preemptive|starter hypothesis|same drain risk/.test(r)) {
+    return "assumed";
+  }
+  if (/observed|measured|\d+\/\d+ empty|replayed into/.test(r)) return "observed";
+  return "asserted";
+}
 var LATENCY_TIER_MS = {
   fast: 4e3,
   medium: 11e3,
@@ -2035,6 +2045,7 @@ function profilesByProvider(provider) {
   allProfiles,
   allProfilesRaw,
   bestEffortProfile,
+  deriveCliffEvidenceClass,
   getProfile,
   inferProviderFromId,
   latencyTierOf,

package/dist/profiles.mjs

@@ -6,6 +6,7 @@ import {
   allProfiles,
   allProfilesRaw,
   bestEffortProfile,
+  deriveCliffEvidenceClass,
   getProfile,
   inferProviderFromId,
   latencyTierOf,
@@ -13,7 +14,7 @@ import {
   registerProfiles,
   resolveModelAlias,
   tryGetProfile
-} from "./chunk-T53ISC2F.mjs";
+} from "./chunk-YO2ZLPSD.mjs";
 export {
   ALIASES,
   LATENCY_TIER_MS,
@@ -22,6 +23,7 @@ export {
   allProfiles,
   allProfilesRaw,
   bestEffortProfile,
+  deriveCliffEvidenceClass,
   getProfile,
   inferProviderFromId,
   latencyTierOf,

package/dist/{types-Cp9ot1HV.d.ts → types-5TqjBeZD.d.ts}

@@ -1,4 +1,4 @@
-import { j as Adapter, F as FallbackReason, y as SectionKind } from './ir-CTx026t0.js';
+import { j as Adapter, F as FallbackReason, y as SectionKind } from './ir-DbvOFKF-.js';
 
 /**
  * Wire contract for the Glass-Box Chrome extension's brain-poll endpoint.

package/dist/{types-BKbRtmUb.d.ts → types-BlrbNQfj.d.ts}

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

package/dist/{types-DD36cCbZ.d.mts → types-D441T-KC.d.mts}

@@ -1,4 +1,4 @@
-import { j as Adapter, F as FallbackReason, y as SectionKind } from './ir-DeYMLWge.mjs';
+import { j as Adapter, F as FallbackReason, y as SectionKind } from './ir-DyMJ84je.mjs';
 
 /**
  * Wire contract for the Glass-Box Chrome extension's brain-poll endpoint.

package/dist/{types-cBzinzUR.d.mts → types-_myk4bxn.d.mts}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmdrift/kgauto-compiler",
-  "version": "2.0.0-alpha.91",
+  "version": "2.0.0-alpha.93",
   "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",
@@ -46,6 +46,11 @@
       "import": "./dist/glassbox-routes/format.mjs",
       "require": "./dist/glassbox-routes/format.js"
     },
+    "./probe": {
+      "types": "./dist/probe.d.ts",
+      "import": "./dist/probe.mjs",
+      "require": "./dist/probe.js"
+    },
     "./glassbox-routes/react": {
       "types": "./dist/glassbox-routes/react/index.d.ts",
       "import": "./dist/glassbox-routes/react/index.mjs",
@@ -57,7 +62,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup src/index.ts src/dialect.ts src/profiles.ts src/brain-proxy.ts src/key-health.ts src/glassbox/index.ts src/glassbox-routes/index.ts src/glassbox-routes/format.ts src/glassbox-routes/react/index.ts --format cjs,esm --dts --clean --external react --external react-dom",
+    "build": "tsup src/index.ts src/dialect.ts src/profiles.ts src/brain-proxy.ts src/key-health.ts src/probe.ts src/glassbox/index.ts src/glassbox-routes/index.ts src/glassbox-routes/format.ts src/glassbox-routes/react/index.ts --format cjs,esm --dts --clean --external react --external react-dom",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:stress": "node scripts/stress-test.mjs",