@unbrained/pm-cli 2026.6.9 → 2026.6.11

package/packages/pm-command-kit/extensions/command-kit/index.js

@@ -0,0 +1,181 @@
+/**
+ * pm-command-kit — first-party exemplar for the `commands` capability surface.
+ *
+ * Demonstrates the three command-facing SDK registration APIs:
+ * 1. `registerCommand` with a FULL CommandDefinition (name, action, description,
+ *    intent, arguments, flags, examples, failure_hints, run).
+ * 2. `registerParser` to preprocess parsed options before the command handler runs.
+ * 3. `registerFlags` to inject an additional flag into an EXISTING command.
+ *
+ * The extension is intentionally pure: no filesystem, network, environment, or
+ * process access — so its manifest declares `sandbox_profile: "strict"` with all
+ * permissions false. Third-party authors can copy this package wholesale and
+ * replace the echo behavior with their own command logic.
+ *
+ * Hand-maintained alongside index.ts: this file is import-free so the extension
+ * stays loadable in extension-only installs without SDK module resolution.
+ */
+export const manifest = {
+  name: "builtin-command-kit",
+  version: "0.1.0",
+  entry: "./index.js",
+  priority: 0,
+  capabilities: ["commands", "schema", "parser"],
+  activation: { commands: ["command-kit echo", "list"] },
+};
+
+export const ECHO_COMMAND = "command-kit echo";
+
+function toPositiveInteger(value, fallback) {
+  const parsed = typeof value === "number" ? value : Number.parseInt(String(value ?? ""), 10);
+  if (!Number.isInteger(parsed) || parsed < 1) {
+    return fallback;
+  }
+  return parsed;
+}
+
+function toDecorationList(value) {
+  const raw = Array.isArray(value) ? value : typeof value === "string" ? value.split(",") : [];
+  const seen = new Set();
+  for (const entry of raw) {
+    const trimmed = String(entry).trim();
+    if (trimmed.length > 0) {
+      seen.add(trimmed);
+    }
+  }
+  return [...seen];
+}
+
+/**
+ * registerParser exemplar: normalize parsed options BEFORE the command handler
+ * runs. Returns a delta — only the keys you set are merged over the parsed
+ * input. Here the deprecated `--shout` alias is rewritten to `--upper`,
+ * `--repeat` is coerced to a positive integer, and `--decorations` values are
+ * trimmed and de-duplicated.
+ *
+ * @param {{ command: string, args: string[], options: Record<string, unknown>, global: Record<string, unknown>, pm_root: string }} context
+ * @returns {{ options: Record<string, unknown> }}
+ */
+export function rewriteEchoOptions(context) {
+  const options = { ...context.options };
+  if (options.shout === true || options.shout === "true") {
+    options.upper = true;
+  }
+  delete options.shout;
+  options.repeat = toPositiveInteger(options.repeat, 1);
+  if (options.decorations !== undefined) {
+    options.decorations = toDecorationList(options.decorations);
+  }
+  return { options };
+}
+
+/**
+ * Command handler: pure compute, structured result rendered by the host.
+ *
+ * @param {{ command: string, args: string[], options: Record<string, unknown>, global: Record<string, unknown>, pm_root: string }} context
+ * @returns {Record<string, unknown>}
+ */
+export function runEchoCommand(context) {
+  const args = Array.isArray(context?.args) ? context.args : [];
+  const options =
+    context?.options && typeof context.options === "object" && !Array.isArray(context.options) ? context.options : {};
+  const message = args
+    .map((arg) => String(arg).trim())
+    .filter((arg) => arg.length > 0)
+    .join(" ");
+  if (message.length === 0) {
+    throw new Error('command-kit echo requires a message argument. Try: pm command-kit echo "hello world".');
+  }
+  const upper = options.upper === true || options.upper === "true";
+  const repeat = toPositiveInteger(options.repeat, 1);
+  const decorations = toDecorationList(options.decorations);
+  const rendered = upper ? message.toUpperCase() : message;
+  return {
+    action: "command-kit-echo",
+    message: rendered,
+    lines: Array.from({ length: repeat }, () => rendered),
+    repeat,
+    upper,
+    decorations,
+  };
+}
+
+const echoFlags = [
+  {
+    long: "--upper",
+    value_type: "boolean",
+    description: "Uppercase the echoed message.",
+  },
+  {
+    long: "--shout",
+    value_type: "boolean",
+    description: "Deprecated alias for --upper; rewritten to --upper by the registered parser.",
+  },
+  {
+    long: "--repeat",
+    value_name: "count",
+    value_type: "number",
+    default: 1,
+    description: "Echo the message this many times (minimum 1).",
+  },
+  {
+    long: "--decorations",
+    value_name: "csv",
+    value_type: "string",
+    list: true,
+    description: "Comma-separated decoration labels; repeated flags accumulate.",
+  },
+];
+
+/** registerCommand exemplar: a FULL CommandDefinition with every field populated. */
+export function buildEchoCommandDefinition() {
+  return {
+    name: ECHO_COMMAND,
+    action: "command-kit-echo",
+    description: "Echo a message as structured output (commands-capability exemplar).",
+    intent: "Demonstrate every CommandDefinition field: arguments, flags, examples, and failure hints.",
+    arguments: [
+      {
+        name: "message",
+        required: true,
+        variadic: true,
+        description: "Message words to echo back.",
+      },
+    ],
+    flags: [...echoFlags],
+    examples: [
+      'pm command-kit echo "hello world"',
+      "pm command-kit echo hello --upper --repeat 2",
+      "pm command-kit echo hello --decorations star,spark --decorations wave",
+    ],
+    failure_hints: [
+      "command-kit echo requires a message argument; pass words after the command name.",
+      "--repeat takes a positive integer; invalid values fall back to 1.",
+    ],
+    run: runEchoCommand,
+  };
+}
+
+/** registerFlags exemplar: inject an inert, namespaced flag into an existing core command. */
+export const injectedListFlags = [
+  {
+    long: "--kit-note",
+    value_name: "text",
+    value_type: "string",
+    description: "Inert exemplar flag injected into `pm list` by pm-command-kit; the core list handler ignores it.",
+  },
+];
+
+/**
+ * @param {import("../../../../src/sdk/index.js").ExtensionApi} api
+ */
+export function activate(api) {
+  api.registerCommand(buildEchoCommandDefinition());
+  api.registerParser(ECHO_COMMAND, rewriteEchoOptions);
+  api.registerFlags("list", injectedListFlags);
+}
+
+export default {
+  manifest,
+  activate,
+};

