@cleocode/core 2026.4.98 → 2026.4.100

package/dist/gc/transcript.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/gc/transcript.ts", "../../src/gc/runner.ts"],
+  "sourcesContent": ["/**\n * Transcript Scanner \u2014 Inventory and age-classification of Claude session transcripts.\n *\n * Implements the hot/warm/cold three-tier model from memory-architecture-spec.md \u00A76:\n * - HOT  (0\u201324h):  Full JSONL retained; agents can re-read\n * - WARM (1\u20137d):   Pending extraction; scheduled at session end\n * - COLD (>7d):    brain.db entries only; raw JSONL deleted (tombstone in brain_obs)\n *\n * Storage layout scanned (\u00A76.2):\n * ```\n * ~/.claude/projects/\n *   <project-slug>/\n *     <session-uuid>.jsonl              \u2190 root-level main session transcript\n *     <session-uuid>/                   \u2190 session UUID directory\n *       subagents/\n *         agent-<agentId>.jsonl         \u2190 subagent transcript\n *         agent-<agentId>.meta.json\n *       tool-results/\n *         <toolUseId>.json\n * ```\n *\n * @see docs/specs/memory-architecture-spec.md \u00A76.1\u20136.2\n * @task T728\n * @epic T726\n */\n\nimport { lstat, readdir, stat } from 'node:fs/promises';\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\nimport { getPathBytes, idempotentRm } from './runner.js';\n\n// ---------------------------------------------------------------------------\n// Tier boundaries (in milliseconds)\n// ---------------------------------------------------------------------------\n\n/** HOT tier: sessions less than 24 hours old. */\nconst HOT_MAX_MS = 24 * 60 * 60 * 1000;\n\n/** WARM tier: sessions 24h\u20137d old. */\nconst WARM_MAX_MS = 7 * 24 * 60 * 60 * 1000;\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Hot/warm/cold lifecycle tier for a transcript session. */\nexport type TranscriptTier = 'hot' | 'warm' | 'cold';\n\n/**\n * Metadata for a single session transcript discovered on disk.\n */\nexport interface SessionInfo {\n  /** Absolute path to the root session JSONL file. */\n  jsonlPath: string;\n  /** Project slug (directory name under `~/.claude/projects/`). */\n  projectSlug: string;\n  /** Session UUID extracted from the JSONL filename. */\n  sessionId: string;\n  /** Last modified time of the JSONL file (ms since epoch). */\n  mtimeMs: number;\n  /** Age of the session in milliseconds. */\n  ageMs: number;\n  /** Lifecycle tier. */\n  tier: TranscriptTier;\n  /** Size in bytes of the root JSONL file. */\n  bytes: number;\n  /**\n   * Absolute path to the session UUID directory (if it exists).\n   * Contains `subagents/` and `tool-results/` subdirs.\n   */\n  sessionDir: string | null;\n  /** Size in bytes of the session UUID directory (including subagents). */\n  sessionDirBytes: number;\n}\n\n/**\n * Aggregate scan result: session inventory with tier-based grouping.\n */\nexport interface TranscriptScanResult {\n  /** Total number of sessions found. */\n  totalSessions: number;\n  /** HOT tier sessions (< 24h). */\n  hot: SessionInfo[];\n  /** WARM tier sessions (24h\u20137d). */\n  warm: SessionInfo[];\n  /** Total size of all discovered transcripts in bytes. */\n  totalBytes: number;\n  /** Absolute path to `~/.claude/projects/`. */\n  projectsDir: string;\n}\n\n/**\n * Result of a transcript prune operation.\n */\nexport interface TranscriptPruneResult {\n  /** Number of sessions pruned. */\n  pruned: number;\n  /** Bytes freed. */\n  bytesFreed: number;\n  /** Paths that were deleted (or would be deleted in dry-run). */\n  deletedPaths: string[];\n  /** Whether this was a dry-run (no filesystem mutations). */\n  dryRun: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Classify a session age into a transcript tier.\n *\n * @param ageMs - Session age in milliseconds\n * @returns Lifecycle tier\n */\nexport function classifyTranscriptTier(ageMs: number): TranscriptTier {\n  if (ageMs < HOT_MAX_MS) return 'hot';\n  if (ageMs < WARM_MAX_MS) return 'warm';\n  return 'cold';\n}\n\n/**\n * Parse a session UUID from a JSONL filename.\n *\n * Expected format: `<uuid>.jsonl` where uuid matches the standard\n * UUID v4 pattern (8-4-4-4-12 hex digits).\n *\n * @param filename - JSONL filename (basename only)\n * @returns Session UUID string, or the filename stem if not UUID format\n */\nfunction parseSessionId(filename: string): string {\n  return filename.replace(/\\.jsonl$/, '');\n}\n\n// ---------------------------------------------------------------------------\n// Core operations\n// ---------------------------------------------------------------------------\n\n/**\n * Scan `~/.claude/projects/` and return a structured inventory of all\n * session transcripts, classified by hot/warm/cold tier.\n *\n * Does not modify any files. Safe to call at any time.\n *\n * @param projectsDir - Override the default `~/.claude/projects/` path (for testing)\n * @returns Transcript scan result with tier-classified session list\n */\nexport async function scanTranscripts(projectsDir?: string): Promise<TranscriptScanResult> {\n  const resolvedProjectsDir = projectsDir ?? join(homedir(), '.claude', 'projects');\n  const now = Date.now();\n\n  const hot: SessionInfo[] = [];\n  const warm: SessionInfo[] = [];\n  let totalBytes = 0;\n\n  // List project slugs\n  let slugs: string[];\n  try {\n    const entries = await readdir(resolvedProjectsDir, { withFileTypes: true });\n    slugs = entries.filter((e) => e.isDirectory()).map((e) => e.name);\n  } catch {\n    // Directory doesn't exist yet \u2014 return empty result\n    return { totalSessions: 0, hot, warm, totalBytes, projectsDir: resolvedProjectsDir };\n  }\n\n  for (const slug of slugs) {\n    const slugDir = join(resolvedProjectsDir, slug);\n\n    let entries: import('fs').Dirent[];\n    try {\n      entries = await readdir(slugDir, { withFileTypes: true });\n    } catch {\n      continue;\n    }\n\n    for (const entry of entries) {\n      if (!entry.isFile() || !entry.name.endsWith('.jsonl')) continue;\n\n      const jsonlPath = join(slugDir, entry.name);\n      const sessionId = parseSessionId(entry.name);\n\n      let fileInfo: import('fs').Stats;\n      try {\n        fileInfo = await stat(jsonlPath);\n      } catch {\n        continue; // File disappeared between readdir and stat\n      }\n\n      const mtimeMs = fileInfo.mtimeMs;\n      const ageMs = now - mtimeMs;\n      const tier = classifyTranscriptTier(ageMs);\n      const bytes = fileInfo.size;\n\n      // Check for associated session UUID directory\n      const candidateSessionDir = join(slugDir, sessionId);\n      let sessionDir: string | null = null;\n      let sessionDirBytes = 0;\n      try {\n        const dirInfo = await lstat(candidateSessionDir);\n        if (dirInfo.isDirectory()) {\n          sessionDir = candidateSessionDir;\n          sessionDirBytes = await getPathBytes(candidateSessionDir);\n        }\n      } catch {\n        // Session dir doesn't exist \u2014 single-file session\n      }\n\n      const info: SessionInfo = {\n        jsonlPath,\n        projectSlug: slug,\n        sessionId,\n        mtimeMs,\n        ageMs,\n        tier,\n        bytes,\n        sessionDir,\n        sessionDirBytes,\n      };\n\n      totalBytes += bytes + sessionDirBytes;\n\n      if (tier === 'hot') {\n        hot.push(info);\n      } else if (tier === 'warm') {\n        warm.push(info);\n      }\n      // COLD sessions have already had their JSONL deleted (tombstone only in brain.db)\n      // so they won't appear in the filesystem scan\n    }\n  }\n\n  const totalSessions = hot.length + warm.length;\n  return { totalSessions, hot, warm, totalBytes, projectsDir: resolvedProjectsDir };\n}\n\n/**\n * Prune session transcripts older than `olderThanMs` milliseconds.\n *\n * Dry-run by default: pass `confirm: true` to perform actual deletion.\n *\n * Circuit breakers (from memory-architecture-spec.md \u00A76.4):\n * - If `ANTHROPIC_API_KEY` is absent, only delete sessions older than 30d\n *   (raw preservation fallback \u2014 skip extraction).\n *\n * @param opts - Prune options\n * @param opts.olderThanMs - Delete sessions older than this many milliseconds\n * @param opts.confirm - If true, perform actual deletion; dry-run if false\n * @param opts.projectsDir - Override `~/.claude/projects/` (for testing)\n * @returns Prune result with count, bytes freed, and deleted paths\n */\nexport async function pruneTranscripts(opts: {\n  olderThanMs: number;\n  confirm: boolean;\n  projectsDir?: string;\n}): Promise<TranscriptPruneResult> {\n  const { olderThanMs, confirm, projectsDir } = opts;\n  const dryRun = !confirm;\n\n  // Circuit breaker: no API key \u2192 be conservative (only prune >30d)\n  const hasApiKey = Boolean(process.env['ANTHROPIC_API_KEY']);\n  const effectiveMaxAgeMs = hasApiKey\n    ? olderThanMs\n    : Math.max(olderThanMs, 30 * 24 * 60 * 60 * 1000);\n\n  const now = Date.now();\n  const deletedPaths: string[] = [];\n  let bytesFreed = 0;\n  let pruned = 0;\n\n  const resolvedProjectsDir = projectsDir ?? join(homedir(), '.claude', 'projects');\n\n  let slugs: string[];\n  try {\n    const entries = await readdir(resolvedProjectsDir, { withFileTypes: true });\n    slugs = entries.filter((e) => e.isDirectory()).map((e) => e.name);\n  } catch {\n    return { pruned: 0, bytesFreed: 0, deletedPaths: [], dryRun };\n  }\n\n  for (const slug of slugs) {\n    const slugDir = join(resolvedProjectsDir, slug);\n\n    let entries: import('fs').Dirent[];\n    try {\n      entries = await readdir(slugDir, { withFileTypes: true });\n    } catch {\n      continue;\n    }\n\n    for (const entry of entries) {\n      if (!entry.isFile() || !entry.name.endsWith('.jsonl')) continue;\n\n      const jsonlPath = join(slugDir, entry.name);\n\n      let fileInfo: import('fs').Stats;\n      try {\n        fileInfo = await stat(jsonlPath);\n      } catch {\n        continue;\n      }\n\n      const ageMs = now - fileInfo.mtimeMs;\n      if (ageMs <= effectiveMaxAgeMs) continue;\n\n      const sessionId = parseSessionId(entry.name);\n      const sessionDir = join(slugDir, sessionId);\n\n      // Measure bytes before deletion\n      const jsonlBytes = fileInfo.size;\n      let sessionDirBytes = 0;\n      try {\n        const dirInfo = await lstat(sessionDir);\n        if (dirInfo.isDirectory()) {\n          sessionDirBytes = await getPathBytes(sessionDir);\n        }\n      } catch {\n        // No session dir\n      }\n\n      if (dryRun) {\n        deletedPaths.push(jsonlPath);\n        if (sessionDirBytes > 0) deletedPaths.push(sessionDir);\n        bytesFreed += jsonlBytes + sessionDirBytes;\n        pruned++;\n        continue;\n      }\n\n      // Actual deletion\n      try {\n        await idempotentRm(jsonlPath);\n        deletedPaths.push(jsonlPath);\n        bytesFreed += jsonlBytes;\n        pruned++;\n      } catch {\n        // Deletion failure: skip this file\n        continue;\n      }\n\n      // Delete associated session directory if it exists\n      try {\n        const dirInfo = await lstat(sessionDir);\n        if (dirInfo.isDirectory()) {\n          await idempotentRm(sessionDir);\n          deletedPaths.push(sessionDir);\n          bytesFreed += sessionDirBytes;\n        }\n      } catch {\n        // No session dir or already deleted\n      }\n    }\n  }\n\n  return { pruned, bytesFreed, deletedPaths, dryRun };\n}\n\n/**\n * Parse a human-readable duration string into milliseconds.\n *\n * Supported formats: `7d`, `24h`, `30m`, `1d`, `14d`, `168h`, etc.\n * Used by `cleo transcript prune --older-than <duration>`.\n *\n * @param duration - Duration string (e.g. `\"7d\"`, `\"24h\"`, `\"30m\"`)\n * @returns Duration in milliseconds\n * @throws Error if the format is not recognized\n */\nexport function parseDurationMs(duration: string): number {\n  const match = /^(\\d+(\\.\\d+)?)(d|h|m|s)$/.exec(duration.trim());\n  if (!match?.[1] || !match[3]) {\n    throw new Error(`Invalid duration format: \"${duration}\". Use format like 7d, 24h, 30m, 60s.`);\n  }\n  const value = parseFloat(match[1]);\n  const unit = match[3];\n  const multipliers: Record<string, number> = {\n    d: 24 * 60 * 60 * 1000,\n    h: 60 * 60 * 1000,\n    m: 60 * 1000,\n    s: 1000,\n  };\n  return value * (multipliers[unit] ?? 1000);\n}\n", "/**\n * GC Runner \u2014 Core garbage collection logic for autonomous transcript cleanup.\n *\n * Performs disk-pressure-aware pruning of ephemeral transcript and temp files\n * under `~/.claude/projects/` using the five-tier threshold model from T751.\n *\n * Retention policy (per ADR-047 and docs/specs/memory-architecture-spec.md \u00A78):\n * - `.temp/` files: 24h normal, 1h emergency\n * - Transcript directories (agent-*.jsonl, tool-results/): 7d normal, 1d emergency\n * - `.cleo/logs/`: 30d normal, 7d emergency\n * - `.cleo/agent-outputs/*.md` (committed artifacts): NEVER auto-pruned\n *\n * Circuit breaker: if `ANTHROPIC_API_KEY` is absent AND no local model configured,\n * skip extraction and only delete transcripts older than 30 days.\n *\n * @see ADR-047 \u2014 Autonomous GC and Disk Safety\n * @see docs/specs/memory-architecture-spec.md \u00A78\n * @task T731\n * @epic T726\n */\n\nimport { lstat, readdir, rm, stat } from 'node:fs/promises';\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\nimport checkDiskSpaceModule from 'check-disk-space';\n\n/**\n * Checks free + total bytes on the filesystem containing the given path.\n *\n * `check-disk-space@3.4.0` publishes its function as `export { x as default }`\n * in the .d.ts, which TS 6.0 strict resolution treats as a namespaced re-export\n * rather than a callable default. The runtime module itself exposes a callable;\n * we bridge the type gap by typing `checkDiskSpaceModule` as the callable\n * shape at the single import boundary.\n */\nconst checkDiskSpace = checkDiskSpaceModule as unknown as (path: string) => Promise<{\n  diskPath: string;\n  free: number;\n  size: number;\n}>;\n\nimport { patchGCState, readGCState } from './state.js';\n\n// ---------------------------------------------------------------------------\n// Threshold Tiers (from T751 \u00A73.2 and ADR-047)\n// ---------------------------------------------------------------------------\n\n/**\n * Disk usage percentage thresholds.\n *\n * Values mirror the five-tier model recommended by T751 research \u00A73.2:\n * - OK:        < 70% \u2014 routine cleanup by age policy only\n * - WATCH:    70-85% \u2014 log + schedule next GC sooner\n * - WARN:     85-90% \u2014 log + set escalation flag for next CLI invocation\n * - URGENT:   90-95% \u2014 auto-prune oldest transcripts immediately\n * - EMERGENCY: \u2265 95% \u2014 auto-prune all transcripts > 1d, pause new writes\n */\nexport const DISK_THRESHOLDS = {\n  WATCH: 70,\n  WARN: 85,\n  URGENT: 90,\n  EMERGENCY: 95,\n} as const;\n\n/** Human-readable tier labels. */\nexport type DiskTier = 'ok' | 'watch' | 'warn' | 'urgent' | 'emergency';\n\n/**\n * Result of a single GC run.\n */\nexport interface GCResult {\n  /** Disk usage percentage at time of GC run (0\u2013100). */\n  diskUsedPct: number;\n  /** Disk tier classification. */\n  threshold: DiskTier;\n  /** Files pruned during this run. */\n  pruned: Array<{ path: string; bytes: number }>;\n  /** Total bytes freed. */\n  bytesFreed: number;\n  /** Whether escalation flag was set (disk \u2265 WARN). */\n  escalationSet: boolean;\n  /** Human-readable escalation reason (set when escalationSet=true). */\n  escalationReason: string | null;\n  /** ISO-8601 timestamp of run completion. */\n  completedAt: string;\n}\n\n/**\n * Options for a GC run.\n */\nexport interface GCRunOptions {\n  /**\n   * Absolute path to the `.cleo/` directory (used for state file and disk check).\n   * Defaults to `~/.cleo`.\n   */\n  cleoDir?: string;\n  /**\n   * Override the default `~/.claude/projects/` scan directory.\n   * Primarily used in tests to point at a temp directory.\n   */\n  projectsDir?: string;\n  /**\n   * Paths from a previous crashed run to resume deletion from.\n   * Written to `pendingPrune` in gc-state.json BEFORE starting deletion.\n   */\n  resumeFrom?: string[];\n  /**\n   * Dry-run mode: compute what would be pruned, but make zero filesystem changes.\n   */\n  dryRun?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Classify a disk usage percentage into a tier.\n *\n * @param pct - Disk usage percentage (0\u2013100)\n * @returns DiskTier\n */\nexport function classifyDiskTier(pct: number): DiskTier {\n  if (pct >= DISK_THRESHOLDS.EMERGENCY) return 'emergency';\n  if (pct >= DISK_THRESHOLDS.URGENT) return 'urgent';\n  if (pct >= DISK_THRESHOLDS.WARN) return 'warn';\n  if (pct >= DISK_THRESHOLDS.WATCH) return 'watch';\n  return 'ok';\n}\n\n/**\n * Compute retention threshold in milliseconds based on disk tier.\n *\n * Higher disk pressure \u2192 shorter retention \u2192 more aggressive pruning.\n *\n * @param tier - Current disk tier\n * @returns Maximum age in milliseconds for transcript retention\n */\nexport function retentionMs(tier: DiskTier): number {\n  switch (tier) {\n    case 'emergency':\n      return 1 * 24 * 60 * 60 * 1000; // 1 day\n    case 'urgent':\n      return 3 * 24 * 60 * 60 * 1000; // 3 days\n    case 'warn':\n      return 7 * 24 * 60 * 60 * 1000; // 7 days\n    default:\n      return 30 * 24 * 60 * 60 * 1000; // 30 days (watch + ok)\n  }\n}\n\n/**\n * Get the size of a path in bytes (file or directory recursively).\n * Returns 0 if the path does not exist.\n *\n * @param targetPath - Path to measure\n * @returns Size in bytes\n */\nexport async function getPathBytes(targetPath: string): Promise<number> {\n  try {\n    const info = await lstat(targetPath);\n    if (info.isFile()) return info.size;\n    if (!info.isDirectory()) return 0;\n\n    const entries = await readdir(targetPath, { withFileTypes: true });\n    let total = 0;\n    for (const entry of entries) {\n      total += await getPathBytes(join(targetPath, entry.name));\n    }\n    return total;\n  } catch {\n    return 0;\n  }\n}\n\n/**\n * Idempotently delete a path (file or directory).\n *\n * Silently ignores ENOENT \u2014 safe to call if path was already deleted.\n * Uses `force: true` to suppress errors on missing paths.\n *\n * @param targetPath - Path to delete\n */\nexport async function idempotentRm(targetPath: string): Promise<void> {\n  try {\n    await rm(targetPath, { recursive: true, force: true });\n  } catch (err) {\n    const nodeErr = err as NodeJS.ErrnoException;\n    if (nodeErr.code === 'ENOENT') return; // already gone \u2014 idempotent\n    throw err;\n  }\n}\n\n/**\n * Gather transcript session directories under `~/.claude/projects/` that are\n * older than `maxAgeMs`.\n *\n * Only session UUID directories are candidates (not the root JSONL files \u2014\n * those are the main transcript). The `tool-results/` subdirectory within a\n * session directory is always included in the prune candidate once the session\n * is old enough.\n *\n * Committed artifact files (`.cleo/agent-outputs/*.md`) are NEVER included.\n *\n * @param maxAgeMs - Maximum age in ms; sessions older than this are candidates\n * @returns Array of absolute directory paths eligible for pruning\n */\nasync function gatherPruneCandidates(maxAgeMs: number, projectsDir?: string): Promise<string[]> {\n  const resolvedProjectsDir = projectsDir ?? join(homedir(), '.claude', 'projects');\n  const candidates: string[] = [];\n  const now = Date.now();\n\n  let projectSlugs: string[];\n  try {\n    const entries = await readdir(resolvedProjectsDir, { withFileTypes: true });\n    projectSlugs = entries.filter((e) => e.isDirectory()).map((e) => e.name);\n  } catch {\n    // ~/.claude/projects/ doesn't exist yet\n    return candidates;\n  }\n\n  for (const slug of projectSlugs) {\n    const slugDir = join(resolvedProjectsDir, slug);\n\n    // Collect root JSONL files (HOT/WARM main session transcripts)\n    let slugEntries: import('fs').Dirent[];\n    try {\n      slugEntries = await readdir(slugDir, { withFileTypes: true });\n    } catch {\n      continue;\n    }\n\n    for (const entry of slugEntries) {\n      const entryPath = join(slugDir, entry.name);\n\n      if (entry.isFile() && entry.name.endsWith('.jsonl')) {\n        // Root-level session JSONL \u2014 check age\n        try {\n          const info = await stat(entryPath);\n          const ageMs = now - info.mtimeMs;\n          if (ageMs > maxAgeMs) {\n            candidates.push(entryPath);\n          }\n        } catch {\n          // File disappeared between readdir and stat \u2014 skip\n        }\n      } else if (entry.isDirectory()) {\n        // Session UUID directory \u2014 check mtime of the directory itself\n        try {\n          const info = await stat(entryPath);\n          const ageMs = now - info.mtimeMs;\n          if (ageMs > maxAgeMs) {\n            candidates.push(entryPath);\n          }\n        } catch {\n          // Directory disappeared \u2014 skip\n        }\n      }\n    }\n  }\n\n  return candidates;\n}\n\n// ---------------------------------------------------------------------------\n// Main GC Runner\n// ---------------------------------------------------------------------------\n\n/**\n * Execute a GC run: check disk pressure, determine retention threshold,\n * prune eligible transcript files, update gc-state.json.\n *\n * This function is idempotent and safe to call multiple times. Crash recovery\n * is implemented via the `pendingPrune` field in gc-state.json:\n * 1. Write paths to `pendingPrune` BEFORE starting deletion\n * 2. Remove each path from `pendingPrune` AFTER successful deletion\n * 3. Clear `pendingPrune` when the job completes\n *\n * @param opts - GC run options\n * @returns GC run results\n */\nexport async function runGC(opts: GCRunOptions = {}): Promise<GCResult> {\n  const cleoDir = opts.cleoDir ?? join(homedir(), '.cleo');\n  const statePath = join(cleoDir, 'gc-state.json');\n  const dryRun = opts.dryRun ?? false;\n  const projectsDir = opts.projectsDir;\n\n  // Step 1: Crash recovery \u2014 resume any pending prune from prior run\n  const initialState = await readGCState(statePath);\n  const resumePaths = opts.resumeFrom ?? initialState.pendingPrune ?? [];\n\n  // Step 2: Check disk space on the filesystem containing .cleo/\n  let diskUsedPct = 0;\n  try {\n    const { free, size } = await checkDiskSpace(cleoDir);\n    diskUsedPct = size > 0 ? ((size - free) / size) * 100 : 0;\n  } catch {\n    // Disk check failure is non-fatal; proceed with default tier\n    diskUsedPct = 0;\n  }\n\n  const tier = classifyDiskTier(diskUsedPct);\n  const maxAgeMs = retentionMs(tier);\n\n  // Step 3: Gather prune candidates\n  const candidatesFromScan =\n    resumePaths.length > 0 ? resumePaths : await gatherPruneCandidates(maxAgeMs, projectsDir);\n\n  // Step 4: Write pendingPrune to state BEFORE any deletion (crash-safe)\n  if (!dryRun && candidatesFromScan.length > 0) {\n    await patchGCState(statePath, { pendingPrune: candidatesFromScan });\n  }\n\n  // Step 5: Delete candidates and accumulate results\n  const pruned: GCResult['pruned'] = [];\n  let bytesFreed = 0;\n  const remaining = [...candidatesFromScan];\n\n  for (const candidatePath of candidatesFromScan) {\n    const bytes = await getPathBytes(candidatePath);\n\n    if (dryRun) {\n      // Dry run: record what would be deleted, make no changes\n      pruned.push({ path: candidatePath, bytes });\n      bytesFreed += bytes;\n      continue;\n    }\n\n    try {\n      await idempotentRm(candidatePath);\n      pruned.push({ path: candidatePath, bytes });\n      bytesFreed += bytes;\n      // Remove successfully-deleted path from the pending list\n      const idx = remaining.indexOf(candidatePath);\n      if (idx !== -1) remaining.splice(idx, 1);\n      // Persist updated pendingPrune after each deletion (crash-safe)\n      await patchGCState(statePath, {\n        pendingPrune: remaining.length > 0 ? remaining : null,\n      });\n    } catch {\n      // Deletion failure: leave in pendingPrune for next run\n    }\n  }\n\n  // Step 6: Determine escalation state\n  const escalationSet = tier === 'warn' || tier === 'urgent' || tier === 'emergency';\n  let escalationReason: string | null = null;\n  if (escalationSet) {\n    escalationReason = `Disk at ${diskUsedPct.toFixed(1)}% (${tier.toUpperCase()}): ${pruned.length} paths pruned, ${bytesFreed} bytes freed`;\n  }\n\n  const completedAt = new Date().toISOString();\n\n  // Step 7: Update gc-state.json with run results\n  if (!dryRun) {\n    await patchGCState(statePath, {\n      lastRunAt: completedAt,\n      lastRunResult: remaining.length === 0 ? 'success' : 'partial',\n      lastRunBytesFreed: bytesFreed,\n      pendingPrune: remaining.length > 0 ? remaining : null,\n      consecutiveFailures: remaining.length > 0 ? initialState.consecutiveFailures + 1 : 0,\n      diskThresholdBreached: diskUsedPct >= DISK_THRESHOLDS.WATCH,\n      lastDiskUsedPct: diskUsedPct,\n      escalationNeeded: escalationSet || initialState.escalationNeeded,\n      escalationReason: escalationReason ?? initialState.escalationReason,\n    });\n  }\n\n  return {\n    diskUsedPct,\n    threshold: tier,\n    pruned,\n    bytesFreed,\n    escalationSet,\n    escalationReason,\n    completedAt,\n  };\n}\n"],
+  "mappings": ";AA0BA,SAAS,SAAAA,QAAO,WAAAC,UAAS,QAAAC,aAAY;AACrC,SAAS,eAAe;AACxB,SAAS,QAAAC,aAAY;;;ACPrB,SAAS,OAAO,SAAS,IAAI,YAAY;AAEzC,SAAS,YAAY;AAuIrB,eAAsB,aAAa,YAAqC;AACtE,MAAI;AACF,UAAM,OAAO,MAAM,MAAM,UAAU;AACnC,QAAI,KAAK,OAAO,EAAG,QAAO,KAAK;AAC/B,QAAI,CAAC,KAAK,YAAY,EAAG,QAAO;AAEhC,UAAM,UAAU,MAAM,QAAQ,YAAY,EAAE,eAAe,KAAK,CAAC;AACjE,QAAI,QAAQ;AACZ,eAAW,SAAS,SAAS;AAC3B,eAAS,MAAM,aAAa,KAAK,YAAY,MAAM,IAAI,CAAC;AAAA,IAC1D;AACA,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAUA,eAAsB,aAAa,YAAmC;AACpE,MAAI;AACF,UAAM,GAAG,YAAY,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAAA,EACvD,SAAS,KAAK;AACZ,UAAM,UAAU;AAChB,QAAI,QAAQ,SAAS,SAAU;AAC/B,UAAM;AAAA,EACR;AACF;;;AD3JA,IAAM,aAAa,KAAK,KAAK,KAAK;AAGlC,IAAM,cAAc,IAAI,KAAK,KAAK,KAAK;AA4EhC,SAAS,uBAAuB,OAA+B;AACpE,MAAI,QAAQ,WAAY,QAAO;AAC/B,MAAI,QAAQ,YAAa,QAAO;AAChC,SAAO;AACT;AAWA,SAAS,eAAe,UAA0B;AAChD,SAAO,SAAS,QAAQ,YAAY,EAAE;AACxC;AAeA,eAAsB,gBAAgB,aAAqD;AACzF,QAAM,sBAAsB,eAAeC,MAAK,QAAQ,GAAG,WAAW,UAAU;AAChF,QAAM,MAAM,KAAK,IAAI;AAErB,QAAM,MAAqB,CAAC;AAC5B,QAAM,OAAsB,CAAC;AAC7B,MAAI,aAAa;AAGjB,MAAI;AACJ,MAAI;AACF,UAAM,UAAU,MAAMC,SAAQ,qBAAqB,EAAE,eAAe,KAAK,CAAC;AAC1E,YAAQ,QAAQ,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI;AAAA,EAClE,QAAQ;AAEN,WAAO,EAAE,eAAe,GAAG,KAAK,MAAM,YAAY,aAAa,oBAAoB;AAAA,EACrF;AAEA,aAAW,QAAQ,OAAO;AACxB,UAAM,UAAUD,MAAK,qBAAqB,IAAI;AAE9C,QAAI;AACJ,QAAI;AACF,gBAAU,MAAMC,SAAQ,SAAS,EAAE,eAAe,KAAK,CAAC;AAAA,IAC1D,QAAQ;AACN;AAAA,IACF;AAEA,eAAW,SAAS,SAAS;AAC3B,UAAI,CAAC,MAAM,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,QAAQ,EAAG;AAEvD,YAAM,YAAYD,MAAK,SAAS,MAAM,IAAI;AAC1C,YAAM,YAAY,eAAe,MAAM,IAAI;AAE3C,UAAI;AACJ,UAAI;AACF,mBAAW,MAAME,MAAK,SAAS;AAAA,MACjC,QAAQ;AACN;AAAA,MACF;AAEA,YAAM,UAAU,SAAS;AACzB,YAAM,QAAQ,MAAM;AACpB,YAAM,OAAO,uBAAuB,KAAK;AACzC,YAAM,QAAQ,SAAS;AAGvB,YAAM,sBAAsBF,MAAK,SAAS,SAAS;AACnD,UAAI,aAA4B;AAChC,UAAI,kBAAkB;AACtB,UAAI;AACF,cAAM,UAAU,MAAMG,OAAM,mBAAmB;AAC/C,YAAI,QAAQ,YAAY,GAAG;AACzB,uBAAa;AACb,4BAAkB,MAAM,aAAa,mBAAmB;AAAA,QAC1D;AAAA,MACF,QAAQ;AAAA,MAER;AAEA,YAAM,OAAoB;AAAA,QACxB;AAAA,QACA,aAAa;AAAA,QACb;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAEA,oBAAc,QAAQ;AAEtB,UAAI,SAAS,OAAO;AAClB,YAAI,KAAK,IAAI;AAAA,MACf,WAAW,SAAS,QAAQ;AAC1B,aAAK,KAAK,IAAI;AAAA,MAChB;AAAA,IAGF;AAAA,EACF;AAEA,QAAM,gBAAgB,IAAI,SAAS,KAAK;AACxC,SAAO,EAAE,eAAe,KAAK,MAAM,YAAY,aAAa,oBAAoB;AAClF;AAiBA,eAAsB,iBAAiB,MAIJ;AACjC,QAAM,EAAE,aAAa,SAAS,YAAY,IAAI;AAC9C,QAAM,SAAS,CAAC;AAGhB,QAAM,YAAY,QAAQ,QAAQ,IAAI,mBAAmB,CAAC;AAC1D,QAAM,oBAAoB,YACtB,cACA,KAAK,IAAI,aAAa,KAAK,KAAK,KAAK,KAAK,GAAI;AAElD,QAAM,MAAM,KAAK,IAAI;AACrB,QAAM,eAAyB,CAAC;AAChC,MAAI,aAAa;AACjB,MAAI,SAAS;AAEb,QAAM,sBAAsB,eAAeH,MAAK,QAAQ,GAAG,WAAW,UAAU;AAEhF,MAAI;AACJ,MAAI;AACF,UAAM,UAAU,MAAMC,SAAQ,qBAAqB,EAAE,eAAe,KAAK,CAAC;AAC1E,YAAQ,QAAQ,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI;AAAA,EAClE,QAAQ;AACN,WAAO,EAAE,QAAQ,GAAG,YAAY,GAAG,cAAc,CAAC,GAAG,OAAO;AAAA,EAC9D;AAEA,aAAW,QAAQ,OAAO;AACxB,UAAM,UAAUD,MAAK,qBAAqB,IAAI;AAE9C,QAAI;AACJ,QAAI;AACF,gBAAU,MAAMC,SAAQ,SAAS,EAAE,eAAe,KAAK,CAAC;AAAA,IAC1D,QAAQ;AACN;AAAA,IACF;AAEA,eAAW,SAAS,SAAS;AAC3B,UAAI,CAAC,MAAM,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,QAAQ,EAAG;AAEvD,YAAM,YAAYD,MAAK,SAAS,MAAM,IAAI;AAE1C,UAAI;AACJ,UAAI;AACF,mBAAW,MAAME,MAAK,SAAS;AAAA,MACjC,QAAQ;AACN;AAAA,MACF;AAEA,YAAM,QAAQ,MAAM,SAAS;AAC7B,UAAI,SAAS,kBAAmB;AAEhC,YAAM,YAAY,eAAe,MAAM,IAAI;AAC3C,YAAM,aAAaF,MAAK,SAAS,SAAS;AAG1C,YAAM,aAAa,SAAS;AAC5B,UAAI,kBAAkB;AACtB,UAAI;AACF,cAAM,UAAU,MAAMG,OAAM,UAAU;AACtC,YAAI,QAAQ,YAAY,GAAG;AACzB,4BAAkB,MAAM,aAAa,UAAU;AAAA,QACjD;AAAA,MACF,QAAQ;AAAA,MAER;AAEA,UAAI,QAAQ;AACV,qBAAa,KAAK,SAAS;AAC3B,YAAI,kBAAkB,EAAG,cAAa,KAAK,UAAU;AACrD,sBAAc,aAAa;AAC3B;AACA;AAAA,MACF;AAGA,UAAI;AACF,cAAM,aAAa,SAAS;AAC5B,qBAAa,KAAK,SAAS;AAC3B,sBAAc;AACd;AAAA,MACF,QAAQ;AAEN;AAAA,MACF;AAGA,UAAI;AACF,cAAM,UAAU,MAAMA,OAAM,UAAU;AACtC,YAAI,QAAQ,YAAY,GAAG;AACzB,gBAAM,aAAa,UAAU;AAC7B,uBAAa,KAAK,UAAU;AAC5B,wBAAc;AAAA,QAChB;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,QAAQ,YAAY,cAAc,OAAO;AACpD;AAYO,SAAS,gBAAgB,UAA0B;AACxD,QAAM,QAAQ,2BAA2B,KAAK,SAAS,KAAK,CAAC;AAC7D,MAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG;AAC5B,UAAM,IAAI,MAAM,6BAA6B,QAAQ,uCAAuC;AAAA,EAC9F;AACA,QAAM,QAAQ,WAAW,MAAM,CAAC,CAAC;AACjC,QAAM,OAAO,MAAM,CAAC;AACpB,QAAM,cAAsC;AAAA,IAC1C,GAAG,KAAK,KAAK,KAAK;AAAA,IAClB,GAAG,KAAK,KAAK;AAAA,IACb,GAAG,KAAK;AAAA,IACR,GAAG;AAAA,EACL;AACA,SAAO,SAAS,YAAY,IAAI,KAAK;AACvC;",
+  "names": ["lstat", "readdir", "stat", "join", "join", "readdir", "stat", "lstat"]
+}