@unbrained/pm-cli 2026.7.6 → 2026.7.8

package/dist/core/history/drift-scan.js

@@ -1,11 +1,6 @@
-/**
- * @module core/history/drift-scan
- *
- * Implements append-only history and replay behavior for Drift Scan.
- */
 
-!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]="91c6995a-7219-5402-b2d4-e50227bf0149")}catch(e){}}();
-import fs from "fs/promises";
+!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]="20ed642a-081f-55bd-9bbe-840b1a1bd3b5")}catch(e){}}();
+import fs from "node:fs/promises";
 import { createHash } from "node:crypto";
 import path from "node:path";
 import { getHistoryPath } from "../store/paths.js";
@@ -224,4 +219,4 @@ export async function scanHistoryDrift(pmRoot, items, options = {}) {
     return { ...accumulator, driftedItems };
 }
 //# sourceMappingURL=drift-scan.js.map
-//# debugId=91c6995a-7219-5402-b2d4-e50227bf0149
+//# debugId=20ed642a-081f-55bd-9bbe-840b1a1bd3b5

package/dist/core/history/drift-scan.js.map

@@ -1 +1 @@
-{"version":3,"file":"drift-scan.js","sources":["core/history/drift-scan.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/history/drift-scan\n *\n * Implements append-only history and replay behavior for Drift Scan.\n */\nimport fs from \"fs/promises\";\nimport { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport { getHistoryPath } from \"../store/paths.js\";\nimport { writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { hashDocument } from \"./history.js\";\nimport { verifyHistoryChain } from \"./replay.js\";\nimport type { HistoryEntry, ItemMetadata } from \"../../types/index.js\";\n\n/**\n * Documents the drift scan result payload exchanged by command, SDK, and package integrations.\n */\nexport interface DriftScanResult {\n  missingStreams: string[];\n  unreadableStreams: string[];\n  hashMismatches: string[];\n  chainMismatches: string[];\n  driftedItems: string[];\n}\n\nconst DRIFT_CACHE_VERSION = 3;\nconst DRIFT_CACHE_FILENAME = \"history-drift-cache.json\";\n\n/**\n * Controls how cached history stream verification is trusted when the file stat\n * tuple still matches a previous scan.\n */\nexport type DriftCacheHitVerification = \"content_hash\" | \"metadata\";\n\n/**\n * Documents the history drift scan options shared by health, validate, and\n * repair callers.\n */\nexport interface DriftScanOptions {\n  cacheHitVerification?: DriftCacheHitVerification;\n}\n\ninterface DriftCacheEntry {\n  mtime_ms: number;\n  ctime_ms: number;\n  size: number;\n  content_hash: string;\n  latest_after_hash: string;\n  chain_ok: boolean;\n}\n\ninterface DriftCacheEnvelope {\n  version: number;\n  entries: Record<string, DriftCacheEntry>;\n}\n\nfunction getDriftCachePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\", DRIFT_CACHE_FILENAME);\n}\n\nasync function loadDriftCache(pmRoot: string): Promise<DriftCacheEnvelope | null> {\n  try {\n    const raw = await fs.readFile(getDriftCachePath(pmRoot), \"utf8\");\n    const parsed = JSON.parse(raw) as DriftCacheEnvelope;\n    if (parsed.version !== DRIFT_CACHE_VERSION || typeof parsed.entries !== \"object\" || parsed.entries === null) {\n      return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === code;\n}\n\ninterface StreamVerification {\n  latestAfterHash: string;\n  chainOk: boolean;\n  contentHash: string;\n}\n\ninterface DriftScanAccumulator {\n  missingStreams: string[];\n  unreadableStreams: string[];\n  hashMismatches: string[];\n  chainMismatches: string[];\n}\n\nfunction hashContent(raw: string): string {\n  return createHash(\"sha256\").update(raw).digest(\"hex\");\n}\n\nasync function readHistoryContentHash(historyPath: string): Promise<string> {\n  const raw = await fs.readFile(historyPath, \"utf8\");\n  return hashContent(raw);\n}\n\n/**\n * Read and fully verify one history stream's hash chain. Returns null for an\n * empty/missing stream (caller records it as a missing stream).\n */\nasync function verifyHistoryStream(historyPath: string): Promise<StreamVerification | null> {\n  const raw = await fs.readFile(historyPath, \"utf8\");\n  const contentHash = hashContent(raw);\n  if (raw.trim().length === 0) {\n    return null;\n  }\n  const entries: HistoryEntry[] = [];\n  let latestAfterHash: string | null = null;\n  for (const line of raw.split(/\\r?\\n/)) {\n    const trimmed = line.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    const parsed = JSON.parse(trimmed) as HistoryEntry;\n    if (typeof parsed.after_hash !== \"string\" || parsed.after_hash.trim().length === 0) {\n      throw new Error(\"missing after_hash\");\n    }\n    entries.push(parsed);\n    latestAfterHash = parsed.after_hash;\n  }\n  /* c8 ignore start -- defensive guard for future history schema changes. */\n  if (!latestAfterHash) {\n    return null;\n  }\n  /* c8 ignore stop */\n  return {\n    latestAfterHash,\n    chainOk: verifyHistoryChain(entries).ok,\n    contentHash,\n  };\n}\n\nfunction cacheMetadataMatches(cached: DriftCacheEntry | undefined, stat: Awaited<ReturnType<typeof fs.stat>>): boolean {\n  return cached !== undefined && cached.mtime_ms === stat.mtimeMs && cached.ctime_ms === stat.ctimeMs && cached.size === stat.size;\n}\n\nasync function loadFreshStreamVerification(\n  itemId: string,\n  historyPath: string,\n  accumulator: DriftScanAccumulator,\n): Promise<StreamVerification | null> {\n  try {\n    const loaded = await verifyHistoryStream(historyPath);\n    if (!loaded) {\n      accumulator.missingStreams.push(itemId);\n      return null;\n    }\n    return loaded;\n  } catch {\n    accumulator.unreadableStreams.push(itemId);\n    return null;\n  }\n}\n\nasync function resolveStreamVerification(params: {\n  itemId: string;\n  historyPath: string;\n  stat: Awaited<ReturnType<typeof fs.stat>>;\n  cached: DriftCacheEntry | undefined;\n  verifyCacheHitByContent: boolean;\n  accumulator: DriftScanAccumulator;\n}): Promise<{ verification: StreamVerification | null; cacheDirty: boolean }> {\n  const cachedContentHash =\n    typeof params.cached?.content_hash === \"string\" && params.cached.content_hash.length > 0\n      ? params.cached.content_hash\n      : undefined;\n  const canUseCache = cacheMetadataMatches(params.cached, params.stat) && cachedContentHash !== undefined && params.cached !== undefined;\n  if (!canUseCache || !params.cached) {\n    return {\n      verification: await loadFreshStreamVerification(params.itemId, params.historyPath, params.accumulator),\n      cacheDirty: true,\n    };\n  }\n  let currentContentHash: string;\n  if (params.verifyCacheHitByContent) {\n    try {\n      currentContentHash = await readHistoryContentHash(params.historyPath);\n    } catch {\n      params.accumulator.unreadableStreams.push(params.itemId);\n      return { verification: null, cacheDirty: false };\n    }\n  } else {\n    currentContentHash = cachedContentHash;\n  }\n  if (!params.verifyCacheHitByContent || currentContentHash === cachedContentHash) {\n    return {\n      verification: {\n        latestAfterHash: params.cached.latest_after_hash,\n        chainOk: params.cached.chain_ok,\n        contentHash: currentContentHash,\n      },\n      cacheDirty: false,\n    };\n  }\n  return {\n    verification: await loadFreshStreamVerification(params.itemId, params.historyPath, params.accumulator),\n    cacheDirty: true,\n  };\n}\n\n/**\n * Scan every item's history stream for drift (missing/unreadable streams, broken\n * hash chains, and item/history hash mismatches).\n *\n * Full chain re-verification of a large history tree is the dominant cost of\n * `pm health`. We cache the per-stream verification keyed by the history file's\n * mtime/ctime/size plus content hash. Strict callers keep recomputing the\n * content hash on metadata hits; latency-sensitive health checks can opt into\n * trusting the stat tuple and skip rereading unchanged streams.\n */\nexport async function scanHistoryDrift(\n  pmRoot: string,\n  items: Array<ItemMetadata & { body: string }>,\n  options: DriftScanOptions = {},\n): Promise<DriftScanResult> {\n  const accumulator: DriftScanAccumulator = {\n    missingStreams: [],\n    unreadableStreams: [],\n    hashMismatches: [],\n    chainMismatches: [],\n  };\n\n  const cache = await loadDriftCache(pmRoot);\n  const previousEntries: Record<string, DriftCacheEntry> = cache?.entries ?? {};\n  const nextEntries: Record<string, DriftCacheEntry> = {};\n  let cacheDirty = false;\n  // Metadata mode does not open a stat-matched stream, so unreadable-after-stat\n  // failures are intentionally deferred to strict validate/history-repair scans.\n  const verifyCacheHitByContent = options.cacheHitVerification !== \"metadata\";\n\n  for (const item of items) {\n    const historyPath = getHistoryPath(pmRoot, item.id);\n\n    let stat: Awaited<ReturnType<typeof fs.stat>>;\n    try {\n      stat = await fs.stat(historyPath);\n    } catch (error: unknown) {\n      if (isErrno(error, \"ENOENT\")) {\n        accumulator.missingStreams.push(item.id);\n      } else {\n        accumulator.unreadableStreams.push(item.id);\n      }\n      continue;\n    }\n\n    const cached = previousEntries[item.id];\n    const resolved = await resolveStreamVerification({\n      itemId: item.id,\n      historyPath,\n      stat,\n      cached,\n      verifyCacheHitByContent,\n      accumulator,\n    });\n    cacheDirty ||= resolved.cacheDirty;\n    if (!resolved.verification) {\n      continue;\n    }\n\n    if (!resolved.verification.chainOk) {\n      accumulator.chainMismatches.push(item.id);\n    }\n    nextEntries[item.id] = {\n      mtime_ms: stat.mtimeMs,\n      ctime_ms: stat.ctimeMs,\n      size: stat.size,\n      content_hash: resolved.verification.contentHash,\n      latest_after_hash: resolved.verification.latestAfterHash,\n      chain_ok: resolved.verification.chainOk,\n    };\n\n    const { body, ...frontMatter } = item;\n    const currentHash = hashDocument({\n      metadata: frontMatter as ItemMetadata,\n      body,\n    });\n    if (currentHash !== resolved.verification.latestAfterHash) {\n      accumulator.hashMismatches.push(item.id);\n    }\n  }\n\n  if (cacheDirty || Object.keys(previousEntries).length !== Object.keys(nextEntries).length) {\n    const cachePath = getDriftCachePath(pmRoot);\n    try {\n      await fs.mkdir(path.dirname(cachePath), { recursive: true });\n      await writeFileAtomic(cachePath, JSON.stringify({ version: DRIFT_CACHE_VERSION, entries: nextEntries }));\n    } catch {\n      // Best-effort cache write: a failed persist must never fail a health scan.\n    }\n  }\n\n  const driftedItems = [\n    ...new Set([\n      ...accumulator.missingStreams,\n      ...accumulator.unreadableStreams,\n      ...accumulator.hashMismatches,\n      ...accumulator.chainMismatches,\n    ]),\n  ].sort((a, b) => a.localeCompare(b));\n  return { ...accumulator, driftedItems };\n}\n"],"names":[],"mappings":"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","debugId":"91c6995a-7219-5402-b2d4-e50227bf0149"}
+{"version":3,"file":"drift-scan.js","sources":["core/history/drift-scan.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/history/drift-scan\n *\n * Implements append-only history and replay behavior for Drift Scan.\n */\nimport type { Stats } from \"node:fs\";\nimport fs from \"node:fs/promises\";\nimport { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport { getHistoryPath } from \"../store/paths.js\";\nimport { writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { hashDocument } from \"./history.js\";\nimport { verifyHistoryChain } from \"./replay.js\";\nimport type { HistoryEntry, ItemMetadata } from \"../../types/index.js\";\n\n/**\n * Documents the drift scan result payload exchanged by command, SDK, and package integrations.\n */\nexport interface DriftScanResult {\n  missingStreams: string[];\n  unreadableStreams: string[];\n  hashMismatches: string[];\n  chainMismatches: string[];\n  driftedItems: string[];\n}\n\nconst DRIFT_CACHE_VERSION = 3;\nconst DRIFT_CACHE_FILENAME = \"history-drift-cache.json\";\n\n/**\n * Controls how cached history stream verification is trusted when the file stat\n * tuple still matches a previous scan.\n */\nexport type DriftCacheHitVerification = \"content_hash\" | \"metadata\";\n\n/**\n * Documents the history drift scan options shared by health, validate, and\n * repair callers.\n */\nexport interface DriftScanOptions {\n  cacheHitVerification?: DriftCacheHitVerification;\n}\n\ninterface DriftCacheEntry {\n  mtime_ms: number;\n  ctime_ms: number;\n  size: number;\n  content_hash: string;\n  latest_after_hash: string;\n  chain_ok: boolean;\n}\n\ninterface DriftCacheEnvelope {\n  version: number;\n  entries: Record<string, DriftCacheEntry>;\n}\n\nfunction getDriftCachePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\", DRIFT_CACHE_FILENAME);\n}\n\nasync function loadDriftCache(pmRoot: string): Promise<DriftCacheEnvelope | null> {\n  try {\n    const raw = await fs.readFile(getDriftCachePath(pmRoot), \"utf8\");\n    const parsed = JSON.parse(raw) as DriftCacheEnvelope;\n    if (parsed.version !== DRIFT_CACHE_VERSION || typeof parsed.entries !== \"object\" || parsed.entries === null) {\n      return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === code;\n}\n\ninterface StreamVerification {\n  latestAfterHash: string;\n  chainOk: boolean;\n  contentHash: string;\n}\n\ninterface DriftScanAccumulator {\n  missingStreams: string[];\n  unreadableStreams: string[];\n  hashMismatches: string[];\n  chainMismatches: string[];\n}\n\nfunction hashContent(raw: string): string {\n  return createHash(\"sha256\").update(raw).digest(\"hex\");\n}\n\nasync function readHistoryContentHash(historyPath: string): Promise<string> {\n  const raw = await fs.readFile(historyPath, \"utf8\");\n  return hashContent(raw);\n}\n\n/**\n * Read and fully verify one history stream's hash chain. Returns null for an\n * empty/missing stream (caller records it as a missing stream).\n */\nasync function verifyHistoryStream(historyPath: string): Promise<StreamVerification | null> {\n  const raw = await fs.readFile(historyPath, \"utf8\");\n  const contentHash = hashContent(raw);\n  if (raw.trim().length === 0) {\n    return null;\n  }\n  const entries: HistoryEntry[] = [];\n  let latestAfterHash: string | null = null;\n  for (const line of raw.split(/\\r?\\n/)) {\n    const trimmed = line.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    const parsed = JSON.parse(trimmed) as HistoryEntry;\n    if (typeof parsed.after_hash !== \"string\" || parsed.after_hash.trim().length === 0) {\n      throw new Error(\"missing after_hash\");\n    }\n    entries.push(parsed);\n    latestAfterHash = parsed.after_hash;\n  }\n  /* c8 ignore start -- defensive guard for future history schema changes. */\n  if (!latestAfterHash) {\n    return null;\n  }\n  /* c8 ignore stop */\n  return {\n    latestAfterHash,\n    chainOk: verifyHistoryChain(entries).ok,\n    contentHash,\n  };\n}\n\nfunction cacheMetadataMatches(cached: DriftCacheEntry | undefined, stat: Stats): boolean {\n  return cached !== undefined && cached.mtime_ms === stat.mtimeMs && cached.ctime_ms === stat.ctimeMs && cached.size === stat.size;\n}\n\nasync function loadFreshStreamVerification(\n  itemId: string,\n  historyPath: string,\n  accumulator: DriftScanAccumulator,\n): Promise<StreamVerification | null> {\n  try {\n    const loaded = await verifyHistoryStream(historyPath);\n    if (!loaded) {\n      accumulator.missingStreams.push(itemId);\n      return null;\n    }\n    return loaded;\n  } catch {\n    accumulator.unreadableStreams.push(itemId);\n    return null;\n  }\n}\n\nasync function resolveStreamVerification(params: {\n  itemId: string;\n  historyPath: string;\n  stat: Stats;\n  cached: DriftCacheEntry | undefined;\n  verifyCacheHitByContent: boolean;\n  accumulator: DriftScanAccumulator;\n}): Promise<{ verification: StreamVerification | null; cacheDirty: boolean }> {\n  const cachedContentHash =\n    typeof params.cached?.content_hash === \"string\" && params.cached.content_hash.length > 0\n      ? params.cached.content_hash\n      : undefined;\n  const canUseCache = cacheMetadataMatches(params.cached, params.stat) && cachedContentHash !== undefined && params.cached !== undefined;\n  if (!canUseCache || !params.cached) {\n    return {\n      verification: await loadFreshStreamVerification(params.itemId, params.historyPath, params.accumulator),\n      cacheDirty: true,\n    };\n  }\n  let currentContentHash: string;\n  if (params.verifyCacheHitByContent) {\n    try {\n      currentContentHash = await readHistoryContentHash(params.historyPath);\n    } catch {\n      params.accumulator.unreadableStreams.push(params.itemId);\n      return { verification: null, cacheDirty: false };\n    }\n  } else {\n    currentContentHash = cachedContentHash;\n  }\n  if (!params.verifyCacheHitByContent || currentContentHash === cachedContentHash) {\n    return {\n      verification: {\n        latestAfterHash: params.cached.latest_after_hash,\n        chainOk: params.cached.chain_ok,\n        contentHash: currentContentHash,\n      },\n      cacheDirty: false,\n    };\n  }\n  return {\n    verification: await loadFreshStreamVerification(params.itemId, params.historyPath, params.accumulator),\n    cacheDirty: true,\n  };\n}\n\n/**\n * Scan every item's history stream for drift (missing/unreadable streams, broken\n * hash chains, and item/history hash mismatches).\n *\n * Full chain re-verification of a large history tree is the dominant cost of\n * `pm health`. We cache the per-stream verification keyed by the history file's\n * mtime/ctime/size plus content hash. Strict callers keep recomputing the\n * content hash on metadata hits; latency-sensitive health checks can opt into\n * trusting the stat tuple and skip rereading unchanged streams.\n */\nexport async function scanHistoryDrift(\n  pmRoot: string,\n  items: Array<ItemMetadata & { body: string }>,\n  options: DriftScanOptions = {},\n): Promise<DriftScanResult> {\n  const accumulator: DriftScanAccumulator = {\n    missingStreams: [],\n    unreadableStreams: [],\n    hashMismatches: [],\n    chainMismatches: [],\n  };\n\n  const cache = await loadDriftCache(pmRoot);\n  const previousEntries: Record<string, DriftCacheEntry> = cache?.entries ?? {};\n  const nextEntries: Record<string, DriftCacheEntry> = {};\n  let cacheDirty = false;\n  // Metadata mode does not open a stat-matched stream, so unreadable-after-stat\n  // failures are intentionally deferred to strict validate/history-repair scans.\n  const verifyCacheHitByContent = options.cacheHitVerification !== \"metadata\";\n\n  for (const item of items) {\n    const historyPath = getHistoryPath(pmRoot, item.id);\n\n    let stat: Stats;\n    try {\n      stat = await fs.stat(historyPath);\n    } catch (error: unknown) {\n      if (isErrno(error, \"ENOENT\")) {\n        accumulator.missingStreams.push(item.id);\n      } else {\n        accumulator.unreadableStreams.push(item.id);\n      }\n      continue;\n    }\n\n    const cached = previousEntries[item.id];\n    const resolved = await resolveStreamVerification({\n      itemId: item.id,\n      historyPath,\n      stat,\n      cached,\n      verifyCacheHitByContent,\n      accumulator,\n    });\n    cacheDirty ||= resolved.cacheDirty;\n    if (!resolved.verification) {\n      continue;\n    }\n\n    if (!resolved.verification.chainOk) {\n      accumulator.chainMismatches.push(item.id);\n    }\n    nextEntries[item.id] = {\n      mtime_ms: stat.mtimeMs,\n      ctime_ms: stat.ctimeMs,\n      size: stat.size,\n      content_hash: resolved.verification.contentHash,\n      latest_after_hash: resolved.verification.latestAfterHash,\n      chain_ok: resolved.verification.chainOk,\n    };\n\n    const { body, ...frontMatter } = item;\n    const currentHash = hashDocument({\n      metadata: frontMatter as ItemMetadata,\n      body,\n    });\n    if (currentHash !== resolved.verification.latestAfterHash) {\n      accumulator.hashMismatches.push(item.id);\n    }\n  }\n\n  if (cacheDirty || Object.keys(previousEntries).length !== Object.keys(nextEntries).length) {\n    const cachePath = getDriftCachePath(pmRoot);\n    try {\n      await fs.mkdir(path.dirname(cachePath), { recursive: true });\n      await writeFileAtomic(cachePath, JSON.stringify({ version: DRIFT_CACHE_VERSION, entries: nextEntries }));\n    } catch {\n      // Best-effort cache write: a failed persist must never fail a health scan.\n    }\n  }\n\n  const driftedItems = [\n    ...new Set([\n      ...accumulator.missingStreams,\n      ...accumulator.unreadableStreams,\n      ...accumulator.hashMismatches,\n      ...accumulator.chainMismatches,\n    ]),\n  ].sort((a, b) => a.localeCompare(b));\n  return { ...accumulator, driftedItems };\n}\n"],"names":[],"mappings":"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","debugId":"20ed642a-081f-55bd-9bbe-840b1a1bd3b5"}

