@lucern/sdk 0.2.0-alpha.13 → 0.2.0-alpha.2

package/dist/contextPackPolicy.js

@@ -1,347 +0,0 @@
-// 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
-function nowMs() {
-  return Date.now();
-}
-function normalizeText(text) {
-  return text.trim().toLowerCase();
-}
-function tokenHits(text, tokens) {
-  if (tokens.length === 0) {
-    return 1;
-  }
-  const haystack = normalizeText(text);
-  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));
-}
-function recencyScore(updatedAt, referenceTimeMs = nowMs()) {
-  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);
-}
-function confidenceScore(confidence) {
-  if (typeof confidence !== "number" || !Number.isFinite(confidence)) {
-    return 0.5;
-  }
-  return clamp01(confidence);
-}
-function priorityScore(priority) {
-  const value = normalizeText(priority || "");
-  return PRIORITY_SCORES[value] ?? DEFAULT_PRIORITY_SCORE;
-}
-function severityScore(severity) {
-  const value = normalizeText(severity || "");
-  return SEVERITY_SCORES[value] ?? DEFAULT_SEVERITY_SCORE;
-}
-function beliefTypeBonus(beliefType) {
-  const value = normalizeText(beliefType || "");
-  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 };
-    }
-  }
-  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, nowMs() - 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)`);
-    }
-  }
-  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(", ");
-}
-function computeBaselineScore(candidate, queryTokens) {
-  const hits = tokenHits(candidate.text, queryTokens);
-  return queryTokens.length === 0 ? 1 : hits;
-}
-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
-    ) : computeBaselineScore(row, 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);
-}
-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));
-}
-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);
-  }
-  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;
-    }
-    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/contextPackPolicy.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/contracts/context-pack.contract.ts","../src/contextPackPolicy.ts"],"names":[],"mappings":"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","file":"contextPackPolicy.js","sourcesContent":["/**\n * Context-Pack Contract v1\n *\n * Canonical TypeScript types and constants for the context-pack output schema.\n * This is the external contract consumed by:\n *   - MCP tool `compile_context` (canonical compiler read)\n *   - SDK/HTTP consumers that read compiled context packs programmatically\n *   - Benchmark harnesses (context-pack-ab)\n *\n * BREAKING CHANGE RULES:\n *   - Adding optional fields to ContextPackV1 is NON-breaking\n *   - Removing fields or changing types is BREAKING (bump CONTEXT_PACK_SCHEMA_VERSION)\n *   - Changing section budget ratios or ranking weights is NON-breaking (tuning)\n *   - Changing the version string is BREAKING (consumers check it)\n */\n\n// =============================================================================\n// SCHEMA VERSION\n// =============================================================================\n\n/** Canonical version string. Consumers MUST check this field for compatibility. */\nexport const CONTEXT_PACK_SCHEMA_VERSION = \"1.0.0\" as const;\n\n// =============================================================================\n// RANKING PROFILES\n// =============================================================================\n\n/**\n * Available ranking profiles for context-pack assembly.\n *\n * - `baseline_v1`: Simple token-hit counting. Items with zero query hits are excluded.\n * - `weighted_v1`: Multi-signal scoring combining query relevance, recency, confidence,\n *    belief type, priority, and severity with section-specific weight vectors.\n */\nexport type ContextRankingProfile = \"baseline_v1\" | \"weighted_v1\";\n\nexport const CONTEXT_RANKING_PROFILES: readonly ContextRankingProfile[] = [\n  \"baseline_v1\",\n  \"weighted_v1\",\n] as const;\n\nexport const DEFAULT_RANKING_PROFILE: ContextRankingProfile = \"weighted_v1\";\n\n// =============================================================================\n// COMPILATION MODE (RS-2)\n// =============================================================================\n\n/**\n * Context compilation mode.\n *\n * - `standard`: Default — ranked beliefs, questions, evidence, contradictions.\n * - `delta`: Diff-aware — adds failure context, verification obligations,\n *    and worktree ledger analysis to the standard context pack.\n */\nexport type ContextCompilationMode = \"standard\" | \"delta\";\n\nexport const DEFAULT_COMPILATION_MODE: ContextCompilationMode = \"standard\";\n\n// =============================================================================\n// SECTION KEYS\n// =============================================================================\n\n/**\n * The five canonical sections of a context pack.\n * Order matters: invariants are injected first, contradictions last.\n */\nexport type ContextPackSectionKey =\n  | \"invariants\"\n  | \"activeBeliefs\"\n  | \"openQuestions\"\n  | \"recentEvidence\"\n  | \"contradictions\";\n\nexport const CONTEXT_PACK_SECTION_KEYS: readonly ContextPackSectionKey[] = [\n  \"invariants\",\n  \"activeBeliefs\",\n  \"openQuestions\",\n  \"recentEvidence\",\n  \"contradictions\",\n] as const;\n\n// =============================================================================\n// SECTION BUDGET RATIOS\n// =============================================================================\n\n/**\n * Token budget allocation ratios per section.\n * These sum to 1.0 and determine how the total tokenBudget is divided.\n *\n * Rationale:\n * - invariants (0.28): Highest-priority constraints, injected first\n * - activeBeliefs (0.30): Largest section, carries domain knowledge\n * - openQuestions (0.17): Unresolved work items guide agent behavior\n * - recentEvidence (0.17): Implementation context for grounding\n * - contradictions (0.08): Tension signals, smallest section\n */\nexport const SECTION_BUDGET_RATIOS: Readonly<\n  Record<ContextPackSectionKey, number>\n> = {\n  invariants: 0.28,\n  activeBeliefs: 0.3,\n  openQuestions: 0.17,\n  recentEvidence: 0.17,\n  contradictions: 0.08,\n} as const;\n\n// =============================================================================\n// TOKEN BUDGET CONSTRAINTS\n// =============================================================================\n\n/** Minimum allowed token budget. Below this, context packs lose utility. */\nexport const MIN_TOKEN_BUDGET = 400;\n\n/** Maximum allowed token budget. Above this, context packs bloat prompts. */\nexport const MAX_TOKEN_BUDGET = 8000;\n\n/** Default token budget when caller does not specify. */\nexport const DEFAULT_TOKEN_BUDGET = 1800;\n\n/** Default max items per section. */\nexport const DEFAULT_SECTION_LIMIT = 8;\n\n/** Hard ceiling on items per section. */\nexport const MAX_SECTION_LIMIT = 25;\n\n/** Minimum contradiction section budget floor (tokens). */\nexport const MIN_CONTRADICTION_BUDGET = 40;\n\n// =============================================================================\n// RANKING WEIGHT VECTORS\n// =============================================================================\n\n/**\n * Weight vectors for the weighted_v1 ranking profile.\n * Each section has a different signal mix:\n *\n * - query: How many query tokens appear in the candidate text\n * - recency: Exponential decay from updatedAt (half-life = 30 days)\n * - confidence: Belief confidence score [0,1]\n * - beliefType: Bonus for invariant > tenet > principle > other\n * - priority: Question priority (critical > high > medium > low)\n * - severity: Contradiction severity (critical > high > medium > low)\n */\nexport type RankingWeightVector = {\n  query: number;\n  recency: number;\n  confidence?: number;\n  beliefType?: number;\n  priority?: number;\n  severity?: number;\n};\n\nexport const RANKING_WEIGHTS: Readonly<\n  Record<ContextPackSectionKey, RankingWeightVector>\n> = {\n  invariants: {\n    query: 0.35,\n    recency: 0.1,\n    confidence: 0.4,\n    beliefType: 0.15,\n  },\n  activeBeliefs: {\n    query: 0.5,\n    recency: 0.2,\n    confidence: 0.2,\n    beliefType: 0.1,\n  },\n  openQuestions: {\n    query: 0.55,\n    recency: 0.2,\n    priority: 0.25,\n  },\n  recentEvidence: {\n    query: 0.6,\n    recency: 0.4,\n  },\n  contradictions: {\n    query: 0.4,\n    recency: 0.2,\n    severity: 0.4,\n  },\n} as const;\n\n/** Recency decay half-life in days. After 30 days, recency score = 0.5. */\nexport const RECENCY_HALF_LIFE_DAYS = 30;\n\n/**\n * Ranking weight vector for the relatedEntities section.\n * Entities are ranked by query relevance and connectivity (bridge edge count).\n * Separate from RANKING_WEIGHTS because entities are not part of the\n * token-budgeted injection plan.\n */\nexport const ENTITY_RANKING_WEIGHTS = {\n  query: 0.4,\n  connectivity: 0.6,\n} as const;\n\n/** Default max entities to include in the context pack. */\nexport const DEFAULT_ENTITY_LIMIT = 10;\n\n/** Hard ceiling on entities per context pack. */\nexport const MAX_ENTITY_LIMIT = 50;\n\n// =============================================================================\n// BELIEF TYPE BONUS MAP\n// =============================================================================\n\n/**\n * Bonus multiplier for belief types in ranking.\n * Invariants get 1.0, unknown types get 0.4.\n */\nexport const BELIEF_TYPE_BONUS: Readonly<Record<string, number>> = {\n  invariant: 1.0,\n  tenet: 0.8,\n  principle: 0.6,\n} as const;\n\nexport const DEFAULT_BELIEF_TYPE_BONUS = 0.4;\n\n// =============================================================================\n// PRIORITY / SEVERITY SCORE MAPS\n// =============================================================================\n\nexport const PRIORITY_SCORES: Readonly<Record<string, number>> = {\n  critical: 1.0,\n  high: 0.85,\n  medium: 0.55,\n  low: 0.35,\n} as const;\n\nexport const DEFAULT_PRIORITY_SCORE = 0.5;\n\nexport const SEVERITY_SCORES: Readonly<Record<string, number>> = {\n  critical: 1.0,\n  high: 0.85,\n  medium: 0.6,\n  low: 0.35,\n} as const;\n\nexport const DEFAULT_SEVERITY_SCORE = 0.5;\n\n// =============================================================================\n// SECTION ITEM TYPES\n// =============================================================================\n\n/** A ranked belief in the invariants or activeBeliefs section. */\nexport type ContextPackBelief = {\n  nodeId: string;\n  canonicalText: string;\n  confidence: number | null;\n  beliefType: string | null;\n  score: number;\n  /** Present in activeBeliefs, absent in invariants */\n  status?: string;\n  updatedAt?: number | null;\n  /** Human-readable explanation of why this item was ranked here (RS-2). */\n  justification?: string;\n};\n\n/** A ranked question in the openQuestions section. */\nexport type ContextPackQuestion = {\n  questionId: string;\n  text: string;\n  status: string;\n  priority: string;\n  updatedAt?: number | null;\n  score: number;\n  /** Human-readable explanation of why this item was ranked here (RS-2). */\n  justification?: string;\n};\n\n/** A ranked evidence item in the recentEvidence section. */\nexport type ContextPackEvidence = {\n  nodeId: string;\n  canonicalText: string;\n  sourceUrl: string | null;\n  kind: string;\n  createdAt: number | null;\n  score: number;\n  /** Human-readable explanation of why this item was ranked here (RS-2). */\n  justification?: string;\n};\n\n/** A ranked contradiction in the contradictions section. */\nexport type ContextPackContradiction = {\n  contradictionId: string;\n  severity: string;\n  status: string;\n  description: string;\n  score: number;\n  /** Human-readable explanation of why this item was ranked here (RS-2). */\n  justification?: string;\n};\n\n/**\n * An entity from the ontological layer surfaced in the context pack.\n * Entities are domain objects (companies, people, functions, etc.) connected\n * to beliefs via bridge edges. They provide the \"reality anchor\" that makes\n * the reasoning graph domain-aware.\n */\nexport type ContextPackEntity = {\n  /** Convex document ID of the entity node. */\n  nodeId: string;\n  /** Entity type (e.g., \"company\", \"person\", \"function\"). */\n  entityType: string;\n  /** Human-readable title/name of the entity. */\n  title: string;\n  /** Number of beliefs connected to this entity via bridge edges. */\n  connectedBeliefCount: number;\n  /** Number of evidence items referencing this entity. */\n  connectedEvidenceCount: number;\n  /** Relevance score from ranking algorithm. */\n  score: number;\n  /** Entity metadata (structured per ontology schema). */\n  metadata?: Record<string, unknown>;\n};\n\n/**\n * A lattice seed entry representing a belief that was auto-generated\n * to cover an ontology entity type within a topic scope.\n */\nexport type BeliefLatticeSeed = {\n  /** The belief node ID that was created or already existed. */\n  beliefNodeId: string;\n  /** The entity type this seed belief covers. */\n  entityType: string;\n  /** Whether this seed was newly created or already existed. */\n  created: boolean;\n  /** The canonical text of the seed belief. */\n  canonicalText: string;\n};\n\n// =============================================================================\n// SUMMARY\n// =============================================================================\n\n/** Counts and scoped health signals for the context pack. */\nexport type ContextPackSummary = {\n  totalBeliefs: number;\n  invariants: number;\n  openQuestions: number;\n  evidenceItems: number;\n  contradictions: number;\n  /** Number of ontological entities in scope (optional, present when entity graph is active). */\n  relatedEntities?: number;\n  scopedTopics: number;\n  descendantDepth: number;\n  query: string | null;\n};\n\n// =============================================================================\n// FAILURE CONTEXT (RS-2)\n// =============================================================================\n\n/** A failed approach surfaced from the failure log for anti-repetition. */\nexport type ContextPackFailure = {\n  /** Lucern attempt/evidence node ID. */\n  attemptId: string;\n  /** What was tried. */\n  approach: string;\n  /** Why it failed. */\n  outcome: string;\n  /** When the attempt was recorded (ms since epoch). */\n  recordedAt: number;\n  /** Relevance score from ranking algorithm. */\n  score: number;\n};\n\n/** Failure context section appended to context packs in delta mode. */\nexport type ContextPackFailureContext = {\n  /** Ranked failed approaches relevant to the current query. */\n  failures: ContextPackFailure[];\n  /** IDs of items suppressed from other sections due to anti-repetition. */\n  suppressedIds: string[];\n};\n\n// =============================================================================\n// DELTA REPORT (RS-2)\n// =============================================================================\n\n/** A verification obligation surfaced by delta compilation. */\nexport type VerificationObligation = {\n  /** What must be verified. */\n  description: string;\n  /** Source of the obligation (e.g., \"belief:xyz confidence drop\"). */\n  source: string;\n  /** Severity: how important it is to verify. */\n  severity: \"critical\" | \"high\" | \"medium\" | \"low\";\n};\n\n/** Delta report appended to context packs when mode = \"delta\". */\nexport type ContextPackDeltaReport = {\n  /** Items that changed since the reference point (new, updated, removed). */\n  changedItems: Array<{\n    id: string;\n    section: ContextPackSectionKey;\n    changeType: \"added\" | \"updated\" | \"removed\" | \"confidence_changed\";\n    summary: string;\n  }>;\n  /** Obligations the consuming session must verify. */\n  verificationObligations: VerificationObligation[];\n  /** Reference point for the delta (worktree ID, timestamp, or commit SHA). */\n  referencePoint: string;\n};\n\n// =============================================================================\n// PACK WEIGHT OVERRIDES (RS-2)\n// =============================================================================\n\n/**\n * Per-section weight overrides that domain packs can apply.\n * Overrides merge with RANKING_WEIGHTS — only specified fields replace defaults.\n */\nexport type PackWeightOverride = {\n  /** Which section to override weights for. */\n  section: ContextPackSectionKey;\n  /** Partial weight vector — only specified fields replace defaults. */\n  weights: Partial<RankingWeightVector>;\n};\n\n// =============================================================================\n// INJECTION POLICY\n// =============================================================================\n\n/** Token-budgeted section selections for prompt injection. */\nexport type ContextPackInjectionPolicy = {\n  /** Total token budget for the entire context pack. */\n  tokenBudget: number;\n  /** Estimated tokens consumed across all sections. */\n  estimatedTokens: number;\n  /** Per-section token budgets derived from SECTION_BUDGET_RATIOS. */\n  sectionBudgets: Record<ContextPackSectionKey, number>;\n  /** Actual token usage per section after greedy fill. */\n  sectionUsage: Record<ContextPackSectionKey, number>;\n  /** Node/question IDs selected for injection, per section. */\n  selected: Record<ContextPackSectionKey, string[]>;\n  /** Items that were scored but excluded from injection, with reason (RS-2). */\n  excludedItems?: Array<{\n    id: string;\n    section: ContextPackSectionKey;\n    reason: \"budget_exceeded\" | \"anti_repetition\" | \"below_threshold\";\n    score: number;\n  }>;\n};\n\n// =============================================================================\n// DIAGNOSTICS\n// =============================================================================\n\n/** Telemetry for context pack assembly. */\nexport type ContextPackDiagnostics = {\n  /** Total candidates scored across all sections. */\n  itemsScored: number;\n  /** Ratio of estimatedTokens / tokenBudget. Range [0, 1+]. */\n  tokenBudgetUtilization: number;\n};\n\n// =============================================================================\n// PUBLIC COMPILED CONTEXT TYPES\n// =============================================================================\n\n/**\n * Public context surface returned by the SDK-facing context client.\n *\n * This preserves the existing external shape while the canonical compiler\n * contract evolves in parallel as ContextPackV1.\n */\nexport type PublicContextBelief = {\n  beliefId: string;\n  text: string;\n  confidence: number | null;\n  beliefType?: string | null;\n  status?: string;\n  updatedAt?: number | null;\n  score: number;\n  justification?: string;\n};\n\nexport type PublicContextQuestion = {\n  questionId: string;\n  text: string;\n  status: string;\n  priority: string;\n  updatedAt?: number | null;\n  score: number;\n  justification?: string;\n};\n\nexport type PublicContextEvidence = {\n  evidenceId: string;\n  text: string;\n  sourceUrl?: string | null;\n  kind: string;\n  createdAt?: number | null;\n  score: number;\n  justification?: string;\n};\n\nexport type PublicContextContradiction = {\n  contradictionId: string;\n  severity: string;\n  status: string;\n  description: string;\n  score: number;\n  justification?: string;\n};\n\nexport type PublicContextEntity = {\n  entityId: string;\n  entityType: string;\n  title: string;\n  text?: string;\n  connectedBeliefCount: number;\n  connectedEvidenceCount: number;\n  score: number;\n  metadata?: Record<string, unknown>;\n};\n\nexport type PublicContextInjectionPolicy = {\n  tokenBudget: number;\n  estimatedTokens: number;\n  sectionBudgets: Record<string, number>;\n  sectionUsage: Record<string, number>;\n  selected: Record<string, string[]>;\n  excludedItems?: Array<{\n    id: string;\n    section: string;\n    reason: \"budget_exceeded\" | \"anti_repetition\" | \"below_threshold\";\n    score: number;\n  }>;\n};\n\nexport type PublicCompiledContext = {\n  schemaVersion: string;\n  topicId: string;\n  topicName: string;\n  scopedTopicIds: string[];\n  generatedAt: number;\n  ranking: ContextRankingProfile;\n  summary: Record<string, unknown>;\n  invariants: PublicContextBelief[];\n  activeBeliefs: PublicContextBelief[];\n  openQuestions: PublicContextQuestion[];\n  recentEvidence: PublicContextEvidence[];\n  contradictions: PublicContextContradiction[];\n  relatedEntities?: PublicContextEntity[];\n  contextNarrative: string[];\n  injectionPolicy: PublicContextInjectionPolicy;\n  diagnostics: Record<string, unknown>;\n  compilationMode?: string;\n  failureContext?: {\n    failures: Array<{\n      attemptId: string;\n      approach: string;\n      outcome: string;\n      recordedAt: number;\n      score: number;\n    }>;\n    suppressedIds: string[];\n  };\n  deltaReport?: {\n    changedItems: Array<{\n      id: string;\n      section: string;\n      changeType: string;\n      summary: string;\n    }>;\n    verificationObligations: Array<{\n      description: string;\n      source: string;\n      severity: \"critical\" | \"high\" | \"medium\" | \"low\";\n    }>;\n    referencePoint: string;\n  };\n  appliedWeightOverrides?: unknown[];\n};\n\n// =============================================================================\n// CONTEXT PACK V1 (TOP-LEVEL OUTPUT)\n// =============================================================================\n\n/**\n * The canonical output schema for context compilation responses.\n *\n * This is the contract that consumers depend on. All fields are required\n * in the output. Adding optional fields is non-breaking; removing or\n * changing types is breaking (requires version bump).\n */\nexport type ContextPackV1 = {\n  /** Schema version for compatibility checking. */\n  schemaVersion: typeof CONTEXT_PACK_SCHEMA_VERSION;\n  /** Resolved topic ID after scope resolution. */\n  topicId: string;\n  /** Human-readable topic name. */\n  topicName: string;\n  /** All topic IDs included in the neighborhood expansion. */\n  scopedTopicIds: string[];\n  /** Deterministic freshness watermark for this pack (ms since epoch). */\n  generatedAt: number;\n  /** Which ranking profile was used. */\n  rankingProfile: ContextRankingProfile;\n  /** Aggregate counts and health signals. */\n  summary: ContextPackSummary;\n  /** High-confidence invariant beliefs (beliefType = \"invariant\"). */\n  invariants: ContextPackBelief[];\n  /** Active beliefs ranked by query relevance. */\n  activeBeliefs: ContextPackBelief[];\n  /** Open questions ranked by relevance and priority. */\n  openQuestions: ContextPackQuestion[];\n  /** Recent evidence ranked by relevance and recency. */\n  recentEvidence: ContextPackEvidence[];\n  /** Active contradictions ranked by severity. */\n  contradictions: ContextPackContradiction[];\n  /**\n   * Ontological entities connected to beliefs in scope, ranked by connectivity.\n   * Optional — present when entity graph substrate is active for this topic.\n   * NON-BREAKING addition per contract rules.\n   */\n  relatedEntities?: ContextPackEntity[];\n  /** Concise instructions for agent context injection. */\n  contextNarrative: string[];\n  /** Token-budgeted injection selections. */\n  injectionPolicy: ContextPackInjectionPolicy;\n  /** Assembly telemetry. */\n  diagnostics: ContextPackDiagnostics;\n  /** Compilation mode used to generate this pack (RS-2). Default: \"standard\". */\n  compilationMode?: ContextCompilationMode;\n  /** Failure context for anti-repetition (RS-2). Present when failures are relevant. */\n  failureContext?: ContextPackFailureContext;\n  /** Delta report (RS-2). Present only when compilationMode = \"delta\". */\n  deltaReport?: ContextPackDeltaReport;\n  /** Pack weight overrides applied during ranking (RS-2). */\n  appliedWeightOverrides?: PackWeightOverride[];\n};\n\n// =============================================================================\n// CONTEXT PACK REQUEST V1 (INPUT)\n// =============================================================================\n\n/**\n * The canonical input schema for `compile_context`.\n * `topicId` is the only scope identifier.\n */\nexport type ContextPackRequestV1 = {\n  /** Topic scope ID (required). */\n  topicId: string;\n  /** Focus query for relevance ranking. */\n  query?: string;\n  /** Max items per section. Default: DEFAULT_SECTION_LIMIT. */\n  limit?: number;\n  /** Ranking profile. Default: DEFAULT_RANKING_PROFILE. */\n  rankingProfile?: ContextRankingProfile;\n  /** Total token budget. Default: DEFAULT_TOKEN_BUDGET. */\n  tokenBudget?: number;\n  /** Descendant topic depth for neighborhood expansion. */\n  maxDepth?: number;\n  /** Include ontological entities connected to beliefs in scope. Default: true. */\n  includeEntities?: boolean;\n  /** Compilation mode (RS-2). Default: \"standard\". */\n  mode?: ContextCompilationMode;\n  /** Include failure log context for anti-repetition (RS-2). Default: false. */\n  includeFailures?: boolean;\n  /** Active worktree ID for delta mode reference point (RS-2). */\n  worktreeId?: string;\n  /** Session ID for anti-repetition dedup (RS-2). */\n  sessionId?: string;\n  /** Pack weight overrides from domain pack binding (RS-2). */\n  packWeightOverrides?: PackWeightOverride[];\n};\n\n// =============================================================================\n// RESOLVED QUESTION STATUSES\n// =============================================================================\n\n/**\n * Question statuses that are considered \"resolved\" (not open).\n * Used to filter which questions appear in the openQuestions section.\n */\nexport const RESOLVED_QUESTION_STATUSES: readonly string[] = [\n  \"answered\",\n  \"archived\",\n  \"closed\",\n  \"resolved\",\n  \"resolved_support\",\n  \"resolved_contra\",\n  \"belief_forked\",\n] as const;\n\n// =============================================================================\n// TOKEN ESTIMATION\n// =============================================================================\n\n/**\n * Tokens-per-word multiplier for rough token estimation.\n * Conservative estimate: ~1.35 tokens per whitespace-delimited word.\n */\nexport const TOKENS_PER_WORD = 1.35;\n\n/** Minimum token estimate for any non-empty string. */\nexport const MIN_TOKEN_ESTIMATE = 8;\n","import {\n  BELIEF_TYPE_BONUS,\n  DEFAULT_ENTITY_LIMIT,\n  DEFAULT_BELIEF_TYPE_BONUS,\n  DEFAULT_PRIORITY_SCORE,\n  DEFAULT_SEVERITY_SCORE,\n  DEFAULT_TOKEN_BUDGET,\n  ENTITY_RANKING_WEIGHTS,\n  MAX_TOKEN_BUDGET,\n  MAX_ENTITY_LIMIT,\n  MIN_CONTRADICTION_BUDGET,\n  MIN_TOKEN_BUDGET,\n  MIN_TOKEN_ESTIMATE,\n  type PackWeightOverride,\n  PRIORITY_SCORES,\n  type RankingWeightVector,\n  RANKING_WEIGHTS,\n  RECENCY_HALF_LIFE_DAYS,\n  SECTION_BUDGET_RATIOS,\n  SEVERITY_SCORES,\n  TOKENS_PER_WORD,\n  type ContextPackSectionKey,\n  type ContextRankingProfile,\n} from \"./contracts/context-pack.contract\";\n\nexport type SectionKey = ContextPackSectionKey;\n\nexport type RankCandidate = {\n  id: string;\n  text: string;\n  updatedAt?: number | null;\n  createdAt?: number | null;\n  confidence?: number | null;\n  beliefType?: string | null;\n  priority?: string | null;\n  severity?: string | null;\n};\n\nexport type RankedCandidate<T extends RankCandidate> = T & {\n  score: number;\n  justification?: string;\n};\n\ntype LexicalExclusion = {\n  id: string;\n  section: SectionKey;\n  reason: \"budget_exceeded\" | \"anti_repetition\" | \"below_threshold\";\n  score: number;\n};\n\nexport type InjectionPlan = {\n  tokenBudget: number;\n  estimatedTokens: number;\n  sectionBudgets: Record<SectionKey, number>;\n  sectionUsage: Record<SectionKey, number>;\n  selected: Record<SectionKey, string[]>;\n  excludedItems?: LexicalExclusion[];\n};\n\ntype RankContextOptions = {\n  effectiveWeights?: Readonly<Record<ContextPackSectionKey, RankingWeightVector>>;\n  includeJustifications?: boolean;\n  referenceTimeMs?: number;\n};\n\nfunction nowMs(): number {\n  return Date.now();\n}\n\nfunction normalizeText(text: string): string {\n  return text.trim().toLowerCase();\n}\n\nfunction tokenHits(text: string, tokens: string[]): number {\n  if (tokens.length === 0) {\n    return 1;\n  }\n  const haystack = normalizeText(text);\n  let hits = 0;\n  for (const token of tokens) {\n    if (haystack.includes(token)) {\n      hits += 1;\n    }\n  }\n  return hits;\n}\n\nfunction clamp01(value: number): number {\n  if (!Number.isFinite(value)) {\n    return 0;\n  }\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction recencyScore(\n  updatedAt: number | null | undefined,\n  referenceTimeMs = nowMs()\n): number {\n  if (!updatedAt || !Number.isFinite(updatedAt)) {\n    return 0.25;\n  }\n  const ageMs = Math.max(0, referenceTimeMs - updatedAt);\n  const ageDays = ageMs / (1000 * 60 * 60 * 24);\n  const decay = 0.5 ** (ageDays / RECENCY_HALF_LIFE_DAYS);\n  return clamp01(decay);\n}\n\nfunction confidenceScore(confidence: number | null | undefined): number {\n  if (typeof confidence !== \"number\" || !Number.isFinite(confidence)) {\n    return 0.5;\n  }\n  return clamp01(confidence);\n}\n\nfunction priorityScore(priority: string | null | undefined): number {\n  const value = normalizeText(priority || \"\");\n  return PRIORITY_SCORES[value] ?? DEFAULT_PRIORITY_SCORE;\n}\n\nfunction severityScore(severity: string | null | undefined): number {\n  const value = normalizeText(severity || \"\");\n  return SEVERITY_SCORES[value] ?? DEFAULT_SEVERITY_SCORE;\n}\n\nfunction beliefTypeBonus(beliefType: string | null | undefined): number {\n  const value = normalizeText(beliefType || \"\");\n  return BELIEF_TYPE_BONUS[value] ?? DEFAULT_BELIEF_TYPE_BONUS;\n}\n\nexport function resolveEffectiveWeights(\n  overrides?: PackWeightOverride[]\n): Readonly<Record<ContextPackSectionKey, RankingWeightVector>> {\n  if (!overrides || overrides.length === 0) {\n    return RANKING_WEIGHTS;\n  }\n  const result = { ...RANKING_WEIGHTS } as Record<\n    ContextPackSectionKey,\n    RankingWeightVector\n  >;\n  for (const override of overrides) {\n    const base = RANKING_WEIGHTS[override.section];\n    if (base) {\n      result[override.section] = { ...base, ...override.weights };\n    }\n  }\n  return result;\n}\n\nfunction generateJustification(\n  _section: SectionKey,\n  candidate: RankCandidate,\n  queryTokens: string[],\n  weights: RankingWeightVector\n): string {\n  const parts: string[] = [];\n\n  const hits = tokenHits(candidate.text, queryTokens);\n  if (queryTokens.length > 0 && hits > 0) {\n    parts.push(`${hits}/${queryTokens.length} query terms matched`);\n  } else if (queryTokens.length === 0) {\n    parts.push(\"no query filter\");\n  }\n\n  const ts = candidate.updatedAt || candidate.createdAt || null;\n  if (ts && Number.isFinite(ts)) {\n    const ageDays = Math.max(0, nowMs() - ts) / (1000 * 60 * 60 * 24);\n    if (ageDays < 1) {\n      parts.push(\"updated today\");\n    } else if (ageDays < 7) {\n      parts.push(`updated ${Math.floor(ageDays)}d ago`);\n    } else if (ageDays < 30) {\n      parts.push(`updated ${Math.floor(ageDays / 7)}w ago`);\n    } else {\n      parts.push(`updated ${Math.floor(ageDays)}d ago (decayed)`);\n    }\n  }\n\n  if (\n    weights.confidence !== undefined &&\n    candidate.confidence !== null &&\n    candidate.confidence !== undefined\n  ) {\n    parts.push(`confidence=${candidate.confidence.toFixed(2)}`);\n  }\n  if (weights.beliefType !== undefined && candidate.beliefType) {\n    parts.push(`type=${candidate.beliefType}`);\n  }\n  if (weights.priority !== undefined && candidate.priority) {\n    parts.push(`priority=${candidate.priority}`);\n  }\n  if (weights.severity !== undefined && candidate.severity) {\n    parts.push(`severity=${candidate.severity}`);\n  }\n\n  return parts.join(\", \");\n}\n\nfunction computeBaselineScore(\n  candidate: RankCandidate,\n  queryTokens: string[]\n): number {\n  const hits = tokenHits(candidate.text, queryTokens);\n  return queryTokens.length === 0 ? 1 : hits;\n}\n\nfunction computeWeightedScore(\n  section: SectionKey,\n  candidate: RankCandidate,\n  queryTokens: string[],\n  effectiveWeights?: Readonly<Record<ContextPackSectionKey, RankingWeightVector>>,\n  referenceTimeMs?: number\n): number {\n  const weights = (effectiveWeights ?? RANKING_WEIGHTS)[section];\n  const queryComponent =\n    queryTokens.length === 0\n      ? 0.4\n      : clamp01(tokenHits(candidate.text, queryTokens) / queryTokens.length);\n  const recencyComponent = recencyScore(\n    candidate.updatedAt || candidate.createdAt || null,\n    referenceTimeMs\n  );\n\n  let score =\n    queryComponent * weights.query + recencyComponent * weights.recency;\n\n  if (weights.confidence !== undefined) {\n    score += confidenceScore(candidate.confidence) * weights.confidence;\n  }\n  if (weights.beliefType !== undefined) {\n    score += beliefTypeBonus(candidate.beliefType) * weights.beliefType;\n  }\n  if (weights.priority !== undefined) {\n    score += priorityScore(candidate.priority) * weights.priority;\n  }\n  if (weights.severity !== undefined) {\n    score += severityScore(candidate.severity) * weights.severity;\n  }\n\n  return score;\n}\n\nexport function rankContextSection<T extends RankCandidate>(\n  section: SectionKey,\n  rows: T[],\n  queryTokens: string[],\n  limit: number,\n  profile: ContextRankingProfile,\n  options?: RankContextOptions\n): RankedCandidate<T>[] {\n  const effectiveWeights = options?.effectiveWeights;\n  const includeJustifications = options?.includeJustifications ?? false;\n  const referenceTimeMs = options?.referenceTimeMs;\n\n  const scored = rows.map((row) => {\n    const score =\n      profile === \"weighted_v1\"\n        ? computeWeightedScore(\n            section,\n            row,\n            queryTokens,\n            effectiveWeights,\n            referenceTimeMs\n          )\n        : computeBaselineScore(row, queryTokens);\n\n    const result: RankedCandidate<T> = { ...row, score };\n\n    if (includeJustifications && profile === \"weighted_v1\") {\n      const weights = (effectiveWeights ?? RANKING_WEIGHTS)[section];\n      result.justification = generateJustification(section, row, queryTokens, weights);\n    }\n\n    return result;\n  });\n\n  const filtered =\n    queryTokens.length === 0 ? scored : scored.filter((row) => row.score > 0);\n\n  filtered.sort((left, right) => {\n    if (right.score !== left.score) {\n      return right.score - left.score;\n    }\n    const rightTs = right.updatedAt || right.createdAt || 0;\n    const leftTs = left.updatedAt || left.createdAt || 0;\n    return rightTs - leftTs;\n  });\n\n  return filtered.slice(0, limit);\n}\n\nexport function parseTokenBudget(\n  value: unknown,\n  fallback = DEFAULT_TOKEN_BUDGET\n): number {\n  const parsed =\n    typeof value === \"number\" && Number.isFinite(value)\n      ? Math.floor(value)\n      : fallback;\n  return Math.max(MIN_TOKEN_BUDGET, Math.min(MAX_TOKEN_BUDGET, parsed));\n}\n\nfunction estimateTokens(text: string): number {\n  const words = text.trim().split(/\\s+/).filter(Boolean).length;\n  return Math.max(MIN_TOKEN_ESTIMATE, Math.ceil(words * TOKENS_PER_WORD));\n}\n\nexport function buildInjectionPlan(args: {\n  tokenBudget: number;\n  invariants: Array<{ nodeId: string; canonicalText: string; score?: number }>;\n  activeBeliefs: Array<{ nodeId: string; canonicalText: string; score?: number }>;\n  openQuestions: Array<{ questionId: string; text: string; score?: number }>;\n  recentEvidence: Array<{ nodeId: string; canonicalText: string; score?: number }>;\n  contradictions: Array<{ contradictionId: string; description: string; score?: number }>;\n  trackExclusions?: boolean;\n}): InjectionPlan {\n  const tokenBudget = parseTokenBudget(args.tokenBudget);\n  const trackExclusions = args.trackExclusions ?? false;\n\n  const sectionBudgets: Record<SectionKey, number> = {\n    invariants: Math.floor(tokenBudget * SECTION_BUDGET_RATIOS.invariants),\n    activeBeliefs: Math.floor(\n      tokenBudget * SECTION_BUDGET_RATIOS.activeBeliefs\n    ),\n    openQuestions: Math.floor(\n      tokenBudget * SECTION_BUDGET_RATIOS.openQuestions\n    ),\n    recentEvidence: Math.floor(\n      tokenBudget * SECTION_BUDGET_RATIOS.recentEvidence\n    ),\n    contradictions: Math.max(\n      MIN_CONTRADICTION_BUDGET,\n      Math.floor(tokenBudget * SECTION_BUDGET_RATIOS.contradictions)\n    ),\n  };\n\n  const selected: Record<SectionKey, string[]> = {\n    invariants: [],\n    activeBeliefs: [],\n    openQuestions: [],\n    recentEvidence: [],\n    contradictions: [],\n  };\n\n  const sectionUsage: Record<SectionKey, number> = {\n    invariants: 0,\n    activeBeliefs: 0,\n    openQuestions: 0,\n    recentEvidence: 0,\n    contradictions: 0,\n  };\n\n  const excludedItems: LexicalExclusion[] = [];\n\n  const pushItem = (section: SectionKey, id: string, text: string, score?: number) => {\n    const itemTokens = estimateTokens(text);\n    const nextUsage = sectionUsage[section] + itemTokens;\n    if (nextUsage > sectionBudgets[section]) {\n      if (trackExclusions) {\n        excludedItems.push({\n          id,\n          section,\n          reason: \"budget_exceeded\",\n          score: score ?? 0,\n        });\n      }\n      return;\n    }\n    selected[section].push(id);\n    sectionUsage[section] = nextUsage;\n  };\n\n  for (const row of args.invariants) {\n    pushItem(\"invariants\", row.nodeId, row.canonicalText, row.score);\n  }\n  for (const row of args.activeBeliefs) {\n    pushItem(\"activeBeliefs\", row.nodeId, row.canonicalText, row.score);\n  }\n  for (const row of args.openQuestions) {\n    pushItem(\"openQuestions\", row.questionId, row.text, row.score);\n  }\n  for (const row of args.recentEvidence) {\n    pushItem(\"recentEvidence\", row.nodeId, row.canonicalText, row.score);\n  }\n  for (const row of args.contradictions) {\n    pushItem(\"contradictions\", row.contradictionId, row.description, row.score);\n  }\n\n  const estimatedTokens =\n    sectionUsage.invariants +\n    sectionUsage.activeBeliefs +\n    sectionUsage.openQuestions +\n    sectionUsage.recentEvidence +\n    sectionUsage.contradictions;\n\n  return {\n    tokenBudget,\n    estimatedTokens,\n    sectionBudgets,\n    sectionUsage,\n    selected,\n    ...(trackExclusions ? { excludedItems } : {}),\n  };\n}\n\nexport type EntityCandidate = {\n  nodeId: string;\n  entityType: string;\n  title: string;\n  canonicalText: string;\n  connectedBeliefCount: number;\n  connectedEvidenceCount: number;\n  metadata: Record<string, unknown>;\n  updatedAt?: number | null;\n};\n\nexport type RankedEntity = EntityCandidate & {\n  score: number;\n};\n\nexport function rankEntities(\n  candidates: EntityCandidate[],\n  queryTokens: string[],\n  limit?: number\n): RankedEntity[] {\n  if (candidates.length === 0) {\n    return [];\n  }\n\n  const effectiveLimit = Math.max(\n    1,\n    Math.min(limit ?? DEFAULT_ENTITY_LIMIT, MAX_ENTITY_LIMIT)\n  );\n\n  const maxConnections = Math.max(\n    1,\n    ...candidates.map(\n      (candidate) =>\n        candidate.connectedBeliefCount + candidate.connectedEvidenceCount\n    )\n  );\n\n  const scored = candidates.map((candidate) => {\n    const searchText = `${candidate.title} ${candidate.entityType} ${candidate.canonicalText}`;\n    const queryScore =\n      queryTokens.length === 0\n        ? 0.4\n        : clamp01(tokenHits(searchText, queryTokens) / queryTokens.length);\n\n    const totalConnections =\n      candidate.connectedBeliefCount + candidate.connectedEvidenceCount;\n    const connectivityScore = clamp01(totalConnections / maxConnections);\n\n    const score =\n      queryScore * ENTITY_RANKING_WEIGHTS.query +\n      connectivityScore * ENTITY_RANKING_WEIGHTS.connectivity;\n\n    return { ...candidate, score };\n  });\n\n  scored.sort((left, right) => {\n    if (right.score !== left.score) {\n      return right.score - left.score;\n    }\n    const rightConn = right.connectedBeliefCount + right.connectedEvidenceCount;\n    const leftConn = left.connectedBeliefCount + left.connectedEvidenceCount;\n    return rightConn - leftConn;\n  });\n\n  return scored.slice(0, effectiveLimit);\n}\n"]}

package/dist/contextPackSchema.d.ts

@@ -1,7 +0,0 @@
-type ValidationResult = {
-    valid: boolean;
-    errors: string[];
-};
-declare function validateContextPackSchema(payload: unknown): ValidationResult;
-
-export { validateContextPackSchema };

package/dist/contextPackSchema.js

@@ -1,203 +0,0 @@
-// src/contextPackSchema.ts
-var CONTEXT_PACK_SCHEMA_VERSION = "1.0.0";
-function isObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function isString(value) {
-  return typeof value === "string";
-}
-function isNumber(value) {
-  return typeof value === "number" && Number.isFinite(value);
-}
-function isNullableNumber(value) {
-  return value === null || isNumber(value);
-}
-function isStringArray(value) {
-  return Array.isArray(value) && value.every((entry) => isString(entry));
-}
-function requireObject(parent, key, errors) {
-  const value = parent[key];
-  if (!isObject(value)) {
-    errors.push(`Expected '${key}' to be an object`);
-    return null;
-  }
-  return value;
-}
-function validateBeliefArray(key, value, errors) {
-  if (!Array.isArray(value)) {
-    errors.push(`Expected '${key}' to be an array`);
-    return;
-  }
-  for (let index = 0; index < value.length; index += 1) {
-    const row = value[index];
-    if (!isObject(row)) {
-      errors.push(`Expected '${key}[${index}]' to be an object`);
-      continue;
-    }
-    if (!isString(row.nodeId)) {
-      errors.push(`Expected '${key}[${index}].nodeId' to be a string`);
-    }
-    if (!isString(row.canonicalText)) {
-      errors.push(`Expected '${key}[${index}].canonicalText' to be a string`);
-    }
-    if (!isNullableNumber(row.confidence)) {
-      errors.push(`Expected '${key}[${index}].confidence' to be number|null`);
-    }
-  }
-}
-function validateQuestionArray(key, value, errors) {
-  if (!Array.isArray(value)) {
-    errors.push(`Expected '${key}' to be an array`);
-    return;
-  }
-  for (let index = 0; index < value.length; index += 1) {
-    const row = value[index];
-    if (!isObject(row)) {
-      errors.push(`Expected '${key}[${index}]' to be an object`);
-      continue;
-    }
-    if (!isString(row.questionId)) {
-      errors.push(`Expected '${key}[${index}].questionId' to be a string`);
-    }
-    if (!isString(row.text)) {
-      errors.push(`Expected '${key}[${index}].text' to be a string`);
-    }
-    if (!isString(row.status)) {
-      errors.push(`Expected '${key}[${index}].status' to be a string`);
-    }
-  }
-}
-function validateEvidenceArray(key, value, errors) {
-  if (!Array.isArray(value)) {
-    errors.push(`Expected '${key}' to be an array`);
-    return;
-  }
-  for (let index = 0; index < value.length; index += 1) {
-    const row = value[index];
-    if (!isObject(row)) {
-      errors.push(`Expected '${key}[${index}]' to be an object`);
-      continue;
-    }
-    if (!isString(row.nodeId)) {
-      errors.push(`Expected '${key}[${index}].nodeId' to be a string`);
-    }
-    if (!isString(row.canonicalText)) {
-      errors.push(`Expected '${key}[${index}].canonicalText' to be a string`);
-    }
-  }
-}
-function validateEntityArray(key, value, errors) {
-  if (!Array.isArray(value)) {
-    errors.push(`Expected '${key}' to be an array`);
-    return;
-  }
-  for (let index = 0; index < value.length; index += 1) {
-    const row = value[index];
-    if (!isObject(row)) {
-      errors.push(`Expected '${key}[${index}]' to be an object`);
-      continue;
-    }
-    if (!isString(row.nodeId)) {
-      errors.push(`Expected '${key}[${index}].nodeId' to be a string`);
-    }
-    if (!isString(row.entityType)) {
-      errors.push(`Expected '${key}[${index}].entityType' to be a string`);
-    }
-    if (!isString(row.title)) {
-      errors.push(`Expected '${key}[${index}].title' to be a string`);
-    }
-    if (!isNumber(row.connectedBeliefCount)) {
-      errors.push(`Expected '${key}[${index}].connectedBeliefCount' to be a number`);
-    }
-    if (!isNumber(row.connectedEvidenceCount)) {
-      errors.push(`Expected '${key}[${index}].connectedEvidenceCount' to be a number`);
-    }
-    if (!isNumber(row.score)) {
-      errors.push(`Expected '${key}[${index}].score' to be a number`);
-    }
-  }
-}
-function validateContradictionArray(key, value, errors) {
-  if (!Array.isArray(value)) {
-    errors.push(`Expected '${key}' to be an array`);
-    return;
-  }
-  for (let index = 0; index < value.length; index += 1) {
-    const row = value[index];
-    if (!isObject(row)) {
-      errors.push(`Expected '${key}[${index}]' to be an object`);
-      continue;
-    }
-    if (!isString(row.contradictionId)) {
-      errors.push(`Expected '${key}[${index}].contradictionId' to be a string`);
-    }
-    if (!isString(row.status)) {
-      errors.push(`Expected '${key}[${index}].status' to be a string`);
-    }
-  }
-}
-function validateContextPackSchema(payload) {
-  const errors = [];
-  if (!isObject(payload)) {
-    return {
-      valid: false,
-      errors: ["Expected context pack payload to be an object"]
-    };
-  }
-  if (payload.schemaVersion !== CONTEXT_PACK_SCHEMA_VERSION) {
-    errors.push(
-      `Expected schemaVersion='${CONTEXT_PACK_SCHEMA_VERSION}', received '${String(
-        payload.schemaVersion
-      )}'`
-    );
-  }
-  if (!isString(payload.topicId)) {
-    errors.push("Expected 'topicId' to be a string");
-  }
-  if (!isString(payload.topicName)) {
-    errors.push("Expected 'topicName' to be a string");
-  }
-  if (!isStringArray(payload.scopedTopicIds)) {
-    errors.push("Expected 'scopedTopicIds' to be string[]");
-  }
-  if (!isNumber(payload.generatedAt)) {
-    errors.push("Expected 'generatedAt' to be a number");
-  }
-  if (!isString(payload.ranking)) {
-    errors.push("Expected 'ranking' to be a string");
-  }
-  validateBeliefArray("invariants", payload.invariants, errors);
-  validateBeliefArray("activeBeliefs", payload.activeBeliefs, errors);
-  validateQuestionArray("openQuestions", payload.openQuestions, errors);
-  validateEvidenceArray("recentEvidence", payload.recentEvidence, errors);
-  validateContradictionArray("contradictions", payload.contradictions, errors);
-  if (payload.relatedEntities !== void 0 && payload.relatedEntities !== null) {
-    validateEntityArray("relatedEntities", payload.relatedEntities, errors);
-  }
-  if (!Array.isArray(payload.contextNarrative)) {
-    errors.push("Expected 'contextNarrative' to be an array");
-  }
-  const injectionPolicy = requireObject(payload, "injectionPolicy", errors);
-  if (injectionPolicy) {
-    if (!isNumber(injectionPolicy.tokenBudget)) {
-      errors.push("Expected 'injectionPolicy.tokenBudget' to be a number");
-    }
-    if (!isNumber(injectionPolicy.estimatedTokens)) {
-      errors.push("Expected 'injectionPolicy.estimatedTokens' to be a number");
-    }
-  }
-  if (!isObject(payload.summary)) {
-    errors.push("Expected 'summary' to be an object");
-  }
-  if (!isObject(payload.diagnostics)) {
-    errors.push("Expected 'diagnostics' to be an object");
-  }
-  return {
-    valid: errors.length === 0,
-    errors
-  };
-}
-
-export { validateContextPackSchema };
-//# sourceMappingURL=contextPackSchema.js.map
-//# sourceMappingURL=contextPackSchema.js.map