@unbrained/pm-cli 2026.5.24 → 2026.5.28

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

@@ -1,7 +1,4 @@
-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));
+import { loadPackageRuntimeModule } from "./runtime-loader.js";
 export const manifest = {
     name: "builtin-todos-import-export",
     version: "0.1.0",
@@ -24,59 +21,15 @@ function toExportOptions(options) {
         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 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);
-    }
-    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();
+    const runtime = await loadPackageRuntimeModule();
     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();
+    const runtime = await loadPackageRuntimeModule();
     if (typeof runtime.runTodosExport !== "function") {
         throw new Error("Bundled todos runtime module is missing runTodosExport().");
     }

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

@@ -1,10 +1,6 @@
-import path from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
 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";
-const CURRENT_EXTENSION_ROOT = path.dirname(fileURLToPath(import.meta.url));
+import { loadPackageRuntimeModule } from "./runtime-loader.js";
 
 export const manifest = {
   name: "builtin-todos-import-export",
@@ -37,56 +33,8 @@ function toExportOptions(options: Record<string, unknown>): TodosExportOptions {
   };
 }
 
-function resolvePackageRootCandidates(): string[] {
-  const candidates: string[] = [];
-  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(): Promise<RuntimeModule> {
-  const attempted: string[] = [];
-  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) as RuntimeModule;
-      } 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) as RuntimeModule;
-  } 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: TodosImportOptions, global: GlobalOptions): Promise<TodosImportResult> {
-  const runtime = await loadRuntimeModule();
+  const runtime = await loadPackageRuntimeModule() as RuntimeModule;
   if (typeof runtime.runTodosImport !== "function") {
     throw new Error("Bundled todos runtime module is missing runTodosImport().");
   }
@@ -94,7 +42,7 @@ async function runTodosImportFromRuntime(options: TodosImportOptions, global: Gl
 }
 
 async function runTodosExportFromRuntime(options: TodosExportOptions, global: GlobalOptions): Promise<TodosExportResult> {
-  const runtime = await loadRuntimeModule();
+  const runtime = await loadPackageRuntimeModule() as RuntimeModule;
   if (typeof runtime.runTodosExport !== "function") {
     throw new Error("Bundled todos runtime module is missing runTodosExport().");
   }

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

@@ -0,0 +1,86 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+/**
+ * GENERATED by scripts/gen-package-runtime-loaders.mjs - do not edit directly.
+ * This file is shipped with the package extension and intentionally avoids
+ * static SDK imports so project-local installed extensions can load it.
+ */
+
+const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+const CURRENT_EXTENSION_ROOT = path.dirname(fileURLToPath(import.meta.url));
+const EXTENSION_NAME = "todos";
+const PACKAGE_NAME = "pm-todos";
+const DIAGNOSTIC_NAME = "todos";
+
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+
+function isMissingRuntimeModuleError(error, modulePath) {
+  if (!isRecord(error) || error.code !== "ERR_MODULE_NOT_FOUND") {
+    return false;
+  }
+  const message = typeof error.message === "string" ? error.message : "";
+  const moduleUrl = pathToFileURL(modulePath).href;
+  return message.includes(modulePath) || message.includes(moduleUrl);
+}
+
+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)];
+}
+
+export async function loadPackageRuntimeModule() {
+  const attempted = [];
+  for (const packageRoot of resolvePackageRootCandidates()) {
+    const modulePaths = [
+      path.join(packageRoot, ".agents", "pm", "extensions", EXTENSION_NAME, "runtime.js"),
+      path.join(packageRoot, "packages", PACKAGE_NAME, "extensions", EXTENSION_NAME, "runtime.js"),
+    ];
+    for (const modulePath of modulePaths) {
+      attempted.push(modulePath);
+      if (!existsSync(modulePath)) {
+        continue;
+      }
+      try {
+        return await import(pathToFileURL(modulePath).href);
+      } catch (error) {
+        if (isMissingRuntimeModuleError(error, modulePath)) {
+          continue;
+        }
+        throw error;
+      }
+    }
+  }
+
+  const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.js");
+  attempted.push(localRuntimePath);
+  if (existsSync(localRuntimePath)) {
+    try {
+      return await import(pathToFileURL(localRuntimePath).href);
+    } catch (error) {
+      if (!isMissingRuntimeModuleError(error, localRuntimePath)) {
+        throw error;
+      }
+    }
+  }
+
+  throw new Error(
+    `Unable to resolve packaged ${DIAGNOSTIC_NAME} 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.`,
+  );
+}

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

