@unbrained/pm-cli 2026.7.16 → 2026.7.17

package/dist/cli-bundle/chunks/{chunk-HYB5AZ63.js → chunk-S46R2M3W.js}

@@ -1,6 +1,6 @@
 import {
   collectStaleVectorizationIds
-} from "./chunk-E2OJMKML.js";
+} from "./chunk-DCC2AQBD.js";
 import {
   buildListQueryFilters
 } from "./chunk-KWYX6ZIR.js";
@@ -19,28 +19,28 @@ import {
   resolveContentFieldFilters,
   resolveMissingMetadataFilters,
   runList
-} from "./chunk-XXXF6PAQ.js";
+} from "./chunk-7LTCLTRG.js";
 import {
   createQueryFingerprint,
   paginateQueryRows
-} from "./chunk-4223PVZT.js";
+} from "./chunk-M7MVOKVV.js";
 import {
   getItemAt
-} from "./chunk-3U7ZR6M4.js";
+} from "./chunk-B57RJHBZ.js";
 import {
   hasMissingMetadataFilter,
   itemMatchesMissingMetadata,
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-IJIICKVW.js";
+} from "./chunk-NTRQLE2R.js";
 import {
   readHistoryEntries
-} from "./chunk-TD3LVC7D.js";
+} from "./chunk-X5YCTFKT.js";
 import {
   parseLimit
-} from "./chunk-NU3IMIEA.js";
+} from "./chunk-I7DIDUSP.js";
 import {
   recordContextUsageTouches
-} from "./chunk-YCQET3OT.js";
+} from "./chunk-BAP7G3N2.js";
 import {
   resolveRegisteredSearchProvider,
   resolveRegisteredVectorStoreAdapter
@@ -57,7 +57,7 @@ import {
   resolveSearchCorpusFields,
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores
-} from "./chunk-7B67ZL4N.js";
+} from "./chunk-B6SH2YNN.js";
 import {
   splitCommaList
 } from "./chunk-D6HZN36B.js";
@@ -79,7 +79,7 @@ import {
   resolveIsoOrRelative,
   runActiveOnReadHooks,
   toItemRecord
-} from "./chunk-XSJUSQAE.js";
+} from "./chunk-646MQXFW.js";
 import {
   EXIT_CODE,
   ITEM_METADATA_KEY_ORDER,
@@ -100,7 +100,7 @@ import {
   resolveRuntimeStatusRegistry,
   toNonEmptyString,
   toNonEmptyStringOrUndefined
-} from "./chunk-BSEQUTQP.js";
+} from "./chunk-WACRQ26A.js";
 
 // dist/cli/commands/aggregate.js
 !(function() {
@@ -451,7 +451,7 @@ async function runAggregate(options, global2) {
   };
 }
 
-// dist/cli/commands/search.js
+// dist/sdk/query/search.js
 import fs from "node:fs/promises";
 import path from "node:path";
 
@@ -794,11 +794,11 @@ function resolveBm25Params(settings) {
   };
 }
 
-// dist/cli/commands/search-rendering.js
+// dist/sdk/query/search-rendering.js
 !(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] = "4445c28d-0c05-583a-8b92-9dbe60e8b467");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "b1092f14-e16e-5d4e-b92b-3456083b1438");
   } catch (e2) {
   }
 })();
@@ -891,11 +891,11 @@ function buildVerboseSearchFilters(params) {
   };
 }
 
-// dist/cli/commands/search-pagination.js
+// dist/sdk/query/search-pagination.js
 !(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] = "39599b41-97b7-53e2-9318-db5e3724bf2e");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "6da6518b-1686-5bf3-8444-a9f48dc4f407");
   } catch (e2) {
   }
 })();
@@ -933,11 +933,11 @@ function resolveSearchPage(options) {
   };
 }
 
-// dist/cli/commands/search.js
+// dist/sdk/query/search.js
 !(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] = "c6c363b7-9d2f-5a6b-8cc9-ab0a8db6c495");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "7d6721eb-1e28-58ea-a5fc-4494f249275c");
   } catch (e2) {
   }
 })();
@@ -1530,6 +1530,7 @@ function highlightFieldSnippet(text, tokens) {
   }
   const lowerText = text.toLowerCase();
   let firstMatchIndex = -1;
