@unbrained/pm-cli 2026.6.6 → 2026.6.8

package/dist/cli-bundle/chunks/{docs-WW4N3MBM.js → docs-SCNBUGSV.js}

@@ -1,15 +1,15 @@
 import {
   renameArtifactsResultKey,
   runLinkedArtifacts
-} from "./chunk-BQHUILZS.js";
+} from "./chunk-BFJPMUF5.js";
 import "./chunk-O7IWB35H.js";
-import "./chunk-XLTD2HN3.js";
-import "./chunk-XTGLRY2Y.js";
-import "./chunk-T3LC5LKB.js";
-import "./chunk-AO442XLN.js";
-import "./chunk-KJE2FOS4.js";
-import "./chunk-QO7EBBOM.js";
-import "./chunk-U5SXYXSY.js";
+import "./chunk-CBJXWXI5.js";
+import "./chunk-2HMD3JM2.js";
+import "./chunk-K62SNVVE.js";
+import "./chunk-M7UBTVFT.js";
+import "./chunk-2BYKYPWY.js";
+import "./chunk-QFVASU44.js";
+import "./chunk-3TXWDGPU.js";
 
 // dist/cli/commands/docs.js
 !(function() {
@@ -31,4 +31,4 @@ async function runDocs(id, options, global2) {
 export {
   runDocs
 };
-//# sourceMappingURL=docs-WW4N3MBM.js.map
+//# sourceMappingURL=docs-SCNBUGSV.js.map

package/dist/cli-bundle/chunks/{extension-VDY2U33M.js → extension-CRE7JM47.js}

@@ -3,16 +3,18 @@
 import {
   copyExtensionDirectoryForInstall,
   parseExtensionInstallSource,
-  parseExtensionManifest,
   readManagedExtensionState,
   resolveManagedExtensionStatePath,
   runExtension,
-  validateExtensionDirectory,
   writeManagedExtensionState
-} from "./chunk-TPH5XEVD.js";
+} from "./chunk-F33AQIB4.js";
+import {
+  parseExtensionManifest,
+  validateExtensionDirectory
+} from "./chunk-ETZZU5QF.js";
 import "./chunk-LXYVKYMQ.js";
-import "./chunk-TCD3R2PF.js";
-import "./chunk-5SFCOO6B.js";
+import "./chunk-XZS4MV37.js";
+import "./chunk-YJAKN2N2.js";
 export {
   copyExtensionDirectoryForInstall,
   parseExtensionInstallSource,
@@ -23,6 +25,6 @@ export {
   validateExtensionDirectory,
   writeManagedExtensionState
 };
-//# sourceMappingURL=extension-VDY2U33M.js.map
+//# sourceMappingURL=extension-CRE7JM47.js.map
 
 //# debugId=45eac7fa-f181-5cca-93b7-cfb58909dbb3

package/dist/cli-bundle/chunks/{extension-J7IBMFTD.js → extension-KK2UPXJD.js}

@@ -1,16 +1,18 @@
 import {
   copyExtensionDirectoryForInstall,
   parseExtensionInstallSource,
-  parseExtensionManifest,
   readManagedExtensionState,
   resolveManagedExtensionStatePath,
   runExtension,
-  validateExtensionDirectory,
   writeManagedExtensionState
-} from "./chunk-ECCMVXGM.js";
+} from "./chunk-7WXGR44E.js";
+import {
+  parseExtensionManifest,
+  validateExtensionDirectory
+} from "./chunk-URJEZOLB.js";
 import "./chunk-3HUE7XOF.js";
-import "./chunk-QO7EBBOM.js";
-import "./chunk-U5SXYXSY.js";
+import "./chunk-QFVASU44.js";
+import "./chunk-3TXWDGPU.js";
 export {
   copyExtensionDirectoryForInstall,
   parseExtensionInstallSource,
@@ -21,4 +23,4 @@ export {
   validateExtensionDirectory,
   writeManagedExtensionState
 };
-//# sourceMappingURL=extension-J7IBMFTD.js.map
+//# sourceMappingURL=extension-KK2UPXJD.js.map

package/dist/cli-bundle/chunks/{files-ISZJGILQ.js → files-3GESQAWL.js}

@@ -6,22 +6,22 @@ import {
   renameArtifactsResultKey,
   runLinkedArtifacts,
   sortLinkedArtifacts
-} from "./chunk-I2HSTRJF.js";
+} from "./chunk-KN4WSESY.js";
 import {
   resolveAuthor
 } from "./chunk-J27KIHTG.js";
-import "./chunk-PO3GSVFV.js";
+import "./chunk-NLVCMVC7.js";
 import {
   locateItem,
   mutateItem,
   readLocatedItem
-} from "./chunk-GGYWB3Y2.js";
-import "./chunk-HZGUAH22.js";
-import "./chunk-LB3RUL2N.js";
+} from "./chunk-ODN53S6H.js";
+import "./chunk-4TI3532H.js";
+import "./chunk-XEKZCBCS.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-2VBQ6ZXS.js";
-import "./chunk-TCD3R2PF.js";
+} from "./chunk-Z2HXAFFH.js";
+import "./chunk-XZS4MV37.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -31,7 +31,7 @@ import {
   pathExists,
   readSettings,
   resolvePmRoot
