@unbrained/pm-cli 2026.10.13 → 2026.10.15

package/dist/core/search/cache.d.ts

@@ -1,83 +1,83 @@
 import { readSettings } from "../store/settings.js";
 import type { EmbeddingProviderConfig } from "./providers.js";
 import type { VectorStoreConfig } from "./vector-stores.js";
-import type { VectorizationEmbeddingIdentity, VectorizationEmbeddingMetadata } from "./vectorization-metadata.js";
+import type { VectorizationEmbeddingIdentity,VectorizationEmbeddingMetadata } from "./vectorization-metadata.js";
 /** Public contract for search cache artifact paths, shared by SDK and presentation-layer consumers. */
-export declare const SEARCH_CACHE_ARTIFACT_PATHS: readonly ["index/manifest.json", "search/embeddings.jsonl"];
+export declare const SEARCH_CACHE_ARTIFACT_PATHS:readonly ["index/manifest.json","search/embeddings.jsonl"];
 /** Filesystem path used for vectorization status ledger resolution. */
 export declare const VECTORIZATION_STATUS_LEDGER_PATH = "search/vectorization-status.json";
 /** Documents the search cache invalidation result payload exchanged by command, SDK, and package integrations. */
 export interface SearchCacheInvalidationResult {
 /** Value that configures or reports invalidated for this contract. */
-invalidated: string[];
+invalidated:string[];
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 }
 /** Documents the semantic mutation refresh result payload exchanged by command, SDK, and package integrations. */
 export interface SemanticMutationRefreshResult {
 /** Value that configures or reports refreshed for this contract. */
-refreshed: string[];
+refreshed:string[];
 /** Value that configures or reports skipped for this contract. */
-skipped: string[];
+skipped:string[];
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 }
 /** Documents the search mutation artifact refresh result payload exchanged by command, SDK, and package integrations. */
 export interface SearchMutationArtifactRefreshResult extends SearchCacheInvalidationResult {
 /** Value that configures or reports refreshed for this contract. */
-refreshed: string[];
+refreshed:string[];
 /** Value that configures or reports skipped for this contract. */
-skipped: string[];
+skipped:string[];
 /** True when the semantic refresh was dispatched to a detached background worker. */
-scheduled?: boolean;
+scheduled?:boolean;
 }
 /** Documents the refresh search artifacts for mutation options payload exchanged by command, SDK, and package integrations. */
 export interface RefreshSearchArtifactsForMutationOptions {
 /** When true and semantic search is active, the (slow) embedding refresh is dispatched to a detached background worker instead of awaited inline so the mutation returns immediately. The synchronous keyword-cache invalidation still runs first. Callers pass this only outside test runners. */
-background?: boolean;
+background?:boolean;
 }
 /** Documents the semantic refresh options payload exchanged by command, SDK, and package integrations. */
 export interface SemanticRefreshOptions {
 /** Value that configures or reports settings for this contract. */
-settings?: Awaited<ReturnType<typeof readSettings>>;
+settings?:Awaited<ReturnType<typeof readSettings>>;
 /** Value that configures or reports apply runtime defaults for this contract. */
-apply_runtime_defaults?: boolean;
+apply_runtime_defaults?:boolean;
 }
 /** Documents the vectorization status ledger read result payload exchanged by command, SDK, and package integrations. */
 export interface VectorizationStatusLedgerReadResult {
 /** Value that configures or reports entries for this contract. */
-entries: Record<string, string>;
+entries:Record<string,string>;
 /** Value that configures or reports embedding for this contract. */
-embedding: VectorizationEmbeddingMetadata | null;
+embedding:VectorizationEmbeddingMetadata | null;
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 }
-declare function normalizeVectorizationLedgerEntries(entries: Record<string, string>): Record<string, string>;
+declare function normalizeVectorizationLedgerEntries(entries:Record<string,string>):Record<string,string>;
 /** Implements read vectorization status ledger for the public runtime surface of this module. */
-export declare function readVectorizationStatusLedger(pmRoot: string): Promise<VectorizationStatusLedgerReadResult>;
+export declare function readVectorizationStatusLedger(pmRoot:string):Promise<VectorizationStatusLedgerReadResult>;
 /** Implements write vectorization status ledger for the public runtime surface of this module. */
