@unbrained/pm-cli 2026.5.31 → 2026.6.5

package/dist/cli-bundle/chunks/chunk-5KB4X7YY.js

@@ -0,0 +1,412 @@
+
+!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]="7064c464-ee52-5164-a51a-6a337b42c837")}catch(e){}}();
+import {
+  verifyHistoryChain
+} from "./chunk-ASQM3IF5.js";
+import {
+  hashDocument
+} from "./chunk-CWT53EYT.js";
+import {
+  getHistoryPath,
+  writeFileAtomic
+} from "./chunk-4LTBNUYT.js";
+
+// dist/core/history/drift-scan.js
+import fs from "fs/promises";
+import path from "node:path";
+var DRIFT_CACHE_VERSION = 1;
+var DRIFT_CACHE_FILENAME = "history-drift-cache.json";
+function getDriftCachePath(pmRoot) {
+  return path.join(pmRoot, "runtime", DRIFT_CACHE_FILENAME);
+}
+async function loadDriftCache(pmRoot) {
+  try {
+    const raw = await fs.readFile(getDriftCachePath(pmRoot), "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed.version !== DRIFT_CACHE_VERSION || typeof parsed.entries !== "object" || parsed.entries === null) {
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function isErrno(error, code) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === code;
+}
+async function verifyHistoryStream(historyPath) {
+  const raw = await fs.readFile(historyPath, "utf8");
+  if (raw.trim().length === 0) {
+    return null;
+  }
+  const entries = [];
+  let latestAfterHash = null;
+  for (const line of raw.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0) {
+      continue;
+    }
+    const parsed = JSON.parse(trimmed);
+    if (typeof parsed.after_hash !== "string" || parsed.after_hash.trim().length === 0) {
+      throw new Error("missing after_hash");
+    }
+    entries.push(parsed);
+    latestAfterHash = parsed.after_hash;
+  }
+  if (!latestAfterHash) {
+    return null;
+  }
+  return { latestAfterHash, chainOk: verifyHistoryChain(entries).ok };
+}
+async function scanHistoryDrift(pmRoot, items) {
+  const missingStreams = [];
+  const unreadableStreams = [];
+  const hashMismatches = [];
+  const chainMismatches = [];
+  const cache = await loadDriftCache(pmRoot);
+  const previousEntries = cache?.entries ?? {};
+  const nextEntries = {};
+  let cacheDirty = false;
+  for (const item of items) {
+    const historyPath = getHistoryPath(pmRoot, item.id);
+    let stat;
+    try {
+      stat = await fs.stat(historyPath);
+    } catch (error) {
+      if (isErrno(error, "ENOENT")) {
+        missingStreams.push(item.id);
+      } else {
+        unreadableStreams.push(item.id);
+      }
+      continue;
+    }
+    const cached = previousEntries[item.id];
+    let verification;
+    if (cached && cached.mtime_ms === stat.mtimeMs && cached.ctime_ms === stat.ctimeMs && cached.size === stat.size) {
+      verification = { latestAfterHash: cached.latest_after_hash, chainOk: cached.chain_ok };
+    } else {
+      cacheDirty = true;
+      let result;
+      try {
+        result = await verifyHistoryStream(historyPath);
+      } catch {
+        unreadableStreams.push(item.id);
+        continue;
+      }
+      if (!result) {
+        missingStreams.push(item.id);
+        continue;
+      }
+      verification = result;
+    }
+    if (!verification.chainOk) {
+      chainMismatches.push(item.id);
+    }
+    nextEntries[item.id] = {
+      mtime_ms: stat.mtimeMs,
+      ctime_ms: stat.ctimeMs,
+      size: stat.size,
+      latest_after_hash: verification.latestAfterHash,
+      chain_ok: verification.chainOk
+    };
+    const { body, ...frontMatter } = item;
+    const currentHash = hashDocument({
+      metadata: frontMatter,
+      body
+    });
+    if (currentHash !== verification.latestAfterHash) {
+      hashMismatches.push(item.id);
+    }
+  }
+  if (cacheDirty || Object.keys(previousEntries).length !== Object.keys(nextEntries).length) {
+    const cachePath = getDriftCachePath(pmRoot);
+    try {
+      await fs.mkdir(path.dirname(cachePath), { recursive: true });
+      await writeFileAtomic(cachePath, JSON.stringify({ version: DRIFT_CACHE_VERSION, entries: nextEntries }));
+    } catch {
+    }
+  }
+  const driftedItems = [.../* @__PURE__ */ new Set([...missingStreams, ...unreadableStreams, ...hashMismatches, ...chainMismatches])].sort((a, b) => a.localeCompare(b));
+  return { missingStreams, unreadableStreams, hashMismatches, chainMismatches, driftedItems };
+}
+
+// dist/core/diagnostics/remediation.js
+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_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."
+  },
+  // --- 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: history_drift ---
+  {
+    code: "history_drift_missing_stream",
+    command: "pm history-repair <id>",
+    summary: "The item has no history stream; re-anchor the chain to rebuild it."
+  },
+  {
+    code: "history_drift_unreadable_stream",
+    command: "pm history-repair <id>",
+    summary: "The item's history stream is unreadable; re-anchor the chain."
+  },
+  {
+    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."
+  },
+  {
+    code: "history_drift_chain_mismatch",
+    command: "pm history-repair <id>",
+    summary: "The item's history chain is broken; re-anchor the chain."
+  },
+  // --- 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."
+  },
+  // --- 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."
+  },
+  // --- 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."
+  },
+  // --- 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."
+  }
+]);
+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 {
+  scanHistoryDrift,
+  buildRemediationMap,
+  buildRemediationCommands
+};
+//# sourceMappingURL=chunk-5KB4X7YY.js.map
+
+//# debugId=7064c464-ee52-5164-a51a-6a337b42c837

