@unbrained/pm-cli 2026.10.14 → 2026.10.17

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

@@ -1,27 +1,27 @@
-import type { ItemDocument, ItemFormat, ItemMetadata, PmSettings } from "../../../types/index.js";
+import type { ItemDocument,ItemFormat,ItemMetadata,PmSettings } from "../../../types/index.js";
 import { type SearchMode } from "../search-rendering.js";
 /** Collect linked file and document paths eligible for optional search corpus enrichment. */
-declare function collectLinkedPaths(item: ItemMetadata): Array<{
-scope: "project" | "global";
-path: string;
+declare function collectLinkedPaths(item:ItemMetadata):Array<{
+scope:"project" | "global";
+path:string;
 }>;
 interface ContainmentRoot {
-resolved: string;
-realpath: string;
+resolved:string;
+realpath:string;
 }
 interface LinkedCorpusRoots {
-projectContainmentRoot: ContainmentRoot | null;
-globalContainmentRoot: ContainmentRoot | null;
+projectContainmentRoot:ContainmentRoot | null;
+globalContainmentRoot:ContainmentRoot | null;
 }
 /** Resolve the workspace and global roots used to contain linked-content reads. */
-declare function resolveLinkedCorpusRoots(projectRoot: string, globalRoot: string): Promise<LinkedCorpusRoots>;
+declare function resolveLinkedCorpusRoots(projectRoot:string,globalRoot:string):Promise<LinkedCorpusRoots>;
 /** Read eligible linked content while retaining lexical and canonical path containment checks. */
-declare function loadLinkedCorpus(document: ItemDocument, roots: LinkedCorpusRoots): Promise<string>;
+declare function loadLinkedCorpus(document:ItemDocument,roots:LinkedCorpusRoots):Promise<string>;
 /** Load the searchable item corpus for the resolved tracker. */
-declare function loadDocuments(pmRoot: string, itemFormat: ItemFormat, typeToFolder: Record<string, string>, schema: PmSettings["schema"]): Promise<{
-documents: ItemDocument[];
-warnings: string[];
+declare function loadDocuments(pmRoot:string,itemFormat:ItemFormat,typeToFolder:Record<string,string>,schema:PmSettings["schema"]):Promise<{
+documents:ItemDocument[];
+warnings:string[];
 }>;
 /** Build an item-ID lookup of linked content for provider execution and reranking. */
-declare function collectLinkedCorpusById(includeLinked: boolean, effectiveMode: SearchMode, filteredDocuments: ItemDocument[]): Promise<Map<string, string>>;
-export { collectLinkedCorpusById, collectLinkedPaths, loadDocuments, loadLinkedCorpus, resolveLinkedCorpusRoots };
+declare function collectLinkedCorpusById(includeLinked:boolean,effectiveMode:SearchMode,filteredDocuments:ItemDocument[]):Promise<Map<string,string>>;
+export { collectLinkedCorpusById,collectLinkedPaths,loadDocuments,loadLinkedCorpus,resolveLinkedCorpusRoots };

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

@@ -1,27 +1,27 @@
 import { type LifecycleClassifier } from "../../../core/governance/metadata-coverage.js";
 import { type ItemTypeRegistry } from "../../../core/item/type-registry.js";
-import type { ItemDocument, ItemStatus } from "../../../types/index.js";
+import type { ItemDocument,ItemStatus } from "../../../types/index.js";
 import { type SearchOptions } from "../search-contracts.js";
 /** Normalize an unknown collection to its string entries for field filtering and scoring. */
-declare function stringArray(value: unknown): string[];
+declare function stringArray(value:unknown):string[];
 /** Extract annotation text entries used by exact-phrase matching and lexical scoring. */
-declare function textEntries(value: unknown): Array<{
-text: string;
+declare function textEntries(value:unknown):Array<{
+text:string;
 }>;
 /** Extract dependency metadata entries used by filtering and lexical scoring. */
-declare function dependencyEntries(value: unknown): Array<{
-id: string;
-kind: string;
+declare function dependencyEntries(value:unknown):Array<{
+id:string;
+kind:string;
 }>;
 /** Collect searchable text fields used by exact-phrase filtering. */
-declare function collectExactPhraseFields(document: ItemDocument): string[];
+declare function collectExactPhraseFields(document:ItemDocument):string[];
 /** Check whether any searchable field contains the normalized exact phrase. */
-declare function documentContainsExactPhrase(document: ItemDocument, normalizedQuery: string): boolean;
+declare function documentContainsExactPhrase(document:ItemDocument,normalizedQuery:string):boolean;
 /** Apply exact-title and exact-phrase restrictions before search ranking. */
-declare function applyExactQueryFilters(items: ItemDocument[], normalizedQuery: string, options: {
-titleExact: boolean;
-phraseExact: boolean;
-}): ItemDocument[];
+declare function applyExactQueryFilters(items:ItemDocument[],normalizedQuery:string,options:{
+titleExact:boolean;
+phraseExact:boolean;
+}):ItemDocument[];
 /** Apply metadata and runtime field predicates to the loaded item corpus. */
-declare function applyFilters(items: ItemDocument[], options: SearchOptions, typeRegistry: ItemTypeRegistry, runtimeFieldFilters: Record<string, unknown>, statusFilter: ItemStatus[] | undefined, lifecycleClassifier: LifecycleClassifier): ItemDocument[];
-export { applyExactQueryFilters, applyFilters, collectExactPhraseFields, dependencyEntries, documentContainsExactPhrase, stringArray, textEntries };
+declare function applyFilters(items:ItemDocument[],options:SearchOptions,typeRegistry:ItemTypeRegistry,runtimeFieldFilters:Record<string,unknown>,statusFilter:ItemStatus[] | undefined,lifecycleClassifier:LifecycleClassifier):ItemDocument[];
+export { applyExactQueryFilters,applyFilters,collectExactPhraseFields,dependencyEntries,documentContainsExactPhrase,stringArray,textEntries };

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

@@ -1,13 +1,13 @@
 import { type SearchOptions } from "../search-contracts.js";
 import type { PreparedSearchInput } from "./types.js";
-declare const INLINE_QUERY_FILTER_FIELDS: readonly ["tag", "status", "type", "priority"];
+declare const INLINE_QUERY_FILTER_FIELDS:readonly ["tag","status","type","priority"];
 type InlineQueryFilterField = (typeof INLINE_QUERY_FILTER_FIELDS)[number];
 /** 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;
+residualQuery:string;
 /** Recognized inline filters keyed by field name; first occurrence per field wins. */
-inlineFilters: Partial<Record<InlineQueryFilterField, string>>;
+inlineFilters:Partial<Record<InlineQueryFilterField,string>>;
 }
 /**
  * Split a raw search query into its residual keyword text and any inline
@@ -18,11 +18,11 @@ inlineFilters: Partial<Record<InlineQueryFilterField, string>>;
  * 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;
+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 applyInlineQueryFilters(options:SearchOptions,inlineFilters:Partial<Record<InlineQueryFilterField,string>>,warnings:string[]):SearchOptions;
 /** Resolve inline filters, explicit options, tokenization and projection before accessing the search corpus. */
-declare function prepareSearchInput(rawQuery: string, rawOptions: SearchOptions): PreparedSearchInput;
+declare function prepareSearchInput(rawQuery:string,rawOptions:SearchOptions):PreparedSearchInput;
 /** Reject incompatible paging options before search execution. */
-declare function assertSearchPagingOptions(options: SearchOptions): void;
-export { applyInlineQueryFilters, assertSearchPagingOptions, parseInlineQueryFilters, prepareSearchInput };
+declare function assertSearchPagingOptions(options:SearchOptions):void;
+export { applyInlineQueryFilters,assertSearchPagingOptions,parseInlineQueryFilters,prepareSearchInput };

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

@@ -1,9 +1,9 @@
 import { type RuntimeStatusRegistry } from "../../../core/schema/runtime-schema.js";
 import type { ItemDocument } from "../../../types/index.js";
 import { type SearchTuning } from "../search-contracts.js";
-import type { SearchHit, SearchHitHighlight } from "./types.js";
+import type { SearchHit,SearchHitHighlight } from "./types.js";
 /** Count query-token occurrences in a searchable field for lexical scoring. */
-declare function countOccurrences(haystack: string, needle: string): number;
+declare function countOccurrences(haystack:string,needle:string):number;
 /**
  * Wrap every case-insensitive occurrence of any query token in `text` with the
  * {@link HIGHLIGHT_OPEN}/{@link HIGHLIGHT_CLOSE} markers. Token boundaries follow
@@ -11,7 +11,7 @@ declare function countOccurrences(haystack: string, needle: string): number;
  * 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;
+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}
@@ -20,15 +20,15 @@ declare function markTokenRuns(text: string, tokens: string[]): string;
  * 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;
+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 buildHitHighlights(document:ItemDocument,matchedFields:string[],tokens:string[]):SearchHitHighlight[];
 /** Score one item using weighted fields and the exact-ID ranking guarantee. */
-declare function scoreDocument(document: ItemDocument, tokens: string[], normalizedQuery: string, linkedCorpus: string, tuning: SearchTuning, idPrefix: string, applyCoverageBonus?: boolean): SearchHit | null;
+declare function scoreDocument(document:ItemDocument,tokens:string[],normalizedQuery:string,linkedCorpus:string,tuning:SearchTuning,idPrefix:string,applyCoverageBonus?:boolean):SearchHit | null;
 /** Order hits by descending relevance with deterministic item tie breakers. */
-declare function sortHits(items: SearchHit[], statusRegistry: RuntimeStatusRegistry): SearchHit[];
+declare function sortHits(items:SearchHit[],statusRegistry:RuntimeStatusRegistry):SearchHit[];
 /** Compute the lexical contribution used when blending keyword and semantic relevance. */
-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 buildHybridLexicalScore(document:ItemDocument,tokens:string[],normalizedQuery:string,includeLinked:boolean,linkedCorpusById:Map<string,string>,tuning:SearchTuning,idPrefix:string,applyCoverageBonus?:boolean):SearchHit | null;
 /** Normalize provider score ranges before combining retrieval results. */
-declare function normalizeScoreMap(scoreById: Map<string, number>): Map<string, number>;
-export { buildHitHighlights, buildHybridLexicalScore, countOccurrences, highlightFieldSnippet, markTokenRuns, normalizeScoreMap, scoreDocument, sortHits };
+declare function normalizeScoreMap(scoreById:Map<string,number>):Map<string,number>;
+export { buildHitHighlights,buildHybridLexicalScore,countOccurrences,highlightFieldSnippet,markTokenRuns,normalizeScoreMap,scoreDocument,sortHits };

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

@@ -1,34 +1,34 @@
-import { type QueryExpansionConfig, type RerankConfig } from "../../../core/search/relevance.js";
+import { type QueryExpansionConfig,type RerankConfig } from "../../../core/search/relevance.js";
 import type { ItemDocument } from "../../../types/index.js";
 import { type WorkspaceMemoryRollup } from "../../workspace-memory.js";
-import { type SearchMatchMode, type SearchModeSource, type SearchOptions, type SearchProjectionConfig } from "../search-contracts.js";
+import { type SearchMatchMode,type SearchModeSource,type SearchOptions,type SearchProjectionConfig } from "../search-contracts.js";
 import { type SearchMode } from "../search-rendering.js";
-import type { PreparedSearchInput, SearchHit, SearchResponseContext, SearchResult, SearchResultItem } from "./types.js";
+import type { PreparedSearchInput,SearchHit,SearchResponseContext,SearchResult,SearchResultItem } from "./types.js";
 /** Build a zero-hit response preserving the requested search mode and filters. */
-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 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;
 /** Resolve a projected search field from item metadata or search-hit evidence. */
-declare function readSearchFieldValue(hit: SearchHit, field: string): unknown;
+declare function readSearchFieldValue(hit:SearchHit,field:string):unknown;
 /** Convert ranked hits into the requested compact, full or custom-field rows. */
-declare function projectSearchHits(hits: SearchHit[], projection: SearchProjectionConfig): SearchResultItem[];
+declare function projectSearchHits(hits:SearchHit[],projection:SearchProjectionConfig):SearchResultItem[];
 /** Build an empty result with the resolved search settings and warnings. */
-declare function buildEmptySearchResultFromContext(response: SearchResponseContext, countOnly: boolean): SearchResult;
+declare function buildEmptySearchResultFromContext(response:SearchResponseContext,countOnly:boolean):SearchResult;
 /** Return the matched total without materializing projected hit rows. */
-declare function buildCountOnlySearchResult(response: SearchResponseContext, total: number): SearchResult;
+declare function buildCountOnlySearchResult(response:SearchResponseContext,total:number):SearchResult;
 /** Attach bounded historical workspace rollups when the query and workspace qualify. */
-declare function withSearchWorkspaceMemory(result: SearchResult, memory: {
-cache_status: "fresh" | "rebuilt";
-matches: WorkspaceMemoryRollup[];
-} | undefined): SearchResult;
+declare function withSearchWorkspaceMemory(result:SearchResult,memory:{
+cache_status:"fresh" | "rebuilt";
+matches:WorkspaceMemoryRollup[];
+} | undefined):SearchResult;
 /** Add matched-field snippets only when highlighting was requested. */
-declare function attachSearchHighlights(prepared: PreparedSearchInput, filteredDocuments: ItemDocument[], limited: SearchHit[]): {
-hits: SearchHit[];
-projection: SearchProjectionConfig;
+declare function attachSearchHighlights(prepared:PreparedSearchInput,filteredDocuments:ItemDocument[],limited:SearchHit[]):{
+hits:SearchHit[];
+projection:SearchProjectionConfig;
 };
 /** Apply search pagination and projection to the final ranked hit set. */
-declare function buildSearchResultForHits(response: SearchResponseContext, projectedItems: SearchResultItem[], total: number, limitedCount: number, effectiveProjection: SearchProjectionConfig, pageExtras: {
-has_more?: boolean;
-next_cursor?: string;
-applied_limit: number;
-truncated?: true;
-}): SearchResult;
-export { attachSearchHighlights, buildCountOnlySearchResult, buildEmptySearchResultFromContext, buildSearchResultForHits, emptySearchResult, projectSearchHits, readSearchFieldValue, withSearchWorkspaceMemory };
+declare function buildSearchResultForHits(response:SearchResponseContext,projectedItems:SearchResultItem[],total:number,limitedCount:number,effectiveProjection:SearchProjectionConfig,pageExtras:{
+has_more?:boolean;
+next_cursor?:string;
+applied_limit:number;
+truncated?:true;
+}):SearchResult;
+export { attachSearchHighlights,buildCountOnlySearchResult,buildEmptySearchResultFromContext,buildSearchResultForHits,emptySearchResult,projectSearchHits,readSearchFieldValue,withSearchWorkspaceMemory };

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

@@ -1,89 +1,89 @@
 import { type Bm25Params } from "../../../core/search/bm25.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 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 { toNonEmptyStringOrUndefined } from "../../../core/shared/primitives.js";
-import type { ItemDocument, PmSettings } from "../../../types/index.js";
+import type { ItemDocument,PmSettings } from "../../../types/index.js";
 import { type SearchOptions } from "../search-contracts.js";
 import { type SearchMode } from "../search-rendering.js";
 import type { SearchHit } from "./types.js";
 interface ExtensionSearchProviderContext {
-query: string;
-mode: SearchMode;
-tokens: string[];
-options: SearchOptions;
-settings: PmSettings;
-documents: ItemDocument[];
+query:string;
+mode:SearchMode;
+tokens:string[];
+options:SearchOptions;
+settings:PmSettings;
+documents:ItemDocument[];
 }
 interface ExtensionSearchProviderHit {
-id: string;
-score: number;
-matched_fields?: string[];
+id:string;
+score:number;
+matched_fields?:string[];
 }
-type ExtensionSearchProviderQuery = (context: ExtensionSearchProviderContext) => Promise<ExtensionSearchProviderHit[] | {
-hits?: ExtensionSearchProviderHit[];
+type ExtensionSearchProviderQuery = (context:ExtensionSearchProviderContext) => Promise<ExtensionSearchProviderHit[] | {
+hits?:ExtensionSearchProviderHit[];
 }> | ExtensionSearchProviderHit[] | {
-hits?: ExtensionSearchProviderHit[];
+hits?:ExtensionSearchProviderHit[];
 };
 interface ExtensionSearchProviderQueryExpansionContext {
-query: string;
-mode: Exclude<SearchMode, "keyword">;
-settings: PmSettings;
+query:string;
+mode:Exclude<SearchMode,"keyword">;
+settings:PmSettings;
 }
 /** Optional provider hook used to expand a query before semantic retrieval. */
-type ExtensionSearchProviderQueryExpansion = (context: ExtensionSearchProviderQueryExpansionContext) => Promise<string[] | {
-queries?: string[];
+type ExtensionSearchProviderQueryExpansion = (context:ExtensionSearchProviderQueryExpansionContext) => Promise<string[] | {
+queries?:string[];
 }> | string[] | {
-queries?: string[];
+queries?:string[];
 };
 interface ExtensionSearchProviderRerankCandidate {
-id: string;
-text: string;
-score: number;
+id:string;
+text:string;
+score:number;
 }
 interface ExtensionSearchProviderRerankContext {
-query: string;
-mode: "hybrid";
-model: string;
-top_k: number;
-settings: PmSettings;
-candidates: ExtensionSearchProviderRerankCandidate[];
+query:string;
+mode:"hybrid";
+model:string;
+top_k:number;
+settings:PmSettings;
+candidates:ExtensionSearchProviderRerankCandidate[];
 }
 /** Optional provider hook used to rerank retrieved candidates. */
-type ExtensionSearchProviderRerank = (context: ExtensionSearchProviderRerankContext) => Promise<Array<{
-id?: unknown;
-score?: unknown;
+type ExtensionSearchProviderRerank = (context:ExtensionSearchProviderRerankContext) => Promise<Array<{
+id?:unknown;
+score?:unknown;
 }> | {
-hits?: Array<{
-id?: unknown;
-score?: unknown;
+hits?:Array<{
+id?:unknown;
+score?:unknown;
 }>;
 }> | Array<{
-id?: unknown;
-score?: unknown;
+id?:unknown;
+score?:unknown;
 }> | {
-hits?: Array<{
-id?: unknown;
-score?: unknown;
+hits?:Array<{
+id?:unknown;
+score?:unknown;
 }>;
 };
-type ExtensionVectorQuery = (context: {
-vector: number[];
-limit: number;
-settings: PmSettings;
+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>;
+type ExtensionVectorUpsert = (context:{
+points:Array<{
+id:string;
+vector:number[];
+payload:Record<string,unknown>;
 }>;
-settings: PmSettings;
+settings:PmSettings;
 }) => Promise<void> | void;
 type ExtensionVectorAdapter = {
-adapterName: string;
-query?: ExtensionVectorQuery;
-upsert?: ExtensionVectorUpsert;
+adapterName:string;
+query?:ExtensionVectorQuery;
+upsert?:ExtensionVectorUpsert;
 };
 type ImplicitSemanticFallbackReason = "timeout" | "connection" | "error";
 /**
@@ -95,71 +95,71 @@ type ImplicitSemanticFallbackReason = "timeout" | "connection" | "error";
  * classifier label a downed/unreachable Ollama backend as "connection" rather
  * than the catch-all "error".
  */
-export declare function collectErrorCauseCodes(error: unknown): string;
+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;
+export declare function classifyImplicitSemanticFallbackReason(error:unknown):ImplicitSemanticFallbackReason;
 /** Describe why an explicitly requested semantic mode fell back to keyword retrieval. */
-declare function buildExplicitSemanticFallbackWarning(requestedMode: SearchMode, error: unknown): string;
+declare function buildExplicitSemanticFallbackWarning(requestedMode:SearchMode,error:unknown):string;
 interface VectorIndexRecoveryRegistrations {
-commands?: readonly {
-command: string;
+commands?:readonly {
+command:string;
 }[];
 }
 interface VectorIndexRecovery {
-command: string;
-args: string[];
-follow_up_command?: string;
-follow_up_args?: string[];
+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;
+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>;
+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[];
+export declare function formatVectorIndexRecoveryWarnings(staleCount:number,recovery:VectorIndexRecovery):string[];
 /** Resolve the configured semantic provider and vector-store dependencies or report their absence. */
-declare function requireSemanticDependencies(requestedMode: Exclude<SearchMode, "keyword">, providerResolution: EmbeddingProviderResolution, vectorResolution: VectorStoreResolution, hasExtensionVectorQuery: boolean): {
-provider: EmbeddingProviderConfig;
-vectorStore: VectorStoreConfig | null;
+declare function requireSemanticDependencies(requestedMode:Exclude<SearchMode,"keyword">,providerResolution:EmbeddingProviderResolution,vectorResolution:VectorStoreResolution,hasExtensionVectorQuery:boolean):{
+provider:EmbeddingProviderConfig;
+vectorStore:VectorStoreConfig | null;
 };
 /** Normalize optional provider identifiers to trimmed non-empty strings. */
-declare const toOptionalNonEmptyString: typeof toNonEmptyStringOrUndefined;
+declare const toOptionalNonEmptyString:typeof toNonEmptyStringOrUndefined;
 interface ExtensionSearchProviderHooks {
-providerName: string;
-query?: ExtensionSearchProviderQuery;
-queryExpansion?: ExtensionSearchProviderQueryExpansion;
-rerank?: ExtensionSearchProviderRerank;
+providerName:string;
+query?:ExtensionSearchProviderQuery;
+queryExpansion?:ExtensionSearchProviderQueryExpansion;
+rerank?:ExtensionSearchProviderRerank;
 }
 /** Find an active extension search provider by its declared name. */
-declare function resolveExtensionSearchProviderByName(providerName: string | undefined): ExtensionSearchProviderHooks | null;
+declare function resolveExtensionSearchProviderByName(providerName:string | undefined):ExtensionSearchProviderHooks | null;
 /** Resolve the configured extension-owned search provider. */
-declare function resolveExtensionSearchProvider(settings: PmSettings): {
-providerName: string;
-query: ExtensionSearchProviderQuery;
+declare function resolveExtensionSearchProvider(settings:PmSettings):{
+providerName:string;
+query:ExtensionSearchProviderQuery;
 } | null;
 /** Resolve the configured extension-owned vector-store adapter. */
-declare function resolveExtensionVectorAdapter(settings: PmSettings): ExtensionVectorAdapter | null;
+declare function resolveExtensionVectorAdapter(settings:PmSettings):ExtensionVectorAdapter | null;
 /** Normalize extension retrieval results to item IDs and numeric scores. */
-declare function normalizeExtensionProviderHits(providerName: string, raw: unknown, filteredById: Map<string, ItemDocument>): SearchHit[];
+declare function normalizeExtensionProviderHits(providerName:string,raw:unknown,filteredById:Map<string,ItemDocument>):SearchHit[];
 /** Join semantic scores to the filtered item corpus. */
-declare function buildSemanticHits(vectorHits: VectorQueryHit[], filteredById: Map<string, ItemDocument>): {
-semanticHits: SearchHit[];
-semanticScores: Map<string, number>;
+declare function buildSemanticHits(vectorHits:VectorQueryHit[],filteredById:Map<string,ItemDocument>):{
+semanticHits:SearchHit[];
+semanticScores:Map<string,number>;
 };
 /** Blend lexical and semantic results while preserving exact-ID precedence. */
-declare function combineHybridHits(filteredById: Map<string, ItemDocument>, semanticScores: Map<string, number>, keywordHits: SearchHit[], hybridSemanticWeight: number, semanticFieldLabel?: string): SearchHit[];
+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";
 /** Select the built-in BM25 path from effective search settings. */
-declare function resolveBuiltInBm25Mode(params: {
-configuredProvider: string | undefined;
-hasEmbeddingProvider: boolean;
-hasExtensionSearchProvider: boolean;
-}): BuiltInBm25Mode | null;
+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
@@ -171,59 +171,59 @@ hasExtensionSearchProvider: boolean;
  * {@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[];
+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;
+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;
+rerank:RerankConfig;
+rerankExtension:{
+providerName:string;
+rerank:ExtensionSearchProviderRerank;
 } | null;
-warnings: string[];
-settings: PmSettings;
-embeddingTimeoutMs?: number;
-vectorQueryTimeoutMs?: number;
+warnings:string[];
+settings:PmSettings;
+embeddingTimeoutMs?:number;
+vectorQueryTimeoutMs?:number;
 }
 interface SemanticQueryResult {
-hits: SearchHit[];
-vectorMatchCount: number;
+hits:SearchHit[];
+vectorMatchCount:number;
 }
 /** Merge vector retrieval batches by item ID for query expansion. */
-declare function mergeVectorHitsById(vectorHitGroups: VectorQueryHit[][]): VectorQueryHit[];
+declare function mergeVectorHitsById(vectorHitGroups:VectorQueryHit[][]):VectorQueryHit[];
 /** Build the candidate text corpus supplied to reranking providers. */
-declare function buildRerankCorpus(document: ItemDocument): string;
+declare function buildRerankCorpus(document:ItemDocument):string;
 /** Execute provider retrieval and ranking with the existing fallback and warning contracts. */
-declare function computeSemanticOrHybridHits(context: SemanticQueryContext): Promise<SemanticQueryResult>;
+declare function computeSemanticOrHybridHits(context:SemanticQueryContext):Promise<SemanticQueryResult>;
 /** Resolve the active provider implementation for configured query expansion. */
-declare function resolveQueryExpansionExtension(queryExpansion: QueryExpansionConfig): {
-providerName: string;
-expand: ExtensionSearchProviderQueryExpansion;
+declare function resolveQueryExpansionExtension(queryExpansion:QueryExpansionConfig):{
+providerName:string;
+expand:ExtensionSearchProviderQueryExpansion;
 } | null;
 /** Resolve the active provider implementation for configured reranking. */
-declare function resolveRerankExtension(settings: PmSettings): {
-providerName: string;
-rerank: ExtensionSearchProviderRerank;
+declare function resolveRerankExtension(settings:PmSettings):{
+providerName:string;
+rerank:ExtensionSearchProviderRerank;
 } | null;
-export { buildExplicitSemanticFallbackWarning, buildRerankCorpus, buildSemanticHits, BuiltInBm25Mode, combineHybridHits, computeBuiltInBm25Hits, computeSemanticOrHybridHits, ExtensionSearchProviderQueryExpansion, ExtensionSearchProviderRerank, maybeEmitVectorIndexStaleWarning, mergeVectorHitsById, normalizeExtensionProviderHits, requireSemanticDependencies, resolveBuiltInBm25Mode, resolveExtensionSearchProvider, resolveExtensionSearchProviderByName, resolveExtensionVectorAdapter, resolveQueryExpansionExtension, resolveRerankExtension, toOptionalNonEmptyString };
+export { buildExplicitSemanticFallbackWarning,buildRerankCorpus,buildSemanticHits,BuiltInBm25Mode,combineHybridHits,computeBuiltInBm25Hits,computeSemanticOrHybridHits,ExtensionSearchProviderQueryExpansion,ExtensionSearchProviderRerank,maybeEmitVectorIndexStaleWarning,mergeVectorHitsById,normalizeExtensionProviderHits,requireSemanticDependencies,resolveBuiltInBm25Mode,resolveExtensionSearchProvider,resolveExtensionSearchProviderByName,resolveExtensionVectorAdapter,resolveQueryExpansionExtension,resolveRerankExtension,toOptionalNonEmptyString };