@unbrained/pm-cli 2026.10.11 → 2026.10.13

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

@@ -2,175 +2,175 @@ import type { AgentGuidanceSettings, ExtensionPolicySettings, GovernanceSettings
 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;
-    /** Value that configures or reports id prefix for this contract. */
-    id_prefix: string;
-    /** Item id allocation policy (random base36 token length appended to the prefix). */
-    ids?: {
-        token_length?: number;
-    };
-    /** Value that configures or reports author default for this contract. */
-    author_default: string;
-    /** Declarative workspace additions to agent identity detection. */
-    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;
-    };
-    /** Value that configures or reports item format for this contract. */
-    item_format?: "toon" | "json_markdown";
-    /** Value that configures or reports locks for this contract. */
-    locks: {
-        ttl_seconds: number;
-        wait_ms?: number;
-    };
-    /** Value that configures or reports checkpoints for this contract. */
-    checkpoints?: {
-        retention_days?: number;
-    };
-    /** Value that configures or reports output for this contract. */
-    output: {
-        default_format: "toon" | "json";
-    };
-    /** Agent and human interaction preferences. */
-    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";
-        };
-    };
-    /** 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>;
-    };
-    /** Value that configures or reports governance for this contract. */
-    governance?: Partial<GovernanceSettings>;
-    /** Value that configures or reports workflow for this contract. */
-    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;
-    };
-    /** 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;
-    };
-    /** Value that configures or reports agent guidance for this contract. */
-    agent_guidance?: Partial<AgentGuidanceSettings>;
-    /** Value that configures or reports item types for this contract. */
-    item_types?: {
-        definitions: ItemTypeDefinition[];
-    };
-    /** Value that configures or reports schema for this contract. */
-    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;
-        };
-    };
-    /** Value that configures or reports extensions for this contract. */
-    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;
-        };
-    };
-    /** Value that configures or reports providers for this contract. */
-    providers: {
-        openai: {
-            base_url: string;
-            api_key: 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;
-        };
-        lancedb: {
-            path: string;
-        };
-    };
+/** Value that configures or reports version for this contract. */
+version: number;
+/** Value that configures or reports id prefix for this contract. */
+id_prefix: string;
+/** Item id allocation policy (random base36 token length appended to the prefix). */
+ids?: {
+token_length?: number;
+};
+/** Value that configures or reports author default for this contract. */
+author_default: string;
+/** Declarative workspace additions to agent identity detection. */
+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;
+};
+/** Value that configures or reports item format for this contract. */
+item_format?: "toon" | "json_markdown";
+/** Value that configures or reports locks for this contract. */
+locks: {
+ttl_seconds: number;
+wait_ms?: number;
+};
+/** Value that configures or reports checkpoints for this contract. */
+checkpoints?: {
+retention_days?: number;
+};
+/** Value that configures or reports output for this contract. */
+output: {
+default_format: "toon" | "json";
+};
+/** Agent and human interaction preferences. */
+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";
+};
+};
+/** 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>;
+};
+/** Value that configures or reports governance for this contract. */
+governance?: Partial<GovernanceSettings>;
+/** Value that configures or reports workflow for this contract. */
+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;
+};
+/** 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;
+};
+/** Value that configures or reports agent guidance for this contract. */
+agent_guidance?: Partial<AgentGuidanceSettings>;
+/** Value that configures or reports item types for this contract. */
+item_types?: {
+definitions: ItemTypeDefinition[];
+};
+/** Value that configures or reports schema for this contract. */
+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;
+};
+};
+/** Value that configures or reports extensions for this contract. */
+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;
+};
+};
+/** Value that configures or reports providers for this contract. */
+providers: {
+openai: {
+base_url: string;
+api_key: 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;
+};
+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;

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

@@ -18,50 +18,50 @@ export declare function runWithConfigurationOnlySettings<T>(pmRoot: string, run:
 /** Report whether this tracker belongs to the current configuration-only source preparation scope. */
 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"]>;
+/** 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"]>;
 }
 interface SerializeSettingsOptions {
-    /** Ordinary writer snapshot, including file-backed schema boundaries. */
-    persist_source?: SettingsPersistSourceSnapshot;
-    /** Paired views of one locked inline source, without schema hydration. */
-    source?: {
-        /** Parsed original JSON whose sparse omissions and future fields survive known-value edits. */
-        raw: unknown;
-        /** Validated projection of the same original JSON, used for the canonical delta baseline. */
-        validated: ParsedSettings;
-    };
+/** Ordinary writer snapshot, including file-backed schema boundaries. */
+persist_source?: SettingsPersistSourceSnapshot;
+/** Paired views of one locked inline source, without schema hydration. */
+source?: {
+/** Parsed original JSON whose sparse omissions and future fields survive known-value edits. */
+raw: unknown;
+/** Validated projection of the same original JSON, used for the canonical delta baseline. */
+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;
+/** Whether explicit item format applies to this operation. */
+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;
-    /** Value that configures or reports metadata for this contract. */
-    metadata: SettingsReadMetadata;
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
+/** Value that configures or reports metadata for this contract. */
+metadata: SettingsReadMetadata;
+/** Value that configures or reports warnings for this contract. */
+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>;
+governance?: Partial<GovernanceSettings>;
 }): GovernanceSettings;
 declare function buildSettingsPersistSourceSnapshot(parsedSettings: ParsedSettings, runtimeSettings: PmSettings): SettingsPersistSourceSnapshot;
 /**
@@ -75,10 +75,10 @@ type SettingsReadCacheSignatures = Awaited<ReturnType<typeof collectSettingsRead
 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"];
+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[];
@@ -115,27 +115,27 @@ export declare function readSettings(pmRoot: string): Promise<PmSettings>;
 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;
+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/telemetry/observability.d.ts

@@ -10,22 +10,22 @@ export type TelemetryResolutionStage = "parse" | "preflight" | "execute" | "unkn
 export type TelemetryCommandResolution = "success" | "nonexistent_command" | "invalid_option" | "missing_required_option" | "missing_required_argument" | "invalid_usage" | "validation_failed" | "health_findings" | "validation_findings" | "conflict" | "runtime_failed" | "unknown_failed";
 /** 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;
-    /** Value that configures or reports command root for this contract. */
-    command_root: string;
-    /** Value that configures or reports command leaf for this contract. */
-    command_leaf: string;
-    /** Value that configures or reports command depth for this contract. */
-    command_depth: number;
-    /** Value that configures or reports command family for this contract. */
-    command_family: "setup" | "query" | "mutation" | "testing" | "extension" | "diagnostics" | "other";
+/** Filesystem path used for command resolution. */
+command_path: string;
+/** Value that configures or reports command root for this contract. */
+command_root: string;
+/** Value that configures or reports command leaf for this contract. */
+command_leaf: string;
+/** Value that configures or reports command depth for this contract. */
+command_depth: number;
+/** Value that configures or reports command family for this contract. */
+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;
@@ -33,8 +33,8 @@ export declare function deriveTelemetryCommandTaxonomy(commandPath: string): Tel
 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;
+ok: boolean;
+errorCode?: string;
+errorCategory?: TelemetryErrorCategory;
 }): TelemetryCommandResolution;
 export {};

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

@@ -6,7 +6,7 @@ export declare const TELEMETRY_SAMPLEABLE_READS: ReadonlySet<string>;
 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;
+telemetry_disabled: boolean;
+do_not_track: boolean;
+test_suppressed: boolean;
 };