@unbrained/pm-cli 2026.6.24 → 2026.7.1

package/dist/cli/registration-helpers.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]="efcb3148-9ad3-54e1-a3d4-b5c04c7cdfc7")}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]="002ca6d8-67bc-59d2-88d2-006f43de8e55")}catch(e){}}();
 import { pathExists } from "../core/fs/fs-utils.js";
 import { refreshSearchArtifactsForMutation } from "../core/search/cache.js";
 import { shouldRunSearchRefreshInForeground } from "../core/search/background-refresh.js";
@@ -9,7 +9,7 @@ import { printError, printResult, writeStdout } from "../core/output/output.js";
 import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
 import { setActiveCommandResult, } from "../core/extensions/index.js";
-import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, readFirstValueFromCommanderOptions, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "../sdk/cli-contracts.js";
+import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, NEXT_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, readFirstValueFromCommanderOptions, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "../sdk/cli-contracts.js";
 export { printError, printResult, writeStdout, };
 const RESOLVED_GLOBAL_OPTIONS = Symbol("pm.resolvedGlobalOptions");
 function commandOptionsReader(command) {
@@ -131,6 +131,26 @@ function pushRepeatableValueFlag(args, flag, values) {
         args.push(flag, trimmed);
     }
 }
+function optionTrue(options, key) {
+    return options[key] === true ? true : undefined;
+}
+function optionFalse(options, key) {
+    return options[key] === false ? true : undefined;
+}
+function anyOptionTrue(options, keys) {
+    return keys.some((key) => options[key] === true) ? true : undefined;
+}
+function copyUnknownOptions(target, source) {
+    for (const [key, value] of Object.entries(source)) {
+        if (key === "__proto__" || key === "constructor" || key === "prototype") {
+            continue;
+        }
+        if (Object.hasOwn(target, key)) {
+            continue;
+        }
+        target[key] = value;
+    }
+}
 /**
  * Implements build background test command args for the public runtime surface of this module.
  */
