@unbrained/pm-cli 2026.5.28 → 2026.5.29

package/dist/core/search/vector-stores.js.map

@@ -1 +1 @@
-{"version":3,"file":"vector-stores.js","sources":["core/search/vector-stores.ts"],"sourceRoot":"/","sourcesContent":["import type { PmSettings } from \"../../types/index.js\";\nimport { mkdir, readFile, rename, stat, unlink, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport {\n  executeSearchJsonRequest,\n  normalizeSearchHttpTimeoutMs,\n  resolveSearchHttpFetcher,\n} from \"./http-client.js\";\nimport type { SearchHttpFetcher, SearchHttpResponse } from \"./http-client.js\";\nimport {\n  isFiniteNumberArray,\n  toErrorMessage,\n  toNonEmptyString,\n  trimTrailingSlashes,\n} from \"../shared/primitives.js\";\n\nexport type VectorStoreName = \"qdrant\" | \"lancedb\";\n\nexport interface QdrantVectorStoreConfig {\n  name: \"qdrant\";\n  url: string;\n  api_key?: string;\n}\n\nexport interface LanceDbVectorStoreConfig {\n  name: \"lancedb\";\n  path: string;\n}\n\nexport type VectorStoreConfig = QdrantVectorStoreConfig | LanceDbVectorStoreConfig;\n\nexport interface VectorStoreResolution {\n  active: VectorStoreConfig | null;\n  available: VectorStoreConfig[];\n}\n\nexport interface VectorStoreRequestTarget {\n  store: VectorStoreName;\n  query_target: string;\n  upsert_target: string;\n}\n\nexport interface VectorQueryPlan {\n  target: VectorStoreRequestTarget;\n  method: \"POST\" | \"LOCAL\";\n  headers: Record<string, string>;\n  body: Record<string, unknown>;\n}\n\nexport interface VectorRecord {\n  id: string;\n  vector: number[];\n  payload?: Record<string, unknown>;\n}\n\nexport interface VectorUpsertPlan {\n  target: VectorStoreRequestTarget;\n  method: \"POST\" | \"LOCAL\";\n  headers: Record<string, string>;\n  body: Record<string, unknown>;\n}\n\nexport interface VectorDeletePlan {\n  target: VectorStoreRequestTarget;\n  method: \"POST\" | \"LOCAL\";\n  headers: Record<string, string>;\n  body: Record<string, unknown>;\n}\n\nexport interface VectorQueryHit {\n  id: string;\n  score: number;\n  payload?: Record<string, unknown>;\n}\n\nexport interface VectorUpsertResult {\n  status: string;\n}\n\nexport type VectorHttpResponse = SearchHttpResponse;\n\nexport type VectorRequestFetcher = SearchHttpFetcher<VectorHttpResponse>;\n\nexport interface ExecuteVectorRequestOptions {\n  timeout_ms?: number;\n  fetcher?: VectorRequestFetcher;\n  warnings?: string[];\n}\n\ntype VectorSettingsInput = {\n  vector_store?: {\n    qdrant?: {\n      url?: string;\n      api_key?: string;\n    };\n    lancedb?: {\n      path?: string;\n    };\n  };\n};\n\nconst DEFAULT_COLLECTION = \"pm_items\";\nconst LANCE_DB_LOCAL_SNAPSHOT_DIR = \".pm-cli-local-vectors\";\nconst LANCE_DB_LOCAL_SNAPSHOT_VERSION = 1;\ninterface LanceDbLocalTableCacheEntry {\n  records: Map<string, VectorRecord>;\n  mtimeMs: number | null;\n  size: number | null;\n}\n\nconst lanceDbLocalTables = new Map<string, LanceDbLocalTableCacheEntry>();\n\nfunction normalizeVector(value: unknown): number[] {\n  if (!isFiniteNumberArray(value) || value.length === 0) {\n    throw new Error(\"Vector values must be a non-empty numeric array\");\n  }\n  return [...value];\n}\n\nfunction normalizeLimit(value: number): number {\n  if (!Number.isFinite(value) || value <= 0) {\n    throw new Error(\"Vector query limit must be a positive number\");\n  }\n  return Math.floor(value);\n}\n\nfunction normalizeQdrantQueryResponse(payload: unknown): VectorQueryHit[] {\n  const result = (payload as { result?: unknown }).result;\n  if (!Array.isArray(result)) {\n    throw new TypeError(\"Qdrant query response must include a result array\");\n  }\n  const hits = result.map((entry, index) => {\n    const idValue = (entry as { id?: unknown }).id;\n    const idCandidate = typeof idValue === \"number\" ? String(idValue) : idValue;\n    const id = toNonEmptyString(idCandidate);\n    if (!id) {\n      throw new Error(`Qdrant query response entry at index ${index} is missing a non-empty id`);\n    }\n\n    const score = (entry as { score?: unknown }).score;\n    if (typeof score !== \"number\" || !Number.isFinite(score)) {\n      throw new TypeError(`Qdrant query response entry at index ${index} is missing a finite numeric score`);\n    }\n\n    const payloadValue = (entry as { payload?: unknown }).payload;\n    if (\n      payloadValue !== undefined &&\n      (typeof payloadValue !== \"object\" || payloadValue === null || Array.isArray(payloadValue))\n    ) {\n      throw new Error(`Qdrant query response entry at index ${index} must provide payload as an object when set`);\n    }\n\n    return {\n      id,\n      score,\n      ...(payloadValue ? { payload: payloadValue as Record<string, unknown> } : {}),\n    };\n  });\n  hits.sort((left, right) => {\n    if (left.score !== right.score) {\n      return right.score - left.score;\n    }\n    return left.id.localeCompare(right.id);\n  });\n  return hits;\n}\n\nfunction normalizeQdrantUpsertResponse(payload: unknown): VectorUpsertResult {\n  const nestedStatus = toNonEmptyString((payload as { result?: { status?: unknown } }).result?.status);\n  if (nestedStatus) {\n    return { status: nestedStatus };\n  }\n  const topLevelStatus = toNonEmptyString((payload as { status?: unknown }).status);\n  if (topLevelStatus) {\n    return { status: topLevelStatus };\n  }\n  throw new Error(\"Qdrant upsert response must include status metadata\");\n}\n\nasync function executeRemoteVectorPlan(\n  endpoint: string,\n  plan: {\n    method: \"POST\";\n    headers: Record<string, string>;\n    body: Record<string, unknown>;\n  },\n  timeoutMs: number,\n  fetcher: VectorRequestFetcher,\n  requestKind: \"query\" | \"upsert\" | \"delete\",\n): Promise<unknown> {\n  return await executeSearchJsonRequest({\n    endpoint,\n    method: plan.method,\n    headers: plan.headers,\n    body: plan.body,\n    timeoutMs,\n    fetcher,\n    requestLabel: `Vector ${requestKind} request`,\n    responseLabel: `Vector ${requestKind} response`,\n  });\n}\n\nfunction resolveQdrantStore(settings: VectorSettingsInput): QdrantVectorStoreConfig | null {\n  const url = toNonEmptyString(settings.vector_store?.qdrant?.url);\n  if (!url) {\n    return null;\n  }\n  const apiKey = toNonEmptyString(settings.vector_store?.qdrant?.api_key);\n  return {\n    name: \"qdrant\",\n    url,\n    ...(apiKey ? { api_key: apiKey } : {}),\n  };\n}\n\nfunction resolveLanceDbStore(settings: VectorSettingsInput): LanceDbVectorStoreConfig | null {\n  const lancedbPath = toNonEmptyString(settings.vector_store?.lancedb?.path);\n  if (!lancedbPath) {\n    return null;\n  }\n  return {\n    name: \"lancedb\",\n    path: lancedbPath,\n  };\n}\n\nfunction normalizeVectorRecords(records: VectorRecord[]): VectorRecord[] {\n  if (!Array.isArray(records) || records.length === 0) {\n    throw new Error(\"Vector upsert records must include at least one entry\");\n  }\n  return records.map((record, index) => {\n    const id = toNonEmptyString(record.id);\n    if (!id) {\n      throw new Error(`Vector upsert record at index ${index} is missing a non-empty id`);\n    }\n    const vector = normalizeVector(record.vector);\n    const payload = record.payload;\n    if (payload !== undefined && (typeof payload !== \"object\" || payload === null || Array.isArray(payload))) {\n      throw new Error(`Vector upsert record at index ${index} must provide payload as an object when set`);\n    }\n    return {\n      id,\n      vector,\n      ...(payload ? { payload } : {}),\n    };\n  });\n}\n\nfunction normalizeVectorDeleteIds(ids: string[]): string[] {\n  if (!Array.isArray(ids) || ids.length === 0) {\n    throw new Error(\"Vector delete ids must include at least one entry\");\n  }\n  const normalizedIds = ids\n    .map((id, index) => {\n      const normalized = toNonEmptyString(id);\n      if (!normalized) {\n        throw new Error(`Vector delete id at index ${index} is missing a non-empty value`);\n      }\n      return normalized;\n    })\n    .sort((left, right) => left.localeCompare(right));\n  const uniqueIds: string[] = [];\n  for (const id of normalizedIds) {\n    if (uniqueIds.at(-1) !== id) {\n      uniqueIds.push(id);\n    }\n  }\n  return uniqueIds;\n}\n\nfunction resolveQdrantDeleteTarget(upsertTarget: string): string {\n  return upsertTarget.replace(/\\/points\\?wait=true$/, \"/points/delete?wait=true\");\n}\n\nfunction getLanceDbLocalTableKey(storePath: string, table: string): string {\n  return getLanceDbSnapshotPath(storePath, table);\n}\n\nfunction getLanceDbSnapshotPath(storePath: string, table: string): string {\n  return join(resolve(storePath), LANCE_DB_LOCAL_SNAPSHOT_DIR, `${table}.json`);\n}\n\nfunction isNodeErrorWithCode(error: unknown, code: string): boolean {\n  return typeof error === \"object\" && error !== null && (error as { code?: unknown }).code === code;\n}\n\nfunction normalizeSnapshotRecord(entry: unknown, index: number, snapshotPath: string): VectorRecord {\n  const id = toNonEmptyString((entry as { id?: unknown }).id);\n  if (!id) {\n    throw new Error(`LanceDB local snapshot '${snapshotPath}' record at index ${index} is missing a non-empty id`);\n  }\n  const vector = normalizeVector((entry as { vector?: unknown }).vector);\n  const payload = (entry as { payload?: unknown }).payload;\n  if (payload !== undefined && (typeof payload !== \"object\" || payload === null || Array.isArray(payload))) {\n    throw new Error(\n      `LanceDB local snapshot '${snapshotPath}' record '${id}' must provide payload as an object when set`,\n    );\n  }\n  return {\n    id,\n    vector,\n    ...(payload ? { payload: payload as Record<string, unknown> } : {}),\n  };\n}\n\nfunction parseLanceDbSnapshot(snapshotPath: string, expectedTable: string, raw: string): Map<string, VectorRecord> {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch (error) {\n    throw new Error(`LanceDB local snapshot at '${snapshotPath}' is not valid JSON: ${toErrorMessage(error)}`);\n  }\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    throw new Error(`LanceDB local snapshot at '${snapshotPath}' must be a JSON object`);\n  }\n\n  const version = (parsed as { version?: unknown }).version;\n  if (version !== LANCE_DB_LOCAL_SNAPSHOT_VERSION) {\n    throw new Error(\n      `LanceDB local snapshot at '${snapshotPath}' must include version=${LANCE_DB_LOCAL_SNAPSHOT_VERSION}`,\n    );\n  }\n\n  const table = toNonEmptyString((parsed as { table?: unknown }).table);\n  if (!table) {\n    throw new Error(`LanceDB local snapshot at '${snapshotPath}' must include a non-empty table value`);\n  }\n  if (table !== expectedTable) {\n    throw new Error(\n      `LanceDB local snapshot at '${snapshotPath}' table mismatch: expected '${expectedTable}', received '${table}'`,\n    );\n  }\n\n  const recordsValue = (parsed as { records?: unknown }).records;\n  if (!Array.isArray(recordsValue)) {\n    throw new TypeError(`LanceDB local snapshot at '${snapshotPath}' must include a records array`);\n  }\n\n  const tableRecords = new Map<string, VectorRecord>();\n  for (let index = 0; index < recordsValue.length; index += 1) {\n    const record = normalizeSnapshotRecord(recordsValue[index], index, snapshotPath);\n    tableRecords.set(record.id, record);\n  }\n  return tableRecords;\n}\n\nasync function loadLanceDbLocalTable(storePath: string, table: string): Promise<Map<string, VectorRecord>> {\n  const key = getLanceDbLocalTableKey(storePath, table);\n  const snapshotPath = getLanceDbSnapshotPath(storePath, table);\n  let snapshotStats: { mtimeMs: number; size: number } | null = null;\n  try {\n    const stats = await stat(snapshotPath);\n    snapshotStats = { mtimeMs: stats.mtimeMs, size: stats.size };\n  } catch (error) {\n    if (!isNodeErrorWithCode(error, \"ENOENT\")) {\n      throw error;\n    }\n  }\n\n  const cached = lanceDbLocalTables.get(key);\n  if (cached && !snapshotStats) {\n    if (cached.mtimeMs === null && cached.size === null && cached.records.size === 0) {\n      return cached.records;\n    }\n    const loaded = new Map<string, VectorRecord>();\n    lanceDbLocalTables.set(key, { records: loaded, mtimeMs: null, size: null });\n    return loaded;\n  }\n  if (\n    cached &&\n    snapshotStats &&\n    cached.mtimeMs === snapshotStats.mtimeMs &&\n    cached.size === snapshotStats.size\n  ) {\n    return cached.records;\n  }\n\n  let loaded = new Map<string, VectorRecord>();\n  try {\n    const raw = await readFile(snapshotPath, \"utf8\");\n    loaded = parseLanceDbSnapshot(snapshotPath, table, raw);\n  } catch (error) {\n    if (!isNodeErrorWithCode(error, \"ENOENT\")) {\n      throw error;\n    }\n  }\n  lanceDbLocalTables.set(key, {\n    records: loaded,\n    mtimeMs: snapshotStats?.mtimeMs ?? null,\n    size: snapshotStats?.size ?? null,\n  });\n  return loaded;\n}\n\nfunction buildSnapshotRecords(table: Map<string, VectorRecord>): VectorRecord[] {\n  const records = [...table.values()];\n  records.sort((left, right) => left.id.localeCompare(right.id));\n  return records.map((record) => ({\n    id: record.id,\n    vector: [...record.vector],\n    ...(record.payload ? { payload: record.payload } : {}),\n  }));\n}\n\nasync function removeSnapshotFile(snapshotPath: string): Promise<void> {\n  try {\n    await unlink(snapshotPath);\n  } catch (error) {\n    if (!isNodeErrorWithCode(error, \"ENOENT\")) {\n      throw new Error(`LanceDB local snapshot delete failed at '${snapshotPath}': ${toErrorMessage(error)}`);\n    }\n  }\n}\n\nasync function persistLanceDbLocalTable(storePath: string, tableName: string, table: Map<string, VectorRecord>): Promise<void> {\n  const snapshotPath = getLanceDbSnapshotPath(storePath, tableName);\n  if (table.size === 0) {\n    await removeSnapshotFile(snapshotPath);\n    return;\n  }\n\n  const snapshotDir = dirname(snapshotPath);\n  try {\n    await mkdir(snapshotDir, { recursive: true });\n  } catch (error) {\n    throw new Error(\n      `LanceDB local snapshot directory create failed at '${snapshotDir}': ${toErrorMessage(error)}`,\n    );\n  }\n\n  const tempPath = join(\n    snapshotDir,\n    `${basename(snapshotPath)}.tmp-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`,\n  );\n  const serialized = `${JSON.stringify(\n    {\n      version: LANCE_DB_LOCAL_SNAPSHOT_VERSION,\n      table: tableName,\n      records: buildSnapshotRecords(table),\n    },\n    null,\n    2,\n  )}\\n`;\n  try {\n    await writeFile(tempPath, serialized, \"utf8\");\n    await rename(tempPath, snapshotPath);\n  } catch (error) {\n    await unlink(tempPath).catch(() => {});\n    throw new Error(`LanceDB local snapshot write failed at '${snapshotPath}': ${toErrorMessage(error)}`);\n  }\n}\n\nfunction l2Norm(vector: number[]): number {\n  let sumSq = 0;\n  for (let index = 0; index < vector.length; index += 1) {\n    sumSq += vector[index] * vector[index];\n  }\n  return Math.sqrt(sumSq);\n}\n\nfunction cosineSimilarity(left: number[], right: number[]): number {\n  let dotProd = 0;\n  for (let index = 0; index < left.length; index += 1) {\n    dotProd += left[index] * right[index];\n  }\n  const leftNorm = l2Norm(left);\n  const rightNorm = l2Norm(right);\n  if (leftNorm === 0 || rightNorm === 0) {\n    return 0;\n  }\n  return dotProd / (leftNorm * rightNorm);\n}\n\nexport function resolveVectorStores(settings: PmSettings | VectorSettingsInput): VectorStoreResolution {\n  const qdrant = resolveQdrantStore(settings);\n  const lancedb = resolveLanceDbStore(settings);\n  const available = [qdrant, lancedb].filter((entry): entry is VectorStoreConfig => entry !== null);\n  return {\n    active: available[0] ?? null,\n    available,\n  };\n}\n\nexport function resolveVectorStoreRequestTarget(store: VectorStoreConfig): VectorStoreRequestTarget {\n  if (store.name === \"qdrant\") {\n    const baseUrl = trimTrailingSlashes(store.url);\n    return {\n      store: \"qdrant\",\n      query_target: `${baseUrl}/collections/${DEFAULT_COLLECTION}/points/search`,\n      upsert_target: `${baseUrl}/collections/${DEFAULT_COLLECTION}/points?wait=true`,\n    };\n  }\n  const encodedPath = encodeURIComponent(store.path);\n  return {\n    store: \"lancedb\",\n    query_target: `lancedb://${encodedPath}#${DEFAULT_COLLECTION}`,\n    upsert_target: `lancedb://${encodedPath}#${DEFAULT_COLLECTION}`,\n  };\n}\n\nexport function buildVectorQueryPlan(store: VectorStoreConfig, vector: number[], limit: number): VectorQueryPlan {\n  const target = resolveVectorStoreRequestTarget(store);\n  const normalizedVector = normalizeVector(vector);\n  const normalizedLimit = normalizeLimit(limit);\n  if (store.name === \"qdrant\") {\n    return {\n      target,\n      method: \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        ...(store.api_key ? { \"api-key\": store.api_key } : {}),\n      },\n      body: {\n        vector: normalizedVector,\n        limit: normalizedLimit,\n        with_payload: true,\n      },\n    };\n  }\n  return {\n    target,\n    method: \"LOCAL\",\n    headers: {},\n    body: {\n      table: DEFAULT_COLLECTION,\n      vector: normalizedVector,\n      limit: normalizedLimit,\n    },\n  };\n}\n\nexport function buildVectorUpsertPlan(store: VectorStoreConfig, records: VectorRecord[]): VectorUpsertPlan {\n  const target = resolveVectorStoreRequestTarget(store);\n  const normalizedRecords = normalizeVectorRecords(records);\n  if (store.name === \"qdrant\") {\n    return {\n      target,\n      method: \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        ...(store.api_key ? { \"api-key\": store.api_key } : {}),\n      },\n      body: {\n        points: normalizedRecords,\n      },\n    };\n  }\n  return {\n    target,\n    method: \"LOCAL\",\n    headers: {},\n    body: {\n      table: DEFAULT_COLLECTION,\n      records: normalizedRecords,\n    },\n  };\n}\n\nexport function buildVectorDeletePlan(store: VectorStoreConfig, ids: string[]): VectorDeletePlan {\n  const target = resolveVectorStoreRequestTarget(store);\n  const normalizedIds = normalizeVectorDeleteIds(ids);\n  if (store.name === \"qdrant\") {\n    return {\n      target,\n      method: \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        ...(store.api_key ? { \"api-key\": store.api_key } : {}),\n      },\n      body: {\n        points: normalizedIds,\n      },\n    };\n  }\n  return {\n    target,\n    method: \"LOCAL\",\n    headers: {},\n    body: {\n      table: DEFAULT_COLLECTION,\n      ids: normalizedIds,\n    },\n  };\n}\n\nexport async function executeVectorQuery(\n  store: VectorStoreConfig,\n  vector: number[],\n  limit: number,\n  options: ExecuteVectorRequestOptions = {},\n): Promise<VectorQueryHit[]> {\n  const plan = buildVectorQueryPlan(store, vector, limit);\n  if (plan.method === \"LOCAL\") {\n    const lanceDbStore = store as LanceDbVectorStoreConfig;\n    const queryBody = plan.body as {\n      table: string;\n      vector: number[];\n      limit: number;\n    };\n    const table = await loadLanceDbLocalTable(lanceDbStore.path, queryBody.table);\n    if (table.size === 0) {\n      return [];\n    }\n    const queryVector = normalizeVector(queryBody.vector);\n    const queryLimit = normalizeLimit(queryBody.limit);\n    const hits: VectorQueryHit[] = [];\n    let dimensionMismatchCount = 0;\n    for (const record of table.values()) {\n      if (record.vector.length !== queryVector.length) {\n        dimensionMismatchCount++;\n        continue;\n      }\n      hits.push({\n        id: record.id,\n        score: cosineSimilarity(queryVector, record.vector),\n        ...(record.payload ? { payload: record.payload } : {}),\n      });\n    }\n    if (dimensionMismatchCount > 0 && options.warnings) {\n      options.warnings.push(\n        `vector_dimension_mismatch:${dimensionMismatchCount} records skipped (expected ${queryVector.length} dimensions)`,\n      );\n    }\n    hits.sort((left, right) => {\n      if (left.score !== right.score) {\n        return right.score - left.score;\n      }\n      return left.id.localeCompare(right.id);\n    });\n    return hits.slice(0, queryLimit);\n  }\n  const timeoutMs = normalizeSearchHttpTimeoutMs(options.timeout_ms, \"Vector request\");\n  const fetcher = resolveSearchHttpFetcher(options.fetcher, \"Vector request\");\n  const payload = await executeRemoteVectorPlan(\n    plan.target.query_target,\n    {\n      method: \"POST\",\n      headers: plan.headers,\n      body: plan.body,\n    },\n    timeoutMs,\n    fetcher,\n    \"query\",\n  );\n  return normalizeQdrantQueryResponse(payload);\n}\n\nexport async function executeVectorUpsert(\n  store: VectorStoreConfig,\n  records: VectorRecord[],\n  options: ExecuteVectorRequestOptions = {},\n): Promise<VectorUpsertResult> {\n  const plan = buildVectorUpsertPlan(store, records);\n  if (plan.method === \"LOCAL\") {\n    const lanceDbStore = store as LanceDbVectorStoreConfig;\n    const upsertBody = plan.body as {\n      table: string;\n      records: VectorRecord[];\n    };\n    const key = getLanceDbLocalTableKey(lanceDbStore.path, upsertBody.table);\n    const table = await loadLanceDbLocalTable(lanceDbStore.path, upsertBody.table);\n    for (const record of upsertBody.records) {\n      table.set(record.id, record);\n    }\n    await persistLanceDbLocalTable(lanceDbStore.path, upsertBody.table, table);\n    const snapshotPath = getLanceDbSnapshotPath(lanceDbStore.path, upsertBody.table);\n    const snapshotStats = await stat(snapshotPath);\n    lanceDbLocalTables.set(key, {\n      records: table,\n      mtimeMs: snapshotStats.mtimeMs,\n      size: snapshotStats.size,\n    });\n    return { status: \"ok\" };\n  }\n  const timeoutMs = normalizeSearchHttpTimeoutMs(options.timeout_ms, \"Vector request\");\n  const fetcher = resolveSearchHttpFetcher(options.fetcher, \"Vector request\");\n  const payload = await executeRemoteVectorPlan(\n    plan.target.upsert_target,\n    {\n      method: \"POST\",\n      headers: plan.headers,\n      body: plan.body,\n    },\n    timeoutMs,\n    fetcher,\n    \"upsert\",\n  );\n  return normalizeQdrantUpsertResponse(payload);\n}\n\nexport async function executeVectorDelete(\n  store: VectorStoreConfig,\n  ids: string[],\n  options: ExecuteVectorRequestOptions = {},\n): Promise<VectorUpsertResult> {\n  const plan = buildVectorDeletePlan(store, ids);\n  if (plan.method === \"LOCAL\") {\n    const lanceDbStore = store as LanceDbVectorStoreConfig;\n    const deleteBody = plan.body as {\n      table: string;\n      ids: string[];\n    };\n    const key = getLanceDbLocalTableKey(lanceDbStore.path, deleteBody.table);\n    const table = await loadLanceDbLocalTable(lanceDbStore.path, deleteBody.table);\n    if (table.size === 0) {\n      return { status: \"ok\" };\n    }\n    for (const id of deleteBody.ids) {\n      table.delete(id);\n    }\n    await persistLanceDbLocalTable(lanceDbStore.path, deleteBody.table, table);\n    if (table.size === 0) {\n      lanceDbLocalTables.delete(key);\n    } else {\n      const snapshotPath = getLanceDbSnapshotPath(lanceDbStore.path, deleteBody.table);\n      const snapshotStats = await stat(snapshotPath);\n      lanceDbLocalTables.set(key, {\n        records: table,\n        mtimeMs: snapshotStats.mtimeMs,\n        size: snapshotStats.size,\n      });\n    }\n    return { status: \"ok\" };\n  }\n  const timeoutMs = normalizeSearchHttpTimeoutMs(options.timeout_ms, \"Vector request\");\n  const fetcher = resolveSearchHttpFetcher(options.fetcher, \"Vector request\");\n  const payload = await executeRemoteVectorPlan(\n    resolveQdrantDeleteTarget(plan.target.upsert_target),\n    {\n      method: \"POST\",\n      headers: plan.headers,\n      body: plan.body,\n    },\n    timeoutMs,\n    fetcher,\n    \"delete\",\n  );\n  return normalizeQdrantUpsertResponse(payload);\n}\n"],"names":[],"mappings":"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","debugId":"7e81fcbb-b493-5774-862f-30107a96e0ce"}
+{"version":3,"file":"vector-stores.js","sources":["core/search/vector-stores.ts"],"sourceRoot":"/","sourcesContent":["import type { PmSettings } from \"../../types/index.js\";\nimport { mkdir, readFile, rename, stat, unlink, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport {\n  executeSearchJsonRequest,\n  normalizeSearchHttpTimeoutMs,\n  resolveSearchHttpFetcher,\n} from \"./http-client.js\";\nimport type { SearchHttpFetcher, SearchHttpResponse } from \"./http-client.js\";\nimport {\n  isFiniteNumberArray,\n  toErrorMessage,\n  toNonEmptyString,\n  trimTrailingSlashes,\n} from \"../shared/primitives.js\";\n\nexport type VectorStoreName = \"qdrant\" | \"lancedb\";\n\nexport interface QdrantVectorStoreConfig {\n  name: \"qdrant\";\n  url: string;\n  api_key?: string;\n}\n\nexport interface LanceDbVectorStoreConfig {\n  name: \"lancedb\";\n  path: string;\n}\n\nexport type VectorStoreConfig = QdrantVectorStoreConfig | LanceDbVectorStoreConfig;\n\nexport interface VectorStoreResolution {\n  active: VectorStoreConfig | null;\n  available: VectorStoreConfig[];\n}\n\nexport interface VectorStoreRequestTarget {\n  store: VectorStoreName;\n  query_target: string;\n  upsert_target: string;\n}\n\nexport interface VectorQueryPlan {\n  target: VectorStoreRequestTarget;\n  method: \"POST\" | \"LOCAL\";\n  headers: Record<string, string>;\n  body: Record<string, unknown>;\n}\n\nexport interface VectorRecord {\n  id: string;\n  vector: number[];\n  payload?: Record<string, unknown>;\n}\n\nexport interface VectorUpsertPlan {\n  target: VectorStoreRequestTarget;\n  method: \"POST\" | \"LOCAL\";\n  headers: Record<string, string>;\n  body: Record<string, unknown>;\n}\n\nexport interface VectorDeletePlan {\n  target: VectorStoreRequestTarget;\n  method: \"POST\" | \"LOCAL\";\n  headers: Record<string, string>;\n  body: Record<string, unknown>;\n}\n\nexport interface VectorQueryHit {\n  id: string;\n  score: number;\n  payload?: Record<string, unknown>;\n}\n\nexport interface VectorUpsertResult {\n  status: string;\n}\n\nexport type VectorHttpResponse = SearchHttpResponse;\n\nexport type VectorRequestFetcher = SearchHttpFetcher<VectorHttpResponse>;\n\nexport interface ExecuteVectorRequestOptions {\n  timeout_ms?: number;\n  fetcher?: VectorRequestFetcher;\n  warnings?: string[];\n}\n\ntype VectorSettingsInput = {\n  vector_store?: {\n    qdrant?: {\n      url?: string;\n      api_key?: string;\n    };\n    lancedb?: {\n      path?: string;\n    };\n  };\n};\n\nconst DEFAULT_COLLECTION = \"pm_items\";\nconst LANCE_DB_LOCAL_SNAPSHOT_DIR = \".pm-cli-local-vectors\";\nconst LANCE_DB_LOCAL_SNAPSHOT_VERSION = 1;\ninterface LanceDbLocalTableCacheEntry {\n  records: Map<string, VectorRecord>;\n  mtimeMs: number | null;\n  size: number | null;\n}\n\nconst lanceDbLocalTables = new Map<string, LanceDbLocalTableCacheEntry>();\n\nfunction normalizeVector(value: unknown): number[] {\n  if (!isFiniteNumberArray(value) || value.length === 0) {\n    throw new Error(\"Vector values must be a non-empty numeric array\");\n  }\n  return [...value];\n}\n\nfunction normalizeLimit(value: number): number {\n  if (!Number.isFinite(value) || value <= 0) {\n    throw new Error(\"Vector query limit must be a positive number\");\n  }\n  return Math.floor(value);\n}\n\nfunction normalizeQdrantQueryResponse(payload: unknown): VectorQueryHit[] {\n  const result = (payload as { result?: unknown }).result;\n  if (!Array.isArray(result)) {\n    throw new TypeError(\"Qdrant query response must include a result array\");\n  }\n  const hits = result.map((entry, index) => {\n    const idValue = (entry as { id?: unknown }).id;\n    const idCandidate = typeof idValue === \"number\" ? String(idValue) : idValue;\n    const id = toNonEmptyString(idCandidate);\n    if (!id) {\n      throw new Error(`Qdrant query response entry at index ${index} is missing a non-empty id`);\n    }\n\n    const score = (entry as { score?: unknown }).score;\n    if (typeof score !== \"number\" || !Number.isFinite(score)) {\n      throw new TypeError(`Qdrant query response entry at index ${index} is missing a finite numeric score`);\n    }\n\n    const payloadValue = (entry as { payload?: unknown }).payload;\n    if (\n      payloadValue !== undefined &&\n      (typeof payloadValue !== \"object\" || payloadValue === null || Array.isArray(payloadValue))\n    ) {\n      throw new Error(`Qdrant query response entry at index ${index} must provide payload as an object when set`);\n    }\n\n    return {\n      id,\n      score,\n      ...(payloadValue ? { payload: payloadValue as Record<string, unknown> } : {}),\n    };\n  });\n  hits.sort((left, right) => {\n    if (left.score !== right.score) {\n      return right.score - left.score;\n    }\n    return left.id.localeCompare(right.id);\n  });\n  return hits;\n}\n\nfunction normalizeQdrantUpsertResponse(payload: unknown): VectorUpsertResult {\n  const nestedStatus = toNonEmptyString((payload as { result?: { status?: unknown } }).result?.status);\n  if (nestedStatus) {\n    return { status: nestedStatus };\n  }\n  const topLevelStatus = toNonEmptyString((payload as { status?: unknown }).status);\n  if (topLevelStatus) {\n    return { status: topLevelStatus };\n  }\n  throw new Error(\"Qdrant upsert response must include status metadata\");\n}\n\nasync function executeRemoteVectorPlan(\n  endpoint: string,\n  plan: {\n    method: \"POST\";\n    headers: Record<string, string>;\n    body: Record<string, unknown>;\n  },\n  timeoutMs: number,\n  fetcher: VectorRequestFetcher,\n  requestKind: \"query\" | \"upsert\" | \"delete\",\n): Promise<unknown> {\n  return await executeSearchJsonRequest({\n    endpoint,\n    method: plan.method,\n    headers: plan.headers,\n    body: plan.body,\n    timeoutMs,\n    fetcher,\n    requestLabel: `Vector ${requestKind} request`,\n    responseLabel: `Vector ${requestKind} response`,\n  });\n}\n\nfunction resolveQdrantStore(settings: VectorSettingsInput): QdrantVectorStoreConfig | null {\n  const url = toNonEmptyString(settings.vector_store?.qdrant?.url);\n  if (!url) {\n    return null;\n  }\n  const apiKey = toNonEmptyString(settings.vector_store?.qdrant?.api_key);\n  return {\n    name: \"qdrant\",\n    url,\n    ...(apiKey ? { api_key: apiKey } : {}),\n  };\n}\n\nfunction resolveLanceDbStore(settings: VectorSettingsInput): LanceDbVectorStoreConfig | null {\n  const lancedbPath = toNonEmptyString(settings.vector_store?.lancedb?.path);\n  if (!lancedbPath) {\n    return null;\n  }\n  return {\n    name: \"lancedb\",\n    path: lancedbPath,\n  };\n}\n\nfunction normalizeVectorRecords(records: VectorRecord[]): VectorRecord[] {\n  if (!Array.isArray(records) || records.length === 0) {\n    throw new Error(\"Vector upsert records must include at least one entry\");\n  }\n  return records.map((record, index) => {\n    const id = toNonEmptyString(record.id);\n    if (!id) {\n      throw new Error(`Vector upsert record at index ${index} is missing a non-empty id`);\n    }\n    const vector = normalizeVector(record.vector);\n    const payload = record.payload;\n    if (payload !== undefined && (typeof payload !== \"object\" || payload === null || Array.isArray(payload))) {\n      throw new Error(`Vector upsert record at index ${index} must provide payload as an object when set`);\n    }\n    return {\n      id,\n      vector,\n      ...(payload ? { payload } : {}),\n    };\n  });\n}\n\nfunction normalizeVectorDeleteIds(ids: string[]): string[] {\n  if (!Array.isArray(ids) || ids.length === 0) {\n    throw new Error(\"Vector delete ids must include at least one entry\");\n  }\n  const normalizedIds = ids\n    .map((id, index) => {\n      const normalized = toNonEmptyString(id);\n      if (!normalized) {\n        throw new Error(`Vector delete id at index ${index} is missing a non-empty value`);\n      }\n      return normalized;\n    })\n    .sort((left, right) => left.localeCompare(right));\n  const uniqueIds: string[] = [];\n  for (const id of normalizedIds) {\n    if (uniqueIds.at(-1) !== id) {\n      uniqueIds.push(id);\n    }\n  }\n  return uniqueIds;\n}\n\nfunction resolveQdrantDeleteTarget(upsertTarget: string): string {\n  return upsertTarget.replace(/\\/points\\?wait=true$/, \"/points/delete?wait=true\");\n}\n\nfunction getLanceDbLocalTableKey(storePath: string, table: string): string {\n  return getLanceDbSnapshotPath(storePath, table);\n}\n\nfunction getLanceDbSnapshotPath(storePath: string, table: string): string {\n  return join(resolve(storePath), LANCE_DB_LOCAL_SNAPSHOT_DIR, `${table}.json`);\n}\n\nfunction isNodeErrorWithCode(error: unknown, code: string): boolean {\n  return typeof error === \"object\" && error !== null && (error as { code?: unknown }).code === code;\n}\n\nfunction normalizeSnapshotRecord(entry: unknown, index: number, snapshotPath: string): VectorRecord {\n  const id = toNonEmptyString((entry as { id?: unknown }).id);\n  if (!id) {\n    throw new Error(`LanceDB local snapshot '${snapshotPath}' record at index ${index} is missing a non-empty id`);\n  }\n  const vector = normalizeVector((entry as { vector?: unknown }).vector);\n  const payload = (entry as { payload?: unknown }).payload;\n  if (payload !== undefined && (typeof payload !== \"object\" || payload === null || Array.isArray(payload))) {\n    throw new Error(\n      `LanceDB local snapshot '${snapshotPath}' record '${id}' must provide payload as an object when set`,\n    );\n  }\n  return {\n    id,\n    vector,\n    ...(payload ? { payload: payload as Record<string, unknown> } : {}),\n  };\n}\n\nfunction parseLanceDbSnapshot(snapshotPath: string, expectedTable: string, raw: string): Map<string, VectorRecord> {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch (error) {\n    throw new Error(`LanceDB local snapshot at '${snapshotPath}' is not valid JSON: ${toErrorMessage(error)}`);\n  }\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    throw new Error(`LanceDB local snapshot at '${snapshotPath}' must be a JSON object`);\n  }\n\n  const version = (parsed as { version?: unknown }).version;\n  if (version !== LANCE_DB_LOCAL_SNAPSHOT_VERSION) {\n    throw new Error(\n      `LanceDB local snapshot at '${snapshotPath}' must include version=${LANCE_DB_LOCAL_SNAPSHOT_VERSION}`,\n    );\n  }\n\n  const table = toNonEmptyString((parsed as { table?: unknown }).table);\n  if (!table) {\n    throw new Error(`LanceDB local snapshot at '${snapshotPath}' must include a non-empty table value`);\n  }\n  if (table !== expectedTable) {\n    throw new Error(\n      `LanceDB local snapshot at '${snapshotPath}' table mismatch: expected '${expectedTable}', received '${table}'`,\n    );\n  }\n\n  const recordsValue = (parsed as { records?: unknown }).records;\n  if (!Array.isArray(recordsValue)) {\n    throw new TypeError(`LanceDB local snapshot at '${snapshotPath}' must include a records array`);\n  }\n\n  const tableRecords = new Map<string, VectorRecord>();\n  for (let index = 0; index < recordsValue.length; index += 1) {\n    const record = normalizeSnapshotRecord(recordsValue[index], index, snapshotPath);\n    tableRecords.set(record.id, record);\n  }\n  return tableRecords;\n}\n\nasync function loadLanceDbLocalTable(storePath: string, table: string): Promise<Map<string, VectorRecord>> {\n  const key = getLanceDbLocalTableKey(storePath, table);\n  const snapshotPath = getLanceDbSnapshotPath(storePath, table);\n  let snapshotStats: { mtimeMs: number; size: number } | null = null;\n  try {\n    const stats = await stat(snapshotPath);\n    snapshotStats = { mtimeMs: stats.mtimeMs, size: stats.size };\n  } catch (error) {\n    if (!isNodeErrorWithCode(error, \"ENOENT\")) {\n      throw error;\n    }\n  }\n\n  const cached = lanceDbLocalTables.get(key);\n  if (cached && !snapshotStats) {\n    if (cached.mtimeMs === null && cached.size === null && cached.records.size === 0) {\n      return cached.records;\n    }\n    const loaded = new Map<string, VectorRecord>();\n    lanceDbLocalTables.set(key, { records: loaded, mtimeMs: null, size: null });\n    return loaded;\n  }\n  if (\n    cached &&\n    snapshotStats &&\n    cached.mtimeMs === snapshotStats.mtimeMs &&\n    cached.size === snapshotStats.size\n  ) {\n    return cached.records;\n  }\n\n  let loaded = new Map<string, VectorRecord>();\n  try {\n    const raw = await readFile(snapshotPath, \"utf8\");\n    loaded = parseLanceDbSnapshot(snapshotPath, table, raw);\n  } catch (error) {\n    if (!isNodeErrorWithCode(error, \"ENOENT\")) {\n      throw error;\n    }\n  }\n  lanceDbLocalTables.set(key, {\n    records: loaded,\n    mtimeMs: snapshotStats?.mtimeMs ?? null,\n    size: snapshotStats?.size ?? null,\n  });\n  return loaded;\n}\n\nfunction buildSnapshotRecords(table: Map<string, VectorRecord>): VectorRecord[] {\n  const records = [...table.values()];\n  records.sort((left, right) => left.id.localeCompare(right.id));\n  return records.map((record) => ({\n    id: record.id,\n    vector: [...record.vector],\n    ...(record.payload ? { payload: record.payload } : {}),\n  }));\n}\n\nasync function removeSnapshotFile(snapshotPath: string): Promise<void> {\n  try {\n    await unlink(snapshotPath);\n  } catch (error) {\n    if (!isNodeErrorWithCode(error, \"ENOENT\")) {\n      throw new Error(`LanceDB local snapshot delete failed at '${snapshotPath}': ${toErrorMessage(error)}`);\n    }\n  }\n}\n\nasync function persistLanceDbLocalTable(storePath: string, tableName: string, table: Map<string, VectorRecord>): Promise<void> {\n  const snapshotPath = getLanceDbSnapshotPath(storePath, tableName);\n  if (table.size === 0) {\n    await removeSnapshotFile(snapshotPath);\n    return;\n  }\n\n  const snapshotDir = dirname(snapshotPath);\n  try {\n    await mkdir(snapshotDir, { recursive: true });\n  } catch (error) {\n    throw new Error(\n      `LanceDB local snapshot directory create failed at '${snapshotDir}': ${toErrorMessage(error)}`,\n    );\n  }\n\n  const tempPath = join(\n    snapshotDir,\n    `${basename(snapshotPath)}.tmp-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`,\n  );\n  const serialized = `${JSON.stringify(\n    {\n      version: LANCE_DB_LOCAL_SNAPSHOT_VERSION,\n      table: tableName,\n      records: buildSnapshotRecords(table),\n    },\n    null,\n    2,\n  )}\\n`;\n  try {\n    await writeFile(tempPath, serialized, \"utf8\");\n    await rename(tempPath, snapshotPath);\n  } catch (error) {\n    await unlink(tempPath).catch(() => {});\n    throw new Error(`LanceDB local snapshot write failed at '${snapshotPath}': ${toErrorMessage(error)}`);\n  }\n}\n\nfunction l2Norm(vector: number[]): number {\n  let sumSq = 0;\n  for (let index = 0; index < vector.length; index += 1) {\n    sumSq += vector[index] * vector[index];\n  }\n  return Math.sqrt(sumSq);\n}\n\nfunction cosineSimilarity(left: number[], right: number[]): number {\n  let dotProd = 0;\n  for (let index = 0; index < left.length; index += 1) {\n    dotProd += left[index] * right[index];\n  }\n  const leftNorm = l2Norm(left);\n  const rightNorm = l2Norm(right);\n  if (leftNorm === 0 || rightNorm === 0) {\n    return 0;\n  }\n  return dotProd / (leftNorm * rightNorm);\n}\n\nexport function resolveVectorStores(settings: PmSettings | VectorSettingsInput): VectorStoreResolution {\n  const qdrant = resolveQdrantStore(settings);\n  const lancedb = resolveLanceDbStore(settings);\n  const available = [qdrant, lancedb].filter((entry): entry is VectorStoreConfig => entry !== null);\n  // Honor `settings.vector_store.adapter` when set: if both built-in stores\n  // are configured, the preferred adapter wins; otherwise fall back to the\n  // first available entry (preserves the previous tie-break: qdrant > lancedb).\n  // Match case-insensitively so \"Qdrant\" / \"LanceDB\" / \"lancedb\" all work.\n  const preferredName = toNonEmptyString(\n    (settings as { vector_store?: { adapter?: unknown } }).vector_store?.adapter,\n  );\n  const preferredKey = preferredName ? preferredName.toLowerCase() : null;\n  const preferred = preferredKey\n    ? available.find((entry) => entry.name === preferredKey)\n    : undefined;\n  return {\n    active: preferred ?? available[0] ?? null,\n    available,\n  };\n}\n\nexport function resolveVectorStoreRequestTarget(store: VectorStoreConfig): VectorStoreRequestTarget {\n  if (store.name === \"qdrant\") {\n    const baseUrl = trimTrailingSlashes(store.url);\n    return {\n      store: \"qdrant\",\n      query_target: `${baseUrl}/collections/${DEFAULT_COLLECTION}/points/search`,\n      upsert_target: `${baseUrl}/collections/${DEFAULT_COLLECTION}/points?wait=true`,\n    };\n  }\n  const encodedPath = encodeURIComponent(store.path);\n  return {\n    store: \"lancedb\",\n    query_target: `lancedb://${encodedPath}#${DEFAULT_COLLECTION}`,\n    upsert_target: `lancedb://${encodedPath}#${DEFAULT_COLLECTION}`,\n  };\n}\n\nexport function buildVectorQueryPlan(store: VectorStoreConfig, vector: number[], limit: number): VectorQueryPlan {\n  const target = resolveVectorStoreRequestTarget(store);\n  const normalizedVector = normalizeVector(vector);\n  const normalizedLimit = normalizeLimit(limit);\n  if (store.name === \"qdrant\") {\n    return {\n      target,\n      method: \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        ...(store.api_key ? { \"api-key\": store.api_key } : {}),\n      },\n      body: {\n        vector: normalizedVector,\n        limit: normalizedLimit,\n        with_payload: true,\n      },\n    };\n  }\n  return {\n    target,\n    method: \"LOCAL\",\n    headers: {},\n    body: {\n      table: DEFAULT_COLLECTION,\n      vector: normalizedVector,\n      limit: normalizedLimit,\n    },\n  };\n}\n\nexport function buildVectorUpsertPlan(store: VectorStoreConfig, records: VectorRecord[]): VectorUpsertPlan {\n  const target = resolveVectorStoreRequestTarget(store);\n  const normalizedRecords = normalizeVectorRecords(records);\n  if (store.name === \"qdrant\") {\n    return {\n      target,\n      method: \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        ...(store.api_key ? { \"api-key\": store.api_key } : {}),\n      },\n      body: {\n        points: normalizedRecords,\n      },\n    };\n  }\n  return {\n    target,\n    method: \"LOCAL\",\n    headers: {},\n    body: {\n      table: DEFAULT_COLLECTION,\n      records: normalizedRecords,\n    },\n  };\n}\n\nexport function buildVectorDeletePlan(store: VectorStoreConfig, ids: string[]): VectorDeletePlan {\n  const target = resolveVectorStoreRequestTarget(store);\n  const normalizedIds = normalizeVectorDeleteIds(ids);\n  if (store.name === \"qdrant\") {\n    return {\n      target,\n      method: \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        ...(store.api_key ? { \"api-key\": store.api_key } : {}),\n      },\n      body: {\n        points: normalizedIds,\n      },\n    };\n  }\n  return {\n    target,\n    method: \"LOCAL\",\n    headers: {},\n    body: {\n      table: DEFAULT_COLLECTION,\n      ids: normalizedIds,\n    },\n  };\n}\n\nexport async function executeVectorQuery(\n  store: VectorStoreConfig,\n  vector: number[],\n  limit: number,\n  options: ExecuteVectorRequestOptions = {},\n): Promise<VectorQueryHit[]> {\n  const plan = buildVectorQueryPlan(store, vector, limit);\n  if (plan.method === \"LOCAL\") {\n    const lanceDbStore = store as LanceDbVectorStoreConfig;\n    const queryBody = plan.body as {\n      table: string;\n      vector: number[];\n      limit: number;\n    };\n    const table = await loadLanceDbLocalTable(lanceDbStore.path, queryBody.table);\n    if (table.size === 0) {\n      return [];\n    }\n    const queryVector = normalizeVector(queryBody.vector);\n    const queryLimit = normalizeLimit(queryBody.limit);\n    const hits: VectorQueryHit[] = [];\n    let dimensionMismatchCount = 0;\n    for (const record of table.values()) {\n      if (record.vector.length !== queryVector.length) {\n        dimensionMismatchCount++;\n        continue;\n      }\n      hits.push({\n        id: record.id,\n        score: cosineSimilarity(queryVector, record.vector),\n        ...(record.payload ? { payload: record.payload } : {}),\n      });\n    }\n    if (dimensionMismatchCount > 0 && options.warnings) {\n      options.warnings.push(\n        `vector_dimension_mismatch:${dimensionMismatchCount} records skipped (expected ${queryVector.length} dimensions)`,\n      );\n    }\n    hits.sort((left, right) => {\n      if (left.score !== right.score) {\n        return right.score - left.score;\n      }\n      return left.id.localeCompare(right.id);\n    });\n    return hits.slice(0, queryLimit);\n  }\n  const timeoutMs = normalizeSearchHttpTimeoutMs(options.timeout_ms, \"Vector request\");\n  const fetcher = resolveSearchHttpFetcher(options.fetcher, \"Vector request\");\n  const payload = await executeRemoteVectorPlan(\n    plan.target.query_target,\n    {\n      method: \"POST\",\n      headers: plan.headers,\n      body: plan.body,\n    },\n    timeoutMs,\n    fetcher,\n    \"query\",\n  );\n  return normalizeQdrantQueryResponse(payload);\n}\n\nexport async function executeVectorUpsert(\n  store: VectorStoreConfig,\n  records: VectorRecord[],\n  options: ExecuteVectorRequestOptions = {},\n): Promise<VectorUpsertResult> {\n  const plan = buildVectorUpsertPlan(store, records);\n  if (plan.method === \"LOCAL\") {\n    const lanceDbStore = store as LanceDbVectorStoreConfig;\n    const upsertBody = plan.body as {\n      table: string;\n      records: VectorRecord[];\n    };\n    const key = getLanceDbLocalTableKey(lanceDbStore.path, upsertBody.table);\n    const table = await loadLanceDbLocalTable(lanceDbStore.path, upsertBody.table);\n    for (const record of upsertBody.records) {\n      table.set(record.id, record);\n    }\n    await persistLanceDbLocalTable(lanceDbStore.path, upsertBody.table, table);\n    const snapshotPath = getLanceDbSnapshotPath(lanceDbStore.path, upsertBody.table);\n    const snapshotStats = await stat(snapshotPath);\n    lanceDbLocalTables.set(key, {\n      records: table,\n      mtimeMs: snapshotStats.mtimeMs,\n      size: snapshotStats.size,\n    });\n    return { status: \"ok\" };\n  }\n  const timeoutMs = normalizeSearchHttpTimeoutMs(options.timeout_ms, \"Vector request\");\n  const fetcher = resolveSearchHttpFetcher(options.fetcher, \"Vector request\");\n  const payload = await executeRemoteVectorPlan(\n    plan.target.upsert_target,\n    {\n      method: \"POST\",\n      headers: plan.headers,\n      body: plan.body,\n    },\n    timeoutMs,\n    fetcher,\n    \"upsert\",\n  );\n  return normalizeQdrantUpsertResponse(payload);\n}\n\nexport async function executeVectorDelete(\n  store: VectorStoreConfig,\n  ids: string[],\n  options: ExecuteVectorRequestOptions = {},\n): Promise<VectorUpsertResult> {\n  const plan = buildVectorDeletePlan(store, ids);\n  if (plan.method === \"LOCAL\") {\n    const lanceDbStore = store as LanceDbVectorStoreConfig;\n    const deleteBody = plan.body as {\n      table: string;\n      ids: string[];\n    };\n    const key = getLanceDbLocalTableKey(lanceDbStore.path, deleteBody.table);\n    const table = await loadLanceDbLocalTable(lanceDbStore.path, deleteBody.table);\n    if (table.size === 0) {\n      return { status: \"ok\" };\n    }\n    for (const id of deleteBody.ids) {\n      table.delete(id);\n    }\n    await persistLanceDbLocalTable(lanceDbStore.path, deleteBody.table, table);\n    if (table.size === 0) {\n      lanceDbLocalTables.delete(key);\n    } else {\n      const snapshotPath = getLanceDbSnapshotPath(lanceDbStore.path, deleteBody.table);\n      const snapshotStats = await stat(snapshotPath);\n      lanceDbLocalTables.set(key, {\n        records: table,\n        mtimeMs: snapshotStats.mtimeMs,\n        size: snapshotStats.size,\n      });\n    }\n    return { status: \"ok\" };\n  }\n  const timeoutMs = normalizeSearchHttpTimeoutMs(options.timeout_ms, \"Vector request\");\n  const fetcher = resolveSearchHttpFetcher(options.fetcher, \"Vector request\");\n  const payload = await executeRemoteVectorPlan(\n    resolveQdrantDeleteTarget(plan.target.upsert_target),\n    {\n      method: \"POST\",\n      headers: plan.headers,\n      body: plan.body,\n    },\n    timeoutMs,\n    fetcher,\n    \"delete\",\n  );\n  return normalizeQdrantUpsertResponse(payload);\n}\n"],"names":[],"mappings":"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","debugId":"1fc8fa51-3aee-5a13-b07a-4b6a91b781ba"}

