@unbrained/pm-cli 2026.6.10 → 2026.6.12

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/dist/sdk/cli-contracts/tool-parameter-tables.js

@@ -1,5 +1,5 @@
 
-!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]="28cc182a-a139-5258-a9c6-5cc6b60e18c3")}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]="94debfc3-fbc8-5417-83a4-05126242aa06")}catch(e){}}();
 import { PLAN_HARNESS_VALUES, PLAN_MODE_VALUES, PLAN_STEP_LINK_KIND_VALUES, PLAN_STEP_STATUS_VALUES, } from "../../types/index.js";
 export const PM_TOOL_PARAMETER_PROPERTIES = {
     json: { type: "boolean", default: true },
@@ -203,6 +203,9 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     strictExit: { type: "boolean" },
     failOnWarn: { type: "boolean" },
     fixHints: { type: "boolean" },
+    autoFix: { type: "boolean" },
+    fixScope: { type: "array", items: { type: "string", enum: ["metadata", "resolution", "lifecycle"] } },
+    pruneMissing: { type: "boolean" },
     checkHistoryDrift: { type: "boolean" },
     checkCommandReferences: { type: "boolean" },
     allowAuditNote: { type: "boolean" },
@@ -212,6 +215,7 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     allowAuditDepUpdate: { type: "boolean" },
     allowAuditRelease: { type: "boolean" },
     dryRun: { type: "boolean" },
+    all: { type: "boolean" },
     cliOnly: { type: "boolean" },
     packagesOnly: { type: "boolean" },
     repair: { type: "boolean" },
@@ -251,6 +255,10 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     discover: { type: "boolean" },
     apply: { type: "boolean" },
     discoveryNote: { type: "string" },
+    // GH-170 (pm-pfnx): single-string note for files/docs add batches (the shared
+    // `note` key below is the array-typed create/update note seed).
+    addNote: { type: "string" },
+    list: { type: "boolean" },
     appendStable: { type: "boolean" },
     validatePaths: { type: "boolean" },
     audit: { type: "boolean" },
@@ -322,6 +330,9 @@ export const PLAN_ACTION_PARAMETER_PROPERTIES = {
     claim: { type: "boolean" },
     fromSearch: { type: "string" },
     stepTitle: { type: "string" },
+    // pm-6mit: ordered step titles for create (string or array; values are never
+    // comma-split). On step subcommands a single value aliases stepTitle.
+    step: { anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }] },
     stepBody: { type: "string" },
     stepOwner: { type: "string" },
     stepStatus: { type: "string", enum: [...PLAN_STEP_STATUS_VALUES] },
@@ -373,6 +384,10 @@ export const PLAN_ACTION_PARAMETER_METADATA = {
         description: "Plan lifecycle mode.",
         examples: ["draft", "research", "approved"],
     },
+    step: {
+        description: "Ordered initial step titles for create (string or array, never comma-split; stepTitle, when also set, becomes the first step). For step subcommands a single value aliases stepTitle.",
+        examples: [["Read the code", "Write the fix", "Run the tests"]],
+    },
     file: {
         description: "File link to attach while creating or materializing a Plan.",
         examples: ["path=src/cli.ts,note=implementation surface"],
@@ -707,6 +722,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
     dryRun: {
         description: "Preview command effects without mutating storage artifacts.",
     },
+    all: {
+        description: "For history-repair action: scan every stream for drift and repair each drifted stream in one audited pass (mutually exclusive with id).",
+    },
     gcScope: {
         description: "Repeatable gc scope selector values (index, embeddings, runtime, locks).",
         examples: [["index", "embeddings"], ["runtime"], ["locks"]],
@@ -821,6 +839,16 @@ export const PM_TOOL_PARAMETER_METADATA = {
     fixHints: {
         description: "For validate action, add a machine-executable fix_hints[] of pm commands to each failing check's details.",
     },
+    autoFix: {
+        description: "For validate action, apply the safe, deterministic subset of fix-hint remediations (field backfills) automatically; combine with dryRun to preview and fixScope to grant gated scopes.",
+    },
+    fixScope: {
+        description: "For validate action, grant --auto-fix scopes (metadata, resolution, lifecycle). Defaults to the safe scopes metadata and resolution; lifecycle must be named explicitly.",
+        examples: [["lifecycle"], ["metadata", "resolution"]],
+    },
+    pruneMissing: {
+        description: "For validate action, remove stale linked-file/doc LINKS whose paths classified as deleted (link removal only — never touches real files); honors dryRun.",
+    },
     checkHistoryDrift: {
         description: "Run item/history hash drift checks.",
     },
@@ -869,6 +897,14 @@ export const PM_TOOL_PARAMETER_METADATA = {
         description: "Note attached to file links added by files discovery.",
         examples: ["discovered from item text"],
     },
+    addNote: {
+        description: "Note attached to every link added by add/addGlob in this call (per-entry embedded note= wins; requires add or addGlob). Maps to the CLI --note flag on pm files/pm docs.",
+        examples: ["command wiring"],
+    },
+    list: {
+        description: "When true for files/docs action, list the current linked paths without mutating them.",
+        examples: [true],
+    },
     stream: {
         description: "Stream selector: test-runs logs accepts stdout|stderr|both; activity accepts boolean/rows|ndjson|jsonl for line-delimited output.",
         examples: ["stderr", "stdout", "both", "rows", "ndjson", "jsonl", true],
@@ -996,4 +1032,4 @@ export const PM_TOOL_PARAMETER_METADATA = {
     },
 };
 //# sourceMappingURL=tool-parameter-tables.js.map
-//# debugId=28cc182a-a139-5258-a9c6-5cc6b60e18c3
+//# debugId=94debfc3-fbc8-5417-83a4-05126242aa06