@unbrained/pm-cli 2026.7.1 → 2026.7.3

package/dist/cli-bundle/chunks/{chunk-7R4QEMZZ.js → chunk-L4SLHV6G.js}

@@ -1,6 +1,6 @@
 // dist/core/fs/fs-utils.js
 
-!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]="03ed13d8-75ea-5f3b-b089-a7347a59acca")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="aeaf9c80-302b-561b-892d-b98b811d424b")}catch(e){}}();
 import * as fs from "node:fs/promises";
 import path from "node:path";
 import crypto from "node:crypto";
@@ -787,6 +787,13 @@ function normalizeItemTypeCommandOptionPolicies(policies, resolvePolicyCommand)
   }
   return [...dedupedByKey.values()].sort((left, right) => left.command === right.command ? left.option.localeCompare(right.option) : left.command.localeCompare(right.command));
 }
+function normalizeOptionalStringList(values, preservePresence) {
+  return preservePresence ? normalizeItemTypeStringList(values) : void 0;
+}
+function optionalNonEmptyString(value) {
+  const normalized = value?.trim();
+  return normalized && normalized.length > 0 ? normalized : void 0;
+}
 function normalizeItemTypeDefinition(definition, options = {}) {
   const resolvePolicyCommand = options.resolvePolicyCommand ?? keepPolicyCommand;
   const name = definition.name.trim();
@@ -797,20 +804,17 @@ function normalizeItemTypeDefinition(definition, options = {}) {
   const hasRequiredCreateRepeatables = definition.required_create_repeatables !== void 0;
   const hasOptions = definition.options !== void 0;
   const hasCommandOptionPolicies = definition.command_option_policies !== void 0;
-  const folder = definition.folder?.trim();
-  const description = definition.description?.trim();
-  const defaultStatus = definition.default_status?.trim();
   const aliases = normalizeItemTypeStringList(definition.aliases);
   const normalizedOptions = (definition.options ?? []).map((option) => normalizeItemTypeOption(option)).filter((option) => option !== null).sort((left, right) => left.key.localeCompare(right.key));
   const commandOptionPolicies = normalizeItemTypeCommandOptionPolicies(definition.command_option_policies, resolvePolicyCommand);
   return {
     name,
-    description: description && description.length > 0 ? description : void 0,
-    default_status: defaultStatus && defaultStatus.length > 0 ? defaultStatus : void 0,
-    folder: folder && folder.length > 0 ? folder : void 0,
+    description: optionalNonEmptyString(definition.description),
+    default_status: optionalNonEmptyString(definition.default_status),
+    folder: optionalNonEmptyString(definition.folder),
     aliases: aliases.length > 0 ? aliases : void 0,
-    required_create_fields: hasRequiredCreateFields ? normalizeItemTypeStringList(definition.required_create_fields) : void 0,
-    required_create_repeatables: hasRequiredCreateRepeatables ? normalizeItemTypeStringList(definition.required_create_repeatables) : void 0,
+    required_create_fields: normalizeOptionalStringList(definition.required_create_fields, hasRequiredCreateFields),
+    required_create_repeatables: normalizeOptionalStringList(definition.required_create_repeatables, hasRequiredCreateRepeatables),
     options: hasOptions ? normalizedOptions : void 0,
     command_option_policies: hasCommandOptionPolicies ? commandOptionPolicies : void 0
   };
@@ -1125,6 +1129,58 @@ function toSlugToken(value) {
 function normalizeTypeDefinition(definition) {
   return normalizeItemTypeDefinition(definition, { resolvePolicyCommand: strictPolicyCommand });
 }
+function readStringArray(record, key) {
+  const value = record[key];
+  return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : void 0;
+}
+function coerceOptionDefinitionFromUnknown(raw) {
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    return null;
+  }
+  const optionRecord = raw;
+  if (typeof optionRecord.key !== "string") {
+    return null;
+  }
+  return {
+    key: optionRecord.key,
+    values: readStringArray(optionRecord, "values") ?? [],
+    required: optionRecord.required === void 0 ? void 0 : Boolean(optionRecord.required),
+    aliases: readStringArray(optionRecord, "aliases"),
+    description: typeof optionRecord.description === "string" ? optionRecord.description : void 0
+  };
+}
+function coerceCommandOptionPolicyFromUnknown(raw) {
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    return null;
+  }
+  const policyRecord = raw;
+  if (typeof policyRecord.command !== "string" || typeof policyRecord.option !== "string") {
+    return null;
+  }
+  const normalizedCommand = policyRecord.command.trim().toLowerCase();
+  if (normalizedCommand !== "create" && normalizedCommand !== "update") {
+    return null;
+  }
+  return {
+    command: normalizedCommand,
+    option: policyRecord.option,
+    required: policyRecord.required === void 0 ? void 0 : Boolean(policyRecord.required),
+    visible: policyRecord.visible === void 0 ? void 0 : Boolean(policyRecord.visible),
+    enabled: policyRecord.enabled === void 0 ? void 0 : Boolean(policyRecord.enabled)
+  };
+}
+function coerceOptionDefinitionsFromRecord(record) {
+  if (!Array.isArray(record.options)) {
+    return void 0;
+  }
+  return record.options.map((entry) => coerceOptionDefinitionFromUnknown(entry)).filter((entry) => entry !== null);
+}
+function coerceCommandOptionPoliciesFromRecord(record) {
+  if (!Array.isArray(record.command_option_policies)) {
+    return void 0;
+  }
+  return record.command_option_policies.map((entry) => coerceCommandOptionPolicyFromUnknown(entry)).filter((entry) => entry !== null);
+}
 function coerceTypeDefinitionFromUnknown(raw) {
   if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
     return null;
@@ -1137,65 +1193,30 @@ function coerceTypeDefinitionFromUnknown(raw) {
   const folder = typeof record.folder === "string" ? record.folder : void 0;
   const description = typeof record.description === "string" ? record.description : void 0;
   const defaultStatus = typeof record.default_status === "string" ? record.default_status : void 0;
-  const aliases = Array.isArray(record.aliases) ? record.aliases.filter((value) => typeof value === "string") : void 0;
-  const requiredCreateFields = Array.isArray(record.required_create_fields) ? record.required_create_fields.filter((value) => typeof value === "string") : void 0;
-  const requiredCreateRepeatables = Array.isArray(record.required_create_repeatables) ? record.required_create_repeatables.filter((value) => typeof value === "string") : void 0;
-  let options;
-  if (Array.isArray(record.options)) {
-    options = [];
-    for (const entry of record.options) {
-      if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
-        continue;
-      }
-      const optionRecord = entry;
-      if (typeof optionRecord.key !== "string") {
-        continue;
-      }
-      options.push({
-        key: optionRecord.key,
-        values: Array.isArray(optionRecord.values) ? optionRecord.values.filter((value) => typeof value === "string") : [],
-        required: optionRecord.required === void 0 ? void 0 : Boolean(optionRecord.required),
-        aliases: Array.isArray(optionRecord.aliases) ? optionRecord.aliases.filter((value) => typeof value === "string") : void 0,
-        description: typeof optionRecord.description === "string" ? optionRecord.description : void 0
-      });
-    }
-  }
-  let commandOptionPolicies;
-  if (Array.isArray(record.command_option_policies)) {
-    commandOptionPolicies = [];
-    for (const entry of record.command_option_policies) {
-      if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
-        continue;
-      }
-      const policyRecord = entry;
-      if (typeof policyRecord.command !== "string" || typeof policyRecord.option !== "string") {
-        continue;
-      }
-      const normalizedCommand = policyRecord.command.trim().toLowerCase();
-      if (normalizedCommand !== "create" && normalizedCommand !== "update") {
-        continue;
-      }
-      commandOptionPolicies.push({
-        command: normalizedCommand,
-        option: policyRecord.option,
-        required: policyRecord.required === void 0 ? void 0 : Boolean(policyRecord.required),
-        visible: policyRecord.visible === void 0 ? void 0 : Boolean(policyRecord.visible),
-        enabled: policyRecord.enabled === void 0 ? void 0 : Boolean(policyRecord.enabled)
-      });
-    }
-  }
   return {
     name,
     description,
     default_status: defaultStatus,
     folder,
-    aliases,
-    required_create_fields: requiredCreateFields,
-    required_create_repeatables: requiredCreateRepeatables,
-    options,
-    command_option_policies: commandOptionPolicies
+    aliases: readStringArray(record, "aliases"),
+    required_create_fields: readStringArray(record, "required_create_fields"),
+    required_create_repeatables: readStringArray(record, "required_create_repeatables"),
+    options: coerceOptionDefinitionsFromRecord(record),
+    command_option_policies: coerceCommandOptionPoliciesFromRecord(record)
   };
 }
