@unbrained/pm-cli 2026.6.5 → 2026.6.7

package/dist/core/store/settings.js

@@ -1,14 +1,16 @@
 
-!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]="6673022c-d06c-5b59-aba1-b56cacea7973")}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]="40eb6325-776d-5b33-887f-abbdee742b52")}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 { readFileIfExists, writeFileAtomic } from "../fs/fs-utils.js";
 import { ensureRuntimeSchemaFileScaffold, loadRuntimeSchemaFromOptionalFiles, normalizeRuntimeSchemaSettings, } from "../schema/runtime-schema.js";
 import { getSettingsPath } from "./paths.js";
-import { orderObject } from "../shared/serialization.js";
+import { orderObject, stableValueEquals } from "../shared/serialization.js";
 import { normalizeItemTypeDefinition } from "../item/item-type-definition.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;
 function resolveGovernanceKnobsFromPreset(preset) {
     return structuredClone(GOVERNANCE_PRESET_DEFAULTS[preset]);
 }
@@ -32,6 +34,9 @@ function withGovernanceExtras(base, governance) {
         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) {
@@ -54,14 +59,19 @@ function normalizeGovernanceForPersist(governance) {
 // governance regardless of preset (see normalizeGovernanceForPersist).
 function resolveGovernanceExtras(rawGovernance) {
     const createDefaultType = typeof rawGovernance.create_default_type === "string" ? rawGovernance.create_default_type.trim() : undefined;
-    return {
-        create_default_type: createDefaultType && createDefaultType.length > 0 ? createDefaultType : undefined,
-        workflow_enforcement: rawGovernance.workflow_enforcement === "off" ||
-            rawGovernance.workflow_enforcement === "warn" ||
-            rawGovernance.workflow_enforcement === "strict"
-            ? rawGovernance.workflow_enforcement
-            : 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;
+    }
+    return extras;
 }
 export function resolveGovernanceKnobs(settings) {
     const rawGovernance = settings.governance ?? {};
@@ -69,6 +79,7 @@ export function resolveGovernanceKnobs(settings) {
     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,
@@ -78,12 +89,16 @@ export function resolveGovernanceKnobs(settings) {
             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,
         };
     }
+    const baseline = resolveGovernanceKnobsFromPreset(preset);
+    const requireCloseReason = extras.require_close_reason ?? baseline.require_close_reason;
     return {
         preset,
-        ...resolveGovernanceKnobsFromPreset(preset),
+        ...baseline,
         ...extras,
+        require_close_reason: requireCloseReason,
     };
 }
 function cloneDefaults() {
@@ -95,6 +110,118 @@ 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 : undefined;
+    const sourceFields = Array.isArray(sourceSchema?.fields) ? sourceSchema?.fields : undefined;
+    const sourceTypeWorkflows = Array.isArray(sourceSchema?.type_workflows) ? sourceSchema?.type_workflows : undefined;
+    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 !== undefined,
+        source_schema_statuses: sourceStatuses ? structuredClone(sourceStatuses) : [],
+        has_source_schema_fields: sourceFields !== undefined,
+        source_schema_fields: sourceFields ? structuredClone(sourceFields) : [],
+        has_source_schema_type_workflows: sourceTypeWorkflows !== undefined,
+        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 undefined;
+    }
+    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)
+                : undefined
+            : normalizedSchema.type_workflows,
+    };
+}
 function buildFallbackSettingsReadResult(warning) {
     return {
         settings: cloneDefaults(),
@@ -338,6 +465,19 @@ function mergeSettings(settings) {
             ...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 },
@@ -345,13 +485,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 },
         },
     };
 }
-export function serializeSettings(settings) {
+export 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",
@@ -372,13 +515,31 @@ export 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),
+            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,
@@ -394,6 +555,13 @@ export function serializeSettings(settings) {
             disabled: normalizeStringList(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({
         ...normalizedSettings,
@@ -438,6 +606,7 @@ export function serializeSettings(settings) {
         "ownership_enforcement",
         "create_mode_default",
         "close_validation_default",
+        "require_close_reason",
         "parent_reference",
         "metadata_profile",
         "force_required_for_stale_lock",
@@ -523,16 +692,26 @@ export 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",
+        "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)}\n`;
@@ -572,6 +751,7 @@ export async function readSettingsWithMetadata(pmRoot) {
             },
             schema: loadedSchemaSections.schema,
         };
+        attachSettingsPersistSourceSnapshot(settings, buildSettingsPersistSourceSnapshot(validated.data, settings));
         return {
             settings,
             metadata: {
@@ -595,7 +775,9 @@ export async function readSettings(pmRoot) {
 }
 export 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",
@@ -603,4 +785,4 @@ export async function writeSettings(pmRoot, settings, op = SETTINGS_WRITE_OP) {
     });
 }
 //# sourceMappingURL=settings.js.map
-//# debugId=6673022c-d06c-5b59-aba1-b56cacea7973
+//# debugId=40eb6325-776d-5b33-887f-abbdee742b52