package/packages/pm-command-kit/extensions/command-kit/index.ts

@@ -0,0 +1,176 @@
+/**
+ * pm-command-kit — first-party exemplar for the `commands` capability surface.
+ *
+ * Demonstrates the three command-facing SDK registration APIs:
+ * 1. `registerCommand` with a FULL CommandDefinition (name, action, description,
+ *    intent, arguments, flags, examples, failure_hints, run).
+ * 2. `registerParser` to preprocess parsed options before the command handler runs.
+ * 3. `registerFlags` to inject an additional flag into an EXISTING command.
+ *
+ * The extension is intentionally pure: no filesystem, network, environment, or
+ * process access — so its manifest declares `sandbox_profile: "strict"` with all
+ * permissions false. Third-party authors can copy this package wholesale and
+ * replace the echo behavior with their own command logic.
+ */
+import type {
+  CommandDefinition,
+  CommandHandlerContext,
+  ExtensionApi,
+  FlagDefinition,
+  ParserOverrideContext,
+  ParserOverrideDelta,
+} from "../../../../src/sdk/index.js";
+
+export const manifest = {
+  name: "builtin-command-kit",
+  version: "0.1.0",
+  entry: "./index.js",
+  priority: 0,
+  capabilities: ["commands", "schema", "parser"],
+  activation: { commands: ["command-kit echo", "list"] },
+};
+
+export const ECHO_COMMAND = "command-kit echo";
+
+function toPositiveInteger(value: unknown, fallback: number): number {
+  const parsed = typeof value === "number" ? value : Number.parseInt(String(value ?? ""), 10);
+  if (!Number.isInteger(parsed) || parsed < 1) {
+    return fallback;
+  }
+  return parsed;
+}
+
+function toDecorationList(value: unknown): string[] {
+  const raw: unknown[] = Array.isArray(value) ? value : typeof value === "string" ? value.split(",") : [];
+  const seen = new Set<string>();
+  for (const entry of raw) {
+    const trimmed = String(entry).trim();
+    if (trimmed.length > 0) {
+      seen.add(trimmed);
+    }
+  }
+  return [...seen];
+}
+
+/**
+ * registerParser exemplar: normalize parsed options BEFORE the command handler
+ * runs. Returns a delta — only the keys you set are merged over the parsed
+ * input. Here the deprecated `--shout` alias is rewritten to `--upper`,
+ * `--repeat` is coerced to a positive integer, and `--decorations` values are
+ * trimmed and de-duplicated.
+ */
+export function rewriteEchoOptions(context: ParserOverrideContext): ParserOverrideDelta {
+  const options: Record<string, unknown> = { ...context.options };
+  if (options.shout === true || options.shout === "true") {
+    options.upper = true;
+  }
+  delete options.shout;
+  options.repeat = toPositiveInteger(options.repeat, 1);
+  if (options.decorations !== undefined) {
+    options.decorations = toDecorationList(options.decorations);
+  }
+  return { options };
+}
+
+/** Command handler: pure compute, structured result rendered by the host. */
+export function runEchoCommand(context: CommandHandlerContext): Record<string, unknown> {
+  const args = Array.isArray(context?.args) ? context.args : [];
+  const options =
+    context?.options && typeof context.options === "object" && !Array.isArray(context.options) ? context.options : {};
+  const message = args
+    .map((arg) => String(arg).trim())
+    .filter((arg) => arg.length > 0)
+    .join(" ");
+  if (message.length === 0) {
+    throw new Error('command-kit echo requires a message argument. Try: pm command-kit echo "hello world".');
+  }
+  const upper = options.upper === true || options.upper === "true";
+  const repeat = toPositiveInteger(options.repeat, 1);
+  const decorations = toDecorationList(options.decorations);
+  const rendered = upper ? message.toUpperCase() : message;
+  return {
+    action: "command-kit-echo",
+    message: rendered,
+    lines: Array.from({ length: repeat }, () => rendered),
+    repeat,
+    upper,
+    decorations,
+  };
+}
+
+const echoFlags: FlagDefinition[] = [
+  {
+    long: "--upper",
+    value_type: "boolean",
+    description: "Uppercase the echoed message.",
+  },
+  {
+    long: "--shout",
+    value_type: "boolean",
+    description: "Deprecated alias for --upper; rewritten to --upper by the registered parser.",
+  },
+  {
+    long: "--repeat",
+    value_name: "count",
+    value_type: "number",
+    default: 1,
+    description: "Echo the message this many times (minimum 1).",
+  },
+  {
+    long: "--decorations",
+    value_name: "csv",
+    value_type: "string",
+    list: true,
+    description: "Comma-separated decoration labels; repeated flags accumulate.",
+  },
+];
+
+/** registerCommand exemplar: a FULL CommandDefinition with every field populated. */
+export function buildEchoCommandDefinition(): CommandDefinition {
+  return {
+    name: ECHO_COMMAND,
+    action: "command-kit-echo",
+    description: "Echo a message as structured output (commands-capability exemplar).",
+    intent: "Demonstrate every CommandDefinition field: arguments, flags, examples, and failure hints.",
+    arguments: [
+      {
+        name: "message",
+        required: true,
+        variadic: true,
+        description: "Message words to echo back.",
+      },
+    ],
+    flags: [...echoFlags],
+    examples: [
+      'pm command-kit echo "hello world"',
+      "pm command-kit echo hello --upper --repeat 2",
+      "pm command-kit echo hello --decorations star,spark --decorations wave",
+    ],
+    failure_hints: [
+      "command-kit echo requires a message argument; pass words after the command name.",
+      "--repeat takes a positive integer; invalid values fall back to 1.",
+    ],
+    run: runEchoCommand,
+  };
+}
+
+/** registerFlags exemplar: inject an inert, namespaced flag into an existing core command. */
+export const injectedListFlags: FlagDefinition[] = [
+  {
+    long: "--kit-note",
+    value_name: "text",
+    value_type: "string",
+    description: "Inert exemplar flag injected into `pm list` by pm-command-kit; the core list handler ignores it.",
+  },
+];
+
+export function activate(api: ExtensionApi): void {
+  api.registerCommand(buildEchoCommandDefinition());
+  api.registerParser(ECHO_COMMAND, rewriteEchoOptions);
+  api.registerFlags("list", injectedListFlags);
+}
+
+export default {
+  manifest,
+  activate,
+};