-} from "./chunk-5SFCOO6B.js";
+} from "./chunk-YJAKN2N2.js";
 
 // dist/cli/commands/files.js
 import fs from "node:fs/promises";
@@ -277,6 +277,6 @@ export {
   runFiles,
   runFilesDiscover
 };
-//# sourceMappingURL=files-ISZJGILQ.js.map
+//# sourceMappingURL=files-3GESQAWL.js.map
 
 //# debugId=2fdc8a3e-c4aa-531a-bd76-1570005b876f

package/dist/cli-bundle/chunks/{files-WKOD326U.js → files-66EHM5ZR.js}

@@ -4,22 +4,22 @@ import {
   renameArtifactsResultKey,
   runLinkedArtifacts,
   sortLinkedArtifacts
-} from "./chunk-BQHUILZS.js";
+} from "./chunk-BFJPMUF5.js";
 import {
   resolveAuthor
 } from "./chunk-O7IWB35H.js";
-import "./chunk-XLTD2HN3.js";
+import "./chunk-CBJXWXI5.js";
 import {
   locateItem,
   mutateItem,
   readLocatedItem
-} from "./chunk-XTGLRY2Y.js";
-import "./chunk-T3LC5LKB.js";
-import "./chunk-AO442XLN.js";
+} from "./chunk-2HMD3JM2.js";
+import "./chunk-K62SNVVE.js";
+import "./chunk-M7UBTVFT.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-KJE2FOS4.js";
-import "./chunk-QO7EBBOM.js";
+} from "./chunk-2BYKYPWY.js";
+import "./chunk-QFVASU44.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -29,7 +29,7 @@ import {
   pathExists,
   readSettings,
   resolvePmRoot
-} from "./chunk-U5SXYXSY.js";
+} from "./chunk-3TXWDGPU.js";
 
 // dist/cli/commands/files.js
 import fs from "node:fs/promises";
@@ -282,4 +282,4 @@ export {
   runFiles,
   runFilesDiscover
 };
-//# sourceMappingURL=files-WKOD326U.js.map
+//# sourceMappingURL=files-66EHM5ZR.js.map

package/dist/cli-bundle/chunks/{gc-JDVJ6OQ2.js → gc-D5IWOKQH.js}

@@ -1,8 +1,8 @@
 
-!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]="8eb2ff99-9b3f-5d18-82ae-b9148ec4b864")}catch(e){}}();
+!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]="ad200c72-c878-50dd-8e2f-6dd46e979296")}catch(e){}}();
 import {
   nowIso
-} from "./chunk-TCD3R2PF.js";
+} from "./chunk-XZS4MV37.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -13,7 +13,7 @@ import {
   runActiveOnIndexHooks,
   runActiveOnReadHooks,
   runActiveOnWriteHooks
