@unbrained/pm-cli 2026.3.9

package/dist/core/shared/constants.js

@@ -0,0 +1,134 @@
+export const PM_DIRNAME = ".agents/pm";
+export const SETTINGS_FILENAME = "settings.json";
+export const PM_REQUIRED_SUBDIRS = [
+    "",
+    "epics",
+    "features",
+    "tasks",
+    "chores",
+    "issues",
+    "history",
+    "index",
+    "search",
+    "extensions",
+    "locks",
+];
+export const TYPE_TO_FOLDER = {
+    Epic: "epics",
+    Feature: "features",
+    Task: "tasks",
+    Chore: "chores",
+    Issue: "issues",
+};
+export const FRONT_MATTER_KEY_ORDER = [
+    "id",
+    "title",
+    "description",
+    "type",
+    "status",
+    "priority",
+    "tags",
+    "created_at",
+    "updated_at",
+    "deadline",
+    "assignee",
+    "author",
+    "estimated_minutes",
+    "acceptance_criteria",
+    "definition_of_ready",
+    "order",
+    "goal",
+    "objective",
+    "value",
+    "impact",
+    "outcome",
+    "why_now",
+    "parent",
+    "reviewer",
+    "risk",
+    "confidence",
+    "sprint",
+    "release",
+    "blocked_by",
+    "blocked_reason",
+    "unblock_note",
+    "reporter",
+    "severity",
+    "environment",
+    "repro_steps",
+    "resolution",
+    "expected_result",
+    "actual_result",
+    "affected_version",
+    "fixed_version",
+    "component",
+    "regression",
+    "customer_impact",
+    "dependencies",
+    "comments",
+    "notes",
+    "learnings",
+    "files",
+    "tests",
+    "docs",
+    "close_reason",
+];
+export const SETTINGS_DEFAULTS = {
+    version: 1,
+    id_prefix: "pm-",
+    author_default: "",
+    locks: {
+        ttl_seconds: 1800,
+    },
+    output: {
+        default_format: "toon",
+    },
+    workflow: {
+        definition_of_done: [],
+    },
+    extensions: {
+        enabled: [],
+        disabled: [],
+    },
+    search: {
+        score_threshold: 0,
+        hybrid_semantic_weight: 0.7,
+        max_results: 50,
+        embedding_model: "",
+        embedding_batch_size: 32,
+        scanner_max_batch_retries: 3,
+    },
+    providers: {
+        openai: {
+            base_url: "",
+            api_key: "",
+            model: "",
+        },
+        ollama: {
+            base_url: "",
+            model: "",
+        },
+    },
+    vector_store: {
+        qdrant: {
+            url: "",
+            api_key: "",
+        },
+        lancedb: {
+            path: "",
+        },
+    },
+};
+export const EMPTY_CANONICAL_DOCUMENT = {
+    front_matter: {},
+    body: "",
+};
+export const EXIT_CODE = {
+    SUCCESS: 0,
+    GENERIC_FAILURE: 1,
+    USAGE: 2,
+    NOT_FOUND: 3,
+    CONFLICT: 4,
+    DEPENDENCY_FAILED: 5,
+};
+//# sourceMappingURL=constants.js.map

