@unbrained/pm-cli 2026.6.13 → 2026.6.17

package/dist/mcp/server.d.ts

@@ -1,12 +1,73 @@
 #!/usr/bin/env node
+import type { GlobalOptions } from "../core/shared/command-types.js";
+import type { CloseManyCommandOptions } from "../cli/commands/close-many.js";
+import type { ListOptions } from "../cli/commands/list.js";
+import type { UpdateManyCommandOptions } from "../cli/commands/update-many.js";
 interface JsonRpcRequest {
     jsonrpc?: string;
     id?: string | number | null;
     method?: string;
     params?: Record<string, unknown>;
 }
+declare function nearestDeclaredKey(unexpected: string, declared: string[]): string | undefined;
+declare function detectUnexpectedTopLevelKeys(toolName: string, args: Record<string, unknown>): string[];
+declare function readScalarString(args: Record<string, unknown>, key: string): string | undefined;
+declare function readScalarStringAllowBlank(args: Record<string, unknown>, key: string): string | undefined;
+declare function readRequiredString(args: Record<string, unknown>, key: string): string;
+declare function globalOptions(args: Record<string, unknown>): GlobalOptions;
+declare function normalizeMcpOptionsArrays(options: Record<string, unknown>, action?: string): Record<string, unknown>;
+declare function optionsWithAuthor(args: Record<string, unknown>, action?: string): Record<string, unknown>;
+declare function withAddNoteOption(options: Record<string, unknown>): Record<string, unknown>;
+declare function withFilesDiscoveryOptions(options: Record<string, unknown>): Record<string, unknown>;
+declare function normalizeActionName(value: string): string;
+declare function normalizeCommandPath(value: string): string;
+declare function readStringArray(value: unknown): string[];
+declare function extensionOptionsFromArgs(args: Record<string, unknown>, options: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Mutation tools (create/update/close/append/update-many) return a verbose
+ * `changed_fields` array. On the agent path we drop it to a `changed_field_count`
+ * by default for token efficiency, restoring the full array only when the caller
+ * explicitly passes the MCP-level fullChangedFields=true control. Mutation options
+ * are forwarded unchanged so runtime fields named `full` remain valid user data.
+ */
+declare function withMutationCompaction(args: Record<string, unknown>, options?: Record<string, unknown> | null): {
+    changedFields: "full" | "compact";
+    idOnly: boolean;
+    runnerOptions: Record<string, unknown>;
+};
+declare function mutationListOptions(options: Record<string, unknown>): ListOptions;
+declare function closeManyOptionsFromFlat(options: Record<string, unknown>): CloseManyCommandOptions;
+declare function normalizeMcpUpdateOptions(options: Record<string, unknown>): Record<string, unknown>;
+declare function updateManyOptionsFromFlat(options: Record<string, unknown>): UpdateManyCommandOptions;
+declare function runAction(args: Record<string, unknown>): Promise<unknown>;
+declare function errorContent(error: unknown): Record<string, unknown>;
 export declare function handleRequest(request: JsonRpcRequest): Promise<Record<string, unknown> | undefined>;
+declare function writeError(id: JsonRpcRequest["id"], error: unknown): void;
 export declare function processRpcLine(line: string): Promise<void>;
 export declare function startMcpServer(): void;
 export declare function isInvokedAsMcpMainModule(argvPath: string | undefined, moduleUrl: string): boolean;
+export declare const _testOnly: {
+    closeManyOptionsFromFlat: typeof closeManyOptionsFromFlat;
+    detectUnexpectedTopLevelKeys: typeof detectUnexpectedTopLevelKeys;
+    errorContent: typeof errorContent;
+    extensionOptionsFromArgs: typeof extensionOptionsFromArgs;
+    globalOptions: typeof globalOptions;
+    mutationListOptions: typeof mutationListOptions;
+    nearestDeclaredKey: typeof nearestDeclaredKey;
+    normalizeActionName: typeof normalizeActionName;
+    normalizeCommandPath: typeof normalizeCommandPath;
+    normalizeMcpUpdateOptions: typeof normalizeMcpUpdateOptions;
+    normalizeMcpOptionsArrays: typeof normalizeMcpOptionsArrays;
+    optionsWithAuthor: typeof optionsWithAuthor;
+    readRequiredString: typeof readRequiredString;
+    readScalarString: typeof readScalarString;
+    readScalarStringAllowBlank: typeof readScalarStringAllowBlank;
+    readStringArray: typeof readStringArray;
+    runAction: typeof runAction;
+    updateManyOptionsFromFlat: typeof updateManyOptionsFromFlat;
+    withAddNoteOption: typeof withAddNoteOption;
+    withFilesDiscoveryOptions: typeof withFilesDiscoveryOptions;
+    withMutationCompaction: typeof withMutationCompaction;
+    writeError: typeof writeError;
+};
 export {};

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]="42dbbd67-6520-56d1-a587-ab581efbb80d")}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]="4304a5af-f678-52e6-8caf-37ef0af19ca5")}catch(e){}}();
 import { realpathSync } from "node:fs";
 import readline from "node:readline";
 import { fileURLToPath } from "node:url";
