@unbrained/pm-cli 2026.10.12 → 2026.10.14

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;
 };