package/dist/core/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/core/shared/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AACvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEjD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,EAAE;IACF,OAAO;IACP,UAAU;IACV,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,OAAO;CACC,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAA6B;IACtD,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,QAAQ;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAyC;IAC1E,IAAI;IACJ,OAAO;IACP,aAAa;IACb,MAAM;IACN,QAAQ;IACR,UAAU;IACV,MAAM;IACN,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,UAAU;IACV,QAAQ;IACR,mBAAmB;IACnB,qBAAqB;IACrB,qBAAqB;IACrB,OAAO;IACP,MAAM;IACN,WAAW;IACX,OAAO;IACP,QAAQ;IACR,SAAS;IACT,SAAS;IACT,QAAQ;IACR,UAAU;IACV,MAAM;IACN,YAAY;IACZ,QAAQ;IACR,SAAS;IACT,YAAY;IACZ,gBAAgB;IAChB,cAAc;IACd,UAAU;IACV,UAAU;IACV,aAAa;IACb,aAAa;IACb,YAAY;IACZ,iBAAiB;IACjB,eAAe;IACf,kBAAkB;IAClB,eAAe;IACf,WAAW;IACX,YAAY;IACZ,iBAAiB;IACjB,cAAc;IACd,UAAU;IACV,OAAO;IACP,WAAW;IACX,OAAO;IACP,OAAO;IACP,MAAM;IACN,cAAc;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,OAAO,EAAE,CAAC;IACV,SAAS,EAAE,KAAK;IAChB,cAAc,EAAE,EAAE;IAClB,KAAK,EAAE;QACL,WAAW,EAAE,IAAI;KAClB;IACD,MAAM,EAAE;QACN,cAAc,EAAE,MAAM;KACvB;IACD,QAAQ,EAAE;QACR,kBAAkB,EAAE,EAAE;KACvB;IACD,UAAU,EAAE;QACV,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,EAAE;KACb;IACD,MAAM,EAAE;QACN,eAAe,EAAE,CAAC;QAClB,sBAAsB,EAAE,GAAG;QAC3B,WAAW,EAAE,EAAE;QACf,eAAe,EAAE,EAAE;QACnB,oBAAoB,EAAE,EAAE;QACxB,yBAAyB,EAAE,CAAC;KAC7B;IACD,SAAS,EAAE;QACT,MAAM,EAAE;YACN,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,EAAE;SACV;QACD,MAAM,EAAE;YACN,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF;IACD,YAAY,EAAE;QACZ,MAAM,EAAE;YACN,GAAG,EAAE,EAAE;YACP,OAAO,EAAE,EAAE;SACZ;QACD,OAAO,EAAE;YACP,IAAI,EAAE,EAAE;SACT;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,YAAY,EAAE,EAAE;IAChB,IAAI,EAAE,EAAE;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,OAAO,EAAE,CAAC;IACV,eAAe,EAAE,CAAC;IAClB,KAAK,EAAE,CAAC;IACR,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,CAAC;IACX,iBAAiB,EAAE,CAAC;CACZ,CAAC"}

package/dist/core/shared/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class PmCliError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode: number);
+}

package/dist/core/shared/errors.js