package/packages/pm-command-kit/extensions/command-kit/manifest.json

@@ -0,0 +1,22 @@
+{
+  "name": "builtin-command-kit",
+  "version": "0.1.0",
+  "entry": "./index.js",
+  "priority": 0,
+  "trusted": true,
+  "sandbox_profile": "strict",
+  "permissions": {
+    "fs_read": false,
+    "fs_write": false,
+    "network": false,
+    "env_read": false,
+    "env_write": false,
+    "process_spawn": false
+  },
+  "capabilities": ["commands", "schema", "parser"],
+  "manifest_version": 1,
+  "pm_min_version": "2026.5.0",
+  "activation": {
+    "commands": ["command-kit echo", "list"]
+  }
+}

package/packages/pm-command-kit/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@unbrained/pm-command-kit",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "First-party pm exemplar package for the commands capability: registerCommand, registerFlags, and registerParser.",
+  "homepage": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unbraind/pm-cli.git",
+    "directory": "packages/pm-command-kit"
+  },
+  "bugs": {
+    "url": "https://github.com/unbraind/pm-cli/issues"
+  },
+  "keywords": [
+    "pm-package",
+    "project-management",
+    "sdk",
+    "commands",
+    "exemplar"
+  ],
+  "pm": {
+    "aliases": [
+      "command-kit"
+    ],
+    "extensions": [
+      "extensions/command-kit"
+    ],
+    "catalog": {
+      "display_name": "Command Kit Exemplar",
+      "category": "sdk",
+      "summary": "Copy-paste-able exemplar for registerCommand, registerFlags, and registerParser.",
+      "tags": [
+        "sdk",
+        "commands",
+        "parser",
+        "exemplar"
+      ],
+      "links": {
+        "docs": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit#readme",
+        "repository": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit",
+        "report": "https://github.com/unbraind/pm-cli/issues"
+      }
+    },
+    "docs": [
+      "README.md"
+    ],
+    "examples": [
+      "README.md"
+    ]
+  }
+}

