@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/core/test/item-test-run-tracking.js

@@ -1,64 +1,2 @@
-/**
- * @module core/test/item-test-run-tracking
- *
- * Runs and records linked-test orchestration for Item Test Run Tracking.
- */
-
-!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]="62af7c1e-c1c7-529e-ab30-117103ac4607")}catch(e){}}();
-import { mutateItem } from "../store/item-store.js";
-import { compareTimestampStrings } from "../shared/time.js";
-const DEFAULT_TRACKED_TEST_RUN_HISTORY_LIMIT = 20;
-function trackedTestRunHistoryLimit() {
-    const raw = process.env.PM_TRACKED_TEST_RUN_HISTORY_LIMIT;
-    if (!raw || raw.trim().length === 0) {
-        return DEFAULT_TRACKED_TEST_RUN_HISTORY_LIMIT;
-    }
-    const parsed = Number.parseInt(raw, 10);
-    if (!Number.isFinite(parsed) || parsed <= 0) {
-        return DEFAULT_TRACKED_TEST_RUN_HISTORY_LIMIT;
-    }
-    return parsed;
-}
-/** Normalize, order, and bound test-run history using the configured retention policy. */
-export function buildTrackedTestRunHistory(entries) {
-    const normalized = [...entries]
-        .filter((entry) => entry.run_id.trim().length > 0 &&
-        entry.started_at.trim().length > 0 &&
-        entry.finished_at.trim().length > 0 &&
-        entry.recorded_at.trim().length > 0)
-        .sort((left, right) => {
-        const byRecorded = compareTimestampStrings(left.recorded_at, right.recorded_at);
-        if (byRecorded !== 0)
-            return byRecorded;
-        const byRunId = left.run_id.localeCompare(right.run_id);
-        if (byRunId !== 0)
-            return byRunId;
-        return left.kind.localeCompare(right.kind);
-    });
-    const historyLimit = trackedTestRunHistoryLimit();
-    return normalized.length > historyLimit
-        ? normalized.slice(normalized.length - historyLimit)
-        : normalized;
-}
-/** Implements append tracked test run summary for the public runtime surface of this module. */
-export async function appendTrackedTestRunSummary(options) {
-    await mutateItem({
-        pmRoot: options.pmRoot,
-        settings: options.settings,
-        id: options.itemId,
-        op: "test_run_track",
-        author: options.author,
-        message: options.message,
-        force: false,
-        mutate(document) {
-            const current = document.metadata.test_runs ?? [];
-            document.metadata.test_runs = buildTrackedTestRunHistory([
-                ...current,
-                options.entry,
-            ]);
-            return { changedFields: ["test_runs"] };
-        },
-    });
-}
+!(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]="ffa50b5b-d99f-5ab4-a70d-cbf12911a0f2")}catch(e2){}})();import{mutateItem}from"../store/item-store.js";import{compareTimestampStrings}from"../shared/time.js";const DEFAULT_TRACKED_TEST_RUN_HISTORY_LIMIT=20;function trackedTestRunHistoryLimit(){const raw=process.env.PM_TRACKED_TEST_RUN_HISTORY_LIMIT;if(!raw||raw.trim().length===0){return DEFAULT_TRACKED_TEST_RUN_HISTORY_LIMIT}const parsed=Number.parseInt(raw,10);if(!Number.isFinite(parsed)||parsed<=0){return DEFAULT_TRACKED_TEST_RUN_HISTORY_LIMIT}return parsed}function buildTrackedTestRunHistory(entries){const normalized=[...entries].filter(entry=>entry.run_id.trim().length>0&&entry.started_at.trim().length>0&&entry.finished_at.trim().length>0&&entry.recorded_at.trim().length>0).sort((left,right)=>{const byRecorded=compareTimestampStrings(left.recorded_at,right.recorded_at);if(byRecorded!==0)return byRecorded;const byRunId=left.run_id.localeCompare(right.run_id);if(byRunId!==0)return byRunId;return left.kind.localeCompare(right.kind)});const historyLimit=trackedTestRunHistoryLimit();return normalized.length>historyLimit?normalized.slice(normalized.length-historyLimit):normalized}async function appendTrackedTestRunSummary(options){await mutateItem({pmRoot:options.pmRoot,settings:options.settings,id:options.itemId,op:"test_run_track",author:options.author,message:options.message,force:false,mutate(document){const current=document.metadata.test_runs??[];document.metadata.test_runs=buildTrackedTestRunHistory([...current,options.entry]);return{changedFields:["test_runs"]}}})}export{appendTrackedTestRunSummary,buildTrackedTestRunHistory};
 //# sourceMappingURL=item-test-run-tracking.js.map
-//# debugId=62af7c1e-c1c7-529e-ab30-117103ac4607

package/dist/core/test/run-selectors.js

