@unbrained/pm-cli 2026.6.23 → 2026.6.30

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

@@ -1,132 +0,0 @@
-import {
-  runTemplatesList as runTemplatesListPackage,
-  runTemplatesSave as runTemplatesSavePackage,
-  runTemplatesShow as runTemplatesShowPackage,
-} from "./runtime.js";
-
-export const manifest = {
-  name: "builtin-templates",
-  version: "0.1.0",
-  entry: "./index.js",
-  priority: 0,
-  capabilities: ["commands", "schema"],
-};
-
-function onlyArg(args, commandName) {
-  const value = args[0];
-  if (typeof value === "string" && value.trim().length > 0) {
-    if (args.length > 1) {
-      throw new Error(`${commandName} accepts exactly one template name argument.`);
-    }
-    return value;
-  }
-  throw new Error(`${commandName} requires a template name argument.`);
-}
-
-function optionKeys(options) {
-  return Object.entries(options)
-    .filter(([, value]) => value !== undefined && value !== false)
-    .map(([key]) => key)
-    .sort();
-}
-
-function assertListInvocation(args, options, commandName) {
-  const unexpectedSubcommand = args.find((arg) => arg.trim().length > 0);
-  if (unexpectedSubcommand) {
-    throw new Error(
-      `Unknown pm templates subcommand "${unexpectedSubcommand}". Allowed: list, save, show. Apply a saved template with pm create <type> <title> --template <name>.`,
-    );
-  }
-  const unexpectedOptions = optionKeys(options);
-  if (unexpectedOptions.length > 0) {
-    throw new Error(
-      `pm ${commandName} does not accept options: ${unexpectedOptions.map((key) => `--${key}`).join(", ")}. Allowed subcommands: list, save, show. Save defaults with pm templates save <name> ... or apply them with pm create <type> <title> --template <name>.`,
-    );
-  }
-}
-
-async function runTemplatesListFromRuntime(global) {
-  return runTemplatesListPackage(global);
-}
-
-async function runTemplatesSaveFromRuntime(args, options, global) {
-  return runTemplatesSavePackage(onlyArg(args, "templates save"), options, global);
-}
-
-async function runTemplatesShowFromRuntime(args, global) {
-  return runTemplatesShowPackage(onlyArg(args, "templates show"), global);
-}
-
-const createOptionFlags = [
-  { long: "--title", short: "-t", value_name: "value", value_type: "string", description: "Template default item title." },
-  { long: "--description", short: "-d", value_name: "value", value_type: "string", description: "Template default item description." },
-  { long: "--type", value_name: "value", value_type: "string", description: "Template default item type." },
-  { long: "--status", short: "-s", value_name: "value", value_type: "string", description: "Template default item status." },
-  { long: "--priority", short: "-p", value_name: "value", value_type: "string", description: "Template default priority 0..4." },
-  { long: "--tags", value_name: "value", value_type: "string", description: "Template default comma-separated tags." },
-  { long: "--body", short: "-b", value_name: "value", value_type: "string", description: "Template default item markdown body." },
-  { long: "--deadline", value_name: "value", value_type: "string", description: "Template default deadline." },
-  { long: "--estimate", value_name: "value", value_type: "string", description: "Template default estimated minutes." },
-  { long: "--estimated-minutes", value_name: "value", value_type: "string", description: "Template default estimated minutes." },
-  { long: "--acceptance-criteria", value_name: "value", value_type: "string", description: "Template default acceptance criteria." },
-  { long: "--ac", value_name: "value", value_type: "string", description: "Alias for --acceptance-criteria." },
-  { long: "--author", value_name: "value", value_type: "string", description: "Template default mutation author." },
-  { long: "--message", value_name: "value", value_type: "string", description: "Template default history message." },
-  { long: "--assignee", value_name: "value", value_type: "string", description: "Template default assignee." },
-  { long: "--parent", value_name: "value", value_type: "string", description: "Template default parent item ID." },
-  { long: "--reviewer", value_name: "value", value_type: "string", description: "Template default reviewer." },
-  { long: "--risk", value_name: "value", value_type: "string", description: "Template default risk level." },
-  { long: "--confidence", value_name: "value", value_type: "string", description: "Template default confidence." },
-  { long: "--sprint", value_name: "value", value_type: "string", description: "Template default sprint identifier." },
-  { long: "--release", value_name: "value", value_type: "string", description: "Template default release identifier." },
-  { long: "--dep", value_name: "value", value_type: "string", description: "Template default dependency seed.", repeatable: true },
-  { long: "--comment", value_name: "value", value_type: "string", description: "Template default comment seed.", repeatable: true },
-  { long: "--note", value_name: "value", value_type: "string", description: "Template default note seed.", repeatable: true },
-  { long: "--learning", value_name: "value", value_type: "string", description: "Template default learning seed.", repeatable: true },
-  { long: "--file", value_name: "value", value_type: "string", description: "Template default linked file seed.", repeatable: true },
-  { long: "--test", value_name: "value", value_type: "string", description: "Template default linked test seed.", repeatable: true },
-  { long: "--doc", value_name: "value", value_type: "string", description: "Template default linked doc seed.", repeatable: true },
-  { long: "--reminder", value_name: "value", value_type: "string", description: "Template default reminder seed.", repeatable: true },
-  { long: "--event", value_name: "value", value_type: "string", description: "Template default event seed.", repeatable: true },
-];
-
-export function activate(api) {
-  api.registerCommand({
-    name: "templates",
-    action: "templates-list",
-    description: "List saved create templates.",
-    run: async (context) => {
-      assertListInvocation(context.args, context.options, "templates");
-      return runTemplatesListFromRuntime(context.global);
-    },
-  });
-  api.registerCommand({
-    name: "templates list",
-    action: "templates-list",
-    description: "List saved create templates.",
-    run: async (context) => {
-      assertListInvocation(context.args, context.options, "templates list");
-      return runTemplatesListFromRuntime(context.global);
-    },
-  });
-  api.registerCommand({
-    name: "templates save",
-    action: "templates-save",
-    description: "Save reusable create template defaults.",
-    arguments: [{ name: "name", required: true, description: "Template name." }],
-    flags: [...createOptionFlags],
-    run: async (context) => runTemplatesSaveFromRuntime(context.args, context.options, context.global),
-  });
-  api.registerCommand({
-    name: "templates show",
-    action: "templates-show",
-    description: "Show a saved create template.",
-    arguments: [{ name: "name", required: true, description: "Template name." }],
-    run: async (context) => runTemplatesShowFromRuntime(context.args, context.global),
-  });
-}
-
-export default {
-  manifest,
-  activate,
-};

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

