@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/core/config/nested-settings.js

@@ -1,535 +1,2 @@
-/**
- * Nested leaf settings exposed via `pm config <scope> set/get <key> <value>`.
- *
- * These are simple string/number leaves of {@link PmSettings} (provider URLs,
- * vector-store adapter, search tuning) that previously required hand-editing
- * `.agents/pm/settings.json`. They live here so the same dotted path is
- * documented in one place and surfaced both to the config dispatcher and to
- * `pm config list` (so `pm config list --json` is discoverable).
- *
- * Shape conventions:
- * - `path` is the dotted JSON path in {@link PmSettings} (e.g. `search.provider`).
- * - `kind` is the value shape: "string" | "boolean" | "integer" | "number" | "ratio"
- *   - "ratio" must be a finite number in [0, 1].
- *   - "integer" must be a finite non-negative integer. Set `min: 1` for keys
- *     where the runtime silently falls back when 0 is supplied (e.g. batch
- *     size, timeout, max-results limits).
- *   - "number" must be a finite number — negatives ARE allowed (e.g. score
- *     thresholds may legitimately be negative when a provider normalizes
- *     scores into a signed range).
- *
- * Adding a key here makes it acceptable to `pm config <scope> set <key> <value>`
- * with no other code changes — the dispatcher walks the dotted path on the
- * already-validated PmSettings shape.
- */
-/** Search/provider/vector-store leaves. Order is the display order in `pm config list` and in error hints. */
-
-!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]="4e50d57b-4502-5ce5-a6dd-0bdc8eba5af4")}catch(e){}}();
-export const NESTED_SETTING_DESCRIPTORS = [
-    {
-        key: "search_provider",
-        path: "search.provider",
-        kind: "string",
-        summary: "Search embedding provider name (e.g. openai, ollama, or an extension provider).",
-    },
-    {
-        key: "search_mutation_refresh_policy",
-        path: "search.mutation_refresh_policy",
-        kind: "string",
-        choices: ["cache_only", "semantic_configured", "semantic_auto"],
-        summary: "Mutation-time search refresh policy: cache_only, semantic_configured, or semantic_auto.",
-    },
-    {
-        key: "search_query_expansion_enabled",
-        path: "search.query_expansion.enabled",
-        kind: "boolean",
-        summary: "Enable or disable query expansion for semantic/hybrid search.",
-    },
-    {
-        key: "search_query_expansion_provider",
-        path: "search.query_expansion.provider",
-        kind: "string",
-        summary: "Query expansion provider name (built-in openai/ollama or extension provider).",
-    },
-    {
-        key: "search_rerank_enabled",
-        path: "search.rerank.enabled",
-        kind: "boolean",
-        summary: "Enable or disable post-retrieval reranking for hybrid search.",
-    },
-    {
-        key: "search_rerank_model",
-        path: "search.rerank.model",
-        kind: "string",
-        summary: "Rerank model name override used by built-in providers.",
-    },
-    {
-        key: "search_rerank_top_k",
-        path: "search.rerank.top_k",
-        kind: "integer",
-        min: 1,
-        summary: "Number of top hybrid candidates to rerank when rerank is enabled.",
-    },
-    {
-        key: "search_embedding_model",
-        path: "search.embedding_model",
-        kind: "string",
-        summary: "Default embedding model name (overrides provider-specific model when set).",
-    },
-    {
-        key: "search_embedding_corpus_max_characters",
-        path: "search.embedding_corpus_max_characters",
-        kind: "integer",
-        min: 1,
-        summary: "Maximum semantic corpus characters per item before truncation.",
-    },
-    {
-        key: "search_embedding_batch_size",
-        path: "search.embedding_batch_size",
-        kind: "integer",
-        min: 1,
-        summary: "Number of items embedded per request batch.",
-    },
-    {
-        key: "search_embedding_timeout_ms",
-        path: "search.embedding_timeout_ms",
-        kind: "integer",
-        min: 1,
-        summary: "Per-request embedding timeout in milliseconds.",
-    },
-    {
-        key: "search_score_threshold",
-        path: "search.score_threshold",
-        kind: "number",
-        summary: "Minimum score for a hit to be returned (0 keeps all matches).",
-    },
-    {
-        key: "search_hybrid_semantic_weight",
-        path: "search.hybrid_semantic_weight",
-        kind: "ratio",
-        summary: "Hybrid mode semantic weight in [0, 1] (1-weight goes to keyword).",
-    },
-    {
-        key: "search_max_results",
-        path: "search.max_results",
-        kind: "integer",
-        min: 1,
-        summary: "Default upper bound on search hits when --limit is not supplied.",
-    },
-    {
-        key: "search_bm25_k1",
-        path: "search.bm25.k1",
-        kind: "number",
-        min: 0,
-        summary: "Offline BM25 term-frequency saturation (k1); higher saturates repeated terms slower (default 1.2).",
-    },
-    {
-        key: "search_bm25_b",
-        path: "search.bm25.b",
-        kind: "ratio",
-        summary: "Offline BM25 document-length normalization (b) in [0, 1]; 0 disables, 1 fully normalizes (default 0.75).",
-    },
-    {
-        key: "openai_base_url",
-        path: "providers.openai.base_url",
-        kind: "string",
-        summary: "OpenAI-compatible API base URL (LM Studio/vLLM also use this).",
-    },
-    {
-        key: "openai_api_key",
-        path: "providers.openai.api_key",
-        kind: "string",
-        summary: "OpenAI-compatible API key.",
-    },
-    {
-        key: "openai_model",
-        path: "providers.openai.model",
-        kind: "string",
-        summary: "OpenAI-compatible embedding model name.",
-    },
-    {
-        key: "ollama_base_url",
-        path: "providers.ollama.base_url",
-        kind: "string",
-        summary: "Ollama API base URL (typically http://localhost:11434).",
-    },
-    {
-        key: "ollama_model",
-        path: "providers.ollama.model",
-        kind: "string",
-        summary: "Ollama embedding model name (e.g. nomic-embed-text).",
-    },
-    {
-        key: "vector_store_adapter",
-        path: "vector_store.adapter",
-        kind: "string",
-        summary: "Vector store adapter name (lancedb, qdrant, or an extension adapter).",
-    },
-    {
-        key: "vector_store_collection_name",
-        path: "vector_store.collection_name",
-        kind: "string",
-        non_empty: true,
-        summary: "Vector collection/table name shared by Qdrant and LanceDB adapters.",
-    },
-    {
-        key: "qdrant_url",
-        path: "vector_store.qdrant.url",
-        kind: "string",
-        summary: "Qdrant HTTP API URL.",
-    },
-    {
-        key: "qdrant_api_key",
-        path: "vector_store.qdrant.api_key",
-        kind: "string",
-        summary: "Qdrant API key (empty if running unauthenticated).",
-    },
-    {
-        key: "lancedb_path",
-        path: "vector_store.lancedb.path",
-        kind: "string",
-        summary: "LanceDB storage path (relative to pm root or absolute).",
-    },
-    // General workspace leaves (id/author/output/locks/schema governance). These
-    // are documented user-facing settings in CONFIGURATION.md that previously
-    // required hand-editing settings.json.
-    {
-        key: "id_prefix",
-        path: "id_prefix",
-        kind: "string",
-        non_empty: true,
-        summary: 'Prefix for generated item IDs (e.g. "pm" produces pm-xxxx).',
-    },
-    {
-        key: "author_default",
-        path: "author_default",
-        kind: "string",
-        non_empty: true,
-        summary: "Default author recorded on mutations when --author is not supplied.",
-    },
-    {
-        key: "agent_identity_probes_enabled",
-        path: "agent_identity.probes_enabled",
-        kind: "boolean",
-        summary: "Allow privacy-bounded local harness provenance probes; no network or subprocess access is permitted.",
-    },
-    {
-        key: "mutation_guard_require_attributed_author",
-        path: "mutation_guard.require_attributed_author",
-        kind: "boolean",
-        summary: "Reject mutations whose effective author resolves to unknown.",
-    },
-    {
-        key: "mutation_guard_secret_guard",
-        path: "mutation_guard.secret_guard",
-        kind: "string",
-        choices: ["off", "advise", "block"],
-        summary: "Detect credential-shaped mutation content: off, advise, or block.",
-    },
-    {
-        key: "mutation_guard_stale_in_progress_hours",
-        path: "mutation_guard.stale_in_progress_hours",
-        kind: "integer",
-        min: 1,
-        summary: "Age threshold for unclaimed in-progress work surfaced by health.",
-    },
-    {
-        key: "governance_duplicate_detection_mode",
-        path: "governance.duplicate_detection_mode",
-        kind: "string",
-        choices: ["off", "advisory", "strict"],
-        summary: "Create/copy duplicate governance: off, advisory, or strict explicit-bypass enforcement.",
-    },
-    {
-        key: "governance_duplicate_detection_threshold",
-        path: "governance.duplicate_detection_threshold",
-        kind: "ratio",
-        summary: "Minimum shared similarity score in [0, 1] for create/copy duplicate governance.",
-    },
-    {
-        key: "governance_duplicate_detection_limit",
-        path: "governance.duplicate_detection_limit",
-        kind: "integer",
-        min: 0,
-        max: 20,
-        summary: "Maximum likely duplicates returned by create/copy governance (0-20).",
-    },
-    {
-        key: "output_default_format",
-        path: "output.default_format",
-        kind: "string",
-        choices: ["toon", "json"],
-        summary: "Default output format for commands that support it: toon or json.",
-    },
-    {
-        key: "ux_deprecation_hints",
-        path: "ux.deprecation_hints",
-        kind: "boolean",
-        summary: "Emit one stderr migration hint for deprecated command aliases.",
-    },
-    {
-        key: "locks_ttl_seconds",
-        path: "locks.ttl_seconds",
-        kind: "integer",
-        min: 1,
-        summary: "Claim/lock time-to-live in seconds before a stale lock can be reclaimed.",
-    },
-    {
-        key: "locks_wait_ms",
-        path: "locks.wait_ms",
-        kind: "integer",
-        min: 0,
-        summary: "Bounded jittered wait in milliseconds before a contended item mutation fails with lock_conflict; 0 fails fast. PM_LOCK_WAIT_MS overrides per invocation.",
-    },
-    {
-        key: "ids_token_length",
-        path: "ids.token_length",
-        kind: "integer",
-        min: 4,
-        max: 12,
-        summary: "Random base36 token length for newly minted item ids (4-12, default 4). Raise it to shrink cross-branch id collision odds in concurrent multi-agent workflows (pm-pibw).",
-    },
-    {
-        key: "checkpoints_retention_days",
-        path: "checkpoints.retention_days",
-        kind: "integer",
-        min: 1,
-        summary: "Age in days above which pm gc --scope checkpoints prunes bulk-mutation rollback checkpoints.",
-    },
-    {
-        key: "schema_unknown_field_policy",
-        path: "schema.unknown_field_policy",
-        kind: "string",
-        choices: ["allow", "warn", "reject"],
-        summary: "How item I/O handles metadata keys not in the field registry: allow, warn, or reject.",
-    },
-    // History compaction policy leaves (pm health advisory + pm history-compact
-    // bulk-sweep default threshold). Disabled by default; enabling makes large
-    // streams discoverable without a manual stats pass.
-    {
-        key: "history_compact_policy_enabled",
-        path: "history.compact_policy.enabled",
-        kind: "boolean",
-        summary: "Enable the history-compaction advisory: pm health warns on over-threshold streams.",
-    },
-    {
-        key: "history_compact_policy_max_entries",
-        path: "history.compact_policy.max_entries",
-        kind: "integer",
-        min: 1,
-        summary: "Entry count above which a history stream is flagged (and the default pm history-compact --all-over threshold).",
-    },
-    {
-        key: "history_compact_policy_trigger",
-        path: "history.compact_policy.trigger",
-        kind: "string",
-        choices: ["health_warn", "auto"],
-        summary: "History-compaction policy intent: health_warn (advisory only) or auto (scheduled sweeps expected).",
-    },
-];
-const DESCRIPTOR_BY_KEY = new Map(NESTED_SETTING_DESCRIPTORS.flatMap((descriptor) => [
-    [descriptor.key, descriptor],
-    [descriptor.path.toLowerCase().replaceAll("-", "_"), descriptor],
-]));
-/** Map a raw user-supplied key (kebab case, snake case, or the dotted settings path surfaced by `pm config list`) onto a known nested-leaf descriptor. Returns `undefined` when the key is not a nested leaf, letting callers fall back to the regular ConfigKey path. */
-export function resolveNestedSettingDescriptor(raw) {
-    if (typeof raw !== "string") {
-        return undefined;
-    }
-    const normalized = raw.trim().toLowerCase().replaceAll("-", "_");
-    if (normalized.length === 0) {
-        return undefined;
-    }
-    return DESCRIPTOR_BY_KEY.get(normalized);
-}
-function parseNestedBooleanValue(descriptor, rawValue) {
-    const normalized = rawValue.trim().toLowerCase();
-    if (normalized === "true" ||
-        normalized === "1" ||
-        normalized === "yes" ||
-        normalized === "on") {
-        return { ok: true, parsed: { descriptor, value: true } };
-    }
-    if (normalized === "false" ||
-        normalized === "0" ||
-        normalized === "no" ||
-        normalized === "off") {
-        return { ok: true, parsed: { descriptor, value: false } };
-    }
-    return {
-        ok: false,
-        error: {
-            message: `Config set ${descriptor.key} requires a boolean value (true|false), got "${rawValue}"`,
-        },
-    };
-}
-function parseNestedStringValue(descriptor, rawValue, trimmed) {
-    if (descriptor.non_empty === true && trimmed.length === 0) {
-        return {
-            ok: false,
-            error: {
-                message: `Config set ${descriptor.key} requires a non-empty value`,
-            },
-        };
-    }
-    if (descriptor.choices && !descriptor.choices.includes(trimmed)) {
-        return {
-            ok: false,
-            error: {
-                message: `Config set ${descriptor.key} must be one of ${descriptor.choices.join("|")}, got "${rawValue}"`,
-            },
-        };
-    }
-    return { ok: true, parsed: { descriptor, value: trimmed } };
-}
-function parseFiniteNestedNumber(descriptor, rawValue, trimmed) {
-    if (trimmed.length === 0) {
-        return {
-            ok: false,
-            error: {
-                message: `Config set ${descriptor.key} requires a non-empty value`,
-            },
-        };
-    }
-    const parsed = Number(trimmed);
-    if (!Number.isFinite(parsed)) {
-        return {
-            ok: false,
-            error: {
-                message: `Config set ${descriptor.key} requires a finite number, got "${rawValue}"`,
-            },
-        };
-    }
-    return { ok: true, value: parsed };
-}
-function parseNestedIntegerValue(descriptor, rawValue, value) {
-    if (!Number.isInteger(value) || value < 0) {
-        return {
-            ok: false,
-            error: {
-                message: `Config set ${descriptor.key} requires a non-negative integer, got "${rawValue}"`,
-            },
-        };
-    }
-    if (descriptor.min !== undefined && value < descriptor.min) {
-        return {
-            ok: false,
-            error: {
-                message: `Config set ${descriptor.key} requires an integer >= ${descriptor.min}, got "${rawValue}" (the runtime silently ignores 0 here and falls back to the default)`,
-            },
-        };
-    }
-    if (descriptor.max !== undefined && value > descriptor.max) {
-        return {
-            ok: false,
-            error: {
-                message: `Config set ${descriptor.key} requires an integer <= ${descriptor.max}, got "${rawValue}"`,
-            },
-        };
-    }
-    return { ok: true, parsed: { descriptor, value } };
-}
-function parseNestedRatioValue(descriptor, rawValue, value) {
-    if (value < 0 || value > 1) {
-        return {
-            ok: false,
-            error: {
-                message: `Config set ${descriptor.key} requires a number in [0, 1], got "${rawValue}"`,
-            },
-        };
-    }
-    return { ok: true, parsed: { descriptor, value } };
-}
-function parseNestedNumberValue(descriptor, rawValue, value) {
-    if (descriptor.min !== undefined && value < descriptor.min) {
-        return {
-            ok: false,
-            error: {
-                message: `Config set ${descriptor.key} requires a number >= ${descriptor.min}, got "${rawValue}"`,
-            },
-        };
-    }
-    return { ok: true, parsed: { descriptor, value } };
-}
-/**
- * Validate and coerce a raw string value for a nested-leaf setting. The
- * returned value is the typed leaf that should be written into PmSettings.
- *
- * Empty strings are allowed for "string" leaves unless `non_empty` is set.
- */
-export function parseNestedSettingValue(descriptor, rawValue) {
-    if (typeof rawValue !== "string") {
-        return {
-            ok: false,
-            error: {
-                message: `Config set ${descriptor.key} requires a string value`,
-            },
-        };
-    }
-    const trimmed = rawValue.trim();
-    if (descriptor.kind === "boolean") {
-        return parseNestedBooleanValue(descriptor, rawValue);
-    }
-    if (descriptor.kind === "string") {
-        return parseNestedStringValue(descriptor, rawValue, trimmed);
-    }
-    // Number("") === 0, which would silently accept empty / whitespace-only input
-    // as a valid zero. Reject explicitly so misconfigurations don't slip through.
-    const parsed = parseFiniteNestedNumber(descriptor, rawValue, trimmed);
-    if (!parsed.ok) {
-        return { ok: false, error: parsed.error };
-    }
-    if (descriptor.kind === "integer") {
-        return parseNestedIntegerValue(descriptor, rawValue, parsed.value);
-    }
-    if (descriptor.kind === "ratio") {
-        return parseNestedRatioValue(descriptor, rawValue, parsed.value);
-    }
-    // kind === "number" — negatives are allowed; only apply an explicit `min`.
-    return parseNestedNumberValue(descriptor, rawValue, parsed.value);
-}
-/** Walk a dotted path on an arbitrary record (best-effort, returns null on miss). */
-export function readNestedSettingValue(settings, descriptor) {
-    const segments = descriptor.path.split(".");
-    let cursor = settings;
-    for (const segment of segments) {
-        if (typeof cursor !== "object" || cursor === null) {
-            return null;
-        }
-        cursor = cursor[segment];
-    }
-    if (typeof cursor === "string" ||
-        typeof cursor === "number" ||
-        typeof cursor === "boolean") {
-        return cursor;
-    }
-    return null;
-}
-/** Set a leaf value on a settings object by walking the descriptor's dotted path. Missing intermediate objects are created. Returns `true` when the value actually changed. */
-export function writeNestedSettingValue(settings, descriptor, value) {
-    const segments = descriptor.path.split(".");
-    let cursor = settings;
-    for (let index = 0; index < segments.length - 1; index += 1) {
-        const segment = segments[index];
-        const existing = cursor[segment];
-        if (typeof existing !== "object" ||
-            existing === null ||
-            Array.isArray(existing)) {
-            const next = {};
-            cursor[segment] = next;
-            cursor = next;
-        }
-        else {
-            cursor = existing;
-        }
-    }
-    const leafKey = segments[segments.length - 1];
-    const previous = cursor[leafKey];
-    if (previous === value) {
-        return false;
-    }
-    cursor[leafKey] = value;
-    return true;
-}
+!(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]="bdebba4f-e8e4-5171-97d2-099c8d65cdb4")}catch(e2){}})();const NESTED_SETTING_DESCRIPTORS=[{key:"search_provider",path:"search.provider",kind:"string",summary:"Search embedding provider name (e.g. openai, ollama, or an extension provider)."},{key:"search_mutation_refresh_policy",path:"search.mutation_refresh_policy",kind:"string",choices:["cache_only","semantic_configured","semantic_auto"],summary:"Mutation-time search refresh policy: cache_only, semantic_configured, or semantic_auto."},{key:"search_query_expansion_enabled",path:"search.query_expansion.enabled",kind:"boolean",summary:"Enable or disable query expansion for semantic/hybrid search."},{key:"search_query_expansion_provider",path:"search.query_expansion.provider",kind:"string",summary:"Query expansion provider name (built-in openai/ollama or extension provider)."},{key:"search_rerank_enabled",path:"search.rerank.enabled",kind:"boolean",summary:"Enable or disable post-retrieval reranking for hybrid search."},{key:"search_rerank_model",path:"search.rerank.model",kind:"string",summary:"Rerank model name override used by built-in providers."},{key:"search_rerank_top_k",path:"search.rerank.top_k",kind:"integer",min:1,summary:"Number of top hybrid candidates to rerank when rerank is enabled."},{key:"search_embedding_model",path:"search.embedding_model",kind:"string",summary:"Default embedding model name (overrides provider-specific model when set)."},{key:"search_embedding_corpus_max_characters",path:"search.embedding_corpus_max_characters",kind:"integer",min:1,summary:"Maximum semantic corpus characters per item before truncation."},{key:"search_embedding_batch_size",path:"search.embedding_batch_size",kind:"integer",min:1,summary:"Number of items embedded per request batch."},{key:"search_embedding_timeout_ms",path:"search.embedding_timeout_ms",kind:"integer",min:1,summary:"Per-request embedding timeout in milliseconds."},{key:"search_score_threshold",path:"search.score_threshold",kind:"number",summary:"Minimum score for a hit to be returned (0 keeps all matches)."},{key:"search_hybrid_semantic_weight",path:"search.hybrid_semantic_weight",kind:"ratio",summary:"Hybrid mode semantic weight in [0, 1] (1-weight goes to keyword)."},{key:"search_max_results",path:"search.max_results",kind:"integer",min:1,summary:"Default upper bound on search hits when --limit is not supplied."},{key:"search_bm25_k1",path:"search.bm25.k1",kind:"number",min:0,summary:"Offline BM25 term-frequency saturation (k1); higher saturates repeated terms slower (default 1.2)."},{key:"search_bm25_b",path:"search.bm25.b",kind:"ratio",summary:"Offline BM25 document-length normalization (b) in [0, 1]; 0 disables, 1 fully normalizes (default 0.75)."},{key:"openai_base_url",path:"providers.openai.base_url",kind:"string",summary:"OpenAI-compatible API base URL (LM Studio/vLLM also use this)."},{key:"openai_api_key",path:"providers.openai.api_key",kind:"string",summary:"OpenAI-compatible API key."},{key:"openai_model",path:"providers.openai.model",kind:"string",summary:"OpenAI-compatible embedding model name."},{key:"ollama_base_url",path:"providers.ollama.base_url",kind:"string",summary:"Ollama API base URL (typically http://localhost:11434)."},{key:"ollama_model",path:"providers.ollama.model",kind:"string",summary:"Ollama embedding model name (e.g. nomic-embed-text)."},{key:"vector_store_adapter",path:"vector_store.adapter",kind:"string",summary:"Vector store adapter name (lancedb, qdrant, or an extension adapter)."},{key:"vector_store_collection_name",path:"vector_store.collection_name",kind:"string",non_empty:true,summary:"Vector collection/table name shared by Qdrant and LanceDB adapters."},{key:"qdrant_url",path:"vector_store.qdrant.url",kind:"string",summary:"Qdrant HTTP API URL."},{key:"qdrant_api_key",path:"vector_store.qdrant.api_key",kind:"string",summary:"Qdrant API key (empty if running unauthenticated)."},{key:"lancedb_path",path:"vector_store.lancedb.path",kind:"string",summary:"LanceDB storage path (relative to pm root or absolute)."},{key:"id_prefix",path:"id_prefix",kind:"string",non_empty:true,summary:'Prefix for generated item IDs (e.g. "pm" produces pm-xxxx).'},{key:"author_default",path:"author_default",kind:"string",non_empty:true,summary:"Default author recorded on mutations when --author is not supplied."},{key:"agent_identity_probes_enabled",path:"agent_identity.probes_enabled",kind:"boolean",summary:"Allow privacy-bounded local harness provenance probes; no network or subprocess access is permitted."},{key:"mutation_guard_require_attributed_author",path:"mutation_guard.require_attributed_author",kind:"boolean",summary:"Reject mutations whose effective author resolves to unknown."},{key:"mutation_guard_secret_guard",path:"mutation_guard.secret_guard",kind:"string",choices:["off","advise","block"],summary:"Detect credential-shaped mutation content: off, advise, or block."},{key:"mutation_guard_stale_in_progress_hours",path:"mutation_guard.stale_in_progress_hours",kind:"integer",min:1,summary:"Age threshold for unclaimed in-progress work surfaced by health."},{key:"governance_duplicate_detection_mode",path:"governance.duplicate_detection_mode",kind:"string",choices:["off","advisory","strict"],summary:"Create/copy duplicate governance: off, advisory, or strict explicit-bypass enforcement."},{key:"governance_duplicate_detection_threshold",path:"governance.duplicate_detection_threshold",kind:"ratio",summary:"Minimum shared similarity score in [0, 1] for create/copy duplicate governance."},{key:"governance_duplicate_detection_limit",path:"governance.duplicate_detection_limit",kind:"integer",min:0,max:20,summary:"Maximum likely duplicates returned by create/copy governance (0-20)."},{key:"output_default_format",path:"output.default_format",kind:"string",choices:["toon","json"],summary:"Default output format for commands that support it: toon or json."},{key:"ux_deprecation_hints",path:"ux.deprecation_hints",kind:"boolean",summary:"Emit one stderr migration hint for deprecated command aliases."},{key:"locks_ttl_seconds",path:"locks.ttl_seconds",kind:"integer",min:1,summary:"Claim/lock time-to-live in seconds before a stale lock can be reclaimed."},{key:"locks_wait_ms",path:"locks.wait_ms",kind:"integer",min:0,summary:"Bounded jittered wait in milliseconds before a contended item mutation fails with lock_conflict; 0 fails fast. PM_LOCK_WAIT_MS overrides per invocation."},{key:"ids_token_length",path:"ids.token_length",kind:"integer",min:4,max:12,summary:"Random base36 token length for newly minted item ids (4-12, default 4). Raise it to shrink cross-branch id collision odds in concurrent multi-agent workflows (pm-pibw)."},{key:"checkpoints_retention_days",path:"checkpoints.retention_days",kind:"integer",min:1,summary:"Age in days above which pm gc --scope checkpoints prunes bulk-mutation rollback checkpoints."},{key:"schema_unknown_field_policy",path:"schema.unknown_field_policy",kind:"string",choices:["allow","warn","reject"],summary:"How item I/O handles metadata keys not in the field registry: allow, warn, or reject."},{key:"history_compact_policy_enabled",path:"history.compact_policy.enabled",kind:"boolean",summary:"Enable the history-compaction advisory: pm health warns on over-threshold streams."},{key:"history_compact_policy_max_entries",path:"history.compact_policy.max_entries",kind:"integer",min:1,summary:"Entry count above which a history stream is flagged (and the default pm history-compact --all-over threshold)."},{key:"history_compact_policy_trigger",path:"history.compact_policy.trigger",kind:"string",choices:["health_warn","auto"],summary:"History-compaction policy intent: health_warn (advisory only) or auto (scheduled sweeps expected)."}];const DESCRIPTOR_BY_KEY=new Map(NESTED_SETTING_DESCRIPTORS.flatMap(descriptor=>[[descriptor.key,descriptor],[descriptor.path.toLowerCase().replaceAll("-","_"),descriptor]]));function resolveNestedSettingDescriptor(raw){if(typeof raw!=="string"){return void 0}const normalized=raw.trim().toLowerCase().replaceAll("-","_");if(normalized.length===0){return void 0}return DESCRIPTOR_BY_KEY.get(normalized)}function parseNestedBooleanValue(descriptor,rawValue){const normalized=rawValue.trim().toLowerCase();if(normalized==="true"||normalized==="1"||normalized==="yes"||normalized==="on"){return{ok:true,parsed:{descriptor,value:true}}}if(normalized==="false"||normalized==="0"||normalized==="no"||normalized==="off"){return{ok:true,parsed:{descriptor,value:false}}}return{ok:false,error:{message:`Config set ${descriptor.key} requires a boolean value (true|false), got "${rawValue}"`}}}function parseNestedStringValue(descriptor,rawValue,trimmed){if(descriptor.non_empty===true&&trimmed.length===0){return{ok:false,error:{message:`Config set ${descriptor.key} requires a non-empty value`}}}if(descriptor.choices&&!descriptor.choices.includes(trimmed)){return{ok:false,error:{message:`Config set ${descriptor.key} must be one of ${descriptor.choices.join("|")}, got "${rawValue}"`}}}return{ok:true,parsed:{descriptor,value:trimmed}}}function parseFiniteNestedNumber(descriptor,rawValue,trimmed){if(trimmed.length===0){return{ok:false,error:{message:`Config set ${descriptor.key} requires a non-empty value`}}}const parsed=Number(trimmed);if(!Number.isFinite(parsed)){return{ok:false,error:{message:`Config set ${descriptor.key} requires a finite number, got "${rawValue}"`}}}return{ok:true,value:parsed}}function parseNestedIntegerValue(descriptor,rawValue,value){if(!Number.isInteger(value)||value<0){return{ok:false,error:{message:`Config set ${descriptor.key} requires a non-negative integer, got "${rawValue}"`}}}if(descriptor.min!==void 0&&value<descriptor.min){return{ok:false,error:{message:`Config set ${descriptor.key} requires an integer >= ${descriptor.min}, got "${rawValue}" (the runtime silently ignores 0 here and falls back to the default)`}}}if(descriptor.max!==void 0&&value>descriptor.max){return{ok:false,error:{message:`Config set ${descriptor.key} requires an integer <= ${descriptor.max}, got "${rawValue}"`}}}return{ok:true,parsed:{descriptor,value}}}function parseNestedRatioValue(descriptor,rawValue,value){if(value<0||value>1){return{ok:false,error:{message:`Config set ${descriptor.key} requires a number in [0, 1], got "${rawValue}"`}}}return{ok:true,parsed:{descriptor,value}}}function parseNestedNumberValue(descriptor,rawValue,value){if(descriptor.min!==void 0&&value<descriptor.min){return{ok:false,error:{message:`Config set ${descriptor.key} requires a number >= ${descriptor.min}, got "${rawValue}"`}}}return{ok:true,parsed:{descriptor,value}}}function parseNestedSettingValue(descriptor,rawValue){if(typeof rawValue!=="string"){return{ok:false,error:{message:`Config set ${descriptor.key} requires a string value`}}}const trimmed=rawValue.trim();if(descriptor.kind==="boolean"){return parseNestedBooleanValue(descriptor,rawValue)}if(descriptor.kind==="string"){return parseNestedStringValue(descriptor,rawValue,trimmed)}const parsed=parseFiniteNestedNumber(descriptor,rawValue,trimmed);if(!parsed.ok){return{ok:false,error:parsed.error}}if(descriptor.kind==="integer"){return parseNestedIntegerValue(descriptor,rawValue,parsed.value)}if(descriptor.kind==="ratio"){return parseNestedRatioValue(descriptor,rawValue,parsed.value)}return parseNestedNumberValue(descriptor,rawValue,parsed.value)}function readNestedSettingValue(settings,descriptor){const segments=descriptor.path.split(".");let cursor=settings;for(const segment of segments){if(typeof cursor!=="object"||cursor===null){return null}cursor=cursor[segment]}if(typeof cursor==="string"||typeof cursor==="number"||typeof cursor==="boolean"){return cursor}return null}function writeNestedSettingValue(settings,descriptor,value){const segments=descriptor.path.split(".");let cursor=settings;for(let index=0;index<segments.length-1;index+=1){const segment=segments[index];const existing=cursor[segment];if(typeof existing!=="object"||existing===null||Array.isArray(existing)){const next={};cursor[segment]=next;cursor=next}else{cursor=existing}}const leafKey=segments[segments.length-1];const previous=cursor[leafKey];if(previous===value){return false}cursor[leafKey]=value;return true}export{NESTED_SETTING_DESCRIPTORS,parseNestedSettingValue,readNestedSettingValue,resolveNestedSettingDescriptor,writeNestedSettingValue};
 //# sourceMappingURL=nested-settings.js.map