@@ -0,0 +1,9 @@
+export class PmCliError extends Error {
+    exitCode;
+    constructor(message, exitCode) {
+        super(message);
+        this.name = "PmCliError";
+        this.exitCode = exitCode;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/shared/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/shared/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnB,QAAQ,CAAS;IAEjC,YAAY,OAAe,EAAE,QAAgB;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF"}

package/dist/core/shared/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./command-types.js";
+export * from "./constants.js";
+export * from "./errors.js";

package/dist/core/shared/index.js

@@ -0,0 +1,4 @@
+export * from "./command-types.js";
+export * from "./constants.js";
+export * from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/core/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/core/shared/serialization.d.ts

@@ -0,0 +1,3 @@
+export declare function stableStringify(value: unknown): string;
+export declare function sha256Hex(value: string): string;
+export declare function orderObject<T extends Record<string, unknown>>(value: T, keyOrder: ReadonlyArray<string>): Record<string, unknown>;

package/dist/core/shared/serialization.js

@@ -0,0 +1,70 @@
+import crypto from "node:crypto";
+function sortObjectKeys(value) {
+    if (value === null)
+        return null;
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "bigint") {
+        return value.toString();
+    }
+    if (value === undefined) {
+        return "undefined";
+    }
+    if (typeof value === "symbol") {
+        return value.toString();
+    }
+    if (typeof value === "function") {
+        return `[function:${value.name || "anonymous"}]`;
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => sortObjectKeys(entry));
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    const maybeJson = value;
+    if (typeof maybeJson.toJSON === "function") {
+        const normalized = maybeJson.toJSON();
+        if (normalized !== value) {
+            return sortObjectKeys(normalized);
+        }
+    }
+    const obj = value;
+    const sortedKeys = Object.keys(obj).sort((a, b) => a.localeCompare(b));
+    const result = {};
+    for (const key of sortedKeys) {
+        const nested = obj[key];
+        if (nested === undefined) {
+            continue;
+        }
+        result[key] = sortObjectKeys(nested);
+    }
+    return result;
+}
+export function stableStringify(value) {
+    return JSON.stringify(sortObjectKeys(value));
+}
+export function sha256Hex(value) {
+    return crypto.createHash("sha256").update(value, "utf8").digest("hex");
+}
+export function orderObject(value, keyOrder) {
+    const ordered = {};
+    for (const key of keyOrder) {
+        const entry = value[key];
+        if (entry !== undefined) {
+            ordered[key] = entry;
+        }
+    }
+    const unknownKeys = Object.keys(value)
+        .filter((key) => !keyOrder.includes(key))
+        .sort((a, b) => a.localeCompare(b));
+    for (const key of unknownKeys) {
+        const entry = value[key];
+        if (entry !== undefined) {
+            ordered[key] = entry;
+        }
+    }
+    return ordered;
+}
+//# sourceMappingURL=serialization.js.map

package/dist/core/shared/serialization.js.map

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

package/dist/core/shared/time.d.ts

@@ -0,0 +1,3 @@
+export declare function nowIso(): string;
+export declare function isNoneToken(input: string | undefined): boolean;
+export declare function resolveIsoOrRelative(input: string, now?: Date): string;

package/dist/core/shared/time.js

@@ -0,0 +1,28 @@
+import { PmCliError } from "./errors.js";
+import { EXIT_CODE } from "./constants.js";
+const RELATIVE_DEADLINE = /^\+?(\d+)([hdw])$/i;
+export function nowIso() {
+    return new Date().toISOString();
+}
+export function isNoneToken(input) {
+    if (input === undefined)
+        return false;
+    const normalized = input.trim().toLowerCase();
+    return normalized === "none" || normalized === "null";
+}
+export function resolveIsoOrRelative(input, now = new Date()) {
+    const trimmed = input.trim();
+    const relative = RELATIVE_DEADLINE.exec(trimmed);
+    if (relative) {
+        const amount = Number.parseInt(relative[1], 10);
+        const unit = relative[2].toLowerCase();
+        const msPerUnit = unit === "h" ? 60 * 60 * 1000 : unit === "d" ? 24 * 60 * 60 * 1000 : 7 * 24 * 60 * 60 * 1000;
+        return new Date(now.getTime() + amount * msPerUnit).toISOString();
+    }
+    const timestamp = Date.parse(trimmed);
+    if (!Number.isFinite(timestamp)) {
+        throw new PmCliError(`Invalid deadline value "${input}". Use ISO timestamp, +6h, +1d, +2w, or none.`, EXIT_CODE.USAGE);
+    }
+    return new Date(timestamp).toISOString();
+}
+//# sourceMappingURL=time.js.map

package/dist/core/shared/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../../src/core/shared/time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAE/C,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAyB;IACnD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,MAAM,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,MAAY,IAAI,IAAI,EAAE;IAEtB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC/G,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,UAAU,CAClB,2BAA2B,KAAK,+CAA+C,EAC/E,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;AAC3C,CAAC"}

package/dist/core/store/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./item-store.js";
+export * from "./paths.js";
+export * from "./settings.js";

package/dist/core/store/index.js

@@ -0,0 +1,4 @@
+export * from "./item-store.js";
+export * from "./paths.js";
+export * from "./settings.js";
+//# sourceMappingURL=index.js.map

package/dist/core/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/store/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/core/store/item-store.d.ts

@@ -0,0 +1,42 @@
+import type { ItemDocument, ItemFrontMatter, ItemType, PmSettings } from "../../types/index.js";
+export interface LocatedItem {
+    id: string;
+    type: ItemType;
+    itemPath: string;
+}
+export declare function locateItem(pmRoot: string, rawId: string, idPrefix: string): Promise<LocatedItem | null>;
+export declare function readLocatedItem(item: LocatedItem): Promise<{
+    raw: string;
+    document: ItemDocument;
+}>;
+export declare function listAllFrontMatter(pmRoot: string): Promise<ItemFrontMatter[]>;
+export declare function mutateItem(params: {
+    pmRoot: string;
+    settings: PmSettings;
+    id: string;
+    op: string;
+    author: string;
+    message?: string;
+    force?: boolean;
+    mutate: (document: ItemDocument) => {
+        changedFields: string[];
+        warnings?: string[];
+    };
+}): Promise<{
+    item: ItemFrontMatter;
+    body: string;
+    changedFields: string[];
+    warnings: string[];
+}>;
+export declare function deleteItem(params: {
+    pmRoot: string;
+    settings: PmSettings;
+    id: string;
+    author: string;
+    message?: string;
+    force?: boolean;
+}): Promise<{
+    item: ItemFrontMatter;
+    changedFields: string[];
+    warnings: string[];
+}>;

package/dist/core/store/item-store.js

@@ -0,0 +1,186 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { runActiveOnReadHooks, runActiveOnWriteHooks } from "../extensions/index.js";
+import { EMPTY_CANONICAL_DOCUMENT, EXIT_CODE, TYPE_TO_FOLDER } from "../shared/constants.js";
+import { PmCliError } from "../shared/errors.js";
+import { appendHistoryEntry, createHistoryEntry } from "../history/history.js";
+import { canonicalDocument, parseItemDocument, serializeItemDocument } from "../item/item-format.js";
+import { acquireLock } from "../lock/lock.js";
+import { writeFileAtomic } from "../fs/fs-utils.js";
+import { normalizeItemId } from "../item/id.js";
+import { getHistoryPath } from "./paths.js";
+import { nowIso } from "../shared/time.js";
+async function fileExists(targetPath) {
+    try {
+        await fs.access(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function locateItem(pmRoot, rawId, idPrefix) {
+    const normalizedId = normalizeItemId(rawId, idPrefix);
+    const entries = Object.entries(TYPE_TO_FOLDER);
+    for (const [type, folder] of entries) {
+        const itemPath = path.join(pmRoot, folder, `${normalizedId}.md`);
+        if (await fileExists(itemPath)) {
+            return {
+                id: normalizedId,
+                type,
+                itemPath,
+            };
+        }
+    }
+    return null;
+}
+export async function readLocatedItem(item) {
+    const raw = await fs.readFile(item.itemPath, "utf8");
+    await runActiveOnReadHooks({
+        path: item.itemPath,
+        scope: "project",
+    });
+    const document = parseItemDocument(raw);
+    return { raw, document };
+}
+export async function listAllFrontMatter(pmRoot) {
+    const entries = Object.values(TYPE_TO_FOLDER);
+    const items = [];
+    for (const folder of entries) {
+        const dirPath = path.join(pmRoot, folder);
+        let files = [];
+        try {
+            files = await fs.readdir(dirPath);
+        }
+        catch {
+            continue;
+        }
+        for (const file of files.filter((entry) => entry.endsWith(".md"))) {
+            try {
+                const itemPath = path.join(dirPath, file);
+                const raw = await fs.readFile(itemPath, "utf8");
+                await runActiveOnReadHooks({
+                    path: itemPath,
+                    scope: "project",
+                });
+                const parsed = parseItemDocument(raw);
+                items.push(parsed.front_matter);
+            }
+            catch {
+                // skip unreadable items
+            }
+        }
+    }
+    return items;
+}
+export async function mutateItem(params) {
+    const located = await locateItem(params.pmRoot, params.id, params.settings.id_prefix);
+    if (!located) {
+        throw new PmCliError(`Item ${params.id} not found`, EXIT_CODE.NOT_FOUND);
+    }
+    const releaseLock = await acquireLock(params.pmRoot, located.id, params.settings.locks.ttl_seconds, params.author, Boolean(params.force));
+    try {
+        const { raw: originalRaw, document } = await readLocatedItem(located);
+        const assigned = document.front_matter.assignee?.trim();
+        if (assigned && assigned !== params.author && !params.force) {
+            throw new PmCliError(`Item ${located.id} is assigned to ${assigned}. Use --force to override.`, EXIT_CODE.CONFLICT);
+        }
+        const beforeDocument = canonicalDocument(document);
+        const mutableDocument = canonicalDocument(structuredClone(document));
+        const mutation = params.mutate(mutableDocument);
+        mutableDocument.front_matter.updated_at = nowIso();
+        const afterDocument = canonicalDocument(mutableDocument);
+        const serializedAfter = serializeItemDocument(afterDocument);
+        await writeFileAtomic(located.itemPath, serializedAfter);
+        const entry = createHistoryEntry({
+            nowIso: afterDocument.front_matter.updated_at,
+            author: params.author,
+            op: params.op,
+            before: beforeDocument,
+            after: afterDocument,
+            message: params.message,
+        });
+        try {
+            await appendHistoryEntry(getHistoryPath(params.pmRoot, located.id), entry);
+        }
+        catch (error) {
+            await writeFileAtomic(located.itemPath, originalRaw);
+            throw error;
+        }
+        const hookWarnings = [
+            ...(await runActiveOnWriteHooks({
+                path: located.itemPath,
+                scope: "project",
+                op: params.op,
+            })),
+            ...(await runActiveOnWriteHooks({
+                path: getHistoryPath(params.pmRoot, located.id),
+                scope: "project",
+                op: `${params.op}:history`,
+            })),
+        ];
+        return {
+            item: afterDocument.front_matter,
+            body: afterDocument.body,
+            changedFields: mutation.changedFields,
+            warnings: [...(mutation.warnings ?? []), ...hookWarnings],
+        };
+    }
+    finally {
+        await releaseLock();
+    }
+}
+export async function deleteItem(params) {
+    const located = await locateItem(params.pmRoot, params.id, params.settings.id_prefix);
+    if (!located) {
+        throw new PmCliError(`Item ${params.id} not found`, EXIT_CODE.NOT_FOUND);
+    }
+    const releaseLock = await acquireLock(params.pmRoot, located.id, params.settings.locks.ttl_seconds, params.author, Boolean(params.force));
+    try {
+        const { raw: originalRaw, document } = await readLocatedItem(located);
+        const assigned = document.front_matter.assignee?.trim();
+        if (assigned && assigned !== params.author && !params.force) {
+            throw new PmCliError(`Item ${located.id} is assigned to ${assigned}. Use --force to override.`, EXIT_CODE.CONFLICT);
+        }
+        const beforeDocument = canonicalDocument(document);
+        const deletionTimestamp = nowIso();
+        const tombstoneDocument = EMPTY_CANONICAL_DOCUMENT;
+        const historyEntry = createHistoryEntry({
+            nowIso: deletionTimestamp,
+            author: params.author,
+            op: "delete",
+            before: beforeDocument,
+            after: tombstoneDocument,
+            message: params.message,
+        });
+        await fs.rm(located.itemPath);
+        try {
+            await appendHistoryEntry(getHistoryPath(params.pmRoot, located.id), historyEntry);
+        }
+        catch (error) {
+            await writeFileAtomic(located.itemPath, originalRaw);
+            throw error;
+        }
+        const hookWarnings = [
+            ...(await runActiveOnWriteHooks({
+                path: located.itemPath,
+                scope: "project",
+                op: "delete",
+            })),
+            ...(await runActiveOnWriteHooks({
+                path: getHistoryPath(params.pmRoot, located.id),
+                scope: "project",
+                op: "delete:history",
+            })),
+        ];
+        return {
+            item: beforeDocument.front_matter,
+            changedFields: ["deleted"],
+            warnings: hookWarnings,
+        };
+    }
+    finally {
+        await releaseLock();
+    }
+}
+//# sourceMappingURL=item-store.js.map

package/dist/core/store/item-store.js.map

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

package/dist/core/store/paths.d.ts

@@ -0,0 +1,8 @@
+import type { ItemType } from "../../types/index.js";
+export declare function resolvePmRoot(cwd: string, cliPath?: string): string;
+export declare function resolveGlobalPmRoot(cwd: string): string;
+export declare function getSettingsPath(pmRoot: string): string;
+export declare function getTypeDirPath(pmRoot: string, type: ItemType): string;
+export declare function getItemPath(pmRoot: string, type: ItemType, id: string): string;
+export declare function getHistoryPath(pmRoot: string, id: string): string;
+export declare function getLockPath(pmRoot: string, id: string): string;

package/dist/core/store/paths.js

@@ -0,0 +1,29 @@
+import os from "node:os";
+import path from "node:path";
+import { PM_DIRNAME, SETTINGS_FILENAME, TYPE_TO_FOLDER } from "../shared/constants.js";
+export function resolvePmRoot(cwd, cliPath) {
+    const envPath = process.env.PM_PATH;
+    const selected = cliPath?.trim() || envPath?.trim() || PM_DIRNAME;
+    return path.resolve(cwd, selected);
+}
+export function resolveGlobalPmRoot(cwd) {
+    const envPath = process.env.PM_GLOBAL_PATH?.trim();
+    const selected = envPath && envPath.length > 0 ? envPath : path.join(os.homedir(), ".pm-cli");
+    return path.resolve(cwd, selected);
+}
+export function getSettingsPath(pmRoot) {
+    return path.join(pmRoot, SETTINGS_FILENAME);
+}
+export function getTypeDirPath(pmRoot, type) {
+    return path.join(pmRoot, TYPE_TO_FOLDER[type]);
+}
+export function getItemPath(pmRoot, type, id) {
+    return path.join(getTypeDirPath(pmRoot, type), `${id}.md`);
+}
+export function getHistoryPath(pmRoot, id) {
+    return path.join(pmRoot, "history", `${id}.jsonl`);
+}
+export function getLockPath(pmRoot, id) {
+    return path.join(pmRoot, "locks", `${id}.lock`);
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/store/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/core/store/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGvF,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,OAAgB;IACzD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,OAAO,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC;IAClE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IACnD,MAAM,QAAQ,GAAG,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9F,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,IAAc;IAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,IAAc,EAAE,EAAU;IACpE,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,EAAU;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,EAAU;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC"}

package/dist/core/store/settings.d.ts

@@ -0,0 +1,4 @@
+import type { PmSettings } from "../../types/index.js";
+export declare function serializeSettings(settings: PmSettings): string;
+export declare function readSettings(pmRoot: string): Promise<PmSettings>;
+export declare function writeSettings(pmRoot: string, settings: PmSettings, op?: string): Promise<void>;