@unbrained/pm-cli 2026.5.31 → 2026.6.6

package/packages/pm-todos/extensions/todos/index.ts

@@ -1,4 +1,9 @@
-import type { CommandDefinition, ExtensionApi, GlobalOptions } from "../../../../src/sdk/index.js";
+import type {
+  ExtensionApi,
+  GlobalOptions,
+  ImportExportContext,
+  ImportExportRegistrationOptions,
+} from "../../../../src/sdk/index.js";
 import type { TodosExportOptions, TodosExportResult, TodosImportOptions, TodosImportResult } from "./runtime.js";
 import { loadPackageRuntimeModule } from "./runtime-loader.js";
 
@@ -7,7 +12,7 @@ export const manifest = {
   version: "0.1.0",
   entry: "./index.js",
   priority: 0,
-  capabilities: ["commands", "schema"],
+  capabilities: ["commands", "schema", "importers"],
 };
 
 type RuntimeModule = {
@@ -50,46 +55,54 @@ async function runTodosExportFromRuntime(options: TodosExportOptions, global: Gl
 }
 
 export function activate(api: ExtensionApi): void {
-  api.registerCommand({
-    name: "todos import",
-    action: "todos-import",
-    description: "Import Todo markdown files into pm items.",
-    flags: [
-      {
-        long: "--folder",
-        value_name: "path",
-        value_type: "string",
-        description: "Source folder containing Todo markdown files.",
-      },
-      {
-        long: "--author",
-        value_name: "author",
-        value_type: "string",
-        description: "Override import mutation author.",
-      },
-      {
-        long: "--message",
-        value_name: "text",
-        value_type: "string",
-        description: "Override import history message.",
-      },
-    ],
-    run: async (context) => runTodosImportFromRuntime(toImportOptions(context.options), context.global),
-  } satisfies CommandDefinition);
-  api.registerCommand({
-    name: "todos export",
-    action: "todos-export",
-    description: "Export pm items into Todo markdown files.",
-    flags: [
-      {
-        long: "--folder",
-        value_name: "path",
-        value_type: "string",
-        description: "Destination folder for exported Todo markdown files.",
-      },
-    ],
-    run: async (context) => runTodosExportFromRuntime(toExportOptions(context.options), context.global),
-  } satisfies CommandDefinition);
+  // First-party exemplar for the importers capability: registerImporter/
+  // registerExporter create the `todos import` / `todos export` command paths,
+  // and the options object keeps the command description + flags as discoverable
+  // as the previous registerCommand registration.
+  api.registerImporter(
+    "todos",
+    async (context: ImportExportContext) => runTodosImportFromRuntime(toImportOptions(context.options), context.global),
+    {
+      action: "todos-import",
+      description: "Import Todo markdown files into pm items.",
+      flags: [
+        {
+          long: "--folder",
+          value_name: "path",
+          value_type: "string",
+          description: "Source folder containing Todo markdown files.",
+        },
+        {
+          long: "--author",
+          value_name: "author",
+          value_type: "string",
+          description: "Override import mutation author.",
+        },
+        {
+          long: "--message",
+          value_name: "text",
+          value_type: "string",
+          description: "Override import history message.",
+        },
+      ],
+    } satisfies ImportExportRegistrationOptions,
+  );
+  api.registerExporter(
+    "todos",
+    async (context: ImportExportContext) => runTodosExportFromRuntime(toExportOptions(context.options), context.global),
+    {
+      action: "todos-export",
+      description: "Export pm items into Todo markdown files.",
+      flags: [
+        {
+          long: "--folder",
+          value_name: "path",
+          value_type: "string",
+          description: "Destination folder for exported Todo markdown files.",
+        },
+      ],
+    } satisfies ImportExportRegistrationOptions,
+  );
 }
 
 export default {

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

@@ -3,5 +3,17 @@
   "version": "0.1.0",
   "entry": "./index.js",
   "priority": 0,
-  "capabilities": ["commands", "schema"]
+  "capabilities": [
+    "commands",
+    "schema",
+    "importers"
+  ],
+  "manifest_version": 1,
+  "pm_min_version": "2026.5.0",
+  "activation": {
+    "commands": [
+      "todos export",
+      "todos import"
+    ]
+  }
 }

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

@@ -1,6 +1,6 @@
 {
   "name": "pm-claude",
-  "description": "Native pm CLI integration for Claude Code — 18 MCP tools, 5 workflow skills, 14 slash commands, 3 subagents (coordinator, 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 — 21 MCP tools, 5 workflow skills, 14 slash commands, 3 subagents (coordinator, 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 |
 |-----------|----------------|
-| **18 MCP tools** | Full pm surface: context, search, list, get, create, update, claim, release, close, comments, files, docs, test, validate, health, contracts, plan + `pm_run` for everything else |
+| **21 MCP tools** | Full pm surface: context, search, list, get, create, update, claim, release, close, comments, files, docs, notes, learnings, deps, test, validate, health, contracts, plan + `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 18 MCP tools, 5 skills, 14 slash commands, 4 subagents, hybrid TUI tracking, and the session hook in one step.
+This installs all 21 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 @unbrained/pm-cli pm-mcp
 ```
 
-This gives you the 18 MCP tools but not the skills, slash commands, or session hook.
+This gives you the 21 MCP tools but not the skills, slash commands, or session hook.
 
 ### Option D: Direct `.mcp.json` (project-scoped MCP only)
 
@@ -159,6 +159,9 @@ Spawn pm-triage-agent to set up the pm item for: add OAuth2 login support
 | `pm_comments` | List or add comments |
 | `pm_files` | Link/unlink files |
 | `pm_docs` | Link/unlink docs |
+| `pm_notes` | List or add notes |
+| `pm_learnings` | List or add learnings |
+| `pm_deps` | List/add/remove dependencies |
 | `pm_test` | Link or run tests |
 | `pm_validate` | Run validation checks |
 | `pm_health` | Run health diagnostics |
@@ -171,7 +174,7 @@ Spawn pm-triage-agent to set up the pm item for: add OAuth2 login support
 |------|---------|
 | `pm_run` | Any pm action not covered above — pass `action` field |
 
-**`pm_run` actions:** `init`, `calendar`, `activity`, `aggregate`, `dedupe-audit`, `normalize`, `reindex`, `extension`, `history`, `stats`, `append`, `notes`, `learnings`, `test-all`, `comments-audit`, `gc`, `templates-list`, `templates-save`, `templates-show`, `test-runs-list`, `test-runs-status`, `test-runs-logs`, `test-runs-stop`, `test-runs-resume`, `config`, `completion`
+**`pm_run` actions:** `init`, `calendar`, `activity`, `aggregate`, `dedupe-audit`, `normalize`, `reindex`, `extension`, `history`, `stats`, `append`, `test-all`, `comments-audit`, `gc`, `templates-list`, `templates-save`, `templates-show`, `test-runs-list`, `test-runs-status`, `test-runs-logs`, `test-runs-stop`, `test-runs-resume`, `config`, `completion`
 
 ## Hybrid TUI Sync Pattern
 

package/plugins/pm-claude/agents/pm-coordinator.md

@@ -29,7 +29,7 @@ For batch audits spanning many items, create one top-level `TaskCreate` for the
 
 ## Tools Available
 
-Use the `pm-mcp` MCP server tools: `pm_context`, `pm_search`, `pm_list`, `pm_get`, `pm_create`, `pm_update`, `pm_claim`, `pm_release`, `pm_close`, `pm_comments`, `pm_files`, `pm_docs`, `pm_test`, `pm_validate`, `pm_health`, `pm_contracts`, `pm_plan`, and `pm_run` for all other operations.
+Use the `pm-mcp` MCP server tools: `pm_context`, `pm_search`, `pm_list`, `pm_get`, `pm_create`, `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`, and `pm_run` for all other operations.
 
 Also use Claude Code's built-in `TaskCreate` and `TaskUpdate` tools for TUI panel display.
 

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 18 MCP tools available: `pm_context`, `pm_search`, `pm_list`, `pm_get`, `pm_create`, `pm_update`, `pm_claim`, `pm_release`, `pm_close`, `pm_comments`, `pm_files`, `pm_docs`, `pm_test`, `pm_validate`, `pm_health`, `pm_contracts`, `pm_plan`, `pm_run`
+   - All 21 MCP tools available: `pm_context`, `pm_search`, `pm_list`, `pm_get`, `pm_create`, `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`
    - 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/scripts/bundle-cli.mjs

@@ -1,30 +1,134 @@
 #!/usr/bin/env node
 
-import { readFile, rm, writeFile } from "node:fs/promises";
+import { lstat, mkdir, readdir, readFile, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { build } from "esbuild";
 
 const repoRoot = process.cwd();
 const entryPoint = path.join(repoRoot, "dist", "cli", "main.js");
 const outputDir = path.join(repoRoot, "dist", "cli-bundle");
+const lockDir = path.join(repoRoot, "dist", ".cli-bundle-build.lock");
 const binPath = path.join(repoRoot, "dist", "cli.js");
+const lockRetryMs = 250;
+const lockTimeoutMs = 120_000;
+const staleLockMs = 10 * 60_000;
+const bundleStaleRetentionMs = 10 * 60_000;
 
-await rm(outputDir, { recursive: true, force: true });
-
-await build({
-  entryPoints: [entryPoint],
-  outdir: outputDir,
-  bundle: true,
-  splitting: true,
-  format: "esm",
-  platform: "node",
-  target: ["node20"],
-  packages: "external",
-  sourcemap: true,
-  entryNames: "[name]",
-  chunkNames: "chunks/[name]-[hash]",
-  logLevel: "warning",
-});
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+async function acquireBundleBuildLock() {
+  await mkdir(path.dirname(lockDir), { recursive: true });
+  const startedAt = Date.now();
+  while (true) {
+    try {
+      await mkdir(lockDir);
+      return async () => {
+        await rm(lockDir, { recursive: true, force: true });
+      };
+    } catch (error) {
+      if (!error || typeof error !== "object" || !("code" in error) || error.code !== "EEXIST") {
+        throw error;
+      }
+      const lockStats = await stat(lockDir).catch((statError) => {
+        if (statError && typeof statError === "object" && "code" in statError && statError.code === "ENOENT") {
+          return null;
+        }
+        throw statError;
+      });
+      if (!lockStats) {
+        continue;
+      }
+      if (Date.now() - lockStats.mtimeMs > staleLockMs) {
+        const staleCandidateDir = `${lockDir}.stale.${Date.now()}.${Math.random().toString(36).slice(2)}`;
+        try {
+          await rename(lockDir, staleCandidateDir);
+          await rm(staleCandidateDir, { recursive: true, force: true });
+        } catch (staleError) {
+          if (
+            !staleError ||
+            typeof staleError !== "object" ||
+            !("code" in staleError) ||
+            !["ENOENT", "EEXIST", "ENOTEMPTY"].includes(String(staleError.code))
+          ) {
+            throw staleError;
+          }
+        }
+        continue;
+      }
+      if (Date.now() - startedAt > lockTimeoutMs) {
+        throw new Error(`Timed out waiting for bundle build lock at ${lockDir}`);
+      }
+      await sleep(lockRetryMs);
+    }
+  }
+}
+
+async function collectFiles(directory) {
+  const entries = await readdir(directory, { withFileTypes: true }).catch((error) => {
+    if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+      return [];
+    }
+    throw error;
+  });
+  const files = [];
+  for (const entry of entries) {
+    const absolutePath = path.join(directory, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...await collectFiles(absolutePath));
+      continue;
+    }
+    if (entry.isFile() || entry.isSymbolicLink()) {
+      files.push(absolutePath);
+    }
+  }
+  return files;
+}
+
+async function removeStaleBundleFiles(outputs) {
+  const expectedFiles = new Set(
+    Object.keys(outputs).map((outputPath) => path.resolve(repoRoot, outputPath)),
+  );
+  const existingFiles = await collectFiles(outputDir);
+  const now = Date.now();
+  await Promise.all(
+    existingFiles
+      .filter((filePath) => !expectedFiles.has(filePath))
+      .map(async (filePath) => {
+        const fileStats = await lstat(filePath).catch(() => null);
+        if (!fileStats || now - fileStats.mtimeMs < bundleStaleRetentionMs) {
+          return;
+        }
+        await unlink(filePath).catch(() => {});
+      }),
+  );
+}
+
+// Do not delete the live bundle before rebuilding. Agents often run docs,
+// dogfood, and build gates concurrently in one checkout; removing this folder
+// creates a transient broken `dist/cli.js` runtime.
+const releaseBundleBuildLock = await acquireBundleBuildLock();
+try {
+  const buildResult = await build({
+    entryPoints: [entryPoint],
+    outdir: outputDir,
+    bundle: true,
+    splitting: true,
+    format: "esm",
+    platform: "node",
+    target: ["node20"],
+    packages: "external",
+    sourcemap: true,
+    metafile: true,
+    entryNames: "[name]",
+    chunkNames: "chunks/[name]-[hash]",
+    logLevel: "warning",
+  });
+  await removeStaleBundleFiles(buildResult.metafile.outputs);
+} finally {
+  await releaseBundleBuildLock();
+}
 
 const binSource = await readFile(binPath, "utf8");
 const sourceImport = 'await import("./cli/main.js")';

package/dist/cli-bundle/chunks/activity-OWYSUZOY.js

@@ -1,17 +0,0 @@
-import {
-  runActivity
-} from "./chunk-L2FXEKDB.js";
-import "./chunk-LRBOHPUE.js";
-import "./chunk-JFWUHHS2.js";
-import "./chunk-SEXQN4KL.js";
-import "./chunk-BUPWJ3IJ.js";
-import "./chunk-4AEZR5EJ.js";
-import "./chunk-CEFIVZPG.js";
-import "./chunk-MD7K4JYF.js";
-import "./chunk-WDPXDQFG.js";
-import "./chunk-PVNQLCIS.js";
-import "./chunk-LSXGH6NE.js";
-export {
-  runActivity
-};
-//# sourceMappingURL=activity-OWYSUZOY.js.map