@unbrained/pm-cli 2026.7.15 → 2026.7.17

package/dist/cli-bundle/chunks/{chunk-ONG5V5CI.js → chunk-6XAZB6SE.js}

@@ -1,8 +1,8 @@
 
-!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]="9a21d12c-d2fd-5325-930c-dfc8bbfe8247")}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]="d283a9b1-313e-53dc-a34a-1b8b0c2cb0ac")}catch(e){}}();
 import {
   collectStaleVectorizationIds
-} from "./chunk-7Z4LKRS4.js";
+} from "./chunk-SPFZV2GR.js";
 import {
   buildListQueryFilters
 } from "./chunk-N7V7TI6J.js";
@@ -21,28 +21,28 @@ import {
   resolveContentFieldFilters,
   resolveMissingMetadataFilters,
   runList
-} from "./chunk-UXONS674.js";
+} from "./chunk-SIJV365F.js";
 import {
   createQueryFingerprint,
   paginateQueryRows
-} from "./chunk-HDH3JUGG.js";
+} from "./chunk-2IPNL3DR.js";
 import {
   getItemAt
-} from "./chunk-OW4JWD5M.js";
+} from "./chunk-VAHZIPWS.js";
 import {
   hasMissingMetadataFilter,
   itemMatchesMissingMetadata,
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-2VPAVL7O.js";
+} from "./chunk-CKX4WOPC.js";
 import {
   readHistoryEntries
-} from "./chunk-GOSLKLFE.js";
+} from "./chunk-KH6QAHME.js";
 import {
   parseLimit
-} from "./chunk-NVPZIJVR.js";
+} from "./chunk-PT7MCCGD.js";
 import {
   recordContextUsageTouches
-} from "./chunk-RLCHOOHC.js";
+} from "./chunk-YJSURTBB.js";
 import {
   resolveRegisteredSearchProvider,
   resolveRegisteredVectorStoreAdapter
@@ -59,7 +59,7 @@ import {
   resolveSearchCorpusFields,
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores
-} from "./chunk-JXQUXVMI.js";
+} from "./chunk-AFSV5HBB.js";
 import {
   splitCommaList
 } from "./chunk-NETP4DY4.js";
@@ -81,7 +81,7 @@ import {
   resolveIsoOrRelative,
   runActiveOnReadHooks,
   toItemRecord
-} from "./chunk-Q7A43DS4.js";
+} from "./chunk-P22HGFFI.js";
 import {
   EXIT_CODE,
   ITEM_METADATA_KEY_ORDER,
@@ -102,7 +102,7 @@ import {
   resolveRuntimeStatusRegistry,
   toNonEmptyString,
   toNonEmptyStringOrUndefined
-} from "./chunk-QKECXBBG.js";
+} from "./chunk-KX62NMZC.js";
 
 // dist/cli/commands/aggregate.js
 var AGGREGATE_GROUP_FIELDS = [
@@ -446,7 +446,7 @@ async function runAggregate(options, global) {
   };
 }
 
-// dist/cli/commands/search.js
+// dist/sdk/query/search.js
 import fs from "node:fs/promises";
 import path from "node:path";
 
@@ -768,7 +768,7 @@ function resolveBm25Params(settings) {
   };
 }
 
-// dist/cli/commands/search-rendering.js
+// dist/sdk/query/search-rendering.js
 function isAllStatuses(value) {
   if (typeof value !== "string")
     return false;
@@ -858,7 +858,7 @@ function buildVerboseSearchFilters(params) {
   };
 }
 
-// dist/cli/commands/search-pagination.js
+// dist/sdk/query/search-pagination.js
 function createSearchCursorFingerprint(options) {
   const normalizedOptions = {
     ...options.searchOptions
@@ -893,7 +893,7 @@ function resolveSearchPage(options) {
   };
 }
 
-// dist/cli/commands/search.js
+// dist/sdk/query/search.js
 var DEFAULT_COMPACT_SEARCH_FIELDS = [
   "id",
   "title",
@@ -1483,6 +1483,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;
@@ -1490,13 +1491,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" : "";
@@ -2269,7 +2271,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 = {};
@@ -2668,7 +2670,7 @@ async function runSearch(rawQuery, rawOptions, global) {
     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);
@@ -2680,7 +2682,7 @@ async function runSearch(rawQuery, rawOptions, global) {
     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);
@@ -2702,7 +2704,7 @@ async function runSearch(rawQuery, rawOptions, global) {
   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";
 
@@ -2842,14 +2844,14 @@ function parseEvalQuerySet(raw) {
   };
 }
 
-// dist/cli/commands/eval.js
+// dist/sdk/eval.js
 var DEFAULT_EVAL_QUERIES_RELATIVE_PATH = path2.join("search", "eval-queries.json");
 var VALID_EVAL_MODES2 = /* @__PURE__ */ new Set([
   "keyword",
   "semantic",
   "hybrid"
 ]);
-function parseEvalMode(raw) {
+var parseEvalMode = (raw) => {
   if (raw === void 0) {
     return "keyword";
   }
@@ -2858,8 +2860,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;
   }
@@ -2868,28 +2870,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: [
@@ -2897,37 +2902,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, global) {
-  const pmRoot = resolvePmRoot(process.cwd(), global.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" }, global);
-    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, global) => {
+  const mode = evalQuery.mode ?? defaultMode;
+  const searchResult = await runSearch(evalQuery.query, { mode, limit: String(k), fields: "id" }, global);
+  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,
@@ -2936,13 +2943,14 @@ async function runEval(options, global) {
       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),
@@ -2951,9 +2959,28 @@ async function runEval(options, global) {
     },
     queries: reports,
     ...failUnder !== void 0 ? { fail_under: failUnder } : {},
-    passed
+    passed: failUnder === void 0 || aggregate.ndcg >= failUnder
   };
-}
+};
+var runEval = async (options, global) => {
+  const pmRoot = resolvePmRoot(process.cwd(), global.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, global);
+    rawMetrics.push(metrics);
+    reports.push(report);
+  }
+  return buildEvalResult(k, reports, rawMetrics, failUnder);
+};
 
 // dist/sdk/item-children.js
 var MAX_CHILD_PROJECTION_ITEMS = 1e6;
@@ -3345,6 +3372,7 @@ async function runGet(id, global, options = {}) {
 export {
   runAggregate,
   runSearch,
+  DEFAULT_EVAL_QUERIES_RELATIVE_PATH,
   runEval,
   MAX_CHILD_PROJECTION_ITEMS,
   DEFAULT_CHILD_SAMPLE_LIMIT,
@@ -3353,6 +3381,6 @@ export {
   buildItemSchedule,
   runGet
 };
-//# sourceMappingURL=chunk-ONG5V5CI.js.map
+//# sourceMappingURL=chunk-6XAZB6SE.js.map
 
-//# debugId=9a21d12c-d2fd-5325-930c-dfc8bbfe8247
+//# debugId=d283a9b1-313e-53dc-a34a-1b8b0c2cb0ac