@unbrained/pm-cli 2026.5.28 → 2026.5.29

package/dist/cli/commands/config.d.ts

@@ -1,3 +1,4 @@
+import { type NestedSettingDescriptor } from "../../core/config/nested-settings.js";
 import type { GlobalOptions } from "../../core/shared/command-types.js";
 import type { GovernanceCloseValidationDefault, GovernanceCreateModeDefault, GovernanceOwnershipEnforcement, GovernancePreset, ItemFormat, ParentReferencePolicy, SprintReleaseFormatPolicy, ValidateMetadataProfile } from "../../types/index.js";
 declare const CONFIG_SCOPE_VALUES: readonly ["project", "global"];
@@ -26,6 +27,7 @@ export interface ConfigCommandOptions {
     criterion?: string[];
     format?: string;
     policy?: string;
+    value?: string;
     clearCriteria?: boolean;
     defaultDepth?: string;
     activityLimit?: string;
@@ -39,12 +41,20 @@ export interface ConfigCommandOptions {
     sectionStaleness?: string;
     sectionTests?: string;
 }
+export interface NestedSettingResultValue {
+    key: string;
+    path: string;
+    kind: NestedSettingDescriptor["kind"];
+    value: string | number | null;
+}
 export interface ConfigResult {
     scope: ConfigScope;
-    key?: ConfigKey;
+    key?: ConfigKey | string;
     criteria?: string[];
     format?: ItemFormat;
     policy?: HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy;
+    nested_setting?: NestedSettingResultValue;
+    nested_settings?: NestedSettingResultValue[];
     keys?: ConfigKeyDescriptor[];
     values?: Record<ConfigKey, ConfigValue>;
     count?: number;

package/dist/cli/commands/config.js

@@ -1,7 +1,8 @@
 
-!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]="5de8e394-f1b2-56ce-9de4-d33ee76eaaa9")}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]="d29673f1-c80f-54ca-a854-6e9abd634001")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { resolveConfigPositionalValue } from "../../core/config/positional-value.js";
+import { NESTED_SETTING_DESCRIPTORS, parseNestedSettingValue, readNestedSettingValue, resolveNestedSettingDescriptor, writeNestedSettingValue, } from "../../core/config/nested-settings.js";
 import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
 import { normalizeParentReferencePolicy } from "../../core/item/parent-reference-policy.js";
 import { normalizeSprintReleaseFormatPolicy } from "../../core/item/sprint-release-format.js";
@@ -218,7 +219,8 @@ function normalizeKey(value) {
         }
         return "definition_of_done";
     }
