@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/query/search-rendering.js

@@ -1,106 +1,2 @@
-/**
- * @module sdk/query/search-rendering
- *
- * Builds stable compact and verbose filter projections for search responses.
- */
-
-!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]="b0abcc02-bd6e-536a-b876-e13cfc8ea741")}catch(e){}}();
-import { applyFilterValueEcho, buildContentFilterEcho, buildGovernanceMissingFilterEcho, } from "./list.js";
-function isAllStatuses(value) {
-    if (typeof value !== "string")
-        return false;
-    const tokens = value
-        .split(",")
-        .map((entry) => entry.trim().toLowerCase())
-        .filter(Boolean);
-    return tokens.length === 1 && tokens[0] === "all";
-}
-const COMPACT_SEARCH_VALUE_FILTER_ECHO_ENTRIES = [
-    {
-        optionKey: "status",
-        summaryKey: "status",
-        normalize: (value) => (isAllStatuses(value) ? "all" : value),
-    },
-    { optionKey: "type", summaryKey: "type" },
-    { optionKey: "tag", summaryKey: "tag" },
-    { optionKey: "priority", summaryKey: "priority" },
-    { optionKey: "deadlineBefore", summaryKey: "deadline_before" },
-    { optionKey: "deadlineAfter", summaryKey: "deadline_after" },
-    { optionKey: "updatedAfter", summaryKey: "updated_after" },
-    { optionKey: "updatedBefore", summaryKey: "updated_before" },
-    { optionKey: "createdAfter", summaryKey: "created_after" },
-    { optionKey: "createdBefore", summaryKey: "created_before" },
-    { optionKey: "assignee", summaryKey: "assignee" },
-    { optionKey: "sprint", summaryKey: "sprint" },
-    { optionKey: "release", summaryKey: "release" },
-    { optionKey: "parent", summaryKey: "parent" },
-];
-/** Builds the token-efficient filter echo used by compact search results. */
-export function buildCompactSearchFilterSummary(params) {
-    const { mode, matchMode, options, includeLinked, titleExact, phraseExact, scoreThreshold, hybridSemanticWeight, runtimeFieldFilters } = params;
-    const filters = {};
-    applyFilterValueEcho(filters, options, COMPACT_SEARCH_VALUE_FILTER_ECHO_ENTRIES);
-    Object.assign(filters, buildGovernanceMissingFilterEcho(options));
-    Object.assign(filters, buildContentFilterEcho(options));
-    if (matchMode !== undefined && matchMode !== "or") {
-        filters.match_mode = matchMode;
-    }
-    if (includeLinked)
-        filters.include_linked = true;
-    if (titleExact)
-        filters.title_exact = true;
-    if (phraseExact)
-        filters.phrase_exact = true;
-    if (scoreThreshold > 0)
-        filters.score_threshold = scoreThreshold;
-    if (mode === "hybrid" && options.semanticWeight !== undefined) {
-        filters.hybrid_semantic_weight = hybridSemanticWeight;
-    }
-    if (options.limit !== undefined)
-        filters.limit = options.limit;
-    if (runtimeFieldFilters && Object.keys(runtimeFieldFilters).length > 0) {
-        filters.runtime_filters = runtimeFieldFilters;
-    }
-    return filters;
-}
-/** Builds the complete filter echo shared by verbose search response paths. */
-export function buildVerboseSearchFilters(params) {
-    const { effectiveMode, matchMode, options, includeLinked, titleExact, phraseExact, scoreThreshold, hybridSemanticWeight, queryExpansion, rerank, runtimeFieldFilters } = params;
-    const valueOrNull = (value) => value ?? null;
-    return {
-        mode: effectiveMode,
-        match_mode: matchMode,
-        status: options.status === undefined || isAllStatuses(options.status)
-            ? "all"
-            : options.status,
-        type: valueOrNull(options.type),
-        tag: valueOrNull(options.tag),
-        priority: valueOrNull(options.priority),
-        deadline_before: valueOrNull(options.deadlineBefore),
-        deadline_after: valueOrNull(options.deadlineAfter),
-        updated_after: valueOrNull(options.updatedAfter),
-        updated_before: valueOrNull(options.updatedBefore),
-        created_after: valueOrNull(options.createdAfter),
-        created_before: valueOrNull(options.createdBefore),
-        assignee: valueOrNull(options.assignee),
-        sprint: valueOrNull(options.sprint),
-        release: valueOrNull(options.release),
-        parent: valueOrNull(options.parent),
-        ...buildGovernanceMissingFilterEcho(options),
-        ...buildContentFilterEcho(options),
-        include_linked: includeLinked,
-        title_exact: titleExact,
-        phrase_exact: phraseExact,
-        score_threshold: scoreThreshold,
-        hybrid_semantic_weight: effectiveMode === "hybrid" ? hybridSemanticWeight : null,
-        query_expansion_enabled: queryExpansion.enabled,
-        query_expansion_provider: queryExpansion.provider,
-        rerank_enabled: rerank.enabled,
-        rerank_model: rerank.model,
-        rerank_top_k: rerank.top_k,
-        limit: valueOrNull(options.limit),
-        runtime_filters: runtimeFieldFilters,
-    };
-}
+!(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]="48888c80-60e1-5905-afd5-8c1b6e532f99")}catch(e2){}})();import{applyFilterValueEcho,buildContentFilterEcho,buildGovernanceMissingFilterEcho}from"./list.js";function isAllStatuses(value){if(typeof value!=="string")return false;const tokens=value.split(",").map(entry=>entry.trim().toLowerCase()).filter(Boolean);return tokens.length===1&&tokens[0]==="all"}const COMPACT_SEARCH_VALUE_FILTER_ECHO_ENTRIES=[{optionKey:"status",summaryKey:"status",normalize:value=>isAllStatuses(value)?"all":value},{optionKey:"type",summaryKey:"type"},{optionKey:"tag",summaryKey:"tag"},{optionKey:"priority",summaryKey:"priority"},{optionKey:"deadlineBefore",summaryKey:"deadline_before"},{optionKey:"deadlineAfter",summaryKey:"deadline_after"},{optionKey:"updatedAfter",summaryKey:"updated_after"},{optionKey:"updatedBefore",summaryKey:"updated_before"},{optionKey:"createdAfter",summaryKey:"created_after"},{optionKey:"createdBefore",summaryKey:"created_before"},{optionKey:"assignee",summaryKey:"assignee"},{optionKey:"sprint",summaryKey:"sprint"},{optionKey:"release",summaryKey:"release"},{optionKey:"parent",summaryKey:"parent"}];function buildCompactSearchFilterSummary(params){const{mode,matchMode,options,includeLinked,titleExact,phraseExact,scoreThreshold,hybridSemanticWeight,runtimeFieldFilters}=params;const filters={};applyFilterValueEcho(filters,options,COMPACT_SEARCH_VALUE_FILTER_ECHO_ENTRIES);Object.assign(filters,buildGovernanceMissingFilterEcho(options));Object.assign(filters,buildContentFilterEcho(options));if(matchMode!==void 0&&matchMode!=="or"){filters.match_mode=matchMode}if(includeLinked)filters.include_linked=true;if(titleExact)filters.title_exact=true;if(phraseExact)filters.phrase_exact=true;if(scoreThreshold>0)filters.score_threshold=scoreThreshold;if(mode==="hybrid"&&options.semanticWeight!==void 0){filters.hybrid_semantic_weight=hybridSemanticWeight}if(options.limit!==void 0)filters.limit=options.limit;if(runtimeFieldFilters&&Object.keys(runtimeFieldFilters).length>0){filters.runtime_filters=runtimeFieldFilters}return filters}function buildVerboseSearchFilters(params){const{effectiveMode,matchMode,options,includeLinked,titleExact,phraseExact,scoreThreshold,hybridSemanticWeight,queryExpansion,rerank,runtimeFieldFilters}=params;const valueOrNull=value=>value??null;return{mode:effectiveMode,match_mode:matchMode,status:options.status===void 0||isAllStatuses(options.status)?"all":options.status,type:valueOrNull(options.type),tag:valueOrNull(options.tag),priority:valueOrNull(options.priority),deadline_before:valueOrNull(options.deadlineBefore),deadline_after:valueOrNull(options.deadlineAfter),updated_after:valueOrNull(options.updatedAfter),updated_before:valueOrNull(options.updatedBefore),created_after:valueOrNull(options.createdAfter),created_before:valueOrNull(options.createdBefore),assignee:valueOrNull(options.assignee),sprint:valueOrNull(options.sprint),release:valueOrNull(options.release),parent:valueOrNull(options.parent),...buildGovernanceMissingFilterEcho(options),...buildContentFilterEcho(options),include_linked:includeLinked,title_exact:titleExact,phrase_exact:phraseExact,score_threshold:scoreThreshold,hybrid_semantic_weight:effectiveMode==="hybrid"?hybridSemanticWeight:null,query_expansion_enabled:queryExpansion.enabled,query_expansion_provider:queryExpansion.provider,rerank_enabled:rerank.enabled,rerank_model:rerank.model,rerank_top_k:rerank.top_k,limit:valueOrNull(options.limit),runtime_filters:runtimeFieldFilters}}export{buildCompactSearchFilterSummary,buildVerboseSearchFilters};
 //# sourceMappingURL=search-rendering.js.map
