@unbrained/pm-cli 2026.10.13 → 2026.10.15

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

@@ -4,50 +4,50 @@
  * Powers search, embeddings, and semantic retrieval behavior for Providers.
  */
 import type { PmSettings } from "../../types/index.js";
-import type { SearchHttpFetcher, SearchHttpResponse } from "./http-client.js";
+import type { SearchHttpFetcher,SearchHttpResponse } from "./http-client.js";
 /** Restricts embedding provider name values accepted by command, SDK, and storage contracts. */
 export type EmbeddingProviderName = "openai" | "ollama";
 /** Documents the embedding provider config payload exchanged by command, SDK, and package integrations. */
 export interface EmbeddingProviderConfig {
 /** Value that configures or reports name for this contract. */
-name: EmbeddingProviderName;
+name:EmbeddingProviderName;
 /** Value that configures or reports base url for this contract. */
-base_url: string;
+base_url:string;
 /** Value that configures or reports model for this contract. */
-model: string;
+model:string;
 /** Value that configures or reports api key for this contract. */
-api_key?: string;
+api_key?:string;
 }
 /** Documents the embedding provider resolution payload exchanged by command, SDK, and package integrations. */
 export interface EmbeddingProviderResolution {
 /** Value that configures or reports active for this contract. */
-active: EmbeddingProviderConfig | null;
+active:EmbeddingProviderConfig | null;
 /** Value that configures or reports available for this contract. */
-available: EmbeddingProviderConfig[];
+available:EmbeddingProviderConfig[];
 }
 /** GH-244: how an active search-provider / vector-store adapter came to be resolved, so `pm health` can explain why a working runtime can coexist with empty persisted `search.provider` / `vector_store.adapter` settings: - "configured": the persisted setting names the active resolution. - "auto-detected": runtime auto-detection selected it; the setting is empty. - "unconfigured": nothing is active. */
 export type ProviderConfigSource = "configured" | "auto-detected" | "unconfigured";
 /** Classifies the resolution source for an active provider/adapter given the persisted (possibly empty) configured value. Pure and adapter-agnostic so it serves both the embedding provider and the vector-store adapter. "configured" requires the persisted value to actually MATCH the active resolution (case-insensitively): a configured-but-unhonored value (typo or unsupported name that the runtime fell back from) is reported as "auto-detected", not falsely "configured". */
