@unbrained/pm-cli 2026.5.12 → 2026.5.14

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

@@ -1,141 +1,130 @@
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-
 const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
 const CURRENT_EXTENSION_ROOT = path.dirname(fileURLToPath(import.meta.url));
-
 export const manifest = {
-  name: "builtin-todos-import-export",
-  version: "0.1.0",
-  entry: "./index.js",
-  priority: 0,
-  capabilities: ["commands", "schema"],
+    name: "builtin-todos-import-export",
+    version: "0.1.0",
+    entry: "./index.js",
+    priority: 0,
+    capabilities: ["commands", "schema"],
 };
-
 function asOptionalString(value) {
-  return typeof value === "string" ? value : undefined;
+    return typeof value === "string" ? value : undefined;
 }
-
 function toImportOptions(options) {
-  return {
-    folder: asOptionalString(options.folder),
-    author: asOptionalString(options.author),
-    message: asOptionalString(options.message),
-  };
+    return {
+        folder: asOptionalString(options.folder),
+        author: asOptionalString(options.author),
+        message: asOptionalString(options.message),
+    };
 }
-
 function toExportOptions(options) {
-  return {
-    folder: asOptionalString(options.folder),
-  };
+    return {
+        folder: asOptionalString(options.folder),
+    };
 }
-
 function resolvePackageRootCandidates() {
-  const candidates = [];
-  const envRoot = process.env[PM_PACKAGE_ROOT_ENV];
-  if (typeof envRoot === "string" && envRoot.trim().length > 0) {
-    candidates.push(path.resolve(envRoot.trim()));
-  }
-  const argvEntry = typeof process.argv[1] === "string" ? process.argv[1].trim() : "";
-  if (argvEntry.length > 0) {
-    const resolvedEntry = path.resolve(argvEntry);
-    const entryDir = path.dirname(resolvedEntry);
-    candidates.push(path.resolve(entryDir, ".."));
-    candidates.push(path.resolve(entryDir, "../.."));
-    candidates.push(path.resolve(entryDir, "../../.."));
-  }
-  return [...new Set(candidates)];
+    const candidates = [];
+    const envRoot = process.env[PM_PACKAGE_ROOT_ENV];
+    if (typeof envRoot === "string" && envRoot.trim().length > 0) {
+        candidates.push(path.resolve(envRoot.trim()));
+    }
+    const argvEntry = typeof process.argv[1] === "string" ? process.argv[1].trim() : "";
+    if (argvEntry.length > 0) {
+        const resolvedEntry = path.resolve(argvEntry);
+        const entryDir = path.dirname(resolvedEntry);
+        candidates.push(path.resolve(entryDir, ".."));
+        candidates.push(path.resolve(entryDir, "../.."));
+        candidates.push(path.resolve(entryDir, "../../.."));
+    }
+    return [...new Set(candidates)];
 }
