@unbrained/pm-cli 2026.7.21 → 2026.7.22

package/dist/sdk/context-relevance.d.ts

@@ -15,6 +15,11 @@ export interface ContextRelevanceCandidate<TItem> {
     /** Value that configures or reports signals for this contract. */
     signals?: ContextRelevanceSignals;
 }
+/** Item candidate whose built-in metadata derivation always supplies signals. */
+export interface ItemContextRelevanceCandidate extends ContextRelevanceCandidate<ItemMetadata> {
+    /** Complete built-in derivation result, with unavailable signals omitted by value. */
+    signals: ContextRelevanceSignals;
+}
 /** Inputs that make item-signal derivation deterministic and host-configurable. */
 export interface BuildItemContextRelevanceCandidatesOptions {
     /** Workspace lifecycle registry, including custom in-progress aliases. */
@@ -27,13 +32,23 @@ export interface BuildItemContextRelevanceCandidatesOptions {
     usageAffinity?: Readonly<Record<string, number>>;
     /** Optional caller-derived semantic similarity by item id. */
     semanticSimilarity?: Readonly<Record<string, number>>;
+    /** Optional index-derived activity density by item id. */
+    activityDensity?: Readonly<Record<string, number>>;
+    /** Optional index-derived graph proximity by item id. */
+    graphProximity?: Readonly<Record<string, number>>;
+    /** Optional host-derived claim or focus affinity by item id. */
+    claimFocus?: Readonly<Record<string, number>>;
+    /** Optional index-derived knowledge density by item id. */
+    knowledgeDensity?: Readonly<Record<string, number>>;
+    /** Optional history-derived author affinity by item id. */
+    authorAffinity?: Readonly<Record<string, number>>;
 }
 /**
  * Derive the canonical metadata signals consumed by `pm context` and `pm next`.
  * Extensions can pair this with {@link scoreContextCandidatesWithActiveExtensions}
  * to reproduce built-in ranking without private imports or subprocesses.
  */
-export declare function buildItemContextRelevanceCandidates(items: readonly ItemMetadata[], options: BuildItemContextRelevanceCandidatesOptions): ContextRelevanceCandidate<ItemMetadata>[];
+export declare function buildItemContextRelevanceCandidates(items: readonly ItemMetadata[], options: BuildItemContextRelevanceCandidatesOptions): ItemContextRelevanceCandidate[];
 /** Per-signal weighted contributions used to explain a ranked result. */
 export type ContextRelevanceContributions = Record<string, number>;
 /** One ranked candidate with deterministic score and explanation metadata. */

package/dist/sdk/context-relevance.js

@@ -6,7 +6,7 @@
  * with core, extension, or project-specific feature stores.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="833cf230-b0c8-51f0-822e-1f27f0574971")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="be8706fa-86f8-576a-9e39-475b9681600c")}catch(e){}}();
 import { runActiveServiceOverride } from "../core/extensions/index.js";
 import { normalizeStatusForRegistry, normalizeStatusInput, } from "../core/item/status.js";
 import { compareTimestampStrings, resolveIsoOrRelative } from "../core/shared/time.js";
@@ -25,6 +25,14 @@ export const CONTEXT_RELEVANCE_SIGNAL_NAMES = [
     "usage_affinity",
     "semantic_similarity",
 ];