package/dist/core/shared/html-entity-decode.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Decode the five core HTML entities (`<`, `>`, `"`, `'`,
+ * `&`) in a single pass — but only when the input contains `<` or
+ * `>`. Returns the input unchanged otherwise so the function is a no-op for
+ * normal text and idempotent on already-decoded strings.
+ *
+ * Single-pass semantics guarantee `<` decodes to `<` (literal) rather
+ * than collapsing to `<`, preserving any intentional double-encoding.
+ */
+export declare function decodeHtmlEntitiesIfEscaped(input: string): string;
+/**
+ * Walk an arbitrary value (string / array / plain object) and apply
+ * {@link decodeHtmlEntitiesIfEscaped} to every string leaf. Non-string scalars
+ * (numbers, booleans, null, undefined) and non-plain values pass through
+ * untouched.
+ *
+ * The walker mutates a fresh shallow copy at each level so the caller's input
+ * is not modified. Cycles are not expected (MCP arguments arrive as JSON), but
+ * a visited-set is used as defensive protection against accidental cycles.
+ */
+export declare function decodeHtmlEntitiesInOptions<T>(options: T): T;

package/dist/core/shared/html-entity-decode.js

@@ -0,0 +1,122 @@
+// Defensive HTML-entity decode for free-text fields arriving over the MCP boundary.
+// Background (pm-ydkl 2026-05-28): when Claude / the Anthropic MCP SDK forwards
+// tool arguments containing `<` or `>`, the upstream platform HTML-encodes those
+// characters before they reach pm-cli. The result is stored pm text containing
+// literal `&lt;type&gt;` instead of `<type>`. Direct CLI calls do NOT have this
+// issue — only the MCP path — so the decode is applied exclusively at the MCP
+// server boundary on incoming tool-call arguments.
+//
+// We decode only the five core HTML entities and ONLY when `&lt;` or `&gt;` is
+// present in the string (the signal that something upstream HTML-encoded it).
+// That makes the function a true no-op for normal text. All replacements run in
+// a single non-greedy pass via a lookup map so we never double-decode — most
+// importantly `&amp;lt;` stays as the literal `&lt;` (because `&amp;` is the
+// last entity resolved in the pass), preserving any text that was already
+// double-encoded upstream.
+
+!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]="59b9e6dc-4fde-5bd0-b4bc-972055df82fe")}catch(e){}}();
+const ENTITY_MAP = Object.freeze({
+    "&lt;": "<",
+    "&gt;": ">",
+    "&quot;": '"',
+    "&#39;": "'",
+    "&amp;": "&",
+});
+// Pattern order is important for documentation only: the alternation matches
+// the leftmost occurrence at each position, and the map lookup resolves each
+// match independently. Crucially, `&amp;` is matched as a whole token, so a
+// substring like `&amp;lt;` matches `&amp;` once → `&lt;` (literal) and the
+// regex engine then advances past the inserted text without re-scanning it.
+const ENTITY_PATTERN = /&(?:lt|gt|quot|#39|amp);/g;
+/**
+ * Decode the five core HTML entities (`&lt;`, `&gt;`, `&quot;`, `&#39;`,
+ * `&amp;`) in a single pass — but only when the input contains `&lt;` or
+ * `&gt;`. Returns the input unchanged otherwise so the function is a no-op for
+ * normal text and idempotent on already-decoded strings.
+ *
+ * Single-pass semantics guarantee `&amp;lt;` decodes to `&lt;` (literal) rather
+ * than collapsing to `<`, preserving any intentional double-encoding.
+ */
+export function decodeHtmlEntitiesIfEscaped(input) {
+    if (typeof input !== "string") {
+        return input;
+    }
+    // Activation signal is INTENTIONALLY narrow: only `&lt;` / `&gt;` trigger
+    // decoding. Rationale: the observed MCP-platform behavior only encodes
+    // angle brackets (the characters that risk display-time HTML
+    // misinterpretation upstream). Widening to `&amp;` / `&quot;` / `&#39;`
+    // would risk altering legitimate text that contains those literal token
+    // sequences for unrelated reasons (a URL containing `&amp;`, a snippet
+    // of HTML being intentionally stored as escaped, etc.). If upstream
+    // changes its encoding policy to cover `&` / `"` / `'` standalone, the
+    // signal-guard here will need to be widened in lockstep — covered by
+    // tests `&amp;-only is no-op` and `&quot;-only is no-op`.
+    if (!input.includes("&lt;") && !input.includes("&gt;")) {
+        return input;
+    }
+    // The regex only matches keys present in ENTITY_MAP, so the lookup is total.
+    return input.replace(ENTITY_PATTERN, (match) => ENTITY_MAP[match]);
+}
+/**
+ * Walk an arbitrary value (string / array / plain object) and apply
+ * {@link decodeHtmlEntitiesIfEscaped} to every string leaf. Non-string scalars
+ * (numbers, booleans, null, undefined) and non-plain values pass through
+ * untouched.
+ *
+ * The walker mutates a fresh shallow copy at each level so the caller's input
+ * is not modified. Cycles are not expected (MCP arguments arrive as JSON), but
+ * a visited-set is used as defensive protection against accidental cycles.
+ */
+export function decodeHtmlEntitiesInOptions(options) {
+    return decodeValue(options, new WeakSet());
+}
+function decodeValue(value, seen) {
+    if (typeof value === "string") {
+        return decodeHtmlEntitiesIfEscaped(value);
+    }
+    if (Array.isArray(value)) {
+        if (seen.has(value)) {
+            return value;
+        }
+        seen.add(value);
+        return value.map((entry) => decodeValue(entry, seen));
+    }
+    if (value !== null && typeof value === "object") {
+        // Only traverse plain objects (`{}` and `Object.create(null)` literals).
+        // Class instances (Date, RegExp, Map, Set, Buffer, etc.) and `null`-proto
+        // objects with no proto would lose their prototype and methods if we
+        // rebuilt them as a `Record<string, unknown>` here, so we pass them through.
+        if (!isPlainObject(value)) {
+            return value;
+        }
+        if (seen.has(value)) {
+            return value;
+        }
+        seen.add(value);
+        const source = value;
+        // Preserve the original prototype so downstream callers can still rely on
+        // standard methods like `.hasOwnProperty` on plain objects.
+        const result = Object.create(Object.getPrototypeOf(value));
+        // Use Object.defineProperty (not bracket assignment) for ALL keys so a
+        // smuggled `__proto__` / `constructor` / `prototype` key from an MCP
+        // caller becomes a regular own property — never triggers JS's special
+        // prototype-chain assignment semantics that would otherwise pollute
+        // Object.prototype. This preserves legitimate data while staying safe.
+        for (const [key, entry] of Object.entries(source)) {
+            Object.defineProperty(result, key, {
+                value: decodeValue(entry, seen),
+                enumerable: true,
+                writable: true,
+                configurable: true,
+            });
+        }
+        return result;
+    }
+    return value;
+}
+function isPlainObject(value) {
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+//# sourceMappingURL=html-entity-decode.js.map
+//# debugId=59b9e6dc-4fde-5bd0-b4bc-972055df82fe

package/dist/core/shared/html-entity-decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-entity-decode.js","sources":["core/shared/html-entity-decode.ts"],"sourceRoot":"/","sourcesContent":["// Defensive HTML-entity decode for free-text fields arriving over the MCP boundary.\n// Background (pm-ydkl 2026-05-28): when Claude / the Anthropic MCP SDK forwards\n// tool arguments containing `<` or `>`, the upstream platform HTML-encodes those\n// characters before they reach pm-cli. The result is stored pm text containing\n// literal `&lt;type&gt;` instead of `<type>`. Direct CLI calls do NOT have this\n// issue — only the MCP path — so the decode is applied exclusively at the MCP\n// server boundary on incoming tool-call arguments.\n//\n// We decode only the five core HTML entities and ONLY when `&lt;` or `&gt;` is\n// present in the string (the signal that something upstream HTML-encoded it).\n// That makes the function a true no-op for normal text. All replacements run in\n// a single non-greedy pass via a lookup map so we never double-decode — most\n// importantly `&amp;lt;` stays as the literal `&lt;` (because `&amp;` is the\n// last entity resolved in the pass), preserving any text that was already\n// double-encoded upstream.\n\nconst ENTITY_MAP: Readonly<Record<string, string>> = Object.freeze({\n  \"&lt;\": \"<\",\n  \"&gt;\": \">\",\n  \"&quot;\": '\"',\n  \"&#39;\": \"'\",\n  \"&amp;\": \"&\",\n});\n\n// Pattern order is important for documentation only: the alternation matches\n// the leftmost occurrence at each position, and the map lookup resolves each\n// match independently. Crucially, `&amp;` is matched as a whole token, so a\n// substring like `&amp;lt;` matches `&amp;` once → `&lt;` (literal) and the\n// regex engine then advances past the inserted text without re-scanning it.\nconst ENTITY_PATTERN = /&(?:lt|gt|quot|#39|amp);/g;\n\n/**\n * Decode the five core HTML entities (`&lt;`, `&gt;`, `&quot;`, `&#39;`,\n * `&amp;`) in a single pass — but only when the input contains `&lt;` or\n * `&gt;`. Returns the input unchanged otherwise so the function is a no-op for\n * normal text and idempotent on already-decoded strings.\n *\n * Single-pass semantics guarantee `&amp;lt;` decodes to `&lt;` (literal) rather\n * than collapsing to `<`, preserving any intentional double-encoding.\n */\nexport function decodeHtmlEntitiesIfEscaped(input: string): string {\n  if (typeof input !== \"string\") {\n    return input;\n  }\n  // Activation signal is INTENTIONALLY narrow: only `&lt;` / `&gt;` trigger\n  // decoding. Rationale: the observed MCP-platform behavior only encodes\n  // angle brackets (the characters that risk display-time HTML\n  // misinterpretation upstream). Widening to `&amp;` / `&quot;` / `&#39;`\n  // would risk altering legitimate text that contains those literal token\n  // sequences for unrelated reasons (a URL containing `&amp;`, a snippet\n  // of HTML being intentionally stored as escaped, etc.). If upstream\n  // changes its encoding policy to cover `&` / `\"` / `'` standalone, the\n  // signal-guard here will need to be widened in lockstep — covered by\n  // tests `&amp;-only is no-op` and `&quot;-only is no-op`.\n  if (!input.includes(\"&lt;\") && !input.includes(\"&gt;\")) {\n    return input;\n  }\n  // The regex only matches keys present in ENTITY_MAP, so the lookup is total.\n  return input.replace(ENTITY_PATTERN, (match) => ENTITY_MAP[match] as string);\n}\n\n/**\n * Walk an arbitrary value (string / array / plain object) and apply\n * {@link decodeHtmlEntitiesIfEscaped} to every string leaf. Non-string scalars\n * (numbers, booleans, null, undefined) and non-plain values pass through\n * untouched.\n *\n * The walker mutates a fresh shallow copy at each level so the caller's input\n * is not modified. Cycles are not expected (MCP arguments arrive as JSON), but\n * a visited-set is used as defensive protection against accidental cycles.\n */\nexport function decodeHtmlEntitiesInOptions<T>(options: T): T {\n  return decodeValue(options, new WeakSet<object>()) as T;\n}\n\nfunction decodeValue(value: unknown, seen: WeakSet<object>): unknown {\n  if (typeof value === \"string\") {\n    return decodeHtmlEntitiesIfEscaped(value);\n  }\n  if (Array.isArray(value)) {\n    if (seen.has(value)) {\n      return value;\n    }\n    seen.add(value);\n    return value.map((entry) => decodeValue(entry, seen));\n  }\n  if (value !== null && typeof value === \"object\") {\n    // Only traverse plain objects (`{}` and `Object.create(null)` literals).\n    // Class instances (Date, RegExp, Map, Set, Buffer, etc.) and `null`-proto\n    // objects with no proto would lose their prototype and methods if we\n    // rebuilt them as a `Record<string, unknown>` here, so we pass them through.\n    if (!isPlainObject(value)) {\n      return value;\n    }\n    if (seen.has(value as object)) {\n      return value;\n    }\n    seen.add(value as object);\n    const source = value as Record<string, unknown>;\n    // Preserve the original prototype so downstream callers can still rely on\n    // standard methods like `.hasOwnProperty` on plain objects.\n    const result: Record<string, unknown> = Object.create(Object.getPrototypeOf(value as object));\n    // Use Object.defineProperty (not bracket assignment) for ALL keys so a\n    // smuggled `__proto__` / `constructor` / `prototype` key from an MCP\n    // caller becomes a regular own property — never triggers JS's special\n    // prototype-chain assignment semantics that would otherwise pollute\n    // Object.prototype. This preserves legitimate data while staying safe.\n    for (const [key, entry] of Object.entries(source)) {\n      Object.defineProperty(result, key, {\n        value: decodeValue(entry, seen),\n        enumerable: true,\n        writable: true,\n        configurable: true,\n      });\n    }\n    return result;\n  }\n  return value;\n}\n\nfunction isPlainObject(value: object): boolean {\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n"],"names":[],"mappings":"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","debugId":"59b9e6dc-4fde-5bd0-b4bc-972055df82fe"}

package/dist/core/shared/split-comma-list.d.ts

@@ -0,0 +1,20 @@
+export interface SplitCommaListOptions {
+    /** Separator pattern. Defaults to `/,/`. */
+    separators?: RegExp | string;
+    /** De-duplicate entries while preserving first-seen order. Defaults to `true`. */
+    unique?: boolean;
+    /** Sort entries lexicographically (default JS string sort). Defaults to `false`. */
+    sort?: boolean;
+}
+/**
+ * Split a comma-separated (or custom-separator) string into trimmed, non-empty entries.
+ *
+ * Default behaviour:
+ *   - Splits on `,`.
+ *   - Trims each entry and discards empty results (collapsing leading/trailing/duplicate separators).
+ *   - De-duplicates while preserving first-seen order.
+ *   - Does not sort.
+ *
+ * Returns `[]` for `undefined`/`null` input. Pure, dependency-free.
+ */
+export declare function splitCommaList(raw: string | undefined | null, options?: SplitCommaListOptions): string[];

package/dist/core/shared/split-comma-list.js

@@ -0,0 +1,29 @@
+/**
+ * Split a comma-separated (or custom-separator) string into trimmed, non-empty entries.
+ *
+ * Default behaviour:
+ *   - Splits on `,`.
+ *   - Trims each entry and discards empty results (collapsing leading/trailing/duplicate separators).
+ *   - De-duplicates while preserving first-seen order.
+ *   - Does not sort.
+ *
+ * Returns `[]` for `undefined`/`null` input. Pure, dependency-free.
+ */
+
+!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]="e5a31927-2a55-5d1d-97e4-b6190988caa1")}catch(e){}}();
+export function splitCommaList(raw, options) {
+    if (raw === undefined || raw === null) {
+        return [];
+    }
+    const separators = options?.separators ?? /,/;
+    const parts = raw.split(separators);
+    const trimmed = parts.map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+    const unique = options?.unique !== false;
+    const deduped = unique ? Array.from(new Set(trimmed)) : trimmed;
+    if (options?.sort === true) {
+        return [...deduped].sort();
+    }
+    return deduped;
+}
+//# sourceMappingURL=split-comma-list.js.map
+//# debugId=e5a31927-2a55-5d1d-97e4-b6190988caa1