-
 async function loadRuntimeModule() {
-  const attempted = [];
-  for (const packageRoot of resolvePackageRootCandidates()) {
-    const modulePaths = [
-      path.join(packageRoot, ".agents", "pm", "extensions", "todos", "runtime.js"),
-      path.join(packageRoot, "packages", "pm-todos", "extensions", "todos", "runtime.js"),
-    ];
-    for (const modulePath of modulePaths) {
-      attempted.push(modulePath);
-      try {
-        return await import(pathToFileURL(modulePath).href);
-      } catch {
-        // Try the next package-root candidate.
-      }
+    const attempted = [];
+    for (const packageRoot of resolvePackageRootCandidates()) {
+        const modulePaths = [
+            path.join(packageRoot, ".agents", "pm", "extensions", "todos", "runtime.js"),
+            path.join(packageRoot, "packages", "pm-todos", "extensions", "todos", "runtime.js"),
+        ];
+        for (const modulePath of modulePaths) {
+            attempted.push(modulePath);
+            try {
+                return await import(pathToFileURL(modulePath).href);
+            }
+            catch {
+                // Try the next package-root candidate.
+            }
+        }
+    }
+    const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.js");
+    attempted.push(localRuntimePath);
+    try {
+        return await import(pathToFileURL(localRuntimePath).href);
     }
-  }
-
-  const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.js");
-  attempted.push(localRuntimePath);
-  try {
-    return await import(pathToFileURL(localRuntimePath).href);
-  } catch {
-    // Fall through to the diagnostic below.
-  }
-
-  throw new Error(
-    "Unable to resolve packaged todos extension runtime module. " +
-      `Tried: ${attempted.join(", ")}. Ensure the installed extension includes runtime.js or PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
-  );
+    catch {
+        // Fall through to the diagnostic below.
+    }
+    throw new Error("Unable to resolve packaged todos extension runtime module. " +
+        `Tried: ${attempted.join(", ")}. Ensure the installed extension includes runtime.js or PM_CLI_PACKAGE_ROOT points to an installed pm package root.`);
 }
-
 async function runTodosImportFromRuntime(options, global) {
-  const runtime = await loadRuntimeModule();
-  if (typeof runtime.runTodosImport !== "function") {
-    throw new Error('Bundled todos runtime module is missing runTodosImport().');
-  }
-  return runtime.runTodosImport(options, global);
+    const runtime = await loadRuntimeModule();
+    if (typeof runtime.runTodosImport !== "function") {
+        throw new Error("Bundled todos runtime module is missing runTodosImport().");
+    }
+    return runtime.runTodosImport(options, global);
 }
-
 async function runTodosExportFromRuntime(options, global) {
-  const runtime = await loadRuntimeModule();
-  if (typeof runtime.runTodosExport !== "function") {
-    throw new Error('Bundled todos runtime module is missing runTodosExport().');
-  }
-  return runtime.runTodosExport(options, global);
+    const runtime = await loadRuntimeModule();
+    if (typeof runtime.runTodosExport !== "function") {
+        throw new Error("Bundled todos runtime module is missing runTodosExport().");
+    }
+    return runtime.runTodosExport(options, global);
 }
-
 export function activate(api) {
-  api.registerCommand({
-    name: "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),
-  });
-  api.registerCommand({
-    name: "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),
-  });
+    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),
+    });
+    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),
+    });
 }
-
 export default {
-  manifest,
-  activate,
+    manifest,
+    activate,
 };

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

@@ -1,7 +1,6 @@
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import type { CommandDefinition, ExtensionApi } from "../../../../src/core/extensions/loader.js";
-import type { GlobalOptions } from "../../../../src/core/shared/command-types.js";
+import type { CommandDefinition, ExtensionApi, GlobalOptions } from "../../../../src/sdk/index.js";
 import type { TodosExportOptions, TodosExportResult, TodosImportOptions, TodosImportResult } from "./runtime.js";
 
 const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
@@ -105,6 +104,7 @@ 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: [
       {
@@ -130,6 +130,7 @@ export function activate(api: ExtensionApi): void {
   } satisfies CommandDefinition);
   api.registerCommand({
     name: "todos export",
+    action: "todos-export",
     description: "Export pm items into Todo markdown files.",
     flags: [
       {

package/packages/pm-todos/extensions/todos/runtime.js

@@ -1,21 +1,6 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks } from "../../../../dist/core/extensions/index.js";
-import { pathExists, removeFileIfExists, writeFileAtomic } from "../../../../dist/core/fs/fs-utils.js";
-import { appendHistoryEntry, createHistoryEntry } from "../../../../dist/core/history/history.js";
-import { generateItemId, normalizeItemId } from "../../../../dist/core/item/id.js";
-import { canonicalDocument, normalizeFrontMatter, serializeItemDocument, splitFrontMatter } from "../../../../dist/core/item/item-format.js";
-import { normalizeStatusInput } from "../../../../dist/core/item/status.js";
-import { resolveItemTypeRegistry } from "../../../../dist/core/item/type-registry.js";
-import { parseTags } from "../../../../dist/core/item/parse.js";
-import { acquireLock } from "../../../../dist/core/lock/lock.js";
-import { EXIT_CODE } from "../../../../dist/core/shared/constants.js";
-import { PmCliError } from "../../../../dist/core/shared/errors.js";
-import { nowIso } from "../../../../dist/core/shared/time.js";
-import { listAllFrontMatter, locateItem, readLocatedItem } from "../../../../dist/core/store/item-store.js";
-import { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from "../../../../dist/core/store/paths.js";
-import { readSettings } from "../../../../dist/core/store/settings.js";
-import { CONFIDENCE_TEXT_VALUES, ISSUE_SEVERITY_VALUES, RISK_VALUES } from "../../../../dist/types/index.js";
+import { CONFIDENCE_TEXT_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, PmCliError, RISK_VALUES, acquireLock, appendHistoryEntry, canonicalDocument, createHistoryEntry, generateItemId, getActiveExtensionRegistrations, getHistoryPath, getItemPath, getSettingsPath, listAllFrontMatter, locateItem, normalizeFrontMatter, normalizeItemId, normalizeStatusInput, nowIso, parseTags, pathExists, readLocatedItem, readSettings, removeFileIfExists, resolveItemTypeRegistry, resolvePmRoot, runActiveOnReadHooks, runActiveOnWriteHooks, serializeItemDocument, splitFrontMatter, writeFileAtomic, } from "../../../../dist/sdk/index.js";
 const DEFAULT_TODOS_FOLDER = ".pm/todos";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -467,4 +452,4 @@ export async function runTodosExport(options, global) {
         ids,
         warnings,
     };
-}
+}

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

@@ -1,24 +1,46 @@
 import fs from "node:fs/promises";
 import type { Dirent } from "node:fs";
 import path from "node:path";
-import { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks } from "../../../../src/core/extensions/index.js";
-import { pathExists, removeFileIfExists, writeFileAtomic } from "../../../../src/core/fs/fs-utils.js";
-import { appendHistoryEntry, createHistoryEntry } from "../../../../src/core/history/history.js";
-import { generateItemId, normalizeItemId } from "../../../../src/core/item/id.js";
-import { canonicalDocument, normalizeFrontMatter, serializeItemDocument, splitFrontMatter } from "../../../../src/core/item/item-format.js";
-import { normalizeStatusInput } from "../../../../src/core/item/status.js";
-import { resolveItemTypeRegistry } from "../../../../src/core/item/type-registry.js";
-import { parseTags } from "../../../../src/core/item/parse.js";
-import { acquireLock } from "../../../../src/core/lock/lock.js";
-import { EXIT_CODE } from "../../../../src/core/shared/constants.js";
-import type { GlobalOptions } from "../../../../src/core/shared/command-types.js";
-import { PmCliError } from "../../../../src/core/shared/errors.js";
-import { nowIso } from "../../../../src/core/shared/time.js";
-import { listAllFrontMatter, locateItem, readLocatedItem } from "../../../../src/core/store/item-store.js";
-import { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from "../../../../src/core/store/paths.js";
-import { readSettings } from "../../../../src/core/store/settings.js";
-import { CONFIDENCE_TEXT_VALUES, ISSUE_SEVERITY_VALUES, RISK_VALUES } from "../../../../src/types/index.js";
-import type { ItemDocument, ItemMetadata, ItemStatus, ItemType, PmSettings } from "../../../../src/types/index.js";
+import {
+  CONFIDENCE_TEXT_VALUES,
+  EXIT_CODE,
+  ISSUE_SEVERITY_VALUES,
+  PmCliError,
+  RISK_VALUES,
+  acquireLock,
+  appendHistoryEntry,
+  canonicalDocument,
+  createHistoryEntry,
+  generateItemId,
+  getActiveExtensionRegistrations,
+  getHistoryPath,
+  getItemPath,
+  getSettingsPath,
+  listAllFrontMatter,
+  locateItem,
+  normalizeFrontMatter,
+  normalizeItemId,
+  normalizeStatusInput,
+  nowIso,
+  parseTags,
+  pathExists,
+  readLocatedItem,
+  readSettings,
+  removeFileIfExists,
+  resolveItemTypeRegistry,
+  resolvePmRoot,
+  runActiveOnReadHooks,
+  runActiveOnWriteHooks,
+  serializeItemDocument,
+  splitFrontMatter,
+  writeFileAtomic,
+  type GlobalOptions,
+  type ItemDocument,
+  type ItemMetadata,
+  type ItemStatus,
+  type ItemType,
+  type PmSettings,
+} from "../../../../src/sdk/index.js";
 
 const DEFAULT_TODOS_FOLDER = ".pm/todos";
 

package/packages/pm-todos/package.json

@@ -4,14 +4,48 @@
   "private": true,
   "type": "module",
   "description": "First-party pm package for Todo markdown import and export.",
+  "homepage": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unbraind/pm-cli.git",
+    "directory": "packages/pm-todos"
+  },
+  "bugs": {
+    "url": "https://github.com/unbraind/pm-cli/issues"
+  },
   "keywords": [
     "pm-package",
     "project-management",
     "todos"
   ],
   "pm": {
+    "aliases": [
+      "todos"
+    ],
     "extensions": [
       "extensions/todos"
+    ],
+    "catalog": {
+      "display_name": "Todos Import/Export",
+      "category": "migration",
+      "summary": "Import and export Todo markdown tasks through pm package commands.",
+      "tags": [
+        "migration",
+        "todos",
+        "import",
+        "export"
+      ],
+      "links": {
+        "docs": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos#readme",
+        "repository": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos",
+        "report": "https://github.com/unbraind/pm-cli/issues"
+      }
+    },
+    "docs": [
+      "README.md"
+    ],
+    "examples": [
+      "README.md"
     ]
   }
 }

package/plugins/pm-cli-claude/scripts/pm-mcp-server.mjs

@@ -39,11 +39,13 @@ async function findRepoServer() {
 
 const explicitServer = process.env.PM_CLI_MCP_SERVER;
 if (explicitServer && (await exists(explicitServer))) {
-  await import(pathToFileURL(explicitServer).href);
+  const server = await import(pathToFileURL(explicitServer).href);
+  server.startMcpServer();
 } else {
   const repoServer = await findRepoServer();
   if (repoServer) {
-    await import(pathToFileURL(repoServer).href);
+    const server = await import(pathToFileURL(repoServer).href);
+    server.startMcpServer();
   } else {
     const child = spawn("npx", ["-y", "--package=@unbrained/pm-cli@latest", "pm-mcp"], {
       stdio: "inherit",

package/plugins/pm-cli-codex/scripts/pm-mcp-server.mjs

@@ -33,11 +33,13 @@ async function findRepoServer() {
 
 const explicitServer = process.env.PM_CLI_MCP_SERVER;
 if (explicitServer && await exists(explicitServer)) {
-  await import(pathToFileURL(explicitServer).href);
+  const server = await import(pathToFileURL(explicitServer).href);
+  server.startMcpServer();
 } else {
   const repoServer = await findRepoServer();
   if (repoServer) {
-    await import(pathToFileURL(repoServer).href);
+    const server = await import(pathToFileURL(repoServer).href);
+    server.startMcpServer();
   } else {
     const child = spawn("npx", ["-y", "@unbrained/pm-cli@latest", "pm-mcp"], {
       stdio: "inherit",