@@ -21,7 +21,7 @@ import { normalizeListOptions, normalizeUpdateOptions } from "../cli/registratio
 import { UPDATE_COMMANDER_STRING_OPTION_CONTRACTS } from "../sdk/cli-contracts/commander-mutation-options.js";
 import { clearWorkspaceContractsCache } from "../sdk/runtime.js";
 import { TOOLS } from "./tool-definitions.js";
-import { runActivity, runAggregate, runAppend, runClaim, runClose, runCloseMany, runComments, runContracts, runContext, runCreate, runCopy, runConfig, runDelete, runDeps, runDocs, runExtension, runFiles, runFilesDiscover, runGc, runGet, runHealth, runHistory, runHistoryCompact, runHistoryRedact, runHistoryRepair, runHistoryRepairAll, assertHistoryRepairTarget, runInit, runLearnings, runList, runNotes, runPlan, runRelease, runSchemaAddStatus, runSchemaAddType, runSchemaList, runSchemaRemoveStatus, runSchemaRemoveType, runSchemaShow, runSchemaShowStatus, runSearch, runStats, runTelemetry, runTest, runTestAll, runUpdate, runUpdateMany, runUpgrade, runValidate, } from "../cli/commands/index.js";
+import { runActivity, runAggregate, runAppend, runClaim, runClose, runCloseMany, runComments, runContracts, runContext, runCreate, runCopy, runFocus, runConfig, runDelete, runDeps, runDocs, runExtension, runFiles, runFilesDiscover, runGc, runGet, runHealth, runHistory, runHistoryCompact, runHistoryRedact, runHistoryRepair, runHistoryRepairAll, assertHistoryRepairTarget, runInit, runLearnings, runList, runNotes, runPlan, runRelease, runSchemaAddStatus, runSchemaAddType, runSchemaAddField, runSchemaApplyPreset, runSchemaInferTypes, runSchemaList, runSchemaListFields, runSchemaRemoveStatus, runSchemaRemoveType, runSchemaRemoveField, runSchemaShow, runSchemaShowField, runSchemaShowStatus, runSearch, runStats, runTelemetry, 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));
@@ -124,6 +124,7 @@ function globalOptions(args) {
         json: true,
         quiet: true,
         path: readString(args, "path"),
+        noExtensions: args.noExtensions === true || args.no_extensions === true,
         noPager: true,
     };
 }
@@ -555,10 +556,13 @@ async function runAction(args) {
                 ...runnerOptions,
                 ...(runnerOptions.title === undefined && typeof args.title === "string" ? { title: args.title } : {}),
                 ...(runnerOptions.message === undefined && typeof args.message === "string" ? { message: args.message } : {}),
-                ...(runnerOptions.author === undefined && typeof args.author === "string" ? { author: args.author } : {}),
             };
             return projectMutationResult(await runCopy(id ?? readRequiredString(copyOptions, "id"), copyOptions, global), { changedFields, idOnly });
         }
