@unbrained/pm-cli 2026.7.1 → 2026.7.3

package/dist/core/store/settings.js

@@ -4,7 +4,7 @@
  * Reads and writes tracker storage with format-aware helpers for Settings.
  */
 
-!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]="76965ca9-e890-5aa2-a7ca-22f8d179dd5c")}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]="4232868d-1e9d-51a3-abbe-3d9a3d1acae1")}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";
@@ -456,29 +456,31 @@ function normalizePmMaxVersionExceededModeSetting(value) {
     }
     return undefined;
 }
+function normalizeExtensionPolicyList(policy, key) {
+    return normalizeLowerStringList(policy?.[key] ?? SETTINGS_DEFAULTS.extensions.policy[key]);
+}
 function normalizeExtensionPolicySettings(policy) {
-    const defaults = SETTINGS_DEFAULTS.extensions.policy;
     const pmMaxVersionExceededMode = normalizePmMaxVersionExceededModeSetting(policy?.pm_max_version_exceeded_mode);
     return {
         mode: normalizeExtensionPolicyMode(policy?.mode),
         trust_mode: normalizeExtensionTrustMode(policy?.trust_mode),
         ...(pmMaxVersionExceededMode !== undefined ? { pm_max_version_exceeded_mode: pmMaxVersionExceededMode } : {}),
         require_provenance: policy?.require_provenance === true,
-        trusted_extensions: normalizeLowerStringList(policy?.trusted_extensions ?? defaults.trusted_extensions),
+        trusted_extensions: normalizeExtensionPolicyList(policy, "trusted_extensions"),
         default_sandbox_profile: normalizeExtensionSandboxProfile(policy?.default_sandbox_profile),
-        allowed_extensions: normalizeLowerStringList(policy?.allowed_extensions ?? defaults.allowed_extensions),
-        blocked_extensions: normalizeLowerStringList(policy?.blocked_extensions ?? defaults.blocked_extensions),
-        allowed_capabilities: normalizeLowerStringList(policy?.allowed_capabilities ?? defaults.allowed_capabilities),
-        blocked_capabilities: normalizeLowerStringList(policy?.blocked_capabilities ?? defaults.blocked_capabilities),
-        allowed_surfaces: normalizeLowerStringList(policy?.allowed_surfaces ?? defaults.allowed_surfaces),
-        blocked_surfaces: normalizeLowerStringList(policy?.blocked_surfaces ?? defaults.blocked_surfaces),
-        allowed_commands: normalizeLowerStringList(policy?.allowed_commands ?? defaults.allowed_commands),
-        blocked_commands: normalizeLowerStringList(policy?.blocked_commands ?? defaults.blocked_commands),
-        allowed_actions: normalizeLowerStringList(policy?.allowed_actions ?? defaults.allowed_actions),
-        blocked_actions: normalizeLowerStringList(policy?.blocked_actions ?? defaults.blocked_actions),
-        allowed_services: normalizeLowerStringList(policy?.allowed_services ?? defaults.allowed_services),
-        blocked_services: normalizeLowerStringList(policy?.blocked_services ?? defaults.blocked_services),
-        extension_overrides: normalizeExtensionPolicyOverrides(policy?.extension_overrides ?? defaults.extension_overrides),
+        allowed_extensions: normalizeExtensionPolicyList(policy, "allowed_extensions"),
+        blocked_extensions: normalizeExtensionPolicyList(policy, "blocked_extensions"),
+        allowed_capabilities: normalizeExtensionPolicyList(policy, "allowed_capabilities"),
+        blocked_capabilities: normalizeExtensionPolicyList(policy, "blocked_capabilities"),
+        allowed_surfaces: normalizeExtensionPolicyList(policy, "allowed_surfaces"),
+        blocked_surfaces: normalizeExtensionPolicyList(policy, "blocked_surfaces"),
+        allowed_commands: normalizeExtensionPolicyList(policy, "allowed_commands"),
+        blocked_commands: normalizeExtensionPolicyList(policy, "blocked_commands"),
+        allowed_actions: normalizeExtensionPolicyList(policy, "allowed_actions"),
+        blocked_actions: normalizeExtensionPolicyList(policy, "blocked_actions"),
+        allowed_services: normalizeExtensionPolicyList(policy, "allowed_services"),
+        blocked_services: normalizeExtensionPolicyList(policy, "blocked_services"),
+        extension_overrides: normalizeExtensionPolicyOverrides(policy?.extension_overrides ?? SETTINGS_DEFAULTS.extensions.policy.extension_overrides),
     };
 }
 function normalizeValidationMetadataRequiredFields(values) {
@@ -509,6 +511,85 @@ function recordOrEmpty(value) {
 function arrayOrEmpty(value) {
     return Array.isArray(value) ? value : [];
 }
+function buildValidationSettings(settings, defaults, governance) {
+    return {
+        ...defaults.validation,
+        ...settings.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 ??
+            defaults.validation.lifecycle_stale_blocker_reason_patterns),
+        lifecycle_closure_like_blocked_reason_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_blocked_reason_patterns ??
+            defaults.validation.lifecycle_closure_like_blocked_reason_patterns),
+        lifecycle_closure_like_resolution_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_resolution_patterns ??
+            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),
+    };
+}
+function buildTelemetrySettings(settings, defaults) {
+    return {
+        enabled: settings.telemetry?.enabled ?? defaults.telemetry.enabled,
+        first_run_prompt_completed: settings.telemetry?.first_run_prompt_completed ?? defaults.telemetry.first_run_prompt_completed,
+        capture_level: settings.telemetry?.capture_level ?? defaults.telemetry.capture_level,
+        endpoint: settings.telemetry?.endpoint ?? defaults.telemetry.endpoint,
+        installation_id: settings.telemetry?.installation_id ?? defaults.telemetry.installation_id,
+        retention_days: settings.telemetry?.retention_days ?? defaults.telemetry.retention_days,
+    };
+}
+function buildSearchSettings(settings, defaults) {
+    return {
+        ...defaults.search,
+        ...settings.search,
+        mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(settings.search?.mutation_refresh_policy),
+        query_expansion: {
+            ...defaults.search.query_expansion,
+            ...settings.search?.query_expansion,
+            enabled: normalizeSearchQueryExpansionEnabled(settings.search?.query_expansion?.enabled),
+            provider: normalizeSearchQueryExpansionProvider(settings.search?.query_expansion?.provider),
+        },
+        rerank: {
+            ...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),
+        },
+    };
+}
+function buildVectorStoreSettings(settings, defaults) {
+    return {
+        adapter: settings.vector_store.adapter ?? defaults.vector_store.adapter,
+        collection_name: normalizeVectorStoreCollectionName(settings.vector_store.collection_name),
+        qdrant: { ...defaults.vector_store.qdrant, ...settings.vector_store.qdrant },
+        lancedb: { ...defaults.vector_store.lancedb, ...settings.vector_store.lancedb },
+    };
+}
+function normalizeSettingsItemFormat(settings, defaults) {
+    if (settings.item_format === "json_markdown") {
+        return "toon";
+    }
+    return settings.item_format ?? defaults.item_format;
+}
+function buildContextSettings(settings, defaults) {
+    return {
+        default_depth: settings.context?.default_depth ?? defaults.context.default_depth,
+        activity_limit: settings.context?.activity_limit ?? defaults.context.activity_limit,
+        stale_threshold_days: settings.context?.stale_threshold_days ?? defaults.context.stale_threshold_days,
+        sections: {
+            ...defaults.context.sections,
+            ...settings.context?.sections,
+        },
+    };
+}
+function buildProviderSettings(settings, defaults) {
+    return {
+        openai: { ...defaults.providers.openai, ...settings.providers.openai },
+        ollama: { ...defaults.providers.ollama, ...settings.providers.ollama },
+    };
+}
 /**
  * Implements normalize item type definitions for the public runtime surface of this module.
  */
