@unbrained/pm-cli 2026.9.27 → 2026.9.28

package/docs/PACKAGE_EVIDENCE.md

@@ -1,8 +1,10 @@
 # Install Plans and Update Evidence
 
-Tracked by [pm-5bsofk](../.agents/pm/issues/pm-5bsofk.toon) and
+Tracked by [pm-erogk1](../.agents/pm/issues/pm-erogk1.toon),
+[pm-5bsofk](../.agents/pm/issues/pm-5bsofk.toon) and
 [pm-gf5zw8](../.agents/pm/issues/pm-gf5zw8.toon), with claim controls tracked by
-[pm-eqdo85](../.agents/pm/issues/pm-eqdo85.toon).
+[pm-eqdo85](../.agents/pm/issues/pm-eqdo85.toon) and Git metadata exclusion by
+[pm-k7nxaz](../.agents/pm/issues/pm-k7nxaz.toon).
 
 ## Install planning
 
@@ -10,17 +12,26 @@ Preview an install with `pm package install ./local-package --project --dry-run`
 The `details.install_plan` receipt distinguishes directory, archive, npm, and
 GitHub sources and reports logical file bytes, file/directory/link counts, and
 the copy policy. External local directories are directory snapshots, including
-development artifacts; nested destinations exclude `.agents`, `node_modules`,
-and installer backup directories at every depth using the installer's filter.
-Counts are lower bounds when `complete` is false, with `stop_reason`
-identifying the entry or depth limit. A source-directory alias resolves to its
+development artifacts other than `.git`. All copied directory sources exclude
+`.git` entries at every depth, including worktree files and symlinks, and count
+those entries in `excluded_entries`. Nested destinations also exclude `.agents`,
+`node_modules`, and installer backup directories at every depth using the
+installer's filter.
+The bounded planner can return lower-bound counts with `complete: false` and a
+`stop_reason` when called directly. Installing a local directory now refuses
+that incomplete scan in both dry-run and real modes before writing or
+activating. SDK callers receive
+`extension_install_incomplete_source_scan`; the CLI exits nonzero with the
+entry or depth limit and a packed-archive recovery step. That recovery keeps
+the requested `--project` or `--global` installation scope. A source-directory
+alias resolves to its
 directory before copying; symlink entries inside the source remain links and
 their targets are never traversed.
 Planning writes no destination files, managed state, or activation settings;
 archive and remote source resolution can still prepare temporary source files
 and perform network or dependency-resolution work.
 
-For development-heavy or incomplete local snapshots, `packed_alternative`
+For development-heavy local snapshots, `packed_alternative`
 provides argument vectors for `npm pack --ignore-scripts --json` and archive
 installation. Run packing in its reported `cwd`, substitute the returned
 `pack_result[0].filename`, and install the resulting archive. Normal local

package/docs/README.md

@@ -34,6 +34,7 @@ pm guide release --json
 - [Quickstart](QUICKSTART.md) - install, initialize, create, claim, link, test, close.
 - [Onboarding](ONBOARDING.md) - first-two-hours maintainer and contributor setup.
 - [Agent Guide](AGENT_GUIDE.md) - canonical agent loop, tracker linking, and token-minimal command choices.
+- [Agent Read and Test Receipts](AGENT_READ_AND_TEST_RECEIPTS.md) - JSON help provenance, linked-test persistence, and history diff continuation.
 - [Command Reference](COMMANDS.md) - command families with examples and when to use each family.
 - [Context and Operations Namespaces](COMMAND_NAMESPACES.md) - native navigation, diagnostics, event streams, and compatibility aliases.
 - [CLI Scripting Contract](SCRIPTING.md) - exit codes, flat mutation receipts versus read envelopes, stdout/stderr boundaries, stable JSON fields, uniform OR filters, and shell composition recipes.

package/docs/TESTING.md

@@ -2,17 +2,22 @@
 
 This page describes safe local tests, linked tests, coverage, and release-readiness checks.
 