+const NO_CONTEXT_AUTHOR = Symbol("no-context-author");
+const NO_ITEM_ASSIGNEE = Symbol("no-item-assignee");
+function normalizeContextActor(value, missingValue) {
+    if (typeof value !== "string")
+        return missingValue;
+    const normalized = value.trim().toLowerCase();
+    return normalized.length > 0 ? normalized : missingValue;
+}
 function normalizedPressure(value, maximum) {
     const parsed = typeof value === "number" ? value : typeof value === "string" ? Number.parseFloat(value) : Number.NaN;
     return Number.isFinite(parsed) ? 1 - Math.min(Math.max(parsed, 0), maximum) / maximum : 0;
@@ -44,6 +52,9 @@ function riskPressure(risk) {
         return 0.5;
     return normalized === "low" ? 0.1 : 0;
 }
+function derivedSignalOrFallback(values, id, fallback) {
+    return values?.[id] ?? fallback;
+}
 /**
  * Derive the canonical metadata signals consumed by `pm context` and `pm next`.
  * Extensions can pair this with {@link scoreContextCandidatesWithActiveExtensions}
@@ -67,24 +78,25 @@ export function buildItemContextRelevanceCandidates(items, options) {
     });
     const recencyRank = new Map(recencyOrder.map((item, index) => [item.id, index]));
     const denominator = Math.max(items.length - 1, 1);
-    const normalizedAuthor = options.author?.trim().toLowerCase();
+    const normalizedAuthor = normalizeContextActor(options.author, NO_CONTEXT_AUTHOR);
     const inProgressStatus = normalizeStatusInput("in_progress", options.statusRegistry);
     const nowMs = Date.parse(options.now);
     return items.map((item) => {
-        const assigned = normalizedAuthor !== undefined && typeof item.assignee === "string" && item.assignee.trim().toLowerCase() === normalizedAuthor;
+        const assigned = normalizeContextActor(item.assignee, NO_ITEM_ASSIGNEE) === normalizedAuthor;
         const knowledgeEntries = (item.comments?.length ?? 0) + (item.notes?.length ?? 0) + (item.learnings?.length ?? 0);
         return {
             id: item.id,
             item,
             signals: {
                 recency: items.length === 1 ? 1 : 1 - recencyRank.get(item.id) / denominator,
-                graph_proximity: item.parent ? 0.3 : 0,
-                claim_focus: normalizeStatusForRegistry(item.status, options.statusRegistry) === inProgressStatus ? 1 : assigned ? 0.75 : 0,
+                activity_density: options.activityDensity?.[item.id],
+                graph_proximity: derivedSignalOrFallback(options.graphProximity, item.id, item.parent ? 0.3 : 0),
+                claim_focus: derivedSignalOrFallback(options.claimFocus, item.id, normalizeStatusForRegistry(item.status, options.statusRegistry) === inProgressStatus ? 1 : assigned ? 0.75 : 0),
                 priority_pressure: normalizedPressure(item.priority, 4),
                 risk_pressure: riskPressure(item.risk),
                 deadline_pressure: deadlinePressure(item.deadline, nowMs),
-                knowledge_density: Math.min(knowledgeEntries / 5, 1),
-                author_affinity: assigned ? 1 : 0,
+                knowledge_density: derivedSignalOrFallback(options.knowledgeDensity, item.id, Math.min(knowledgeEntries / 5, 1)),
+                author_affinity: derivedSignalOrFallback(options.authorAffinity, item.id, assigned ? 1 : 0),
                 usage_affinity: options.usageAffinity?.[item.id],
                 semantic_similarity: options.semanticSimilarity?.[item.id],
             },
@@ -410,4 +422,4 @@ export async function runContextEvaluationCorpus(scenarios, reader, thresholds)
     return summarizeContextEvaluationReports(reports, thresholds);
 }
 //# sourceMappingURL=context-relevance.js.map
-//# debugId=833cf230-b0c8-51f0-822e-1f27f0574971
+//# debugId=be8706fa-86f8-576a-9e39-475b9681600c

package/dist/sdk/context-relevance.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-relevance.js","sources":["sdk/context-relevance.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/context-relevance\n *\n * Public, deterministic context-ranking and evaluation primitives. The scorer\n * accepts already-derived signals so package authors can reuse the same model\n * with core, extension, or project-specific feature stores.\n */\nimport { runActiveServiceOverride } from \"../core/extensions/index.js\";\nimport {\n  normalizeStatusForRegistry,\n  normalizeStatusInput,\n} from \"../core/item/status.js\";\nimport type { RuntimeStatusRegistry } from \"../core/schema/runtime-schema.js\";\nimport { compareTimestampStrings, resolveIsoOrRelative } from \"../core/shared/time.js\";\nimport type { ItemMetadata } from \"../types/index.js\";\n\n/** Canonical signal keys understood by the built-in relevance model. */\nexport const CONTEXT_RELEVANCE_SIGNAL_NAMES = [\n  \"structural\",\n  \"recency\",\n  \"activity_density\",\n  \"graph_proximity\",\n  \"claim_focus\",\n  \"priority_pressure\",\n  \"risk_pressure\",\n  \"deadline_pressure\",\n  \"knowledge_density\",\n  \"author_affinity\",\n  \"usage_affinity\",\n  \"semantic_similarity\",\n] as const;\n\n/** A normalized signal consumed by the built-in context relevance scorer. */\nexport type ContextRelevanceSignalName =\n  (typeof CONTEXT_RELEVANCE_SIGNAL_NAMES)[number];\n\n/** Normalized candidate features; omitted signals are excluded from weighting. */\nexport type ContextRelevanceSignals = Partial<\n  Record<Exclude<ContextRelevanceSignalName, \"structural\">, number>\n>;\n\n/** A project-management object and its derived relevance signals. */\nexport interface ContextRelevanceCandidate<TItem> {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports item for this contract. */\n  item: TItem;\n  /** Value that configures or reports signals for this contract. */\n  signals?: ContextRelevanceSignals;\n}\n\n/** Inputs that make item-signal derivation deterministic and host-configurable. */\nexport interface BuildItemContextRelevanceCandidatesOptions {\n  /** Workspace lifecycle registry, including custom in-progress aliases. */\n  statusRegistry: RuntimeStatusRegistry;\n  /** Stable clock used for deadline pressure. */\n  now: string;\n  /** Optional caller identity used for assignment affinity. */\n  author?: string;\n  /** Optional derived served-then-used affinity by item id. */\n  usageAffinity?: Readonly<Record<string, number>>;\n  /** Optional caller-derived semantic similarity by item id. */\n  semanticSimilarity?: Readonly<Record<string, number>>;\n}\n\nfunction normalizedPressure(value: unknown, maximum: number): number {\n  const parsed = typeof value === \"number\" ? value : typeof value === \"string\" ? Number.parseFloat(value) : Number.NaN;\n  return Number.isFinite(parsed) ? 1 - Math.min(Math.max(parsed, 0), maximum) / maximum : 0;\n}\n\nfunction deadlinePressure(deadline: unknown, nowMs: number): number {\n  const deadlineMs = typeof deadline === \"string\" ? Date.parse(deadline) : deadline instanceof Date ? deadline.getTime() : typeof deadline === \"number\" ? deadline : Number.NaN;\n  if (!Number.isFinite(deadlineMs) || !Number.isFinite(nowMs)) return 0;\n  const days = (deadlineMs - nowMs) / 86_400_000;\n  return days <= 0 ? 1 : 1 / (1 + days / 30);\n}\n\nfunction riskPressure(risk: ItemMetadata[\"risk\"]): number {\n  const normalized = typeof risk === \"string\" ? risk.trim().toLowerCase() : undefined;\n  if (normalized === \"critical\" || normalized === \"high\") return 1;\n  if (normalized === \"medium\") return 0.5;\n  return normalized === \"low\" ? 0.1 : 0;\n}\n\n/**\n * Derive the canonical metadata signals consumed by `pm context` and `pm next`.\n * Extensions can pair this with {@link scoreContextCandidatesWithActiveExtensions}\n * to reproduce built-in ranking without private imports or subprocesses.\n */\nexport function buildItemContextRelevanceCandidates(\n  items: readonly ItemMetadata[],\n  options: BuildItemContextRelevanceCandidatesOptions,\n): ContextRelevanceCandidate<ItemMetadata>[] {\n  const sortableTimestamp = (value: unknown): string => {\n    if (typeof value !== \"string\") return \"\";\n    try {\n      return resolveIsoOrRelative(value, new Date(Number.NaN), \"updated_at\");\n    } catch {\n      return \"\";\n    }\n  };\n  const recencyOrder = [...items].sort((left, right) => {\n    const leftTime = sortableTimestamp(left.updated_at);\n    const rightTime = sortableTimestamp(right.updated_at);\n    return compareTimestampStrings(rightTime, leftTime) || left.id.localeCompare(right.id);\n  });\n  const recencyRank = new Map(recencyOrder.map((item, index) => [item.id, index]));\n  const denominator = Math.max(items.length - 1, 1);\n  const normalizedAuthor = options.author?.trim().toLowerCase();\n  const inProgressStatus = normalizeStatusInput(\"in_progress\", options.statusRegistry);\n  const nowMs = Date.parse(options.now);\n  return items.map((item) => {\n    const assigned = normalizedAuthor !== undefined && typeof item.assignee === \"string\" && item.assignee.trim().toLowerCase() === normalizedAuthor;\n    const knowledgeEntries = (item.comments?.length ?? 0) + (item.notes?.length ?? 0) + (item.learnings?.length ?? 0);\n    return {\n      id: item.id,\n      item,\n      signals: {\n        recency: items.length === 1 ? 1 : 1 - (recencyRank.get(item.id) as number) / denominator,\n        graph_proximity: item.parent ? 0.3 : 0,\n        claim_focus: normalizeStatusForRegistry(item.status, options.statusRegistry) === inProgressStatus ? 1 : assigned ? 0.75 : 0,\n        priority_pressure: normalizedPressure(item.priority, 4),\n        risk_pressure: riskPressure(item.risk),\n        deadline_pressure: deadlinePressure(item.deadline, nowMs),\n        knowledge_density: Math.min(knowledgeEntries / 5, 1),\n        author_affinity: assigned ? 1 : 0,\n        usage_affinity: options.usageAffinity?.[item.id],\n        semantic_similarity: options.semanticSimilarity?.[item.id],\n      },\n    };\n  });\n}\n\n/** Per-signal weighted contributions used to explain a ranked result. */\nexport type ContextRelevanceContributions = Record<string, number>;\n\n/** One ranked candidate with deterministic score and explanation metadata. */\nexport interface RankedContextCandidate<\n  TItem,\n> extends ContextRelevanceCandidate<TItem> {\n  /** Value that configures or reports baseline rank for this contract. */\n  baseline_rank: number;\n  /** Value that configures or reports rank for this contract. */\n  rank: number;\n  /** Value that configures or reports score for this contract. */\n  score: number;\n  /** Value that configures or reports contributions for this contract. */\n  contributions: ContextRelevanceContributions;\n}\n\n/** Complete output from a context relevance scorer. */\nexport interface ContextRelevanceReport<TItem> {\n  /** Value that configures or reports model for this contract. */\n  model: string;\n  /** Value that configures or reports available signals for this contract. */\n  available_signals: ContextRelevanceSignalName[];\n  /** Value that configures or reports ranked for this contract. */\n  ranked: RankedContextCandidate<TItem>[];\n  /** Value that configures or reports warnings for this contract. */\n  warnings?: string[];\n}\n\n/** Minimal custom score returned by a replacement or wrapper scorer. */\nexport interface ContextRelevanceCustomScore {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports score for this contract. */\n  score: number;\n}\n\n/** Input provided to a custom scorer, including the deterministic default. */\nexport interface ContextRelevanceScorerInput<TItem> {\n  /** Value that configures or reports candidates for this contract. */\n  candidates: readonly ContextRelevanceCandidate<TItem>[];\n  /** Fallback report used when callers do not provide an override. */\n  default_report: ContextRelevanceReport<TItem>;\n}\n\n/** Replaceable package/extension scorer contract. */\nexport type ContextRelevanceScorer<TItem> = (\n  input: ContextRelevanceScorerInput<TItem>,\n) =>\n  | readonly ContextRelevanceCustomScore[]\n  | Promise<readonly ContextRelevanceCustomScore[]>;\n\n/** Options for the built-in or replaceable context relevance scorer. */\nexport interface ScoreContextCandidatesOptions<TItem> {\n  /** Value that configures or reports weights for this contract. */\n  weights?: Partial<Record<ContextRelevanceSignalName, number>>;\n  /** Value that configures or reports scorer for this contract. */\n  scorer?: ContextRelevanceScorer<TItem>;\n}\n\n/** Governed extension service used to replace or wrap context ranking. */\nexport const CONTEXT_RELEVANCE_SERVICE = \"context_relevance\" as const;\n\n/** Command surface requesting an active extension relevance override. */\nexport type ContextRelevanceSurface = \"context\" | \"next\";\n\nconst DEFAULT_CONTEXT_RELEVANCE_WEIGHTS: Record<\n  ContextRelevanceSignalName,\n  number\n> = {\n  structural: 0.4,\n  recency: 0.35,\n  activity_density: 0.25,\n  graph_proximity: 0.15,\n  claim_focus: 0.6,\n  priority_pressure: 0.35,\n  risk_pressure: 0.2,\n  deadline_pressure: 0.45,\n  knowledge_density: 0.25,\n  author_affinity: 0.2,\n  usage_affinity: 0.3,\n  semantic_similarity: 0.5,\n};\nconst JSON_TOKEN_ENCODER = new TextEncoder();\n\nfunction assertCandidates<TItem>(\n  candidates: readonly ContextRelevanceCandidate<TItem>[],\n): void {\n  const ids = new Set<string>();\n  for (const candidate of candidates) {\n    if (\n      typeof candidate.id !== \"string\" ||\n      candidate.id.trim().length === 0 ||\n      ids.has(candidate.id)\n    ) {\n      throw new TypeError(\n        \"Context relevance candidates require unique non-empty ids\",\n      );\n    }\n    ids.add(candidate.id);\n    for (const [signal, value] of Object.entries(candidate.signals ?? {})) {\n      if (\n        signal === \"structural\" ||\n        !CONTEXT_RELEVANCE_SIGNAL_NAMES.includes(\n          signal as ContextRelevanceSignalName,\n        )\n      ) {\n        throw new TypeError(`Unknown context relevance signal: ${signal}`);\n      }\n      if (value === undefined) continue;\n      if (!Number.isFinite(value) || value < 0 || value > 1) {\n        throw new TypeError(\n          `Context relevance signal ${signal} must be a finite number from 0 to 1`,\n        );\n      }\n    }\n  }\n}\n\nfunction resolveWeights(\n  overrides: Partial<Record<ContextRelevanceSignalName, number>> | undefined,\n): Record<ContextRelevanceSignalName, number> {\n  const weights = { ...DEFAULT_CONTEXT_RELEVANCE_WEIGHTS };\n  for (const [signal, weight] of Object.entries(overrides ?? {})) {\n    if (\n      weight !== undefined &&\n      CONTEXT_RELEVANCE_SIGNAL_NAMES.includes(\n        signal as ContextRelevanceSignalName,\n      )\n    ) {\n      weights[signal as ContextRelevanceSignalName] = weight;\n    }\n  }\n  for (const [signal, weight] of Object.entries(weights)) {\n    if (!Number.isFinite(weight) || weight < 0) {\n      throw new TypeError(\n        `Context relevance weight ${signal} must be a finite non-negative number`,\n      );\n    }\n  }\n  return weights;\n}\n\n/** Score candidates with pm's deterministic weighted model. Candidate order is the structural baseline and remains unchanged when no advanced signals exist. */\nexport function defaultScoreContextCandidates<TItem>(\n  candidates: readonly ContextRelevanceCandidate<TItem>[],\n  options: Pick<ScoreContextCandidatesOptions<TItem>, \"weights\"> = {},\n): ContextRelevanceReport<TItem> {\n  assertCandidates(candidates);\n  const weights = resolveWeights(options.weights);\n  const denominator = Math.max(candidates.length - 1, 1);\n  const available = new Set<ContextRelevanceSignalName>([\"structural\"]);\n  for (const candidate of candidates) {\n    for (const [signal, value] of Object.entries(candidate.signals ?? {})) {\n      if (value !== undefined)\n        available.add(signal as ContextRelevanceSignalName);\n    }\n  }\n  const availableSignals = CONTEXT_RELEVANCE_SIGNAL_NAMES.filter((signal) =>\n    available.has(signal),\n  );\n  const scored = candidates.map(\n    (candidate, index): RankedContextCandidate<TItem> => {\n      const signalValues: Partial<Record<ContextRelevanceSignalName, number>> =\n        {\n          structural: candidates.length === 1 ? 1 : 1 - index / denominator,\n          ...candidate.signals,\n        };\n      const contributions: ContextRelevanceContributions = {};\n      let weightedScore = 0;\n      let totalWeight = 0;\n      for (const signal of availableSignals) {\n        const value = signalValues[signal];\n        if (value === undefined) continue;\n        const contribution = value * weights[signal];\n        contributions[signal] = contribution;\n        weightedScore += contribution;\n        totalWeight += weights[signal];\n      }\n      return {\n        ...candidate,\n        baseline_rank: index + 1,\n        rank: 0,\n        score: totalWeight === 0 ? 0 : weightedScore / totalWeight,\n        contributions,\n      };\n    },\n  );\n  scored.sort(\n    (left, right) =>\n      right.score - left.score || left.baseline_rank - right.baseline_rank,\n  );\n  scored.forEach((entry, index) => {\n    entry.rank = index + 1;\n  });\n  return {\n    model: \"default-weighted-v1\",\n    available_signals: availableSignals,\n    ranked: scored,\n  };\n}\n\n/** Score candidates with the default model or a validated replacement/wrapper. */\nexport async function scoreContextCandidates<TItem>(\n  candidates: readonly ContextRelevanceCandidate<TItem>[],\n  options: ScoreContextCandidatesOptions<TItem> = {},\n): Promise<ContextRelevanceReport<TItem>> {\n  const defaultReport = defaultScoreContextCandidates(candidates, options);\n  if (!options.scorer) return defaultReport;\n  const customScores = await options.scorer({\n    candidates,\n    default_report: defaultReport,\n  });\n  const scoreById = new Map<string, number>();\n  for (const entry of customScores) {\n    if (scoreById.has(entry.id) || !Number.isFinite(entry.score)) {\n      throw new TypeError(\n        \"Context relevance scorer must return one finite score for every candidate\",\n      );\n    }\n    scoreById.set(entry.id, entry.score);\n  }\n  if (\n    scoreById.size !== candidates.length ||\n    candidates.some((candidate) => !scoreById.has(candidate.id))\n  ) {\n    throw new TypeError(\n      \"Context relevance scorer must return one finite score for every candidate\",\n    );\n  }\n  const ranked = defaultReport.ranked.map((entry) => {\n    const score = scoreById.get(entry.id) as number;\n    return { ...entry, score, contributions: { custom: score } };\n  });\n  ranked.sort(\n    (left, right) =>\n      right.score - left.score || left.baseline_rank - right.baseline_rank,\n  );\n  ranked.forEach((entry, index) => {\n    entry.rank = index + 1;\n  });\n  return {\n    model: \"custom\",\n    available_signals: defaultReport.available_signals,\n    ranked,\n  };\n}\n\n/** Score command candidates through the public default model and then the active governed `context_relevance` service override, when one is registered. */\nexport async function scoreContextCandidatesWithActiveExtensions<TItem>(\n  surface: ContextRelevanceSurface,\n  candidates: readonly ContextRelevanceCandidate<TItem>[],\n  options: Pick<ScoreContextCandidatesOptions<TItem>, \"weights\"> = {},\n): Promise<ContextRelevanceReport<TItem>> {\n  const defaultReport = defaultScoreContextCandidates(candidates, options);\n  const override = await runActiveServiceOverride(CONTEXT_RELEVANCE_SERVICE, {\n    surface,\n    candidates,\n    default_report: defaultReport,\n  });\n  if (!override.handled) {\n    return override.warnings.length > 0\n      ? { ...defaultReport, warnings: override.warnings }\n      : defaultReport;\n  }\n  if (\n    !Array.isArray(override.result) ||\n    !override.result.every(\n      (entry) =>\n        typeof entry === \"object\" &&\n        entry !== null &&\n        typeof (entry as { id?: unknown }).id === \"string\" &&\n        typeof (entry as { score?: unknown }).score === \"number\" &&\n        Number.isFinite((entry as { score: number }).score),\n    )\n  ) {\n    return {\n      ...defaultReport,\n      warnings: [\n        ...override.warnings,\n        \"extension_context_relevance_invalid_result\",\n      ],\n    };\n  }\n  try {\n    const report = await scoreContextCandidates(candidates, {\n      ...options,\n      scorer: () => override.result as ContextRelevanceCustomScore[],\n    });\n    return override.warnings.length > 0\n      ? { ...report, warnings: override.warnings }\n      : report;\n  } catch {\n    return {\n      ...defaultReport,\n      warnings: [\n        ...override.warnings,\n        \"extension_context_relevance_invalid_result\",\n      ],\n    };\n  }\n}\n\n/** Input for rank-aware context/next quality evaluation. */\nexport interface ContextRankingEvaluationInput {\n  /** Value that configures or reports ranked ids for this contract. */\n  ranked_ids: string[];\n  /** Value that configures or reports judgments for this contract. */\n  judgments: Record<string, number>;\n  /** Value that configures or reports required ids for this contract. */\n  required_ids?: string[];\n  /** Value that configures or reports continuity ids for this contract. */\n  continuity_ids?: string[];\n  /** Value that configures or reports actual tokens for this contract. */\n  actual_tokens: number;\n  /** Value that configures or reports token budget for this contract. */\n  token_budget: number;\n}\n\n/** Rank-quality, continuity, recall, and token-budget metrics for one scenario. */\nexport interface ContextRankingEvaluation {\n  /** Value that configures or reports ndcg for this contract. */\n  ndcg: number;\n  /** Value that configures or reports reciprocal rank for this contract. */\n  reciprocal_rank: number;\n  /** Value that configures or reports required recall for this contract. */\n  required_recall: number;\n  /** Value that configures or reports continuity coverage for this contract. */\n  continuity_coverage: number;\n  /** Value that configures or reports token budget adherence for this contract. */\n  token_budget_adherence: number;\n  /** Value that configures or reports within token budget for this contract. */\n  within_token_budget: boolean;\n}\n\n/** Flexible read options accepted by context evaluation scenarios. */\nexport interface ContextEvaluationReadOptions {\n  /** Value that configures or reports explain ranking for this contract. */\n  explainRanking?: boolean;\n  [key: string]: unknown;\n}\n\n/** Minimal item identity consumed by the context evaluation runner. */\nexport interface ContextEvaluationResultItem {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n}\n\n/** Optional scorer attribution returned by an evaluated read primitive. */\nexport interface ContextEvaluationResultRanking {\n  /** Value that configures or reports items for this contract. */\n  items?: Array<{ id: string; contributions: ContextRelevanceContributions }>;\n}\n\n/** Structural context result consumed by the evaluation runner. */\nexport interface ContextEvaluationContextResult {\n  /** Value that configures or reports high level for this contract. */\n  high_level?: ContextEvaluationResultItem[];\n  /** Value that configures or reports low level for this contract. */\n  low_level?: ContextEvaluationResultItem[];\n  /** Value that configures or reports blocked fallback for this contract. */\n  blocked_fallback?: ContextEvaluationResultItem[];\n  /** Value that configures or reports ranking for this contract. */\n  ranking?: ContextEvaluationResultRanking;\n  [key: string]: unknown;\n}\n\n/** Structural next result consumed by the evaluation runner. */\nexport interface ContextEvaluationNextResult {\n  /** Value that configures or reports recommended for this contract. */\n  recommended?: ContextEvaluationResultItem | null;\n  /** Value that configures or reports ready for this contract. */\n  ready?: ContextEvaluationResultItem[];\n  /** Value that configures or reports ranking for this contract. */\n  ranking?: ContextEvaluationResultRanking;\n  [key: string]: unknown;\n}\n\n/** Read-only SDK surface required by the context evaluation runner. */\nexport interface ContextEvaluationReader {\n  /** Value that configures or reports context for this contract. */\n  context(\n    options?: ContextEvaluationReadOptions,\n  ): Promise<ContextEvaluationContextResult>;\n  /** Value that configures or reports next for this contract. */\n  next(\n    options?: ContextEvaluationReadOptions,\n  ): Promise<ContextEvaluationNextResult>;\n}\n\n/** One graded context or next scenario evaluated against a real SDK reader. */\nexport interface ContextEvaluationScenario {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports surface for this contract. */\n  surface: ContextRelevanceSurface;\n  /** Value that configures or reports options for this contract. */\n  options?: ContextEvaluationReadOptions;\n  /** Value that configures or reports judgments for this contract. */\n  judgments: Record<string, number>;\n  /** Value that configures or reports required ids for this contract. */\n  required_ids?: string[];\n  /** Value that configures or reports continuity ids for this contract. */\n  continuity_ids?: string[];\n  /** Value that configures or reports token budget for this contract. */\n  token_budget: number;\n  /** Value that configures or reports rationale for this contract. */\n  rationale: string;\n}\n\n/** Per-item signal attribution retained by a context evaluation report. */\nexport interface ContextEvaluationAttribution {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports contributions for this contract. */\n  contributions: ContextRelevanceContributions;\n}\n\n/** Result of executing and grading one context evaluation scenario. */\nexport interface ContextEvaluationScenarioReport {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports surface for this contract. */\n  surface: ContextRelevanceSurface;\n  /** Value that configures or reports rationale for this contract. */\n  rationale: string;\n  /** Value that configures or reports ranked ids for this contract. */\n  ranked_ids: string[];\n  /** Value that configures or reports actual tokens for this contract. */\n  actual_tokens: number;\n  /** Value that configures or reports metrics for this contract. */\n  metrics: ContextRankingEvaluation;\n  /** Value that configures or reports attribution for this contract. */\n  attribution: ContextEvaluationAttribution[];\n}\n\n/** Minimum acceptable aggregate metrics for a context evaluation corpus. */\nexport interface ContextEvaluationThresholds {\n  /** Value that configures or reports ndcg for this contract. */\n  ndcg: number;\n  /** Value that configures or reports reciprocal rank for this contract. */\n  reciprocal_rank: number;\n  /** Value that configures or reports required recall for this contract. */\n  required_recall: number;\n  /** Value that configures or reports continuity coverage for this contract. */\n  continuity_coverage: number;\n  /** Value that configures or reports token budget adherence for this contract. */\n  token_budget_adherence: number;\n}\n\n/** Canonical aggregate metrics required by every context evaluation corpus. */\nexport const CONTEXT_EVALUATION_METRIC_NAMES = [\n  \"ndcg\",\n  \"reciprocal_rank\",\n  \"required_recall\",\n  \"continuity_coverage\",\n  \"token_budget_adherence\",\n] as const satisfies readonly (keyof ContextEvaluationThresholds)[];\n\n/** Aggregate context evaluation report suitable for a CI quality gate. */\nexport interface ContextEvaluationCorpusReport {\n  /** Number of scenario entries represented by this result. */\n  scenario_count: number;\n  /** Value that configures or reports aggregate for this contract. */\n  aggregate: ContextEvaluationThresholds;\n  /** Value that configures or reports scenarios for this contract. */\n  scenarios: ContextEvaluationScenarioReport[];\n  /** Value that configures or reports passed for this contract. */\n  passed: boolean;\n  /** Value that configures or reports failures for this contract. */\n  failures: string[];\n}\n\nfunction ratioOfPresent(\n  expected: readonly string[],\n  actual: ReadonlySet<string>,\n): number {\n  if (expected.length === 0) return 1;\n  return expected.filter((id) => actual.has(id)).length / expected.length;\n}\n\n/** Evaluate one ranked context packet against graded human judgments. */\nexport function evaluateContextRanking(\n  input: ContextRankingEvaluationInput,\n): ContextRankingEvaluation {\n  if (\n    !Number.isFinite(input.actual_tokens) ||\n    input.actual_tokens < 0 ||\n    !Number.isFinite(input.token_budget) ||\n    input.token_budget <= 0\n  ) {\n    throw new TypeError(\n      \"Context ranking token counts require actual_tokens >= 0 and token_budget > 0\",\n    );\n  }\n  const judgments = input.judgments ?? {};\n  const gains = input.ranked_ids.map((id) => Math.max(0, judgments[id] ?? 0));\n  const idealGains = Object.values(judgments)\n    .map((grade) => Math.max(0, grade))\n    .sort((left, right) => right - left)\n    .slice(0, gains.length || 1);\n  const discountedGain = (values: readonly number[]) =>\n    values.reduce(\n      (total, grade, index) => total + (2 ** grade - 1) / Math.log2(index + 2),\n      0,\n    );\n  const ideal = discountedGain(idealGains);\n  const firstRelevant = gains.findIndex((grade) => grade > 0);\n  const actualIds = new Set(input.ranked_ids);\n  const withinBudget = input.actual_tokens <= input.token_budget;\n  return {\n    ndcg: ideal === 0 ? 1 : discountedGain(gains) / ideal,\n    reciprocal_rank: firstRelevant < 0 ? 0 : 1 / (firstRelevant + 1),\n    required_recall: ratioOfPresent(input.required_ids ?? [], actualIds),\n    continuity_coverage: ratioOfPresent(input.continuity_ids ?? [], actualIds),\n    token_budget_adherence: withinBudget\n      ? 1\n      : input.token_budget / input.actual_tokens,\n    within_token_budget: withinBudget,\n  };\n}\n\nfunction estimateJsonTokens(value: unknown): number {\n  return Math.ceil(\n    JSON_TOKEN_ENCODER.encode(JSON.stringify(value)).byteLength / 4,\n  );\n}\n\nfunction roundEvaluationMetric(value: number): number {\n  return Math.round(value * 10_000) / 10_000;\n}\n\nfunction rankingPayloadForScenario(\n  result: ContextEvaluationContextResult | ContextEvaluationNextResult,\n  surface: ContextRelevanceSurface,\n): { rankedIds: string[]; attribution: ContextEvaluationAttribution[] } {\n  const rankedIds =\n    surface === \"context\"\n      ? [\n          ...((result as ContextEvaluationContextResult).high_level ?? []),\n          ...((result as ContextEvaluationContextResult).low_level ?? []),\n          ...((result as ContextEvaluationContextResult).blocked_fallback ??\n            []),\n        ].map((item) => item.id)\n      : [\n          ...((result as ContextEvaluationNextResult).recommended\n            ? [\n                (result as ContextEvaluationNextResult)\n                  .recommended as ContextEvaluationResultItem,\n              ]\n            : []),\n          ...((result as ContextEvaluationNextResult).ready ?? []),\n        ].map((item) => item.id);\n  const servedIds = new Set(rankedIds);\n  const attribution = (result.ranking?.items ?? [])\n    .filter((item) => servedIds.has(item.id))\n    .map((item) => ({ id: item.id, contributions: item.contributions }));\n  return { rankedIds, attribution };\n}\n\n/** Execute one graded scenario through public SDK context/next read primitives. */\nexport async function runContextEvaluationScenario(\n  scenario: ContextEvaluationScenario,\n  reader: ContextEvaluationReader,\n): Promise<ContextEvaluationScenarioReport> {\n  if (\n    scenario.id.trim().length === 0 ||\n    scenario.rationale.trim().length === 0\n  ) {\n    throw new TypeError(\n      \"Context evaluation scenarios require non-empty id and rationale values\",\n    );\n  }\n  const result =\n    scenario.surface === \"context\"\n      ? await reader.context({ ...scenario.options, explainRanking: true })\n      : await reader.next({ ...scenario.options, explainRanking: true });\n  const { rankedIds, attribution } = rankingPayloadForScenario(\n    result,\n    scenario.surface,\n  );\n  const packet = { ...result, ranking: undefined };\n  const actualTokens = estimateJsonTokens(packet);\n  return {\n    id: scenario.id,\n    surface: scenario.surface,\n    rationale: scenario.rationale,\n    ranked_ids: rankedIds,\n    actual_tokens: actualTokens,\n    metrics: evaluateContextRanking({\n      ranked_ids: rankedIds,\n      judgments: scenario.judgments,\n      required_ids: scenario.required_ids,\n      continuity_ids: scenario.continuity_ids,\n      actual_tokens: actualTokens,\n      token_budget: scenario.token_budget,\n    }),\n    attribution,\n  };\n}\n\n/** Aggregate scenario reports and evaluate every metric against explicit thresholds. */\nexport function summarizeContextEvaluationReports(\n  reports: readonly ContextEvaluationScenarioReport[],\n  thresholds: ContextEvaluationThresholds,\n): ContextEvaluationCorpusReport {\n  if (reports.length === 0) {\n    throw new TypeError(\n      \"Context evaluation requires at least one scenario report\",\n    );\n  }\n  const metrics = CONTEXT_EVALUATION_METRIC_NAMES;\n  for (const metric of metrics) {\n    if (!Number.isFinite(thresholds[metric])) {\n      throw new TypeError(\n        `Context evaluation threshold ${metric} must be a finite number`,\n      );\n    }\n  }\n  const aggregate = Object.fromEntries(\n    metrics.map((metric) => [\n      metric,\n      roundEvaluationMetric(\n        reports.reduce((total, report) => total + report.metrics[metric], 0) /\n          reports.length,\n      ),\n    ]),\n  ) as unknown as ContextEvaluationThresholds;\n  const failures = metrics\n    .filter((metric) => aggregate[metric] < thresholds[metric])\n    .map((metric) => `${metric}:${aggregate[metric]}<${thresholds[metric]}`);\n  return {\n    scenario_count: reports.length,\n    aggregate,\n    scenarios: [...reports],\n    passed: failures.length === 0,\n    failures,\n  };\n}\n\n/** Execute a same-workspace scenario corpus through public SDK read primitives. */\nexport async function runContextEvaluationCorpus(\n  scenarios: readonly ContextEvaluationScenario[],\n  reader: ContextEvaluationReader,\n  thresholds: ContextEvaluationThresholds,\n): Promise<ContextEvaluationCorpusReport> {\n  const reports: ContextEvaluationScenarioReport[] = [];\n  for (const scenario of scenarios) {\n    reports.push(await runContextEvaluationScenario(scenario, reader));\n  }\n  return summarizeContextEvaluationReports(reports, thresholds);\n}\n"],"names":[],"mappings":"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","debugId":"833cf230-b0c8-51f0-822e-1f27f0574971"}
+{"version":3,"file":"context-relevance.js","sources":["sdk/context-relevance.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/context-relevance\n *\n * Public, deterministic context-ranking and evaluation primitives. The scorer\n * accepts already-derived signals so package authors can reuse the same model\n * with core, extension, or project-specific feature stores.\n */\nimport { runActiveServiceOverride } from \"../core/extensions/index.js\";\nimport {\n  normalizeStatusForRegistry,\n  normalizeStatusInput,\n} from \"../core/item/status.js\";\nimport type { RuntimeStatusRegistry } from \"../core/schema/runtime-schema.js\";\nimport { compareTimestampStrings, resolveIsoOrRelative } from \"../core/shared/time.js\";\nimport type { ItemMetadata } from \"../types/index.js\";\n\n/** Canonical signal keys understood by the built-in relevance model. */\nexport const CONTEXT_RELEVANCE_SIGNAL_NAMES = [\n  \"structural\",\n  \"recency\",\n  \"activity_density\",\n  \"graph_proximity\",\n  \"claim_focus\",\n  \"priority_pressure\",\n  \"risk_pressure\",\n  \"deadline_pressure\",\n  \"knowledge_density\",\n  \"author_affinity\",\n  \"usage_affinity\",\n  \"semantic_similarity\",\n] as const;\n\n/** A normalized signal consumed by the built-in context relevance scorer. */\nexport type ContextRelevanceSignalName =\n  (typeof CONTEXT_RELEVANCE_SIGNAL_NAMES)[number];\n\n/** Normalized candidate features; omitted signals are excluded from weighting. */\nexport type ContextRelevanceSignals = Partial<\n  Record<Exclude<ContextRelevanceSignalName, \"structural\">, number>\n>;\n\nconst NO_CONTEXT_AUTHOR = Symbol(\"no-context-author\");\nconst NO_ITEM_ASSIGNEE = Symbol(\"no-item-assignee\");\n\nfunction normalizeContextActor(value: unknown, missingValue: symbol): string | symbol {\n  if (typeof value !== \"string\") return missingValue;\n  const normalized = value.trim().toLowerCase();\n  return normalized.length > 0 ? normalized : missingValue;\n}\n\n/** A project-management object and its derived relevance signals. */\nexport interface ContextRelevanceCandidate<TItem> {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports item for this contract. */\n  item: TItem;\n  /** Value that configures or reports signals for this contract. */\n  signals?: ContextRelevanceSignals;\n}\n\n/** Item candidate whose built-in metadata derivation always supplies signals. */\nexport interface ItemContextRelevanceCandidate\n  extends ContextRelevanceCandidate<ItemMetadata> {\n  /** Complete built-in derivation result, with unavailable signals omitted by value. */\n  signals: ContextRelevanceSignals;\n}\n\n/** Inputs that make item-signal derivation deterministic and host-configurable. */\nexport interface BuildItemContextRelevanceCandidatesOptions {\n  /** Workspace lifecycle registry, including custom in-progress aliases. */\n  statusRegistry: RuntimeStatusRegistry;\n  /** Stable clock used for deadline pressure. */\n  now: string;\n  /** Optional caller identity used for assignment affinity. */\n  author?: string;\n  /** Optional derived served-then-used affinity by item id. */\n  usageAffinity?: Readonly<Record<string, number>>;\n  /** Optional caller-derived semantic similarity by item id. */\n  semanticSimilarity?: Readonly<Record<string, number>>;\n  /** Optional index-derived activity density by item id. */\n  activityDensity?: Readonly<Record<string, number>>;\n  /** Optional index-derived graph proximity by item id. */\n  graphProximity?: Readonly<Record<string, number>>;\n  /** Optional host-derived claim or focus affinity by item id. */\n  claimFocus?: Readonly<Record<string, number>>;\n  /** Optional index-derived knowledge density by item id. */\n  knowledgeDensity?: Readonly<Record<string, number>>;\n  /** Optional history-derived author affinity by item id. */\n  authorAffinity?: Readonly<Record<string, number>>;\n}\n\nfunction normalizedPressure(value: unknown, maximum: number): number {\n  const parsed = typeof value === \"number\" ? value : typeof value === \"string\" ? Number.parseFloat(value) : Number.NaN;\n  return Number.isFinite(parsed) ? 1 - Math.min(Math.max(parsed, 0), maximum) / maximum : 0;\n}\n\nfunction deadlinePressure(deadline: unknown, nowMs: number): number {\n  const deadlineMs = typeof deadline === \"string\" ? Date.parse(deadline) : deadline instanceof Date ? deadline.getTime() : typeof deadline === \"number\" ? deadline : Number.NaN;\n  if (!Number.isFinite(deadlineMs) || !Number.isFinite(nowMs)) return 0;\n  const days = (deadlineMs - nowMs) / 86_400_000;\n  return days <= 0 ? 1 : 1 / (1 + days / 30);\n}\n\nfunction riskPressure(risk: ItemMetadata[\"risk\"]): number {\n  const normalized = typeof risk === \"string\" ? risk.trim().toLowerCase() : undefined;\n  if (normalized === \"critical\" || normalized === \"high\") return 1;\n  if (normalized === \"medium\") return 0.5;\n  return normalized === \"low\" ? 0.1 : 0;\n}\n\nfunction derivedSignalOrFallback(\n  values: Readonly<Record<string, number>> | undefined,\n  id: string,\n  fallback: number,\n): number {\n  return values?.[id] ?? fallback;\n}\n\n/**\n * Derive the canonical metadata signals consumed by `pm context` and `pm next`.\n * Extensions can pair this with {@link scoreContextCandidatesWithActiveExtensions}\n * to reproduce built-in ranking without private imports or subprocesses.\n */\nexport function buildItemContextRelevanceCandidates(\n  items: readonly ItemMetadata[],\n  options: BuildItemContextRelevanceCandidatesOptions,\n): ItemContextRelevanceCandidate[] {\n  const sortableTimestamp = (value: unknown): string => {\n    if (typeof value !== \"string\") return \"\";\n    try {\n      return resolveIsoOrRelative(value, new Date(Number.NaN), \"updated_at\");\n    } catch {\n      return \"\";\n    }\n  };\n  const recencyOrder = [...items].sort((left, right) => {\n    const leftTime = sortableTimestamp(left.updated_at);\n    const rightTime = sortableTimestamp(right.updated_at);\n    return compareTimestampStrings(rightTime, leftTime) || left.id.localeCompare(right.id);\n  });\n  const recencyRank = new Map(recencyOrder.map((item, index) => [item.id, index]));\n  const denominator = Math.max(items.length - 1, 1);\n  const normalizedAuthor = normalizeContextActor(options.author, NO_CONTEXT_AUTHOR);\n  const inProgressStatus = normalizeStatusInput(\"in_progress\", options.statusRegistry);\n  const nowMs = Date.parse(options.now);\n  return items.map((item) => {\n    const assigned = normalizeContextActor(item.assignee, NO_ITEM_ASSIGNEE) === normalizedAuthor;\n    const knowledgeEntries = (item.comments?.length ?? 0) + (item.notes?.length ?? 0) + (item.learnings?.length ?? 0);\n    return {\n      id: item.id,\n      item,\n      signals: {\n        recency: items.length === 1 ? 1 : 1 - (recencyRank.get(item.id) as number) / denominator,\n        activity_density: options.activityDensity?.[item.id],\n        graph_proximity: derivedSignalOrFallback(options.graphProximity, item.id, item.parent ? 0.3 : 0),\n        claim_focus: derivedSignalOrFallback(options.claimFocus, item.id, normalizeStatusForRegistry(item.status, options.statusRegistry) === inProgressStatus ? 1 : assigned ? 0.75 : 0),\n        priority_pressure: normalizedPressure(item.priority, 4),\n        risk_pressure: riskPressure(item.risk),\n        deadline_pressure: deadlinePressure(item.deadline, nowMs),\n        knowledge_density: derivedSignalOrFallback(options.knowledgeDensity, item.id, Math.min(knowledgeEntries / 5, 1)),\n        author_affinity: derivedSignalOrFallback(options.authorAffinity, item.id, assigned ? 1 : 0),\n        usage_affinity: options.usageAffinity?.[item.id],\n        semantic_similarity: options.semanticSimilarity?.[item.id],\n      },\n    };\n  });\n}\n\n/** Per-signal weighted contributions used to explain a ranked result. */\nexport type ContextRelevanceContributions = Record<string, number>;\n\n/** One ranked candidate with deterministic score and explanation metadata. */\nexport interface RankedContextCandidate<\n  TItem,\n> extends ContextRelevanceCandidate<TItem> {\n  /** Value that configures or reports baseline rank for this contract. */\n  baseline_rank: number;\n  /** Value that configures or reports rank for this contract. */\n  rank: number;\n  /** Value that configures or reports score for this contract. */\n  score: number;\n  /** Value that configures or reports contributions for this contract. */\n  contributions: ContextRelevanceContributions;\n}\n\n/** Complete output from a context relevance scorer. */\nexport interface ContextRelevanceReport<TItem> {\n  /** Value that configures or reports model for this contract. */\n  model: string;\n  /** Value that configures or reports available signals for this contract. */\n  available_signals: ContextRelevanceSignalName[];\n  /** Value that configures or reports ranked for this contract. */\n  ranked: RankedContextCandidate<TItem>[];\n  /** Value that configures or reports warnings for this contract. */\n  warnings?: string[];\n}\n\n/** Minimal custom score returned by a replacement or wrapper scorer. */\nexport interface ContextRelevanceCustomScore {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports score for this contract. */\n  score: number;\n}\n\n/** Input provided to a custom scorer, including the deterministic default. */\nexport interface ContextRelevanceScorerInput<TItem> {\n  /** Value that configures or reports candidates for this contract. */\n  candidates: readonly ContextRelevanceCandidate<TItem>[];\n  /** Fallback report used when callers do not provide an override. */\n  default_report: ContextRelevanceReport<TItem>;\n}\n\n/** Replaceable package/extension scorer contract. */\nexport type ContextRelevanceScorer<TItem> = (\n  input: ContextRelevanceScorerInput<TItem>,\n) =>\n  | readonly ContextRelevanceCustomScore[]\n  | Promise<readonly ContextRelevanceCustomScore[]>;\n\n/** Options for the built-in or replaceable context relevance scorer. */\nexport interface ScoreContextCandidatesOptions<TItem> {\n  /** Value that configures or reports weights for this contract. */\n  weights?: Partial<Record<ContextRelevanceSignalName, number>>;\n  /** Value that configures or reports scorer for this contract. */\n  scorer?: ContextRelevanceScorer<TItem>;\n}\n\n/** Governed extension service used to replace or wrap context ranking. */\nexport const CONTEXT_RELEVANCE_SERVICE = \"context_relevance\" as const;\n\n/** Command surface requesting an active extension relevance override. */\nexport type ContextRelevanceSurface = \"context\" | \"next\";\n\nconst DEFAULT_CONTEXT_RELEVANCE_WEIGHTS: Record<\n  ContextRelevanceSignalName,\n  number\n> = {\n  structural: 0.4,\n  recency: 0.35,\n  activity_density: 0.25,\n  graph_proximity: 0.15,\n  claim_focus: 0.6,\n  priority_pressure: 0.35,\n  risk_pressure: 0.2,\n  deadline_pressure: 0.45,\n  knowledge_density: 0.25,\n  author_affinity: 0.2,\n  usage_affinity: 0.3,\n  semantic_similarity: 0.5,\n};\nconst JSON_TOKEN_ENCODER = new TextEncoder();\n\nfunction assertCandidates<TItem>(\n  candidates: readonly ContextRelevanceCandidate<TItem>[],\n): void {\n  const ids = new Set<string>();\n  for (const candidate of candidates) {\n    if (\n      typeof candidate.id !== \"string\" ||\n      candidate.id.trim().length === 0 ||\n      ids.has(candidate.id)\n    ) {\n      throw new TypeError(\n        \"Context relevance candidates require unique non-empty ids\",\n      );\n    }\n    ids.add(candidate.id);\n    for (const [signal, value] of Object.entries(candidate.signals ?? {})) {\n      if (\n        signal === \"structural\" ||\n        !CONTEXT_RELEVANCE_SIGNAL_NAMES.includes(\n          signal as ContextRelevanceSignalName,\n        )\n      ) {\n        throw new TypeError(`Unknown context relevance signal: ${signal}`);\n      }\n      if (value === undefined) continue;\n      if (!Number.isFinite(value) || value < 0 || value > 1) {\n        throw new TypeError(\n          `Context relevance signal ${signal} must be a finite number from 0 to 1`,\n        );\n      }\n    }\n  }\n}\n\nfunction resolveWeights(\n  overrides: Partial<Record<ContextRelevanceSignalName, number>> | undefined,\n): Record<ContextRelevanceSignalName, number> {\n  const weights = { ...DEFAULT_CONTEXT_RELEVANCE_WEIGHTS };\n  for (const [signal, weight] of Object.entries(overrides ?? {})) {\n    if (\n      weight !== undefined &&\n      CONTEXT_RELEVANCE_SIGNAL_NAMES.includes(\n        signal as ContextRelevanceSignalName,\n      )\n    ) {\n      weights[signal as ContextRelevanceSignalName] = weight;\n    }\n  }\n  for (const [signal, weight] of Object.entries(weights)) {\n    if (!Number.isFinite(weight) || weight < 0) {\n      throw new TypeError(\n        `Context relevance weight ${signal} must be a finite non-negative number`,\n      );\n    }\n  }\n  return weights;\n}\n\n/** Score candidates with pm's deterministic weighted model. Candidate order is the structural baseline and remains unchanged when no advanced signals exist. */\nexport function defaultScoreContextCandidates<TItem>(\n  candidates: readonly ContextRelevanceCandidate<TItem>[],\n  options: Pick<ScoreContextCandidatesOptions<TItem>, \"weights\"> = {},\n): ContextRelevanceReport<TItem> {\n  assertCandidates(candidates);\n  const weights = resolveWeights(options.weights);\n  const denominator = Math.max(candidates.length - 1, 1);\n  const available = new Set<ContextRelevanceSignalName>([\"structural\"]);\n  for (const candidate of candidates) {\n    for (const [signal, value] of Object.entries(candidate.signals ?? {})) {\n      if (value !== undefined)\n        available.add(signal as ContextRelevanceSignalName);\n    }\n  }\n  const availableSignals = CONTEXT_RELEVANCE_SIGNAL_NAMES.filter((signal) =>\n    available.has(signal),\n  );\n  const scored = candidates.map(\n    (candidate, index): RankedContextCandidate<TItem> => {\n      const signalValues: Partial<Record<ContextRelevanceSignalName, number>> =\n        {\n          structural: candidates.length === 1 ? 1 : 1 - index / denominator,\n          ...candidate.signals,\n        };\n      const contributions: ContextRelevanceContributions = {};\n      let weightedScore = 0;\n      let totalWeight = 0;\n      for (const signal of availableSignals) {\n        const value = signalValues[signal];\n        if (value === undefined) continue;\n        const contribution = value * weights[signal];\n        contributions[signal] = contribution;\n        weightedScore += contribution;\n        totalWeight += weights[signal];\n      }\n      return {\n        ...candidate,\n        baseline_rank: index + 1,\n        rank: 0,\n        score: totalWeight === 0 ? 0 : weightedScore / totalWeight,\n        contributions,\n      };\n    },\n  );\n  scored.sort(\n    (left, right) =>\n      right.score - left.score || left.baseline_rank - right.baseline_rank,\n  );\n  scored.forEach((entry, index) => {\n    entry.rank = index + 1;\n  });\n  return {\n    model: \"default-weighted-v1\",\n    available_signals: availableSignals,\n    ranked: scored,\n  };\n}\n\n/** Score candidates with the default model or a validated replacement/wrapper. */\nexport async function scoreContextCandidates<TItem>(\n  candidates: readonly ContextRelevanceCandidate<TItem>[],\n  options: ScoreContextCandidatesOptions<TItem> = {},\n): Promise<ContextRelevanceReport<TItem>> {\n  const defaultReport = defaultScoreContextCandidates(candidates, options);\n  if (!options.scorer) return defaultReport;\n  const customScores = await options.scorer({\n    candidates,\n    default_report: defaultReport,\n  });\n  const scoreById = new Map<string, number>();\n  for (const entry of customScores) {\n    if (scoreById.has(entry.id) || !Number.isFinite(entry.score)) {\n      throw new TypeError(\n        \"Context relevance scorer must return one finite score for every candidate\",\n      );\n    }\n    scoreById.set(entry.id, entry.score);\n  }\n  if (\n    scoreById.size !== candidates.length ||\n    candidates.some((candidate) => !scoreById.has(candidate.id))\n  ) {\n    throw new TypeError(\n      \"Context relevance scorer must return one finite score for every candidate\",\n    );\n  }\n  const ranked = defaultReport.ranked.map((entry) => {\n    const score = scoreById.get(entry.id) as number;\n    return { ...entry, score, contributions: { custom: score } };\n  });\n  ranked.sort(\n    (left, right) =>\n      right.score - left.score || left.baseline_rank - right.baseline_rank,\n  );\n  ranked.forEach((entry, index) => {\n    entry.rank = index + 1;\n  });\n  return {\n    model: \"custom\",\n    available_signals: defaultReport.available_signals,\n    ranked,\n  };\n}\n\n/** Score command candidates through the public default model and then the active governed `context_relevance` service override, when one is registered. */\nexport async function scoreContextCandidatesWithActiveExtensions<TItem>(\n  surface: ContextRelevanceSurface,\n  candidates: readonly ContextRelevanceCandidate<TItem>[],\n  options: Pick<ScoreContextCandidatesOptions<TItem>, \"weights\"> = {},\n): Promise<ContextRelevanceReport<TItem>> {\n  const defaultReport = defaultScoreContextCandidates(candidates, options);\n  const override = await runActiveServiceOverride(CONTEXT_RELEVANCE_SERVICE, {\n    surface,\n    candidates,\n    default_report: defaultReport,\n  });\n  if (!override.handled) {\n    return override.warnings.length > 0\n      ? { ...defaultReport, warnings: override.warnings }\n      : defaultReport;\n  }\n  if (\n    !Array.isArray(override.result) ||\n    !override.result.every(\n      (entry) =>\n        typeof entry === \"object\" &&\n        entry !== null &&\n        typeof (entry as { id?: unknown }).id === \"string\" &&\n        typeof (entry as { score?: unknown }).score === \"number\" &&\n        Number.isFinite((entry as { score: number }).score),\n    )\n  ) {\n    return {\n      ...defaultReport,\n      warnings: [\n        ...override.warnings,\n        \"extension_context_relevance_invalid_result\",\n      ],\n    };\n  }\n  try {\n    const report = await scoreContextCandidates(candidates, {\n      ...options,\n      scorer: () => override.result as ContextRelevanceCustomScore[],\n    });\n    return override.warnings.length > 0\n      ? { ...report, warnings: override.warnings }\n      : report;\n  } catch {\n    return {\n      ...defaultReport,\n      warnings: [\n        ...override.warnings,\n        \"extension_context_relevance_invalid_result\",\n      ],\n    };\n  }\n}\n\n/** Input for rank-aware context/next quality evaluation. */\nexport interface ContextRankingEvaluationInput {\n  /** Value that configures or reports ranked ids for this contract. */\n  ranked_ids: string[];\n  /** Value that configures or reports judgments for this contract. */\n  judgments: Record<string, number>;\n  /** Value that configures or reports required ids for this contract. */\n  required_ids?: string[];\n  /** Value that configures or reports continuity ids for this contract. */\n  continuity_ids?: string[];\n  /** Value that configures or reports actual tokens for this contract. */\n  actual_tokens: number;\n  /** Value that configures or reports token budget for this contract. */\n  token_budget: number;\n}\n\n/** Rank-quality, continuity, recall, and token-budget metrics for one scenario. */\nexport interface ContextRankingEvaluation {\n  /** Value that configures or reports ndcg for this contract. */\n  ndcg: number;\n  /** Value that configures or reports reciprocal rank for this contract. */\n  reciprocal_rank: number;\n  /** Value that configures or reports required recall for this contract. */\n  required_recall: number;\n  /** Value that configures or reports continuity coverage for this contract. */\n  continuity_coverage: number;\n  /** Value that configures or reports token budget adherence for this contract. */\n  token_budget_adherence: number;\n  /** Value that configures or reports within token budget for this contract. */\n  within_token_budget: boolean;\n}\n\n/** Flexible read options accepted by context evaluation scenarios. */\nexport interface ContextEvaluationReadOptions {\n  /** Value that configures or reports explain ranking for this contract. */\n  explainRanking?: boolean;\n  [key: string]: unknown;\n}\n\n/** Minimal item identity consumed by the context evaluation runner. */\nexport interface ContextEvaluationResultItem {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n}\n\n/** Optional scorer attribution returned by an evaluated read primitive. */\nexport interface ContextEvaluationResultRanking {\n  /** Value that configures or reports items for this contract. */\n  items?: Array<{ id: string; contributions: ContextRelevanceContributions }>;\n}\n\n/** Structural context result consumed by the evaluation runner. */\nexport interface ContextEvaluationContextResult {\n  /** Value that configures or reports high level for this contract. */\n  high_level?: ContextEvaluationResultItem[];\n  /** Value that configures or reports low level for this contract. */\n  low_level?: ContextEvaluationResultItem[];\n  /** Value that configures or reports blocked fallback for this contract. */\n  blocked_fallback?: ContextEvaluationResultItem[];\n  /** Value that configures or reports ranking for this contract. */\n  ranking?: ContextEvaluationResultRanking;\n  [key: string]: unknown;\n}\n\n/** Structural next result consumed by the evaluation runner. */\nexport interface ContextEvaluationNextResult {\n  /** Value that configures or reports recommended for this contract. */\n  recommended?: ContextEvaluationResultItem | null;\n  /** Value that configures or reports ready for this contract. */\n  ready?: ContextEvaluationResultItem[];\n  /** Value that configures or reports ranking for this contract. */\n  ranking?: ContextEvaluationResultRanking;\n  [key: string]: unknown;\n}\n\n/** Read-only SDK surface required by the context evaluation runner. */\nexport interface ContextEvaluationReader {\n  /** Value that configures or reports context for this contract. */\n  context(\n    options?: ContextEvaluationReadOptions,\n  ): Promise<ContextEvaluationContextResult>;\n  /** Value that configures or reports next for this contract. */\n  next(\n    options?: ContextEvaluationReadOptions,\n  ): Promise<ContextEvaluationNextResult>;\n}\n\n/** One graded context or next scenario evaluated against a real SDK reader. */\nexport interface ContextEvaluationScenario {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports surface for this contract. */\n  surface: ContextRelevanceSurface;\n  /** Value that configures or reports options for this contract. */\n  options?: ContextEvaluationReadOptions;\n  /** Value that configures or reports judgments for this contract. */\n  judgments: Record<string, number>;\n  /** Value that configures or reports required ids for this contract. */\n  required_ids?: string[];\n  /** Value that configures or reports continuity ids for this contract. */\n  continuity_ids?: string[];\n  /** Value that configures or reports token budget for this contract. */\n  token_budget: number;\n  /** Value that configures or reports rationale for this contract. */\n  rationale: string;\n}\n\n/** Per-item signal attribution retained by a context evaluation report. */\nexport interface ContextEvaluationAttribution {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports contributions for this contract. */\n  contributions: ContextRelevanceContributions;\n}\n\n/** Result of executing and grading one context evaluation scenario. */\nexport interface ContextEvaluationScenarioReport {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports surface for this contract. */\n  surface: ContextRelevanceSurface;\n  /** Value that configures or reports rationale for this contract. */\n  rationale: string;\n  /** Value that configures or reports ranked ids for this contract. */\n  ranked_ids: string[];\n  /** Value that configures or reports actual tokens for this contract. */\n  actual_tokens: number;\n  /** Value that configures or reports metrics for this contract. */\n  metrics: ContextRankingEvaluation;\n  /** Value that configures or reports attribution for this contract. */\n  attribution: ContextEvaluationAttribution[];\n}\n\n/** Minimum acceptable aggregate metrics for a context evaluation corpus. */\nexport interface ContextEvaluationThresholds {\n  /** Value that configures or reports ndcg for this contract. */\n  ndcg: number;\n  /** Value that configures or reports reciprocal rank for this contract. */\n  reciprocal_rank: number;\n  /** Value that configures or reports required recall for this contract. */\n  required_recall: number;\n  /** Value that configures or reports continuity coverage for this contract. */\n  continuity_coverage: number;\n  /** Value that configures or reports token budget adherence for this contract. */\n  token_budget_adherence: number;\n}\n\n/** Canonical aggregate metrics required by every context evaluation corpus. */\nexport const CONTEXT_EVALUATION_METRIC_NAMES = [\n  \"ndcg\",\n  \"reciprocal_rank\",\n  \"required_recall\",\n  \"continuity_coverage\",\n  \"token_budget_adherence\",\n] as const satisfies readonly (keyof ContextEvaluationThresholds)[];\n\n/** Aggregate context evaluation report suitable for a CI quality gate. */\nexport interface ContextEvaluationCorpusReport {\n  /** Number of scenario entries represented by this result. */\n  scenario_count: number;\n  /** Value that configures or reports aggregate for this contract. */\n  aggregate: ContextEvaluationThresholds;\n  /** Value that configures or reports scenarios for this contract. */\n  scenarios: ContextEvaluationScenarioReport[];\n  /** Value that configures or reports passed for this contract. */\n  passed: boolean;\n  /** Value that configures or reports failures for this contract. */\n  failures: string[];\n}\n\nfunction ratioOfPresent(\n  expected: readonly string[],\n  actual: ReadonlySet<string>,\n): number {\n  if (expected.length === 0) return 1;\n  return expected.filter((id) => actual.has(id)).length / expected.length;\n}\n\n/** Evaluate one ranked context packet against graded human judgments. */\nexport function evaluateContextRanking(\n  input: ContextRankingEvaluationInput,\n): ContextRankingEvaluation {\n  if (\n    !Number.isFinite(input.actual_tokens) ||\n    input.actual_tokens < 0 ||\n    !Number.isFinite(input.token_budget) ||\n    input.token_budget <= 0\n  ) {\n    throw new TypeError(\n      \"Context ranking token counts require actual_tokens >= 0 and token_budget > 0\",\n    );\n  }\n  const judgments = input.judgments ?? {};\n  const gains = input.ranked_ids.map((id) => Math.max(0, judgments[id] ?? 0));\n  const idealGains = Object.values(judgments)\n    .map((grade) => Math.max(0, grade))\n    .sort((left, right) => right - left)\n    .slice(0, gains.length || 1);\n  const discountedGain = (values: readonly number[]) =>\n    values.reduce(\n      (total, grade, index) => total + (2 ** grade - 1) / Math.log2(index + 2),\n      0,\n    );\n  const ideal = discountedGain(idealGains);\n  const firstRelevant = gains.findIndex((grade) => grade > 0);\n  const actualIds = new Set(input.ranked_ids);\n  const withinBudget = input.actual_tokens <= input.token_budget;\n  return {\n    ndcg: ideal === 0 ? 1 : discountedGain(gains) / ideal,\n    reciprocal_rank: firstRelevant < 0 ? 0 : 1 / (firstRelevant + 1),\n    required_recall: ratioOfPresent(input.required_ids ?? [], actualIds),\n    continuity_coverage: ratioOfPresent(input.continuity_ids ?? [], actualIds),\n    token_budget_adherence: withinBudget\n      ? 1\n      : input.token_budget / input.actual_tokens,\n    within_token_budget: withinBudget,\n  };\n}\n\nfunction estimateJsonTokens(value: unknown): number {\n  return Math.ceil(\n    JSON_TOKEN_ENCODER.encode(JSON.stringify(value)).byteLength / 4,\n  );\n}\n\nfunction roundEvaluationMetric(value: number): number {\n  return Math.round(value * 10_000) / 10_000;\n}\n\nfunction rankingPayloadForScenario(\n  result: ContextEvaluationContextResult | ContextEvaluationNextResult,\n  surface: ContextRelevanceSurface,\n): { rankedIds: string[]; attribution: ContextEvaluationAttribution[] } {\n  const rankedIds =\n    surface === \"context\"\n      ? [\n          ...((result as ContextEvaluationContextResult).high_level ?? []),\n          ...((result as ContextEvaluationContextResult).low_level ?? []),\n          ...((result as ContextEvaluationContextResult).blocked_fallback ??\n            []),\n        ].map((item) => item.id)\n      : [\n          ...((result as ContextEvaluationNextResult).recommended\n            ? [\n                (result as ContextEvaluationNextResult)\n                  .recommended as ContextEvaluationResultItem,\n              ]\n            : []),\n          ...((result as ContextEvaluationNextResult).ready ?? []),\n        ].map((item) => item.id);\n  const servedIds = new Set(rankedIds);\n  const attribution = (result.ranking?.items ?? [])\n    .filter((item) => servedIds.has(item.id))\n    .map((item) => ({ id: item.id, contributions: item.contributions }));\n  return { rankedIds, attribution };\n}\n\n/** Execute one graded scenario through public SDK context/next read primitives. */\nexport async function runContextEvaluationScenario(\n  scenario: ContextEvaluationScenario,\n  reader: ContextEvaluationReader,\n): Promise<ContextEvaluationScenarioReport> {\n  if (\n    scenario.id.trim().length === 0 ||\n    scenario.rationale.trim().length === 0\n  ) {\n    throw new TypeError(\n      \"Context evaluation scenarios require non-empty id and rationale values\",\n    );\n  }\n  const result =\n    scenario.surface === \"context\"\n      ? await reader.context({ ...scenario.options, explainRanking: true })\n      : await reader.next({ ...scenario.options, explainRanking: true });\n  const { rankedIds, attribution } = rankingPayloadForScenario(\n    result,\n    scenario.surface,\n  );\n  const packet = { ...result, ranking: undefined };\n  const actualTokens = estimateJsonTokens(packet);\n  return {\n    id: scenario.id,\n    surface: scenario.surface,\n    rationale: scenario.rationale,\n    ranked_ids: rankedIds,\n    actual_tokens: actualTokens,\n    metrics: evaluateContextRanking({\n      ranked_ids: rankedIds,\n      judgments: scenario.judgments,\n      required_ids: scenario.required_ids,\n      continuity_ids: scenario.continuity_ids,\n      actual_tokens: actualTokens,\n      token_budget: scenario.token_budget,\n    }),\n    attribution,\n  };\n}\n\n/** Aggregate scenario reports and evaluate every metric against explicit thresholds. */\nexport function summarizeContextEvaluationReports(\n  reports: readonly ContextEvaluationScenarioReport[],\n  thresholds: ContextEvaluationThresholds,\n): ContextEvaluationCorpusReport {\n  if (reports.length === 0) {\n    throw new TypeError(\n      \"Context evaluation requires at least one scenario report\",\n    );\n  }\n  const metrics = CONTEXT_EVALUATION_METRIC_NAMES;\n  for (const metric of metrics) {\n    if (!Number.isFinite(thresholds[metric])) {\n      throw new TypeError(\n        `Context evaluation threshold ${metric} must be a finite number`,\n      );\n    }\n  }\n  const aggregate = Object.fromEntries(\n    metrics.map((metric) => [\n      metric,\n      roundEvaluationMetric(\n        reports.reduce((total, report) => total + report.metrics[metric], 0) /\n          reports.length,\n      ),\n    ]),\n  ) as unknown as ContextEvaluationThresholds;\n  const failures = metrics\n    .filter((metric) => aggregate[metric] < thresholds[metric])\n    .map((metric) => `${metric}:${aggregate[metric]}<${thresholds[metric]}`);\n  return {\n    scenario_count: reports.length,\n    aggregate,\n    scenarios: [...reports],\n    passed: failures.length === 0,\n    failures,\n  };\n}\n\n/** Execute a same-workspace scenario corpus through public SDK read primitives. */\nexport async function runContextEvaluationCorpus(\n  scenarios: readonly ContextEvaluationScenario[],\n  reader: ContextEvaluationReader,\n  thresholds: ContextEvaluationThresholds,\n): Promise<ContextEvaluationCorpusReport> {\n  const reports: ContextEvaluationScenarioReport[] = [];\n  for (const scenario of scenarios) {\n    reports.push(await runContextEvaluationScenario(scenario, reader));\n  }\n  return summarizeContextEvaluationReports(reports, thresholds);\n}\n"],"names":[],"mappings":"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","debugId":"be8706fa-86f8-576a-9e39-475b9681600c"}

