@unbrained/pm-cli 2026.9.19 → 2026.9.21

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

@@ -0,0 +1,123 @@
+/**
+ * @module sdk/query/search/types
+ * Shared search result and pipeline state contracts; no runtime dependencies.
+ */
+import { type QueryExpansionConfig, type RerankConfig } from "../../../core/search/relevance.js";
+import type { ItemMetadata } from "../../../types/index.js";
+import { type WorkspaceMemoryRollup } from "../../workspace-memory.js";
+import { type SearchMatchMode, type SearchModeSource, type SearchOptions, type SearchProjectionConfig, type SearchProjectionMode } from "../search-contracts.js";
+import { type SearchMode } from "../search-rendering.js";
+/** Documents the search hit payload exchanged by command, SDK, and package integrations. */
+export interface SearchHit {
+    /** Value that configures or reports item for this contract. */
+    item: ItemMetadata;
+    /** Value that configures or reports score for this contract. */
+    score: number;
+    /** Value that configures or reports matched fields for this contract. */
+    matched_fields: string[];
+    /** Value that configures or reports matched all terms for this contract. */
+    matched_all_terms?: boolean;
+    /** Value that configures or reports exact id match for this contract. */
+    exact_id_match?: boolean;
+    /** Value that configures or reports highlights for this contract. */
+    highlights?: SearchHitHighlight[];
+}
+/**
+ * Pairs a matched field name with a snippet of its text where every matching
+ * token run is wrapped in the {@link HIGHLIGHT_OPEN}/{@link HIGHLIGHT_CLOSE}
+ * markers. Emitted on {@link SearchHit.highlights} when `--highlight` is set.
+ */
+export interface SearchHitHighlight {
+    /** Value that configures or reports field for this contract. */
+    field: string;
+    /** Value that configures or reports snippet for this contract. */
+    snippet: string;
+}
+/** Restricts search result item values accepted by command, SDK, and storage contracts. */
+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;
+    /** Whether additional ranked hits remain after this page. */
+    has_more?: boolean;
+    /** Opaque continuation cursor when additional hits remain. */
+    next_cursor?: string;
+    /** Effective page size for this response. */
+    applied_limit?: number;
+    /** Explicit marker that the response is a bounded page. */
+    truncated?: true;
+    count_only?: boolean;
+    warnings?: string[];
+    /** Historical epoch and epic rollups matching the query in large workspaces. */
+    workspace_memory?: {
+        /** Persistence freshness for the derived projection. */
+        cache_status: "fresh" | "rebuilt";
+        /** Matching bounded rollups, ordered by term coverage and recency. */
+        matches: WorkspaceMemoryRollup[];
+    };
+}
+/** Documents the search compact result payload exchanged by command, SDK, and package integrations. */
+export interface SearchCompactResult extends SearchResultBase {
+    /** Value that configures or reports filters for this contract. */
+    filters: Record<string, unknown>;
+    /** Value that configures or reports projection for this contract. */
+    projection?: undefined;
+    /** Value that configures or reports now for this contract. */
+    now?: undefined;
+}
+/** Documents the search verbose result payload exchanged by command, SDK, and package integrations. */
+export interface SearchVerboseResult extends SearchResultBase {
+    /** Value that configures or reports filters for this contract. */
+    filters: Record<string, unknown>;
+    /** Value that configures or reports projection for this contract. */
+    projection: {
+        mode: SearchProjectionMode;
+        fields: string[] | null;
+    };
+    /** Value that configures or reports now for this contract. */
+    now: string;
+}
+/** Restricts search result values accepted by command, SDK, and storage contracts. */
+export type SearchResult = SearchCompactResult | SearchVerboseResult;
+/** Validated search input shared by corpus selection, retrieval and result construction. */
+interface PreparedSearchInput {
+    query: string;
+    options: SearchOptions;
+    inlineWarnings: string[];
+    highlight: boolean;
+    includeLinked: boolean;
+    titleExact: boolean;
+    phraseExact: boolean;
+    matchMode: SearchMatchMode;
+    minScoreOverride: number | undefined;
+    countOnly: boolean;
+    tokens: string[];
+    normalizedQuery: string;
+    limit: number | undefined;
+    projection: SearchProjectionConfig;
+    modeWasExplicit: boolean;
+}
+/** Resolved query settings and evidence retained while shaping the final response. */
+interface SearchResponseContext {
+    query: string;
+    effectiveMode: SearchMode;
+    modeSource: SearchModeSource;
+    matchMode: SearchMatchMode;
+    options: SearchOptions;
+    includeLinked: boolean;
+    titleExact: boolean;
+    phraseExact: boolean;
+    scoreThreshold: number;
+    hybridSemanticWeight: number;
+    queryExpansion: QueryExpansionConfig;
+    rerank: RerankConfig;
+    projection: SearchProjectionConfig;
+    warnings: string[];
+    runtimeFieldFilters: Record<string, unknown>;
+}
+export { PreparedSearchInput, SearchResponseContext };