@@ -530,7 +611,7 @@ function mergeSettings(settings) {
     return {
         ...defaults,
         ...settings,
-        item_format: settings.item_format === "json_markdown" ? "toon" : (settings.item_format ?? defaults.item_format),
+        item_format: normalizeSettingsItemFormat(settings, defaults),
         locks: { ...defaults.locks, ...settings.locks },
         checkpoints: { ...defaults.checkpoints, ...settings.checkpoints },
         output: { ...defaults.output, ...settings.output },
@@ -542,22 +623,7 @@ function mergeSettings(settings) {
                 ...settings.history?.compact_policy,
             },
         },
-        validation: {
-            ...defaults.validation,
-            ...settings.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 ??
-                defaults.validation.lifecycle_stale_blocker_reason_patterns),
-            lifecycle_closure_like_blocked_reason_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_blocked_reason_patterns ??
-                defaults.validation.lifecycle_closure_like_blocked_reason_patterns),
-            lifecycle_closure_like_resolution_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_resolution_patterns ??
-                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),
-        },
+        validation: buildValidationSettings(settings, defaults, governance),
         governance,
         workflow: {
             definition_of_done: [...(settings.workflow?.definition_of_done ?? defaults.workflow.definition_of_done)],
@@ -565,190 +631,27 @@ function mergeSettings(settings) {
         testing: {
             record_results_to_items: settings.testing?.record_results_to_items ?? defaults.testing.record_results_to_items,
         },
-        telemetry: {
-            enabled: settings.telemetry?.enabled ?? defaults.telemetry.enabled,
-            first_run_prompt_completed: settings.telemetry?.first_run_prompt_completed ?? defaults.telemetry.first_run_prompt_completed,
-            capture_level: settings.telemetry?.capture_level ?? defaults.telemetry.capture_level,
-            endpoint: settings.telemetry?.endpoint ?? defaults.telemetry.endpoint,
-            installation_id: settings.telemetry?.installation_id ?? defaults.telemetry.installation_id,
-            retention_days: settings.telemetry?.retention_days ?? defaults.telemetry.retention_days,
-        },
+        telemetry: buildTelemetrySettings(settings, defaults),
         agent_guidance: normalizeAgentGuidanceSettings(settings.agent_guidance ?? defaults.agent_guidance),
         item_types: {
             definitions: normalizeItemTypeDefinitions(settings.item_types?.definitions),
         },
         schema: normalizeRuntimeSchemaSettings(settings.schema ?? defaults.schema),
-        context: {
-            default_depth: settings.context?.default_depth ?? defaults.context.default_depth,
-            activity_limit: settings.context?.activity_limit ?? defaults.context.activity_limit,
-            stale_threshold_days: settings.context?.stale_threshold_days ?? defaults.context.stale_threshold_days,
-            sections: {
-                ...defaults.context.sections,
-                ...settings.context?.sections,
-            },
-        },
+        context: buildContextSettings(settings, defaults),
         extensions: {
             enabled: [...settings.extensions.enabled],
             disabled: [...settings.extensions.disabled],
             policy: normalizeExtensionPolicySettings(settings.extensions.policy ?? defaults.extensions.policy),
         },
-        search: {
-            ...defaults.search,
-            ...settings.search,
-            mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(settings.search?.mutation_refresh_policy),
-            query_expansion: {
-                ...defaults.search.query_expansion,
-                ...settings.search?.query_expansion,
-                enabled: normalizeSearchQueryExpansionEnabled(settings.search?.query_expansion?.enabled),
-                provider: normalizeSearchQueryExpansionProvider(settings.search?.query_expansion?.provider),
-            },
-            rerank: {
-                ...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),
-            },
-        },
-        providers: {
-            openai: { ...defaults.providers.openai, ...settings.providers.openai },
-            ollama: { ...defaults.providers.ollama, ...settings.providers.ollama },
-        },
-        vector_store: {
-            adapter: settings.vector_store.adapter ?? defaults.vector_store.adapter,
-            collection_name: normalizeVectorStoreCollectionName(settings.vector_store.collection_name),
-            qdrant: { ...defaults.vector_store.qdrant, ...settings.vector_store.qdrant },
-            lancedb: { ...defaults.vector_store.lancedb, ...settings.vector_store.lancedb },
-        },
+        search: buildSearchSettings(settings, defaults),
+        providers: buildProviderSettings(settings, defaults),
+        vector_store: buildVectorStoreSettings(settings, defaults),
     };
 }