@@ -0,0 +1,88 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+/**
+ * GENERATED by scripts/gen-package-runtime-loaders.mjs - do not edit directly.
+ * This file is shipped with the package extension and intentionally avoids
+ * static SDK imports so project-local installed extensions can load it.
+ */
+
+const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+const CURRENT_EXTENSION_ROOT = path.dirname(fileURLToPath(import.meta.url));
+const EXTENSION_NAME = "todos";
+const PACKAGE_NAME = "pm-todos";
+const DIAGNOSTIC_NAME = "todos";
+
+export type PackageRuntimeModule = Record<string, unknown>;
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null;
+}
+
+function isMissingRuntimeModuleError(error: unknown, modulePath: string): boolean {
+  if (!isRecord(error) || error.code !== "ERR_MODULE_NOT_FOUND") {
+    return false;
+  }
+  const message = typeof error.message === "string" ? error.message : "";
+  const moduleUrl = pathToFileURL(modulePath).href;
+  return message.includes(modulePath) || message.includes(moduleUrl);
+}
+
+function resolvePackageRootCandidates(): string[] {
+  const candidates: string[] = [];
+  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)];
+}
+
+export async function loadPackageRuntimeModule(): Promise<PackageRuntimeModule> {
+  const attempted: string[] = [];
+  for (const packageRoot of resolvePackageRootCandidates()) {
+    const modulePaths = [
+      path.join(packageRoot, ".agents", "pm", "extensions", EXTENSION_NAME, "runtime.js"),
+      path.join(packageRoot, "packages", PACKAGE_NAME, "extensions", EXTENSION_NAME, "runtime.js"),
+    ];
+    for (const modulePath of modulePaths) {
+      attempted.push(modulePath);
+      if (!existsSync(modulePath)) {
+        continue;
+      }
+      try {
+        return await import(pathToFileURL(modulePath).href) as PackageRuntimeModule;
+      } catch (error: unknown) {
+        if (isMissingRuntimeModuleError(error, modulePath)) {
+          continue;
+        }
+        throw error;
+      }
+    }
+  }
+
+  const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.js");
+  attempted.push(localRuntimePath);
+  if (existsSync(localRuntimePath)) {
+    try {
+      return await import(pathToFileURL(localRuntimePath).href) as PackageRuntimeModule;
+    } catch (error: unknown) {
+      if (!isMissingRuntimeModuleError(error, localRuntimePath)) {
+        throw error;
+      }
+    }
+  }
+
+  throw new Error(
+    `Unable to resolve packaged ${DIAGNOSTIC_NAME} 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.`,
+  );
+}

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

@@ -1,17 +1,15 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-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";
+import { CONFIDENCE_TEXT_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, PmCliError, RISK_VALUES, canonicalDocument, commitImportedItem, generateItemId, getActiveExtensionRegistrations, getItemPath, listAllFrontMatter, locateItem, normalizeFrontMatter, normalizeItemId, nowIso, readLocatedItem, readSettings, resolveItemTypeRegistry, resolvePmRoot, runActiveOnReadHooks, runActiveOnWriteHooks, selectImportAuthor, splitFrontMatter, ensureTrackerInitialized, toEstimatedMinutesValue, toImportPriority, toImportStatus, toImportTags, toNonEmptyImportString, writeFileAtomic, } from "../../../../dist/sdk/index.js";
 const DEFAULT_TODOS_FOLDER = ".pm/todos";
