@unbrained/pm-cli 2026.6.10 → 2026.6.11

package/dist/mcp/tool-definitions.js

@@ -0,0 +1,330 @@
+
+!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]="6101f461-4390-5960-ae47-ed875ff3ee06")}catch(e){}}();
+import { PM_TOOL_ACTIONS } from "../sdk/cli-contracts/enum-contracts.js";
+import { RUNTIME_STATUS_ROLE_VALUES } from "../types.js";
+const TOOL_SCHEMA_BASE = {
+    type: "object",
+    properties: {
+        cwd: {
+            type: "string",
+            description: "Workspace directory to run the native pm operation in. Defaults to the MCP server process cwd.",
+        },
+        path: {
+            type: "string",
+            description: "Optional pm data root, equivalent to PM_PATH/global --path. Leave unset for real repository tracking.",
+        },
+        author: {
+            type: "string",
+            description: "Mutation author. Defaults to PM_AUTHOR or pm settings when supported by the underlying operation.",
+        },
+    },
+    additionalProperties: true,
+};
+const idSchema = {
+    type: "string",
+    description: "pm item id, for example pm-abc1.",
+};
+// pm-fd8n: derive the pm_run action enumeration from the canonical
+// PM_TOOL_ACTIONS contract instead of a hand-maintained prose list, so the
+// 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,
+        properties: {
+            ...TOOL_SCHEMA_BASE.properties,
+            ...properties,
+        },
+        required,
+    };
+}
+export const TOOLS = [
+    {
+        name: "pm_run",
+        description: "Run any supported pm operation natively through the pm library. Use this for commands not covered by narrower pm_* tools.",
+        inputSchema: objectSchema({
+            action: {
+                type: "string",
+                description: PM_RUN_ACTION_DESCRIPTION,
+            },
+            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." },
+            // pm-v68d: the schema-specific subcommand enum and add-type/add-status
+            // properties migrated to the dedicated pm_schema tool. action=schema
+            // still accepts them as passthrough, but agents should prefer pm_schema.
+            subcommand: {
+                type: "string",
+                description: "Subcommand selector for actions that take one (for example telemetry, or schema — prefer the dedicated pm_schema tool for schema operations).",
+            },
+            options: { type: "object", description: "Underlying pm command options using camelCase keys." },
+            fullChangedFields: {
+                type: "boolean",
+                description: "For mutation actions, return the full changed_fields array instead of the default changed_field_count.",
+            },
+            idOnly: {
+                type: "boolean",
+                description: "For single-item mutation actions, return only id and status.",
+            },
+        }, ["action"]),
+    },
+    {
+        name: "pm_context",
+        description: "Return the agent-oriented project context snapshot.",
+        inputSchema: objectSchema({ options: { type: "object" } }),
+    },
+    {
+        name: "pm_search",
+        description: "Search pm items with keyword, semantic, or hybrid search. " +
+            "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). " +
+            "The result echoes the applied filters and projection mode in query_summary.",
+        inputSchema: objectSchema({ query: { type: "string" }, options: { type: "object" }, ...SEARCH_TOP_LEVEL_OPTION_PROPERTIES }, ["query"]),
+    },
+    {
+        name: "pm_list",
+        description: "List pm items with status/type/tag/priority filters. Defaults to compact projection for token efficiency. " +
+            "options.status accepts CSV (open,in_progress). " +
+            "Pass options.compact=false or options.includeBody=true for full bodies/comments. " +
+            "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. " +
+            "The result echoes the applied filters and projection mode in query_summary.",
+        inputSchema: objectSchema({ options: { type: "object" }, ...LIST_TOP_LEVEL_OPTION_PROPERTIES }),
+    },
+    {
+        name: "pm_get",
+        description: "Read one pm item. Pass options.depth='brief' or options.fields='id,title,status' for low-token inspection.",
+        inputSchema: objectSchema({
+            id: idSchema,
+            options: { type: "object", description: "Get options such as depth=brief|standard|deep|full or fields=id,title,status." },
+        }, ["id"]),
+    },
+    {
+        name: "pm_create",
+        description: "Create a pm item natively and write pm history. " +
+            "Output is compact by default (changed_fields replaced with changed_field_count for token efficiency); pass fullChangedFields=true for the full changed_fields array.",
+        inputSchema: objectSchema({
+            fullChangedFields: { type: "boolean", description: "Return full changed_fields instead of changed_field_count." },
+            allowMissingParent: { type: "boolean", description: "Allow unresolved parent references and emit a validation warning." },
+            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. " +
+            "Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields delta.",
+        inputSchema: objectSchema({
+            id: idSchema,
+            fullChangedFields: { type: "boolean", description: "Return full changed_fields instead of changed_field_count." },
+            options: { type: "object" },
+        }, ["id", "options"]),
+    },
+    {
+        name: "pm_append",
+        description: "Append markdown text to a pm item body and write pm history. Useful for seeding evidence/log entries before close. " +
+            "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,
+            body: {
+                type: "string",
+                description: "Markdown text to append to the item body. Required here or as options.body.",
+            },
+            fullChangedFields: { type: "boolean", description: "Return full changed_fields instead of changed_field_count." },
+            options: { type: "object", description: "Append options such as body, author, and message." },
+        }, ["id"]),
+    },
+    {
+        name: "pm_claim",
+        description: "Claim a pm item.",
+        inputSchema: objectSchema({ id: idSchema, force: { type: "boolean" }, options: { type: "object" } }, ["id"]),
+    },
+    {
+        name: "pm_release",
+        description: "Release a pm item claim.",
+        inputSchema: objectSchema({ id: idSchema, force: { type: "boolean" }, options: { type: "object" } }, ["id"]),
+    },
+    {
+        name: "pm_close",
+        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", description: "Close reason text when provided or required by governance settings." },
+            duplicateOf: { type: "string", description: "Canonical item id when closing this item as a duplicate." },
+            fullChangedFields: { type: "boolean", description: "Return full changed_fields instead of changed_field_count." },
+            idOnly: { type: "boolean", description: "Return only id and status." },
+            options: { type: "object" },
+        }, ["id"]),
+    },
+    {
+        name: "pm_comments",
+        description: "List or add comments on a pm item. Use options.add to append. " +
+            "List calls default to the most recent 20 comments with total_count/has_more metadata for token efficiency. " +
+            "Pass options.limit=N to choose a page size, options.limit=0 for summary-only metadata, or options.full=true for full history.",
+        inputSchema: objectSchema({ id: idSchema, options: { type: "object" } }, ["id"]),
+    },
+    {
+        name: "pm_files",
+        description: "List, add, remove, audit, or validate linked files for a pm item.",
+        inputSchema: objectSchema({ id: idSchema, options: { type: "object" } }, ["id"]),
+    },
+    {
+        name: "pm_docs",
+        description: "List, add, or remove linked docs for a pm item.",
+        inputSchema: objectSchema({ id: idSchema, options: { type: "object" } }, ["id"]),
+    },
+    {
+        name: "pm_notes",
+        description: "List or add structured notes on a pm item. Use options.add to append a note; omit it to list existing notes.",
+        inputSchema: objectSchema({ id: idSchema, options: { type: "object" } }, ["id"]),
+    },
+    {
+        name: "pm_learnings",
+        description: "List or add learnings on a pm item. Use options.add to capture a learning/insight; omit it to list existing learnings.",
+        inputSchema: objectSchema({ id: idSchema, options: { type: "object" } }, ["id"]),
+    },
+    {
+        name: "pm_deps",
+        description: "List, add, or remove dependencies for a pm item. Use options.add to declare a dependency and options.remove to drop one; omit both to list current dependencies.",
+        inputSchema: objectSchema({ id: idSchema, options: { type: "object" } }, ["id"]),
+    },
+    {
+        name: "pm_test",
+        description: "List, add, remove, or run linked tests for a pm item.",
+        inputSchema: objectSchema({ id: idSchema, options: { type: "object" } }, ["id"]),
+    },
+    {
+        name: "pm_validate",
+        description: "Run pm validation checks.",
+        inputSchema: objectSchema({ options: { type: "object" } }),
+    },
+    {
+        name: "pm_health",
+        description: "Run pm health diagnostics. Pass options.brief=true for compact low-token details, options.skipIntegrity=true, options.skipDrift=true, options.skipVectors=true for a fast status-only check, or options.full=true for the complete deep check.",
+        inputSchema: objectSchema({ options: { type: "object" } }),
+    },
+    {
+        name: "pm_contracts",
+        description: "Inspect pm command, flag, schema, and availability contracts.",
+        inputSchema: objectSchema({ options: { type: "object" } }),
+    },
+    {
+        name: "pm_schema",
+        description: "Inspect or modify the workspace item-type/status schema (pm schema). " +
+            "subcommand selects the operation; name carries the item type name (show/add-type/remove-type) or status id (show-status/add-status/remove-status). " +
+            "Schema mutations write workspace config files, not item history.",
+        inputSchema: objectSchema({
+            subcommand: {
+                type: "string",
+                enum: ["list", "show", "show-status", "add-type", "remove-type", "add-status", "remove-status"],
+                description: "Schema subcommand to run.",
+            },
+            name: {
+                type: "string",
+                description: "Item type name for show/add-type/remove-type, or status id for show-status/add-status/remove-status. Required for every subcommand except list.",
+            },
+            description: {
+                type: "string",
+                description: "Custom item type or status description for add-type/add-status.",
+            },
+            defaultStatus: { type: "string", description: "Default status for add-type." },
+            folder: { type: "string", description: "Storage folder for add-type." },
+            alias: {
+                type: "array",
+                items: { type: "string" },
+                description: "Aliases for add-type/add-status.",
+            },
+            role: {
+                type: "array",
+                items: { type: "string", enum: [...RUNTIME_STATUS_ROLE_VALUES] },
+                description: `Lifecycle roles for add-status: ${RUNTIME_STATUS_ROLE_VALUES.join(", ")}.`,
+            },
+            order: { type: "number", description: "Display/sort order for add-status." },
+            force: { type: "boolean", description: "Override removal guardrails for destructive schema changes when supported." },
+            options: { type: "object", description: "Additional schema options using camelCase keys." },
+        }, ["subcommand"]),
+    },
+    {
+        name: "pm_config",
+        description: "Read or write pm workspace configuration (pm config). " +
+            "configAction selects get/set/list/export; key/value address a single setting for get/set. " +
+            "scope chooses the project (default) or global settings file.",
+        inputSchema: objectSchema({
+            configAction: {
+                type: "string",
+                enum: ["get", "set", "list", "export"],
+                description: "Config operation to perform. get/set require key; list/export dump the resolved settings surface.",
+            },
+            key: {
+                type: "string",
+                description: "Settings key for get/set, for example governance-require-close-reason, telemetry-tracking, or a nested leaf such as search_provider (dash and underscore variants accepted; configAction=get without a key lists supported keys in the error).",
+            },
+            value: { type: "string", description: "New value for configAction=set." },
+            scope: {
+                type: "string",
+                enum: ["project", "global"],
+                description: "Settings scope to read or write. Defaults to project.",
+            },
+            options: {
+                type: "object",
+                description: "Additional config options such as criterion, clearCriteria, format, or policy.",
+            },
+        }, ["configAction"]),
+    },
+    {
+        name: "pm_plan",
+        description: "Run agent-optimized Plan workflows. options.subcommand selects: create|show|add-step|update-step|complete-step|block-step|reorder-step|remove-step|link|unlink|decision|discovery|validation|resume|approve|materialize. Provide id for all non-create subcommands; provide stepRef for step lifecycle subcommands. Plans store agent-readable steps with dependencies, decisions, discoveries, validation, and resume context.",
+        inputSchema: objectSchema({
+            id: { type: "string", description: "Plan id (required for all subcommands except create)." },
+            stepRef: { type: "string", description: "Step id or order for step lifecycle subcommands." },
+            reorderTo: { type: "number", description: "New order for reorder-step." },
+            options: { type: "object", description: "Plan options including subcommand, stepRef, stepStatus, link, depth, etc." },
+        }),
+    },
+];
+export function buildMcpToolContracts() {
+    return TOOLS.map((tool) => {
+        const schemaRequired = tool.inputSchema["required"];
+        const required = Array.isArray(schemaRequired)
+            ? schemaRequired.map((entry) => String(entry)).sort((left, right) => left.localeCompare(right))
+            : [];
+        return {
+            name: tool.name,
+            description: tool.description,
+            required,
+            input_schema: tool.inputSchema,
+        };
+    }).sort((left, right) => left.name.localeCompare(right.name));
+}
+//# sourceMappingURL=tool-definitions.js.map
+//# debugId=6101f461-4390-5960-ae47-ed875ff3ee06