package/dist/sdk/context-signal-store.d.ts

@@ -0,0 +1,77 @@
+import { type BuildItemContextRelevanceCandidatesOptions, type ContextRelevanceCandidate, type ContextRelevanceSignals } from "./context-relevance.js";
+import type { ItemMetadata } from "../types/index.js";
+/** Current serialized feature-store envelope version. */
+export declare const CONTEXT_SIGNAL_STORE_FORMAT_VERSION = 1;
+/** Current canonical signal-vector version. */
+export declare const CONTEXT_SIGNAL_SET_VERSION = 1;
+/** Authoritative substrate used to derive one snapshot. */
+export type ContextSignalSnapshotSource = "derived_index" | "scan_fallback";
+/** One immutable item signal row. */
+export interface ContextSignalSnapshotItem {
+    /** Stable item identifier. */
+    id: string;
+    /** Canonical normalized signal vector. */
+    signals: ContextRelevanceSignals;
+}
+/** Rebuildable, deterministic context-signal snapshot. */
+export interface ContextSignalSnapshot {
+    /** Serialized envelope version. */
+    format_version: number;
+    /** Signal algorithm version. */
+    signal_set_version: number;
+    /** Authoritative history or derived-index cursor folded into this snapshot. */
+    source_cursor: string;
+    /** Stable clock supplied by the caller. */
+    generated_at: string;
+    /** Read substrate used for the fold. */
+    source: ContextSignalSnapshotSource;
+    /** Item rows sorted by canonical id. */
+    items: readonly ContextSignalSnapshotItem[];
+}
+/** Pluggable persistence boundary for context-signal snapshots. */
+export interface ContextSignalStoreAdapter {
+    /** Read the serialized snapshot, or null when none exists. */
+    read(): Promise<unknown | null>;
+    /** Atomically replace the serialized snapshot. */
+    write(snapshot: ContextSignalSnapshot): Promise<void>;
+}
+/** Options required to fold authoritative items into a snapshot. */
+export interface BuildContextSignalSnapshotOptions extends BuildItemContextRelevanceCandidatesOptions {
+    /** Authoritative history or derived-index cursor. */
+    sourceCursor: string;
+    /** Substrate used to load the authoritative items. */
+    source: ContextSignalSnapshotSource;
+}
+/** Result of a feature-store read with explicit degradation metadata. */
+export interface ContextSignalStoreReadResult {
+    /** Valid snapshot used for candidate assembly. */
+    snapshot: ContextSignalSnapshot;
+    /** Candidates joined to the caller's authoritative item objects. */
+    candidates: ContextRelevanceCandidate<ItemMetadata>[];
+    /** Whether the persisted snapshot was reused or rebuilt. */
+    cache_status: "fresh" | "rebuilt";
+    /** Non-fatal recovery diagnostics. */
+    warnings: readonly string[];
+}
+/** Validate an untrusted serialized snapshot without accepting partial envelopes. */
+export declare function parseContextSignalSnapshot(value: unknown): ContextSignalSnapshot | null;
+/** Fold authoritative items into a deterministic, immutable signal snapshot. */
+export declare function buildContextSignalSnapshot(items: readonly ItemMetadata[], options: BuildContextSignalSnapshotOptions): ContextSignalSnapshot;
+/** Filesystem adapter using same-directory atomic replacement. */
+export declare class JsonFileContextSignalStoreAdapter implements ContextSignalStoreAdapter {
+    private readonly filePath;
+    /** Create an adapter for an explicit derived-state file path. */
+    constructor(filePath: string);
+    /** Read and decode the JSON snapshot, returning null when it does not exist. */
+    read(): Promise<unknown | null>;
+    /** Write a complete snapshot through a unique same-directory temporary file. */
+    write(snapshot: ContextSignalSnapshot): Promise<void>;
+}
+/** Cursor-aware feature store that self-heals from absent, stale, or corrupt state. */
+export declare class ContextSignalStore {
+    private readonly adapter;
+    /** Bind the store to a caller-selected persistence adapter. */
+    constructor(adapter: ContextSignalStoreAdapter);
+    /** Read matching signals or rebuild them from authoritative items. */
+    readOrRebuild(items: readonly ItemMetadata[], options: BuildContextSignalSnapshotOptions): Promise<ContextSignalStoreReadResult>;
+}