@@ -225,7 +245,7 @@ export function normalizeCreateOptions(commandOptions, options = {}) {
         message: readCreateString("message"),
         assignee: readCreateString("assignee"),
         parent: readCreateString("parent"),
-        allowMissingParent: commandOptions.allowMissingParent === true,
+        allowMissingParent: optionTrue(commandOptions, "allowMissingParent") === true,
         reviewer: readCreateString("reviewer"),
         risk: readCreateString("risk"),
         confidence: readCreateString("confidence"),
@@ -258,23 +278,18 @@ export function normalizeCreateOptions(commandOptions, options = {}) {
         typeOption: readCreateList("typeOption"),
         field: readCreateList("field"),
         unset: readCreateList("unset"),
-        clearDeps: commandOptions.clearDeps === true ? true : undefined,
-        clearComments: commandOptions.clearComments === true ? true : undefined,
-        clearNotes: commandOptions.clearNotes === true ? true : undefined,
-        clearLearnings: commandOptions.clearLearnings === true ? true : undefined,
-        clearFiles: commandOptions.clearFiles === true ? true : undefined,
-        clearTests: commandOptions.clearTests === true ? true : undefined,
-        clearDocs: commandOptions.clearDocs === true ? true : undefined,
-        clearReminders: commandOptions.clearReminders === true ? true : undefined,
-        clearEvents: commandOptions.clearEvents === true ? true : undefined,
-        clearTypeOptions: commandOptions.clearTypeOptions === true ? true : undefined,
+        clearDeps: optionTrue(commandOptions, "clearDeps"),
+        clearComments: optionTrue(commandOptions, "clearComments"),
+        clearNotes: optionTrue(commandOptions, "clearNotes"),
+        clearLearnings: optionTrue(commandOptions, "clearLearnings"),
+        clearFiles: optionTrue(commandOptions, "clearFiles"),
+        clearTests: optionTrue(commandOptions, "clearTests"),
+        clearDocs: optionTrue(commandOptions, "clearDocs"),
+        clearReminders: optionTrue(commandOptions, "clearReminders"),
+        clearEvents: optionTrue(commandOptions, "clearEvents"),
+        clearTypeOptions: optionTrue(commandOptions, "clearTypeOptions"),
     };
-    for (const [key, value] of Object.entries(commandOptions)) {
-        if (Object.hasOwn(normalized, key)) {
-            continue;
-        }
-        normalized[key] = value;
-    }
+    copyUnknownOptions(normalized, commandOptions);
     return normalized;
 }
 /**
@@ -309,8 +324,8 @@ export function normalizeUpdateOptions(commandOptions) {
         author: readUpdateString("author"),
         message: readUpdateString("message"),
         force: Boolean(commandOptions.force),
-        allowAuditUpdate: commandOptions.allowAuditUpdate === true || commandOptions.allow_audit_update === true ? true : undefined,
-        allowAuditDepUpdate: commandOptions.allowAuditDepUpdate === true || commandOptions.allow_audit_dep_update === true ? true : undefined,
+        allowAuditUpdate: anyOptionTrue(commandOptions, ["allowAuditUpdate", "allow_audit_update"]),
+        allowAuditDepUpdate: anyOptionTrue(commandOptions, ["allowAuditDepUpdate", "allow_audit_dep_update"]),
         assignee: readUpdateString("assignee"),
         parent: readUpdateString("parent"),
         reviewer: readUpdateString("reviewer"),
@@ -335,8 +350,8 @@ export function normalizeUpdateOptions(commandOptions) {
         customerImpact: readUpdateString("customerImpact"),
         dep: readUpdateList("dep"),
         depRemove: readUpdateList("depRemove"),
-        replaceDeps: commandOptions.replaceDeps === true ? true : undefined,
-        replaceTests: commandOptions.replaceTests === true ? true : undefined,
+        replaceDeps: optionTrue(commandOptions, "replaceDeps"),
+        replaceTests: optionTrue(commandOptions, "replaceTests"),
         comment: readUpdateList("comment"),
         note: readUpdateList("note"),
         learning: readUpdateList("learning"),
@@ -348,23 +363,18 @@ export function normalizeUpdateOptions(commandOptions) {
         typeOption: readUpdateList("typeOption"),
         field: readUpdateList("field"),
         unset: readUpdateList("unset"),
-        clearDeps: commandOptions.clearDeps === true ? true : undefined,
-        clearComments: commandOptions.clearComments === true ? true : undefined,
-        clearNotes: commandOptions.clearNotes === true ? true : undefined,
-        clearLearnings: commandOptions.clearLearnings === true ? true : undefined,
-        clearFiles: commandOptions.clearFiles === true ? true : undefined,
-        clearTests: commandOptions.clearTests === true ? true : undefined,
-        clearDocs: commandOptions.clearDocs === true ? true : undefined,
-        clearReminders: commandOptions.clearReminders === true ? true : undefined,
-        clearEvents: commandOptions.clearEvents === true ? true : undefined,
-        clearTypeOptions: commandOptions.clearTypeOptions === true ? true : undefined,
+        clearDeps: optionTrue(commandOptions, "clearDeps"),
+        clearComments: optionTrue(commandOptions, "clearComments"),
+        clearNotes: optionTrue(commandOptions, "clearNotes"),
+        clearLearnings: optionTrue(commandOptions, "clearLearnings"),
+        clearFiles: optionTrue(commandOptions, "clearFiles"),
+        clearTests: optionTrue(commandOptions, "clearTests"),
+        clearDocs: optionTrue(commandOptions, "clearDocs"),
+        clearReminders: optionTrue(commandOptions, "clearReminders"),
+        clearEvents: optionTrue(commandOptions, "clearEvents"),
+        clearTypeOptions: optionTrue(commandOptions, "clearTypeOptions"),
     };
-    for (const [key, value] of Object.entries(commandOptions)) {
-        if (Object.hasOwn(normalized, key)) {
-            continue;
-        }
-        normalized[key] = value;
-    }
+    copyUnknownOptions(normalized, commandOptions);
     return normalized;
 }
 const UPDATE_MANY_CONTROL_OPTION_KEYS = new Set([
@@ -475,54 +485,49 @@ export function normalizeListOptions(options) {
         limit: readListOptionString(options, "limit"),
         offset: readListOptionString(options, "offset"),
         // Commander stores --no-truncate as truncate=false; --all is the positive alias.
-        noTruncate: options.truncate === false || options.all === true ? true : undefined,
-        includeBody: options.includeBody === true ? true : undefined,
-        compact: options.compact === true ? true : undefined,
-        brief: options.brief === true ? true : undefined,
-        full: options.full === true ? true : undefined,
+        noTruncate: optionFalse(options, "truncate") ?? optionTrue(options, "all"),
+        includeBody: optionTrue(options, "includeBody"),
+        compact: optionTrue(options, "compact"),
+        brief: optionTrue(options, "brief"),
+        full: optionTrue(options, "full"),
         fields: readListOptionString(options, "fields"),
         sort: readListOptionString(options, "sort"),
         order: readListOptionString(options, "order"),
-        tree: options.tree === true ? true : undefined,
+        tree: optionTrue(options, "tree"),
         treeDepth: readListOptionString(options, "treeDepth"),
-        filterAcMissing: options.filterAcMissing === true ? true : undefined,
-        filterEstimatesMissing: options.filterEstimatesMissing === true || options.filterEstimateMissing === true ? true : undefined,
-        filterResolutionMissing: options.filterResolutionMissing === true ? true : undefined,
-        filterMetadataMissing: options.filterMetadataMissing === true ? true : undefined,
+        filterAcMissing: optionTrue(options, "filterAcMissing"),
+        filterEstimatesMissing: anyOptionTrue(options, ["filterEstimatesMissing", "filterEstimateMissing"]),
+        filterResolutionMissing: optionTrue(options, "filterResolutionMissing"),
+        filterMetadataMissing: optionTrue(options, "filterMetadataMissing"),
         // Governance-missing selection filters (GH-236).
-        filterReviewerMissing: options.filterReviewerMissing === true ? true : undefined,
-        filterRiskMissing: options.filterRiskMissing === true ? true : undefined,
-        filterConfidenceMissing: options.filterConfidenceMissing === true ? true : undefined,
-        filterSprintMissing: options.filterSprintMissing === true ? true : undefined,
-        filterReleaseMissing: options.filterReleaseMissing === true ? true : undefined,
+        filterReviewerMissing: optionTrue(options, "filterReviewerMissing"),
+        filterRiskMissing: optionTrue(options, "filterRiskMissing"),
+        filterConfidenceMissing: optionTrue(options, "filterConfidenceMissing"),
+        filterSprintMissing: optionTrue(options, "filterSprintMissing"),
+        filterReleaseMissing: optionTrue(options, "filterReleaseMissing"),
         // Content-field presence/absence selection filters (GH-242). Presence flags
         // are plain booleans; absence uses commander negation (`--no-notes` stores
         // notes=false) except --empty-body which is its own dest.
-        hasNotes: options.hasNotes === true ? true : undefined,
-        hasLearnings: options.hasLearnings === true ? true : undefined,
-        hasFiles: options.hasFiles === true ? true : undefined,
-        hasDocs: options.hasDocs === true ? true : undefined,
-        hasTests: options.hasTests === true ? true : undefined,
-        hasComments: options.hasComments === true ? true : undefined,
-        hasDeps: options.hasDeps === true ? true : undefined,
-        hasBody: options.hasBody === true ? true : undefined,
-        hasLinkedCommand: options.hasLinkedCommand === true ? true : undefined,
-        noNotes: options.notes === false ? true : undefined,
-        noLearnings: options.learnings === false ? true : undefined,
-        noFiles: options.files === false ? true : undefined,
-        noDocs: options.docs === false ? true : undefined,
-        noTests: options.tests === false ? true : undefined,
-        noComments: options.comments === false ? true : undefined,
-        noDeps: options.deps === false ? true : undefined,
-        emptyBody: options.emptyBody === true ? true : undefined,
-        noLinkedCommand: options.linkedCommand === false ? true : undefined,
+        hasNotes: optionTrue(options, "hasNotes"),
+        hasLearnings: optionTrue(options, "hasLearnings"),
+        hasFiles: optionTrue(options, "hasFiles"),
+        hasDocs: optionTrue(options, "hasDocs"),
+        hasTests: optionTrue(options, "hasTests"),
+        hasComments: optionTrue(options, "hasComments"),
+        hasDeps: optionTrue(options, "hasDeps"),
+        hasBody: optionTrue(options, "hasBody"),
+        hasLinkedCommand: optionTrue(options, "hasLinkedCommand"),
+        noNotes: optionFalse(options, "notes"),
+        noLearnings: optionFalse(options, "learnings"),
+        noFiles: optionFalse(options, "files"),
+        noDocs: optionFalse(options, "docs"),
+        noTests: optionFalse(options, "tests"),
+        noComments: optionFalse(options, "comments"),
+        noDeps: optionFalse(options, "deps"),
+        emptyBody: optionTrue(options, "emptyBody"),
+        noLinkedCommand: optionFalse(options, "linkedCommand"),
     };
-    for (const [key, value] of Object.entries(options)) {
-        if (Object.hasOwn(normalized, key)) {
-            continue;
-        }
-        normalized[key] = value;
-    }
+    copyUnknownOptions(normalized, options);
     return normalized;
 }
 /**
@@ -636,12 +641,12 @@ export function normalizeSearchOptions(options) {
         mode,
         matchMode: readSearchString("matchMode"),
         minScore: readSearchStringOrNumber("minScore"),
-        count: options.count === true ? true : undefined,
+        count: optionTrue(options, "count"),
         semanticWeight: readSearchStringOrNumber("semanticWeight"),
-        includeLinked: options.includeLinked === true ? true : undefined,
-        titleExact: options.titleExact === true ? true : undefined,
-        phraseExact: options.phraseExact === true ? true : undefined,
-        highlight: options.highlight === true ? true : undefined,
+        includeLinked: optionTrue(options, "includeLinked"),
+        titleExact: optionTrue(options, "titleExact"),
+        phraseExact: optionTrue(options, "phraseExact"),
+        highlight: optionTrue(options, "highlight"),
         status: readSearchString("status"),
         type: readSearchString("type"),
         tag: readSearchString("tag"),
@@ -659,41 +664,36 @@ export function normalizeSearchOptions(options) {
         limit: readSearchString("limit"),
         fields,
         compact: compactRequested || defaultCompact ? true : undefined,
-        full: fullRequested ? true : undefined,
+        full: optionTrue(options, "full"),
         // Governance-missing selection filters (GH-236).
-        filterReviewerMissing: options.filterReviewerMissing === true ? true : undefined,
-        filterRiskMissing: options.filterRiskMissing === true ? true : undefined,
-        filterConfidenceMissing: options.filterConfidenceMissing === true ? true : undefined,
-        filterSprintMissing: options.filterSprintMissing === true ? true : undefined,
-        filterReleaseMissing: options.filterReleaseMissing === true ? true : undefined,
+        filterReviewerMissing: optionTrue(options, "filterReviewerMissing"),
+        filterRiskMissing: optionTrue(options, "filterRiskMissing"),
+        filterConfidenceMissing: optionTrue(options, "filterConfidenceMissing"),
+        filterSprintMissing: optionTrue(options, "filterSprintMissing"),
+        filterReleaseMissing: optionTrue(options, "filterReleaseMissing"),
         // Content-field presence/absence selection filters (GH-242). Mirror
         // normalizeListOptions: presence flags are booleans; absence uses commander
         // negation (notes=false) except --empty-body which is its own dest.
-        hasNotes: options.hasNotes === true ? true : undefined,
-        hasLearnings: options.hasLearnings === true ? true : undefined,
-        hasFiles: options.hasFiles === true ? true : undefined,
-        hasDocs: options.hasDocs === true ? true : undefined,
-        hasTests: options.hasTests === true ? true : undefined,
-        hasComments: options.hasComments === true ? true : undefined,
-        hasDeps: options.hasDeps === true ? true : undefined,
-        hasBody: options.hasBody === true ? true : undefined,
-        hasLinkedCommand: options.hasLinkedCommand === true ? true : undefined,
-        noNotes: options.notes === false ? true : undefined,
-        noLearnings: options.learnings === false ? true : undefined,
-        noFiles: options.files === false ? true : undefined,
-        noDocs: options.docs === false ? true : undefined,
-        noTests: options.tests === false ? true : undefined,
-        noComments: options.comments === false ? true : undefined,
-        noDeps: options.deps === false ? true : undefined,
-        emptyBody: options.emptyBody === true ? true : undefined,
-        noLinkedCommand: options.linkedCommand === false ? true : undefined,
+        hasNotes: optionTrue(options, "hasNotes"),
+        hasLearnings: optionTrue(options, "hasLearnings"),
+        hasFiles: optionTrue(options, "hasFiles"),
+        hasDocs: optionTrue(options, "hasDocs"),
+        hasTests: optionTrue(options, "hasTests"),
+        hasComments: optionTrue(options, "hasComments"),
+        hasDeps: optionTrue(options, "hasDeps"),
+        hasBody: optionTrue(options, "hasBody"),
+        hasLinkedCommand: optionTrue(options, "hasLinkedCommand"),
+        noNotes: optionFalse(options, "notes"),
+        noLearnings: optionFalse(options, "learnings"),
+        noFiles: optionFalse(options, "files"),
+        noDocs: optionFalse(options, "docs"),
+        noTests: optionFalse(options, "tests"),
+        noComments: optionFalse(options, "comments"),
+        noDeps: optionFalse(options, "deps"),
+        emptyBody: optionTrue(options, "emptyBody"),
+        noLinkedCommand: optionFalse(options, "linkedCommand"),
     };
-    for (const [key, value] of Object.entries(options)) {
-        if (Object.hasOwn(normalized, key)) {
-            continue;
-        }
-        normalized[key] = value;
-    }
+    copyUnknownOptions(normalized, options);
     return normalized;
 }
 /**
@@ -724,6 +724,8 @@ export function normalizeActivityOptions(options) {
         compact: options.full === true ? false : options.compact === false ? false : true,
     };
 }
+const ACTIVITY_STREAM_ENABLED_VALUES = new Set(["", "rows", "ndjson", "jsonl", "true", "1", "yes", "on"]);
+const ACTIVITY_STREAM_DISABLED_VALUES = new Set(["false", "off", "none", "0"]);
 /**
  * Implements resolve activity stream mode for the public runtime surface of this module.
  */