-export declare function writeVectorizationStatusLedger(pmRoot: string, entries: Record<string, string>, embedding?: VectorizationEmbeddingMetadata | null): Promise<void>;
+export declare function writeVectorizationStatusLedger(pmRoot:string,entries:Record<string,string>,embedding?:VectorizationEmbeddingMetadata | null):Promise<void>;
 interface SemanticRefreshOperationResult {
-refreshed: string[];
-skipped: string[];
-warnings: string[];
+refreshed:string[];
+skipped:string[];
+warnings:string[];
 }
-declare function buildVectorizationIdentityForProvider(provider: EmbeddingProviderConfig): VectorizationEmbeddingIdentity;
-declare function buildSkippedSemanticRefreshResult(itemIds: string[], warning: string): SemanticMutationRefreshResult;
-declare function resetSemanticVectorStore(vectorStore: VectorStoreConfig, ledgerEntries: Record<string, string>): Promise<SemanticRefreshOperationResult>;
+declare function buildVectorizationIdentityForProvider(provider:EmbeddingProviderConfig):VectorizationEmbeddingIdentity;
+declare function buildSkippedSemanticRefreshResult(itemIds:string[],warning:string):SemanticMutationRefreshResult;
+declare function resetSemanticVectorStore(vectorStore:VectorStoreConfig,ledgerEntries:Record<string,string>):Promise<SemanticRefreshOperationResult>;
 /** Implements invalidate search cache artifacts for the public runtime surface of this module. */
-export declare function invalidateSearchCacheArtifacts(pmRoot: string): Promise<SearchCacheInvalidationResult>;
+export declare function invalidateSearchCacheArtifacts(pmRoot:string):Promise<SearchCacheInvalidationResult>;
 /** Implements refresh semantic embeddings for mutated items for the public runtime surface of this module. */
-export declare function refreshSemanticEmbeddingsForMutatedItems(pmRoot: string, itemIds: string[], options?: SemanticRefreshOptions): Promise<SemanticMutationRefreshResult>;
+export declare function refreshSemanticEmbeddingsForMutatedItems(pmRoot:string,itemIds:string[],options?:SemanticRefreshOptions):Promise<SemanticMutationRefreshResult>;
 /** Returns true when a semantic embedding refresh would do real work for these settings (an embedding provider AND a vector store both resolve). Used to decide whether a mutation's refresh is worth dispatching to a background worker — when semantic search is not configured the inline path is already a fast no-op and no child is spawned. */
-export declare function isSemanticRefreshActive(settings: Awaited<ReturnType<typeof readSettings>>, applyRuntimeDefaults: boolean): boolean;
+export declare function isSemanticRefreshActive(settings:Awaited<ReturnType<typeof readSettings>>,applyRuntimeDefaults:boolean):boolean;
 /** Implements refresh search artifacts for mutation for the public runtime surface of this module. */
-export declare function refreshSearchArtifactsForMutation(pmRoot: string, itemIds: string[], options?: RefreshSearchArtifactsForMutationOptions): Promise<SearchMutationArtifactRefreshResult>;
+export declare function refreshSearchArtifactsForMutation(pmRoot:string,itemIds:string[],options?:RefreshSearchArtifactsForMutationOptions):Promise<SearchMutationArtifactRefreshResult>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-buildSkippedSemanticRefreshResult: typeof buildSkippedSemanticRefreshResult;
-buildVectorizationIdentityForProvider: typeof buildVectorizationIdentityForProvider;
-normalizeVectorizationLedgerEntries: typeof normalizeVectorizationLedgerEntries;
-resetSemanticVectorStore: typeof resetSemanticVectorStore;
+export declare const _testOnly:{
+buildSkippedSemanticRefreshResult:typeof buildSkippedSemanticRefreshResult;
+buildVectorizationIdentityForProvider:typeof buildVectorizationIdentityForProvider;
+normalizeVectorizationLedgerEntries:typeof normalizeVectorizationLedgerEntries;
+resetSemanticVectorStore:typeof resetSemanticVectorStore;
 };
 export {};