package/dist/cli-bundle/chunks/chunk-5KB4X7YY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../core/history/drift-scan.ts","../../../../../../../../core/diagnostics/remediation.ts"],"sourcesContent":["import fs from \"fs/promises\";\nimport path from \"node:path\";\nimport { getHistoryPath } from \"../store/paths.js\";\nimport { writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { hashDocument } from \"./history.js\";\nimport { verifyHistoryChain } from \"./replay.js\";\nimport type { HistoryEntry, ItemMetadata } from \"../../types/index.js\";\n\nexport interface DriftScanResult {\n  missingStreams: string[];\n  unreadableStreams: string[];\n  hashMismatches: string[];\n  chainMismatches: string[];\n  driftedItems: string[];\n}\n\nconst DRIFT_CACHE_VERSION = 1;\nconst DRIFT_CACHE_FILENAME = \"history-drift-cache.json\";\n\ninterface DriftCacheEntry {\n  mtime_ms: number;\n  ctime_ms: number;\n  size: number;\n  latest_after_hash: string;\n  chain_ok: boolean;\n}\n\ninterface DriftCacheEnvelope {\n  version: number;\n  entries: Record<string, DriftCacheEntry>;\n}\n\nfunction getDriftCachePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\", DRIFT_CACHE_FILENAME);\n}\n\nasync function loadDriftCache(pmRoot: string): Promise<DriftCacheEnvelope | null> {\n  try {\n    const raw = await fs.readFile(getDriftCachePath(pmRoot), \"utf8\");\n    const parsed = JSON.parse(raw) as DriftCacheEnvelope;\n    if (parsed.version !== DRIFT_CACHE_VERSION || typeof parsed.entries !== \"object\" || parsed.entries === null) {\n      return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === code;\n}\n\ninterface StreamVerification {\n  latestAfterHash: string;\n  chainOk: boolean;\n}\n\n/**\n * Read and fully verify one history stream's hash chain. Returns null for an\n * empty/missing stream (caller records it as a missing stream).\n */\nasync function verifyHistoryStream(historyPath: string): Promise<StreamVerification | null> {\n  const raw = await fs.readFile(historyPath, \"utf8\");\n  if (raw.trim().length === 0) {\n    return null;\n  }\n  const entries: HistoryEntry[] = [];\n  let latestAfterHash: string | null = null;\n  for (const line of raw.split(/\\r?\\n/)) {\n    const trimmed = line.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    const parsed = JSON.parse(trimmed) as HistoryEntry;\n    if (typeof parsed.after_hash !== \"string\" || parsed.after_hash.trim().length === 0) {\n      throw new Error(\"missing after_hash\");\n    }\n    entries.push(parsed);\n    latestAfterHash = parsed.after_hash;\n  }\n  /* c8 ignore start -- defensive guard for future history schema changes. */\n  if (!latestAfterHash) {\n    return null;\n  }\n  /* c8 ignore stop */\n  return { latestAfterHash, chainOk: verifyHistoryChain(entries).ok };\n}\n\n/**\n * Scan every item's history stream for drift (missing/unreadable streams, broken\n * hash chains, and item/history hash mismatches).\n *\n * Full chain re-verification of a 17MB+ history tree is the dominant cost of\n * `pm health`. We cache the per-stream verification keyed by the history file's\n * mtime/size: an unchanged file has an identical chain and latest stored hash, so\n * we skip re-reading and re-hashing it. Item-side changes are still caught every\n * run because the current document hash is recomputed and compared to the cached\n * `latest_after_hash`.\n */\nexport async function scanHistoryDrift(\n  pmRoot: string,\n  items: Array<ItemMetadata & { body: string }>,\n): Promise<DriftScanResult> {\n  const missingStreams: string[] = [];\n  const unreadableStreams: string[] = [];\n  const hashMismatches: string[] = [];\n  const chainMismatches: string[] = [];\n\n  const cache = await loadDriftCache(pmRoot);\n  const previousEntries: Record<string, DriftCacheEntry> = cache?.entries ?? {};\n  const nextEntries: Record<string, DriftCacheEntry> = {};\n  let cacheDirty = false;\n\n  for (const item of items) {\n    const historyPath = getHistoryPath(pmRoot, item.id);\n\n    let stat: Awaited<ReturnType<typeof fs.stat>>;\n    try {\n      stat = await fs.stat(historyPath);\n    } catch (error: unknown) {\n      if (isErrno(error, \"ENOENT\")) {\n        missingStreams.push(item.id);\n      } else {\n        unreadableStreams.push(item.id);\n      }\n      continue;\n    }\n\n    const cached = previousEntries[item.id];\n    let verification: StreamVerification;\n    if (cached && cached.mtime_ms === stat.mtimeMs && cached.ctime_ms === stat.ctimeMs && cached.size === stat.size) {\n      verification = { latestAfterHash: cached.latest_after_hash, chainOk: cached.chain_ok };\n    } else {\n      cacheDirty = true;\n      let result: StreamVerification | null;\n      try {\n        result = await verifyHistoryStream(historyPath);\n      } catch {\n        unreadableStreams.push(item.id);\n        continue;\n      }\n      if (!result) {\n        missingStreams.push(item.id);\n        continue;\n      }\n      verification = result;\n    }\n\n    if (!verification.chainOk) {\n      chainMismatches.push(item.id);\n    }\n    nextEntries[item.id] = {\n      mtime_ms: stat.mtimeMs,\n      ctime_ms: stat.ctimeMs,\n      size: stat.size,\n      latest_after_hash: verification.latestAfterHash,\n      chain_ok: verification.chainOk,\n    };\n\n    const { body, ...frontMatter } = item;\n    const currentHash = hashDocument({\n      metadata: frontMatter as ItemMetadata,\n      body,\n    });\n    if (currentHash !== verification.latestAfterHash) {\n      hashMismatches.push(item.id);\n    }\n  }\n\n  if (cacheDirty || Object.keys(previousEntries).length !== Object.keys(nextEntries).length) {\n    const cachePath = getDriftCachePath(pmRoot);\n    try {\n      await fs.mkdir(path.dirname(cachePath), { recursive: true });\n      await writeFileAtomic(cachePath, JSON.stringify({ version: DRIFT_CACHE_VERSION, entries: nextEntries }));\n    } catch {\n      // Best-effort cache write: a failed persist must never fail a health scan.\n    }\n  }\n\n  const driftedItems = [...new Set([...missingStreams, ...unreadableStreams, ...hashMismatches, ...chainMismatches])].sort((a, b) =>\n    a.localeCompare(b),\n  );\n  return { missingStreams, unreadableStreams, hashMismatches, chainMismatches, driftedItems };\n}\n","/**\n * Shared machine-executable remediation registry.\n *\n * `pm health` and `pm validate` both emit stable, colon-delimited warning tokens\n * (for example `history_drift_missing_stream:pm-abcd` or\n * `validate_resolution_missing_fields:3`). Agents that gate on these commands\n * previously had to hardcode the mapping from a warning code to the `pm` command\n * that fixes it. This module is the single source of truth for that mapping so\n * `pm health --json` (per-check `remediation_map`) and `pm validate --fix-hints`\n * (per-check `fix_hints`) can both surface executable remediation without any\n * duplicated, drift-prone lookup tables.\n *\n * Semantics of {@link RemediationEntry.command}: the suggested next `pm` command\n * an operator/agent should run to resolve findings with that code. Per-item\n * findings use an `<id>` placeholder (callers that have the concrete id may\n * substitute it); findings whose only fix is a manual file edit point at the\n * most useful diagnostic/repair command and describe the manual step in\n * {@link RemediationEntry.summary}.\n */\n\nexport interface RemediationEntry {\n  /**\n   * Stable warning-code prefix this entry resolves. A warning matches when it\n   * equals this code or begins with `<code>:`. Registry codes are mutually\n   * exclusive under that colon-boundary rule (no code is a `:`-delimited prefix\n   * of another — e.g. `settings:id_prefix_empty` is distinct from a bare\n   * `settings`, which is intentionally not registered), so `resolveRemediation`\n   * uses first-match with no ordering dependency.\n   */\n  readonly code: string;\n  /** Executable `pm` command (or imperative) that resolves the finding. May contain an `<id>` placeholder. */\n  readonly command: string;\n  /** One-line description of what the command does / which manual step it covers. */\n  readonly summary: string;\n}\n\n/**\n * Registry of every non-extension `pm health` / `pm validate` warning code and\n * its remediation. Extension findings keep their richer, contextual\n * `details.triage.remediation` produced by the extension health triage and are\n * intentionally excluded here (see pm-0hnu: \"all non-extension checks\").\n */\nexport const REMEDIATION_REGISTRY: readonly RemediationEntry[] = Object.freeze([\n  // --- pm health: directories ---\n  {\n    code: \"missing_directory\",\n    command: \"pm init\",\n    summary: \"Recreate missing tracker directories (pm init is idempotent and restores the scaffold).\",\n  },\n  // --- pm health: settings (read/parse) ---\n  {\n    code: \"settings_read_invalid_json\",\n    command: \"pm config list --json\",\n    summary:\n      \"settings.json is not valid JSON and pm fell back to defaults; fix the syntax error in the reported path, then re-run.\",\n  },\n  {\n    code: \"settings_read_invalid_schema\",\n    command: \"pm config list --json\",\n    summary:\n      \"settings.json failed schema validation and pm fell back to defaults; correct the reported key in the file, then re-run.\",\n  },\n  {\n    code: \"settings_read_merge_failed\",\n    command: \"pm config list --json\",\n    summary: \"Global/project settings could not be merged; reconcile the conflicting keys in the reported settings files.\",\n  },\n  // --- pm health: settings_values ---\n  {\n    code: \"settings:id_prefix_empty\",\n    command: \"pm config list --json\",\n    summary: 'id_prefix is empty; set a non-empty \"id_prefix\" in settings.json so generated item ids are well-formed.',\n  },\n  {\n    code: \"settings:locks_ttl_non_positive\",\n    command: \"pm config list --json\",\n    summary: 'locks.ttl_seconds must be positive; set a positive \"locks.ttl_seconds\" in settings.json.',\n  },\n  // --- pm health: telemetry (advisory) ---\n  {\n    code: \"telemetry_state_invalid_json\",\n    command: \"pm health --check-telemetry\",\n    summary: \"Local telemetry state file is corrupt; pm recreates it on the next flush. Advisory only.\",\n  },\n  {\n    code: \"telemetry_queue_invalid_rows\",\n    command: \"pm health --check-telemetry\",\n    summary: \"The telemetry queue has unparseable rows; they are skipped on the next flush. Advisory only.\",\n  },\n  {\n    code: \"telemetry_queue_pending\",\n    command: \"pm health --check-telemetry\",\n    summary: \"Telemetry events are queued; they flush automatically on the next reachable command. Advisory only.\",\n  },\n  {\n    code: \"telemetry_endpoint_probe_failed\",\n    command: \"pm health --check-telemetry\",\n    summary: \"The telemetry endpoint is unreachable; events stay queued until it recovers. Advisory only.\",\n  },\n  {\n    code: \"telemetry_endpoint_probe_http_status\",\n    command: \"pm health --check-telemetry\",\n    summary: \"The telemetry endpoint returned a non-success status; events stay queued until it recovers. Advisory only.\",\n  },\n  // --- pm health: integrity ---\n  {\n    code: \"integrity_item_unreadable\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary: \"An item file could not be read; restore or repair the file at the reported path.\",\n  },\n  {\n    code: \"integrity_item_parse_failed\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary: \"An item file failed to parse; fix the malformed front matter at the reported path.\",\n  },\n  {\n    code: \"integrity_item_conflict_marker\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary: \"An item file contains Git conflict markers; resolve the <<<<<<< / >>>>>>> markers at the reported line.\",\n  },\n  {\n    code: \"integrity_history_unreadable\",\n    command: \"pm history-repair <id>\",\n    summary: \"A history stream could not be read; re-anchor the affected item's history chain.\",\n  },\n  {\n    code: \"integrity_history_invalid_json\",\n    command: \"pm history-repair <id>\",\n    summary: \"A history stream contains invalid JSON; re-anchor the affected item's history chain.\",\n  },\n  {\n    code: \"integrity_history_conflict_marker\",\n    command: \"pm history-repair <id>\",\n    summary: \"A history stream contains Git conflict markers; resolve the markers, then re-anchor the chain.\",\n  },\n  // --- pm health: history_drift ---\n  {\n    code: \"history_drift_missing_stream\",\n    command: \"pm history-repair <id>\",\n    summary: \"The item has no history stream; re-anchor the chain to rebuild it.\",\n  },\n  {\n    code: \"history_drift_unreadable_stream\",\n    command: \"pm history-repair <id>\",\n    summary: \"The item's history stream is unreadable; re-anchor the chain.\",\n  },\n  {\n    code: \"history_drift_hash_mismatch\",\n    command: \"pm history-repair <id>\",\n    summary: \"The item's content hash no longer matches its history; re-anchor the chain.\",\n  },\n  {\n    code: \"history_drift_chain_mismatch\",\n    command: \"pm history-repair <id>\",\n    summary: \"The item's history chain is broken; re-anchor the chain.\",\n  },\n  // --- pm health: vectorization ---\n  {\n    code: \"vectorization_stale_items_remaining\",\n    command: \"pm health --refresh-vectors\",\n    summary: \"Some items have stale embeddings; refresh vectors so semantic search results stay current.\",\n  },\n  // --- pm validate: metadata ---\n  // Note: validate_metadata_missing_author has no entry on purpose. `pm update\n  // --author` sets the mutation/audit author (history), not the item's\n  // `metadata.author` front-matter field, and there is no CLI flag that writes\n  // that field — so emitting a command here would record an audit entry without\n  // clearing the finding. A missing item author must be restored at the source.\n  {\n    code: \"validate_metadata_missing_acceptance_criteria\",\n    command: 'pm update <id> --acceptance-criteria \"<criteria>\"',\n    summary: \"Backfill the missing acceptance criteria on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_estimate\",\n    command: 'pm update <id> --estimate \"<estimate>\"',\n    summary: \"Backfill the missing estimate on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_close_reason\",\n    command: 'pm update <id> --close-reason \"<reason>\"',\n    summary: \"Backfill the missing close reason on the reported closed item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_reviewer\",\n    command: 'pm update <id> --reviewer \"<name>\"',\n    summary: \"Backfill the missing reviewer on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_risk\",\n    command: 'pm update <id> --risk \"<level>\"',\n    summary: \"Backfill the missing risk on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_confidence\",\n    command: 'pm update <id> --confidence \"<level>\"',\n    summary: \"Backfill the missing confidence on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_sprint\",\n    command: 'pm update <id> --sprint \"<sprint>\"',\n    summary: \"Backfill the missing sprint on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_release\",\n    command: 'pm update <id> --release \"<release>\"',\n    summary: \"Backfill the missing release on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_custom_profile_missing_required_fields\",\n    command: 'pm config set metadata-required-fields --criterion \"<field>\"',\n    summary:\n      \"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.\",\n  },\n  // --- pm validate: resolution ---\n  {\n    code: \"validate_resolution_missing_fields\",\n    command: 'pm update <id> --resolution \"<how resolved>\"',\n    summary: \"Backfill resolution / expected_result / actual_result on the reported closed item(s).\",\n  },\n  // --- pm validate: lifecycle ---\n  {\n    code: \"validate_lifecycle_active_closure_like_metadata\",\n    command: \"pm update <id> --unset <closure-like-field>\",\n    summary:\n      \"Clear the closure-like field the validator flags on this active item — the detail row names it (resolution / actual-result / blocked-reason) — or close the item if it is actually done.\",\n  },\n  {\n    code: \"validate_lifecycle_active_terminal_parent\",\n    command: \"pm update <id> --parent <active-parent-id>\",\n    summary: \"Reopen the terminal parent or move the active child under a non-terminal parent.\",\n  },\n  {\n    code: \"validate_lifecycle_stale_blockers\",\n    command: \"pm update <id> --unset blocked-by --unset blocked-reason\",\n    summary:\n      \"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.\",\n  },\n  {\n    code: \"validate_lifecycle_dependency_cycles_error\",\n    command: \"pm update <id> --dep-remove <dep-id>\",\n    summary: \"Break the dependency cycle by removing one edge from the reported cycle.\",\n  },\n  {\n    code: \"validate_lifecycle_dependency_cycles\",\n    command: \"pm update <id> --dep-remove <dep-id>\",\n    summary: \"Break the dependency cycle by removing one edge from the reported cycle.\",\n  },\n  // --- pm validate: files ---\n  {\n    code: \"validate_files_missing_linked_paths\",\n    command: \"pm <files|docs> <id> --remove <path>\",\n    summary:\n      \"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).\",\n  },\n  {\n    code: \"validate_files_orphaned_paths\",\n    command: \"pm <files|docs> <id> --add <path>\",\n    summary:\n      \"Link the orphaned artifact with pm files (file) or pm docs (doc), or remove it from the workspace.\",\n  },\n  {\n    code: \"validate_files_tracked_all_strict_forces_pm_internals\",\n    command: \"pm validate --check-files --include-pm-internals\",\n    summary: \"tracked-all-strict scan flagged pm internals; re-run with --include-pm-internals or a softer --scan-mode.\",\n  },\n  // --- pm validate: history_drift ---\n  {\n    code: \"validate_history_drift_missing_streams\",\n    command: \"pm history-repair <id>\",\n    summary: \"Re-anchor the history chains of the items missing a history stream.\",\n  },\n  {\n    code: \"validate_history_drift_unreadable_streams\",\n    command: \"pm history-repair <id>\",\n    summary: \"Re-anchor the history chains of the items with an unreadable history stream.\",\n  },\n  {\n    code: \"validate_history_drift_hash_mismatches\",\n    command: \"pm history-repair <id>\",\n    summary: \"Re-anchor the history chains of the items whose content hash drifted.\",\n  },\n  {\n    code: \"validate_history_drift_chain_mismatches\",\n    command: \"pm history-repair <id>\",\n    summary: \"Re-anchor the history chains of the items with a broken history chain.\",\n  },\n  // --- pm validate: command_references ---\n  {\n    code: \"validate_command_references_stale_pm_ids\",\n    command: 'pm update <id> --replace-tests --test \"command=<corrected-command>\" [--test ...]',\n    summary:\n      \"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.\",\n  },\n]);\n\n/**\n * Resolve the remediation entry for a warning token, or `undefined` when no\n * entry is registered. A warning matches an entry when it equals the entry code\n * or begins with `<code>:` (the colon boundary keeps sibling codes such as\n * `validate_lifecycle_dependency_cycles` and\n * `validate_lifecycle_dependency_cycles_error` disjoint).\n *\n * First match is intentional and correct: registry codes are mutually exclusive\n * under the colon-boundary rule, so at most one entry can ever match a warning\n * and order is irrelevant. That invariant is enforced by a test (see\n * remediation-registry.spec.ts \"keeps every registry code mutually exclusive\"),\n * which is why this stays a simple linear scan rather than a longest-prefix\n * search — a longest-prefix tie-break is unreachable with disjoint codes.\n *\n * Accepts unknown input defensively (this is an exported helper SDK consumers\n * may call from untyped JS): a non-string `warning` resolves to `undefined`.\n */\nexport function resolveRemediation(warning: string): RemediationEntry | undefined {\n  if (typeof warning !== \"string\") {\n    return undefined;\n  }\n  const normalized = warning.trim();\n  for (const entry of REMEDIATION_REGISTRY) {\n    if (normalized === entry.code || normalized.startsWith(`${entry.code}:`)) {\n      return entry;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Build a compact `remediation_map` (code -> command) for a set of warning\n * tokens. First match wins per code; unknown codes are skipped. Used by\n * `pm health --json` per-check details and as the source of deduped executable\n * commands for `pm validate --fix-hints`.\n */\nexport function buildRemediationMap(warnings: Iterable<string>): Record<string, string> {\n  const map: Record<string, string> = {};\n  for (const warning of warnings) {\n    const entry = resolveRemediation(warning);\n    if (entry !== undefined && !Object.prototype.hasOwnProperty.call(map, entry.code)) {\n      map[entry.code] = entry.command;\n    }\n  }\n  return map;\n}\n\n/**\n * Build a deduped, ordered list of executable remediation commands for a set of\n * warning tokens (one command per distinct matched code). Used by\n * `pm validate --fix-hints` for checks that do not already emit per-row\n * remediation commands.\n */\nexport function buildRemediationCommands(warnings: Iterable<string>): string[] {\n  return Object.values(buildRemediationMap(warnings));\n}\n"],"names":[],"mappings":"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","debugId":"7064c464-ee52-5164-a51a-6a337b42c837"}

