@unbrained/pm-cli 2026.5.31 → 2026.6.5

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

@@ -1,14 +1,14 @@
 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";
+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_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_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[] | ItemFormat | HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | ContextConfigValue;
+type ConfigValue = string | string[] | ItemFormat | HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | ContextConfigValue;
 interface ContextConfigValue {
     default_depth: string;
     activity_limit: number;
@@ -52,7 +52,7 @@ export interface ConfigResult {
     key?: ConfigKey | string;
     criteria?: string[];
     format?: ItemFormat;
-    policy?: HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy;
+    policy?: HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | string;
     nested_setting?: NestedSettingResultValue;
     nested_settings?: NestedSettingResultValue[];
     keys?: ConfigKeyDescriptor[];

package/dist/cli/commands/config.js

@@ -1,12 +1,13 @@
 
-!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){}}();
+!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){}}();
 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";
-import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
+import { resolveItemTypeRegistry, resolveTypeName } from "../../core/item/type-registry.js";
+import { buildInvalidTypeError } from "../../core/schema/item-types-file.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { migrateItemFilesToFormat } from "../../core/store/item-format-migration.js";
@@ -45,6 +46,10 @@ const CONFIG_KEY_VALUES = [
     "governance_create_mode_default",
     "governance-close-validation-default",
     "governance_close_validation_default",
+    "governance-create-default-type",
+    "governance_create_default_type",
+    "governance-workflow-enforcement",
+    "governance_workflow_enforcement",
     "governance-parent-reference-policy",
     "governance_parent_reference_policy",
     "governance-metadata-validation-profile",
@@ -88,6 +93,8 @@ const CONFIG_KEY_ALIASES = {
         "governance-close-validation-default",
         "governance_close_validation_default",
     ],
+    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"],
     governance_metadata_validation_profile: [
         "governance-metadata-validation-profile",
@@ -121,6 +128,8 @@ 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_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).",
     governance_metadata_validation_profile: "Governance metadata validation profile (core|strict|custom).",
     governance_force_required_for_stale_lock: "Governance stale-lock force policy (enabled|disabled).",
@@ -197,6 +206,12 @@ function normalizeKey(value) {
         if (value === "governance-close-validation-default" || value === "governance_close_validation_default") {
             return "governance_close_validation_default";
         }
+        if (value === "governance-create-default-type" || value === "governance_create_default_type") {
+            return "governance_create_default_type";
+        }
+        if (value === "governance-workflow-enforcement" || value === "governance_workflow_enforcement") {
+            return "governance_workflow_enforcement";
+        }
         if (value === "governance-parent-reference-policy" || value === "governance_parent_reference_policy") {
             return "governance_parent_reference_policy";
         }
@@ -304,6 +319,16 @@ function normalizeGovernanceCloseValidationDefault(value) {
     }
     throw new PmCliError("Config set governance-close-validation-default requires --policy with one of: off, warn, strict", EXIT_CODE.USAGE);
 }
+function normalizeGovernanceWorkflowEnforcement(value) {
+    const normalized = typeof value === "string" ? value.trim().toLowerCase().replaceAll("-", "_") : undefined;
+    if (normalized === "off" || normalized === "warn" || normalized === "strict") {
+        return normalized;
+    }
+    if (normalized === "none" || normalized === "disabled") {
+        return "off";
+    }
+    throw new PmCliError("Config set governance-workflow-enforcement requires one of: off, warn, strict", EXIT_CODE.USAGE);
+}
 function normalizeGovernanceForceRequiredForStaleLockPolicy(value) {
     const normalized = value?.trim().toLowerCase().replaceAll("-", "_");
     if (normalized === "enabled" || normalized === "disabled") {
@@ -331,6 +356,8 @@ function normalizePolicyForConflict(key, value) {
             return normalizeGovernanceCreateModeDefault(value);
         case "governance_close_validation_default":
             return normalizeGovernanceCloseValidationDefault(value);
+        case "governance_workflow_enforcement":
+            return normalizeGovernanceWorkflowEnforcement(value);
         case "governance_force_required_for_stale_lock":
             return normalizeGovernanceForceRequiredForStaleLockPolicy(value);
         case "test_result_tracking":
@@ -457,6 +484,12 @@ function readConfigValue(settings, key) {
     if (key === "governance_close_validation_default") {
         return settings.governance.close_validation_default;
     }
+    if (key === "governance_create_default_type") {
+        return settings.governance.create_default_type ?? "";
+    }
+    if (key === "governance_workflow_enforcement") {
+        return settings.governance.workflow_enforcement ?? "off";
+    }
     if (key === "governance_parent_reference_policy") {
         return settings.governance.parent_reference;
     }
@@ -727,6 +760,8 @@ 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_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"),
             governance_metadata_validation_profile: readConfigValue(settings, "governance_metadata_validation_profile"),
             governance_force_required_for_stale_lock: readConfigValue(settings, "governance_force_required_for_stale_lock"),
@@ -872,6 +907,24 @@ export async function runConfig(scopeValue, actionValue, keyValue, options, glob
                 changed: false,
             }, warnings);
         }
+        if (key === "governance_create_default_type") {
+            return withWarnings({
+                scope,
+                key,
+                policy: settings.governance.create_default_type ?? "",
+                settings_path: target.settingsPath,
+                changed: false,
+            }, warnings);
+        }
+        if (key === "governance_workflow_enforcement") {
+            return withWarnings({
+                scope,
+                key,
+                policy: settings.governance.workflow_enforcement ?? "off",
+                settings_path: target.settingsPath,
+                changed: false,
+            }, warnings);
+        }
         if (key === "governance_parent_reference_policy") {
             return withWarnings({
                 scope,
@@ -1183,6 +1236,65 @@ export async function runConfig(scopeValue, actionValue, keyValue, options, glob
             changed,
         }, warnings);
     }
+    if (key === "governance_create_default_type") {
+        const policyProvided = typeof options.policy === "string";
+        const rawType = policyProvided ? options.policy.trim() : "";
+        // An explicit empty value clears the setting back to "unset" (matching how
+        // get/export expose unset as ""). Without this clear path there is no CLI
+        // route back from a set value to the governance default.
+        if (policyProvided && rawType.length === 0) {
+            const changed = settings.governance.create_default_type !== undefined;
+            delete settings.governance.create_default_type;
+            if (changed) {
+                await writeSettings(target.pmRoot, settings, "config:set:governance_create_default_type");
+            }
+            return withWarnings({
+                scope,
+                key,
+                policy: settings.governance.create_default_type ?? "",
+                settings_path: target.settingsPath,
+                changed,
+            }, warnings);
+        }
+        if (rawType.length === 0) {
+            throw new PmCliError('Config set governance-create-default-type requires an item type value (or an empty value "" to clear it)', EXIT_CODE.USAGE);
+        }
+        // create_default_type is preset-orthogonal: it tunes `pm create` and is
+        // carried through writes regardless of preset, so we do NOT force preset=custom.
+        const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+        const resolvedType = resolveTypeName(rawType, typeRegistry);
+        if (!resolvedType) {
+            throw new PmCliError(buildInvalidTypeError(rawType, typeRegistry.types), EXIT_CODE.USAGE);
+        }
+        const changed = settings.governance.create_default_type !== resolvedType;
+        settings.governance.create_default_type = resolvedType;
+        if (changed) {
+            await writeSettings(target.pmRoot, settings, "config:set:governance_create_default_type");
+        }
+        return withWarnings({
+            scope,
+            key,
+            policy: settings.governance.create_default_type,
+            settings_path: target.settingsPath,
+            changed,
+        }, warnings);
+    }
+    if (key === "governance_workflow_enforcement") {
+        const nextPolicy = normalizeGovernanceWorkflowEnforcement(options.policy);
+        // workflow_enforcement is preset-orthogonal (see create_default_type above).
+        const changed = (settings.governance.workflow_enforcement ?? "off") !== nextPolicy;
+        settings.governance.workflow_enforcement = nextPolicy;
+        if (changed) {
+            await writeSettings(target.pmRoot, settings, "config:set:governance_workflow_enforcement");
+        }
+        return withWarnings({
+            scope,
+            key,
+            policy: settings.governance.workflow_enforcement,
+            settings_path: target.settingsPath,
+            changed,
+        }, warnings);
+    }
     if (key === "governance_parent_reference_policy") {
         const nextPolicy = normalizeParentReferencePolicy(options.policy);
         const changed = settings.governance.preset !== "custom" || settings.governance.parent_reference !== nextPolicy;
@@ -1286,4 +1398,4 @@ export async function runConfig(scopeValue, actionValue, keyValue, options, glob
     }, warnings);
 }
 //# sourceMappingURL=config.js.map
-//# debugId=d29673f1-c80f-54ca-a854-6e9abd634001
+//# debugId=597be62b-f4c6-5dfe-8f00-62b9ab38f374