@@ -1,121 +1,2 @@
-/**
- * @module core/test/run-selectors
- *
- * Runs and records linked-test orchestration for Run Selectors.
- */
-
-!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]="8a6a3402-dae3-56f8-b9ba-a4f6f8a47cda")}catch(e){}}();
-import { EXIT_CODE } from "../shared/constants.js";
-import { PmCliError } from "../shared/errors.js";
-const MAX_SELECTOR_ENTRY_LABEL_LENGTH = 100;
-/** Implements parse only index value for the public runtime surface of this module. */
-export function parseOnlyIndexValue(raw, optionName = "--only-index") {
-    const value = typeof raw === "number" ? raw : Number(String(raw).trim());
-    if (!Number.isInteger(value) || value < 1) {
-        throw new PmCliError(`${optionName} requires a 1-based integer index into the linked-test list (got "${raw}"). Use pm test <id> --list to inspect positions.`, EXIT_CODE.USAGE);
-    }
-    return value;
-}
-function summarizeSelectorEntry(entry) {
-    const label = entry.command ?? entry.path ?? "<no command>";
-    const normalized = label.replaceAll(/\s+/g, " ").trim() || "<no command>";
-    if (normalized.length <= MAX_SELECTOR_ENTRY_LABEL_LENGTH) {
-        return normalized;
-    }
-    return `${normalized.slice(0, MAX_SELECTOR_ENTRY_LABEL_LENGTH - 3)}...`;
-}
-/** Implements describe linked test entries for the public runtime surface of this module. */
-export function describeLinkedTestEntries(tests) {
-    return tests
-        .map((entry, index) => `${index + 1}. ${summarizeSelectorEntry(entry)}`)
-        .join("; ");
-}
-function activeSelectorKinds(selector) {
-    const kinds = [];
-    if (selector.match !== undefined) {
-        kinds.push("match");
-    }
-    if (selector.onlyIndex !== undefined) {
-        kinds.push("only-index");
-    }
-    if (selector.onlyLast === true) {
-        kinds.push("only-last");
-    }
-    return kinds;
-}
-function entryMatchesSubstring(entry, needle) {
-    const command = entry.command?.toLowerCase() ?? "";
-    const entryPath = entry.path?.toLowerCase() ?? "";
-    return command.includes(needle) || entryPath.includes(needle);
-}
-/** Implements resolve linked test run selection for the public runtime surface of this module. */
-export function resolveLinkedTestRunSelection(tests, selector) {
-    const kinds = activeSelectorKinds(selector);
-    if (kinds.length === 0) {
-        return {
-            selector: null,
-            requested: null,
-            selected: tests,
-            selected_indexes: tests.map((_, index) => index + 1),
-            selected_count: tests.length,
-            skipped_count: 0,
-        };
-    }
-    if (kinds.length > 1) {
-        throw new PmCliError(`Combine at most one linked-test selector per run: ${kinds.map((kind) => `--${kind}`).join(" and ")} were provided. Pick one of --match, --only-index, --only-last.`, EXIT_CODE.USAGE);
-    }
-    const kind = kinds[0];
-    if (tests.length === 0) {
-        throw new PmCliError(`--${kind} matched no linked tests because this item has none. Add one first with --add, --command, or --add-json.`, EXIT_CODE.USAGE);
-    }
-    if (kind === "match") {
-        // kind is "match" only when selector.match is defined (see activeSelectorKinds).
-        const needle = selector.match.trim().toLowerCase();
-        if (needle.length === 0) {
-            throw new PmCliError("--match requires a non-empty substring to match against linked-test command/path values", EXIT_CODE.USAGE);
-        }
-        const selectedIndexes = [];
-        const selected = [];
-        for (let index = 0; index < tests.length; index += 1) {
-            if (entryMatchesSubstring(tests[index], needle)) {
-                selected.push(tests[index]);
-                selectedIndexes.push(index + 1);
-            }
-        }
-        if (selected.length === 0) {
-            throw new PmCliError(`--match "${selector.match}" matched none of the ${tests.length} linked test(s). Available entries: ${describeLinkedTestEntries(tests)}`, EXIT_CODE.USAGE);
-        }
-        return {
-            selector: "match",
-            requested: selector.match,
-            selected,
-            selected_indexes: selectedIndexes,
-            selected_count: selected.length,
-            skipped_count: tests.length - selected.length,
-        };
-    }
-    if (kind === "only-index") {
-        const index = parseOnlyIndexValue(selector.onlyIndex);
-        if (index > tests.length) {
-            throw new PmCliError(`--only-index ${index} is out of range: this item has ${tests.length} linked test(s). Available entries: ${describeLinkedTestEntries(tests)}`, EXIT_CODE.USAGE);
-        }
-        return {
-            selector: "only-index",
-            requested: String(index),
-            selected: [tests[index - 1]],
-            selected_indexes: [index],
-            selected_count: 1,
-            skipped_count: tests.length - 1,
-        };
-    }
-    return {
-        selector: "only-last",
-        requested: "last",
-        selected: [tests[tests.length - 1]],
-        selected_indexes: [tests.length],
-        selected_count: 1,
-        skipped_count: tests.length - 1,
-    };
-}
+!(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]="328c7577-364c-5869-aa92-199e56d2f6a7")}catch(e2){}})();import{EXIT_CODE}from"../shared/constants.js";import{PmCliError}from"../shared/errors.js";const MAX_SELECTOR_ENTRY_LABEL_LENGTH=100;function parseOnlyIndexValue(raw,optionName="--only-index"){const value=typeof raw==="number"?raw:Number(String(raw).trim());if(!Number.isInteger(value)||value<1){throw new PmCliError(`${optionName} requires a 1-based integer index into the linked-test list (got "${raw}"). Use pm test <id> --list to inspect positions.`,EXIT_CODE.USAGE)}return value}function summarizeSelectorEntry(entry){const label=entry.command??entry.path??"<no command>";const normalized=label.replaceAll(/\s+/g," ").trim()||"<no command>";if(normalized.length<=MAX_SELECTOR_ENTRY_LABEL_LENGTH){return normalized}return`${normalized.slice(0,MAX_SELECTOR_ENTRY_LABEL_LENGTH-3)}...`}function describeLinkedTestEntries(tests){return tests.map((entry,index)=>`${index+1}. ${summarizeSelectorEntry(entry)}`).join("; ")}function activeSelectorKinds(selector){const kinds=[];if(selector.match!==void 0){kinds.push("match")}if(selector.onlyIndex!==void 0){kinds.push("only-index")}if(selector.onlyLast===true){kinds.push("only-last")}return kinds}function entryMatchesSubstring(entry,needle){const command=entry.command?.toLowerCase()??"";const entryPath=entry.path?.toLowerCase()??"";return command.includes(needle)||entryPath.includes(needle)}function resolveLinkedTestRunSelection(tests,selector){const kinds=activeSelectorKinds(selector);if(kinds.length===0){return{selector:null,requested:null,selected:tests,selected_indexes:tests.map((_,index)=>index+1),selected_count:tests.length,skipped_count:0}}if(kinds.length>1){throw new PmCliError(`Combine at most one linked-test selector per run: ${kinds.map(kind2=>`--${kind2}`).join(" and ")} were provided. Pick one of --match, --only-index, --only-last.`,EXIT_CODE.USAGE)}const kind=kinds[0];if(tests.length===0){throw new PmCliError(`--${kind} matched no linked tests because this item has none. Add one first with --add, --command, or --add-json.`,EXIT_CODE.USAGE)}if(kind==="match"){const needle=selector.match.trim().toLowerCase();if(needle.length===0){throw new PmCliError("--match requires a non-empty substring to match against linked-test command/path values",EXIT_CODE.USAGE)}const selectedIndexes=[];const selected=[];for(let index=0;index<tests.length;index+=1){if(entryMatchesSubstring(tests[index],needle)){selected.push(tests[index]);selectedIndexes.push(index+1)}}if(selected.length===0){throw new PmCliError(`--match "${selector.match}" matched none of the ${tests.length} linked test(s). Available entries: ${describeLinkedTestEntries(tests)}`,EXIT_CODE.USAGE)}return{selector:"match",requested:selector.match,selected,selected_indexes:selectedIndexes,selected_count:selected.length,skipped_count:tests.length-selected.length}}if(kind==="only-index"){const index=parseOnlyIndexValue(selector.onlyIndex);if(index>tests.length){throw new PmCliError(`--only-index ${index} is out of range: this item has ${tests.length} linked test(s). Available entries: ${describeLinkedTestEntries(tests)}`,EXIT_CODE.USAGE)}return{selector:"only-index",requested:String(index),selected:[tests[index-1]],selected_indexes:[index],selected_count:1,skipped_count:tests.length-1}}return{selector:"only-last",requested:"last",selected:[tests[tests.length-1]],selected_indexes:[tests.length],selected_count:1,skipped_count:tests.length-1}}export{describeLinkedTestEntries,parseOnlyIndexValue,resolveLinkedTestRunSelection};
 //# sourceMappingURL=run-selectors.js.map
