@unbrained/pm-cli 2026.3.9

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

@@ -0,0 +1,363 @@
+import { CONFIDENCE_TEXT_VALUES, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, STATUS_VALUES } from "../../types/index.js";
+import { EXIT_CODE, FRONT_MATTER_KEY_ORDER } from "../shared/constants.js";
+import { PmCliError } from "../shared/errors.js";
+import { orderObject } from "../shared/serialization.js";
+function normalizePathValue(value) {
+    return value.replaceAll("\\", "/");
+}
+const REQUIRED_STRING_FIELDS = [
+    "id",
+    "title",
+    "description",
+    "created_at",
+    "updated_at",
+];
+function validationError(message) {
+    throw new PmCliError(`Invalid item front matter: ${message}`, EXIT_CODE.GENERIC_FAILURE);
+}
+function assertFrontMatterCondition(condition, message) {
+    if (!condition) {
+        validationError(message);
+    }
+}
+function assertTimestampField(record, fieldName) {
+    const rawValue = record[fieldName];
+    assertFrontMatterCondition(typeof rawValue === "string", `${fieldName} must be a string`);
+    const timestamp = rawValue;
+    assertFrontMatterCondition(Number.isFinite(Date.parse(timestamp)), `${fieldName} must be a valid ISO timestamp`);
+}
+function assertValidFrontMatter(frontMatter) {
+    assertFrontMatterCondition(typeof frontMatter === "object" && frontMatter !== null && !Array.isArray(frontMatter), "front matter must be an object");
+    const record = frontMatter;
+    for (const fieldName of REQUIRED_STRING_FIELDS) {
+        assertFrontMatterCondition(typeof record[fieldName] === "string", `${fieldName} is required and must be a string`);
+    }
+    const itemType = record.type;
+    assertFrontMatterCondition(typeof itemType === "string" && ITEM_TYPE_VALUES.includes(itemType), `type must be one of: ${ITEM_TYPE_VALUES.join(", ")}`);
+    const status = record.status;
+    assertFrontMatterCondition(typeof status === "string" && STATUS_VALUES.includes(status), `status must be one of: ${STATUS_VALUES.join(", ")}`);
+    const priority = record.priority;
+    assertFrontMatterCondition(typeof priority === "number" && Number.isInteger(priority) && [0, 1, 2, 3, 4].includes(priority), "priority must be an integer 0..4");
+    const tags = record.tags;
+    assertFrontMatterCondition(Array.isArray(tags), "tags must be an array");
+    for (const tag of tags) {
+        assertFrontMatterCondition(typeof tag === "string", "tags entries must be strings");
+    }
+    const confidence = record.confidence;
+    if (confidence !== undefined) {
+        if (typeof confidence === "number") {
+            assertFrontMatterCondition(Number.isInteger(confidence) && confidence >= 0 && confidence <= 100, "confidence number value must be an integer 0..100");
+        }
+        else if (typeof confidence === "string") {
+            const normalizedConfidence = confidence.trim().toLowerCase();
+            const isKnownTextConfidence = normalizedConfidence === "med" || CONFIDENCE_TEXT_VALUES.includes(normalizedConfidence);
+            assertFrontMatterCondition(isKnownTextConfidence, `confidence string value must be one of: ${[...CONFIDENCE_TEXT_VALUES, "med"].join(", ")}`);
+        }
+        else {
+            assertFrontMatterCondition(false, "confidence must be a number or string");
+        }
+    }
+    const severity = record.severity;
+    if (severity !== undefined) {
+        if (typeof severity !== "string") {
+            validationError("severity must be a string");
+        }
+        const normalizedSeverity = severity.trim().toLowerCase();
+        const isKnownSeverity = normalizedSeverity === "med" || ISSUE_SEVERITY_VALUES.includes(normalizedSeverity);
+        assertFrontMatterCondition(isKnownSeverity, `severity value must be one of: ${[...ISSUE_SEVERITY_VALUES, "med"].join(", ")}`);
+    }
+    const regression = record.regression;
+    if (regression !== undefined) {
+        if (typeof regression !== "boolean") {
+            validationError("regression must be a boolean");
+        }
+    }
+    assertTimestampField(record, "created_at");
+    assertTimestampField(record, "updated_at");
+    if (record.deadline !== undefined) {
+        assertTimestampField(record, "deadline");
+    }
+}
+function sortDependencies(values) {
+    if (!values || values.length === 0)
+        return undefined;
+    return [...values]
+        .map((value) => ({
+        id: value.id.trim().toLowerCase(),
+        kind: value.kind,
+        created_at: value.created_at,
+        author: value.author?.trim() || undefined,
+    }))
+        .sort((a, b) => {
+        const byCreated = a.created_at.localeCompare(b.created_at);
+        if (byCreated !== 0)
+            return byCreated;
+        const byId = a.id.localeCompare(b.id);
+        if (byId !== 0)
+            return byId;
+        return a.kind.localeCompare(b.kind);
+    });
+}
+function sortLogValues(values) {
+    if (!values || values.length === 0)
+        return undefined;
+    return [...values].sort((a, b) => {
+        const byCreated = a.created_at.localeCompare(b.created_at);
+        if (byCreated !== 0)
+            return byCreated;
+        const byText = a.text.localeCompare(b.text);
+        if (byText !== 0)
+            return byText;
+        return a.author.localeCompare(b.author);
+    });
+}
+function sortFiles(values) {
+    if (!values || values.length === 0)
+        return undefined;
+    return [...values]
+        .map((value) => ({
+        path: normalizePathValue(value.path),
+        scope: value.scope,
+        note: value.note?.trim() || undefined,
+    }))
+        .sort((a, b) => {
+        const byScope = a.scope.localeCompare(b.scope);
+        if (byScope !== 0)
+            return byScope;
+        const byPath = a.path.localeCompare(b.path);
+        if (byPath !== 0)
+            return byPath;
+        return (a.note ?? "").localeCompare(b.note ?? "");
+    });
+}
+function sortTests(values) {
+    if (!values || values.length === 0)
+        return undefined;
+    return [...values]
+        .map((value) => ({
+        command: value.command?.trim() || undefined,
+        path: value.path ? normalizePathValue(value.path) : undefined,
+        scope: value.scope,
+        timeout_seconds: value.timeout_seconds,
+        note: value.note?.trim() || undefined,
+    }))
+        .sort((a, b) => {
+        const byScope = a.scope.localeCompare(b.scope);
+        if (byScope !== 0)
+            return byScope;
+        const byPath = (a.path ?? "").localeCompare(b.path ?? "");
+        if (byPath !== 0)
+            return byPath;
+        const byCommand = (a.command ?? "").localeCompare(b.command ?? "");
+        if (byCommand !== 0)
+            return byCommand;
+        const byTimeout = (a.timeout_seconds ?? 0) - (b.timeout_seconds ?? 0);
+        if (byTimeout !== 0)
+            return byTimeout;
+        return (a.note ?? "").localeCompare(b.note ?? "");
+    });
+}
+function sortDocs(values) {
+    if (!values || values.length === 0)
+        return undefined;
+    return [...values]
+        .map((value) => ({
+        path: normalizePathValue(value.path),
+        scope: value.scope,
+        note: value.note?.trim() || undefined,
+    }))
+        .sort((a, b) => {
+        const byScope = a.scope.localeCompare(b.scope);
+        if (byScope !== 0)
+            return byScope;
+        const byPath = a.path.localeCompare(b.path);
+        if (byPath !== 0)
+            return byPath;
+        return (a.note ?? "").localeCompare(b.note ?? "");
+    });
+}
+function normalizeBody(body) {
+    return body.replace(/^\n+/, "").replace(/\s+$/, "");
+}
+function normalizeConfidenceValue(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value === "number") {
+        return value;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "med") {
+        return "medium";
+    }
+    if (CONFIDENCE_TEXT_VALUES.includes(normalized)) {
+        return normalized;
+    }
+    return undefined;
+}
+function normalizeSeverityValue(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "med") {
+        return "medium";
+    }
+    if (ISSUE_SEVERITY_VALUES.includes(normalized)) {
+        return normalized;
+    }
+    return undefined;
+}
+export function normalizeFrontMatter(frontMatter) {
+    const tags = Array.from(new Set(frontMatter.tags.map((tag) => tag.trim().toLowerCase()).filter(Boolean))).sort((a, b) => a.localeCompare(b));
+    const normalized = {
+        id: frontMatter.id,
+        title: frontMatter.title,
+        description: frontMatter.description,
+        type: frontMatter.type,
+        status: frontMatter.status,
+        priority: frontMatter.priority,
+        tags,
+        created_at: frontMatter.created_at,
+        updated_at: frontMatter.updated_at,
+        dependencies: sortDependencies(frontMatter.dependencies),
+        comments: sortLogValues(frontMatter.comments),
+        notes: sortLogValues(frontMatter.notes),
+        learnings: sortLogValues(frontMatter.learnings),
+        files: sortFiles(frontMatter.files),
+        tests: sortTests(frontMatter.tests),
+        docs: sortDocs(frontMatter.docs),
+        deadline: frontMatter.deadline || undefined,
+        assignee: frontMatter.assignee?.trim() || undefined,
+        author: frontMatter.author || undefined,
+        estimated_minutes: frontMatter.estimated_minutes,
+        acceptance_criteria: frontMatter.acceptance_criteria ?? undefined,
+        definition_of_ready: frontMatter.definition_of_ready?.trim() || undefined,
+        order: frontMatter.order,
+        goal: frontMatter.goal?.trim() || undefined,
+        objective: frontMatter.objective?.trim() || undefined,
+        value: frontMatter.value?.trim() || undefined,
+        impact: frontMatter.impact?.trim() || undefined,
+        outcome: frontMatter.outcome?.trim() || undefined,
+        why_now: frontMatter.why_now?.trim() || undefined,
+        parent: frontMatter.parent?.trim() || undefined,
+        reviewer: frontMatter.reviewer?.trim() || undefined,
+        risk: frontMatter.risk ?? undefined,
+        confidence: normalizeConfidenceValue(frontMatter.confidence),
+        sprint: frontMatter.sprint?.trim() || undefined,
+        release: frontMatter.release?.trim() || undefined,
+        blocked_by: frontMatter.blocked_by?.trim() || undefined,
+        blocked_reason: frontMatter.blocked_reason?.trim() || undefined,
+        unblock_note: frontMatter.unblock_note?.trim() || undefined,
+        reporter: frontMatter.reporter?.trim() || undefined,
+        severity: normalizeSeverityValue(frontMatter.severity),
+        environment: frontMatter.environment?.trim() || undefined,
+        repro_steps: frontMatter.repro_steps?.trim() || undefined,
+        resolution: frontMatter.resolution?.trim() || undefined,
+        expected_result: frontMatter.expected_result?.trim() || undefined,
+        actual_result: frontMatter.actual_result?.trim() || undefined,
+        affected_version: frontMatter.affected_version?.trim() || undefined,
+        fixed_version: frontMatter.fixed_version?.trim() || undefined,
+        component: frontMatter.component?.trim() || undefined,
+        regression: frontMatter.regression,
+        customer_impact: frontMatter.customer_impact?.trim() || undefined,
+        close_reason: frontMatter.close_reason || undefined,
+    };
+    for (const [key, value] of Object.entries(normalized)) {
+        if (value === undefined) {
+            delete normalized[key];
+        }
+    }
+    return normalized;
+}
+function orderFrontMatter(frontMatter) {
+    return orderObject(frontMatter, FRONT_MATTER_KEY_ORDER);
+}
+function findJsonObjectEnd(content) {
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = 0; i < content.length; i += 1) {
+        const char = content[i];
+        if (inString) {
+            if (escaped) {
+                escaped = false;
+                continue;
+            }
+            if (char === "\\") {
+                escaped = true;
+                continue;
+            }
+            if (char === "\"") {
+                inString = false;
+            }
+            continue;
+        }
+        if (char === "\"") {
+            inString = true;
+            continue;
+        }
+        if (char === "{") {
+            depth += 1;
+            continue;
+        }
+        if (char === "}") {
+            depth -= 1;
+            if (depth === 0) {
+                return i;
+            }
+        }
+    }
+    return -1;
+}
+export function splitFrontMatter(content) {
+    if (!content.startsWith("{")) {
+        return { frontMatter: "", body: content };
+    }
+    const end = findJsonObjectEnd(content);
+    if (end < 0) {
+        return { frontMatter: "", body: content };
+    }
+    const frontMatter = content.slice(0, end + 1);
+    const body = content.slice(end + 1).replace(/^\r?\n+/, "");
+    return { frontMatter, body };
+}
+export function parseItemDocument(content) {
+    const { frontMatter, body } = splitFrontMatter(content);
+    if (!frontMatter) {
+        const trimmed = content.trimStart();
+        if (trimmed.startsWith("{")) {
+            validationError("JSON front matter is not valid JSON");
+        }
+        validationError("missing JSON front matter");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(frontMatter);
+    }
+    catch {
+        validationError("JSON front matter is not valid JSON");
+    }
+    assertValidFrontMatter(parsed);
+    return {
+        front_matter: normalizeFrontMatter(parsed),
+        body: normalizeBody(body),
+    };
+}
+export function serializeItemDocument(document) {
+    const normalizedFrontMatter = normalizeFrontMatter(document.front_matter);
+    const orderedFrontMatter = orderFrontMatter(normalizedFrontMatter);
+    const serializedFrontMatter = JSON.stringify(orderedFrontMatter, null, 2);
+    const normalizedBody = normalizeBody(document.body ?? "");
+    if (!normalizedBody) {
+        return `${serializedFrontMatter}\n`;
+    }
+    return `${serializedFrontMatter}\n\n${normalizedBody}\n`;
+}
+export function canonicalDocument(document) {
+    return {
+        front_matter: normalizeFrontMatter(document.front_matter),
+        body: normalizeBody(document.body ?? ""),
+    };
+}
+//# sourceMappingURL=item-format.js.map

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

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

