@unbrained/pm-cli 2026.3.9

package/dist/cli/commands/activity.js

@@ -0,0 +1,80 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { pathExists } from "../../core/fs/fs-utils.js";
+import { runActiveOnReadHooks } from "../../core/extensions/index.js";
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
+import { readSettings } from "../../core/store/settings.js";
+import { readHistoryEntries } from "./history.js";
+function parseLimit(raw) {
+    if (raw === undefined)
+        return undefined;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        throw new PmCliError("Invalid --limit value", EXIT_CODE.USAGE);
+    }
+    return Math.floor(parsed);
+}
+function limitEntries(values, limit) {
+    if (limit === undefined)
+        return values;
+    return values.slice(0, limit);
+}
+function sortActivity(entries) {
+    return [...entries].sort((a, b) => {
+        const byTimestamp = b.ts.localeCompare(a.ts);
+        if (byTimestamp !== 0)
+            return byTimestamp;
+        const byId = a.id.localeCompare(b.id);
+        if (byId !== 0)
+            return byId;
+        return a.op.localeCompare(b.op);
+    });
+}
+async function listHistoryFiles(historyDir) {
+    try {
+        return (await fs.readdir(historyDir))
+            .filter((entry) => entry.endsWith(".jsonl"))
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch (error) {
+        // Activity should degrade gracefully when optional history storage is absent.
+        if (error.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+}
+export async function runActivity(options, global) {
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    if (!(await pathExists(getSettingsPath(pmRoot)))) {
+        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    }
+    const limit = parseLimit(options.limit);
+    await readSettings(pmRoot);
+    const historyDir = path.join(pmRoot, "history");
+    await runActiveOnReadHooks({
+        path: historyDir,
+        scope: "project",
+    });
+    const historyFiles = await listHistoryFiles(historyDir);
+    const combined = [];
+    for (const file of historyFiles) {
+        const id = file.slice(0, -".jsonl".length);
+        const entries = await readHistoryEntries(path.join(historyDir, file), id);
+        for (const entry of entries) {
+            combined.push({
+                id,
+                ...entry,
+            });
+        }
+    }
+    const activity = limitEntries(sortActivity(combined), limit);
+    return {
+        activity,
+        count: activity.length,
+        limit: limit ?? null,
+    };
+}
+//# sourceMappingURL=activity.js.map

package/dist/cli/commands/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../src/cli/commands/activity.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/append.d.ts

@@ -0,0 +1,13 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+export interface AppendCommandOptions {
+    body: string;
+    author?: string;
+    message?: string;
+    force?: boolean;
+}
+export interface AppendResult {
+    item: Record<string, unknown>;
+    appended: string;
+    changed_fields: string[];
+}
+export declare function runAppend(id: string, options: AppendCommandOptions, global: GlobalOptions): Promise<AppendResult>;

package/dist/cli/commands/append.js

@@ -0,0 +1,46 @@
+import { pathExists } from "../../core/fs/fs-utils.js";
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+import { mutateItem } from "../../core/store/item-store.js";
+import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
+import { readSettings } from "../../core/store/settings.js";
+function resolveAuthor(candidate, defaultAuthor) {
+    const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;
+    const trimmed = resolved.trim();
+    return trimmed || "unknown";
+}
+export async function runAppend(id, options, global) {
+    if (options.body === undefined) {
+        throw new PmCliError("Missing required --body text", EXIT_CODE.USAGE);
+    }
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    if (!(await pathExists(getSettingsPath(pmRoot)))) {
+        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    }
+    const settings = await readSettings(pmRoot);
+    const author = resolveAuthor(options.author, settings.author_default);
+    const appended = options.body.trim();
+    const result = await mutateItem({
+        pmRoot,
+        settings,
+        id,
+        op: "append",
+        author,
+        message: options.message,
+        force: options.force,
+        mutate(document) {
+            if (appended.length === 0) {
+                return { changedFields: [] };
+            }
+            const spacer = document.body.trim().length > 0 ? "\n\n" : "";
+            document.body = `${document.body.replace(/\s+$/, "")}${spacer}${appended}\n`;
+            return { changedFields: ["body"] };
+        },
+    });
+    return {
+        item: result.item,
+        appended: appended.length > 0 ? appended : "",
+        changed_fields: result.changedFields,
+    };
+}
+//# sourceMappingURL=append.js.map

package/dist/cli/commands/append.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"append.js","sourceRoot":"","sources":["../../../src/cli/commands/append.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAe5D,SAAS,aAAa,CAAC,SAA6B,EAAE,aAAqB;IACzE,MAAM,QAAQ,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,aAAa,CAAC;IACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAAU,EAAE,OAA6B,EAAE,MAAqB;IAC9F,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,UAAU,CAAC,8BAA8B,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,iCAAiC,MAAM,sBAAsB,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAErC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,MAAM;QACN,QAAQ;QACR,EAAE;QACF,EAAE,EAAE,QAAQ;QACZ,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,CAAC,QAAQ;YACb,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;YAC/B,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,QAAQ,CAAC,IAAI,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,QAAQ,IAAI,CAAC;YAC7E,OAAO,EAAE,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAA0C;QACvD,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QAC7C,cAAc,EAAE,MAAM,CAAC,aAAa;KACrC,CAAC;AACJ,CAAC"}

package/dist/cli/commands/beads.d.ts

@@ -0,0 +1,15 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+export interface BeadsImportOptions {
+    file?: string;
+    author?: string;
+    message?: string;
+}
+export interface BeadsImportResult {
+    ok: boolean;
+    source: string;
+    imported: number;
+    skipped: number;
+    ids: string[];
+    warnings: string[];
+}
+export declare function runBeadsImport(options: BeadsImportOptions, global: GlobalOptions): Promise<BeadsImportResult>;

package/dist/cli/commands/beads.js

@@ -0,0 +1,475 @@
+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 } 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 { 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";
+const DEFAULT_BEADS_FILE = ".beads/issues.jsonl";
+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) {
+        return undefined;
+    }
+    const timestamp = Date.parse(raw);
+    if (!Number.isFinite(timestamp)) {
+        return undefined;
+    }
+    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 toPriority(value) {
+    const fallback = 2;
+    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 fallback;
+}
+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 [];
+}
+function toItemType(value) {
+    const normalized = toNonEmptyString(value)?.toLowerCase();
+    switch (normalized) {
+        case "epic":
+            return "Epic";
+        case "feature":
+            return "Feature";
+        case "task":
+            return "Task";
+        case "chore":
+            return "Chore";
+        case "issue":
+            return "Issue";
+        default:
+            return "Task";
+    }
+}
+function toStatus(value) {
+    const normalized = toNonEmptyString(value)?.toLowerCase();
+    if (normalized && STATUS_VALUES.includes(normalized)) {
+        return normalized;
+    }
+    return "open";
+}
+function toDependencyKind(value) {
+    const normalized = toNonEmptyString(value)?.toLowerCase();
+    if (normalized && DEPENDENCY_KIND_VALUES.includes(normalized)) {
+        return normalized;
+    }
+    return "related";
+}
+function toDependencies(value, fallbackCreatedAt, prefix) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const dependencies = [];
+    for (const entry of value) {
+        if (typeof entry === "string") {
+            const id = toNonEmptyString(entry);
+            if (!id) {
+                continue;
+            }
+            dependencies.push({
+                id: normalizeItemId(id, prefix),
+                kind: "related",
+                created_at: fallbackCreatedAt,
+            });
+            continue;
+        }
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+            continue;
+        }
+        const candidate = entry;
+        const id = toNonEmptyString(candidate.id) ?? toNonEmptyString(candidate.item_id) ?? toNonEmptyString(candidate.depends_on_id);
+        if (!id) {
+            continue;
+        }
+        dependencies.push({
+            id: normalizeItemId(id, prefix),
+            kind: toDependencyKind(candidate.kind),
+            created_at: toIsoString(candidate.created_at) ?? fallbackCreatedAt,
+            author: toNonEmptyString(candidate.author),
+        });
+    }
+    return dependencies.length > 0 ? dependencies : undefined;
+}
+function toLogEntries(value, fallbackCreatedAt, fallbackAuthor) {
+    if (typeof value === "string") {
+        const text = toNonEmptyString(value);
+        if (!text) {
+            return undefined;
+        }
+        return [
+            {
+                created_at: fallbackCreatedAt,
+                author: fallbackAuthor,
+                text,
+            },
+        ];
+    }
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const entries = [];
+    for (const entry of value) {
+        if (typeof entry === "string") {
+            const text = toNonEmptyString(entry);
+            if (!text) {
+                continue;
+            }
+            entries.push({
+                created_at: fallbackCreatedAt,
+                author: fallbackAuthor,
+                text,
+            });
+            continue;
+        }
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+            continue;
+        }
+        const candidate = entry;
+        const text = toNonEmptyString(candidate.text) ??
+            toNonEmptyString(candidate.comment) ??
+            toNonEmptyString(candidate.note) ??
+            toNonEmptyString(candidate.learning);
+        if (!text) {
+            continue;
+        }
+        entries.push({
+            created_at: toIsoString(candidate.created_at) ?? fallbackCreatedAt,
+            author: toNonEmptyString(candidate.author) ?? fallbackAuthor,
+            text,
+        });
+    }
+    return entries.length > 0 ? entries : undefined;
+}
+function toLinkedFiles(value) {
+    if (typeof value === "string") {
+        const p = toNonEmptyString(value);
+        if (!p)
+            return undefined;
+        return [{ path: p, scope: "project" }];
+    }
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const files = [];
+    for (const entry of value) {
+        if (typeof entry === "string") {
+            const p = toNonEmptyString(entry);
+            if (p)
+                files.push({ path: p, scope: "project" });
+            continue;
+        }
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+            continue;
+        }
+        const candidate = entry;
+        const p = toNonEmptyString(candidate.path) ?? toNonEmptyString(candidate.file);
+        if (!p)
+            continue;
+        files.push({
+            path: p,
+            scope: toNonEmptyString(candidate.scope) === "global" ? "global" : "project",
+            note: toNonEmptyString(candidate.note),
+        });
+    }
+    return files.length > 0 ? files : undefined;
+}
+function toLinkedTests(value) {
+    if (typeof value === "string") {
+        const c = toNonEmptyString(value);
+        if (!c)
+            return undefined;
+        return [{ command: c, scope: "project" }];
+    }
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const tests = [];
+    for (const entry of value) {
+        if (typeof entry === "string") {
+            const c = toNonEmptyString(entry);
+            if (c)
+                tests.push({ command: c, scope: "project" });
+            continue;
+        }
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+            continue;
+        }
+        const candidate = entry;
+        const command = toNonEmptyString(candidate.command) ?? toNonEmptyString(candidate.test);
+        const p = toNonEmptyString(candidate.path);
+        if (!command && !p)
+            continue;
+        let timeout;
+        if (typeof candidate.timeout_seconds === "number" && Number.isFinite(candidate.timeout_seconds)) {
+            timeout = candidate.timeout_seconds;
+        }
+        else if (typeof candidate.timeout_seconds === "string") {
+            const parsed = Number(candidate.timeout_seconds);
+            if (Number.isFinite(parsed) && parsed >= 0) {
+                timeout = parsed;
+            }
+        }
+        tests.push({
+            command,
+            path: p,
+            scope: toNonEmptyString(candidate.scope) === "global" ? "global" : "project",
+            timeout_seconds: timeout,
+            note: toNonEmptyString(candidate.note),
+        });
+    }
+    return tests.length > 0 ? tests : undefined;
+}
+function toLinkedDocs(value) {
+    if (typeof value === "string") {
+        const p = toNonEmptyString(value);
+        if (!p)
+            return undefined;
+        return [{ path: p, scope: "project" }];
+    }
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const docs = [];
+    for (const entry of value) {
+        if (typeof entry === "string") {
+            const p = toNonEmptyString(entry);
+            if (p)
+                docs.push({ path: p, scope: "project" });
+            continue;
+        }
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+            continue;
+        }
+        const candidate = entry;
+        const p = toNonEmptyString(candidate.path) ?? toNonEmptyString(candidate.doc);
+        if (!p)
+            continue;
+        docs.push({
+            path: p,
+            scope: toNonEmptyString(candidate.scope) === "global" ? "global" : "project",
+            note: toNonEmptyString(candidate.note),
+        });
+    }
+    return docs.length > 0 ? docs : undefined;
+}
+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);
+        }
+    });
+}
+function emptyDocument() {
+    return {
+        front_matter: {},
+        body: "",
+    };
+}
+function resolveInputPath(rawPath) {
+    return path.isAbsolute(rawPath) ? rawPath : path.resolve(process.cwd(), rawPath);
+}
+export async function runBeadsImport(options, global) {
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    await ensureInitHasRun(pmRoot);
+    const settings = await readSettings(pmRoot);
+    const source = toNonEmptyString(options.file) ?? DEFAULT_BEADS_FILE;
+    const sourcePath = resolveInputPath(source);
+    if (!(await pathExists(sourcePath))) {
+        throw new PmCliError(`Beads source file not found at ${sourcePath}`, EXIT_CODE.NOT_FOUND);
+    }
+    const raw = await fs.readFile(sourcePath, "utf8");
+    const warnings = [
+        ...(await runActiveOnReadHooks({
+            path: sourcePath,
+            scope: "project",
+        })),
+    ];
+    const lines = raw.split(/\r?\n/);
+    const author = selectAuthor(toNonEmptyString(options.author), settings.author_default);
+    const message = toNonEmptyString(options.message) ?? "Import from Beads JSONL";
+    const ids = [];
+    let imported = 0;
+    let skipped = 0;
+    for (let index = 0; index < lines.length; index += 1) {
+        const lineNumber = index + 1;
+        const line = lines[index].trim();
+        if (line.length === 0) {
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            warnings.push(`beads_import_invalid_jsonl_line:${lineNumber}`);
+            skipped += 1;
+            continue;
+        }
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            warnings.push(`beads_import_invalid_record:${lineNumber}`);
+            skipped += 1;
+            continue;
+        }
+        const record = parsed;
+        const title = toNonEmptyString(record.title);
+        if (!title) {
+            warnings.push(`beads_import_missing_title:${lineNumber}`);
+            skipped += 1;
+            continue;
+        }
+        const createdAt = toIsoString(record.created_at) ?? nowIso();
+        const updatedAt = toIsoString(record.updated_at) ?? createdAt;
+        const id = toNonEmptyString(record.id)
+            ? normalizeItemId(toNonEmptyString(record.id), settings.id_prefix)
+            : await generateItemId(pmRoot, settings.id_prefix);
+        const type = toItemType(record.issue_type ?? record.type);
+        const frontMatter = normalizeFrontMatter({
+            id,
+            title,
+            description: toNonEmptyString(record.description) ?? "",
+            type,
+            status: toStatus(record.status),
+            priority: toPriority(record.priority),
+            tags: toTags(record.tags ?? record.labels),
+            created_at: createdAt,
+            updated_at: updatedAt,
+            deadline: toIsoString(record.deadline),
+            assignee: toNonEmptyString(record.assignee),
+            author: toNonEmptyString(record.author) ?? toNonEmptyString(record.created_by) ?? author,
+            estimated_minutes: toEstimatedMinutes(record.estimated_minutes),
+            acceptance_criteria: toNonEmptyString(record.acceptance_criteria),
+            close_reason: toNonEmptyString(record.close_reason) ?? (toIsoString(record.closed_at) ? `Closed at ${toIsoString(record.closed_at)}` : undefined),
+            dependencies: toDependencies(record.dependencies, createdAt, settings.id_prefix),
+            comments: toLogEntries(record.comments, createdAt, author),
+            notes: toLogEntries(record.notes, createdAt, author),
+            learnings: toLogEntries(record.learnings, createdAt, author),
+            files: toLinkedFiles(record.files),
+            tests: toLinkedTests(record.tests),
+            docs: toLinkedDocs(record.docs),
+        });
+        const rawBody = toNonEmptyString(record.body) ?? "";
+        const design = toNonEmptyString(record.design);
+        const externalRef = toNonEmptyString(record.external_ref);
+        let finalBody = rawBody;
+        if (design) {
+            finalBody += (finalBody ? "\n\n" : "") + "## Design\n\n" + design;
+        }
+        if (externalRef) {
+            finalBody += (finalBody ? "\n\n" : "") + "## External Reference\n" + externalRef;
+        }
+        const afterDocument = canonicalDocument({
+            front_matter: frontMatter,
+            body: finalBody,
+        });
+        const itemPath = getItemPath(pmRoot, type, id);
+        if (await pathExists(itemPath)) {
+            warnings.push(`beads_import_item_exists:${id}`);
+            skipped += 1;
+            continue;
+        }
+        const historyPath = getHistoryPath(pmRoot, id);
+        try {
+            const releaseLock = await acquireLock(pmRoot, id, settings.locks.ttl_seconds, author);
+            try {
+                await writeFileAtomic(itemPath, serializeItemDocument(afterDocument));
+                try {
+                    const entry = createHistoryEntry({
+                        nowIso: nowIso(),
+                        author,
+                        op: "import",
+                        before: emptyDocument(),
+                        after: afterDocument,
+                        message,
+                    });
+                    await appendHistoryEntry(historyPath, entry);
+                    warnings.push(...(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) {
+                warnings.push(`beads_import_lock_conflict:${id}`);
+                skipped += 1;
+                continue;
+            }
+            throw error;
+        }
+        ids.push(id);
+        imported += 1;
+    }
+    return {
+        ok: true,
+        source,
+        imported,
+        skipped,
+        ids,
+        warnings,
+    };
+}
+//# sourceMappingURL=beads.js.map