@@ -1,35 +0,0 @@
-import path from "node:path";
-import { pathToFileURL } from "node:url";
-const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
-const sdk = await loadTemplatesSdkModule();
-async function loadTemplatesSdkModule() {
-  const envRoot = process.env[PM_PACKAGE_ROOT_ENV];
-  if (typeof envRoot !== "string" || envRoot.trim().length === 0) {
-    throw new Error(`builtin-templates requires ${PM_PACKAGE_ROOT_ENV} to locate core SDK runtime exports.`);
-  }
-  const modulePath = path.join(path.resolve(envRoot.trim()), "dist", "sdk", "index.js");
-  try {
-    const loaded = await import(pathToFileURL(modulePath).href);
-    if (typeof loaded.loadCreateTemplateOptions === "function" &&
-      typeof loaded.runTemplatesList === "function" &&
-      typeof loaded.runTemplatesSave === "function" &&
-      typeof loaded.runTemplatesShow === "function") {
-      return loaded;
-    }
-  } catch {
-    // Fall through to deterministic failure message below.
-  }
-  throw new Error(`builtin-templates failed to load template runtime exports from ${modulePath}.`);
-}
-export async function loadCreateTemplateOptions(pmRoot, rawTemplateName) {
-  return sdk.loadCreateTemplateOptions(pmRoot, rawTemplateName);
-}
-export async function runTemplatesSave(rawTemplateName, options, global) {
-  return sdk.runTemplatesSave(rawTemplateName, options, global);
-}
-export async function runTemplatesList(global) {
-  return sdk.runTemplatesList(global);
-}
-export async function runTemplatesShow(rawTemplateName, global) {
-  return sdk.runTemplatesShow(rawTemplateName, global);
-}

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

@@ -1,81 +0,0 @@
-import { loadPackageRuntimeModule } from "./runtime-loader.js";
-export const manifest = {
-    name: "builtin-todos-import-export",
-    version: "0.1.0",
-    entry: "./index.js",
-    priority: 0,
-    capabilities: ["commands", "schema", "importers"],
-};
-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),
-    };
-}
-async function runTodosImportFromRuntime(options, global) {
-    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 loadPackageRuntimeModule();
-    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.registerImporter("todos", async (context) => runTodosImportFromRuntime(toImportOptions(context.options), context.global), {
-        action: "todos-import",
-        description: "Import Todo markdown files into pm items.",
-        failure_hints: ["This command reads a directory, not a file. Use --folder <path> to point at the Todo markdown directory."],
-        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.",
-            },
-        ],
-    });
-    api.registerExporter("todos", async (context) => runTodosExportFromRuntime(toExportOptions(context.options), context.global), {
-        action: "todos-export",
-        description: "Export pm items into Todo markdown files.",
-        failure_hints: ["This command writes a directory of markdown files. Use --folder <path> to choose the destination directory."],
-        flags: [
-            {
-                long: "--folder",
-                value_name: "path",
-                value_type: "string",
-                description: "Destination folder for exported Todo markdown files.",
-            },
-        ],
-    });
-}
-export default {
-    manifest,
-    activate,
-};

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

@@ -1,86 +0,0 @@
-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.`,
-  );
-}