package/dist/mcp/tool-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-definitions.js","sources":["mcp/tool-definitions.ts"],"sourceRoot":"/","sourcesContent":["import { PM_TOOL_ACTIONS } from \"../sdk/cli-contracts/enum-contracts.js\";\nimport { RUNTIME_STATUS_ROLE_VALUES } from \"../types.js\";\n\n/**\n * Static MCP tool surface for the pm MCP server.\n *\n * Kept as a dependency-light data module (only the enum contract import) so the\n * `pm contracts` command can snapshot the tool surface into the contract\n * golden file (pm-4os2) without importing the full MCP server runtime, and so\n * the server itself stays the single consumer of the dispatch handlers.\n */\nexport interface ToolDefinition {\n  name: string;\n  description: string;\n  inputSchema: Record<string, unknown>;\n}\n\nconst TOOL_SCHEMA_BASE = {\n  type: \"object\",\n  properties: {\n    cwd: {\n      type: \"string\",\n      description: \"Workspace directory to run the native pm operation in. Defaults to the MCP server process cwd.\",\n    },\n    path: {\n      type: \"string\",\n      description: \"Optional pm data root, equivalent to PM_PATH/global --path. Leave unset for real repository tracking.\",\n    },\n    author: {\n      type: \"string\",\n      description: \"Mutation author. Defaults to PM_AUTHOR or pm settings when supported by the underlying operation.\",\n    },\n  },\n  additionalProperties: true,\n} as const;\n\nconst idSchema = {\n  type: \"string\",\n  description: \"pm item id, for example pm-abc1.\",\n};\n\n// pm-fd8n: derive the pm_run action enumeration from the canonical\n// PM_TOOL_ACTIONS contract instead of a hand-maintained prose list, so the\n// MCP-facing description can never drift from the actual supported actions.\nconst PM_RUN_ACTION_DESCRIPTION =\n  `Operation name (one of): ${PM_TOOL_ACTIONS.join(\", \")}. ` +\n  \"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.\";\n\nconst LIST_TOP_LEVEL_OPTION_PROPERTIES: Record<string, unknown> = {\n  status: { type: \"string\", description: \"Alias for options.status.\" },\n  type: { type: \"string\", description: \"Alias for options.type.\" },\n  tag: { type: \"string\", description: \"Alias for options.tag.\" },\n  priority: { type: \"string\", description: \"Alias for options.priority.\" },\n  limit: { type: [\"string\", \"number\"], description: \"Alias for options.limit.\" },\n  offset: { type: [\"string\", \"number\"], description: \"Alias for options.offset.\" },\n};\n\nconst SEARCH_TOP_LEVEL_OPTION_PROPERTIES: Record<string, unknown> = {\n  mode: { type: \"string\", description: \"Alias for options.mode.\" },\n  status: { type: \"string\", description: \"Alias for options.status.\" },\n  type: { type: \"string\", description: \"Alias for options.type.\" },\n  tag: { type: \"string\", description: \"Alias for options.tag.\" },\n  priority: { type: \"string\", description: \"Alias for options.priority.\" },\n  limit: { type: [\"string\", \"number\"], description: \"Alias for options.limit.\" },\n};\n\nfunction objectSchema(properties: Record<string, unknown>, required: string[] = []): Record<string, unknown> {\n  return {\n    ...TOOL_SCHEMA_BASE,\n    properties: {\n      ...TOOL_SCHEMA_BASE.properties,\n      ...properties,\n    },\n    required,\n  };\n}\n\nexport const TOOLS: ToolDefinition[] = [\n  {\n    name: \"pm_run\",\n    description:\n      \"Run any supported pm operation natively through the pm library. Use this for commands not covered by narrower pm_* tools.\",\n    inputSchema: objectSchema(\n      {\n        action: {\n          type: \"string\",\n          description: PM_RUN_ACTION_DESCRIPTION,\n        },\n        id: idSchema,\n        query: { type: \"string\", description: \"Search query for action=search.\" },\n        reason: { type: \"string\", description: \"Close reason for action=close.\" },\n        force: { type: \"boolean\", description: \"Force ownership/terminal-state override when supported.\" },\n        // pm-v68d: the schema-specific subcommand enum and add-type/add-status\n        // properties migrated to the dedicated pm_schema tool. action=schema\n        // still accepts them as passthrough, but agents should prefer pm_schema.\n        subcommand: {\n          type: \"string\",\n          description:\n            \"Subcommand selector for actions that take one (for example telemetry, or schema — prefer the dedicated pm_schema tool for schema operations).\",\n        },\n        options: { type: \"object\", description: \"Underlying pm command options using camelCase keys.\" },\n        fullChangedFields: {\n          type: \"boolean\",\n          description:\n            \"For mutation actions, return the full changed_fields array instead of the default changed_field_count.\",\n        },\n        idOnly: {\n          type: \"boolean\",\n          description: \"For single-item mutation actions, return only id and status.\",\n        },\n      },\n      [\"action\"],\n    ),\n  },\n  {\n    name: \"pm_context\",\n    description: \"Return the agent-oriented project context snapshot.\",\n    inputSchema: objectSchema({ options: { type: \"object\" } }),\n  },\n  {\n    name: \"pm_search\",\n    description:\n      \"Search pm items with keyword, semantic, or hybrid search. \" +\n      \"Defaults to a compact projection for token efficiency. \" +\n      \"Pass options.mode=keyword|semantic|hybrid, options.limit=N to cap hits, \" +\n      \"options.fields='id,title,score' for a custom projection, or options.full=true for full item bodies (can be large). \" +\n      \"The result echoes the applied filters and projection mode in query_summary.\",\n    inputSchema: objectSchema({ query: { type: \"string\" }, options: { type: \"object\" }, ...SEARCH_TOP_LEVEL_OPTION_PROPERTIES }, [\"query\"]),\n  },\n  {\n    name: \"pm_list\",\n    description:\n      \"List pm items with status/type/tag/priority filters. Defaults to compact projection for token efficiency. \" +\n      \"options.status accepts CSV (open,in_progress). \" +\n      \"Pass options.compact=false or options.includeBody=true for full bodies/comments. \" +\n      \"Pass options.brief=true for ultra-terse (id/status/type/title only). \" +\n      \"Pass options.fields='id,title,priority' for custom projection. \" +\n      \"Pass options.limit=N to cap row count. \" +\n      \"The result echoes the applied filters and projection mode in query_summary.\",\n    inputSchema: objectSchema({ options: { type: \"object\" }, ...LIST_TOP_LEVEL_OPTION_PROPERTIES }),\n  },\n  {\n    name: \"pm_get\",\n    description:\n      \"Read one pm item. Pass options.depth='brief' or options.fields='id,title,status' for low-token inspection.\",\n    inputSchema: objectSchema({\n      id: idSchema,\n      options: { type: \"object\", description: \"Get options such as depth=brief|standard|deep|full or fields=id,title,status.\" },\n    }, [\"id\"]),\n  },\n  {\n    name: \"pm_create\",\n    description:\n      \"Create a pm item natively and write pm history. \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count for token efficiency); pass fullChangedFields=true for the full changed_fields array.\",\n    inputSchema: objectSchema(\n      {\n        fullChangedFields: { type: \"boolean\", description: \"Return full changed_fields instead of changed_field_count.\" },\n        allowMissingParent: { type: \"boolean\", description: \"Allow unresolved parent references and emit a validation warning.\" },\n        options: { type: \"object\", description: \"Create options. title and description are required.\" },\n      },\n      [\"options\"],\n    ),\n  },\n  {\n    name: \"pm_copy\",\n    description:\n      \"Copy an existing pm item into a new id while resetting lifecycle fields. \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields array.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        fullChangedFields: { type: \"boolean\", description: \"Return full changed_fields instead of changed_field_count.\" },\n        options: { type: \"object\", description: \"Copy options such as title override, author, and message.\" },\n      },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_update\",\n    description:\n      \"Update pm item metadata/body/dependencies/log seeds natively. \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields delta.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        fullChangedFields: { type: \"boolean\", description: \"Return full changed_fields instead of changed_field_count.\" },\n        options: { type: \"object\" },\n      },\n      [\"id\", \"options\"],\n    ),\n  },\n  {\n    name: \"pm_append\",\n    description:\n      \"Append markdown text to a pm item body and write pm history. Useful for seeding evidence/log entries before close. \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields array.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        body: {\n          type: \"string\",\n          description: \"Markdown text to append to the item body. Required here or as options.body.\",\n        },\n        fullChangedFields: { type: \"boolean\", description: \"Return full changed_fields instead of changed_field_count.\" },\n        options: { type: \"object\", description: \"Append options such as body, author, and message.\" },\n      },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_claim\",\n    description: \"Claim a pm item.\",\n    inputSchema: objectSchema({ id: idSchema, force: { type: \"boolean\" }, options: { type: \"object\" } }, [\"id\"]),\n  },\n  {\n    name: \"pm_release\",\n    description: \"Release a pm item claim.\",\n    inputSchema: objectSchema({ id: idSchema, force: { type: \"boolean\" }, options: { type: \"object\" } }, [\"id\"]),\n  },\n  {\n    name: \"pm_close\",\n    description:\n      \"Close a pm item with optional close reason and optional close validation (reason requirement follows governance settings). \" +\n      \"Output is compact by default (changed_fields replaced with changed_field_count); pass fullChangedFields=true for the full changed_fields array.\",\n    inputSchema: objectSchema(\n      {\n        id: idSchema,\n        reason: { type: \"string\", description: \"Close reason text when provided or required by governance settings.\" },\n        duplicateOf: { type: \"string\", description: \"Canonical item id when closing this item as a duplicate.\" },\n        fullChangedFields: { type: \"boolean\", description: \"Return full changed_fields instead of changed_field_count.\" },\n        idOnly: { type: \"boolean\", description: \"Return only id and status.\" },\n        options: { type: \"object\" },\n      },\n      [\"id\"],\n    ),\n  },\n  {\n    name: \"pm_comments\",\n    description:\n      \"List or add comments on a pm item. Use options.add to append. \" +\n      \"List calls default to the most recent 20 comments with total_count/has_more metadata for token efficiency. \" +\n      \"Pass options.limit=N to choose a page size, options.limit=0 for summary-only metadata, or options.full=true for full history.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\"id\"]),\n  },\n  {\n    name: \"pm_files\",\n    description: \"List, add, remove, audit, or validate linked files for a pm item.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\"id\"]),\n  },\n  {\n    name: \"pm_docs\",\n    description: \"List, add, or remove linked docs for a pm item.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\"id\"]),\n  },\n  {\n    name: \"pm_notes\",\n    description:\n      \"List or add structured notes on a pm item. Use options.add to append a note; omit it to list existing notes.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\"id\"]),\n  },\n  {\n    name: \"pm_learnings\",\n    description:\n      \"List or add learnings on a pm item. Use options.add to capture a learning/insight; omit it to list existing learnings.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\"id\"]),\n  },\n  {\n    name: \"pm_deps\",\n    description:\n      \"List, add, or remove dependencies for a pm item. Use options.add to declare a dependency and options.remove to drop one; omit both to list current dependencies.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\"id\"]),\n  },\n  {\n    name: \"pm_test\",\n    description: \"List, add, remove, or run linked tests for a pm item.\",\n    inputSchema: objectSchema({ id: idSchema, options: { type: \"object\" } }, [\"id\"]),\n  },\n  {\n    name: \"pm_validate\",\n    description: \"Run pm validation checks.\",\n    inputSchema: objectSchema({ options: { type: \"object\" } }),\n  },\n  {\n    name: \"pm_health\",\n    description: \"Run pm health diagnostics. Pass options.brief=true for compact low-token details, options.skipIntegrity=true, options.skipDrift=true, options.skipVectors=true for a fast status-only check, or options.full=true for the complete deep check.\",\n    inputSchema: objectSchema({ options: { type: \"object\" } }),\n  },\n  {\n    name: \"pm_contracts\",\n    description: \"Inspect pm command, flag, schema, and availability contracts.\",\n    inputSchema: objectSchema({ options: { type: \"object\" } }),\n  },\n  {\n    name: \"pm_schema\",\n    description:\n      \"Inspect or modify the workspace item-type/status schema (pm schema). \" +\n      \"subcommand selects the operation; name carries the item type name (show/add-type/remove-type) or status id (show-status/add-status/remove-status). \" +\n      \"Schema mutations write workspace config files, not item history.\",\n    inputSchema: objectSchema(\n      {\n        subcommand: {\n          type: \"string\",\n          enum: [\"list\", \"show\", \"show-status\", \"add-type\", \"remove-type\", \"add-status\", \"remove-status\"],\n          description: \"Schema subcommand to run.\",\n        },\n        name: {\n          type: \"string\",\n          description:\n            \"Item type name for show/add-type/remove-type, or status id for show-status/add-status/remove-status. Required for every subcommand except list.\",\n        },\n        description: {\n          type: \"string\",\n          description: \"Custom item type or status description for add-type/add-status.\",\n        },\n        defaultStatus: { type: \"string\", description: \"Default status for add-type.\" },\n        folder: { type: \"string\", description: \"Storage folder for add-type.\" },\n        alias: {\n          type: \"array\",\n          items: { type: \"string\" },\n          description: \"Aliases for add-type/add-status.\",\n        },\n        role: {\n          type: \"array\",\n          items: { type: \"string\", enum: [...RUNTIME_STATUS_ROLE_VALUES] },\n          description: `Lifecycle roles for add-status: ${RUNTIME_STATUS_ROLE_VALUES.join(\", \")}.`,\n        },\n        order: { type: \"number\", description: \"Display/sort order for add-status.\" },\n        force: { type: \"boolean\", description: \"Override removal guardrails for destructive schema changes when supported.\" },\n        options: { type: \"object\", description: \"Additional schema options using camelCase keys.\" },\n      },\n      [\"subcommand\"],\n    ),\n  },\n  {\n    name: \"pm_config\",\n    description:\n      \"Read or write pm workspace configuration (pm config). \" +\n      \"configAction selects get/set/list/export; key/value address a single setting for get/set. \" +\n      \"scope chooses the project (default) or global settings file.\",\n    inputSchema: objectSchema(\n      {\n        configAction: {\n          type: \"string\",\n          enum: [\"get\", \"set\", \"list\", \"export\"],\n          description: \"Config operation to perform. get/set require key; list/export dump the resolved settings surface.\",\n        },\n        key: {\n          type: \"string\",\n          description:\n            \"Settings key for get/set, for example governance-require-close-reason, telemetry-tracking, or a nested leaf such as search_provider (dash and underscore variants accepted; configAction=get without a key lists supported keys in the error).\",\n        },\n        value: { type: \"string\", description: \"New value for configAction=set.\" },\n        scope: {\n          type: \"string\",\n          enum: [\"project\", \"global\"],\n          description: \"Settings scope to read or write. Defaults to project.\",\n        },\n        options: {\n          type: \"object\",\n          description: \"Additional config options such as criterion, clearCriteria, format, or policy.\",\n        },\n      },\n      [\"configAction\"],\n    ),\n  },\n  {\n    name: \"pm_plan\",\n    description:\n      \"Run agent-optimized Plan workflows. options.subcommand selects: create|show|add-step|update-step|complete-step|block-step|reorder-step|remove-step|link|unlink|decision|discovery|validation|resume|approve|materialize. Provide id for all non-create subcommands; provide stepRef for step lifecycle subcommands. Plans store agent-readable steps with dependencies, decisions, discoveries, validation, and resume context.\",\n    inputSchema: objectSchema({\n      id: { type: \"string\", description: \"Plan id (required for all subcommands except create).\" },\n      stepRef: { type: \"string\", description: \"Step id or order for step lifecycle subcommands.\" },\n      reorderTo: { type: \"number\", description: \"New order for reorder-step.\" },\n      options: { type: \"object\", description: \"Plan options including subcommand, stepRef, stepStatus, link, depth, etc.\" },\n    }),\n  },\n];\n\n/**\n * Stable projection of one MCP tool definition for the contract golden file\n * (pm-4os2): tool name, description, required top-level fields, and the full\n * inputSchema shape. Any drift (typo'd property, dropped required field,\n * changed TOOL_SCHEMA_BASE) shows up in `pnpm contracts:check`.\n */\nexport interface McpToolContract {\n  name: string;\n  description: string;\n  required: string[];\n  input_schema: Record<string, unknown>;\n}\n\nexport function buildMcpToolContracts(): McpToolContract[] {\n  return TOOLS.map((tool) => {\n    const schemaRequired = tool.inputSchema[\"required\"];\n    const required = Array.isArray(schemaRequired)\n      ? schemaRequired.map((entry) => String(entry)).sort((left, right) => left.localeCompare(right))\n      : [];\n    return {\n      name: tool.name,\n      description: tool.description,\n      required,\n      input_schema: tool.inputSchema,\n    };\n  }).sort((left, right) => left.name.localeCompare(right.name));\n}\n"],"names":[],"mappings":"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","debugId":"6101f461-4390-5960-ae47-ed875ff3ee06"}

