@unbrained/pm-cli 2026.7.5 → 2026.7.7

package/dist/cli-bundle/chunks/chunk-QZ342C63.js

@@ -1,220 +0,0 @@
-// dist/core/lock/lock-gc.js
-import fs from "node:fs/promises";
-import path from "node:path";
-!(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] = "e9910e08-e968-52b7-b6cb-01167fa89d4c");
-  } catch (e2) {
-  }
-})();
-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 isErrno(error, code) {
-  return typeof error === "object" && error !== null && "code" in error && error.code === code;
-}
-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 (isErrno(error, "ENOENT")) {
-      return scan;
-    }
-    throw error;
-  }
-  for (const file of dirEntries) {
-    let raw;
-    try {
-      raw = await fs.readFile(path.join(locksDir, file), "utf8");
-    } catch (readError) {
-      if (isErrno(readError, "ENOENT")) {
-        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 (isErrno(error, "ENOENT")) {
-      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 (isErrno(readError, "ENOENT")) {
-        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 (!isErrno(unlinkError, "ENOENT")) {
-          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 {
-  scanLockHealth,
-  runLockGc
-};
-//# sourceMappingURL=chunk-QZ342C63.js.map

package/dist/cli-bundle/chunks/chunk-QZ342C63.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../../../../core/lock/lock-gc.ts"],
-  "sourcesContent": ["/**\n * lock-gc.ts — Stale lock file garbage collector.\n *\n * Safety-first policy: if a lock file cannot be read or parsed, it is RETAINED\n * rather than deleted. We only remove locks whose staleness can be conclusively\n * determined from the lock's own embedded `ttl_seconds` field.\n *\n * Staleness formula: (now_ms - Date.parse(created_at)) > ttl_seconds * 1000\n * Zero ttl means any lock older than 0 ms is stale. Negative ttl means always stale.\n */\n\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/**\n * Documents the stale lock scan entry payload exchanged by command, SDK, and package integrations.\n */\nexport interface StaleLockScanEntry {\n  /** e.g. \"pm-abc1.lock\" */\n  file: string;\n  /** parsed id, or null if unparseable */\n  id: string | null;\n  owner: string | null;\n  created_at: string | null;\n  ttl_seconds: number | null;\n  /** floor((now - created_at)/1000), null if unparseable */\n  age_seconds: number | null;\n  /** true only when classified expired */\n  stale: boolean;\n  reason: \"expired\" | \"active\" | \"unparseable\";\n}\n\n/**\n * Documents the lock gc hooks payload exchanged by command, SDK, and package integrations.\n */\nexport interface LockGcHooks {\n  onRead?: (lockPath: string) => Promise<string[]> | string[];\n  onWrite?: (lockPath: string) => Promise<string[]> | string[];\n}\n\n/**\n * Documents the lock gc options payload exchanged by command, SDK, and package integrations.\n */\nexport interface LockGcOptions {\n  dryRun: boolean;\n  /** epoch ms; defaults to Date.now() — injectable for deterministic tests */\n  now?: number;\n  hooks?: LockGcHooks;\n}\n\n/**\n * Documents the lock gc result payload exchanged by command, SDK, and package integrations.\n */\nexport interface LockGcResult {\n  /** number of *.lock files examined */\n  scanned: number;\n  /** relative paths like \"locks/pm-abc1.lock\" (removed, or would-remove under dryRun) */\n  removed: string[];\n  /** relative paths retained (active OR unparseable — never delete what we can't reason about) */\n  retained: string[];\n  warnings: string[];\n  /** one per scanned *.lock file, sorted by file name asc */\n  entries: StaleLockScanEntry[];\n}\n\ninterface ParsedLock {\n  id: string;\n  owner: string;\n  created_at: string;\n  ttl_seconds: number;\n}\n\nfunction parseLock(raw: string): ParsedLock | null {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    return null;\n  }\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    return null;\n  }\n  const candidate = parsed as Record<string, unknown>;\n  const { id, owner, created_at, ttl_seconds } = candidate;\n  if (\n    typeof id !== \"string\" ||\n    typeof owner !== \"string\" ||\n    typeof created_at !== \"string\" ||\n    typeof ttl_seconds !== \"number\" ||\n    !Number.isFinite(ttl_seconds)\n  ) {\n    return null;\n  }\n  return { id, owner, created_at, ttl_seconds };\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    (error as { code?: string }).code === code\n  );\n}\n\n/**\n * Fine-grained classification outcome for one readable lock file's content.\n * `unparseable_json` and `invalid_timestamp` both surface as the coarse\n * `reason: \"unparseable\"` on the scan entry (gc retains both), but stay\n * distinct here so callers can emit precise warnings.\n */\nexport type LockClassificationDetail = \"active\" | \"expired\" | \"unparseable_json\" | \"invalid_timestamp\";\n\n/**\n * Documents the lock content classification payload exchanged by command, SDK, and package integrations.\n */\nexport interface LockContentClassification {\n  detail: LockClassificationDetail;\n  entry: StaleLockScanEntry;\n}\n\n/**\n * Pure classification of one lock file's raw content against `nowMs`. This is\n * the single staleness/parse policy shared by `pm gc --scope locks` (which acts\n * on it) and the `pm health` locks check (which only reports it).\n */\nexport function classifyLockContent(file: string, raw: string, nowMs: number): LockContentClassification {\n  const lock = parseLock(raw);\n  if (lock === null) {\n    return {\n      detail: \"unparseable_json\",\n      entry: {\n        file,\n        id: null,\n        owner: null,\n        created_at: null,\n        ttl_seconds: null,\n        age_seconds: null,\n        stale: false,\n        reason: \"unparseable\",\n      },\n    };\n  }\n  const createdAtMs = Date.parse(lock.created_at);\n  if (!Number.isFinite(createdAtMs)) {\n    return {\n      detail: \"invalid_timestamp\",\n      entry: {\n        file,\n        id: lock.id,\n        owner: lock.owner,\n        created_at: lock.created_at,\n        ttl_seconds: lock.ttl_seconds,\n        age_seconds: null,\n        stale: false,\n        reason: \"unparseable\",\n      },\n    };\n  }\n  const ageMs = nowMs - createdAtMs;\n  const age_seconds = Math.floor(ageMs / 1000);\n  const stale = ageMs > lock.ttl_seconds * 1000;\n  return {\n    detail: stale ? \"expired\" : \"active\",\n    entry: {\n      file,\n      id: lock.id,\n      owner: lock.owner,\n      created_at: lock.created_at,\n      ttl_seconds: lock.ttl_seconds,\n      age_seconds,\n      stale,\n      reason: stale ? \"expired\" : \"active\",\n    },\n  };\n}\n\n/**\n * Documents the lock health scan payload exchanged by command, SDK, and package integrations.\n */\nexport interface LockHealthScan {\n  /** number of *.lock files examined (ghost files that vanish mid-scan are skipped) */\n  scanned: number;\n  active_lock_count: number;\n  stale_lock_count: number;\n  unreadable_lock_count: number;\n  /** invalid JSON, wrong shape, or an unparseable created_at timestamp */\n  unparseable_lock_count: number;\n}\n\n/**\n * Read-only locks scan for `pm health`: classifies every lock file with the\n * same policy `pm gc --scope locks` uses but never removes anything.\n */\nexport async function scanLockHealth(pmRoot: string, now?: number): Promise<LockHealthScan> {\n  const nowMs = now ?? Date.now();\n  const locksDir = path.join(pmRoot, \"locks\");\n  const scan: LockHealthScan = {\n    scanned: 0,\n    active_lock_count: 0,\n    stale_lock_count: 0,\n    unreadable_lock_count: 0,\n    unparseable_lock_count: 0,\n  };\n\n  let dirEntries: string[];\n  try {\n    const rawDir = await fs.readdir(locksDir);\n    dirEntries = rawDir.filter((f) => f.endsWith(\".lock\")).sort();\n  } catch (error: unknown) {\n    if (isErrno(error, \"ENOENT\")) {\n      return scan;\n    }\n    throw error;\n  }\n\n  for (const file of dirEntries) {\n    let raw: string;\n    try {\n      raw = await fs.readFile(path.join(locksDir, file), \"utf8\");\n    } catch (readError: unknown) {\n      if (isErrno(readError, \"ENOENT\")) {\n        // Disappeared between readdir and readFile — treat as a ghost; skip quietly.\n        continue;\n      }\n      scan.scanned += 1;\n      scan.unreadable_lock_count += 1;\n      continue;\n    }\n    scan.scanned += 1;\n    const { detail } = classifyLockContent(file, raw, nowMs);\n    if (detail === \"active\") {\n      scan.active_lock_count += 1;\n    } else if (detail === \"expired\") {\n      scan.stale_lock_count += 1;\n    } else {\n      scan.unparseable_lock_count += 1;\n    }\n  }\n\n  return scan;\n}\n\n/**\n * Implements run lock gc for the public runtime surface of this module.\n */\nexport async function runLockGc(pmRoot: string, options: LockGcOptions): Promise<LockGcResult> {\n  const { dryRun, hooks } = options;\n  const nowMs = options.now ?? Date.now();\n  const locksDir = path.join(pmRoot, \"locks\");\n\n  const result: LockGcResult = {\n    scanned: 0,\n    removed: [],\n    retained: [],\n    warnings: [],\n    entries: [],\n  };\n\n  let dirEntries: string[];\n  try {\n    const raw = await fs.readdir(locksDir);\n    dirEntries = raw.filter((f) => f.endsWith(\".lock\")).sort();\n  } catch (error: unknown) {\n    if (isErrno(error, \"ENOENT\")) {\n      return result;\n    }\n    throw error;\n  }\n\n  for (const file of dirEntries) {\n    result.scanned += 1;\n    const absPath = path.join(locksDir, file);\n    const relPath = `locks/${file}`;\n\n    // --- onRead hook ---\n    if (hooks?.onRead) {\n      const hookWarnings = await hooks.onRead(absPath);\n      result.warnings.push(...hookWarnings);\n    }\n\n    // --- read file ---\n    let raw: string;\n    try {\n      raw = await fs.readFile(absPath, \"utf8\");\n    } catch (readError: unknown) {\n      if (isErrno(readError, \"ENOENT\")) {\n        // Disappeared between readdir and readFile — treat as a ghost; skip quietly.\n        result.scanned -= 1;\n        continue;\n      }\n      result.warnings.push(`lock_unreadable:${file}`);\n      result.retained.push(relPath);\n      result.entries.push({\n        file,\n        id: null,\n        owner: null,\n        created_at: null,\n        ttl_seconds: null,\n        age_seconds: null,\n        stale: false,\n        reason: \"unparseable\",\n      });\n      continue;\n    }\n\n    // --- classify (shared with the read-only pm health locks scan) ---\n    const classified = classifyLockContent(file, raw, nowMs);\n    if (classified.detail === \"unparseable_json\") {\n      result.warnings.push(`lock_unparseable:${file}`);\n      result.retained.push(relPath);\n      result.entries.push(classified.entry);\n      continue;\n    }\n    if (classified.detail === \"invalid_timestamp\") {\n      result.warnings.push(`lock_invalid_timestamp:${file}`);\n      result.retained.push(relPath);\n      result.entries.push(classified.entry);\n      continue;\n    }\n    if (classified.detail === \"active\") {\n      result.retained.push(relPath);\n      result.entries.push(classified.entry);\n      continue;\n    }\n\n    // --- stale: remove or preview ---\n    if (!dryRun) {\n      try {\n        await fs.unlink(absPath);\n      } catch (unlinkError: unknown) {\n        if (!isErrno(unlinkError, \"ENOENT\")) {\n          result.warnings.push(`lock_remove_failed:${file}`);\n          result.retained.push(relPath);\n          result.entries.push(classified.entry);\n          continue;\n        }\n        // ENOENT on unlink = already gone (race); treat as removed\n      }\n      // onWrite hook after successful removal\n      if (hooks?.onWrite) {\n        const hookWarnings = await hooks.onWrite(absPath);\n        result.warnings.push(...hookWarnings);\n      }\n    }\n\n    result.removed.push(relPath);\n    result.entries.push(classified.entry);\n  }\n\n  return result;\n}\n"],
-  "mappings": "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",
-  "names": []
-}

package/dist/cli-bundle/chunks/chunk-R2EMWY7Q.js

@@ -1,368 +0,0 @@
-// dist/core/diagnostics/remediation.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]="d544ed3b-8846-5b6f-91a8-978992585267")}catch(e){}}();
-var REMEDIATION_REGISTRY = Object.freeze([
-  // --- pm health: directories ---
-  {
-    code: "missing_directory",
-    command: "pm init",
-    summary: "Recreate missing tracker directories (pm init is idempotent and restores the scaffold)."
-  },
-  // --- pm health: settings (read/parse) ---
-  {
-    code: "settings_read_invalid_json",
-    command: "pm config list --json",
-    summary: "settings.json is not valid JSON and pm fell back to defaults; fix the syntax error in the reported path, then re-run."
-  },
-  {
-    code: "settings_read_invalid_schema",
-    command: "pm config list --json",
-    summary: "settings.json failed schema validation and pm fell back to defaults; correct the reported key in the file, then re-run."
-  },
-  {
-    code: "settings_read_merge_failed",
-    command: "pm config list --json",
-    summary: "Global/project settings could not be merged; reconcile the conflicting keys in the reported settings files."
-  },
-  // --- pm health: settings_values ---
-  {
-    code: "settings:id_prefix_empty",
-    command: "pm config list --json",
-    summary: 'id_prefix is empty; set a non-empty "id_prefix" in settings.json so generated item ids are well-formed.'
-  },
-  {
-    code: "settings:locks_ttl_non_positive",
-    command: "pm config list --json",
-    summary: 'locks.ttl_seconds must be positive; set a positive "locks.ttl_seconds" in settings.json.'
-  },
-  // --- pm health: telemetry (advisory) ---
-  {
-    code: "telemetry_state_invalid_json",
-    command: "pm health --check-telemetry",
-    summary: "Local telemetry state file is corrupt; pm recreates it on the next flush. Advisory only."
-  },
-  {
-    code: "telemetry_queue_invalid_rows",
-    command: "pm health --check-telemetry",
-    summary: "The telemetry queue has unparseable rows; they are skipped on the next flush. Advisory only."
-  },
-  {
-    code: "telemetry_queue_pending",
-    command: "pm health --check-telemetry",
-    summary: "Telemetry events are queued; they flush automatically on the next reachable command. Advisory only."
-  },
-  {
-    code: "telemetry_queue_high_retries",
-    command: "pm telemetry flush",
-    summary: "Some queued telemetry events are near retry exhaustion; flush now and verify endpoint reachability before entries are dropped."
-  },
-  {
-    code: "telemetry_endpoint_probe_failed",
-    command: "pm health --check-telemetry",
-    summary: "The telemetry endpoint is unreachable; events stay queued until it recovers. Advisory only."
-  },
-  {
-    code: "telemetry_endpoint_probe_http_status",
-    command: "pm health --check-telemetry",
-    summary: "The telemetry endpoint returned a non-success status; events stay queued until it recovers. Advisory only."
-  },
-  {
-    code: "telemetry_schema_version_behind",
-    command: "pm health --check-telemetry",
-    summary: "Client schema is behind server; upgrade pm-cli to emit the latest event shape."
-  },
-  {
-    code: "telemetry_otel_export_failing",
-    command: "pm health --check-telemetry",
-    summary: "OTLP trace spans are queued but the traces endpoint export is failing; spans retry automatically on the next reachable command, or set PM_TELEMETRY_OTEL_DISABLED=1 to skip OTLP export. Advisory only."
-  },
-  // --- pm health: integrity ---
-  {
-    code: "integrity_item_unreadable",
-    command: "pm validate --check-files --verbose-diagnostics",
-    summary: "An item file could not be read; restore or repair the file at the reported path."
-  },
-  {
-    code: "integrity_item_parse_failed",
-    command: "pm validate --check-files --verbose-diagnostics",
-    summary: "An item file failed to parse; fix the malformed front matter at the reported path."
-  },
-  {
-    code: "integrity_item_conflict_marker",
-    command: "pm validate --check-files --verbose-diagnostics",
-    summary: "An item file contains Git conflict markers; resolve the <<<<<<< / >>>>>>> markers at the reported line."
-  },
-  {
-    code: "integrity_history_unreadable",
-    command: "pm history-repair <id>",
-    summary: "A history stream could not be read; re-anchor the affected item's history chain."
-  },
-  {
-    code: "integrity_history_invalid_json",
-    command: "pm history-repair <id>",
-    summary: "A history stream contains invalid JSON; re-anchor the affected item's history chain."
-  },
-  {
-    code: "integrity_history_conflict_marker",
-    command: "pm history-repair <id>",
-    summary: "A history stream contains Git conflict markers; resolve the markers, then re-anchor the chain."
-  },
-  // --- pm health (integrity) + pm validate (format_version): item format version ---
-  {
-    code: "integrity_item_outdated_format_version",
-    command: "pm validate --verbose-diagnostics",
-    summary: "An item predates the current storage format version; a pm storage migration rewrites it. Use --verbose-diagnostics to list the affected items."
-  },
-  {
-    code: "integrity_item_ahead_format_version",
-    command: "npm install -g @unbrained/pm-cli@latest",
-    summary: "An item was written by a newer pm format version than this runtime supports; upgrade pm to read and validate it safely."
-  },
-  // --- pm health: history_drift ---
-  // `pm health` rewrites these commands to `pm history-repair --all` in the
-  // per-check remediation_map when more than one stream is drifted.
-  {
-    code: "history_drift_missing_stream",
-    command: "pm history-repair <id>",
-    summary: "The item has no history stream; re-anchor the chain to rebuild it (pm history-repair --all repairs every drifted stream in one pass)."
-  },
-  {
-    code: "history_drift_unreadable_stream",
-    command: "pm history-repair <id>",
-    summary: "The item's history stream is unreadable; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."
-  },
-  {
-    code: "history_drift_hash_mismatch",
-    command: "pm history-repair <id>",
-    summary: "The item's content hash no longer matches its history; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."
-  },
-  {
-    code: "history_drift_chain_mismatch",
-    command: "pm history-repair <id>",
-    summary: "The item's history chain is broken; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."
-  },
-  // --- pm health: storage (history compaction policy) ---
-  {
-    code: "history_stream_over_compact_threshold",
-    command: "pm history-compact <id>",
-    summary: "The history stream exceeds the configured compaction threshold; compact it (pm history-compact --all-streams sweeps every over-threshold stream in one pass)."
-  },
-  // --- pm health: locks ---
-  {
-    code: "locks_stale_count",
-    command: "pm gc --scope locks",
-    summary: "Stale item-claim locks (embedded ttl elapsed) can block mutations; sweep them \u2014 gc retains active and unparseable locks."
-  },
-  {
-    code: "locks_unreadable",
-    command: "pm gc --scope locks --dry-run",
-    summary: "Some lock files could not be read; preview the sweep and inspect the unreadable files manually \u2014 gc never deletes what it cannot read."
-  },
-  // --- pm health: extensions ---
-  // Most extension findings keep their richer, contextual
-  // `details.triage.remediation` and are intentionally absent here. The
-  // partial-coverage code is the exception: it is not a per-extension triage
-  // result but a system-wide adoption gap (unmanaged installs the update-health
-  // scan had to skip), so it has a single deterministic fix and belongs in the
-  // shared registry like any other health finding (pm-bdvm).
-  {
-    code: "extension_update_health_partial_coverage",
-    command: "pm extension --adopt-all --project",
-    summary: "Update-health coverage is partial because unmanaged extensions were skipped; adopt the existing installs into managed metadata so the update scan covers them (use --global for global-scope extensions, or pm package --adopt-all when working with packages)."
-  },
-  // --- pm health: vectorization ---
-  {
-    code: "vectorization_stale_items_remaining",
-    command: "pm health --refresh-vectors",
-    summary: "Some items have stale embeddings; refresh vectors so semantic search results stay current."
-  },
-  {
-    code: "vectorization_embedding_identity_changed",
-    command: "pm reindex --mode semantic",
-    summary: "Embedding provider/model changed since the last index; run a semantic reindex to rebuild vectors."
-  },
-  // --- pm validate: metadata ---
-  // Note: validate_metadata_missing_author has no entry on purpose. `pm update
-  // --author` sets the mutation/audit author (history), not the item's
-  // `metadata.author` front-matter field, and there is no CLI flag that writes
-  // that field — so emitting a command here would record an audit entry without
-  // clearing the finding. A missing item author must be restored at the source.
-  {
-    code: "validate_metadata_missing_acceptance_criteria",
-    command: 'pm update <id> --acceptance-criteria "<criteria>"',
-    summary: "Backfill the missing acceptance criteria on the reported item(s)."
-  },
-  {
-    code: "validate_metadata_missing_estimate",
-    command: 'pm update <id> --estimate "<estimate>"',
-    summary: "Backfill the missing estimate on the reported item(s)."
-  },
-  {
-    code: "validate_metadata_missing_close_reason",
-    command: 'pm update <id> --close-reason "<reason>"',
-    summary: "Backfill the missing close reason on the reported closed item(s)."
-  },
-  {
-    code: "validate_metadata_missing_reviewer",
-    command: 'pm update <id> --reviewer "<name>"',
-    summary: "Backfill the missing reviewer on the reported item(s)."
-  },
-  {
-    code: "validate_metadata_missing_risk",
-    command: 'pm update <id> --risk "<level>"',
-    summary: "Backfill the missing risk on the reported item(s)."
-  },
-  {
-    code: "validate_metadata_missing_confidence",
-    command: 'pm update <id> --confidence "<level>"',
-    summary: "Backfill the missing confidence on the reported item(s)."
-  },
-  {
-    code: "validate_metadata_missing_sprint",
-    command: 'pm update <id> --sprint "<sprint>"',
-    summary: "Backfill the missing sprint on the reported item(s)."
-  },
-  {
-    code: "validate_metadata_missing_release",
-    command: 'pm update <id> --release "<release>"',
-    summary: "Backfill the missing release on the reported item(s)."
-  },
-  {
-    code: "validate_metadata_custom_profile_missing_required_fields",
-    command: 'pm config set metadata-required-fields --criterion "<field>"',
-    summary: "Config-driven finding: the custom metadata profile has no required fields configured and falls back to core, so configure the fields rather than mutating items."
-  },
-  {
-    code: "validate_metadata_duplicate_issue_codes",
-    command: 'pm update <id> --title "<distinct title>"',
-    summary: "Two or more items share one logical issue code (GH-235); give each a distinct title so the derived code is unique, or close the redundant item with pm close <id> --duplicate-of <canonical-id> (closed-as-duplicate items are excluded from the check)."
-  },
-  // --- pm validate: resolution ---
-  {
-    code: "validate_resolution_missing_fields",
-    command: 'pm update <id> --resolution "<how resolved>"',
-    summary: "Backfill resolution / expected_result / actual_result on the reported closed item(s)."
-  },
-  // --- pm validate: lifecycle ---
-  {
-    code: "validate_lifecycle_active_closure_like_metadata",
-    command: "pm update <id> --unset <closure-like-field>",
-    summary: "Clear the closure-like field the validator flags on this active item \u2014 the detail row names it (resolution / actual-result / blocked-reason) \u2014 or close the item if it is actually done."
-  },
-  {
-    code: "validate_lifecycle_active_terminal_parent",
-    command: "pm update <id> --parent <active-parent-id>",
-    summary: "Reopen the terminal parent or move the active child under a non-terminal parent."
-  },
-  {
-    code: "validate_lifecycle_stale_blockers",
-    command: "pm update <id> --unset blocked-by --unset blocked-reason",
-    summary: "Resolve the stale blocker the validator flags: clear blocked-by/blocked-reason when they linger on a non-blocked item or report a resolved blocker; if instead a blocked item is missing blocker context, add the context or move it out of a blocked status."
-  },
-  {
-    code: "validate_lifecycle_dependency_cycles_error",
-    command: "pm update <id> --dep-remove <dep-id>",
-    summary: "Break the dependency cycle by removing one edge from the reported cycle."
-  },
-  {
-    code: "validate_lifecycle_dependency_cycles",
-    command: "pm update <id> --dep-remove <dep-id>",
-    summary: "Break the dependency cycle by removing one edge from the reported cycle."
-  },
-  {
-    code: "validate_hierarchy_parent_cycle_error",
-    command: "pm update <id> --parent <other-id>",
-    summary: "Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent)."
-  },
-  {
-    code: "validate_hierarchy_parent_cycle",
-    command: "pm update <id> --parent <other-id>",
-    summary: "Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent)."
-  },
-  // --- pm validate: files ---
-  {
-    code: "validate_files_missing_linked_paths",
-    command: "pm <files|docs> <id> --remove <path>",
-    summary: "The check spans both item.files and item.docs under one code: restore the missing linked artifact, or unlink it with pm files (linked file) or pm docs (linked doc)."
-  },
-  {
-    code: "validate_files_orphaned_paths",
-    command: "pm <files|docs> <id> --add <path>",
-    summary: "Link the orphaned artifact with pm files (file) or pm docs (doc), or remove it from the workspace."
-  },
-  {
-    code: "validate_files_tracked_all_strict_forces_pm_internals",
-    command: "pm validate --check-files --include-pm-internals",
-    summary: "tracked-all-strict scan flagged pm internals; re-run with --include-pm-internals or a softer --scan-mode."
-  },
-  // --- pm validate: history_drift ---
-  {
-    code: "validate_history_drift_missing_streams",
-    command: "pm history-repair <id>",
-    summary: "Re-anchor the history chains of the items missing a history stream."
-  },
-  {
-    code: "validate_history_drift_unreadable_streams",
-    command: "pm history-repair <id>",
-    summary: "Re-anchor the history chains of the items with an unreadable history stream."
-  },
-  {
-    code: "validate_history_drift_hash_mismatches",
-    command: "pm history-repair <id>",
-    summary: "Re-anchor the history chains of the items whose content hash drifted."
-  },
-  {
-    code: "validate_history_drift_chain_mismatches",
-    command: "pm history-repair <id>",
-    summary: "Re-anchor the history chains of the items with a broken history chain."
-  },
-  // --- pm validate: command_references ---
-  {
-    code: "validate_command_references_stale_pm_ids",
-    command: 'pm update <id> --replace-tests --test "command=<corrected-command>" [--test ...]',
-    summary: "Correct the stale pm-ID inside the item's linked test command (the check scans tests[].command, not the body). --replace-tests overwrites the entire tests list, so re-include the item's other linked tests in the same call."
-  },
-  {
-    code: "validate_format_version_outdated_items",
-    command: "pm validate --verbose-diagnostics",
-    summary: "One or more items predate the current storage format version; a pm storage migration rewrites them. Use --verbose-diagnostics to list the affected items."
-  },
-  {
-    code: "validate_format_version_ahead_items",
-    command: "npm install -g @unbrained/pm-cli@latest",
-    summary: "One or more items were written by a newer pm format version than this runtime supports; upgrade pm to read and validate them safely."
-  }
-]);
-function resolveRemediation(warning) {
-  if (typeof warning !== "string") {
-    return void 0;
-  }
-  const normalized = warning.trim();
-  for (const entry of REMEDIATION_REGISTRY) {
-    if (normalized === entry.code || normalized.startsWith(`${entry.code}:`)) {
-      return entry;
-    }
-  }
-  return void 0;
-}
-function buildRemediationMap(warnings) {
-  const map = {};
-  for (const warning of warnings) {
-    const entry = resolveRemediation(warning);
-    if (entry !== void 0 && !Object.prototype.hasOwnProperty.call(map, entry.code)) {
-      map[entry.code] = entry.command;
-    }
-  }
-  return map;
-}
-function buildRemediationCommands(warnings) {
-  return Object.values(buildRemediationMap(warnings));
-}
-
-export {
-  buildRemediationMap,
-  buildRemediationCommands
-};
-//# sourceMappingURL=chunk-R2EMWY7Q.js.map
-
-//# debugId=d544ed3b-8846-5b6f-91a8-978992585267