@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/core/store/settings.js

@@ -1,1310 +1,4 @@
-/**
- * @module core/store/settings
- *
- * 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]="5b95183e-9fd3-55cf-9059-8736f692e96e")}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";
-import { resolveAuthor } from "../shared/author.js";
-import { readFileIfExists } from "../fs/fs-utils.js";
-import { writeWorkspaceJsonWithHistory } from "../history/workspace-history.js";
-import { DEFAULT_RUNTIME_SCHEMA_FILE_PATHS, ensureRuntimeSchemaFileScaffold, filePathForSchemaSection, loadRuntimeSchemaFromOptionalFiles, normalizeRuntimeSchemaSettings, } from "../schema/runtime-schema.js";
-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");
-const MAX_VECTOR_STORE_COLLECTION_NAME_LENGTH = 128;
-const DUPLICATE_DETECTION_MODES = new Set(["off", "advisory", "strict"]);
-function resolveGovernanceKnobsFromPreset(preset) {
-    return structuredClone(GOVERNANCE_PRESET_DEFAULTS[preset]);
-}
-function normalizeGovernancePreset(value) {
-    if (value === "minimal" ||
-        value === "default" ||
-        value === "strict" ||
-        value === "custom") {
-        return value;
-    }
-    return SETTINGS_DEFAULTS.governance.preset;
-}
-// Create defaults, workflow enforcement, and duplicate detection are orthogonal to the
-// governance preset (they tune create/update behavior, not the preset knobs),
-// so they must survive a write regardless of preset — otherwise a project on a
-// non-custom preset would silently drop them on every settings write.
-function withGovernanceExtras(base, governance) {
-    const createDefaultType = typeof governance.create_default_type === "string"
-        ? governance.create_default_type.trim()
-        : undefined;
-    if (createDefaultType && createDefaultType.length > 0) {
-        base.create_default_type = createDefaultType;
-    }
-    if (governance.workflow_enforcement === "off" ||
-        governance.workflow_enforcement === "warn" ||
-        governance.workflow_enforcement === "strict") {
-        base.workflow_enforcement = governance.workflow_enforcement;
-    }
-    if (governance.require_close_reason === false) {
-        base.require_close_reason = false;
-    }
-    base.duplicate_detection_mode = governance.duplicate_detection_mode;
-    base.duplicate_detection_threshold = governance.duplicate_detection_threshold;
-    base.duplicate_detection_limit = governance.duplicate_detection_limit;
-    return base;
-}
-function normalizeGovernanceForPersist(governance) {
-    if (governance.preset === "custom") {
-        return withGovernanceExtras({
-            preset: "custom",
-            ownership_enforcement: governance.ownership_enforcement,
-            create_mode_default: governance.create_mode_default,
-            close_validation_default: governance.close_validation_default,
-            parent_reference: governance.parent_reference,
-            metadata_profile: governance.metadata_profile,
-            force_required_for_stale_lock: governance.force_required_for_stale_lock,
-        }, governance);
-    }
-    return withGovernanceExtras({
-        preset: governance.preset,
-    }, governance);
-}
-// Preset-orthogonal knobs that must be carried through resolve from the raw
-// governance regardless of preset (see normalizeGovernanceForPersist).
-function resolveGovernanceExtras(rawGovernance) {
-    const createDefaultType = typeof rawGovernance.create_default_type === "string"
-        ? rawGovernance.create_default_type.trim()
-        : undefined;
-    const extras = {};
-    if (createDefaultType && createDefaultType.length > 0) {
-        extras.create_default_type = createDefaultType;
-    }
-    if (rawGovernance.workflow_enforcement === "off" ||
-        rawGovernance.workflow_enforcement === "warn" ||
-        rawGovernance.workflow_enforcement === "strict") {
-        extras.workflow_enforcement = rawGovernance.workflow_enforcement;
-    }
-    if (typeof rawGovernance.require_close_reason === "boolean") {
-        extras.require_close_reason = rawGovernance.require_close_reason;
-    }
-    if (DUPLICATE_DETECTION_MODES.has(String(rawGovernance.duplicate_detection_mode))) {
-        extras.duplicate_detection_mode =
-            rawGovernance.duplicate_detection_mode;
-    }
-    const threshold = rawGovernance.duplicate_detection_threshold;
-    if ([
-        typeof threshold === "number",
-        Number.isFinite(threshold),
-        Number(threshold) >= 0,
-        Number(threshold) <= 1,
-    ].every(Boolean)) {
-        extras.duplicate_detection_threshold = threshold;
-    }
-    const limit = rawGovernance.duplicate_detection_limit;
-    if ([
-        typeof limit === "number",
-        Number.isSafeInteger(limit),
-        Number(limit) >= 0,
-        Number(limit) <= 20,
-    ].every(Boolean)) {
-        extras.duplicate_detection_limit = limit;
-    }
-    return extras;
-}
-/** Implements resolve governance knobs for the public runtime surface of this module. */
-export function resolveGovernanceKnobs(settings) {
-    const rawGovernance = settings.governance ?? {};
-    const preset = normalizeGovernancePreset(rawGovernance.preset);
-    const extras = resolveGovernanceExtras(rawGovernance);
-    if (preset === "custom") {
-        const baseline = resolveGovernanceKnobsFromPreset("default");
-        const requireCloseReason = extras.require_close_reason ?? baseline.require_close_reason;
-        return {
-            preset,
-            ownership_enforcement: rawGovernance.ownership_enforcement ?? baseline.ownership_enforcement,
-            create_mode_default: rawGovernance.create_mode_default ?? baseline.create_mode_default,
-            close_validation_default: rawGovernance.close_validation_default ??
-                baseline.close_validation_default,
-            parent_reference: rawGovernance.parent_reference ?? baseline.parent_reference,
-            metadata_profile: rawGovernance.metadata_profile ?? baseline.metadata_profile,
-            force_required_for_stale_lock: rawGovernance.force_required_for_stale_lock ??
-                baseline.force_required_for_stale_lock,
-            ...extras,
-            require_close_reason: requireCloseReason,
-            duplicate_detection_mode: extras.duplicate_detection_mode ?? baseline.duplicate_detection_mode,
-            duplicate_detection_threshold: extras.duplicate_detection_threshold ??
-                baseline.duplicate_detection_threshold,
-            duplicate_detection_limit: extras.duplicate_detection_limit ?? baseline.duplicate_detection_limit,
-        };
-    }
-    const baseline = resolveGovernanceKnobsFromPreset(preset);
-    const requireCloseReason = extras.require_close_reason ?? baseline.require_close_reason;
-    return {
-        preset,
-        ...baseline,
-        ...extras,
-        require_close_reason: requireCloseReason,
-    };
-}
-function cloneDefaults() {
-    return structuredClone(SETTINGS_DEFAULTS);
-}
-function normalizeSearchMutationRefreshPolicy(value) {
-    if (value === "cache_only" ||
-        value === "semantic_configured" ||
-        value === "semantic_auto") {
-        return value;
-    }
-    return SETTINGS_DEFAULTS.search.mutation_refresh_policy;
-}
-function normalizeSearchQueryExpansionEnabled(value) {
-    if (typeof value === "boolean") {
-        return value;
-    }
-    return SETTINGS_DEFAULTS.search.query_expansion.enabled;
-}
-function normalizeSearchQueryExpansionProvider(value) {
-    if (typeof value !== "string") {
-        return SETTINGS_DEFAULTS.search.query_expansion.provider;
-    }
-    return value.trim();
-}
-function normalizeSearchRerankEnabled(value) {
-    if (typeof value === "boolean") {
-        return value;
-    }
-    return SETTINGS_DEFAULTS.search.rerank.enabled;
-}
-function normalizeSearchRerankModel(value) {
-    if (typeof value !== "string") {
-        return SETTINGS_DEFAULTS.search.rerank.model;
-    }
-    return value.trim();
-}
-function normalizeSearchRerankTopK(value) {
-    if (typeof value === "number" &&
-        Number.isFinite(value) &&
-        Number.isInteger(value) &&
-        value > 0) {
-        return value;
-    }
-    return SETTINGS_DEFAULTS.search.rerank.top_k;
-}
-function normalizeVectorStoreCollectionName(value) {
-    if (typeof value !== "string") {
-        return SETTINGS_DEFAULTS.vector_store.collection_name;
-    }
-    const sanitized = value.trim().replaceAll(/[^a-zA-Z0-9_-]/g, "_");
-    const truncated = sanitized.slice(0, MAX_VECTOR_STORE_COLLECTION_NAME_LENGTH);
-    return truncated.length > 0
-        ? truncated
-        : SETTINGS_DEFAULTS.vector_store.collection_name;
-}
-function cloneOptionalArray(value) {
-    return {
-        present: Array.isArray(value),
-        values: Array.isArray(value) ? structuredClone(value) : [],
-    };
-}
-function buildSettingsPersistSourceSnapshot(parsedSettings, runtimeSettings) {
-    const sourceSchema = parsedSettings.schema;
-    const sourceStatuses = cloneOptionalArray(sourceSchema?.statuses);
-    const sourceFields = cloneOptionalArray(sourceSchema?.fields);
-    const sourceTypeWorkflows = cloneOptionalArray(sourceSchema?.type_workflows);
-    return {
-        source_settings: structuredClone(parsedSettings),
-        has_source_item_type_definitions: Array.isArray(parsedSettings.item_types?.definitions),
-        source_item_type_definitions: normalizeItemTypeDefinitions(parsedSettings.item_types?.definitions),
-        has_source_schema_statuses: sourceStatuses.present,
-        source_schema_statuses: sourceStatuses.values,
-        has_source_schema_fields: sourceFields.present,
-        source_schema_fields: sourceFields.values,
-        has_source_schema_type_workflows: sourceTypeWorkflows.present,
-        source_schema_type_workflows: sourceTypeWorkflows.values,
-        runtime_item_type_definitions: normalizeItemTypeDefinitions(runtimeSettings.item_types?.definitions),
-        runtime_schema_statuses: structuredClone(runtimeSettings.schema.statuses),
-        runtime_schema_fields: structuredClone(runtimeSettings.schema.fields),
-        runtime_schema_type_workflows: structuredClone(runtimeSettings.schema.type_workflows ?? []),
-    };
-}
-function attachSettingsPersistSourceSnapshot(settings, source) {
-    Object.defineProperty(settings, SETTINGS_PERSIST_SOURCE_SYMBOL, {
-        value: source,
-        writable: true,
-        configurable: true,
-        enumerable: false,
-    });
-}
-function getSettingsPersistSourceSnapshot(settings) {
-    const candidate = settings[SETTINGS_PERSIST_SOURCE_SYMBOL];
-    if (!candidate || typeof candidate !== "object") {
-        return undefined;
-    }
-    return candidate;
-}
-/**
- * Mark the runtime-selected item format as intentional persisted state while
- * preserving every other default-backed setting as a sparse omission.
- */
-export function persistSelectedItemFormat(settings) {
-    const source = getSettingsPersistSourceSnapshot(settings);
-    if (source) {
-        const detachedSource = structuredClone(source);
-        detachedSource.source_settings.item_format = settings.item_format;
-        attachSettingsPersistSourceSnapshot(settings, detachedSource);
-    }
-}
-function cloneSettingsReadResult(result) {
-    const clonedSettings = structuredClone(result.settings);
-    const persistSource = getSettingsPersistSourceSnapshot(result.settings);
-    if (persistSource) {
-        attachSettingsPersistSourceSnapshot(clonedSettings, persistSource);
-    }
-    return {
-        settings: clonedSettings,
-        metadata: {
-            has_explicit_item_format: result.metadata.has_explicit_item_format,
-        },
-        warnings: [...result.warnings],
-    };
-}
-function resolveSettingsReadTrackedPaths(pmRoot, schema, settingsPath) {
-    const normalizedSchema = normalizeRuntimeSchemaSettings(schema);
-    return [
-        settingsPath,
-        filePathForSchemaSection(pmRoot, normalizedSchema.files.types, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types),
-        filePathForSchemaSection(pmRoot, normalizedSchema.files.statuses, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.statuses),
-        filePathForSchemaSection(pmRoot, normalizedSchema.files.fields, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.fields),
-        filePathForSchemaSection(pmRoot, normalizedSchema.files.workflows, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.workflows),
-    ];
-}
-async function cacheSettingsReadResult(pmRoot, trackedPaths, result) {
-    const signatures = await collectSettingsReadCacheSignatures(trackedPaths);
-    setSettingsReadCacheEntry(pmRoot, {
-        tracked_paths: trackedPaths,
-        signatures,
-        value: cloneSettingsReadResult(result),
-    });
-}
-async function cacheSettingsReadResultSafe(pmRoot, trackedPaths, result) {
-    try {
-        await cacheSettingsReadResult(pmRoot, trackedPaths, result);
-    }
-    catch {
-        clearSettingsReadCache(pmRoot);
-    }
-}
-function findSettingsReadCacheSignature(signatures, targetPath) {
-    return signatures.find((signature) => signature.path === targetPath);
-}
-function selectedSettingsReadCacheSignaturesEqual(before, after, targetPaths) {
-    for (const targetPath of targetPaths) {
-        const beforeSignature = findSettingsReadCacheSignature(before, targetPath);
-        const afterSignature = findSettingsReadCacheSignature(after, targetPath);
-        if (!beforeSignature ||
-            !afterSignature ||
-            !settingsReadCacheSignaturesEqual([beforeSignature], [afterSignature])) {
-            return false;
-        }
-    }
-    return true;
-}
-async function cacheSettingsReadResultIfStable(pmRoot, trackedPaths, result, stableSignatures, stablePaths) {
-    try {
-        const currentSignatures = await collectSettingsReadCacheSignatures(trackedPaths);
-        if (!selectedSettingsReadCacheSignaturesEqual(stableSignatures, currentSignatures, stablePaths)) {
-            clearSettingsReadCache(pmRoot);
-            return;
-        }
-        setSettingsReadCacheEntry(pmRoot, {
-            tracked_paths: trackedPaths,
-            signatures: currentSignatures,
-            value: cloneSettingsReadResult(result),
-        });
-    }
-    catch {
-        clearSettingsReadCache(pmRoot);
-    }
-}
-function resolvePersistedFileBackedSchemaSections(settings, source) {
-    const normalizedSchema = normalizeRuntimeSchemaSettings(settings.schema);
-    const currentItemTypeDefinitions = normalizeItemTypeDefinitions(settings.item_types?.definitions);
-    if (!source) {
-        return {
-            item_type_definitions: currentItemTypeDefinitions,
-            schema_statuses: normalizedSchema.statuses,
-            schema_fields: normalizedSchema.fields,
-            schema_type_workflows: normalizedSchema.type_workflows,
-        };
-    }
-    const currentTypeWorkflows = normalizedSchema.type_workflows ?? [];
-    const itemTypeDefinitionsUnchanged = stableValueEquals(currentItemTypeDefinitions, source.runtime_item_type_definitions);
-    const schemaStatusesUnchanged = stableValueEquals(normalizedSchema.statuses, source.runtime_schema_statuses);
-    const schemaFieldsUnchanged = stableValueEquals(normalizedSchema.fields, source.runtime_schema_fields);
-    const schemaTypeWorkflowsUnchanged = stableValueEquals(currentTypeWorkflows, source.runtime_schema_type_workflows);
-    return {
-        item_type_definitions: itemTypeDefinitionsUnchanged
-            ? source.has_source_item_type_definitions
-                ? normalizeItemTypeDefinitions(source.source_item_type_definitions)
-                : []
-            : currentItemTypeDefinitions,
-        schema_statuses: schemaStatusesUnchanged
-            ? source.has_source_schema_statuses
-                ? structuredClone(source.source_schema_statuses)
-                : []
-            : normalizedSchema.statuses,
-        schema_fields: schemaFieldsUnchanged
-            ? source.has_source_schema_fields
-                ? structuredClone(source.source_schema_fields)
-                : []
-            : normalizedSchema.fields,
-        schema_type_workflows: schemaTypeWorkflowsUnchanged
-            ? source.has_source_schema_type_workflows
-                ? structuredClone(source.source_schema_type_workflows)
-                : undefined
-            : normalizedSchema.type_workflows,
-    };
-}
-function buildFallbackSettingsReadResult(warning) {
-    return {
-        settings: cloneDefaults(),
-        metadata: {
-            has_explicit_item_format: false,
-        },
-        warnings: warning ? [warning] : [],
-    };
-}
-function hasExplicitItemFormat(raw) {
-    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-        return false;
-    }
-    const itemFormat = raw.item_format;
-    return itemFormat === "toon" || itemFormat === "json_markdown";
-}
-function normalizeStringList(values) {
-    return [
-        ...new Set((values ?? [])
-            .map((value) => value.trim())
-            .filter((value) => value.length > 0)),
-    ].sort((left, right) => left.localeCompare(right));
-}
-function normalizeAgentGuidanceSettings(value) {
-    const defaults = SETTINGS_DEFAULTS.agent_guidance;
-    const templateVersion = value?.template_version;
-    return {
-        prompt_completed: value?.prompt_completed === true,
-        declined: value?.declined === true,
-        declined_at: typeof value?.declined_at === "string"
-            ? value.declined_at
-            : defaults.declined_at,
-        template_version: typeof templateVersion === "number" &&
-            Number.isInteger(templateVersion) &&
-            templateVersion > 0
-            ? templateVersion
-            : defaults.template_version,
-        last_checked_files: normalizeStringList(value?.last_checked_files ?? defaults.last_checked_files),
-    };
-}
-function normalizeLowerStringList(values) {
-    return [
-        ...new Set((values ?? [])
-            .map((value) => value.trim().toLowerCase())
-            .filter((value) => value.length > 0)),
-    ].sort((left, right) => left.localeCompare(right));
-}
-function normalizeExtensionPolicyMode(value) {
-    if (value === "off" || value === "warn" || value === "enforce") {
-        return value;
-    }
-    return SETTINGS_DEFAULTS.extensions.policy.mode;
-}
-function normalizeExtensionTrustMode(value) {
-    if (value === "off" || value === "warn" || value === "enforce") {
-        return value;
-    }
-    return SETTINGS_DEFAULTS.extensions.policy.trust_mode;
-}
-function normalizeExtensionSandboxProfile(value) {
-    if (value === "none" || value === "restricted" || value === "strict") {
-        return value;
-    }
-    return SETTINGS_DEFAULTS.extensions.policy.default_sandbox_profile;
-}
-function normalizeExtensionPolicyOverride(override) {
-    const name = override.name.trim().toLowerCase();
-    if (name.length === 0) {
-        return null;
-    }
-    const normalized = {
-        name,
-    };
-    if (override.disabled === true) {
-        normalized.disabled = true;
-    }
-    if (override.require_trusted === true) {
-        normalized.require_trusted = true;
-    }
-    if (override.require_provenance === true) {
-        normalized.require_provenance = true;
-    }
-    if (override.sandbox_profile !== undefined) {
-        normalized.sandbox_profile = normalizeExtensionSandboxProfile(override.sandbox_profile);
-    }
-    const allowedCapabilities = normalizeLowerStringList(override.allowed_capabilities);
-    const blockedCapabilities = normalizeLowerStringList(override.blocked_capabilities);
-    const allowedSurfaces = normalizeLowerStringList(override.allowed_surfaces);
-    const blockedSurfaces = normalizeLowerStringList(override.blocked_surfaces);
-    const allowedCommands = normalizeLowerStringList(override.allowed_commands);
-    const blockedCommands = normalizeLowerStringList(override.blocked_commands);
-    const allowedActions = normalizeLowerStringList(override.allowed_actions);
-    const blockedActions = normalizeLowerStringList(override.blocked_actions);
-    const allowedServices = normalizeLowerStringList(override.allowed_services);
-    const blockedServices = normalizeLowerStringList(override.blocked_services);
-    if (allowedCapabilities.length > 0) {
-        normalized.allowed_capabilities = allowedCapabilities;
-    }
-    if (blockedCapabilities.length > 0) {
-        normalized.blocked_capabilities = blockedCapabilities;
-    }
-    if (allowedSurfaces.length > 0) {
-        normalized.allowed_surfaces = allowedSurfaces;
-    }
-    if (blockedSurfaces.length > 0) {
-        normalized.blocked_surfaces = blockedSurfaces;
-    }
-    if (allowedCommands.length > 0) {
-        normalized.allowed_commands = allowedCommands;
-    }
-    if (blockedCommands.length > 0) {
-        normalized.blocked_commands = blockedCommands;
-    }
-    if (allowedActions.length > 0) {
-        normalized.allowed_actions = allowedActions;
-    }
-    if (blockedActions.length > 0) {
-        normalized.blocked_actions = blockedActions;
-    }
-    if (allowedServices.length > 0) {
-        normalized.allowed_services = allowedServices;
-    }
-    if (blockedServices.length > 0) {
-        normalized.blocked_services = blockedServices;
-    }
-    return normalized;
-}
-function normalizeExtensionPolicyOverrides(overrides) {
-    const dedupedByName = new Map();
-    for (const override of overrides ?? []) {
-        const normalized = normalizeExtensionPolicyOverride(override);
-        if (!normalized) {
-            continue;
-        }
-        dedupedByName.set(normalized.name, normalized);
-    }
-    return [...dedupedByName.values()].sort((left, right) => left.name.localeCompare(right.name));
-}
-function normalizePmMaxVersionExceededModeValue(value) {
-    return value === "block" || value === "warn" ? value : undefined;
-}
-/** 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"). */
-function normalizePmMaxVersionExceededModeSetting(value) {
-    if (typeof value === "string") {
-        return normalizePmMaxVersionExceededModeValue(value);
-    }
-    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
-        const global = normalizePmMaxVersionExceededModeValue(value.global);
-        const project = normalizePmMaxVersionExceededModeValue(value.project);
-        if (global === undefined && project === undefined) {
-            return undefined;
-        }
-        return {
-            ...(global !== undefined ? { global } : {}),
-            ...(project !== undefined ? { project } : {}),
-        };
-    }
-    return undefined;
-}
-function normalizeExtensionPolicyList(policy, key) {
-    return normalizeLowerStringList(policy?.[key] ?? SETTINGS_DEFAULTS.extensions.policy[key]);
-}
-function normalizeExtensionPolicySettings(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: normalizeExtensionPolicyList(policy, "trusted_extensions"),
-        default_sandbox_profile: normalizeExtensionSandboxProfile(policy?.default_sandbox_profile),
-        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) {
-    const normalized = [
-        ...new Set((values ?? []).map((value) => value.trim().toLowerCase().replaceAll("-", "_"))),
-    ]
-        .filter((value) => value.length > 0)
-        .sort((left, right) => left.localeCompare(right));
-    return normalized.filter((value) => [
-        "author",
-        "acceptance_criteria",
-        "estimated_minutes",
-        "close_reason",
-        "reviewer",
-        "risk",
-        "confidence",
-        "sprint",
-        "release",
-    ].includes(value));
-}
-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 : [];
-}
-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. */
-export function normalizeItemTypeDefinitions(definitions) {
-    const normalized = (definitions ?? [])
-        .map((definition) => normalizeItemTypeDefinition(definition))
-        .filter((definition) => definition !== null);
-    const dedupedByName = new Map();
-    for (const definition of normalized) {
-        dedupedByName.set(definition.name.toLowerCase(), definition);
-    }
-    return [...dedupedByName.values()].sort((left, right) => left.name.localeCompare(right.name));
-}
-function mergeSettings(settings) {
-    const defaults = cloneDefaults();
-    const governance = resolveGovernanceKnobs({
-        governance: settings.governance ?? { preset: "default" },
-    });
-    return {
-        ...defaults,
-        ...settings,
-        item_format: normalizeSettingsItemFormat(settings, defaults),
-        locks: { ...defaults.locks, ...settings.locks },
-        ids: { ...defaults.ids, ...settings.ids },
-        agent_identity: structuredClone(settings.agent_identity ?? defaults.agent_identity),
-        mutation_guard: {
-            ...defaults.mutation_guard,
-            ...settings.mutation_guard,
-        },
-        checkpoints: { ...defaults.checkpoints, ...settings.checkpoints },
-        output: { ...defaults.output, ...settings.output },
-        ux: { ...defaults.ux, ...settings.ux },
-        history: {
-            ...defaults.history,
-            ...settings.history,
-            compact_policy: {
-                ...defaults.history.compact_policy,
-                ...settings.history?.compact_policy,
-            },
-        },
-        validation: buildValidationSettings(settings, defaults, governance),
-        governance,
-        workflow: {
-            definition_of_done: [
-                ...(settings.workflow?.definition_of_done ??
-                    defaults.workflow.definition_of_done),
-            ],
-        },
-        testing: {
-            record_results_to_items: settings.testing?.record_results_to_items ??
-                defaults.testing.record_results_to_items,
-            allow_untrusted_linked_tests: settings.testing?.allow_untrusted_linked_tests ??
-                defaults.testing.allow_untrusted_linked_tests,
-        },
-        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: buildContextSettings(settings, defaults),
-        extensions: {
-            enabled: [...settings.extensions.enabled],
-            disabled: [...settings.extensions.disabled],
-            policy: normalizeExtensionPolicySettings(settings.extensions.policy ?? defaults.extensions.policy),
-        },
-        search: buildSearchSettings(settings, defaults),
-        providers: buildProviderSettings(settings, defaults),
-        vector_store: buildVectorStoreSettings(settings, defaults),
-    };
-}
-function orderSerializedSettingsSections(ordered) {
-    ordered.agent_identity = orderObject(ordered.agent_identity, ["probes_enabled", "identity_vocabulary", "harness_signals"]);
-    const orderedAgentIdentity = ordered.agent_identity;
-    if (Object.hasOwn(orderedAgentIdentity, "identity_vocabulary")) {
-        orderedAgentIdentity.identity_vocabulary = orderObject(recordOrEmpty(orderedAgentIdentity.identity_vocabulary), ["version", "aliases"]);
-    }
-    ordered.agent_identity.harness_signals =
-        arrayOrEmpty(ordered.agent_identity.harness_signals).map((entry) => orderObject(recordOrEmpty(entry), [
-            "harness",
-            "environment_keys",
-            "model_environment_keys",
-            "session_environment_keys",
-            "provenance_environment_keys",
-            "provenance_resolvers",
-            "provenance_unavailable_dimensions",
-            "argv_markers",
-            "client_names",
-        ]));
-    ordered.locks = orderObject(ordered.locks, [
-        "ttl_seconds",
-        "wait_ms",
-    ]);
-    ordered.ids = orderObject(ordered.ids, [
-        "token_length",
-    ]);
-    ordered.mutation_guard = orderObject(ordered.mutation_guard, ["require_attributed_author", "secret_guard", "stale_in_progress_hours"]);
-    ordered.checkpoints = orderObject(ordered.checkpoints, ["retention_days"]);
-    ordered.output = orderObject(ordered.output, [
-        "default_format",
-    ]);
-    ordered.ux = orderObject(ordered.ux, [
-        "deprecation_hints",
-    ]);
-    ordered.history = orderObject(ordered.history, [
-        "missing_stream",
-        "compact_policy",
-    ]);
-    ordered.validation = orderObject(ordered.validation, [
-        "sprint_release_format",
-        "parent_reference",
-        "metadata_profile",
-        "metadata_required_fields",
-        "lifecycle_stale_blocker_reason_patterns",
-        "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",
-        "ownership_enforcement",
-        "create_mode_default",
-        "close_validation_default",
-        "require_close_reason",
-        "parent_reference",
-        "metadata_profile",
-        "force_required_for_stale_lock",
-        "create_default_type",
-        "workflow_enforcement",
-        "duplicate_detection_mode",
-        "duplicate_detection_threshold",
-        "duplicate_detection_limit",
-    ]);
-    ordered.workflow = orderObject(ordered.workflow, [
-        "definition_of_done",
-    ]);
-    ordered.testing = orderObject(ordered.testing, [
-        "record_results_to_items",
-        "allow_untrusted_linked_tests",
-    ]);
-    ordered.telemetry = orderObject(ordered.telemetry, [
-        "enabled",
-        "first_run_prompt_completed",
-        "capture_level",
-        "endpoint",
-        "installation_id",
-        "retention_days",
-    ]);
-    ordered.agent_guidance = orderObject(ordered.agent_guidance, [
-        "prompt_completed",
-        "declined",
-        "declined_at",
-        "template_version",
-        "last_checked_files",
-    ]);
-    ordered.item_types = orderObject(ordered.item_types, ["definitions"]);
-    ordered.schema = orderObject(ordered.schema, [
-        "version",
-        "files",
-        "statuses",
-        "fields",
-        "workflow",
-        "type_workflows",
-        "unknown_field_policy",
-    ]);
-    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(recordOrEmpty(ordered.context.sections), [
-        "hierarchy",
-        "activity",
-        "progress",
-        "blockers",
-        "files",
-        "workload",
-        "staleness",
-        "tests",
-    ]);
-    ordered.extensions = orderObject(ordered.extensions, ["enabled", "disabled", "policy"]);
-    ordered.extensions.policy = orderObject(recordOrEmpty(ordered.extensions.policy), [
-        "mode",
-        "trust_mode",
-        "pm_max_version_exceeded_mode",
-        "require_provenance",
-        "trusted_extensions",
-        "default_sandbox_profile",
-        "allowed_extensions",
-        "blocked_extensions",
-        "allowed_capabilities",
-        "blocked_capabilities",
-        "allowed_surfaces",
-        "blocked_surfaces",
-        "allowed_commands",
-        "blocked_commands",
-        "allowed_actions",
-        "blocked_actions",
-        "allowed_services",
-        "blocked_services",
-        "extension_overrides",
-    ]);
-    ordered.extensions.policy.extension_overrides = arrayOrEmpty(ordered.extensions.policy.extension_overrides).map((entry) => orderObject(recordOrEmpty(entry), [
-        "name",
-        "disabled",
-        "require_trusted",
-        "require_provenance",
-        "sandbox_profile",
-        "allowed_capabilities",
-        "blocked_capabilities",
-        "allowed_surfaces",
-        "blocked_surfaces",
-        "allowed_commands",
-        "blocked_commands",
-        "allowed_actions",
-        "blocked_actions",
-        "allowed_services",
-        "blocked_services",
-    ]));
-    ordered.search = orderObject(ordered.search, [
-        "score_threshold",
-        "hybrid_semantic_weight",
-        "max_results",
-        "embedding_model",
-        "embedding_corpus_max_characters",
-        "embedding_batch_size",
-        "embedding_timeout_ms",
-        "scanner_max_batch_retries",
-        "provider",
-        "mutation_refresh_policy",
-        "query_expansion",
-        "rerank",
-    ]);
-    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(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(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),
-        ids: valueOrDefault(settings.ids, SETTINGS_DEFAULTS.ids),
-        agent_identity: valueOrDefault(settings.agent_identity, SETTINGS_DEFAULTS.agent_identity),
-        mutation_guard: valueOrDefault(settings.mutation_guard, SETTINGS_DEFAULTS.mutation_guard),
-        checkpoints: valueOrDefault(settings.checkpoints, SETTINGS_DEFAULTS.checkpoints),
-        output: valueOrDefault(settings.output, SETTINGS_DEFAULTS.output),
-        ux: valueOrDefault(settings.ux, SETTINGS_DEFAULTS.ux),
-        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),
-    };
-}
-function applySettingsDelta(target, baseline, current) {
-    const keys = new Set([...Object.keys(baseline), ...Object.keys(current)]);
-    for (const key of keys) {
-        const before = baseline[key];
-        const after = current[key];
-        if (stableValueEquals(before, after))
-            continue;
-        if (after === undefined) {
-            delete target[key];
-            continue;
-        }
-        if (typeof before === "object" &&
-            before !== null &&
-            !Array.isArray(before) &&
-            typeof after === "object" &&
-            after !== null &&
-            !Array.isArray(after)) {
-            const existing = target[key];
-            const nestedTarget = typeof existing === "object" &&
-                existing !== null &&
-                !Array.isArray(existing)
-                ? existing
-                : {};
-            applySettingsDelta(nestedTarget, before, after);
-            if (Object.keys(nestedTarget).length > 0)
-                target[key] = nestedTarget;
-            else
-                delete target[key];
-            continue;
-        }
-        target[key] = structuredClone(after);
-    }
-}
-const SETTINGS_TOP_LEVEL_KEY_ORDER = [
-    "version",
-    "id_prefix",
-    "ids",
-    "author_default",
-    "agent_identity",
-    "mutation_guard",
-    "item_format",
-    "locks",
-    "checkpoints",
-    "output",
-    "ux",
-    "history",
-    "validation",
-    "governance",
-    "workflow",
-    "testing",
-    "telemetry",
-    "agent_guidance",
-    "item_types",
-    "schema",
-    "context",
-    "extensions",
-    "search",
-    "providers",
-    "vector_store",
-];
-function buildOrderedSettingsForSerialization(settings, persistSource) {
-    const baseSettings = buildSerializeBaseSettings(settings);
-    const governance = resolveGovernanceKnobs(baseSettings);
-    const normalizedSchema = normalizeRuntimeSchemaSettings(baseSettings.schema);
-    const persistedFileBackedSections = resolvePersistedFileBackedSchemaSections(baseSettings, persistSource);
-    const normalizedSettings = buildNormalizedSettingsForSerialization(baseSettings, governance, normalizedSchema, persistedFileBackedSections);
-    const ordered = orderObject({
-        ...normalizedSettings,
-        governance: normalizeGovernanceForPersist(governance),
-    }, SETTINGS_TOP_LEVEL_KEY_ORDER);
-    orderSerializedSettingsSections(ordered);
-    return ordered;
-}
-/** Implements serialize settings for the public runtime surface of this module. */
-export function serializeSettings(settings, options = {}) {
-    const ordered = buildOrderedSettingsForSerialization(settings, options.persist_source);
-    if (options.persist_source) {
-        const baselineSettings = mergeSettings(options.persist_source.source_settings);
-        baselineSettings.item_types = {
-            definitions: structuredClone(options.persist_source.runtime_item_type_definitions),
-        };
-        baselineSettings.schema = {
-            ...baselineSettings.schema,
-            statuses: structuredClone(options.persist_source.runtime_schema_statuses),
-            fields: structuredClone(options.persist_source.runtime_schema_fields),
-            type_workflows: structuredClone(options.persist_source.runtime_schema_type_workflows),
-        };
-        const baseline = buildOrderedSettingsForSerialization(baselineSettings, options.persist_source);
-        const sparse = structuredClone(options.persist_source.source_settings);
-        applySettingsDelta(sparse, baseline, ordered);
-        return `${JSON.stringify(orderObject(sparse, SETTINGS_TOP_LEVEL_KEY_ORDER), null, 2)}\n`;
-    }
-    return `${JSON.stringify(ordered, null, 2)}\n`;
-}
-/** Implements read settings with metadata for the public runtime surface of this module. */
-export async function readSettingsWithMetadata(pmRoot) {
-    const settingsPath = getSettingsPath(pmRoot);
-    let trackedPathsForFailure = [settingsPath];
-    await runActiveOnReadHooks({
-        path: settingsPath,
-        scope: "project",
-    });
-    const cachedResult = getSettingsReadCacheEntry(pmRoot);
-    if (cachedResult) {
-        const currentSignatures = await collectSettingsReadCacheSignatures(cachedResult.tracked_paths);
-        if (settingsReadCacheSignaturesEqual(currentSignatures, cachedResult.signatures)) {
-            return cloneSettingsReadResult(cachedResult.value);
-        }
-    }
-    const settingsOnlySignatures = await collectSettingsReadCacheSignatures([
-        settingsPath,
-    ]);
-    let raw;
-    try {
-        raw = await readFileIfExists(settingsPath);
-    }
-    catch {
-        return buildFallbackSettingsReadResult("settings_read_fs_error");
-    }
-    if (raw === null) {
-        const fallback = buildFallbackSettingsReadResult();
-        await cacheSettingsReadResultIfStable(pmRoot, [settingsPath], fallback, settingsOnlySignatures, [settingsPath]);
-        return fallback;
-    }
-    const settingsSignaturesAfterRead = await collectSettingsReadCacheSignatures([
-        settingsPath,
-    ]);
-    if (!settingsReadCacheSignaturesEqual(settingsOnlySignatures, settingsSignaturesAfterRead)) {
-        clearSettingsReadCache(pmRoot);
-        return readSettingsWithMetadata(pmRoot);
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        const fallback = buildFallbackSettingsReadResult("settings_read_invalid_json");
-        await cacheSettingsReadResultIfStable(pmRoot, [settingsPath], fallback, settingsSignaturesAfterRead, [settingsPath]);
-        return fallback;
-    }
-    const validated = validateSettings(parsed);
-    if (!validated.success) {
-        const fallback = buildFallbackSettingsReadResult("settings_read_invalid_schema");
-        await cacheSettingsReadResultIfStable(pmRoot, [settingsPath], fallback, settingsSignaturesAfterRead, [settingsPath]);
-        return fallback;
-    }
-    try {
-        const mergedSettings = mergeSettings(validated.data);
-        const trackedPaths = resolveSettingsReadTrackedPaths(pmRoot, mergedSettings.schema, settingsPath);
-        trackedPathsForFailure = trackedPaths;
-        const signaturesBeforeSchemaLoad = await collectSettingsReadCacheSignatures(trackedPaths);
-        const schemaScaffold = await ensureRuntimeSchemaFileScaffold(pmRoot, mergedSettings.schema);
-        const loadedSchemaSections = await loadRuntimeSchemaFromOptionalFiles(pmRoot, mergedSettings.schema);
-        const signaturesAfterSchemaLoad = await collectSettingsReadCacheSignatures(trackedPaths);
-        const settings = {
-            ...mergedSettings,
-            item_types: {
-                definitions: normalizeItemTypeDefinitions([
-                    ...mergedSettings.item_types.definitions,
-                    ...arrayOrEmpty(loadedSchemaSections.type_definitions_from_file),
-                ]),
-            },
-            schema: loadedSchemaSections.schema,
-        };
-        attachSettingsPersistSourceSnapshot(settings, buildSettingsPersistSourceSnapshot(validated.data, settings));
-        const result = {
-            settings,
-            metadata: {
-                has_explicit_item_format: hasExplicitItemFormat(parsed),
-            },
-            warnings: [
-                ...(validated.data.item_format === "json_markdown"
-                    ? ["settings_item_format_legacy_json_markdown_coerced_to_toon"]
-                    : []),
-                ...schemaScaffold.created_paths.map((createdPath) => `runtime_schema_bootstrap_created:${createdPath}`),
-                ...loadedSchemaSections.warnings,
-            ],
-        };
-        if (schemaScaffold.created_paths.length === 0) {
-            if (!settingsReadCacheSignaturesEqual(signaturesBeforeSchemaLoad, signaturesAfterSchemaLoad)) {
-                clearSettingsReadCache(pmRoot);
-            }
-            else {
-                setSettingsReadCacheEntry(pmRoot, {
-                    tracked_paths: trackedPaths,
-                    signatures: signaturesAfterSchemaLoad,
-                    value: cloneSettingsReadResult(result),
-                });
-            }
-        }
-        else {
-            // Bootstrap warnings are intentionally one-shot and should not be replayed from cache.
-            clearSettingsReadCache(pmRoot);
-        }
-        return result;
-    }
-    catch {
-        const fallback = buildFallbackSettingsReadResult("settings_read_merge_failed");
-        await cacheSettingsReadResultSafe(pmRoot, trackedPathsForFailure, fallback);
-        return fallback;
-    }
-}
-/** Implements read settings for the public runtime surface of this module. */
-export async function readSettings(pmRoot) {
-    return (await readSettingsWithMetadata(pmRoot)).settings;
-}
-/** Implements write settings for the public runtime surface of this module. */
-export async function writeSettings(pmRoot, settings, op = SETTINGS_WRITE_OP) {
-    const settingsPath = getSettingsPath(pmRoot);
-    const afterRaw = serializeSettings(settings, {
-        persist_source: getSettingsPersistSourceSnapshot(settings),
-    });
-    try {
-        await writeWorkspaceJsonWithHistory({
-            pmRoot,
-            filePath: settingsPath,
-            raw: afterRaw,
-            op,
-            author: resolveAuthor(undefined, settings.author_default),
-            lockTtlSeconds: settings.locks.ttl_seconds,
-            lockWaitMs: settings.locks.wait_ms,
-            recordCreation: false,
-        });
-        await runActiveOnWriteHooks({
-            path: settingsPath,
-            scope: "project",
-            op,
-        });
-    }
-    finally {
-        clearSettingsReadCache(pmRoot);
-    }
-}
-/** Public contract for settings store test only, shared by SDK and presentation-layer consumers. */
-export const settingsStoreTestOnly = {
-    applySettingsDelta,
-    hasExplicitItemFormat,
-    buildSettingsPersistSourceSnapshot,
-    cacheSettingsReadResultIfStable,
-    cacheSettingsReadResultSafe,
-    mergeSettings,
-    normalizeExtensionPolicySettings,
-    normalizeExtensionPolicyOverride,
-    normalizeExtensionPolicyOverrides,
-    normalizeExtensionPolicyMode,
-    normalizePmMaxVersionExceededModeSetting,
-    normalizeExtensionSandboxProfile,
-    normalizeExtensionTrustMode,
-    normalizeLowerStringList,
-    normalizeStringList,
-    valueOrDefault,
-    arrayOrEmpty,
-    normalizeValidationPatternList,
-    normalizeValidationMetadataRequiredFields,
-    resolveSettingsReadTrackedPaths,
-    resolvePersistedFileBackedSchemaSections,
-    selectedSettingsReadCacheSignaturesEqual,
-};
+!(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]="9c6acf02-5259-51f7-bbda-f3967ed0ab74")}catch(e2){}})();import{validateSettings}from"./settings-validator.js";import{runActiveOnReadHooks,runActiveOnWriteHooks}from"../extensions/index.js";import{GOVERNANCE_PRESET_DEFAULTS,SETTINGS_DEFAULTS}from"../shared/constants.js";import{resolveAuthor}from"../shared/author.js";import{readFileIfExists}from"../fs/fs-utils.js";import{writeWorkspaceJsonWithHistory}from"../history/workspace-history.js";import{DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,ensureRuntimeSchemaFileScaffold,filePathForSchemaSection,loadRuntimeSchemaFromOptionalFiles,normalizeRuntimeSchemaSettings}from"../schema/runtime-schema.js";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");const MAX_VECTOR_STORE_COLLECTION_NAME_LENGTH=128;const DUPLICATE_DETECTION_MODES=new Set(["off","advisory","strict"]);function resolveGovernanceKnobsFromPreset(preset){return structuredClone(GOVERNANCE_PRESET_DEFAULTS[preset])}function normalizeGovernancePreset(value){if(value==="minimal"||value==="default"||value==="strict"||value==="custom"){return value}return SETTINGS_DEFAULTS.governance.preset}function withGovernanceExtras(base,governance){const createDefaultType=typeof governance.create_default_type==="string"?governance.create_default_type.trim():void 0;if(createDefaultType&&createDefaultType.length>0){base.create_default_type=createDefaultType}if(governance.workflow_enforcement==="off"||governance.workflow_enforcement==="warn"||governance.workflow_enforcement==="strict"){base.workflow_enforcement=governance.workflow_enforcement}if(governance.require_close_reason===false){base.require_close_reason=false}base.duplicate_detection_mode=governance.duplicate_detection_mode;base.duplicate_detection_threshold=governance.duplicate_detection_threshold;base.duplicate_detection_limit=governance.duplicate_detection_limit;return base}function normalizeGovernanceForPersist(governance){if(governance.preset==="custom"){return withGovernanceExtras({preset:"custom",ownership_enforcement:governance.ownership_enforcement,create_mode_default:governance.create_mode_default,close_validation_default:governance.close_validation_default,parent_reference:governance.parent_reference,metadata_profile:governance.metadata_profile,force_required_for_stale_lock:governance.force_required_for_stale_lock},governance)}return withGovernanceExtras({preset:governance.preset},governance)}function resolveGovernanceExtras(rawGovernance){const createDefaultType=typeof rawGovernance.create_default_type==="string"?rawGovernance.create_default_type.trim():void 0;const extras={};if(createDefaultType&&createDefaultType.length>0){extras.create_default_type=createDefaultType}if(rawGovernance.workflow_enforcement==="off"||rawGovernance.workflow_enforcement==="warn"||rawGovernance.workflow_enforcement==="strict"){extras.workflow_enforcement=rawGovernance.workflow_enforcement}if(typeof rawGovernance.require_close_reason==="boolean"){extras.require_close_reason=rawGovernance.require_close_reason}if(DUPLICATE_DETECTION_MODES.has(String(rawGovernance.duplicate_detection_mode))){extras.duplicate_detection_mode=rawGovernance.duplicate_detection_mode}const threshold=rawGovernance.duplicate_detection_threshold;if([typeof threshold==="number",Number.isFinite(threshold),Number(threshold)>=0,Number(threshold)<=1].every(Boolean)){extras.duplicate_detection_threshold=threshold}const limit=rawGovernance.duplicate_detection_limit;if([typeof limit==="number",Number.isSafeInteger(limit),Number(limit)>=0,Number(limit)<=20].every(Boolean)){extras.duplicate_detection_limit=limit}return extras}function resolveGovernanceKnobs(settings){const rawGovernance=settings.governance??{};const preset=normalizeGovernancePreset(rawGovernance.preset);const extras=resolveGovernanceExtras(rawGovernance);if(preset==="custom"){const baseline2=resolveGovernanceKnobsFromPreset("default");const requireCloseReason2=extras.require_close_reason??baseline2.require_close_reason;return{preset,ownership_enforcement:rawGovernance.ownership_enforcement??baseline2.ownership_enforcement,create_mode_default:rawGovernance.create_mode_default??baseline2.create_mode_default,close_validation_default:rawGovernance.close_validation_default??baseline2.close_validation_default,parent_reference:rawGovernance.parent_reference??baseline2.parent_reference,metadata_profile:rawGovernance.metadata_profile??baseline2.metadata_profile,force_required_for_stale_lock:rawGovernance.force_required_for_stale_lock??baseline2.force_required_for_stale_lock,...extras,require_close_reason:requireCloseReason2,duplicate_detection_mode:extras.duplicate_detection_mode??baseline2.duplicate_detection_mode,duplicate_detection_threshold:extras.duplicate_detection_threshold??baseline2.duplicate_detection_threshold,duplicate_detection_limit:extras.duplicate_detection_limit??baseline2.duplicate_detection_limit}}const baseline=resolveGovernanceKnobsFromPreset(preset);const requireCloseReason=extras.require_close_reason??baseline.require_close_reason;return{preset,...baseline,...extras,require_close_reason:requireCloseReason}}function cloneDefaults(){return structuredClone(SETTINGS_DEFAULTS)}function normalizeSearchMutationRefreshPolicy(value){if(value==="cache_only"||value==="semantic_configured"||value==="semantic_auto"){return value}return SETTINGS_DEFAULTS.search.mutation_refresh_policy}function normalizeSearchQueryExpansionEnabled(value){if(typeof value==="boolean"){return value}return SETTINGS_DEFAULTS.search.query_expansion.enabled}function normalizeSearchQueryExpansionProvider(value){if(typeof value!=="string"){return SETTINGS_DEFAULTS.search.query_expansion.provider}return value.trim()}function normalizeSearchRerankEnabled(value){if(typeof value==="boolean"){return value}return SETTINGS_DEFAULTS.search.rerank.enabled}function normalizeSearchRerankModel(value){if(typeof value!=="string"){return SETTINGS_DEFAULTS.search.rerank.model}return value.trim()}function normalizeSearchRerankTopK(value){if(typeof value==="number"&&Number.isFinite(value)&&Number.isInteger(value)&&value>0){return value}return SETTINGS_DEFAULTS.search.rerank.top_k}function normalizeVectorStoreCollectionName(value){if(typeof value!=="string"){return SETTINGS_DEFAULTS.vector_store.collection_name}const sanitized=value.trim().replaceAll(/[^a-zA-Z0-9_-]/g,"_");const truncated=sanitized.slice(0,MAX_VECTOR_STORE_COLLECTION_NAME_LENGTH);return truncated.length>0?truncated:SETTINGS_DEFAULTS.vector_store.collection_name}function cloneOptionalArray(value){return{present:Array.isArray(value),values:Array.isArray(value)?structuredClone(value):[]}}function buildSettingsPersistSourceSnapshot(parsedSettings,runtimeSettings){const sourceSchema=parsedSettings.schema;const sourceStatuses=cloneOptionalArray(sourceSchema?.statuses);const sourceFields=cloneOptionalArray(sourceSchema?.fields);const sourceTypeWorkflows=cloneOptionalArray(sourceSchema?.type_workflows);return{source_settings:structuredClone(parsedSettings),has_source_item_type_definitions:Array.isArray(parsedSettings.item_types?.definitions),source_item_type_definitions:normalizeItemTypeDefinitions(parsedSettings.item_types?.definitions),has_source_schema_statuses:sourceStatuses.present,source_schema_statuses:sourceStatuses.values,has_source_schema_fields:sourceFields.present,source_schema_fields:sourceFields.values,has_source_schema_type_workflows:sourceTypeWorkflows.present,source_schema_type_workflows:sourceTypeWorkflows.values,runtime_item_type_definitions:normalizeItemTypeDefinitions(runtimeSettings.item_types?.definitions),runtime_schema_statuses:structuredClone(runtimeSettings.schema.statuses),runtime_schema_fields:structuredClone(runtimeSettings.schema.fields),runtime_schema_type_workflows:structuredClone(runtimeSettings.schema.type_workflows??[])}}function attachSettingsPersistSourceSnapshot(settings,source){Object.defineProperty(settings,SETTINGS_PERSIST_SOURCE_SYMBOL,{value:source,writable:true,configurable:true,enumerable:false})}function getSettingsPersistSourceSnapshot(settings){const candidate=settings[SETTINGS_PERSIST_SOURCE_SYMBOL];if(!candidate||typeof candidate!=="object"){return void 0}return candidate}function persistSelectedItemFormat(settings){const source=getSettingsPersistSourceSnapshot(settings);if(source){const detachedSource=structuredClone(source);detachedSource.source_settings.item_format=settings.item_format;attachSettingsPersistSourceSnapshot(settings,detachedSource)}}function cloneSettingsReadResult(result){const clonedSettings=structuredClone(result.settings);const persistSource=getSettingsPersistSourceSnapshot(result.settings);if(persistSource){attachSettingsPersistSourceSnapshot(clonedSettings,persistSource)}return{settings:clonedSettings,metadata:{has_explicit_item_format:result.metadata.has_explicit_item_format},warnings:[...result.warnings]}}function resolveSettingsReadTrackedPaths(pmRoot,schema,settingsPath){const normalizedSchema=normalizeRuntimeSchemaSettings(schema);return[settingsPath,filePathForSchemaSection(pmRoot,normalizedSchema.files.types,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types),filePathForSchemaSection(pmRoot,normalizedSchema.files.statuses,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.statuses),filePathForSchemaSection(pmRoot,normalizedSchema.files.fields,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.fields),filePathForSchemaSection(pmRoot,normalizedSchema.files.workflows,DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.workflows)]}async function cacheSettingsReadResult(pmRoot,trackedPaths,result){const signatures=await collectSettingsReadCacheSignatures(trackedPaths);setSettingsReadCacheEntry(pmRoot,{tracked_paths:trackedPaths,signatures,value:cloneSettingsReadResult(result)})}async function cacheSettingsReadResultSafe(pmRoot,trackedPaths,result){try{await cacheSettingsReadResult(pmRoot,trackedPaths,result)}catch{clearSettingsReadCache(pmRoot)}}function findSettingsReadCacheSignature(signatures,targetPath){return signatures.find(signature=>signature.path===targetPath)}function selectedSettingsReadCacheSignaturesEqual(before,after,targetPaths){for(const targetPath of targetPaths){const beforeSignature=findSettingsReadCacheSignature(before,targetPath);const afterSignature=findSettingsReadCacheSignature(after,targetPath);if(!beforeSignature||!afterSignature||!settingsReadCacheSignaturesEqual([beforeSignature],[afterSignature])){return false}}return true}async function cacheSettingsReadResultIfStable(pmRoot,trackedPaths,result,stableSignatures,stablePaths){try{const currentSignatures=await collectSettingsReadCacheSignatures(trackedPaths);if(!selectedSettingsReadCacheSignaturesEqual(stableSignatures,currentSignatures,stablePaths)){clearSettingsReadCache(pmRoot);return}setSettingsReadCacheEntry(pmRoot,{tracked_paths:trackedPaths,signatures:currentSignatures,value:cloneSettingsReadResult(result)})}catch{clearSettingsReadCache(pmRoot)}}function resolvePersistedFileBackedSchemaSections(settings,source){const normalizedSchema=normalizeRuntimeSchemaSettings(settings.schema);const currentItemTypeDefinitions=normalizeItemTypeDefinitions(settings.item_types?.definitions);if(!source){return{item_type_definitions:currentItemTypeDefinitions,schema_statuses:normalizedSchema.statuses,schema_fields:normalizedSchema.fields,schema_type_workflows:normalizedSchema.type_workflows}}const currentTypeWorkflows=normalizedSchema.type_workflows??[];const itemTypeDefinitionsUnchanged=stableValueEquals(currentItemTypeDefinitions,source.runtime_item_type_definitions);const schemaStatusesUnchanged=stableValueEquals(normalizedSchema.statuses,source.runtime_schema_statuses);const schemaFieldsUnchanged=stableValueEquals(normalizedSchema.fields,source.runtime_schema_fields);const schemaTypeWorkflowsUnchanged=stableValueEquals(currentTypeWorkflows,source.runtime_schema_type_workflows);return{item_type_definitions:itemTypeDefinitionsUnchanged?source.has_source_item_type_definitions?normalizeItemTypeDefinitions(source.source_item_type_definitions):[]:currentItemTypeDefinitions,schema_statuses:schemaStatusesUnchanged?source.has_source_schema_statuses?structuredClone(source.source_schema_statuses):[]:normalizedSchema.statuses,schema_fields:schemaFieldsUnchanged?source.has_source_schema_fields?structuredClone(source.source_schema_fields):[]:normalizedSchema.fields,schema_type_workflows:schemaTypeWorkflowsUnchanged?source.has_source_schema_type_workflows?structuredClone(source.source_schema_type_workflows):void 0:normalizedSchema.type_workflows}}function buildFallbackSettingsReadResult(warning){return{settings:cloneDefaults(),metadata:{has_explicit_item_format:false},warnings:warning?[warning]:[]}}function hasExplicitItemFormat(raw){if(typeof raw!=="object"||raw===null||Array.isArray(raw)){return false}const itemFormat=raw.item_format;return itemFormat==="toon"||itemFormat==="json_markdown"}function normalizeStringList(values){return[...new Set((values??[]).map(value=>value.trim()).filter(value=>value.length>0))].sort((left,right)=>left.localeCompare(right))}function normalizeAgentGuidanceSettings(value){const defaults=SETTINGS_DEFAULTS.agent_guidance;const templateVersion=value?.template_version;return{prompt_completed:value?.prompt_completed===true,declined:value?.declined===true,declined_at:typeof value?.declined_at==="string"?value.declined_at:defaults.declined_at,template_version:typeof templateVersion==="number"&&Number.isInteger(templateVersion)&&templateVersion>0?templateVersion:defaults.template_version,last_checked_files:normalizeStringList(value?.last_checked_files??defaults.last_checked_files)}}function normalizeLowerStringList(values){return[...new Set((values??[]).map(value=>value.trim().toLowerCase()).filter(value=>value.length>0))].sort((left,right)=>left.localeCompare(right))}function normalizeExtensionPolicyMode(value){if(value==="off"||value==="warn"||value==="enforce"){return value}return SETTINGS_DEFAULTS.extensions.policy.mode}function normalizeExtensionTrustMode(value){if(value==="off"||value==="warn"||value==="enforce"){return value}return SETTINGS_DEFAULTS.extensions.policy.trust_mode}function normalizeExtensionSandboxProfile(value){if(value==="none"||value==="restricted"||value==="strict"){return value}return SETTINGS_DEFAULTS.extensions.policy.default_sandbox_profile}function normalizeExtensionPolicyOverride(override){const name=override.name.trim().toLowerCase();if(name.length===0){return null}const normalized={name};if(override.disabled===true){normalized.disabled=true}if(override.require_trusted===true){normalized.require_trusted=true}if(override.require_provenance===true){normalized.require_provenance=true}if(override.sandbox_profile!==void 0){normalized.sandbox_profile=normalizeExtensionSandboxProfile(override.sandbox_profile)}const allowedCapabilities=normalizeLowerStringList(override.allowed_capabilities);const blockedCapabilities=normalizeLowerStringList(override.blocked_capabilities);const allowedSurfaces=normalizeLowerStringList(override.allowed_surfaces);const blockedSurfaces=normalizeLowerStringList(override.blocked_surfaces);const allowedCommands=normalizeLowerStringList(override.allowed_commands);const blockedCommands=normalizeLowerStringList(override.blocked_commands);const allowedActions=normalizeLowerStringList(override.allowed_actions);const blockedActions=normalizeLowerStringList(override.blocked_actions);const allowedServices=normalizeLowerStringList(override.allowed_services);const blockedServices=normalizeLowerStringList(override.blocked_services);if(allowedCapabilities.length>0){normalized.allowed_capabilities=allowedCapabilities}if(blockedCapabilities.length>0){normalized.blocked_capabilities=blockedCapabilities}if(allowedSurfaces.length>0){normalized.allowed_surfaces=allowedSurfaces}if(blockedSurfaces.length>0){normalized.blocked_surfaces=blockedSurfaces}if(allowedCommands.length>0){normalized.allowed_commands=allowedCommands}if(blockedCommands.length>0){normalized.blocked_commands=blockedCommands}if(allowedActions.length>0){normalized.allowed_actions=allowedActions}if(blockedActions.length>0){normalized.blocked_actions=blockedActions}if(allowedServices.length>0){normalized.allowed_services=allowedServices}if(blockedServices.length>0){normalized.blocked_services=blockedServices}return normalized}function normalizeExtensionPolicyOverrides(overrides){const dedupedByName=new Map;for(const override of overrides??[]){const normalized=normalizeExtensionPolicyOverride(override);if(!normalized){continue}dedupedByName.set(normalized.name,normalized)}return[...dedupedByName.values()].sort((left,right)=>left.name.localeCompare(right.name))}function normalizePmMaxVersionExceededModeValue(value){return value==="block"||value==="warn"?value:void 0}function normalizePmMaxVersionExceededModeSetting(value){if(typeof value==="string"){return normalizePmMaxVersionExceededModeValue(value)}if(typeof value==="object"&&value!==null&&!Array.isArray(value)){const global2=normalizePmMaxVersionExceededModeValue(value.global);const project=normalizePmMaxVersionExceededModeValue(value.project);if(global2===void 0&&project===void 0){return void 0}return{...global2!==void 0?{global:global2}:{},...project!==void 0?{project}:{}}}return void 0}function normalizeExtensionPolicyList(policy,key){return normalizeLowerStringList(policy?.[key]??SETTINGS_DEFAULTS.extensions.policy[key])}function normalizeExtensionPolicySettings(policy){const pmMaxVersionExceededMode=normalizePmMaxVersionExceededModeSetting(policy?.pm_max_version_exceeded_mode);return{mode:normalizeExtensionPolicyMode(policy?.mode),trust_mode:normalizeExtensionTrustMode(policy?.trust_mode),...pmMaxVersionExceededMode!==void 0?{pm_max_version_exceeded_mode:pmMaxVersionExceededMode}:{},require_provenance:policy?.require_provenance===true,trusted_extensions:normalizeExtensionPolicyList(policy,"trusted_extensions"),default_sandbox_profile:normalizeExtensionSandboxProfile(policy?.default_sandbox_profile),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){const normalized=[...new Set((values??[]).map(value=>value.trim().toLowerCase().replaceAll("-","_")))].filter(value=>value.length>0).sort((left,right)=>left.localeCompare(right));return normalized.filter(value=>["author","acceptance_criteria","estimated_minutes","close_reason","reviewer","risk","confidence","sprint","release"].includes(value))}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===void 0?fallback:value}function recordOrEmpty(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)?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}}}function normalizeItemTypeDefinitions(definitions){const normalized=(definitions??[]).map(definition=>normalizeItemTypeDefinition(definition)).filter(definition=>definition!==null);const dedupedByName=new Map;for(const definition of normalized){dedupedByName.set(definition.name.toLowerCase(),definition)}return[...dedupedByName.values()].sort((left,right)=>left.name.localeCompare(right.name))}function mergeSettings(settings){const defaults=cloneDefaults();const governance=resolveGovernanceKnobs({governance:settings.governance??{preset:"default"}});return{...defaults,...settings,item_format:normalizeSettingsItemFormat(settings,defaults),locks:{...defaults.locks,...settings.locks},ids:{...defaults.ids,...settings.ids},agent_identity:structuredClone(settings.agent_identity??defaults.agent_identity),mutation_guard:{...defaults.mutation_guard,...settings.mutation_guard},checkpoints:{...defaults.checkpoints,...settings.checkpoints},output:{...defaults.output,...settings.output},ux:{...defaults.ux,...settings.ux},history:{...defaults.history,...settings.history,compact_policy:{...defaults.history.compact_policy,...settings.history?.compact_policy}},validation:buildValidationSettings(settings,defaults,governance),governance,workflow:{definition_of_done:[...settings.workflow?.definition_of_done??defaults.workflow.definition_of_done]},testing:{record_results_to_items:settings.testing?.record_results_to_items??defaults.testing.record_results_to_items,allow_untrusted_linked_tests:settings.testing?.allow_untrusted_linked_tests??defaults.testing.allow_untrusted_linked_tests},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:buildContextSettings(settings,defaults),extensions:{enabled:[...settings.extensions.enabled],disabled:[...settings.extensions.disabled],policy:normalizeExtensionPolicySettings(settings.extensions.policy??defaults.extensions.policy)},search:buildSearchSettings(settings,defaults),providers:buildProviderSettings(settings,defaults),vector_store:buildVectorStoreSettings(settings,defaults)}}function orderSerializedSettingsSections(ordered){ordered.agent_identity=orderObject(ordered.agent_identity,["probes_enabled","identity_vocabulary","harness_signals"]);const orderedAgentIdentity=ordered.agent_identity;if(Object.hasOwn(orderedAgentIdentity,"identity_vocabulary")){orderedAgentIdentity.identity_vocabulary=orderObject(recordOrEmpty(orderedAgentIdentity.identity_vocabulary),["version","aliases"])}ordered.agent_identity.harness_signals=arrayOrEmpty(ordered.agent_identity.harness_signals).map(entry=>orderObject(recordOrEmpty(entry),["harness","environment_keys","model_environment_keys","session_environment_keys","provenance_environment_keys","provenance_resolvers","provenance_unavailable_dimensions","argv_markers","client_names"]));ordered.locks=orderObject(ordered.locks,["ttl_seconds","wait_ms"]);ordered.ids=orderObject(ordered.ids,["token_length"]);ordered.mutation_guard=orderObject(ordered.mutation_guard,["require_attributed_author","secret_guard","stale_in_progress_hours"]);ordered.checkpoints=orderObject(ordered.checkpoints,["retention_days"]);ordered.output=orderObject(ordered.output,["default_format"]);ordered.ux=orderObject(ordered.ux,["deprecation_hints"]);ordered.history=orderObject(ordered.history,["missing_stream","compact_policy"]);ordered.validation=orderObject(ordered.validation,["sprint_release_format","parent_reference","metadata_profile","metadata_required_fields","lifecycle_stale_blocker_reason_patterns","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","ownership_enforcement","create_mode_default","close_validation_default","require_close_reason","parent_reference","metadata_profile","force_required_for_stale_lock","create_default_type","workflow_enforcement","duplicate_detection_mode","duplicate_detection_threshold","duplicate_detection_limit"]);ordered.workflow=orderObject(ordered.workflow,["definition_of_done"]);ordered.testing=orderObject(ordered.testing,["record_results_to_items","allow_untrusted_linked_tests"]);ordered.telemetry=orderObject(ordered.telemetry,["enabled","first_run_prompt_completed","capture_level","endpoint","installation_id","retention_days"]);ordered.agent_guidance=orderObject(ordered.agent_guidance,["prompt_completed","declined","declined_at","template_version","last_checked_files"]);ordered.item_types=orderObject(ordered.item_types,["definitions"]);ordered.schema=orderObject(ordered.schema,["version","files","statuses","fields","workflow","type_workflows","unknown_field_policy"]);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(recordOrEmpty(ordered.context.sections),["hierarchy","activity","progress","blockers","files","workload","staleness","tests"]);ordered.extensions=orderObject(ordered.extensions,["enabled","disabled","policy"]);ordered.extensions.policy=orderObject(recordOrEmpty(ordered.extensions.policy),["mode","trust_mode","pm_max_version_exceeded_mode","require_provenance","trusted_extensions","default_sandbox_profile","allowed_extensions","blocked_extensions","allowed_capabilities","blocked_capabilities","allowed_surfaces","blocked_surfaces","allowed_commands","blocked_commands","allowed_actions","blocked_actions","allowed_services","blocked_services","extension_overrides"]);ordered.extensions.policy.extension_overrides=arrayOrEmpty(ordered.extensions.policy.extension_overrides).map(entry=>orderObject(recordOrEmpty(entry),["name","disabled","require_trusted","require_provenance","sandbox_profile","allowed_capabilities","blocked_capabilities","allowed_surfaces","blocked_surfaces","allowed_commands","blocked_commands","allowed_actions","blocked_actions","allowed_services","blocked_services"]));ordered.search=orderObject(ordered.search,["score_threshold","hybrid_semantic_weight","max_results","embedding_model","embedding_corpus_max_characters","embedding_batch_size","embedding_timeout_ms","scanner_max_batch_retries","provider","mutation_refresh_policy","query_expansion","rerank"]);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(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(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),ids:valueOrDefault(settings.ids,SETTINGS_DEFAULTS.ids),agent_identity:valueOrDefault(settings.agent_identity,SETTINGS_DEFAULTS.agent_identity),mutation_guard:valueOrDefault(settings.mutation_guard,SETTINGS_DEFAULTS.mutation_guard),checkpoints:valueOrDefault(settings.checkpoints,SETTINGS_DEFAULTS.checkpoints),output:valueOrDefault(settings.output,SETTINGS_DEFAULTS.output),ux:valueOrDefault(settings.ux,SETTINGS_DEFAULTS.ux),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)}}function applySettingsDelta(target,baseline,current){const keys=new Set([...Object.keys(baseline),...Object.keys(current)]);for(const key of keys){const before=baseline[key];const after=current[key];if(stableValueEquals(before,after))continue;if(after===void 0){delete target[key];continue}if(typeof before==="object"&&before!==null&&!Array.isArray(before)&&typeof after==="object"&&after!==null&&!Array.isArray(after)){const existing=target[key];const nestedTarget=typeof existing==="object"&&existing!==null&&!Array.isArray(existing)?existing:{};applySettingsDelta(nestedTarget,before,after);if(Object.keys(nestedTarget).length>0)target[key]=nestedTarget;else delete target[key];continue}target[key]=structuredClone(after)}}const SETTINGS_TOP_LEVEL_KEY_ORDER=["version","id_prefix","ids","author_default","agent_identity","mutation_guard","item_format","locks","checkpoints","output","ux","history","validation","governance","workflow","testing","telemetry","agent_guidance","item_types","schema","context","extensions","search","providers","vector_store"];function buildOrderedSettingsForSerialization(settings,persistSource){const baseSettings=buildSerializeBaseSettings(settings);const governance=resolveGovernanceKnobs(baseSettings);const normalizedSchema=normalizeRuntimeSchemaSettings(baseSettings.schema);const persistedFileBackedSections=resolvePersistedFileBackedSchemaSections(baseSettings,persistSource);const normalizedSettings=buildNormalizedSettingsForSerialization(baseSettings,governance,normalizedSchema,persistedFileBackedSections);const ordered=orderObject({...normalizedSettings,governance:normalizeGovernanceForPersist(governance)},SETTINGS_TOP_LEVEL_KEY_ORDER);orderSerializedSettingsSections(ordered);return ordered}function serializeSettings(settings,options={}){const ordered=buildOrderedSettingsForSerialization(settings,options.persist_source);if(options.persist_source){const baselineSettings=mergeSettings(options.persist_source.source_settings);baselineSettings.item_types={definitions:structuredClone(options.persist_source.runtime_item_type_definitions)};baselineSettings.schema={...baselineSettings.schema,statuses:structuredClone(options.persist_source.runtime_schema_statuses),fields:structuredClone(options.persist_source.runtime_schema_fields),type_workflows:structuredClone(options.persist_source.runtime_schema_type_workflows)};const baseline=buildOrderedSettingsForSerialization(baselineSettings,options.persist_source);const sparse=structuredClone(options.persist_source.source_settings);applySettingsDelta(sparse,baseline,ordered);return`${JSON.stringify(orderObject(sparse,SETTINGS_TOP_LEVEL_KEY_ORDER),null,2)}
+`}return`${JSON.stringify(ordered,null,2)}
+`}async function readSettingsWithMetadata(pmRoot){const settingsPath=getSettingsPath(pmRoot);let trackedPathsForFailure=[settingsPath];await runActiveOnReadHooks({path:settingsPath,scope:"project"});const cachedResult=getSettingsReadCacheEntry(pmRoot);if(cachedResult){const currentSignatures=await collectSettingsReadCacheSignatures(cachedResult.tracked_paths);if(settingsReadCacheSignaturesEqual(currentSignatures,cachedResult.signatures)){return cloneSettingsReadResult(cachedResult.value)}}const settingsOnlySignatures=await collectSettingsReadCacheSignatures([settingsPath]);let raw;try{raw=await readFileIfExists(settingsPath)}catch{return buildFallbackSettingsReadResult("settings_read_fs_error")}if(raw===null){const fallback=buildFallbackSettingsReadResult();await cacheSettingsReadResultIfStable(pmRoot,[settingsPath],fallback,settingsOnlySignatures,[settingsPath]);return fallback}const settingsSignaturesAfterRead=await collectSettingsReadCacheSignatures([settingsPath]);if(!settingsReadCacheSignaturesEqual(settingsOnlySignatures,settingsSignaturesAfterRead)){clearSettingsReadCache(pmRoot);return readSettingsWithMetadata(pmRoot)}let parsed;try{parsed=JSON.parse(raw)}catch{const fallback=buildFallbackSettingsReadResult("settings_read_invalid_json");await cacheSettingsReadResultIfStable(pmRoot,[settingsPath],fallback,settingsSignaturesAfterRead,[settingsPath]);return fallback}const validated=validateSettings(parsed);if(!validated.success){const fallback=buildFallbackSettingsReadResult("settings_read_invalid_schema");await cacheSettingsReadResultIfStable(pmRoot,[settingsPath],fallback,settingsSignaturesAfterRead,[settingsPath]);return fallback}try{const mergedSettings=mergeSettings(validated.data);const trackedPaths=resolveSettingsReadTrackedPaths(pmRoot,mergedSettings.schema,settingsPath);trackedPathsForFailure=trackedPaths;const signaturesBeforeSchemaLoad=await collectSettingsReadCacheSignatures(trackedPaths);const schemaScaffold=await ensureRuntimeSchemaFileScaffold(pmRoot,mergedSettings.schema);const loadedSchemaSections=await loadRuntimeSchemaFromOptionalFiles(pmRoot,mergedSettings.schema);const signaturesAfterSchemaLoad=await collectSettingsReadCacheSignatures(trackedPaths);const settings={...mergedSettings,item_types:{definitions:normalizeItemTypeDefinitions([...mergedSettings.item_types.definitions,...arrayOrEmpty(loadedSchemaSections.type_definitions_from_file)])},schema:loadedSchemaSections.schema};attachSettingsPersistSourceSnapshot(settings,buildSettingsPersistSourceSnapshot(validated.data,settings));const result={settings,metadata:{has_explicit_item_format:hasExplicitItemFormat(parsed)},warnings:[...validated.data.item_format==="json_markdown"?["settings_item_format_legacy_json_markdown_coerced_to_toon"]:[],...schemaScaffold.created_paths.map(createdPath=>`runtime_schema_bootstrap_created:${createdPath}`),...loadedSchemaSections.warnings]};if(schemaScaffold.created_paths.length===0){if(!settingsReadCacheSignaturesEqual(signaturesBeforeSchemaLoad,signaturesAfterSchemaLoad)){clearSettingsReadCache(pmRoot)}else{setSettingsReadCacheEntry(pmRoot,{tracked_paths:trackedPaths,signatures:signaturesAfterSchemaLoad,value:cloneSettingsReadResult(result)})}}else{clearSettingsReadCache(pmRoot)}return result}catch{const fallback=buildFallbackSettingsReadResult("settings_read_merge_failed");await cacheSettingsReadResultSafe(pmRoot,trackedPathsForFailure,fallback);return fallback}}async function readSettings(pmRoot){return(await readSettingsWithMetadata(pmRoot)).settings}async function writeSettings(pmRoot,settings,op=SETTINGS_WRITE_OP){const settingsPath=getSettingsPath(pmRoot);const afterRaw=serializeSettings(settings,{persist_source:getSettingsPersistSourceSnapshot(settings)});try{await writeWorkspaceJsonWithHistory({pmRoot,filePath:settingsPath,raw:afterRaw,op,author:resolveAuthor(void 0,settings.author_default),lockTtlSeconds:settings.locks.ttl_seconds,lockWaitMs:settings.locks.wait_ms,recordCreation:false});await runActiveOnWriteHooks({path:settingsPath,scope:"project",op})}finally{clearSettingsReadCache(pmRoot)}}const settingsStoreTestOnly={applySettingsDelta,hasExplicitItemFormat,buildSettingsPersistSourceSnapshot,cacheSettingsReadResultIfStable,cacheSettingsReadResultSafe,mergeSettings,normalizeExtensionPolicySettings,normalizeExtensionPolicyOverride,normalizeExtensionPolicyOverrides,normalizeExtensionPolicyMode,normalizePmMaxVersionExceededModeSetting,normalizeExtensionSandboxProfile,normalizeExtensionTrustMode,normalizeLowerStringList,normalizeStringList,valueOrDefault,arrayOrEmpty,normalizeValidationPatternList,normalizeValidationMetadataRequiredFields,resolveSettingsReadTrackedPaths,resolvePersistedFileBackedSchemaSections,selectedSettingsReadCacheSignaturesEqual};export{normalizeItemTypeDefinitions,persistSelectedItemFormat,readSettings,readSettingsWithMetadata,resolveGovernanceKnobs,serializeSettings,settingsStoreTestOnly,writeSettings};
 //# sourceMappingURL=settings.js.map
-//# debugId=5b95183e-9fd3-55cf-9059-8736f692e96e