package/dist/core/item/parse.d.ts

@@ -0,0 +1,3 @@
+export declare function parseTags(raw: string): string[];
+export declare function parseCsvKv(raw: string, optionName: string): Record<string, string>;
+export declare function parseOptionalNumber(raw: string, optionName: string): number;

package/dist/core/item/parse.js

@@ -0,0 +1,72 @@
+import { PmCliError } from "../shared/errors.js";
+import { EXIT_CODE } from "../shared/constants.js";
+import { isNoneToken } from "../shared/time.js";
+export function parseTags(raw) {
+    if (isNoneToken(raw) || raw.trim() === "") {
+        return [];
+    }
+    const tags = raw
+        .split(",")
+        .map((tag) => tag.trim())
+        .filter(Boolean)
+        .map((tag) => tag.toLowerCase());
+    return Array.from(new Set(tags)).sort((a, b) => a.localeCompare(b));
+}
+export function parseCsvKv(raw, optionName) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        throw new PmCliError(`${optionName} cannot be empty`, EXIT_CODE.USAGE);
+    }
+    const parts = [];
+    let current = "";
+    let inQuotes = false;
+    let escaped = false;
+    for (const char of trimmed) {
+        if (escaped) {
+            current += char;
+            escaped = false;
+            continue;
+        }
+        if (char === "\\") {
+            current += char;
+            escaped = true;
+            continue;
+        }
+        if (char === "\"") {
+            inQuotes = !inQuotes;
+            current += char;
+            continue;
+        }
+        if (char === "," && !inQuotes) {
+            parts.push(current.trim());
+            current = "";
+            continue;
+        }
+        current += char;
+    }
+    if (current.trim()) {
+        parts.push(current.trim());
+    }
+    const result = {};
+    for (const part of parts) {
+        const idx = part.indexOf("=");
+        if (idx <= 0) {
+            throw new PmCliError(`Invalid ${optionName} value "${raw}". Expected key=value pairs separated by commas.`, EXIT_CODE.USAGE);
+        }
+        const key = part.slice(0, idx).trim();
+        let value = part.slice(idx + 1).trim();
+        if (value.startsWith("\"") && value.endsWith("\"")) {
+            value = value.slice(1, -1).replace(/\\"/g, "\"");
+        }
+        result[key] = value;
+    }
+    return result;
+}
+export function parseOptionalNumber(raw, optionName) {
+    const value = Number(raw);
+    if (!Number.isFinite(value)) {
+        throw new PmCliError(`Invalid ${optionName} value "${raw}"`, EXIT_CODE.USAGE);
+    }
+    return value;
+}
+//# sourceMappingURL=parse.js.map