package/docs/AGENT_GUIDE.md

@@ -133,7 +133,7 @@ Default TOON output is preferred for model-readable loops. Use `--json` only whe
 
 `list`/`search` compact mode is intentionally token-light: it returns compact items plus only active filters (and runtime schema filters when present), omitting default projection/sorting/now trailer metadata.
 
-Over MCP the mutation tools (`pm_create`/`pm_update`/`pm_close`, and `pm_run` for `append`/`update-many`) are already compact by default: they return `changed_field_count` instead of the full `changed_fields` array. Pass `fullChangedFields=true` only when you need the explicit field-level delta, or `idOnly=true` for single-item id/status output.
+Over MCP the mutation tools (`pm_create`/`pm_update`/`pm_append`/`pm_close`, and `pm_run` for `update-many`) are already compact by default: they return `changed_field_count` instead of the full `changed_fields` array. Pass `fullChangedFields=true` only when you need the explicit field-level delta, or `idOnly=true` for single-item id/status output.
 
 `pm create --parent <id>` fails fast when the parent cannot be found. Use `--allow-missing-parent` only for deliberate imports or staged backlog reconstruction.
 

package/docs/CLAUDE_CODE_PLUGIN.md

@@ -65,7 +65,7 @@ This clones the repo, reads `.claude-plugin/marketplace.json` at the root, insta
 claude mcp add --transport stdio pm-mcp -- npx -y --package=@unbrained/pm-cli@latest pm-mcp
 ```
 
-Gives you the 22 MCP tools without skills or slash commands.
+Gives you the 25 MCP tools without skills or slash commands.
 
 ### 3. Direct project `.mcp.json` (project-scoped MCP only)
 
@@ -123,7 +123,7 @@ node scripts/smoke-claude-plugin.mjs
 pnpm smoke:claude-plugin
 ```
 
