@unbrained/pm-cli 2026.6.9 → 2026.6.11

package/dist/core/test/run-selectors.js

@@ -0,0 +1,110 @@
+
+!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]="89480c78-9cf5-55e5-a881-aaa130d9c509")}catch(e){}}();
+import { EXIT_CODE } from "../shared/constants.js";
+import { PmCliError } from "../shared/errors.js";
+const MAX_SELECTOR_ENTRY_LABEL_LENGTH = 100;
+export function parseOnlyIndexValue(raw, optionName = "--only-index") {
+    const value = typeof raw === "number" ? raw : Number(String(raw).trim());
+    if (!Number.isInteger(value) || value < 1) {
+        throw new PmCliError(`${optionName} requires a 1-based integer index into the linked-test list (got "${raw}"). Use pm test <id> --list to inspect positions.`, EXIT_CODE.USAGE);
+    }
+    return value;
+}
+function summarizeSelectorEntry(entry) {
+    const label = entry.command ?? entry.path ?? "<no command>";
+    const normalized = label.replaceAll(/\s+/g, " ").trim() || "<no command>";
+    if (normalized.length <= MAX_SELECTOR_ENTRY_LABEL_LENGTH) {
+        return normalized;
+    }
+    return `${normalized.slice(0, MAX_SELECTOR_ENTRY_LABEL_LENGTH - 3)}...`;
+}
+export function describeLinkedTestEntries(tests) {
+    return tests.map((entry, index) => `${index + 1}. ${summarizeSelectorEntry(entry)}`).join("; ");
+}
+function activeSelectorKinds(selector) {
+    const kinds = [];
+    if (selector.match !== undefined) {
+        kinds.push("match");
+    }
+    if (selector.onlyIndex !== undefined) {
+        kinds.push("only-index");
+    }
+    if (selector.onlyLast === true) {
+        kinds.push("only-last");
+    }
+    return kinds;
+}
+function entryMatchesSubstring(entry, needle) {
+    const command = entry.command?.toLowerCase() ?? "";
+    const entryPath = entry.path?.toLowerCase() ?? "";
+    return command.includes(needle) || entryPath.includes(needle);
+}
+export function resolveLinkedTestRunSelection(tests, selector) {
+    const kinds = activeSelectorKinds(selector);
+    if (kinds.length === 0) {
+        return {
+            selector: null,
+            requested: null,
+            selected: tests,
+            selected_indexes: tests.map((_, index) => index + 1),
+            selected_count: tests.length,
+            skipped_count: 0,
+        };
+    }
+    if (kinds.length > 1) {
+        throw new PmCliError(`Combine at most one linked-test selector per run: ${kinds.map((kind) => `--${kind}`).join(" and ")} were provided. Pick one of --match, --only-index, --only-last.`, EXIT_CODE.USAGE);
+    }
+    const kind = kinds[0];
+    if (tests.length === 0) {
+        throw new PmCliError(`--${kind} matched no linked tests because this item has none. Add one first with --add, --command, or --add-json.`, EXIT_CODE.USAGE);
+    }
+    if (kind === "match") {
+        const needle = (selector.match ?? "").trim().toLowerCase();
+        if (needle.length === 0) {
+            throw new PmCliError("--match requires a non-empty substring to match against linked-test command/path values", EXIT_CODE.USAGE);
+        }
+        const selectedIndexes = [];
+        const selected = [];
+        for (let index = 0; index < tests.length; index += 1) {
+            if (entryMatchesSubstring(tests[index], needle)) {
+                selected.push(tests[index]);
+                selectedIndexes.push(index + 1);
+            }
+        }
+        if (selected.length === 0) {
+            throw new PmCliError(`--match "${selector.match}" matched none of the ${tests.length} linked test(s). Available entries: ${describeLinkedTestEntries(tests)}`, EXIT_CODE.USAGE);
+        }
+        return {
+            selector: "match",
+            requested: selector.match ?? "",
+            selected,
+            selected_indexes: selectedIndexes,
+            selected_count: selected.length,
+            skipped_count: tests.length - selected.length,
+        };
+    }
+    if (kind === "only-index") {
+        const index = parseOnlyIndexValue(selector.onlyIndex);
+        if (index > tests.length) {
+            throw new PmCliError(`--only-index ${index} is out of range: this item has ${tests.length} linked test(s). Available entries: ${describeLinkedTestEntries(tests)}`, EXIT_CODE.USAGE);
+        }
+        return {
+            selector: "only-index",
+            requested: String(index),
+            selected: [tests[index - 1]],
+            selected_indexes: [index],
+            selected_count: 1,
+            skipped_count: tests.length - 1,
+        };
+    }
+    return {
+        selector: "only-last",
+        requested: "last",
+        selected: [tests[tests.length - 1]],
+        selected_indexes: [tests.length],
+        selected_count: 1,
+        skipped_count: tests.length - 1,
+    };
+}
+//# sourceMappingURL=run-selectors.js.map
+//# debugId=89480c78-9cf5-55e5-a881-aaa130d9c509