package/packages/pm-governance-audit/extensions/governance-audit/manifest.json

@@ -3,6 +3,16 @@
   "version": "0.1.0",
   "entry": "./index.js",
   "priority": 0,
+  "trusted": true,
+  "sandbox_profile": "restricted",
+  "permissions": {
+    "fs_read": true,
+    "fs_write": true,
+    "network": false,
+    "env_read": true,
+    "env_write": false,
+    "process_spawn": false
+  },
   "capabilities": ["commands", "schema", "hooks"],
   "manifest_version": 1,
   "pm_min_version": "2026.5.0",

package/packages/pm-guide-shell/extensions/guide-shell/manifest.json

@@ -3,6 +3,16 @@
   "version": "0.1.0",
   "entry": "./index.js",
   "priority": 0,
+  "trusted": true,
+  "sandbox_profile": "strict",
+  "permissions": {
+    "fs_read": true,
+    "fs_write": false,
+    "network": false,
+    "env_read": true,
+    "env_write": false,
+    "process_spawn": false
+  },
   "capabilities": ["commands", "schema", "services"],
   "manifest_version": 1,
   "pm_min_version": "2026.5.0",

package/packages/pm-lifecycle-hooks/extensions/lifecycle-hooks/manifest.json

@@ -3,6 +3,16 @@
   "version": "0.1.0",
   "entry": "./index.js",
   "priority": 0,
+  "trusted": true,
+  "sandbox_profile": "strict",
+  "permissions": {
+    "fs_read": false,
+    "fs_write": false,
+    "network": false,
+    "env_read": false,
+    "env_write": false,
+    "process_spawn": false
+  },
   "capabilities": ["hooks"],
   "manifest_version": 1,
   "pm_min_version": "2026.5.0"