package/dist/sdk/context-signal-store.js

@@ -0,0 +1,201 @@
+/**
+ * @module sdk/context-signal-store
+ *
+ * Rebuildable, cursor-stamped feature-store primitives for context relevance.
+ * Snapshots are derived read artifacts: callers retain authoritative items and
+ * history, while stale, absent, or corrupt snapshots rebuild transparently.
+ */
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="26f26fe2-7795-5447-8a43-6d86f5da0e73")}catch(e){}}();
+import fs from "node:fs/promises";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { buildItemContextRelevanceCandidates, CONTEXT_RELEVANCE_SIGNAL_NAMES, } from "./context-relevance.js";
+/** Current serialized feature-store envelope version. */
+export const CONTEXT_SIGNAL_STORE_FORMAT_VERSION = 1;
+/** Current canonical signal-vector version. */
+export const CONTEXT_SIGNAL_SET_VERSION = 1;
+const STORED_CONTEXT_SIGNAL_NAMES = CONTEXT_RELEVANCE_SIGNAL_NAMES.slice(1);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNormalizedSignal(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 && value <= 1;
+}
+function compactSignals(signals) {
+    const compact = {};
+    for (const name of STORED_CONTEXT_SIGNAL_NAMES) {
+        const value = signals[name];
+        if (value === undefined)
+            continue;
+        if (!isNormalizedSignal(value)) {
+            throw new TypeError(`Context relevance signal ${name} must be a finite number from 0 to 1`);
+        }
+        compact[name] = value;
+    }
+    return compact;
+}
+function parseSnapshotItem(value) {
+    if (!isRecord(value) || typeof value.id !== "string" || !isRecord(value.signals)) {
+        return null;
+    }
+    const signals = {};
+    const supportedSignals = new Set(STORED_CONTEXT_SIGNAL_NAMES);
+    for (const [name, signal] of Object.entries(value.signals)) {
+        if (!supportedSignals.has(name) || !isNormalizedSignal(signal)) {
+            return null;
+        }
+        signals[name] = signal;
+    }
+    return { id: value.id, signals: signals };
+}
+/** Validate an untrusted serialized snapshot without accepting partial envelopes. */
+export function parseContextSignalSnapshot(value) {
+    if (!isRecord(value) ||
+        value.format_version !== CONTEXT_SIGNAL_STORE_FORMAT_VERSION ||
+        value.signal_set_version !== CONTEXT_SIGNAL_SET_VERSION ||
+        typeof value.source_cursor !== "string" ||
+        value.source_cursor.trim().length === 0 ||
+        typeof value.generated_at !== "string" ||
+        !Number.isFinite(Date.parse(value.generated_at)) ||
+        (value.source !== "derived_index" && value.source !== "scan_fallback") ||
+        !Array.isArray(value.items)) {
+        return null;
+    }
+    const items = value.items.map(parseSnapshotItem);
+    if (items.some((item) => item === null)) {
+        return null;
+    }
+    const validItems = items;
+    if (new Set(validItems.map((item) => item.id)).size !== validItems.length ||
+        validItems.some((item) => item.id.trim().length === 0)) {
+        return null;
+    }
+    return {
+        format_version: CONTEXT_SIGNAL_STORE_FORMAT_VERSION,
+        signal_set_version: CONTEXT_SIGNAL_SET_VERSION,
+        source_cursor: value.source_cursor,
+        generated_at: value.generated_at,
+        source: value.source,
+        items: validItems.sort((left, right) => left.id.localeCompare(right.id)),
+    };
+}
+/** Fold authoritative items into a deterministic, immutable signal snapshot. */
+export function buildContextSignalSnapshot(items, options) {
+    if (typeof options.sourceCursor !== "string" || options.sourceCursor.trim().length === 0) {
+        throw new TypeError("Context signal source cursor must be non-empty");
+    }
+    if (!Number.isFinite(Date.parse(options.now))) {
+        throw new TypeError("Context signal snapshot clock must be a valid timestamp");
+    }
+    const rows = buildItemContextRelevanceCandidates(items, options)
+        .map(({ id, signals }) => ({
+        id,
+        signals: compactSignals(signals),
+    }))
+        .sort((left, right) => left.id.localeCompare(right.id));
+    return Object.freeze({
+        format_version: CONTEXT_SIGNAL_STORE_FORMAT_VERSION,
+        signal_set_version: CONTEXT_SIGNAL_SET_VERSION,
+        source_cursor: options.sourceCursor,
+        generated_at: options.now,
+        source: options.source,
+        items: Object.freeze(rows.map((row) => Object.freeze(row))),
+    });
+}
+/** Filesystem adapter using same-directory atomic replacement. */
+export class JsonFileContextSignalStoreAdapter {
+    filePath;
+    /** Create an adapter for an explicit derived-state file path. */
+    constructor(filePath) {
+        if (typeof filePath !== "string" || filePath.trim().length === 0) {
+            throw new TypeError("Context signal store path must be non-empty");
+        }
+        this.filePath = path.resolve(filePath);
+    }
+    /** Read and decode the JSON snapshot, returning null when it does not exist. */
+    async read() {
+        try {
+            return JSON.parse(await fs.readFile(this.filePath, "utf8"));
+        }
+        catch (error) {
+            if (isRecord(error) && error.code === "ENOENT") {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /** Write a complete snapshot through a unique same-directory temporary file. */
+    async write(snapshot) {
+        const directory = path.dirname(this.filePath);
+        await fs.mkdir(directory, { recursive: true });
+        const temporaryPath = path.join(directory, `.${path.basename(this.filePath)}.${randomUUID()}.tmp`);
+        try {
+            await fs.writeFile(temporaryPath, `${JSON.stringify(snapshot)}\n`, { encoding: "utf8", flag: "wx" });
+            await fs.rename(temporaryPath, this.filePath);
+        }
+        finally {
+            try {
+                await fs.rm(temporaryPath, { force: true });
+            }
+            catch {
+                // The complete snapshot is already committed; temporary-file cleanup is best effort.
+            }
+        }
+    }
+}
+/** Cursor-aware feature store that self-heals from absent, stale, or corrupt state. */
+export class ContextSignalStore {
+    adapter;
+    /** Bind the store to a caller-selected persistence adapter. */
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    /** Read matching signals or rebuild them from authoritative items. */
+    async readOrRebuild(items, options) {
+        const warnings = [];
+        let snapshot = null;
+        try {
+            const serialized = await this.adapter.read();
+            snapshot = parseContextSignalSnapshot(serialized);
+            if (serialized !== null && snapshot === null) {
+                warnings.push("context_signal_store_invalid");
+            }
+        }
+        catch {
+            warnings.push("context_signal_store_invalid");
+        }
+        const authoritativeIds = items.map((item) => item.id).sort((left, right) => left.localeCompare(right));
+        const snapshotIds = snapshot?.items.map((item) => item.id) ?? [];
+        const fresh = snapshot !== null &&
+            snapshot.source_cursor === options.sourceCursor &&
+            snapshot.source === options.source &&
+            snapshotIds.length === authoritativeIds.length &&
+            snapshotIds.every((id, index) => id === authoritativeIds[index]);
+        let resolvedSnapshot;
+        if (fresh && snapshot !== null) {
+            resolvedSnapshot = snapshot;
+        }
+        else {
+            if (snapshot !== null) {
+                warnings.push("context_signal_store_stale");
+            }
+            resolvedSnapshot = buildContextSignalSnapshot(items, options);
+            try {
+                await this.adapter.write(resolvedSnapshot);
+            }
+            catch {
+                warnings.push("context_signal_store_write_failed");
+            }
+        }
+        const signalsById = new Map(resolvedSnapshot.items.map((item) => [item.id, item.signals]));
+        return {
+            snapshot: resolvedSnapshot,
+            candidates: items.map((item) => ({ id: item.id, item, signals: signalsById.get(item.id) })),
+            cache_status: fresh ? "fresh" : "rebuilt",
+            warnings,
+        };
+    }
+}
+//# sourceMappingURL=context-signal-store.js.map
+//# debugId=26f26fe2-7795-5447-8a43-6d86f5da0e73