package/dist/core/test/run-selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-selectors.js","sources":["core/test/run-selectors.ts"],"sourceRoot":"/","sourcesContent":["import { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport type { LinkedTest } from \"../../types.js\";\n\n/**\n * Pure selection logic for `pm test --run` selectors (pm-p86h / GitHub #194).\n *\n * Selectors pick WHICH linked tests execute without mutating item metadata:\n * - `--match <substring>`: case-insensitive substring on command/path.\n * - `--only-index <n>`: 1-based index into the `--list` order.\n * - `--only-last`: most recently added entry (last in `--list` order).\n */\n\nexport type LinkedTestSelectorKind = \"match\" | \"only-index\" | \"only-last\";\n\nexport interface LinkedTestRunSelector {\n  match?: string;\n  onlyIndex?: number;\n  onlyLast?: boolean;\n}\n\nexport interface LinkedTestRunSelection {\n  selector: LinkedTestSelectorKind | null;\n  requested: string | null;\n  selected: LinkedTest[];\n  /** 1-based positions of selected entries in the original `--list` order. */\n  selected_indexes: number[];\n  selected_count: number;\n  skipped_count: number;\n}\n\nconst MAX_SELECTOR_ENTRY_LABEL_LENGTH = 100;\n\nexport function parseOnlyIndexValue(raw: string | number, optionName = \"--only-index\"): number {\n  const value = typeof raw === \"number\" ? raw : Number(String(raw).trim());\n  if (!Number.isInteger(value) || value < 1) {\n    throw new PmCliError(\n      `${optionName} requires a 1-based integer index into the linked-test list (got \"${raw}\"). Use pm test <id> --list to inspect positions.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return value;\n}\n\nfunction summarizeSelectorEntry(entry: LinkedTest): string {\n  const label = entry.command ?? entry.path ?? \"<no command>\";\n  const normalized = label.replaceAll(/\\s+/g, \" \").trim() || \"<no command>\";\n  if (normalized.length <= MAX_SELECTOR_ENTRY_LABEL_LENGTH) {\n    return normalized;\n  }\n  return `${normalized.slice(0, MAX_SELECTOR_ENTRY_LABEL_LENGTH - 3)}...`;\n}\n\nexport function describeLinkedTestEntries(tests: LinkedTest[]): string {\n  return tests.map((entry, index) => `${index + 1}. ${summarizeSelectorEntry(entry)}`).join(\"; \");\n}\n\nfunction activeSelectorKinds(selector: LinkedTestRunSelector): LinkedTestSelectorKind[] {\n  const kinds: LinkedTestSelectorKind[] = [];\n  if (selector.match !== undefined) {\n    kinds.push(\"match\");\n  }\n  if (selector.onlyIndex !== undefined) {\n    kinds.push(\"only-index\");\n  }\n  if (selector.onlyLast === true) {\n    kinds.push(\"only-last\");\n  }\n  return kinds;\n}\n\nfunction entryMatchesSubstring(entry: LinkedTest, needle: string): boolean {\n  const command = entry.command?.toLowerCase() ?? \"\";\n  const entryPath = entry.path?.toLowerCase() ?? \"\";\n  return command.includes(needle) || entryPath.includes(needle);\n}\n\nexport function resolveLinkedTestRunSelection(tests: LinkedTest[], selector: LinkedTestRunSelector): LinkedTestRunSelection {\n  const kinds = activeSelectorKinds(selector);\n  if (kinds.length === 0) {\n    return {\n      selector: null,\n      requested: null,\n      selected: tests,\n      selected_indexes: tests.map((_, index) => index + 1),\n      selected_count: tests.length,\n      skipped_count: 0,\n    };\n  }\n  if (kinds.length > 1) {\n    throw new PmCliError(\n      `Combine at most one linked-test selector per run: ${kinds.map((kind) => `--${kind}`).join(\" and \")} were provided. Pick one of --match, --only-index, --only-last.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  const kind = kinds[0];\n  if (tests.length === 0) {\n    throw new PmCliError(\n      `--${kind} matched no linked tests because this item has none. Add one first with --add, --command, or --add-json.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (kind === \"match\") {\n    const needle = (selector.match ?? \"\").trim().toLowerCase();\n    if (needle.length === 0) {\n      throw new PmCliError(\"--match requires a non-empty substring to match against linked-test command/path values\", EXIT_CODE.USAGE);\n    }\n    const selectedIndexes: number[] = [];\n    const selected: LinkedTest[] = [];\n    for (let index = 0; index < tests.length; index += 1) {\n      if (entryMatchesSubstring(tests[index], needle)) {\n        selected.push(tests[index]);\n        selectedIndexes.push(index + 1);\n      }\n    }\n    if (selected.length === 0) {\n      throw new PmCliError(\n        `--match \"${selector.match}\" matched none of the ${tests.length} linked test(s). Available entries: ${describeLinkedTestEntries(tests)}`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      selector: \"match\",\n      requested: selector.match ?? \"\",\n      selected,\n      selected_indexes: selectedIndexes,\n      selected_count: selected.length,\n      skipped_count: tests.length - selected.length,\n    };\n  }\n  if (kind === \"only-index\") {\n    const index = parseOnlyIndexValue(selector.onlyIndex as number);\n    if (index > tests.length) {\n      throw new PmCliError(\n        `--only-index ${index} is out of range: this item has ${tests.length} linked test(s). Available entries: ${describeLinkedTestEntries(tests)}`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      selector: \"only-index\",\n      requested: String(index),\n      selected: [tests[index - 1]],\n      selected_indexes: [index],\n      selected_count: 1,\n      skipped_count: tests.length - 1,\n    };\n  }\n  return {\n    selector: \"only-last\",\n    requested: \"last\",\n    selected: [tests[tests.length - 1]],\n    selected_indexes: [tests.length],\n    selected_count: 1,\n    skipped_count: tests.length - 1,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"89480c78-9cf5-55e5-a881-aaa130d9c509"}

package/dist/mcp/server.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3919b575-b5c2-5bb1-91d7-5c736d48c59e")}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]="5d14434e-fc25-502b-9aa8-8efd7ab7fd6a")}catch(e){}}();
 import readline from "node:readline";
 import { fileURLToPath } from "node:url";
 import { createEmptyExtensionCommandRegistry, createEmptyExtensionHookRegistry, createEmptyExtensionParserRegistry, createEmptyExtensionPreflightRegistry, createEmptyExtensionRegistrationRegistry, createEmptyExtensionRendererRegistry, createEmptyExtensionServiceRegistry, } from "../core/extensions/extension-registries.js";
@@ -8,6 +8,7 @@ import { activateExtensions, deactivateExtensions, loadExtensions, runActiveComm
 import { pathExists } from "../core/fs/fs-utils.js";
 import { resolvePmCliVersion } from "../core/packages/root.js";
 import { projectMutationResult } from "../core/output/mutation-projection.js";
+import { withQuerySummary } from "../core/output/query-summary.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { decodeHtmlEntitiesInOptions } from "../core/shared/html-entity-decode.js";
 import { levenshteinDistanceWithinLimit } from "../core/shared/levenshtein.js";
@@ -17,7 +18,8 @@ import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
 import { normalizeListOptions, normalizeUpdateOptions } from "../cli/registration-helpers.js";
 import { UPDATE_COMMANDER_STRING_OPTION_CONTRACTS } from "../sdk/cli-contracts/commander-mutation-options.js";
-import { PM_TOOL_ACTIONS } from "../sdk/cli-contracts/enum-contracts.js";
+import { clearWorkspaceContractsCache } from "../sdk/runtime.js";
+import { TOOLS } from "./tool-definitions.js";
 import { runActivity, runAggregate, runAppend, runClaim, runClose, runCloseMany, runComments, runContracts, runContext, runCreate, runCopy, runConfig, runDelete, runDeps, runDocs, runExtension, runFiles, runFilesDiscover, runGc, runGet, runHealth, runHistory, runHistoryCompact, runHistoryRedact, runHistoryRepair, runInit, runLearnings, runList, runNotes, runPlan, runRelease, runSchemaAddStatus, runSchemaAddType, runSchemaList, runSchemaRemoveStatus, runSchemaRemoveType, runSchemaShow, runSchemaShowStatus, runSearch, runStats, runTelemetry, runTest, runTestAll, runUpdate, runUpdateMany, runUpgrade, runValidate, } from "../cli/commands/index.js";
 const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
 function resolvePmPackageRoot() {
@@ -29,249 +31,9 @@ if (typeof process.env[PM_PACKAGE_ROOT_ENV] !== "string" || process.env[PM_PACKA
 // Reflect the real package.json version so agents/telemetry can identify the
 // build serving requests (was hard-coded "1.0.0"; see pm-2nvw).
 const PM_MCP_SERVER_VERSION = resolvePmCliVersion(import.meta.url, ["../.."]) ?? "0.0.0";
-const TOOL_SCHEMA_BASE = {
-    type: "object",
-    properties: {
-        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,
-    };
-}
-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." },
-            subcommand: {
-                type: "string",
-                enum: ["list", "show", "show-status", "add-type", "remove-type", "add-status", "remove-status"],
-                description: "Schema subcommand when action=schema.",
-            },
-            name: {
-                type: "string",
-                description: "Item type name for action=schema show/add-type/remove-type, or status id for show-status/add-status/remove-status.",
-            },
-            description: {
-                type: "string",
-                description: "Custom item type or status description for action=schema add-type/add-status.",
-            },
-            defaultStatus: { type: "string", description: "Default status for action=schema add-type." },
-            folder: { type: "string", description: "Storage folder for action=schema add-type." },
-            alias: {
-                type: "array",
-                items: { type: "string" },
-                description: "Aliases for action=schema add-type/add-status.",
-            },
-            role: {
-                type: "array",
-                items: { type: "string" },
-                description: "Lifecycle roles for action=schema add-status: draft, active, blocked, terminal, terminal_done, terminal_canceled, default_open, default_close, default_cancel.",
-            },
-            order: { type: "number", description: "Display/sort order for action=schema add-status." },
-            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.",
-            },
-        }, ["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).",
-        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.",
-        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." },
-            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_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." },
-            fullChangedFields: { type: "boolean", description: "Return full changed_fields instead of changed_field_count." },
-            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_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." },
-        }),
-    },
-];
+// Tool definitions (TOOLS) live in ./tool-definitions.ts so the `pm contracts`
+// golden-file snapshot can import the surface without loading the server
+// runtime (pm-4os2). This file owns dispatch, normalization, and transport.
 // pm-qxwu: TOOL_SCHEMA_BASE keeps additionalProperties:true so legitimate
 // passthrough keeps working, which means a typo'd top-level arg (e.g.
 // "fullChangedField" missing the trailing "s") is silently swallowed and the
