@unbrained/pm-cli 2026.7.21 → 2026.7.22

package/dist/core/search/background-refresh.js

@@ -4,14 +4,14 @@
  * Powers search, embeddings, and semantic retrieval behavior for Background Refresh.
  */
 
-!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]="29dca602-09bd-5ca8-b505-f9ea519c0c44")}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]="1c1df3a7-d81f-53bb-9590-1c9c9d461569")}catch(e){}}();
 import { spawn } from "node:child_process";
 import { mkdirSync, rmSync, statSync } from "node:fs";
 import path from "node:path";
 import { pathExists, readFileIfExists, writeFileAtomic, } from "../fs/fs-utils.js";
 import { acquireLock } from "../lock/lock.js";
 import { resolvePmPackageRootFromModule } from "../packages/root.js";
-import { readSettings } from "../store/settings.js";
+import { readSettingsWithMetadata, } from "../store/settings.js";
 import { toErrorMessage } from "../shared/primitives.js";
 import { resolveSettingsWithSemanticRuntimeDefaults } from "./semantic-defaults.js";
 /** Shared lock id for any process that rewrites the local vector store. Reindex and the background mutation-refresh worker both acquire this so they never write concurrently and corrupt the store. Exported so `pm reindex` reuses the same id rather than duplicating the literal. */
@@ -21,6 +21,8 @@ const PENDING_QUEUE_GATE_REL_PATH = "search/pending-refresh.gate.lock";
 const PENDING_QUEUE_GATE_STALE_MS = 30_000;
 const SEARCH_REFRESH_INLINE_ENV = "PM_SEARCH_REFRESH_INLINE";
 const SEARCH_REFRESH_CHILD_ENV = "PM_SEARCH_REFRESH_CHILD";