+Current linked-test and merge-fence work: [pm-t05d8d](../.agents/pm/issues/pm-t05d8d.toon), [pm-kynkl8](../.agents/pm/issues/pm-kynkl8.toon).
+
 Tracked implementation updates: [pm-52eh](../.agents/pm/features/pm-52eh.toon), [pm-mcxr](../.agents/pm/issues/pm-mcxr.toon), [pm-u42x](../.agents/pm/issues/pm-u42x.toon), [pm-atfm](../.agents/pm/features/pm-atfm.toon), [pm-xmp5](../.agents/pm/tasks/pm-xmp5.toon), [pm-39cqqx](../.agents/pm/tasks/pm-39cqqx.toon), [pm-5cgm2z](../.agents/pm/chores/pm-5cgm2z.toon), [pm-avv3wx](../.agents/pm/issues/pm-avv3wx.toon), [pm-rizqb6](../.agents/pm/issues/pm-rizqb6.toon), [pm-95h7pg](../.agents/pm/issues/pm-95h7pg.toon), [pm-giks4s](../.agents/pm/issues/pm-giks4s.toon), [pm-xa3t0o](../.agents/pm/issues/pm-xa3t0o.toon), [pm-e97jyf](../.agents/pm/issues/pm-e97jyf.toon), [pm-efkvdy](../.agents/pm/issues/pm-efkvdy.toon), [pm-ed28wi](../.agents/pm/issues/pm-ed28wi.toon), and [pm-5ug5xq](../.agents/pm/issues/pm-5ug5xq.toon).
 
 ## Agent Quick Context
 
 - Unit and integration tests must not read or write real `.agents/pm` data.
 - Prefer `node scripts/run-tests.mjs ...` because it creates sandboxed `PM_PATH` and `PM_GLOBAL_PATH`.
-- Linked-test execution injects isolated `PM_PATH` and `PM_GLOBAL_PATH` for
-  every command and applies stored-command provenance checks before process
+- Linked-test execution injects isolated `PM_GLOBAL_PATH` and normally
+  `PM_PATH`; `pm_context_mode=none` omits `PM_PATH` for self-isolating SDK tests
+  in disposable workspaces. It applies stored-command provenance checks before process
   creation. Direct runners are accepted; prefer
   `node scripts/run-tests.mjs ...` when the repository provides it because the
-  wrapper also reproduces build, coverage, and cleanup policy.
+  wrapper also reproduces build, coverage, and cleanup policy. Use a direct
+  runner when a `none`-mode test must observe an unset `PM_PATH`; the wrapper
+  creates its own sandboxed `PM_PATH`.
 - Run linked tests before closing the item that owns the work.
 
 Tracked documentation work: [pm-u9d0](../.agents/pm/epics/pm-u9d0.toon).
@@ -510,6 +515,11 @@ only their schema roots; a non-PM command explicitly configured with
 data are materialized only when at least one selected command requires tracker
 context. This preserves source isolation without copying an unrelated tracker
 into constrained temporary storage.
+For SDK tests that create independent temporary PM roots, use
+`pm_context_mode: "none"` with `workspace_context_mode: "isolated"` or
+`"snapshot"`. The runner omits `PM_PATH` so each SDK client can resolve its
+explicit workspace independently; `PM_GLOBAL_PATH` remains sandboxed. Source
+workspace execution and direct PM commands refuse this mode before execution.
 Capacity, permission, and resource failures while seeding a required tracker
 surface as typed, path-redacted host-environment refusals with recovery steps.
 When a legacy source tracker has settings but no `_workspace` history, tracker
@@ -593,6 +603,7 @@ Use explicit modes when needed:
 pm test <item-id> --run --pm-context schema
 pm test <item-id> --run --pm-context tracker
 pm test <item-id> --run --pm-context auto --check-context --auto-pm-context