-/**
- * Implements serialize settings for the public runtime surface of this module.
- */
-export function serializeSettings(settings, options = {}) {
-    const baseSettings = {
-        ...settings,
-        locks: valueOrDefault(settings.locks, SETTINGS_DEFAULTS.locks),
-        checkpoints: valueOrDefault(settings.checkpoints, SETTINGS_DEFAULTS.checkpoints),
-        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: {
-            ...baseSettings.validation,
-            parent_reference: governance.parent_reference,
-            metadata_profile: governance.metadata_profile,
-            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(baseSettings.validation?.lifecycle_closure_like_blocked_reason_patterns ??
-                SETTINGS_DEFAULTS.validation.lifecycle_closure_like_blocked_reason_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(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(baseSettings.agent_guidance),
-        item_types: {
-            definitions: persistedFileBackedSections.item_type_definitions,
-        },
-        schema: {
-            ...normalizedSchema,
-            statuses: persistedFileBackedSections.schema_statuses,
-            fields: persistedFileBackedSections.schema_fields,
-            type_workflows: persistedFileBackedSections.schema_type_workflows,
-        },
-        search: {
-            ...SETTINGS_DEFAULTS.search,
-            ...baseSettings.search,
-            mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(baseSettings.search?.mutation_refresh_policy),
-            query_expansion: {
-                ...SETTINGS_DEFAULTS.search.query_expansion,
-                ...baseSettings.search?.query_expansion,
-                enabled: normalizeSearchQueryExpansionEnabled(baseSettings.search?.query_expansion?.enabled),
-                provider: normalizeSearchQueryExpansionProvider(baseSettings.search?.query_expansion?.provider),
-            },
-            rerank: {
-                ...SETTINGS_DEFAULTS.search.rerank,
-                ...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: 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,
-                ...baseSettings.context?.sections,
-            },
-        },
-        extensions: {
-            enabled: normalizeStringList(baseSettings.extensions?.enabled),
-            disabled: normalizeStringList(baseSettings.extensions?.disabled),
-            policy: normalizeExtensionPolicySettings(baseSettings.extensions?.policy),
-        },
-        vector_store: {
-            ...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({
-        ...normalizedSettings,
-        governance: normalizeGovernanceForPersist(governance),
-    }, [
-        "version",
-        "id_prefix",
-        "author_default",
-        "item_format",
-        "locks",
-        "checkpoints",
-        "output",
-        "history",
-        "validation",
-        "governance",
-        "workflow",
-        "testing",
-        "telemetry",
-        "agent_guidance",
-        "item_types",
-        "schema",
-        "context",
-        "extensions",
-        "search",
-        "providers",
-        "vector_store",
-    ]);
+function orderSerializedSettingsSections(ordered) {
     ordered.locks = orderObject(ordered.locks, ["ttl_seconds"]);
     ordered.checkpoints = orderObject(ordered.checkpoints, ["retention_days"]);
     ordered.output = orderObject(ordered.output, ["default_format"]);
-    // compact_policy's own keys are emitted in deterministic order by mergeSettings
-    // (it rebuilds the object as {enabled, max_entries, trigger}); only the top-level
-    // history keys need explicit ordering here.
     ordered.history = orderObject(ordered.history, ["missing_stream", "compact_policy"]);
     ordered.validation = orderObject(ordered.validation, [
         "sprint_release_format",
@@ -875,6 +778,147 @@ export function serializeSettings(settings, options = {}) {
     ]);
     ordered.vector_store.qdrant = orderObject(recordOrEmpty(ordered.vector_store.qdrant), ["url", "api_key"]);
     ordered.vector_store.lancedb = orderObject(recordOrEmpty(ordered.vector_store.lancedb), ["path"]);
+}
+function buildSerializeBaseSettings(settings) {
+    return {
+        ...settings,
+        locks: valueOrDefault(settings.locks, SETTINGS_DEFAULTS.locks),
+        checkpoints: valueOrDefault(settings.checkpoints, SETTINGS_DEFAULTS.checkpoints),
+        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),
+    };
+}
+function buildSerializedValidationSettings(baseSettings, governance) {
+    return {
+        ...baseSettings.validation,
+        parent_reference: governance.parent_reference,
+        metadata_profile: governance.metadata_profile,
+        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(baseSettings.validation?.lifecycle_closure_like_blocked_reason_patterns ??
+            SETTINGS_DEFAULTS.validation.lifecycle_closure_like_blocked_reason_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(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),
+    };
+}
+function buildSerializedSearchSettings(baseSettings) {
+    return {
+        ...SETTINGS_DEFAULTS.search,
+        ...baseSettings.search,
+        mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(baseSettings.search?.mutation_refresh_policy),
+        query_expansion: {
+            ...SETTINGS_DEFAULTS.search.query_expansion,
+            ...baseSettings.search?.query_expansion,
+            enabled: normalizeSearchQueryExpansionEnabled(baseSettings.search?.query_expansion?.enabled),
+            provider: normalizeSearchQueryExpansionProvider(baseSettings.search?.query_expansion?.provider),
+        },
+        rerank: {
+            ...SETTINGS_DEFAULTS.search.rerank,
+            ...baseSettings.search?.rerank,
+            enabled: normalizeSearchRerankEnabled(baseSettings.search?.rerank?.enabled),
+            model: normalizeSearchRerankModel(baseSettings.search?.rerank?.model),
+            top_k: normalizeSearchRerankTopK(baseSettings.search?.rerank?.top_k),
+        },
+    };
+}
+function buildSerializedContextSettings(baseSettings) {
+    return {
+        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,
+            ...baseSettings.context?.sections,
+        },
+    };
+}
+function buildSerializedVectorStoreSettings(baseSettings) {
+    return {
+        ...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 },
+    };
+}
+function buildNormalizedSettingsForSerialization(baseSettings, governance, normalizedSchema, persistedFileBackedSections) {
+    return {
+        ...baseSettings,
+        item_format: "toon",
+        validation: buildSerializedValidationSettings(baseSettings, governance),
+        governance,
+        agent_guidance: normalizeAgentGuidanceSettings(baseSettings.agent_guidance),
+        item_types: {
+            definitions: persistedFileBackedSections.item_type_definitions,
+        },
+        schema: {
+            ...normalizedSchema,
+            statuses: persistedFileBackedSections.schema_statuses,
+            fields: persistedFileBackedSections.schema_fields,
+            type_workflows: persistedFileBackedSections.schema_type_workflows,
+        },
+        search: buildSerializedSearchSettings(baseSettings),
+        context: buildSerializedContextSettings(baseSettings),
+        extensions: {
+            enabled: normalizeStringList(baseSettings.extensions?.enabled),
+            disabled: normalizeStringList(baseSettings.extensions?.disabled),
+            policy: normalizeExtensionPolicySettings(baseSettings.extensions?.policy),
+        },
+        vector_store: buildSerializedVectorStoreSettings(baseSettings),
+    };
+}
+/**
+ * Implements serialize settings for the public runtime surface of this module.
+ */
+export function serializeSettings(settings, options = {}) {
+    const baseSettings = buildSerializeBaseSettings(settings);
+    const governance = resolveGovernanceKnobs(baseSettings);
+    const normalizedSchema = normalizeRuntimeSchemaSettings(baseSettings.schema);
+    const persistedFileBackedSections = resolvePersistedFileBackedSchemaSections(baseSettings, options.persist_source);
+    const normalizedSettings = buildNormalizedSettingsForSerialization(baseSettings, governance, normalizedSchema, persistedFileBackedSections);
+    const ordered = orderObject({
+        ...normalizedSettings,
+        governance: normalizeGovernanceForPersist(governance),
+    }, [
+        "version",
+        "id_prefix",
+        "author_default",
+        "item_format",
+        "locks",
+        "checkpoints",
+        "output",
+        "history",
+        "validation",
+        "governance",
+        "workflow",
+        "testing",
+        "telemetry",
+        "agent_guidance",
+        "item_types",
+        "schema",
+        "context",
+        "extensions",
+        "search",
+        "providers",
+        "vector_store",
+    ]);
+    orderSerializedSettingsSections(ordered);
     return `${JSON.stringify(ordered, null, 2)}\n`;
 }
 /**
@@ -1026,4 +1070,4 @@ export const settingsStoreTestOnly = {
     selectedSettingsReadCacheSignaturesEqual,
 };
 //# sourceMappingURL=settings.js.map
-//# debugId=76965ca9-e890-5aa2-a7ca-22f8d179dd5c
+//# debugId=4232868d-1e9d-51a3-abbe-3d9a3d1acae1