+  let firstMatchLength = 0;
   for (const token of tokens) {
     if (token.length === 0) {
       continue;
@@ -1537,13 +1538,14 @@ function highlightFieldSnippet(text, tokens) {
     const index = lowerText.indexOf(token);
     if (index >= 0 && (firstMatchIndex < 0 || index < firstMatchIndex)) {
       firstMatchIndex = index;
+      firstMatchLength = token.length;
     }
   }
   if (firstMatchIndex < 0) {
     return null;
   }
   const windowStart = Math.max(0, firstMatchIndex - HIGHLIGHT_SNIPPET_RADIUS);
-  const windowEnd = Math.min(text.length, firstMatchIndex + HIGHLIGHT_SNIPPET_RADIUS);
+  const windowEnd = Math.min(text.length, firstMatchIndex + firstMatchLength + HIGHLIGHT_SNIPPET_RADIUS);
   const marked = markTokenRuns(text.slice(windowStart, windowEnd), tokens);
   const prefix = windowStart > 0 ? "\u2026" : "";
   const suffix = windowEnd < text.length ? "\u2026" : "";
@@ -2316,7 +2318,7 @@ function readSearchFieldValue(hit, field) {
 }
 function projectSearchHits(hits, projection) {
   if (projection.mode === "full") {
-    return hits.map(({ matched_all_terms: _matchedAllTerms, ...hit }) => hit);
+    return hits.map(({ matched_all_terms: _matchedAllTerms, exact_id_match: _exactIdMatch, ...hit }) => hit);
   }
   return hits.map((hit) => {
     const projected = {};
@@ -2715,7 +2717,7 @@ async function runSearch(rawQuery, rawOptions, global2) {
     warnings,
     runtimeFieldFilters: runtime.runtimeFieldFilters
   };
-  if (runtime.effectiveMode === "keyword" && (corpus.filteredDocuments.length === 0 || prepared.limit === 0)) {
+  if (runtime.effectiveMode === "keyword" && (corpus.filteredDocuments.length === 0 || prepared.limit === 0 && !prepared.countOnly)) {
     return buildEmptySearchResultFromContext({ ...responseBase, effectiveMode: runtime.effectiveMode }, prepared.countOnly);
   }
   const keywordHits = await computeKeywordSearchHits(prepared, runtime, corpus.filteredDocuments);
@@ -2727,7 +2729,7 @@ async function runSearch(rawQuery, rawOptions, global2) {
     warnings,
     modeWasExplicit: prepared.modeWasExplicit
   });
-  if (modeResult.effectiveMode !== "keyword" && modeResult.hits.length === 0 && (corpus.filteredDocuments.length === 0 || prepared.limit === 0)) {
+  if (modeResult.effectiveMode !== "keyword" && modeResult.hits.length === 0 && (corpus.filteredDocuments.length === 0 || prepared.limit === 0 && !prepared.countOnly)) {
     return buildEmptySearchResultFromContext({ ...responseBase, effectiveMode: modeResult.effectiveMode }, prepared.countOnly);
   }
   const thresholded = modeResult.hits.filter((entry) => entry.exact_id_match === true || entry.score >= runtime.scoreThreshold);
@@ -2749,7 +2751,7 @@ async function runSearch(rawQuery, rawOptions, global2) {
   return buildSearchResultForHits(response, projectedItems, total, page.limited.length, effectiveProjection, page.pageExtras);
 }
 
-// dist/cli/commands/eval.js
+// dist/sdk/eval.js
 import fs2 from "node:fs/promises";
 import path2 from "node:path";
 
@@ -2896,11 +2898,11 @@ function parseEvalQuerySet(raw) {
   };
 }
 
-// dist/cli/commands/eval.js
+// dist/sdk/eval.js
 !(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] = "bf3ddf99-3338-5cfc-a1f0-3d4bb15877da");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "57d5033f-647c-5813-8294-33096b5e090e");
   } catch (e2) {
   }
 })();
@@ -2910,7 +2912,7 @@ var VALID_EVAL_MODES2 = /* @__PURE__ */ new Set([
   "semantic",
   "hybrid"
 ]);