+function resolveDefinitionRequiredCreateFields(normalizedDefinition, existing) {
+  return normalizedDefinition.required_create_fields ? normalizeItemTypeStringList(normalizedDefinition.required_create_fields) : existing?.required_create_fields ?? [];
+}
+function resolveDefinitionRequiredCreateRepeatables(normalizedDefinition, existing) {
+  return normalizedDefinition.required_create_repeatables ? normalizeItemTypeStringList(normalizedDefinition.required_create_repeatables) : existing?.required_create_repeatables ?? [];
+}
+function resolveDefinitionOptions(normalizedDefinition, existing) {
+  return normalizedDefinition.options ? normalizedDefinition.options : existing?.options ? [...existing.options] : [];
+}
+function resolveDefinitionCommandOptionPolicies(normalizedDefinition, existing) {
+  return normalizedDefinition.command_option_policies ? normalizedDefinition.command_option_policies : existing?.command_option_policies ? [...existing.command_option_policies] : [];
+}
 function applyTypeDefinitions(source, target) {
   for (const rawDefinition of source) {
     const normalizedDefinition = normalizeTypeDefinition(rawDefinition);
@@ -1210,10 +1231,6 @@ function applyTypeDefinitions(source, target) {
       ...existing?.aliases ?? [],
       ...normalizedDefinition.aliases ?? []
     ]);
-    const requiredCreateFields = normalizedDefinition.required_create_fields ? normalizeItemTypeStringList(normalizedDefinition.required_create_fields) : existing?.required_create_fields ?? [];
-    const requiredCreateRepeatables = normalizedDefinition.required_create_repeatables ? normalizeItemTypeStringList(normalizedDefinition.required_create_repeatables) : existing?.required_create_repeatables ?? [];
-    const options = normalizedDefinition.options ? normalizedDefinition.options : existing?.options ? [...existing.options] : [];
-    const commandOptionPolicies = normalizedDefinition.command_option_policies ? normalizedDefinition.command_option_policies : existing?.command_option_policies ? [...existing.command_option_policies] : [];
     const defaultStatus = normalizedDefinition.default_status ?? existing?.default_status;
     const description = normalizedDefinition.description ?? existing?.description;
     target.set(lowerName, {
@@ -1222,10 +1239,10 @@ function applyTypeDefinitions(source, target) {
       ...defaultStatus ? { default_status: defaultStatus } : {},
       folder,
       aliases,
-      required_create_fields: requiredCreateFields,
-      required_create_repeatables: requiredCreateRepeatables,
-      options,
-      command_option_policies: commandOptionPolicies
+      required_create_fields: resolveDefinitionRequiredCreateFields(normalizedDefinition, existing),
+      required_create_repeatables: resolveDefinitionRequiredCreateRepeatables(normalizedDefinition, existing),
+      options: resolveDefinitionOptions(normalizedDefinition, existing),
+      command_option_policies: resolveDefinitionCommandOptionPolicies(normalizedDefinition, existing)
     });
   }
 }
@@ -1353,6 +1370,29 @@ function resolveCommandOptionPolicyState(typeDefinition, command, baseRequiredOp
     errors
   };
 }