+        case "focus": {
+            const clear = options.clear === true || args.clear === true;
+            return runFocus(id, { clear }, global);
+        }
         case "update": {
             const { changedFields, idOnly, runnerOptions } = withMutationCompaction(args, options);
             return projectMutationResult(await runUpdate(id ?? readRequiredString(runnerOptions, "id"), runnerOptions, global), { changedFields, idOnly });
@@ -577,7 +581,11 @@ async function runAction(args) {
         }
         case "comments": {
             const commentOptions = { ...options };
-            const isListing = commentOptions.add === undefined && commentOptions.stdin === undefined && commentOptions.file === undefined;
+            const isListing = commentOptions.add === undefined &&
+                commentOptions.stdin === undefined &&
+                commentOptions.file === undefined &&
+                commentOptions.edit === undefined &&
+                commentOptions.delete === undefined;
             if (isListing) {
                 commentOptions.includeMeta = true;
                 if (commentOptions.limit === undefined && commentOptions.full !== true) {
@@ -720,11 +728,44 @@ async function runAction(args) {
             if (normalizedSubcommand === "show-status") {
                 return runSchemaShowStatus(schemaName, global);
             }
+            if (normalizedSubcommand === "list-fields") {
+                return runSchemaListFields(global);
+            }
+            if (normalizedSubcommand === "show-field") {
+                return runSchemaShowField(schemaName, global);
+            }
             if (normalizedSubcommand === "remove-type") {
                 return runSchemaRemoveType(schemaName, { author: schemaAuthor, force: schemaForce }, global);
             }
+            if (normalizedSubcommand === "remove-field") {
+                return runSchemaRemoveField(schemaName, { author: schemaAuthor, force: schemaForce }, global);
+            }
+            if (normalizedSubcommand === "apply-preset") {
+                const presetSource = readString(args, "typePreset") ?? readString(options, "typePreset");
+                return runSchemaApplyPreset(presetSource, { author: schemaAuthor, force: schemaForce }, global);
+            }
             const aliasSource = args.alias ?? options.alias;
             const aliases = aliasSource === undefined ? undefined : readStringArray(aliasSource);
+            if (normalizedSubcommand === "add-field") {
+                const commandsSource = args.commands ?? options.commands;
+                const commands = commandsSource === undefined ? undefined : readStringArray(commandsSource);
+                const requiredTypesSource = args.requiredTypes ?? options.requiredTypes;
+                const requiredTypes = requiredTypesSource === undefined ? undefined : readStringArray(requiredTypesSource);
+                return runSchemaAddField(schemaName, {
+                    type: readString(args, "fieldType") ?? readString(options, "fieldType"),
+                    commands,
+                    description: readString(args, "description") ?? readString(options, "description"),
+                    cliFlag: readString(args, "cliFlag") ?? readString(options, "cliFlag"),
+                    alias: aliases,
+                    required: args.required === true || options.required === true,
+                    requiredOnCreate: args.requiredOnCreate === true || options.requiredOnCreate === true,
+                    // allow_unset defaults true; only an explicit false disables it.
+                    allowUnset: !(args.allowUnset === false || options.allowUnset === false),
+                    requiredTypes,
+                    author: schemaAuthor,
+                    force: schemaForce,
+                }, global);
+            }
             if (normalizedSubcommand === "add-status") {
                 const roleSource = args.role ?? options.role;
                 const roles = roleSource === undefined ? undefined : readStringArray(roleSource);
@@ -756,7 +797,21 @@ async function runAction(args) {
                 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, show-status`, 64);
+                throw new PmCliError(`Unknown pm schema subcommand "${subcommand}". Allowed: add-type, remove-type, add-status, remove-status, add-field, remove-field, list-fields, show-field, apply-preset, list, show, show-status`, 64);
+            }
+            if (args.infer === true || options.infer === true) {
+                const minCountSource = args.minCount ?? options.minCount;
+                const minCount = typeof minCountSource === "number"
+                    ? minCountSource
+                    : typeof minCountSource === "string" && minCountSource.trim().length > 0
+                        ? Number(minCountSource)
+                        : undefined;
+                return runSchemaInferTypes({
+                    minCount,
+                    apply: args.apply === true || options.apply === true,
+                    author: schemaAuthor,
+                    force: schemaForce,
+                }, global);
             }
             return runSchemaAddType(schemaName, {
                 description: readString(args, "description") ?? readString(options, "description"),
@@ -771,7 +826,15 @@ async function runAction(args) {
             }, global);
         }
         case "stats":
-            return runStats(global, { storage: options.storage === true });
+            return runStats(global, {
+                storage: options.storage === true,
+                metadataCoverage: options.metadataCoverage === true,
+                fieldUtilization: options.fieldUtilization === true,
+                byAssignee: options.byAssignee === true,
+                byTag: options.byTag === true,
+                byPriority: options.byPriority === true,
+                tagPrefix: typeof options.tagPrefix === "string" ? options.tagPrefix : undefined,
+            });
         case "append": {
             const { changedFields, runnerOptions } = withMutationCompaction(args, options);
             return projectMutationResult(await runAppend(id ?? readRequiredString(runnerOptions, "id"), runnerOptions, global), { changedFields });
@@ -805,6 +868,7 @@ const HANDLERS = {
     pm_get: (args) => runAction({ ...args, action: "get" }),
     pm_create: (args) => runAction({ ...args, action: "create" }),
     pm_copy: (args) => runAction({ ...args, action: "copy" }),
+    pm_focus: (args) => runAction({ ...args, action: "focus" }),
     pm_update: (args) => runAction({ ...args, action: "update" }),
     pm_append: (args) => runAction({ ...args, action: "append" }),
     pm_claim: (args) => runAction({ ...args, action: "claim" }),
@@ -868,7 +932,7 @@ export async function handleRequest(request) {
             serverInfo: { name: "pm-mcp", version: PM_MCP_SERVER_VERSION },
             instructions: "You have access to native pm CLI tools for git-based project management. " +
                 "Use pm_context or pm_search before creating new work. " +
-                "Prefer narrow tools (pm_context, pm_list, pm_get, pm_search, pm_create, pm_copy, pm_update, pm_append, pm_claim, pm_release, pm_close, pm_comments, pm_files, pm_docs, pm_notes, pm_learnings, pm_deps, pm_test, pm_validate, pm_health, pm_contracts, pm_schema, pm_config, pm_plan) over pm_run when they cover the operation. " +
+                "Prefer narrow tools (pm_context, pm_list, pm_get, pm_search, pm_create, pm_copy, pm_focus, pm_update, pm_append, pm_claim, pm_release, pm_close, pm_comments, pm_files, pm_docs, pm_notes, pm_learnings, pm_deps, pm_test, pm_validate, pm_health, pm_contracts, pm_schema, pm_config, pm_plan) over pm_run when they cover the operation. " +
                 "Use pm_plan for agent harness Plan workflows: it provides Codex/Claude/Cursor-style planning with durable steps, dependencies, decisions, discoveries, validation, and materialization. " +
                 "Use pm_schema and pm_config for workspace configuration: pm_schema manages custom item types/statuses and pm_config reads or writes settings keys. " +
                 "Use pm_run with an explicit action for package-owned operations (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), plus activity, aggregate, history, stats, test-all, and gc. " +
@@ -982,8 +1046,34 @@ export function isInvokedAsMcpMainModule(argvPath, moduleUrl) {
         return false;
     }
 }
+export const _testOnly = {
+    closeManyOptionsFromFlat,
+    detectUnexpectedTopLevelKeys,
+    errorContent,
+    extensionOptionsFromArgs,
+    globalOptions,
+    mutationListOptions,
+    nearestDeclaredKey,
+    normalizeActionName,
+    normalizeCommandPath,
+    normalizeMcpUpdateOptions,
+    normalizeMcpOptionsArrays,
+    optionsWithAuthor,
+    readRequiredString,
+    readScalarString,
+    readScalarStringAllowBlank,
+    readStringArray,
+    runAction,
+    updateManyOptionsFromFlat,
+    withAddNoteOption,
+    withFilesDiscoveryOptions,
+    withMutationCompaction,
+    writeError,
+};
+/* c8 ignore start */
 if (isInvokedAsMcpMainModule(process.argv[1], import.meta.url)) {
     startMcpServer();
 }
+/* c8 ignore stop */
 //# sourceMappingURL=server.js.map
-//# debugId=42dbbd67-6520-56d1-a587-ab581efbb80d
+//# debugId=4304a5af-f678-52e6-8caf-37ef0af19ca5