package/dist/cli-bundle/chunks/chunk-5PAOPUZX.js

@@ -0,0 +1,182 @@
+
+!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]="5824ce26-e61b-5294-a4fa-9a239e190399")}catch(e){}}();
+import {
+  listAllFrontMatterLight,
+  mutateItem,
+  toItemRecord
+} from "./chunk-CWT53EYT.js";
+import {
+  isTerminalStatus
+} from "./chunk-KBG47ZOY.js";
+import {
+  resolveItemTypeRegistry
+} from "./chunk-SZQCER6S.js";
+import {
+  EXIT_CODE,
+  PmCliError,
+  getSettingsPath,
+  pathExists,
+  readSettings,
+  resolvePmRoot,
+  resolveRuntimeStatusRegistry
+} from "./chunk-4LTBNUYT.js";
+
+// dist/cli/commands/close.js
+function toAuthor(candidate, defaultAuthor) {
+  const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;
+  const trimmed = resolved.trim();
+  return trimmed || "unknown";
+}
+function ensureCloseReason(reasonText) {
+  const reason = reasonText.trim();
+  if (reason.length === 0) {
+    throw new PmCliError("Close reason text must not be empty", EXIT_CODE.USAGE);
+  }
+  return reason;
+}
+var CLOSE_VALIDATION_FIELDS = [
+  { key: "resolution", label: "resolution" },
+  { key: "expected_result", label: "expected_result" },
+  { key: "actual_result", label: "actual_result" }
+];
+function parseValidateCloseMode(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  const normalized = raw.trim().toLowerCase();
+  if (normalized.length === 0 || normalized === "warn") {
+    return "warn";
+  }
+  if (normalized === "off" || normalized === "none" || normalized === "disabled") {
+    return "off";
+  }
+  if (normalized === "strict") {
+    return "strict";
+  }
+  throw new PmCliError(`Invalid --validate-close mode "${raw}" (expected "off", "warn", or "strict")`, EXIT_CODE.USAGE);
+}
+function findMissingCloseValidationFields(frontMatter) {
+  const missing = [];
+  for (const field of CLOSE_VALIDATION_FIELDS) {
+    const rawValue = frontMatter[field.key];
+    if (typeof rawValue !== "string" || rawValue.trim().length === 0) {
+      missing.push(field.label);
+    }
+  }
+  return missing;
+}
+async function findActiveChildIds(pmRoot, settings, parentId, statusRegistry) {
+  const typeRegistry = resolveItemTypeRegistry(settings);
+  const items = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, void 0, settings.schema);
+  return items.filter((item) => item.parent === parentId && !isTerminalStatus(item.status, statusRegistry)).map((item) => item.id).sort((left, right) => left.localeCompare(right));
+}
+async function runClose(id, closeReasonText, options, global) {
+  const pmRoot = resolvePmRoot(process.cwd(), global.path);
+  if (!await pathExists(getSettingsPath(pmRoot))) {
+    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+  }
+  const settings = await readSettings(pmRoot);
+  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
+  const author = toAuthor(options.author, settings.author_default);
+  const closeReason = ensureCloseReason(closeReasonText);
+  const validateCloseMode = parseValidateCloseMode(options.validateClose) ?? settings.governance.close_validation_default;
+  const activeChildIds = await findActiveChildIds(pmRoot, settings, id, statusRegistry);
+  const result = await mutateItem({
+    pmRoot,
+    settings,
+    id,
+    op: "close",
+    author,
+    message: options.message,
+    force: options.force,
+    mutate(document) {
+      if (isTerminalStatus(document.metadata.status, statusRegistry) && !options.force) {
+        throw new PmCliError(`Item ${document.metadata.id} is already terminal; use --force to close again.`, EXIT_CODE.CONFLICT);
+      }
+      const mutationWarnings = [];
+      const inlineCloseFields = [
+        { option: options.resolution, key: "resolution" },
+        { option: options.expectedResult, key: "expected_result" },
+        { option: options.actualResult, key: "actual_result" }
+      ];
+      for (const { option, key } of inlineCloseFields) {
+        if (typeof option !== "string")
+          continue;
+        const trimmed = option.trim();
+        if (trimmed.length === 0)
+          continue;
+        document.metadata[key] = trimmed;
+      }
+      if (validateCloseMode !== "off") {
+        const missingFields = findMissingCloseValidationFields(document.metadata);
+        if (missingFields.length > 0) {
+          if (validateCloseMode === "strict") {
+            throw new PmCliError(`Cannot close item ${document.metadata.id}: missing ${missingFields.join(", ")}. Populate fields or use --validate-close warn.`, EXIT_CODE.USAGE);
+          }
+          mutationWarnings.push(`close_validation_missing_fields:${document.metadata.id}:${missingFields.join(",")}`);
+        }
+        if (activeChildIds.length > 0) {
+          if (validateCloseMode === "strict") {
+            throw new PmCliError(`Cannot close item ${document.metadata.id}: active child items remain open (${activeChildIds.join(", ")}). Close, cancel, or re-parent them first, or use --validate-close warn.`, EXIT_CODE.USAGE);
+          }
+          mutationWarnings.push(`close_validation_active_children:${document.metadata.id}:${activeChildIds.join(",")}`);
+        }
+      } else if (activeChildIds.length > 0) {
+        mutationWarnings.push(`closed_with_active_children:${document.metadata.id}:${activeChildIds.join(",")}`);
+      }
+      document.metadata.status = statusRegistry.close_status;
+      document.metadata.close_reason = closeReason;
+      const changedFields = ["status", "close_reason"];
+      for (const { option, key } of inlineCloseFields) {
+        if (typeof option === "string" && option.trim().length > 0) {
+          changedFields.push(key);
+        }
+      }
+      if (document.metadata.assignee !== void 0) {
+        delete document.metadata.assignee;
+        changedFields.push("assignee");
+      }
+      const previousBlockedBy = typeof document.metadata.blocked_by === "string" ? document.metadata.blocked_by.trim() : "";
+      const existingDeps = document.metadata.dependencies ?? [];
+      const blockedByEdge = existingDeps.find((dep) => dep.kind === "blocked_by");
+      const hadBlockedReason = document.metadata.blocked_reason !== void 0;
+      if (previousBlockedBy.length > 0 || blockedByEdge !== void 0 || hadBlockedReason) {
+        if (previousBlockedBy.length > 0) {
+          delete document.metadata.blocked_by;
+          changedFields.push("blocked_by");
+        }
+        if (hadBlockedReason) {
+          delete document.metadata.blocked_reason;
+          changedFields.push("blocked_reason");
+        }
+        if (blockedByEdge !== void 0) {
+          const remainingDeps = existingDeps.filter((dep) => dep.kind !== "blocked_by");
+          if (remainingDeps.length > 0) {
+            document.metadata.dependencies = remainingDeps;
+          } else {
+            delete document.metadata.dependencies;
+          }
+          changedFields.push("dependencies");
+        }
+        const reportedBlocker = previousBlockedBy || blockedByEdge?.id || "unknown";
+        mutationWarnings.push(`closed_cleared_blocked_by:${document.metadata.id}:${reportedBlocker}`);
+      }
+      return {
+        changedFields,
+        ...mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}
+      };
+    }
+  });
+  return {
+    item: toItemRecord(result.item),
+    changed_fields: result.changedFields,
+    warnings: result.warnings
+  };
+}
+
+export {
+  runClose
+};
+//# sourceMappingURL=chunk-5PAOPUZX.js.map
+
+//# debugId=5824ce26-e61b-5294-a4fa-9a239e190399