@unbrained/pm-cli 2026.6.11 → 2026.6.12

package/dist/cli-bundle/chunks/gc-FENB2ESG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/commands/gc.ts"],"sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { runActiveOnIndexHooks, runActiveOnReadHooks, runActiveOnWriteHooks } from \"../../core/extensions/index.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { runLockGc } from \"../../core/lock/lock-gc.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\nconst GC_SCOPE_VALUES = [\"index\", \"embeddings\", \"runtime\", \"locks\"] as const;\ntype GcScope = (typeof GC_SCOPE_VALUES)[number];\n\ninterface GcTarget {\n  scope: GcScope;\n  relativePath: string;\n  kind: \"file\" | \"directory\";\n}\n\nconst GC_TARGETS: readonly GcTarget[] = [\n  {\n    scope: \"index\",\n    relativePath: \"index/manifest.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/embeddings.jsonl\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/vectorization-status.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/lancedb\",\n    kind: \"directory\",\n  },\n  {\n    scope: \"runtime\",\n    relativePath: \"runtime/test-runs\",\n    kind: \"directory\",\n  },\n  {\n    scope: \"runtime\",\n    relativePath: \"runtime/history-drift-cache.json\",\n    kind: \"file\",\n  },\n] as const;\n\nexport interface GcCommandOptions {\n  dryRun?: boolean;\n  scope?: string[];\n}\n\nexport interface GcLocksSummary {\n  scanned: number;\n  removed: number;\n  retained: number;\n}\n\nexport interface GcResult {\n  ok: boolean;\n  dry_run: boolean;\n  scope: GcScope[];\n  removed: string[];\n  retained: string[];\n  warnings: string[];\n  guidance: string[];\n  /** Present only when the locks scope was selected. Summarizes the stale-lock sweep. */\n  locks?: GcLocksSummary;\n  generated_at: string;\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\nasync function removeCacheFile(\n  pmRoot: string,\n  target: GcTarget,\n  dryRun: boolean,\n): Promise<{ removed: boolean; warnings: string[] }> {\n  const relativePath = target.relativePath;\n  const absolutePath = path.join(pmRoot, relativePath);\n  const warnings = await runActiveOnReadHooks({\n    path: absolutePath,\n    scope: \"project\",\n  });\n  try {\n    const stats = await fs.stat(absolutePath);\n    if (target.kind === \"file\" && !stats.isFile()) {\n      return {\n        removed: false,\n        warnings: [...warnings, `not_a_file:${relativePath}`],\n      };\n    }\n    if (target.kind === \"directory\" && !stats.isDirectory()) {\n      return {\n        removed: false,\n        warnings: [...warnings, `not_a_directory:${relativePath}`],\n      };\n    }\n    if (dryRun) {\n      return {\n        removed: true,\n        warnings,\n      };\n    }\n    if (target.kind === \"file\") {\n      await fs.unlink(absolutePath);\n    } else {\n      await fs.rm(absolutePath, { recursive: true, force: true });\n    }\n    const writeWarnings = await runActiveOnWriteHooks({\n      path: absolutePath,\n      scope: \"project\",\n      op: \"gc:remove\",\n    });\n    return {\n      removed: true,\n      warnings: [...warnings, ...writeWarnings],\n    };\n  } catch (error: unknown) {\n    if (isErrno(error, \"ENOENT\")) {\n      return {\n        removed: false,\n        warnings,\n      };\n    }\n    throw error;\n  }\n}\n\nfunction parseScopes(raw: string[] | undefined): GcScope[] {\n  if (!raw || raw.length === 0) {\n    return [...GC_SCOPE_VALUES];\n  }\n  const tokens = raw\n    .flatMap((entry) => entry.split(\",\"))\n    .map((entry) => entry.trim().toLowerCase())\n    .filter((entry) => entry.length > 0);\n  if (tokens.length === 0) {\n    throw new PmCliError(`--scope requires at least one value (${GC_SCOPE_VALUES.join(\",\")})`, EXIT_CODE.USAGE);\n  }\n  const resolved = new Set<GcScope>();\n  for (const token of tokens) {\n    if (!(GC_SCOPE_VALUES as readonly string[]).includes(token)) {\n      throw new PmCliError(\n        `Invalid --scope value \"${token}\". Expected one or more of: ${GC_SCOPE_VALUES.join(\", \")}`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    resolved.add(token as GcScope);\n  }\n  return GC_SCOPE_VALUES.filter((scope) => resolved.has(scope));\n}\n\nfunction buildGcGuidance(params: {\n  dryRun: boolean;\n  scopes: GcScope[];\n  removed: string[];\n}): string[] {\n  const guidance: string[] = [];\n  if (params.dryRun) {\n    guidance.push(\"Dry-run preview only: no cache artifacts were deleted.\");\n  }\n  const searchScopeSelected = params.scopes.includes(\"index\") || params.scopes.includes(\"embeddings\");\n  const searchArtifactsAffected = params.removed.some(\n    (entry) =>\n      entry === \"index/manifest.json\" ||\n      entry === \"search/embeddings.jsonl\" ||\n      entry === \"search/vectorization-status.json\" ||\n      entry === \"search/lancedb\",\n  );\n  if (searchScopeSelected && searchArtifactsAffected) {\n    guidance.push(\n      'Search artifacts were removed; run \"pm install search-advanced --project\" if reindex is unavailable, then \"pm reindex --mode keyword\" (and \"--mode semantic\" when semantic search is enabled) before search-heavy workflows.',\n    );\n  }\n  if (params.removed.includes(\"runtime/history-drift-cache.json\")) {\n    guidance.push('History drift cache was removed; the next \"pm health\" run performs a full history-drift re-scan.');\n  }\n  return guidance;\n}\n\nexport async function runGc(global: GlobalOptions, options: GcCommandOptions = {}): Promise<GcResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  await readSettings(pmRoot);\n  const dryRun = options.dryRun === true;\n  const scopes = parseScopes(options.scope);\n  const selectedTargets = GC_TARGETS.filter((target) => scopes.includes(target.scope));\n\n  const removed: string[] = [];\n  const retained: string[] = [];\n  const warnings: string[] = [];\n\n  for (const target of selectedTargets) {\n    const result = await removeCacheFile(pmRoot, target, dryRun);\n    if (result.removed) {\n      removed.push(target.relativePath);\n    } else {\n      retained.push(target.relativePath);\n    }\n    warnings.push(...result.warnings);\n  }\n\n  // The locks scope is not a path-based GC_TARGET: it sweeps the locks/ directory\n  // and removes only locks whose own embedded ttl has expired (crashed-process\n  // debris), retaining active and unparseable locks. See core/lock/lock-gc.ts.\n  let locksSummary: GcLocksSummary | undefined;\n  if (scopes.includes(\"locks\")) {\n    const lockResult = await runLockGc(pmRoot, {\n      dryRun,\n      hooks: {\n        onRead: (lockPath) => runActiveOnReadHooks({ path: lockPath, scope: \"project\" }),\n        onWrite: (lockPath) => runActiveOnWriteHooks({ path: lockPath, scope: \"project\", op: \"gc:lock_remove\" }),\n      },\n    });\n    removed.push(...lockResult.removed);\n    retained.push(...lockResult.retained);\n    warnings.push(...lockResult.warnings);\n    locksSummary = {\n      scanned: lockResult.scanned,\n      removed: lockResult.removed.length,\n      retained: lockResult.retained.length,\n    };\n  }\n\n  warnings.push(\n    ...(await runActiveOnIndexHooks({\n      mode: dryRun ? \"gc:dry-run\" : \"gc\",\n      total_items: selectedTargets.length,\n    })),\n  );\n  const guidance = buildGcGuidance({\n    dryRun,\n    scopes,\n    removed,\n  });\n\n  return {\n    ok: warnings.length === 0,\n    dry_run: dryRun,\n    scope: scopes,\n    removed,\n    retained,\n    warnings,\n    ...(locksSummary ? { locks: locksSummary } : {}),\n    guidance,\n    generated_at: nowIso(),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"53de24e8-b5be-5de6-93ad-bdaa9f3015b0"}