package/packages/pm-linked-test-adapters/extensions/linked-test-adapters/manifest.json

@@ -3,6 +3,16 @@
   "version": "0.1.0",
   "entry": "./index.js",
   "priority": 0,
+  "trusted": true,
+  "sandbox_profile": "none",
+  "permissions": {
+    "fs_read": true,
+    "fs_write": true,
+    "network": false,
+    "env_read": true,
+    "env_write": false,
+    "process_spawn": true
+  },
   "capabilities": ["commands", "schema"],
   "manifest_version": 1,
   "pm_min_version": "2026.5.0",

package/packages/pm-search-advanced/extensions/search-advanced/index.js

@@ -195,6 +195,12 @@ const reindexFlags = [
     value_type: "string",
     description: "Reindex mode: keyword|semantic|hybrid.",
   },
+  {
+    long: "--full",
+    value_type: "boolean",
+    description:
+      "Force full semantic/hybrid embedding rebuild; by default semantic/hybrid reindex only embeds stale items.",
+  },
   {
     long: "--progress",
     value_type: "boolean",

package/packages/pm-search-advanced/extensions/search-advanced/index.ts

@@ -217,6 +217,12 @@ const reindexFlags = [
     value_type: "string",
     description: "Reindex mode: keyword|semantic|hybrid.",
   },
+  {
+    long: "--full",
+    value_type: "boolean",
+    description:
+      "Force full semantic/hybrid embedding rebuild; by default semantic/hybrid reindex only embeds stale items.",
+  },
   {
     long: "--progress",
     value_type: "boolean",

package/packages/pm-search-advanced/extensions/search-advanced/manifest.json

@@ -3,6 +3,16 @@
   "version": "0.1.0",
   "entry": "./index.js",
   "priority": 0,
+  "trusted": true,
+  "sandbox_profile": "restricted",
+  "permissions": {
+    "fs_read": true,
+    "fs_write": true,
+    "network": true,
+    "env_read": true,
+    "env_write": false,
+    "process_spawn": false
+  },
   "capabilities": [
     "commands",
     "schema",

package/packages/pm-search-advanced/extensions/search-advanced/runtime.js

@@ -138,6 +138,7 @@ function normalizeAdvancedSearchOptions(rawOptions, args) {
 function normalizeReindexOptions(rawOptions) {
   return {
     mode: readStringOption(rawOptions, "mode"),
+    full: readBooleanOption(rawOptions, "full") === true ? true : undefined,
     progress: readBooleanOption(rawOptions, "progress") === true ? true : undefined,
   };
 }

package/packages/pm-search-advanced/extensions/search-advanced/runtime.ts

@@ -211,6 +211,7 @@ function normalizeAdvancedSearchOptions(rawOptions: Record<string, unknown>, arg
 function normalizeReindexOptions(rawOptions: Record<string, unknown>): ReindexOptions {
   return {
     mode: readStringOption(rawOptions, "mode"),
+    full: readBooleanOption(rawOptions, "full") === true ? true : undefined,
     progress: readBooleanOption(rawOptions, "progress") === true ? true : undefined,
   };
 }

package/packages/pm-templates/extensions/templates/manifest.json

@@ -3,6 +3,16 @@
   "version": "0.1.0",
   "entry": "./index.js",
   "priority": 0,
+  "trusted": true,
+  "sandbox_profile": "restricted",
+  "permissions": {
+    "fs_read": true,
+    "fs_write": true,
+    "network": false,
+    "env_read": true,
+    "env_write": false,
+    "process_spawn": false
+  },
   "capabilities": ["commands", "schema"],
   "manifest_version": 1,
   "pm_min_version": "2026.5.0",

package/packages/pm-todos/extensions/todos/manifest.json

@@ -3,6 +3,16 @@
   "version": "0.1.0",
   "entry": "./index.js",
   "priority": 0,
+  "trusted": true,
+  "sandbox_profile": "restricted",
+  "permissions": {
+    "fs_read": true,
+    "fs_write": true,
+    "network": false,
+    "env_read": true,
+    "env_write": false,
+    "process_spawn": false
+  },
   "capabilities": [
     "commands",
     "schema",

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.