prunify 0.1.5 → 0.1.6

package/README.md

@@ -28,7 +28,7 @@
 
 | Module | What it finds |
 |--------|---------------|
-| 🗑️ **Dead code** | Files and named exports that are never imported anywhere in the codebase |
+| 🗑️ **Dead code** | **Safe to delete** (nothing imports them), **transitively dead** (only dead files import them), and **dead exports** (live files with unused named exports) |
 | 🔁 **Duplicate code** | Functions with identical bodies, suspiciously similar names, and duplicate constants |
 | ♻️ **Circular imports** | Dependency cycles that can cause runtime bugs and bundler issues |
 | 📦 **Unused dependencies** | Packages declared in `package.json` that are never actually imported |
@@ -81,7 +81,7 @@ npx prunify --ci
 ✔ Parsed codebase — 142 file(s) found
 ✔ Import graph built — 389 edge(s)
 
-✔ Dead code analysis complete — 7 item(s) found
+✔ Dead code analysis complete — 3 safe to delete, 1 transitively dead, 3 dead export(s)
 ✔ Duplicate scan complete — 3 duplicate block(s) found
 ✔ Circular import analysis complete — 2 cycle(s) found
 ✔ Dependency audit complete — 4 issue(s) found
@@ -89,15 +89,15 @@ npx prunify --ci
 
 Summary
 
-┌──────────────────────┬───────┬──────────────────┐
-│ Check                │ Found │ Output File      │
-├──────────────────────┼───────┼──────────────────┤
-│ Dead Files / Exports │ 7     │ dead-code.txt    │
-│ Duplicate Clusters   │ 3     │ dupes.md         │
-│ Unused Packages      │ 4     │ deps.md          │
-│ Circular Deps        │ 2     │ circular.txt     │
-│ Unused Assets        │ 5     │ assets.md        │
-└──────────────────────┴───────┴──────────────────┘
+┌─────────────────────────────┬───────┬──────────────────┐
+│ Check                       │ Found │ Output File      │
+├─────────────────────────────┼───────┼──────────────────┤
+│ Dead Code (files + exports) │ 7     │ dead-code.txt    │
+│ Circular Dependencies       │ 2     │ circular.txt     │
+│ Duplicate Clusters          │ 3     │ dupes.md         │
+│ Unused Packages             │ 4     │ deps.md          │
+│ Unused Assets               │ 5     │ assets.md        │
+└─────────────────────────────┴───────┴──────────────────┘
 ```
 
 ---
@@ -112,10 +112,23 @@ Summary
 | `--ignore <pattern>` | — | Glob pattern to exclude from analysis. Repeatable. |
 | `--out <path>` | `<dir>/prunify-reports/` | Directory to write report files to. |
 | `--html` | `false` | Generate `code_health.html` — a self-contained page with an SVG score gauge. |
-| `--delete` | `false` | After analysis, prompt to permanently delete dead files. |
-| `--ci` | `false` | Non-interactive mode. Exits `1` if any issues are found. |
+| `--delete` | `false` | Prompt to permanently delete dead **code files** (safe to delete + transitively dead — not dead exports). See **Delete commands & cached reports** below. |
+| `--delete-assets` | `false` | Prompt to delete unused files under `public/` from the asset report. Only paths inside `public/` are removed. See **Delete commands & cached reports** below. |
+| `--ci` | `false` | Non-interactive mode. Exits `1` if any issues are found. With `--delete` / `--delete-assets`, does not prompt and does **not** delete files. |
 | `-v, --version` | — | Print the installed version. |
 
+### Delete commands & cached reports
+
+When you use **`--delete`** or **`--delete-assets`**, prunify prefers your last report so you do not have to re-scan the whole repo every time:
+
+| Flag | If the report already exists | If the report is missing |
+|------|------------------------------|---------------------------|
+| **`--delete`** | Reads file paths from `prunify-reports/dead-code.txt` (skips dead-code analysis and may skip building the import graph when no other module needs it). | Runs dead-code analysis, writes `dead-code.txt`, then prompts to delete. |
+| **`--delete-assets`** | Reads paths from `prunify-reports/assets.md` (skips the asset scan). | Runs the asset scan, writes `assets.md`, then prompts to delete. |
+
+- **`dead-code.txt`** starts with a line like `prunify <version> — <ISO timestamp>` so you know which run produced it.
+- Keep your dependency on prunify up to date (e.g. `"prunify": "^0.1.5"` in `devDependencies`) so you get the latest detection logic; pinning an old exact version will not pick up fixes from npm.
+
 ### More examples
 
 ```bash