package/dist/sdk/query/search/types.js

@@ -0,0 +1,2 @@
+!(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]="e5f69492-4892-582c-af77-a8e142d02d37")}catch(e2){}})();
+//# sourceMappingURL=types.js.map

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

@@ -1,207 +1,17 @@
-import { type ItemTypeRegistry } from "../../core/item/type-registry.js";
-import { type EmbeddingProviderConfig, type EmbeddingProviderResolution } from "../../core/search/providers.js";
-import { type QueryExpansionConfig, type RerankConfig } from "../../core/search/relevance.js";
-import { type VectorQueryHit, type VectorStoreConfig, type VectorStoreResolution } from "../../core/search/vector-stores.js";
-import { type Bm25Params } from "../../core/search/bm25.js";
-import { type LifecycleClassifier } from "../../core/governance/metadata-coverage.js";
-import { buildCompactSearchFilterSummary, buildVerboseSearchFilters, type SearchMode } from "./search-rendering.js";
-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 SearchModeSource, type SearchOptions, type SearchProjectionConfig, type SearchProjectionMode, type SearchTuning } from "./search-contracts.js";
-import { type WorkspaceMemoryRollup } from "../workspace-memory.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. */
-export interface SearchHit {
-    /** Value that configures or reports item for this contract. */
-    item: ItemMetadata;
-    /** Value that configures or reports score for this contract. */
-    score: number;
-    /** Value that configures or reports matched fields for this contract. */
-    matched_fields: string[];
-    /** Value that configures or reports matched all terms for this contract. */
-    matched_all_terms?: boolean;
-    /** Value that configures or reports exact id match for this contract. */
-    exact_id_match?: boolean;
-    /** Value that configures or reports highlights for this contract. */
-    highlights?: SearchHitHighlight[];
-}
-/**
- * Pairs a matched field name with a snippet of its text where every matching
- * token run is wrapped in the {@link HIGHLIGHT_OPEN}/{@link HIGHLIGHT_CLOSE}
- * markers. Emitted on {@link SearchHit.highlights} when `--highlight` is set.
- */
-export interface SearchHitHighlight {
-    /** Value that configures or reports field for this contract. */
-    field: string;
-    /** Value that configures or reports snippet for this contract. */
-    snippet: string;
-}
-/** Restricts search result item values accepted by command, SDK, and storage contracts. */
-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;
-    /** Whether additional ranked hits remain after this page. */
-    has_more?: boolean;
-    /** Opaque continuation cursor when additional hits remain. */
-    next_cursor?: string;
-    /** Effective page size for this response. */
-    applied_limit?: number;
-    /** Explicit marker that the response is a bounded page. */
-    truncated?: true;
-    count_only?: boolean;
-    warnings?: string[];
-    /** Historical epoch and epic rollups matching the query in large workspaces. */
-    workspace_memory?: {
-        /** Persistence freshness for the derived projection. */
-        cache_status: "fresh" | "rebuilt";
-        /** Matching bounded rollups, ordered by term coverage and recency. */
-        matches: WorkspaceMemoryRollup[];
-    };
-}
-/** Documents the search compact result payload exchanged by command, SDK, and package integrations. */
-export interface SearchCompactResult extends SearchResultBase {
-    /** Value that configures or reports filters for this contract. */
-    filters: Record<string, unknown>;
-    /** Value that configures or reports projection for this contract. */
-    projection?: undefined;
-    /** Value that configures or reports now for this contract. */
-    now?: undefined;
-}
-/** Documents the search verbose result payload exchanged by command, SDK, and package integrations. */
-export interface SearchVerboseResult extends SearchResultBase {
-    /** Value that configures or reports filters for this contract. */
-    filters: Record<string, unknown>;
-    /** Value that configures or reports projection for this contract. */
-    projection: {
-        mode: SearchProjectionMode;
-        fields: string[] | null;
-    };
-    /** Value that configures or reports now for this contract. */
-    now: string;
-}
-/** Restricts search result values accepted by command, SDK, and storage contracts. */
-export type SearchResult = SearchCompactResult | SearchVerboseResult;
-interface ExtensionSearchProviderContext {
-    query: string;
-    mode: SearchMode;
-    tokens: string[];
-    options: SearchOptions;
-    settings: PmSettings;
-    documents: ItemDocument[];
-}
-interface ExtensionSearchProviderHit {
-    id: string;
-    score: number;
-    matched_fields?: string[];
-}
-type ExtensionSearchProviderQuery = (context: ExtensionSearchProviderContext) => Promise<ExtensionSearchProviderHit[] | {
-    hits?: ExtensionSearchProviderHit[];
-}> | ExtensionSearchProviderHit[] | {
-    hits?: ExtensionSearchProviderHit[];
-};
-interface ExtensionSearchProviderQueryExpansionContext {
-    query: string;
-    mode: Exclude<SearchMode, "keyword">;
-    settings: PmSettings;
-}
-type ExtensionSearchProviderQueryExpansion = (context: ExtensionSearchProviderQueryExpansionContext) => Promise<string[] | {
-    queries?: string[];
-}> | string[] | {
-    queries?: string[];
-};
-interface ExtensionSearchProviderRerankCandidate {
-    id: string;
-    text: string;
-    score: number;
-}
-interface ExtensionSearchProviderRerankContext {
-    query: string;
-    mode: "hybrid";
-    model: string;
-    top_k: number;
-    settings: PmSettings;
-    candidates: ExtensionSearchProviderRerankCandidate[];
-}
-type ExtensionSearchProviderRerank = (context: ExtensionSearchProviderRerankContext) => Promise<Array<{
-    id?: unknown;
-    score?: unknown;
-}> | {
-    hits?: Array<{
-        id?: unknown;
-        score?: unknown;
-    }>;
-}> | Array<{
-    id?: unknown;
-    score?: unknown;
-}> | {
-    hits?: Array<{
-        id?: unknown;
-        score?: unknown;
-    }>;
-};
-type ExtensionVectorQuery = (context: {
-    vector: number[];
-    limit: number;
-    settings: PmSettings;
-}) => Promise<VectorQueryHit[]> | VectorQueryHit[];
-type ExtensionVectorUpsert = (context: {
-    points: Array<{
-        id: string;
-        vector: number[];
-        payload: Record<string, unknown>;
-    }>;
-    settings: PmSettings;
-}) => Promise<void> | void;
-type ExtensionVectorAdapter = {
-    adapterName: string;
-    query?: ExtensionVectorQuery;
-    upsert?: ExtensionVectorUpsert;
-};
-type ImplicitSemanticFallbackReason = "timeout" | "connection" | "error";
-/**
- * Aggregate the `code` strings found along an error's `cause` chain.
- *
- * undici (Node's fetch) collapses connection errors to the generic message
- * "fetch failed" and stashes the real syscall code (e.g. `ECONNREFUSED`) on
- * `error.cause.code`. Walking the chain (bounded depth) lets the fallback
- * classifier label a downed/unreachable Ollama backend as "connection" rather
- * than the catch-all "error".
- */
-export declare function collectErrorCauseCodes(error: unknown): string;
-/**
- * Classify why an implicit/explicit semantic search degraded to keyword mode,
- * inspecting both the error message and the {@link collectErrorCauseCodes} chain
- * so undici's generic "fetch failed" is recognised as a connection failure.
- */
-export declare function classifyImplicitSemanticFallbackReason(error: unknown): ImplicitSemanticFallbackReason;
-declare function buildExplicitSemanticFallbackWarning(requestedMode: SearchMode, error: unknown): string;
-interface VectorIndexRecoveryRegistrations {
-    commands?: readonly {
-        command: string;
-    }[];
-}
-interface VectorIndexRecovery {
-    command: string;
-    args: string[];
-    follow_up_command?: string;
-    follow_up_args?: string[];
-}
-/** Resolve an executable reindex path from the active extension capability surface. */
-export declare function resolveVectorIndexRecovery(registrations: VectorIndexRecoveryRegistrations | null): VectorIndexRecovery;
-/** Compare the vectorization-status ledger against the filtered corpus and, when the vector index is behind, emit a one-line stderr warning plus a structured `vector_index_stale:N` entry in the JSON warnings array. Best-effort: ledger read failures fall through silently — the existing semantic/hybrid fallback paths cover backend errors. */
-declare function maybeEmitVectorIndexStaleWarning(pmRoot: string, filteredDocuments: ItemDocument[], warnings: string[]): Promise<void>;
-/** Format token-efficient vector-index staleness and executable recovery warnings. */
-export declare function formatVectorIndexRecoveryWarnings(staleCount: number, recovery: VectorIndexRecovery): string[];
+import { parseSearchProjection, parseSearchTokens, parseTimestampWindow, validateSearchProjectionFields, type SearchOptions } from "./search-contracts.js";
+import { buildCompactSearchFilterSummary, buildVerboseSearchFilters } from "./search-rendering.js";
+import { collectLinkedPaths, loadDocuments, loadLinkedCorpus, resolveLinkedCorpusRoots } from "./search/corpus.js";
+import { applyExactQueryFilters, applyFilters, collectExactPhraseFields, dependencyEntries, documentContainsExactPhrase, stringArray, textEntries } from "./search/filters.js";
+import { applyInlineQueryFilters, parseInlineQueryFilters } from "./search/input.js";
+import { buildHitHighlights, buildHybridLexicalScore, countOccurrences, highlightFieldSnippet, markTokenRuns, normalizeScoreMap, scoreDocument, sortHits } from "./search/lexical.js";
+import { emptySearchResult, projectSearchHits, readSearchFieldValue } from "./search/response.js";
+import { buildExplicitSemanticFallbackWarning, buildRerankCorpus, buildSemanticHits, classifyImplicitSemanticFallbackReason, collectErrorCauseCodes, combineHybridHits, computeBuiltInBm25Hits, computeSemanticOrHybridHits, maybeEmitVectorIndexStaleWarning, mergeVectorHitsById, normalizeExtensionProviderHits, requireSemanticDependencies, resolveBuiltInBm25Mode, resolveExtensionSearchProvider, resolveExtensionSearchProviderByName, resolveExtensionVectorAdapter } from "./search/semantic.js";
+import type { SearchResult } from "./search/types.js";
+export type { SearchDefaultMode, SearchMatchMode, SearchModeResolution, SearchModeSource, SearchOptions, SearchTuning } from "./search-contracts.js";
+export { resolveEffectiveSearchMode, resolveHybridSemanticWeight, resolveSearchMaxResults, resolveSearchScoreThreshold, resolveSearchTuning } from "./search-contracts.js";
+export { classifyImplicitSemanticFallbackReason, collectErrorCauseCodes, formatVectorIndexRecoveryWarnings, resolveVectorIndexRecovery } from "./search/semantic.js";
+export type { SearchCompactResult, SearchHit, SearchHitHighlight, SearchResult, SearchResultItem, SearchVerboseResult } from "./search/types.js";
 /** Public contract for test only search command, shared by SDK and presentation-layer consumers. */
 export declare const _testOnlySearchCommand: {
     applyFilters: typeof applyFilters;
@@ -251,166 +61,5 @@ export declare const _testOnlySearchCommand: {
     textEntries: typeof textEntries;
     validateSearchProjectionFields: typeof validateSearchProjectionFields;
 };
-/** Result of extracting inline `field:value` tokens from a raw search query. */
-interface InlineQueryParse {
-    /** The query with all recognized inline filter tokens removed. */
-    residualQuery: string;
-    /** Recognized inline filters keyed by field name; first occurrence per field wins. */
-    inlineFilters: Partial<Record<InlineQueryFilterField, string>>;
-}
-/**
- * Split a raw search query into its residual keyword text and any inline
- * `field:value` filter tokens (GH-157). Recognized fields are
- * {@link INLINE_QUERY_FILTER_FIELDS}; the value runs to the end of the token so
- * colon-bearing values like `tag:area:search` parse as `{ tag: "area:search" }`.
- * Only the first occurrence of each field is captured — later duplicates are left
- * in the residual query so they are never silently dropped. Tokens whose prefix
- * is not a recognized field (`foo:bar`) stay in the residual query verbatim.
- */
-declare function parseInlineQueryFilters(query: string): InlineQueryParse;
-/** Merge inline `field:value` filters into a search options object (GH-157). Explicit `--field` flags always win: an inline token is applied only when the corresponding option is not already set, and a conflicting inline token is recorded as a `search_inline_filter_ignored:<field>:flag_takes_precedence` warning so the override is observable rather than silent. Returns a fresh options object — the caller's input is never mutated. */
-declare function applyInlineQueryFilters(options: SearchOptions, inlineFilters: Partial<Record<InlineQueryFilterField, string>>, warnings: string[]): SearchOptions;
-declare function stringArray(value: unknown): string[];
-declare function textEntries(value: unknown): Array<{
-    text: string;
-}>;
-declare function dependencyEntries(value: unknown): Array<{
-    id: string;
-    kind: string;
-}>;
-declare function collectExactPhraseFields(document: ItemDocument): string[];
-declare function documentContainsExactPhrase(document: ItemDocument, normalizedQuery: string): boolean;
-declare function applyExactQueryFilters(items: ItemDocument[], normalizedQuery: string, options: {
-    titleExact: boolean;
-    phraseExact: boolean;
-}): ItemDocument[];
-declare function applyFilters(items: ItemDocument[], options: SearchOptions, typeRegistry: ItemTypeRegistry, runtimeFieldFilters: Record<string, unknown>, statusFilter: ItemStatus[] | undefined, lifecycleClassifier: LifecycleClassifier): ItemDocument[];
-declare function countOccurrences(haystack: string, needle: string): number;
-declare function collectLinkedPaths(item: ItemMetadata): Array<{
-    scope: "project" | "global";
-    path: string;
-}>;
-interface ContainmentRoot {
-    resolved: string;
-    realpath: string;
-}
-interface LinkedCorpusRoots {
-    projectContainmentRoot: ContainmentRoot | null;
-    globalContainmentRoot: ContainmentRoot | null;
-}
-declare function resolveLinkedCorpusRoots(projectRoot: string, globalRoot: string): Promise<LinkedCorpusRoots>;
-declare function loadLinkedCorpus(document: ItemDocument, roots: LinkedCorpusRoots): Promise<string>;
-/**
- * Wrap every case-insensitive occurrence of any query token in `text` with the
- * {@link HIGHLIGHT_OPEN}/{@link HIGHLIGHT_CLOSE} markers. Token boundaries follow
- * the same substring semantics as the lexical scorer (a token highlights inside
- * longer words, matching how it scored), and overlapping matches are coalesced
- * by the single combined alternation so markers never nest.
- */
-declare function markTokenRuns(text: string, tokens: string[]): string;
-/**
- * Build a single highlighted snippet for one field value (GH-157), or null when
- * no token matches. The snippet is a window of {@link HIGHLIGHT_SNIPPET_RADIUS}
- * characters on each side of the first match with the matching token runs
- * wrapped in markers, prefixed/suffixed with an ellipsis when the field text was
- * trimmed. Returning null lets the caller skip fields with no concrete textual
- * match (e.g. a field flagged purely by the phrase-coverage bonus).
- */
-declare function highlightFieldSnippet(text: string, tokens: string[]): string | null;
-/** Produce per-field matched-text snippets for a hit (GH-157, `--highlight`). Iterates the hit's already-sorted `matched_fields`, retains only the document-derived searchable fields (skipping synthetic markers like `id`, `semantic`, `rerank`, and `linked_content`), and emits a snippet for each field that still contains a concrete token match. */
-declare function buildHitHighlights(document: ItemDocument, matchedFields: string[], tokens: string[]): SearchHitHighlight[];
-declare function scoreDocument(document: ItemDocument, tokens: string[], normalizedQuery: string, linkedCorpus: string, tuning: SearchTuning, idPrefix: string, applyCoverageBonus?: boolean): SearchHit | null;
-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> | undefined, countOnly: boolean, modeSource: SearchModeSource): SearchResult;
-declare function requireSemanticDependencies(requestedMode: Exclude<SearchMode, "keyword">, providerResolution: EmbeddingProviderResolution, vectorResolution: VectorStoreResolution, hasExtensionVectorQuery: boolean): {
-    provider: EmbeddingProviderConfig;
-    vectorStore: VectorStoreConfig | null;
-};
-interface ExtensionSearchProviderHooks {
-    providerName: string;
-    query?: ExtensionSearchProviderQuery;
-    queryExpansion?: ExtensionSearchProviderQueryExpansion;
-    rerank?: ExtensionSearchProviderRerank;
-}
-declare function resolveExtensionSearchProviderByName(providerName: string | undefined): ExtensionSearchProviderHooks | null;
-declare function resolveExtensionSearchProvider(settings: PmSettings): {
-    providerName: string;
-    query: ExtensionSearchProviderQuery;
-} | null;
-declare function resolveExtensionVectorAdapter(settings: PmSettings): ExtensionVectorAdapter | null;
-declare function normalizeExtensionProviderHits(providerName: string, raw: unknown, filteredById: Map<string, ItemDocument>): SearchHit[];
-declare function buildSemanticHits(vectorHits: VectorQueryHit[], filteredById: Map<string, ItemDocument>): {
-    semanticHits: SearchHit[];
-    semanticScores: Map<string, number>;
-};
-declare function combineHybridHits(filteredById: Map<string, ItemDocument>, semanticScores: Map<string, number>, keywordHits: SearchHit[], hybridSemanticWeight: number, semanticFieldLabel?: string): SearchHit[];
-/** Built-in BM25 activation outcome for semantic/hybrid search (pm-75k9): - `"explicit"`: `search.provider` is `bm25` — the user opted into offline lexical ranking, so it is used even if an embedding provider is configured. - `"auto-fallback"`: `search.provider` is `auto` and neither an embedding provider nor an extension search provider is available — BM25 is used in place of degrading to the naive field-weighted keyword scorer. - `null`: BM25 does not apply; the existing embedding/extension path runs. */
-type BuiltInBm25Mode = "explicit" | "auto-fallback";
-declare function resolveBuiltInBm25Mode(params: {
-    configuredProvider: string | undefined;
-    hasEmbeddingProvider: boolean;
-    hasExtensionSearchProvider: boolean;
-}): BuiltInBm25Mode | null;
-/**
- * Rank the filtered corpus with the offline BM25 provider (pm-75k9). Builds a
- * BM25 index over each document's resolved search corpus (honoring
- * `search.corpus_fields`), scores the query, and shapes hits for the requested
- * mode: semantic mode returns pure BM25-ranked hits tagged
- * `matched_fields: ["bm25"]`, while hybrid mode blends the BM25 scores with the
- * locally computed keyword scores via {@link combineHybridHits}. The exact
- * full-ID / short-ID guarantee is preserved in both modes via
- * {@link forceExactIdHitsToTop}. No network, embedding service, or vector store
- * is involved, so this path cannot fail on a backend error.
- */
-declare function computeBuiltInBm25Hits(params: {
-    requestedMode: Exclude<SearchMode, "keyword">;
-    query: string;
-    filteredDocuments: ItemDocument[];
-    keywordHits: SearchHit[];
-    corpusFields: string[];
-    bm25Params: Bm25Params;
-    hybridSemanticWeight: number;
-}): SearchHit[];
-interface SemanticQueryContext {
-    requestedMode: Exclude<SearchMode, "keyword">;
-    query: string;
-    filteredDocuments: ItemDocument[];
-    keywordHits: SearchHit[];
-    hybridSemanticWeight: number;
-    limit: number | undefined;
-    maxResults: number;
-    provider: EmbeddingProviderConfig;
-    vectorStore: VectorStoreConfig | null;
-    extensionVectorAdapter: ExtensionVectorAdapter | null;
-    queryExpansion: QueryExpansionConfig;
-    queryExpansionExtension: {
-        providerName: string;
-        expand: ExtensionSearchProviderQueryExpansion;
-    } | null;
-    rerank: RerankConfig;
-    rerankExtension: {
-        providerName: string;
-        rerank: ExtensionSearchProviderRerank;
-    } | null;
-    warnings: string[];
-    settings: PmSettings;
-    embeddingTimeoutMs?: number;
-    vectorQueryTimeoutMs?: number;
-}
-interface SemanticQueryResult {
-    hits: SearchHit[];
-    vectorMatchCount: number;
-}
-declare function mergeVectorHitsById(vectorHitGroups: VectorQueryHit[][]): VectorQueryHit[];
-declare function buildRerankCorpus(document: ItemDocument): string;
-declare function computeSemanticOrHybridHits(context: SemanticQueryContext): Promise<SemanticQueryResult>;
-declare function loadDocuments(pmRoot: string, itemFormat: ItemFormat, typeToFolder: Record<string, string>, schema: PmSettings["schema"]): Promise<{
-    documents: ItemDocument[];
-    warnings: string[];
-}>;
-declare function readSearchFieldValue(hit: SearchHit, field: string): unknown;
-declare function projectSearchHits(hits: SearchHit[], projection: SearchProjectionConfig): SearchResultItem[];
 /** Implements run search for the public runtime surface of this module. */
 export declare function runSearch(rawQuery: string, rawOptions: SearchOptions, global: GlobalOptions): Promise<SearchResult>;