@unbrained/pm-cli 2026.6.5 → 2026.6.7

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

@@ -3,12 +3,13 @@ import type { GlobalOptions } from "../../core/shared/command-types.js";
 import type { GovernanceCloseValidationDefault, GovernanceCreateModeDefault, GovernanceOwnershipEnforcement, GovernancePreset, GovernanceWorkflowEnforcement, ItemFormat, ParentReferencePolicy, SprintReleaseFormatPolicy, ValidateMetadataProfile } from "../../types/index.js";
 declare const CONFIG_SCOPE_VALUES: readonly ["project", "global"];
 type ConfigScope = (typeof CONFIG_SCOPE_VALUES)[number];
-type ConfigKey = "definition_of_done" | "item_format" | "history_missing_stream_policy" | "sprint_release_format_policy" | "parent_reference_policy" | "metadata_validation_profile" | "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" | "governance_preset" | "governance_ownership_enforcement" | "governance_create_mode_default" | "governance_close_validation_default" | "governance_create_default_type" | "governance_workflow_enforcement" | "governance_parent_reference_policy" | "governance_metadata_validation_profile" | "governance_force_required_for_stale_lock" | "test_result_tracking" | "telemetry_tracking" | "context";
+type ConfigKey = "definition_of_done" | "item_format" | "history_missing_stream_policy" | "sprint_release_format_policy" | "parent_reference_policy" | "metadata_validation_profile" | "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" | "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" | "telemetry_tracking" | "context";
 type HistoryMissingStreamPolicy = "auto_create" | "strict_error";
 type TestResultTrackingPolicy = "enabled" | "disabled";
 type TelemetryTrackingPolicy = "enabled" | "disabled";
 type GovernanceForceRequiredForStaleLockPolicy = "enabled" | "disabled";