-//# debugId=8a6a3402-dae3-56f8-b9ba-a4f6f8a47cda

package/dist/core/validate/estimate-defaults.js

@@ -1,90 +1,2 @@
-/**
- * Per-type default estimate resolution for `pm validate --auto-fix` (GH-212).
- *
- * When an item is missing `estimated_minutes`, the auto-fix path backfills a
- * config-driven default based on the item's type. This module is the pure
- * resolution layer: given an item type and an optional settings-derived override
- * map, it returns the default estimate in minutes. The planning + apply path is
- * wired separately by the validate command.
- *
- * Pure module: no filesystem access, no heavy imports. Bad input is never
- * thrown on — invalid override entries are dropped, not errored (mirrors the
- * deterministic, non-throwing style of stale-file-classification.ts).
- */
-/** Built-in per-type default estimates in MINUTES used by `pm validate --auto-fix` (GH-212) to backfill missing `estimated_minutes`. Keys are canonical built-in type names. Lookups are case-insensitive (see resolveEstimateDefaultMinutes). */
-
-!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]="2d377bc4-c624-561c-9856-405c82099070")}catch(e){}}();
-export const DEFAULT_ESTIMATE_MINUTES_BY_TYPE = {
-    Epic: 2880,
-    Feature: 480,
-    Story: 480,
-    Milestone: 2880,
-    Task: 120,
-    Issue: 60,
-    Bug: 60,
-    Chore: 30,
-    Decision: 15,
-    Plan: 120,
-};
-/** Fallback when neither overrides nor the built-in map have the type. */
-export const FALLBACK_ESTIMATE_MINUTES = 120;
-/** A value is honored only when it is a finite number strictly greater than zero. */
-function isHonoredMinutes(value) {
-    return typeof value === "number" && Number.isFinite(value) && value > 0;
-}
-/** Build a case-insensitive lookup keyed by lowercased type name. When two source keys collide case-insensitively, last-wins (later entries overwrite earlier ones); callers normalize overrides up front so collisions are rare. */
-function toLowercasedLookup(source) {
-    const lookup = new Map();
-    for (const [key, value] of Object.entries(source)) {
-        lookup.set(key.toLowerCase(), value);
-    }
-    return lookup;
-}
-/** Built-in lookup is type-static, so build the lowercased index once. */
-const BUILTIN_LOWERCASED_LOOKUP = toLowercasedLookup(DEFAULT_ESTIMATE_MINUTES_BY_TYPE);
-/** Cache lowercased override lookups keyed on the override object reference so a backfill that resolves once per item does not rebuild the same Map each call. A WeakMap keeps this allocation-free for callers that reuse one normalized settings map across the whole run. */
-const OVERRIDE_LOOKUP_CACHE = new WeakMap();
-function lowercasedOverrideLookup(overrides) {
-    const cached = OVERRIDE_LOOKUP_CACHE.get(overrides);
-    if (cached) {
-        return cached;
-    }
-    const lookup = toLowercasedLookup(overrides);
-    OVERRIDE_LOOKUP_CACHE.set(overrides, lookup);
-    return lookup;
-}
-/** Resolve the default estimated-minutes for an item type. Precedence: overrides (case-insensitive key match) > DEFAULT_ESTIMATE_MINUTES_BY_TYPE (case-insensitive) > FALLBACK_ESTIMATE_MINUTES. - `type` undefined/empty -> FALLBACK. - Only finite values > 0 are honored from overrides/defaults; a non-positive or non-finite override value is ignored and resolution continues to the next tier. - Returned value is a positive integer (floor of the resolved value). */
-export function resolveEstimateDefaultMinutes(type, overrides) {
-    const key = (type ?? "").trim().toLowerCase();
-    if (key.length === 0) {
-        return FALLBACK_ESTIMATE_MINUTES;
-    }
-    if (overrides) {
-        const overrideValue = lowercasedOverrideLookup(overrides).get(key);
-        if (isHonoredMinutes(overrideValue)) {
-            return Math.floor(overrideValue);
-        }
-    }
-    const builtinValue = BUILTIN_LOWERCASED_LOOKUP.get(key);
-    if (isHonoredMinutes(builtinValue)) {
-        return Math.floor(builtinValue);
-    }
-    return FALLBACK_ESTIMATE_MINUTES;
-}
-/** Validate + normalize a raw `validation.estimate_defaults_by_type` settings object into a clean Record<string, number> of positive integers, dropping invalid entries. Used so the pure resolver always receives a sane override map. Returns {} for undefined/null/non-object input. Trims keys; ignores empty keys and non-positive / non-finite / non-number values. Floors values to integers. */
-export function normalizeEstimateDefaultOverrides(raw) {
-    const normalized = {};
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-        return normalized;
-    }
-    for (const [rawKey, rawValue] of Object.entries(raw)) {
-        const key = rawKey.trim();
-        if (key.length === 0 || !isHonoredMinutes(rawValue)) {
-            continue;
-        }
-        normalized[key] = Math.floor(rawValue);
-    }
-    return normalized;
-}
+!(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]="833a4f8a-7e5d-5480-a526-4e1ebaadd0a8")}catch(e2){}})();const DEFAULT_ESTIMATE_MINUTES_BY_TYPE={Epic:2880,Feature:480,Story:480,Milestone:2880,Task:120,Issue:60,Bug:60,Chore:30,Decision:15,Plan:120};const FALLBACK_ESTIMATE_MINUTES=120;function isHonoredMinutes(value){return typeof value==="number"&&Number.isFinite(value)&&value>0}function toLowercasedLookup(source){const lookup=new Map;for(const[key,value]of Object.entries(source)){lookup.set(key.toLowerCase(),value)}return lookup}const BUILTIN_LOWERCASED_LOOKUP=toLowercasedLookup(DEFAULT_ESTIMATE_MINUTES_BY_TYPE);const OVERRIDE_LOOKUP_CACHE=new WeakMap;function lowercasedOverrideLookup(overrides){const cached=OVERRIDE_LOOKUP_CACHE.get(overrides);if(cached){return cached}const lookup=toLowercasedLookup(overrides);OVERRIDE_LOOKUP_CACHE.set(overrides,lookup);return lookup}function resolveEstimateDefaultMinutes(type,overrides){const key=(type??"").trim().toLowerCase();if(key.length===0){return FALLBACK_ESTIMATE_MINUTES}if(overrides){const overrideValue=lowercasedOverrideLookup(overrides).get(key);if(isHonoredMinutes(overrideValue)){return Math.floor(overrideValue)}}const builtinValue=BUILTIN_LOWERCASED_LOOKUP.get(key);if(isHonoredMinutes(builtinValue)){return Math.floor(builtinValue)}return FALLBACK_ESTIMATE_MINUTES}function normalizeEstimateDefaultOverrides(raw){const normalized={};if(raw===null||typeof raw!=="object"||Array.isArray(raw)){return normalized}for(const[rawKey,rawValue]of Object.entries(raw)){const key=rawKey.trim();if(key.length===0||!isHonoredMinutes(rawValue)){continue}normalized[key]=Math.floor(rawValue)}return normalized}export{DEFAULT_ESTIMATE_MINUTES_BY_TYPE,FALLBACK_ESTIMATE_MINUTES,normalizeEstimateDefaultOverrides,resolveEstimateDefaultMinutes};
 //# sourceMappingURL=estimate-defaults.js.map