+// Shared, behavior-identical value coercers are sourced from the SDK adapter
+// surface; package-specific mappings (lenient timestamps, type-name resolution,
+// confidence/enum coercion) stay local below.
+const toNonEmptyString = toNonEmptyImportString;
+const toEstimatedMinutes = toEstimatedMinutesValue;
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function toNonEmptyString(value) {
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : undefined;
-}
 function toIsoString(value) {
     const raw = toNonEmptyString(value);
     if (!raw) {
@@ -23,18 +21,6 @@ function toIsoString(value) {
     }
     return new Date(timestamp).toISOString();
 }
-function toEstimatedMinutes(value) {
-    if (typeof value === "number" && Number.isFinite(value) && value >= 0) {
-        return value;
-    }
-    if (typeof value === "string" && value.trim().length > 0) {
-        const parsed = Number(value);
-        if (Number.isFinite(parsed) && parsed >= 0) {
-            return parsed;
-        }
-    }
-    return undefined;
-}
 function toInteger(value) {
     if (typeof value === "number" && Number.isInteger(value)) {
         return value;
@@ -47,18 +33,7 @@ function toInteger(value) {
     }
     return undefined;
 }
-function toPriority(value) {
-    if (typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= 4) {
-        return value;
-    }
-    if (typeof value === "string" && value.trim().length > 0) {
-        const parsed = Number(value);
-        if (Number.isInteger(parsed) && parsed >= 0 && parsed <= 4) {
-            return parsed;
-        }
-    }
-    return 2;
-}
+const toPriority = toImportPriority;
 function toConfidence(value) {
     if (typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= 100) {
         return value;
@@ -119,19 +94,7 @@ function toBoolean(value) {
     }
     return undefined;
 }
-function toTags(value) {
-    if (Array.isArray(value)) {
-        const tags = value
-            .filter((entry) => typeof entry === "string")
-            .map((entry) => entry.trim().toLowerCase())
-            .filter((entry) => entry.length > 0);
-        return Array.from(new Set(tags)).sort((left, right) => left.localeCompare(right));
-    }
-    if (typeof value === "string") {
-        return parseTags(value);
-    }
-    return [];
-}
+const toTags = toImportTags;
 function toItemType(value, typeNames) {
     const normalized = toNonEmptyString(value)?.toLowerCase();
     const fallbackType = typeNames.find((entry) => entry.toLowerCase() === "task") ?? typeNames[0] ?? "Task";
@@ -145,37 +108,12 @@ function toItemType(value, typeNames) {
     }
     return fallbackType;
 }
-function toStatus(value) {
-    const normalized = toNonEmptyString(value);
-    if (normalized) {
-        const canonical = normalizeStatusInput(normalized);
-        if (canonical) {
-            return canonical;
-        }
-    }
-    return "open";
-}
-function selectAuthor(explicitAuthor, settingsAuthor) {
-    const candidate = explicitAuthor ?? process.env.PM_AUTHOR ?? settingsAuthor;
-    const trimmed = candidate.trim();
-    return trimmed.length > 0 ? trimmed : "unknown";
-}
-function ensureInitHasRun(pmRoot) {
-    return pathExists(getSettingsPath(pmRoot)).then((exists) => {
-        if (!exists) {
-            throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-        }
-    });
-}
+const toStatus = toImportStatus;
+const selectAuthor = selectImportAuthor;
+const ensureInitHasRun = ensureTrackerInitialized;
 function normalizeBody(body) {
     return body.replace(/^\n+/, "").replace(/\s+$/, "");
 }
-function emptyDocument() {
-    return {
-        metadata: {},
-        body: "",
-    };
-}
 function resolveFolderPath(rawPath) {
     return path.isAbsolute(rawPath) ? rawPath : path.resolve(process.cwd(), rawPath);
 }
@@ -296,51 +234,20 @@ async function importTodoCandidate(candidate, runtime) {
         }),
         body: candidate.body,
     });
-    const historyPath = getHistoryPath(runtime.pmRoot, id);
-    let writeWarnings = [];
-    try {
-        const releaseLock = await acquireLock(runtime.pmRoot, id, runtime.settings.locks.ttl_seconds, runtime.author);
-        try {
-            await writeFileAtomic(itemPath, serializeItemDocument(afterDocument, { format: "toon" }));
-            try {
-                const historyEntry = createHistoryEntry({
-                    nowIso: nowIso(),
-                    author: runtime.author,
-                    op: "import",
-                    before: emptyDocument(),
-                    after: afterDocument,
-                    message: runtime.message,
-                });
-                await appendHistoryEntry(historyPath, historyEntry);
-                writeWarnings = [
-                    ...(await runActiveOnWriteHooks({
-                        path: itemPath,
-                        scope: "project",
-                        op: "import",
-                    })),
-                    ...(await runActiveOnWriteHooks({
-                        path: historyPath,
-                        scope: "project",
-                        op: "import:history",
-                    })),
-                ];
-            }
-            catch (error) {
-                await removeFileIfExists(itemPath);
-                throw error;
-            }
-        }
-        finally {
-            await releaseLock();
-        }
-    }
-    catch (error) {
-        if (error instanceof PmCliError && error.exitCode === EXIT_CODE.CONFLICT) {
-            return { warning: `todos_import_lock_conflict:${id}` };
-        }
-        throw error;
+    const commit = await commitImportedItem({
+        pmRoot: runtime.pmRoot,
+        id,
+        itemPath,
+        document: afterDocument,
+        author: runtime.author,
+        message: runtime.message,
+        settings: runtime.settings,
+        conflictWarningPrefix: "todos_import_lock_conflict",
+    });
+    if (!commit.committed) {
+        return { warning: commit.conflictWarning };
     }
-    return { id, writeWarnings };
+    return { id, writeWarnings: commit.writeWarnings };
 }
 export async function runTodosImport(options, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);