-    throw new PmCliError(`Invalid config key "${value}". Supported: ${CANONICAL_CONFIG_KEYS.join(", ")} (underscore variants also accepted)`, EXIT_CODE.USAGE);
+    const nestedKeys = NESTED_SETTING_DESCRIPTORS.map((descriptor) => descriptor.key).join(", ");
+    throw new PmCliError(`Invalid config key "${value}". Supported: ${CANONICAL_CONFIG_KEYS.join(", ")} (underscore variants also accepted). Nested leaf settings: ${nestedKeys}.`, EXIT_CODE.USAGE);
 }
 function normalizeCriteria(values, clearCriteria) {
     const normalized = [...new Set((values ?? []).map((value) => value.trim()).filter((value) => value.length > 0))].sort((left, right) => left.localeCompare(right));
@@ -584,7 +586,7 @@ async function applyContextConfig(settings, options, target, scope, warnings) {
  * working exactly as before: a positional value is only injected when its flag was
  * not already supplied, and a conflicting explicit flag is a clear error.
  */
-function applyPositionalValue(action, keyValue, normalizedKey, valueValue, options) {
+function applyPositionalValue(action, keyValue, normalizedKey, nestedSetting, valueValue, options) {
     if (valueValue === undefined) {
         return options;
     }
@@ -594,6 +596,13 @@ function applyPositionalValue(action, keyValue, normalizedKey, valueValue, optio
     if (typeof keyValue !== "string" || keyValue.trim().length === 0) {
         throw new PmCliError('Config action "set" requires <key> before a positional <value>.', EXIT_CODE.USAGE);
     }
+    if (nestedSetting) {
+        if (options.value !== undefined && valueValue !== undefined && options.value !== valueValue) {
+            throw new PmCliError(`Config set ${keyValue} received both positional value "${valueValue}" and --value "${options.value}". Pass only one.`, EXIT_CODE.USAGE);
+        }
+        // Pick whichever was supplied; do not overwrite a present --value with undefined.
+        return { ...options, value: valueValue ?? options.value };
+    }
     const routed = resolveConfigPositionalValue(normalizedKey ?? keyValue, valueValue);
     if (!routed.routable) {
         throw new PmCliError(routed.reason, EXIT_CODE.USAGE);
@@ -622,11 +631,57 @@ function applyPositionalValue(action, keyValue, normalizedKey, valueValue, optio
 export async function runConfig(scopeValue, actionValue, keyValue, options, global, valueValue) {
     const scope = normalizeScope(scopeValue);
     const action = normalizeAction(actionValue);
-    const key = normalizeKeyForAction(action, keyValue);
-    options = applyPositionalValue(action, keyValue, key, valueValue, options);
+    // Nested leaf settings (search/provider/vector-store) are detected before
+    // normalizeKey so they bypass the ConfigKey union without breaking the
+    // existing key-not-found error path for actually-unknown keys.
+    const nestedSetting = (action === "get" || action === "set") ? resolveNestedSettingDescriptor(keyValue) : undefined;
+    const key = nestedSetting ? undefined : normalizeKeyForAction(action, keyValue);
+    options = applyPositionalValue(action, keyValue, key, nestedSetting, valueValue, options);
     const target = await resolveSettingsTarget(scope, global);
     const { settings, metadata, warnings: settingsReadWarnings } = await readSettingsWithMetadata(target.pmRoot);
     const warnings = normalizeWarnings(settingsReadWarnings);
+    if (nestedSetting) {
+        if (action === "get") {
+            const currentValue = readNestedSettingValue(settings, nestedSetting);
+            return withWarnings({
+                scope,
+                key: nestedSetting.key,
+                nested_setting: {
+                    key: nestedSetting.key,
+                    path: nestedSetting.path,
+                    kind: nestedSetting.kind,
+                    value: currentValue,
+                },
+                settings_path: target.settingsPath,
+                changed: false,
+            }, warnings);
+        }
+        // action === "set"
+        const rawValue = options.value;
+        if (typeof rawValue !== "string") {
+            throw new PmCliError(`Config set ${nestedSetting.key} requires a value. Pass it positionally (\`pm config ${scope} set ${nestedSetting.key} <value>\`) or via --value.`, EXIT_CODE.USAGE);
+        }
+        const parsed = parseNestedSettingValue(nestedSetting, rawValue);
+        if (!parsed.ok) {
+            throw new PmCliError(parsed.error.message, EXIT_CODE.USAGE);
+        }
+        const changed = writeNestedSettingValue(settings, nestedSetting, parsed.parsed.value);
+        if (changed) {
+            await writeSettings(target.pmRoot, settings, `config:set:${nestedSetting.path}`);
+        }
+        return withWarnings({
+            scope,
+            key: nestedSetting.key,
+            nested_setting: {
+                key: nestedSetting.key,
+                path: nestedSetting.path,
+                kind: nestedSetting.kind,
+                value: parsed.parsed.value,
+            },
+            settings_path: target.settingsPath,
+            changed,
+        }, warnings);
+    }
     if (action === "list") {
         const keys = Object.keys(CONFIG_KEY_ALIASES).map((candidate) => ({
             key: candidate,
@@ -640,9 +695,16 @@ export async function runConfig(scopeValue, actionValue, keyValue, options, glob
             summary: CONFIG_KEY_SUMMARIES[candidate],
             value: readConfigValue(settings, candidate),
         }));
+        const nestedSettings = NESTED_SETTING_DESCRIPTORS.map((descriptor) => ({
+            key: descriptor.key,
+            path: descriptor.path,
+            kind: descriptor.kind,
+            value: readNestedSettingValue(settings, descriptor),
+        }));
         return withWarnings({
             scope,
             keys,
+            nested_settings: nestedSettings,
             count: keys.length,
             settings_path: target.settingsPath,
             changed: false,
@@ -1224,4 +1286,4 @@ export async function runConfig(scopeValue, actionValue, keyValue, options, glob
     }, warnings);
 }
 //# sourceMappingURL=config.js.map
-//# debugId=5de8e394-f1b2-56ce-9de4-d33ee76eaaa9
+//# debugId=d29673f1-c80f-54ca-a854-6e9abd634001