-//# debugId=2d377bc4-c624-561c-9856-405c82099070

package/dist/core/validate/fix-planning.js

@@ -1,190 +1,2 @@
-/**
- * Fix planning for `pm validate --auto-fix` / `--prune-missing` (pm-c3sz,
- * pm-8jss, pm-0v2m).
- *
- * Pure module: planners turn check findings into declarative
- * {@link ValidateFixRecord}s; the validate command decides whether to apply
- * them (apply mode), preview them (`--dry-run`), or withhold gated fixes
- * (lifecycle structural changes require an explicit `--fix-scope lifecycle`).
- *
- * Safety invariants:
- * - Every planned fix is deterministic and non-destructive: it only sets a
- *   derivable field value or removes a stale LINK (never a real file).
- * - No fix ever closes, deletes, or cancels an item.
- * - Lifecycle fixes (reparent / unset parent) are structural, so they are
- *   planned with `gate: "lifecycle"` and only applied when that scope was
- *   explicitly granted.
- */
-
-!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]="98a73818-c4ef-5bce-8b23-6c40f7312cc3")}catch(e){}}();
-import { EXIT_CODE } from "../shared/constants.js";
-import { PmCliError } from "../shared/errors.js";
-import { resolveEstimateDefaultMinutes } from "./estimate-defaults.js";
-/** Scopes auto-applied without an explicit `--fix-scope` (safe field backfills). */
-export const DEFAULT_GRANTED_FIX_SCOPES = [
-    "metadata",
-    "resolution",
-];
-/** Scopes accepted by `--fix-scope`. `estimates` and `lifecycle` are opt-in: estimate backfills are heuristic per-type guesses (not derived facts) and lifecycle changes are structural, so neither is granted by default. */
-export const SUPPORTED_FIX_SCOPES = [
-    "metadata",
-    "resolution",
-    "estimates",
-    "lifecycle",
-];
-/** Default resolution backfilled onto closed items with no derivable source text. */
-const DEFAULT_RESOLUTION_BACKFILL_VALUE = "completed";
-function quoteForCommand(value) {
-    return `"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
-}
-function toMeaningfulValue(value) {
-    const trimmed = value?.trim();
-    return trimmed !== undefined && trimmed.length > 0 ? trimmed : undefined;
-}
-/** Plan resolution backfills for closed items flagged by the resolution check. Only the `resolution` field is mechanical enough to auto-fix: it derives from the item's own `close_reason` when present and falls back to the `"completed"` default. `expected_result` / `actual_result` stay hint-only — no deterministic source text exists for them. */
-export function planResolutionBackfillFixes(rows) {
-    const fixes = [];
-    for (const row of rows) {
-        if (!row.missing_fields.includes("resolution")) {
-            continue;
-        }
-        const value = toMeaningfulValue(row.close_reason) ?? DEFAULT_RESOLUTION_BACKFILL_VALUE;
-        fixes.push({
-            item_id: row.id,
-            check: "resolution",
-            field: "resolution",
-            kind: "set_resolution",
-            value,
-            command: `pm update ${row.id} --resolution ${quoteForCommand(value)}`,
-            gate: "resolution",
-        });
-    }
-    return fixes;
-}
-/** Plan close_reason backfills for closed items flagged by the metadata check. Only derivable when the item already carries a resolution; items missing both stay hint-only (any synthesized reason would be fabricated, not derived). */
-export function planCloseReasonBackfillFixes(rows) {
-    const fixes = [];
-    for (const row of rows) {
-        const value = toMeaningfulValue(row.resolution);
-        if (value === undefined) {
-            continue;
-        }
-        fixes.push({
-            item_id: row.id,
-            check: "metadata",
-            field: "close_reason",
-            kind: "set_close_reason",
-            value,
-            command: `pm update ${row.id} --close-reason ${quoteForCommand(value)}`,
-            gate: "metadata",
-        });
-    }
-    return fixes;
-}
-/** Plan estimate backfills for items flagged by the metadata check as missing `estimated_minutes` (GH-212). The value is a config-driven per-type default (overrides > built-in map > fallback), never a derived fact — so these fixes carry `gate: "estimates"`, an opt-in scope that is NOT granted by default. `overrides` is the already-normalized `validation.estimate_defaults_by_type` map; pass `undefined`/`{}` to use the built-in defaults. */
-export function planEstimateBackfillFixes(rows, overrides) {
-    return rows.map((row) => {
-        const minutes = resolveEstimateDefaultMinutes(row.type, overrides);
-        return {
-            item_id: row.id,
-            check: "metadata",
-            field: "estimated_minutes",
-            kind: "set_estimate",
-            value: String(minutes),
-            command: `pm update ${row.id} --estimate ${minutes}`,
-            gate: "estimates",
-        };
-    });
-}
-/** Plan lifecycle fixes for active items whose parent is terminal (pm-8jss / GH-168). When the terminal parent has an active grandparent, the child is reparented one level up (it stays inside the same hierarchy); otherwise the parent link is cleared so the item surfaces as unparented active work. Either way the item itself is never closed or mutated beyond `parent` — and every fix carries `gate: "lifecycle"` so it is only applied under an explicit `--fix-scope lifecycle`. */
-export function planTerminalParentFixes(rows) {
-    return rows.map((row) => {
-        if (row.grandparent_id !== undefined && row.grandparent_active === true) {
-            return {
-                item_id: row.id,
-                check: "lifecycle",
-                field: "parent",
-                kind: "reparent",
-                parent_id: row.grandparent_id,
-                command: `pm update ${row.id} --parent ${row.grandparent_id}`,
-                gate: "lifecycle",
-            };
-        }
-        return {
-            item_id: row.id,
-            check: "lifecycle",
-            field: "parent",
-            kind: "unset_parent",
-            command: `pm update ${row.id} --unset parent`,
-            gate: "lifecycle",
-        };
-    });
-}
-/** Plan link prunes for `--prune-missing` (pm-0v2m / GH-184). Only links whose stale path classified as `deleted` are pruned; `moved` links keep their relink candidates in the files-check details instead of being dropped, so recoverable link information is never destroyed. Link removal only — real files are never touched. */
-export function planStaleLinkPruneFixes(rows) {
-    const fixes = [];
-    for (const row of rows) {
-        if (row.classification !== "deleted") {
-            continue;
-        }
-        const noun = row.link_kind === "files" ? "files" : "docs";
-        fixes.push({
-            item_id: row.item_id,
-            check: "files",
-            field: row.link_kind,
-            kind: row.link_kind === "files" ? "prune_file_link" : "prune_doc_link",
-            path: row.path,
-            command: `pm ${noun} ${row.item_id} --remove ${quoteForCommand(row.path)}`,
-        });
-    }
-    return fixes;
-}
-/** Resolve the granted `--fix-scope` set (repeatable and/or comma-separated). With no explicit scopes the safe field-backfill scopes (metadata, resolution) are granted; lifecycle must always be named explicitly. Unknown values fail fast with the supported list. */
-export function resolveGrantedFixScopes(rawScopes) {
-    const tokens = (rawScopes ?? [])
-        .flatMap((raw) => raw.split(","))
-        .map((raw) => raw.trim())
-        .filter((raw) => raw.length > 0);
-    if (tokens.length === 0) {
-        if (rawScopes !== undefined && rawScopes.length > 0) {
-            throw new PmCliError(`--fix-scope values must not be empty. Supported values: ${SUPPORTED_FIX_SCOPES.join(", ")}.`, EXIT_CODE.USAGE);
-        }
-        return new Set(DEFAULT_GRANTED_FIX_SCOPES);
-    }
-    const granted = new Set();
-    for (const raw of tokens) {
-        const normalized = raw.toLowerCase().replaceAll("-", "_");
-        if (SUPPORTED_FIX_SCOPES.includes(normalized)) {
-            granted.add(normalized);
-            continue;
-        }
-        throw new PmCliError(`Unknown --fix-scope value "${raw}". Supported values: ${SUPPORTED_FIX_SCOPES.join(", ")}.`, EXIT_CODE.USAGE);
-    }
-    return granted;
-}
-/** Split a fix plan into the records that may be applied under the granted scopes and the gated records that were withheld. `--fix-scope` is an exact allowlist: every `--auto-fix` record requires its gate scope in `granted`. Ungated records (`--prune-missing` link prunes, governed by their own flag) are always applicable. */
-export function partitionFixesByGrant(fixes, granted) {
-    const applicable = [];
-    const gated = [];
-    for (const fix of fixes) {
-        if (fix.gate !== undefined && !granted.has(fix.gate)) {
-            gated.push(fix);
-        }
-        else {
-            applicable.push(fix);
-        }
-    }
-    return { applicable, gated };
-}
-/** Compact serialization of a fix for planned/applied output rows. */
-export function toFixOutputRow(fix) {
-    return {
-        item_id: fix.item_id,
-        check: fix.check,
-        field: fix.field,
-        command: fix.command,
-        ...(fix.gate !== undefined ? { gate: fix.gate } : {}),
-    };
-}
+!(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]="55d5ac7a-9aa4-569e-9bb6-f504a0ac7421")}catch(e2){}})();import{EXIT_CODE}from"../shared/constants.js";import{PmCliError}from"../shared/errors.js";import{resolveEstimateDefaultMinutes}from"./estimate-defaults.js";const DEFAULT_GRANTED_FIX_SCOPES=["metadata","resolution"];const SUPPORTED_FIX_SCOPES=["metadata","resolution","estimates","lifecycle"];const DEFAULT_RESOLUTION_BACKFILL_VALUE="completed";function quoteForCommand(value){return`"${value.replaceAll("\\","\\\\").replaceAll('"','\\"')}"`}function toMeaningfulValue(value){const trimmed=value?.trim();return trimmed!==void 0&&trimmed.length>0?trimmed:void 0}function planResolutionBackfillFixes(rows){const fixes=[];for(const row of rows){if(!row.missing_fields.includes("resolution")){continue}const value=toMeaningfulValue(row.close_reason)??DEFAULT_RESOLUTION_BACKFILL_VALUE;fixes.push({item_id:row.id,check:"resolution",field:"resolution",kind:"set_resolution",value,command:`pm update ${row.id} --resolution ${quoteForCommand(value)}`,gate:"resolution"})}return fixes}function planCloseReasonBackfillFixes(rows){const fixes=[];for(const row of rows){const value=toMeaningfulValue(row.resolution);if(value===void 0){continue}fixes.push({item_id:row.id,check:"metadata",field:"close_reason",kind:"set_close_reason",value,command:`pm update ${row.id} --close-reason ${quoteForCommand(value)}`,gate:"metadata"})}return fixes}function planEstimateBackfillFixes(rows,overrides){return rows.map(row=>{const minutes=resolveEstimateDefaultMinutes(row.type,overrides);return{item_id:row.id,check:"metadata",field:"estimated_minutes",kind:"set_estimate",value:String(minutes),command:`pm update ${row.id} --estimate ${minutes}`,gate:"estimates"}})}function planTerminalParentFixes(rows){return rows.map(row=>{if(row.grandparent_id!==void 0&&row.grandparent_active===true){return{item_id:row.id,check:"lifecycle",field:"parent",kind:"reparent",parent_id:row.grandparent_id,command:`pm update ${row.id} --parent ${row.grandparent_id}`,gate:"lifecycle"}}return{item_id:row.id,check:"lifecycle",field:"parent",kind:"unset_parent",command:`pm update ${row.id} --unset parent`,gate:"lifecycle"}})}function planStaleLinkPruneFixes(rows){const fixes=[];for(const row of rows){if(row.classification!=="deleted"){continue}const noun=row.link_kind==="files"?"files":"docs";fixes.push({item_id:row.item_id,check:"files",field:row.link_kind,kind:row.link_kind==="files"?"prune_file_link":"prune_doc_link",path:row.path,command:`pm ${noun} ${row.item_id} --remove ${quoteForCommand(row.path)}`})}return fixes}function resolveGrantedFixScopes(rawScopes){const tokens=(rawScopes??[]).flatMap(raw=>raw.split(",")).map(raw=>raw.trim()).filter(raw=>raw.length>0);if(tokens.length===0){if(rawScopes!==void 0&&rawScopes.length>0){throw new PmCliError(`--fix-scope values must not be empty. Supported values: ${SUPPORTED_FIX_SCOPES.join(", ")}.`,EXIT_CODE.USAGE)}return new Set(DEFAULT_GRANTED_FIX_SCOPES)}const granted=new Set;for(const raw of tokens){const normalized=raw.toLowerCase().replaceAll("-","_");if(SUPPORTED_FIX_SCOPES.includes(normalized)){granted.add(normalized);continue}throw new PmCliError(`Unknown --fix-scope value "${raw}". Supported values: ${SUPPORTED_FIX_SCOPES.join(", ")}.`,EXIT_CODE.USAGE)}return granted}function partitionFixesByGrant(fixes,granted){const applicable=[];const gated=[];for(const fix of fixes){if(fix.gate!==void 0&&!granted.has(fix.gate)){gated.push(fix)}else{applicable.push(fix)}}return{applicable,gated}}function toFixOutputRow(fix){return{item_id:fix.item_id,check:fix.check,field:fix.field,command:fix.command,...fix.gate!==void 0?{gate:fix.gate}:{}}}export{DEFAULT_GRANTED_FIX_SCOPES,SUPPORTED_FIX_SCOPES,partitionFixesByGrant,planCloseReasonBackfillFixes,planEstimateBackfillFixes,planResolutionBackfillFixes,planStaleLinkPruneFixes,planTerminalParentFixes,resolveGrantedFixScopes,toFixOutputRow};
 //# sourceMappingURL=fix-planning.js.map
-//# debugId=98a73818-c4ef-5bce-8b23-6c40f7312cc3

package/dist/core/validate/linked-artifact-reference.js

@@ -1,37 +1,2 @@
-/**
- * Remote-reference detection for linked artifacts (`pm files` / `pm docs`
- * `path` values).
- *
- * A linked artifact path is normally a workspace-relative or absolute local
- * filesystem path, but `pm docs --add` legitimately records *remote*
- * references too — most commonly an `https://` URL to a pull request, issue, or
- * external design doc. Such references are not local files, so they must never
- * be:
- * - probed with `fs.stat` for existence (the resolved path is meaningless),
- * - classified as `moved`/`deleted` by the stale-path classifier,
- * - counted among `missing_linked_paths` in `pm validate --check-files`, or
- * - pruned by `pm validate --prune-missing` — which would silently destroy an
- *   intentionally-recorded reference (project management = context management).
- *
- * Pure module: no filesystem or network access — callers pass the stored path
- * string and branch on the boolean result.
- */
-/**
- * Matches an RFC 3986 URI that carries an authority component
- * (`scheme://…`) — e.g. `https://`, `http://`, `ftp://`, `ssh://`, `file://`.
- *
- * The scheme is required to be at least two characters so a Windows drive
- * prefix (`C:/…`, which is a single letter followed by a single slash and never
- * `://`) can never be mistaken for a remote reference. A relative or absolute
- * POSIX path (`src/api.ts`, `/dev/null`) and a UNC path (`//server/share`) all
- * lack the `scheme://` shape and are correctly treated as local.
- */
-
-!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]="2b9ba0a4-396f-5870-bc89-e7fc789bb49d")}catch(e){}}();
-const REMOTE_ARTIFACT_REFERENCE_PATTERN = /^[a-z][a-z0-9+.-]+:\/\//i;
-/** Return `true` when a linked-artifact path is a remote reference (a URL with a `scheme://` authority) rather than a local filesystem path. Whitespace is trimmed before matching so a stored `" https://…"` is still recognized. */
-export function isRemoteLinkedArtifactReference(path) {
-    return REMOTE_ARTIFACT_REFERENCE_PATTERN.test(path.trim());
-}
+!(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]="6f94fb3c-3d6c-5543-a2f0-e12680459e71")}catch(e2){}})();const REMOTE_ARTIFACT_REFERENCE_PATTERN=/^[a-z][a-z0-9+.-]+:\/\//i;function isRemoteLinkedArtifactReference(path){return REMOTE_ARTIFACT_REFERENCE_PATTERN.test(path.trim())}export{isRemoteLinkedArtifactReference};
 //# sourceMappingURL=linked-artifact-reference.js.map