+function buildTypeOptionAliasMap(typeDefinition) {
+  const optionByAlias = /* @__PURE__ */ new Map();
+  for (const option of typeDefinition.options) {
+    optionByAlias.set(option.key.toLowerCase(), option);
+    for (const alias of option.aliases ?? []) {
+      optionByAlias.set(alias.toLowerCase(), option);
+    }
+  }
+  return optionByAlias;
+}
+function resolveTypeOptionValue(optionDefinition, trimmedValue, errors) {
+  const allowedValues = optionDefinition.values;
+  if (allowedValues.length === 0) {
+    return trimmedValue;
+  }
+  const valueLookup = new Map(allowedValues.map((value) => [value.toLowerCase(), value]));
+  const canonical = valueLookup.get(trimmedValue.toLowerCase());
+  if (!canonical) {
+    errors.push(`Invalid value "${trimmedValue}" for type option "${optionDefinition.key}". Allowed: ${allowedValues.join(", ")}`);
+    return void 0;
+  }
+  return canonical;
+}
 function validateTypeOptions(typeName, rawTypeOptions, registry) {
   const typeDefinition = resolveTypeDefinition(typeName, registry);
   if (!typeDefinition) {
@@ -1362,13 +1402,7 @@ function validateTypeOptions(typeName, rawTypeOptions, registry) {
     };
   }
   const errors = [];
-  const optionByAlias = /* @__PURE__ */ new Map();
-  for (const option of typeDefinition.options) {
-    optionByAlias.set(option.key.toLowerCase(), option);
-    for (const alias of option.aliases ?? []) {
-      optionByAlias.set(alias.toLowerCase(), option);
-    }
-  }
+  const optionByAlias = buildTypeOptionAliasMap(typeDefinition);
   const normalized = {};
   for (const [rawKey, rawValue] of Object.entries(rawTypeOptions ?? {})) {
     const trimmedKey = rawKey.trim();
@@ -1387,16 +1421,9 @@ function validateTypeOptions(typeName, rawTypeOptions, registry) {
       errors.push(typeDefinition.options.length > 0 ? `Unknown type option "${trimmedKey}" for type "${typeDefinition.name}". Allowed: ${allowed}` : `Type "${typeDefinition.name}" does not define any configurable type options`);
       continue;
     }
-    const allowedValues = optionDefinition.values;
-    let resolvedValue = trimmedValue;
-    if (allowedValues.length > 0) {
-      const valueLookup = new Map(allowedValues.map((value) => [value.toLowerCase(), value]));
-      const canonical = valueLookup.get(trimmedValue.toLowerCase());
-      if (!canonical) {
-        errors.push(`Invalid value "${trimmedValue}" for type option "${optionDefinition.key}". Allowed: ${allowedValues.join(", ")}`);
-        continue;
-      }
-      resolvedValue = canonical;
+    const resolvedValue = resolveTypeOptionValue(optionDefinition, trimmedValue, errors);
+    if (resolvedValue === void 0) {
+      continue;
     }
     normalized[optionDefinition.key] = resolvedValue;
   }
@@ -5103,40 +5130,47 @@ function normalizeRuntimeWorkflow(workflow) {
     canceled_status: normalizeStatusId(workflow?.canceled_status)
   };
 }
+function appendTypeWorkflowPair(record, pair) {
+  if (!Array.isArray(pair) || pair.length !== 2) {
+    return;
+  }
+  const from = normalizeStatusToken(pair[0]);
+  const to = normalizeStatusToken(pair[1]);
+  if (from.length === 0 || to.length === 0) {
+    return;
+  }
+  if (record.pairs.some((candidate) => candidate[0] === from && candidate[1] === to)) {
+    return;
+  }
+  record.pairs.push([from, to]);
+}
+function normalizedTypeWorkflowEntry(entry) {
+  const rawType = typeof entry?.type === "string" ? entry.type.trim() : "";
+  if (rawType.length === 0 || !Array.isArray(entry?.allowed_transitions)) {
+    return null;
+  }
+  const record = { type: rawType, pairs: [], denyAll: entry.allowed_transitions.length === 0 };
+  for (const pair of entry.allowed_transitions) {
+    appendTypeWorkflowPair(record, pair);
+  }
+  return { typeKey: rawType.toLowerCase(), record };
+}
 function normalizeTypeWorkflowDefinitions(workflows) {
   if (!Array.isArray(workflows) || workflows.length === 0) {
     return void 0;
   }
   const byTypeKey = /* @__PURE__ */ new Map();
   for (const entry of workflows) {
-    const rawType = typeof entry?.type === "string" ? entry.type.trim() : "";
-    if (rawType.length === 0) {
-      continue;
-    }
-    if (!Array.isArray(entry?.allowed_transitions)) {
+    const normalized2 = normalizedTypeWorkflowEntry(entry);
+    if (normalized2 === null) {
       continue;
     }
-    const typeKey = rawType.toLowerCase();
-    const pairs = entry.allowed_transitions;
-    const record = byTypeKey.get(typeKey) ?? { type: rawType, pairs: [], denyAll: false };
-    if (pairs.length === 0) {
-      record.denyAll = true;
+    const record = byTypeKey.get(normalized2.typeKey) ?? normalized2.record;
+    record.denyAll ||= normalized2.record.denyAll;
+    for (const pair of normalized2.record.pairs) {
+      appendTypeWorkflowPair(record, pair);
     }
-    for (const pair of pairs) {
-      if (!Array.isArray(pair) || pair.length !== 2) {
-        continue;
-      }
-      const from = normalizeStatusToken(pair[0]);
-      const to = normalizeStatusToken(pair[1]);
-      if (from.length === 0 || to.length === 0) {
-        continue;
-      }
-      if (record.pairs.some((candidate) => candidate[0] === from && candidate[1] === to)) {
-        continue;
-      }
-      record.pairs.push([from, to]);
-    }
-    byTypeKey.set(typeKey, record);
+    byTypeKey.set(normalized2.typeKey, record);
   }
   const normalized = [];
   for (const record of byTypeKey.values()) {
@@ -5184,70 +5218,81 @@ function normalizeRuntimeFieldDefinition(definition) {
     allow_unset: definition.allow_unset !== false
   };
 }
+function normalizeRuntimeStatusDefinitions(statusesSource) {
+  const dedupedById = /* @__PURE__ */ new Map();
+  for (const [index, definition] of statusesSource.entries()) {
+    const normalized = normalizeRuntimeStatusDefinition(definition, index);
+    if (normalized) {
+      dedupedById.set(normalized.id, normalized);
+    }
+  }
+  const values = sortRuntimeStatusDefinitions([...dedupedById.values()]);
+  if (values.length > 0) {
+    return values;
+  }
+  return sortRuntimeStatusDefinitions(DEFAULT_RUNTIME_STATUS_DEFINITIONS.map((definition, index) => normalizeRuntimeStatusDefinition(definition, index)).filter((definition) => definition !== null));
+}
+function sortRuntimeStatusDefinitions(definitions) {
+  return definitions.sort((left, right) => left.order === right.order ? left.id.localeCompare(right.id) : left.order - right.order);
+}
+function normalizeRuntimeFieldDefinitions(fieldsSource) {
+  const dedupedByKey = /* @__PURE__ */ new Map();
+  for (const definition of fieldsSource ?? []) {
+    const normalized = normalizeRuntimeFieldDefinition(definition);
+    if (normalized) {
+      dedupedByKey.set(normalized.key, normalized);
+    }
+  }
+  return [...dedupedByKey.values()].sort((left, right) => left.key.localeCompare(right.key));
+}
+function serializeRuntimeStatusDefinition(definition) {
+  return {
+    id: definition.id,
+    aliases: definition.aliases.length > 0 ? [...definition.aliases] : void 0,
+    roles: definition.roles.length > 0 ? [...definition.roles] : void 0,
+    description: definition.description,
+    order: definition.order
+  };
+}
+function serializeRuntimeFieldDefinition(definition) {
+  return {
+    key: definition.key,
+    metadata_key: definition.metadata_key !== definition.key ? definition.metadata_key : void 0,
+    cli_flag: definition.cli_flag !== keyToDefaultCliFlag(definition.key) ? definition.cli_flag : void 0,
+    cli_aliases: definition.cli_aliases.length > 0 ? [...definition.cli_aliases] : void 0,
+    description: definition.description,
+    type: definition.type,
+    commands: [...definition.commands],
+    repeatable: definition.repeatable === true ? true : void 0,
+    required: definition.required === true ? true : void 0,
+    required_on_create: definition.required_on_create === true ? true : void 0,
+    required_types: definition.required_types.length > 0 ? [...definition.required_types] : void 0,
+    allow_unset: definition.allow_unset === false ? false : void 0
+  };
+}
+function normalizeUnknownFieldPolicy(policy) {
+  const candidate = typeof policy === "string" ? policy.trim().toLowerCase() : "allow";
+  return RUNTIME_UNKNOWN_FIELD_POLICY_SET.has(candidate) ? candidate : "allow";
+}
 function normalizeRuntimeSchemaSettings(schema) {
   const files = {
     ...DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,
     ...schema?.files
   };
   const statusesSource = schema?.statuses && schema.statuses.length > 0 ? schema.statuses : DEFAULT_RUNTIME_STATUS_DEFINITIONS;
-  const normalizedStatuses = (() => {
-    const dedupedById = /* @__PURE__ */ new Map();
-    for (const [index, definition] of statusesSource.entries()) {
-      const normalized = normalizeRuntimeStatusDefinition(definition, index);
-      if (!normalized) {
-        continue;
-      }
-      dedupedById.set(normalized.id, normalized);
-    }
-    const values = [...dedupedById.values()].sort((left, right) => left.order === right.order ? left.id.localeCompare(right.id) : left.order - right.order);
-    if (values.length > 0) {
-      return values;
-    }
-    return DEFAULT_RUNTIME_STATUS_DEFINITIONS.map((definition, index) => normalizeRuntimeStatusDefinition(definition, index)).filter((definition) => definition !== null);
-  })();
-  const normalizedFields = (() => {
-    const dedupedByKey = /* @__PURE__ */ new Map();
-    for (const definition of schema?.fields ?? []) {
-      const normalized = normalizeRuntimeFieldDefinition(definition);
-      if (!normalized) {
-        continue;
-      }
-      dedupedByKey.set(normalized.key, normalized);
-    }
-    return [...dedupedByKey.values()].sort((left, right) => left.key.localeCompare(right.key));
-  })();
-  const unknownFieldPolicyCandidate = typeof schema?.unknown_field_policy === "string" ? schema.unknown_field_policy.trim().toLowerCase() : "allow";
-  const unknownFieldPolicy = RUNTIME_UNKNOWN_FIELD_POLICY_SET.has(unknownFieldPolicyCandidate) ? unknownFieldPolicyCandidate : "allow";
+  const normalizedStatuses = normalizeRuntimeStatusDefinitions(statusesSource);
+  const normalizedFields = normalizeRuntimeFieldDefinitions(schema?.fields);
   return {
     version: typeof schema?.version === "number" && Number.isFinite(schema.version) ? Math.floor(schema.version) : 1,
     files,
-    statuses: normalizedStatuses.map((definition) => ({
-      id: definition.id,
-      aliases: definition.aliases.length > 0 ? [...definition.aliases] : void 0,
-      roles: definition.roles.length > 0 ? [...definition.roles] : void 0,
-      description: definition.description,
-      order: definition.order
-    })),
-    fields: normalizedFields.map((definition) => ({
-      key: definition.key,
-      metadata_key: definition.metadata_key !== definition.key ? definition.metadata_key : void 0,
-      cli_flag: definition.cli_flag !== keyToDefaultCliFlag(definition.key) ? definition.cli_flag : void 0,
-      cli_aliases: definition.cli_aliases.length > 0 ? [...definition.cli_aliases] : void 0,
-      description: definition.description,
-      type: definition.type,
-      commands: [...definition.commands],
-      repeatable: definition.repeatable === true ? true : void 0,
-      required: definition.required === true ? true : void 0,
-      required_on_create: definition.required_on_create === true ? true : void 0,
-      required_types: definition.required_types.length > 0 ? [...definition.required_types] : void 0,
-      allow_unset: definition.allow_unset === false ? false : void 0
-    })),
+    statuses: normalizedStatuses.map(serializeRuntimeStatusDefinition),
+    fields: normalizedFields.map(serializeRuntimeFieldDefinition),
     workflow: {
       ...DEFAULT_RUNTIME_WORKFLOW,
       ...normalizeRuntimeWorkflow(schema?.workflow)
     },
     type_workflows: normalizeTypeWorkflowDefinitions(schema?.type_workflows),
-    unknown_field_policy: unknownFieldPolicy
+    unknown_field_policy: normalizeUnknownFieldPolicy(schema?.unknown_field_policy)
   };
 }
 function serializeJson(value) {
@@ -5604,7 +5649,7 @@ var PmCliError = class extends Error {
 
 // dist/core/shared/serialization.js
 import crypto2 from "node:crypto";
-function sortObjectKeys(value) {
+function sortScalarValue(value) {
   if (value === null)
     return null;
   if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
@@ -5622,6 +5667,25 @@ function sortObjectKeys(value) {
   if (typeof value === "function") {
     return `[function:${value.name || "anonymous"}]`;
   }
+  return void 0;
+}
+function sortPlainObjectKeys(value) {
+  const sortedKeys = Object.keys(value).sort();
+  const result = {};
+  for (const key of sortedKeys) {
+    const nested = value[key];
+    if (nested === void 0) {
+      continue;
+    }
+    result[key] = sortObjectKeys(nested);
+  }
+  return result;
+}
+function sortObjectKeys(value) {
+  const scalarValue = sortScalarValue(value);
+  if (scalarValue !== void 0) {
+    return scalarValue;
+  }
   if (Array.isArray(value)) {
     return value.map((entry) => sortObjectKeys(entry));
   }
@@ -5635,17 +5699,7 @@ function sortObjectKeys(value) {
       return sortObjectKeys(normalized);
     }
   }
-  const obj = value;
-  const sortedKeys = Object.keys(obj).sort((a, b) => a.localeCompare(b));
-  const result = {};
-  for (const key of sortedKeys) {
-    const nested = obj[key];
-    if (nested === void 0) {
-      continue;
-    }
-    result[key] = sortObjectKeys(nested);
-  }
-  return result;
+  return sortPlainObjectKeys(value);
 }
 function stableStringify(value) {
   return JSON.stringify(sortObjectKeys(value));
@@ -6640,29 +6694,31 @@ function normalizePmMaxVersionExceededModeSetting(value) {
   }
   return void 0;
 }
+function normalizeExtensionPolicyList(policy, key) {
+  return normalizeLowerStringList(policy?.[key] ?? SETTINGS_DEFAULTS.extensions.policy[key]);
+}
 function normalizeExtensionPolicySettings(policy) {
-  const defaults = SETTINGS_DEFAULTS.extensions.policy;
   const pmMaxVersionExceededMode2 = normalizePmMaxVersionExceededModeSetting(policy?.pm_max_version_exceeded_mode);
   return {
     mode: normalizeExtensionPolicyMode(policy?.mode),
     trust_mode: normalizeExtensionTrustMode(policy?.trust_mode),
     ...pmMaxVersionExceededMode2 !== void 0 ? { pm_max_version_exceeded_mode: pmMaxVersionExceededMode2 } : {},
     require_provenance: policy?.require_provenance === true,
-    trusted_extensions: normalizeLowerStringList(policy?.trusted_extensions ?? defaults.trusted_extensions),
+    trusted_extensions: normalizeExtensionPolicyList(policy, "trusted_extensions"),
     default_sandbox_profile: normalizeExtensionSandboxProfile(policy?.default_sandbox_profile),
-    allowed_extensions: normalizeLowerStringList(policy?.allowed_extensions ?? defaults.allowed_extensions),
-    blocked_extensions: normalizeLowerStringList(policy?.blocked_extensions ?? defaults.blocked_extensions),
-    allowed_capabilities: normalizeLowerStringList(policy?.allowed_capabilities ?? defaults.allowed_capabilities),
-    blocked_capabilities: normalizeLowerStringList(policy?.blocked_capabilities ?? defaults.blocked_capabilities),
-    allowed_surfaces: normalizeLowerStringList(policy?.allowed_surfaces ?? defaults.allowed_surfaces),
-    blocked_surfaces: normalizeLowerStringList(policy?.blocked_surfaces ?? defaults.blocked_surfaces),
-    allowed_commands: normalizeLowerStringList(policy?.allowed_commands ?? defaults.allowed_commands),
-    blocked_commands: normalizeLowerStringList(policy?.blocked_commands ?? defaults.blocked_commands),
-    allowed_actions: normalizeLowerStringList(policy?.allowed_actions ?? defaults.allowed_actions),
-    blocked_actions: normalizeLowerStringList(policy?.blocked_actions ?? defaults.blocked_actions),
-    allowed_services: normalizeLowerStringList(policy?.allowed_services ?? defaults.allowed_services),
-    blocked_services: normalizeLowerStringList(policy?.blocked_services ?? defaults.blocked_services),
-    extension_overrides: normalizeExtensionPolicyOverrides(policy?.extension_overrides ?? defaults.extension_overrides)
+    allowed_extensions: normalizeExtensionPolicyList(policy, "allowed_extensions"),
+    blocked_extensions: normalizeExtensionPolicyList(policy, "blocked_extensions"),
+    allowed_capabilities: normalizeExtensionPolicyList(policy, "allowed_capabilities"),
+    blocked_capabilities: normalizeExtensionPolicyList(policy, "blocked_capabilities"),
+    allowed_surfaces: normalizeExtensionPolicyList(policy, "allowed_surfaces"),
+    blocked_surfaces: normalizeExtensionPolicyList(policy, "blocked_surfaces"),
+    allowed_commands: normalizeExtensionPolicyList(policy, "allowed_commands"),
+    blocked_commands: normalizeExtensionPolicyList(policy, "blocked_commands"),
+    allowed_actions: normalizeExtensionPolicyList(policy, "allowed_actions"),
+    blocked_actions: normalizeExtensionPolicyList(policy, "blocked_actions"),
+    allowed_services: normalizeExtensionPolicyList(policy, "allowed_services"),
+    blocked_services: normalizeExtensionPolicyList(policy, "blocked_services"),
+    extension_overrides: normalizeExtensionPolicyOverrides(policy?.extension_overrides ?? SETTINGS_DEFAULTS.extensions.policy.extension_overrides)
   };
 }
 function normalizeValidationMetadataRequiredFields(values) {
@@ -6691,6 +6747,81 @@ function recordOrEmpty(value) {
 function arrayOrEmpty(value) {
   return Array.isArray(value) ? value : [];
 }
+function buildValidationSettings(settings, defaults, governance) {
+  return {
+    ...defaults.validation,
+    ...settings.validation,
+    parent_reference: governance.parent_reference,
+    metadata_profile: governance.metadata_profile,
+    metadata_required_fields: normalizeValidationMetadataRequiredFields(settings.validation?.metadata_required_fields),
+    lifecycle_stale_blocker_reason_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_stale_blocker_reason_patterns ?? defaults.validation.lifecycle_stale_blocker_reason_patterns),
+    lifecycle_closure_like_blocked_reason_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_blocked_reason_patterns ?? defaults.validation.lifecycle_closure_like_blocked_reason_patterns),
+    lifecycle_closure_like_resolution_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_resolution_patterns ?? defaults.validation.lifecycle_closure_like_resolution_patterns),
+    lifecycle_closure_like_actual_result_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_actual_result_patterns ?? defaults.validation.lifecycle_closure_like_actual_result_patterns),
+    estimate_defaults_by_type: normalizeEstimateDefaultOverrides(settings.validation?.estimate_defaults_by_type)
+  };
+}
+function buildTelemetrySettings(settings, defaults) {
+  return {
+    enabled: settings.telemetry?.enabled ?? defaults.telemetry.enabled,
+    first_run_prompt_completed: settings.telemetry?.first_run_prompt_completed ?? defaults.telemetry.first_run_prompt_completed,
+    capture_level: settings.telemetry?.capture_level ?? defaults.telemetry.capture_level,
+    endpoint: settings.telemetry?.endpoint ?? defaults.telemetry.endpoint,
+    installation_id: settings.telemetry?.installation_id ?? defaults.telemetry.installation_id,
+    retention_days: settings.telemetry?.retention_days ?? defaults.telemetry.retention_days
+  };
+}
+function buildSearchSettings(settings, defaults) {
+  return {
+    ...defaults.search,
+    ...settings.search,
+    mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(settings.search?.mutation_refresh_policy),
+    query_expansion: {
+      ...defaults.search.query_expansion,
+      ...settings.search?.query_expansion,
+      enabled: normalizeSearchQueryExpansionEnabled(settings.search?.query_expansion?.enabled),
+      provider: normalizeSearchQueryExpansionProvider(settings.search?.query_expansion?.provider)
+    },
+    rerank: {
+      ...defaults.search.rerank,
+      ...settings.search?.rerank,
+      enabled: normalizeSearchRerankEnabled(settings.search?.rerank?.enabled),
+      model: normalizeSearchRerankModel(settings.search?.rerank?.model),
+      top_k: normalizeSearchRerankTopK(settings.search?.rerank?.top_k)
+    }
+  };
+}
+function buildVectorStoreSettings(settings, defaults) {
+  return {
+    adapter: settings.vector_store.adapter ?? defaults.vector_store.adapter,
+    collection_name: normalizeVectorStoreCollectionName(settings.vector_store.collection_name),
+    qdrant: { ...defaults.vector_store.qdrant, ...settings.vector_store.qdrant },
+    lancedb: { ...defaults.vector_store.lancedb, ...settings.vector_store.lancedb }
+  };
+}
+function normalizeSettingsItemFormat(settings, defaults) {
+  if (settings.item_format === "json_markdown") {
+    return "toon";
+  }
+  return settings.item_format ?? defaults.item_format;
+}
+function buildContextSettings(settings, defaults) {
+  return {
+    default_depth: settings.context?.default_depth ?? defaults.context.default_depth,
+    activity_limit: settings.context?.activity_limit ?? defaults.context.activity_limit,
+    stale_threshold_days: settings.context?.stale_threshold_days ?? defaults.context.stale_threshold_days,
+    sections: {
+      ...defaults.context.sections,
+      ...settings.context?.sections
+    }
+  };
+}
+function buildProviderSettings(settings, defaults) {
+  return {
+    openai: { ...defaults.providers.openai, ...settings.providers.openai },
+    ollama: { ...defaults.providers.ollama, ...settings.providers.ollama }
+  };
+}
 function normalizeItemTypeDefinitions(definitions) {
   const normalized = (definitions ?? []).map((definition) => normalizeItemTypeDefinition(definition)).filter((definition) => definition !== null);
   const dedupedByName = /* @__PURE__ */ new Map();
@@ -6707,7 +6838,7 @@ function mergeSettings(settings) {
   return {
     ...defaults,
     ...settings,
-    item_format: settings.item_format === "json_markdown" ? "toon" : settings.item_format ?? defaults.item_format,
+    item_format: normalizeSettingsItemFormat(settings, defaults),
     locks: { ...defaults.locks, ...settings.locks },
     checkpoints: { ...defaults.checkpoints, ...settings.checkpoints },
     output: { ...defaults.output, ...settings.output },
@@ -6719,18 +6850,7 @@ function mergeSettings(settings) {
         ...settings.history?.compact_policy
       }
     },
-    validation: {
-      ...defaults.validation,
-      ...settings.validation,
-      parent_reference: governance.parent_reference,
-      metadata_profile: governance.metadata_profile,
-      metadata_required_fields: normalizeValidationMetadataRequiredFields(settings.validation?.metadata_required_fields),
-      lifecycle_stale_blocker_reason_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_stale_blocker_reason_patterns ?? defaults.validation.lifecycle_stale_blocker_reason_patterns),
-      lifecycle_closure_like_blocked_reason_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_blocked_reason_patterns ?? defaults.validation.lifecycle_closure_like_blocked_reason_patterns),
-      lifecycle_closure_like_resolution_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_resolution_patterns ?? defaults.validation.lifecycle_closure_like_resolution_patterns),
-      lifecycle_closure_like_actual_result_patterns: normalizeValidationPatternList(settings.validation?.lifecycle_closure_like_actual_result_patterns ?? defaults.validation.lifecycle_closure_like_actual_result_patterns),
-      estimate_defaults_by_type: normalizeEstimateDefaultOverrides(settings.validation?.estimate_defaults_by_type)
-    },
+    validation: buildValidationSettings(settings, defaults, governance),
     governance,
     workflow: {
       definition_of_done: [...settings.workflow?.definition_of_done ?? defaults.workflow.definition_of_done]
@@ -6738,177 +6858,24 @@ function mergeSettings(settings) {
     testing: {
       record_results_to_items: settings.testing?.record_results_to_items ?? defaults.testing.record_results_to_items
     },
-    telemetry: {
-      enabled: settings.telemetry?.enabled ?? defaults.telemetry.enabled,
-      first_run_prompt_completed: settings.telemetry?.first_run_prompt_completed ?? defaults.telemetry.first_run_prompt_completed,
-      capture_level: settings.telemetry?.capture_level ?? defaults.telemetry.capture_level,
-      endpoint: settings.telemetry?.endpoint ?? defaults.telemetry.endpoint,
-      installation_id: settings.telemetry?.installation_id ?? defaults.telemetry.installation_id,
-      retention_days: settings.telemetry?.retention_days ?? defaults.telemetry.retention_days
-    },
+    telemetry: buildTelemetrySettings(settings, defaults),
     agent_guidance: normalizeAgentGuidanceSettings(settings.agent_guidance ?? defaults.agent_guidance),
     item_types: {
       definitions: normalizeItemTypeDefinitions(settings.item_types?.definitions)
     },
     schema: normalizeRuntimeSchemaSettings(settings.schema ?? defaults.schema),
-    context: {
-      default_depth: settings.context?.default_depth ?? defaults.context.default_depth,
-      activity_limit: settings.context?.activity_limit ?? defaults.context.activity_limit,
-      stale_threshold_days: settings.context?.stale_threshold_days ?? defaults.context.stale_threshold_days,
-      sections: {
-        ...defaults.context.sections,
-        ...settings.context?.sections
-      }
-    },
+    context: buildContextSettings(settings, defaults),
     extensions: {
       enabled: [...settings.extensions.enabled],
       disabled: [...settings.extensions.disabled],
       policy: normalizeExtensionPolicySettings(settings.extensions.policy ?? defaults.extensions.policy)
     },
-    search: {
-      ...defaults.search,
-      ...settings.search,
-      mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(settings.search?.mutation_refresh_policy),
-      query_expansion: {
-        ...defaults.search.query_expansion,
-        ...settings.search?.query_expansion,
-        enabled: normalizeSearchQueryExpansionEnabled(settings.search?.query_expansion?.enabled),
-        provider: normalizeSearchQueryExpansionProvider(settings.search?.query_expansion?.provider)
-      },
-      rerank: {
-        ...defaults.search.rerank,
-        ...settings.search?.rerank,
-        enabled: normalizeSearchRerankEnabled(settings.search?.rerank?.enabled),
-        model: normalizeSearchRerankModel(settings.search?.rerank?.model),
-        top_k: normalizeSearchRerankTopK(settings.search?.rerank?.top_k)
-      }
-    },
-    providers: {
-      openai: { ...defaults.providers.openai, ...settings.providers.openai },
-      ollama: { ...defaults.providers.ollama, ...settings.providers.ollama }
-    },
-    vector_store: {
-      adapter: settings.vector_store.adapter ?? defaults.vector_store.adapter,
-      collection_name: normalizeVectorStoreCollectionName(settings.vector_store.collection_name),
-      qdrant: { ...defaults.vector_store.qdrant, ...settings.vector_store.qdrant },
-      lancedb: { ...defaults.vector_store.lancedb, ...settings.vector_store.lancedb }
-    }
+    search: buildSearchSettings(settings, defaults),
+    providers: buildProviderSettings(settings, defaults),
+    vector_store: buildVectorStoreSettings(settings, defaults)
   };
 }
-function serializeSettings(settings, options = {}) {
-  const baseSettings = {
-    ...settings,
-    locks: valueOrDefault(settings.locks, SETTINGS_DEFAULTS.locks),
-    checkpoints: valueOrDefault(settings.checkpoints, SETTINGS_DEFAULTS.checkpoints),
-    output: valueOrDefault(settings.output, SETTINGS_DEFAULTS.output),
-    history: valueOrDefault(settings.history, SETTINGS_DEFAULTS.history),
-    validation: valueOrDefault(settings.validation, SETTINGS_DEFAULTS.validation),
-    workflow: valueOrDefault(settings.workflow, SETTINGS_DEFAULTS.workflow),
-    testing: valueOrDefault(settings.testing, SETTINGS_DEFAULTS.testing),
-    telemetry: valueOrDefault(settings.telemetry, SETTINGS_DEFAULTS.telemetry),
-    agent_guidance: valueOrDefault(settings.agent_guidance, SETTINGS_DEFAULTS.agent_guidance),
-    item_types: valueOrDefault(settings.item_types, SETTINGS_DEFAULTS.item_types),
-    schema: valueOrDefault(settings.schema, SETTINGS_DEFAULTS.schema),
-    context: valueOrDefault(settings.context, SETTINGS_DEFAULTS.context),
-    extensions: valueOrDefault(settings.extensions, SETTINGS_DEFAULTS.extensions),
-    search: valueOrDefault(settings.search, SETTINGS_DEFAULTS.search),
-    providers: valueOrDefault(settings.providers, SETTINGS_DEFAULTS.providers),
-    vector_store: valueOrDefault(settings.vector_store, SETTINGS_DEFAULTS.vector_store)
-  };
-  const governance = resolveGovernanceKnobs(baseSettings);
-  const normalizedSchema = normalizeRuntimeSchemaSettings(baseSettings.schema);
-  const persistedFileBackedSections = resolvePersistedFileBackedSchemaSections(baseSettings, options.persist_source);
-  const normalizedSettings = {
-    ...baseSettings,
-    item_format: "toon",
-    validation: {
-      ...baseSettings.validation,
-      parent_reference: governance.parent_reference,
-      metadata_profile: governance.metadata_profile,
-      metadata_required_fields: normalizeValidationMetadataRequiredFields(baseSettings.validation?.metadata_required_fields),
-      lifecycle_stale_blocker_reason_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_stale_blocker_reason_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_stale_blocker_reason_patterns),
-      lifecycle_closure_like_blocked_reason_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_closure_like_blocked_reason_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_closure_like_blocked_reason_patterns),
-      lifecycle_closure_like_resolution_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_closure_like_resolution_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_closure_like_resolution_patterns),
-      lifecycle_closure_like_actual_result_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_closure_like_actual_result_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_closure_like_actual_result_patterns),
-      estimate_defaults_by_type: normalizeEstimateDefaultOverrides(baseSettings.validation?.estimate_defaults_by_type)
-    },
-    governance,
-    agent_guidance: normalizeAgentGuidanceSettings(baseSettings.agent_guidance),
-    item_types: {
-      definitions: persistedFileBackedSections.item_type_definitions
-    },
-    schema: {
-      ...normalizedSchema,
-      statuses: persistedFileBackedSections.schema_statuses,
-      fields: persistedFileBackedSections.schema_fields,
-      type_workflows: persistedFileBackedSections.schema_type_workflows
-    },
-    search: {
-      ...SETTINGS_DEFAULTS.search,
-      ...baseSettings.search,
-      mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(baseSettings.search?.mutation_refresh_policy),
-      query_expansion: {
-        ...SETTINGS_DEFAULTS.search.query_expansion,
-        ...baseSettings.search?.query_expansion,
-        enabled: normalizeSearchQueryExpansionEnabled(baseSettings.search?.query_expansion?.enabled),
-        provider: normalizeSearchQueryExpansionProvider(baseSettings.search?.query_expansion?.provider)
-      },
-      rerank: {
-        ...SETTINGS_DEFAULTS.search.rerank,
-        ...baseSettings.search?.rerank,
-        enabled: normalizeSearchRerankEnabled(baseSettings.search?.rerank?.enabled),
-        model: normalizeSearchRerankModel(baseSettings.search?.rerank?.model),
-        top_k: normalizeSearchRerankTopK(baseSettings.search?.rerank?.top_k)
-      }
-    },
-    context: {
-      default_depth: baseSettings.context?.default_depth ?? SETTINGS_DEFAULTS.context.default_depth,
-      activity_limit: baseSettings.context?.activity_limit ?? SETTINGS_DEFAULTS.context.activity_limit,
-      stale_threshold_days: baseSettings.context?.stale_threshold_days ?? SETTINGS_DEFAULTS.context.stale_threshold_days,
-      sections: {
-        ...SETTINGS_DEFAULTS.context.sections,
-        ...baseSettings.context?.sections
-      }
-    },
-    extensions: {
-      enabled: normalizeStringList2(baseSettings.extensions?.enabled),
-      disabled: normalizeStringList2(baseSettings.extensions?.disabled),
-      policy: normalizeExtensionPolicySettings(baseSettings.extensions?.policy)
-    },
-    vector_store: {
-      ...baseSettings.vector_store,
-      adapter: baseSettings.vector_store?.adapter ?? SETTINGS_DEFAULTS.vector_store.adapter,
-      collection_name: normalizeVectorStoreCollectionName(baseSettings.vector_store?.collection_name),
-      qdrant: { ...baseSettings.vector_store?.qdrant },
-      lancedb: { ...baseSettings.vector_store?.lancedb }
-    }
-  };
-  const ordered = orderObject({
-    ...normalizedSettings,
-    governance: normalizeGovernanceForPersist(governance)
-  }, [
-    "version",
-    "id_prefix",
-    "author_default",
-    "item_format",
-    "locks",
-    "checkpoints",
-    "output",
-    "history",
-    "validation",
-    "governance",
-    "workflow",
-    "testing",
-    "telemetry",
-    "agent_guidance",
-    "item_types",
-    "schema",
-    "context",
-    "extensions",
-    "search",
-    "providers",
-    "vector_store"
-  ]);
+function orderSerializedSettingsSections(ordered) {
   ordered.locks = orderObject(ordered.locks, ["ttl_seconds"]);
   ordered.checkpoints = orderObject(ordered.checkpoints, ["retention_days"]);
   ordered.output = orderObject(ordered.output, ["default_format"]);
@@ -7038,6 +7005,140 @@ function serializeSettings(settings, options = {}) {
   ]);
   ordered.vector_store.qdrant = orderObject(recordOrEmpty(ordered.vector_store.qdrant), ["url", "api_key"]);
   ordered.vector_store.lancedb = orderObject(recordOrEmpty(ordered.vector_store.lancedb), ["path"]);
+}
+function buildSerializeBaseSettings(settings) {
+  return {
+    ...settings,
+    locks: valueOrDefault(settings.locks, SETTINGS_DEFAULTS.locks),
+    checkpoints: valueOrDefault(settings.checkpoints, SETTINGS_DEFAULTS.checkpoints),
+    output: valueOrDefault(settings.output, SETTINGS_DEFAULTS.output),
+    history: valueOrDefault(settings.history, SETTINGS_DEFAULTS.history),
+    validation: valueOrDefault(settings.validation, SETTINGS_DEFAULTS.validation),
+    workflow: valueOrDefault(settings.workflow, SETTINGS_DEFAULTS.workflow),
+    testing: valueOrDefault(settings.testing, SETTINGS_DEFAULTS.testing),
+    telemetry: valueOrDefault(settings.telemetry, SETTINGS_DEFAULTS.telemetry),
+    agent_guidance: valueOrDefault(settings.agent_guidance, SETTINGS_DEFAULTS.agent_guidance),
+    item_types: valueOrDefault(settings.item_types, SETTINGS_DEFAULTS.item_types),
+    schema: valueOrDefault(settings.schema, SETTINGS_DEFAULTS.schema),
+    context: valueOrDefault(settings.context, SETTINGS_DEFAULTS.context),
+    extensions: valueOrDefault(settings.extensions, SETTINGS_DEFAULTS.extensions),
+    search: valueOrDefault(settings.search, SETTINGS_DEFAULTS.search),
+    providers: valueOrDefault(settings.providers, SETTINGS_DEFAULTS.providers),
+    vector_store: valueOrDefault(settings.vector_store, SETTINGS_DEFAULTS.vector_store)
+  };
+}
+function buildSerializedValidationSettings(baseSettings, governance) {
+  return {
+    ...baseSettings.validation,
+    parent_reference: governance.parent_reference,
+    metadata_profile: governance.metadata_profile,
+    metadata_required_fields: normalizeValidationMetadataRequiredFields(baseSettings.validation?.metadata_required_fields),
+    lifecycle_stale_blocker_reason_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_stale_blocker_reason_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_stale_blocker_reason_patterns),
+    lifecycle_closure_like_blocked_reason_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_closure_like_blocked_reason_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_closure_like_blocked_reason_patterns),
+    lifecycle_closure_like_resolution_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_closure_like_resolution_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_closure_like_resolution_patterns),
+    lifecycle_closure_like_actual_result_patterns: normalizeValidationPatternList(baseSettings.validation?.lifecycle_closure_like_actual_result_patterns ?? SETTINGS_DEFAULTS.validation.lifecycle_closure_like_actual_result_patterns),
+    estimate_defaults_by_type: normalizeEstimateDefaultOverrides(baseSettings.validation?.estimate_defaults_by_type)
+  };
+}
+function buildSerializedSearchSettings(baseSettings) {
+  return {
+    ...SETTINGS_DEFAULTS.search,
+    ...baseSettings.search,
+    mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(baseSettings.search?.mutation_refresh_policy),
+    query_expansion: {
+      ...SETTINGS_DEFAULTS.search.query_expansion,
+      ...baseSettings.search?.query_expansion,
+      enabled: normalizeSearchQueryExpansionEnabled(baseSettings.search?.query_expansion?.enabled),
+      provider: normalizeSearchQueryExpansionProvider(baseSettings.search?.query_expansion?.provider)
+    },
+    rerank: {
+      ...SETTINGS_DEFAULTS.search.rerank,
+      ...baseSettings.search?.rerank,
+      enabled: normalizeSearchRerankEnabled(baseSettings.search?.rerank?.enabled),
+      model: normalizeSearchRerankModel(baseSettings.search?.rerank?.model),
+      top_k: normalizeSearchRerankTopK(baseSettings.search?.rerank?.top_k)
+    }
+  };
+}
+function buildSerializedContextSettings(baseSettings) {
+  return {
+    default_depth: baseSettings.context?.default_depth ?? SETTINGS_DEFAULTS.context.default_depth,
+    activity_limit: baseSettings.context?.activity_limit ?? SETTINGS_DEFAULTS.context.activity_limit,
+    stale_threshold_days: baseSettings.context?.stale_threshold_days ?? SETTINGS_DEFAULTS.context.stale_threshold_days,
+    sections: {
+      ...SETTINGS_DEFAULTS.context.sections,
+      ...baseSettings.context?.sections
+    }
+  };
+}
+function buildSerializedVectorStoreSettings(baseSettings) {
+  return {
+    ...baseSettings.vector_store,
+    adapter: baseSettings.vector_store?.adapter ?? SETTINGS_DEFAULTS.vector_store.adapter,
+    collection_name: normalizeVectorStoreCollectionName(baseSettings.vector_store?.collection_name),
+    qdrant: { ...baseSettings.vector_store?.qdrant },
+    lancedb: { ...baseSettings.vector_store?.lancedb }
+  };
+}
+function buildNormalizedSettingsForSerialization(baseSettings, governance, normalizedSchema, persistedFileBackedSections) {
+  return {
+    ...baseSettings,
+    item_format: "toon",
+    validation: buildSerializedValidationSettings(baseSettings, governance),
+    governance,
+    agent_guidance: normalizeAgentGuidanceSettings(baseSettings.agent_guidance),
+    item_types: {
+      definitions: persistedFileBackedSections.item_type_definitions
+    },
+    schema: {
+      ...normalizedSchema,
+      statuses: persistedFileBackedSections.schema_statuses,
+      fields: persistedFileBackedSections.schema_fields,
+      type_workflows: persistedFileBackedSections.schema_type_workflows
+    },
+    search: buildSerializedSearchSettings(baseSettings),
+    context: buildSerializedContextSettings(baseSettings),
+    extensions: {
+      enabled: normalizeStringList2(baseSettings.extensions?.enabled),
+      disabled: normalizeStringList2(baseSettings.extensions?.disabled),
+      policy: normalizeExtensionPolicySettings(baseSettings.extensions?.policy)
+    },
+    vector_store: buildSerializedVectorStoreSettings(baseSettings)
+  };
+}
+function serializeSettings(settings, options = {}) {
+  const baseSettings = buildSerializeBaseSettings(settings);
+  const governance = resolveGovernanceKnobs(baseSettings);
+  const normalizedSchema = normalizeRuntimeSchemaSettings(baseSettings.schema);
+  const persistedFileBackedSections = resolvePersistedFileBackedSchemaSections(baseSettings, options.persist_source);
+  const normalizedSettings = buildNormalizedSettingsForSerialization(baseSettings, governance, normalizedSchema, persistedFileBackedSections);
+  const ordered = orderObject({
+    ...normalizedSettings,
+    governance: normalizeGovernanceForPersist(governance)
+  }, [
+    "version",
+    "id_prefix",
+    "author_default",
+    "item_format",
+    "locks",
+    "checkpoints",
+    "output",
+    "history",
+    "validation",
+    "governance",
+    "workflow",
+    "testing",
+    "telemetry",
+    "agent_guidance",
+    "item_types",
+    "schema",
+    "context",
+    "extensions",
+    "search",
+    "providers",
+    "vector_store"
+  ]);
+  orderSerializedSettingsSections(ordered);
   return `${JSON.stringify(ordered, null, 2)}
 `;
 }
@@ -7299,6 +7400,6 @@ export {
   readSettings,
   writeSettings
 };
-//# sourceMappingURL=chunk-7R4QEMZZ.js.map
+//# sourceMappingURL=chunk-L4SLHV6G.js.map
 
-//# debugId=03ed13d8-75ea-5f3b-b089-a7347a59acca
+//# debugId=aeaf9c80-302b-561b-892d-b98b811d424b