-} from "./chunk-5SFCOO6B.js";
+} from "./chunk-YJAKN2N2.js";
 
 // dist/cli/commands/gc.js
 import fs2 from "node:fs/promises";
@@ -209,6 +209,11 @@ var GC_TARGETS = [
     scope: "runtime",
     relativePath: "runtime/test-runs",
     kind: "directory"
+  },
+  {
+    scope: "runtime",
+    relativePath: "runtime/history-drift-cache.json",
+    kind: "file"
   }
 ];
 function isErrno2(error, code) {
@@ -292,6 +297,9 @@ function buildGcGuidance(params) {
   if (searchScopeSelected && searchArtifactsAffected) {
     guidance.push('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.');
   }
+  if (params.removed.includes("runtime/history-drift-cache.json")) {
+    guidance.push('History drift cache was removed; the next "pm health" run performs a full history-drift re-scan.');
+  }
   return guidance;
 }
 async function runGc(global, options = {}) {
@@ -357,6 +365,6 @@ async function runGc(global, options = {}) {
 export {
   runGc
 };
-//# sourceMappingURL=gc-JDVJ6OQ2.js.map
+//# sourceMappingURL=gc-D5IWOKQH.js.map
 
-//# debugId=8eb2ff99-9b3f-5d18-82ae-b9148ec4b864
+//# debugId=ad200c72-c878-50dd-8e2f-6dd46e979296

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/commands/gc.ts","../../../../../../../../core/lock/lock-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","/**\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\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\nexport interface LockGcHooks {\n  onRead?: (lockPath: string) => Promise<string[]> | string[];\n  onWrite?: (lockPath: string) => Promise<string[]> | string[];\n}\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\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\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    // --- parse ---\n    const lock = parseLock(raw);\n    if (lock === null) {\n      result.warnings.push(`lock_unparseable:${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    // --- validate timestamp ---\n    const createdAtMs = Date.parse(lock.created_at);\n    if (!Number.isFinite(createdAtMs)) {\n      result.warnings.push(`lock_invalid_timestamp:${file}`);\n      result.retained.push(relPath);\n      result.entries.push({\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      continue;\n    }\n\n    const ageMs = nowMs - createdAtMs;\n    const age_seconds = Math.floor(ageMs / 1000);\n    const stale = ageMs > lock.ttl_seconds * 1000;\n\n    if (!stale) {\n      result.retained.push(relPath);\n      result.entries.push({\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: false,\n        reason: \"active\",\n      });\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({\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: true,\n            reason: \"expired\",\n          });\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({\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: true,\n      reason: \"expired\",\n    });\n  }\n\n  return result;\n}\n"],"names":["fs","path","isErrno","path","fs"],"mappings":"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","debugId":"ad200c72-c878-50dd-8e2f-6dd46e979296"}

package/dist/cli-bundle/chunks/{gc-ULPVWMTN.js → gc-MOQDND5J.js}

@@ -1,6 +1,6 @@
 import {
   nowIso
-} from "./chunk-QO7EBBOM.js";
+} from "./chunk-QFVASU44.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -11,7 +11,7 @@ import {
   runActiveOnIndexHooks,
   runActiveOnReadHooks,
   runActiveOnWriteHooks
-} from "./chunk-U5SXYXSY.js";
+} from "./chunk-3TXWDGPU.js";
 
 // dist/cli/commands/gc.js
 import fs2 from "node:fs/promises";
@@ -191,7 +191,7 @@ async function runLockGc(pmRoot, options) {
 !(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] = "ddcbdf59-d0c8-5ae8-84e3-c4af1966deb6");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "abfb11ce-9272-5c0e-8fae-25ea38f31327");
   } catch (e2) {
   }
 })();
@@ -221,6 +221,11 @@ var GC_TARGETS = [
     scope: "runtime",
     relativePath: "runtime/test-runs",
     kind: "directory"
+  },
+  {
+    scope: "runtime",
+    relativePath: "runtime/history-drift-cache.json",
+    kind: "file"
   }
 ];
 function isErrno2(error, code) {
@@ -304,6 +309,9 @@ function buildGcGuidance(params) {
   if (searchScopeSelected && searchArtifactsAffected) {
     guidance.push('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.');
   }
+  if (params.removed.includes("runtime/history-drift-cache.json")) {
+    guidance.push('History drift cache was removed; the next "pm health" run performs a full history-drift re-scan.');
+  }
   return guidance;
 }
 async function runGc(global2, options = {}) {
@@ -369,4 +377,4 @@ async function runGc(global2, options = {}) {
 export {
   runGc
 };
-//# sourceMappingURL=gc-ULPVWMTN.js.map
+//# sourceMappingURL=gc-MOQDND5J.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/gc.ts", "../../../../../../../../core/lock/lock-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", "/**\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\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\nexport interface LockGcHooks {\n  onRead?: (lockPath: string) => Promise<string[]> | string[];\n  onWrite?: (lockPath: string) => Promise<string[]> | string[];\n}\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\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\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    // --- parse ---\n    const lock = parseLock(raw);\n    if (lock === null) {\n      result.warnings.push(`lock_unparseable:${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    // --- validate timestamp ---\n    const createdAtMs = Date.parse(lock.created_at);\n    if (!Number.isFinite(createdAtMs)) {\n      result.warnings.push(`lock_invalid_timestamp:${file}`);\n      result.retained.push(relPath);\n      result.entries.push({\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      continue;\n    }\n\n    const ageMs = nowMs - createdAtMs;\n    const age_seconds = Math.floor(ageMs / 1000);\n    const stale = ageMs > lock.ttl_seconds * 1000;\n\n    if (!stale) {\n      result.retained.push(relPath);\n      result.entries.push({\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: false,\n        reason: \"active\",\n      });\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({\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: true,\n            reason: \"expired\",\n          });\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({\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: true,\n      reason: \"expired\",\n    });\n  }\n\n  return result;\n}\n"],
+  "mappings": "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",
+  "names": ["fs", "path", "isErrno", "path", "fs", "global"]
+}

package/dist/cli-bundle/chunks/{get-RV37HT3G.js → get-7J2ZCBV5.js}

@@ -1,22 +1,24 @@
 
-!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]="ee4af23f-e74f-5512-a4da-786f9a459b45")}catch(e){}}();
+!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]="8d05da97-b537-5f04-9c8b-7b8ebdb34993")}catch(e){}}();
 import {
   readHistoryEntries
-} from "./chunk-2RSPZI5H.js";
-import "./chunk-GXSUPCBV.js";
-import "./chunk-3VAM3NNM.js";
+} from "./chunk-OVSSE2JP.js";
+import "./chunk-HOA3GMB6.js";
+import {
+  parseIntegerLimit
+} from "./chunk-NDSMKB2I.js";
 import {
   buildItemNotFoundError,
   locateItem,
   readLocatedItem,
   toItemRecord
-} from "./chunk-GGYWB3Y2.js";
-import "./chunk-HZGUAH22.js";
-import "./chunk-LB3RUL2N.js";
+} from "./chunk-ODN53S6H.js";
+import "./chunk-4TI3532H.js";
+import "./chunk-XEKZCBCS.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-2VBQ6ZXS.js";
-import "./chunk-TCD3R2PF.js";
+} from "./chunk-Z2HXAFFH.js";
+import "./chunk-XZS4MV37.js";
 import {
   EXIT_CODE,
   FRONT_MATTER_KEY_ORDER,
@@ -28,7 +30,7 @@ import {
   readSettings,
   resolvePmRoot,
   resolveRuntimeFieldRegistry
-} from "./chunk-5SFCOO6B.js";
+} from "./chunk-YJAKN2N2.js";
 
 // dist/cli/commands/get.js
 var GET_DEPTH_VALUES = ["brief", "standard", "deep"];
@@ -129,7 +131,11 @@ async function runGet(id, global, options = {}) {
   if (options.full && (options.fields !== void 0 || options.depth !== void 0)) {
     throw new PmCliError("Get projection options are mutually exclusive; remove the extra projection flag and retry.", EXIT_CODE.USAGE);
   }
+  if (options.tree !== true && options.treeDepth !== void 0) {
+    throw new PmCliError("Get --tree-depth requires --tree", EXIT_CODE.USAGE);
+  }
   const depth = options.full ? "deep" : parseGetDepth(options.depth);
+  const treeDepth = options.tree === true ? parseIntegerLimit(options.treeDepth, "--tree-depth") : void 0;
   const fields = parseGetFields(options.fields);
   const pmRoot = resolvePmRoot(process.cwd(), global.path);
   if (!await pathExists(getSettingsPath(pmRoot))) {
@@ -184,11 +190,27 @@ async function runGet(id, global, options = {}) {
   if (claimState) {
     result.claim_state = claimState;
   }
+  if (options.tree === true) {
+    const { runList } = await import("./list-JGP7ODML.js");
+    const subtree = await runList(void 0, {
+      parent: located.id,
+      tree: true,
+      treeDepth: treeDepth === void 0 ? void 0 : String(treeDepth),
+      full: true
+    }, global);
+    result.tree = {
+      root_id: located.id,
+      root_title: loaded.document.metadata.title,
+      depth_limit: treeDepth ?? null,
+      count: subtree.count,
+      items: subtree.items.map((entry) => toItemRecord(entry))
+    };
+  }
   return result;
 }
 export {
   runGet
 };
-//# sourceMappingURL=get-RV37HT3G.js.map
+//# sourceMappingURL=get-7J2ZCBV5.js.map
 
-//# debugId=ee4af23f-e74f-5512-a4da-786f9a459b45
+//# debugId=8d05da97-b537-5f04-9c8b-7b8ebdb34993

package/dist/cli-bundle/chunks/get-7J2ZCBV5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/commands/get.ts"],"sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { resolveRuntimeFieldRegistry } from \"../../core/schema/runtime-schema.js\";\nimport { EXIT_CODE, FRONT_MATTER_KEY_ORDER } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { buildItemNotFoundError, locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getHistoryPath, getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { parseIntegerLimit } from \"../shared-parsers.js\";\nimport type { ItemFrontMatter, LinkedDoc, LinkedFile, LinkedTest } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\n\ninterface ClaimHistoryContext {\n  ts: string;\n  author: string;\n  message: string | null;\n}\n\ninterface ClaimHistoryEntry {\n  op: string;\n  ts: string;\n  author: string;\n  message?: string;\n}\n\ninterface ClaimStateContext {\n  claimed: boolean;\n  assignee: string | null;\n  last_claim: ClaimHistoryContext | null;\n  last_release: ClaimHistoryContext | null;\n}\n\nexport interface GetResult {\n  item: Partial<ItemFrontMatter>;\n  body?: string;\n  linked?: {\n    files: LinkedFile[];\n    tests: LinkedTest[];\n    docs: LinkedDoc[];\n  };\n  claim_state?: ClaimStateContext;\n  tree?: {\n    root_id: string;\n    root_title: string | null;\n    depth_limit: number | null;\n    count: number;\n    items: Record<string, unknown>[];\n  };\n}\n\nconst GET_DEPTH_VALUES = [\"brief\", \"standard\", \"deep\"] as const;\n\ntype GetDepth = (typeof GET_DEPTH_VALUES)[number];\n\nexport interface GetOptions {\n  depth?: string;\n  fields?: string;\n  full?: boolean;\n  tree?: boolean;\n  treeDepth?: string;\n}\n\nfunction toClaimHistoryContext(\n  entry: ClaimHistoryEntry,\n): ClaimHistoryContext {\n  return {\n    ts: entry.ts,\n    author: entry.author,\n    message: entry.message ?? null,\n  };\n}\n\nfunction resolveClaimStateContext(\n  assigneeValue: string | undefined,\n  history: ClaimHistoryEntry[],\n): ClaimStateContext {\n  const assignee = assigneeValue?.trim();\n  const normalizedAssignee = assignee && assignee.length > 0 ? assignee : null;\n  const lastClaim = [...history].reverse().find((entry) => entry.op === \"claim\");\n  const lastRelease = [...history].reverse().find((entry) => entry.op === \"release\");\n  return {\n    claimed: normalizedAssignee !== null,\n    assignee: normalizedAssignee,\n    last_claim: lastClaim ? toClaimHistoryContext(lastClaim) : null,\n    last_release: lastRelease ? toClaimHistoryContext(lastRelease) : null,\n  };\n}\n\nfunction parseGetDepth(raw: string | undefined): GetDepth {\n  if (raw === undefined || raw.trim().length === 0) {\n    return \"standard\";\n  }\n  const normalized = raw.trim().toLowerCase();\n  if (normalized === \"full\") {\n    return \"deep\";\n  }\n  if (GET_DEPTH_VALUES.includes(normalized as GetDepth)) {\n    return normalized as GetDepth;\n  }\n  throw new PmCliError(\"Get --depth must be one of brief|standard|deep|full\", EXIT_CODE.USAGE);\n}\n\nfunction projectItemForDepth(item: ItemFrontMatter, depth: GetDepth): Partial<ItemFrontMatter> {\n  if (depth === \"deep\") {\n    return item;\n  }\n  const {\n    comments: _comments,\n    notes: _notes,\n    learnings: _learnings,\n    files: _files,\n    tests: _tests,\n    docs: _docs,\n    reminders: _reminders,\n    events: _events,\n    ...projected\n  } = item;\n  return projected;\n}\n\nfunction parseGetFields(raw: string | undefined): string[] | null {\n  if (raw === undefined) {\n    return null;\n  }\n  const fields = raw\n    .split(\",\")\n    .map((entry) => entry.trim())\n    .filter((entry) => entry.length > 0);\n  if (fields.length === 0) {\n    throw new PmCliError(\"Get --fields requires a comma-separated list of field names\", EXIT_CODE.USAGE);\n  }\n  return fields;\n}\n\nfunction normalizeGetField(field: string): string {\n  return field.startsWith(\"item.\") ? field.slice(\"item.\".length) : field;\n}\n\nfunction validateGetFields(fields: string[] | null, runtimeMetadataKeys: Iterable<string>): void {\n  if (fields === null) {\n    return;\n  }\n  const itemFields = new Set([...FRONT_MATTER_KEY_ORDER, ...runtimeMetadataKeys]);\n  const allowedRootFields = new Set([\"body\", \"linked\", \"claim_state\"]);\n  const allowedLinkedFields = new Set([\"linked.files\", \"linked.tests\", \"linked.docs\"]);\n  const allowedClaimStateFields = new Set([\"claim_state.claimed\", \"claim_state.assignee\", \"claim_state.last_claim\", \"claim_state.last_release\"]);\n  const unknown = fields.filter((field) => {\n    const normalized = normalizeGetField(field);\n    return (\n      !itemFields.has(normalized) &&\n      !allowedRootFields.has(normalized) &&\n      !allowedLinkedFields.has(normalized) &&\n      !allowedClaimStateFields.has(normalized)\n    );\n  });\n  if (unknown.length > 0) {\n    throw new PmCliError(`Unknown get --fields value(s): ${unknown.join(\", \")}`, EXIT_CODE.USAGE, {\n      code: \"unknown_field_projection\",\n      examples: [\n        \"pm get <id> --fields id,title,status,type,updated_at\",\n        \"pm get <id> --fields id,title,claim_state\",\n        \"pm get <id> --fields id,title,body,linked.files\",\n      ],\n    });\n  }\n}\n\nfunction projectItemForFields(item: ItemFrontMatter, fields: string[]): Partial<ItemFrontMatter> {\n  const source = toItemRecord(item);\n  const projected: Record<string, unknown> = {};\n  for (const field of fields) {\n    const normalized = field.startsWith(\"item.\") ? field.slice(\"item.\".length) : field;\n    if (normalized === \"body\" || normalized === \"linked\" || normalized.startsWith(\"linked.\")) {\n      continue;\n    }\n    projected[normalized] = source[normalized];\n  }\n  return projected as Partial<ItemFrontMatter>;\n}\n\nfunction fieldsInclude(fields: string[] | null, name: string): boolean {\n  return fields?.some((field) => field === name || field === `item.${name}`) ?? false;\n}\n\nfunction fieldsIncludeRoot(fields: string[], name: string): boolean {\n  return fields.some((field) => field === name || field.startsWith(`${name}.`));\n}\n\nexport async function runGet(id: string, global: GlobalOptions, options: GetOptions = {}): Promise<GetResult> {\n  if (options.full && (options.fields !== undefined || options.depth !== undefined)) {\n    throw new PmCliError(\"Get projection options are mutually exclusive; remove the extra projection flag and retry.\", EXIT_CODE.USAGE);\n  }\n  if (options.tree !== true && options.treeDepth !== undefined) {\n    throw new PmCliError(\"Get --tree-depth requires --tree\", EXIT_CODE.USAGE);\n  }\n  const depth = options.full ? \"deep\" : parseGetDepth(options.depth);\n  const treeDepth = options.tree === true ? parseIntegerLimit(options.treeDepth, \"--tree-depth\") : undefined;\n  const fields = parseGetFields(options.fields);\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  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\n  if (!located) {\n    throw await buildItemNotFoundError(pmRoot, id, settings.id_prefix, typeRegistry.type_to_folder);\n  }\n  const loaded = await readLocatedItem(located, { schema: settings.schema });\n  const runtimeMetadataKeys: string[] = [];\n  for (const field of resolveRuntimeFieldRegistry(settings.schema).definitions) {\n    runtimeMetadataKeys.push(field.metadata_key);\n  }\n  validateGetFields(fields, runtimeMetadataKeys);\n  const files = loaded.document.metadata.files ?? [];\n  const tests = loaded.document.metadata.tests ?? [];\n  const docs = loaded.document.metadata.docs ?? [];\n  const fieldProjection = fields !== null;\n  const includeBody = !fieldProjection ? depth !== \"brief\" : fieldsInclude(fields, \"body\");\n  const includeLinked = !fieldProjection ? depth !== \"brief\" : fieldsInclude(fields, \"linked\");\n  const includeLinkedFiles = includeLinked || fieldsInclude(fields, \"linked.files\");\n  const includeLinkedTests = includeLinked || fieldsInclude(fields, \"linked.tests\");\n  const includeLinkedDocs = includeLinked || fieldsInclude(fields, \"linked.docs\");\n  const includeClaimState = !fieldProjection ? depth !== \"brief\" : fieldsIncludeRoot(fields, \"claim_state\");\n  let claimState: ClaimStateContext | undefined;\n  if (includeClaimState) {\n    const historyPath = getHistoryPath(pmRoot, located.id);\n    let history: ClaimHistoryEntry[] = [];\n    try {\n      history = await readHistoryEntries(historyPath, located.id);\n    } catch {\n      history = [];\n    }\n    claimState = resolveClaimStateContext(loaded.document.metadata.assignee, history);\n  }\n  const result: GetResult = {\n    item: fieldProjection\n      ? projectItemForFields(loaded.document.metadata, fields)\n      : projectItemForDepth(loaded.document.metadata, depth),\n  };\n  if (includeBody) {\n    result.body = loaded.document.body;\n  }\n  if (includeLinked || includeLinkedFiles || includeLinkedTests || includeLinkedDocs) {\n    result.linked = {\n      files: includeLinkedFiles ? files : [],\n      tests: includeLinkedTests ? tests : [],\n      docs: includeLinkedDocs ? docs : [],\n    };\n  }\n  if (claimState) {\n    result.claim_state = claimState;\n  }\n  if (options.tree === true) {\n    const { runList } = await import(\"./list.js\");\n    const subtree = await runList(\n      undefined,\n      {\n        parent: located.id,\n        tree: true,\n        treeDepth: treeDepth === undefined ? undefined : String(treeDepth),\n        full: true,\n      },\n      global,\n    );\n    result.tree = {\n      root_id: located.id,\n      root_title: loaded.document.metadata.title,\n      depth_limit: treeDepth ?? null,\n      count: subtree.count,\n      items: subtree.items.map((entry) => toItemRecord(entry)),\n    };\n  }\n  return result;\n}\n"],"names":[],"mappings":"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","debugId":"8d05da97-b537-5f04-9c8b-7b8ebdb34993"}

package/dist/cli-bundle/chunks/{get-WXU6WI5P.js → get-WXSLXV3K.js}

@@ -1,20 +1,22 @@
 import {
   readHistoryEntries
-} from "./chunk-PRJCELV4.js";
-import "./chunk-UM2GBHS4.js";
-import "./chunk-WKY2IBOQ.js";
+} from "./chunk-2YPVCD7T.js";
+import "./chunk-MSH23UWO.js";
+import {
+  parseIntegerLimit
+} from "./chunk-FGRJZVXD.js";
 import {
   buildItemNotFoundError,
   locateItem,
   readLocatedItem,
   toItemRecord
-} from "./chunk-XTGLRY2Y.js";
-import "./chunk-T3LC5LKB.js";
-import "./chunk-AO442XLN.js";
+} from "./chunk-2HMD3JM2.js";
+import "./chunk-K62SNVVE.js";
+import "./chunk-M7UBTVFT.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-KJE2FOS4.js";
-import "./chunk-QO7EBBOM.js";
+} from "./chunk-2BYKYPWY.js";
+import "./chunk-QFVASU44.js";
 import {
   EXIT_CODE,
   FRONT_MATTER_KEY_ORDER,
@@ -26,13 +28,13 @@ import {
   readSettings,
   resolvePmRoot,
   resolveRuntimeFieldRegistry
-} from "./chunk-U5SXYXSY.js";
+} from "./chunk-3TXWDGPU.js";
 
 // dist/cli/commands/get.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] = "808844af-e84f-5fd7-97c3-e4c81ff86193");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "a8eb7675-53ef-5cf4-a41e-4eb9f5b44a5c");
   } catch (e2) {
   }
 })();
@@ -134,7 +136,11 @@ async function runGet(id, global2, options = {}) {
   if (options.full && (options.fields !== void 0 || options.depth !== void 0)) {
     throw new PmCliError("Get projection options are mutually exclusive; remove the extra projection flag and retry.", EXIT_CODE.USAGE);
   }
+  if (options.tree !== true && options.treeDepth !== void 0) {
+    throw new PmCliError("Get --tree-depth requires --tree", EXIT_CODE.USAGE);
+  }
   const depth = options.full ? "deep" : parseGetDepth(options.depth);
+  const treeDepth = options.tree === true ? parseIntegerLimit(options.treeDepth, "--tree-depth") : void 0;
   const fields = parseGetFields(options.fields);
   const pmRoot = resolvePmRoot(process.cwd(), global2.path);
   if (!await pathExists(getSettingsPath(pmRoot))) {
@@ -189,9 +195,25 @@ async function runGet(id, global2, options = {}) {
   if (claimState) {
     result.claim_state = claimState;
   }
+  if (options.tree === true) {
+    const { runList } = await import("./list-7MTPPZHC.js");
+    const subtree = await runList(void 0, {
+      parent: located.id,
+      tree: true,
+      treeDepth: treeDepth === void 0 ? void 0 : String(treeDepth),
+      full: true
+    }, global2);
+    result.tree = {
+      root_id: located.id,
+      root_title: loaded.document.metadata.title,
+      depth_limit: treeDepth ?? null,
+      count: subtree.count,
+      items: subtree.items.map((entry) => toItemRecord(entry))
+    };
+  }
   return result;
 }
 export {
   runGet
 };
-//# sourceMappingURL=get-WXU6WI5P.js.map
+//# sourceMappingURL=get-WXSLXV3K.js.map