package/dist/core/shared/split-comma-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-comma-list.js","sources":["core/shared/split-comma-list.ts"],"sourceRoot":"/","sourcesContent":["export interface SplitCommaListOptions {\n  /** Separator pattern. Defaults to `/,/`. */\n  separators?: RegExp | string;\n  /** De-duplicate entries while preserving first-seen order. Defaults to `true`. */\n  unique?: boolean;\n  /** Sort entries lexicographically (default JS string sort). Defaults to `false`. */\n  sort?: boolean;\n}\n\n/**\n * Split a comma-separated (or custom-separator) string into trimmed, non-empty entries.\n *\n * Default behaviour:\n *   - Splits on `,`.\n *   - Trims each entry and discards empty results (collapsing leading/trailing/duplicate separators).\n *   - De-duplicates while preserving first-seen order.\n *   - Does not sort.\n *\n * Returns `[]` for `undefined`/`null` input. Pure, dependency-free.\n */\nexport function splitCommaList(raw: string | undefined | null, options?: SplitCommaListOptions): string[] {\n  if (raw === undefined || raw === null) {\n    return [];\n  }\n  const separators = options?.separators ?? /,/;\n  const parts = raw.split(separators as never);\n  const trimmed = parts.map((entry) => entry.trim()).filter((entry) => entry.length > 0);\n  const unique = options?.unique !== false;\n  const deduped = unique ? Array.from(new Set(trimmed)) : trimmed;\n  if (options?.sort === true) {\n    return [...deduped].sort();\n  }\n  return deduped;\n}\n"],"names":[],"mappings":"AASA;;;;;;;;;;GAUG;;;AACH,MAAM,UAAU,cAAc,CAAC,GAA8B,EAAE,OAA+B;IAC5F,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,GAAG,CAAC;IAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,UAAmB,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChE,IAAI,OAAO,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","debugId":"e5a31927-2a55-5d1d-97e4-b6190988caa1"}

