@unbrained/pm-cli 2026.6.6 → 2026.6.8

package/dist/mcp/server.js

@@ -1,10 +1,11 @@
 #!/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]="f59eb89f-30d4-55de-b785-a4bd3f3f0025")}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]="f5cf4684-71f3-5373-886c-b57359653e23")}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";
 import { pathExists } from "../core/fs/fs-utils.js";
+import { resolvePmCliVersion } from "../core/packages/root.js";
 import { projectMutationResult } from "../core/output/mutation-projection.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { decodeHtmlEntitiesInOptions } from "../core/shared/html-entity-decode.js";
@@ -16,7 +17,7 @@ import { readSettings } from "../core/store/settings.js";
 import { normalizeListOptions, normalizeUpdateOptions } from "../cli/registration-helpers.js";
 import { UPDATE_COMMANDER_STRING_OPTION_CONTRACTS } from "../sdk/cli-contracts/commander-mutation-options.js";
 import { PM_TOOL_ACTIONS } from "../sdk/cli-contracts/enum-contracts.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, runTelemetry, runTest, runTestAll, runUpdate, runUpdateMany, runUpgrade, runValidate, } from "../cli/commands/index.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, 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));
@@ -24,6 +25,9 @@ function resolvePmPackageRoot() {
 if (typeof process.env[PM_PACKAGE_ROOT_ENV] !== "string" || process.env[PM_PACKAGE_ROOT_ENV]?.trim().length === 0) {
     process.env[PM_PACKAGE_ROOT_ENV] = resolvePmPackageRoot();
 }
+// Reflect the real package.json version so agents/telemetry can identify the
+// build serving requests (was hard-coded "1.0.0"; see pm-2nvw).
+const PM_MCP_SERVER_VERSION = resolvePmCliVersion(import.meta.url, ["../.."]) ?? "0.0.0";
 const TOOL_SCHEMA_BASE = {
     type: "object",
     properties: {
@@ -51,6 +55,22 @@ const idSchema = {
 // MCP-facing description can never drift from the actual supported actions.
 const PM_RUN_ACTION_DESCRIPTION = `Operation name (one of): ${PM_TOOL_ACTIONS.join(", ")}. ` +
     "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.";
+const LIST_TOP_LEVEL_OPTION_PROPERTIES = {
+    status: { type: "string", description: "Alias for options.status." },
+    type: { type: "string", description: "Alias for options.type." },
+    tag: { type: "string", description: "Alias for options.tag." },
+    priority: { type: "string", description: "Alias for options.priority." },
+    limit: { type: ["string", "number"], description: "Alias for options.limit." },
+    offset: { type: ["string", "number"], description: "Alias for options.offset." },
+};
+const SEARCH_TOP_LEVEL_OPTION_PROPERTIES = {
+    mode: { type: "string", description: "Alias for options.mode." },
+    status: { type: "string", description: "Alias for options.status." },
+    type: { type: "string", description: "Alias for options.type." },
+    tag: { type: "string", description: "Alias for options.tag." },
+    priority: { type: "string", description: "Alias for options.priority." },
+    limit: { type: ["string", "number"], description: "Alias for options.limit." },
+};
 function objectSchema(properties, required = []) {
     return {
         ...TOOL_SCHEMA_BASE,
@@ -76,12 +96,12 @@ const TOOLS = [
             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"],
+                enum: ["list", "show", "show-status", "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: "Item type name for action=schema show/add-type/remove-type, or status id for show-status/add-status/remove-status.",
             },
             description: {
                 type: "string",
@@ -118,7 +138,7 @@ const TOOLS = [
             "Defaults to a compact projection for token efficiency. " +
             "Pass options.mode=keyword|semantic|hybrid, options.limit=N to cap hits, " +
             "options.fields='id,title,score' for a custom projection, or options.full=true for full item bodies (can be large).",
-        inputSchema: objectSchema({ query: { type: "string" }, options: { type: "object" } }, ["query"]),
+        inputSchema: objectSchema({ query: { type: "string" }, options: { type: "object" }, ...SEARCH_TOP_LEVEL_OPTION_PROPERTIES }, ["query"]),
     },
     {
         name: "pm_list",
@@ -128,7 +148,7 @@ const TOOLS = [
             "Pass options.brief=true for ultra-terse (id/status/type/title only). " +
             "Pass options.fields='id,title,priority' for custom projection. " +
             "Pass options.limit=N to cap row count.",
-        inputSchema: objectSchema({ options: { type: "object" } }),
+        inputSchema: objectSchema({ options: { type: "object" }, ...LIST_TOP_LEVEL_OPTION_PROPERTIES }),
     },
     {
         name: "pm_get",
@@ -147,6 +167,16 @@ const TOOLS = [
             options: { type: "object", description: "Create options. title and description are required." },
         }, ["options"]),
     },
+    {
+        name: "pm_copy",
+        description: "Copy an existing pm item into a new id while resetting lifecycle fields. " +
+            "Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields array.",
+        inputSchema: objectSchema({
+            id: idSchema,
+            fullChangedFields: { type: "boolean", description: "Return full changed_fields instead of changed_field_count." },
+            options: { type: "object", description: "Copy options such as title override, author, and message." },
+        }, ["id"]),
+    },
     {
         name: "pm_update",
         description: "Update pm item metadata/body/dependencies/log seeds natively. " +
@@ -169,14 +199,14 @@ const TOOLS = [
     },
     {
         name: "pm_close",
-        description: "Close a pm item with a reason and optional close validation. " +
+        description: "Close a pm item with optional close reason and optional close validation (reason requirement follows governance settings). " +
             "Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields array.",
         inputSchema: objectSchema({
             id: idSchema,
-            reason: { type: "string" },
+            reason: { type: "string", description: "Close reason text when provided or required by governance settings." },
             fullChangedFields: { type: "boolean", description: "Return full changed_fields instead of changed_field_count." },
             options: { type: "object" },
-        }, ["id", "reason"]),
+        }, ["id"]),
     },
     {
         name: "pm_comments",
@@ -386,7 +416,31 @@ function normalizeMcpOptionsArrays(options, action) {
     return result;
 }
 function optionsWithAuthor(args, action) {
-    const options = normalizeMcpOptionsArrays(asRecordClone(args.options), action);
+    const baseOptions = asRecordClone(args.options);
+    const hoistedTopLevel = {};
+    const hoistKey = (key) => {
+        if (baseOptions[key] !== undefined || args[key] === undefined) {
+            return;
+        }
+        hoistedTopLevel[key] = args[key];
+    };
+    if (action === "list") {
+        hoistKey("status");
+        hoistKey("type");
+        hoistKey("tag");
+        hoistKey("priority");
+        hoistKey("limit");
+        hoistKey("offset");
+    }
+    else if (action === "search") {
+        hoistKey("mode");
+        hoistKey("status");
+        hoistKey("type");
+        hoistKey("tag");
+        hoistKey("priority");
+        hoistKey("limit");
+    }
+    const options = normalizeMcpOptionsArrays({ ...hoistedTopLevel, ...baseOptions }, action);
     const author = readString(args, "author");
     return author && options.author === undefined ? { ...options, author } : options;
 }
@@ -641,6 +695,16 @@ async function runAction(args) {
             const { changedFields, runnerOptions } = withMutationCompaction(args, options);
             return projectMutationResult(await runCreate(runnerOptions, global), { changedFields });
         }
+        case "copy": {
+            const { changedFields, runnerOptions } = withMutationCompaction(args, options);
+            const copyOptions = {
+                ...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 });
+        }
         case "update": {
             const { changedFields, runnerOptions } = withMutationCompaction(args, options);
             return projectMutationResult(await runUpdate(id ?? readRequiredString(runnerOptions, "id"), runnerOptions, global), { changedFields });
@@ -651,7 +715,11 @@ async function runAction(args) {
             return runRelease(id ?? readRequiredString(options, "id"), force, global, options);
         case "close": {
             const { changedFields, runnerOptions } = withMutationCompaction(args, options);
-            return projectMutationResult(await runClose(id ?? readRequiredString(runnerOptions, "id"), readRequiredString(args, "reason"), runnerOptions, global), { changedFields });
+            const closeReason = readString(args, "reason") ??
+                readString(args, "text") ??
+                readString(runnerOptions, "reason") ??
+                readString(runnerOptions, "text");
+            return projectMutationResult(await runClose(id ?? readRequiredString(runnerOptions, "id"), closeReason, runnerOptions, global), { changedFields });
         }
         case "comments": {
             const commentOptions = { ...options };
@@ -688,8 +756,19 @@ async function runAction(args) {
             }, global);
         case "validate":
             return runValidate(options, global);
-        case "health":
-            return runHealth(global, options);
+        case "health": {
+            // Default to the compact `summary` projection for agents (ok + per-check
+            // status + warning samples; ~22x smaller than the full payload). Callers
+            // opt into detail with brief/summary/full or the deep remediation payload
+            // via full=true. Mirrors the compact-by-default list/search behavior (F2).
+            const healthOptions = { ...options };
+            if (healthOptions.brief === undefined &&
+                healthOptions.summary === undefined &&
+                healthOptions.full === undefined) {
+                healthOptions.summary = true;
+            }
+            return runHealth(global, healthOptions);
+        }
         case "contracts":
             return runContracts(options, global);
         case "config":
@@ -729,6 +808,8 @@ async function runAction(args) {
             return runHistoryRedact(id ?? readRequiredString(options, "id"), options, global);
         case "history-repair":
             return runHistoryRepair(id ?? readRequiredString(options, "id"), options, global);
+        case "history-compact":
+            return runHistoryCompact(id ?? readRequiredString(options, "id"), options, global);
         case "plan": {
             const subcommand = readRequiredString(options, "subcommand");
             const planRecord = options;
@@ -766,6 +847,9 @@ async function runAction(args) {
             if (normalizedSubcommand === "show") {
                 return runSchemaShow(schemaName, global);
             }
+            if (normalizedSubcommand === "show-status") {
+                return runSchemaShowStatus(schemaName, global);
+            }
             if (normalizedSubcommand === "remove-type") {
                 return runSchemaRemoveType(schemaName, { author: schemaAuthor, force: schemaForce }, global);
             }
@@ -802,7 +886,7 @@ 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`, 64);
+                throw new PmCliError(`Unknown pm schema subcommand "${subcommand}". Allowed: add-type, remove-type, add-status, remove-status, list, show, show-status`, 64);
             }
             return runSchemaAddType(schemaName, {
                 description: readString(args, "description") ?? readString(options, "description"),
@@ -850,6 +934,7 @@ const HANDLERS = {
     pm_list: (args) => runAction({ ...args, action: "list" }),
     pm_get: (args) => runAction({ ...args, action: "get" }),
     pm_create: (args) => runAction({ ...args, action: "create" }),
+    pm_copy: (args) => runAction({ ...args, action: "copy" }),
     pm_update: (args) => runAction({ ...args, action: "update" }),
     pm_claim: (args) => runAction({ ...args, action: "claim" }),
     pm_release: (args) => runAction({ ...args, action: "release" }),
@@ -891,24 +976,29 @@ function errorContent(error) {
                 text: JSON.stringify({ error: message, code }, null, 2),
             },
         ],
-        structuredContent: { error: message, code },
+        // Keep `result` present on the error envelope so consumers can read
+        // `structuredContent.result` uniformly across success and failure (pm-l40h).
+        structuredContent: { result: null, error: message, code },
     };
 }
 export async function handleRequest(request) {
     if (!request.id && request.method?.startsWith("notifications/")) {
         return undefined;
     }
+    if (request.method === "ping") {
+        return {};
+    }
     if (request.method === "initialize") {
         return {
             protocolVersion: "2025-06-18",
             capabilities: { tools: {} },
-            serverInfo: { name: "pm-mcp", version: "1.0.0" },
+            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_update, 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_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_update, 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_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_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, append, test-all, and gc. " +
-                "Use history-redact for audited history-stream redaction workflows, and history-repair to re-anchor a drifted history chain so pm health/validate report ok. " +
+                "Use history-redact for audited history-stream redaction workflows, history-repair to re-anchor a drifted history chain, and history-compact to checkpoint/prune long history streams while preserving replay integrity. " +
                 "Set author to 'claude-code-agent' on all mutations. " +
                 "Do not pass path during real repository tracking — only pass path for sandbox or test runs.",
         };
@@ -1003,4 +1093,4 @@ if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
     startMcpServer();
 }
 //# sourceMappingURL=server.js.map
-//# debugId=f59eb89f-30d4-55de-b785-a4bd3f3f0025
+//# debugId=f5cf4684-71f3-5373-886c-b57359653e23