@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/core/item/type-synonyms.js

@@ -1,39 +1,2 @@
-/**
- * Common type synonyms agents type that are not item types themselves. Telemetry
- * shows real users repeatedly run e.g. `pm create Bug "..."` and `pm create Change
- * "..."` and hit a hard "invalid type" error. Rather than block, `create` maps an
- * unregistered type through this table to its closest canonical built-in type (and
- * prints a note). The mapping is only a FALLBACK: it applies after the real type
- * registry fails to resolve the name, and the canonical target is itself resolved
- * through the live registry — so a project that defines its own `Bug` type keeps it,
- * and a project that has removed `Issue` will simply fall through to the normal error.
- *
- * Keys are compared case-insensitively after trimming. Values are canonical built-in
- * type names (resolved through the registry, never written verbatim).
- */
-/** Public contract for type synonyms, shared by SDK and presentation-layer consumers. */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b7a167e0-3041-5056-a672-ea0a054ed8df")}catch(e){}}();
-export const TYPE_SYNONYMS = {
-    bug: "Issue",
-    bugfix: "Issue",
-    defect: "Issue",
-    incident: "Issue",
-    enhancement: "Feature",
-    story: "Feature",
-    userstory: "Feature",
-    "user-story": "Feature",
-    "user story": "Feature",
-    change: "Chore",
-    ticket: "Task",
-    todo: "Task",
-};
-/** Map a free-form type token to its canonical built-in type synonym, or `undefined` when there is no synonym. The caller must still confirm the canonical target exists in the active type registry before using it. */
-export function resolveTypeSynonym(rawType) {
-    if (rawType === undefined) {
-        return undefined;
-    }
-    return TYPE_SYNONYMS[rawType.trim().toLowerCase()];
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="eb151177-d326-5ce4-9624-87f6393046e0")}catch(e2){}})();const TYPE_SYNONYMS={bug:"Issue",bugfix:"Issue",defect:"Issue",incident:"Issue",enhancement:"Feature",story:"Feature",userstory:"Feature","user-story":"Feature","user story":"Feature",change:"Chore",ticket:"Task",todo:"Task"};function resolveTypeSynonym(rawType){if(rawType===void 0){return void 0}return TYPE_SYNONYMS[rawType.trim().toLowerCase()]}export{TYPE_SYNONYMS,resolveTypeSynonym};
 //# sourceMappingURL=type-synonyms.js.map
-//# debugId=b7a167e0-3041-5056-a672-ea0a054ed8df

package/dist/core/lock/index.js

