@lucern/sdk 1.0.11 → 1.0.12

package/dist/contextPackPolicy.d.ts

@@ -1,7 +1,6 @@
-import { PackWeightOverride, ContextPackSectionKey, RankingWeightVector, ContextRankingProfile } from './contracts/context-pack.contract.js';
-
-type SectionKey = ContextPackSectionKey;
-type RankCandidate = {
+import { type PackWeightOverride, type RankingWeightVector, type ContextPackSectionKey, type ContextRankingProfile } from "./contracts/context-pack.contract";
+export type SectionKey = ContextPackSectionKey;
+export type RankCandidate = {
     id: string;
     text: string;
     updatedAt?: number | null;
@@ -11,7 +10,7 @@ type RankCandidate = {
     priority?: string | null;
     severity?: string | null;
 };
-type RankedCandidate<T extends RankCandidate> = T & {
+export type RankedCandidate<T extends RankCandidate> = T & {
     score: number;
     justification?: string;
 };
@@ -21,7 +20,7 @@ type LexicalExclusion = {
     reason: "budget_exceeded" | "anti_repetition" | "below_threshold";
     score: number;
 };
-type InjectionPlan = {
+export type InjectionPlan = {
     tokenBudget: number;
     estimatedTokens: number;
     sectionBudgets: Record<SectionKey, number>;
@@ -34,10 +33,10 @@ type RankContextOptions = {
     includeJustifications?: boolean;
     referenceTimeMs?: number;
 };
-declare function resolveEffectiveWeights(overrides?: PackWeightOverride[]): Readonly<Record<ContextPackSectionKey, RankingWeightVector>>;
-declare function rankContextSection<T extends RankCandidate>(section: SectionKey, rows: T[], queryTokens: string[], limit: number, profile: ContextRankingProfile, options?: RankContextOptions): RankedCandidate<T>[];
-declare function parseTokenBudget(value: unknown, fallback?: number): number;
-declare function buildInjectionPlan(args: {
+export declare function resolveEffectiveWeights(overrides?: PackWeightOverride[]): Readonly<Record<ContextPackSectionKey, RankingWeightVector>>;
+export declare function rankContextSection<T extends RankCandidate>(section: SectionKey, rows: T[], queryTokens: string[], limit: number, profile: ContextRankingProfile, options?: RankContextOptions): RankedCandidate<T>[];
+export declare function parseTokenBudget(value: unknown, fallback?: number): number;
+export declare function buildInjectionPlan(args: {
     tokenBudget: number;
     invariants: Array<{
         nodeId: string;
@@ -66,7 +65,7 @@ declare function buildInjectionPlan(args: {
     }>;
     trackExclusions?: boolean;
 }): InjectionPlan;
-type EntityCandidate = {
+export type EntityCandidate = {
     nodeId: string;
     entityType: string;
     title: string;
@@ -76,9 +75,9 @@ type EntityCandidate = {
     metadata: Record<string, unknown>;
     updatedAt?: number | null;
 };
-type RankedEntity = EntityCandidate & {
+export type RankedEntity = EntityCandidate & {
     score: number;
 };
-declare function rankEntities(candidates: EntityCandidate[], queryTokens: string[], limit?: number): RankedEntity[];
-
-export { type EntityCandidate, type InjectionPlan, type RankCandidate, type RankedCandidate, type RankedEntity, type SectionKey, buildInjectionPlan, parseTokenBudget, rankContextSection, rankEntities, resolveEffectiveWeights };
+export declare function rankEntities(candidates: EntityCandidate[], queryTokens: string[], limit?: number): RankedEntity[];
+export {};
+//# sourceMappingURL=contextPackPolicy.d.ts.map

package/dist/contextPackPolicy.js

@@ -1,337 +1,259 @@
-// src/contracts/context-pack.contract.ts
-var SECTION_BUDGET_RATIOS = {
-  invariants: 0.28,
-  activeBeliefs: 0.3,
-  openQuestions: 0.17,
-  recentEvidence: 0.17,
-  contradictions: 0.08
-};
-var MIN_TOKEN_BUDGET = 400;
-var MAX_TOKEN_BUDGET = 8e3;
-var DEFAULT_TOKEN_BUDGET = 1800;
-var MIN_CONTRADICTION_BUDGET = 40;
-var RANKING_WEIGHTS = {
-  invariants: {
-    query: 0.35,
-    recency: 0.1,
-    confidence: 0.4,
-    beliefType: 0.15
-  },
-  activeBeliefs: {
-    query: 0.5,
-    recency: 0.2,
-    confidence: 0.2,
-    beliefType: 0.1
-  },
-  openQuestions: {
-    query: 0.55,
-    recency: 0.2,
-    priority: 0.25
-  },
-  recentEvidence: {
-    query: 0.6,
-    recency: 0.4
-  },
-  contradictions: {
-    query: 0.4,
-    recency: 0.2,
-    severity: 0.4
-  }
-};
-var RECENCY_HALF_LIFE_DAYS = 30;
-var ENTITY_RANKING_WEIGHTS = {
-  query: 0.4,
-  connectivity: 0.6
-};
-var DEFAULT_ENTITY_LIMIT = 10;
-var MAX_ENTITY_LIMIT = 50;
-var BELIEF_TYPE_BONUS = {
-  invariant: 1,
-  tenet: 0.8,
-  principle: 0.6
-};
-var DEFAULT_BELIEF_TYPE_BONUS = 0.4;
-var PRIORITY_SCORES = {
-  critical: 1,
-  high: 0.85,
-  medium: 0.55,
-  low: 0.35
-};
-var DEFAULT_PRIORITY_SCORE = 0.5;
-var SEVERITY_SCORES = {
-  critical: 1,
-  high: 0.85,
-  medium: 0.6,
-  low: 0.35
-};
-var DEFAULT_SEVERITY_SCORE = 0.5;
-var TOKENS_PER_WORD = 1.35;
-var MIN_TOKEN_ESTIMATE = 8;
-
-// src/contextPackPolicy.ts
+import { BELIEF_TYPE_BONUS, DEFAULT_ENTITY_LIMIT, DEFAULT_BELIEF_TYPE_BONUS, DEFAULT_PRIORITY_SCORE, DEFAULT_SEVERITY_SCORE, DEFAULT_TOKEN_BUDGET, ENTITY_RANKING_WEIGHTS, MAX_TOKEN_BUDGET, MAX_ENTITY_LIMIT, MIN_CONTRADICTION_BUDGET, MIN_TOKEN_BUDGET, MIN_TOKEN_ESTIMATE, PRIORITY_SCORES, RANKING_WEIGHTS, RECENCY_HALF_LIFE_DAYS, SECTION_BUDGET_RATIOS, SEVERITY_SCORES, TOKENS_PER_WORD, } from "./contracts/context-pack.contract.js";
 function tokenHits(text, tokens) {
-  if (tokens.length === 0) {
-    return 1;
-  }
-  const haystack = text.trim().toLowerCase();
-  let hits = 0;
-  for (const token of tokens) {
-    if (haystack.includes(token)) {
-      hits += 1;
+    if (tokens.length === 0) {
+        return 1;
     }
-  }
-  return hits;
+    const haystack = text.trim().toLowerCase();
+    let hits = 0;
+    for (const token of tokens) {
+        if (haystack.includes(token)) {
+            hits += 1;
+        }
+    }
+    return hits;
 }
 function clamp01(value) {
-  if (!Number.isFinite(value)) {
-    return 0;
-  }
-  return Math.max(0, Math.min(1, value));
+    if (!Number.isFinite(value)) {
+        return 0;
+    }
+    return Math.max(0, Math.min(1, value));
 }
 function recencyScore(updatedAt, referenceTimeMs = Date.now()) {
-  if (!updatedAt || !Number.isFinite(updatedAt)) {
-    return 0.25;
-  }
-  const ageMs = Math.max(0, referenceTimeMs - updatedAt);
-  const ageDays = ageMs / (1e3 * 60 * 60 * 24);
-  const decay = 0.5 ** (ageDays / RECENCY_HALF_LIFE_DAYS);
-  return clamp01(decay);
+    if (!updatedAt || !Number.isFinite(updatedAt)) {
+        return 0.25;
+    }
+    const ageMs = Math.max(0, referenceTimeMs - updatedAt);
+    const ageDays = ageMs / (1000 * 60 * 60 * 24);
+    const decay = 0.5 ** (ageDays / RECENCY_HALF_LIFE_DAYS);
+    return clamp01(decay);
 }
 function confidenceScore(confidence) {
-  if (typeof confidence !== "number" || !Number.isFinite(confidence)) {
-    return 0.5;
-  }
-  return clamp01(confidence);
+    if (typeof confidence !== "number" || !Number.isFinite(confidence)) {
+        return 0.5;
+    }
+    return clamp01(confidence);
 }
 function priorityScore(priority) {
-  const value = (priority || "").trim().toLowerCase();
-  return PRIORITY_SCORES[value] ?? DEFAULT_PRIORITY_SCORE;
+    const value = (priority || "").trim().toLowerCase();
+    return PRIORITY_SCORES[value] ?? DEFAULT_PRIORITY_SCORE;
 }
 function severityScore(severity) {
-  const value = (severity || "").trim().toLowerCase();
-  return SEVERITY_SCORES[value] ?? DEFAULT_SEVERITY_SCORE;
+    const value = (severity || "").trim().toLowerCase();
+    return SEVERITY_SCORES[value] ?? DEFAULT_SEVERITY_SCORE;
 }
 function beliefTypeBonus(beliefType) {
-  const value = (beliefType || "").trim().toLowerCase();
-  return BELIEF_TYPE_BONUS[value] ?? DEFAULT_BELIEF_TYPE_BONUS;
+    const value = (beliefType || "").trim().toLowerCase();
+    return BELIEF_TYPE_BONUS[value] ?? DEFAULT_BELIEF_TYPE_BONUS;
 }
-function resolveEffectiveWeights(overrides) {
-  if (!overrides || overrides.length === 0) {
-    return RANKING_WEIGHTS;
-  }
-  const result = { ...RANKING_WEIGHTS };
-  for (const override of overrides) {
-    const base = RANKING_WEIGHTS[override.section];
-    if (base) {
-      result[override.section] = { ...base, ...override.weights };
+export function resolveEffectiveWeights(overrides) {
+    if (!overrides || overrides.length === 0) {
+        return RANKING_WEIGHTS;
+    }
+    const result = { ...RANKING_WEIGHTS };
+    for (const override of overrides) {
+        const base = RANKING_WEIGHTS[override.section];
+        if (base) {
+            result[override.section] = { ...base, ...override.weights };
+        }
     }
-  }
-  return result;
+    return result;
 }
 function generateJustification(_section, candidate, queryTokens, weights) {
-  const parts = [];
-  const hits = tokenHits(candidate.text, queryTokens);
-  if (queryTokens.length > 0 && hits > 0) {
-    parts.push(`${hits}/${queryTokens.length} query terms matched`);
-  } else if (queryTokens.length === 0) {
-    parts.push("no query filter");
-  }
-  const ts = candidate.updatedAt || candidate.createdAt || null;
-  if (ts && Number.isFinite(ts)) {
-    const ageDays = Math.max(0, Date.now() - ts) / (1e3 * 60 * 60 * 24);
-    if (ageDays < 1) {
-      parts.push("updated today");
-    } else if (ageDays < 7) {
-      parts.push(`updated ${Math.floor(ageDays)}d ago`);
-    } else if (ageDays < 30) {
-      parts.push(`updated ${Math.floor(ageDays / 7)}w ago`);
-    } else {
-      parts.push(`updated ${Math.floor(ageDays)}d ago (decayed)`);
+    const parts = [];
+    const hits = tokenHits(candidate.text, queryTokens);
+    if (queryTokens.length > 0 && hits > 0) {
+        parts.push(`${hits}/${queryTokens.length} query terms matched`);
+    }
+    else if (queryTokens.length === 0) {
+        parts.push("no query filter");
+    }
+    const ts = candidate.updatedAt || candidate.createdAt || null;
+    if (ts && Number.isFinite(ts)) {
+        const ageDays = Math.max(0, Date.now() - ts) / (1000 * 60 * 60 * 24);
+        if (ageDays < 1) {
+            parts.push("updated today");
+        }
+        else if (ageDays < 7) {
+            parts.push(`updated ${Math.floor(ageDays)}d ago`);
+        }
+        else if (ageDays < 30) {
+            parts.push(`updated ${Math.floor(ageDays / 7)}w ago`);
+        }
+        else {
+            parts.push(`updated ${Math.floor(ageDays)}d ago (decayed)`);
+        }
+    }
+    if (weights.confidence !== undefined &&
+        candidate.confidence !== null &&
+        candidate.confidence !== undefined) {
+        parts.push(`confidence=${candidate.confidence.toFixed(2)}`);
+    }
+    if (weights.beliefType !== undefined && candidate.beliefType) {
+        parts.push(`type=${candidate.beliefType}`);
+    }
+    if (weights.priority !== undefined && candidate.priority) {
+        parts.push(`priority=${candidate.priority}`);
     }
-  }
-  if (weights.confidence !== void 0 && candidate.confidence !== null && candidate.confidence !== void 0) {
-    parts.push(`confidence=${candidate.confidence.toFixed(2)}`);
-  }
-  if (weights.beliefType !== void 0 && candidate.beliefType) {
-    parts.push(`type=${candidate.beliefType}`);
-  }
-  if (weights.priority !== void 0 && candidate.priority) {
-    parts.push(`priority=${candidate.priority}`);
-  }
-  if (weights.severity !== void 0 && candidate.severity) {
-    parts.push(`severity=${candidate.severity}`);
-  }
-  return parts.join(", ");
+    if (weights.severity !== undefined && candidate.severity) {
+        parts.push(`severity=${candidate.severity}`);
+    }
+    return parts.join(", ");
 }
 function computeWeightedScore(section, candidate, queryTokens, effectiveWeights, referenceTimeMs) {
-  const weights = (effectiveWeights ?? RANKING_WEIGHTS)[section];
-  const queryComponent = queryTokens.length === 0 ? 0.4 : clamp01(tokenHits(candidate.text, queryTokens) / queryTokens.length);
-  const recencyComponent = recencyScore(
-    candidate.updatedAt || candidate.createdAt || null,
-    referenceTimeMs
-  );
-  let score = queryComponent * weights.query + recencyComponent * weights.recency;
-  if (weights.confidence !== void 0) {
-    score += confidenceScore(candidate.confidence) * weights.confidence;
-  }
-  if (weights.beliefType !== void 0) {
-    score += beliefTypeBonus(candidate.beliefType) * weights.beliefType;
-  }
-  if (weights.priority !== void 0) {
-    score += priorityScore(candidate.priority) * weights.priority;
-  }
-  if (weights.severity !== void 0) {
-    score += severityScore(candidate.severity) * weights.severity;
-  }
-  return score;
-}
-function rankContextSection(section, rows, queryTokens, limit, profile, options) {
-  const effectiveWeights = options?.effectiveWeights;
-  const includeJustifications = options?.includeJustifications ?? false;
-  const referenceTimeMs = options?.referenceTimeMs;
-  const scored = rows.map((row) => {
-    const score = profile === "weighted_v1" ? computeWeightedScore(
-      section,
-      row,
-      queryTokens,
-      effectiveWeights,
-      referenceTimeMs
-    ) : queryTokens.length === 0 ? 1 : tokenHits(row.text, queryTokens);
-    const result = { ...row, score };
-    if (includeJustifications && profile === "weighted_v1") {
-      const weights = (effectiveWeights ?? RANKING_WEIGHTS)[section];
-      result.justification = generateJustification(section, row, queryTokens, weights);
+    const weights = (effectiveWeights ?? RANKING_WEIGHTS)[section];
+    const queryComponent = queryTokens.length === 0
+        ? 0.4
+        : clamp01(tokenHits(candidate.text, queryTokens) / queryTokens.length);
+    const recencyComponent = recencyScore(candidate.updatedAt || candidate.createdAt || null, referenceTimeMs);
+    let score = queryComponent * weights.query + recencyComponent * weights.recency;
+    if (weights.confidence !== undefined) {
+        score += confidenceScore(candidate.confidence) * weights.confidence;
     }
-    return result;
-  });
-  const filtered = queryTokens.length === 0 ? scored : scored.filter((row) => row.score > 0);
-  filtered.sort((left, right) => {
-    if (right.score !== left.score) {
-      return right.score - left.score;
+    if (weights.beliefType !== undefined) {
+        score += beliefTypeBonus(candidate.beliefType) * weights.beliefType;
+    }
+    if (weights.priority !== undefined) {
+        score += priorityScore(candidate.priority) * weights.priority;
+    }
+    if (weights.severity !== undefined) {
+        score += severityScore(candidate.severity) * weights.severity;
     }
-    const rightTs = right.updatedAt || right.createdAt || 0;
-    const leftTs = left.updatedAt || left.createdAt || 0;
-    return rightTs - leftTs;
-  });
-  return filtered.slice(0, limit);
+    return score;
 }
-function parseTokenBudget(value, fallback = DEFAULT_TOKEN_BUDGET) {
-  const parsed = typeof value === "number" && Number.isFinite(value) ? Math.floor(value) : fallback;
-  return Math.max(MIN_TOKEN_BUDGET, Math.min(MAX_TOKEN_BUDGET, parsed));
+export function rankContextSection(section, rows, queryTokens, limit, profile, options) {
+    const effectiveWeights = options?.effectiveWeights;
+    const includeJustifications = options?.includeJustifications ?? false;
+    const referenceTimeMs = options?.referenceTimeMs;
+    const scored = rows.map((row) => {
+        const score = profile === "weighted_v1"
+            ? computeWeightedScore(section, row, queryTokens, effectiveWeights, referenceTimeMs)
+            : queryTokens.length === 0
+                ? 1
+                : tokenHits(row.text, queryTokens);
+        const result = { ...row, score };
+        if (includeJustifications && profile === "weighted_v1") {
+            const weights = (effectiveWeights ?? RANKING_WEIGHTS)[section];
+            result.justification = generateJustification(section, row, queryTokens, weights);
+        }
+        return result;
+    });
+    const filtered = queryTokens.length === 0 ? scored : scored.filter((row) => row.score > 0);
+    filtered.sort((left, right) => {
+        if (right.score !== left.score) {
+            return right.score - left.score;
+        }
+        const rightTs = right.updatedAt || right.createdAt || 0;
+        const leftTs = left.updatedAt || left.createdAt || 0;
+        return rightTs - leftTs;
+    });
+    return filtered.slice(0, limit);
+}
+export function parseTokenBudget(value, fallback = DEFAULT_TOKEN_BUDGET) {
+    const parsed = typeof value === "number" && Number.isFinite(value)
+        ? Math.floor(value)
+        : fallback;
+    return Math.max(MIN_TOKEN_BUDGET, Math.min(MAX_TOKEN_BUDGET, parsed));
 }
 function estimateTokens(text) {
-  const words = text.trim().split(/\s+/).filter(Boolean).length;
-  return Math.max(MIN_TOKEN_ESTIMATE, Math.ceil(words * TOKENS_PER_WORD));
+    const words = text.trim().split(/\s+/).filter(Boolean).length;
+    return Math.max(MIN_TOKEN_ESTIMATE, Math.ceil(words * TOKENS_PER_WORD));
 }
-function buildInjectionPlan(args) {
-  const tokenBudget = parseTokenBudget(args.tokenBudget);
-  const trackExclusions = args.trackExclusions ?? false;
-  const sectionBudgets = {
-    invariants: Math.floor(tokenBudget * SECTION_BUDGET_RATIOS.invariants),
-    activeBeliefs: Math.floor(
-      tokenBudget * SECTION_BUDGET_RATIOS.activeBeliefs
-    ),
-    openQuestions: Math.floor(
-      tokenBudget * SECTION_BUDGET_RATIOS.openQuestions
-    ),
-    recentEvidence: Math.floor(
-      tokenBudget * SECTION_BUDGET_RATIOS.recentEvidence
-    ),
-    contradictions: Math.max(
-      MIN_CONTRADICTION_BUDGET,
-      Math.floor(tokenBudget * SECTION_BUDGET_RATIOS.contradictions)
-    )
-  };
-  const selected = {
-    invariants: [],
-    activeBeliefs: [],
-    openQuestions: [],
-    recentEvidence: [],
-    contradictions: []
-  };
-  const sectionUsage = {
-    invariants: 0,
-    activeBeliefs: 0,
-    openQuestions: 0,
-    recentEvidence: 0,
-    contradictions: 0
-  };
-  const excludedItems = [];
-  const pushItem = (section, id, text, score) => {
-    const itemTokens = estimateTokens(text);
-    const nextUsage = sectionUsage[section] + itemTokens;
-    if (nextUsage > sectionBudgets[section]) {
-      if (trackExclusions) {
-        excludedItems.push({
-          id,
-          section,
-          reason: "budget_exceeded",
-          score: score ?? 0
-        });
-      }
-      return;
+export function buildInjectionPlan(args) {
+    const tokenBudget = parseTokenBudget(args.tokenBudget);
+    const trackExclusions = args.trackExclusions ?? false;
+    const sectionBudgets = {
+        invariants: Math.floor(tokenBudget * SECTION_BUDGET_RATIOS.invariants),
+        activeBeliefs: Math.floor(tokenBudget * SECTION_BUDGET_RATIOS.activeBeliefs),
+        openQuestions: Math.floor(tokenBudget * SECTION_BUDGET_RATIOS.openQuestions),
+        recentEvidence: Math.floor(tokenBudget * SECTION_BUDGET_RATIOS.recentEvidence),
+        contradictions: Math.max(MIN_CONTRADICTION_BUDGET, Math.floor(tokenBudget * SECTION_BUDGET_RATIOS.contradictions)),
+    };
+    const selected = {
+        invariants: [],
+        activeBeliefs: [],
+        openQuestions: [],
+        recentEvidence: [],
+        contradictions: [],
+    };
+    const sectionUsage = {
+        invariants: 0,
+        activeBeliefs: 0,
+        openQuestions: 0,
+        recentEvidence: 0,
+        contradictions: 0,
+    };
+    const excludedItems = [];
+    const pushItem = (section, id, text, score) => {
+        const itemTokens = estimateTokens(text);
+        const nextUsage = sectionUsage[section] + itemTokens;
+        if (nextUsage > sectionBudgets[section]) {
+            if (trackExclusions) {
+                excludedItems.push({
+                    id,
+                    section,
+                    reason: "budget_exceeded",
+                    score: score ?? 0,
+                });
+            }
+            return;
+        }
+        selected[section].push(id);
+        sectionUsage[section] = nextUsage;
+    };
+    for (const row of args.invariants) {
+        pushItem("invariants", row.nodeId, row.canonicalText, row.score);
+    }
+    for (const row of args.activeBeliefs) {
+        pushItem("activeBeliefs", row.nodeId, row.canonicalText, row.score);
+    }
+    for (const row of args.openQuestions) {
+        pushItem("openQuestions", row.questionId, row.text, row.score);
+    }
+    for (const row of args.recentEvidence) {
+        pushItem("recentEvidence", row.nodeId, row.canonicalText, row.score);
+    }
+    for (const row of args.contradictions) {
+        pushItem("contradictions", row.contradictionId, row.description, row.score);
     }
-    selected[section].push(id);
-    sectionUsage[section] = nextUsage;
-  };
-  for (const row of args.invariants) {
-    pushItem("invariants", row.nodeId, row.canonicalText, row.score);
-  }
-  for (const row of args.activeBeliefs) {
-    pushItem("activeBeliefs", row.nodeId, row.canonicalText, row.score);
-  }
-  for (const row of args.openQuestions) {
-    pushItem("openQuestions", row.questionId, row.text, row.score);
-  }
-  for (const row of args.recentEvidence) {
-    pushItem("recentEvidence", row.nodeId, row.canonicalText, row.score);
-  }
-  for (const row of args.contradictions) {
-    pushItem("contradictions", row.contradictionId, row.description, row.score);
-  }
-  const estimatedTokens = sectionUsage.invariants + sectionUsage.activeBeliefs + sectionUsage.openQuestions + sectionUsage.recentEvidence + sectionUsage.contradictions;
-  return {
-    tokenBudget,
-    estimatedTokens,
-    sectionBudgets,
-    sectionUsage,
-    selected,
-    ...trackExclusions ? { excludedItems } : {}
-  };
+    const estimatedTokens = sectionUsage.invariants +
+        sectionUsage.activeBeliefs +
+        sectionUsage.openQuestions +
+        sectionUsage.recentEvidence +
+        sectionUsage.contradictions;
+    return {
+        tokenBudget,
+        estimatedTokens,
+        sectionBudgets,
+        sectionUsage,
+        selected,
+        ...(trackExclusions ? { excludedItems } : {}),
+    };
 }
-function rankEntities(candidates, queryTokens, limit) {
-  if (candidates.length === 0) {
-    return [];
-  }
-  const effectiveLimit = Math.max(
-    1,
-    Math.min(limit ?? DEFAULT_ENTITY_LIMIT, MAX_ENTITY_LIMIT)
-  );
-  const maxConnections = Math.max(
-    1,
-    ...candidates.map(
-      (candidate) => candidate.connectedBeliefCount + candidate.connectedEvidenceCount
-    )
-  );
-  const scored = candidates.map((candidate) => {
-    const searchText = `${candidate.title} ${candidate.entityType} ${candidate.canonicalText}`;
-    const queryScore = queryTokens.length === 0 ? 0.4 : clamp01(tokenHits(searchText, queryTokens) / queryTokens.length);
-    const totalConnections = candidate.connectedBeliefCount + candidate.connectedEvidenceCount;
-    const connectivityScore = clamp01(totalConnections / maxConnections);
-    const score = queryScore * ENTITY_RANKING_WEIGHTS.query + connectivityScore * ENTITY_RANKING_WEIGHTS.connectivity;
-    return { ...candidate, score };
-  });
-  scored.sort((left, right) => {
-    if (right.score !== left.score) {
-      return right.score - left.score;
+export function rankEntities(candidates, queryTokens, limit) {
+    if (candidates.length === 0) {
+        return [];
     }
-    const rightConn = right.connectedBeliefCount + right.connectedEvidenceCount;
-    const leftConn = left.connectedBeliefCount + left.connectedEvidenceCount;
-    return rightConn - leftConn;
-  });
-  return scored.slice(0, effectiveLimit);
+    const effectiveLimit = Math.max(1, Math.min(limit ?? DEFAULT_ENTITY_LIMIT, MAX_ENTITY_LIMIT));
+    const maxConnections = Math.max(1, ...candidates.map((candidate) => candidate.connectedBeliefCount + candidate.connectedEvidenceCount));
+    const scored = candidates.map((candidate) => {
+        const searchText = `${candidate.title} ${candidate.entityType} ${candidate.canonicalText}`;
+        const queryScore = queryTokens.length === 0
+            ? 0.4
+            : clamp01(tokenHits(searchText, queryTokens) / queryTokens.length);
+        const totalConnections = candidate.connectedBeliefCount + candidate.connectedEvidenceCount;
+        const connectivityScore = clamp01(totalConnections / maxConnections);
+        const score = queryScore * ENTITY_RANKING_WEIGHTS.query +
+            connectivityScore * ENTITY_RANKING_WEIGHTS.connectivity;
+        return { ...candidate, score };
+    });
+    scored.sort((left, right) => {
+        if (right.score !== left.score) {
+            return right.score - left.score;
+        }
+        const rightConn = right.connectedBeliefCount + right.connectedEvidenceCount;
+        const leftConn = left.connectedBeliefCount + left.connectedEvidenceCount;
+        return rightConn - leftConn;
+    });
+    return scored.slice(0, effectiveLimit);
 }
-
-export { buildInjectionPlan, parseTokenBudget, rankContextSection, rankEntities, resolveEffectiveWeights };
-//# sourceMappingURL=contextPackPolicy.js.map
 //# sourceMappingURL=contextPackPolicy.js.map

package/dist/contextPackSchema.d.ts

@@ -2,6 +2,6 @@ type ValidationResult = {
     valid: boolean;
     errors: string[];
 };
-declare function validateContextPackSchema(payload: unknown): ValidationResult;
-
-export { validateContextPackSchema };
+export declare function validateContextPackSchema(payload: unknown): ValidationResult;
+export {};
+//# sourceMappingURL=contextPackSchema.d.ts.map