package/dist/core/search/corpus.d.ts

@@ -3,7 +3,7 @@
  *
  * Powers search, embeddings, and semantic retrieval behavior for Corpus.
  */
-import type { ItemDocument, ItemMetadata, PmSettings } from "../../types/index.js";
+import type { ItemDocument,ItemMetadata,PmSettings } from "../../types/index.js";
 /**
  * Canonical ordered list of corpus field names emitted by {@link buildSearchCorpus}.
  *
@@ -16,14 +16,14 @@ import type { ItemDocument, ItemMetadata, PmSettings } from "../../types/index.j
  * content (see {@link buildPlanCorpus}); it is still part of the default set so
  * plan-bearing items keep their plan corpus.
  */
-export declare const DEFAULT_SEARCH_CORPUS_FIELDS: readonly string[];
+export declare const DEFAULT_SEARCH_CORPUS_FIELDS:readonly string[];
 /**
  * Resolve the effective corpus field list from settings.
  *
  * - unset / not an array / empty array → the full default set (backward compatible).
  * - non-empty array → exactly those names (string entries only; trimmed; empties dropped).
  */
-export declare function resolveSearchCorpusFields(settings: Pick<PmSettings, "search"> | undefined): string[];
+export declare function resolveSearchCorpusFields(settings:Pick<PmSettings,"search"> | undefined):string[];
 /** Fallback semantic corpus input max characters used when callers do not provide an override. */
 export declare const DEFAULT_SEMANTIC_CORPUS_INPUT_MAX_CHARACTERS = 8000;
 /** Public contract for ollama semantic corpus input max characters, shared by SDK and presentation-layer consumers. */
@@ -33,47 +33,47 @@ export declare const SEMANTIC_CORPUS_TRUNCATION_SUFFIX = "...[semantic corpus tr
 /** Public contract for search embedding corpus max characters invalid warning, shared by SDK and presentation-layer consumers. */
 export declare const SEARCH_EMBEDDING_CORPUS_MAX_CHARACTERS_INVALID_WARNING = "search_embedding_corpus_max_characters_invalid:using_provider_default";
 /** Implements build reminder corpus for the public runtime surface of this module. */
-export declare function buildReminderCorpus(item: ItemMetadata): string[];
+export declare function buildReminderCorpus(item:ItemMetadata):string[];
 /** Implements build event corpus for the public runtime surface of this module. */
-export declare function buildEventCorpus(item: ItemMetadata): string[];
+export declare function buildEventCorpus(item:ItemMetadata):string[];
 /** Implements build plan flat corpus for the public runtime surface of this module. */
-export declare function buildPlanFlatCorpus(item: ItemMetadata): string;
+export declare function buildPlanFlatCorpus(item:ItemMetadata):string;
 /** Implements build plan corpus for the public runtime surface of this module. */
-export declare function buildPlanCorpus(item: ItemMetadata): Record<string, unknown> | undefined;
+export declare function buildPlanCorpus(item:ItemMetadata):Record<string,unknown> | undefined;
 /** Documents the search corpus options payload exchanged by command, SDK, and package integrations. */
 export interface SearchCorpusOptions {
 /**
      * Field names to include. When omitted, the full default set is used.
      * See {@link DEFAULT_SEARCH_CORPUS_FIELDS} and {@link resolveSearchCorpusFields}.
      */
-fields?: string[];
+fields?:string[];
 }
 /** Implements build search corpus for the public runtime surface of this module. */
-export declare function buildSearchCorpus(document: ItemDocument, options?: SearchCorpusOptions): Record<string, unknown>;
+export declare function buildSearchCorpus(document:ItemDocument,options?:SearchCorpusOptions):Record<string,unknown>;
 /** Implements resolve semantic corpus input character limit for the public runtime surface of this module. */
-export declare function resolveSemanticCorpusInputCharacterLimit(providerName: string | undefined): number;
+export declare function resolveSemanticCorpusInputCharacterLimit(providerName:string | undefined):number;
 /** Documents the semantic corpus character limit resolution payload exchanged by command, SDK, and package integrations. */
 export interface SemanticCorpusCharacterLimitResolution {
 /** Value that configures or reports max characters for this contract. */
-maxCharacters: number;
+maxCharacters:number;
 /** Value that configures or reports warning for this contract. */
-warning: string | null;
+warning:string | null;
 }
 /** Implements resolve semantic corpus character limit for the public runtime surface of this module. */