-Verifies: plugin file structure, manifest name consistency, MCP initialize, 22 tools present, full workflow (init → create → claim → update → link files/docs/tests → get → context → search → validate → health), and session-start hook.
+Verifies: plugin file structure, manifest name consistency, MCP initialize, 25 tools present, full workflow (init → create → claim → update → link files/docs/tests → get → context → search → validate → health), and session-start hook.
 
 ### MCP server smoke test
 

package/docs/COMMANDS.md

@@ -280,6 +280,7 @@ Linked files and docs keep reviews reproducible. `deps` is read-only and project
 
 ```bash
 pm test <id> --add command="node scripts/run-tests.mjs test -- tests/unit/output.spec.ts",timeout_seconds=240
+pm test <id> --add command "node scripts/run-tests.mjs test -- tests/unit/output.spec.ts"
 pm test <id> --add-json '{"command":"node scripts/run-tests.mjs test -- tests/unit/output.spec.ts","timeout_seconds":240}'
 pm test <id> --run --progress
 pm test <id> --run --match output
@@ -288,7 +289,7 @@ pm test <id> --run --only-last
 pm test-all --status in_progress --progress
 ```
 
-Linked test commands should be sandbox-safe. Prefer `node scripts/run-tests.mjs ...` because it sets temporary `PM_PATH` and `PM_GLOBAL_PATH`. Use `--add-json` when command strings contain commas, nested quotes, shell variables, or `--` separators that are awkward to preserve through CSV-style `--add` parsing. `--match`, `--only-index`, and `--only-last` select which linked tests execute without mutating the stored linked-test list.
+Linked test commands should be sandbox-safe. Prefer `node scripts/run-tests.mjs ...` because it sets temporary `PM_PATH` and `PM_GLOBAL_PATH`. The two-token form `--add command "npm test -- parser"` (and `--add path "..."` / `--remove command "..."`) is accepted when the value is quoted into a single shell argument; it is normalized to `--add command=...` before parsing. Use `--add-json` when command strings contain commas, nested quotes, shell variables, or `--` separators that are awkward to preserve through CSV-style `--add` parsing. `--match`, `--only-index`, and `--only-last` select which linked tests execute without mutating the stored linked-test list.
 
 Strict linked-test guards:
 

