@unbrained/pm-cli 2026.10.13 → 2026.10.15

package/dist/core/store/settings-validator.d.ts

@@ -1,176 +1,176 @@
-import type { AgentGuidanceSettings, ExtensionPolicySettings, GovernanceSettings, ItemTypeDefinition, PmSettings, RuntimeSchemaSettings } from "../../types.js";
+import type { AgentGuidanceSettings,ExtensionPolicySettings,GovernanceSettings,ItemTypeDefinition,PmSettings,RuntimeSchemaSettings } from "../../types.js";
 import type { PmMaxVersionExceededModeSetting } from "../extensions/extension-types.js";
 /** Validated, unknown-key-stripped settings input (pre-merge), matching the legacy zod inference. */
 export interface ParsedSettings {
 /** Value that configures or reports version for this contract. */
-version: number;
+version:number;
 /** Value that configures or reports id prefix for this contract. */
-id_prefix: string;
+id_prefix:string;
 /** Item id allocation policy (random base36 token length appended to the prefix). */
-ids?: {
-token_length?: number;
+ids?:{
+token_length?:number;
 };
 /** Value that configures or reports author default for this contract. */
-author_default: string;
+author_default:string;
 /** Declarative workspace additions to agent identity detection. */
-agent_identity?: PmSettings["agent_identity"];
+agent_identity?:PmSettings["agent_identity"];
 /** Shared pre-write mutation guard policy. */
-mutation_guard?: {
-require_attributed_author?: boolean;
-secret_guard?: "off" | "advise" | "block";
-stale_in_progress_hours?: number;
+mutation_guard?:{
+require_attributed_author?:boolean;
+secret_guard?:"off" | "advise" | "block";
+stale_in_progress_hours?:number;
 };
 /** Value that configures or reports item format for this contract. */
-item_format?: "toon" | "json_markdown";
+item_format?:"toon" | "json_markdown";
 /** Value that configures or reports locks for this contract. */
-locks: {
-ttl_seconds: number;
-wait_ms?: number;
+locks:{
+ttl_seconds:number;
+wait_ms?:number;
 };
 /** Value that configures or reports checkpoints for this contract. */
-checkpoints?: {
-retention_days?: number;
+checkpoints?:{
+retention_days?:number;
 };
 /** Value that configures or reports output for this contract. */
-output: {
-default_format: "toon" | "json";
+output:{
+default_format:"toon" | "json";
 };
 /** Agent and human interaction preferences. */
-ux?: {
-deprecation_hints?: boolean;
+ux?:{
+deprecation_hints?:boolean;
 };
 /** Value that configures or reports history for this contract. */
-history?: {
-missing_stream: "auto_create" | "strict_error";
-compact_policy?: {
-enabled?: boolean;
-max_entries?: number;
-trigger?: "health_warn" | "auto";
+history?:{
+missing_stream:"auto_create" | "strict_error";
+compact_policy?:{
+enabled?:boolean;
+max_entries?:number;
+trigger?:"health_warn" | "auto";
 };
 };
 /** Value that configures or reports validation for this contract. */
-validation?: {
-sprint_release_format: "warn" | "strict_error";
-parent_reference?: "warn" | "strict_error";
-metadata_profile?: "core" | "strict" | "custom";
-metadata_required_fields?: string[];
-lifecycle_stale_blocker_reason_patterns?: string[];
-lifecycle_closure_like_blocked_reason_patterns?: string[];
-lifecycle_closure_like_resolution_patterns?: string[];
-lifecycle_closure_like_actual_result_patterns?: string[];
-estimate_defaults_by_type?: Record<string, number>;
+validation?:{
+sprint_release_format:"warn" | "strict_error";
+parent_reference?:"warn" | "strict_error";
+metadata_profile?:"core" | "strict" | "custom";
+metadata_required_fields?:string[];
+lifecycle_stale_blocker_reason_patterns?:string[];
+lifecycle_closure_like_blocked_reason_patterns?:string[];
+lifecycle_closure_like_resolution_patterns?:string[];
+lifecycle_closure_like_actual_result_patterns?:string[];
+estimate_defaults_by_type?:Record<string,number>;
 };
 /** Value that configures or reports governance for this contract. */
-governance?: Partial<GovernanceSettings>;
+governance?:Partial<GovernanceSettings>;
 /** Value that configures or reports workflow for this contract. */
-workflow?: {
-definition_of_done: string[];
+workflow?:{
+definition_of_done:string[];
 };
 /** Value that configures or reports testing for this contract. */
-testing?: {
-record_results_to_items: boolean;
-allow_untrusted_linked_tests?: boolean;
+testing?:{
+record_results_to_items:boolean;
+allow_untrusted_linked_tests?:boolean;
 };
 /** Value that configures or reports telemetry for this contract. */
-telemetry?: {
-enabled: boolean;
-first_run_prompt_completed?: boolean;
-capture_level?: "minimal" | "redacted" | "max";
-endpoint?: string;
-installation_id?: string;
-retention_days?: number;
+telemetry?:{
+enabled:boolean;
+first_run_prompt_completed?:boolean;
+capture_level?:"minimal" | "redacted" | "max";
+endpoint?:string;
+installation_id?:string;
+retention_days?:number;
 };
 /** Value that configures or reports agent guidance for this contract. */
-agent_guidance?: Partial<AgentGuidanceSettings>;
+agent_guidance?:Partial<AgentGuidanceSettings>;
 /** Value that configures or reports item types for this contract. */
-item_types?: {
-definitions: ItemTypeDefinition[];
+item_types?:{
+definitions:ItemTypeDefinition[];
 };
 /** Value that configures or reports schema for this contract. */
-schema?: Partial<RuntimeSchemaSettings>;
+schema?:Partial<RuntimeSchemaSettings>;
 /** Value that configures or reports context for this contract. */
-context?: {
-default_depth?: "brief" | "standard" | "deep";
-activity_limit?: number;
-stale_threshold_days?: number;
-sections?: {
-hierarchy?: boolean;
-activity?: boolean;
-progress?: boolean;
-blockers?: boolean;
-files?: boolean;
-workload?: boolean;
-staleness?: boolean;
-tests?: boolean;
+context?:{
+default_depth?:"brief" | "standard" | "deep";
+activity_limit?:number;
+stale_threshold_days?:number;
+sections?:{
+hierarchy?:boolean;
+activity?:boolean;
+progress?:boolean;
+blockers?:boolean;
+files?:boolean;
+workload?:boolean;
+staleness?:boolean;
+tests?:boolean;
 };
 };
 /** Value that configures or reports extensions for this contract. */
-extensions: {
-enabled: string[];
-disabled: string[];
-policy?: Partial<ExtensionPolicySettings> & {
-pm_max_version_exceeded_mode?: PmMaxVersionExceededModeSetting;
+extensions:{
+enabled:string[];
+disabled:string[];
+policy?:Partial<ExtensionPolicySettings> & {
+pm_max_version_exceeded_mode?:PmMaxVersionExceededModeSetting;
 };
 };
 /** Value that configures or reports search for this contract. */
-search: {
-score_threshold: number;
-hybrid_semantic_weight?: number;
-max_results: number;
-embedding_model: string;
-embedding_corpus_max_characters?: number;
-embedding_batch_size: number;
-embedding_timeout_ms?: number;
-scanner_max_batch_retries: number;
-provider?: string;
-default_mode?: "auto" | "keyword" | "semantic" | "hybrid";
-corpus_fields?: string[];
-mutation_refresh_policy?: "cache_only" | "semantic_configured" | "semantic_auto";
-query_expansion?: {
-enabled?: boolean;
-provider?: string;
-};
-rerank?: {
-enabled?: boolean;
-model?: string;
-top_k?: number;
-};
-bm25?: {
-k1?: number;
-b?: number;
+search:{
+score_threshold:number;
+hybrid_semantic_weight?:number;
+max_results:number;
+embedding_model:string;
+embedding_corpus_max_characters?:number;
+embedding_batch_size:number;
+embedding_timeout_ms?:number;
+scanner_max_batch_retries:number;
+provider?:string;
+default_mode?:"auto" | "keyword" | "semantic" | "hybrid";
+corpus_fields?:string[];
+mutation_refresh_policy?:"cache_only" | "semantic_configured" | "semantic_auto";
+query_expansion?:{
+enabled?:boolean;
+provider?:string;
+};
+rerank?:{
+enabled?:boolean;
+model?:string;
+top_k?:number;
+};
+bm25?:{
+k1?:number;
+b?:number;
 };
 };
 /** Value that configures or reports providers for this contract. */
-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;
 };
 };
 /** Value that configures or reports vector store for this contract. */
-vector_store: {
-adapter?: string;
-collection_name?: string;
-qdrant: {
-url: string;
-api_key: string;
+vector_store:{
+adapter?:string;
+collection_name?:string;
+qdrant:{
+url:string;
+api_key:string;
 };
-lancedb: {
-path: string;
+lancedb:{
+path:string;
 };
 };
 }
 /** Restricts settings validation result values accepted by command, SDK, and storage contracts. */
 export type SettingsValidationResult = {
-success: true;
-data: ParsedSettings;
+success:true;
+data:ParsedSettings;
 } | {
-success: false;
+success:false;
 };
 /** Validate raw settings, returning stripped, type-checked data or failure (matching the legacy zod safeParse). */
-export declare function validateSettings(raw: unknown): SettingsValidationResult;
+export declare function validateSettings(raw:unknown):SettingsValidationResult;

package/dist/core/store/settings.d.ts

@@ -1,7 +1,7 @@
 import { type ParsedSettings } from "./settings-validator.js";
 import { collectSettingsReadCacheSignatures } from "./settings-read-cache.js";
-import type { ExtensionGovernancePolicy, PmMaxVersionExceededModeSetting } from "../extensions/extension-types.js";
-import type { ExtensionSandboxProfile, ExtensionPolicyMode, ExtensionPolicyOverrideSettings, ExtensionTrustMode, GovernanceSettings, ItemTypeDefinition, PmSettings, ValidateMetadataRequiredField } from "../../types/index.js";
+import type { ExtensionGovernancePolicy,PmMaxVersionExceededModeSetting } from "../extensions/extension-types.js";
+import type { ExtensionSandboxProfile,ExtensionPolicyMode,ExtensionPolicyOverrideSettings,ExtensionTrustMode,GovernanceSettings,ItemTypeDefinition,PmSettings,ValidateMetadataRequiredField } from "../../types/index.js";
 /**
  * Scope bootstrap reads to validated inline base settings for the selected
  * source tracker and its resolved root alias. These reads execute no hooks,
@@ -14,128 +14,128 @@ import type { ExtensionSandboxProfile, ExtensionPolicyMode, ExtensionPolicyOverr
  * same root; hosts can settle conservative parser decisions without changing
  * a caller's policy or another invocation.
  */
-export declare function runWithConfigurationOnlySettings<T>(pmRoot: string, run: () => Promise<T>, isEnabled?: () => boolean): Promise<T>;
+export declare function runWithConfigurationOnlySettings<T>(pmRoot:string,run:() => Promise<T>,isEnabled?:() => boolean):Promise<T>;
 /** Report whether this tracker belongs to the current configuration-only source preparation scope. */
-export declare function isConfigurationOnlySettingsRead(pmRoot: string): boolean;
+export declare function isConfigurationOnlySettingsRead(pmRoot:string):boolean;
 interface SettingsPersistSourceSnapshot {
 /** Last sparse state proposed by this instance, independent of peer edits. */
-persisted_settings: unknown;
-source_settings: ParsedSettings;
-has_source_item_type_definitions: boolean;
-source_item_type_definitions: ItemTypeDefinition[];
-has_source_schema_statuses: boolean;
-source_schema_statuses: PmSettings["schema"]["statuses"];
-has_source_schema_fields: boolean;
-source_schema_fields: PmSettings["schema"]["fields"];
-has_source_schema_type_workflows: boolean;
-source_schema_type_workflows: NonNullable<PmSettings["schema"]["type_workflows"]>;
-runtime_item_type_definitions: ItemTypeDefinition[];
-runtime_schema_statuses: PmSettings["schema"]["statuses"];
-runtime_schema_fields: PmSettings["schema"]["fields"];
-runtime_schema_type_workflows: NonNullable<PmSettings["schema"]["type_workflows"]>;
+persisted_settings:unknown;
+source_settings:ParsedSettings;
+has_source_item_type_definitions:boolean;
+source_item_type_definitions:ItemTypeDefinition[];
+has_source_schema_statuses:boolean;
+source_schema_statuses:PmSettings["schema"]["statuses"];
+has_source_schema_fields:boolean;
+source_schema_fields:PmSettings["schema"]["fields"];
+has_source_schema_type_workflows:boolean;
+source_schema_type_workflows:NonNullable<PmSettings["schema"]["type_workflows"]>;
+runtime_item_type_definitions:ItemTypeDefinition[];
+runtime_schema_statuses:PmSettings["schema"]["statuses"];
+runtime_schema_fields:PmSettings["schema"]["fields"];
+runtime_schema_type_workflows:NonNullable<PmSettings["schema"]["type_workflows"]>;
 }
 interface SerializeSettingsOptions {
 /** Ordinary writer snapshot, including file-backed schema boundaries. */
-persist_source?: SettingsPersistSourceSnapshot;
+persist_source?:SettingsPersistSourceSnapshot;
 /** Paired views of one locked inline source, without schema hydration. */
-source?: {
+source?:{
 /** Parsed original JSON whose sparse omissions and future fields survive known-value edits. */
-raw: unknown;
+raw:unknown;
 /** Validated projection of the same original JSON, used for the canonical delta baseline. */
-validated: ParsedSettings;
+validated:ParsedSettings;
 };
 }
 /** Documents the settings read metadata payload exchanged by command, SDK, and package integrations. */
 export interface SettingsReadMetadata {
 /** Whether explicit item format applies to this operation. */
-has_explicit_item_format: boolean;
+has_explicit_item_format:boolean;
 }
 /** Documents the settings read result payload exchanged by command, SDK, and package integrations. */
 export interface SettingsReadResult {
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
+settings:PmSettings;
 /** Value that configures or reports metadata for this contract. */
-metadata: SettingsReadMetadata;
+metadata:SettingsReadMetadata;
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 }
 /** Implements resolve governance knobs for the public runtime surface of this module. */
-export declare function resolveGovernanceKnobs(settings: Pick<PmSettings, "governance"> | {
-governance?: Partial<GovernanceSettings>;
-}): GovernanceSettings;
-declare function buildSettingsPersistSourceSnapshot(parsedSettings: ParsedSettings, runtimeSettings: PmSettings): SettingsPersistSourceSnapshot;
+export declare function resolveGovernanceKnobs(settings:Pick<PmSettings,"governance"> | {
+governance?:Partial<GovernanceSettings>;
+}):GovernanceSettings;
+declare function buildSettingsPersistSourceSnapshot(parsedSettings:ParsedSettings,runtimeSettings:PmSettings):SettingsPersistSourceSnapshot;
 /**
  * Mark the runtime-selected item format as intentional persisted state while
  * preserving every other default-backed setting as a sparse omission.
  */
-export declare function persistSelectedItemFormat(settings: PmSettings): void;
-declare function resolveSettingsReadTrackedPaths(pmRoot: string, schema: PmSettings["schema"], settingsPath: string): string[];
-declare function cacheSettingsReadResultSafe(pmRoot: string, trackedPaths: string[], result: SettingsReadResult): Promise<void>;
+export declare function persistSelectedItemFormat(settings:PmSettings):void;
+declare function resolveSettingsReadTrackedPaths(pmRoot:string,schema:PmSettings["schema"],settingsPath:string):string[];
+declare function cacheSettingsReadResultSafe(pmRoot:string,trackedPaths:string[],result:SettingsReadResult):Promise<void>;
 type SettingsReadCacheSignatures = Awaited<ReturnType<typeof collectSettingsReadCacheSignatures>>;
-declare function selectedSettingsReadCacheSignaturesEqual(before: SettingsReadCacheSignatures, after: SettingsReadCacheSignatures, targetPaths: string[]): boolean;
-declare function cacheSettingsReadResultIfStable(pmRoot: string, trackedPaths: string[], result: SettingsReadResult, stableSignatures: SettingsReadCacheSignatures, stablePaths: string[]): Promise<void>;
-declare function resolvePersistedFileBackedSchemaSections(settings: PmSettings, source: SettingsPersistSourceSnapshot | undefined): {
-item_type_definitions: ItemTypeDefinition[];
-schema_statuses: PmSettings["schema"]["statuses"];
-schema_fields: PmSettings["schema"]["fields"];
-schema_type_workflows: PmSettings["schema"]["type_workflows"];
+declare function selectedSettingsReadCacheSignaturesEqual(before:SettingsReadCacheSignatures,after:SettingsReadCacheSignatures,targetPaths:string[]):boolean;
+declare function cacheSettingsReadResultIfStable(pmRoot:string,trackedPaths:string[],result:SettingsReadResult,stableSignatures:SettingsReadCacheSignatures,stablePaths:string[]):Promise<void>;
+declare function resolvePersistedFileBackedSchemaSections(settings:PmSettings,source:SettingsPersistSourceSnapshot | undefined):{
+item_type_definitions:ItemTypeDefinition[];
+schema_statuses:PmSettings["schema"]["statuses"];
+schema_fields:PmSettings["schema"]["fields"];
+schema_type_workflows:PmSettings["schema"]["type_workflows"];
 };
-declare function hasExplicitItemFormat(raw: unknown): boolean;
-declare function normalizeStringList(values: string[] | undefined): string[];
-declare function normalizeLowerStringList(values: string[] | undefined): string[];
-declare function normalizeExtensionPolicyMode(value: ExtensionPolicyMode | undefined): ExtensionPolicyMode;
-declare function normalizeExtensionTrustMode(value: ExtensionTrustMode | undefined): ExtensionTrustMode;
-declare function normalizeExtensionSandboxProfile(value: ExtensionSandboxProfile | undefined): ExtensionSandboxProfile;
-declare function normalizeExtensionPolicyOverride(override: ExtensionPolicyOverrideSettings): ExtensionPolicyOverrideSettings | null;
-declare function normalizeExtensionPolicyOverrides(overrides: ExtensionPolicyOverrideSettings[] | undefined): ExtensionPolicyOverrideSettings[];
+declare function hasExplicitItemFormat(raw:unknown):boolean;
+declare function normalizeStringList(values:string[] | undefined):string[];
+declare function normalizeLowerStringList(values:string[] | undefined):string[];
+declare function normalizeExtensionPolicyMode(value:ExtensionPolicyMode | undefined):ExtensionPolicyMode;
+declare function normalizeExtensionTrustMode(value:ExtensionTrustMode | undefined):ExtensionTrustMode;
+declare function normalizeExtensionSandboxProfile(value:ExtensionSandboxProfile | undefined):ExtensionSandboxProfile;
+declare function normalizeExtensionPolicyOverride(override:ExtensionPolicyOverrideSettings):ExtensionPolicyOverrideSettings | null;
+declare function normalizeExtensionPolicyOverrides(overrides:ExtensionPolicyOverrideSettings[] | undefined):ExtensionPolicyOverrideSettings[];
 /** Preserve a configured `pm_max_version_exceeded_mode` (string mode or per-layer override object) through settings normalization. Unset/invalid values are omitted so existing settings.json files round-trip byte-identically and the loader applies its safe default ("block"). */
-declare function normalizePmMaxVersionExceededModeSetting(value: PmMaxVersionExceededModeSetting | undefined): PmMaxVersionExceededModeSetting | undefined;
-declare function normalizeExtensionPolicySettings(policy: Partial<ExtensionGovernancePolicy> | undefined): ExtensionGovernancePolicy;
-declare function normalizeValidationMetadataRequiredFields(values: string[] | undefined): ValidateMetadataRequiredField[];
-declare function normalizeValidationPatternList(values: string[] | undefined): string[];
-declare function valueOrDefault<T>(value: T | undefined, fallback: T): T;
-declare function arrayOrEmpty<T>(value: unknown): T[];
+declare function normalizePmMaxVersionExceededModeSetting(value:PmMaxVersionExceededModeSetting | undefined):PmMaxVersionExceededModeSetting | undefined;
+declare function normalizeExtensionPolicySettings(policy:Partial<ExtensionGovernancePolicy> | undefined):ExtensionGovernancePolicy;
+declare function normalizeValidationMetadataRequiredFields(values:string[] | undefined):ValidateMetadataRequiredField[];
+declare function normalizeValidationPatternList(values:string[] | undefined):string[];
+declare function valueOrDefault<T>(value:T | undefined,fallback:T):T;
+declare function arrayOrEmpty<T>(value:unknown):T[];
 /** Implements normalize item type definitions for the public runtime surface of this module. */
-export declare function normalizeItemTypeDefinitions(definitions: ItemTypeDefinition[] | undefined): ItemTypeDefinition[];
+export declare function normalizeItemTypeDefinitions(definitions:ItemTypeDefinition[] | undefined):ItemTypeDefinition[];
 /** Resolve validated inline settings using the shared defaults and preset rules, without filesystem reads or schema hydration. */
-export declare function mergeSettings(settings: ParsedSettings): PmSettings;
-declare function applySettingsDelta(target: Record<string, unknown>, baseline: Record<string, unknown>, current: Record<string, unknown>): void;
+export declare function mergeSettings(settings:ParsedSettings):PmSettings;
+declare function applySettingsDelta(target:Record<string,unknown>,baseline:Record<string,unknown>,current:Record<string,unknown>):void;
 /** Canonicalize settings, optionally applying only known-value changes to a captured sparse source. */
-export declare function serializeSettings(settings: PmSettings, options?: SerializeSettingsOptions): string;
+export declare function serializeSettings(settings:PmSettings,options?:SerializeSettingsOptions):string;
 /** Implements read settings with metadata for the public runtime surface of this module. */
-export declare function readSettingsWithMetadata(pmRoot: string): Promise<SettingsReadResult>;
+export declare function readSettingsWithMetadata(pmRoot:string):Promise<SettingsReadResult>;
 /** Implements read settings for the public runtime surface of this module. */
-export declare function readSettings(pmRoot: string): Promise<PmSettings>;
+export declare function readSettings(pmRoot:string):Promise<PmSettings>;
 /**
  * Persist edits to a readSettings snapshot under the workspace-history lock.
  * Disjoint concurrent edits survive; overlapping stale edits fail before any
  * write. Caller-constructed settings without a read snapshot replace the whole
  * document. History append failures compensate the document before unlocking.
  */
-export declare function writeSettings(pmRoot: string, settings: PmSettings, op?: string): Promise<void>;
+export declare function writeSettings(pmRoot:string,settings:PmSettings,op?:string):Promise<void>;
 /** Public contract for settings store test only, shared by SDK and presentation-layer consumers. */
-export declare const settingsStoreTestOnly: {
-applySettingsDelta: typeof applySettingsDelta;
-hasExplicitItemFormat: typeof hasExplicitItemFormat;
-buildSettingsPersistSourceSnapshot: typeof buildSettingsPersistSourceSnapshot;
-cacheSettingsReadResultIfStable: typeof cacheSettingsReadResultIfStable;
-cacheSettingsReadResultSafe: typeof cacheSettingsReadResultSafe;
-mergeSettings: typeof mergeSettings;
-normalizeExtensionPolicySettings: typeof normalizeExtensionPolicySettings;
-normalizeExtensionPolicyOverride: typeof normalizeExtensionPolicyOverride;
-normalizeExtensionPolicyOverrides: typeof normalizeExtensionPolicyOverrides;
-normalizeExtensionPolicyMode: typeof normalizeExtensionPolicyMode;
-normalizePmMaxVersionExceededModeSetting: typeof normalizePmMaxVersionExceededModeSetting;
-normalizeExtensionSandboxProfile: typeof normalizeExtensionSandboxProfile;
-normalizeExtensionTrustMode: typeof normalizeExtensionTrustMode;
-normalizeLowerStringList: typeof normalizeLowerStringList;
-normalizeStringList: typeof normalizeStringList;
-valueOrDefault: typeof valueOrDefault;
-arrayOrEmpty: typeof arrayOrEmpty;
-normalizeValidationPatternList: typeof normalizeValidationPatternList;
-normalizeValidationMetadataRequiredFields: typeof normalizeValidationMetadataRequiredFields;
-resolveSettingsReadTrackedPaths: typeof resolveSettingsReadTrackedPaths;
-resolvePersistedFileBackedSchemaSections: typeof resolvePersistedFileBackedSchemaSections;
-selectedSettingsReadCacheSignaturesEqual: typeof selectedSettingsReadCacheSignaturesEqual;
+export declare const settingsStoreTestOnly:{
+applySettingsDelta:typeof applySettingsDelta;
+hasExplicitItemFormat:typeof hasExplicitItemFormat;
+buildSettingsPersistSourceSnapshot:typeof buildSettingsPersistSourceSnapshot;
+cacheSettingsReadResultIfStable:typeof cacheSettingsReadResultIfStable;
+cacheSettingsReadResultSafe:typeof cacheSettingsReadResultSafe;
+mergeSettings:typeof mergeSettings;
+normalizeExtensionPolicySettings:typeof normalizeExtensionPolicySettings;
+normalizeExtensionPolicyOverride:typeof normalizeExtensionPolicyOverride;
+normalizeExtensionPolicyOverrides:typeof normalizeExtensionPolicyOverrides;
+normalizeExtensionPolicyMode:typeof normalizeExtensionPolicyMode;
+normalizePmMaxVersionExceededModeSetting:typeof normalizePmMaxVersionExceededModeSetting;
+normalizeExtensionSandboxProfile:typeof normalizeExtensionSandboxProfile;
+normalizeExtensionTrustMode:typeof normalizeExtensionTrustMode;
+normalizeLowerStringList:typeof normalizeLowerStringList;
+normalizeStringList:typeof normalizeStringList;
+valueOrDefault:typeof valueOrDefault;
+arrayOrEmpty:typeof arrayOrEmpty;
+normalizeValidationPatternList:typeof normalizeValidationPatternList;
+normalizeValidationMetadataRequiredFields:typeof normalizeValidationMetadataRequiredFields;
+resolveSettingsReadTrackedPaths:typeof resolveSettingsReadTrackedPaths;
+resolvePersistedFileBackedSchemaSections:typeof resolvePersistedFileBackedSchemaSections;
+selectedSettingsReadCacheSignaturesEqual:typeof selectedSettingsReadCacheSignaturesEqual;
 };
 export {};

package/dist/core/store/sqlite-runtime.d.ts

@@ -10,6 +10,6 @@ import type { DatabaseSync } from "node:sqlite";
  * that call. Restore the prior emitter even when the optional module is absent.
  * The caller still receives every other warning with its original arguments.
  */
-export declare function loadDatabaseSync(loadModule: (specifier: string) => unknown): typeof DatabaseSync | null;
+export declare function loadDatabaseSync(loadModule:(specifier:string) => unknown):typeof DatabaseSync | null;
 /** Skip native probing on runtimes below the supported SQLite capability floor. */
-export declare function loadStableDatabaseSync(nodeVersion: string, loadModule: (specifier: string) => unknown): typeof DatabaseSync | null;
+export declare function loadStableDatabaseSync(nodeVersion:string,loadModule:(specifier:string) => unknown):typeof DatabaseSync | null;

package/dist/core/store/tracker-preflight.d.ts

@@ -1,7 +1,7 @@
 import { type PmCliErrorRecoveryPayload } from "../shared/errors.js";
 /** Build the non-interactive, tokenized retry that initializes a selected tracker root. */
-export declare function buildTrackerInitializationRecovery(pmRoot: string): PmCliErrorRecoveryPayload;
+export declare function buildTrackerInitializationRecovery(pmRoot:string):PmCliErrorRecoveryPayload;
 /** Require a tracker root to be a readable directory without requiring initialized settings. */
-export declare function assertReadableTrackerRoot(pmRoot: string): Promise<void>;
+export declare function assertReadableTrackerRoot(pmRoot:string):Promise<void>;
 /** Require the selected tracker root and its settings marker before an SDK command reads or mutates project state. */
-export declare function assertInitializedTracker(pmRoot: string): Promise<void>;
+export declare function assertInitializedTracker(pmRoot:string):Promise<void>;

package/dist/core/telemetry/consent.d.ts

@@ -1,3 +1,3 @@
 import type { GlobalOptions } from "../shared/command-types.js";
 /** Prompt eligible interactive users once, persisting their choice without interrupting commands on failure. */
-export declare function maybeRunFirstUseTelemetryPrompt(commandPath: string, globalOptions: GlobalOptions): Promise<void>;
+export declare function maybeRunFirstUseTelemetryPrompt(commandPath:string,globalOptions:GlobalOptions):Promise<void>;

package/dist/core/telemetry/observability.d.ts

@@ -11,30 +11,30 @@ export type TelemetryCommandResolution = "success" | "nonexistent_command" | "in
 /** Documents the telemetry command taxonomy payload exchanged by command, SDK, and package integrations. */
 export interface TelemetryCommandTaxonomy {
 /** Filesystem path used for command resolution. */
-command_path: string;
+command_path:string;
 /** Value that configures or reports command root for this contract. */
-command_root: string;
+command_root:string;
 /** Value that configures or reports command leaf for this contract. */
-command_leaf: string;
+command_leaf:string;
 /** Value that configures or reports command depth for this contract. */
-command_depth: number;
+command_depth:number;
 /** Value that configures or reports command family for this contract. */
-command_family: "setup" | "query" | "mutation" | "testing" | "extension" | "diagnostics" | "other";
+command_family:"setup" | "query" | "mutation" | "testing" | "extension" | "diagnostics" | "other";
 }
 interface InferTelemetryErrorCodeParams {
-ok: boolean;
-errorCode?: string;
-errorMessage?: string;
-exitCode?: number;
+ok:boolean;
+errorCode?:string;
+errorMessage?:string;
+exitCode?:number;
 }
 /** Implements derive telemetry command taxonomy for the public runtime surface of this module. */
-export declare function deriveTelemetryCommandTaxonomy(commandPath: string): TelemetryCommandTaxonomy;
+export declare function deriveTelemetryCommandTaxonomy(commandPath:string):TelemetryCommandTaxonomy;
 /** Implements infer telemetry error code for the public runtime surface of this module. */
-export declare function inferTelemetryErrorCode(params: InferTelemetryErrorCodeParams): string | undefined;
+export declare function inferTelemetryErrorCode(params:InferTelemetryErrorCodeParams):string | undefined;
 /** Implements derive telemetry command resolution for the public runtime surface of this module. */
-export declare function deriveTelemetryCommandResolution(params: {
-ok: boolean;
-errorCode?: string;
-errorCategory?: TelemetryErrorCategory;
-}): TelemetryCommandResolution;
+export declare function deriveTelemetryCommandResolution(params:{
+ok:boolean;
+errorCode?:string;
+errorCategory?:TelemetryErrorCategory;
+}):TelemetryCommandResolution;
 export {};

package/dist/core/telemetry/policy.d.ts

@@ -1,12 +1,12 @@
 /** Supported explicit classifications for intentional telemetry delivery. */
-export declare const PM_TELEMETRY_SOURCE_CONTEXT_VALUES: readonly ["user", "automation", "test", "dogfood"];
+export declare const PM_TELEMETRY_SOURCE_CONTEXT_VALUES:readonly ["user","automation","test","dogfood"];
 /** Fixed core reads eligible only after runtime ownership has been established. */
-export declare const TELEMETRY_SAMPLEABLE_READS: ReadonlySet<string>;
+export declare const TELEMETRY_SAMPLEABLE_READS:ReadonlySet<string>;
 /** Resolve explicit read sampling only for core-only invocations with no write-capable extensions. */
-export declare function resolveTelemetryReadSampleRate(command: string, noExtensions: boolean, env?: Readonly<Record<string, string | undefined>>): number;
+export declare function resolveTelemetryReadSampleRate(command:string,noExtensions:boolean,env?:Readonly<Record<string,string | undefined>>):number;
 /** Explain process opt-outs without reading settings or creating installation identity. */
-export declare function resolveTelemetryEnvironmentPolicy(env?: Readonly<Record<string, string | undefined>>): {
-telemetry_disabled: boolean;
-do_not_track: boolean;
-test_suppressed: boolean;
+export declare function resolveTelemetryEnvironmentPolicy(env?:Readonly<Record<string,string | undefined>>):{
+telemetry_disabled:boolean;
+do_not_track:boolean;
+test_suppressed:boolean;
 };

package/dist/core/telemetry/read-sampling.d.ts

@@ -5,4 +5,4 @@
  * Explicit rates bypass automatic state. Corrupt or inaccessible state retains
  * the invocation. Failures must override the returned probability at finish.
  */
-export declare function resolveAutomaticReadSampleRate(globalPmRoot: string, command: string, coreReadOwned: boolean, env?: Readonly<Record<string, string | undefined>>, now?: number): Promise<number>;
+export declare function resolveAutomaticReadSampleRate(globalPmRoot:string,command:string,coreReadOwned:boolean,env?:Readonly<Record<string,string | undefined>>,now?:number):Promise<number>;