package/dist/cli-bundle/chunks/{gc-4Z3IKHAZ.js → gc-KGQG66SA.js}

@@ -1,3 +1,6 @@
+import {
+  runLockGc
+} from "./chunk-NAWVUHXH.js";
 import {
   nowIso
 } from "./chunk-IUKD4W6Z.js";
@@ -14,180 +17,8 @@ import {
 } from "./chunk-FY4SPXSC.js";
 
 // dist/cli/commands/gc.js
-import fs2 from "node:fs/promises";
-import path2 from "node:path";
-
-// 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] = "1a412027-5c73-58d4-b696-4a909dde88a8");
-  } 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;
-}
-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 lock = parseLock(raw);
-    if (lock === null) {
-      result.warnings.push(`lock_unparseable:${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 createdAtMs = Date.parse(lock.created_at);
-    if (!Number.isFinite(createdAtMs)) {
-      result.warnings.push(`lock_invalid_timestamp:${file}`);
-      result.retained.push(relPath);
-      result.entries.push({
-        file,
-        id: lock.id,
-        owner: lock.owner,
-        created_at: lock.created_at,
-        ttl_seconds: lock.ttl_seconds,
-        age_seconds: null,
-        stale: false,
-        reason: "unparseable"
-      });
-      continue;
-    }
-    const ageMs = nowMs - createdAtMs;
-    const age_seconds = Math.floor(ageMs / 1e3);
-    const stale = ageMs > lock.ttl_seconds * 1e3;
-    if (!stale) {
-      result.retained.push(relPath);
-      result.entries.push({
-        file,
-        id: lock.id,
-        owner: lock.owner,
-        created_at: lock.created_at,
-        ttl_seconds: lock.ttl_seconds,
-        age_seconds,
-        stale: false,
-        reason: "active"
-      });
-      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({
-            file,
-            id: lock.id,
-            owner: lock.owner,
-            created_at: lock.created_at,
-            ttl_seconds: lock.ttl_seconds,
-            age_seconds,
-            stale: true,
-            reason: "expired"
-          });
-          continue;
-        }
-      }
-      if (hooks?.onWrite) {
-        const hookWarnings = await hooks.onWrite(absPath);
-        result.warnings.push(...hookWarnings);
-      }
-    }
-    result.removed.push(relPath);
-    result.entries.push({
-      file,
-      id: lock.id,
-      owner: lock.owner,
-      created_at: lock.created_at,
-      ttl_seconds: lock.ttl_seconds,
-      age_seconds,
-      stale: true,
-      reason: "expired"
-    });
-  }
-  return result;
-}
-
-// dist/cli/commands/gc.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;
@@ -228,18 +59,18 @@ var GC_TARGETS = [
     kind: "file"
   }
 ];
-function isErrno2(error, code) {
+function isErrno(error, code) {
   return typeof error === "object" && error !== null && "code" in error && error.code === code;
 }
 async function removeCacheFile(pmRoot, target, dryRun) {
   const relativePath = target.relativePath;
-  const absolutePath = path2.join(pmRoot, relativePath);
+  const absolutePath = path.join(pmRoot, relativePath);
   const warnings = await runActiveOnReadHooks({
     path: absolutePath,
     scope: "project"
   });
   try {
-    const stats = await fs2.stat(absolutePath);
+    const stats = await fs.stat(absolutePath);
     if (target.kind === "file" && !stats.isFile()) {
       return {
         removed: false,
@@ -259,9 +90,9 @@ async function removeCacheFile(pmRoot, target, dryRun) {
       };
     }
     if (target.kind === "file") {
-      await fs2.unlink(absolutePath);
+      await fs.unlink(absolutePath);
     } else {
-      await fs2.rm(absolutePath, { recursive: true, force: true });
+      await fs.rm(absolutePath, { recursive: true, force: true });
     }
     const writeWarnings = await runActiveOnWriteHooks({
       path: absolutePath,
@@ -273,7 +104,7 @@ async function removeCacheFile(pmRoot, target, dryRun) {
       warnings: [...warnings, ...writeWarnings]
     };
   } catch (error) {
-    if (isErrno2(error, "ENOENT")) {
+    if (isErrno(error, "ENOENT")) {
       return {
         removed: false,
         warnings
@@ -377,4 +208,4 @@ async function runGc(global2, options = {}) {
 export {
   runGc
 };
-//# sourceMappingURL=gc-4Z3IKHAZ.js.map
+//# sourceMappingURL=gc-KGQG66SA.js.map

package/dist/cli-bundle/chunks/gc-KGQG66SA.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/gc.ts"],
+  "sourcesContent": ["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { runActiveOnIndexHooks, runActiveOnReadHooks, runActiveOnWriteHooks } from \"../../core/extensions/index.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { runLockGc } from \"../../core/lock/lock-gc.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\nconst GC_SCOPE_VALUES = [\"index\", \"embeddings\", \"runtime\", \"locks\"] as const;\ntype GcScope = (typeof GC_SCOPE_VALUES)[number];\n\ninterface GcTarget {\n  scope: GcScope;\n  relativePath: string;\n  kind: \"file\" | \"directory\";\n}\n\nconst GC_TARGETS: readonly GcTarget[] = [\n  {\n    scope: \"index\",\n    relativePath: \"index/manifest.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/embeddings.jsonl\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/vectorization-status.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/lancedb\",\n    kind: \"directory\",\n  },\n  {\n    scope: \"runtime\",\n    relativePath: \"runtime/test-runs\",\n    kind: \"directory\",\n  },\n  {\n    scope: \"runtime\",\n    relativePath: \"runtime/history-drift-cache.json\",\n    kind: \"file\",\n  },\n] as const;\n\nexport interface GcCommandOptions {\n  dryRun?: boolean;\n  scope?: string[];\n}\n\nexport interface GcLocksSummary {\n  scanned: number;\n  removed: number;\n  retained: number;\n}\n\nexport interface GcResult {\n  ok: boolean;\n  dry_run: boolean;\n  scope: GcScope[];\n  removed: string[];\n  retained: string[];\n  warnings: string[];\n  guidance: string[];\n  /** Present only when the locks scope was selected. Summarizes the stale-lock sweep. */\n  locks?: GcLocksSummary;\n  generated_at: string;\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\nasync function removeCacheFile(\n  pmRoot: string,\n  target: GcTarget,\n  dryRun: boolean,\n): Promise<{ removed: boolean; warnings: string[] }> {\n  const relativePath = target.relativePath;\n  const absolutePath = path.join(pmRoot, relativePath);\n  const warnings = await runActiveOnReadHooks({\n    path: absolutePath,\n    scope: \"project\",\n  });\n  try {\n    const stats = await fs.stat(absolutePath);\n    if (target.kind === \"file\" && !stats.isFile()) {\n      return {\n        removed: false,\n        warnings: [...warnings, `not_a_file:${relativePath}`],\n      };\n    }\n    if (target.kind === \"directory\" && !stats.isDirectory()) {\n      return {\n        removed: false,\n        warnings: [...warnings, `not_a_directory:${relativePath}`],\n      };\n    }\n    if (dryRun) {\n      return {\n        removed: true,\n        warnings,\n      };\n    }\n    if (target.kind === \"file\") {\n      await fs.unlink(absolutePath);\n    } else {\n      await fs.rm(absolutePath, { recursive: true, force: true });\n    }\n    const writeWarnings = await runActiveOnWriteHooks({\n      path: absolutePath,\n      scope: \"project\",\n      op: \"gc:remove\",\n    });\n    return {\n      removed: true,\n      warnings: [...warnings, ...writeWarnings],\n    };\n  } catch (error: unknown) {\n    if (isErrno(error, \"ENOENT\")) {\n      return {\n        removed: false,\n        warnings,\n      };\n    }\n    throw error;\n  }\n}\n\nfunction parseScopes(raw: string[] | undefined): GcScope[] {\n  if (!raw || raw.length === 0) {\n    return [...GC_SCOPE_VALUES];\n  }\n  const tokens = raw\n    .flatMap((entry) => entry.split(\",\"))\n    .map((entry) => entry.trim().toLowerCase())\n    .filter((entry) => entry.length > 0);\n  if (tokens.length === 0) {\n    throw new PmCliError(`--scope requires at least one value (${GC_SCOPE_VALUES.join(\",\")})`, EXIT_CODE.USAGE);\n  }\n  const resolved = new Set<GcScope>();\n  for (const token of tokens) {\n    if (!(GC_SCOPE_VALUES as readonly string[]).includes(token)) {\n      throw new PmCliError(\n        `Invalid --scope value \"${token}\". Expected one or more of: ${GC_SCOPE_VALUES.join(\", \")}`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    resolved.add(token as GcScope);\n  }\n  return GC_SCOPE_VALUES.filter((scope) => resolved.has(scope));\n}\n\nfunction buildGcGuidance(params: {\n  dryRun: boolean;\n  scopes: GcScope[];\n  removed: string[];\n}): string[] {\n  const guidance: string[] = [];\n  if (params.dryRun) {\n    guidance.push(\"Dry-run preview only: no cache artifacts were deleted.\");\n  }\n  const searchScopeSelected = params.scopes.includes(\"index\") || params.scopes.includes(\"embeddings\");\n  const searchArtifactsAffected = params.removed.some(\n    (entry) =>\n      entry === \"index/manifest.json\" ||\n      entry === \"search/embeddings.jsonl\" ||\n      entry === \"search/vectorization-status.json\" ||\n      entry === \"search/lancedb\",\n  );\n  if (searchScopeSelected && searchArtifactsAffected) {\n    guidance.push(\n      'Search artifacts were removed; run \"pm install search-advanced --project\" if reindex is unavailable, then \"pm reindex --mode keyword\" (and \"--mode semantic\" when semantic search is enabled) before search-heavy workflows.',\n    );\n  }\n  if (params.removed.includes(\"runtime/history-drift-cache.json\")) {\n    guidance.push('History drift cache was removed; the next \"pm health\" run performs a full history-drift re-scan.');\n  }\n  return guidance;\n}\n\nexport async function runGc(global: GlobalOptions, options: GcCommandOptions = {}): Promise<GcResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  await readSettings(pmRoot);\n  const dryRun = options.dryRun === true;\n  const scopes = parseScopes(options.scope);\n  const selectedTargets = GC_TARGETS.filter((target) => scopes.includes(target.scope));\n\n  const removed: string[] = [];\n  const retained: string[] = [];\n  const warnings: string[] = [];\n\n  for (const target of selectedTargets) {\n    const result = await removeCacheFile(pmRoot, target, dryRun);\n    if (result.removed) {\n      removed.push(target.relativePath);\n    } else {\n      retained.push(target.relativePath);\n    }\n    warnings.push(...result.warnings);\n  }\n\n  // The locks scope is not a path-based GC_TARGET: it sweeps the locks/ directory\n  // and removes only locks whose own embedded ttl has expired (crashed-process\n  // debris), retaining active and unparseable locks. See core/lock/lock-gc.ts.\n  let locksSummary: GcLocksSummary | undefined;\n  if (scopes.includes(\"locks\")) {\n    const lockResult = await runLockGc(pmRoot, {\n      dryRun,\n      hooks: {\n        onRead: (lockPath) => runActiveOnReadHooks({ path: lockPath, scope: \"project\" }),\n        onWrite: (lockPath) => runActiveOnWriteHooks({ path: lockPath, scope: \"project\", op: \"gc:lock_remove\" }),\n      },\n    });\n    removed.push(...lockResult.removed);\n    retained.push(...lockResult.retained);\n    warnings.push(...lockResult.warnings);\n    locksSummary = {\n      scanned: lockResult.scanned,\n      removed: lockResult.removed.length,\n      retained: lockResult.retained.length,\n    };\n  }\n\n  warnings.push(\n    ...(await runActiveOnIndexHooks({\n      mode: dryRun ? \"gc:dry-run\" : \"gc\",\n      total_items: selectedTargets.length,\n    })),\n  );\n  const guidance = buildGcGuidance({\n    dryRun,\n    scopes,\n    removed,\n  });\n\n  return {\n    ok: warnings.length === 0,\n    dry_run: dryRun,\n    scope: scopes,\n    removed,\n    retained,\n    warnings,\n    ...(locksSummary ? { locks: locksSummary } : {}),\n    guidance,\n    generated_at: nowIso(),\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/{health-YO5LRWN4.js → health-7MTXAVR2.js}

@@ -1,7 +1,12 @@
 import {
-  buildRemediationMap,
+  buildRemediationMap
+} from "./chunk-R4VWYWRN.js";
+import {
+  scanLockHealth
+} from "./chunk-NAWVUHXH.js";
+import {
   scanHistoryDrift
-} from "./chunk-LCSCXBGT.js";
+} from "./chunk-R2OUQVBK.js";
 import {
   collectStaleVectorizationIds
 } from "./chunk-QAJBIGRA.js";
@@ -72,7 +77,7 @@ 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] = "aa444802-31ea-5656-a3d6-8ed0ea39244f");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "aea76476-f15d-5223-8832-76e396aceb72");
   } catch (e2) {
   }
 })();