package/marketplace.json

@@ -12,7 +12,7 @@
     {
       "name": "pm-claude",
       "source": "./plugins/pm-claude",
-      "description": "Native pm CLI integration for Claude Code — 22 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
+      "description": "Native pm CLI integration for Claude Code — 25 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
       "version": "1.4.0",
       "author": {
         "name": "unbrained",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.6.10",
+  "version": "2026.6.11",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "author": "unbrained",

package/plugins/pm-claude/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-claude",
-  "description": "Native pm CLI integration for Claude Code — 22 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents (coordinator, delivery-chain, triage, verification), hybrid TUI task tracking (pm as persistent store + Claude Code task panel as live view), session context injection, and full git-based project management without leaving Claude Code.",
+  "description": "Native pm CLI integration for Claude Code — 25 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents (coordinator, delivery-chain, triage, verification), hybrid TUI task tracking (pm as persistent store + Claude Code task panel as live view), session context injection, and full git-based project management without leaving Claude Code.",
   "version": "1.4.0",
   "author": {
     "name": "unbrained",

package/plugins/pm-claude/README.md

@@ -6,7 +6,7 @@ Native pm CLI integration for Claude Code. Use pm project management tools direc
 
 | Component | What it provides |
 |-----------|----------------|
-| **22 MCP tools** | Full pm surface: context, search, list, get, create, copy, update, claim, release, close, comments, files, docs, notes, learnings, deps, test, validate, health, contracts, plan + `pm_run` for everything else |
+| **25 MCP tools** | Full pm surface: context, search, list, get, create, copy, update, claim, release, close, comments, files, docs, notes, learnings, deps, test, validate, health, contracts, plan, append, schema, config + `pm_run` for everything else |
 | **5 skills** | `pm-workflow`, `pm-developer`, `pm-release`, `pm-audit`, `pm-planner` — auto-loaded as Claude Code skills |
 | **14 slash commands** | Full lifecycle coverage — status, start, close, triage, audit, search, new, list, calendar, developer, planner, release, workflow, init |
 | **4 subagents** | `pm-coordinator` (batch/multi-item), `pm-triage-agent` (duplicate-safe item creation), `pm-verification-agent` (evidence + close readiness), and `pm-delivery-chain` (orchestrated delivery) |
@@ -29,7 +29,7 @@ claude plugin marketplace add /path/to/pm-cli
 # claude plugin marketplace add unbraind/pm-cli
 ```
 
-This installs all 22 MCP tools, 5 skills, 14 slash commands, 4 subagents, hybrid TUI tracking, and the session hook in one step.
+This installs all 25 MCP tools, 5 skills, 14 slash commands, 4 subagents, hybrid TUI tracking, and the session hook in one step.
 
 ### Option B: Legacy marketplace alias (also works)
 
@@ -45,7 +45,7 @@ Both `pm` and `pm-cli` marketplace IDs resolve to the same plugin.
 claude mcp add --transport stdio pm-mcp -- npx -y --package=@unbrained/pm-cli@latest pm-mcp
 ```
 
-This gives you the 22 MCP tools but not the skills, slash commands, or session hook.
+This gives you the 25 MCP tools but not the skills, slash commands, or session hook.
 
 ### Option D: Direct `.mcp.json` (project-scoped MCP only)
 
@@ -152,7 +152,9 @@ Spawn pm-triage-agent to set up the pm item for: add OAuth2 login support
 | `pm_list` | Filtered item list |
 | `pm_get` | Single item detail |
 | `pm_create` | Create new item |
+| `pm_copy` | Copy item into a new id |
 | `pm_update` | Update metadata |
+| `pm_append` | Append text to item body |
 | `pm_claim` | Claim for active work |
 | `pm_release` | Release claim |
 | `pm_close` | Close with reason |
@@ -166,6 +168,8 @@ Spawn pm-triage-agent to set up the pm item for: add OAuth2 login support
 | `pm_validate` | Run validation checks |
 | `pm_health` | Run health diagnostics |
 | `pm_contracts` | Inspect command contracts |
+| `pm_schema` | Manage custom item types/statuses |
+| `pm_config` | Read or write settings keys |
 | `pm_plan` | Manage durable Plan workflows |
 
 ### General tool

package/plugins/pm-claude/commands/pm-init.md

@@ -47,7 +47,7 @@ Initialize pm project tracking using native MCP tools. Argument: `$ARGUMENTS` (o
    - pm initialized at `.agents/pm/`
    - guidance mode defaults to `ask` (TTY prompt only); use `agentGuidance=add|skip|status` in `pm_run` options for deterministic behavior
    - Available slash commands: `/pm-status`, `/pm-new`, `/pm-start-task`, `/pm-close-task`, `/pm-list`, `/pm-search`, `/pm-triage`, `/pm-calendar`, `/pm-developer`, `/pm-planner`, `/pm-release`, `/pm-audit`, `/pm-workflow`
-   - All 22 MCP tools available: `pm_context`, `pm_search`, `pm_list`, `pm_get`, `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`, `pm_run`
+   - All 25 MCP tools available: `pm_context`, `pm_search`, `pm_list`, `pm_get`, `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`, `pm_run`
    - Next: use `/pm-new <title>` to create your first item, or `/pm-status` to see the tracker state
 
 If initialization fails, report the error and suggest running `pm init` manually in the terminal.

package/plugins/pm-codex/README.md

@@ -21,9 +21,9 @@ For a published package install, keep `@unbrained/pm-cli` available through npm.
 
 ## Native Tools
 
-Prefer the narrow tools when they match the task: `pm_context`, `pm_search`, `pm_list`, `pm_get`, `pm_create`, `pm_update`, `pm_claim`, `pm_release`, `pm_close`, `pm_comments`, `pm_files`, `pm_docs`, `pm_test`, `pm_validate`, `pm_health`, `pm_contracts`, and `pm_plan`.
+Prefer the narrow tools when they match the task: `pm_context`, `pm_search`, `pm_list`, `pm_get`, `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`, and `pm_plan`.
 
-Use `pm_run` for the remaining pm surface. Supported actions include `init`, `calendar`, `activity`, `aggregate`, `dedupe-audit`, `normalize`, `reindex`, `extension`, `history`, `history-redact`, `plan`, `stats`, `append`, `notes`, `learnings`, `test-all`, `comments-audit`, `gc`, templates, and test-runs controls.
+Use `pm_run` for the remaining pm surface. Supported actions include `init`, `calendar`, `activity`, `aggregate`, `dedupe-audit`, `normalize`, `reindex`, `extension`, `history`, `history-redact`, `stats`, `test-all`, `comments-audit`, `gc`, templates, and test-runs controls.
 
 `pm_plan` exposes Codex-style ExecPlans as a first-class `Plan` item type with ordered steps, evidence, decisions, discoveries, validation, and materialization. See the `pm-native` skill for the full Plan workflow recipe.
 For `init` automation, pass `options.agentGuidance` (`ask|add|skip|status`) when you need deterministic AGENTS/CLAUDE guidance behavior in non-interactive runs.

package/dist/cli-bundle/chunks/activity-5QLX6DHN.js

@@ -1,16 +0,0 @@
-import {
-  runActivity
-} from "./chunk-D6JZBUZ6.js";
-import "./chunk-WBU257Z4.js";
-import "./chunk-TXWMLDMG.js";
-import "./chunk-TV6FZGVK.js";
-import "./chunk-XRE4CTNP.js";
-import "./chunk-I2FM2SMO.js";
-import "./chunk-Q6PSD5DZ.js";
-import "./chunk-7GYMMDDW.js";
-import "./chunk-7TW64BS5.js";
-import "./chunk-OQGJSCZZ.js";
-export {
-  runActivity
-};
-//# sourceMappingURL=activity-5QLX6DHN.js.map