@warmdrift/kgauto-compiler 2.0.0-alpha.48 → 2.0.0-alpha.49

package/dist/index.d.mts

@@ -1844,6 +1844,10 @@ interface ModelBrainRow {
     active?: boolean;
     /** alpha.41 — model-family tag (migration 024 column). */
     family?: string | null;
+    /** alpha.49 — explicit latency bucket (migration 028 column). */
+    latency_tier?: string | null;
+    /** alpha.49 — per-archetype prompt-shape conventions (migration 028 column). */
+    archetype_conventions?: ArchetypeConvention[] | null;
 }
 interface ProfileToRowOptions {
     /** e.g. `'2.0.0-alpha.12'` — leave undefined to omit from row. */

package/dist/index.d.ts

@@ -1844,6 +1844,10 @@ interface ModelBrainRow {
     active?: boolean;
     /** alpha.41 — model-family tag (migration 024 column). */
     family?: string | null;
+    /** alpha.49 — explicit latency bucket (migration 028 column). */
+    latency_tier?: string | null;
+    /** alpha.49 — per-archetype prompt-shape conventions (migration 028 column). */
+    archetype_conventions?: ArchetypeConvention[] | null;
 }
 interface ProfileToRowOptions {
     /** e.g. `'2.0.0-alpha.12'` — leave undefined to omit from row. */

package/dist/index.js

@@ -1587,6 +1587,9 @@ function rowToProfile(row) {
     if (row.lowering !== void 0 && row.lowering !== null && (typeof row.lowering !== "object" || Array.isArray(row.lowering))) {
       return null;
     }
+    if (row.archetype_conventions !== void 0 && row.archetype_conventions !== null && !Array.isArray(row.archetype_conventions)) {
+      return null;
+    }
     return {
       id: row.model_id,
       provider: row.provider,
@@ -1613,12 +1616,21 @@ function rowToProfile(row) {
       // resolution time (see family-resolution.ts, G1).
       family: row.family ?? void 0,
       versionAdded: row.version_added ?? void 0,
-      active: row.active ?? void 0
+      active: row.active ?? void 0,
+      // alpha.49 — executable-knowledge fields (migration 028). Invalid
+      // latency_tier → undefined (latencyTierOf derives from tags; not
+      // safety-critical). archetype_conventions already array-validated above.
+      latencyTier: normalizeLatencyTier(row.latency_tier),
+      archetypeConventions: row.archetype_conventions ?? void 0
     };
   } catch {
     return null;
   }
 }
+var VALID_LATENCY_TIERS = /* @__PURE__ */ new Set(["fast", "medium", "slow"]);
+function normalizeLatencyTier(v) {
+  return typeof v === "string" && VALID_LATENCY_TIERS.has(v) ? v : void 0;
+}
 function profileToRow(profile, opts = {}) {
   const row = {
     model_id: profile.id,
@@ -1644,7 +1656,12 @@ function profileToRow(profile, opts = {}) {
     // alpha.41 — round-trip family + version_added when present on profile.
     // version_added is operator-controlled via opts; profile-side value is
     // used only when opts didn't override.
-    family: profile.family ?? null
+    family: profile.family ?? null,
+    // alpha.49 — round-trip the executable-knowledge fields (migration 028)
+    // so a reseed from bundled profiles makes the latency lever + schema
+    // conventions live warm. Closes the silently-dropped-field gap.
+    latency_tier: profile.latencyTier ?? null,
+    archetype_conventions: profile.archetypeConventions ?? null
   };
   if (opts.verifiedAgainstDocs !== void 0) {
     row.verified_against_docs = opts.verifiedAgainstDocs;
@@ -2389,6 +2406,17 @@ function passApplyCliffs(ir, profile, estimatedInputTokens) {
 }
 var LATENCY_OVERAGE_WEIGHT = 0.6;
 var LATENCY_PENALTY_CAP = 1;
+var QUALITY_GATE_PENALTY = 4;
+function effectiveConventions(profile) {
+  const own = profile.archetypeConventions ?? [];
+  if (own.length > 0) return own;
+  const family = profile.family ?? deriveFamilyFromModelId(profile.id);
+  if (!family) return [];
+  const repId = familyRepId(family);
+  if (!repId || repId === profile.id) return [];
+  const rep = tryGetProfile(repId);
+  return rep?.archetypeConventions ?? [];
+}
 function passScoreTargets(ir, opts) {
   const constraints = ir.constraints ?? {};
   const policy = opts.policy ?? {};
@@ -2453,7 +2481,14 @@ function passScoreTargets(ir, opts) {
         latencyPenalty = Math.min(LATENCY_OVERAGE_WEIGHT * overage, LATENCY_PENALTY_CAP);
       }
     }
-    const rank = qualityScore + callerOrderBoost - costPenalty - reasons.length * 10 + preferredBoost - latencyPenalty;
+    let qualityGatePenalty = 0;
+    if (constraints.structuredOutput) {
+      const schemaWeak = effectiveConventions(profile).some(
+        (c) => c.archetype === ir.intent.archetype && c.structuredOutputHint === "avoid"
+      );
+      if (schemaWeak) qualityGatePenalty = QUALITY_GATE_PENALTY;
+    }
+    const rank = qualityScore + callerOrderBoost - costPenalty - reasons.length * 10 + preferredBoost - latencyPenalty - qualityGatePenalty;
     scores.push({
       modelId,
       estimatedCostUsd,
@@ -2495,6 +2530,14 @@ function passScoreTargets(ir, opts) {
         description: `Model ${modelId} rank down ${latencyPenalty.toFixed(2)} \u2014 latency tier '${tier}' (~${LATENCY_TIER_MS[tier]}ms) exceeds constraints.maxLatencyMs (${maxLatencyMs}ms)`
       });
     }
+    if (qualityGatePenalty > 0) {
+      policyMutations.push({
+        id: `quality-gate-structured-${modelId}`,
+        source: "quality_gate",
+        passName: "score_targets",
+        description: `Model ${modelId} gated below the quality floor for archetype '${ir.intent.archetype}' \u2014 declared structuredOutput + kgauto convention flags it schema-weak for this contract (structuredOutputHint:'avoid'). Down-ranked out of leadership; retained as graceful fallback only.`
+      });
+    }
   }
   return { value: scores, mutations: policyMutations };
 }

package/dist/index.mjs

@@ -76,6 +76,9 @@ function rowToProfile(row) {
     if (row.lowering !== void 0 && row.lowering !== null && (typeof row.lowering !== "object" || Array.isArray(row.lowering))) {
       return null;
     }
+    if (row.archetype_conventions !== void 0 && row.archetype_conventions !== null && !Array.isArray(row.archetype_conventions)) {
+      return null;
+    }
     return {
       id: row.model_id,
       provider: row.provider,
@@ -102,12 +105,21 @@ function rowToProfile(row) {
       // resolution time (see family-resolution.ts, G1).
       family: row.family ?? void 0,
       versionAdded: row.version_added ?? void 0,
-      active: row.active ?? void 0
+      active: row.active ?? void 0,
+      // alpha.49 — executable-knowledge fields (migration 028). Invalid
+      // latency_tier → undefined (latencyTierOf derives from tags; not
+      // safety-critical). archetype_conventions already array-validated above.
+      latencyTier: normalizeLatencyTier(row.latency_tier),
+      archetypeConventions: row.archetype_conventions ?? void 0
     };
   } catch {
     return null;
   }
 }
+var VALID_LATENCY_TIERS = /* @__PURE__ */ new Set(["fast", "medium", "slow"]);
+function normalizeLatencyTier(v) {
+  return typeof v === "string" && VALID_LATENCY_TIERS.has(v) ? v : void 0;
+}
 function profileToRow(profile, opts = {}) {
   const row = {
     model_id: profile.id,
@@ -133,7 +145,12 @@ function profileToRow(profile, opts = {}) {
     // alpha.41 — round-trip family + version_added when present on profile.
     // version_added is operator-controlled via opts; profile-side value is
     // used only when opts didn't override.
-    family: profile.family ?? null
+    family: profile.family ?? null,
+    // alpha.49 — round-trip the executable-knowledge fields (migration 028)
+    // so a reseed from bundled profiles makes the latency lever + schema
+    // conventions live warm. Closes the silently-dropped-field gap.
+    latency_tier: profile.latencyTier ?? null,
+    archetype_conventions: profile.archetypeConventions ?? null
   };
   if (opts.verifiedAgainstDocs !== void 0) {
     row.verified_against_docs = opts.verifiedAgainstDocs;
@@ -714,6 +731,17 @@ function passApplyCliffs(ir, profile, estimatedInputTokens) {
 }
 var LATENCY_OVERAGE_WEIGHT = 0.6;
 var LATENCY_PENALTY_CAP = 1;
+var QUALITY_GATE_PENALTY = 4;
+function effectiveConventions(profile) {
+  const own = profile.archetypeConventions ?? [];
+  if (own.length > 0) return own;
+  const family = profile.family ?? deriveFamilyFromModelId(profile.id);
+  if (!family) return [];
+  const repId = familyRepId(family);
+  if (!repId || repId === profile.id) return [];
+  const rep = tryGetProfile(repId);
+  return rep?.archetypeConventions ?? [];
+}
 function passScoreTargets(ir, opts) {
   const constraints = ir.constraints ?? {};
   const policy = opts.policy ?? {};
@@ -778,7 +806,14 @@ function passScoreTargets(ir, opts) {
         latencyPenalty = Math.min(LATENCY_OVERAGE_WEIGHT * overage, LATENCY_PENALTY_CAP);
       }
     }
-    const rank = qualityScore + callerOrderBoost - costPenalty - reasons.length * 10 + preferredBoost - latencyPenalty;
+    let qualityGatePenalty = 0;
+    if (constraints.structuredOutput) {
+      const schemaWeak = effectiveConventions(profile).some(
+        (c) => c.archetype === ir.intent.archetype && c.structuredOutputHint === "avoid"
+      );
+      if (schemaWeak) qualityGatePenalty = QUALITY_GATE_PENALTY;
+    }
+    const rank = qualityScore + callerOrderBoost - costPenalty - reasons.length * 10 + preferredBoost - latencyPenalty - qualityGatePenalty;
     scores.push({
       modelId,
       estimatedCostUsd,
@@ -820,6 +855,14 @@ function passScoreTargets(ir, opts) {
         description: `Model ${modelId} rank down ${latencyPenalty.toFixed(2)} \u2014 latency tier '${tier}' (~${LATENCY_TIER_MS[tier]}ms) exceeds constraints.maxLatencyMs (${maxLatencyMs}ms)`
       });
     }
+    if (qualityGatePenalty > 0) {
+      policyMutations.push({
+        id: `quality-gate-structured-${modelId}`,
+        source: "quality_gate",
+        passName: "score_targets",
+        description: `Model ${modelId} gated below the quality floor for archetype '${ir.intent.archetype}' \u2014 declared structuredOutput + kgauto convention flags it schema-weak for this contract (structuredOutputHint:'avoid'). Down-ranked out of leadership; retained as graceful fallback only.`
+      });
+    }
   }
   return { value: scores, mutations: policyMutations };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmdrift/kgauto-compiler",
-  "version": "2.0.0-alpha.48",
+  "version": "2.0.0-alpha.49",
   "description": "Prompt compiler + central learning brain for multi-model AI apps. Swap models without rewriting prompts.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",