@@ -710,6 +715,14 @@ function summarizeHealthCheckDetails(check, limit) {
   if (check.name === "storage") {
     return details;
   }
+  if (check.name === "locks") {
+    return {
+      active_lock_count: details.active_lock_count,
+      stale_lock_count: details.stale_lock_count,
+      unreadable_lock_count: details.unreadable_lock_count,
+      unparseable_lock_count: details.unparseable_lock_count
+    };
+  }
   if (check.name === "integrity") {
     return {
       checked_item_files: details.checked_item_files,
@@ -1014,6 +1027,50 @@ async function buildTelemetryCheck(settings, options) {
     warnings
   };
 }
+async function buildLocksCheck(pmRoot) {
+  let scan;
+  try {
+    scan = await scanLockHealth(pmRoot);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      check: {
+        name: "locks",
+        status: "warn",
+        details: {
+          active_lock_count: 0,
+          stale_lock_count: 0,
+          unreadable_lock_count: 0,
+          unparseable_lock_count: 0,
+          scan_failed: true,
+          error: message,
+          pm_root: pmRoot
+        }
+      },
+      warnings: [`locks_scan_failed:${message}`]
+    };
+  }
+  const warnings = [];
+  if (scan.stale_lock_count > 0) {
+    warnings.push(`locks_stale_count:${scan.stale_lock_count}`);
+  }
+  if (scan.unreadable_lock_count > 0) {
+    warnings.push(`locks_unreadable:${scan.unreadable_lock_count}`);
+  }
+  return {
+    check: {
+      name: "locks",
+      status: warnings.length === 0 ? "ok" : "warn",
+      details: {
+        active_lock_count: scan.active_lock_count,
+        stale_lock_count: scan.stale_lock_count,
+        unreadable_lock_count: scan.unreadable_lock_count,
+        unparseable_lock_count: scan.unparseable_lock_count
+      }
+    },
+    warnings
+  };
+}
 async function buildHistoryDriftCheck(pmRoot, items) {
   const { missingStreams, unreadableStreams, hashMismatches, chainMismatches, driftedItems } = await scanHistoryDrift(pmRoot, items);
   const warnings = [
@@ -1210,6 +1267,7 @@ async function runHealth(global2, options = {}) {
     commandLabel: "health"
   });
   const historySummary = await countHistoryStreams(pmRoot);
+  const locksCheck = await buildLocksCheck(pmRoot);
   const integrityCheck = skipIntegrity ? { check: { name: "integrity", status: "ok", details: { skipped: true } }, warnings: [] } : await buildIntegrityCheck(pmRoot, typeRegistry.type_to_folder, settings.schema);
   const historyDriftCheck = skipDrift ? { check: { name: "history_drift", status: "ok", details: { skipped: true } }, warnings: [] } : await buildHistoryDriftCheck(pmRoot, itemsWithBody);
   const vectorizationCheck = skipVectors ? { check: { name: "vectorization", status: "ok", details: { skipped: true } }, warnings: [] } : await buildVectorizationCheck(pmRoot, settings, itemsWithBody, refreshPolicy, options.verboseStaleItems === true);
@@ -1254,6 +1312,7 @@ async function runHealth(global2, options = {}) {
         history_streams: historySummary.count
       }
     },
+    locksCheck.check,
     integrityCheck.check,
     historyDriftCheck.check,
     vectorizationCheck.check
@@ -1267,6 +1326,7 @@ async function runHealth(global2, options = {}) {
     ...extensionCheck.warnings,
     ...historyPolicy.warnings,
     ...historySummary.warnings,
+    ...locksCheck.warnings,
     ...integrityCheck.warnings,
     ...historyDriftCheck.warnings,
     ...vectorizationCheck.warnings,
@@ -1278,16 +1338,23 @@ async function runHealth(global2, options = {}) {
     directories: missingDirs.map((dir) => `missing_directory:${dir}`),
     settings_values: settingWarnings,
     telemetry: telemetryCheck.warnings,
+    locks: locksCheck.warnings,
     integrity: integrityCheck.warnings,
     history_drift: historyDriftCheck.warnings,
     vectorization: vectorizationCheck.warnings
   };
+  const historyDriftedCount = typeof historyDriftCheck.check.details.counts?.drifted === "number" ? historyDriftCheck.check.details.counts.drifted : 0;
   for (const check of checks) {
     const sources = checkRemediationSources[check.name];
     if (sources === void 0) {
       continue;
     }
     const remediationMap = buildRemediationMap(sources);
+    if (check.name === "history_drift" && historyDriftedCount > 1) {
+      for (const code of Object.keys(remediationMap)) {
+        remediationMap[code] = "pm history-repair --all";
+      }
+    }
     if (Object.keys(remediationMap).length > 0) {
       check.details = { ...check.details, remediation_map: remediationMap };
     }
@@ -1307,4 +1374,4 @@ async function runHealth(global2, options = {}) {
 export {
   runHealth
 };
-//# sourceMappingURL=health-YO5LRWN4.js.map
+//# sourceMappingURL=health-7MTXAVR2.js.map