-export declare function resolveSemanticCorpusCharacterLimit(providerName: string | undefined, configuredMaxCharacters: unknown): SemanticCorpusCharacterLimitResolution;
+export declare function resolveSemanticCorpusCharacterLimit(providerName:string | undefined,configuredMaxCharacters:unknown):SemanticCorpusCharacterLimitResolution;
 /** Documents the semantic corpus input options payload exchanged by command, SDK, and package integrations. */
 export interface SemanticCorpusInputOptions {
 /** Value that configures or reports provider name for this contract. */
-providerName?: string;
+providerName?:string;
 /** Value that configures or reports max characters for this contract. */
-maxCharacters?: number;
+maxCharacters?:number;
 /**
      * Corpus field names to include. When omitted, the full default set is used
      * (see {@link DEFAULT_SEARCH_CORPUS_FIELDS}). Thread the resolved list from
      * {@link resolveSearchCorpusFields} so the embedded input honours
      * `search.corpus_fields`.
      */
-fields?: string[];
+fields?:string[];
 }
 /** Implements build semantic corpus input for the public runtime surface of this module. */
-export declare function buildSemanticCorpusInput(document: ItemDocument, options?: SemanticCorpusInputOptions): string;
+export declare function buildSemanticCorpusInput(document:ItemDocument,options?:SemanticCorpusInputOptions):string;

package/dist/core/search/embedding-batches.d.ts

@@ -9,62 +9,62 @@ import type { EmbeddingProviderConfig } from "./providers.js";
 /** Completed vectors and execution evidence returned only after every input succeeds. */
 export interface EmbeddingBatchExecutionResult {
 /** One vector for each input position, including repeated input text. */
-vectors: number[][];
+vectors:number[][];
 /** Truncation, retry, and split diagnostics; never contains source input text. */
-warnings: string[];
+warnings:string[];
 /** Actual provider work, including retries and adaptive splits. */
-receipt?: EmbeddingBatchReceipt;
+receipt?:EmbeddingBatchReceipt;
 }
 /** Bounded summary of actual provider work; histogram keys are successful request sizes. */
 export interface EmbeddingBatchReceipt {
 /** Provider and model used for this execution, without endpoint or credentials. */
-provider: string;
+provider:string;
 /** Model requested from the provider. */
-model: string;
+model:string;
 /** Maximum encoded JSON request size, including model and escaping. */
-max_request_bytes: number;
+max_request_bytes:number;
 /** Whether the request ceiling was supplied by the caller or the runtime. */
-limit_source: "caller" | "default";
+limit_source:"caller" | "default";
 /** Number of requests planned before adaptive splitting. */
-planned_batches: number;
+planned_batches:number;
 /** Total HTTP attempts, including unsuccessful requests. */
-requests: number;
+requests:number;
 /** Requests that returned validated vectors. */
-successful_batches: number;
+successful_batches:number;
 /** Failed requests subdivided into smaller requests. */
-split_batches: number;
+split_batches:number;
 /** Additional attempts of the same batch after a transient failure. */
-retries: number;
+retries:number;
 /** Successful request count by number of input positions. */
-batch_size_histogram: Record<string, number>;
+batch_size_histogram:Record<string,number>;
 /** Wall-clock duration including provider time and retry backoff. */
-elapsed_ms: number;
+elapsed_ms:number;
 /** Completed input positions divided by elapsed seconds. */
-inputs_per_second: number;
+inputs_per_second:number;
 }
 /** Progress across planned batches; actual HTTP work is reported separately in the receipt. */
 export interface EmbeddingBatchProgressEvent {
 /** One-based index of the current planned batch. */
-batch_index: number;
+batch_index:number;
 /** Number of planned batches before adaptive splitting. */
-batch_total: number;
+batch_total:number;
 /** Number of input positions in the current planned batch. */
-batch_size: number;
+batch_size:number;
 /** Input positions successfully embedded before or after this event. */
-completed_inputs: number;
+completed_inputs:number;
 /** Total input positions in this execution. */
-total_inputs: number;
+total_inputs:number;
 /** Optional attempt counter for callers extending progress reporting. */
-attempt?: number;
+attempt?:number;
 /** Whether dispatch is starting or the complete planned batch has succeeded. */
-phase: "start" | "complete";
+phase:"start" | "complete";
 }
 /** Host controls for progress reporting and transport payload bounds. */
 export interface EmbeddingBatchExecutionOptions {
 /** Observe planned-batch boundaries without receiving input text. */
-onProgress?: (event: EmbeddingBatchProgressEvent) => void;
+onProgress?:(event:EmbeddingBatchProgressEvent) => void;
 /** Positive JSON payload byte ceiling, independent of per-input corpus truncation; defaults to 256 KiB. */
-maxRequestBytes?: number;
+maxRequestBytes?:number;
 }
 /** Execute count- and byte-bounded batches in order. Reject impossible inputs before dispatch, retry transient failures, and subdivide size or timeout failures without returning partial vectors. */
