@unbrained/pm-cli 2026.6.5 → 2026.6.7

package/dist/cli-bundle/chunks/{chunk-4LTBNUYT.js → chunk-X4IZKYHP.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]="ba0e58d6-49b8-5381-ad9e-e68ab249dc60")}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]="bcdcd911-483c-5908-892f-1986b07ffaae")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import crypto from "node:crypto";
@@ -330,6 +330,7 @@ var GOVERNANCE_PRESET_DEFAULTS = {
     ownership_enforcement: "none",
     create_mode_default: "progressive",
     close_validation_default: "off",
+    require_close_reason: true,
     parent_reference: "warn",
     metadata_profile: "core",
     force_required_for_stale_lock: false
@@ -338,6 +339,7 @@ var GOVERNANCE_PRESET_DEFAULTS = {
     ownership_enforcement: "warn",
     create_mode_default: "progressive",
     close_validation_default: "warn",
+    require_close_reason: true,
     parent_reference: "warn",
     metadata_profile: "core",
     force_required_for_stale_lock: true
@@ -346,6 +348,7 @@ var GOVERNANCE_PRESET_DEFAULTS = {
     ownership_enforcement: "strict",
     create_mode_default: "strict",
     close_validation_default: "strict",
+    require_close_reason: true,
     parent_reference: "strict_error",
     metadata_profile: "strict",
     force_required_for_stale_lock: true
@@ -452,7 +455,16 @@ var SETTINGS_DEFAULTS = {
     embedding_timeout_ms: 3e4,
     scanner_max_batch_retries: 3,
     provider: "",
-    mutation_refresh_policy: "semantic_configured"
+    mutation_refresh_policy: "semantic_configured",
+    query_expansion: {
+      enabled: false,
+      provider: ""
+    },
+    rerank: {
+      enabled: false,
+      model: "",
+      top_k: 20
+    }
   },
   providers: {
     openai: {
@@ -482,6 +494,7 @@ var SETTINGS_DEFAULTS = {
   },
   vector_store: {
     adapter: "",
+    collection_name: "pm_items",
     qdrant: {
       url: "",
       api_key: ""
@@ -606,12 +619,34 @@ function getSettingsPath(pmRoot) {
   return path4.join(pmRoot, SETTINGS_FILENAME);
 }
 function deriveDefaultTypeFolder(type) {
-  const normalized = type.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  const normalized = toSlugToken(type);
   if (normalized.length === 0) {
     return "items";
   }
   return normalized.endsWith("s") ? normalized : `${normalized}s`;
 }
+function toSlugToken(value) {
+  const trimmed = value.trim().toLowerCase();
+  let slug = "";
+  let pendingDash = false;
+  for (const character of trimmed) {
+    const code = character.charCodeAt(0);
+    const isAlpha = code >= 97 && code <= 122;
+    const isDigit = code >= 48 && code <= 57;
+    if (isAlpha || isDigit) {
+      if (pendingDash && slug.length > 0) {
+        slug += "-";
+      }
+      slug += character;
+      pendingDash = false;
+      continue;
+    }
+    if (slug.length > 0) {
+      pendingDash = true;
+    }
+  }
+  return slug;
+}
 function getTypeDirPath(pmRoot, type, typeToFolder = TYPE_TO_FOLDER) {
   const folder = typeToFolder[type] ?? deriveDefaultTypeFolder(type);
   return path4.join(pmRoot, folder);
@@ -685,6 +720,24 @@ function toErrorMessage(error) {
   }
   return String(error);
 }
+function coerceFiniteNumber(value) {
+  const parsed = typeof value === "number" ? value : typeof value === "string" && value.trim().length > 0 ? Number(value.trim()) : Number.NaN;
+  return Number.isFinite(parsed) ? parsed : null;
+}
+function coercePositiveInteger(value) {
+  const parsed = coerceFiniteNumber(value);
+  if (parsed === null || parsed <= 0 || !Number.isInteger(parsed)) {
+    return null;
+  }
+  return parsed;
+}
+function coerceNumberInRange(value, min, max) {
+  const parsed = coerceFiniteNumber(value);
+  if (parsed === null || parsed < min || parsed > max) {
+    return null;
+  }
+  return parsed;
+}
 function asRecordOrNull(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
     return null;
@@ -2003,7 +2056,7 @@ async function listExtensionDirectories(extensionsRoot) {
   }
 }
 function summarizeCandidate(candidate) {
-  return {
+  const summary = {
     layer: candidate.layer,
     directory: candidate.directory,
     manifest_path: candidate.manifest_path,
@@ -2025,6 +2078,41 @@ function summarizeCandidate(candidate) {
       commands: [...candidate.manifest.activation.commands ?? []]
     } : void 0
   };
+  if (candidate.source_package) {
+    summary.source_package = candidate.source_package;
+  }
+  return summary;
+}
+function normalizeManagedSourcePackage(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+async function readManagedExtensionSourcePackages(extensionsRoot) {
+  const packages = /* @__PURE__ */ new Map();
+  try {
+    const parsed = JSON.parse(await fs3.readFile(path5.join(extensionsRoot, ".managed-extensions.json"), "utf8"));
+    if (typeof parsed !== "object" || parsed === null || !Array.isArray(parsed.entries)) {
+      return packages;
+    }
+    for (const entry of parsed.entries) {
+      if (typeof entry !== "object" || entry === null) {
+        continue;
+      }
+      const record = entry;
+      const sourcePackage = normalizeManagedSourcePackage(record.source?.package);
+      if (!sourcePackage) {
+        continue;
+      }
+      if (typeof record.directory === "string" && record.directory.trim().length > 0) {
+        packages.set(`directory:${record.directory.trim()}`, sourcePackage);
+      }
+      if (typeof record.name === "string" && record.name.trim().length > 0) {
+        packages.set(`name:${record.name.trim()}`, sourcePackage);
+      }
+    }
+  } catch {
+    return packages;
+  }
+  return packages;
 }
 function sortCandidates(candidates) {
   return [...candidates].sort((left, right) => {
@@ -2055,8 +2143,9 @@ async function scanExtensionLayer(layer, extensionsRoot, enabled, disabled) {
   const warnings = [];
   const candidates = [];
   const directories = await listExtensionDirectories(extensionsRoot);
+  const managedSourcePackages = await readManagedExtensionSourcePackages(extensionsRoot);
   for (const directory of directories) {
-    const scanned = await scanExtensionDirectory(layer, extensionsRoot, directory, enabled, disabled);
+    const scanned = await scanExtensionDirectory(layer, extensionsRoot, directory, enabled, disabled, managedSourcePackages);
     diagnostics.push(scanned.diagnostic);
     warnings.push(...scanned.warnings);
     if (scanned.candidate) {
@@ -2065,7 +2154,7 @@ async function scanExtensionLayer(layer, extensionsRoot, enabled, disabled) {
   }
   return { diagnostics, warnings, candidates };
 }
-async function scanExtensionDirectory(layer, extensionsRoot, directory, enabled, disabled) {
+async function scanExtensionDirectory(layer, extensionsRoot, directory, enabled, disabled, managedSourcePackages) {
   const extensionDir = path5.join(extensionsRoot, directory);
   const manifestPath = path5.join(extensionDir, "manifest.json");
   if (!await pathExists(manifestPath)) {
@@ -2137,6 +2226,7 @@ async function scanExtensionDirectory(layer, extensionsRoot, directory, enabled,
     extensionWarnings.push(pmMaxVersionCompatibility.warning);
   }
   const extensionReady = entryWithinDirectory && entryExists && pmVersionCompatibility.allowed && pmMaxVersionCompatibility.allowed;
+  const sourcePackage = managedSourcePackages.get(`directory:${directory}`) ?? managedSourcePackages.get(`name:${manifest.name}`);
   return {
     diagnostic: {
       layer,
@@ -2156,7 +2246,8 @@ async function scanExtensionDirectory(layer, extensionsRoot, directory, enabled,
       directory,
       manifest_path: manifestPath,
       entry_path: entryPath,
-      manifest
+      manifest,
+      source_package: sourcePackage
     } : null
   };
 }
@@ -2868,6 +2959,7 @@ function createExtensionApi(extension, hooks, commands, parsers, preflight, serv
       const registration = {
         layer: extension.layer,
         name: extension.name,
+        source_package: extension.source_package,
         command: normalizedCommand,
         action,
         examples,
@@ -3047,6 +3139,7 @@ function createExtensionApi(extension, hooks, commands, parsers, preflight, serv
     const registration = {
       layer: extension.layer,
       name: extension.name,
+      source_package: extension.source_package,
       command: commandPath,
       action,
       examples,
@@ -4641,6 +4734,7 @@ var governanceSettings = vOptional(vObject({
   ownership_enforcement: vOptional(vLiteral("none", "warn", "strict")),
   create_mode_default: vOptional(vLiteral("progressive", "strict")),
   close_validation_default: vOptional(vLiteral("off", "warn", "strict")),
+  require_close_reason: vOptional(vBoolean),
   parent_reference: vOptional(vLiteral("warn", "strict_error")),
   metadata_profile: vOptional(vLiteral("core", "strict", "custom")),
   force_required_for_stale_lock: vOptional(vBoolean),
@@ -4747,11 +4841,21 @@ var settingsCheck = vObject({
     hybrid_semantic_weight: vOptional(vNumber()),
     max_results: vNumber({ int: true }),
     embedding_model: vString,
+    embedding_corpus_max_characters: vOptional(vNumber()),
     embedding_batch_size: vNumber({ int: true }),
     embedding_timeout_ms: vOptional(vNumber({ int: true })),
     scanner_max_batch_retries: vNumber({ int: true }),
     provider: vOptional(vString),
-    mutation_refresh_policy: vOptional(vLiteral("cache_only", "semantic_configured", "semantic_auto"))
+    mutation_refresh_policy: vOptional(vLiteral("cache_only", "semantic_configured", "semantic_auto")),
+    query_expansion: vOptional(vObject({
+      enabled: vOptional(vBoolean),
+      provider: vOptional(vString)
+    })),
+    rerank: vOptional(vObject({
+      enabled: vOptional(vBoolean),
+      model: vOptional(vString),
+      top_k: vOptional(vNumber({ int: true, positive: true }))
+    }))
   }),
   providers: vObject({
     openai: vObject({ base_url: vString, api_key: vString, model: vString }),
@@ -4759,6 +4863,7 @@ var settingsCheck = vObject({
   }),
   vector_store: vObject({
     adapter: vOptional(vString),
+    collection_name: vOptional(vString),
     qdrant: vObject({ url: vString, api_key: vString }),
     lancedb: vObject({ path: vString })
   })
@@ -4854,6 +4959,8 @@ function normalizeItemTypeDefinition(definition, options = {}) {
 
 // dist/core/store/settings.js
 var SETTINGS_WRITE_OP = "settings:write";
+var SETTINGS_PERSIST_SOURCE_SYMBOL = /* @__PURE__ */ Symbol("pm.settings.persist_source");
+var MAX_VECTOR_STORE_COLLECTION_NAME_LENGTH = 128;
 function resolveGovernanceKnobsFromPreset(preset) {
   return structuredClone(GOVERNANCE_PRESET_DEFAULTS[preset]);
 }
@@ -4871,6 +4978,9 @@ function withGovernanceExtras(base, governance) {
   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;
+  }
   return base;
 }
 function normalizeGovernanceForPersist(governance) {
@@ -4891,32 +5001,44 @@ function normalizeGovernanceForPersist(governance) {
 }
 function resolveGovernanceExtras(rawGovernance) {
   const createDefaultType = typeof rawGovernance.create_default_type === "string" ? rawGovernance.create_default_type.trim() : void 0;
-  return {
-    create_default_type: createDefaultType && createDefaultType.length > 0 ? createDefaultType : void 0,
-    workflow_enforcement: rawGovernance.workflow_enforcement === "off" || rawGovernance.workflow_enforcement === "warn" || rawGovernance.workflow_enforcement === "strict" ? rawGovernance.workflow_enforcement : 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;
+  }
+  return extras;
 }
 function resolveGovernanceKnobs(settings) {
   const rawGovernance = settings.governance ?? {};
   const preset = normalizeGovernancePreset(rawGovernance.preset);
   const extras = resolveGovernanceExtras(rawGovernance);
   if (preset === "custom") {
-    const baseline = resolveGovernanceKnobsFromPreset("default");
+    const baseline2 = resolveGovernanceKnobsFromPreset("default");
+    const requireCloseReason2 = extras.require_close_reason ?? baseline2.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
+      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
     };
   }
+  const baseline = resolveGovernanceKnobsFromPreset(preset);
+  const requireCloseReason = extras.require_close_reason ?? baseline.require_close_reason;
   return {
     preset,
-    ...resolveGovernanceKnobsFromPreset(preset),
-    ...extras
+    ...baseline,
+    ...extras,
+    require_close_reason: requireCloseReason
   };
 }
 function cloneDefaults() {
@@ -4928,6 +5050,102 @@ function normalizeSearchMutationRefreshPolicy(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 buildSettingsPersistSourceSnapshot(parsedSettings, runtimeSettings) {
+  const sourceSchema = parsedSettings.schema;
+  const sourceStatuses = Array.isArray(sourceSchema?.statuses) ? sourceSchema?.statuses : void 0;
+  const sourceFields = Array.isArray(sourceSchema?.fields) ? sourceSchema?.fields : void 0;
+  const sourceTypeWorkflows = Array.isArray(sourceSchema?.type_workflows) ? sourceSchema?.type_workflows : void 0;
+  return {
+    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 !== void 0,
+    source_schema_statuses: sourceStatuses ? structuredClone(sourceStatuses) : [],
+    has_source_schema_fields: sourceFields !== void 0,
+    source_schema_fields: sourceFields ? structuredClone(sourceFields) : [],
+    has_source_schema_type_workflows: sourceTypeWorkflows !== void 0,
+    source_schema_type_workflows: sourceTypeWorkflows ? structuredClone(sourceTypeWorkflows) : [],
+    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 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(),
@@ -5160,7 +5378,20 @@ function mergeSettings(settings) {
     search: {
       ...defaults.search,
       ...settings.search,
-      mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(settings.search?.mutation_refresh_policy)
+      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 },
@@ -5168,13 +5399,16 @@ function mergeSettings(settings) {
     },
     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 }
     }
   };
 }
-function serializeSettings(settings) {
+function serializeSettings(settings, options = {}) {
   const governance = resolveGovernanceKnobs(settings);
+  const normalizedSchema = normalizeRuntimeSchemaSettings(settings.schema);
+  const persistedFileBackedSections = resolvePersistedFileBackedSchemaSections(settings, options.persist_source);
   const normalizedSettings = {
     ...settings,
     item_format: "toon",
@@ -5191,13 +5425,31 @@ function serializeSettings(settings) {
     governance,
     agent_guidance: normalizeAgentGuidanceSettings(settings.agent_guidance),
     item_types: {
-      definitions: normalizeItemTypeDefinitions(settings.item_types?.definitions)
+      definitions: persistedFileBackedSections.item_type_definitions
+    },
+    schema: {
+      ...normalizedSchema,
+      statuses: persistedFileBackedSections.schema_statuses,
+      fields: persistedFileBackedSections.schema_fields,
+      type_workflows: persistedFileBackedSections.schema_type_workflows
     },
-    schema: normalizeRuntimeSchemaSettings(settings.schema),
     search: {
       ...SETTINGS_DEFAULTS.search,
       ...settings.search,
-      mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(settings.search?.mutation_refresh_policy)
+      mutation_refresh_policy: normalizeSearchMutationRefreshPolicy(settings.search?.mutation_refresh_policy),
+      query_expansion: {
+        ...SETTINGS_DEFAULTS.search.query_expansion,
+        ...settings.search?.query_expansion ?? {},
+        enabled: normalizeSearchQueryExpansionEnabled(settings.search?.query_expansion?.enabled),
+        provider: normalizeSearchQueryExpansionProvider(settings.search?.query_expansion?.provider)
+      },
+      rerank: {
+        ...SETTINGS_DEFAULTS.search.rerank,
+        ...settings.search?.rerank ?? {},
+        enabled: normalizeSearchRerankEnabled(settings.search?.rerank?.enabled),
+        model: normalizeSearchRerankModel(settings.search?.rerank?.model),
+        top_k: normalizeSearchRerankTopK(settings.search?.rerank?.top_k)
+      }
     },
     context: {
       default_depth: settings.context?.default_depth ?? SETTINGS_DEFAULTS.context.default_depth,
@@ -5212,6 +5464,13 @@ function serializeSettings(settings) {
       enabled: normalizeStringList2(settings.extensions?.enabled),
       disabled: normalizeStringList2(settings.extensions?.disabled),
       policy: normalizeExtensionPolicySettings(settings.extensions?.policy)
+    },
+    vector_store: {
+      ...settings.vector_store ?? {},
+      adapter: settings.vector_store?.adapter ?? SETTINGS_DEFAULTS.vector_store.adapter,
+      collection_name: normalizeVectorStoreCollectionName(settings.vector_store?.collection_name),
+      qdrant: { ...settings.vector_store?.qdrant ?? {} },
+      lancedb: { ...settings.vector_store?.lancedb ?? {} }
     }
   };
   const ordered = orderObject({
@@ -5257,6 +5516,7 @@ function serializeSettings(settings) {
     "ownership_enforcement",
     "create_mode_default",
     "close_validation_default",
+    "require_close_reason",
     "parent_reference",
     "metadata_profile",
     "force_required_for_stale_lock",
@@ -5342,16 +5602,26 @@ function serializeSettings(settings) {
     "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"
+    "mutation_refresh_policy",
+    "query_expansion",
+    "rerank"
   ]);
+  ordered.search.query_expansion = orderObject(ordered.search.query_expansion ?? {}, ["enabled", "provider"]);
+  ordered.search.rerank = orderObject(ordered.search.rerank ?? {}, ["enabled", "model", "top_k"]);
   ordered.providers = orderObject(ordered.providers, ["openai", "ollama"]);
   ordered.providers.openai = orderObject(ordered.providers.openai ?? {}, ["base_url", "api_key", "model"]);
   ordered.providers.ollama = orderObject(ordered.providers.ollama ?? {}, ["base_url", "model"]);
-  ordered.vector_store = orderObject(ordered.vector_store, ["adapter", "qdrant", "lancedb"]);
+  ordered.vector_store = orderObject(ordered.vector_store, [
+    "adapter",
+    "collection_name",
+    "qdrant",
+    "lancedb"
+  ]);
   ordered.vector_store.qdrant = orderObject(ordered.vector_store.qdrant ?? {}, ["url", "api_key"]);
   ordered.vector_store.lancedb = orderObject(ordered.vector_store.lancedb ?? {}, ["path"]);
   return `${JSON.stringify(ordered, null, 2)}
@@ -5391,6 +5661,7 @@ async function readSettingsWithMetadata(pmRoot) {
       },
       schema: loadedSchemaSections.schema
     };
+    attachSettingsPersistSourceSnapshot(settings, buildSettingsPersistSourceSnapshot(validated.data, settings));
     return {
       settings,
       metadata: {
@@ -5411,7 +5682,9 @@ async function readSettings(pmRoot) {
 }
 async function writeSettings(pmRoot, settings, op = SETTINGS_WRITE_OP) {
   const settingsPath = getSettingsPath(pmRoot);
-  await writeFileAtomic(settingsPath, serializeSettings(settings));
+  await writeFileAtomic(settingsPath, serializeSettings(settings, {
+    persist_source: getSettingsPersistSourceSnapshot(settings)
+  }));
   await runActiveOnWriteHooks({
     path: settingsPath,
     scope: "project",
@@ -5470,6 +5743,8 @@ export {
   trimTrailingSlashes,
   isFiniteNumberArray,
   toErrorMessage,
+  coercePositiveInteger,
+  coerceNumberInRange,
   asRecordOrNull,
   parseUnknownExtensionCapabilityWarning,
   parseLegacyExtensionCapabilityAliasWarning,
@@ -5548,6 +5823,6 @@ export {
   readSettings,
   writeSettings
 };
-//# sourceMappingURL=chunk-4LTBNUYT.js.map
+//# sourceMappingURL=chunk-X4IZKYHP.js.map
 
-//# debugId=ba0e58d6-49b8-5381-ad9e-e68ab249dc60
+//# debugId=bcdcd911-483c-5908-892f-1986b07ffaae