-type ConfigValue = string | string[] | ItemFormat | HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | ContextConfigValue;
+type GovernanceRequireCloseReasonPolicy = "enabled" | "disabled";
+type ConfigValue = string | string[] | ItemFormat | HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | ContextConfigValue;
 interface ContextConfigValue {
     default_depth: string;
     activity_limit: number;
@@ -45,14 +46,14 @@ export interface NestedSettingResultValue {
     key: string;
     path: string;
     kind: NestedSettingDescriptor["kind"];
-    value: string | number | null;
+    value: string | number | boolean | null;
 }
 export interface ConfigResult {
     scope: ConfigScope;
     key?: ConfigKey | string;
     criteria?: string[];
     format?: ItemFormat;
-    policy?: HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | string;
+    policy?: HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | string;
     nested_setting?: NestedSettingResultValue;
     nested_settings?: NestedSettingResultValue[];
     keys?: ConfigKeyDescriptor[];

package/dist/cli/commands/config.js

@@ -1,5 +1,5 @@
 
-!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]="597be62b-f4c6-5dfe-8f00-62b9ab38f374")}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]="0a6df339-140f-5018-96e1-782e613aae14")}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";
@@ -46,6 +46,8 @@ const CONFIG_KEY_VALUES = [
     "governance_create_mode_default",
     "governance-close-validation-default",
     "governance_close_validation_default",
+    "governance-require-close-reason",
+    "governance_require_close_reason",
     "governance-create-default-type",
     "governance_create_default_type",
     "governance-workflow-enforcement",
@@ -93,6 +95,10 @@ const CONFIG_KEY_ALIASES = {
         "governance-close-validation-default",
         "governance_close_validation_default",
     ],
+    governance_require_close_reason: [
+        "governance-require-close-reason",
+        "governance_require_close_reason",
+    ],
     governance_create_default_type: ["governance-create-default-type", "governance_create_default_type"],
     governance_workflow_enforcement: ["governance-workflow-enforcement", "governance_workflow_enforcement"],
     governance_parent_reference_policy: ["governance-parent-reference-policy", "governance_parent_reference_policy"],
@@ -128,6 +134,7 @@ const CONFIG_KEY_SUMMARIES = {
     governance_ownership_enforcement: "Governance ownership enforcement policy (none|warn|strict).",
     governance_create_mode_default: "Governance default create mode (progressive|strict).",
     governance_close_validation_default: "Governance default close validation mode (off|warn|strict).",
+    governance_require_close_reason: "Governance close-reason requirement policy (enabled|disabled).",
     governance_create_default_type: "Governance default item type for `pm create` when --type is omitted.",
     governance_workflow_enforcement: "Governance per-type transition enforcement mode (off|warn|strict).",
     governance_parent_reference_policy: "Governance parent reference policy (warn|strict_error).",
@@ -206,6 +213,9 @@ function normalizeKey(value) {
         if (value === "governance-close-validation-default" || value === "governance_close_validation_default") {
             return "governance_close_validation_default";
         }
+        if (value === "governance-require-close-reason" || value === "governance_require_close_reason") {
+            return "governance_require_close_reason";
+        }
         if (value === "governance-create-default-type" || value === "governance_create_default_type") {
             return "governance_create_default_type";
         }
@@ -336,6 +346,13 @@ 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 normalizeGovernanceRequireCloseReasonPolicy(value) {
+    const normalized = value?.trim().toLowerCase().replaceAll("-", "_");
+    if (normalized === "enabled" || normalized === "disabled") {
+        return normalized;
+    }
+    throw new PmCliError("Config set governance-require-close-reason requires --policy with one of: enabled, disabled", EXIT_CODE.USAGE);
+}
 function normalizePolicyForConflict(key, value) {
     switch (key) {
         case "history_missing_stream_policy":
@@ -356,6 +373,8 @@ function normalizePolicyForConflict(key, value) {
             return normalizeGovernanceCreateModeDefault(value);
         case "governance_close_validation_default":
             return normalizeGovernanceCloseValidationDefault(value);
+        case "governance_require_close_reason":
+            return normalizeGovernanceRequireCloseReasonPolicy(value);
         case "governance_workflow_enforcement":
             return normalizeGovernanceWorkflowEnforcement(value);
         case "governance_force_required_for_stale_lock":
@@ -484,6 +503,9 @@ function readConfigValue(settings, key) {
     if (key === "governance_close_validation_default") {
         return settings.governance.close_validation_default;
     }
+    if (key === "governance_require_close_reason") {
+        return settings.governance.require_close_reason ? "enabled" : "disabled";
+    }
     if (key === "governance_create_default_type") {
         return settings.governance.create_default_type ?? "";
     }
@@ -760,6 +782,7 @@ export async function runConfig(scopeValue, actionValue, keyValue, options, glob
             governance_ownership_enforcement: readConfigValue(settings, "governance_ownership_enforcement"),
             governance_create_mode_default: readConfigValue(settings, "governance_create_mode_default"),
             governance_close_validation_default: readConfigValue(settings, "governance_close_validation_default"),
+            governance_require_close_reason: readConfigValue(settings, "governance_require_close_reason"),
             governance_create_default_type: readConfigValue(settings, "governance_create_default_type"),
             governance_workflow_enforcement: readConfigValue(settings, "governance_workflow_enforcement"),
             governance_parent_reference_policy: readConfigValue(settings, "governance_parent_reference_policy"),
@@ -907,6 +930,15 @@ export async function runConfig(scopeValue, actionValue, keyValue, options, glob
                 changed: false,
             }, warnings);
         }
+        if (key === "governance_require_close_reason") {
+            return withWarnings({
+                scope,
+                key,
+                policy: settings.governance.require_close_reason ? "enabled" : "disabled",
+                settings_path: target.settingsPath,
+                changed: false,
+            }, warnings);
+        }
         if (key === "governance_create_default_type") {
             return withWarnings({
                 scope,
@@ -1236,6 +1268,22 @@ export async function runConfig(scopeValue, actionValue, keyValue, options, glob
             changed,
         }, warnings);
     }
+    if (key === "governance_require_close_reason") {
+        const nextPolicy = normalizeGovernanceRequireCloseReasonPolicy(options.policy);
+        const nextEnabled = nextPolicy === "enabled";
+        const changed = settings.governance.require_close_reason !== nextEnabled;
+        settings.governance.require_close_reason = nextEnabled;
+        if (changed) {
+            await writeSettings(target.pmRoot, settings, "config:set:governance_require_close_reason");
+        }
+        return withWarnings({
+            scope,
+            key,
+            policy: settings.governance.require_close_reason ? "enabled" : "disabled",
+            settings_path: target.settingsPath,
+            changed,
+        }, warnings);
+    }
     if (key === "governance_create_default_type") {
         const policyProvided = typeof options.policy === "string";
         const rawType = policyProvided ? options.policy.trim() : "";
@@ -1398,4 +1446,4 @@ export async function runConfig(scopeValue, actionValue, keyValue, options, glob
     }, warnings);
 }
 //# sourceMappingURL=config.js.map
-//# debugId=597be62b-f4c6-5dfe-8f00-62b9ab38f374
+//# debugId=0a6df339-140f-5018-96e1-782e613aae14