-export declare function executeEmbeddingBatchesWithRetry(provider: EmbeddingProviderConfig, settings: PmSettings, inputs: string[], options?: EmbeddingBatchExecutionOptions): Promise<EmbeddingBatchExecutionResult>;
+export declare function executeEmbeddingBatchesWithRetry(provider:EmbeddingProviderConfig,settings:PmSettings,inputs:string[],options?:EmbeddingBatchExecutionOptions):Promise<EmbeddingBatchExecutionResult>;

package/dist/core/search/eval-thresholds.d.ts

@@ -5,10 +5,10 @@
  * scores. Shared by the public evaluator and repository quality gates.
  */
 /** Ranking metrics eligible for a declared quality floor. */
-export declare const EVAL_METRIC_NAMES: readonly ["ndcg", "mrr", "precision", "recall"];
+export declare const EVAL_METRIC_NAMES:readonly ["ndcg","mrr","precision","recall"];
 /** Optional normalized lower bounds; omitted metrics impose no constraint. */
-export type EvalMetricFloors = Partial<Record<typeof EVAL_METRIC_NAMES[number], number>>;
+export type EvalMetricFloors = Partial<Record<typeof EVAL_METRIC_NAMES[number],number>>;
 /** Reject malformed or misspelled floors rather than silently weakening a quality contract. */
-export declare function parseEvalMetricFloors(value: unknown): EvalMetricFloors;
+export declare function parseEvalMetricFloors(value:unknown):EvalMetricFloors;
 /** Compare unrounded metrics to validated floors and return stable, actionable violations. */
-export declare function evaluateMetricFloors(metrics: Record<typeof EVAL_METRIC_NAMES[number], number>, floors: EvalMetricFloors): string[];
+export declare function evaluateMetricFloors(metrics:Record<typeof EVAL_METRIC_NAMES[number],number>,floors:EvalMetricFloors):string[];

package/dist/core/search/eval.d.ts

@@ -19,43 +19,43 @@ export type EvalSearchMode = "keyword" | "semantic" | "hybrid";
 /** Default cutoff (`@k`) used for every metric when the caller does not override it. */
 export declare const DEFAULT_EVAL_K = 10;
 /** Stable public schema identifier for versioned golden-query files. */
-export declare const EVAL_QUERY_SET_SCHEMA_ID: "https://schema.unbrained.dev/pm/eval-query-set/v1";
+export declare const EVAL_QUERY_SET_SCHEMA_ID:"https://schema.unbrained.dev/pm/eval-query-set/v1";
 /** Machine-readable input contract exposed by the SDK and CLI guidance. */
