@unbrained/pm-cli 2026.6.12 → 2026.6.16

package/dist/mcp/server.d.ts

@@ -1,11 +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,7 @@
 #!/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]="e3feb52b-3154-5b9c-85ec-f0639c808233")}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]="213a44a1-8ff0-5cc0-8e41-9aab0fe7ad2d")}catch(e){}}();
+import { realpathSync } from "node:fs";
 import readline from "node:readline";
 import { fileURLToPath } from "node:url";
 import { createEmptyExtensionCommandRegistry, createEmptyExtensionHookRegistry, createEmptyExtensionParserRegistry, createEmptyExtensionPreflightRegistry, createEmptyExtensionRegistrationRegistry, createEmptyExtensionRendererRegistry, createEmptyExtensionServiceRegistry, } from "../core/extensions/extension-registries.js";
@@ -20,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, runSchemaList, runSchemaRemoveStatus, runSchemaRemoveType, runSchemaShow, 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));
@@ -123,6 +124,7 @@ function globalOptions(args) {
         json: true,
         quiet: true,
         path: readString(args, "path"),
+        noExtensions: args.noExtensions === true || args.no_extensions === true,
         noPager: true,
     };
 }
@@ -554,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 });
@@ -576,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) {
@@ -770,7 +779,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 });
@@ -804,6 +821,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" }),
@@ -867,7 +885,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. " +
@@ -962,8 +980,53 @@ export function startMcpServer() {
         void queue.enqueue(() => processRpcLine(line));
     });
 }
-if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+// npm bin entries are symlinks (node_modules/.bin/pm-mcp -> dist/mcp/server.js),
+// so argv[1] must be realpath-resolved before comparing against this module's
+// path — a plain equality check made the published `pm-mcp` bin exit 0 without
+// ever starting the server (pm-qtbc).
+export function isInvokedAsMcpMainModule(argvPath, moduleUrl) {
+    if (!argvPath) {
+        return false;
+    }
+    const selfPath = fileURLToPath(moduleUrl);
+    if (argvPath === selfPath) {
+        return true;
+    }
+    try {
+        return realpathSync(argvPath) === realpathSync(selfPath);
+    }
+    catch {
+        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=e3feb52b-3154-5b9c-85ec-f0639c808233
+//# debugId=213a44a1-8ff0-5cc0-8e41-9aab0fe7ad2d