@unbrained/pm-cli 2026.3.12 → 2026.5.1-2

package/.agents/pm/extensions/.managed-extensions.json

@@ -0,0 +1,42 @@
+{
+  "version": 1,
+  "updated_at": "2026-04-25T17:01:49.273Z",
+  "entries": [
+    {
+      "name": "builtin-beads-import",
+      "directory": "beads",
+      "scope": "project",
+      "manifest_version": "0.1.0",
+      "manifest_entry": "./index.js",
+      "capabilities": [
+        "commands",
+        "schema"
+      ],
+      "installed_at": "2026-04-25T17:01:49.268Z",
+      "updated_at": "2026-04-25T17:01:49.268Z",
+      "source": {
+        "kind": "local",
+        "input": "builtin-beads-import",
+        "location": "/home/steve/GITHUB_RELEASE/pm-cli/.agents/pm/extensions/beads"
+      }
+    },
+    {
+      "name": "builtin-todos-import-export",
+      "directory": "todos",
+      "scope": "project",
+      "manifest_version": "0.1.0",
+      "manifest_entry": "./index.js",
+      "capabilities": [
+        "commands",
+        "schema"
+      ],
+      "installed_at": "2026-04-25T17:01:49.268Z",
+      "updated_at": "2026-04-25T17:01:49.268Z",
+      "source": {
+        "kind": "local",
+        "input": "builtin-todos-import-export",
+        "location": "/home/steve/GITHUB_RELEASE/pm-cli/.agents/pm/extensions/todos"
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,109 @@
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+
+const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+
+export const manifest = {
+  name: "builtin-beads-import",
+  version: "0.1.0",
+  entry: "./index.js",
+  priority: 0,
+  capabilities: ["commands", "schema"],
+};
+
+function asOptionalString(value) {
+  return typeof value === "string" ? value : undefined;
+}
+
+function asBoolean(value) {
+  return typeof value === "boolean" ? value : undefined;
+}
+
+function toBeadsImportOptions(options) {
+  return {
+    file: asOptionalString(options.file),
+    author: asOptionalString(options.author),
+    message: asOptionalString(options.message),
+    preserveSourceIds: asBoolean(options.preserveSourceIds),
+  };
+}
+
+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", "beads", "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 beads extension runtime module. " +
+      `Tried: ${attempted.join(", ")}. Ensure PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
+  );
+}
+
+async function runBeadsImportFromRuntime(options, global) {
+  const runtime = await loadRuntimeModule();
+  if (typeof runtime.runBeadsImport !== "function") {
+    throw new Error('Bundled beads runtime module is missing runBeadsImport().');
+  }
+  return runtime.runBeadsImport(options, global);
+}
+
+export function activate(api) {
+  api.registerCommand({
+    name: "beads import",
+    description: "Import Beads JSONL records into pm items.",
+    flags: [
+      {
+        long: "--file",
+        value_name: "path",
+        value_type: "string",
+        description: "Path to the Beads JSONL source file.",
+      },
+      {
+        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.",
+      },
+      {
+        long: "--preserve-source-ids",
+        value_type: "boolean",
+        description: "Preserve source IDs from Beads payload records when possible.",
+      },
+    ],
+    run: async (context) => runBeadsImportFromRuntime(toBeadsImportOptions(context.options), context.global),
+  });
+}
+
+export default {
+  manifest,
+  activate,
+};

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

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

package/{dist/cli/commands/beads.js → .agents/pm/extensions/beads/runtime.js}

@@ -1,18 +1,21 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { pathExists, removeFileIfExists, writeFileAtomic } from "../../core/fs/fs-utils.js";
-import { runActiveOnReadHooks, runActiveOnWriteHooks } from "../../core/extensions/index.js";
-import { appendHistoryEntry, createHistoryEntry } from "../../core/history/history.js";
-import { generateItemId, normalizeItemId, normalizeRawItemId } from "../../core/item/id.js";
-import { canonicalDocument, normalizeFrontMatter, serializeItemDocument } 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 { isTimestampLiteral, nowIso } from "../../core/shared/time.js";
-import { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
-import { readSettings } from "../../core/store/settings.js";
-import { DEPENDENCY_KIND_VALUES, STATUS_VALUES } from "../../types/index.js";
+import { pathExists, removeFileIfExists, writeFileAtomic } from "../../../../dist/core/fs/fs-utils.js";
+import { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks } from "../../../../dist/core/extensions/index.js";
+import { appendHistoryEntry, createHistoryEntry } from "../../../../dist/core/history/history.js";
+import { generateItemId, normalizeItemId, normalizeRawItemId } from "../../../../dist/core/item/id.js";
+import { canonicalDocument, normalizeFrontMatter, serializeItemDocument } 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 { isTimestampLiteral, nowIso } from "../../../../dist/core/shared/time.js";
+import { locateItem } 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 { DEPENDENCY_KIND_VALUES } from "../../../../dist/types/index.js";
 const PRIMARY_AUTO_DISCOVERY_FILES = [
     ".beads/issues.jsonl",
     "issues.jsonl",
@@ -99,9 +102,12 @@ function toItemType(value) {
     }
 }
 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";
 }
@@ -363,6 +369,9 @@ function resolveInputPath(rawPath) {
     return path.isAbsolute(rawPath) ? rawPath : path.resolve(process.cwd(), rawPath);
 }
 async function readStdin() {
+    if (process.stdin.isTTY === true) {
+        throw new PmCliError('--file value "-" requires piped stdin input. Pipe JSONL content into the command, or end manual stdin with Ctrl+D (Unix/macOS) or Ctrl+Z then Enter (Windows).', EXIT_CODE.USAGE);
+    }
     return await new Promise((resolve, reject) => {
         let raw = "";
         process.stdin.setEncoding("utf8");
@@ -417,6 +426,7 @@ export async function runBeadsImport(options, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     await ensureInitHasRun(pmRoot);
     const settings = await readSettings(pmRoot);
+    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
     const preserveSourceIds = options.preserveSourceIds === true;
     const { source, sourcePath, raw, warnings: sourceWarnings } = await resolveBeadsSource(options.file);
     const warnings = [
@@ -513,17 +523,18 @@ export async function runBeadsImport(options, global) {
             front_matter: frontMatter,
             body: finalBody,
         });
-        const itemPath = getItemPath(pmRoot, type, id);
-        if (await pathExists(itemPath)) {
+        const existing = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);
+        if (existing) {
             warnings.push(`beads_import_item_exists:${id}`);
             skipped += 1;
             continue;
         }
+        const itemPath = getItemPath(pmRoot, type, id, settings.item_format, typeRegistry.type_to_folder);
         const historyPath = getHistoryPath(pmRoot, id);
         try {
             const releaseLock = await acquireLock(pmRoot, id, settings.locks.ttl_seconds, author);
             try {
-                await writeFileAtomic(itemPath, serializeItemDocument(afterDocument));
+                await writeFileAtomic(itemPath, serializeItemDocument(afterDocument, { format: settings.item_format }));
                 try {
                     const entry = createHistoryEntry({
                         nowIso: nowIso(),
@@ -572,5 +583,4 @@ export async function runBeadsImport(options, global) {
         ids,
         warnings,
     };
-}
-//# sourceMappingURL=beads.js.map
+}