package/dist/core/output/mutation-projection.js

@@ -19,7 +19,7 @@
  * MCP server, and returns the original reference unchanged when nothing is compacted.
  */
 
-!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]="31ecd51a-b5e0-503b-b488-4e6a12815ffe")}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]="3e1d237e-475e-5dbe-9e6e-2903b521208d")}catch(e){}}();
 const CHANGED_FIELDS_KEY = "changed_fields";
 const CHANGED_FIELD_COUNT_KEY = "changed_field_count";
 const ROWS_KEY = "rows";
@@ -61,11 +61,17 @@ function replaceRows(envelope, rows) {
     return projected;
 }
 function projectIdOnlyResult(result) {
-    if (!isPlainObject(result) || !isPlainObject(result.item)) {
+    if (!isPlainObject(result)) {
         return null;
     }
-    const id = typeof result.item.id === "string" ? result.item.id : undefined;
-    const status = typeof result.item.status === "string" ? result.item.status : undefined;
+    // Plan mutations wrap the mutated subject under "plan" instead of "item";
+    // both shapes honor the root --id-only contract (id + status).
+    const subject = isPlainObject(result.item) ? result.item : isPlainObject(result.plan) ? result.plan : null;
+    if (subject === null) {
+        return null;
+    }
+    const id = typeof subject.id === "string" ? subject.id : undefined;
+    const status = typeof subject.status === "string" ? subject.status : undefined;
     if (!id) {
         return null;
     }
@@ -123,4 +129,4 @@ export function projectMutationResult(result, options = {}) {
     return changed ? projected : result;
 }
 //# sourceMappingURL=mutation-projection.js.map
-//# debugId=31ecd51a-b5e0-503b-b488-4e6a12815ffe
+//# debugId=3e1d237e-475e-5dbe-9e6e-2903b521208d

package/dist/core/output/mutation-projection.js.map

@@ -1 +1 @@
-{"version":3,"file":"mutation-projection.js","sources":["core/output/mutation-projection.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Shared projection helper for mutation command results.\n *\n * Mutation commands (create/update/close/append/update-many) return a result\n * envelope that carries a `changed_fields` string array. On create this array simply\n * re-lists every field the command just set, which the item echo above it already\n * shows, so for high-volume agent loops it is ~50% redundant payload. This helper\n * lets the CLI (`--no-changed-fields`) and the MCP agent path trim that array down\n * to a deterministic `changed_field_count` without losing mutation evidence.\n *\n * Compaction is deliberately scoped to the mutation envelope only:\n *   - the envelope's own top-level `changed_fields` (create/update/close/append), and\n *   - `rows[*].changed_fields` (update-many reports its delta per row).\n * It does NOT recurse into arbitrary nested objects, so unrelated payloads that\n * legitimately carry `changed_fields` (for example `pm history --diff` entries, or a\n * custom runtime metadata field) are left untouched.\n *\n * The helper is pure and side-effect free, reused by both the output layer and the\n * MCP server, and returns the original reference unchanged when nothing is compacted.\n */\n\n/** Controls whether mutation output keeps full changed fields or compact counts. */\nexport type ChangedFieldsMode = \"full\" | \"compact\";\n\n/**\n * Documents the mutation projection options payload exchanged by command, SDK, and package integrations.\n */\nexport interface MutationProjectionOptions {\n  /** Defaults to \"full\" (unchanged output). \"compact\" drops the array, keeping a count. */\n  changedFields?: ChangedFieldsMode;\n  /** Return only id/status for single-item mutation envelopes. */\n  idOnly?: boolean;\n}\n\nconst CHANGED_FIELDS_KEY = \"changed_fields\";\nconst CHANGED_FIELD_COUNT_KEY = \"changed_field_count\";\nconst ROWS_KEY = \"rows\";\nconst UPDATE_MANY_MUTATION_MODES = new Set([\"apply\", \"rollback\"]);\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return false;\n  }\n  const proto = Object.getPrototypeOf(value);\n  return proto === null || proto === Object.prototype;\n}\n\n/** Replace a single envelope's own top-level `changed_fields` array with a count. */\nfunction compactOwnChangedFields(envelope: Record<string, unknown>): Record<string, unknown> | null {\n  const changedFields = envelope[CHANGED_FIELDS_KEY];\n  if (!Array.isArray(changedFields)) {\n    return null;\n  }\n  const projected: Record<string, unknown> =\n    Object.getPrototypeOf(envelope) === null ? Object.create(null) : {};\n  for (const [key, value] of Object.entries(envelope)) {\n    if (key !== CHANGED_FIELDS_KEY) {\n      projected[key] = value;\n    }\n  }\n  projected[CHANGED_FIELD_COUNT_KEY] = changedFields.length;\n  return projected;\n}\n\nfunction isMutationEnvelope(value: Record<string, unknown>): boolean {\n  return \"item\" in value && Array.isArray(value[CHANGED_FIELDS_KEY]);\n}\n\nfunction isUpdateManyMutationEnvelope(value: Record<string, unknown>): boolean {\n  return (\n    typeof value.mode === \"string\" &&\n    UPDATE_MANY_MUTATION_MODES.has(value.mode) &&\n    Array.isArray(value[ROWS_KEY])\n  );\n}\n\nfunction replaceRows(envelope: Record<string, unknown>, rows: unknown[]): Record<string, unknown> {\n  const projected: Record<string, unknown> =\n    Object.getPrototypeOf(envelope) === null ? Object.create(null) : {};\n  Object.assign(projected, envelope);\n  projected[ROWS_KEY] = rows;\n  return projected;\n}\n\nfunction projectIdOnlyResult(result: unknown): unknown | null {\n  if (!isPlainObject(result) || !isPlainObject(result.item)) {\n    return null;\n  }\n  const id = typeof result.item.id === \"string\" ? result.item.id : undefined;\n  const status = typeof result.item.status === \"string\" ? result.item.status : undefined;\n  if (!id) {\n    return null;\n  }\n  return status ? { id, status } : { id };\n}\n\nfunction compactUpdateManyRows(envelope: Record<string, unknown>): { projected: Record<string, unknown>; changed: boolean } {\n  const rows = isUpdateManyMutationEnvelope(envelope) ? envelope[ROWS_KEY] : undefined;\n  if (!Array.isArray(rows)) {\n    return { projected: envelope, changed: false };\n  }\n  let rowsChanged = false;\n  const nextRows = rows.map((row) => {\n    if (!isPlainObject(row)) {\n      return row;\n    }\n    const compactedRow = compactOwnChangedFields(row);\n    if (compactedRow) {\n      rowsChanged = true;\n      return compactedRow;\n    }\n    return row;\n  });\n  return rowsChanged\n    ? { projected: replaceRows(envelope, nextRows), changed: true }\n    : { projected: envelope, changed: false };\n}\n\n/**\n * Returns a copy of a mutation result with the envelope `changed_fields` arrays\n * replaced by `changed_field_count` when compact mode is requested. Inputs that are\n * not a mutation envelope (or full mode) are returned unchanged (same reference).\n */\nexport function projectMutationResult(result: unknown, options: MutationProjectionOptions = {}): unknown {\n  if (options.idOnly === true) {\n    const idOnly = projectIdOnlyResult(result);\n    if (idOnly !== null) {\n      return idOnly;\n    }\n  }\n\n  const mode = options.changedFields ?? \"full\";\n  if (mode === \"full\" || !isPlainObject(result)) {\n    return result;\n  }\n\n  let changed = false;\n  let projected: Record<string, unknown> = result;\n\n  const compactedTop = isMutationEnvelope(result) ? compactOwnChangedFields(result) : null;\n  if (compactedTop !== null) {\n    projected = compactedTop;\n    changed = true;\n  }\n\n  const rowProjection = compactUpdateManyRows(projected);\n  if (rowProjection.changed) {\n    projected = rowProjection.projected;\n    changed = true;\n  }\n\n  return changed ? projected : result;\n}\n"],"names":[],"mappings":"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","debugId":"31ecd51a-b5e0-503b-b488-4e6a12815ffe"}
+{"version":3,"file":"mutation-projection.js","sources":["core/output/mutation-projection.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Shared projection helper for mutation command results.\n *\n * Mutation commands (create/update/close/append/update-many) return a result\n * envelope that carries a `changed_fields` string array. On create this array simply\n * re-lists every field the command just set, which the item echo above it already\n * shows, so for high-volume agent loops it is ~50% redundant payload. This helper\n * lets the CLI (`--no-changed-fields`) and the MCP agent path trim that array down\n * to a deterministic `changed_field_count` without losing mutation evidence.\n *\n * Compaction is deliberately scoped to the mutation envelope only:\n *   - the envelope's own top-level `changed_fields` (create/update/close/append), and\n *   - `rows[*].changed_fields` (update-many reports its delta per row).\n * It does NOT recurse into arbitrary nested objects, so unrelated payloads that\n * legitimately carry `changed_fields` (for example `pm history --diff` entries, or a\n * custom runtime metadata field) are left untouched.\n *\n * The helper is pure and side-effect free, reused by both the output layer and the\n * MCP server, and returns the original reference unchanged when nothing is compacted.\n */\n\n/** Controls whether mutation output keeps full changed fields or compact counts. */\nexport type ChangedFieldsMode = \"full\" | \"compact\";\n\n/**\n * Documents the mutation projection options payload exchanged by command, SDK, and package integrations.\n */\nexport interface MutationProjectionOptions {\n  /** Defaults to \"full\" (unchanged output). \"compact\" drops the array, keeping a count. */\n  changedFields?: ChangedFieldsMode;\n  /** Return only id/status for single-item mutation envelopes. */\n  idOnly?: boolean;\n}\n\nconst CHANGED_FIELDS_KEY = \"changed_fields\";\nconst CHANGED_FIELD_COUNT_KEY = \"changed_field_count\";\nconst ROWS_KEY = \"rows\";\nconst UPDATE_MANY_MUTATION_MODES = new Set([\"apply\", \"rollback\"]);\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return false;\n  }\n  const proto = Object.getPrototypeOf(value);\n  return proto === null || proto === Object.prototype;\n}\n\n/** Replace a single envelope's own top-level `changed_fields` array with a count. */\nfunction compactOwnChangedFields(envelope: Record<string, unknown>): Record<string, unknown> | null {\n  const changedFields = envelope[CHANGED_FIELDS_KEY];\n  if (!Array.isArray(changedFields)) {\n    return null;\n  }\n  const projected: Record<string, unknown> =\n    Object.getPrototypeOf(envelope) === null ? Object.create(null) : {};\n  for (const [key, value] of Object.entries(envelope)) {\n    if (key !== CHANGED_FIELDS_KEY) {\n      projected[key] = value;\n    }\n  }\n  projected[CHANGED_FIELD_COUNT_KEY] = changedFields.length;\n  return projected;\n}\n\nfunction isMutationEnvelope(value: Record<string, unknown>): boolean {\n  return \"item\" in value && Array.isArray(value[CHANGED_FIELDS_KEY]);\n}\n\nfunction isUpdateManyMutationEnvelope(value: Record<string, unknown>): boolean {\n  return (\n    typeof value.mode === \"string\" &&\n    UPDATE_MANY_MUTATION_MODES.has(value.mode) &&\n    Array.isArray(value[ROWS_KEY])\n  );\n}\n\nfunction replaceRows(envelope: Record<string, unknown>, rows: unknown[]): Record<string, unknown> {\n  const projected: Record<string, unknown> =\n    Object.getPrototypeOf(envelope) === null ? Object.create(null) : {};\n  Object.assign(projected, envelope);\n  projected[ROWS_KEY] = rows;\n  return projected;\n}\n\nfunction projectIdOnlyResult(result: unknown): unknown | null {\n  if (!isPlainObject(result)) {\n    return null;\n  }\n  // Plan mutations wrap the mutated subject under \"plan\" instead of \"item\";\n  // both shapes honor the root --id-only contract (id + status).\n  const subject = isPlainObject(result.item) ? result.item : isPlainObject(result.plan) ? result.plan : null;\n  if (subject === null) {\n    return null;\n  }\n  const id = typeof subject.id === \"string\" ? subject.id : undefined;\n  const status = typeof subject.status === \"string\" ? subject.status : undefined;\n  if (!id) {\n    return null;\n  }\n  return status ? { id, status } : { id };\n}\n\nfunction compactUpdateManyRows(envelope: Record<string, unknown>): { projected: Record<string, unknown>; changed: boolean } {\n  const rows = isUpdateManyMutationEnvelope(envelope) ? envelope[ROWS_KEY] : undefined;\n  if (!Array.isArray(rows)) {\n    return { projected: envelope, changed: false };\n  }\n  let rowsChanged = false;\n  const nextRows = rows.map((row) => {\n    if (!isPlainObject(row)) {\n      return row;\n    }\n    const compactedRow = compactOwnChangedFields(row);\n    if (compactedRow) {\n      rowsChanged = true;\n      return compactedRow;\n    }\n    return row;\n  });\n  return rowsChanged\n    ? { projected: replaceRows(envelope, nextRows), changed: true }\n    : { projected: envelope, changed: false };\n}\n\n/**\n * Returns a copy of a mutation result with the envelope `changed_fields` arrays\n * replaced by `changed_field_count` when compact mode is requested. Inputs that are\n * not a mutation envelope (or full mode) are returned unchanged (same reference).\n */\nexport function projectMutationResult(result: unknown, options: MutationProjectionOptions = {}): unknown {\n  if (options.idOnly === true) {\n    const idOnly = projectIdOnlyResult(result);\n    if (idOnly !== null) {\n      return idOnly;\n    }\n  }\n\n  const mode = options.changedFields ?? \"full\";\n  if (mode === \"full\" || !isPlainObject(result)) {\n    return result;\n  }\n\n  let changed = false;\n  let projected: Record<string, unknown> = result;\n\n  const compactedTop = isMutationEnvelope(result) ? compactOwnChangedFields(result) : null;\n  if (compactedTop !== null) {\n    projected = compactedTop;\n    changed = true;\n  }\n\n  const rowProjection = compactUpdateManyRows(projected);\n  if (rowProjection.changed) {\n    projected = rowProjection.projected;\n    changed = true;\n  }\n\n  return changed ? projected : result;\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAeH,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAC5C,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AACtD,MAAM,QAAQ,GAAG,MAAM,CAAC;AACxB,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAElE,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,CAAC;AACtD,CAAC;AAED,qFAAqF;AACrF,SAAS,uBAAuB,CAAC,QAAiC;IAChE,MAAM,aAAa,GAAG,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,SAAS,GACb,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,KAAK,kBAAkB,EAAE,CAAC;YAC/B,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IACD,SAAS,CAAC,uBAAuB,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC;IAC1D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAA8B;IACxD,OAAO,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,4BAA4B,CAAC,KAA8B;IAClE,OAAO,CACL,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,0BAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;QAC1C,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAC/B,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,QAAiC,EAAE,IAAe;IACrE,MAAM,SAAS,GACb,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnC,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC3B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAe;IAC1C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,0EAA0E;IAC1E,+DAA+D;IAC/D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3G,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,EAAE,GAAG,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAiC;IAC9D,MAAM,IAAI,GAAG,4BAA4B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACjD,CAAC;IACD,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAChC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,YAAY,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,YAAY,EAAE,CAAC;YACjB,WAAW,GAAG,IAAI,CAAC;YACnB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;IACH,OAAO,WAAW;QAChB,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE;QAC/D,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAe,EAAE,UAAqC,EAAE;IAC5F,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,IAAI,MAAM,CAAC;IAC7C,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,SAAS,GAA4B,MAAM,CAAC;IAEhD,MAAM,YAAY,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzF,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,SAAS,GAAG,YAAY,CAAC;QACzB,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,MAAM,aAAa,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1B,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC;QACpC,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,OAAO,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AACtC,CAAC","debugId":"3e1d237e-475e-5dbe-9e6e-2903b521208d"}

package/dist/core/search/cache.js

@@ -4,7 +4,7 @@
  * Powers search, embeddings, and semantic retrieval behavior for Cache.
  */
 
-!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]="81b33560-411e-51e7-8009-cf3615d51a2a")}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]="0af5c45d-b1b3-543b-aa4a-a70d52010fac")}catch(e){}}();
 import path from "node:path";
 import { getActiveExtensionRegistrations } from "../extensions/index.js";
 import { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from "../fs/fs-utils.js";
@@ -173,7 +173,7 @@ async function resolveSemanticRefreshRuntimeContext(pmRoot, normalizedItemIds, o
     if (!provider) {
         return buildSkippedSemanticRefreshResult(normalizedItemIds, "search_semantic_refresh_skipped:provider_unconfigured");
     }
-    const vectorStore = resolveVectorStores(effectiveSettings).active;
+    const vectorStore = resolveVectorStores(effectiveSettings, pmRoot).active;
     if (!vectorStore) {
         return buildSkippedSemanticRefreshResult(normalizedItemIds, "search_semantic_refresh_skipped:vector_store_unconfigured");
     }
@@ -480,4 +480,4 @@ export const _testOnly = {
     resetSemanticVectorStore,
 };
 //# sourceMappingURL=cache.js.map
-//# debugId=81b33560-411e-51e7-8009-cf3615d51a2a
+//# debugId=0af5c45d-b1b3-543b-aa4a-a70d52010fac

package/dist/core/search/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sources":["core/search/cache.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/search/cache\n *\n * Powers search, embeddings, and semantic retrieval behavior for Cache.\n */\nimport path from \"node:path\";\nimport { getActiveExtensionRegistrations } from \"../extensions/index.js\";\nimport { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { resolveItemTypeRegistry } from \"../item/type-registry.js\";\nimport { toErrorMessage } from \"../shared/primitives.js\";\nimport { locateItem, readLocatedItem } from \"../store/item-store.js\";\nimport { getSettingsPath } from \"../store/paths.js\";\nimport { readSettings } from \"../store/settings.js\";\nimport { executeEmbeddingBatchesWithRetry } from \"./embedding-batches.js\";\nimport {\n  buildSemanticCorpusInput,\n  resolveSearchCorpusFields,\n  resolveSemanticCorpusCharacterLimit,\n} from \"./corpus.js\";\nimport { resolveEmbeddingProviders } from \"./providers.js\";\nimport type { EmbeddingProviderConfig } from \"./providers.js\";\nimport { resolveSettingsWithSemanticRuntimeDefaults } from \"./semantic-defaults.js\";\nimport { scheduleBackgroundSemanticRefresh } from \"./background-refresh.js\";\nimport { executeVectorDelete, executeVectorReset, executeVectorUpsert, resolveVectorStores } from \"./vector-stores.js\";\nimport type { VectorStoreConfig } from \"./vector-stores.js\";\nimport {\n  buildVectorizationEmbeddingIdentity,\n  buildVectorizationEmbeddingMetadata,\n  hasVectorizationEmbeddingIdentityChanged,\n  hasVectorizationVectorDimensionChanged,\n  inferConsistentVectorDimension,\n  normalizeVectorizationEmbeddingMetadata,\n} from \"./vectorization-metadata.js\";\nimport type {\n  VectorizationEmbeddingIdentity,\n  VectorizationEmbeddingMetadata,\n} from \"./vectorization-metadata.js\";\nimport { nowIso } from \"../shared/time.js\";\nimport type { ItemDocument, ItemFrontMatter } from \"../../types/index.js\";\n\nexport const SEARCH_CACHE_ARTIFACT_PATHS = [\"index/manifest.json\", \"search/embeddings.jsonl\"] as const;\nexport const VECTORIZATION_STATUS_LEDGER_PATH = \"search/vectorization-status.json\";\n\n/**\n * Documents the search cache invalidation result payload exchanged by command, SDK, and package integrations.\n */\nexport interface SearchCacheInvalidationResult {\n  invalidated: string[];\n  warnings: string[];\n}\n\n/**\n * Documents the semantic mutation refresh result payload exchanged by command, SDK, and package integrations.\n */\nexport interface SemanticMutationRefreshResult {\n  refreshed: string[];\n  skipped: string[];\n  warnings: string[];\n}\n\n/**\n * Documents the search mutation artifact refresh result payload exchanged by command, SDK, and package integrations.\n */\nexport interface SearchMutationArtifactRefreshResult extends SearchCacheInvalidationResult {\n  refreshed: string[];\n  skipped: string[];\n  /** True when the semantic refresh was dispatched to a detached background worker. */\n  scheduled?: boolean;\n}\n\n/**\n * Documents the refresh search artifacts for mutation options payload exchanged by command, SDK, and package integrations.\n */\nexport interface RefreshSearchArtifactsForMutationOptions {\n  /**\n   * When true and semantic search is active, the (slow) embedding refresh is\n   * dispatched to a detached background worker instead of awaited inline so the\n   * mutation returns immediately. The synchronous keyword-cache invalidation\n   * still runs first. Callers pass this only outside test runners.\n   */\n  background?: boolean;\n}\n\n/**\n * Documents the semantic refresh options payload exchanged by command, SDK, and package integrations.\n */\nexport interface SemanticRefreshOptions {\n  settings?: Awaited<ReturnType<typeof readSettings>>;\n  apply_runtime_defaults?: boolean;\n}\n\n/**\n * Documents the vectorization status ledger read result payload exchanged by command, SDK, and package integrations.\n */\nexport interface VectorizationStatusLedgerReadResult {\n  entries: Record<string, string>;\n  embedding: VectorizationEmbeddingMetadata | null;\n  warnings: string[];\n}\n\nfunction formatInvalidationWarning(relativePath: string, error: unknown): string {\n  return `search_cache_invalidation_failed:${relativePath}:${String(error)}`;\n}\n\n\nfunction toUniqueSorted(values: Iterable<string>): string[] {\n  return [...new Set([...values].map((value) => value.trim()).filter((value) => value.length > 0))]\n    .sort((left, right) => left.localeCompare(right));\n}\n\nfunction isValidUpdatedAt(value: unknown): value is string {\n  return typeof value === \"string\" && value.trim().length > 0 && Number.isFinite(Date.parse(value));\n}\n\nfunction normalizeVectorizationLedgerEntries(entries: Record<string, string>): Record<string, string> {\n  const normalized = new Map<string, string>();\n  for (const [rawId, rawUpdatedAt] of Object.entries(entries)) {\n    const id = rawId.trim();\n    if (id.length === 0 || !isValidUpdatedAt(rawUpdatedAt)) {\n      continue;\n    }\n    normalized.set(id, rawUpdatedAt);\n  }\n  return Object.fromEntries([...normalized.entries()].sort((left, right) => left[0].localeCompare(right[0])));\n}\n\n/**\n * Implements read vectorization status ledger for the public runtime surface of this module.\n */\nexport async function readVectorizationStatusLedger(pmRoot: string): Promise<VectorizationStatusLedgerReadResult> {\n  const ledgerPath = path.join(pmRoot, VECTORIZATION_STATUS_LEDGER_PATH);\n  const raw = await readFileIfExists(ledgerPath);\n  if (raw === null || raw.trim().length === 0) {\n    return {\n      entries: {},\n      embedding: null,\n      warnings: [],\n    };\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    return {\n      entries: {},\n      embedding: null,\n      warnings: [\"search_vectorization_status_ledger_invalid\"],\n    };\n  }\n\n  if (\n    typeof parsed !== \"object\" ||\n    parsed === null ||\n    (parsed as { version?: unknown }).version !== 1 ||\n    !Array.isArray((parsed as { items?: unknown }).items)\n  ) {\n    return {\n      entries: {},\n      embedding: null,\n      warnings: [\"search_vectorization_status_ledger_invalid\"],\n    };\n  }\n\n  const mapped = new Map<string, string>();\n  for (const entry of (parsed as { items: unknown[] }).items) {\n    if (typeof entry !== \"object\" || entry === null) {\n      return {\n        entries: {},\n        embedding: null,\n        warnings: [\"search_vectorization_status_ledger_invalid\"],\n      };\n    }\n    const id = (entry as { id?: unknown }).id;\n    const updatedAt = (entry as { updated_at?: unknown }).updated_at;\n    if (typeof id !== \"string\" || id.trim().length === 0 || !isValidUpdatedAt(updatedAt)) {\n      return {\n        entries: {},\n        embedding: null,\n        warnings: [\"search_vectorization_status_ledger_invalid\"],\n      };\n    }\n    mapped.set(id.trim(), updatedAt);\n  }\n\n  let embedding: VectorizationEmbeddingMetadata | null = null;\n  try {\n    embedding = normalizeVectorizationEmbeddingMetadata((parsed as { embedding?: unknown }).embedding);\n  } catch {\n    return {\n      entries: {},\n      embedding: null,\n      warnings: [\"search_vectorization_status_ledger_invalid\"],\n    };\n  }\n\n  return {\n    entries: Object.fromEntries([...mapped.entries()].sort((left, right) => left[0].localeCompare(right[0]))),\n    embedding,\n    warnings: [],\n  };\n}\n\n/**\n * Implements write vectorization status ledger for the public runtime surface of this module.\n */\nexport async function writeVectorizationStatusLedger(\n  pmRoot: string,\n  entries: Record<string, string>,\n  embedding?: VectorizationEmbeddingMetadata | null,\n): Promise<void> {\n  const normalizedEntries = normalizeVectorizationLedgerEntries(entries);\n  const ledgerPath = path.join(pmRoot, VECTORIZATION_STATUS_LEDGER_PATH);\n  const serialized = `${JSON.stringify(\n    {\n      version: 1,\n      generated_at: nowIso(),\n      ...(embedding ? { embedding } : {}),\n      items: Object.entries(normalizedEntries).map(([id, updated_at]) => ({\n        id,\n        updated_at,\n      })),\n    },\n    null,\n    2,\n  )}\\n`;\n  await writeFileAtomic(ledgerPath, serialized);\n}\n\nfunction buildVectorPayload(item: ItemFrontMatter): Record<string, unknown> {\n  return {\n    id: item.id,\n    type: item.type,\n    status: item.status,\n    priority: item.priority,\n    updated_at: item.updated_at,\n  };\n}\n\ninterface SemanticRefreshRuntimeContext {\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  provider: EmbeddingProviderConfig;\n  vectorStore: VectorStoreConfig;\n}\n\ninterface SemanticRefreshWorkload {\n  documents: Array<{ id: string; document: ItemDocument }>;\n  missingIds: string[];\n  skippedIds: string[];\n  warnings: string[];\n}\n\ninterface SemanticRefreshOperationResult {\n  refreshed: string[];\n  skipped: string[];\n  warnings: string[];\n}\n\ninterface SemanticEmbeddingOperationResult {\n  vectors: number[][];\n  vector_dimension: number;\n  warnings: string[];\n}\n\nfunction buildVectorizationIdentityForProvider(provider: EmbeddingProviderConfig): VectorizationEmbeddingIdentity {\n  const identity = buildVectorizationEmbeddingIdentity(provider.name, provider.model);\n  if (!identity) {\n    throw new Error(\"Embedding provider must include a provider name and model\");\n  }\n  return identity;\n}\n\nfunction buildSkippedSemanticRefreshResult(itemIds: string[], warning: string): SemanticMutationRefreshResult {\n  return {\n    refreshed: [],\n    skipped: itemIds,\n    warnings: [warning],\n  };\n}\n\nasync function resolveSemanticRefreshRuntimeContext(\n  pmRoot: string,\n  normalizedItemIds: string[],\n  options: SemanticRefreshOptions,\n): Promise<SemanticRefreshRuntimeContext | SemanticMutationRefreshResult> {\n  if (!options.settings && !(await pathExists(getSettingsPath(pmRoot)))) {\n    return buildSkippedSemanticRefreshResult(normalizedItemIds, \"search_semantic_refresh_skipped:settings_not_initialized\");\n  }\n\n  let settings: Awaited<ReturnType<typeof readSettings>>;\n  try {\n    settings = options.settings ?? (await readSettings(pmRoot));\n  } catch (error: unknown) {\n    return buildSkippedSemanticRefreshResult(\n      normalizedItemIds,\n      `search_semantic_refresh_skipped:settings_read_failed:${toErrorMessage(error)}`,\n    );\n  }\n  const effectiveSettings = options.apply_runtime_defaults\n    ? resolveSettingsWithSemanticRuntimeDefaults(settings).settings\n    : settings;\n\n  const provider = resolveEmbeddingProviders(effectiveSettings).active;\n  if (!provider) {\n    return buildSkippedSemanticRefreshResult(normalizedItemIds, \"search_semantic_refresh_skipped:provider_unconfigured\");\n  }\n  const vectorStore = resolveVectorStores(effectiveSettings).active;\n  if (!vectorStore) {\n    return buildSkippedSemanticRefreshResult(normalizedItemIds, \"search_semantic_refresh_skipped:vector_store_unconfigured\");\n  }\n\n  return {\n    settings: effectiveSettings,\n    provider,\n    vectorStore,\n  };\n}\n\nasync function collectSemanticRefreshWorkload(\n  pmRoot: string,\n  idPrefix: string,\n  preferredFormat: \"toon\" | \"json_markdown\",\n  normalizedItemIds: string[],\n  typeToFolder: Record<string, string>,\n  schema: Awaited<ReturnType<typeof readSettings>>[\"schema\"],\n): Promise<SemanticRefreshWorkload> {\n  const warnings: string[] = [];\n  const skipped = new Set<string>();\n  const missing = new Set<string>();\n  const documents: Array<{ id: string; document: ItemDocument }> = [];\n\n  for (const itemId of normalizedItemIds) {\n    const located = await locateItem(pmRoot, itemId, idPrefix, preferredFormat, typeToFolder);\n    if (!located) {\n      missing.add(itemId);\n      continue;\n    }\n\n    try {\n      const loaded = await readLocatedItem(located, { schema });\n      documents.push({\n        id: loaded.document.metadata.id,\n        document: loaded.document,\n      });\n    } catch (error: unknown) {\n      skipped.add(located.id);\n      warnings.push(`search_semantic_refresh_item_read_failed:${located.id}:${toErrorMessage(error)}`);\n    }\n  }\n\n  documents.sort((left, right) => left.id.localeCompare(right.id));\n  return {\n    documents,\n    missingIds: toUniqueSorted(missing),\n    skippedIds: toUniqueSorted(skipped),\n    warnings,\n  };\n}\n\nasync function embedLocatedSemanticVectors(\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  provider: EmbeddingProviderConfig,\n  documents: Array<{ id: string; document: ItemDocument }>,\n): Promise<SemanticEmbeddingOperationResult> {\n  const corpusCharacterLimit = resolveSemanticCorpusCharacterLimit(\n    provider.name,\n    settings.search.embedding_corpus_max_characters,\n  ).maxCharacters;\n  const corpusFields = resolveSearchCorpusFields(settings);\n  const corpusInputs = documents.map((entry) =>\n    buildSemanticCorpusInput(entry.document, {\n      providerName: provider.name,\n      maxCharacters: corpusCharacterLimit,\n      fields: corpusFields,\n    }),\n  );\n  const embeddingResult = await executeEmbeddingBatchesWithRetry(provider, settings, corpusInputs);\n  return {\n    vectors: embeddingResult.vectors,\n    vector_dimension: inferConsistentVectorDimension(embeddingResult.vectors, \"Semantic refresh embedding\"),\n    warnings: embeddingResult.warnings,\n  };\n}\n\nasync function upsertLocatedSemanticVectors(\n  vectorStore: VectorStoreConfig,\n  documents: Array<{ id: string; document: ItemDocument }>,\n  vectors: number[][],\n): Promise<SemanticRefreshOperationResult> {\n  await executeVectorUpsert(\n    vectorStore,\n    documents.map((entry, index) => ({\n      id: entry.id,\n      vector: vectors[index],\n      payload: buildVectorPayload(entry.document.metadata),\n    })),\n  );\n  return {\n    refreshed: documents.map((entry) => entry.id),\n    skipped: [],\n    warnings: [],\n  };\n}\n\nasync function resetSemanticVectorStore(\n  vectorStore: VectorStoreConfig,\n  ledgerEntries: Record<string, string>,\n): Promise<SemanticRefreshOperationResult> {\n  try {\n    await executeVectorReset(vectorStore, Object.keys(ledgerEntries));\n    return { refreshed: [], skipped: [], warnings: [] };\n  } catch (error: unknown) {\n    return {\n      refreshed: [],\n      skipped: [],\n      warnings: [`search_semantic_refresh_reset_failed:${toErrorMessage(error)}`],\n    };\n  }\n}\n\nasync function pruneMissingSemanticVectors(\n  vectorStore: VectorStoreConfig,\n  missingIds: string[],\n): Promise<SemanticRefreshOperationResult> {\n  if (missingIds.length === 0) {\n    return { refreshed: [], skipped: [], warnings: [] };\n  }\n  try {\n    await executeVectorDelete(vectorStore, missingIds);\n    return {\n      refreshed: [],\n      skipped: [],\n      warnings: [],\n    };\n  } catch (error: unknown) {\n    return {\n      refreshed: [],\n      skipped: missingIds,\n      warnings: [`search_semantic_refresh_delete_failed:${toErrorMessage(error)}`],\n    };\n  }\n}\n\n/**\n * Implements invalidate search cache artifacts for the public runtime surface of this module.\n */\nexport async function invalidateSearchCacheArtifacts(pmRoot: string): Promise<SearchCacheInvalidationResult> {\n  const invalidated: string[] = [];\n  const warnings: string[] = [];\n\n  for (const relativePath of SEARCH_CACHE_ARTIFACT_PATHS) {\n    const artifactPath = path.join(pmRoot, relativePath);\n    try {\n      if (!(await pathExists(artifactPath))) {\n        continue;\n      }\n      await removeFileIfExists(artifactPath);\n      invalidated.push(relativePath);\n    } catch (error: unknown) {\n      warnings.push(formatInvalidationWarning(relativePath, error));\n    }\n  }\n\n  return {\n    invalidated,\n    warnings,\n  };\n}\n\n/**\n * Implements refresh semantic embeddings for mutated items for the public runtime surface of this module.\n */\nexport async function refreshSemanticEmbeddingsForMutatedItems(\n  pmRoot: string,\n  itemIds: string[],\n  options: SemanticRefreshOptions = {},\n): Promise<SemanticMutationRefreshResult> {\n  const normalizedItemIds = toUniqueSorted(itemIds);\n  if (normalizedItemIds.length === 0) {\n    return {\n      refreshed: [],\n      skipped: [],\n      warnings: [],\n    };\n  }\n\n  const runtimeContext = await resolveSemanticRefreshRuntimeContext(pmRoot, normalizedItemIds, options);\n  if (!(\"settings\" in runtimeContext)) {\n    return runtimeContext;\n  }\n  const typeRegistry = resolveItemTypeRegistry(runtimeContext.settings, getActiveExtensionRegistrations());\n  const workload = await collectSemanticRefreshWorkload(\n    pmRoot,\n    runtimeContext.settings.id_prefix,\n    runtimeContext.settings.item_format,\n    normalizedItemIds,\n    typeRegistry.type_to_folder,\n    runtimeContext.settings.schema,\n  );\n  const ledgerRead =\n    workload.documents.length > 0 || workload.missingIds.length > 0\n      ? await readVectorizationStatusLedger(pmRoot)\n      : { entries: {}, embedding: null, warnings: [] };\n  const embeddingIdentity = buildVectorizationIdentityForProvider(runtimeContext.provider);\n  const nextLedgerBaseEntries = ledgerRead.entries;\n  let refreshedResult: SemanticRefreshOperationResult = { refreshed: [], skipped: [], warnings: [] };\n  let nextEmbeddingMetadata = ledgerRead.embedding;\n  if (workload.documents.length > 0) {\n    if (ledgerRead.embedding && hasVectorizationEmbeddingIdentityChanged(ledgerRead.embedding, embeddingIdentity)) {\n      refreshedResult = {\n        refreshed: [],\n        skipped: workload.documents.map((entry) => entry.id),\n        warnings: [\"search_semantic_refresh_requires_reindex:embedding_identity_changed\"],\n      };\n    } else {\n      try {\n        const embedded = await embedLocatedSemanticVectors(\n          runtimeContext.settings,\n          runtimeContext.provider,\n          workload.documents,\n        );\n        if (hasVectorizationVectorDimensionChanged(ledgerRead.embedding, embedded.vector_dimension)) {\n          refreshedResult = {\n            refreshed: [],\n            skipped: workload.documents.map((entry) => entry.id),\n            warnings: [...embedded.warnings, \"search_semantic_refresh_requires_reindex:vector_dimension_changed\"],\n          };\n        } else {\n          nextEmbeddingMetadata = buildVectorizationEmbeddingMetadata(embeddingIdentity, embedded.vector_dimension);\n          const upserted = await upsertLocatedSemanticVectors(runtimeContext.vectorStore, workload.documents, embedded.vectors);\n          refreshedResult = {\n            refreshed: upserted.refreshed,\n            skipped: upserted.skipped,\n            warnings: [...embedded.warnings, ...upserted.warnings],\n          };\n        }\n      } catch (error: unknown) {\n        refreshedResult = {\n          refreshed: [],\n          skipped: workload.documents.map((entry) => entry.id),\n          warnings: [`search_semantic_refresh_failed:${toErrorMessage(error)}`],\n        };\n      }\n    }\n  }\n  const pruneResult = await pruneMissingSemanticVectors(runtimeContext.vectorStore, workload.missingIds);\n  const refreshedIdSet = new Set(refreshedResult.refreshed);\n  const refreshedEntries = Object.fromEntries(\n    workload.documents\n      .filter((entry) => refreshedIdSet.has(entry.id))\n      .map((entry) => [entry.id, entry.document.metadata.updated_at]),\n  );\n  const ledgerWarnings: string[] = [];\n  if (Object.keys(refreshedEntries).length > 0 || workload.missingIds.length > 0) {\n    const nextEntries = {\n      ...nextLedgerBaseEntries,\n      ...normalizeVectorizationLedgerEntries(refreshedEntries),\n    };\n    for (const missingId of workload.missingIds) {\n      delete nextEntries[missingId];\n    }\n    try {\n      await writeVectorizationStatusLedger(pmRoot, nextEntries, nextEmbeddingMetadata);\n    } catch (error: unknown) {\n      ledgerWarnings.push(`search_vectorization_status_ledger_write_failed:${toErrorMessage(error)}`);\n    }\n    ledgerWarnings.push(...ledgerRead.warnings);\n  }\n\n  return {\n    refreshed: toUniqueSorted([...refreshedResult.refreshed, ...pruneResult.refreshed]),\n    skipped: toUniqueSorted([...workload.skippedIds, ...refreshedResult.skipped, ...pruneResult.skipped]),\n    warnings: [...workload.warnings, ...refreshedResult.warnings, ...pruneResult.warnings, ...ledgerWarnings],\n  };\n}\n\n/**\n * Returns true when a semantic embedding refresh would do real work for these\n * settings (an embedding provider AND a vector store both resolve). Used to\n * decide whether a mutation's refresh is worth dispatching to a background\n * worker — when semantic search is not configured the inline path is already a\n * fast no-op and no child is spawned.\n */\nexport function isSemanticRefreshActive(\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  applyRuntimeDefaults: boolean,\n): boolean {\n  const effectiveSettings = applyRuntimeDefaults\n    ? resolveSettingsWithSemanticRuntimeDefaults(settings).settings\n    : settings;\n  return Boolean(resolveEmbeddingProviders(effectiveSettings).active && resolveVectorStores(effectiveSettings).active);\n}\n\n/**\n * Implements refresh search artifacts for mutation for the public runtime surface of this module.\n */\nexport async function refreshSearchArtifactsForMutation(\n  pmRoot: string,\n  itemIds: string[],\n  options: RefreshSearchArtifactsForMutationOptions = {},\n): Promise<SearchMutationArtifactRefreshResult> {\n  const invalidation = await invalidateSearchCacheArtifacts(pmRoot);\n  const normalizedItemIds = toUniqueSorted(itemIds);\n  if (normalizedItemIds.length === 0) {\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: [],\n      warnings: invalidation.warnings,\n    };\n  }\n\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    const semanticRefresh = await refreshSemanticEmbeddingsForMutatedItems(pmRoot, normalizedItemIds);\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: semanticRefresh.refreshed,\n      skipped: semanticRefresh.skipped,\n      warnings: [...invalidation.warnings, ...semanticRefresh.warnings],\n    };\n  }\n\n  let settings: Awaited<ReturnType<typeof readSettings>>;\n  try {\n    settings = await readSettings(pmRoot);\n  } catch (error: unknown) {\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: normalizedItemIds,\n      warnings: [\n        ...invalidation.warnings,\n        `search_semantic_refresh_skipped:settings_read_failed:${toErrorMessage(error)}`,\n      ],\n    };\n  }\n\n  if (settings.search.mutation_refresh_policy === \"cache_only\") {\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: normalizedItemIds,\n      warnings: invalidation.warnings,\n    };\n  }\n\n  const applyRuntimeDefaults = settings.search.mutation_refresh_policy === \"semantic_auto\";\n\n  // Keyword cache is already invalidated synchronously above (so keyword search\n  // stays immediately correct). When requested, dispatch the slow embedding\n  // refresh to a detached worker so the mutation returns instantly; the\n  // vector_index_stale health/search warning covers the catch-up window.\n  if (options.background && isSemanticRefreshActive(settings, applyRuntimeDefaults)) {\n    await scheduleBackgroundSemanticRefresh(pmRoot, normalizedItemIds);\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: [],\n      warnings: [...invalidation.warnings, \"search_semantic_refresh_scheduled_background\"],\n      scheduled: true,\n    };\n  }\n\n  const semanticRefresh = await refreshSemanticEmbeddingsForMutatedItems(pmRoot, normalizedItemIds, {\n    settings,\n    apply_runtime_defaults: applyRuntimeDefaults,\n  });\n  return {\n    invalidated: invalidation.invalidated,\n    refreshed: semanticRefresh.refreshed,\n    skipped: semanticRefresh.skipped,\n    warnings: [...invalidation.warnings, ...semanticRefresh.warnings],\n  };\n}\n\nexport const _testOnly = {\n  buildSkippedSemanticRefreshResult,\n  buildVectorizationIdentityForProvider,\n  normalizeVectorizationLedgerEntries,\n  resetSemanticVectorStore,\n};\n"],"names":[],"mappings":"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","debugId":"81b33560-411e-51e7-8009-cf3615d51a2a"}
+{"version":3,"file":"cache.js","sources":["core/search/cache.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/search/cache\n *\n * Powers search, embeddings, and semantic retrieval behavior for Cache.\n */\nimport path from \"node:path\";\nimport { getActiveExtensionRegistrations } from \"../extensions/index.js\";\nimport { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { resolveItemTypeRegistry } from \"../item/type-registry.js\";\nimport { toErrorMessage } from \"../shared/primitives.js\";\nimport { locateItem, readLocatedItem } from \"../store/item-store.js\";\nimport { getSettingsPath } from \"../store/paths.js\";\nimport { readSettings } from \"../store/settings.js\";\nimport { executeEmbeddingBatchesWithRetry } from \"./embedding-batches.js\";\nimport {\n  buildSemanticCorpusInput,\n  resolveSearchCorpusFields,\n  resolveSemanticCorpusCharacterLimit,\n} from \"./corpus.js\";\nimport { resolveEmbeddingProviders } from \"./providers.js\";\nimport type { EmbeddingProviderConfig } from \"./providers.js\";\nimport { resolveSettingsWithSemanticRuntimeDefaults } from \"./semantic-defaults.js\";\nimport { scheduleBackgroundSemanticRefresh } from \"./background-refresh.js\";\nimport { executeVectorDelete, executeVectorReset, executeVectorUpsert, resolveVectorStores } from \"./vector-stores.js\";\nimport type { VectorStoreConfig } from \"./vector-stores.js\";\nimport {\n  buildVectorizationEmbeddingIdentity,\n  buildVectorizationEmbeddingMetadata,\n  hasVectorizationEmbeddingIdentityChanged,\n  hasVectorizationVectorDimensionChanged,\n  inferConsistentVectorDimension,\n  normalizeVectorizationEmbeddingMetadata,\n} from \"./vectorization-metadata.js\";\nimport type {\n  VectorizationEmbeddingIdentity,\n  VectorizationEmbeddingMetadata,\n} from \"./vectorization-metadata.js\";\nimport { nowIso } from \"../shared/time.js\";\nimport type { ItemDocument, ItemFrontMatter } from \"../../types/index.js\";\n\nexport const SEARCH_CACHE_ARTIFACT_PATHS = [\"index/manifest.json\", \"search/embeddings.jsonl\"] as const;\nexport const VECTORIZATION_STATUS_LEDGER_PATH = \"search/vectorization-status.json\";\n\n/**\n * Documents the search cache invalidation result payload exchanged by command, SDK, and package integrations.\n */\nexport interface SearchCacheInvalidationResult {\n  invalidated: string[];\n  warnings: string[];\n}\n\n/**\n * Documents the semantic mutation refresh result payload exchanged by command, SDK, and package integrations.\n */\nexport interface SemanticMutationRefreshResult {\n  refreshed: string[];\n  skipped: string[];\n  warnings: string[];\n}\n\n/**\n * Documents the search mutation artifact refresh result payload exchanged by command, SDK, and package integrations.\n */\nexport interface SearchMutationArtifactRefreshResult extends SearchCacheInvalidationResult {\n  refreshed: string[];\n  skipped: string[];\n  /** True when the semantic refresh was dispatched to a detached background worker. */\n  scheduled?: boolean;\n}\n\n/**\n * Documents the refresh search artifacts for mutation options payload exchanged by command, SDK, and package integrations.\n */\nexport interface RefreshSearchArtifactsForMutationOptions {\n  /**\n   * When true and semantic search is active, the (slow) embedding refresh is\n   * dispatched to a detached background worker instead of awaited inline so the\n   * mutation returns immediately. The synchronous keyword-cache invalidation\n   * still runs first. Callers pass this only outside test runners.\n   */\n  background?: boolean;\n}\n\n/**\n * Documents the semantic refresh options payload exchanged by command, SDK, and package integrations.\n */\nexport interface SemanticRefreshOptions {\n  settings?: Awaited<ReturnType<typeof readSettings>>;\n  apply_runtime_defaults?: boolean;\n}\n\n/**\n * Documents the vectorization status ledger read result payload exchanged by command, SDK, and package integrations.\n */\nexport interface VectorizationStatusLedgerReadResult {\n  entries: Record<string, string>;\n  embedding: VectorizationEmbeddingMetadata | null;\n  warnings: string[];\n}\n\nfunction formatInvalidationWarning(relativePath: string, error: unknown): string {\n  return `search_cache_invalidation_failed:${relativePath}:${String(error)}`;\n}\n\n\nfunction toUniqueSorted(values: Iterable<string>): string[] {\n  return [...new Set([...values].map((value) => value.trim()).filter((value) => value.length > 0))]\n    .sort((left, right) => left.localeCompare(right));\n}\n\nfunction isValidUpdatedAt(value: unknown): value is string {\n  return typeof value === \"string\" && value.trim().length > 0 && Number.isFinite(Date.parse(value));\n}\n\nfunction normalizeVectorizationLedgerEntries(entries: Record<string, string>): Record<string, string> {\n  const normalized = new Map<string, string>();\n  for (const [rawId, rawUpdatedAt] of Object.entries(entries)) {\n    const id = rawId.trim();\n    if (id.length === 0 || !isValidUpdatedAt(rawUpdatedAt)) {\n      continue;\n    }\n    normalized.set(id, rawUpdatedAt);\n  }\n  return Object.fromEntries([...normalized.entries()].sort((left, right) => left[0].localeCompare(right[0])));\n}\n\n/**\n * Implements read vectorization status ledger for the public runtime surface of this module.\n */\nexport async function readVectorizationStatusLedger(pmRoot: string): Promise<VectorizationStatusLedgerReadResult> {\n  const ledgerPath = path.join(pmRoot, VECTORIZATION_STATUS_LEDGER_PATH);\n  const raw = await readFileIfExists(ledgerPath);\n  if (raw === null || raw.trim().length === 0) {\n    return {\n      entries: {},\n      embedding: null,\n      warnings: [],\n    };\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    return {\n      entries: {},\n      embedding: null,\n      warnings: [\"search_vectorization_status_ledger_invalid\"],\n    };\n  }\n\n  if (\n    typeof parsed !== \"object\" ||\n    parsed === null ||\n    (parsed as { version?: unknown }).version !== 1 ||\n    !Array.isArray((parsed as { items?: unknown }).items)\n  ) {\n    return {\n      entries: {},\n      embedding: null,\n      warnings: [\"search_vectorization_status_ledger_invalid\"],\n    };\n  }\n\n  const mapped = new Map<string, string>();\n  for (const entry of (parsed as { items: unknown[] }).items) {\n    if (typeof entry !== \"object\" || entry === null) {\n      return {\n        entries: {},\n        embedding: null,\n        warnings: [\"search_vectorization_status_ledger_invalid\"],\n      };\n    }\n    const id = (entry as { id?: unknown }).id;\n    const updatedAt = (entry as { updated_at?: unknown }).updated_at;\n    if (typeof id !== \"string\" || id.trim().length === 0 || !isValidUpdatedAt(updatedAt)) {\n      return {\n        entries: {},\n        embedding: null,\n        warnings: [\"search_vectorization_status_ledger_invalid\"],\n      };\n    }\n    mapped.set(id.trim(), updatedAt);\n  }\n\n  let embedding: VectorizationEmbeddingMetadata | null = null;\n  try {\n    embedding = normalizeVectorizationEmbeddingMetadata((parsed as { embedding?: unknown }).embedding);\n  } catch {\n    return {\n      entries: {},\n      embedding: null,\n      warnings: [\"search_vectorization_status_ledger_invalid\"],\n    };\n  }\n\n  return {\n    entries: Object.fromEntries([...mapped.entries()].sort((left, right) => left[0].localeCompare(right[0]))),\n    embedding,\n    warnings: [],\n  };\n}\n\n/**\n * Implements write vectorization status ledger for the public runtime surface of this module.\n */\nexport async function writeVectorizationStatusLedger(\n  pmRoot: string,\n  entries: Record<string, string>,\n  embedding?: VectorizationEmbeddingMetadata | null,\n): Promise<void> {\n  const normalizedEntries = normalizeVectorizationLedgerEntries(entries);\n  const ledgerPath = path.join(pmRoot, VECTORIZATION_STATUS_LEDGER_PATH);\n  const serialized = `${JSON.stringify(\n    {\n      version: 1,\n      generated_at: nowIso(),\n      ...(embedding ? { embedding } : {}),\n      items: Object.entries(normalizedEntries).map(([id, updated_at]) => ({\n        id,\n        updated_at,\n      })),\n    },\n    null,\n    2,\n  )}\\n`;\n  await writeFileAtomic(ledgerPath, serialized);\n}\n\nfunction buildVectorPayload(item: ItemFrontMatter): Record<string, unknown> {\n  return {\n    id: item.id,\n    type: item.type,\n    status: item.status,\n    priority: item.priority,\n    updated_at: item.updated_at,\n  };\n}\n\ninterface SemanticRefreshRuntimeContext {\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  provider: EmbeddingProviderConfig;\n  vectorStore: VectorStoreConfig;\n}\n\ninterface SemanticRefreshWorkload {\n  documents: Array<{ id: string; document: ItemDocument }>;\n  missingIds: string[];\n  skippedIds: string[];\n  warnings: string[];\n}\n\ninterface SemanticRefreshOperationResult {\n  refreshed: string[];\n  skipped: string[];\n  warnings: string[];\n}\n\ninterface SemanticEmbeddingOperationResult {\n  vectors: number[][];\n  vector_dimension: number;\n  warnings: string[];\n}\n\nfunction buildVectorizationIdentityForProvider(provider: EmbeddingProviderConfig): VectorizationEmbeddingIdentity {\n  const identity = buildVectorizationEmbeddingIdentity(provider.name, provider.model);\n  if (!identity) {\n    throw new Error(\"Embedding provider must include a provider name and model\");\n  }\n  return identity;\n}\n\nfunction buildSkippedSemanticRefreshResult(itemIds: string[], warning: string): SemanticMutationRefreshResult {\n  return {\n    refreshed: [],\n    skipped: itemIds,\n    warnings: [warning],\n  };\n}\n\nasync function resolveSemanticRefreshRuntimeContext(\n  pmRoot: string,\n  normalizedItemIds: string[],\n  options: SemanticRefreshOptions,\n): Promise<SemanticRefreshRuntimeContext | SemanticMutationRefreshResult> {\n  if (!options.settings && !(await pathExists(getSettingsPath(pmRoot)))) {\n    return buildSkippedSemanticRefreshResult(normalizedItemIds, \"search_semantic_refresh_skipped:settings_not_initialized\");\n  }\n\n  let settings: Awaited<ReturnType<typeof readSettings>>;\n  try {\n    settings = options.settings ?? (await readSettings(pmRoot));\n  } catch (error: unknown) {\n    return buildSkippedSemanticRefreshResult(\n      normalizedItemIds,\n      `search_semantic_refresh_skipped:settings_read_failed:${toErrorMessage(error)}`,\n    );\n  }\n  const effectiveSettings = options.apply_runtime_defaults\n    ? resolveSettingsWithSemanticRuntimeDefaults(settings).settings\n    : settings;\n\n  const provider = resolveEmbeddingProviders(effectiveSettings).active;\n  if (!provider) {\n    return buildSkippedSemanticRefreshResult(normalizedItemIds, \"search_semantic_refresh_skipped:provider_unconfigured\");\n  }\n  const vectorStore = resolveVectorStores(effectiveSettings, pmRoot).active;\n  if (!vectorStore) {\n    return buildSkippedSemanticRefreshResult(normalizedItemIds, \"search_semantic_refresh_skipped:vector_store_unconfigured\");\n  }\n\n  return {\n    settings: effectiveSettings,\n    provider,\n    vectorStore,\n  };\n}\n\nasync function collectSemanticRefreshWorkload(\n  pmRoot: string,\n  idPrefix: string,\n  preferredFormat: \"toon\" | \"json_markdown\",\n  normalizedItemIds: string[],\n  typeToFolder: Record<string, string>,\n  schema: Awaited<ReturnType<typeof readSettings>>[\"schema\"],\n): Promise<SemanticRefreshWorkload> {\n  const warnings: string[] = [];\n  const skipped = new Set<string>();\n  const missing = new Set<string>();\n  const documents: Array<{ id: string; document: ItemDocument }> = [];\n\n  for (const itemId of normalizedItemIds) {\n    const located = await locateItem(pmRoot, itemId, idPrefix, preferredFormat, typeToFolder);\n    if (!located) {\n      missing.add(itemId);\n      continue;\n    }\n\n    try {\n      const loaded = await readLocatedItem(located, { schema });\n      documents.push({\n        id: loaded.document.metadata.id,\n        document: loaded.document,\n      });\n    } catch (error: unknown) {\n      skipped.add(located.id);\n      warnings.push(`search_semantic_refresh_item_read_failed:${located.id}:${toErrorMessage(error)}`);\n    }\n  }\n\n  documents.sort((left, right) => left.id.localeCompare(right.id));\n  return {\n    documents,\n    missingIds: toUniqueSorted(missing),\n    skippedIds: toUniqueSorted(skipped),\n    warnings,\n  };\n}\n\nasync function embedLocatedSemanticVectors(\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  provider: EmbeddingProviderConfig,\n  documents: Array<{ id: string; document: ItemDocument }>,\n): Promise<SemanticEmbeddingOperationResult> {\n  const corpusCharacterLimit = resolveSemanticCorpusCharacterLimit(\n    provider.name,\n    settings.search.embedding_corpus_max_characters,\n  ).maxCharacters;\n  const corpusFields = resolveSearchCorpusFields(settings);\n  const corpusInputs = documents.map((entry) =>\n    buildSemanticCorpusInput(entry.document, {\n      providerName: provider.name,\n      maxCharacters: corpusCharacterLimit,\n      fields: corpusFields,\n    }),\n  );\n  const embeddingResult = await executeEmbeddingBatchesWithRetry(provider, settings, corpusInputs);\n  return {\n    vectors: embeddingResult.vectors,\n    vector_dimension: inferConsistentVectorDimension(embeddingResult.vectors, \"Semantic refresh embedding\"),\n    warnings: embeddingResult.warnings,\n  };\n}\n\nasync function upsertLocatedSemanticVectors(\n  vectorStore: VectorStoreConfig,\n  documents: Array<{ id: string; document: ItemDocument }>,\n  vectors: number[][],\n): Promise<SemanticRefreshOperationResult> {\n  await executeVectorUpsert(\n    vectorStore,\n    documents.map((entry, index) => ({\n      id: entry.id,\n      vector: vectors[index],\n      payload: buildVectorPayload(entry.document.metadata),\n    })),\n  );\n  return {\n    refreshed: documents.map((entry) => entry.id),\n    skipped: [],\n    warnings: [],\n  };\n}\n\nasync function resetSemanticVectorStore(\n  vectorStore: VectorStoreConfig,\n  ledgerEntries: Record<string, string>,\n): Promise<SemanticRefreshOperationResult> {\n  try {\n    await executeVectorReset(vectorStore, Object.keys(ledgerEntries));\n    return { refreshed: [], skipped: [], warnings: [] };\n  } catch (error: unknown) {\n    return {\n      refreshed: [],\n      skipped: [],\n      warnings: [`search_semantic_refresh_reset_failed:${toErrorMessage(error)}`],\n    };\n  }\n}\n\nasync function pruneMissingSemanticVectors(\n  vectorStore: VectorStoreConfig,\n  missingIds: string[],\n): Promise<SemanticRefreshOperationResult> {\n  if (missingIds.length === 0) {\n    return { refreshed: [], skipped: [], warnings: [] };\n  }\n  try {\n    await executeVectorDelete(vectorStore, missingIds);\n    return {\n      refreshed: [],\n      skipped: [],\n      warnings: [],\n    };\n  } catch (error: unknown) {\n    return {\n      refreshed: [],\n      skipped: missingIds,\n      warnings: [`search_semantic_refresh_delete_failed:${toErrorMessage(error)}`],\n    };\n  }\n}\n\n/**\n * Implements invalidate search cache artifacts for the public runtime surface of this module.\n */\nexport async function invalidateSearchCacheArtifacts(pmRoot: string): Promise<SearchCacheInvalidationResult> {\n  const invalidated: string[] = [];\n  const warnings: string[] = [];\n\n  for (const relativePath of SEARCH_CACHE_ARTIFACT_PATHS) {\n    const artifactPath = path.join(pmRoot, relativePath);\n    try {\n      if (!(await pathExists(artifactPath))) {\n        continue;\n      }\n      await removeFileIfExists(artifactPath);\n      invalidated.push(relativePath);\n    } catch (error: unknown) {\n      warnings.push(formatInvalidationWarning(relativePath, error));\n    }\n  }\n\n  return {\n    invalidated,\n    warnings,\n  };\n}\n\n/**\n * Implements refresh semantic embeddings for mutated items for the public runtime surface of this module.\n */\nexport async function refreshSemanticEmbeddingsForMutatedItems(\n  pmRoot: string,\n  itemIds: string[],\n  options: SemanticRefreshOptions = {},\n): Promise<SemanticMutationRefreshResult> {\n  const normalizedItemIds = toUniqueSorted(itemIds);\n  if (normalizedItemIds.length === 0) {\n    return {\n      refreshed: [],\n      skipped: [],\n      warnings: [],\n    };\n  }\n\n  const runtimeContext = await resolveSemanticRefreshRuntimeContext(pmRoot, normalizedItemIds, options);\n  if (!(\"settings\" in runtimeContext)) {\n    return runtimeContext;\n  }\n  const typeRegistry = resolveItemTypeRegistry(runtimeContext.settings, getActiveExtensionRegistrations());\n  const workload = await collectSemanticRefreshWorkload(\n    pmRoot,\n    runtimeContext.settings.id_prefix,\n    runtimeContext.settings.item_format,\n    normalizedItemIds,\n    typeRegistry.type_to_folder,\n    runtimeContext.settings.schema,\n  );\n  const ledgerRead =\n    workload.documents.length > 0 || workload.missingIds.length > 0\n      ? await readVectorizationStatusLedger(pmRoot)\n      : { entries: {}, embedding: null, warnings: [] };\n  const embeddingIdentity = buildVectorizationIdentityForProvider(runtimeContext.provider);\n  const nextLedgerBaseEntries = ledgerRead.entries;\n  let refreshedResult: SemanticRefreshOperationResult = { refreshed: [], skipped: [], warnings: [] };\n  let nextEmbeddingMetadata = ledgerRead.embedding;\n  if (workload.documents.length > 0) {\n    if (ledgerRead.embedding && hasVectorizationEmbeddingIdentityChanged(ledgerRead.embedding, embeddingIdentity)) {\n      refreshedResult = {\n        refreshed: [],\n        skipped: workload.documents.map((entry) => entry.id),\n        warnings: [\"search_semantic_refresh_requires_reindex:embedding_identity_changed\"],\n      };\n    } else {\n      try {\n        const embedded = await embedLocatedSemanticVectors(\n          runtimeContext.settings,\n          runtimeContext.provider,\n          workload.documents,\n        );\n        if (hasVectorizationVectorDimensionChanged(ledgerRead.embedding, embedded.vector_dimension)) {\n          refreshedResult = {\n            refreshed: [],\n            skipped: workload.documents.map((entry) => entry.id),\n            warnings: [...embedded.warnings, \"search_semantic_refresh_requires_reindex:vector_dimension_changed\"],\n          };\n        } else {\n          nextEmbeddingMetadata = buildVectorizationEmbeddingMetadata(embeddingIdentity, embedded.vector_dimension);\n          const upserted = await upsertLocatedSemanticVectors(runtimeContext.vectorStore, workload.documents, embedded.vectors);\n          refreshedResult = {\n            refreshed: upserted.refreshed,\n            skipped: upserted.skipped,\n            warnings: [...embedded.warnings, ...upserted.warnings],\n          };\n        }\n      } catch (error: unknown) {\n        refreshedResult = {\n          refreshed: [],\n          skipped: workload.documents.map((entry) => entry.id),\n          warnings: [`search_semantic_refresh_failed:${toErrorMessage(error)}`],\n        };\n      }\n    }\n  }\n  const pruneResult = await pruneMissingSemanticVectors(runtimeContext.vectorStore, workload.missingIds);\n  const refreshedIdSet = new Set(refreshedResult.refreshed);\n  const refreshedEntries = Object.fromEntries(\n    workload.documents\n      .filter((entry) => refreshedIdSet.has(entry.id))\n      .map((entry) => [entry.id, entry.document.metadata.updated_at]),\n  );\n  const ledgerWarnings: string[] = [];\n  if (Object.keys(refreshedEntries).length > 0 || workload.missingIds.length > 0) {\n    const nextEntries = {\n      ...nextLedgerBaseEntries,\n      ...normalizeVectorizationLedgerEntries(refreshedEntries),\n    };\n    for (const missingId of workload.missingIds) {\n      delete nextEntries[missingId];\n    }\n    try {\n      await writeVectorizationStatusLedger(pmRoot, nextEntries, nextEmbeddingMetadata);\n    } catch (error: unknown) {\n      ledgerWarnings.push(`search_vectorization_status_ledger_write_failed:${toErrorMessage(error)}`);\n    }\n    ledgerWarnings.push(...ledgerRead.warnings);\n  }\n\n  return {\n    refreshed: toUniqueSorted([...refreshedResult.refreshed, ...pruneResult.refreshed]),\n    skipped: toUniqueSorted([...workload.skippedIds, ...refreshedResult.skipped, ...pruneResult.skipped]),\n    warnings: [...workload.warnings, ...refreshedResult.warnings, ...pruneResult.warnings, ...ledgerWarnings],\n  };\n}\n\n/**\n * Returns true when a semantic embedding refresh would do real work for these\n * settings (an embedding provider AND a vector store both resolve). Used to\n * decide whether a mutation's refresh is worth dispatching to a background\n * worker — when semantic search is not configured the inline path is already a\n * fast no-op and no child is spawned.\n */\nexport function isSemanticRefreshActive(\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  applyRuntimeDefaults: boolean,\n): boolean {\n  const effectiveSettings = applyRuntimeDefaults\n    ? resolveSettingsWithSemanticRuntimeDefaults(settings).settings\n    : settings;\n  return Boolean(resolveEmbeddingProviders(effectiveSettings).active && resolveVectorStores(effectiveSettings).active);\n}\n\n/**\n * Implements refresh search artifacts for mutation for the public runtime surface of this module.\n */\nexport async function refreshSearchArtifactsForMutation(\n  pmRoot: string,\n  itemIds: string[],\n  options: RefreshSearchArtifactsForMutationOptions = {},\n): Promise<SearchMutationArtifactRefreshResult> {\n  const invalidation = await invalidateSearchCacheArtifacts(pmRoot);\n  const normalizedItemIds = toUniqueSorted(itemIds);\n  if (normalizedItemIds.length === 0) {\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: [],\n      warnings: invalidation.warnings,\n    };\n  }\n\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    const semanticRefresh = await refreshSemanticEmbeddingsForMutatedItems(pmRoot, normalizedItemIds);\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: semanticRefresh.refreshed,\n      skipped: semanticRefresh.skipped,\n      warnings: [...invalidation.warnings, ...semanticRefresh.warnings],\n    };\n  }\n\n  let settings: Awaited<ReturnType<typeof readSettings>>;\n  try {\n    settings = await readSettings(pmRoot);\n  } catch (error: unknown) {\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: normalizedItemIds,\n      warnings: [\n        ...invalidation.warnings,\n        `search_semantic_refresh_skipped:settings_read_failed:${toErrorMessage(error)}`,\n      ],\n    };\n  }\n\n  if (settings.search.mutation_refresh_policy === \"cache_only\") {\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: normalizedItemIds,\n      warnings: invalidation.warnings,\n    };\n  }\n\n  const applyRuntimeDefaults = settings.search.mutation_refresh_policy === \"semantic_auto\";\n\n  // Keyword cache is already invalidated synchronously above (so keyword search\n  // stays immediately correct). When requested, dispatch the slow embedding\n  // refresh to a detached worker so the mutation returns instantly; the\n  // vector_index_stale health/search warning covers the catch-up window.\n  if (options.background && isSemanticRefreshActive(settings, applyRuntimeDefaults)) {\n    await scheduleBackgroundSemanticRefresh(pmRoot, normalizedItemIds);\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: [],\n      warnings: [...invalidation.warnings, \"search_semantic_refresh_scheduled_background\"],\n      scheduled: true,\n    };\n  }\n\n  const semanticRefresh = await refreshSemanticEmbeddingsForMutatedItems(pmRoot, normalizedItemIds, {\n    settings,\n    apply_runtime_defaults: applyRuntimeDefaults,\n  });\n  return {\n    invalidated: invalidation.invalidated,\n    refreshed: semanticRefresh.refreshed,\n    skipped: semanticRefresh.skipped,\n    warnings: [...invalidation.warnings, ...semanticRefresh.warnings],\n  };\n}\n\nexport const _testOnly = {\n  buildSkippedSemanticRefreshResult,\n  buildVectorizationIdentityForProvider,\n  normalizeVectorizationLedgerEntries,\n  resetSemanticVectorStore,\n};\n"],"names":[],"mappings":"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","debugId":"0af5c45d-b1b3-543b-aa4a-a70d52010fac"}