-//# debugId=b0abcc02-bd6e-536a-b876-e13cfc8ea741

package/dist/sdk/query/search.d.ts

@@ -8,10 +8,10 @@ import { buildCompactSearchFilterSummary, buildVerboseSearchFilters, type Search
 import { type RuntimeStatusRegistry } from "../../core/schema/runtime-schema.js";
 import type { GlobalOptions } from "../../core/shared/command-types.js";
 import type { ItemDocument, ItemFormat, ItemMetadata, ItemStatus, PmSettings } from "../../types/index.js";
-import { parseSearchProjection, parseSearchTokens, parseTimestampWindow, validateSearchProjectionFields, type SearchMatchMode, type SearchOptions, type SearchProjectionConfig, type SearchProjectionMode, type SearchTuning } from "./search-contracts.js";
+import { parseSearchProjection, parseSearchTokens, parseTimestampWindow, validateSearchProjectionFields, type SearchMatchMode, type SearchModeSource, type SearchOptions, type SearchProjectionConfig, type SearchProjectionMode, type SearchTuning } from "./search-contracts.js";
 import { type WorkspaceMemoryRollup } from "../workspace-memory.js";
-export type { SearchMatchMode, SearchOptions, SearchTuning, } from "./search-contracts.js";
-export { resolveHybridSemanticWeight, resolveSearchMaxResults, resolveSearchScoreThreshold, resolveSearchTuning, } from "./search-contracts.js";
+export type { SearchDefaultMode, SearchMatchMode, SearchModeResolution, SearchModeSource, SearchOptions, SearchTuning, } from "./search-contracts.js";
+export { resolveEffectiveSearchMode, resolveHybridSemanticWeight, resolveSearchMaxResults, resolveSearchScoreThreshold, resolveSearchTuning, } from "./search-contracts.js";
 declare const INLINE_QUERY_FILTER_FIELDS: readonly ["tag", "status", "type", "priority"];
 type InlineQueryFilterField = (typeof INLINE_QUERY_FILTER_FIELDS)[number];
 /** Documents the search hit payload exchanged by command, SDK, and package integrations. */
@@ -45,6 +45,8 @@ export type SearchResultItem = SearchHit | Record<string, unknown>;
 interface SearchResultBase {
     query: string;
     mode: SearchMode;
+    /** Which layer chose `mode` before any runtime fallback: the caller, `search.default_mode`, or the workspace-state default. */
+    mode_source?: SearchModeSource;
     items: SearchResultItem[];
     count: number;
     total?: number;
@@ -321,7 +323,7 @@ declare function scoreDocument(document: ItemDocument, tokens: string[], normali
 declare function sortHits(items: SearchHit[], statusRegistry: RuntimeStatusRegistry): SearchHit[];
 declare function buildHybridLexicalScore(document: ItemDocument, tokens: string[], normalizedQuery: string, includeLinked: boolean, linkedCorpusById: Map<string, string>, tuning: SearchTuning, idPrefix: string, applyCoverageBonus?: boolean): SearchHit | null;
 declare function normalizeScoreMap(scoreById: Map<string, number>): Map<string, number>;
-declare function emptySearchResult(query: string, mode: SearchMode, matchMode: SearchMatchMode, options: SearchOptions, includeLinked: boolean, scoreThreshold: number, hybridSemanticWeight: number, queryExpansion: QueryExpansionConfig, rerank: RerankConfig, projection: SearchProjectionConfig, warnings: string[], runtimeFieldFilters?: Record<string, unknown>, countOnly?: boolean): SearchResult;
+declare function emptySearchResult(query: string, mode: SearchMode, matchMode: SearchMatchMode, options: SearchOptions, includeLinked: boolean, scoreThreshold: number, hybridSemanticWeight: number, queryExpansion: QueryExpansionConfig, rerank: RerankConfig, projection: SearchProjectionConfig, warnings: string[], runtimeFieldFilters: Record<string, unknown> | undefined, countOnly: boolean, modeSource: SearchModeSource): SearchResult;
 declare function requireSemanticDependencies(requestedMode: Exclude<SearchMode, "keyword">, providerResolution: EmbeddingProviderResolution, vectorResolution: VectorStoreResolution, hasExtensionVectorQuery: boolean): {
     provider: EmbeddingProviderConfig;
     vectorStore: VectorStoreConfig | null;