+pm test <item-id> --add-json '{"command":"pnpm exec vitest run tests/integration/linked-test-context-trust.integration.spec.ts","pm_context_mode":"none","workspace_context_mode":"snapshot"}'
 ```
 
 For complex linked-test commands, prefer JSON input so shell syntax survives unchanged:

package/docs/generated/REFUSAL_CLOSURE_CENSUS.md

@@ -4,12 +4,12 @@ Tracker: `pm-f05lsg`.
 
 Every catalog code is listed. An `uncovered` row is an explicit closure obligation, never an omission or implied approval.
 
-- Catalog error codes: 385
+- Catalog error codes: 389
 - Executable error codes: 19
 - Executable-code ratchet floor: 18
 - Required executable canonical codes: `bulk_ids_input_empty`, `bulk_ids_input_missing_path`, `bulk_ids_input_unreadable`, `invalid_argument_value`, `manifest_unknown_key`, `missing_lifecycle_target`, `missing_required_argument`, `no_version_bounds_declared`, `projection_options_mutually_exclusive`, `tracker_not_initialized`, `tracker_root_missing`, `tracker_root_not_directory`, `tracker_root_unreadable`, `unknown_context_intent`, `unknown_field_projection`, `unknown_option`, `unknown_subcommand`
-- Uncovered error codes: 366
-- Coverage fraction: 0.049351
+- Uncovered error codes: 370
+- Coverage fraction: 0.048843
 - Closed-domain probes: 19
 - Grammar probes: 117
 
@@ -86,6 +86,7 @@ Every catalog code is listed. An `uncovered` row is an explicit closure obligati
 | `extension_dependency_name_unsafe` | `extension_dependency_name_unsafe` | uncovered | none | 0 |
 | `extension_dependency_spec_invalid` | `extension_dependency_spec_invalid` | uncovered | none | 0 |
 | `extension_dependency_version_unsafe` | `extension_dependency_version_unsafe` | uncovered | none | 0 |
+| `extension_install_incomplete_source_scan` | `extension_install_incomplete_source_scan` | uncovered | none | 0 |
 | `extension_install_soft_failed` | `extension_install_soft_failed` | uncovered | none | 0 |
 | `extension_install_source_contains_destination` | `extension_install_source_contains_destination` | uncovered | none | 0 |
 | `extension_item_field_reserved` | `extension_item_field_reserved` | uncovered | none | 0 |
@@ -203,6 +204,8 @@ Every catalog code is listed. An `uncovered` row is an explicit closure obligati
 | `merge_decisions_unreviewed` | `merge_decisions_unreviewed` | uncovered | none | 0 |
 | `merge_driver_configuration_drift` | `merge_driver_configuration_drift` | uncovered | none | 0 |
 | `merge_driver_configuration_missing` | `merge_driver_configuration_missing` | uncovered | none | 0 |
+| `merge_fence_drift` | `merge_fence_drift` | uncovered | none | 0 |
+| `merge_fence_missing` | `merge_fence_missing` | uncovered | none | 0 |
 | `merge_git_config_unwritable` | `merge_git_config_unwritable` | uncovered | none | 0 |
 | `merge_receipt_evidence_invalid` | `merge_receipt_evidence_invalid` | uncovered | none | 0 |
 | `merge_receipt_history_reference_missing` | `merge_receipt_history_reference_missing` | uncovered | none | 0 |
@@ -285,6 +288,7 @@ Every catalog code is listed. An `uncovered` row is an explicit closure obligati
 | `settings_read_invalid_schema` | `settings_read_invalid_schema` | uncovered | none | 0 |
 | `settings_read_merge_failed` | `settings_read_merge_failed` | uncovered | none | 0 |
 | `settings_unreadable` | `settings_unreadable` | uncovered | none | 0 |
+| `settings_write_invalid_existing_json` | `settings_write_invalid_existing_json` | uncovered | none | 0 |
 | `stale_budget` | `stale_budget` | uncovered | none | 0 |
 | `stale_destination` | `stale_destination` | uncovered | none | 0 |
 | `stale_observed_signature` | `stale_observed_signature` | uncovered | none | 0 |

package/marketplace.json

@@ -4,16 +4,14 @@
     "name": "unbrained",
     "url": "https://github.com/unbraind/pm-cli"
   },
-  "metadata": {
-    "description": "Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.",
-    "version": "2026.9.27"
-  },
+  "description": "Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.",
+  "version": "2026.9.28",
   "plugins": [
     {
       "name": "pm-claude",
       "source": "./plugins/pm-claude",
-      "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
-      "version": "2026.9.27",
+      "description": "Native pm CLI integration for Claude Code — 32 MCP tools, 14 workflow skills with slash invocations, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
+      "version": "2026.9.28",
       "author": {
         "name": "unbrained",
         "url": "https://github.com/unbraind/pm-cli"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "packageManager": "pnpm@11.10.0",
@@ -238,10 +238,10 @@
     "eslint-plugin-unicorn": "76.0.0",
     "fast-check": "^4.10.2",
     "github-slugger": "2.0.0",
-    "greptile": "^3.5.3",
-    "jscpd": "^5.3.1",
-    "knip": "^6.37.0",
-    "marked": "18.0.13",
+    "greptile": "^3.6.0",
+    "jscpd": "^5.3.2",
+    "knip": "^6.38.0",
+    "marked": "18.0.14",
     "parse5": "8.0.1",
     "tsx": "^4.23.15",
     "typescript": "^6.0.3",

package/packages/pm-beads/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-beads",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "private": true,
   "type": "module",
   "description": "First-party pm package for importing Beads JSONL records.",

package/packages/pm-calendar/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-calendar",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "private": true,
   "type": "module",
   "description": "First-party pm package for calendar and agenda views.",

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

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-command-kit",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "private": true,
   "type": "module",
   "description": "First-party pm exemplar package for the commands capability: registerCommand, registerFlags, and registerParser.",

package/packages/pm-digital-twin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-digital-twin",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "private": true,
   "type": "module",
   "description": "Beyond-PM exemplar: a temporal production-facility digital twin built entirely on public pm SDK and extension primitives.",

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

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-governance-audit",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "private": true,
   "type": "module",
   "description": "First-party pm package for governance audit and normalization workflows.",

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

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-guide-shell",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "private": true,
   "type": "module",
   "description": "First-party pm package for guide and shell completion workflows.",

package/packages/pm-kanban/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-kanban",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "private": true,
   "type": "module",
   "description": "First-party pm archetype package: a complete Kanban continuous-flow profile built on public SDK primitives.",

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

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-lifecycle-hooks",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "private": true,
   "type": "module",
   "description": "First-party pm package demonstrating safe lifecycle hook registration.",

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

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-linked-test-adapters",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "private": true,
   "type": "module",
   "description": "First-party pm package for optional linked-test run management adapters and reporters.",

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

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-search-advanced",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "private": true,
   "type": "module",
   "description": "First-party pm package for semantic, hybrid, and reindex search workflows.",

package/packages/pm-templates/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-templates",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "private": true,
   "type": "module",
   "description": "First-party pm package for reusable create templates.",

package/packages/pm-todos/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-todos",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "private": true,
   "type": "module",
   "description": "First-party pm package for Todo markdown import and export.",

package/packages/pm-vcs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-vcs-sdk-exemplar",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "private": true,
   "type": "module",
   "description": "Beyond-PM exemplar: a VCS-style changeset workflow built entirely on public pm SDK and extension primitives.",

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

@@ -1,7 +1,9 @@
 {
+  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "pm-claude",
-  "description": "Native pm CLI integration for Claude Code — 28 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": "2026.9.27",
+  "displayName": "pm CLI",
+  "description": "Native pm CLI integration for Claude Code — 32 MCP tools, 14 skills with slash invocations, 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": "2026.9.28",
   "author": {
     "name": "unbrained",
     "url": "https://github.com/unbraind/pm-cli"

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

@@ -2,8 +2,7 @@
   "mcpServers": {
     "pm-mcp": {
       "command": "node",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/pm-mcp-server.mjs"],
-      "note": "Native pm-cli MCP server with automatic client/harness identity. Imports pm command modules directly — no pm shell invocation needed."
+      "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/pm-mcp-server.mjs"]
     }
   }
 }

package/plugins/pm-claude/README.md

@@ -7,15 +7,15 @@ Native pm CLI integration for Claude Code. Use pm project management tools direc
 | Component | What it provides |
 |-----------|----------------|
 | **32 MCP tools** | Full pm surface: discover, next, context, search, events, list, get, create, atomic mutate, copy, focus, update, claim, release, close, comments, files, docs, notes, learnings, deps, graph, test, validate, health, contracts, plan, append, schema, config, profile + `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 |