package/dist/core/search/semantic-defaults.d.ts

@@ -5,6 +5,8 @@ import type { PmSettings } from "../../types/index.js";
 export interface SemanticRuntimeDefaultsResolution {
     settings: PmSettings;
     auto_ollama_defaults_applied: boolean;
+    auto_ollama_defaults_skipped_reason?: "no_installed_embedding_model";
+    auto_ollama_defaults_remediation?: string;
 }
 /**
  * Implements resolve settings with semantic runtime defaults for the public runtime surface of this module.

package/dist/core/search/semantic-defaults.js

@@ -4,13 +4,13 @@
  * Powers search, embeddings, and semantic retrieval behavior for Semantic Defaults.
  */
 
-!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]="e60fbb33-d9f9-5212-a26d-628e6e2e6fd9")}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]="7e8365ed-5fc5-5a75-a0a5-3db958c07f88")}catch(e){}}();
 import { spawnSync } from "node:child_process";
 import { toNonEmptyString } from "../shared/primitives.js";
 const DISABLE_AUTO_DEFAULTS_ENV = "PM_DISABLE_OLLAMA_AUTO_DEFAULTS";
 const OLLAMA_MODEL_ENV = "PM_OLLAMA_MODEL";
 const DEFAULT_OLLAMA_BASE_URL = "http://localhost:11434";
