@unbrained/pm-cli 2026.5.31 → 2026.6.5

package/dist/mcp/server.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!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]="1988238d-a5e8-5080-b8ad-253b203dd069")}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]="bca7578e-84fd-5024-bf68-3518ff6f4192")}catch(e){}}();
 import readline from "node:readline";
 import { fileURLToPath } from "node:url";
 import { activateExtensions, loadExtensions, runActiveCommandHandler, setActiveExtensionCommands, setActiveExtensionHooks, setActiveExtensionParsers, setActiveExtensionPreflight, setActiveExtensionRegistrations, setActiveExtensionRenderers, setActiveExtensionServices, } from "../core/extensions/index.js";
@@ -11,7 +11,9 @@ import { decodeHtmlEntitiesInOptions } from "../core/shared/html-entity-decode.j
 import { asRecordClone } from "../core/shared/primitives.js";
 import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
-import { runActivity, runAggregate, runAppend, runClaim, runClose, runComments, runContracts, runContext, runCreate, runConfig, runDelete, runDeps, runDocs, runExtension, runFiles, runFilesDiscover, runGc, runGet, runHealth, runHistory, runHistoryRedact, runHistoryRepair, runInit, runLearnings, runList, runNotes, runPlan, runRelease, runSchemaAddType, runSearch, runStats, runTest, runTestAll, runUpdate, runUpdateMany, runUpgrade, runValidate, } from "../cli/commands/index.js";
+import { normalizeListOptions, normalizeUpdateOptions } from "../cli/registration-helpers.js";
+import { UPDATE_COMMANDER_STRING_OPTION_CONTRACTS } from "../sdk/cli-contracts/commander-mutation-options.js";
+import { runActivity, runAggregate, runAppend, runClaim, runClose, runCloseMany, runComments, runContracts, runContext, runCreate, runConfig, runDelete, runDeps, runDocs, runExtension, runFiles, runFilesDiscover, runGc, runGet, runHealth, runHistory, runHistoryRedact, runHistoryRepair, runInit, runLearnings, runList, runNotes, runPlan, runRelease, runSchemaAddStatus, runSchemaAddType, runSchemaList, runSchemaRemoveStatus, runSchemaRemoveType, runSchemaShow, runSearch, runStats, runTest, runTestAll, runUpdate, runUpdateMany, runUpgrade, runValidate, } from "../cli/commands/index.js";
 const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
 function resolvePmPackageRoot() {
     return fileURLToPath(new URL("../..", import.meta.url));
@@ -58,12 +60,38 @@ const TOOLS = [
         inputSchema: objectSchema({
             action: {
                 type: "string",
-                description: "Operation name: init, context, list, get, search, create, update, delete, claim, release, close, comments, notes, learnings, files, files-discover, docs, deps, test, test-all, validate, health, contracts, config, activity, aggregate, extension, extension-reload, package, package-install, package-catalog, install, upgrade, history, stats, append, update-many, gc. Package-owned actions (for example calendar/templates/guide/dedupe-audit/normalize/reindex/comments-audit/completion/test-runs-list/test-runs-status/test-runs-logs/test-runs-stop/test-runs-resume) are available dynamically when installed.",
+                description: "Operation name: init, context, list, get, search, create, update, delete, claim, release, close, close-many, comments, notes, learnings, files, files-discover, docs, deps, test, test-all, validate, health, contracts, config, activity, aggregate, extension, extension-reload, package, package-install, package-catalog, install, upgrade, history, schema, stats, append, update-many, gc. Package-owned actions (for example calendar/templates/guide/dedupe-audit/normalize/reindex/comments-audit/completion/test-runs-list/test-runs-status/test-runs-logs/test-runs-stop/test-runs-resume) are available dynamically when installed.",
             },
             id: idSchema,
             query: { type: "string", description: "Search query for action=search." },
             reason: { type: "string", description: "Close reason for action=close." },
             force: { type: "boolean", description: "Force ownership/terminal-state override when supported." },
+            subcommand: {
+                type: "string",
+                enum: ["list", "show", "add-type", "remove-type", "add-status", "remove-status"],
+                description: "Schema subcommand when action=schema.",
+            },
+            name: {
+                type: "string",
+                description: "Item type name for action=schema show/add-type/remove-type, or status id for add-status/remove-status.",
+            },
+            description: {
+                type: "string",
+                description: "Custom item type or status description for action=schema add-type/add-status.",
+            },
+            defaultStatus: { type: "string", description: "Default status for action=schema add-type." },
+            folder: { type: "string", description: "Storage folder for action=schema add-type." },
+            alias: {
+                type: "array",
+                items: { type: "string" },
+                description: "Aliases for action=schema add-type/add-status.",
+            },
+            role: {
+                type: "array",
+                items: { type: "string" },
+                description: "Lifecycle roles for action=schema add-status: draft, active, blocked, terminal, terminal_done, terminal_canceled, default_open, default_close, default_cancel.",
+            },
+            order: { type: "number", description: "Display/sort order for action=schema add-status." },
             options: { type: "object", description: "Underlying pm command options using camelCase keys." },
             fullChangedFields: {
                 type: "boolean",
@@ -194,6 +222,23 @@ function readString(args, key) {
     const value = args[key];
     return typeof value === "string" && value.trim().length > 0 ? value : undefined;
 }
+function readScalarString(args, key) {
+    const value = args[key];
+    if (typeof value === "string") {
+        return value.trim().length > 0 ? value : undefined;
+    }
+    return typeof value === "number" && Number.isFinite(value) ? String(value) : undefined;
+}
+function readScalarStringAllowBlank(args, key) {
+    const value = args[key];
+    if (typeof value === "string") {
+        return value;
+    }
+    return typeof value === "number" && Number.isFinite(value) ? String(value) : undefined;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
 function readRequiredString(args, key) {
     const value = readString(args, key);
     if (!value) {
@@ -241,7 +286,7 @@ const ARRAY_ADD_REMOVE_ACTIONS = new Set([
     "test",
     "test-all",
 ]);
-function normalizeOptionsArrays(options, action) {
+function normalizeMcpOptionsArrays(options, action) {
     const result = {};
     const promoteAddRemove = action !== undefined && ARRAY_ADD_REMOVE_ACTIONS.has(action);
     for (const [key, value] of Object.entries(options)) {
@@ -262,7 +307,7 @@ function normalizeOptionsArrays(options, action) {
     return result;
 }
 function optionsWithAuthor(args, action) {
-    const options = normalizeOptionsArrays(asRecordClone(args.options), action);
+    const options = normalizeMcpOptionsArrays(asRecordClone(args.options), action);
     const author = readString(args, "author");
     return author && options.author === undefined ? { ...options, author } : options;
 }
@@ -371,6 +416,116 @@ async function withCwd(cwd, run) {
 function withMutationCompaction(args, options) {
     return { changedFields: args.fullChangedFields === true ? "full" : "compact", runnerOptions: { ...(options ?? {}) } };
 }
+function mutationListOptions(options) {
+    return {
+        type: readScalarString(options, "filterType"),
+        tag: readScalarString(options, "filterTag"),
+        priority: readScalarString(options, "filterPriority"),
+        deadlineBefore: readScalarString(options, "filterDeadlineBefore"),
+        deadlineAfter: readScalarString(options, "filterDeadlineAfter"),
+        updatedAfter: readScalarString(options, "filterUpdatedAfter"),
+        updatedBefore: readScalarString(options, "filterUpdatedBefore"),
+        createdAfter: readScalarString(options, "filterCreatedAfter"),
+        createdBefore: readScalarString(options, "filterCreatedBefore"),
+        ids: readScalarStringAllowBlank(options, "ids"),
+        assignee: readScalarString(options, "filterAssignee"),
+        assigneeFilter: readScalarString(options, "filterAssigneeFilter") ?? readScalarString(options, "filterAssignee_filter"),
+        parent: readScalarString(options, "filterParent"),
+        sprint: readScalarString(options, "filterSprint"),
+        release: readScalarString(options, "filterRelease"),
+        limit: readScalarString(options, "limit"),
+        offset: readScalarString(options, "offset"),
+    };
+}
+function closeManyOptionsFromFlat(options) {
+    return {
+        status: readString(options, "filterStatus"),
+        list: isRecord(options.list) ? normalizeListOptions(options.list) : mutationListOptions(options),
+        reason: readString(options, "reason"),
+        resolution: readString(options, "resolution"),
+        expectedResult: readString(options, "expectedResult") ?? readString(options, "expected_result") ?? readString(options, "expected"),
+        actualResult: readString(options, "actualResult") ?? readString(options, "actual_result") ?? readString(options, "actual"),
+        validateClose: readString(options, "validateClose") ?? readString(options, "validate_close"),
+        author: readString(options, "author"),
+        message: readString(options, "message"),
+        force: options.force === true ? true : undefined,
+        dryRun: options.dryRun === true || options.dry_run === true ? true : undefined,
+        rollback: readString(options, "rollback"),
+        checkpoint: options.checkpoint === false || options.noCheckpoint === true || options.no_checkpoint === true ? false : undefined,
+    };
+}
+const UPDATE_MANY_FLAT_CONTROL_KEYS = new Set([
+    "filterStatus",
+    "filterType",
+    "filterTag",
+    "filterPriority",
+    "filterDeadlineBefore",
+    "filterDeadlineAfter",
+    "filterUpdatedAfter",
+    "filterUpdatedBefore",
+    "filterCreatedAfter",
+    "filterCreatedBefore",
+    "filterAssignee",
+    "filterAssigneeFilter",
+    "filterAssignee_filter",
+    "filterParent",
+    "filterSprint",
+    "filterRelease",
+    "ids",
+    "list",
+    "update",
+    "limit",
+    "offset",
+    "dryRun",
+    "dry_run",
+    "rollback",
+    "checkpoint",
+    "noCheckpoint",
+    "no_checkpoint",
+]);
+function updateManyUpdateOptionsFromFlat(options) {
+    const update = {};
+    for (const [key, value] of Object.entries(options)) {
+        if (UPDATE_MANY_FLAT_CONTROL_KEYS.has(key)) {
+            continue;
+        }
+        update[key] = value;
+    }
+    return normalizeMcpUpdateOptions(update);
+}
+function normalizeMcpUpdateOptions(options) {
+    const normalizedInput = normalizeMcpOptionsArrays(options, "update-many");
+    for (const contract of UPDATE_COMMANDER_STRING_OPTION_CONTRACTS) {
+        for (const key of contract.keys) {
+            const value = normalizedInput[key];
+            if (typeof value === "number" && Number.isFinite(value)) {
+                normalizedInput[key] = String(value);
+            }
+        }
+    }
+    return normalizeUpdateOptions(normalizedInput);
+}
+function updateManyOptionsFromFlat(options) {
+    if (isRecord(options.list) || isRecord(options.update)) {
+        const updateSource = isRecord(options.update) ? options.update : updateManyUpdateOptionsFromFlat(options);
+        return {
+            status: readScalarString(options, "filterStatus"),
+            list: isRecord(options.list) ? normalizeListOptions(options.list) : mutationListOptions(options),
+            update: normalizeMcpUpdateOptions(updateSource),
+            dryRun: options.dryRun === true || options.dry_run === true ? true : undefined,
+            rollback: readString(options, "rollback"),
+            checkpoint: options.checkpoint === false || options.noCheckpoint === true || options.no_checkpoint === true ? false : undefined,
+        };
+    }
+    return {
+        status: readScalarString(options, "filterStatus"),
+        list: mutationListOptions(options),
+        update: updateManyUpdateOptionsFromFlat(options),
+        dryRun: options.dryRun === true || options.dry_run === true ? true : undefined,
+        rollback: readString(options, "rollback"),
+        checkpoint: options.checkpoint === false || options.noCheckpoint === true || options.no_checkpoint === true ? false : undefined,
+    };
+}
 async function runAction(args) {
     const action = readRequiredString(args, "action");
     const global = globalOptions(args);
@@ -513,12 +668,55 @@ async function runAction(args) {
             // subcommand/name are top-level fields in the published action contract,
             // so accept them from args first and fall back to options for parity.
             const subcommand = readString(args, "subcommand") ?? readRequiredString(options, "subcommand");
-            if (subcommand.trim().toLowerCase() !== "add-type") {
-                throw new PmCliError(`Unknown pm schema subcommand "${subcommand}". Allowed: add-type`, 64);
+            const normalizedSubcommand = subcommand.trim().toLowerCase();
+            const schemaName = readString(args, "name") ?? readString(options, "name");
+            const schemaAuthor = readString(args, "author") ?? readString(options, "author");
+            const schemaForce = args.force === true || options.force === true;
+            if (normalizedSubcommand === "list") {
+                return runSchemaList(global);
+            }
+            if (normalizedSubcommand === "show") {
+                return runSchemaShow(schemaName, global);
+            }
+            if (normalizedSubcommand === "remove-type") {
+                return runSchemaRemoveType(schemaName, { author: schemaAuthor, force: schemaForce }, global);
             }
             const aliasSource = args.alias ?? options.alias;
             const aliases = aliasSource === undefined ? undefined : readStringArray(aliasSource);
-            return runSchemaAddType(readString(args, "name") ?? readString(options, "name"), {
+            if (normalizedSubcommand === "add-status") {
+                const roleSource = args.role ?? options.role;
+                const roles = roleSource === undefined ? undefined : readStringArray(roleSource);
+                const orderSource = args.order ?? options.order;
+                let order;
+                if (typeof orderSource === "number") {
+                    if (!Number.isInteger(orderSource)) {
+                        throw new PmCliError("schema add-status order must be a finite integer.", 64);
+                    }
+                    order = orderSource;
+                }
+                else if (typeof orderSource === "string" && orderSource.trim().length > 0) {
+                    const parsed = Number(orderSource);
+                    if (!Number.isInteger(parsed)) {
+                        throw new PmCliError("schema add-status order must be a finite integer.", 64);
+                    }
+                    order = parsed;
+                }
+                return runSchemaAddStatus(schemaName, {
+                    role: roles,
+                    alias: aliases,
+                    description: readString(args, "description") ?? readString(options, "description"),
+                    order,
+                    author: schemaAuthor,
+                    force: schemaForce,
+                }, global);
+            }
+            if (normalizedSubcommand === "remove-status") {
+                return runSchemaRemoveStatus(schemaName, { author: schemaAuthor, force: schemaForce }, global);
+            }
+            if (normalizedSubcommand !== "add-type") {
+                throw new PmCliError(`Unknown pm schema subcommand "${subcommand}". Allowed: add-type, remove-type, add-status, remove-status, list, show`, 64);
+            }
+            return runSchemaAddType(schemaName, {
                 description: readString(args, "description") ?? readString(options, "description"),
                 defaultStatus: readString(args, "defaultStatus") ??
                     readString(args, "default_status") ??
@@ -526,8 +724,8 @@ async function runAction(args) {
                     readString(options, "default_status"),
                 folder: readString(args, "folder") ?? readString(options, "folder"),
                 alias: aliases,
-                author: readString(args, "author") ?? readString(options, "author"),
-                force: args.force === true || options.force === true,
+                author: schemaAuthor,
+                force: schemaForce,
             }, global);
         }
         case "stats":
@@ -538,7 +736,18 @@ async function runAction(args) {
         }
         case "update-many": {
             const { changedFields, runnerOptions } = withMutationCompaction(args, options);
-            return projectMutationResult(await runUpdateMany(runnerOptions, global), { changedFields });
+            return projectMutationResult(await runUpdateMany(updateManyOptionsFromFlat(runnerOptions), global), { changedFields });
+        }
+        case "close-many": {
+            const { changedFields, runnerOptions } = withMutationCompaction(args, options);
+            const topLevelReason = readString(args, "reason");
+            const closeManyRunnerOptions = topLevelReason !== undefined && runnerOptions.reason === undefined
+                ? { ...runnerOptions, reason: topLevelReason }
+                : { ...runnerOptions };
+            if (force && closeManyRunnerOptions.force === undefined) {
+                closeManyRunnerOptions.force = true;
+            }
+            return projectMutationResult(await runCloseMany(closeManyOptionsFromFlat(closeManyRunnerOptions), global), { changedFields });
         }
         case "gc":
             return runGc(global, options);
@@ -676,4 +885,4 @@ if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
     startMcpServer();
 }
 //# sourceMappingURL=server.js.map
-//# debugId=1988238d-a5e8-5080-b8ad-253b203dd069
+//# debugId=bca7578e-84fd-5024-bf68-3518ff6f4192