-//# debugId=4e50d57b-4502-5ce5-a6dd-0bdc8eba5af4

package/dist/core/config/positional-value.js

@@ -1,110 +1,2 @@
-/**
- * Pure routing helper for the optional positional `value` argument of `pm config set`.
- *
- * `pm config set <key> <value>` is the intuitive form agents reach for, but config
- * VALUES are actually carried by typed flags (`--format`, `--policy`, `--criterion`).
- * This module maps a config key (kebab or snake form, canonical or alias) plus a raw
- * positional value onto the typed flag it should populate, applying enabled/disabled
- * synonyms (off/on/true/false) for boolean-style policy keys. The existing per-key
- * validators in config.ts still run on the routed value, so bad values keep their
- * good error messages.
- */
-
-!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]="77fa2822-1681-59d5-8388-037cf13c45dd")}catch(e){}}();
-const FORMAT_KEYS = new Set(["item_format"]);
-const CRITERIA_KEYS = new Set([
-    "definition_of_done",
-    "metadata_required_fields",
-    "lifecycle_stale_blocker_reason_patterns",
-    "lifecycle_closure_like_blocked_reason_patterns",
-    "lifecycle_closure_like_resolution_patterns",
-    "lifecycle_closure_like_actual_result_patterns",
-]);
-const POLICY_KEYS = new Set([
-    "history_missing_stream_policy",
-    "sprint_release_format_policy",
-    "parent_reference_policy",
-    "metadata_validation_profile",
-    "governance_preset",
-    "governance_ownership_enforcement",
-    "governance_create_mode_default",
-    "governance_close_validation_default",
-    "governance_require_close_reason",
-    "governance_create_default_type",
-    "governance_workflow_enforcement",
-    "governance_parent_reference_policy",
-    "governance_metadata_validation_profile",
-    "governance_force_required_for_stale_lock",
-    "test_result_tracking",
-    "untrusted_linked_test_execution",
-    "telemetry_tracking",
-    "agent_identity_vocabulary",
-]);
-/** Policy keys whose only valid values are enabled/disabled. For these we accept the intuitive synonyms off/on/true/false. Other policy keys pass through unchanged so their own validators report the precise allowed set. */
-const ENABLED_DISABLED_POLICY_KEYS = new Set([
-    "governance_require_close_reason",
-    "governance_force_required_for_stale_lock",
-    "test_result_tracking",
-    "untrusted_linked_test_execution",
-    "telemetry_tracking",
-]);
-const ENABLED_DISABLED_SYNONYMS = {
-    off: "disabled",
-    on: "enabled",
-    true: "enabled",
-    false: "disabled",
-    enabled: "enabled",
-    disabled: "disabled",
-};
-/** Normalize any kebab/snake key form to the canonical snake key (or undefined). */
-function toCanonicalKey(keyOrAlias) {
-    const normalized = keyOrAlias.trim().toLowerCase().replaceAll("-", "_");
-    if (FORMAT_KEYS.has(normalized) ||
-        CRITERIA_KEYS.has(normalized) ||
-        POLICY_KEYS.has(normalized) ||
-        normalized === "context") {
-        return normalized;
-    }
-    return undefined;
-}
-/** Map an enabled/disabled-style value through its synonyms (case-insensitive). Values that are not synonyms pass through unchanged so the downstream validator can reject them with its own message. */
-function normalizeEnabledDisabled(value) {
-    const normalized = value.trim().toLowerCase();
-    return ENABLED_DISABLED_SYNONYMS[normalized] ?? value;
-}
-/**
- * Resolve which typed flag a positional `pm config set <key> <value>` value should
- * populate, plus the normalized value.
- *
- * Returns `{ routable: false, reason }` for keys that require multiple/structured
- * flags (e.g. `context`). Unknown keys also return `routable: false` so the caller
- * can fall back to the existing invalid-key path.
- */
-export function resolveConfigPositionalValue(canonicalKeyOrAlias, value) {
-    const key = toCanonicalKey(canonicalKeyOrAlias);
-    if (key === undefined) {
-        return {
-            routable: false,
-            reason: `Unknown config key "${canonicalKeyOrAlias}" cannot route a positional value.`,
-        };
-    }
-    if (key === "context") {
-        return {
-            routable: false,
-            reason: "Config set context does not accept a positional value. Use --default-depth, --activity-limit, --stale-threshold-days, or --section-<name> flags.",
-        };
-    }
-    if (FORMAT_KEYS.has(key)) {
-        return { routable: true, flag: "format", value };
-    }
-    if (CRITERIA_KEYS.has(key)) {
-        return { routable: true, flag: "criterion", values: [value] };
-    }
-    // policy key
-    const policyValue = ENABLED_DISABLED_POLICY_KEYS.has(key)
-        ? normalizeEnabledDisabled(value)
-        : value;
-    return { routable: true, flag: "policy", value: policyValue };
-}
+!(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]="d0f97e1d-37de-5512-806c-833ec249ff52")}catch(e2){}})();const FORMAT_KEYS=new Set(["item_format"]);const CRITERIA_KEYS=new Set(["definition_of_done","metadata_required_fields","lifecycle_stale_blocker_reason_patterns","lifecycle_closure_like_blocked_reason_patterns","lifecycle_closure_like_resolution_patterns","lifecycle_closure_like_actual_result_patterns"]);const POLICY_KEYS=new Set(["history_missing_stream_policy","sprint_release_format_policy","parent_reference_policy","metadata_validation_profile","governance_preset","governance_ownership_enforcement","governance_create_mode_default","governance_close_validation_default","governance_require_close_reason","governance_create_default_type","governance_workflow_enforcement","governance_parent_reference_policy","governance_metadata_validation_profile","governance_force_required_for_stale_lock","test_result_tracking","untrusted_linked_test_execution","telemetry_tracking","agent_identity_vocabulary"]);const ENABLED_DISABLED_POLICY_KEYS=new Set(["governance_require_close_reason","governance_force_required_for_stale_lock","test_result_tracking","untrusted_linked_test_execution","telemetry_tracking"]);const ENABLED_DISABLED_SYNONYMS={off:"disabled",on:"enabled",true:"enabled",false:"disabled",enabled:"enabled",disabled:"disabled"};function toCanonicalKey(keyOrAlias){const normalized=keyOrAlias.trim().toLowerCase().replaceAll("-","_");if(FORMAT_KEYS.has(normalized)||CRITERIA_KEYS.has(normalized)||POLICY_KEYS.has(normalized)||normalized==="context"){return normalized}return void 0}function normalizeEnabledDisabled(value){const normalized=value.trim().toLowerCase();return ENABLED_DISABLED_SYNONYMS[normalized]??value}function resolveConfigPositionalValue(canonicalKeyOrAlias,value){const key=toCanonicalKey(canonicalKeyOrAlias);if(key===void 0){return{routable:false,reason:`Unknown config key "${canonicalKeyOrAlias}" cannot route a positional value.`}}if(key==="context"){return{routable:false,reason:"Config set context does not accept a positional value. Use --default-depth, --activity-limit, --stale-threshold-days, or --section-<name> flags."}}if(FORMAT_KEYS.has(key)){return{routable:true,flag:"format",value}}if(CRITERIA_KEYS.has(key)){return{routable:true,flag:"criterion",values:[value]}}const policyValue=ENABLED_DISABLED_POLICY_KEYS.has(key)?normalizeEnabledDisabled(value):value;return{routable:true,flag:"policy",value:policyValue}}export{resolveConfigPositionalValue};
 //# sourceMappingURL=positional-value.js.map
-//# debugId=77fa2822-1681-59d5-8388-037cf13c45dd