-export declare function resolveProviderConfigSource(activeName: string | null | undefined, configured: string | null | undefined): ProviderConfigSource;
+export declare function resolveProviderConfigSource(activeName:string | null | undefined,configured:string | null | undefined):ProviderConfigSource;
 /** Documents the embedding request target payload exchanged by command, SDK, and package integrations. */
 export interface EmbeddingRequestTarget {
 /** Value that configures or reports provider for this contract. */
-provider: EmbeddingProviderName;
+provider:EmbeddingProviderName;
 /** Value that configures or reports endpoint for this contract. */
-endpoint: string;
+endpoint:string;
 /** Value that configures or reports model for this contract. */
-model: string;
+model:string;
 }
 /** Documents the embedding request plan payload exchanged by command, SDK, and package integrations. */
 export interface EmbeddingRequestPlan {
 /** Value that configures or reports target for this contract. */
-target: EmbeddingRequestTarget;
+target:EmbeddingRequestTarget;
 /** Value that configures or reports method for this contract. */
-method: "POST";
+method:"POST";
 /** 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>;
 }
 /** Restricts embedding http response values accepted by command, SDK, and storage contracts. */
 export type EmbeddingHttpResponse = SearchHttpResponse;
@@ -56,31 +56,31 @@ export type EmbeddingRequestFetcher = SearchHttpFetcher<EmbeddingHttpResponse>;
 /** Documents the execute embedding request options payload exchanged by command, SDK, and package integrations. */
 export interface ExecuteEmbeddingRequestOptions {
 /** Elapsed time in milliseconds for timeout. */
-timeout_ms?: number;
+timeout_ms?:number;
 /** Value that configures or reports fetcher for this contract. */
-fetcher?: EmbeddingRequestFetcher;
+fetcher?:EmbeddingRequestFetcher;
 }
 type ProviderSettingsInput = {
-providers?: {
-openai?: {
-base_url?: string;
-api_key?: string;
-model?: string;
+providers?:{
+openai?:{
+base_url?:string;
+api_key?:string;
+model?:string;
 };
-ollama?: {
-base_url?: string;
-model?: string;
+ollama?:{
+base_url?:string;
+model?:string;
 };
 };
 };
 /** Implements resolve embedding providers for the public runtime surface of this module. */
-export declare function resolveEmbeddingProviders(settings: PmSettings | ProviderSettingsInput): EmbeddingProviderResolution;
+export declare function resolveEmbeddingProviders(settings:PmSettings | ProviderSettingsInput):EmbeddingProviderResolution;
 /** Implements resolve embedding request target for the public runtime surface of this module. */
-export declare function resolveEmbeddingRequestTarget(provider: EmbeddingProviderConfig): EmbeddingRequestTarget;
+export declare function resolveEmbeddingRequestTarget(provider:EmbeddingProviderConfig):EmbeddingRequestTarget;
 /** Implements build embedding request plan for the public runtime surface of this module. */
-export declare function buildEmbeddingRequestPlan(provider: EmbeddingProviderConfig, input: string | string[]): EmbeddingRequestPlan;
+export declare function buildEmbeddingRequestPlan(provider:EmbeddingProviderConfig,input:string | string[]):EmbeddingRequestPlan;
 /** Implements normalize embedding response for the public runtime surface of this module. */
-export declare function normalizeEmbeddingResponse(provider: EmbeddingProviderConfig, response: unknown): number[][];
+export declare function normalizeEmbeddingResponse(provider:EmbeddingProviderConfig,response:unknown):number[][];
 /** Implements execute embedding request for the public runtime surface of this module. */
-export declare function executeEmbeddingRequest(provider: EmbeddingProviderConfig, input: string | string[], options?: ExecuteEmbeddingRequestOptions): Promise<number[][]>;
+export declare function executeEmbeddingRequest(provider:EmbeddingProviderConfig,input:string | string[],options?:ExecuteEmbeddingRequestOptions):Promise<number[][]>;
 export {};

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

@@ -12,46 +12,46 @@ export declare const DEFAULT_RERANK_TOP_K = 20;
 /** Documents the query expansion config payload exchanged by command, SDK, and package integrations. */
 export interface QueryExpansionConfig {
 /** Whether enabled applies to this operation. */
-enabled: boolean;
+enabled:boolean;
 /** Value that configures or reports provider for this contract. */
-provider: string | null;
+provider:string | null;
 /** Value that configures or reports max queries for this contract. */
-max_queries: number;
+max_queries:number;
 }
 /** Documents the rerank config payload exchanged by command, SDK, and package integrations. */
 export interface RerankConfig {
 /** Whether enabled applies to this operation. */
-enabled: boolean;
+enabled:boolean;
 /** Value that configures or reports model for this contract. */
-model: string;
+model:string;
 /** Value that configures or reports top k for this contract. */
-top_k: number;
+top_k:number;
 }
 /** Documents the rerank candidate payload exchanged by command, SDK, and package integrations. */
 export interface RerankCandidate {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports text for this contract. */
-text: string;
+text:string;
 }
 /** Documents the rerank scored hit payload exchanged by command, SDK, and package integrations. */
 export interface RerankScoredHit {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports score for this contract. */
-score: number;
+score:number;
 }
 /** Implements build deterministic query expansions for the public runtime surface of this module. */
-export declare function buildDeterministicQueryExpansions(query: string, maxQueries?: number): string[];
+export declare function buildDeterministicQueryExpansions(query:string,maxQueries?:number):string[];
 /** Implements normalize query expansion output for the public runtime surface of this module. */
-export declare function normalizeQueryExpansionOutput(raw: unknown): string[];
+export declare function normalizeQueryExpansionOutput(raw:unknown):string[];
 /** Implements merge query expansions for the public runtime surface of this module. */
-export declare function mergeQueryExpansions(base: string[], extra: string[], maxQueries: number): string[];
+export declare function mergeQueryExpansions(base:string[],extra:string[],maxQueries:number):string[];
 /** Implements resolve query expansion config for the public runtime surface of this module. */
-export declare function resolveQueryExpansionConfig(settings: PmSettings, fallbackProviderName: string | null): QueryExpansionConfig;
+export declare function resolveQueryExpansionConfig(settings:PmSettings,fallbackProviderName:string | null):QueryExpansionConfig;
 /** Implements resolve rerank config for the public runtime surface of this module. */
-export declare function resolveRerankConfig(settings: PmSettings, fallbackModel: string): RerankConfig;
+export declare function resolveRerankConfig(settings:PmSettings,fallbackModel:string):RerankConfig;
 /** Implements normalize rerank output for the public runtime surface of this module. */
-export declare function normalizeRerankOutput(raw: unknown): RerankScoredHit[];
+export declare function normalizeRerankOutput(raw:unknown):RerankScoredHit[];
 /** Implements rerank candidates with embeddings for the public runtime surface of this module. */
-export declare function rerankCandidatesWithEmbeddings(provider: EmbeddingProviderConfig, model: string, query: string, candidates: RerankCandidate[], timeoutMs?: number): Promise<Map<string, number>>;
+export declare function rerankCandidatesWithEmbeddings(provider:EmbeddingProviderConfig,model:string,query:string,candidates:RerankCandidate[],timeoutMs?:number):Promise<Map<string,number>>;

package/dist/core/search/semantic-defaults.d.ts

@@ -2,13 +2,13 @@ import type { PmSettings } from "../../types/index.js";
 /** Documents the semantic runtime defaults resolution payload exchanged by command, SDK, and package integrations. */
 export interface SemanticRuntimeDefaultsResolution {
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
+settings:PmSettings;
 /** Value that configures or reports auto ollama defaults applied for this contract. */
-auto_ollama_defaults_applied: boolean;
+auto_ollama_defaults_applied:boolean;
 /** Value that configures or reports auto ollama defaults skipped reason for this contract. */
-auto_ollama_defaults_skipped_reason?: "no_installed_embedding_model";
+auto_ollama_defaults_skipped_reason?:"no_installed_embedding_model";
 /** Value that configures or reports auto ollama defaults remediation for this contract. */
-auto_ollama_defaults_remediation?: string;
+auto_ollama_defaults_remediation?:string;
 }
 /** Implements resolve settings with semantic runtime defaults for the public runtime surface of this module. */
-export declare function resolveSettingsWithSemanticRuntimeDefaults(settings: PmSettings): SemanticRuntimeDefaultsResolution;
+export declare function resolveSettingsWithSemanticRuntimeDefaults(settings:PmSettings):SemanticRuntimeDefaultsResolution;

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

@@ -15,9 +15,9 @@
 /** Minimal item shape required to compare vectorization freshness. */
 export interface ItemWithUpdatedAt {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** ISO 8601 timestamp recording when updated occurred. */
-updated_at: string;
+updated_at:string;
 }
 /** Return the sorted list of item IDs whose current `updated_at` does not match the ledger entry. Missing ledger entries count as stale. */
-export declare function collectStaleVectorizationIds<T extends ItemWithUpdatedAt>(items: readonly T[], ledgerEntries: Readonly<Record<string, string>> | null | undefined): string[];
+export declare function collectStaleVectorizationIds<T extends ItemWithUpdatedAt>(items:readonly T[],ledgerEntries:Readonly<Record<string,string>> | null | undefined):string[];

package/dist/core/search/vector-stores.d.ts

@@ -4,102 +4,102 @@
  * Powers search, embeddings, and semantic retrieval behavior for Vector Stores.
  */
 import type { PmSettings } from "../../types/index.js";
-import type { SearchHttpFetcher, SearchHttpResponse } from "./http-client.js";
+import type { SearchHttpFetcher,SearchHttpResponse } from "./http-client.js";
 /** Restricts vector store name values accepted by command, SDK, and storage contracts. */
 export type VectorStoreName = "qdrant" | "lancedb";
 /** Documents the qdrant vector store config payload exchanged by command, SDK, and package integrations. */
 export interface QdrantVectorStoreConfig {
 /** Value that configures or reports name for this contract. */
-name: "qdrant";
+name:"qdrant";
 /** Value that configures or reports url for this contract. */
-url: string;
+url:string;
 /** Value that configures or reports collection name for this contract. */
-collection_name?: string;
+collection_name?:string;
 /** Value that configures or reports api key for this contract. */
-api_key?: string;
+api_key?:string;
 }
 /** Documents the lance db vector store config payload exchanged by command, SDK, and package integrations. */
 export interface LanceDbVectorStoreConfig {
 /** Value that configures or reports name for this contract. */
-name: "lancedb";
+name:"lancedb";
 /** Filesystem path used for path resolution. */
-path: string;
+path:string;
 /** Value that configures or reports collection name for this contract. */
-collection_name?: string;
+collection_name?:string;
 }
 /** Restricts vector store config values accepted by command, SDK, and storage contracts. */
 export type VectorStoreConfig = QdrantVectorStoreConfig | LanceDbVectorStoreConfig;
 /** Documents the vector store resolution payload exchanged by command, SDK, and package integrations. */
 export interface VectorStoreResolution {
 /** Value that configures or reports active for this contract. */
-active: VectorStoreConfig | null;
+active:VectorStoreConfig | null;
 /** Value that configures or reports available for this contract. */
-available: VectorStoreConfig[];
+available:VectorStoreConfig[];
 }
 /** Documents the vector store request target payload exchanged by command, SDK, and package integrations. */
 export interface VectorStoreRequestTarget {
 /** Value that configures or reports store for this contract. */
-store: VectorStoreName;
+store:VectorStoreName;
 /** Value that configures or reports query target for this contract. */
-query_target: string;
+query_target:string;
 /** Value that configures or reports upsert target for this contract. */
-upsert_target: string;
+upsert_target:string;
 }
 /** Documents the vector query plan payload exchanged by command, SDK, and package integrations. */
 export interface VectorQueryPlan {
 /** Value that configures or reports target for this contract. */
-target: VectorStoreRequestTarget;
+target:VectorStoreRequestTarget;
 /** Value that configures or reports method for this contract. */
-method: "POST" | "LOCAL";
+method:"POST" | "LOCAL";
 /** 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>;
 }
 /** Documents the vector record payload exchanged by command, SDK, and package integrations. */
 export interface VectorRecord {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports vector for this contract. */
-vector: number[];
+vector:number[];
 /** Value that configures or reports payload for this contract. */
-payload?: Record<string, unknown>;
+payload?:Record<string,unknown>;
 }
 /** Documents the vector upsert plan payload exchanged by command, SDK, and package integrations. */
 export interface VectorUpsertPlan {
 /** Value that configures or reports target for this contract. */
-target: VectorStoreRequestTarget;
+target:VectorStoreRequestTarget;
 /** Value that configures or reports method for this contract. */
-method: "POST" | "LOCAL";
+method:"POST" | "LOCAL";
 /** 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>;
 }
 /** Documents the vector delete plan payload exchanged by command, SDK, and package integrations. */
 export interface VectorDeletePlan {
 /** Value that configures or reports target for this contract. */
-target: VectorStoreRequestTarget;
+target:VectorStoreRequestTarget;
 /** Value that configures or reports method for this contract. */
-method: "POST" | "LOCAL";
+method:"POST" | "LOCAL";
 /** 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>;
 }
 /** Documents the vector query hit payload exchanged by command, SDK, and package integrations. */
 export interface VectorQueryHit {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports score for this contract. */
-score: number;
+score:number;
 /** Value that configures or reports payload for this contract. */
-payload?: Record<string, unknown>;
+payload?:Record<string,unknown>;
 }
 /** Documents the vector upsert result payload exchanged by command, SDK, and package integrations. */
 export interface VectorUpsertResult {
 /** Lifecycle state reported for status. */
-status: string;
+status:string;
 }
 /** Restricts vector http response values accepted by command, SDK, and storage contracts. */
 export type VectorHttpResponse = SearchHttpResponse;
@@ -108,40 +108,40 @@ export type VectorRequestFetcher = SearchHttpFetcher<VectorHttpResponse>;
 /** Documents the execute vector request options payload exchanged by command, SDK, and package integrations. */
 export interface ExecuteVectorRequestOptions {
 /** Elapsed time in milliseconds for timeout. */
-timeout_ms?: number;
+timeout_ms?:number;
 /** Value that configures or reports fetcher for this contract. */
-fetcher?: VectorRequestFetcher;
+fetcher?:VectorRequestFetcher;
 /** Value that configures or reports warnings for this contract. */
-warnings?: string[];
+warnings?:string[];
 }
 type VectorSettingsInput = {
-vector_store?: {
-collection_name?: string;
-qdrant?: {
-url?: string;
-api_key?: string;
+vector_store?:{
+collection_name?:string;
+qdrant?:{
+url?:string;
+api_key?:string;
 };
-lancedb?: {
-path?: string;
+lancedb?:{
+path?:string;
 };
 };
 };
 /** Implements resolve vector stores for the public runtime surface of this module. */
-export declare function resolveVectorStores(settings: PmSettings | VectorSettingsInput, pmRoot?: string): VectorStoreResolution;
+export declare function resolveVectorStores(settings:PmSettings | VectorSettingsInput,pmRoot?:string):VectorStoreResolution;
 /** Implements resolve vector store request target for the public runtime surface of this module. */
-export declare function resolveVectorStoreRequestTarget(store: VectorStoreConfig): VectorStoreRequestTarget;
+export declare function resolveVectorStoreRequestTarget(store:VectorStoreConfig):VectorStoreRequestTarget;
 /** Implements build vector query plan for the public runtime surface of this module. */
-export declare function buildVectorQueryPlan(store: VectorStoreConfig, vector: number[], limit: number): VectorQueryPlan;
+export declare function buildVectorQueryPlan(store:VectorStoreConfig,vector:number[],limit:number):VectorQueryPlan;
 /** Implements build vector upsert plan for the public runtime surface of this module. */
-export declare function buildVectorUpsertPlan(store: VectorStoreConfig, records: VectorRecord[]): VectorUpsertPlan;
+export declare function buildVectorUpsertPlan(store:VectorStoreConfig,records:VectorRecord[]):VectorUpsertPlan;
 /** Implements build vector delete plan for the public runtime surface of this module. */
-export declare function buildVectorDeletePlan(store: VectorStoreConfig, ids: string[]): VectorDeletePlan;
+export declare function buildVectorDeletePlan(store:VectorStoreConfig,ids:string[]):VectorDeletePlan;
 /** Implements execute vector query for the public runtime surface of this module. */
-export declare function executeVectorQuery(store: VectorStoreConfig, vector: number[], limit: number, options?: ExecuteVectorRequestOptions): Promise<VectorQueryHit[]>;
+export declare function executeVectorQuery(store:VectorStoreConfig,vector:number[],limit:number,options?:ExecuteVectorRequestOptions):Promise<VectorQueryHit[]>;
 /** Implements execute vector upsert for the public runtime surface of this module. */
-export declare function executeVectorUpsert(store: VectorStoreConfig, records: VectorRecord[], options?: ExecuteVectorRequestOptions): Promise<VectorUpsertResult>;
+export declare function executeVectorUpsert(store:VectorStoreConfig,records:VectorRecord[],options?:ExecuteVectorRequestOptions):Promise<VectorUpsertResult>;
 /** Implements execute vector delete for the public runtime surface of this module. */
-export declare function executeVectorDelete(store: VectorStoreConfig, ids: string[], options?: ExecuteVectorRequestOptions): Promise<VectorUpsertResult>;
+export declare function executeVectorDelete(store:VectorStoreConfig,ids:string[],options?:ExecuteVectorRequestOptions):Promise<VectorUpsertResult>;
 /** Implements execute vector reset for the public runtime surface of this module. */
-export declare function executeVectorReset(store: VectorStoreConfig, knownIds?: string[], options?: ExecuteVectorRequestOptions, vectorDimension?: number): Promise<VectorUpsertResult>;
+export declare function executeVectorReset(store:VectorStoreConfig,knownIds?:string[],options?:ExecuteVectorRequestOptions,vectorDimension?:number):Promise<VectorUpsertResult>;
 export {};

package/dist/core/search/vectorization-metadata.d.ts

@@ -1,24 +1,24 @@
 /** Documents the vectorization embedding identity payload exchanged by command, SDK, and package integrations. */
 export interface VectorizationEmbeddingIdentity {
 /** Value that configures or reports provider for this contract. */
-provider: string;
+provider:string;
 /** Value that configures or reports model for this contract. */
-model: string;
+model:string;
 }
 /** Documents the vectorization embedding metadata payload exchanged by command, SDK, and package integrations. */
 export interface VectorizationEmbeddingMetadata extends VectorizationEmbeddingIdentity {
 /** Value that configures or reports vector dimension for this contract. */
-vector_dimension: number;
+vector_dimension:number;
 }
 /** Implements build vectorization embedding identity for the public runtime surface of this module. */
-export declare function buildVectorizationEmbeddingIdentity(provider: unknown, model: unknown): VectorizationEmbeddingIdentity | null;
+export declare function buildVectorizationEmbeddingIdentity(provider:unknown,model:unknown):VectorizationEmbeddingIdentity | null;
 /** Implements normalize vectorization embedding metadata for the public runtime surface of this module. */
-export declare function normalizeVectorizationEmbeddingMetadata(value: unknown): VectorizationEmbeddingMetadata | null;
+export declare function normalizeVectorizationEmbeddingMetadata(value:unknown):VectorizationEmbeddingMetadata | null;
 /** Implements build vectorization embedding metadata for the public runtime surface of this module. */
-export declare function buildVectorizationEmbeddingMetadata(identity: VectorizationEmbeddingIdentity, vectorDimension: number): VectorizationEmbeddingMetadata;
+export declare function buildVectorizationEmbeddingMetadata(identity:VectorizationEmbeddingIdentity,vectorDimension:number):VectorizationEmbeddingMetadata;
 /** Implements check whether vectorization embedding identity changed for the public runtime surface of this module. */
-export declare function hasVectorizationEmbeddingIdentityChanged(metadata: VectorizationEmbeddingMetadata | null | undefined, identity: VectorizationEmbeddingIdentity): boolean;
+export declare function hasVectorizationEmbeddingIdentityChanged(metadata:VectorizationEmbeddingMetadata | null | undefined,identity:VectorizationEmbeddingIdentity):boolean;
 /** Implements check whether vectorization vector dimension changed for the public runtime surface of this module. */
-export declare function hasVectorizationVectorDimensionChanged(metadata: VectorizationEmbeddingMetadata | null | undefined, vectorDimension: number): boolean;
+export declare function hasVectorizationVectorDimensionChanged(metadata:VectorizationEmbeddingMetadata | null | undefined,vectorDimension:number):boolean;
 /** Implements infer consistent vector dimension for the public runtime surface of this module. */
-export declare function inferConsistentVectorDimension(vectors: readonly number[][], context: string): number;
+export declare function inferConsistentVectorDimension(vectors:readonly number[][],context:string):number;

package/dist/core/sentry/helpers.d.ts

@@ -1,20 +1,22 @@
 import { type TelemetryErrorCategory } from "../shared/constants.js";
-import { type TelemetryCommandResolution, type TelemetryResolutionStage } from "../telemetry/observability.js";
+import { type TelemetryCommandResolution,type TelemetryResolutionStage } from "../telemetry/observability.js";
 /** Implements sentry set command context for the public runtime surface of this module. */
-export declare function sentrySetCommandContext(command: string, args: string[], options: Record<string, unknown>, metadata?: {
-source_context?: string;
-source_context_source?: string;
-}): void;
+export declare function sentrySetCommandContext(command:string,args:string[],options:Record<string,unknown>,metadata?:{
+source_context?:string;
+source_context_source?:string;
+}):void;
 /** Implements sentry start command span for the public runtime surface of this module. */
-export declare function sentryStartCommandSpan(command: string): void;
+export declare function sentryStartCommandSpan(command:string):void;
+/** Clear the pending command span without ending it or submitting it for export. */
+export declare function sentryDiscardCommandSpan():void;
 /** Implements sentry finish command span for the public runtime surface of this module. */
-export declare function sentryFinishCommandSpan(ok: boolean, error?: string, metadata?: {
-error_code?: string;
-error_category?: TelemetryErrorCategory;
-exit_code?: number;
-command_resolution?: TelemetryCommandResolution;
-resolution_stage?: TelemetryResolutionStage;
-}): void;
+export declare function sentryFinishCommandSpan(ok:boolean,error?:string,metadata?:{
+error_code?:string;
+error_category?:TelemetryErrorCategory;
+exit_code?:number;
+command_resolution?:TelemetryCommandResolution;
+resolution_stage?:TelemetryResolutionStage;
+}):void;
 /**
  * Tag value recorded when a captured error declares no canonical pm error code.
  *
@@ -26,19 +28,19 @@ resolution_stage?: TelemetryResolutionStage;
  */
 export declare const UNCLASSIFIED_CAPTURED_ERROR_CODE = "unclassified_runtime_error";
 /** Implements sentry capture cli error for the public runtime surface of this module. */
-export declare function sentryCaptureCliError(error: unknown): void;
+export declare function sentryCaptureCliError(error:unknown):void;
 /** Implements sentry log cli usage error for the public runtime surface of this module. */
-export declare function sentryLogCliUsageError(params: {
-command: string;
-error_code: string;
-error_category: TelemetryErrorCategory;
-exit_code: number;
-error_message: string;
-command_resolution?: TelemetryCommandResolution;
-resolution_stage?: TelemetryResolutionStage;
-source_context?: string;
-}): void;
+export declare function sentryLogCliUsageError(params:{
+command:string;
+error_code:string;
+error_category:TelemetryErrorCategory;
+exit_code:number;
+error_message:string;
+command_resolution?:TelemetryCommandResolution;
+resolution_stage?:TelemetryResolutionStage;
+source_context?:string;
+}):void;
 /** Implements should capture cli error for the public runtime surface of this module. */
-export declare function shouldCaptureCliError(error: unknown): boolean;
+export declare function shouldCaptureCliError(error:unknown):boolean;
 /** Implements sentry flush for the public runtime surface of this module. */
-export declare function sentryFlush(timeoutMs?: number): Promise<void>;
+export declare function sentryFlush(timeoutMs?:number):Promise<void>;

package/dist/core/sentry/helpers.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ceaee876-c2c8-5b28-91ee-f670384fd559")}catch{}})();import{getSentry}from"./instrument.js";import{PmCliError}from"../shared/errors.js";import{EXIT_CODE}from"../shared/constants.js";import{deriveTelemetryCommandResolution,deriveTelemetryCommandTaxonomy}from"../telemetry/observability.js";let activeCommandSpan;function setSpanAttribute(span,key,value){if(value===void 0)return;const attributeTarget=span;typeof attributeTarget.setAttribute=="function"&&attributeTarget.setAttribute(key,value)}function setSentryTagIfPresent(Sentry,key,value){typeof value=="string"&&value.trim().length>0&&Sentry.setTag(key,value)}function setSentryCommandFinishTags(Sentry,normalizedOk,metadata){Sentry.setTag("pm.ok",normalizedOk),Sentry.setTag("pm.command_ok",normalizedOk),typeof metadata?.exit_code=="number"&&(Sentry.setTag("pm.exit_code",String(metadata.exit_code)),Sentry.setTag("pm.command_exit_code",String(metadata.exit_code))),setSentryTagIfPresent(Sentry,"pm.error_code",metadata?.error_code),setSentryTagIfPresent(Sentry,"pm.error_category",metadata?.error_category),setSentryTagIfPresent(Sentry,"pm.command_resolution",metadata?.command_resolution),setSentryTagIfPresent(Sentry,"pm.resolution_stage",metadata?.resolution_stage)}function setCommandSpanFinishAttributes(span,normalizedOk,normalizedExitCode,metadata){setSpanAttribute(span,"pm.ok",normalizedOk),setSpanAttribute(span,"pm.command_ok",normalizedOk),setSpanAttribute(span,"pm.exit_code",normalizedExitCode),setSpanAttribute(span,"pm.command_exit_code",normalizedExitCode),setSpanAttribute(span,"pm.error_code",metadata?.error_code),setSpanAttribute(span,"pm.error_category",metadata?.error_category),setSpanAttribute(span,"pm.command_resolution",metadata?.command_resolution),setSpanAttribute(span,"pm.resolution_stage",metadata?.resolution_stage)}function sentrySetCommandContext(command,args,options,metadata){const Sentry=getSentry();if(!Sentry)return;const taxonomy=deriveTelemetryCommandTaxonomy(command);Sentry.setTag("pm.command",command),Sentry.setTag("pm.command_root",taxonomy.command_root),Sentry.setTag("pm.command_family",taxonomy.command_family),typeof metadata?.source_context=="string"&&metadata.source_context.trim().length>0&&Sentry.setTag("pm.source_context",metadata.source_context);const safeArgs=args.map(arg=>arg.startsWith("--")?arg.split("=")[0]:arg);Sentry.setContext("pm.command",{name:command,root:taxonomy.command_root,leaf:taxonomy.command_leaf,family:taxonomy.command_family,args:safeArgs,option_keys:Object.keys(options).sort(),source_context:metadata?.source_context,source_context_source:metadata?.source_context_source}),Sentry.addBreadcrumb({category:"pm.command",message:`pm ${command}`,level:"info",data:{args:safeArgs,command_root:taxonomy.command_root,command_family:taxonomy.command_family,source_context:metadata?.source_context}})}function sentryStartCommandSpan(command){const Sentry=getSentry();Sentry&&(activeCommandSpan=Sentry.startInactiveSpan({op:"pm.command",name:`pm ${command}`,forceTransaction:!0}))}function sentryFinishCommandSpan(ok,error,metadata){if(!activeCommandSpan)return;const normalizedOk=ok?"true":"false",normalizedExitCode=typeof metadata?.exit_code=="number"?String(metadata.exit_code):void 0,Sentry=getSentry();Sentry&&setSentryCommandFinishTags(Sentry,normalizedOk,metadata),setCommandSpanFinishAttributes(activeCommandSpan,normalizedOk,normalizedExitCode,metadata),activeCommandSpan.setStatus(ok?{code:1}:{code:2,message:error??"command_failed"}),activeCommandSpan.end(),activeCommandSpan=void 0}const UNCLASSIFIED_CAPTURED_ERROR_CODE="unclassified_runtime_error";function readCapturedErrorContract(error){const candidate=typeof error=="object"&&error!==null?error:void 0,hasDeclaredExitCode=typeof candidate?.exitCode=="number",exitCode=hasDeclaredExitCode?Math.trunc(candidate?.exitCode):EXIT_CODE.GENERIC_FAILURE;return{error_code:typeof candidate?.code=="string"&&candidate.code.length>0&&hasDeclaredExitCode?candidate?.code:UNCLASSIFIED_CAPTURED_ERROR_CODE,exit_code:exitCode}}function buildCapturedErrorTags(error){const contract=readCapturedErrorContract(error);return{"pm.error_code":contract.error_code,"pm.exit_code":String(contract.exit_code)}}function sentryCaptureCliError(error){if(!shouldCaptureCliError(error))return;const Sentry=getSentry();if(!Sentry)return;const tags=buildCapturedErrorTags(error);if(error instanceof Error){const extras={};"exitCode"in error&&typeof error.exitCode=="number"&&(extras.exit_code=error.exitCode),"context"in error&&typeof error.context=="object"&&(extras.error_context=error.context),Sentry.captureException(error,{extra:extras,tags})}else Sentry.captureException(new Error(String(error)),{tags})}function sentryLogCliUsageError(params){const Sentry=getSentry();if(!Sentry)return;const resolvedCommandResolution=params.command_resolution??deriveTelemetryCommandResolution({ok:!1,errorCode:params.error_code,errorCategory:params.error_category}),resolvedResolutionStage=params.resolution_stage??"unknown",payload={"pm.command":params.command,"pm.error_code":params.error_code,"pm.error_category":params.error_category,"pm.exit_code":params.exit_code,"pm.error_message":params.error_message,"pm.command_resolution":resolvedCommandResolution,"pm.resolution_stage":resolvedResolutionStage,"pm.source_context":params.source_context??""},loggerCandidate=Sentry.logger;if(loggerCandidate&&typeof loggerCandidate.warn=="function"){loggerCandidate.warn("pm_cli_usage_error",payload);return}Sentry.captureMessage(`pm_cli_usage_error:${params.error_code}`,{level:"warning",tags:{"pm.command":params.command,"pm.error_code":params.error_code,"pm.error_category":params.error_category,"pm.exit_code":String(params.exit_code),"pm.command_resolution":resolvedCommandResolution,"pm.resolution_stage":resolvedResolutionStage,"pm.source_context":params.source_context??"unknown"},extra:payload})}function shouldCaptureCliError(error){if(error instanceof PmCliError||error instanceof Error&&error.name==="AbortError"&&/(?:ctrl\+[cd]|sigint|user[- ]initiated)/i.test(error.message))return!1;if(typeof error=="object"&&error!==null&&"exitCode"in error&&typeof error.exitCode=="number"){if(error instanceof Error&&error.name==="CommandError")return!1;const exitCode=Math.trunc(error.exitCode);return!new Set([EXIT_CODE.SUCCESS,EXIT_CODE.USAGE,EXIT_CODE.NOT_FOUND,EXIT_CODE.CONFLICT]).has(exitCode)}return!0}async function sentryFlush(timeoutMs=3e3){const Sentry=getSentry();if(Sentry)try{await Sentry.flush(timeoutMs)}catch{}}export{UNCLASSIFIED_CAPTURED_ERROR_CODE,sentryCaptureCliError,sentryFinishCommandSpan,sentryFlush,sentryLogCliUsageError,sentrySetCommandContext,sentryStartCommandSpan,shouldCaptureCliError};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0d9d54cd-bd42-5958-83df-15316ea520c7")}catch{}})();import{getSentry}from"./instrument.js";import{PmCliError}from"../shared/errors.js";import{EXIT_CODE}from"../shared/constants.js";import{deriveTelemetryCommandResolution,deriveTelemetryCommandTaxonomy}from"../telemetry/observability.js";let activeCommandSpan;function setSpanAttribute(span,key,value){if(value===void 0)return;const attributeTarget=span;typeof attributeTarget.setAttribute=="function"&&attributeTarget.setAttribute(key,value)}function setSentryTagIfPresent(Sentry,key,value){typeof value=="string"&&value.trim().length>0&&Sentry.setTag(key,value)}function setSentryCommandFinishTags(Sentry,normalizedOk,metadata){Sentry.setTag("pm.ok",normalizedOk),Sentry.setTag("pm.command_ok",normalizedOk),typeof metadata?.exit_code=="number"&&(Sentry.setTag("pm.exit_code",String(metadata.exit_code)),Sentry.setTag("pm.command_exit_code",String(metadata.exit_code))),setSentryTagIfPresent(Sentry,"pm.error_code",metadata?.error_code),setSentryTagIfPresent(Sentry,"pm.error_category",metadata?.error_category),setSentryTagIfPresent(Sentry,"pm.command_resolution",metadata?.command_resolution),setSentryTagIfPresent(Sentry,"pm.resolution_stage",metadata?.resolution_stage)}function setCommandSpanFinishAttributes(span,normalizedOk,normalizedExitCode,metadata){setSpanAttribute(span,"pm.ok",normalizedOk),setSpanAttribute(span,"pm.command_ok",normalizedOk),setSpanAttribute(span,"pm.exit_code",normalizedExitCode),setSpanAttribute(span,"pm.command_exit_code",normalizedExitCode),setSpanAttribute(span,"pm.error_code",metadata?.error_code),setSpanAttribute(span,"pm.error_category",metadata?.error_category),setSpanAttribute(span,"pm.command_resolution",metadata?.command_resolution),setSpanAttribute(span,"pm.resolution_stage",metadata?.resolution_stage)}function sentrySetCommandContext(command,args,options,metadata){const Sentry=getSentry();if(!Sentry)return;const taxonomy=deriveTelemetryCommandTaxonomy(command);Sentry.setTag("pm.command",command),Sentry.setTag("pm.command_root",taxonomy.command_root),Sentry.setTag("pm.command_family",taxonomy.command_family),typeof metadata?.source_context=="string"&&metadata.source_context.trim().length>0&&Sentry.setTag("pm.source_context",metadata.source_context);const safeArgs=args.map(()=>"[redacted]");Sentry.setContext("pm.command",{name:command,root:taxonomy.command_root,leaf:taxonomy.command_leaf,family:taxonomy.command_family,args:safeArgs,option_keys:Object.keys(options).sort(),source_context:metadata?.source_context,source_context_source:metadata?.source_context_source}),Sentry.addBreadcrumb({category:"pm.command",message:`pm ${command}`,level:"info",data:{args:safeArgs,command_root:taxonomy.command_root,command_family:taxonomy.command_family,source_context:metadata?.source_context}})}function sentryStartCommandSpan(command){const Sentry=getSentry();if(!Sentry)return;const taxonomy=deriveTelemetryCommandTaxonomy(command);activeCommandSpan=Sentry.startInactiveSpan({op:"pm.command",name:`pm ${command}`,forceTransaction:!0,attributes:{"pm.command":command,"pm.command_root":taxonomy.command_root,"pm.command_family":taxonomy.command_family}})}function sentryDiscardCommandSpan(){activeCommandSpan=void 0}function sentryFinishCommandSpan(ok,error,metadata){if(!activeCommandSpan)return;const normalizedOk=ok?"true":"false",normalizedExitCode=typeof metadata?.exit_code=="number"?String(metadata.exit_code):void 0,Sentry=getSentry();Sentry&&setSentryCommandFinishTags(Sentry,normalizedOk,metadata),setCommandSpanFinishAttributes(activeCommandSpan,normalizedOk,normalizedExitCode,metadata),activeCommandSpan.setStatus(ok?{code:1}:{code:2,message:error??"command_failed"}),activeCommandSpan.end(),activeCommandSpan=void 0}const UNCLASSIFIED_CAPTURED_ERROR_CODE="unclassified_runtime_error";function readCapturedErrorContract(error){const candidate=typeof error=="object"&&error!==null?error:void 0,hasDeclaredExitCode=typeof candidate?.exitCode=="number",exitCode=hasDeclaredExitCode?Math.trunc(candidate?.exitCode):EXIT_CODE.GENERIC_FAILURE;return{error_code:typeof candidate?.code=="string"&&candidate.code.length>0&&hasDeclaredExitCode?candidate?.code:UNCLASSIFIED_CAPTURED_ERROR_CODE,exit_code:exitCode}}function buildCapturedErrorTags(error){const contract=readCapturedErrorContract(error);return{"pm.error_code":contract.error_code,"pm.exit_code":String(contract.exit_code)}}function sentryCaptureCliError(error){if(!shouldCaptureCliError(error))return;const Sentry=getSentry();if(!Sentry)return;const tags=buildCapturedErrorTags(error);if(error instanceof Error){const extras={};"exitCode"in error&&typeof error.exitCode=="number"&&(extras.exit_code=error.exitCode),"context"in error&&typeof error.context=="object"&&(extras.error_context=error.context),Sentry.captureException(error,{extra:extras,tags})}else Sentry.captureException(new Error(String(error)),{tags})}function sentryLogCliUsageError(params){const Sentry=getSentry();if(!Sentry)return;const resolvedCommandResolution=params.command_resolution??deriveTelemetryCommandResolution({ok:!1,errorCode:params.error_code,errorCategory:params.error_category}),resolvedResolutionStage=params.resolution_stage??"unknown",payload={"pm.command":params.command,"pm.error_code":params.error_code,"pm.error_category":params.error_category,"pm.exit_code":params.exit_code,"pm.error_message":params.error_message,"pm.command_resolution":resolvedCommandResolution,"pm.resolution_stage":resolvedResolutionStage,"pm.source_context":params.source_context??""},loggerCandidate=Sentry.logger;if(loggerCandidate&&typeof loggerCandidate.warn=="function"){loggerCandidate.warn("pm_cli_usage_error",payload);return}Sentry.captureMessage(`pm_cli_usage_error:${params.error_code}`,{level:"warning",tags:{"pm.command":params.command,"pm.error_code":params.error_code,"pm.error_category":params.error_category,"pm.exit_code":String(params.exit_code),"pm.command_resolution":resolvedCommandResolution,"pm.resolution_stage":resolvedResolutionStage,"pm.source_context":params.source_context??"unknown"},extra:payload})}function shouldCaptureCliError(error){if(error instanceof PmCliError||error instanceof Error&&error.name==="AbortError"&&/(?:ctrl\+[cd]|sigint|user[- ]initiated)/i.test(error.message))return!1;if(typeof error=="object"&&error!==null&&"exitCode"in error&&typeof error.exitCode=="number"){if(error instanceof Error&&error.name==="CommandError")return!1;const exitCode=Math.trunc(error.exitCode);return!new Set([EXIT_CODE.SUCCESS,EXIT_CODE.USAGE,EXIT_CODE.NOT_FOUND,EXIT_CODE.CONFLICT]).has(exitCode)}return!0}async function sentryFlush(timeoutMs=3e3){const Sentry=getSentry();if(Sentry)try{await Sentry.flush(timeoutMs)}catch{}}export{UNCLASSIFIED_CAPTURED_ERROR_CODE,sentryCaptureCliError,sentryDiscardCommandSpan,sentryFinishCommandSpan,sentryFlush,sentryLogCliUsageError,sentrySetCommandContext,sentryStartCommandSpan,shouldCaptureCliError};
 //# sourceMappingURL=helpers.js.map