-function parseEvalMode(raw) {
+var parseEvalMode = (raw) => {
   if (raw === void 0) {
     return "keyword";
   }
@@ -2919,8 +2921,8 @@ function parseEvalMode(raw) {
     throw new PmCliError("Eval --mode must be one of keyword|semantic|hybrid", EXIT_CODE.USAGE);
   }
   return normalized;
-}
-function parseEvalK(raw) {
+};
+var parseEvalK = (raw) => {
   if (raw === void 0 || raw === "") {
     return DEFAULT_EVAL_K;
   }
@@ -2929,28 +2931,31 @@ function parseEvalK(raw) {
     throw new PmCliError("Eval --k must be a positive integer", EXIT_CODE.USAGE);
   }
   return parsed;
-}
-function parseFailUnder(raw) {
+};
+var parseFailUnder = (raw) => {
   if (raw === void 0 || raw === "") {
     return void 0;
   }
-  const parsed = typeof raw === "number" ? raw : Number(String(raw).trim());
-  if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {
+  const normalized = String(raw).trim();
+  const parsed = Number(normalized);
+  if ([
+    normalized.length === 0,
+    !Number.isFinite(parsed),
+    parsed < 0,
+    parsed > 1
+  ].includes(true)) {
     throw new PmCliError("Eval --fail-under must be a number in the range [0, 1]", EXIT_CODE.USAGE);
   }
   return parsed;
-}
-function roundMetric(value) {
-  return Math.round(value * 1e4) / 1e4;
-}
-async function loadEvalQuerySet(queriesPath) {
-  let raw;
+};
+var roundMetric = (value) => Math.round(value * 1e4) / 1e4;
+var readEvalQuerySetFile = async (queriesPath) => {
   try {
-    raw = await fs2.readFile(queriesPath, "utf8");
+    return await fs2.readFile(queriesPath, "utf8");
   } catch {
     throw new PmCliError(`Eval query set not found at ${queriesPath}`, EXIT_CODE.NOT_FOUND, {
       examples: [
-        `echo '[{"query":"offline search","relevant_ids":["pm-75k9"]}]' > ` + queriesPath,
+        `echo '[{"query":"offline search","relevant_ids":["pm-75k9"]}]' > ${queriesPath}`,
         "pm eval --queries ./my-eval.json"
       ],
       nextSteps: [
@@ -2958,37 +2963,39 @@ async function loadEvalQuerySet(queriesPath) {
       ]
     });
   }
-  let parsed;
+};
+var parseEvalQuerySetJson = (raw, queriesPath) => {
   try {
-    parsed = JSON.parse(raw);
+    return JSON.parse(raw);
   } catch (error) {
-    throw new PmCliError(`Eval query set at ${queriesPath} is not valid JSON: ${error.message}`, EXIT_CODE.USAGE);
+    throw new PmCliError(
+      /* c8 ignore next -- JSON.parse throws Error instances; String fallback protects nonstandard hosts. */
+      `Eval query set at ${queriesPath} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
+      EXIT_CODE.USAGE
+    );
   }
+};
+var validateEvalQuerySet = (parsed) => {
   try {
     return parseEvalQuerySet(parsed);
   } catch (error) {
-    throw new PmCliError(error.message, EXIT_CODE.USAGE);
+    throw new PmCliError(
+      /* c8 ignore next -- parseEvalQuerySet throws Error instances; String fallback protects nonstandard hosts. */
+      error instanceof Error ? error.message : String(error),
+      EXIT_CODE.USAGE
+    );
   }
-}
-async function runEval(options, global2) {
-  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
-  if (!await pathExists(getSettingsPath(pmRoot))) {
-    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-  }
-  const k = parseEvalK(options.k);
-  const defaultMode = parseEvalMode(options.mode);
-  const failUnder = parseFailUnder(options.failUnder);
-  const queriesPath = options.queries ? path2.resolve(process.cwd(), options.queries) : path2.join(pmRoot, DEFAULT_EVAL_QUERIES_RELATIVE_PATH);
-  const querySet = await loadEvalQuerySet(queriesPath);
-  const reports = [];
-  const rawMetrics = [];
-  for (const evalQuery of querySet.queries) {
-    const mode = evalQuery.mode ?? defaultMode;
-    const searchResult = await runSearch(evalQuery.query, { mode, limit: String(k), fields: "id" }, global2);
-    const rankedIds = searchResult.items.map((item) => item.id).filter((id) => typeof id === "string");
-    const metrics = evaluateRanking(rankedIds, new Set(evalQuery.relevant_ids), k);
-    rawMetrics.push(metrics);
-    reports.push({
+};
+var loadEvalQuerySet = async (queriesPath) => validateEvalQuerySet(parseEvalQuerySetJson(await readEvalQuerySetFile(queriesPath), queriesPath));
+var resolveEvalQueriesPath = (pmRoot, queries) => queries ? path2.resolve(process.cwd(), queries) : path2.join(pmRoot, DEFAULT_EVAL_QUERIES_RELATIVE_PATH);
+var evaluateEvalQuery = async (evalQuery, defaultMode, k, global2) => {
+  const mode = evalQuery.mode ?? defaultMode;
+  const searchResult = await runSearch(evalQuery.query, { mode, limit: String(k), fields: "id" }, global2);
+  const rankedIds = searchResult.items.map((item) => item.id).filter((id) => typeof id === "string");
+  const metrics = evaluateRanking(rankedIds, new Set(evalQuery.relevant_ids), k);
+  return {
+    metrics,
+    report: {
       query: evalQuery.query,
       mode,
       relevant_total: metrics.relevant_total,
@@ -2997,13 +3004,14 @@ async function runEval(options, global2) {
       mrr: roundMetric(metrics.mrr),
       precision: roundMetric(metrics.precision),
       recall: roundMetric(metrics.recall)
-    });
-  }
+    }
+  };
+};
+var buildEvalResult = (k, reports, rawMetrics, failUnder) => {
   const aggregate = aggregateEvalMetrics(rawMetrics);
-  const passed = failUnder === void 0 || aggregate.ndcg >= failUnder;
   return {
     k,
-    query_count: querySet.queries.length,
+    query_count: reports.length,
     aggregate: {
       ndcg: roundMetric(aggregate.ndcg),
       mrr: roundMetric(aggregate.mrr),
@@ -3012,9 +3020,37 @@ async function runEval(options, global2) {
     },
     queries: reports,
     ...failUnder !== void 0 ? { fail_under: failUnder } : {},
-    passed
+    passed: failUnder === void 0 || aggregate.ndcg >= failUnder
   };
-}
+};
+var runEval = async (options, global2) => {
+  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
+  if (!await pathExists(getSettingsPath(pmRoot))) {
+    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+  }
+  const k = parseEvalK(options.k);
+  const defaultMode = parseEvalMode(options.mode);
+  const failUnder = parseFailUnder(options.failUnder);
+  const queriesPath = resolveEvalQueriesPath(pmRoot, options.queries);
+  const querySet = await loadEvalQuerySet(queriesPath);
+  const reports = [];
+  const rawMetrics = [];
+  for (const evalQuery of querySet.queries) {
+    const { report, metrics } = await evaluateEvalQuery(evalQuery, defaultMode, k, global2);
+    rawMetrics.push(metrics);
+    reports.push(report);
+  }
+  return buildEvalResult(k, reports, rawMetrics, failUnder);
+};
+
+// dist/cli/commands/eval.js
+!(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] = "6282863e-edcf-5259-9c0e-ec8d5923e98c");
+  } catch (e2) {
+  }
+})();
 
 // dist/sdk/item-children.js
 !(function() {
@@ -3424,9 +3460,19 @@ async function runGet(id, global2, options = {}) {
   return result;
 }
 
+// dist/cli/commands/search.js
+!(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] = "8fa83c44-d2f2-5f3b-8026-851048097d1f");
+  } catch (e2) {
+  }
+})();
+
 export {
   runAggregate,
   runSearch,
+  DEFAULT_EVAL_QUERIES_RELATIVE_PATH,
   runEval,
   MAX_CHILD_PROJECTION_ITEMS,
   DEFAULT_CHILD_SAMPLE_LIMIT,
@@ -3435,4 +3481,4 @@ export {
   buildItemSchedule,
   runGet
 };
-//# sourceMappingURL=chunk-HYB5AZ63.js.map
+//# sourceMappingURL=chunk-S46R2M3W.js.map