-export declare const EVAL_QUERY_SET_CONTRACT: {
-readonly schema: "https://schema.unbrained.dev/pm/eval-query-set/v1";
-readonly accepted_top_level: readonly ["array", "object"];
-readonly required_query_fields: readonly ["query", "relevant_ids"];
-readonly optional_fields: readonly ["mode", "description", "minimum"];
-readonly modes: readonly ["keyword", "semantic", "hybrid"];
+export declare const EVAL_QUERY_SET_CONTRACT:{
+readonly schema:"https://schema.unbrained.dev/pm/eval-query-set/v1";
+readonly accepted_top_level:readonly ["array","object"];
+readonly required_query_fields:readonly ["query","relevant_ids"];
+readonly optional_fields:readonly ["mode","description","minimum"];
+readonly modes:readonly ["keyword","semantic","hybrid"];
 };
 /** Copy-ready minimal query set shared by help, diagnostics, and integrations. */
-export declare const EVAL_QUERY_SET_EXAMPLE: {
-readonly schema: "https://schema.unbrained.dev/pm/eval-query-set/v1";
-readonly queries: readonly [{
-readonly query: "offline search";
-readonly relevant_ids: readonly ["pm-75k9"];
-readonly mode: "keyword";
+export declare const EVAL_QUERY_SET_EXAMPLE:{
+readonly schema:"https://schema.unbrained.dev/pm/eval-query-set/v1";
+readonly queries:readonly [{
+readonly query:"offline search";
+readonly relevant_ids:readonly ["pm-75k9"];
+readonly mode:"keyword";
 }];
 };
 /** One curated golden query: the query text, the set of item ids considered relevant, an optional per-query retrieval mode override, and an optional human-readable description of the relevance intent. */
 export interface EvalQuery {
 /** Value that configures or reports query for this contract. */
-query: string;
+query:string;
 /** Value that configures or reports relevant ids for this contract. */
-relevant_ids: string[];
+relevant_ids:string[];
 /** Value that configures or reports mode for this contract. */
-mode?: EvalSearchMode;
+mode?:EvalSearchMode;
 /** Value that configures or reports description for this contract. */
-description?: string;
+description?:string;
 /** Per-query floors applied before rounding, independently of the aggregate gate. */
-minimum?: EvalMetricFloors;
+minimum?:EvalMetricFloors;
 }
 /** A parsed, validated golden-query set. */
 export interface EvalQuerySet {
 /** Versioned schema used to interpret the query-set payload. */
-schema: typeof EVAL_QUERY_SET_SCHEMA_ID;
+schema:typeof EVAL_QUERY_SET_SCHEMA_ID;
 /** Value that configures or reports queries for this contract. */
-queries: EvalQuery[];
+queries:EvalQuery[];
 }
 /**
  * Thrown by {@link parseEvalQuerySet} when the raw golden-query payload is
@@ -64,54 +64,54 @@ queries: EvalQuery[];
  */
 export declare class EvalQuerySetError extends Error {
 /** Construct an error describing why a golden-query set failed validation. */
-constructor(message: string);
+constructor(message:string);
 }
 /** Compute Discounted Cumulative Gain at cutoff `k` for an ordered list of binary relevance gains (`1` relevant, `0` not). Position `i` (1-based) contributes `gain / log2(i + 1)`, so a relevant hit ranked first is worth `1` and later hits are progressively discounted. Gains beyond `k` are ignored. */
-export declare function dcgAtK(relevanceGains: number[], k: number): number;
+export declare function dcgAtK(relevanceGains:number[],k:number):number;
 /** Normalized DCG at cutoff `k`: the ranking's DCG divided by the DCG of the ideal ranking (all relevant ids first). Returns `0` when the query has no relevant ids (the ideal DCG is `0` and the score is undefined), giving a stable lower bound for aggregation. Result is in `[0, 1]`. */
-export declare function ndcgAtK(rankedIds: string[], relevantIds: ReadonlySet<string>, k: number): number;
+export declare function ndcgAtK(rankedIds:string[],relevantIds:ReadonlySet<string>,k:number):number;
 /**
  * Reciprocal rank of the first relevant id within the top `k` results: `1/rank`
  * (rank is 1-based), or `0` when no relevant id appears in the cutoff. Averaged
  * across queries this is Mean Reciprocal Rank (MRR@k).
  */
-export declare function reciprocalRankAtK(rankedIds: string[], relevantIds: ReadonlySet<string>, k: number): number;
+export declare function reciprocalRankAtK(rankedIds:string[],relevantIds:ReadonlySet<string>,k:number):number;
 /** Precision at cutoff `k`: relevant ids retrieved in the top `k` divided by `k`. Returns `0` for a non-positive `k`. */
-export declare function precisionAtK(rankedIds: string[], relevantIds: ReadonlySet<string>, k: number): number;
+export declare function precisionAtK(rankedIds:string[],relevantIds:ReadonlySet<string>,k:number):number;
 /** Recall at cutoff `k`: relevant ids retrieved in the top `k` divided by the total number of relevant ids. Returns `0` when the query has no relevant ids. */
-export declare function recallAtK(rankedIds: string[], relevantIds: ReadonlySet<string>, k: number): number;
+export declare function recallAtK(rankedIds:string[],relevantIds:ReadonlySet<string>,k:number):number;
 /** The four ranking metrics computed for a single query, plus match counts. */
 export interface QueryEvalMetrics {
 /** Value that configures or reports ndcg for this contract. */
-ndcg: number;
+ndcg:number;
 /** Value that configures or reports mrr for this contract. */
-mrr: number;
+mrr:number;
 /** Value that configures or reports precision for this contract. */
-precision: number;
+precision:number;
 /** Value that configures or reports recall for this contract. */
-recall: number;
+recall:number;
 /** Value that configures or reports relevant total for this contract. */
-relevant_total: number;
+relevant_total:number;
 /** Value that configures or reports retrieved relevant for this contract. */
-retrieved_relevant: number;
+retrieved_relevant:number;
 }
 /** Evaluate one ranking against its relevant-id set at cutoff `k`, returning all four metrics together so callers compute the document ranking once and read every score off the result. */
-export declare function evaluateRanking(rankedIds: string[], relevantIds: ReadonlySet<string>, k: number): QueryEvalMetrics;
+export declare function evaluateRanking(rankedIds:string[],relevantIds:ReadonlySet<string>,k:number):QueryEvalMetrics;
 /** Macro-averaged metrics across all evaluated queries. */
 export interface AggregateEvalMetrics {
 /** Value that configures or reports ndcg for this contract. */
-ndcg: number;
+ndcg:number;
 /** Value that configures or reports mrr for this contract. */
-mrr: number;
+mrr:number;
 /** Value that configures or reports precision for this contract. */
-precision: number;
+precision:number;
 /** Value that configures or reports recall for this contract. */
-recall: number;
+recall:number;
 /** Number of query entries represented by this result. */
-query_count: number;
+query_count:number;
 }
 /** Macro-average per-query metrics (each query weighted equally). Returns all zeros with `query_count: 0` for an empty input so the gate path has a stable shape to compare against. */
-export declare function aggregateEvalMetrics(perQuery: QueryEvalMetrics[]): AggregateEvalMetrics;
+export declare function aggregateEvalMetrics(perQuery:QueryEvalMetrics[]):AggregateEvalMetrics;
 /**
  * Parse and validate a raw golden-query payload (typically `JSON.parse` of
  * `.agents/pm/search/eval-queries.json`). Accepts either a bare array of query
@@ -120,4 +120,4 @@ export declare function aggregateEvalMetrics(perQuery: QueryEvalMetrics[]): Aggr
  * `queries` is missing/not an array, when the set is empty, or when any entry
  * fails {@link parseEvalQueryEntry}.
  */
-export declare function parseEvalQuerySet(raw: unknown): EvalQuerySet;
+export declare function parseEvalQuerySet(raw:unknown):EvalQuerySet;

package/dist/core/search/http-client.d.ts

@@ -1,60 +1,60 @@
 /** HTTP failure with a status code that schedulers can classify without parsing provider text. */
 export declare class SearchHttpError extends Error {
 /** HTTP status returned by the provider, retained independently of its response body. */
-readonly status: number;
+readonly status:number;
 /** Preserve the existing user-facing message and the machine-readable HTTP status. */
-constructor(message: string, status: number);
+constructor(message:string,status:number);
 }
 /** Documents the search http response payload exchanged by command, SDK, and package integrations. */
 export interface SearchHttpResponse {
 /** Whether the operation completed without a blocking failure. */
-ok: boolean;
+ok:boolean;
 /** Lifecycle state reported for status. */
-status: number;
+status:number;
 /** Value that configures or reports status text for this contract. */
-statusText: string;
+statusText:string;
 /** Value that configures or reports json for this contract. */
-json(): Promise<unknown>;
+json():Promise<unknown>;
 /** Value that configures or reports text for this contract. */
-text(): Promise<string>;
+text():Promise<string>;
 }
 /** Documents the search http request init payload exchanged by command, SDK, and package integrations. */
 export interface SearchHttpRequestInit {
 /** Value that configures or reports method for this contract. */
-method: "DELETE" | "POST" | "PUT";
+method:"DELETE" | "POST" | "PUT";
 /** Value that configures or reports headers for this contract. */
-headers: Record<string, string>;
+headers:Record<string,string>;
 /** Value that configures or reports body for this contract. */
-body: string;
+body:string;
 /** Value that configures or reports signal for this contract. */
-signal: AbortSignal;
+signal:AbortSignal;
 }
 /** Restricts search http fetcher values accepted by command, SDK, and storage contracts. */
-export type SearchHttpFetcher<ResponseType extends SearchHttpResponse = SearchHttpResponse> = (url: string, init: SearchHttpRequestInit) => Promise<ResponseType>;
+export type SearchHttpFetcher<ResponseType extends SearchHttpResponse = SearchHttpResponse> = (url:string,init:SearchHttpRequestInit) => Promise<ResponseType>;
 /** Documents the execute search json request options payload exchanged by command, SDK, and package integrations. */
 export interface ExecuteSearchJsonRequestOptions<ResponseType extends SearchHttpResponse = SearchHttpResponse> {
 /** Value that configures or reports endpoint for this contract. */
-endpoint: string;
+endpoint:string;
 /** Value that configures or reports method for this contract. */
-method: "DELETE" | "POST" | "PUT";
+method:"DELETE" | "POST" | "PUT";
 /** Value that configures or reports headers for this contract. */
-headers: Record<string, string>;
+headers:Record<string,string>;
 /** Value that configures or reports body for this contract. */
-body: Record<string, unknown>;
+body:Record<string,unknown>;
 /** Elapsed time in milliseconds for timeout. */
-timeoutMs: number;
+timeoutMs:number;
 /** Value that configures or reports fetcher for this contract. */
-fetcher: SearchHttpFetcher<ResponseType>;
+fetcher:SearchHttpFetcher<ResponseType>;
 /** Value that configures or reports request label for this contract. */
-requestLabel: string;
+requestLabel:string;
 /** Value that configures or reports response label for this contract. */
-responseLabel: string;
+responseLabel:string;
 }
 /** Implements normalize search http timeout ms for the public runtime surface of this module. */
-export declare function normalizeSearchHttpTimeoutMs(timeoutMs: number | undefined, requestLabel: string, defaultTimeoutMs?: number): number;
+export declare function normalizeSearchHttpTimeoutMs(timeoutMs:number | undefined,requestLabel:string,defaultTimeoutMs?:number):number;
 /** Implements resolve search http fetcher for the public runtime surface of this module. */
-export declare function resolveSearchHttpFetcher<ResponseType extends SearchHttpResponse>(fetcher: SearchHttpFetcher<ResponseType> | undefined, requestLabel: string): SearchHttpFetcher<ResponseType>;
+export declare function resolveSearchHttpFetcher<ResponseType extends SearchHttpResponse>(fetcher:SearchHttpFetcher<ResponseType> | undefined,requestLabel:string):SearchHttpFetcher<ResponseType>;
 /** Implements read failed search http response body for the public runtime surface of this module. */
-export declare function readFailedSearchHttpResponseBody(response: SearchHttpResponse): Promise<string>;
+export declare function readFailedSearchHttpResponseBody(response:SearchHttpResponse):Promise<string>;
 /** Implements execute search json request for the public runtime surface of this module. */
-export declare function executeSearchJsonRequest<ResponseType extends SearchHttpResponse>(options: ExecuteSearchJsonRequestOptions<ResponseType>): Promise<unknown>;
+export declare function executeSearchJsonRequest<ResponseType extends SearchHttpResponse>(options:ExecuteSearchJsonRequestOptions<ResponseType>):Promise<unknown>;