@unbrained/pm-cli 2026.3.12 → 2026.5.1

package/.agents/pm/extensions/todos/index.js

@@ -0,0 +1,126 @@
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+
+const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+
+export const manifest = {
+  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;
+}
+
+function toImportOptions(options) {
+  return {
+    folder: asOptionalString(options.folder),
+    author: asOptionalString(options.author),
+    message: asOptionalString(options.message),
+  };
+}
+
+function toExportOptions(options) {
+  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)];
+}
+
+async function loadRuntimeModule() {
+  const attempted = [];
+  for (const packageRoot of resolvePackageRootCandidates()) {
+    const modulePath = path.join(packageRoot, ".agents", "pm", "extensions", "todos", "runtime.js");
+    attempted.push(modulePath);
+    try {
+      return await import(pathToFileURL(modulePath).href);
+    } catch {
+      // Try the next package-root candidate.
+    }
+  }
+  throw new Error(
+    "Unable to resolve bundled todos extension runtime module. " +
+      `Tried: ${attempted.join(", ")}. Ensure 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);
+}
+
+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);
+}
+
+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),
+  });
+}
+
+export default {
+  manifest,
+  activate,
+};

package/.agents/pm/extensions/todos/manifest.json

@@ -0,0 +1,7 @@
+{
+  "name": "builtin-todos-import-export",
+  "version": "0.1.0",
+  "entry": "./index.js",
+  "priority": 0,
+  "capabilities": ["commands", "schema"]
+}

package/{dist/extensions/builtins/todos/import-export.js → .agents/pm/extensions/todos/runtime.js}

@@ -1,19 +1,21 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { runActiveOnReadHooks, runActiveOnWriteHooks } from "../../../core/extensions/index.js";
-import { pathExists, removeFileIfExists, writeFileAtomic } from "../../../core/fs/fs-utils.js";
-import { appendHistoryEntry, createHistoryEntry } from "../../../core/history/history.js";
-import { generateItemId, normalizeItemId } from "../../../core/item/id.js";
-import { canonicalDocument, normalizeFrontMatter, serializeItemDocument, splitFrontMatter } from "../../../core/item/item-format.js";
-import { parseTags } from "../../../core/item/parse.js";
-import { acquireLock } from "../../../core/lock/lock.js";
-import { EXIT_CODE } from "../../../core/shared/constants.js";
-import { PmCliError } from "../../../core/shared/errors.js";
-import { nowIso } from "../../../core/shared/time.js";
-import { listAllFrontMatter, locateItem, readLocatedItem } from "../../../core/store/item-store.js";
-import { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from "../../../core/store/paths.js";
-import { readSettings } from "../../../core/store/settings.js";
-import { CONFIDENCE_TEXT_VALUES, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, RISK_VALUES, STATUS_VALUES } from "../../../types/index.js";
+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";
 const DEFAULT_TODOS_FOLDER = ".pi/todos";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -145,22 +147,26 @@ function toTags(value) {
     }
     return [];
 }
-function toItemType(value) {
+function toItemType(value, typeNames) {
     const normalized = toNonEmptyString(value)?.toLowerCase();
+    const fallbackType = typeNames.find((entry) => entry.toLowerCase() === "task") ?? typeNames[0] ?? "Task";
     if (!normalized) {
-        return "Task";
+        return fallbackType;
     }
-    for (const candidate of ITEM_TYPE_VALUES) {
+    for (const candidate of typeNames) {
         if (candidate.toLowerCase() === normalized) {
             return candidate;
         }
     }
-    return "Task";
+    return fallbackType;
 }
 function toStatus(value) {
-    const normalized = toNonEmptyString(value)?.toLowerCase();
-    if (normalized && STATUS_VALUES.includes(normalized)) {
-        return normalized;
+    const normalized = toNonEmptyString(value);
+    if (normalized) {
+        const canonical = normalizeStatusInput(normalized);
+        if (canonical) {
+            return canonical;
+        }
     }
     return "open";
 }
@@ -243,11 +249,12 @@ async function importTodoCandidate(candidate, runtime) {
         : await generateItemId(runtime.pmRoot, runtime.settings.id_prefix);
     const createdAt = toIsoString(candidate.frontMatter.created_at) ?? nowIso();
     const updatedAt = toIsoString(candidate.frontMatter.updated_at) ?? createdAt;
-    const type = toItemType(candidate.frontMatter.type);
-    const itemPath = getItemPath(runtime.pmRoot, type, id);
-    if (await pathExists(itemPath)) {
+    const type = toItemType(candidate.frontMatter.type, runtime.typeNames);
+    const located = await locateItem(runtime.pmRoot, id, runtime.settings.id_prefix, runtime.settings.item_format, runtime.typeToFolder);
+    if (located) {
         return { warning: `todos_import_item_exists:${id}` };
     }
+    const itemPath = getItemPath(runtime.pmRoot, type, id, runtime.settings.item_format, runtime.typeToFolder);
     const afterDocument = canonicalDocument({
         front_matter: normalizeFrontMatter({
             id,
@@ -309,7 +316,7 @@ async function importTodoCandidate(candidate, runtime) {
     try {
         const releaseLock = await acquireLock(runtime.pmRoot, id, runtime.settings.locks.ttl_seconds, runtime.author);
         try {
-            await writeFileAtomic(itemPath, serializeItemDocument(afterDocument));
+            await writeFileAtomic(itemPath, serializeItemDocument(afterDocument, { format: runtime.settings.item_format }));
             try {
                 const historyEntry = createHistoryEntry({
                     nowIso: nowIso(),
@@ -354,6 +361,7 @@ export async function runTodosImport(options, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     await ensureInitHasRun(pmRoot);
     const settings = await readSettings(pmRoot);
+    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
     const folder = toNonEmptyString(options.folder) ?? DEFAULT_TODOS_FOLDER;
     const sourceFolder = resolveFolderPath(folder);
     let entries;
@@ -381,6 +389,8 @@ export async function runTodosImport(options, global) {
         pmRoot,
         sourceFolder,
         settings,
+        typeNames: typeRegistry.types,
+        typeToFolder: typeRegistry.type_to_folder,
         author,
         message,
     };
@@ -415,16 +425,17 @@ export async function runTodosExport(options, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     await ensureInitHasRun(pmRoot);
     const settings = await readSettings(pmRoot);
+    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
     const folder = toNonEmptyString(options.folder) ?? DEFAULT_TODOS_FOLDER;
     const destinationFolder = resolveFolderPath(folder);
     await fs.mkdir(destinationFolder, { recursive: true });
     const warnings = [];
     const ids = [];
     let exported = 0;
-    const items = await listAllFrontMatter(pmRoot);
+    const items = await listAllFrontMatter(pmRoot, settings.item_format, typeRegistry.type_to_folder);
     const sorted = [...items].sort((left, right) => left.id.localeCompare(right.id));
     for (const item of sorted) {
-        const located = await locateItem(pmRoot, item.id, settings.id_prefix);
+        const located = await locateItem(pmRoot, item.id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);
         if (!located) {
             warnings.push(`todos_export_missing_item:${item.id}`);
             continue;
@@ -456,5 +467,4 @@ export async function runTodosExport(options, global) {
         ids,
         warnings,
     };
-}
-//# sourceMappingURL=import-export.js.map
+}