+/** Delay before a settings-failed worker dispatches one replacement child, preventing a tight retry loop while preserving eventual queue recovery. */
+export const SEARCH_REFRESH_RETRY_DELAY_MS = 30_000;
 function parseBooleanTrueLike(value) {
     if (typeof value !== "string") {
         return false;
@@ -178,13 +180,16 @@ function dispatchRefreshChild(pmRoot) {
         // Best effort — see doc comment above.
     }
 }
+function scheduleDelayedRefreshRetry(pmRoot) {
+    setTimeout(() => dispatchRefreshChild(pmRoot), SEARCH_REFRESH_RETRY_DELAY_MS);
+}
 /** Enqueue mutated ids and dispatch a detached worker child to refresh semantic embeddings without blocking the mutation. The reindex lock the worker acquires serializes concurrent refreshes, so the spawn itself stays unconditional and cheap; a worker that loses the lock exits and its ids are drained by the holder. */
 export async function scheduleBackgroundSemanticRefresh(pmRoot, itemIds) {
     await enqueuePendingRefreshIds(pmRoot, itemIds);
     dispatchRefreshChild(pmRoot);
 }
 /** Drain the pending queue and refresh semantic vectors under the reindex lock so the local vector store is never rewritten concurrently. If the lock is held by another worker we exit immediately — that holder drains our enqueued ids. After releasing we re-check the queue once and re-dispatch if a sibling enqueued ids during our final window, guaranteeing eventual processing. */
-export async function runSemanticRefreshWorker(pmRoot, refresh) {
+export async function runSemanticRefreshWorker(pmRoot, refresh, scheduleRetry = scheduleDelayedRefreshRetry) {
     const warnings = [];
     const processed = [];
     if (!(await pathExists(pmRoot))) {
@@ -192,9 +197,22 @@ export async function runSemanticRefreshWorker(pmRoot, refresh) {
     }
     let settings;
     try {
-        settings = resolveSettingsWithSemanticRuntimeDefaults(await readSettings(pmRoot)).settings;
+        const settingsRead = await readSettingsWithMetadata(pmRoot);
+        const readFailure = settingsRead.warnings.find((warning) => warning.startsWith("settings_read_"));
+        if (readFailure) {
+            scheduleRetry(pmRoot);
+            return {
+                processed,
+                rounds: 0,
+                warnings: [
+                    `search_background_refresh_settings_read_failed:${readFailure}`,
+                ],
+            };
+        }
+        settings = resolveSettingsWithSemanticRuntimeDefaults(settingsRead.settings).settings;
     }
     catch (error) {
+        scheduleRetry(pmRoot);
         return {
             processed,
             rounds: 0,
@@ -215,6 +233,7 @@ export async function runSemanticRefreshWorker(pmRoot, refresh) {
     }
     let rounds = 0;
     let failed = false;
+    let retryPending = false;
     try {
         for (;;) {
             const ids = await drainPendingRefreshIds(pmRoot);
@@ -224,8 +243,14 @@ export async function runSemanticRefreshWorker(pmRoot, refresh) {
             rounds += 1;
             try {
                 const result = await refresh(pmRoot, ids);
-                processed.push(...result.refreshed);
                 warnings.push(...result.warnings);
+                if (result.warnings.some((warning) => warning.startsWith("search_semantic_refresh_skipped:settings_read_failed:"))) {
+                    await enqueuePendingRefreshIds(pmRoot, ids);
+                    failed = true;
+                    retryPending = true;
+                    break;
+                }
+                processed.push(...result.refreshed);
             }
             catch (error) {
                 warnings.push(`search_background_refresh_failed:${toErrorMessage(error)}`);
@@ -239,6 +264,9 @@ export async function runSemanticRefreshWorker(pmRoot, refresh) {
     finally {
         await release?.();
     }
+    if (retryPending) {
+        scheduleRetry(pmRoot);
+    }
     // Close the race where a sibling enqueued ids between our last empty drain and
     // releasing the lock: re-dispatch so those ids are eventually processed. Skip
     // this after a refresh failure — the failed ids were re-enqueued and an
@@ -255,4 +283,4 @@ export async function runSemanticRefreshWorker(pmRoot, refresh) {
     };
 }
 //# sourceMappingURL=background-refresh.js.map
-//# debugId=29dca602-09bd-5ca8-b505-f9ea519c0c44
+//# debugId=1c1df3a7-d81f-53bb-9590-1c9c9d461569

package/dist/core/search/background-refresh.js.map

@@ -1 +1 @@
-{"version":3,"file":"background-refresh.js","sources":["core/search/background-refresh.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/search/background-refresh\n *\n * Powers search, embeddings, and semantic retrieval behavior for Background Refresh.\n */\nimport { spawn } from \"node:child_process\";\nimport { mkdirSync, rmSync, statSync } from \"node:fs\";\nimport path from \"node:path\";\n\nimport {\n  pathExists,\n  readFileIfExists,\n  writeFileAtomic,\n} from \"../fs/fs-utils.js\";\nimport { acquireLock } from \"../lock/lock.js\";\nimport { resolvePmPackageRootFromModule } from \"../packages/root.js\";\nimport { readSettings } from \"../store/settings.js\";\nimport { toErrorMessage } from \"../shared/primitives.js\";\nimport { resolveSettingsWithSemanticRuntimeDefaults } from \"./semantic-defaults.js\";\n\n/** Shared lock id for any process that rewrites the local vector store. Reindex and the background mutation-refresh worker both acquire this so they never write concurrently and corrupt the store. Exported so `pm reindex` reuses the same id rather than duplicating the literal. */\nexport const REINDEX_LOCK_ID = \"reindex\";\n\nconst PENDING_QUEUE_REL_PATH = \"search/pending-refresh.json\";\nconst PENDING_QUEUE_GATE_REL_PATH = \"search/pending-refresh.gate.lock\";\nconst PENDING_QUEUE_GATE_STALE_MS = 30_000;\n\nconst SEARCH_REFRESH_INLINE_ENV = \"PM_SEARCH_REFRESH_INLINE\";\nconst SEARCH_REFRESH_CHILD_ENV = \"PM_SEARCH_REFRESH_CHILD\";\n\nfunction parseBooleanTrueLike(value: string | undefined): boolean {\n  if (typeof value !== \"string\") {\n    return false;\n  }\n  const normalized = value.trim().toLowerCase();\n  return (\n    normalized === \"1\" ||\n    normalized === \"true\" ||\n    normalized === \"yes\" ||\n    normalized === \"on\"\n  );\n}\n\n/** Mutation search refresh runs inline (blocking) under test runners, inside the background worker child itself, or when explicitly requested. Otherwise the semantic refresh is dispatched to a detached child so mutations return without waiting on embeddings. Mirrors the telemetry-flush inline gate so the full test suite stays deterministic. */\nexport function shouldRunSearchRefreshInForeground(): boolean {\n  if (parseBooleanTrueLike(process.env[SEARCH_REFRESH_INLINE_ENV])) {\n    return true;\n  }\n  if (parseBooleanTrueLike(process.env[SEARCH_REFRESH_CHILD_ENV])) {\n    return true;\n  }\n  const nodeEnv = (process.env.NODE_ENV ?? \"\").trim().toLowerCase();\n  return (\n    typeof process.env.VITEST === \"string\" ||\n    typeof process.env.VITEST_WORKER_ID === \"string\" ||\n    nodeEnv === \"test\"\n  );\n}\n\nfunction pendingQueuePath(pmRoot: string): string {\n  return path.join(pmRoot, PENDING_QUEUE_REL_PATH);\n}\n\nfunction pendingQueueGatePath(pmRoot: string): string {\n  return path.join(pmRoot, PENDING_QUEUE_GATE_REL_PATH);\n}\n\nfunction acquireQueueGate(pmRoot: string): boolean {\n  const gatePath = pendingQueueGatePath(pmRoot);\n  try {\n    if (Date.now() - statSync(gatePath).mtimeMs < PENDING_QUEUE_GATE_STALE_MS) {\n      return false;\n    }\n    rmSync(gatePath, { recursive: true, force: true });\n  } catch {\n    // Missing gate is the common case; fall through to create it.\n  }\n  try {\n    mkdirSync(path.dirname(gatePath), { recursive: true });\n    mkdirSync(gatePath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction releaseQueueGate(pmRoot: string): void {\n  try {\n    rmSync(pendingQueueGatePath(pmRoot), { recursive: true, force: true });\n  } catch {\n    // Best effort; a stale gate self-heals after PENDING_QUEUE_GATE_STALE_MS.\n  }\n}\n\nasync function withQueueGate<T>(\n  pmRoot: string,\n  fn: () => Promise<T>,\n  fallback: T,\n): Promise<T> {\n  // Briefly serialize read-modify-write access to the pending queue across the\n  // mutation process and the worker child. Acquisition is best effort; if a\n  // healthy gate is held we skip rather than risk a torn queue.\n  for (let attempt = 0; attempt < 50; attempt += 1) {\n    if (acquireQueueGate(pmRoot)) {\n      try {\n        return await fn();\n      } finally {\n        releaseQueueGate(pmRoot);\n      }\n    }\n    await delay(20);\n  }\n  return fallback;\n}\n\nfunction delay(ms: number): Promise<void> {\n  return new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n}\n\nasync function readPendingQueueIds(pmRoot: string): Promise<string[]> {\n  const raw = await readFileIfExists(pendingQueuePath(pmRoot));\n  if (!raw || raw.trim().length === 0) {\n    return [];\n  }\n  try {\n    const parsed = JSON.parse(raw) as { ids?: unknown };\n    if (!Array.isArray(parsed.ids)) {\n      return [];\n    }\n    return parsed.ids.filter(\n      (id): id is string => typeof id === \"string\" && id.length > 0,\n    );\n  } catch {\n    return [];\n  }\n}\n\nasync function writePendingQueueIds(\n  pmRoot: string,\n  ids: string[],\n): Promise<void> {\n  await writeFileAtomic(\n    pendingQueuePath(pmRoot),\n    `${JSON.stringify({ ids })}\\n`,\n  );\n}\n\n/** Merge mutated item ids into the persistent pending-refresh queue. */\nexport async function enqueuePendingRefreshIds(\n  pmRoot: string,\n  itemIds: string[],\n): Promise<void> {\n  const incoming = itemIds.filter(\n    (id) => typeof id === \"string\" && id.trim().length > 0,\n  );\n  if (incoming.length === 0) {\n    return;\n  }\n  const mergeIncoming = async (): Promise<void> => {\n    const existing = await readPendingQueueIds(pmRoot);\n    const merged = [...new Set([...existing, ...incoming])].sort(\n      (left, right) => left.localeCompare(right),\n    );\n    await writePendingQueueIds(pmRoot, merged);\n  };\n  const gated = await withQueueGate(\n    pmRoot,\n    async () => {\n      await mergeIncoming();\n      return true;\n    },\n    false,\n  );\n  if (!gated) {\n    // The gate stayed contended past the retry budget. Never silently drop a\n    // mutation's refresh work: fall back to a best-effort unguarded merge.\n    // writeFileAtomic keeps the file valid; the only risk is losing a concurrent\n    // writer's delta, which its own next dispatch and the vector_index_stale\n    // warning both recover.\n    await mergeIncoming();\n  }\n}\n\n/** Atomically read and clear the pending-refresh queue, returning drained ids. */\nexport async function drainPendingRefreshIds(\n  pmRoot: string,\n): Promise<string[]> {\n  return withQueueGate(pmRoot, async () => {\n    const ids = await readPendingQueueIds(pmRoot);\n    if (ids.length > 0) {\n      await writePendingQueueIds(pmRoot, []);\n    }\n    return ids;\n  }, []);\n}\n\nfunction searchRefreshRunnerPath(): string {\n  return path.join(\n    resolvePmPackageRootFromModule(import.meta.url, [\"../../..\"]),\n    \"dist\",\n    \"cli\",\n    \"search-refresh.js\",\n  );\n}\n\n/** Spawn the detached refresh worker child for this pm root. Best effort: a failed dispatch must never keep the CLI alive or fail a mutation; the next mutation re-dispatches and `vector_index_stale` warns about the catch-up window in the meantime. */\nfunction dispatchRefreshChild(pmRoot: string): void {\n  try {\n    const child = spawn(process.execPath, [searchRefreshRunnerPath()], {\n      detached: true,\n      stdio: \"ignore\",\n      env: {\n        ...process.env,\n        PM_PATH: pmRoot,\n        [SEARCH_REFRESH_CHILD_ENV]: \"1\",\n      },\n    });\n    // A detached child can emit an async 'error' event (e.g. spawn EAGAIN/ENOENT,\n    // resource limits). Swallow it so it never becomes an unhandled error that\n    // crashes the parent CLI; dispatch is best effort.\n    child.on(\"error\", () => {});\n    child.unref();\n  } catch {\n    // Best effort — see doc comment above.\n  }\n}\n\n/** Enqueue mutated ids and dispatch a detached worker child to refresh semantic embeddings without blocking the mutation. The reindex lock the worker acquires serializes concurrent refreshes, so the spawn itself stays unconditional and cheap; a worker that loses the lock exits and its ids are drained by the holder. */\nexport async function scheduleBackgroundSemanticRefresh(\n  pmRoot: string,\n  itemIds: string[],\n): Promise<void> {\n  await enqueuePendingRefreshIds(pmRoot, itemIds);\n  dispatchRefreshChild(pmRoot);\n}\n\n/** Documents the semantic refresh worker result payload exchanged by command, SDK, and package integrations. */\nexport interface SemanticRefreshWorkerResult {\n  /** Value that configures or reports processed for this contract. */\n  processed: string[];\n  /** Value that configures or reports rounds for this contract. */\n  rounds: number;\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n}\n\ntype SemanticRefreshFn = (\n  pmRoot: string,\n  itemIds: string[],\n) => Promise<{ refreshed: string[]; skipped: string[]; warnings: string[] }>;\n\n/** Drain the pending queue and refresh semantic vectors under the reindex lock so the local vector store is never rewritten concurrently. If the lock is held by another worker we exit immediately — that holder drains our enqueued ids. After releasing we re-check the queue once and re-dispatch if a sibling enqueued ids during our final window, guaranteeing eventual processing. */\nexport async function runSemanticRefreshWorker(\n  pmRoot: string,\n  refresh: SemanticRefreshFn,\n): Promise<SemanticRefreshWorkerResult> {\n  const warnings: string[] = [];\n  const processed: string[] = [];\n  if (!(await pathExists(pmRoot))) {\n    return { processed, rounds: 0, warnings };\n  }\n\n  let settings: Awaited<ReturnType<typeof readSettings>>;\n  try {\n    settings = resolveSettingsWithSemanticRuntimeDefaults(\n      await readSettings(pmRoot),\n    ).settings;\n  } catch (error: unknown) {\n    return {\n      processed,\n      rounds: 0,\n      warnings: [\n        `search_background_refresh_settings_read_failed:${toErrorMessage(error)}`,\n      ],\n    };\n  }\n\n  let release: (() => Promise<void>) | null = null;\n  try {\n    release = await acquireLock(\n      pmRoot,\n      REINDEX_LOCK_ID,\n      settings.locks.ttl_seconds,\n      process.env.PM_AUTHOR ?? \"pm-search-refresh\",\n      false,\n      settings.governance.force_required_for_stale_lock,\n      settings.locks.wait_ms,\n    );\n  } catch {\n    // acquireLock owns the bounded wait budget; queued ids remain for the next dispatch.\n  }\n  if (!release) {\n    return { processed, rounds: 0, warnings };\n  }\n\n  let rounds = 0;\n  let failed = false;\n  try {\n    for (;;) {\n      const ids = await drainPendingRefreshIds(pmRoot);\n      if (ids.length === 0) {\n        break;\n      }\n      rounds += 1;\n      try {\n        const result = await refresh(pmRoot, ids);\n        processed.push(...result.refreshed);\n        warnings.push(...result.warnings);\n      } catch (error: unknown) {\n        warnings.push(\n          `search_background_refresh_failed:${toErrorMessage(error)}`,\n        );\n        // Re-enqueue so the work is retried by a later dispatch rather than lost.\n        await enqueuePendingRefreshIds(pmRoot, ids);\n        failed = true;\n        break;\n      }\n    }\n  } finally {\n    await release?.();\n  }\n\n  // Close the race where a sibling enqueued ids between our last empty drain and\n  // releasing the lock: re-dispatch so those ids are eventually processed. Skip\n  // this after a refresh failure — the failed ids were re-enqueued and an\n  // immediate respawn would just fail again, spinning indefinitely. They wait\n  // for the next mutation's dispatch instead.\n  const remaining = failed ? [] : await readPendingQueueIds(pmRoot);\n  if (remaining.length > 0) {\n    dispatchRefreshChild(pmRoot);\n  }\n\n  return {\n    processed: [...new Set(processed)].sort((a, b) => a.localeCompare(b)),\n    rounds,\n    warnings,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"29dca602-09bd-5ca8-b505-f9ea519c0c44"}
+{"version":3,"file":"background-refresh.js","sources":["core/search/background-refresh.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/search/background-refresh\n *\n * Powers search, embeddings, and semantic retrieval behavior for Background Refresh.\n */\nimport { spawn } from \"node:child_process\";\nimport { mkdirSync, rmSync, statSync } from \"node:fs\";\nimport path from \"node:path\";\n\nimport {\n  pathExists,\n  readFileIfExists,\n  writeFileAtomic,\n} from \"../fs/fs-utils.js\";\nimport { acquireLock } from \"../lock/lock.js\";\nimport { resolvePmPackageRootFromModule } from \"../packages/root.js\";\nimport {\n  readSettings,\n  readSettingsWithMetadata,\n} from \"../store/settings.js\";\nimport { toErrorMessage } from \"../shared/primitives.js\";\nimport { resolveSettingsWithSemanticRuntimeDefaults } from \"./semantic-defaults.js\";\n\n/** Shared lock id for any process that rewrites the local vector store. Reindex and the background mutation-refresh worker both acquire this so they never write concurrently and corrupt the store. Exported so `pm reindex` reuses the same id rather than duplicating the literal. */\nexport const REINDEX_LOCK_ID = \"reindex\";\n\nconst PENDING_QUEUE_REL_PATH = \"search/pending-refresh.json\";\nconst PENDING_QUEUE_GATE_REL_PATH = \"search/pending-refresh.gate.lock\";\nconst PENDING_QUEUE_GATE_STALE_MS = 30_000;\n\nconst SEARCH_REFRESH_INLINE_ENV = \"PM_SEARCH_REFRESH_INLINE\";\nconst SEARCH_REFRESH_CHILD_ENV = \"PM_SEARCH_REFRESH_CHILD\";\n/** Delay before a settings-failed worker dispatches one replacement child, preventing a tight retry loop while preserving eventual queue recovery. */\nexport const SEARCH_REFRESH_RETRY_DELAY_MS = 30_000;\n\nfunction parseBooleanTrueLike(value: string | undefined): boolean {\n  if (typeof value !== \"string\") {\n    return false;\n  }\n  const normalized = value.trim().toLowerCase();\n  return (\n    normalized === \"1\" ||\n    normalized === \"true\" ||\n    normalized === \"yes\" ||\n    normalized === \"on\"\n  );\n}\n\n/** Mutation search refresh runs inline (blocking) under test runners, inside the background worker child itself, or when explicitly requested. Otherwise the semantic refresh is dispatched to a detached child so mutations return without waiting on embeddings. Mirrors the telemetry-flush inline gate so the full test suite stays deterministic. */\nexport function shouldRunSearchRefreshInForeground(): boolean {\n  if (parseBooleanTrueLike(process.env[SEARCH_REFRESH_INLINE_ENV])) {\n    return true;\n  }\n  if (parseBooleanTrueLike(process.env[SEARCH_REFRESH_CHILD_ENV])) {\n    return true;\n  }\n  const nodeEnv = (process.env.NODE_ENV ?? \"\").trim().toLowerCase();\n  return (\n    typeof process.env.VITEST === \"string\" ||\n    typeof process.env.VITEST_WORKER_ID === \"string\" ||\n    nodeEnv === \"test\"\n  );\n}\n\nfunction pendingQueuePath(pmRoot: string): string {\n  return path.join(pmRoot, PENDING_QUEUE_REL_PATH);\n}\n\nfunction pendingQueueGatePath(pmRoot: string): string {\n  return path.join(pmRoot, PENDING_QUEUE_GATE_REL_PATH);\n}\n\nfunction acquireQueueGate(pmRoot: string): boolean {\n  const gatePath = pendingQueueGatePath(pmRoot);\n  try {\n    if (Date.now() - statSync(gatePath).mtimeMs < PENDING_QUEUE_GATE_STALE_MS) {\n      return false;\n    }\n    rmSync(gatePath, { recursive: true, force: true });\n  } catch {\n    // Missing gate is the common case; fall through to create it.\n  }\n  try {\n    mkdirSync(path.dirname(gatePath), { recursive: true });\n    mkdirSync(gatePath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction releaseQueueGate(pmRoot: string): void {\n  try {\n    rmSync(pendingQueueGatePath(pmRoot), { recursive: true, force: true });\n  } catch {\n    // Best effort; a stale gate self-heals after PENDING_QUEUE_GATE_STALE_MS.\n  }\n}\n\nasync function withQueueGate<T>(\n  pmRoot: string,\n  fn: () => Promise<T>,\n  fallback: T,\n): Promise<T> {\n  // Briefly serialize read-modify-write access to the pending queue across the\n  // mutation process and the worker child. Acquisition is best effort; if a\n  // healthy gate is held we skip rather than risk a torn queue.\n  for (let attempt = 0; attempt < 50; attempt += 1) {\n    if (acquireQueueGate(pmRoot)) {\n      try {\n        return await fn();\n      } finally {\n        releaseQueueGate(pmRoot);\n      }\n    }\n    await delay(20);\n  }\n  return fallback;\n}\n\nfunction delay(ms: number): Promise<void> {\n  return new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n}\n\nasync function readPendingQueueIds(pmRoot: string): Promise<string[]> {\n  const raw = await readFileIfExists(pendingQueuePath(pmRoot));\n  if (!raw || raw.trim().length === 0) {\n    return [];\n  }\n  try {\n    const parsed = JSON.parse(raw) as { ids?: unknown };\n    if (!Array.isArray(parsed.ids)) {\n      return [];\n    }\n    return parsed.ids.filter(\n      (id): id is string => typeof id === \"string\" && id.length > 0,\n    );\n  } catch {\n    return [];\n  }\n}\n\nasync function writePendingQueueIds(\n  pmRoot: string,\n  ids: string[],\n): Promise<void> {\n  await writeFileAtomic(\n    pendingQueuePath(pmRoot),\n    `${JSON.stringify({ ids })}\\n`,\n  );\n}\n\n/** Merge mutated item ids into the persistent pending-refresh queue. */\nexport async function enqueuePendingRefreshIds(\n  pmRoot: string,\n  itemIds: string[],\n): Promise<void> {\n  const incoming = itemIds.filter(\n    (id) => typeof id === \"string\" && id.trim().length > 0,\n  );\n  if (incoming.length === 0) {\n    return;\n  }\n  const mergeIncoming = async (): Promise<void> => {\n    const existing = await readPendingQueueIds(pmRoot);\n    const merged = [...new Set([...existing, ...incoming])].sort(\n      (left, right) => left.localeCompare(right),\n    );\n    await writePendingQueueIds(pmRoot, merged);\n  };\n  const gated = await withQueueGate(\n    pmRoot,\n    async () => {\n      await mergeIncoming();\n      return true;\n    },\n    false,\n  );\n  if (!gated) {\n    // The gate stayed contended past the retry budget. Never silently drop a\n    // mutation's refresh work: fall back to a best-effort unguarded merge.\n    // writeFileAtomic keeps the file valid; the only risk is losing a concurrent\n    // writer's delta, which its own next dispatch and the vector_index_stale\n    // warning both recover.\n    await mergeIncoming();\n  }\n}\n\n/** Atomically read and clear the pending-refresh queue, returning drained ids. */\nexport async function drainPendingRefreshIds(\n  pmRoot: string,\n): Promise<string[]> {\n  return withQueueGate(pmRoot, async () => {\n    const ids = await readPendingQueueIds(pmRoot);\n    if (ids.length > 0) {\n      await writePendingQueueIds(pmRoot, []);\n    }\n    return ids;\n  }, []);\n}\n\nfunction searchRefreshRunnerPath(): string {\n  return path.join(\n    resolvePmPackageRootFromModule(import.meta.url, [\"../../..\"]),\n    \"dist\",\n    \"cli\",\n    \"search-refresh.js\",\n  );\n}\n\n/** Spawn the detached refresh worker child for this pm root. Best effort: a failed dispatch must never keep the CLI alive or fail a mutation; the next mutation re-dispatches and `vector_index_stale` warns about the catch-up window in the meantime. */\nfunction dispatchRefreshChild(pmRoot: string): void {\n  try {\n    const child = spawn(process.execPath, [searchRefreshRunnerPath()], {\n      detached: true,\n      stdio: \"ignore\",\n      env: {\n        ...process.env,\n        PM_PATH: pmRoot,\n        [SEARCH_REFRESH_CHILD_ENV]: \"1\",\n      },\n    });\n    // A detached child can emit an async 'error' event (e.g. spawn EAGAIN/ENOENT,\n    // resource limits). Swallow it so it never becomes an unhandled error that\n    // crashes the parent CLI; dispatch is best effort.\n    child.on(\"error\", () => {});\n    child.unref();\n  } catch {\n    // Best effort — see doc comment above.\n  }\n}\n\nfunction scheduleDelayedRefreshRetry(pmRoot: string): void {\n  setTimeout(() => dispatchRefreshChild(pmRoot), SEARCH_REFRESH_RETRY_DELAY_MS);\n}\n\n/** Enqueue mutated ids and dispatch a detached worker child to refresh semantic embeddings without blocking the mutation. The reindex lock the worker acquires serializes concurrent refreshes, so the spawn itself stays unconditional and cheap; a worker that loses the lock exits and its ids are drained by the holder. */\nexport async function scheduleBackgroundSemanticRefresh(\n  pmRoot: string,\n  itemIds: string[],\n): Promise<void> {\n  await enqueuePendingRefreshIds(pmRoot, itemIds);\n  dispatchRefreshChild(pmRoot);\n}\n\n/** Documents the semantic refresh worker result payload exchanged by command, SDK, and package integrations. */\nexport interface SemanticRefreshWorkerResult {\n  /** Value that configures or reports processed for this contract. */\n  processed: string[];\n  /** Value that configures or reports rounds for this contract. */\n  rounds: number;\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n}\n\ntype SemanticRefreshFn = (\n  pmRoot: string,\n  itemIds: string[],\n) => Promise<{ refreshed: string[]; skipped: string[]; warnings: string[] }>;\n\n/** Drain the pending queue and refresh semantic vectors under the reindex lock so the local vector store is never rewritten concurrently. If the lock is held by another worker we exit immediately — that holder drains our enqueued ids. After releasing we re-check the queue once and re-dispatch if a sibling enqueued ids during our final window, guaranteeing eventual processing. */\nexport async function runSemanticRefreshWorker(\n  pmRoot: string,\n  refresh: SemanticRefreshFn,\n  scheduleRetry: (root: string) => void = scheduleDelayedRefreshRetry,\n): Promise<SemanticRefreshWorkerResult> {\n  const warnings: string[] = [];\n  const processed: string[] = [];\n  if (!(await pathExists(pmRoot))) {\n    return { processed, rounds: 0, warnings };\n  }\n\n  let settings: Awaited<ReturnType<typeof readSettings>>;\n  try {\n    const settingsRead = await readSettingsWithMetadata(pmRoot);\n    const readFailure = settingsRead.warnings.find((warning) =>\n      warning.startsWith(\"settings_read_\"),\n    );\n    if (readFailure) {\n      scheduleRetry(pmRoot);\n      return {\n        processed,\n        rounds: 0,\n        warnings: [\n          `search_background_refresh_settings_read_failed:${readFailure}`,\n        ],\n      };\n    }\n    settings = resolveSettingsWithSemanticRuntimeDefaults(\n      settingsRead.settings,\n    ).settings;\n  } catch (error: unknown) {\n    scheduleRetry(pmRoot);\n    return {\n      processed,\n      rounds: 0,\n      warnings: [\n        `search_background_refresh_settings_read_failed:${toErrorMessage(error)}`,\n      ],\n    };\n  }\n\n  let release: (() => Promise<void>) | null = null;\n  try {\n    release = await acquireLock(\n      pmRoot,\n      REINDEX_LOCK_ID,\n      settings.locks.ttl_seconds,\n      process.env.PM_AUTHOR ?? \"pm-search-refresh\",\n      false,\n      settings.governance.force_required_for_stale_lock,\n      settings.locks.wait_ms,\n    );\n  } catch {\n    // acquireLock owns the bounded wait budget; queued ids remain for the next dispatch.\n  }\n  if (!release) {\n    return { processed, rounds: 0, warnings };\n  }\n\n  let rounds = 0;\n  let failed = false;\n  let retryPending = false;\n  try {\n    for (;;) {\n      const ids = await drainPendingRefreshIds(pmRoot);\n      if (ids.length === 0) {\n        break;\n      }\n      rounds += 1;\n      try {\n        const result = await refresh(pmRoot, ids);\n        warnings.push(...result.warnings);\n        if (\n          result.warnings.some((warning) =>\n            warning.startsWith(\n              \"search_semantic_refresh_skipped:settings_read_failed:\",\n            ),\n          )\n        ) {\n          await enqueuePendingRefreshIds(pmRoot, ids);\n          failed = true;\n          retryPending = true;\n          break;\n        }\n        processed.push(...result.refreshed);\n      } catch (error: unknown) {\n        warnings.push(\n          `search_background_refresh_failed:${toErrorMessage(error)}`,\n        );\n        // Re-enqueue so the work is retried by a later dispatch rather than lost.\n        await enqueuePendingRefreshIds(pmRoot, ids);\n        failed = true;\n        break;\n      }\n    }\n  } finally {\n    await release?.();\n  }\n\n  if (retryPending) {\n    scheduleRetry(pmRoot);\n  }\n\n  // Close the race where a sibling enqueued ids between our last empty drain and\n  // releasing the lock: re-dispatch so those ids are eventually processed. Skip\n  // this after a refresh failure — the failed ids were re-enqueued and an\n  // immediate respawn would just fail again, spinning indefinitely. They wait\n  // for the next mutation's dispatch instead.\n  const remaining = failed ? [] : await readPendingQueueIds(pmRoot);\n  if (remaining.length > 0) {\n    dispatchRefreshChild(pmRoot);\n  }\n\n  return {\n    processed: [...new Set(processed)].sort((a, b) => a.localeCompare(b)),\n    rounds,\n    warnings,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"1c1df3a7-d81f-53bb-9590-1c9c9d461569"}

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]="c65c4b7b-9860-5c4c-a7a4-de3eb53b59a3")}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]="64ce81f6-7bac-5243-8391-ccc808cd2dfc")}catch(e){}}();
 import path from "node:path";
 import { getActiveExtensionRegistrations } from "../extensions/index.js";
 import { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic, } from "../fs/fs-utils.js";
@@ -12,7 +12,7 @@ import { resolveItemTypeRegistry } from "../item/type-registry.js";
 import { toErrorMessage } from "../shared/primitives.js";
 import { locateItem, readLocatedItem } from "../store/item-store.js";
 import { getSettingsPath } from "../store/paths.js";
-import { readSettings } from "../store/settings.js";
+import { readSettingsWithMetadata, } from "../store/settings.js";
 import { executeEmbeddingBatchesWithRetry } from "./embedding-batches.js";
 import { buildSemanticCorpusInput, resolveSearchCorpusFields, resolveSemanticCorpusCharacterLimit, } from "./corpus.js";
 import { resolveEmbeddingProviders } from "./providers.js";
@@ -169,7 +169,17 @@ async function resolveSemanticRefreshRuntimeContext(pmRoot, normalizedItemIds, o
     }
     let settings;
     try {
-        settings = options.settings ?? (await readSettings(pmRoot));
+        if (options.settings) {
+            settings = options.settings;
+        }
+        else {
+            const settingsRead = await readSettingsWithMetadata(pmRoot);
+            const readFailure = settingsRead.warnings.find((warning) => warning.startsWith("settings_read_"));
+            if (readFailure) {
+                return buildSkippedSemanticRefreshResult(normalizedItemIds, `search_semantic_refresh_skipped:settings_read_failed:${readFailure}`);
+            }
+            settings = settingsRead.settings;
+        }
     }
     catch (error) {
         return buildSkippedSemanticRefreshResult(normalizedItemIds, `search_semantic_refresh_skipped:settings_read_failed:${toErrorMessage(error)}`);
@@ -450,7 +460,20 @@ export async function refreshSearchArtifactsForMutation(pmRoot, itemIds, options
     }
     let settings;
     try {
-        settings = await readSettings(pmRoot);
+        const settingsRead = await readSettingsWithMetadata(pmRoot);
+        const readFailure = settingsRead.warnings.find((warning) => warning.startsWith("settings_read_"));
+        if (readFailure) {
+            return {
+                invalidated: invalidation.invalidated,
+                refreshed: [],
+                skipped: normalizedItemIds,
+                warnings: [
+                    ...invalidation.warnings,
+                    `search_semantic_refresh_skipped:settings_read_failed:${readFailure}`,
+                ],
+            };
+        }
+        settings = settingsRead.settings;
     }
     catch (error) {
         return {
@@ -509,4 +532,4 @@ export const _testOnly = {
     resetSemanticVectorStore,
 };
 //# sourceMappingURL=cache.js.map
-//# debugId=c65c4b7b-9860-5c4c-a7a4-de3eb53b59a3
+//# debugId=64ce81f6-7bac-5243-8391-ccc808cd2dfc

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 {\n  pathExists,\n  readFileIfExists,\n  removeFileIfExists,\n  writeFileAtomic,\n} 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 {\n  executeVectorDelete,\n  executeVectorReset,\n  executeVectorUpsert,\n  resolveVectorStores,\n} 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, ItemMetadata } from \"../../types/index.js\";\n\n/** Public contract for search cache artifact paths, shared by SDK and presentation-layer consumers. */\nexport const SEARCH_CACHE_ARTIFACT_PATHS = [\n  \"index/manifest.json\",\n  \"search/embeddings.jsonl\",\n] as const;\n/** Filesystem path used for vectorization status ledger resolution. */\nexport const VECTORIZATION_STATUS_LEDGER_PATH =\n  \"search/vectorization-status.json\";\n\n/** Documents the search cache invalidation result payload exchanged by command, SDK, and package integrations. */\nexport interface SearchCacheInvalidationResult {\n  /** Value that configures or reports invalidated for this contract. */\n  invalidated: string[];\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n}\n\n/** Documents the semantic mutation refresh result payload exchanged by command, SDK, and package integrations. */\nexport interface SemanticMutationRefreshResult {\n  /** Value that configures or reports refreshed for this contract. */\n  refreshed: string[];\n  /** Value that configures or reports skipped for this contract. */\n  skipped: string[];\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n}\n\n/** Documents the search mutation artifact refresh result payload exchanged by command, SDK, and package integrations. */\nexport interface SearchMutationArtifactRefreshResult extends SearchCacheInvalidationResult {\n  /** Value that configures or reports refreshed for this contract. */\n  refreshed: string[];\n  /** Value that configures or reports skipped for this contract. */\n  skipped: string[];\n  /** True when the semantic refresh was dispatched to a detached background worker. */\n  scheduled?: boolean;\n}\n\n/** Documents the refresh search artifacts for mutation options payload exchanged by command, SDK, and package integrations. */\nexport interface RefreshSearchArtifactsForMutationOptions {\n  /** When true and semantic search is active, the (slow) embedding refresh is dispatched to a detached background worker instead of awaited inline so the mutation returns immediately. The synchronous keyword-cache invalidation still runs first. Callers pass this only outside test runners. */\n  background?: boolean;\n}\n\n/** Documents the semantic refresh options payload exchanged by command, SDK, and package integrations. */\nexport interface SemanticRefreshOptions {\n  /** Value that configures or reports settings for this contract. */\n  settings?: Awaited<ReturnType<typeof readSettings>>;\n  /** Value that configures or reports apply runtime defaults for this contract. */\n  apply_runtime_defaults?: boolean;\n}\n\n/** Documents the vectorization status ledger read result payload exchanged by command, SDK, and package integrations. */\nexport interface VectorizationStatusLedgerReadResult {\n  /** Value that configures or reports entries for this contract. */\n  entries: Record<string, string>;\n  /** Value that configures or reports embedding for this contract. */\n  embedding: VectorizationEmbeddingMetadata | null;\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n}\n\nfunction formatInvalidationWarning(\n  relativePath: string,\n  error: unknown,\n): string {\n  return `search_cache_invalidation_failed:${relativePath}:${String(error)}`;\n}\n\nfunction toUniqueSorted(values: Iterable<string>): string[] {\n  return [\n    ...new Set(\n      [...values]\n        .map((value) => value.trim())\n        .filter((value) => value.length > 0),\n    ),\n  ].sort((left, right) => left.localeCompare(right));\n}\n\nfunction isValidUpdatedAt(value: unknown): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.trim().length > 0 &&\n    Number.isFinite(Date.parse(value))\n  );\n}\n\nfunction normalizeVectorizationLedgerEntries(\n  entries: Record<string, string>,\n): 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(\n    [...normalized.entries()].sort((left, right) =>\n      left[0].localeCompare(right[0]),\n    ),\n  );\n}\n\n/** Implements read vectorization status ledger for the public runtime surface of this module. */\nexport async function readVectorizationStatusLedger(\n  pmRoot: string,\n): 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 (\n      typeof id !== \"string\" ||\n      id.trim().length === 0 ||\n      !isValidUpdatedAt(updatedAt)\n    ) {\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(\n      (parsed as { embedding?: unknown }).embedding,\n    );\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(\n      [...mapped.entries()].sort((left, right) =>\n        left[0].localeCompare(right[0]),\n      ),\n    ),\n    embedding,\n    warnings: [],\n  };\n}\n\n/** Implements write vectorization status ledger for the public runtime surface of this module. */\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: ItemMetadata): 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(\n  provider: EmbeddingProviderConfig,\n): VectorizationEmbeddingIdentity {\n  const identity = buildVectorizationEmbeddingIdentity(\n    provider.name,\n    provider.model,\n  );\n  if (!identity) {\n    throw new Error(\n      \"Embedding provider must include a provider name and model\",\n    );\n  }\n  return identity;\n}\n\nfunction buildSkippedSemanticRefreshResult(\n  itemIds: string[],\n  warning: string,\n): 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(\n      normalizedItemIds,\n      \"search_semantic_refresh_skipped:settings_not_initialized\",\n    );\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(\n      normalizedItemIds,\n      \"search_semantic_refresh_skipped:provider_unconfigured\",\n    );\n  }\n  const vectorStore = resolveVectorStores(effectiveSettings, pmRoot).active;\n  if (!vectorStore) {\n    return buildSkippedSemanticRefreshResult(\n      normalizedItemIds,\n      \"search_semantic_refresh_skipped:vector_store_unconfigured\",\n    );\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(\n      pmRoot,\n      itemId,\n      idPrefix,\n      preferredFormat,\n      typeToFolder,\n    );\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(\n        `search_semantic_refresh_item_read_failed:${located.id}:${toErrorMessage(error)}`,\n      );\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(\n    provider,\n    settings,\n    corpusInputs,\n  );\n  return {\n    vectors: embeddingResult.vectors,\n    vector_dimension: inferConsistentVectorDimension(\n      embeddingResult.vectors,\n      \"Semantic refresh embedding\",\n    ),\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: [\n        `search_semantic_refresh_reset_failed:${toErrorMessage(error)}`,\n      ],\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: [\n        `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. */\nexport async function invalidateSearchCacheArtifacts(\n  pmRoot: string,\n): 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/** Implements refresh semantic embeddings for mutated items for the public runtime surface of this module. */\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(\n    pmRoot,\n    normalizedItemIds,\n    options,\n  );\n  if (!(\"settings\" in runtimeContext)) {\n    return runtimeContext;\n  }\n  const typeRegistry = resolveItemTypeRegistry(\n    runtimeContext.settings,\n    getActiveExtensionRegistrations(),\n  );\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(\n    runtimeContext.provider,\n  );\n  const nextLedgerBaseEntries = ledgerRead.entries;\n  let refreshedResult: SemanticRefreshOperationResult = {\n    refreshed: [],\n    skipped: [],\n    warnings: [],\n  };\n  let nextEmbeddingMetadata = ledgerRead.embedding;\n  if (workload.documents.length > 0) {\n    if (\n      ledgerRead.embedding &&\n      hasVectorizationEmbeddingIdentityChanged(\n        ledgerRead.embedding,\n        embeddingIdentity,\n      )\n    ) {\n      refreshedResult = {\n        refreshed: [],\n        skipped: workload.documents.map((entry) => entry.id),\n        warnings: [\n          \"search_semantic_refresh_requires_reindex:embedding_identity_changed\",\n        ],\n      };\n    } else {\n      try {\n        const embedded = await embedLocatedSemanticVectors(\n          runtimeContext.settings,\n          runtimeContext.provider,\n          workload.documents,\n        );\n        if (\n          hasVectorizationVectorDimensionChanged(\n            ledgerRead.embedding,\n            embedded.vector_dimension,\n          )\n        ) {\n          refreshedResult = {\n            refreshed: [],\n            skipped: workload.documents.map((entry) => entry.id),\n            warnings: [\n              ...embedded.warnings,\n              \"search_semantic_refresh_requires_reindex:vector_dimension_changed\",\n            ],\n          };\n        } else {\n          nextEmbeddingMetadata = buildVectorizationEmbeddingMetadata(\n            embeddingIdentity,\n            embedded.vector_dimension,\n          );\n          const upserted = await upsertLocatedSemanticVectors(\n            runtimeContext.vectorStore,\n            workload.documents,\n            embedded.vectors,\n          );\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(\n    runtimeContext.vectorStore,\n    workload.missingIds,\n  );\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 (\n    Object.keys(refreshedEntries).length > 0 ||\n    workload.missingIds.length > 0\n  ) {\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(\n        pmRoot,\n        nextEntries,\n        nextEmbeddingMetadata,\n      );\n    } catch (error: unknown) {\n      ledgerWarnings.push(\n        `search_vectorization_status_ledger_write_failed:${toErrorMessage(error)}`,\n      );\n    }\n    ledgerWarnings.push(...ledgerRead.warnings);\n  }\n\n  return {\n    refreshed: toUniqueSorted([\n      ...refreshedResult.refreshed,\n      ...pruneResult.refreshed,\n    ]),\n    skipped: toUniqueSorted([\n      ...workload.skippedIds,\n      ...refreshedResult.skipped,\n      ...pruneResult.skipped,\n    ]),\n    warnings: [\n      ...workload.warnings,\n      ...refreshedResult.warnings,\n      ...pruneResult.warnings,\n      ...ledgerWarnings,\n    ],\n  };\n}\n\n/** Returns true when a semantic embedding refresh would do real work for these settings (an embedding provider AND a vector store both resolve). Used to decide whether a mutation's refresh is worth dispatching to a background worker — when semantic search is not configured the inline path is already a fast no-op and no child is spawned. */\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(\n    resolveEmbeddingProviders(effectiveSettings).active &&\n    resolveVectorStores(effectiveSettings).active,\n  );\n}\n\n/** Implements refresh search artifacts for mutation for the public runtime surface of this module. */\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(\n      pmRoot,\n      normalizedItemIds,\n    );\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 =\n    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 (\n    options.background &&\n    isSemanticRefreshActive(settings, applyRuntimeDefaults)\n  ) {\n    await scheduleBackgroundSemanticRefresh(pmRoot, normalizedItemIds);\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: [],\n      warnings: [\n        ...invalidation.warnings,\n        \"search_semantic_refresh_scheduled_background\",\n      ],\n      scheduled: true,\n    };\n  }\n\n  const semanticRefresh = await refreshSemanticEmbeddingsForMutatedItems(\n    pmRoot,\n    normalizedItemIds,\n    {\n      settings,\n      apply_runtime_defaults: applyRuntimeDefaults,\n    },\n  );\n  return {\n    invalidated: invalidation.invalidated,\n    refreshed: semanticRefresh.refreshed,\n    skipped: semanticRefresh.skipped,\n    warnings: [...invalidation.warnings, ...semanticRefresh.warnings],\n  };\n}\n\n/** Public contract for test only, shared by SDK and presentation-layer consumers. */\nexport const _testOnly = {\n  buildSkippedSemanticRefreshResult,\n  buildVectorizationIdentityForProvider,\n  normalizeVectorizationLedgerEntries,\n  resetSemanticVectorStore,\n};\n"],"names":[],"mappings":"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","debugId":"c65c4b7b-9860-5c4c-a7a4-de3eb53b59a3"}
+{"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 {\n  pathExists,\n  readFileIfExists,\n  removeFileIfExists,\n  writeFileAtomic,\n} 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 {\n  readSettings,\n  readSettingsWithMetadata,\n} 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 {\n  executeVectorDelete,\n  executeVectorReset,\n  executeVectorUpsert,\n  resolveVectorStores,\n} 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, ItemMetadata } from \"../../types/index.js\";\n\n/** Public contract for search cache artifact paths, shared by SDK and presentation-layer consumers. */\nexport const SEARCH_CACHE_ARTIFACT_PATHS = [\n  \"index/manifest.json\",\n  \"search/embeddings.jsonl\",\n] as const;\n/** Filesystem path used for vectorization status ledger resolution. */\nexport const VECTORIZATION_STATUS_LEDGER_PATH =\n  \"search/vectorization-status.json\";\n\n/** Documents the search cache invalidation result payload exchanged by command, SDK, and package integrations. */\nexport interface SearchCacheInvalidationResult {\n  /** Value that configures or reports invalidated for this contract. */\n  invalidated: string[];\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n}\n\n/** Documents the semantic mutation refresh result payload exchanged by command, SDK, and package integrations. */\nexport interface SemanticMutationRefreshResult {\n  /** Value that configures or reports refreshed for this contract. */\n  refreshed: string[];\n  /** Value that configures or reports skipped for this contract. */\n  skipped: string[];\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n}\n\n/** Documents the search mutation artifact refresh result payload exchanged by command, SDK, and package integrations. */\nexport interface SearchMutationArtifactRefreshResult extends SearchCacheInvalidationResult {\n  /** Value that configures or reports refreshed for this contract. */\n  refreshed: string[];\n  /** Value that configures or reports skipped for this contract. */\n  skipped: string[];\n  /** True when the semantic refresh was dispatched to a detached background worker. */\n  scheduled?: boolean;\n}\n\n/** Documents the refresh search artifacts for mutation options payload exchanged by command, SDK, and package integrations. */\nexport interface RefreshSearchArtifactsForMutationOptions {\n  /** When true and semantic search is active, the (slow) embedding refresh is dispatched to a detached background worker instead of awaited inline so the mutation returns immediately. The synchronous keyword-cache invalidation still runs first. Callers pass this only outside test runners. */\n  background?: boolean;\n}\n\n/** Documents the semantic refresh options payload exchanged by command, SDK, and package integrations. */\nexport interface SemanticRefreshOptions {\n  /** Value that configures or reports settings for this contract. */\n  settings?: Awaited<ReturnType<typeof readSettings>>;\n  /** Value that configures or reports apply runtime defaults for this contract. */\n  apply_runtime_defaults?: boolean;\n}\n\n/** Documents the vectorization status ledger read result payload exchanged by command, SDK, and package integrations. */\nexport interface VectorizationStatusLedgerReadResult {\n  /** Value that configures or reports entries for this contract. */\n  entries: Record<string, string>;\n  /** Value that configures or reports embedding for this contract. */\n  embedding: VectorizationEmbeddingMetadata | null;\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n}\n\nfunction formatInvalidationWarning(\n  relativePath: string,\n  error: unknown,\n): string {\n  return `search_cache_invalidation_failed:${relativePath}:${String(error)}`;\n}\n\nfunction toUniqueSorted(values: Iterable<string>): string[] {\n  return [\n    ...new Set(\n      [...values]\n        .map((value) => value.trim())\n        .filter((value) => value.length > 0),\n    ),\n  ].sort((left, right) => left.localeCompare(right));\n}\n\nfunction isValidUpdatedAt(value: unknown): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.trim().length > 0 &&\n    Number.isFinite(Date.parse(value))\n  );\n}\n\nfunction normalizeVectorizationLedgerEntries(\n  entries: Record<string, string>,\n): 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(\n    [...normalized.entries()].sort((left, right) =>\n      left[0].localeCompare(right[0]),\n    ),\n  );\n}\n\n/** Implements read vectorization status ledger for the public runtime surface of this module. */\nexport async function readVectorizationStatusLedger(\n  pmRoot: string,\n): 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 (\n      typeof id !== \"string\" ||\n      id.trim().length === 0 ||\n      !isValidUpdatedAt(updatedAt)\n    ) {\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(\n      (parsed as { embedding?: unknown }).embedding,\n    );\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(\n      [...mapped.entries()].sort((left, right) =>\n        left[0].localeCompare(right[0]),\n      ),\n    ),\n    embedding,\n    warnings: [],\n  };\n}\n\n/** Implements write vectorization status ledger for the public runtime surface of this module. */\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: ItemMetadata): 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(\n  provider: EmbeddingProviderConfig,\n): VectorizationEmbeddingIdentity {\n  const identity = buildVectorizationEmbeddingIdentity(\n    provider.name,\n    provider.model,\n  );\n  if (!identity) {\n    throw new Error(\n      \"Embedding provider must include a provider name and model\",\n    );\n  }\n  return identity;\n}\n\nfunction buildSkippedSemanticRefreshResult(\n  itemIds: string[],\n  warning: string,\n): 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(\n      normalizedItemIds,\n      \"search_semantic_refresh_skipped:settings_not_initialized\",\n    );\n  }\n\n  let settings: Awaited<ReturnType<typeof readSettings>>;\n  try {\n    if (options.settings) {\n      settings = options.settings;\n    } else {\n      const settingsRead = await readSettingsWithMetadata(pmRoot);\n      const readFailure = settingsRead.warnings.find((warning) =>\n        warning.startsWith(\"settings_read_\"),\n      );\n      if (readFailure) {\n        return buildSkippedSemanticRefreshResult(\n          normalizedItemIds,\n          `search_semantic_refresh_skipped:settings_read_failed:${readFailure}`,\n        );\n      }\n      settings = settingsRead.settings;\n    }\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(\n      normalizedItemIds,\n      \"search_semantic_refresh_skipped:provider_unconfigured\",\n    );\n  }\n  const vectorStore = resolveVectorStores(effectiveSettings, pmRoot).active;\n  if (!vectorStore) {\n    return buildSkippedSemanticRefreshResult(\n      normalizedItemIds,\n      \"search_semantic_refresh_skipped:vector_store_unconfigured\",\n    );\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(\n      pmRoot,\n      itemId,\n      idPrefix,\n      preferredFormat,\n      typeToFolder,\n    );\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(\n        `search_semantic_refresh_item_read_failed:${located.id}:${toErrorMessage(error)}`,\n      );\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(\n    provider,\n    settings,\n    corpusInputs,\n  );\n  return {\n    vectors: embeddingResult.vectors,\n    vector_dimension: inferConsistentVectorDimension(\n      embeddingResult.vectors,\n      \"Semantic refresh embedding\",\n    ),\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: [\n        `search_semantic_refresh_reset_failed:${toErrorMessage(error)}`,\n      ],\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: [\n        `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. */\nexport async function invalidateSearchCacheArtifacts(\n  pmRoot: string,\n): 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/** Implements refresh semantic embeddings for mutated items for the public runtime surface of this module. */\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(\n    pmRoot,\n    normalizedItemIds,\n    options,\n  );\n  if (!(\"settings\" in runtimeContext)) {\n    return runtimeContext;\n  }\n  const typeRegistry = resolveItemTypeRegistry(\n    runtimeContext.settings,\n    getActiveExtensionRegistrations(),\n  );\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(\n    runtimeContext.provider,\n  );\n  const nextLedgerBaseEntries = ledgerRead.entries;\n  let refreshedResult: SemanticRefreshOperationResult = {\n    refreshed: [],\n    skipped: [],\n    warnings: [],\n  };\n  let nextEmbeddingMetadata = ledgerRead.embedding;\n  if (workload.documents.length > 0) {\n    if (\n      ledgerRead.embedding &&\n      hasVectorizationEmbeddingIdentityChanged(\n        ledgerRead.embedding,\n        embeddingIdentity,\n      )\n    ) {\n      refreshedResult = {\n        refreshed: [],\n        skipped: workload.documents.map((entry) => entry.id),\n        warnings: [\n          \"search_semantic_refresh_requires_reindex:embedding_identity_changed\",\n        ],\n      };\n    } else {\n      try {\n        const embedded = await embedLocatedSemanticVectors(\n          runtimeContext.settings,\n          runtimeContext.provider,\n          workload.documents,\n        );\n        if (\n          hasVectorizationVectorDimensionChanged(\n            ledgerRead.embedding,\n            embedded.vector_dimension,\n          )\n        ) {\n          refreshedResult = {\n            refreshed: [],\n            skipped: workload.documents.map((entry) => entry.id),\n            warnings: [\n              ...embedded.warnings,\n              \"search_semantic_refresh_requires_reindex:vector_dimension_changed\",\n            ],\n          };\n        } else {\n          nextEmbeddingMetadata = buildVectorizationEmbeddingMetadata(\n            embeddingIdentity,\n            embedded.vector_dimension,\n          );\n          const upserted = await upsertLocatedSemanticVectors(\n            runtimeContext.vectorStore,\n            workload.documents,\n            embedded.vectors,\n          );\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(\n    runtimeContext.vectorStore,\n    workload.missingIds,\n  );\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 (\n    Object.keys(refreshedEntries).length > 0 ||\n    workload.missingIds.length > 0\n  ) {\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(\n        pmRoot,\n        nextEntries,\n        nextEmbeddingMetadata,\n      );\n    } catch (error: unknown) {\n      ledgerWarnings.push(\n        `search_vectorization_status_ledger_write_failed:${toErrorMessage(error)}`,\n      );\n    }\n    ledgerWarnings.push(...ledgerRead.warnings);\n  }\n\n  return {\n    refreshed: toUniqueSorted([\n      ...refreshedResult.refreshed,\n      ...pruneResult.refreshed,\n    ]),\n    skipped: toUniqueSorted([\n      ...workload.skippedIds,\n      ...refreshedResult.skipped,\n      ...pruneResult.skipped,\n    ]),\n    warnings: [\n      ...workload.warnings,\n      ...refreshedResult.warnings,\n      ...pruneResult.warnings,\n      ...ledgerWarnings,\n    ],\n  };\n}\n\n/** Returns true when a semantic embedding refresh would do real work for these settings (an embedding provider AND a vector store both resolve). Used to decide whether a mutation's refresh is worth dispatching to a background worker — when semantic search is not configured the inline path is already a fast no-op and no child is spawned. */\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(\n    resolveEmbeddingProviders(effectiveSettings).active &&\n    resolveVectorStores(effectiveSettings).active,\n  );\n}\n\n/** Implements refresh search artifacts for mutation for the public runtime surface of this module. */\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(\n      pmRoot,\n      normalizedItemIds,\n    );\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    const settingsRead = await readSettingsWithMetadata(pmRoot);\n    const readFailure = settingsRead.warnings.find((warning) =>\n      warning.startsWith(\"settings_read_\"),\n    );\n    if (readFailure) {\n      return {\n        invalidated: invalidation.invalidated,\n        refreshed: [],\n        skipped: normalizedItemIds,\n        warnings: [\n          ...invalidation.warnings,\n          `search_semantic_refresh_skipped:settings_read_failed:${readFailure}`,\n        ],\n      };\n    }\n    settings = settingsRead.settings;\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 =\n    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 (\n    options.background &&\n    isSemanticRefreshActive(settings, applyRuntimeDefaults)\n  ) {\n    await scheduleBackgroundSemanticRefresh(pmRoot, normalizedItemIds);\n    return {\n      invalidated: invalidation.invalidated,\n      refreshed: [],\n      skipped: [],\n      warnings: [\n        ...invalidation.warnings,\n        \"search_semantic_refresh_scheduled_background\",\n      ],\n      scheduled: true,\n    };\n  }\n\n  const semanticRefresh = await refreshSemanticEmbeddingsForMutatedItems(\n    pmRoot,\n    normalizedItemIds,\n    {\n      settings,\n      apply_runtime_defaults: applyRuntimeDefaults,\n    },\n  );\n  return {\n    invalidated: invalidation.invalidated,\n    refreshed: semanticRefresh.refreshed,\n    skipped: semanticRefresh.skipped,\n    warnings: [...invalidation.warnings, ...semanticRefresh.warnings],\n  };\n}\n\n/** Public contract for test only, shared by SDK and presentation-layer consumers. */\nexport const _testOnly = {\n  buildSkippedSemanticRefreshResult,\n  buildVectorizationIdentityForProvider,\n  normalizeVectorizationLedgerEntries,\n  resetSemanticVectorStore,\n};\n"],"names":[],"mappings":"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","debugId":"64ce81f6-7bac-5243-8391-ccc808cd2dfc"}

package/dist/core/shared/constants.d.ts

@@ -28,6 +28,8 @@ export declare const PM_OPTIONAL_TYPE_SUBDIRS: readonly ["decisions", "events",
 export declare const PM_REQUIRED_SUBDIRS: readonly ["", "epics", "features", "tasks", "chores", "issues", "schema", "history", "search", "extensions", "locks", "decisions", "events", "reminders", "milestones", "meetings", "plans"];
 /** Public contract for type to folder, shared by SDK and presentation-layer consumers. */
 export declare const TYPE_TO_FOLDER: Record<BuiltinItemType, string>;
+/** Portable project-context fields shared by storage order and structured mutation IO. */
+export declare const ITEM_PROJECT_CONTEXT_KEYS: readonly ["goal", "objective", "value", "impact", "outcome", "why_now", "parent", "reviewer", "risk", "confidence", "sprint", "release", "blocked_by", "blocked_reason", "unblock_note", "reporter", "severity", "environment", "repro_steps", "resolution", "expected_result", "actual_result"];
 /** Public contract for item metadata key order, shared by SDK and presentation-layer consumers. */
 export declare const ITEM_METADATA_KEY_ORDER: ReadonlyArray<string>;
 type BuiltinGovernancePreset = Exclude<GovernancePreset, "custom">;

package/dist/core/shared/constants.js

@@ -1,5 +1,5 @@
 
-!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]="54677a0e-1944-5c10-bfa9-2840cb3630cd")}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]="3f35f57d-c4cd-5508-8860-c6bcd0d56eeb")}catch(e){}}();
 import { createDefaultExtensionGovernancePolicy } from "../extensions/extension-types.js";
 /**
  * Canonical default lifecycle status model and workflow role mapping.
@@ -93,6 +93,31 @@ export const TYPE_TO_FOLDER = {
     Meeting: "meetings",
     Plan: "plans",
 };
+/** Portable project-context fields shared by storage order and structured mutation IO. */
+export const ITEM_PROJECT_CONTEXT_KEYS = [
+    "goal",
+    "objective",
+    "value",
+    "impact",
+    "outcome",
+    "why_now",
+    "parent",
+    "reviewer",
+    "risk",
+    "confidence",
+    "sprint",
+    "release",
+    "blocked_by",
+    "blocked_reason",
+    "unblock_note",
+    "reporter",
+    "severity",
+    "environment",
+    "repro_steps",
+    "resolution",
+    "expected_result",
+    "actual_result",
+];
 /** Public contract for item metadata key order, shared by SDK and presentation-layer consumers. */
 export const ITEM_METADATA_KEY_ORDER = [
     "id",
@@ -120,28 +145,7 @@ export const ITEM_METADATA_KEY_ORDER = [
     "external_ref",
     "definition_of_ready",
     "order",
-    "goal",
-    "objective",
-    "value",
-    "impact",
-    "outcome",
-    "why_now",
-    "parent",
-    "reviewer",
-    "risk",
-    "confidence",
-    "sprint",
-    "release",
-    "blocked_by",
-    "blocked_reason",
-    "unblock_note",
-    "reporter",
-    "severity",
-    "environment",
-    "repro_steps",
-    "resolution",
-    "expected_result",
-    "actual_result",
+    ...ITEM_PROJECT_CONTEXT_KEYS,
     "affected_version",
     "fixed_version",
     "component",
@@ -414,6 +418,7 @@ export const TELEMETRY_ERROR_CATEGORY_BY_CODE = Object.freeze({
     lock_conflict: "conflict",
     terminal_state_conflict: "conflict",
     dependency_failed: "runtime",
+    merge_git_config_unwritable: "runtime",
     command_failed: "runtime",
     unknown_error: "runtime",
 });
@@ -445,4 +450,4 @@ export function resolveTelemetryErrorCategory(errorCode) {
     return "unknown";
 }
 //# sourceMappingURL=constants.js.map
-//# debugId=54677a0e-1944-5c10-bfa9-2840cb3630cd
+//# debugId=3f35f57d-c4cd-5508-8860-c6bcd0d56eeb