-const DEFAULT_OLLAMA_MODEL = "qwen3-embedding:0.6b";
+const RECOMMENDED_OLLAMA_EMBEDDING_MODEL = "qwen3-embedding:0.6b";
 const DEFAULT_LANCEDB_PATH = ".agents/pm/search/lancedb/";
 const OLLAMA_VERSION_TIMEOUT_MS = 1_500;
 const OLLAMA_LIST_TIMEOUT_MS = 2_500;
@@ -114,7 +114,7 @@ function resolveAutoOllamaModel(settings) {
             return listedModel;
         }
     }
-    return DEFAULT_OLLAMA_MODEL;
+    return null;
 }
 function resolveSemanticDefaultNeeds(settings) {
     return {
@@ -184,6 +184,13 @@ export function resolveSettingsWithSemanticRuntimeDefaults(settings) {
     }
     const nextSettings = structuredClone(settings);
     const resolvedModel = resolveAutoOllamaModel(nextSettings);
+    if (!resolvedModel) {
+        return {
+            ...unchanged,
+            auto_ollama_defaults_skipped_reason: "no_installed_embedding_model",
+            auto_ollama_defaults_remediation: `Run ollama pull ${RECOMMENDED_OLLAMA_EMBEDDING_MODEL} or configure providers.ollama.model explicitly (and search.embedding_model if you need an override).`,
+        };
+    }
     // `readSettings` always normalizes these nested objects, but this function is
     // exported and runs on the search hot path with caller-supplied settings, so a
     // partial object (e.g. providers/vector_store set but no `search` block) must
@@ -197,4 +204,4 @@ export function resolveSettingsWithSemanticRuntimeDefaults(settings) {
     };
 }
 //# sourceMappingURL=semantic-defaults.js.map
-//# debugId=e60fbb33-d9f9-5212-a26d-628e6e2e6fd9
+//# debugId=7e8365ed-5fc5-5a75-a0a5-3db958c07f88

package/dist/core/search/semantic-defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"semantic-defaults.js","sources":["core/search/semantic-defaults.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/search/semantic-defaults\n *\n * Powers search, embeddings, and semantic retrieval behavior for Semantic Defaults.\n */\nimport { spawnSync } from \"node:child_process\";\nimport type { PmSettings } from \"../../types/index.js\";\nimport { toNonEmptyString } from \"../shared/primitives.js\";\n\nconst DISABLE_AUTO_DEFAULTS_ENV = \"PM_DISABLE_OLLAMA_AUTO_DEFAULTS\";\nconst OLLAMA_MODEL_ENV = \"PM_OLLAMA_MODEL\";\nconst DEFAULT_OLLAMA_BASE_URL = \"http://localhost:11434\";\nconst DEFAULT_OLLAMA_MODEL = \"qwen3-embedding:0.6b\";\nconst DEFAULT_LANCEDB_PATH = \".agents/pm/search/lancedb/\";\nconst OLLAMA_VERSION_TIMEOUT_MS = 1_500;\nconst OLLAMA_LIST_TIMEOUT_MS = 2_500;\nconst QWEN_EMBEDDING_MODEL_PATTERN = /qwen.*(?:embed|embedding)|(?:embed|embedding).*qwen/i;\nconst EMBEDDING_MODEL_PATTERN = /embed|embedding/i;\n\n/**\n * Documents the semantic runtime defaults resolution payload exchanged by command, SDK, and package integrations.\n */\nexport interface SemanticRuntimeDefaultsResolution {\n  settings: PmSettings;\n  auto_ollama_defaults_applied: boolean;\n}\n\nconst toOptionalNonEmptyString = toNonEmptyString;\n\nfunction isAutoDefaultsDisabled(): boolean {\n  const raw = toOptionalNonEmptyString(process.env[DISABLE_AUTO_DEFAULTS_ENV]);\n  if (!raw) {\n    return false;\n  }\n  const normalized = raw.toLowerCase();\n  return normalized === \"1\" || normalized === \"true\" || normalized === \"yes\";\n}\n\nfunction hasConfiguredValue(values: readonly unknown[]): boolean {\n  return values.some((entry) => toOptionalNonEmptyString(entry) !== null);\n}\n\nfunction hasCompetingProvider(provider: unknown): boolean {\n  const normalized = toOptionalNonEmptyString(provider);\n  return Boolean(normalized && normalized.toLowerCase() !== \"ollama\");\n}\n\nfunction hasCompetingVectorAdapter(adapter: unknown): boolean {\n  const normalized = toOptionalNonEmptyString(adapter);\n  return Boolean(normalized && normalized.toLowerCase() !== \"lancedb\");\n}\n\n/**\n * True only when the user has opted into a provider/store that COMPETES with the\n * Ollama + LanceDB auto-default stack: an explicit non-Ollama search provider, a\n * non-LanceDB vector adapter, or any OpenAI/Qdrant credentials. A partial Ollama\n * setup (e.g. only `ollama.base_url`) is NOT competing — its missing leaves are\n * filled per-field below so a single config write can never silently disable\n * semantic search and then hard-error `pm reindex`.\n */\nfunction hasCompetingSemanticConfiguration(settings: PmSettings): boolean {\n  if (hasCompetingProvider(settings.search?.provider)) {\n    return true;\n  }\n  if (hasCompetingVectorAdapter(settings.vector_store?.adapter)) {\n    return true;\n  }\n  if (hasConfiguredValue([\n    settings.providers?.openai?.base_url,\n    settings.providers?.openai?.model,\n    settings.providers?.openai?.api_key,\n  ])) {\n    return true;\n  }\n  return hasConfiguredValue([\n    settings.vector_store?.qdrant?.url,\n    settings.vector_store?.qdrant?.api_key,\n  ]);\n}\n\nfunction isOllamaInstalled(): boolean {\n  const result = spawnSync(\"ollama\", [\"--version\"], {\n    encoding: \"utf8\",\n    timeout: OLLAMA_VERSION_TIMEOUT_MS,\n  });\n  if (result.error) {\n    return false;\n  }\n  return result.status === 0;\n}\n\nfunction parseOllamaModelList(output: string): string | null {\n  const lines = output\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0);\n  if (lines.length === 0) {\n    return null;\n  }\n  const models = lines\n    .map((line) => line.split(/\\s+/)[0]?.trim())\n    .filter((entry): entry is string => Boolean(entry && entry.length > 0))\n    .filter((entry) => entry.toUpperCase() !== \"NAME\");\n  if (models.length === 0) {\n    return null;\n  }\n  const preferredQwenEmbeddingModel = models.find((entry) => QWEN_EMBEDDING_MODEL_PATTERN.test(entry));\n  if (preferredQwenEmbeddingModel) {\n    return preferredQwenEmbeddingModel;\n  }\n  const embeddingModel = models.find((entry) => EMBEDDING_MODEL_PATTERN.test(entry));\n  return embeddingModel ?? null;\n}\n\nfunction resolveAutoOllamaModel(settings: PmSettings): string {\n  const settingsModel = toOptionalNonEmptyString(settings.providers?.ollama?.model);\n  if (settingsModel) {\n    return settingsModel;\n  }\n  const envModel = toOptionalNonEmptyString(process.env[OLLAMA_MODEL_ENV]);\n  if (envModel) {\n    return envModel;\n  }\n  const listed = spawnSync(\"ollama\", [\"list\"], {\n    encoding: \"utf8\",\n    timeout: OLLAMA_LIST_TIMEOUT_MS,\n  });\n  if (!listed.error && listed.status === 0) {\n    const listedModel = parseOllamaModelList(typeof listed.stdout === \"string\" ? listed.stdout : \"\");\n    if (listedModel) {\n      return listedModel;\n    }\n  }\n  return DEFAULT_OLLAMA_MODEL;\n}\n\ninterface SemanticDefaultNeeds {\n  baseUrl: boolean;\n  model: boolean;\n  lancedbPath: boolean;\n  embeddingModel: boolean;\n}\n\nfunction resolveSemanticDefaultNeeds(settings: PmSettings): SemanticDefaultNeeds {\n  return {\n    baseUrl: toOptionalNonEmptyString(settings.providers?.ollama?.base_url) === null,\n    model: toOptionalNonEmptyString(settings.providers?.ollama?.model) === null,\n    lancedbPath: toOptionalNonEmptyString(settings.vector_store?.lancedb?.path) === null,\n    embeddingModel: toOptionalNonEmptyString(settings.search?.embedding_model) === null,\n  };\n}\n\nfunction needsAnySemanticDefault(needs: SemanticDefaultNeeds): boolean {\n  return needs.baseUrl || needs.model || needs.lancedbPath || needs.embeddingModel;\n}\n\nfunction applyOllamaProviderDefaults(settings: PmSettings, needs: SemanticDefaultNeeds, resolvedModel: string): void {\n  if (!needs.baseUrl && !needs.model) {\n    return;\n  }\n  const providers = (settings.providers ??= {} as PmSettings[\"providers\"]);\n  const ollama = (providers.ollama ??= {} as PmSettings[\"providers\"][\"ollama\"]);\n  if (needs.baseUrl) {\n    ollama.base_url = DEFAULT_OLLAMA_BASE_URL;\n  }\n  if (needs.model) {\n    ollama.model = resolvedModel;\n  }\n}\n\nfunction applyVectorStoreDefaults(settings: PmSettings, needs: SemanticDefaultNeeds): void {\n  if (!needs.lancedbPath) {\n    return;\n  }\n  const vectorStore = (settings.vector_store ??= {} as PmSettings[\"vector_store\"]);\n  const lancedb = (vectorStore.lancedb ??= {} as PmSettings[\"vector_store\"][\"lancedb\"]);\n  lancedb.path = DEFAULT_LANCEDB_PATH;\n}\n\nfunction applySearchEmbeddingDefaults(settings: PmSettings, needs: SemanticDefaultNeeds, resolvedModel: string): void {\n  if (!needs.embeddingModel) {\n    return;\n  }\n  const search = (settings.search ??= {} as PmSettings[\"search\"]);\n  search.embedding_model = resolvedModel;\n}\n\n/**\n * Implements resolve settings with semantic runtime defaults for the public runtime surface of this module.\n */\nexport function resolveSettingsWithSemanticRuntimeDefaults(settings: PmSettings): SemanticRuntimeDefaultsResolution {\n  const unchanged: SemanticRuntimeDefaultsResolution = {\n    settings,\n    auto_ollama_defaults_applied: false,\n  };\n  if (isAutoDefaultsDisabled()) {\n    return unchanged;\n  }\n  if (hasCompetingSemanticConfiguration(settings)) {\n    return unchanged;\n  }\n\n  const needs = resolveSemanticDefaultNeeds(settings);\n  if (!needsAnySemanticDefault(needs)) {\n    // A fully-configured Ollama/LanceDB stack — nothing to fill, and no need to\n    // probe for Ollama at all.\n    return unchanged;\n  }\n\n  // Auto-discovering the embedding model (via `ollama list`) is the only step that\n  // requires Ollama to be installed. When a model is already configured we mirror it\n  // into the remaining leaves without forcing an Ollama probe; when it is missing we\n  // require Ollama to actually be present rather than writing an unusable default.\n  if (needs.model && !isOllamaInstalled()) {\n    return unchanged;\n  }\n\n  const nextSettings = structuredClone(settings);\n  const resolvedModel = resolveAutoOllamaModel(nextSettings);\n  // `readSettings` always normalizes these nested objects, but this function is\n  // exported and runs on the search hot path with caller-supplied settings, so a\n  // partial object (e.g. providers/vector_store set but no `search` block) must\n  // fill the missing leaf rather than throwing on an undefined parent.\n  applyOllamaProviderDefaults(nextSettings, needs, resolvedModel);\n  applyVectorStoreDefaults(nextSettings, needs);\n  applySearchEmbeddingDefaults(nextSettings, needs, resolvedModel);\n  return {\n    settings: nextSettings,\n    auto_ollama_defaults_applied: true,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"e60fbb33-d9f9-5212-a26d-628e6e2e6fd9"}
+{"version":3,"file":"semantic-defaults.js","sources":["core/search/semantic-defaults.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/search/semantic-defaults\n *\n * Powers search, embeddings, and semantic retrieval behavior for Semantic Defaults.\n */\nimport { spawnSync } from \"node:child_process\";\nimport type { PmSettings } from \"../../types/index.js\";\nimport { toNonEmptyString } from \"../shared/primitives.js\";\n\nconst DISABLE_AUTO_DEFAULTS_ENV = \"PM_DISABLE_OLLAMA_AUTO_DEFAULTS\";\nconst OLLAMA_MODEL_ENV = \"PM_OLLAMA_MODEL\";\nconst DEFAULT_OLLAMA_BASE_URL = \"http://localhost:11434\";\nconst RECOMMENDED_OLLAMA_EMBEDDING_MODEL = \"qwen3-embedding:0.6b\";\nconst DEFAULT_LANCEDB_PATH = \".agents/pm/search/lancedb/\";\nconst OLLAMA_VERSION_TIMEOUT_MS = 1_500;\nconst OLLAMA_LIST_TIMEOUT_MS = 2_500;\nconst QWEN_EMBEDDING_MODEL_PATTERN = /qwen.*(?:embed|embedding)|(?:embed|embedding).*qwen/i;\nconst EMBEDDING_MODEL_PATTERN = /embed|embedding/i;\n\n/**\n * Documents the semantic runtime defaults resolution payload exchanged by command, SDK, and package integrations.\n */\nexport interface SemanticRuntimeDefaultsResolution {\n  settings: PmSettings;\n  auto_ollama_defaults_applied: boolean;\n  auto_ollama_defaults_skipped_reason?: \"no_installed_embedding_model\";\n  auto_ollama_defaults_remediation?: string;\n}\n\nconst toOptionalNonEmptyString = toNonEmptyString;\n\nfunction isAutoDefaultsDisabled(): boolean {\n  const raw = toOptionalNonEmptyString(process.env[DISABLE_AUTO_DEFAULTS_ENV]);\n  if (!raw) {\n    return false;\n  }\n  const normalized = raw.toLowerCase();\n  return normalized === \"1\" || normalized === \"true\" || normalized === \"yes\";\n}\n\nfunction hasConfiguredValue(values: readonly unknown[]): boolean {\n  return values.some((entry) => toOptionalNonEmptyString(entry) !== null);\n}\n\nfunction hasCompetingProvider(provider: unknown): boolean {\n  const normalized = toOptionalNonEmptyString(provider);\n  return Boolean(normalized && normalized.toLowerCase() !== \"ollama\");\n}\n\nfunction hasCompetingVectorAdapter(adapter: unknown): boolean {\n  const normalized = toOptionalNonEmptyString(adapter);\n  return Boolean(normalized && normalized.toLowerCase() !== \"lancedb\");\n}\n\n/**\n * True only when the user has opted into a provider/store that COMPETES with the\n * Ollama + LanceDB auto-default stack: an explicit non-Ollama search provider, a\n * non-LanceDB vector adapter, or any OpenAI/Qdrant credentials. A partial Ollama\n * setup (e.g. only `ollama.base_url`) is NOT competing — its missing leaves are\n * filled per-field below so a single config write can never silently disable\n * semantic search and then hard-error `pm reindex`.\n */\nfunction hasCompetingSemanticConfiguration(settings: PmSettings): boolean {\n  if (hasCompetingProvider(settings.search?.provider)) {\n    return true;\n  }\n  if (hasCompetingVectorAdapter(settings.vector_store?.adapter)) {\n    return true;\n  }\n  if (hasConfiguredValue([\n    settings.providers?.openai?.base_url,\n    settings.providers?.openai?.model,\n    settings.providers?.openai?.api_key,\n  ])) {\n    return true;\n  }\n  return hasConfiguredValue([\n    settings.vector_store?.qdrant?.url,\n    settings.vector_store?.qdrant?.api_key,\n  ]);\n}\n\nfunction isOllamaInstalled(): boolean {\n  const result = spawnSync(\"ollama\", [\"--version\"], {\n    encoding: \"utf8\",\n    timeout: OLLAMA_VERSION_TIMEOUT_MS,\n  });\n  if (result.error) {\n    return false;\n  }\n  return result.status === 0;\n}\n\nfunction parseOllamaModelList(output: string): string | null {\n  const lines = output\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0);\n  if (lines.length === 0) {\n    return null;\n  }\n  const models = lines\n    .map((line) => line.split(/\\s+/)[0]?.trim())\n    .filter((entry): entry is string => Boolean(entry && entry.length > 0))\n    .filter((entry) => entry.toUpperCase() !== \"NAME\");\n  if (models.length === 0) {\n    return null;\n  }\n  const preferredQwenEmbeddingModel = models.find((entry) => QWEN_EMBEDDING_MODEL_PATTERN.test(entry));\n  if (preferredQwenEmbeddingModel) {\n    return preferredQwenEmbeddingModel;\n  }\n  const embeddingModel = models.find((entry) => EMBEDDING_MODEL_PATTERN.test(entry));\n  return embeddingModel ?? null;\n}\n\nfunction resolveAutoOllamaModel(settings: PmSettings): string | null {\n  const settingsModel = toOptionalNonEmptyString(settings.providers?.ollama?.model);\n  if (settingsModel) {\n    return settingsModel;\n  }\n  const envModel = toOptionalNonEmptyString(process.env[OLLAMA_MODEL_ENV]);\n  if (envModel) {\n    return envModel;\n  }\n  const listed = spawnSync(\"ollama\", [\"list\"], {\n    encoding: \"utf8\",\n    timeout: OLLAMA_LIST_TIMEOUT_MS,\n  });\n  if (!listed.error && listed.status === 0) {\n    const listedModel = parseOllamaModelList(typeof listed.stdout === \"string\" ? listed.stdout : \"\");\n    if (listedModel) {\n      return listedModel;\n    }\n  }\n  return null;\n}\n\ninterface SemanticDefaultNeeds {\n  baseUrl: boolean;\n  model: boolean;\n  lancedbPath: boolean;\n  embeddingModel: boolean;\n}\n\nfunction resolveSemanticDefaultNeeds(settings: PmSettings): SemanticDefaultNeeds {\n  return {\n    baseUrl: toOptionalNonEmptyString(settings.providers?.ollama?.base_url) === null,\n    model: toOptionalNonEmptyString(settings.providers?.ollama?.model) === null,\n    lancedbPath: toOptionalNonEmptyString(settings.vector_store?.lancedb?.path) === null,\n    embeddingModel: toOptionalNonEmptyString(settings.search?.embedding_model) === null,\n  };\n}\n\nfunction needsAnySemanticDefault(needs: SemanticDefaultNeeds): boolean {\n  return needs.baseUrl || needs.model || needs.lancedbPath || needs.embeddingModel;\n}\n\nfunction applyOllamaProviderDefaults(settings: PmSettings, needs: SemanticDefaultNeeds, resolvedModel: string): void {\n  if (!needs.baseUrl && !needs.model) {\n    return;\n  }\n  const providers = (settings.providers ??= {} as PmSettings[\"providers\"]);\n  const ollama = (providers.ollama ??= {} as PmSettings[\"providers\"][\"ollama\"]);\n  if (needs.baseUrl) {\n    ollama.base_url = DEFAULT_OLLAMA_BASE_URL;\n  }\n  if (needs.model) {\n    ollama.model = resolvedModel;\n  }\n}\n\nfunction applyVectorStoreDefaults(settings: PmSettings, needs: SemanticDefaultNeeds): void {\n  if (!needs.lancedbPath) {\n    return;\n  }\n  const vectorStore = (settings.vector_store ??= {} as PmSettings[\"vector_store\"]);\n  const lancedb = (vectorStore.lancedb ??= {} as PmSettings[\"vector_store\"][\"lancedb\"]);\n  lancedb.path = DEFAULT_LANCEDB_PATH;\n}\n\nfunction applySearchEmbeddingDefaults(settings: PmSettings, needs: SemanticDefaultNeeds, resolvedModel: string): void {\n  if (!needs.embeddingModel) {\n    return;\n  }\n  const search = (settings.search ??= {} as PmSettings[\"search\"]);\n  search.embedding_model = resolvedModel;\n}\n\n/**\n * Implements resolve settings with semantic runtime defaults for the public runtime surface of this module.\n */\nexport function resolveSettingsWithSemanticRuntimeDefaults(settings: PmSettings): SemanticRuntimeDefaultsResolution {\n  const unchanged: SemanticRuntimeDefaultsResolution = {\n    settings,\n    auto_ollama_defaults_applied: false,\n  };\n  if (isAutoDefaultsDisabled()) {\n    return unchanged;\n  }\n  if (hasCompetingSemanticConfiguration(settings)) {\n    return unchanged;\n  }\n\n  const needs = resolveSemanticDefaultNeeds(settings);\n  if (!needsAnySemanticDefault(needs)) {\n    // A fully-configured Ollama/LanceDB stack — nothing to fill, and no need to\n    // probe for Ollama at all.\n    return unchanged;\n  }\n\n  // Auto-discovering the embedding model (via `ollama list`) is the only step that\n  // requires Ollama to be installed. When a model is already configured we mirror it\n  // into the remaining leaves without forcing an Ollama probe; when it is missing we\n  // require Ollama to actually be present rather than writing an unusable default.\n  if (needs.model && !isOllamaInstalled()) {\n    return unchanged;\n  }\n\n  const nextSettings = structuredClone(settings);\n  const resolvedModel = resolveAutoOllamaModel(nextSettings);\n  if (!resolvedModel) {\n    return {\n      ...unchanged,\n      auto_ollama_defaults_skipped_reason: \"no_installed_embedding_model\",\n      auto_ollama_defaults_remediation:\n        `Run ollama pull ${RECOMMENDED_OLLAMA_EMBEDDING_MODEL} or configure providers.ollama.model explicitly (and search.embedding_model if you need an override).`,\n    };\n  }\n  // `readSettings` always normalizes these nested objects, but this function is\n  // exported and runs on the search hot path with caller-supplied settings, so a\n  // partial object (e.g. providers/vector_store set but no `search` block) must\n  // fill the missing leaf rather than throwing on an undefined parent.\n  applyOllamaProviderDefaults(nextSettings, needs, resolvedModel);\n  applyVectorStoreDefaults(nextSettings, needs);\n  applySearchEmbeddingDefaults(nextSettings, needs, resolvedModel);\n  return {\n    settings: nextSettings,\n    auto_ollama_defaults_applied: true,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"7e8365ed-5fc5-5a75-a0a5-3db958c07f88"}

package/dist/core/search/vector-stores.d.ts

@@ -125,7 +125,7 @@ type VectorSettingsInput = {
 /**
  * Implements resolve vector stores for the public runtime surface of this module.
  */
-export declare function resolveVectorStores(settings: PmSettings | VectorSettingsInput): VectorStoreResolution;
+export declare function resolveVectorStores(settings: PmSettings | VectorSettingsInput, pmRoot?: string): VectorStoreResolution;
 /**
  * Implements resolve vector store request target for the public runtime surface of this module.
  */