+| **14 skills and slash invocations** | 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) |
 | **Hybrid TUI tracking** | pm items sync to Claude Code's task panel — pm is the persistent store, the task panel is the live session view |
 | **Session hook** | Injects active pm item summary at session start using the same pinned pm-cli runtime as the MCP server |
 
-The five skills are generated from the shared portable source in
+Five core workflow skills are generated from the shared portable source in
 `templates/agent-skills/`. Both plugin packages carry identical workflow
 guidance; the Claude task panel mapping is conditional on its tools.
+The other nine skills provide Claude-specific, directly invocable workflows.
 
 ## Installation
 
@@ -33,7 +33,7 @@ claude plugin marketplace add /path/to/pm-cli
 # claude plugin marketplace add unbraind/pm-cli
 ```
 
-This installs all 32 MCP tools, 5 skills, 14 slash commands, 4 subagents, hybrid TUI tracking, and the session hook in one step. (`pm-claude` is the plugin name; `pm` is the marketplace name from `marketplace.json`.)
+This installs all 32 MCP tools, 14 skills available through `/pm-*`, 4 subagents, hybrid TUI tracking, and the session hook in one step. (`pm-claude` is the plugin name; `pm` is the marketplace name from `.claude-plugin/marketplace.json`.)
 
 ### Option B: Global MCP server via Claude Code CLI (MCP tools only)
 
@@ -41,7 +41,7 @@ This installs all 32 MCP tools, 5 skills, 14 slash commands, 4 subagents, hybrid
 claude mcp add --transport stdio pm-mcp -- npx -y --package=@unbrained/pm-cli@latest pm-mcp
 ```
 
