@unbrained/pm-cli 2026.7.15 → 2026.7.17

package/dist/cli/commands/search.d.ts

@@ -1,467 +1,6 @@
-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 RuntimeFieldRegistry, 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 type { SharedItemFilterOptions } from "./item-filter-options.js";
-/** Documents the search options payload exchanged by command, SDK, and package integrations. */
-export interface SearchOptions extends SharedItemFilterOptions {
-    /** Value that configures or reports mode for this contract. */
-    mode?: string;
-    /** Strategy used to control match behavior. */
-    matchMode?: string;
-    /** Value that configures or reports min score for this contract. */
-    minScore?: string | number;
-    /** Value that configures or reports count for this contract. */
-    count?: boolean;
-    /** Value that configures or reports semantic weight for this contract. */
-    semanticWeight?: string | number;
-    /** Value that configures or reports include linked for this contract. */
-    includeLinked?: boolean;
-    /** Value that configures or reports title exact for this contract. */
-    titleExact?: boolean;
-    /** Value that configures or reports phrase exact for this contract. */
-    phraseExact?: boolean;
-    /** Value that configures or reports limit for this contract. */
-    limit?: string;
-    /** Opaque cursor returned by a previous search page. */
-    after?: string;
-    /** Value that configures or reports compact for this contract. */
-    compact?: boolean;
-    /** Value that configures or reports full for this contract. */
-    full?: boolean;
-    /** Value that configures or reports fields for this contract. */
-    fields?: string;
-    /** Value that configures or reports highlight for this contract. */
-    highlight?: boolean;
-}
-/** Restricts search match mode values accepted by command, SDK, and storage contracts. */
-export type SearchMatchMode = "and" | "or" | "exact";
-type SearchProjectionMode = "compact" | "full" | "fields";
-interface SearchProjectionConfig {
-    mode: SearchProjectionMode;
-    fields: string[];
-}
-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;
-    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[];
-}
-/** 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.
+ * @module cli/commands/search
  *
- * 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;
-/** 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 parseTimestampWindow(raw: unknown, fieldLabel: string): string | undefined;
-declare function parseProjectionConfig(options: SearchOptions): SearchProjectionConfig;
-/** Public contract for test only search command, shared by SDK and presentation-layer consumers. */
-export declare const _testOnlySearchCommand: {
-    applyFilters: typeof applyFilters;
-    applyExactQueryFilters: typeof applyExactQueryFilters;
-    applyInlineQueryFilters: typeof applyInlineQueryFilters;
-    buildHitHighlights: typeof buildHitHighlights;
-    buildVerboseSearchFilters: typeof buildVerboseSearchFilters;
-    buildExplicitSemanticFallbackWarning: typeof buildExplicitSemanticFallbackWarning;
-    buildCompactSearchFilterSummary: typeof buildCompactSearchFilterSummary;
-    buildHybridLexicalScore: typeof buildHybridLexicalScore;
-    buildRerankCorpus: typeof buildRerankCorpus;
-    buildSemanticHits: typeof buildSemanticHits;
-    classifyImplicitSemanticFallbackReason: typeof classifyImplicitSemanticFallbackReason;
-    collectErrorCauseCodes: typeof collectErrorCauseCodes;
-    collectExactPhraseFields: typeof collectExactPhraseFields;
-    collectLinkedPaths: typeof collectLinkedPaths;
-    combineHybridHits: typeof combineHybridHits;
-    computeBuiltInBm25Hits: typeof computeBuiltInBm25Hits;
-    computeSemanticOrHybridHits: typeof computeSemanticOrHybridHits;
-    resolveBuiltInBm25Mode: typeof resolveBuiltInBm25Mode;
-    countOccurrences: typeof countOccurrences;
-    dependencyEntries: typeof dependencyEntries;
-    documentContainsExactPhrase: typeof documentContainsExactPhrase;
-    emptySearchResult: typeof emptySearchResult;
-    highlightFieldSnippet: typeof highlightFieldSnippet;
-    loadDocuments: typeof loadDocuments;
-    markTokenRuns: typeof markTokenRuns;
-    parseInlineQueryFilters: typeof parseInlineQueryFilters;
-    maybeEmitVectorIndexStaleWarning: typeof maybeEmitVectorIndexStaleWarning;
-    loadLinkedCorpus: typeof loadLinkedCorpus;
-    mergeVectorHitsById: typeof mergeVectorHitsById;
-    normalizeExtensionProviderHits: typeof normalizeExtensionProviderHits;
-    normalizeScoreMap: typeof normalizeScoreMap;
-    parseProjectionConfig: typeof parseProjectionConfig;
-    parseTimestampWindow: typeof parseTimestampWindow;
-    parseTokens: typeof parseTokens;
-    readSearchFieldValue: typeof readSearchFieldValue;
-    requireSemanticDependencies: typeof requireSemanticDependencies;
-    resolveExtensionSearchProvider: typeof resolveExtensionSearchProvider;
-    resolveExtensionSearchProviderByName: typeof resolveExtensionSearchProviderByName;
-    resolveExtensionVectorAdapter: typeof resolveExtensionVectorAdapter;
-    resolveLinkedCorpusRoots: typeof resolveLinkedCorpusRoots;
-    scoreDocument: typeof scoreDocument;
-    sortHits: typeof sortHits;
-    stringArray: typeof stringArray;
-    textEntries: typeof textEntries;
-    validateSearchProjectionFields: typeof validateSearchProjectionFields;
-};
-declare function validateSearchProjectionFields(projection: SearchProjectionConfig, runtimeFieldRegistry: RuntimeFieldRegistry): void;
-declare function parseTokens(query: string): string[];
-/** 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>;
-/** Documents the search tuning payload exchanged by command, SDK, and package integrations. */
-export interface SearchTuning {
-    /** Value that configures or reports title exact bonus for this contract. */
-    title_exact_bonus: number;
-    /** Value that configures or reports title weight for this contract. */
-    title_weight: number;
-    /** Value that configures or reports description weight for this contract. */
-    description_weight: number;
-    /** Value that configures or reports tags weight for this contract. */
-    tags_weight: number;
-    /** Value that configures or reports status weight for this contract. */
-    status_weight: number;
-    /** Value that configures or reports body weight for this contract. */
-    body_weight: number;
-    /** Value that configures or reports comments weight for this contract. */
-    comments_weight: number;
-    /** Value that configures or reports notes weight for this contract. */
-    notes_weight: number;
-    /** Value that configures or reports learnings weight for this contract. */
-    learnings_weight: number;
-    /** Value that configures or reports reminders weight for this contract. */
-    reminders_weight: number;
-    /** Value that configures or reports events weight for this contract. */
-    events_weight: number;
-    /** Value that configures or reports dependencies weight for this contract. */
-    dependencies_weight: number;
-    /** Value that configures or reports linked content weight for this contract. */
-    linked_content_weight: number;
-}
-/**
- * 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>;
-/** Implements resolve search max results for the public runtime surface of this module. */
-export declare function resolveSearchMaxResults(settings: unknown): number;
-/** Implements resolve search score threshold for the public runtime surface of this module. */
-export declare function resolveSearchScoreThreshold(settings: unknown): number;
-/** Implements resolve hybrid semantic weight for the public runtime surface of this module. */
-export declare function resolveHybridSemanticWeight(settings: unknown): number;
-/** Implements resolve search tuning for the public runtime surface of this module. */
-export declare function resolveSearchTuning(settings: unknown): SearchTuning;
-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 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.
+ * Compatibility export for the SDK-owned search implementation.
  */
-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;
-/** Implements run search for the public runtime surface of this module. */
-export declare function runSearch(rawQuery: string, rawOptions: SearchOptions, global: GlobalOptions): Promise<SearchResult>;
-export {};
+export * from "../../sdk/query/search.js";