package/dist/mcp/server.js

@@ -1,12 +1,13 @@
 #!/usr/bin/env node
 
-!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]="16ab349e-99ce-51eb-85d5-62e1c2c56c10")}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]="0b886283-0ee3-5dcd-bd65-6199134c8901")}catch(e){}}();
 import readline from "node:readline";
 import { fileURLToPath } from "node:url";
 import { activateExtensions, loadExtensions, runActiveCommandHandler, setActiveExtensionCommands, setActiveExtensionHooks, setActiveExtensionParsers, setActiveExtensionPreflight, setActiveExtensionRegistrations, setActiveExtensionRenderers, setActiveExtensionServices, } from "../core/extensions/index.js";
 import { pathExists } from "../core/fs/fs-utils.js";
 import { projectMutationResult } from "../core/output/mutation-projection.js";
 import { PmCliError } from "../core/shared/errors.js";
+import { decodeHtmlEntitiesInOptions } from "../core/shared/html-entity-decode.js";
 import { asRecordClone } from "../core/shared/primitives.js";
 import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
@@ -619,7 +620,13 @@ export async function handleRequest(request) {
         if (!handler) {
             throw new PmCliError(`Unknown pm MCP tool: ${name}`, 64);
         }
-        const args = asRecordClone(params.arguments);
+        // pm-ydkl: defensive HTML-entity decode for free-text fields. Claude / the
+        // Anthropic MCP SDK HTML-encodes `<` / `>` (and friends) in tool arguments
+        // before they reach pm-cli, which would otherwise leak `&lt;type&gt;` into
+        // stored pm comments / notes / item bodies. Direct CLI calls are not
+        // affected; decoding at the MCP boundary normalizes the agent path while
+        // leaving normal text untouched.
+        const args = decodeHtmlEntitiesInOptions(asRecordClone(params.arguments));
         const result = await withCwd(args.cwd, () => handler(args));
         return resultContent(result);
     }
@@ -669,4 +676,4 @@ if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
     startMcpServer();
 }
 //# sourceMappingURL=server.js.map
-//# debugId=16ab349e-99ce-51eb-85d5-62e1c2c56c10
+//# debugId=0b886283-0ee3-5dcd-bd65-6199134c8901