@unbrained/pm-cli 2026.5.10 → 2026.5.11

package/.claude-plugin/marketplace.json

@@ -1,19 +1,19 @@
 {
-  "name": "pm-cli",
+  "name": "pm",
   "owner": {
     "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": "1.0.0"
+    "version": "1.3.0"
   },
   "plugins": [
     {
       "name": "pm-cli",
       "source": "./plugins/pm-cli-claude",
-      "description": "Native pm CLI integration for Claude Code — 18 MCP tools, workflow skills, slash commands, session context injection, and a coordination subagent for git-based project management without leaving Claude Code.",
-      "version": "1.0.0",
+      "description": "Native pm CLI integration for Claude Code — 18 MCP tools, 5 workflow skills, 14 slash commands, 3 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
+      "version": "1.3.0",
       "author": {
         "name": "unbrained",
         "url": "https://github.com/unbraind/pm-cli"

package/.pi/README.md

@@ -19,8 +19,17 @@ pi -e .
 
 Resources exposed by `package.json`:
 
-- `.pi/extensions/pm-cli/index.js` — native Pi extension registering the `pm` tool and slash commands.
+- `.pi/extensions/pm-cli/index.js` — native Pi extension registering the `pm` tool, custom TUI renderers, autocomplete, status/widget UI, and slash commands.
 - `.pi/skills/*` — Pi skills for native pm workflows and release validation.
 - `.pi/prompts/*` — prompt templates for pm-tracked work.
+- `.pi/agents/*` and `.pi/chains/*` — optional pi-subagents setup for pm triage and verification workflows in repositories that use subagents.
 
 The extension imports the built package from `dist/`, so run `pnpm build` before local install or before publishing.
+
+Interactive commands:
+
+- `/pm-board [limit]` — dashboard panel for active pm context.
+- `/pm-item <id>` and `/pm-history <id>` — item details/history panels.
+- `/pm-actions` and `/pm-workflows` — native action list and workflow reminders.
+
+The `pm` tool should be preferred over shelling out to `pm`; it calls pm command modules directly in-process.

package/.pi/agents/pm-triage-agent.md

@@ -0,0 +1,19 @@
+---
+name: pm-triage-agent
+description: Native pm triage agent for Pi. Use to inspect context, search for duplicates, select or create tracker lineage, and hand off an implementation-ready pm item without shelling out to the pm CLI.
+tools: pm,read,grep,find,ls
+skills: pm-native,pm-user
+---
+
+# pm Triage Agent
+
+Use the native `pm` tool only for pm operations.
+
+Workflow:
+1. Run `pm` action `context` with `limit: 10`.
+2. Run `pm` action `search` with the user's key terms.
+3. Run `pm` actions `list-open` and `list-in-progress`.
+4. If an item exists, recommend reusing it and claim/start only when asked.
+5. If no item exists, identify parent lineage and propose a create payload with duplicate-check evidence.
+
+Output a concise handoff with item id, rationale, recommended next action, and exact native `pm` tool calls.

package/.pi/agents/pm-verification-agent.md

@@ -0,0 +1,21 @@
+---
+name: pm-verification-agent
+description: Native pm verification agent for Pi. Use to inspect linked files/tests/docs, run sandbox-safe linked tests through pm, validate close readiness, and produce closure evidence.
+tools: pm,bash,read,grep,find,ls
+skills: pm-native,pm-release
+---
+
+# pm Verification Agent
+
+Use the native `pm` tool for pm mutations and linked-test orchestration.
+Use bash only for non-pm project commands such as `pnpm build` or `gh run list`.
+
+Workflow:
+1. Read the target item with `pm` action `get`.
+2. Check linked files/docs/tests and acceptance criteria.
+3. Run `pm` action `test` with `run: true` or equivalent linked-test options when available.
+4. Run targeted project validation requested by the parent.
+5. Add a `pm` comment summarizing evidence.
+6. Recommend close/release only if verification is clean.
+
+Output failures with exact commands, item id, and next remediation step.

package/.pi/chains/pm-native-delivery.chain.md

@@ -0,0 +1,11 @@
+---
+name: pm-native-delivery
+description: Triage, implement, and verify a pm-tracked change using native pm operations in Pi.
+steps:
+  - agent: pm-triage-agent
+    task: "Triage the requested work and identify the canonical pm item for: {task}"
+  - agent: worker
+    task: "Implement the approved scope from the triage handoff. Use native pm for tracker operations, link changed files/tests/docs, and keep edits scoped. Original request: {task}\n\nTriage handoff:\n{previous}"
+  - agent: pm-verification-agent
+    task: "Verify the implementation and produce pm closure evidence. Original request: {task}\n\nImplementation handoff:\n{previous}"
+---

package/.pi/extensions/pm-cli/index.js

@@ -1,32 +1,9 @@
-import { PM_TOOL_ACTIONS } from "../../../dist/sdk/cli-contracts.js";
+import { PM_PI_TOOL_PARAMETERS_SCHEMA, PM_TOOL_ACTIONS } from "../../../dist/sdk/cli-contracts.js";
 import { runNativePmAction } from "../../../dist/pi/native.js";
 
-const PM_PI_TOOL_PARAMETERS_SCHEMA = {
-  type: "object",
+const PM_PI_TOOL_PARAMETERS_SCHEMA_COMPAT = {
+  ...PM_PI_TOOL_PARAMETERS_SCHEMA,
   additionalProperties: true,
-  required: ["action"],
-  description: "Parameters for the native pm Pi tool. Extra properties are forwarded to the selected pm action.",
-  properties: {
-    action: {
-      type: "string",
-      description: "pm action to execute, for example context, search, get, create, update, files, docs, test, validate, or close-task.",
-    },
-    id: { type: "string", description: "pm item id for item-scoped actions." },
-    text: { type: "string", description: "Text payload for comment-like actions or close reasons." },
-    title: { type: "string", description: "Title for create actions." },
-    description: { type: "string", description: "Description for create/update actions." },
-    query: { type: "string", description: "Search query text." },
-    limit: { type: "string", description: "Result limit. Numeric strings are accepted." },
-    author: { type: "string", description: "Explicit pm author for mutations." },
-    path: { type: "string", description: "pm data path override or linked file path, depending on action." },
-    scope: { type: "string", description: "Link scope such as project." },
-    command: { type: "string", description: "Linked test command or shell completion target, depending on action." },
-    options: {
-      type: "object",
-      additionalProperties: true,
-      description: "Advanced command options object forwarded to the selected pm action.",
-    },
-  },
 };
 
 function contentText(result) {
@@ -34,6 +11,155 @@ function contentText(result) {
   return JSON.stringify(result, null, 2);
 }
 
+function firstText(result) {
+  const entry = Array.isArray(result?.content) ? result.content.find((part) => part?.type === "text") : undefined;
+  return typeof entry?.text === "string" ? entry.text : "";
+}
+
+function truncatePlain(value, width) {
+  const text = String(value ?? "");
+  let visible = 0;
+  let output = "";
+  for (let index = 0; index < text.length; index += 1) {
+    const char = text[index];
+    if (char === "\u001b") {
+      const match = text.slice(index).match(/^\u001b\[[0-9;?]*[ -/]*[@-~]/);
+      if (match) {
+        output += match[0];
+        index += match[0].length - 1;
+        continue;
+      }
+    }
+    if (visible >= Math.max(0, width - 1)) return `${output}…`;
+    output += char;
+    visible += 1;
+  }
+  return output;
+}
+
+function statusIcon(status, theme) {
+  const normalized = String(status ?? "").toLowerCase();
+  if (normalized === "closed") return theme.fg("success", "✓");
+  if (normalized === "blocked") return theme.fg("warning", "!");
+  if (normalized === "in_progress") return theme.fg("accent", "▶");
+  if (normalized === "canceled") return theme.fg("dim", "×");
+  return theme.fg("dim", "○");
+}
+
+class PmPanelComponent {
+  constructor(title, lines, theme, onClose) {
+    this.title = title;
+    this.lines = lines;
+    this.theme = theme;
+    this.onClose = onClose;
+    this.cachedWidth = undefined;
+    this.cachedLines = undefined;
+  }
+
+  handleInput(data) {
+    if (data === "\u001b" || data === "\u0003" || data === "q" || data === "Q") {
+      this.onClose?.();
+    }
+  }
+
+  render(width) {
+    if (this.cachedLines && this.cachedWidth === width) return this.cachedLines;
+    const theme = this.theme;
+    const usable = Math.max(20, width);
+    const border = theme.fg("borderMuted", "─".repeat(Math.max(0, usable)));
+    const rendered = [
+      border,
+      truncatePlain(`${theme.fg("accent", theme.bold(` pm ${this.title} `))}${theme.fg("dim", "q/esc closes")}`, usable),
+      border,
+      ...this.lines.map((line) => truncatePlain(line, usable)),
+      border,
+    ];
+    this.cachedWidth = width;
+    this.cachedLines = rendered;
+    return rendered;
+  }
+
+  invalidate() {
+    this.cachedWidth = undefined;
+    this.cachedLines = undefined;
+  }
+}
+
+function makeItemLine(item, theme) {
+  const id = theme.fg("accent", item.id ?? "unknown");
+  const type = theme.fg("muted", item.type ?? "Item");
+  const status = statusIcon(item.status, theme);
+  const priority = item.priority === undefined ? "" : theme.fg("dim", ` p${item.priority}`);
+  const owner = item.assignee ? theme.fg("dim", ` @${item.assignee}`) : "";
+  return `${status} ${id} ${type}${priority}${owner} ${item.title ?? "(untitled)"}`;
+}
+
+function contextLines(result, theme) {
+  const lines = [];
+  const summary = result?.summary;
+  if (summary) {
+    lines.push(
+      `${theme.fg("muted", "summary")} active=${summary.active_items ?? 0} open=${summary.open ?? 0} in_progress=${summary.in_progress ?? 0} blocked=${summary.blocked ?? 0}`,
+    );
+  }
+  const high = Array.isArray(result?.high_level) ? result.high_level : [];
+  const low = Array.isArray(result?.low_level) ? result.low_level : [];
+  if (high.length > 0) {
+    lines.push("", theme.fg("accent", "High level"));
+    lines.push(...high.map((item) => makeItemLine(item, theme)));
+  }
+  if (low.length > 0) {
+    lines.push("", theme.fg("accent", "Tasks"));
+    lines.push(...low.map((item) => makeItemLine(item, theme)));
+  }
+  if (lines.length === 0) lines.push(theme.fg("dim", "No pm context items found."));
+  return lines;
+}
+
+function listLines(result, theme) {
+  const items = Array.isArray(result?.items) ? result.items : Array.isArray(result) ? result : [];
+  if (items.length === 0) return [theme.fg("dim", "No items.")];
+  return items.map((entry) => makeItemLine(entry.item ?? entry, theme));
+}
+
+function historyLines(result, theme) {
+  const entries = Array.isArray(result?.history) ? result.history : Array.isArray(result?.entries) ? result.entries : [];
+  if (entries.length === 0) return [theme.fg("dim", "No history entries.")];
+  return entries.slice(0, 30).map((entry) => {
+    const at = entry.timestamp ?? entry.created_at ?? "";
+    const op = entry.op ?? entry.operation ?? entry.type ?? "history";
+    const author = entry.author ? ` ${theme.fg("dim", `@${entry.author}`)}` : "";
+    const message = entry.message ?? entry.text ?? entry.reason ?? "";
+    return `${theme.fg("muted", at)} ${theme.fg("accent", op)}${author} ${message}`;
+  });
+}
+
+function getItemLines(result, theme) {
+  const item = result?.item ?? result;
+  if (!item || typeof item !== "object") return [theme.fg("dim", "No item details.")];
+  const lines = [makeItemLine(item, theme)];
+  if (item.description) lines.push("", item.description);
+  if (item.acceptance_criteria) lines.push("", `${theme.fg("accent", "Acceptance")}: ${item.acceptance_criteria}`);
+  if (Array.isArray(item.comments) && item.comments.length > 0) {
+    lines.push("", theme.fg("accent", "Recent comments"));
+    for (const comment of item.comments.slice(-5)) {
+      lines.push(`${theme.fg("muted", comment.created_at ?? "")} ${comment.author ?? "unknown"}: ${comment.text ?? ""}`);
+    }
+  }
+  return lines;
+}
+
+function resultLines(details, theme) {
+  const action = details?.action;
+  const result = details?.result;
+  if (action === "context") return contextLines(result, theme);
+  if (String(action ?? "").startsWith("list") || action === "search") return listLines(result, theme);
+  if (action === "history" || action === "activity") return historyLines(result, theme);
+  if (action === "get") return getItemLines(result, theme);
+  const raw = contentText(result);
+  return raw.split("\n").slice(0, 40);
+}
+
 function errorDetails(error) {
   return {
     message: error instanceof Error ? error.message : String(error),
@@ -41,19 +167,42 @@ function errorDetails(error) {
   };
 }
 
+function uiTheme(ctx) {
+  return ctx.ui?.theme ?? {
+    fg: (_name, text) => String(text),
+    bold: (text) => String(text),
+  };
+}
+
+async function showPanel(ctx, title, lines, overlay = true) {
+  if (!ctx.hasUI || typeof ctx.ui?.custom !== "function") {
+    ctx.ui.notify(lines.join("\n"), "info");
+    return;
+  }
+  await ctx.ui.custom((_tui, theme, _keybindings, done) => new PmPanelComponent(title, lines, theme, () => done(undefined)), {
+    overlay,
+    overlayOptions: { anchor: "right-center", width: "70%", minWidth: 60, maxHeight: "85%", margin: 1 },
+  });
+}
+
+async function runForCommand(ctx, params) {
+  return runNativePmAction({ cwd: ctx.cwd, ...params });
+}
+
 export function createPmToolDefinition() {
   return {
     name: "pm",
     label: "pm",
     description:
-      "Use pm natively from Pi without shelling out to the pm CLI. Supports pm project context, search, lifecycle mutations, links, tests, validation, extension management, templates, calendar, and audit workflows.",
+      "Use pm natively from Pi without shelling out to the pm CLI. Supports pm project context, search, lifecycle mutations, links, tests, validation, extension management, templates, calendar, guide, audit, beads, todos, and managed test-run workflows.",
     promptSnippet: "Run native pm project-management operations without bash or the pm CLI.",
     promptGuidelines: [
       "Use the pm tool instead of bash pm commands for project-management operations when this tool is available.",
       "Use pm action=context/list-open/list-in-progress/search before creating new work items.",
       "For mutations, set author explicitly and link changed files/tests/docs through pm actions before closing work.",
+      "Use pm action=contracts or guide when you need exact action/flag support instead of guessing parameters.",
     ],
-    parameters: PM_PI_TOOL_PARAMETERS_SCHEMA,
+    parameters: PM_PI_TOOL_PARAMETERS_SCHEMA_COMPAT,
     async execute(_toolCallId, params, _signal, onUpdate, ctx) {
       onUpdate?.({ content: [{ type: "text", text: `Running native pm action: ${params.action}` }] });
       try {
@@ -67,6 +216,20 @@ export function createPmToolDefinition() {
         throw new Error(`pm ${params.action ?? "action"} failed: ${details.message}`);
       }
     },
+    renderCall(args, theme) {
+      const action = args?.action ?? "action";
+      const target = args?.id ?? args?.query ?? args?.target ?? args?.title ?? "";
+      return new PmPanelComponent("tool", [`${theme.fg("toolTitle", theme.bold("pm"))} ${theme.fg("accent", action)} ${theme.fg("dim", target)}`], theme);
+    },
+    renderResult(result, { expanded, isPartial }, theme) {
+      if (isPartial) return new PmPanelComponent("running", [theme.fg("warning", "Running…")], theme);
+      const details = result?.details;
+      if (!details?.ok) return new PmPanelComponent("result", [firstText(result) || contentText(result)], theme);
+      const lines = resultLines(details, theme);
+      const visible = expanded ? lines : lines.slice(0, 12);
+      if (!expanded && lines.length > visible.length) visible.push(theme.fg("dim", `… ${lines.length - visible.length} more; expand tool output for details`));
+      return new PmPanelComponent(String(details.action ?? "result"), visible, theme);
+    },
   };
 }
 
@@ -75,8 +238,38 @@ export function registerPmCommands(pi) {
     description: "Show pm context snapshot using the native pm integration",
     handler: async (args, ctx) => {
       const limit = args?.trim() || "10";
-      const result = await runNativePmAction({ cwd: ctx.cwd, action: "context", limit, json: false });
-      ctx.ui.notify(contentText(result), "info");
+      const result = await runForCommand(ctx, { action: "context", limit, json: true });
+      await showPanel(ctx, "context", contextLines(result, uiTheme(ctx)));
+    },
+  });
+
+  pi.registerCommand("pm-board", {
+    description: "Open an interactive pm dashboard panel: /pm-board [limit]",
+    handler: async (args, ctx) => {
+      const limit = args?.trim() || "12";
+      const result = await runForCommand(ctx, { action: "context", limit, depth: "standard", json: true });
+      await showPanel(ctx, "board", contextLines(result, uiTheme(ctx)));
+    },
+  });
+
+  pi.registerCommand("pm-item", {
+    description: "Open pm item details: /pm-item <id>",
+    getArgumentCompletions: () => null,
+    handler: async (args, ctx) => {
+      const id = args?.trim();
+      if (!id) return ctx.ui.notify("Usage: /pm-item <id>", "error");
+      const result = await runForCommand(ctx, { action: "get", id, json: true });
+      await showPanel(ctx, id, getItemLines(result, uiTheme(ctx)));
+    },
+  });
+
+  pi.registerCommand("pm-history", {
+    description: "Open pm item history/activity panel: /pm-history <id>",
+    handler: async (args, ctx) => {
+      const id = args?.trim();
+      if (!id) return ctx.ui.notify("Usage: /pm-history <id>", "error");
+      const result = await runForCommand(ctx, { action: "history", id, limit: 30, json: true });
+      await showPanel(ctx, `${id} history`, historyLines(result, uiTheme(ctx)));
     },
   });
 
@@ -85,7 +278,7 @@ export function registerPmCommands(pi) {
     handler: async (args, ctx) => {
       const id = args?.trim();
       if (!id) return ctx.ui.notify("Usage: /pm-start <id>", "error");
-      const result = await runNativePmAction({ cwd: ctx.cwd, action: "start-task", id, author: "pi-agent" });
+      const result = await runForCommand(ctx, { action: "start-task", id, author: "pi-agent" });
       ctx.ui.notify(contentText(result), "success");
     },
   });
@@ -96,7 +289,7 @@ export function registerPmCommands(pi) {
       const [id, ...reasonParts] = (args ?? "").trim().split(/\s+/);
       const reason = reasonParts.join(" ");
       if (!id || !reason) return ctx.ui.notify("Usage: /pm-close <id> <reason>", "error");
-      const result = await runNativePmAction({ cwd: ctx.cwd, action: "close-task", id, text: reason, author: "pi-agent", validateClose: "warn" });
+      const result = await runForCommand(ctx, { action: "close-task", id, text: reason, author: "pi-agent", validateClose: "warn" });
       ctx.ui.notify(contentText(result), "success");
     },
   });
@@ -104,7 +297,21 @@ export function registerPmCommands(pi) {
   pi.registerCommand("pm-actions", {
     description: "List native pm tool actions",
     handler: async (_args, ctx) => {
-      ctx.ui.notify(PM_TOOL_ACTIONS.join(", "), "info");
+      await showPanel(ctx, "actions", PM_TOOL_ACTIONS.map((action) => `• ${action}`));
+    },
+  });
+
+  pi.registerCommand("pm-workflows", {
+    description: "Show native pm workflow shortcuts and bundled Pi resources",
+    handler: async (_args, ctx) => {
+      await showPanel(ctx, "workflows", [
+        "1. /pm-board to inspect focus/context items.",
+        "2. Use the pm tool action=search/list-open/list-in-progress before creating work.",
+        "3. /pm-start <id> or pm action=start-task to claim and move in_progress.",
+        "4. Use pm action=files/docs/test to link implementation evidence.",
+        "5. Run pm action=test/validate and close with pm action=close-task.",
+        "Bundled resources: pm-native and pm-release skills, pm-workflow prompt, pm subagent templates in .pi/agents.",
+      ]);
     },
   });
 }
@@ -122,14 +329,14 @@ function patchPmToolParametersInProviderPayload(payload) {
       const parameters = tool.parameters;
       if (!parameters || parameters.type !== "object") {
         changed = true;
-        return { ...tool, parameters: PM_PI_TOOL_PARAMETERS_SCHEMA };
+        return { ...tool, parameters: PM_PI_TOOL_PARAMETERS_SCHEMA_COMPAT };
       }
     }
     if (tool.function?.name === "pm") {
       const parameters = tool.function.parameters;
       if (!parameters || parameters.type !== "object") {
         changed = true;
-        return { ...tool, function: { ...tool.function, parameters: PM_PI_TOOL_PARAMETERS_SCHEMA } };
+        return { ...tool, function: { ...tool.function, parameters: PM_PI_TOOL_PARAMETERS_SCHEMA_COMPAT } };
       }
     }
     return tool;
@@ -137,11 +344,44 @@ function patchPmToolParametersInProviderPayload(payload) {
   return changed ? { ...payload, tools } : undefined;
 }
 
+function installPmAutocomplete(ctx) {
+  if (typeof ctx.ui?.addAutocompleteProvider !== "function") return;
+  ctx.ui.addAutocompleteProvider((current) => ({
+    async getSuggestions(lines, line, col, options) {
+      const beforeCursor = (lines[line] ?? "").slice(0, col);
+      const match = beforeCursor.match(/(?:^|[\s(])@(pm-[a-z0-9-]*)$/i);
+      if (!match) return current.getSuggestions(lines, line, col, options);
+      try {
+        const result = await runNativePmAction({ cwd: ctx.cwd, action: "list-open", limit: 20, json: true });
+        const items = Array.isArray(result?.items) ? result.items : [];
+        return {
+          prefix: `@${match[1] ?? ""}`,
+          items: items.map((item) => ({ value: `@${item.id}`, label: item.id, description: item.title ?? item.status ?? "pm item" })),
+        };
+      } catch {
+        return current.getSuggestions(lines, line, col, options);
+      }
+    },
+    applyCompletion(lines, line, col, item, prefix) {
+      return current.applyCompletion(lines, line, col, item, prefix);
+    },
+    shouldTriggerFileCompletion(lines, line, col) {
+      return current.shouldTriggerFileCompletion?.(lines, line, col) ?? true;
+    },
+  }));
+}
+
 export default function pmCliPiExtension(pi) {
   pi.registerTool(createPmToolDefinition());
   pi.on("before_provider_request", (event) => patchPmToolParametersInProviderPayload(event.payload));
   registerPmCommands(pi);
   pi.on("session_start", async (_event, ctx) => {
-    ctx.ui.setStatus?.("pm", "pm native");
+    ctx.ui.setStatus?.("pm", ctx.ui.theme?.fg ? ctx.ui.theme.fg("accent", "pm native") : "pm native");
+    ctx.ui.setWidget?.("pm-native", ["pm native ready • /pm-board • /pm-actions • @pm-id autocomplete"], { placement: "belowEditor" });
+    installPmAutocomplete(ctx);
+  });
+  pi.on("session_shutdown", async (_event, ctx) => {
+    ctx.ui.setStatus?.("pm", undefined);
+    ctx.ui.setWidget?.("pm-native", undefined);
   });
 }

package/.pi/skills/pm-native/SKILL.md

@@ -11,7 +11,7 @@ metadata:
 
 # pm Native for Pi
 
-Use the `pm` tool for project-management operations. Do not run `pm ...` through bash when the native tool is available.
+Use the `pm` tool for project-management operations. Do not run `pm ...` through bash when the native tool is available. In interactive Pi, use `/pm-board`, `/pm-item <id>`, `/pm-history <id>`, `/pm-actions`, and `/pm-workflows` when the user would benefit from seeing tracker state in the TUI.
 
 ## Required Loop
 
@@ -27,6 +27,7 @@ Use the `pm` tool for project-management operations. Do not run `pm ...` through
    - action `test` with sandbox-safe commands
 5. Verify with action `test`, `validate`, and project test commands when appropriate.
 6. Close with action `close-task` or `close`, then release if needed.
+7. For exact feature support, call `pm` action `contracts` or `guide` instead of guessing flags.
 
 ## Common Tool Calls
 
@@ -36,5 +37,8 @@ Use the `pm` tool for project-management operations. Do not run `pm ...` through
 - Link file: `{ "action": "files", "id": "pm-1234", "add": ["path=src/file.ts,scope=project,note=implementation"], "author": "pi-agent" }`
 - Add comment: `{ "action": "comments", "id": "pm-1234", "add": ["Evidence: build and tests passed"], "author": "pi-agent" }`
 - Close: `{ "action": "close-task", "id": "pm-1234", "text": "All acceptance criteria met", "author": "pi-agent", "validateClose": "warn" }`
+- Extension lifecycle: `{ "action": "extension", "install": true, "target": "todos", "scope": "project" }`
+- Templates: `{ "action": "templates-list" }`
+- Managed tests: `{ "action": "test-runs-list" }`
 
-Use `pm guide` topics through action `guide` for deeper command docs.
+Use `pm guide` topics through action `guide` for deeper command docs. The bundled Pi package also provides project subagent definitions (`pm-triage-agent`, `pm-verification-agent`) and a `pm-native-delivery` chain for installations that use pi-subagents.

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2026.5.11] - 2026-05-11
+
+### Added
+- Claude Code plugin v1.3.0: added `pm-triage-agent`, `pm-verification-agent`, and `pm-delivery-chain` subagents for full end-to-end pm workflow orchestration without leaving Claude Code.
+- Claude Code plugin: registered `pm` as the canonical marketplace ID so the plugin installs via `/plugin install pm-cli@pm` (both `pm` and `pm-cli` marketplace IDs resolve to the same plugin).
+- Claude Code plugin: rewrote session-start hook to use native `dist/pi/native.js` modules when available (repo checkout), falling back to `npx @unbrained/pm-cli` — no global `pm` CLI required.
+
 ## [2026.5.10] - 2026-05-10
 
 ### Changed

package/README.md

@@ -51,13 +51,21 @@ Project-local invocation also works:
 npx @unbrained/pm-cli --help
 ```
 
+For Claude Code, install the native plugin (no `pm` CLI required):
+
+```
+/plugin install pm-cli@pm
+```
+
+This registers 18 MCP tools, 5 workflow skills, 14 slash commands, 3 subagents, hybrid TUI tracking, and a session-start context hook — all without shelling out to the `pm` CLI.
+
 For Pi, install the native package integration after publish:
 
 ```bash
 pi install npm:@unbrained/pm-cli
 ```
 
-This registers a native `pm` tool, Pi skills, and prompt templates without requiring Pi to run the `pm` shell command.
+This registers a native `pm` tool, custom TUI panels/renderers (`/pm-board`, `/pm-item`, `/pm-history`), Pi skills, prompt templates, and optional pi-subagents setup without requiring Pi to run the `pm` shell command.
 
 ## 60 Second Example
 

package/dist/cli/argv-utils.d.ts

@@ -0,0 +1,5 @@
+export declare function normalizeLongFlag(flag: string): string;
+export declare function normalizeLongOptionFlag(token: string): string | undefined;
+export declare function extractProvidedOptionFlags(argv: string[]): string[];
+export declare function quoteCommandArg(arg: string): string;
+export declare function renderPmCommand(argv: string[]): string;

package/dist/cli/argv-utils.js

@@ -0,0 +1,34 @@
+export function normalizeLongFlag(flag) {
+    return `--${flag
+        .replace(/^--?/, "")
+        .replace(/_/g, "-")
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .toLowerCase()}`;
+}
+export function normalizeLongOptionFlag(token) {
+    if (!token.startsWith("--")) {
+        return undefined;
+    }
+    const key = token.includes("=") ? token.slice(0, token.indexOf("=")) : token;
+    return normalizeLongFlag(key);
+}
+export function extractProvidedOptionFlags(argv) {
+    const provided = new Set();
+    for (const token of argv) {
+        const normalized = normalizeLongOptionFlag(token);
+        if (normalized) {
+            provided.add(normalized);
+        }
+    }
+    return [...provided].sort((left, right) => left.localeCompare(right));
+}
+export function quoteCommandArg(arg) {
+    if (/^[A-Za-z0-9._:/@=-]+$/.test(arg)) {
+        return arg;
+    }
+    return `"${arg.replace(/(["\\$`])/g, "\\$1")}"`;
+}
+export function renderPmCommand(argv) {
+    return `pm ${argv.map((token) => quoteCommandArg(token)).join(" ")}`;
+}
+//# sourceMappingURL=argv-utils.js.map

package/dist/cli/argv-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argv-utils.js","sourceRoot":"/","sources":["cli/argv-utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,KAAK,IAAI;SACb,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,WAAW,EAAE,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7E,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAc;IACvD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,UAAU,EAAE,CAAC;YACf,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAc;IAC5C,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACvE,CAAC","sourcesContent":["export function normalizeLongFlag(flag: string): string {\n  return `--${flag\n    .replace(/^--?/, \"\")\n    .replace(/_/g, \"-\")\n    .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\n    .toLowerCase()}`;\n}\n\nexport function normalizeLongOptionFlag(token: string): string | undefined {\n  if (!token.startsWith(\"--\")) {\n    return undefined;\n  }\n  const key = token.includes(\"=\") ? token.slice(0, token.indexOf(\"=\")) : token;\n  return normalizeLongFlag(key);\n}\n\nexport function extractProvidedOptionFlags(argv: string[]): string[] {\n  const provided = new Set<string>();\n  for (const token of argv) {\n    const normalized = normalizeLongOptionFlag(token);\n    if (normalized) {\n      provided.add(normalized);\n    }\n  }\n  return [...provided].sort((left, right) => left.localeCompare(right));\n}\n\nexport function quoteCommandArg(arg: string): string {\n  if (/^[A-Za-z0-9._:/@=-]+$/.test(arg)) {\n    return arg;\n  }\n  return `\"${arg.replace(/([\"\\\\$`])/g, \"\\\\$1\")}\"`;\n}\n\nexport function renderPmCommand(argv: string[]): string {\n  return `pm ${argv.map((token) => quoteCommandArg(token)).join(\" \")}`;\n}\n"]}

package/dist/cli/bootstrap-args.d.ts

@@ -15,4 +15,19 @@ export declare function parseBootstrapHelpRequest(argv: string[]): BootstrapHelp
 export declare function parseBootstrapCommandName(argv: string[]): string | undefined;
 export declare function applyBootstrapPagerPolicy(argv: string[]): void;
 export declare function normalizeLegacyExtensionActionSyntax(argv: string[]): string[];
+type BootstrapNormalizationReason = "legacy_extension_action" | "flag_alias" | "flag_typo" | "bare_key_value";
+type BootstrapNormalizationConfidence = "high" | "medium";
+export interface BootstrapNormalizationEvent {
+    from: string;
+    to: string[];
+    reason: BootstrapNormalizationReason;
+    confidence: BootstrapNormalizationConfidence;
+}
+export interface BootstrapInvocationNormalizationResult {
+    argv: string[];
+    commandName: string | undefined;
+    trace: BootstrapNormalizationEvent[];
+}
+export declare function normalizeBootstrapInvocation(argv: string[]): BootstrapInvocationNormalizationResult;
 export declare function parseBootstrapTypeValue(argv: string[]): string | undefined;
+export {};