@unbrained/pm-cli 2026.6.13 → 2026.6.16

package/dist/core/store/settings.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="759b1285-3075-5bd2-a0d7-9eab54fc1093")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ad562c88-0172-5c5c-8288-40d66376c88d")}catch(e){}}();
 import { validateSettings } from "./settings-validator.js";
 import { runActiveOnReadHooks, runActiveOnWriteHooks } from "../extensions/index.js";
 import { GOVERNANCE_PRESET_DEFAULTS, SETTINGS_DEFAULTS } from "../shared/constants.js";
@@ -8,6 +8,7 @@ import { DEFAULT_RUNTIME_SCHEMA_FILE_PATHS, ensureRuntimeSchemaFileScaffold, fil
 import { getSettingsPath } from "./paths.js";
 import { orderObject, stableValueEquals } from "../shared/serialization.js";
 import { normalizeItemTypeDefinition } from "../item/item-type-definition.js";
+import { normalizeEstimateDefaultOverrides } from "../validate/estimate-defaults.js";
 import { clearSettingsReadCache, collectSettingsReadCacheSignatures, getSettingsReadCacheEntry, setSettingsReadCacheEntry, settingsReadCacheSignaturesEqual, } from "./settings-read-cache.js";
 const SETTINGS_WRITE_OP = "settings:write";
 const SETTINGS_PERSIST_SOURCE_SYMBOL = Symbol("pm.settings.persist_source");
@@ -491,6 +492,15 @@ function normalizeValidationMetadataRequiredFields(values) {
 function normalizeValidationPatternList(values) {
     return [...new Set((values ?? []).map((value) => value.trim().toLowerCase()).filter((value) => value.length > 0))].sort((left, right) => left.localeCompare(right));
 }
+function valueOrDefault(value, fallback) {
+    return value === undefined ? fallback : value;
+}
+function recordOrEmpty(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+function arrayOrEmpty(value) {
+    return Array.isArray(value) ? value : [];
+}
 export function normalizeItemTypeDefinitions(definitions) {
     const normalized = (definitions ?? [])
         .map((definition) => normalizeItemTypeDefinition(definition))
@@ -527,6 +537,7 @@ function mergeSettings(settings) {
                 defaults.validation.lifecycle_closure_like_resolution_patterns),
             lifecycle_closure_like_actual_result_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_actual_result_patterns ??
                 defaults.validation.lifecycle_closure_like_actual_result_patterns),
+            estimate_defaults_by_type: normalizeEstimateDefaultOverrides(settings.validation?.estimate_defaults_by_type),
         },
         governance,
         workflow: {
@@ -593,28 +604,47 @@ function mergeSettings(settings) {
     };
 }
 export function serializeSettings(settings, options = {}) {
-    const governance = resolveGovernanceKnobs(settings);
-    const normalizedSchema = normalizeRuntimeSchemaSettings(settings.schema);
-    const persistedFileBackedSections = resolvePersistedFileBackedSchemaSections(settings, options.persist_source);
-    const normalizedSettings = {
+    const baseSettings = {
         ...settings,
+        locks: valueOrDefault(settings.locks, SETTINGS_DEFAULTS.locks),
+        output: valueOrDefault(settings.output, SETTINGS_DEFAULTS.output),
+        history: valueOrDefault(settings.history, SETTINGS_DEFAULTS.history),
+        validation: valueOrDefault(settings.validation, SETTINGS_DEFAULTS.validation),
+        workflow: valueOrDefault(settings.workflow, SETTINGS_DEFAULTS.workflow),
+        testing: valueOrDefault(settings.testing, SETTINGS_DEFAULTS.testing),
+        telemetry: valueOrDefault(settings.telemetry, SETTINGS_DEFAULTS.telemetry),
+        agent_guidance: valueOrDefault(settings.agent_guidance, SETTINGS_DEFAULTS.agent_guidance),
+        item_types: valueOrDefault(settings.item_types, SETTINGS_DEFAULTS.item_types),
+        schema: valueOrDefault(settings.schema, SETTINGS_DEFAULTS.schema),
+        context: valueOrDefault(settings.context, SETTINGS_DEFAULTS.context),
+        extensions: valueOrDefault(settings.extensions, SETTINGS_DEFAULTS.extensions),
+        search: valueOrDefault(settings.search, SETTINGS_DEFAULTS.search),
+        providers: valueOrDefault(settings.providers, SETTINGS_DEFAULTS.providers),
+        vector_store: valueOrDefault(settings.vector_store, SETTINGS_DEFAULTS.vector_store),
+    };
+    const governance = resolveGovernanceKnobs(baseSettings);
+    const normalizedSchema = normalizeRuntimeSchemaSettings(baseSettings.schema);
+    const persistedFileBackedSections = resolvePersistedFileBackedSchemaSections(baseSettings, options.persist_source);
+    const normalizedSettings = {
+        ...baseSettings,
         item_format: "toon",
         validation: {
-            ...settings.validation,
+            ...baseSettings.validation,
             parent_reference: governance.parent_reference,
             metadata_profile: governance.metadata_profile,
-            metadata_required_fields: normalizeValidationMetadataRequiredFields(settings.validation?.metadata_required_fields),
-            lifecycle_stale_blocker_reason_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_stale_blocker_reason_patterns ??
+            metadata_required_fields: normalizeValidationMetadataRequiredFields(baseSettings.validation?.metadata_required_fields),
+            lifecycle_stale_blocker_reason_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_stale_blocker_reason_patterns ??
                 SETTINGS_DEFAULTS.validation.lifecycle_stale_blocker_reason_patterns),
-            lifecycle_closure_like_blocked_reason_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_blocked_reason_patterns ??
+            lifecycle_closure_like_blocked_reason_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_closure_like_blocked_reason_patterns ??
                 SETTINGS_DEFAULTS.validation.lifecycle_closure_like_blocked_reason_patterns),
-            lifecycle_closure_like_resolution_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_resolution_patterns ??
+            lifecycle_closure_like_resolution_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_closure_like_resolution_patterns ??
                 SETTINGS_DEFAULTS.validation.lifecycle_closure_like_resolution_patterns),
-            lifecycle_closure_like_actual_result_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_actual_result_patterns ??
+            lifecycle_closure_like_actual_result_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_closure_like_actual_result_patterns ??
                 SETTINGS_DEFAULTS.validation.lifecycle_closure_like_actual_result_patterns),
+            estimate_defaults_by_type: normalizeEstimateDefaultOverrides(baseSettings.validation?.estimate_defaults_by_type),
         },
         governance,
-        agent_guidance: normalizeAgentGuidanceSettings(settings.agent_guidance),
+        agent_guidance: normalizeAgentGuidanceSettings(baseSettings.agent_guidance),
         item_types: {
             definitions: persistedFileBackedSections.item_type_definitions,
         },
@@ -626,42 +656,42 @@ export function serializeSettings(settings, options = {}) {
         },
         search: {
             ...SETTINGS_DEFAULTS.search,
-            ...settings.search,
-            mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(settings.search?.mutation_refresh_policy),
+            ...baseSettings.search,
+            mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(baseSettings.search?.mutation_refresh_policy),
             query_expansion: {
                 ...SETTINGS_DEFAULTS.search.query_expansion,
-                ...(settings.search?.query_expansion ?? {}),
-                enabled: normalizeSearchQueryExpansionEnabled(settings.search?.query_expansion?.enabled),
-                provider: normalizeSearchQueryExpansionProvider(settings.search?.query_expansion?.provider),
+                ...(baseSettings.search?.query_expansion ?? {}),
+                enabled: normalizeSearchQueryExpansionEnabled(baseSettings.search?.query_expansion?.enabled),
+                provider: normalizeSearchQueryExpansionProvider(baseSettings.search?.query_expansion?.provider),
             },
             rerank: {
                 ...SETTINGS_DEFAULTS.search.rerank,
-                ...(settings.search?.rerank ?? {}),
-                enabled: normalizeSearchRerankEnabled(settings.search?.rerank?.enabled),
-                model: normalizeSearchRerankModel(settings.search?.rerank?.model),
-                top_k: normalizeSearchRerankTopK(settings.search?.rerank?.top_k),
+                ...(baseSettings.search?.rerank ?? {}),
+                enabled: normalizeSearchRerankEnabled(baseSettings.search?.rerank?.enabled),
+                model: normalizeSearchRerankModel(baseSettings.search?.rerank?.model),
+                top_k: normalizeSearchRerankTopK(baseSettings.search?.rerank?.top_k),
             },
         },
         context: {
-            default_depth: settings.context?.default_depth ?? SETTINGS_DEFAULTS.context.default_depth,
-            activity_limit: settings.context?.activity_limit ?? SETTINGS_DEFAULTS.context.activity_limit,
-            stale_threshold_days: settings.context?.stale_threshold_days ?? SETTINGS_DEFAULTS.context.stale_threshold_days,
+            default_depth: baseSettings.context?.default_depth ?? SETTINGS_DEFAULTS.context.default_depth,
+            activity_limit: baseSettings.context?.activity_limit ?? SETTINGS_DEFAULTS.context.activity_limit,
+            stale_threshold_days: baseSettings.context?.stale_threshold_days ?? SETTINGS_DEFAULTS.context.stale_threshold_days,
             sections: {
                 ...SETTINGS_DEFAULTS.context.sections,
-                ...(settings.context?.sections ?? {}),
+                ...(baseSettings.context?.sections ?? {}),
             },
         },
         extensions: {
-            enabled: normalizeStringList(settings.extensions?.enabled),
-            disabled: normalizeStringList(settings.extensions?.disabled),
-            policy: normalizeExtensionPolicySettings(settings.extensions?.policy),
+            enabled: normalizeStringList(baseSettings.extensions?.enabled),
+            disabled: normalizeStringList(baseSettings.extensions?.disabled),
+            policy: normalizeExtensionPolicySettings(baseSettings.extensions?.policy),
         },
         vector_store: {
-            ...(settings.vector_store ?? {}),
-            adapter: settings.vector_store?.adapter ?? SETTINGS_DEFAULTS.vector_store.adapter,
-            collection_name: normalizeVectorStoreCollectionName(settings.vector_store?.collection_name),
-            qdrant: { ...(settings.vector_store?.qdrant ?? {}) },
-            lancedb: { ...(settings.vector_store?.lancedb ?? {}) },
+            ...baseSettings.vector_store,
+            adapter: baseSettings.vector_store?.adapter ?? SETTINGS_DEFAULTS.vector_store.adapter,
+            collection_name: normalizeVectorStoreCollectionName(baseSettings.vector_store?.collection_name),
+            qdrant: { ...(baseSettings.vector_store?.qdrant ?? {}) },
+            lancedb: { ...(baseSettings.vector_store?.lancedb ?? {}) },
         },
     };
     const ordered = orderObject({
@@ -701,6 +731,7 @@ export function serializeSettings(settings, options = {}) {
         "lifecycle_closure_like_blocked_reason_patterns",
         "lifecycle_closure_like_resolution_patterns",
         "lifecycle_closure_like_actual_result_patterns",
+        "estimate_defaults_by_type",
     ]);
     ordered.governance = orderObject(ordered.governance, [
         "preset",
@@ -741,17 +772,17 @@ export function serializeSettings(settings, options = {}) {
         "type_workflows",
         "unknown_field_policy",
     ]);
-    ordered.schema.files = orderObject((ordered.schema.files ?? {}), ["types", "statuses", "fields", "workflows"]);
-    ordered.schema.workflow = orderObject((ordered.schema.workflow ?? {}), ["draft_status", "open_status", "in_progress_status", "blocked_status", "close_status", "canceled_status"]);
+    ordered.schema.files = orderObject(recordOrEmpty(ordered.schema.files), ["types", "statuses", "fields", "workflows"]);
+    ordered.schema.workflow = orderObject(recordOrEmpty(ordered.schema.workflow), ["draft_status", "open_status", "in_progress_status", "blocked_status", "close_status", "canceled_status"]);
     ordered.context = orderObject(ordered.context, [
         "default_depth",
         "activity_limit",
         "stale_threshold_days",
         "sections",
     ]);
-    ordered.context.sections = orderObject((ordered.context.sections ?? {}), ["hierarchy", "activity", "progress", "blockers", "files", "workload", "staleness", "tests"]);
+    ordered.context.sections = orderObject(recordOrEmpty(ordered.context.sections), ["hierarchy", "activity", "progress", "blockers", "files", "workload", "staleness", "tests"]);
     ordered.extensions = orderObject(ordered.extensions, ["enabled", "disabled", "policy"]);
-    ordered.extensions.policy = orderObject((ordered.extensions.policy ?? {}), [
+    ordered.extensions.policy = orderObject(recordOrEmpty(ordered.extensions.policy), [
         "mode",
         "trust_mode",
         "pm_max_version_exceeded_mode",
@@ -772,7 +803,7 @@ export function serializeSettings(settings, options = {}) {
         "blocked_services",
         "extension_overrides",
     ]);
-    ordered.extensions.policy.extension_overrides = (ordered.extensions.policy.extension_overrides ?? []).map((entry) => orderObject((entry ?? {}), [
+    ordered.extensions.policy.extension_overrides = (arrayOrEmpty(ordered.extensions.policy.extension_overrides)).map((entry) => orderObject(recordOrEmpty(entry), [
         "name",
         "disabled",
         "require_trusted",
@@ -803,19 +834,19 @@ export function serializeSettings(settings, options = {}) {
         "query_expansion",
         "rerank",
     ]);
-    ordered.search.query_expansion = orderObject((ordered.search.query_expansion ?? {}), ["enabled", "provider"]);
-    ordered.search.rerank = orderObject((ordered.search.rerank ?? {}), ["enabled", "model", "top_k"]);
+    ordered.search.query_expansion = orderObject(recordOrEmpty(ordered.search.query_expansion), ["enabled", "provider"]);
+    ordered.search.rerank = orderObject(recordOrEmpty(ordered.search.rerank), ["enabled", "model", "top_k"]);
     ordered.providers = orderObject(ordered.providers, ["openai", "ollama"]);
-    ordered.providers.openai = orderObject((ordered.providers.openai ?? {}), ["base_url", "api_key", "model"]);
-    ordered.providers.ollama = orderObject((ordered.providers.ollama ?? {}), ["base_url", "model"]);
+    ordered.providers.openai = orderObject(recordOrEmpty(ordered.providers.openai), ["base_url", "api_key", "model"]);
+    ordered.providers.ollama = orderObject(recordOrEmpty(ordered.providers.ollama), ["base_url", "model"]);
     ordered.vector_store = orderObject(ordered.vector_store, [
         "adapter",
         "collection_name",
         "qdrant",
         "lancedb",
     ]);
-    ordered.vector_store.qdrant = orderObject((ordered.vector_store.qdrant ?? {}), ["url", "api_key"]);
-    ordered.vector_store.lancedb = orderObject((ordered.vector_store.lancedb ?? {}), ["path"]);
+    ordered.vector_store.qdrant = orderObject(recordOrEmpty(ordered.vector_store.qdrant), ["url", "api_key"]);
+    ordered.vector_store.lancedb = orderObject(recordOrEmpty(ordered.vector_store.lancedb), ["path"]);
     return `${JSON.stringify(ordered, null, 2)}\n`;
 }
 export async function readSettingsWithMetadata(pmRoot) {
@@ -872,7 +903,7 @@ export async function readSettingsWithMetadata(pmRoot) {
             item_types: {
                 definitions: normalizeItemTypeDefinitions([
                     ...mergedSettings.item_types.definitions,
-                    ...(loadedSchemaSections.type_definitions_from_file ?? []),
+                    ...arrayOrEmpty(loadedSchemaSections.type_definitions_from_file),
                 ]),
             },
             schema: loadedSchemaSections.schema,
@@ -934,5 +965,28 @@ export async function writeSettings(pmRoot, settings, op = SETTINGS_WRITE_OP) {
         clearSettingsReadCache(pmRoot);
     }
 }
+export const settingsStoreTestOnly = {
+    hasExplicitItemFormat,
+    buildSettingsPersistSourceSnapshot,
+    cacheSettingsReadResultIfStable,
+    cacheSettingsReadResultSafe,
+    mergeSettings,
+    normalizeExtensionPolicySettings,
+    normalizeExtensionPolicyOverride,
+    normalizeExtensionPolicyOverrides,
+    normalizeExtensionPolicyMode,
+    normalizePmMaxVersionExceededModeSetting,
+    normalizeExtensionSandboxProfile,
+    normalizeExtensionTrustMode,
+    normalizeLowerStringList,
+    normalizeStringList,
+    valueOrDefault,
+    arrayOrEmpty,
+    normalizeValidationPatternList,
+    normalizeValidationMetadataRequiredFields,
+    resolveSettingsReadTrackedPaths,
+    resolvePersistedFileBackedSchemaSections,
+    selectedSettingsReadCacheSignaturesEqual,
+};
 //# sourceMappingURL=settings.js.map
-//# debugId=759b1285-3075-5bd2-a0d7-9eab54fc1093
+//# debugId=ad562c88-0172-5c5c-8288-40d66376c88d