@@ -736,17 +738,10 @@ export function resolveActivityStreamMode(raw) {
     }
     if (typeof raw === "string") {
         const normalized = raw.trim().toLowerCase();
-        if (normalized.length === 0 ||
-            normalized === "rows" ||
-            normalized === "ndjson" ||
-            normalized === "jsonl" ||
-            normalized === "true" ||
-            normalized === "1" ||
-            normalized === "yes" ||
-            normalized === "on") {
+        if (ACTIVITY_STREAM_ENABLED_VALUES.has(normalized)) {
             return true;
         }
-        if (normalized === "false" || normalized === "off" || normalized === "none" || normalized === "0") {
+        if (ACTIVITY_STREAM_DISABLED_VALUES.has(normalized)) {
             return false;
         }
     }
@@ -792,6 +787,37 @@ export function normalizeContextOptions(options) {
     }
     return normalized;
 }
+/**
+ * Normalizes raw commander options for `pm next` into a typed {@link NextOptions}
+ * payload, resolving snake_case flag aliases (e.g. `--assignee_filter`,
+ * `--blocked_limit`, `--ready_only`) to their canonical camelCase keys and folding
+ * the boolean `--ready-only` switch. Unknown keys are passed through untouched so
+ * downstream filtering still sees them.
+ */
+export function normalizeNextOptions(options) {
+    const readNextString = (target) => readFirstStringFromCommanderOptions(options, resolveCommanderContract(NEXT_COMMANDER_STRING_OPTION_CONTRACTS, target));
+    const normalized = {
+        type: readNextString("type"),
+        tag: readNextString("tag"),
+        priority: readNextString("priority"),
+        assignee: readNextString("assignee"),
+        assigneeFilter: readNextString("assigneeFilter"),
+        sprint: readNextString("sprint"),
+        release: readNextString("release"),
+        parent: readNextString("parent"),
+        limit: readNextString("limit"),
+        blockedLimit: readNextString("blockedLimit"),
+        readyOnly: options.readyOnly === true || options.ready_only === true ? true : undefined,
+        format: readNextString("format"),
+    };
+    for (const [key, value] of Object.entries(options)) {
+        if (Object.hasOwn(normalized, key)) {
+            continue;
+        }
+        normalized[key] = value;
+    }
+    return normalized;
+}
 function collectMutationItemIds(result) {
     if (!result || typeof result !== "object") {
         return [];
@@ -846,4 +872,4 @@ export const _testOnly = {
     collectMutationItemIds,
 };
 //# sourceMappingURL=registration-helpers.js.map
-//# debugId=efcb3148-9ad3-54e1-a3d4-b5c04c7cdfc7
+//# debugId=002ca6d8-67bc-59d2-88d2-006f43de8e55