package/dist/core/item/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/core/item/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,IAAI,GAAG,GAAG;SACb,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,UAAkB;IACxD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAAC,GAAG,UAAU,kBAAkB,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,IAAI,IAAI,CAAC;YAChB,OAAO,GAAG,KAAK,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,IAAI,CAAC;YAChB,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACrB,OAAO,IAAI,IAAI,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3B,OAAO,GAAG,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QACD,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,MAAM,IAAI,UAAU,CAClB,WAAW,UAAU,WAAW,GAAG,kDAAkD,EACrF,SAAS,CAAC,KAAK,CAChB,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,UAAkB;IACjE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,UAAU,CAAC,WAAW,UAAU,WAAW,GAAG,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1 @@
+export * from "./lock.js";

package/dist/core/lock/index.js

@@ -0,0 +1,2 @@
+export * from "./lock.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/lock/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/core/lock/lock.d.ts

@@ -0,0 +1 @@
+export declare function acquireLock(pmRoot: string, id: string, ttlSeconds: number, owner: string, force?: boolean): Promise<() => Promise<void>>;

package/dist/core/lock/lock.js

@@ -0,0 +1,100 @@
+import fs from "node:fs/promises";
+import { runActiveOnReadHooks, runActiveOnWriteHooks } from "../extensions/index.js";
+import { EXIT_CODE } from "../shared/constants.js";
+import { PmCliError } from "../shared/errors.js";
+import { getLockPath } from "../store/paths.js";
+import { nowIso } from "../shared/time.js";
+async function readLockInfo(lockPath) {
+    try {
+        const raw = await fs.readFile(lockPath, "utf8");
+        await runActiveOnReadHooks({
+            path: lockPath,
+            scope: "project",
+        });
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function isErrno(error, code) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === code;
+}
+async function emitLockWriteHook(lockPath, op) {
+    await runActiveOnWriteHooks({
+        path: lockPath,
+        scope: "project",
+        op,
+    });
+}
+function buildLockPayload(id, owner, ttlSeconds) {
+    return {
+        id,
+        pid: process.pid,
+        owner,
+        created_at: nowIso(),
+        ttl_seconds: ttlSeconds,
+    };
+}
+async function createLockFile(lockPath, id, owner, ttlSeconds) {
+    const handle = await fs.open(lockPath, "wx");
+    try {
+        await handle.writeFile(`${JSON.stringify(buildLockPayload(id, owner, ttlSeconds), null, 2)}\n`, "utf8");
+    }
+    finally {
+        await handle.close();
+    }
+    await emitLockWriteHook(lockPath, "lock:create");
+}
+async function unlinkLockWithHook(lockPath, op) {
+    try {
+        await fs.unlink(lockPath);
+        await emitLockWriteHook(lockPath, op);
+    }
+    catch {
+        // Lock cleanup is best-effort.
+    }
+}
+function isStaleLock(info, ttlSeconds) {
+    const createdAtMs = info?.created_at ? Date.parse(info.created_at) : Number.NaN;
+    const ageMs = Number.isFinite(createdAtMs) ? Date.now() - createdAtMs : Number.POSITIVE_INFINITY;
+    return ageMs > ttlSeconds * 1000;
+}
+function lockOwnerSuffix(info) {
+    return info?.owner ? ` (owner ${info.owner})` : "";
+}
+async function handleExistingLock(lockPath, id, ttlSeconds, force) {
+    const info = await readLockInfo(lockPath);
+    if (!isStaleLock(info, ttlSeconds)) {
+        throw new PmCliError(`Item ${id} is locked${lockOwnerSuffix(info)}`, EXIT_CODE.CONFLICT);
+    }
+    if (!force) {
+        throw new PmCliError(`Item ${id} lock is stale; rerun with --force when supported for this command`, EXIT_CODE.CONFLICT);
+    }
+    await unlinkLockWithHook(lockPath, "lock:stale_remove");
+}
+function toErrorMessage(error) {
+    if (error instanceof Error && error.message.trim().length > 0) {
+        return error.message;
+    }
+    return String(error);
+}
+export async function acquireLock(pmRoot, id, ttlSeconds, owner, force = false) {
+    const lockPath = getLockPath(pmRoot, id);
+    for (let attempt = 0; attempt < 3; attempt += 1) {
+        try {
+            await createLockFile(lockPath, id, owner, ttlSeconds);
+            return async () => {
+                await unlinkLockWithHook(lockPath, "lock:release");
+            };
+        }
+        catch (error) {
+            if (!isErrno(error, "EEXIST")) {
+                throw new PmCliError(`Failed to acquire lock for ${id}: ${toErrorMessage(error)}`, EXIT_CODE.GENERIC_FAILURE);
+            }
+            await handleExistingLock(lockPath, id, ttlSeconds, force);
+        }
+    }
+    throw new PmCliError(`Failed to acquire lock for ${id}`, EXIT_CODE.CONFLICT);
+}
+//# sourceMappingURL=lock.js.map

package/dist/core/lock/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../src/core/lock/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAY3C,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,oBAAoB,CAAC;YACzB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,KAAc,EAAE,IAAY;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAK,KAA2B,CAAC,IAAI,KAAK,IAAI,CAAC;AACtH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,QAAgB,EAAE,EAAe;IAChE,MAAM,qBAAqB,CAAC;QAC1B,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,SAAS;QAChB,EAAE;KACH,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAU,EAAE,KAAa,EAAE,UAAkB;IACrE,OAAO;QACL,EAAE;QACF,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK;QACL,UAAU,EAAE,MAAM,EAAE;QACpB,WAAW,EAAE,UAAU;KACxB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,EAAU,EAAE,KAAa,EAAE,UAAkB;IAC3F,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1G,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IACD,MAAM,iBAAiB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AACnD,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,QAAgB,EAAE,EAAwC;IAC1F,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,MAAM,iBAAiB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAqB,EAAE,UAAkB;IAC5D,MAAM,WAAW,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IAChF,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;IACjG,OAAO,KAAK,GAAG,UAAU,GAAG,IAAI,CAAC;AACnC,CAAC;AAED,SAAS,eAAe,CAAC,IAAqB;IAC5C,OAAO,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,QAAgB,EAAE,EAAU,EAAE,UAAkB,EAAE,KAAc;IAChG,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,UAAU,CAAC,QAAQ,EAAE,aAAa,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC3F,CAAC;IAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,UAAU,CAClB,QAAQ,EAAE,oEAAoE,EAC9E,SAAS,CAAC,QAAQ,CACnB,CAAC;IACJ,CAAC;IAED,MAAM,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAc,EACd,EAAU,EACV,UAAkB,EAClB,KAAa,EACb,KAAK,GAAG,KAAK;IAEb,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEzC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YACtD,OAAO,KAAK,IAAI,EAAE;gBAChB,MAAM,kBAAkB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;YACrD,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,UAAU,CAAC,8BAA8B,EAAE,KAAK,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;YAChH,CAAC;YACD,MAAM,kBAAkB,CAAC,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,MAAM,IAAI,UAAU,CAAC,8BAA8B,EAAE,EAAE,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC/E,CAAC"}

package/dist/core/output/output.d.ts

@@ -0,0 +1,7 @@
+export interface OutputOptions {
+    json?: boolean;
+    quiet?: boolean;
+}
+export declare function formatOutput(result: unknown, options: OutputOptions): string;
+export declare function printResult(result: unknown, options: OutputOptions): void;
+export declare function printError(message: string): void;