@@ -131,9 +144,18 @@ npx prunify --only health --html
 # Only check unused public assets
 npx prunify --only assets
 
-# Delete dead files after reviewing
+# First run: analyse + write reports, then prompt to delete dead code files
 npx prunify --delete
 
+# Later: delete from existing dead-code.txt only (no graph build if e.g. --only deps)
+npx prunify --only deps --delete
+
+# Unused public assets: scan + prompt to delete
+npx prunify --only assets --delete-assets
+
+# Reuse assets.md only (no asset scan)
+npx prunify --delete-assets
+
 # Strict CI gate — fails the build if any issues exist
 npx prunify --ci
 ```
@@ -146,11 +168,11 @@ All reports are written to `prunify-reports/` (auto-added to `.gitignore`).
 
 | File | Contents |
 |------|----------|
-| `dead-code.txt` | Dead files and exports with chain analysis and recoverable byte count |
+| `dead-code.txt` | Header with tool version + time, then **Safe to delete**, **Transitively dead**, and **Dead exports** sections (sizes and optional chains). Used by `--delete` when re-running deletes. |
 | `dupes.md` | Duplicate function clusters with AI-ready refactor prompts |
-| `circular.txt` | Circular dependency chains |
+| `circular.txt` | Circular dependency chains (relative paths; header with tool version + time) |
 | `deps.md` | Unused packages |
-| `assets.md` | Unused files found in `public/` with sizes |
+| `assets.md` | Unused files found in `public/` with sizes (Markdown table). Used by `--delete-assets` when re-running deletes. |
 | `health-report.md` | Combined report with health score (with `--only health`) |
 | `code_health.html` | Self-contained HTML page with SVG score gauge (with `--html`) |
 
@@ -158,16 +180,15 @@ All reports are written to `prunify-reports/` (auto-added to `.gitignore`).
 
 ## How Dead Code Detection Works
 
-prunify builds a directed import graph of your entire codebase, then runs a depth-first traversal starting from your entry points.
+prunify builds a directed import graph (with `tsconfig.json` path aliases) and a **reverse** map of “who imports this file”.
 
-**Entry point auto-detection order:**
+1. **Safe to delete** — No other project file imports this file, and it is not treated as an app entry (e.g. Next.js `pages/` / `app/` routes) or a known framework/config file (`next.config.*`, `middleware.*`, `tailwind.config.*`, etc.).
+2. **Transitively dead** — The file is only imported by files that are already dead; removing the safe-to-delete roots would leave it orphaned.
+3. **Dead exports** — The file is still used, but specific named exports are never imported by name elsewhere (namespace imports count as “all exports used”).
 
-1. Next.js — all files inside `pages/` and `app/` directories
-2. `package.json` `"main"` and `"module"` fields
-3. Common fallbacks — `src/main`, `src/index`, `src/App`, `index` (all TS/JS extensions)
-4. If none found — files with no importers are used as roots (safest heuristic)
+**Why not “reachable from entry” only?** A pure reachability scan from entry points can mark heavily shared modules as dead if any link in the chain fails to resolve. The importer-based model matches the usual meaning of “nothing uses this file.”
 
-Any file not reachable from an entry point is flagged as dead. Circular dependencies are handled correctly — files in a cycle that are reachable from an entry point are always marked live.
+**Circular imports** are reported separately in `circular.txt`; they are not lumped into “safe to delete.”
 
 ---
 
@@ -218,7 +239,8 @@ src/
 ├── cli.ts                  # Entry point & CLI flag handling
 ├── core/
 │   ├── parser.ts           # File discovery + ts-morph AST parsing
-│   ├── graph.ts            # Import graph builder, DFS traversal, cycle detection
+│   ├── graph.ts            # Import graph builder, cycle detection, reverse graph
+│   ├── report-parser.ts    # Parse dead-code.txt / assets.md for --delete / --delete-assets
 │   └── reporter.ts         # Markdown / JSON / HTML output writer
 ├── modules/
 │   ├── dead-code.ts        # Dead file + dead export detection

package/dist/cli.cjs

@@ -27,8 +27,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var import_commander = require("commander");
 var import_chalk7 = __toESM(require("chalk"), 1);
 var import_cli_table36 = __toESM(require("cli-table3"), 1);
-var import_node_fs9 = __toESM(require("fs"), 1);
-var import_node_path9 = __toESM(require("path"), 1);
+var import_node_fs10 = __toESM(require("fs"), 1);
+var import_node_path10 = __toESM(require("path"), 1);
 var import_node_url = require("url");
 var import_node_readline = __toESM(require("readline"), 1);
 
@@ -243,11 +243,11 @@ function detectCycles(graph) {
   const seenKeys = /* @__PURE__ */ new Set();
   const visited = /* @__PURE__ */ new Set();
   const inStack = /* @__PURE__ */ new Set();
-  const path10 = [];
+  const path11 = [];
   const acc = { seenKeys, cycles };
   for (const start of graph.keys()) {
     if (!visited.has(start)) {
-      dfsForCycles(start, graph, visited, inStack, path10, acc);
+      dfsForCycles(start, graph, visited, inStack, path11, acc);
     }
   }
   return cycles;
@@ -305,7 +305,7 @@ function resolveFallbackEntries(rootDir) {
 function mkFrame(node, graph) {
   return { node, neighbors: (graph.get(node) ?? /* @__PURE__ */ new Set()).values(), entered: false };
 }
-function dfsForCycles(start, graph, visited, inStack, path10, acc) {
+function dfsForCycles(start, graph, visited, inStack, path11, acc) {
   const stack = [mkFrame(start, graph)];
   while (stack.length > 0) {
     const frame = stack.at(-1);
@@ -317,30 +317,30 @@ function dfsForCycles(start, graph, visited, inStack, path10, acc) {
       }
       frame.entered = true;
       inStack.add(frame.node);
-      path10.push(frame.node);
+      path11.push(frame.node);
     }
     const { done, value: neighbor } = frame.neighbors.next();
     if (done) {
       stack.pop();
-      path10.pop();
+      path11.pop();
       inStack.delete(frame.node);
       visited.add(frame.node);
     } else {
-      handleCycleNeighbor(neighbor, stack, path10, inStack, visited, acc, graph);
+      handleCycleNeighbor(neighbor, stack, path11, inStack, visited, acc, graph);
     }
   }
 }
-function handleCycleNeighbor(neighbor, stack, path10, inStack, visited, acc, graph) {
+function handleCycleNeighbor(neighbor, stack, path11, inStack, visited, acc, graph) {
   if (inStack.has(neighbor)) {
-    recordCycle(neighbor, path10, acc);
+    recordCycle(neighbor, path11, acc);
   } else if (!visited.has(neighbor)) {
     stack.push(mkFrame(neighbor, graph));
   }
 }
-function recordCycle(cycleStart, path10, acc) {
-  const idx = path10.indexOf(cycleStart);
+function recordCycle(cycleStart, path11, acc) {
+  const idx = path11.indexOf(cycleStart);
   if (idx === -1) return;
-  const cycle = normalizeCycle(path10.slice(idx));
+  const cycle = normalizeCycle(path11.slice(idx));
   const key = cycle.join("\0");
   if (!acc.seenKeys.has(key)) {
     acc.seenKeys.add(key);
@@ -1284,21 +1284,125 @@ function buildAssetReport(unused, totalAssets, rootDir) {
   return lines.join("\n");
 }
 
+// src/core/report-parser.ts
+var import_node_fs9 = __toESM(require("fs"), 1);
+var import_node_path9 = __toESM(require("path"), 1);
+function parseDeadCodeReportFile(reportPath, rootDir) {
+  if (!import_node_fs9.default.existsSync(reportPath)) return [];
+  const content = import_node_fs9.default.readFileSync(reportPath, "utf-8");
+  return parseDeadCodeReportContent(content, rootDir);
+}
+function parseDeadCodeReportContent(content, rootDir) {
+  const lines = content.split(/\r?\n/);
+  const paths = [];
+  const legacyRe = /^DEAD FILE —\s+(.+)$/;
+  let legacyMode = content.includes("DEAD FILE \u2014") && content.includes("Dead files :");
+  if (legacyMode) {
+    for (const line of lines) {
+      const m = legacyRe.exec(line.trim());
+      if (m) paths.push(import_node_path9.default.resolve(rootDir, m[1].trim()));
+    }
+    return [...new Set(paths)];
+  }
+  let section = "none";
+  const fileLineRe = /^\s{2}(.+?)\s+\(~[\d.]+\s+KB\)\s*$/;
+  for (const line of lines) {
+    if (line.includes("\u2500\u2500 SAFE TO DELETE \u2500\u2500")) {
+      section = "safe";
+      continue;
+    }
+    if (line.includes("\u2500\u2500 TRANSITIVELY DEAD \u2500\u2500")) {
+      section = "transitive";
+      continue;
+    }
+    if (line.includes("\u2500\u2500 DEAD EXPORTS \u2500\u2500")) {
+      section = "none";
+      continue;
+    }
+    if (line.startsWith("\u2500\u2500 ") && line.includes("\u2500\u2500")) {
+      if (section !== "none" && !line.includes("SAFE TO DELETE") && !line.includes("TRANSITIVELY DEAD")) {
+        section = "none";
+      }
+      continue;
+    }
+    if (section === "safe" || section === "transitive") {
+      if (line.includes("\u2514\u2500") || line.includes("also makes dead")) continue;
+      const m = fileLineRe.exec(line);
+      if (m) {
+        const rel = m[1].trim();
+        if (rel && !rel.startsWith("(")) {
+          paths.push(import_node_path9.default.resolve(rootDir, rel));
+        }
+      }
+    }
+  }
+  return [...new Set(paths)];
+}
+function countDeadExportsInReport(content) {
+  let section = false;
+  let n = 0;
+  for (const line of content.split(/\r?\n/)) {
+    if (line.includes("\u2500\u2500 DEAD EXPORTS \u2500\u2500")) {
+      section = true;
+      continue;
+    }
+    if (section && line.startsWith("\u2500\u2500 ") && line.includes("\u2500\u2500")) break;
+    if (section && /\s→\s.+\[line \d+\]/.test(line)) n++;
+  }
+  return n;
+}
+function parseAssetsReportFile(reportPath, rootDir) {
+  if (!import_node_fs9.default.existsSync(reportPath)) return [];
+  const content = import_node_fs9.default.readFileSync(reportPath, "utf-8");
+  return parseAssetsReportContent(content, rootDir);
+}
+function parseAssetsReportContent(content, rootDir) {
+  const lines = content.split(/\r?\n/);
+  const paths = [];
+  let inTable = false;
+  let headerSeen = false;
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith("## Unused Assets")) {
+      inTable = true;
+      headerSeen = false;
+      continue;
+    }
+    if (inTable && trimmed.startsWith("## ")) {
+      break;
+    }
+    if (!inTable) continue;
+    if (trimmed.startsWith("|") && trimmed.includes("---")) {
+      headerSeen = true;
+      continue;
+    }
+    if (!headerSeen || !trimmed.startsWith("|")) continue;
+    const cells = trimmed.split("|").map((c) => c.trim()).filter(Boolean);
+    if (cells.length >= 1) {
+      const rel = cells[0];
+      if (rel.toLowerCase() === "asset") continue;
+      if (rel.includes("---")) continue;
+      paths.push(import_node_path9.default.resolve(rootDir, rel));
+    }
+  }
+  return [...new Set(paths)];
+}
+
 // src/cli.ts
 var import_meta = {};
 function readPkgVersion() {
   try {
     if (typeof import_meta !== "undefined" && import_meta.url) {
-      const dir = import_node_path9.default.dirname((0, import_node_url.fileURLToPath)(import_meta.url));
-      const pkgPath = import_node_path9.default.resolve(dir, "..", "package.json");
-      return JSON.parse(import_node_fs9.default.readFileSync(pkgPath, "utf-8")).version;
+      const dir = import_node_path10.default.dirname((0, import_node_url.fileURLToPath)(import_meta.url));
+      const pkgPath = import_node_path10.default.resolve(dir, "..", "package.json");
+      return JSON.parse(import_node_fs10.default.readFileSync(pkgPath, "utf-8")).version;
     }
   } catch {
   }
   try {
     const dir = globalThis.__dirname ?? __dirname;
-    const pkgPath = import_node_path9.default.resolve(dir, "..", "package.json");
-    return JSON.parse(import_node_fs9.default.readFileSync(pkgPath, "utf-8")).version;
+    const pkgPath = import_node_path10.default.resolve(dir, "..", "package.json");
+    return JSON.parse(import_node_fs10.default.readFileSync(pkgPath, "utf-8")).version;
   } catch {
     return "0.0.0";
   }
@@ -1311,11 +1415,14 @@ program.name("prunify").description("npm run clean. ship with confidence.").vers
   "Glob pattern to ignore (repeatable)",
   (val, acc) => [...acc, val],
   []
-).option("--out <path>", "Output directory for reports").option("--html", "Also generate code_health.html").option("--delete", "Prompt to delete dead files after analysis").option("--ci", "CI mode: exit 1 if issues found, no interactive prompts").action(main);
+).option("--out <path>", "Output directory for reports").option("--html", "Also generate code_health.html").option("--delete", "Delete dead files (uses prunify-reports/dead-code.txt if present, else runs analysis)").option(
+  "--delete-assets",
+  "Delete unused public assets (uses prunify-reports/assets.md if present, else runs asset scan)"
+).option("--ci", "CI mode: exit 1 if issues found, no interactive prompts").action(main);
 program.parse();
 async function main(opts) {
-  const rootDir = import_node_path9.default.resolve(opts.dir);
-  if (!import_node_fs9.default.existsSync(import_node_path9.default.join(rootDir, "package.json"))) {
+  const rootDir = import_node_path10.default.resolve(opts.dir);
+  if (!import_node_fs10.default.existsSync(import_node_path10.default.join(rootDir, "package.json"))) {
     console.error(import_chalk7.default.red(`\u2717  No package.json found in ${rootDir}`));
     console.error(import_chalk7.default.dim("   Use --dir <path> to point to your project root."));
     process.exit(1);
@@ -1324,21 +1431,53 @@ async function main(opts) {
   console.log();
   console.log(import_chalk7.default.bold.cyan("\u{1F9F9} prunify \u2014 npm run clean. ship with confidence."));
   console.log();
-  const parseSpinner = createSpinner(import_chalk7.default.cyan("Parsing codebase\u2026"));
-  const files = discoverFiles(rootDir, opts.ignore);
-  parseSpinner.succeed(import_chalk7.default.green(`Parsed codebase \u2014 ${files.length} file(s) found`));
-  const graphSpinner = createSpinner(import_chalk7.default.cyan("Building import graph\u2026"));
-  const project = buildProject(files);
-  const graph = buildGraph(files, (f) => {
-    const sf = project.getSourceFile(f);
-    return sf ? getImportsForFile(sf) : [];
-  });
-  const edgeCount = [...graph.values()].reduce((n, s) => n + s.size, 0);
-  graphSpinner.succeed(import_chalk7.default.green(`Import graph built \u2014 ${edgeCount} edge(s)`));
-  const packageJson = loadPackageJson2(rootDir);
-  const entryPoints = opts.entry ? [import_node_path9.default.resolve(opts.entry)] : findEntryPoints(rootDir, packageJson);
   const reportsDir = ensureReportsDir(rootDir, opts.out);
   appendToGitignore(rootDir);
+  const deadReportPath = import_node_path10.default.join(reportsDir, "dead-code.txt");
+  const assetsReportPath = import_node_path10.default.join(reportsDir, "assets.md");
+  const loadDeadFromCache = Boolean(opts.delete && import_node_fs10.default.existsSync(deadReportPath));
+  const loadAssetsFromCache = Boolean(opts.deleteAssets && import_node_fs10.default.existsSync(assetsReportPath));
+  let deadFilePaths = [];
+  let unusedAssetPaths = [];
+  if (loadDeadFromCache) {
+    deadFilePaths = parseDeadCodeReportFile(deadReportPath, rootDir);
+    console.log(
+      import_chalk7.default.cyan(
+        `  Using existing dead-code report (${deadFilePaths.length} file(s) to delete) \u2192 ${import_node_path10.default.relative(rootDir, deadReportPath)}`
+      )
+    );
+  }
+  if (loadAssetsFromCache) {
+    unusedAssetPaths = parseAssetsReportFile(assetsReportPath, rootDir);
+    console.log(
+      import_chalk7.default.cyan(
+        `  Using existing assets report (${unusedAssetPaths.length} asset(s) to delete) \u2192 ${import_node_path10.default.relative(rootDir, assetsReportPath)}`
+      )
+    );
+  }
+  const runDeadCode2 = !loadDeadFromCache && (modules.includes("dead-code") || Boolean(opts.delete));
+  const runCircular2 = modules.includes("circular");
+  const runAssets = !loadAssetsFromCache && (modules.includes("assets") || Boolean(opts.deleteAssets));
+  const needsGraph = runCircular2 || runDeadCode2;
+  let files = [];
+  let project;
+  let graph;
+  let entryPoints = [];
+  if (needsGraph) {
+    const parseSpinner = createSpinner(import_chalk7.default.cyan("Parsing codebase\u2026"));
+    files = discoverFiles(rootDir, opts.ignore);
+    parseSpinner.succeed(import_chalk7.default.green(`Parsed codebase \u2014 ${files.length} file(s) found`));
+    const graphSpinner = createSpinner(import_chalk7.default.cyan("Building import graph\u2026"));
+    project = buildProject(files);
+    graph = buildGraph(files, (f) => {
+      const sf = project.getSourceFile(f);
+      return sf ? getImportsForFile(sf) : [];
+    });
+    const edgeCount = [...graph.values()].reduce((n, s) => n + s.size, 0);
+    graphSpinner.succeed(import_chalk7.default.green(`Import graph built \u2014 ${edgeCount} edge(s)`));
+    const packageJson = loadPackageJson2(rootDir);
+    entryPoints = opts.entry ? [import_node_path10.default.resolve(opts.entry)] : findEntryPoints(rootDir, packageJson);
+  }
   console.log();
   let deadFileCount = 0;
   let dupeCount = 0;
@@ -1350,12 +1489,24 @@ async function main(opts) {
   let depsReportFile = "";
   let circularReportFile = "";
   let assetsReportFile = "";
-  const deadFilePaths = [];
-  if (modules.includes("dead-code")) {
+  if (loadDeadFromCache) {
+    deadReportFile = "dead-code.txt";
+    try {
+      const raw = import_node_fs10.default.readFileSync(deadReportPath, "utf-8");
+      deadFileCount = deadFilePaths.length + countDeadExportsInReport(raw);
+    } catch {
+      deadFileCount = deadFilePaths.length;
+    }
+  }
+  if (loadAssetsFromCache) {
+    assetsReportFile = "assets.md";
+    unusedAssetCount = unusedAssetPaths.length;
+  }
+  if (runDeadCode2) {
     const spinner = createSpinner(import_chalk7.default.cyan("Analysing dead code\u2026"));
     const result = runDeadCodeModule(project, graph, entryPoints, rootDir);
     deadFileCount = result.safeToDelete.length + result.transitivelyDead.length + result.deadExports.length;
-    deadFilePaths.push(...result.safeToDelete, ...result.transitivelyDead);
+    deadFilePaths = [...result.safeToDelete, ...result.transitivelyDead];
     spinner.succeed(
       import_chalk7.default.green(
         `Dead code analysis complete \u2014 ${result.safeToDelete.length} safe to delete, ${result.transitivelyDead.length} transitively dead, ${result.deadExports.length} dead export(s)`
@@ -1370,19 +1521,19 @@ async function main(opts) {
     }
   }
   if (modules.includes("dupes")) {
-    const outputPath = import_node_path9.default.join(reportsDir, "dupes.md");
+    const outputPath = import_node_path10.default.join(reportsDir, "dupes.md");
     const dupes = await runDupeFinder(rootDir, { output: outputPath });
     dupeCount = dupes.length;
     if (dupeCount > 0) dupesReportFile = "dupes.md";
   }
-  if (modules.includes("circular")) {
+  if (runCircular2) {
     const spinner = createSpinner(import_chalk7.default.cyan("Analysing circular imports\u2026"));
     const cycles = detectCycles(graph);
     circularCount = cycles.length;
     spinner.succeed(import_chalk7.default.green(`Circular import analysis complete \u2014 ${circularCount} cycle(s) found`));
     if (circularCount > 0) {
       circularReportFile = "circular.txt";
-      const rel = (p) => import_node_path9.default.relative(rootDir, p).replaceAll("\\", "/");
+      const rel = (p) => import_node_path10.default.relative(rootDir, p).replaceAll("\\", "/");
       const cycleLines = [
         "========================================",
         "  CIRCULAR DEPENDENCIES",
@@ -1407,23 +1558,24 @@ async function main(opts) {
     }
   }
   if (modules.includes("deps")) {
-    const outputPath = import_node_path9.default.join(reportsDir, "deps.md");
+    const outputPath = import_node_path10.default.join(reportsDir, "deps.md");
     const issues = await runDepCheck({ cwd: rootDir, output: outputPath });
     unusedPkgCount = issues.filter((i) => i.type === "unused").length;
     if (issues.length > 0) depsReportFile = "deps.md";
   }
-  if (modules.includes("assets")) {
-    const outputPath = import_node_path9.default.join(reportsDir, "assets.md");
+  if (runAssets) {
+    const outputPath = import_node_path10.default.join(reportsDir, "assets.md");
     const unusedAssets = await runAssetCheck(rootDir, { output: outputPath });
+    unusedAssetPaths = unusedAssets.map((a) => a.filePath);
     unusedAssetCount = unusedAssets.length;
     if (unusedAssetCount > 0) assetsReportFile = "assets.md";
   }
   if (modules.includes("health")) {
-    const outputPath = import_node_path9.default.join(reportsDir, "health-report.md");
+    const outputPath = import_node_path10.default.join(reportsDir, "health-report.md");
     await runHealthReport(rootDir, { output: outputPath });
   }
   if (opts.html) {
-    const htmlPath = import_node_path9.default.join(reportsDir, "code_health.html");
+    const htmlPath = import_node_path10.default.join(reportsDir, "code_health.html");
     writeHtmlReport(htmlPath, rootDir, deadFilePaths, circularCount, dupeCount, unusedPkgCount);
     console.log(import_chalk7.default.cyan(`  HTML report written to ${htmlPath}`));
   }
@@ -1445,22 +1597,72 @@ async function main(opts) {
   console.log(table.toString());
   console.log();
   if (opts.delete && deadFilePaths.length > 0) {
-    console.log(import_chalk7.default.yellow(`Dead files (${deadFilePaths.length}):`));
+    console.log(import_chalk7.default.yellow(`Dead code files to delete (${deadFilePaths.length}):`));
     for (const f of deadFilePaths) {
-      console.log(import_chalk7.default.dim(`  ${import_node_path9.default.relative(rootDir, f)}`));
+      console.log(import_chalk7.default.dim(`  ${import_node_path10.default.relative(rootDir, f)}`));
     }
     console.log();
     if (!opts.ci) {
-      const confirmed = await confirmPrompt("Delete these files? (y/N) ");
+      const confirmed = await confirmPrompt("Delete these dead code files? (y/N) ");
       if (confirmed) {
+        let removed = 0;
         for (const f of deadFilePaths) {
-          import_node_fs9.default.rmSync(f, { force: true });
+          try {
+            if (import_node_fs10.default.existsSync(f)) {
+              import_node_fs10.default.rmSync(f, { force: true });
+              removed++;
+            }
+          } catch {
+            console.log(import_chalk7.default.red(`  Failed to delete: ${import_node_path10.default.relative(rootDir, f)}`));
+          }
+        }
+        console.log(import_chalk7.default.green(`  Deleted ${removed} file(s).`));
+      } else {
+        console.log(import_chalk7.default.dim("  Skipped."));
+      }
+    }
+  } else if (opts.delete && deadFilePaths.length === 0) {
+    console.log(import_chalk7.default.dim("  --delete: no dead code files listed in report (nothing to delete)."));
+  }
+  if (opts.deleteAssets && unusedAssetPaths.length > 0) {
+    const publicDir = import_node_path10.default.join(rootDir, "public");
+    const safePaths = unusedAssetPaths.filter((p) => {
+      const norm = import_node_path10.default.normalize(p);
+      return norm.startsWith(import_node_path10.default.normalize(publicDir + import_node_path10.default.sep));
+    });
+    if (safePaths.length !== unusedAssetPaths.length) {
+      console.log(
+        import_chalk7.default.yellow(
+          `  Warning: skipped ${unusedAssetPaths.length - safePaths.length} path(s) outside public/`
+        )
+      );
+    }
+    console.log(import_chalk7.default.yellow(`Unused assets to delete (${safePaths.length}):`));
+    for (const f of safePaths) {
+      console.log(import_chalk7.default.dim(`  ${import_node_path10.default.relative(rootDir, f)}`));
+    }
+    console.log();
+    if (!opts.ci) {
+      const confirmed = await confirmPrompt("Delete these unused assets? (y/N) ");
+      if (confirmed) {
+        let removed = 0;
+        for (const f of safePaths) {
+          try {
+            if (import_node_fs10.default.existsSync(f)) {
+              import_node_fs10.default.rmSync(f, { force: true });
+              removed++;
+            }
+          } catch {
+            console.log(import_chalk7.default.red(`  Failed to delete: ${import_node_path10.default.relative(rootDir, f)}`));
+          }
         }
-        console.log(import_chalk7.default.green(`  Deleted ${deadFilePaths.length} file(s).`));
+        console.log(import_chalk7.default.green(`  Deleted ${removed} asset file(s).`));
       } else {
         console.log(import_chalk7.default.dim("  Skipped."));
       }
     }
+  } else if (opts.deleteAssets && unusedAssetPaths.length === 0) {
+    console.log(import_chalk7.default.dim("  --delete-assets: no unused assets in report (nothing to delete)."));
   }
   if (opts.ci) {
     const hasIssues = deadFileCount > 0 || dupeCount > 0 || unusedPkgCount > 0 || circularCount > 0 || unusedAssetCount > 0;
@@ -1474,7 +1676,7 @@ function resolveModules(only) {
 }
 function loadPackageJson2(dir) {
   try {
-    return JSON.parse(import_node_fs9.default.readFileSync(import_node_path9.default.join(dir, "package.json"), "utf-8"));
+    return JSON.parse(import_node_fs10.default.readFileSync(import_node_path10.default.join(dir, "package.json"), "utf-8"));
   } catch {
     return null;
   }
@@ -1495,7 +1697,7 @@ function writeHtmlReport(outputPath, rootDir, deadFiles, circularCount, dupeCoun
     ["Circular Dependencies", String(circularCount)],
     ["Unused Packages", String(unusedPkgCount)]
   ].map(([label, val]) => `    <tr><td>${label}</td><td>${val}</td></tr>`).join("\n");
-  const deadList = deadFiles.length > 0 ? `<ul>${deadFiles.map((f) => `<li>${import_node_path9.default.relative(rootDir, f)}</li>`).join("")}</ul>` : "<p>None</p>";
+  const deadList = deadFiles.length > 0 ? `<ul>${deadFiles.map((f) => `<li>${import_node_path10.default.relative(rootDir, f)}</li>`).join("")}</ul>` : "<p>None</p>";
   const html = `<!DOCTYPE html>
 <html lang="en">
 <head>
@@ -1522,7 +1724,7 @@ ${rows}
   ${deadList}
 </body>
 </html>`;
-  import_node_fs9.default.mkdirSync(import_node_path9.default.dirname(outputPath), { recursive: true });
-  import_node_fs9.default.writeFileSync(outputPath, html, "utf-8");
+  import_node_fs10.default.mkdirSync(import_node_path10.default.dirname(outputPath), { recursive: true });
+  import_node_fs10.default.writeFileSync(outputPath, html, "utf-8");
 }
 //# sourceMappingURL=cli.cjs.map