@unbrained/pm-cli 2026.5.2 → 2026.5.3-5

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

@@ -1,4 +1,5 @@
 import type { PmSettings } from "../../types/index.js";
+import type { SearchHttpFetcher, SearchHttpResponse } from "./http-client.js";
 export type VectorStoreName = "qdrant" | "lancedb";
 export interface QdrantVectorStoreConfig {
     name: "qdrant";
@@ -50,19 +51,8 @@ export interface VectorQueryHit {
 export interface VectorUpsertResult {
     status: string;
 }
-export interface VectorHttpResponse {
-    ok: boolean;
-    status: number;
-    statusText: string;
-    json(): Promise<unknown>;
-    text(): Promise<string>;
-}
-export type VectorRequestFetcher = (url: string, init: {
-    method: "POST";
-    headers: Record<string, string>;
-    body: string;
-    signal: AbortSignal;
-}) => Promise<VectorHttpResponse>;
+export type VectorHttpResponse = SearchHttpResponse;
+export type VectorRequestFetcher = SearchHttpFetcher<VectorHttpResponse>;
 export interface ExecuteVectorRequestOptions {
     timeout_ms?: number;
     fetcher?: VectorRequestFetcher;

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

@@ -1,8 +1,8 @@
 import { mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
 import { basename, dirname, join, resolve } from "node:path";
+import { executeSearchJsonRequest, normalizeSearchHttpTimeoutMs, resolveSearchHttpFetcher, } from "./http-client.js";
 import { isFiniteNumberArray, toErrorMessage, toNonEmptyString, trimTrailingSlashes, } from "../shared/primitives.js";
 const DEFAULT_COLLECTION = "pm_items";
-const DEFAULT_VECTOR_TIMEOUT_MS = 30_000;
 const LANCE_DB_LOCAL_SNAPSHOT_DIR = ".pm-cli-local-vectors";
 const LANCE_DB_LOCAL_SNAPSHOT_VERSION = 1;
 const lanceDbLocalTables = new Map();
@@ -18,30 +18,6 @@ function normalizeLimit(value) {
     }
     return Math.floor(value);
 }
-function resolveVectorFetcher(fetcher) {
-    if (fetcher) {
-        return fetcher;
-    }
-    if (typeof globalThis.fetch === "function") {
-        return globalThis.fetch.bind(globalThis);
-    }
-    throw new Error("Vector request execution requires a fetch implementation");
-}
-function normalizeTimeoutMs(timeoutMs) {
-    const resolved = timeoutMs ?? DEFAULT_VECTOR_TIMEOUT_MS;
-    if (!Number.isFinite(resolved) || resolved <= 0) {
-        throw new Error("Vector request timeout must be a positive finite number");
-    }
-    return Math.floor(resolved);
-}
-async function readFailedResponseBody(response) {
-    try {
-        return (await response.text()).replaceAll(/\s+/g, " ").trim();
-    }
-    catch (error) {
-        return `(failed to read response body: ${toErrorMessage(error)})`;
-    }
-}
 function normalizeQdrantQueryResponse(payload) {
     const result = payload.result;
     if (!Array.isArray(result)) {
@@ -89,41 +65,16 @@ function normalizeQdrantUpsertResponse(payload) {
     throw new Error("Qdrant upsert response must include status metadata");
 }
 async function executeRemoteVectorPlan(endpoint, plan, timeoutMs, fetcher, requestKind) {
-    const controller = new AbortController();
-    const timeoutHandle = setTimeout(() => {
-        controller.abort();
-    }, timeoutMs);
-    try {
-        let response;
-        try {
-            response = await fetcher(endpoint, {
-                method: plan.method,
-                headers: plan.headers,
-                body: JSON.stringify(plan.body),
-                signal: controller.signal,
-            });
-        }
-        catch (error) {
-            if (error instanceof Error && error.name === "AbortError") {
-                throw new Error(`Vector ${requestKind} request timed out after ${timeoutMs}ms`);
-            }
-            throw new Error(`Vector ${requestKind} request execution failed: ${toErrorMessage(error)}`);
-        }
-        if (!response.ok) {
-            const responseBody = await readFailedResponseBody(response);
-            const detail = responseBody.length > 0 ? `: ${responseBody}` : "";
-            throw new Error(`Vector ${requestKind} request failed with status ${response.status} ${response.statusText}${detail}`);
-        }
-        try {
-            return await response.json();
-        }
-        catch (error) {
-            throw new Error(`Vector ${requestKind} response JSON parse failed: ${toErrorMessage(error)}`);
-        }
-    }
-    finally {
-        clearTimeout(timeoutHandle);
-    }
+    return await executeSearchJsonRequest({
+        endpoint,
+        method: plan.method,
+        headers: plan.headers,
+        body: plan.body,
+        timeoutMs,
+        fetcher,
+        requestLabel: `Vector ${requestKind} request`,
+        responseLabel: `Vector ${requestKind} response`,
+    });
 }
 function resolveQdrantStore(settings) {
     const url = toNonEmptyString(settings.vector_store?.qdrant?.url);
@@ -478,8 +429,8 @@ export async function executeVectorQuery(store, vector, limit, options = {}) {
         });
         return hits.slice(0, queryLimit);
     }
-    const timeoutMs = normalizeTimeoutMs(options.timeout_ms);
-    const fetcher = resolveVectorFetcher(options.fetcher);
+    const timeoutMs = normalizeSearchHttpTimeoutMs(options.timeout_ms, "Vector request");
+    const fetcher = resolveSearchHttpFetcher(options.fetcher, "Vector request");
     const payload = await executeRemoteVectorPlan(plan.target.query_target, {
         method: "POST",
         headers: plan.headers,
@@ -501,8 +452,8 @@ export async function executeVectorUpsert(store, records, options = {}) {
         lanceDbLocalTables.set(key, table);
         return { status: "ok" };
     }
-    const timeoutMs = normalizeTimeoutMs(options.timeout_ms);
-    const fetcher = resolveVectorFetcher(options.fetcher);
+    const timeoutMs = normalizeSearchHttpTimeoutMs(options.timeout_ms, "Vector request");
+    const fetcher = resolveSearchHttpFetcher(options.fetcher, "Vector request");
     const payload = await executeRemoteVectorPlan(plan.target.upsert_target, {
         method: "POST",
         headers: plan.headers,
@@ -532,8 +483,8 @@ export async function executeVectorDelete(store, ids, options = {}) {
         }
         return { status: "ok" };
     }
-    const timeoutMs = normalizeTimeoutMs(options.timeout_ms);
-    const fetcher = resolveVectorFetcher(options.fetcher);
+    const timeoutMs = normalizeSearchHttpTimeoutMs(options.timeout_ms, "Vector request");
+    const fetcher = resolveSearchHttpFetcher(options.fetcher, "Vector request");
     const payload = await executeRemoteVectorPlan(resolveQdrantDeleteTarget(plan.target.upsert_target), {
         method: "POST",
         headers: plan.headers,

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

@@ -1 +1 @@
-{"version":3,"file":"vector-stores.js","sourceRoot":"/","sources":["core/search/vector-stores.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PmSettings } from \"../../types/index.js\";\nimport { mkdir, readFile, rename, unlink, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\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 interface VectorHttpResponse {\n  ok: boolean;\n  status: number;\n  statusText: string;\n  json(): Promise<unknown>;\n  text(): Promise<string>;\n}\n\nexport type VectorRequestFetcher = (\n  url: string,\n  init: {\n    method: \"POST\";\n    headers: Record<string, string>;\n    body: string;\n    signal: AbortSignal;\n  },\n) => Promise<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 DEFAULT_VECTOR_TIMEOUT_MS = 30_000;\nconst LANCE_DB_LOCAL_SNAPSHOT_DIR = \".pm-cli-local-vectors\";\nconst LANCE_DB_LOCAL_SNAPSHOT_VERSION = 1;\nconst lanceDbLocalTables = new Map<string, Map<string, VectorRecord>>();\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 resolveVectorFetcher(fetcher: VectorRequestFetcher | undefined): VectorRequestFetcher {\n  if (fetcher) {\n    return fetcher;\n  }\n  if (typeof globalThis.fetch === \"function\") {\n    return globalThis.fetch.bind(globalThis) as unknown as VectorRequestFetcher;\n  }\n  throw new Error(\"Vector request execution requires a fetch implementation\");\n}\n\nfunction normalizeTimeoutMs(timeoutMs: number | undefined): number {\n  const resolved = timeoutMs ?? DEFAULT_VECTOR_TIMEOUT_MS;\n  if (!Number.isFinite(resolved) || resolved <= 0) {\n    throw new Error(\"Vector request timeout must be a positive finite number\");\n  }\n  return Math.floor(resolved);\n}\n\nasync function readFailedResponseBody(response: VectorHttpResponse): Promise<string> {\n  try {\n    return (await response.text()).replaceAll(/\\s+/g, \" \").trim();\n  } catch (error) {\n    return `(failed to read response body: ${toErrorMessage(error)})`;\n  }\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  const controller = new AbortController();\n  const timeoutHandle = setTimeout(() => {\n    controller.abort();\n  }, timeoutMs);\n\n  try {\n    let response: VectorHttpResponse;\n    try {\n      response = await fetcher(endpoint, {\n        method: plan.method,\n        headers: plan.headers,\n        body: JSON.stringify(plan.body),\n        signal: controller.signal,\n      });\n    } catch (error) {\n      if (error instanceof Error && error.name === \"AbortError\") {\n        throw new Error(`Vector ${requestKind} request timed out after ${timeoutMs}ms`);\n      }\n      throw new Error(`Vector ${requestKind} request execution failed: ${toErrorMessage(error)}`);\n    }\n\n    if (!response.ok) {\n      const responseBody = await readFailedResponseBody(response);\n      const detail = responseBody.length > 0 ? `: ${responseBody}` : \"\";\n      throw new Error(`Vector ${requestKind} request failed with status ${response.status} ${response.statusText}${detail}`);\n    }\n\n    try {\n      return await response.json();\n    } catch (error) {\n      throw new Error(`Vector ${requestKind} response JSON parse failed: ${toErrorMessage(error)}`);\n    }\n  } finally {\n    clearTimeout(timeoutHandle);\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 cached = lanceDbLocalTables.get(key);\n  if (cached) {\n    return cached;\n  }\n\n  const snapshotPath = getLanceDbSnapshotPath(storePath, table);\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, loaded);\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 = normalizeTimeoutMs(options.timeout_ms);\n  const fetcher = resolveVectorFetcher(options.fetcher);\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    lanceDbLocalTables.set(key, table);\n    return { status: \"ok\" };\n  }\n  const timeoutMs = normalizeTimeoutMs(options.timeout_ms);\n  const fetcher = resolveVectorFetcher(options.fetcher);\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      lanceDbLocalTables.set(key, table);\n    }\n    return { status: \"ok\" };\n  }\n  const timeoutMs = normalizeTimeoutMs(options.timeout_ms);\n  const fetcher = resolveVectorFetcher(options.fetcher);\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"]}
+{"version":3,"file":"vector-stores.js","sourceRoot":"/","sources":["core/search/vector-stores.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PmSettings } from \"../../types/index.js\";\nimport { mkdir, readFile, rename, 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;\nconst lanceDbLocalTables = new Map<string, Map<string, VectorRecord>>();\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 cached = lanceDbLocalTables.get(key);\n  if (cached) {\n    return cached;\n  }\n\n  const snapshotPath = getLanceDbSnapshotPath(storePath, table);\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, loaded);\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    lanceDbLocalTables.set(key, table);\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      lanceDbLocalTables.set(key, table);\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"]}

package/dist/core/sentry/helpers.d.ts

@@ -1,6 +1,27 @@
-export declare function sentrySetCommandContext(command: string, args: string[], options: Record<string, unknown>): void;
+import type { TelemetryErrorCategory } from "../shared/constants.js";
+import { type TelemetryCommandResolution, type TelemetryResolutionStage } from "../telemetry/observability.js";
+export declare function sentrySetCommandContext(command: string, args: string[], options: Record<string, unknown>, metadata?: {
+    source_context?: string;
+    source_context_source?: string;
+}): void;
 export declare function sentryStartCommandSpan(command: string): void;
-export declare function sentryFinishCommandSpan(ok: boolean, error?: string): void;
+export declare function sentryFinishCommandSpan(ok: boolean, error?: string, metadata?: {
+    error_code?: string;
+    error_category?: TelemetryErrorCategory;
+    exit_code?: number;
+    command_resolution?: TelemetryCommandResolution;
+    resolution_stage?: TelemetryResolutionStage;
+}): void;
 export declare function sentryCaptureCliError(error: unknown): void;
+export declare function sentryLogCliUsageError(params: {
+    command: string;
+    error_code: string;
+    error_category: TelemetryErrorCategory;
+    exit_code: number;
+    error_message: string;
+    command_resolution?: TelemetryCommandResolution;
+    resolution_stage?: TelemetryResolutionStage;
+    source_context?: string;
+}): void;
 export declare function shouldCaptureCliError(error: unknown): boolean;
 export declare function sentryFlush(): Promise<void>;

package/dist/core/sentry/helpers.js

@@ -1,22 +1,48 @@
 import { getSentry } from "./instrument.js";
 import { PmCliError } from "../shared/errors.js";
+import { deriveTelemetryCommandResolution, deriveTelemetryCommandTaxonomy, } from "../telemetry/observability.js";
 let activeCommandSpan;
-export function sentrySetCommandContext(command, args, options) {
+function setSpanAttribute(span, key, value) {
+    if (value === undefined) {
+        return;
+    }
+    const attributeTarget = span;
+    if (typeof attributeTarget.setAttribute === "function") {
+        attributeTarget.setAttribute(key, value);
+    }
+}
+export function sentrySetCommandContext(command, args, options, metadata) {
     const Sentry = getSentry();
     if (!Sentry)
         return;
+    const taxonomy = deriveTelemetryCommandTaxonomy(command);
     Sentry.setTag("pm.command", command);
+    Sentry.setTag("pm.command_root", taxonomy.command_root);
+    Sentry.setTag("pm.command_family", taxonomy.command_family);
+    if (typeof metadata?.source_context === "string" && metadata.source_context.trim().length > 0) {
+        Sentry.setTag("pm.source_context", metadata.source_context);
+    }
     const safeArgs = args.map((arg) => arg.startsWith("--") ? arg.split("=")[0] : arg);
     Sentry.setContext("pm.command", {
         name: command,
+        root: taxonomy.command_root,
+        leaf: taxonomy.command_leaf,
+        family: taxonomy.command_family,
         args: safeArgs,
         option_keys: Object.keys(options).sort(),
+        source_context: metadata?.source_context,
+        source_context_source: metadata?.source_context_source,
     });
     Sentry.addBreadcrumb({
         category: "pm.command",
         message: `pm ${command}`,
         level: "info",
-        data: { args: safeArgs },
+        data: {
+            args: safeArgs,
+            command_root: taxonomy.command_root,
+            command_family: taxonomy.command_family,
+            source_context: metadata?.source_context,
+        },
     });
 }
 export function sentryStartCommandSpan(command) {
@@ -29,9 +55,40 @@ export function sentryStartCommandSpan(command) {
         forceTransaction: true,
     });
 }
-export function sentryFinishCommandSpan(ok, error) {
+export function sentryFinishCommandSpan(ok, error, metadata) {
     if (!activeCommandSpan)
         return;
+    const normalizedOk = ok ? "true" : "false";
+    const normalizedExitCode = typeof metadata?.exit_code === "number" ? String(metadata.exit_code) : undefined;
+    const Sentry = getSentry();
+    if (Sentry) {
+        Sentry.setTag("pm.ok", normalizedOk);
+        Sentry.setTag("pm.command_ok", normalizedOk);
+        if (typeof metadata?.exit_code === "number") {
+            Sentry.setTag("pm.exit_code", String(metadata.exit_code));
+            Sentry.setTag("pm.command_exit_code", String(metadata.exit_code));
+        }
+        if (typeof metadata?.error_code === "string" && metadata.error_code.trim().length > 0) {
+            Sentry.setTag("pm.error_code", metadata.error_code);
+        }
+        if (typeof metadata?.error_category === "string" && metadata.error_category.trim().length > 0) {
+            Sentry.setTag("pm.error_category", metadata.error_category);
+        }
+        if (typeof metadata?.command_resolution === "string" && metadata.command_resolution.trim().length > 0) {
+            Sentry.setTag("pm.command_resolution", metadata.command_resolution);
+        }
+        if (typeof metadata?.resolution_stage === "string" && metadata.resolution_stage.trim().length > 0) {
+            Sentry.setTag("pm.resolution_stage", metadata.resolution_stage);
+        }
+    }
+    setSpanAttribute(activeCommandSpan, "pm.ok", normalizedOk);
+    setSpanAttribute(activeCommandSpan, "pm.command_ok", normalizedOk);
+    setSpanAttribute(activeCommandSpan, "pm.exit_code", normalizedExitCode);
+    setSpanAttribute(activeCommandSpan, "pm.command_exit_code", normalizedExitCode);
+    setSpanAttribute(activeCommandSpan, "pm.error_code", metadata?.error_code);
+    setSpanAttribute(activeCommandSpan, "pm.error_category", metadata?.error_category);
+    setSpanAttribute(activeCommandSpan, "pm.command_resolution", metadata?.command_resolution);
+    setSpanAttribute(activeCommandSpan, "pm.resolution_stage", metadata?.resolution_stage);
     activeCommandSpan.setStatus(ok ? { code: 1 } : { code: 2, message: error ?? "command_failed" });
     activeCommandSpan.end();
     activeCommandSpan = undefined;
@@ -56,6 +113,47 @@ export function sentryCaptureCliError(error) {
         Sentry.captureException(new Error(String(error)));
     }
 }
+export function sentryLogCliUsageError(params) {
+    const Sentry = getSentry();
+    if (!Sentry)
+        return;
+    const resolvedCommandResolution = params.command_resolution ??
+        deriveTelemetryCommandResolution({
+            ok: false,
+            errorCode: params.error_code,
+            errorCategory: params.error_category,
+        });
+    const resolvedResolutionStage = params.resolution_stage ?? "unknown";
+    const payload = {
+        "pm.command": params.command,
+        "pm.error_code": params.error_code,
+        "pm.error_category": params.error_category,
+        "pm.exit_code": params.exit_code,
+        "pm.error_message": params.error_message,
+        "pm.command_resolution": resolvedCommandResolution,
+        "pm.resolution_stage": resolvedResolutionStage,
+        "pm.source_context": params.source_context ?? "",
+    };
+    const loggerCandidate = Sentry
+        .logger;
+    if (loggerCandidate && typeof loggerCandidate.warn === "function") {
+        loggerCandidate.warn("pm_cli_usage_error", payload);
+        return;
+    }
+    Sentry.captureMessage(`pm_cli_usage_error:${params.error_code}`, {
+        level: "warning",
+        tags: {
+            "pm.command": params.command,
+            "pm.error_code": params.error_code,
+            "pm.error_category": params.error_category,
+            "pm.exit_code": String(params.exit_code),
+            "pm.command_resolution": resolvedCommandResolution,
+            "pm.resolution_stage": resolvedResolutionStage,
+            "pm.source_context": params.source_context ?? "unknown",
+        },
+        extra: payload,
+    });
+}
 export function shouldCaptureCliError(error) {
     return !(error instanceof PmCliError);
 }

package/dist/core/sentry/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"/","sources":["core/sentry/helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import { getSentry } from \"./instrument.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport type { Span } from \"@sentry/node\";\n\nlet activeCommandSpan: Span | undefined;\n\nexport function sentrySetCommandContext(\n  command: string,\n  args: string[],\n  options: Record<string, unknown>,\n): void {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n\n  Sentry.setTag(\"pm.command\", command);\n\n  const safeArgs = args.map((arg) =>\n    arg.startsWith(\"--\") ? arg.split(\"=\")[0] : arg,\n  );\n\n  Sentry.setContext(\"pm.command\", {\n    name: command,\n    args: safeArgs,\n    option_keys: Object.keys(options).sort(),\n  });\n\n  Sentry.addBreadcrumb({\n    category: \"pm.command\",\n    message: `pm ${command}`,\n    level: \"info\",\n    data: { args: safeArgs },\n  });\n}\n\nexport function sentryStartCommandSpan(command: string): void {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n\n  activeCommandSpan = Sentry.startInactiveSpan({\n    op: \"pm.command\",\n    name: `pm ${command}`,\n    forceTransaction: true,\n  });\n}\n\nexport function sentryFinishCommandSpan(ok: boolean, error?: string): void {\n  if (!activeCommandSpan) return;\n  activeCommandSpan.setStatus(ok ? { code: 1 } : { code: 2, message: error ?? \"command_failed\" });\n  activeCommandSpan.end();\n  activeCommandSpan = undefined;\n}\n\nexport function sentryCaptureCliError(error: unknown): void {\n  if (!shouldCaptureCliError(error)) return;\n\n  const Sentry = getSentry();\n  if (!Sentry) return;\n\n  if (error instanceof Error) {\n    const extras: Record<string, unknown> = {};\n    if (\"exitCode\" in error && typeof (error as { exitCode: unknown }).exitCode === \"number\") {\n      extras.exit_code = (error as { exitCode: number }).exitCode;\n    }\n    if (\"context\" in error && typeof (error as { context: unknown }).context === \"object\") {\n      extras.error_context = (error as { context: unknown }).context;\n    }\n    Sentry.captureException(error, { extra: extras });\n  } else {\n    Sentry.captureException(new Error(String(error)));\n  }\n}\n\nexport function shouldCaptureCliError(error: unknown): boolean {\n  return !(error instanceof PmCliError);\n}\n\nexport async function sentryFlush(): Promise<void> {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n\n  try {\n    await Sentry.flush(3000);\n  } catch {\n    // Sentry flush must never block CLI exit.\n  }\n}\n"]}
+{"version":3,"file":"helpers.js","sourceRoot":"/","sources":["core/sentry/helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import { getSentry } from \"./instrument.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport type { TelemetryErrorCategory } from \"../shared/constants.js\";\nimport {\n  deriveTelemetryCommandResolution,\n  deriveTelemetryCommandTaxonomy,\n  type TelemetryCommandResolution,\n  type TelemetryResolutionStage,\n} from \"../telemetry/observability.js\";\nimport type { Span } from \"@sentry/node\";\n\nlet activeCommandSpan: Span | undefined;\n\nfunction setSpanAttribute(\n  span: Span,\n  key: string,\n  value: string | number | boolean | undefined,\n): void {\n  if (value === undefined) {\n    return;\n  }\n  const attributeTarget = span as unknown as { setAttribute?: (attrKey: string, attrValue: string | number | boolean) => void };\n  if (typeof attributeTarget.setAttribute === \"function\") {\n    attributeTarget.setAttribute(key, value);\n  }\n}\n\nexport function sentrySetCommandContext(\n  command: string,\n  args: string[],\n  options: Record<string, unknown>,\n  metadata?: {\n    source_context?: string;\n    source_context_source?: string;\n  },\n): void {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n  const taxonomy = deriveTelemetryCommandTaxonomy(command);\n\n  Sentry.setTag(\"pm.command\", command);\n  Sentry.setTag(\"pm.command_root\", taxonomy.command_root);\n  Sentry.setTag(\"pm.command_family\", taxonomy.command_family);\n  if (typeof metadata?.source_context === \"string\" && metadata.source_context.trim().length > 0) {\n    Sentry.setTag(\"pm.source_context\", metadata.source_context);\n  }\n\n  const safeArgs = args.map((arg) =>\n    arg.startsWith(\"--\") ? arg.split(\"=\")[0] : arg,\n  );\n\n  Sentry.setContext(\"pm.command\", {\n    name: command,\n    root: taxonomy.command_root,\n    leaf: taxonomy.command_leaf,\n    family: taxonomy.command_family,\n    args: safeArgs,\n    option_keys: Object.keys(options).sort(),\n    source_context: metadata?.source_context,\n    source_context_source: metadata?.source_context_source,\n  });\n\n  Sentry.addBreadcrumb({\n    category: \"pm.command\",\n    message: `pm ${command}`,\n    level: \"info\",\n    data: {\n      args: safeArgs,\n      command_root: taxonomy.command_root,\n      command_family: taxonomy.command_family,\n      source_context: metadata?.source_context,\n    },\n  });\n}\n\nexport function sentryStartCommandSpan(command: string): void {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n\n  activeCommandSpan = Sentry.startInactiveSpan({\n    op: \"pm.command\",\n    name: `pm ${command}`,\n    forceTransaction: true,\n  });\n}\n\nexport function sentryFinishCommandSpan(\n  ok: boolean,\n  error?: string,\n  metadata?: {\n    error_code?: string;\n    error_category?: TelemetryErrorCategory;\n    exit_code?: number;\n    command_resolution?: TelemetryCommandResolution;\n    resolution_stage?: TelemetryResolutionStage;\n  },\n): void {\n  if (!activeCommandSpan) return;\n  const normalizedOk = ok ? \"true\" : \"false\";\n  const normalizedExitCode = typeof metadata?.exit_code === \"number\" ? String(metadata.exit_code) : undefined;\n  const Sentry = getSentry();\n  if (Sentry) {\n    Sentry.setTag(\"pm.ok\", normalizedOk);\n    Sentry.setTag(\"pm.command_ok\", normalizedOk);\n    if (typeof metadata?.exit_code === \"number\") {\n      Sentry.setTag(\"pm.exit_code\", String(metadata.exit_code));\n      Sentry.setTag(\"pm.command_exit_code\", String(metadata.exit_code));\n    }\n    if (typeof metadata?.error_code === \"string\" && metadata.error_code.trim().length > 0) {\n      Sentry.setTag(\"pm.error_code\", metadata.error_code);\n    }\n    if (typeof metadata?.error_category === \"string\" && metadata.error_category.trim().length > 0) {\n      Sentry.setTag(\"pm.error_category\", metadata.error_category);\n    }\n    if (typeof metadata?.command_resolution === \"string\" && metadata.command_resolution.trim().length > 0) {\n      Sentry.setTag(\"pm.command_resolution\", metadata.command_resolution);\n    }\n    if (typeof metadata?.resolution_stage === \"string\" && metadata.resolution_stage.trim().length > 0) {\n      Sentry.setTag(\"pm.resolution_stage\", metadata.resolution_stage);\n    }\n  }\n  setSpanAttribute(activeCommandSpan, \"pm.ok\", normalizedOk);\n  setSpanAttribute(activeCommandSpan, \"pm.command_ok\", normalizedOk);\n  setSpanAttribute(activeCommandSpan, \"pm.exit_code\", normalizedExitCode);\n  setSpanAttribute(activeCommandSpan, \"pm.command_exit_code\", normalizedExitCode);\n  setSpanAttribute(activeCommandSpan, \"pm.error_code\", metadata?.error_code);\n  setSpanAttribute(activeCommandSpan, \"pm.error_category\", metadata?.error_category);\n  setSpanAttribute(activeCommandSpan, \"pm.command_resolution\", metadata?.command_resolution);\n  setSpanAttribute(activeCommandSpan, \"pm.resolution_stage\", metadata?.resolution_stage);\n  activeCommandSpan.setStatus(ok ? { code: 1 } : { code: 2, message: error ?? \"command_failed\" });\n  activeCommandSpan.end();\n  activeCommandSpan = undefined;\n}\n\nexport function sentryCaptureCliError(error: unknown): void {\n  if (!shouldCaptureCliError(error)) return;\n\n  const Sentry = getSentry();\n  if (!Sentry) return;\n\n  if (error instanceof Error) {\n    const extras: Record<string, unknown> = {};\n    if (\"exitCode\" in error && typeof (error as { exitCode: unknown }).exitCode === \"number\") {\n      extras.exit_code = (error as { exitCode: number }).exitCode;\n    }\n    if (\"context\" in error && typeof (error as { context: unknown }).context === \"object\") {\n      extras.error_context = (error as { context: unknown }).context;\n    }\n    Sentry.captureException(error, { extra: extras });\n  } else {\n    Sentry.captureException(new Error(String(error)));\n  }\n}\n\nexport function sentryLogCliUsageError(params: {\n  command: string;\n  error_code: string;\n  error_category: TelemetryErrorCategory;\n  exit_code: number;\n  error_message: string;\n  command_resolution?: TelemetryCommandResolution;\n  resolution_stage?: TelemetryResolutionStage;\n  source_context?: string;\n}): void {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n  const resolvedCommandResolution =\n    params.command_resolution ??\n    deriveTelemetryCommandResolution({\n      ok: false,\n      errorCode: params.error_code,\n      errorCategory: params.error_category,\n    });\n  const resolvedResolutionStage = params.resolution_stage ?? \"unknown\";\n\n  const payload = {\n    \"pm.command\": params.command,\n    \"pm.error_code\": params.error_code,\n    \"pm.error_category\": params.error_category,\n    \"pm.exit_code\": params.exit_code,\n    \"pm.error_message\": params.error_message,\n    \"pm.command_resolution\": resolvedCommandResolution,\n    \"pm.resolution_stage\": resolvedResolutionStage,\n    \"pm.source_context\": params.source_context ?? \"\",\n  };\n  const loggerCandidate = (Sentry as unknown as { logger?: { warn?: (message: string, attributes?: Record<string, unknown>) => void } })\n    .logger;\n  if (loggerCandidate && typeof loggerCandidate.warn === \"function\") {\n    loggerCandidate.warn(\"pm_cli_usage_error\", payload);\n    return;\n  }\n\n  Sentry.captureMessage(`pm_cli_usage_error:${params.error_code}`, {\n    level: \"warning\",\n    tags: {\n      \"pm.command\": params.command,\n      \"pm.error_code\": params.error_code,\n      \"pm.error_category\": params.error_category,\n      \"pm.exit_code\": String(params.exit_code),\n      \"pm.command_resolution\": resolvedCommandResolution,\n      \"pm.resolution_stage\": resolvedResolutionStage,\n      \"pm.source_context\": params.source_context ?? \"unknown\",\n    },\n    extra: payload,\n  });\n}\n\nexport function shouldCaptureCliError(error: unknown): boolean {\n  return !(error instanceof PmCliError);\n}\n\nexport async function sentryFlush(): Promise<void> {\n  const Sentry = getSentry();\n  if (!Sentry) return;\n\n  try {\n    await Sentry.flush(3000);\n  } catch {\n    // Sentry flush must never block CLI exit.\n  }\n}\n"]}

package/dist/core/sentry/instrument.d.ts

@@ -1,4 +1,25 @@
+declare function scrubString(value: string): string;
 type SentryLike = typeof import("@sentry/node");
+declare function isExpectedCliErrorEvent(event: {
+    exception?: {
+        values?: Array<{
+            type?: string;
+            value?: string;
+        }>;
+    };
+    message?: string;
+    extra?: Record<string, unknown>;
+    logger?: string;
+}): boolean;
+declare function isPmCliErrorBreadcrumb(breadcrumb: {
+    category?: string;
+    message?: string;
+}): boolean;
 export declare function ensureSentryInit(): Promise<SentryLike | undefined>;
 export declare function getSentry(): SentryLike | undefined;
+export declare const _testOnly: {
+    isExpectedCliErrorEvent: typeof isExpectedCliErrorEvent;
+    isPmCliErrorBreadcrumb: typeof isPmCliErrorBreadcrumb;
+    scrubString: typeof scrubString;
+};
 export {};