@unbrained/pm-cli 2026.5.24 → 2026.5.28

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

@@ -61,5 +61,5 @@ export interface ConfigResult {
     changed: boolean;
     warnings?: string[];
 }
-export declare function runConfig(scopeValue: string, actionValue: string, keyValue: string | undefined, options: ConfigCommandOptions, global: GlobalOptions): Promise<ConfigResult>;
+export declare function runConfig(scopeValue: string, actionValue: string, keyValue: string | undefined, options: ConfigCommandOptions, global: GlobalOptions, valueValue?: string): Promise<ConfigResult>;
 export {};

package/dist/cli/commands/config.js

@@ -1,6 +1,7 @@
 
-!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]="290ca243-a9ef-50d1-852e-28ac75561c57")}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]="5de8e394-f1b2-56ce-9de4-d33ee76eaaa9")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
+import { resolveConfigPositionalValue } from "../../core/config/positional-value.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";
@@ -99,6 +100,10 @@ const CONFIG_KEY_ALIASES = {
     telemetry_tracking: ["telemetry-tracking", "telemetry_tracking"],
     context: ["context"],
 };
+// Canonical kebab-case forms (first alias entry per key). Used for the invalid-key
+// hint so agents see ~21 keys instead of all ~45 kebab+snake variants; snake_case
+// forms stay fully accepted as input via CONFIG_KEY_VALUES/normalizeKey.
+const CANONICAL_CONFIG_KEYS = Object.keys(CONFIG_KEY_ALIASES).map((candidate) => CONFIG_KEY_ALIASES[candidate][0]);
 const CONFIG_KEY_SUMMARIES = {
     definition_of_done: "Definition of Done criteria list.",
     item_format: "Default item file format.",
@@ -213,7 +218,7 @@ function normalizeKey(value) {
         }
         return "definition_of_done";
     }
-    throw new PmCliError(`Invalid config key "${value}". Supported: ${CONFIG_KEY_VALUES.join(", ")}`, EXIT_CODE.USAGE);
+    throw new PmCliError(`Invalid config key "${value}". Supported: ${CANONICAL_CONFIG_KEYS.join(", ")} (underscore variants also accepted)`, 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));
@@ -304,6 +309,36 @@ function normalizeGovernanceForceRequiredForStaleLockPolicy(value) {
     }
     throw new PmCliError("Config set governance-force-required-for-stale-lock requires --policy with one of: enabled, disabled", EXIT_CODE.USAGE);
 }
+function normalizePolicyForConflict(key, value) {
+    switch (key) {
+        case "history_missing_stream_policy":
+            return normalizeHistoryMissingStreamPolicy(value);
+        case "sprint_release_format_policy":
+            return normalizeSprintReleaseFormatPolicy(value);
+        case "parent_reference_policy":
+        case "governance_parent_reference_policy":
+            return normalizeParentReferencePolicy(value);
+        case "metadata_validation_profile":
+        case "governance_metadata_validation_profile":
+            return normalizeValidateMetadataProfile(value);
+        case "governance_preset":
+            return normalizeGovernancePreset(value);
+        case "governance_ownership_enforcement":
+            return normalizeGovernanceOwnershipEnforcement(value);
+        case "governance_create_mode_default":
+            return normalizeGovernanceCreateModeDefault(value);
+        case "governance_close_validation_default":
+            return normalizeGovernanceCloseValidationDefault(value);
+        case "governance_force_required_for_stale_lock":
+            return normalizeGovernanceForceRequiredForStaleLockPolicy(value);
+        case "test_result_tracking":
+            return normalizeTestResultTrackingPolicy(value);
+        case "telemetry_tracking":
+            return normalizeTelemetryTrackingPolicy(value);
+        default:
+            return value.trim().toLowerCase().replaceAll("-", "_");
+    }
+}
 const METADATA_REQUIRED_FIELD_ALIAS_MAP = {
     author: "author",
     acceptance_criteria: "acceptance_criteria",
@@ -542,10 +577,53 @@ async function applyContextConfig(settings, options, target, scope, warnings) {
         changed,
     }, warnings);
 }
-export async function runConfig(scopeValue, actionValue, keyValue, options, global) {
+/**
+ * Route an intuitive `pm config set <key> <value>` positional value onto the typed
+ * flag it belongs to (--format/--policy/--criterion), applying enabled/disabled
+ * synonyms. Returns the (possibly augmented) options. The typed-flag forms keep
+ * 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) {
+    if (valueValue === undefined) {
+        return options;
+    }
+    if (action !== "set") {
+        throw new PmCliError(`Config action "${action}" does not accept a positional value. Only "set" takes <value>.`, EXIT_CODE.USAGE);
+    }
+    if (typeof keyValue !== "string" || keyValue.trim().length === 0) {
+        throw new PmCliError('Config action "set" requires <key> before a positional <value>.', EXIT_CODE.USAGE);
+    }
+    const routed = resolveConfigPositionalValue(normalizedKey ?? keyValue, valueValue);
+    if (!routed.routable) {
+        throw new PmCliError(routed.reason, EXIT_CODE.USAGE);
+    }
+    if (routed.flag === "criterion") {
+        if (options.criterion !== undefined && options.criterion.length > 0) {
+            throw new PmCliError(`Config set ${keyValue} received both positional value "${valueValue}" and --criterion. Pass criteria via --criterion only when supplying more than one value.`, EXIT_CODE.USAGE);
+        }
+        return { ...options, criterion: routed.values };
+    }
+    if (routed.flag === "format") {
+        if (options.format !== undefined &&
+            normalizeItemFormat(options.format) !== normalizeItemFormat(routed.value)) {
+            throw new PmCliError(`Config set ${keyValue} received both positional value "${valueValue}" and --format "${options.format}". Pass only one.`, EXIT_CODE.USAGE);
+        }
+        return { ...options, format: routed.value };
+    }
+    // policy flag (--policy)
+    if (options.policy !== undefined &&
+        normalizePolicyForConflict(normalizedKey, options.policy) !==
+            normalizePolicyForConflict(normalizedKey, routed.value)) {
+        throw new PmCliError(`Config set ${keyValue} received both positional value "${valueValue}" and --policy "${options.policy}". Pass only one.`, EXIT_CODE.USAGE);
+    }
+    return { ...options, policy: routed.value };
+}
+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);
     const target = await resolveSettingsTarget(scope, global);
     const { settings, metadata, warnings: settingsReadWarnings } = await readSettingsWithMetadata(target.pmRoot);
     const warnings = normalizeWarnings(settingsReadWarnings);
@@ -1146,4 +1224,4 @@ export async function runConfig(scopeValue, actionValue, keyValue, options, glob
     }, warnings);
 }
 //# sourceMappingURL=config.js.map
-//# debugId=290ca243-a9ef-50d1-852e-28ac75561c57
+//# debugId=5de8e394-f1b2-56ce-9de4-d33ee76eaaa9