@@ -364,7 +126,7 @@ function globalOptions(args) {
         noPager: true,
     };
 }
-const ARRAY_TO_CSV_FIELDS = new Set(["tags", "blockedBy", "blocked_by", "skills"]);
+const ARRAY_TO_CSV_FIELDS = new Set(["tags", "blockedBy", "blocked_by", "skills", "fields"]);
 const SCALAR_TO_ARRAY_FIELDS = new Set([
     "comment",
     "note",
@@ -441,6 +203,19 @@ function optionsWithAuthor(args, action) {
         hoistKey("priority");
         hoistKey("limit");
     }
+    else if (action === "create") {
+        hoistKey("allowMissingParent");
+    }
+    else if (action === "close") {
+        hoistKey("duplicateOf");
+    }
+    else if (action === "append") {
+        // pm-7u9j: the narrow pm_append tool declares `body` top-level; runAppend
+        // reads it from options, so hoist unless options.body already wins.
+        // (pm_schema/pm_config top-level args are consumed directly by runAction's
+        // schema/config cases, which read args before options — no hoist needed.)
+        hoistKey("body");
+    }
     const options = normalizeMcpOptionsArrays({ ...hoistedTopLevel, ...baseOptions }, action);
     const author = readString(args, "author");
     return author && options.author === undefined ? { ...options, author } : options;
@@ -481,6 +256,18 @@ function extensionOptionsFromArgs(args, options) {
     delete normalizedOptions.args;
     return normalizedOptions;
 }
+// pm-bl6m: runDynamicExtensionAction mutates the process-global active extension
+// registries (set globals -> run handler -> clear globals in a finally). The stdio
+// transport already processes JSON-RPC lines sequentially, but handleRequest is a
+// public entry point (tests, future concurrent transports) — if two native-action
+// requests ever ran concurrently, the newer request would overwrite the globals
+// mid-flight and whichever finished first would clear them out from under the
+// other (its lazily-read hooks/overrides would silently vanish). Serialize the
+// whole activation cycle (load -> activate -> set -> run -> clear -> deactivate)
+// on a dedicated FIFO queue so the critical section can never interleave. Full
+// request-scoped registry plumbing remains possible later if true intra-server
+// concurrency is ever needed.
+const dynamicExtensionActionQueue = createSerialQueue();
 async function runDynamicExtensionAction(action, args, options, global) {
     if (global.noExtensions) {
         throw new PmCliError(`Unsupported native pm action: ${action}`, 64);
@@ -489,6 +276,19 @@ async function runDynamicExtensionAction(action, args, options, global) {
     if (!(await pathExists(getSettingsPath(pmRoot)))) {
         throw new PmCliError(`Unsupported native pm action: ${action}`, 64);
     }
+    return dynamicExtensionActionQueue.enqueue(async () => {
+        try {
+            return await runDynamicExtensionActionExclusively(action, args, options, global, pmRoot);
+        }
+        finally {
+            clearWorkspaceContractsCache();
+        }
+    });
+}
+// Body of the dynamic-action activation cycle. Must only ever run under
+// dynamicExtensionActionQueue (see runDynamicExtensionAction above): it is the
+// exclusive owner of the process-global active extension registries while it runs.
+async function runDynamicExtensionActionExclusively(action, args, options, global, pmRoot) {
     const settings = await readSettings(pmRoot);
     const loadResult = await loadExtensions({
         pmRoot,
@@ -573,7 +373,7 @@ async function withCwd(cwd, run) {
  * are forwarded unchanged so runtime fields named `full` remain valid user data.
  */
 function withMutationCompaction(args, options) {
-    return { changedFields: args.fullChangedFields === true ? "full" : "compact", runnerOptions: { ...(options ?? {}) } };
+    return { changedFields: args.fullChangedFields === true ? "full" : "compact", idOnly: args.idOnly === true, runnerOptions: { ...(options ?? {}) } };
 }
 function mutationListOptions(options) {
     return {
@@ -704,7 +504,9 @@ async function runAction(args) {
                 listOptions.includeBody === undefined) {
                 listOptions.compact = true;
             }
-            return runList(readString(args, "status"), listOptions, global);
+            // pm-rmjy: echo the applied filters + resolved projection mode so agents
+            // get structured confirmation of what the server actually ran.
+            return withQuerySummary((await runList(readString(args, "status"), listOptions, global)), listOptions);
         }
         case "get":
             return runGet(id ?? readRequiredString(options, "id"), global, options);
@@ -715,37 +517,38 @@ async function runAction(args) {
                 searchOptions.fields === undefined) {
                 searchOptions.compact = true;
             }
-            return runSearch(readRequiredString(args, "query"), searchOptions, global);
+            // pm-rmjy: echo the applied filters + resolved projection mode (see list).
+            return withQuerySummary((await runSearch(readRequiredString(args, "query"), searchOptions, global)), searchOptions);
         }
         case "create": {
-            const { changedFields, runnerOptions } = withMutationCompaction(args, options);
-            return projectMutationResult(await runCreate(runnerOptions, global), { changedFields });
+            const { changedFields, idOnly, runnerOptions } = withMutationCompaction(args, options);
+            return projectMutationResult(await runCreate(runnerOptions, global), { changedFields, idOnly });
         }
         case "copy": {
-            const { changedFields, runnerOptions } = withMutationCompaction(args, options);
+            const { changedFields, idOnly, runnerOptions } = withMutationCompaction(args, options);
             const copyOptions = {
                 ...runnerOptions,
                 ...(runnerOptions.title === undefined && typeof args.title === "string" ? { title: args.title } : {}),
                 ...(runnerOptions.message === undefined && typeof args.message === "string" ? { message: args.message } : {}),
                 ...(runnerOptions.author === undefined && typeof args.author === "string" ? { author: args.author } : {}),
             };
-            return projectMutationResult(await runCopy(id ?? readRequiredString(copyOptions, "id"), copyOptions, global), { changedFields });
+            return projectMutationResult(await runCopy(id ?? readRequiredString(copyOptions, "id"), copyOptions, global), { changedFields, idOnly });
         }
         case "update": {
-            const { changedFields, runnerOptions } = withMutationCompaction(args, options);
-            return projectMutationResult(await runUpdate(id ?? readRequiredString(runnerOptions, "id"), runnerOptions, global), { changedFields });
+            const { changedFields, idOnly, runnerOptions } = withMutationCompaction(args, options);
+            return projectMutationResult(await runUpdate(id ?? readRequiredString(runnerOptions, "id"), runnerOptions, global), { changedFields, idOnly });
         }
         case "claim":
             return runClaim(id ?? readRequiredString(options, "id"), force, global, options);
         case "release":
             return runRelease(id ?? readRequiredString(options, "id"), force, global, options);
         case "close": {
-            const { changedFields, runnerOptions } = withMutationCompaction(args, options);
+            const { changedFields, idOnly, runnerOptions } = withMutationCompaction(args, options);
             const closeReason = readString(args, "reason") ??
                 readString(args, "text") ??
                 readString(runnerOptions, "reason") ??
                 readString(runnerOptions, "text");
-            return projectMutationResult(await runClose(id ?? readRequiredString(runnerOptions, "id"), closeReason, runnerOptions, global), { changedFields });
+            return projectMutationResult(await runClose(id ?? readRequiredString(runnerOptions, "id"), closeReason, runnerOptions, global), { changedFields, idOnly });
         }
         case "comments": {
             const commentOptions = { ...options };
@@ -797,8 +600,15 @@ async function runAction(args) {
         }
         case "contracts":
             return runContracts(options, global);
-        case "config":
-            return runConfig(readString(args, "scope") ?? readString(options, "scope") ?? "project", readString(args, "configAction") ?? readRequiredString(options, "action"), readString(args, "key") ?? readString(options, "key"), options, global, readString(args, "value") ?? readString(options, "value"));
+        case "config": {
+            // pm-v68d: the narrow pm_config tool declares configAction top-level;
+            // options.configAction/options.action remain accepted for pm_run parity.
+            const configAction = readString(args, "configAction") ?? readString(options, "configAction") ?? readString(options, "action");
+            if (configAction === undefined) {
+                throw new PmCliError("Missing required argument: configAction", 64);
+            }
+            return runConfig(readString(args, "scope") ?? readString(options, "scope") ?? "project", configAction, readString(args, "key") ?? readString(options, "key"), options, global, readString(args, "value") ?? readString(options, "value"));
+        }
         case "activity": {
             const activityOptions = { ...options };
             if (activityOptions.compact === undefined) {
@@ -962,6 +772,7 @@ const HANDLERS = {
     pm_create: (args) => runAction({ ...args, action: "create" }),
     pm_copy: (args) => runAction({ ...args, action: "copy" }),
     pm_update: (args) => runAction({ ...args, action: "update" }),
+    pm_append: (args) => runAction({ ...args, action: "append" }),
     pm_claim: (args) => runAction({ ...args, action: "claim" }),
     pm_release: (args) => runAction({ ...args, action: "release" }),
     pm_close: (args) => runAction({ ...args, action: "close" }),
@@ -975,6 +786,8 @@ const HANDLERS = {
     pm_validate: (args) => runAction({ ...args, action: "validate" }),
     pm_health: (args) => runAction({ ...args, action: "health" }),
     pm_contracts: (args) => runAction({ ...args, action: "contracts" }),
+    pm_schema: (args) => runAction({ ...args, action: "schema" }),
+    pm_config: (args) => runAction({ ...args, action: "config" }),
     pm_plan: (args) => runAction({ ...args, action: "plan" }),
 };
 function resultContent(result, warnings) {
@@ -1021,9 +834,10 @@ export async function handleRequest(request) {
             serverInfo: { name: "pm-mcp", version: PM_MCP_SERVER_VERSION },
             instructions: "You have access to native pm CLI tools for git-based project management. " +
                 "Use pm_context or pm_search before creating new work. " +
-                "Prefer narrow tools (pm_context, pm_list, pm_get, pm_search, pm_create, pm_copy, pm_update, pm_claim, pm_release, pm_close, pm_comments, pm_files, pm_docs, pm_notes, pm_learnings, pm_deps, pm_test, pm_validate, pm_health, pm_contracts, pm_plan) over pm_run when they cover the operation. " +
+                "Prefer narrow tools (pm_context, pm_list, pm_get, pm_search, pm_create, pm_copy, pm_update, pm_append, pm_claim, pm_release, pm_close, pm_comments, pm_files, pm_docs, pm_notes, pm_learnings, pm_deps, pm_test, pm_validate, pm_health, pm_contracts, pm_schema, pm_config, pm_plan) over pm_run when they cover the operation. " +
                 "Use pm_plan for agent harness Plan workflows: it provides Codex/Claude/Cursor-style planning with durable steps, dependencies, decisions, discoveries, validation, and materialization. " +
-                "Use pm_run with an explicit action for package-owned operations (calendar/templates/guide/dedupe-audit/normalize/reindex/comments-audit/completion/test-runs-list/test-runs-status/test-runs-logs/test-runs-stop/test-runs-resume), plus activity, aggregate, history, stats, append, test-all, and gc. " +
+                "Use pm_schema and pm_config for workspace configuration: pm_schema manages custom item types/statuses and pm_config reads or writes settings keys. " +
+                "Use pm_run with an explicit action for package-owned operations (calendar/templates/guide/dedupe-audit/normalize/reindex/comments-audit/completion/test-runs-list/test-runs-status/test-runs-logs/test-runs-stop/test-runs-resume), plus activity, aggregate, history, stats, test-all, and gc. " +
                 "Use history-redact for audited history-stream redaction workflows, history-repair to re-anchor a drifted history chain, and history-compact to checkpoint/prune long history streams while preserving replay integrity. " +
                 "Set author to 'claude-code-agent' on all mutations. " +
                 "Do not pass path during real repository tracking — only pass path for sandbox or test runs.",
@@ -1119,4 +933,4 @@ if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
     startMcpServer();
 }
 //# sourceMappingURL=server.js.map
-//# debugId=3919b575-b5c2-5bb1-91d7-5c736d48c59e
+//# debugId=5d14434e-fc25-502b-9aa8-8efd7ab7fd6a