@unbrained/pm-cli 2026.5.14 → 2026.5.24

package/dist/core/store/settings.js

@@ -1,263 +1,13 @@
-import { z } from "zod";
+
+!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]="7fed7222-981d-50f3-8a28-3635f56361b9")}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";
-const itemTypeOptionSchema = z.object({
-    key: z.string(),
-    values: z.array(z.string()),
-    required: z.boolean().optional(),
-    aliases: z.array(z.string()).optional(),
-    description: z.string().optional(),
-});
-const itemTypeCommandOptionPolicySchema = z.object({
-    command: z.union([z.literal("create"), z.literal("update")]),
-    option: z.string(),
-    required: z.boolean().optional(),
-    visible: z.boolean().optional(),
-    enabled: z.boolean().optional(),
-});
-const itemTypeDefinitionSchema = z.object({
-    name: z.string(),
-    folder: z.string().optional(),
-    aliases: z.array(z.string()).optional(),
-    required_create_fields: z.array(z.string()).optional(),
-    required_create_repeatables: z.array(z.string()).optional(),
-    options: z.array(itemTypeOptionSchema).optional(),
-    command_option_policies: z.array(itemTypeCommandOptionPolicySchema).optional(),
-});
-const runtimeStatusDefinitionSchema = z.object({
-    id: z.string(),
-    aliases: z.array(z.string()).optional(),
-    roles: z
-        .array(z.union([
-        z.literal("draft"),
-        z.literal("active"),
-        z.literal("blocked"),
-        z.literal("terminal"),
-        z.literal("terminal_done"),
-        z.literal("terminal_canceled"),
-        z.literal("default_open"),
-        z.literal("default_close"),
-        z.literal("default_cancel"),
-    ]))
-        .optional(),
-    description: z.string().optional(),
-    order: z.number().optional(),
-});
-const runtimeFieldDefinitionSchema = z.object({
-    key: z.string(),
-    metadata_key: z.string().optional(),
-    front_matter_key: z.string().optional(),
-    cli_flag: z.string().optional(),
-    cli_aliases: z.array(z.string()).optional(),
-    description: z.string().optional(),
-    type: z.union([z.literal("string"), z.literal("number"), z.literal("boolean"), z.literal("string_array")]).optional(),
-    commands: z
-        .array(z.union([
-        z.literal("create"),
-        z.literal("update"),
-        z.literal("update_many"),
-        z.literal("list"),
-        z.literal("search"),
-        z.literal("calendar"),
-        z.literal("context"),
-    ]))
-        .optional(),
-    repeatable: z.boolean().optional(),
-    required: z.boolean().optional(),
-    required_on_create: z.boolean().optional(),
-    required_types: z.array(z.string()).optional(),
-    allow_unset: z.boolean().optional(),
-});
-const runtimeSchemaSettingsSchema = z
-    .object({
-    version: z.number().int().optional(),
-    files: z
-        .object({
-        types: z.string().optional(),
-        statuses: z.string().optional(),
-        fields: z.string().optional(),
-        workflows: z.string().optional(),
-    })
-        .optional(),
-    statuses: z.array(runtimeStatusDefinitionSchema).optional(),
-    fields: z.array(runtimeFieldDefinitionSchema).optional(),
-    workflow: z
-        .object({
-        draft_status: z.string().optional(),
-        open_status: z.string().optional(),
-        in_progress_status: z.string().optional(),
-        blocked_status: z.string().optional(),
-        close_status: z.string().optional(),
-        canceled_status: z.string().optional(),
-    })
-        .optional(),
-    unknown_field_policy: z.union([z.literal("allow"), z.literal("warn"), z.literal("reject")]).optional(),
-})
-    .optional();
-const governanceSettingsSchema = z
-    .object({
-    preset: z.union([z.literal("minimal"), z.literal("default"), z.literal("strict"), z.literal("custom")]).optional(),
-    ownership_enforcement: z.union([z.literal("none"), z.literal("warn"), z.literal("strict")]).optional(),
-    create_mode_default: z.union([z.literal("progressive"), z.literal("strict")]).optional(),
-    close_validation_default: z.union([z.literal("off"), z.literal("warn"), z.literal("strict")]).optional(),
-    parent_reference: z.union([z.literal("warn"), z.literal("strict_error")]).optional(),
-    metadata_profile: z.union([z.literal("core"), z.literal("strict"), z.literal("custom")]).optional(),
-    force_required_for_stale_lock: z.boolean().optional(),
-})
-    .optional();
-const extensionPolicyOverrideSchema = z.object({
-    name: z.string(),
-    disabled: z.boolean().optional(),
-    require_trusted: z.boolean().optional(),
-    require_provenance: z.boolean().optional(),
-    sandbox_profile: z.union([z.literal("none"), z.literal("restricted"), z.literal("strict")]).optional(),
-    allowed_capabilities: z.array(z.string()).optional(),
-    blocked_capabilities: z.array(z.string()).optional(),
-    allowed_surfaces: z.array(z.string()).optional(),
-    blocked_surfaces: z.array(z.string()).optional(),
-    allowed_commands: z.array(z.string()).optional(),
-    blocked_commands: z.array(z.string()).optional(),
-    allowed_actions: z.array(z.string()).optional(),
-    blocked_actions: z.array(z.string()).optional(),
-    allowed_services: z.array(z.string()).optional(),
-    blocked_services: z.array(z.string()).optional(),
-});
-const extensionPolicySchema = z
-    .object({
-    mode: z.union([z.literal("off"), z.literal("warn"), z.literal("enforce")]).optional(),
-    trust_mode: z.union([z.literal("off"), z.literal("warn"), z.literal("enforce")]).optional(),
-    require_provenance: z.boolean().optional(),
-    trusted_extensions: z.array(z.string()).optional(),
-    default_sandbox_profile: z.union([z.literal("none"), z.literal("restricted"), z.literal("strict")]).optional(),
-    allowed_extensions: z.array(z.string()).optional(),
-    blocked_extensions: z.array(z.string()).optional(),
-    allowed_capabilities: z.array(z.string()).optional(),
-    blocked_capabilities: z.array(z.string()).optional(),
-    allowed_surfaces: z.array(z.string()).optional(),
-    blocked_surfaces: z.array(z.string()).optional(),
-    allowed_commands: z.array(z.string()).optional(),
-    blocked_commands: z.array(z.string()).optional(),
-    allowed_actions: z.array(z.string()).optional(),
-    blocked_actions: z.array(z.string()).optional(),
-    allowed_services: z.array(z.string()).optional(),
-    blocked_services: z.array(z.string()).optional(),
-    extension_overrides: z.array(extensionPolicyOverrideSchema).optional(),
-})
-    .optional();
-const settingsSchema = z.object({
-    version: z.number().int(),
-    id_prefix: z.string(),
-    author_default: z.string(),
-    item_format: z.union([z.literal("toon"), z.literal("json_markdown")]).optional(),
-    locks: z.object({
-        ttl_seconds: z.number().int(),
-    }),
-    output: z.object({
-        default_format: z.union([z.literal("toon"), z.literal("json")]),
-    }),
-    history: z
-        .object({
-        missing_stream: z.union([z.literal("auto_create"), z.literal("strict_error")]),
-    })
-        .optional(),
-    validation: z
-        .object({
-        sprint_release_format: z.union([z.literal("warn"), z.literal("strict_error")]),
-        parent_reference: z.union([z.literal("warn"), z.literal("strict_error")]).optional(),
-        metadata_profile: z.union([z.literal("core"), z.literal("strict"), z.literal("custom")]).optional(),
-        metadata_required_fields: z.array(z.string()).optional(),
-        lifecycle_stale_blocker_reason_patterns: z.array(z.string()).optional(),
-        lifecycle_closure_like_blocked_reason_patterns: z.array(z.string()).optional(),
-        lifecycle_closure_like_resolution_patterns: z.array(z.string()).optional(),
-        lifecycle_closure_like_actual_result_patterns: z.array(z.string()).optional(),
-    })
-        .optional(),
-    governance: governanceSettingsSchema,
-    workflow: z
-        .object({
-        definition_of_done: z.array(z.string()),
-    })
-        .optional(),
-    testing: z
-        .object({
-        record_results_to_items: z.boolean(),
-    })
-        .optional(),
-    telemetry: z
-        .object({
-        enabled: z.boolean(),
-        first_run_prompt_completed: z.boolean().optional(),
-        capture_level: z.union([z.literal("minimal"), z.literal("redacted"), z.literal("max")]).optional(),
-        endpoint: z.string().optional(),
-        installation_id: z.string().optional(),
-        retention_days: z.number().int().positive().optional(),
-    })
-        .optional(),
-    item_types: z
-        .object({
-        definitions: z.array(itemTypeDefinitionSchema),
-    })
-        .optional(),
-    schema: runtimeSchemaSettingsSchema,
-    context: z
-        .object({
-        default_depth: z.union([z.literal("brief"), z.literal("standard"), z.literal("deep")]).optional(),
-        activity_limit: z.number().int().positive().optional(),
-        stale_threshold_days: z.number().int().positive().optional(),
-        sections: z
-            .object({
-            hierarchy: z.boolean().optional(),
-            activity: z.boolean().optional(),
-            progress: z.boolean().optional(),
-            blockers: z.boolean().optional(),
-            files: z.boolean().optional(),
-            workload: z.boolean().optional(),
-            staleness: z.boolean().optional(),
-            tests: z.boolean().optional(),
-        })
-            .optional(),
-    })
-        .optional(),
-    extensions: z.object({
-        enabled: z.array(z.string()),
-        disabled: z.array(z.string()),
-        policy: extensionPolicySchema,
-    }),
-    search: z.object({
-        score_threshold: z.number(),
-        hybrid_semantic_weight: z.number().optional(),
-        max_results: z.number().int(),
-        embedding_model: z.string(),
-        embedding_batch_size: z.number().int(),
-        scanner_max_batch_retries: z.number().int(),
-        provider: z.string().optional(),
-    }),
-    providers: z.object({
-        openai: z.object({
-            base_url: z.string(),
-            api_key: z.string(),
-            model: z.string(),
-        }),
-        ollama: z.object({
-            base_url: z.string(),
-            model: z.string(),
-        }),
-    }),
-    vector_store: z.object({
-        adapter: z.string().optional(),
-        qdrant: z.object({
-            url: z.string(),
-            api_key: z.string(),
-        }),
-        lancedb: z.object({
-            path: z.string(),
-        }),
-    }),
-});
+import { normalizeItemTypeDefinition } from "../item/item-type-definition.js";
 const SETTINGS_WRITE_OP = "settings:write";
 function resolveGovernanceKnobsFromPreset(preset) {
     return structuredClone(GOVERNANCE_PRESET_DEFAULTS[preset]);
@@ -326,6 +76,19 @@ function hasExplicitItemFormat(raw) {
 function normalizeStringList(values) {
     return [...new Set((values ?? []).map((value) => value.trim()).filter((value) => value.length > 0))].sort((left, right) => left.localeCompare(right));
 }
+function normalizeAgentGuidanceSettings(value) {
+    const defaults = SETTINGS_DEFAULTS.agent_guidance;
+    const templateVersion = value?.template_version;
+    return {
+        prompt_completed: value?.prompt_completed === true,
+        declined: value?.declined === true,
+        declined_at: typeof value?.declined_at === "string" ? value.declined_at : defaults.declined_at,
+        template_version: typeof templateVersion === "number" && Number.isInteger(templateVersion) && templateVersion > 0
+            ? templateVersion
+            : defaults.template_version,
+        last_checked_files: normalizeStringList(value?.last_checked_files ?? defaults.last_checked_files),
+    };
+}
 function normalizeLowerStringList(values) {
     return [...new Set((values ?? []).map((value) => value.trim().toLowerCase()).filter((value) => value.length > 0))].sort((left, right) => left.localeCompare(right));
 }
@@ -462,75 +225,6 @@ function normalizeValidationMetadataRequiredFields(values) {
 function normalizeValidationPatternList(values) {
     return [...new Set((values ?? []).map((value) => value.trim().toLowerCase()).filter((value) => value.length > 0))].sort((left, right) => left.localeCompare(right));
 }
-function normalizeItemTypeOptionDefinition(option) {
-    const key = option.key.trim();
-    if (key.length === 0) {
-        return null;
-    }
-    const values = normalizeStringList(option.values);
-    const aliases = normalizeStringList(option.aliases);
-    const description = option.description?.trim();
-    return {
-        key,
-        values,
-        required: option.required === true ? true : undefined,
-        aliases: aliases.length > 0 ? aliases : undefined,
-        description: description && description.length > 0 ? description : undefined,
-    };
-}
-function normalizeItemTypeCommandOptionPolicy(policy) {
-    const option = policy.option.trim();
-    if (option.length === 0) {
-        return null;
-    }
-    return {
-        command: policy.command,
-        option,
-        required: policy.required,
-        visible: policy.visible,
-        enabled: policy.enabled,
-    };
-}
-function normalizeItemTypeDefinition(definition) {
-    const name = definition.name.trim();
-    if (name.length === 0) {
-        return null;
-    }
-    const hasRequiredCreateFields = definition.required_create_fields !== undefined;
-    const hasRequiredCreateRepeatables = definition.required_create_repeatables !== undefined;
-    const hasOptions = definition.options !== undefined;
-    const hasCommandOptionPolicies = definition.command_option_policies !== undefined;
-    const folder = definition.folder?.trim();
-    const aliases = normalizeStringList(definition.aliases);
-    const requiredCreateFields = normalizeStringList(definition.required_create_fields);
-    const requiredCreateRepeatables = normalizeStringList(definition.required_create_repeatables);
-    const options = (definition.options ?? [])
-        .map((option) => normalizeItemTypeOptionDefinition(option))
-        .filter((option) => option !== null)
-        .sort((left, right) => left.key.localeCompare(right.key));
-    const commandOptionPolicies = (() => {
-        const dedupedByKey = new Map();
-        for (const policy of definition.command_option_policies ?? []) {
-            const normalized = normalizeItemTypeCommandOptionPolicy(policy);
-            if (!normalized) {
-                continue;
-            }
-            dedupedByKey.set(`${normalized.command}:${normalized.option.toLowerCase()}`, normalized);
-        }
-        return [...dedupedByKey.values()].sort((left, right) => left.command === right.command
-            ? left.option.localeCompare(right.option)
-            : left.command.localeCompare(right.command));
-    })();
-    return {
-        name,
-        folder: folder && folder.length > 0 ? folder : undefined,
-        aliases: aliases.length > 0 ? aliases : undefined,
-        required_create_fields: hasRequiredCreateFields ? requiredCreateFields : undefined,
-        required_create_repeatables: hasRequiredCreateRepeatables ? requiredCreateRepeatables : undefined,
-        options: hasOptions ? options : undefined,
-        command_option_policies: hasCommandOptionPolicies ? commandOptionPolicies : undefined,
-    };
-}
 export function normalizeItemTypeDefinitions(definitions) {
     const normalized = (definitions ?? [])
         .map((definition) => normalizeItemTypeDefinition(definition))
@@ -541,13 +235,8 @@ export function normalizeItemTypeDefinitions(definitions) {
     }
     return [...dedupedByName.values()].sort((left, right) => left.name.localeCompare(right.name));
 }
-function mergeSettings(raw) {
+function mergeSettings(settings) {
     const defaults = cloneDefaults();
-    const parsed = settingsSchema.safeParse(raw);
-    if (!parsed.success) {
-        return defaults;
-    }
-    const settings = parsed.data;
     const governance = resolveGovernanceKnobs({
         governance: settings.governance ?? { preset: "default" },
     });
@@ -588,6 +277,7 @@ function mergeSettings(raw) {
             installation_id: settings.telemetry?.installation_id ?? defaults.telemetry.installation_id,
             retention_days: settings.telemetry?.retention_days ?? defaults.telemetry.retention_days,
         },
+        agent_guidance: normalizeAgentGuidanceSettings(settings.agent_guidance ?? defaults.agent_guidance),
         item_types: {
             definitions: normalizeItemTypeDefinitions(settings.item_types?.definitions),
         },
@@ -638,6 +328,7 @@ export function serializeSettings(settings) {
                 SETTINGS_DEFAULTS.validation.lifecycle_closure_like_actual_result_patterns),
         },
         governance,
+        agent_guidance: normalizeAgentGuidanceSettings(settings.agent_guidance),
         item_types: {
             definitions: normalizeItemTypeDefinitions(settings.item_types?.definitions),
         },
@@ -673,6 +364,7 @@ export function serializeSettings(settings) {
         "workflow",
         "testing",
         "telemetry",
+        "agent_guidance",
         "item_types",
         "schema",
         "context",
@@ -713,6 +405,13 @@ export function serializeSettings(settings) {
         "installation_id",
         "retention_days",
     ]);
+    ordered.agent_guidance = orderObject(ordered.agent_guidance, [
+        "prompt_completed",
+        "declined",
+        "declined_at",
+        "template_version",
+        "last_checked_files",
+    ]);
     ordered.item_types = orderObject(ordered.item_types, ["definitions"]);
     ordered.schema = orderObject(ordered.schema, [
         "version",
@@ -775,6 +474,7 @@ export function serializeSettings(settings) {
         "max_results",
         "embedding_model",
         "embedding_batch_size",
+        "embedding_timeout_ms",
         "scanner_max_batch_retries",
         "provider",
     ]);
@@ -803,7 +503,7 @@ export async function readSettingsWithMetadata(pmRoot) {
     catch {
         return buildFallbackSettingsReadResult("settings_read_invalid_json");
     }
-    const validated = settingsSchema.safeParse(parsed);
+    const validated = validateSettings(parsed);
     if (!validated.success) {
         return buildFallbackSettingsReadResult("settings_read_invalid_schema");
     }
@@ -851,4 +551,5 @@ export async function writeSettings(pmRoot, settings, op = SETTINGS_WRITE_OP) {
         op,
     });
 }
-//# sourceMappingURL=settings.js.map
+//# sourceMappingURL=settings.js.map
+//# debugId=7fed7222-981d-50f3-8a28-3635f56361b9