-This gives you the 32 MCP tools but not the skills, slash commands, or session hook.
+This gives you the 32 MCP tools but not the skills or session hook.
 
 ### Option C: Direct `.mcp.json` (project-scoped MCP only)
 
@@ -91,7 +91,7 @@ When you `/pm-start-task` or `/pm-developer`:
 
 This means you get full history in pm (survives restarts, visible in `pm list`) and live visual feedback in the Claude Code session.
 
-## Slash Commands
+## Skill Invocations
 
 | Command | What it does |
 |---------|-------------|
@@ -110,7 +110,7 @@ This means you get full history in pm (survives restarts, visible in `pm list`)
 | `/pm-workflow [id or description]` | General pm workflow loop with TUI tracking |
 | `/pm-init [project name]` | Initialize pm in the current project |
 
-## Skills
+## Core Skills
 
 | Skill | When Claude uses it |
 |-------|-------------------|

package/plugins/pm-claude/package.json

@@ -2,8 +2,8 @@
   "name": "pm-claude-runtime",
   "private": true,
   "type": "module",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "dependencies": {
-    "@unbrained/pm-cli": "2026.9.27"
+    "@unbrained/pm-cli": "2026.9.28"
   }
 }

package/plugins/pm-claude/{commands/pm-calendar.md → skills/pm-calendar/SKILL.md}

@@ -1,4 +1,5 @@
 ---
+name: pm-calendar
 description: Show the pm calendar — upcoming deadlines, reminders, and scheduled events. Optionally pass a view like "week", "month", or a date range.
 ---
 

package/plugins/pm-claude/{commands/pm-close-task.md → skills/pm-close-task/SKILL.md}

@@ -1,4 +1,5 @@
 ---
+name: pm-close-task
 description: Close a pm-tracked task with evidence — verify tests pass, link changed files, add closing comment, close and release in pm, then mark the Claude Code task panel entry as completed. Accepts an optional item ID as argument.
 ---
 

package/plugins/pm-claude/{commands/pm-init.md → skills/pm-init/SKILL.md}

@@ -1,4 +1,5 @@
 ---
+name: pm-init
 description: Initialize pm in the current project — creates the .agents/pm/ tracker directory, sets up default settings, and shows a quick-start summary. Accepts an optional project name as argument.
 ---
 