-//# debugId=2b9ba0a4-396f-5870-bc89-e7fc789bb49d

package/dist/core/validate/missing-by-type.js

@@ -1,35 +1,2 @@
-/**
- * Per-item-type grouping of missing-required-field counts for
- * `pm validate --check-metadata` (pm-pmyq / GH-172).
- *
- * Pure module: callers stream `(item_type, field)` pairs — one per missing
- * required field occurrence — and receive a compact, deterministically sorted
- * `missing_by_type` map of counts (never row dumps), e.g.
- * `{ Task: { close_reason: 3, reviewer: 1 } }`.
- */
-/** Aggregate missing-field occurrences into `{ type: { field: count } }` with both levels sorted lexicographically for stable, diff-friendly output. Zero counts never appear (only observed occurrences are aggregated). */
-
-!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]="1951b0f1-11fa-5728-b516-7458a55b1e29")}catch(e){}}();
-export function buildMissingByTypeCounts(occurrences) {
-    const countsByType = new Map();
-    for (const occurrence of occurrences) {
-        let fieldCounts = countsByType.get(occurrence.item_type);
-        if (!fieldCounts) {
-            fieldCounts = new Map();
-            countsByType.set(occurrence.item_type, fieldCounts);
-        }
-        fieldCounts.set(occurrence.field, (fieldCounts.get(occurrence.field) ?? 0) + 1);
-    }
-    const result = {};
-    for (const type of [...countsByType.keys()].sort((left, right) => left.localeCompare(right))) {
-        const fieldCounts = countsByType.get(type);
-        const fields = {};
-        for (const field of [...fieldCounts.keys()].sort((left, right) => left.localeCompare(right))) {
-            fields[field] = fieldCounts.get(field);
-        }
-        result[type] = fields;
-    }
-    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]="b51a9fba-7bbe-573b-a708-5ffea6fa040f")}catch(e2){}})();function buildMissingByTypeCounts(occurrences){const countsByType=new Map;for(const occurrence of occurrences){let fieldCounts=countsByType.get(occurrence.item_type);if(!fieldCounts){fieldCounts=new Map;countsByType.set(occurrence.item_type,fieldCounts)}fieldCounts.set(occurrence.field,(fieldCounts.get(occurrence.field)??0)+1)}const result={};for(const type of[...countsByType.keys()].sort((left,right)=>left.localeCompare(right))){const fieldCounts=countsByType.get(type);const fields={};for(const field of[...fieldCounts.keys()].sort((left,right)=>left.localeCompare(right))){fields[field]=fieldCounts.get(field)}result[type]=fields}return result}export{buildMissingByTypeCounts};
 //# sourceMappingURL=missing-by-type.js.map
-//# debugId=1951b0f1-11fa-5728-b516-7458a55b1e29