@@ -1,10 +1,2 @@
-/**
- * @module core/lock/index
- *
- * Coordinates tracker lock ownership and cleanup for Index.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="19ab4e55-4912-53bb-8b01-17a771339334")}catch(e){}}();
-export * from "./lock.js";
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6569a063-f3b5-5067-88c8-d88b552c5f4c")}catch(e2){}})();export*from"./lock.js";
 //# sourceMappingURL=index.js.map
-//# debugId=19ab4e55-4912-53bb-8b01-17a771339334

package/dist/core/lock/lock-gc.js

@@ -1,241 +1,2 @@
-/**
- * lock-gc.ts — Stale lock file garbage collector.
- *
- * Safety-first policy: if a lock file cannot be read or parsed, it is RETAINED
- * rather than deleted. We only remove locks whose staleness can be conclusively
- * determined from the lock's own embedded `ttl_seconds` field.
- *
- * Staleness formula: (now_ms - Date.parse(created_at)) > ttl_seconds * 1000
- * Zero ttl means any lock older than 0 ms is stale. Negative ttl means always stale.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="79f9ccbd-48d1-5eb3-82ae-3dd62427041c")}catch(e){}}();
-import { isFileMissingError } from "../fs/fs-utils.js";
-import fs from "node:fs/promises";
-import path from "node:path";
-function parseLock(raw) {
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-        return null;
-    }
-    const candidate = parsed;
-    const { id, owner, created_at, ttl_seconds } = candidate;
-    if (typeof id !== "string" ||
-        typeof owner !== "string" ||
-        typeof created_at !== "string" ||
-        typeof ttl_seconds !== "number" ||
-        !Number.isFinite(ttl_seconds)) {
-        return null;
-    }
-    return { id, owner, created_at, ttl_seconds };
-}
-/** Pure classification of one lock file's raw content against `nowMs`. This is the single staleness/parse policy shared by `pm gc --scope locks` (which acts on it) and the `pm health` locks check (which only reports it). */
-export function classifyLockContent(file, raw, nowMs) {
-    const lock = parseLock(raw);
-    if (lock === null) {
-        return {
-            detail: "unparseable_json",
-            entry: {
-                file,
-                id: null,
-                owner: null,
-                created_at: null,
-                ttl_seconds: null,
-                age_seconds: null,
-                stale: false,
-                reason: "unparseable",
-            },
-        };
-    }
-    const createdAtMs = Date.parse(lock.created_at);
-    if (!Number.isFinite(createdAtMs)) {
-        return {
-            detail: "invalid_timestamp",
-            entry: {
-                file,
-                id: lock.id,
-                owner: lock.owner,
-                created_at: lock.created_at,
-                ttl_seconds: lock.ttl_seconds,
-                age_seconds: null,
-                stale: false,
-                reason: "unparseable",
-            },
-        };
-    }
-    const ageMs = nowMs - createdAtMs;
-    const age_seconds = Math.floor(ageMs / 1000);
-    const stale = ageMs > lock.ttl_seconds * 1000;
-    return {
-        detail: stale ? "expired" : "active",
-        entry: {
-            file,
-            id: lock.id,
-            owner: lock.owner,
-            created_at: lock.created_at,
-            ttl_seconds: lock.ttl_seconds,
-            age_seconds,
-            stale,
-            reason: stale ? "expired" : "active",
-        },
-    };
-}
-/** Read-only locks scan for `pm health`: classifies every lock file with the same policy `pm gc --scope locks` uses but never removes anything. */
-export async function scanLockHealth(pmRoot, now) {
-    const nowMs = now ?? Date.now();
-    const locksDir = path.join(pmRoot, "locks");
-    const scan = {
-        scanned: 0,
-        active_lock_count: 0,
-        stale_lock_count: 0,
-        unreadable_lock_count: 0,
-        unparseable_lock_count: 0,
-    };
-    let dirEntries;
-    try {
-        const rawDir = await fs.readdir(locksDir);
-        dirEntries = rawDir.filter((f) => f.endsWith(".lock")).sort();
-    }
-    catch (error) {
-        if (isFileMissingError(error)) {
-            return scan;
-        }
-        throw error;
-    }
-    for (const file of dirEntries) {
-        let raw;
-        try {
-            raw = await fs.readFile(path.join(locksDir, file), "utf8");
-        }
-        catch (readError) {
-            if (isFileMissingError(readError)) {
-                // Disappeared between readdir and readFile — treat as a ghost; skip quietly.
-                continue;
-            }
-            scan.scanned += 1;
-            scan.unreadable_lock_count += 1;
-            continue;
-        }
-        scan.scanned += 1;
-        const { detail } = classifyLockContent(file, raw, nowMs);
-        if (detail === "active") {
-            scan.active_lock_count += 1;
-        }
-        else if (detail === "expired") {
-            scan.stale_lock_count += 1;
-        }
-        else {
-            scan.unparseable_lock_count += 1;
-        }
-    }
-    return scan;
-}
-/** Implements run lock gc for the public runtime surface of this module. */
-export async function runLockGc(pmRoot, options) {
-    const { dryRun, hooks } = options;
-    const nowMs = options.now ?? Date.now();
-    const locksDir = path.join(pmRoot, "locks");
-    const result = {
-        scanned: 0,
-        removed: [],
-        retained: [],
-        warnings: [],
-        entries: [],
-    };
-    let dirEntries;
-    try {
-        const raw = await fs.readdir(locksDir);
-        dirEntries = raw.filter((f) => f.endsWith(".lock")).sort();
-    }
-    catch (error) {
-        if (isFileMissingError(error)) {
-            return result;
-        }
-        throw error;
-    }
-    for (const file of dirEntries) {
-        result.scanned += 1;
-        const absPath = path.join(locksDir, file);
-        const relPath = `locks/${file}`;
-        // --- onRead hook ---
-        if (hooks?.onRead) {
-            const hookWarnings = await hooks.onRead(absPath);
-            result.warnings.push(...hookWarnings);
-        }
-        // --- read file ---
-        let raw;
-        try {
-            raw = await fs.readFile(absPath, "utf8");
-        }
-        catch (readError) {
-            if (isFileMissingError(readError)) {
-                // Disappeared between readdir and readFile — treat as a ghost; skip quietly.
-                result.scanned -= 1;
-                continue;
-            }
-            result.warnings.push(`lock_unreadable:${file}`);
-            result.retained.push(relPath);
-            result.entries.push({
-                file,
-                id: null,
-                owner: null,
-                created_at: null,
-                ttl_seconds: null,
-                age_seconds: null,
-                stale: false,
-                reason: "unparseable",
-            });
-            continue;
-        }
-        // --- classify (shared with the read-only pm health locks scan) ---
-        const classified = classifyLockContent(file, raw, nowMs);
-        if (classified.detail === "unparseable_json") {
-            result.warnings.push(`lock_unparseable:${file}`);
-            result.retained.push(relPath);
-            result.entries.push(classified.entry);
-            continue;
-        }
-        if (classified.detail === "invalid_timestamp") {
-            result.warnings.push(`lock_invalid_timestamp:${file}`);
-            result.retained.push(relPath);
-            result.entries.push(classified.entry);
-            continue;
-        }
-        if (classified.detail === "active") {
-            result.retained.push(relPath);
-            result.entries.push(classified.entry);
-            continue;
-        }
-        // --- stale: remove or preview ---
-        if (!dryRun) {
-            try {
-                await fs.unlink(absPath);
-            }
-            catch (unlinkError) {
-                if (!isFileMissingError(unlinkError)) {
-                    result.warnings.push(`lock_remove_failed:${file}`);
-                    result.retained.push(relPath);
-                    result.entries.push(classified.entry);
-                    continue;
-                }
-                // ENOENT on unlink = already gone (race); treat as removed
-            }
-            // onWrite hook after successful removal
-            if (hooks?.onWrite) {
-                const hookWarnings = await hooks.onWrite(absPath);
-                result.warnings.push(...hookWarnings);
-            }
-        }
-        result.removed.push(relPath);
-        result.entries.push(classified.entry);
-    }
-    return result;
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="84aca8e9-b9a8-59dd-8e11-aa9f67184ec4")}catch(e2){}})();import{isFileMissingError}from"../fs/fs-utils.js";import fs from"node:fs/promises";import path from"node:path";function parseLock(raw){let parsed;try{parsed=JSON.parse(raw)}catch{return null}if(typeof parsed!=="object"||parsed===null||Array.isArray(parsed)){return null}const candidate=parsed;const{id,owner,created_at,ttl_seconds}=candidate;if(typeof id!=="string"||typeof owner!=="string"||typeof created_at!=="string"||typeof ttl_seconds!=="number"||!Number.isFinite(ttl_seconds)){return null}return{id,owner,created_at,ttl_seconds}}function classifyLockContent(file,raw,nowMs){const lock=parseLock(raw);if(lock===null){return{detail:"unparseable_json",entry:{file,id:null,owner:null,created_at:null,ttl_seconds:null,age_seconds:null,stale:false,reason:"unparseable"}}}const createdAtMs=Date.parse(lock.created_at);if(!Number.isFinite(createdAtMs)){return{detail:"invalid_timestamp",entry:{file,id:lock.id,owner:lock.owner,created_at:lock.created_at,ttl_seconds:lock.ttl_seconds,age_seconds:null,stale:false,reason:"unparseable"}}}const ageMs=nowMs-createdAtMs;const age_seconds=Math.floor(ageMs/1e3);const stale=ageMs>lock.ttl_seconds*1e3;return{detail:stale?"expired":"active",entry:{file,id:lock.id,owner:lock.owner,created_at:lock.created_at,ttl_seconds:lock.ttl_seconds,age_seconds,stale,reason:stale?"expired":"active"}}}async function scanLockHealth(pmRoot,now){const nowMs=now??Date.now();const locksDir=path.join(pmRoot,"locks");const scan={scanned:0,active_lock_count:0,stale_lock_count:0,unreadable_lock_count:0,unparseable_lock_count:0};let dirEntries;try{const rawDir=await fs.readdir(locksDir);dirEntries=rawDir.filter(f=>f.endsWith(".lock")).sort()}catch(error){if(isFileMissingError(error)){return scan}throw error}for(const file of dirEntries){let raw;try{raw=await fs.readFile(path.join(locksDir,file),"utf8")}catch(readError){if(isFileMissingError(readError)){continue}scan.scanned+=1;scan.unreadable_lock_count+=1;continue}scan.scanned+=1;const{detail}=classifyLockContent(file,raw,nowMs);if(detail==="active"){scan.active_lock_count+=1}else if(detail==="expired"){scan.stale_lock_count+=1}else{scan.unparseable_lock_count+=1}}return scan}async function runLockGc(pmRoot,options){const{dryRun,hooks}=options;const nowMs=options.now??Date.now();const locksDir=path.join(pmRoot,"locks");const result={scanned:0,removed:[],retained:[],warnings:[],entries:[]};let dirEntries;try{const raw=await fs.readdir(locksDir);dirEntries=raw.filter(f=>f.endsWith(".lock")).sort()}catch(error){if(isFileMissingError(error)){return result}throw error}for(const file of dirEntries){result.scanned+=1;const absPath=path.join(locksDir,file);const relPath=`locks/${file}`;if(hooks?.onRead){const hookWarnings=await hooks.onRead(absPath);result.warnings.push(...hookWarnings)}let raw;try{raw=await fs.readFile(absPath,"utf8")}catch(readError){if(isFileMissingError(readError)){result.scanned-=1;continue}result.warnings.push(`lock_unreadable:${file}`);result.retained.push(relPath);result.entries.push({file,id:null,owner:null,created_at:null,ttl_seconds:null,age_seconds:null,stale:false,reason:"unparseable"});continue}const classified=classifyLockContent(file,raw,nowMs);if(classified.detail==="unparseable_json"){result.warnings.push(`lock_unparseable:${file}`);result.retained.push(relPath);result.entries.push(classified.entry);continue}if(classified.detail==="invalid_timestamp"){result.warnings.push(`lock_invalid_timestamp:${file}`);result.retained.push(relPath);result.entries.push(classified.entry);continue}if(classified.detail==="active"){result.retained.push(relPath);result.entries.push(classified.entry);continue}if(!dryRun){try{await fs.unlink(absPath)}catch(unlinkError){if(!isFileMissingError(unlinkError)){result.warnings.push(`lock_remove_failed:${file}`);result.retained.push(relPath);result.entries.push(classified.entry);continue}}if(hooks?.onWrite){const hookWarnings=await hooks.onWrite(absPath);result.warnings.push(...hookWarnings)}}result.removed.push(relPath);result.entries.push(classified.entry)}return result}export{classifyLockContent,runLockGc,scanLockHealth};
 //# sourceMappingURL=lock-gc.js.map
-//# debugId=79f9ccbd-48d1-5eb3-82ae-3dd62427041c