@@ -46,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 30 MCP tools available: `pm_next`, `pm_context`, `pm_search`, `pm_list`, `pm_get`, `pm_create`, `pm_mutate`, `pm_copy`, `pm_focus`, `pm_update`, `pm_append`, `pm_claim`, `pm_release`, `pm_close`, `pm_comments`, `pm_files`, `pm_docs`, `pm_notes`, `pm_learnings`, `pm_deps`, `pm_graph`, `pm_test`, `pm_validate`, `pm_health`, `pm_contracts`, `pm_schema`, `pm_config`, `pm_profile`, `pm_plan`, `pm_run`
+   - Use `pm_discover` to inspect the current MCP tool catalog and `pm_contracts` for exact command flags. The catalog is currently 32 tools.
    - Next: use `/pm-new <title>` to create your first item, or `/pm-status` to see the tracker state
 
 If initialization fails, report the error and suggest running `pm init` manually in the terminal.

package/plugins/pm-claude/{commands/pm-list.md → skills/pm-list/SKILL.md}

@@ -1,4 +1,5 @@
 ---
+name: pm-list
 description: List pm items with optional status or type filter. Pass a filter like "open", "in_progress", "blocked", "bugs", or leave empty for active items.
 ---
 
@@ -23,7 +24,7 @@ List pm items using native MCP tools. Filter: `$ARGUMENTS`
      }
    }
    ```
-   For `all`, use `pm_list` with no status filter.
+   For `all`, use `pm_list` with `status: "all"` so closed and canceled items are included.
 
 3. **If filter is empty** (active items) — also call `pm_context` for a richer summary:
    ```json

package/plugins/pm-claude/{commands/pm-new.md → skills/pm-new/SKILL.md}

@@ -1,4 +1,5 @@
 ---
+name: pm-new
 description: Quickly create a new pm item — duplicate-checks first, then creates with sensible defaults. Pass a title (or title + description) as argument.
 ---
 

package/plugins/pm-claude/{commands/pm-search.md → skills/pm-search/SKILL.md}

@@ -1,4 +1,5 @@
 ---
+name: pm-search
 description: Search pm items by keywords, tags, status, or type — returns ranked results with context. Pass the search query as argument.
 ---
 

package/plugins/pm-claude/{commands/pm-start-task.md → skills/pm-start-task/SKILL.md}

@@ -1,4 +1,5 @@
 ---
+name: pm-start-task
 description: Start a pm-tracked task — orient, find or create the right item, claim it, sync to TUI, and link initial scope. Accepts an optional item ID or keywords as argument.
 ---
 

package/plugins/pm-claude/{commands/pm-status.md → skills/pm-status/SKILL.md}

@@ -1,4 +1,5 @@
 ---
+name: pm-status
 description: Show a compact pm project status snapshot — active items, blocked work, and upcoming deadlines.
 ---
 

package/plugins/pm-claude/{commands/pm-triage.md → skills/pm-triage/SKILL.md}

@@ -1,4 +1,5 @@
 ---
+name: pm-triage
 description: Triage a new request through pm — check for duplicates, create canonical parent lineage if needed, and produce a scoped child item with acceptance criteria. Pass the request description as argument.
 ---
 

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

@@ -1,6 +1,6 @@
 {
   "name": "pm-codex",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "description": "Native Codex integration for pm-cli with bundled MCP tools, skills, commands, and agent workflows.",
   "author": {
     "name": "unbrained",

package/plugins/pm-codex/package.json

@@ -2,8 +2,8 @@
   "name": "pm-codex-runtime",
   "private": true,
   "type": "module",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "dependencies": {
-    "@unbrained/pm-cli": "2026.9.27"
+    "@unbrained/pm-cli": "2026.9.28"
   }
 }

package/plugins/pm-codex/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "pm-codex",
-  "version": "2026.9.27",
+  "version": "2026.9.28",
   "description": "Repository-native project context workflows and a version-pinned pm MCP server for Codex.",
   "author": {
     "name": "unbrained",