@kb-labs/quality-entry 2.93.0 → 2.96.0

package/dist/cli/commands/dead-code.js

@@ -1,216 +1,60 @@
-import { defineCommand } from '@kb-labs/sdk';
-import { CACHE_KEYS } from '@kb-labs/quality-contracts';
-import { listBackups, restoreFromBackup, scanDeadFiles, removeDeadFiles } from '@kb-labs/quality-core/dead-code';
+import { defineCommand, useConfig } from '@kb-labs/sdk';
+import { runKnip } from '@kb-labs/quality-core';
+import { defaultQualityConfig } from '@kb-labs/quality-contracts';
 
 // src/cli/commands/dead-code.ts
 var dead_code_default = defineCommand({
   id: "quality:dead-code",
-  description: "Detect and optionally remove dead (unreachable) source files",
+  description: "Detect unused files, exports, and deps via knip",
   handler: {
     async execute(ctx, input) {
-      const { ui, platform } = ctx;
-      const flags = "flags" in input && typeof input.flags === "object" && input.flags !== null ? input.flags : input;
-      if (flags["list-backups"]) {
-        const backups = listBackups(ctx.cwd);
-        if (flags.json) {
-          ui?.json?.(backups);
-        } else {
-          outputBackupList(backups, ui);
-        }
-        return { exitCode: 0, result: backups };
+      const { flags } = input;
+      const config = await useConfig();
+      const cwd = ctx.cwd ?? process.cwd();
+      const cfg = config ?? defaultQualityConfig;
+      if (!cfg.knip.enabled) {
+        ctx.ui?.success?.("knip is disabled in config (knip.enabled = false)");
+        return { exitCode: 0 };
       }
-      if (flags.restore) {
-        try {
-          const result2 = await restoreFromBackup(ctx.cwd, flags.restore);
-          if (flags.json) {
-            ui?.json?.(result2);
-          } else {
-            ui?.success?.(`Restored ${result2.restoredFiles} file(s) from backup ${flags.restore}`, {});
-            if (result2.restoredExports > 0) {
-              ui?.info?.(`Note: ${result2.restoredExports} package.json export(s) were cleaned. You may need to rebuild.`);
-            }
-          }
-          return { exitCode: 0 };
-        } catch (err) {
-          if (flags.json) {
-            ui?.json?.({ error: err instanceof Error ? err.message : String(err) });
-          } else {
-            ui?.error?.(err instanceof Error ? err.message : String(err));
-          }
-          return { exitCode: 1 };
-        }
+      const report = await runKnip({ shell: ctx.api.shell, rootDir: cwd });
+      if (flags.json) {
+        ctx.ui?.json?.(report);
+        return { exitCode: report.totalIssues > 0 ? 1 : 0 };
       }
-      const cacheKey = `${CACHE_KEYS.DEAD_CODE}:${flags.package || "all"}`;
-      if (!flags.refresh && !flags["auto-remove"]) {
-        const cached = await platform.cache.get(cacheKey);
-        if (cached) {
-          outputDeadCodeReport({ ...cached, cached: true }, flags, ui);
-          return { exitCode: cached.summary.totalDead > 0 ? 1 : 0, result: cached };
-        }
+      if (report.totalIssues === 0) {
+        ctx.ui?.success?.("No dead code detected");
+        return { exitCode: 0 };
       }
-      const result = await scanDeadFiles(ctx.cwd, {
-        packageFilter: flags.package,
-        verbose: flags.verbose
-      });
-      await platform.cache.set(cacheKey, result, 5 * 60 * 1e3);
-      await platform.analytics.track("quality:dead-code", {
-        totalPackages: result.summary.totalPackages,
-        totalFiles: result.summary.totalFiles,
-        totalDead: result.summary.totalDead,
-        totalDeadBytes: result.summary.totalDeadBytes,
-        duration: result.duration,
-        autoRemove: !!flags["auto-remove"],
-        dryRun: !!flags["dry-run"]
-      });
-      if (flags["auto-remove"]) {
-        if (result.summary.totalDead === 0) {
-          if (flags.json) {
-            ui?.json?.({ message: "No dead files found", ...result });
-          } else {
-            ui?.success?.("No dead files found. Nothing to remove.", {});
-          }
-          return { exitCode: 0, result };
-        }
-        const removalResult = await removeDeadFiles(ctx.cwd, result, {
-          dryRun: flags["dry-run"]
+      const sections = [];
+      if (report.unusedFiles.length > 0) {
+        sections.push({
+          header: `Unused files (${report.unusedFiles.length})`,
+          items: report.unusedFiles
         });
-        if (flags.json) {
-          ui?.json?.(removalResult);
-        } else {
-          outputRemovalReport(removalResult, flags, ui);
-        }
-        return { exitCode: 0, result: removalResult };
       }
-      outputDeadCodeReport({ ...result, cached: false }, flags, ui);
-      return {
-        exitCode: result.summary.totalDead > 0 ? 1 : 0,
-        result
-      };
-    }
-  }
-});
-function outputDeadCodeReport(result, flags, ui) {
-  if (flags.json) {
-    ui?.json?.(result);
-    return;
-  }
-  const sections = [];
-  const packagesWithDead = result.packages.filter((p) => p.deadFiles.length > 0);
-  if (packagesWithDead.length > 0) {
-    const items = [];
-    for (const pkg of packagesWithDead) {
-      items.push(`${pkg.packageName} (${pkg.deadFiles.length} dead file${pkg.deadFiles.length === 1 ? "" : "s"})`);
-      for (const dead of pkg.deadFiles.slice(0, 5)) {
-        const sizeKb = (dead.sizeBytes / 1024).toFixed(1);
-        items.push(`  ${dead.relativePath} (${sizeKb} KB)`);
+      if (report.unusedExports.length > 0) {
+        sections.push({
+          header: `Unused exports (${report.unusedExports.length})`,
+          items: report.unusedExports.map((e) => `${e.file}  ${e.symbol}`)
+        });
       }
-      if (pkg.deadFiles.length > 5) {
-        items.push(`  ... and ${pkg.deadFiles.length - 5} more`);
+      if (report.unusedDependencies.length > 0) {
+        sections.push({
+          header: `Unused dependencies (${report.unusedDependencies.length})`,
+          items: report.unusedDependencies.map((d) => `${d.package}  in ${d.workspace}`)
+        });
       }
-    }
-    sections.push({ header: "Dead Files", items });
-  }
-  if (flags.verbose) {
-    for (const pkg of result.packages) {
-      if (pkg.entryPoints.length > 0) {
-        const items = pkg.entryPoints.slice(0, 10).map((ep) => `  ${ep}`);
-        if (pkg.entryPoints.length > 10) {
-          items.push(`  ... and ${pkg.entryPoints.length - 10} more`);
-        }
-        sections.push({ header: `Entry Points: ${pkg.packageName}`, items });
+      if (report.unlistedDependencies.length > 0) {
+        sections.push({
+          header: `Unlisted dependencies (${report.unlistedDependencies.length})`,
+          items: report.unlistedDependencies.map((d) => `${d.package}  in ${d.workspace}`)
+        });
       }
+      ctx.ui?.error?.(`${report.totalIssues} dead code issue(s) found`, { sections });
+      return { exitCode: 1 };
     }
   }
-  const allWarnings = result.packages.flatMap((p) => p.warnings);
-  if (allWarnings.length > 0) {
-    sections.push({
-      header: "Warnings",
-      items: allWarnings.slice(0, 10)
-    });
-  }
-  const totalDeadKb = (result.summary.totalDeadBytes / 1024).toFixed(1);
-  const summaryItems = [
-    `Packages scanned: ${result.summary.totalPackages}`,
-    `Total source files: ${result.summary.totalFiles}`,
-    `Alive files: ${result.summary.totalAlive}`,
-    `Dead files: ${result.summary.totalDead}`,
-    result.summary.totalDead > 0 ? `Dead code size: ${totalDeadKb} KB` : null,
-    result.summary.emptyDirectories.length > 0 ? `Empty directories: ${result.summary.emptyDirectories.length}` : null,
-    `Duration: ${(result.duration / 1e3).toFixed(1)}s`,
-    result.cached ? "(cached \u2014 use --refresh to rescan)" : null
-  ].filter(Boolean);
-  sections.push({ header: "Summary", items: summaryItems });
-  if (result.summary.totalDead > 0) {
-    sections.push({
-      header: "Next Steps",
-      items: [
-        "Run with --auto-remove --dry-run to preview removal",
-        "Run with --auto-remove to remove and create backup",
-        "Run with --verbose to see entry points"
-      ]
-    });
-  }
-  const title = result.summary.totalDead === 0 ? "No dead files found" : `${result.summary.totalDead} dead file(s) found`;
-  ui?.success?.("Dead code analysis completed", { title, sections });
-}
-function outputRemovalReport(result, flags, ui) {
-  const isDryRun = flags["dry-run"];
-  const prefix = isDryRun ? "[DRY RUN] Would" : "Successfully";
-  const sections = [];
-  const items = [
-    `${prefix} remove ${result.filesRemoved} file(s)`,
-    `${prefix} free ${(result.bytesRemoved / 1024).toFixed(1)} KB`
-  ];
-  if (result.emptyDirsRemoved > 0) {
-    items.push(`${prefix} remove ${result.emptyDirsRemoved} empty director${result.emptyDirsRemoved === 1 ? "y" : "ies"}`);
-  }
-  if (result.exportsCleanedUp > 0) {
-    items.push(`${prefix} clean ${result.exportsCleanedUp} package.json export(s)`);
-  }
-  sections.push({ header: isDryRun ? "Preview" : "Removal Complete", items });
-  if (!isDryRun) {
-    sections.push({
-      header: "Backup",
-      items: [
-        `Backup ID: ${result.backupId}`,
-        `To restore: pnpm kb quality:dead-code --restore ${result.backupId}`
-      ]
-    });
-  }
-  const fileItems = [];
-  for (const file of result.manifest.removedFiles.slice(0, 10)) {
-    const sizeKb = (file.sizeBytes / 1024).toFixed(1);
-    fileItems.push(`${file.backupPath} (${sizeKb} KB)`);
-  }
-  if (result.manifest.removedFiles.length > 10) {
-    fileItems.push(`... and ${result.manifest.removedFiles.length - 10} more`);
-  }
-  sections.push({ header: "Files", items: fileItems });
-  const title = isDryRun ? `[DRY RUN] Would remove ${result.filesRemoved} file(s)` : `Removed ${result.filesRemoved} file(s)`;
-  ui?.success?.(title, { title, sections });
-}
-function outputBackupList(backups, ui) {
-  if (backups.length === 0) {
-    ui?.info?.("No backups found.");
-    return;
-  }
-  const sections = [];
-  for (const backup of backups) {
-    const date = new Date(backup.createdAt).toLocaleString();
-    const items = [
-      `Date: ${date}`,
-      `Git: ${backup.gitBranch} @ ${backup.gitSha.slice(0, 8)}`,
-      `Files: ${backup.totalFilesRemoved}`,
-      `Size: ${(backup.totalBytesRemoved / 1024).toFixed(1)} KB`,
-      `Restore: pnpm kb quality:dead-code --restore ${backup.id}`
-    ];
-    sections.push({ header: `Backup: ${backup.id}`, items });
-  }
-  ui?.success?.(`${backups.length} backup(s) found`, {
-    title: "Dead Code Backups",
-    sections
-  });
-}
+});
 
 export { dead_code_default as default };
 //# sourceMappingURL=dead-code.js.map

package/dist/cli/commands/dead-code.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/cli/commands/dead-code.ts"],"names":["result"],"mappings":";;;;;AA2BA,IAAO,oBAAQ,aAAA,CAAc;AAAA,EAC3B,EAAA,EAAI,mBAAA;AAAA,EACJ,WAAA,EAAa,8DAAA;AAAA,EAEb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EACgC;AAChC,MAAA,MAAM,EAAE,EAAA,EAAI,QAAA,EAAS,GAAI,GAAA;AAEzB,MAAA,MAAM,KAAA,GAAS,OAAA,IAAW,KAAA,IAAS,OAAQ,KAAA,CAA8B,KAAA,KAAU,QAAA,IAAa,KAAA,CAA8B,KAAA,KAAU,IAAA,GACnI,KAAA,CAAmC,KAAA,GACpC,KAAA;AAKJ,MAAA,IAAI,KAAA,CAAM,cAAc,CAAA,EAAG;AACzB,QAAA,MAAM,OAAA,GAAU,WAAA,CAAY,GAAA,CAAI,GAAG,CAAA;AACnC,QAAA,IAAI,MAAM,IAAA,EAAM;AACd,UAAA,EAAA,EAAI,OAAO,OAAO,CAAA;AAAA,QACpB,CAAA,MAAO;AACL,UAAA,gBAAA,CAAiB,SAAS,EAAE,CAAA;AAAA,QAC9B;AACA,QAAA,OAAO,EAAE,QAAA,EAAU,CAAA,EAAG,MAAA,EAAQ,OAAA,EAAQ;AAAA,MACxC;AAGA,MAAA,IAAI,MAAM,OAAA,EAAS;AACjB,QAAA,IAAI;AACF,UAAA,MAAMA,UAAS,MAAM,iBAAA,CAAkB,GAAA,CAAI,GAAA,EAAK,MAAM,OAAO,CAAA;AAC7D,UAAA,IAAI,MAAM,IAAA,EAAM;AACd,YAAA,EAAA,EAAI,OAAOA,OAAM,CAAA;AAAA,UACnB,CAAA,MAAO;AACL,YAAA,EAAA,EAAI,OAAA,GAAU,YAAYA,OAAAA,CAAO,aAAa,wBAAwB,KAAA,CAAM,OAAO,CAAA,CAAA,EAAI,EAAE,CAAA;AACzF,YAAA,IAAIA,OAAAA,CAAO,kBAAkB,CAAA,EAAG;AAC9B,cAAA,EAAA,EAAI,IAAA,GAAO,CAAA,MAAA,EAASA,OAAAA,CAAO,eAAe,CAAA,8DAAA,CAAgE,CAAA;AAAA,YAC5G;AAAA,UACF;AACA,UAAA,OAAO,EAAE,UAAU,CAAA,EAAE;AAAA,QACvB,SAAS,GAAA,EAAc;AACrB,UAAA,IAAI,MAAM,IAAA,EAAM;AACd,YAAA,EAAA,EAAI,IAAA,GAAO,EAAE,KAAA,EAAO,GAAA,YAAe,KAAA,GAAQ,IAAI,OAAA,GAAU,MAAA,CAAO,GAAG,CAAA,EAAG,CAAA;AAAA,UACxE,CAAA,MAAO;AACL,YAAA,EAAA,EAAI,QAAQ,GAAA,YAAe,KAAA,GAAQ,IAAI,OAAA,GAAU,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,UAC9D;AACA,UAAA,OAAO,EAAE,UAAU,CAAA,EAAE;AAAA,QACvB;AAAA,MACF;AAKA,MAAA,MAAM,WAAW,CAAA,EAAG,UAAA,CAAW,SAAS,CAAA,CAAA,EAAI,KAAA,CAAM,WAAW,KAAK,CAAA,CAAA;AAClE,MAAA,IAAI,CAAC,KAAA,CAAM,OAAA,IAAW,CAAC,KAAA,CAAM,aAAa,CAAA,EAAG;AAC3C,QAAA,MAAM,MAAA,GAAS,MAAM,QAAA,CAAS,KAAA,CAAM,IAAoB,QAAQ,CAAA;AAChE,QAAA,IAAI,MAAA,EAAQ;AACV,UAAA,oBAAA,CAAqB,EAAE,GAAG,MAAA,EAAQ,QAAQ,IAAA,EAAK,EAAG,OAAO,EAAE,CAAA;AAC3D,UAAA,OAAO,EAAE,UAAU,MAAA,CAAO,OAAA,CAAQ,YAAY,CAAA,GAAI,CAAA,GAAI,CAAA,EAAG,MAAA,EAAQ,MAAA,EAAO;AAAA,QAC1E;AAAA,MACF;AAGA,MAAA,MAAM,MAAA,GAAS,MAAM,aAAA,CAAc,GAAA,CAAI,GAAA,EAAK;AAAA,QAC1C,eAAe,KAAA,CAAM,OAAA;AAAA,QACrB,SAAS,KAAA,CAAM;AAAA,OAChB,CAAA;AAGD,MAAA,MAAM,SAAS,KAAA,CAAM,GAAA,CAAI,UAAU,MAAA,EAAQ,CAAA,GAAI,KAAK,GAAI,CAAA;AAGxD,MAAA,MAAM,QAAA,CAAS,SAAA,CAAU,KAAA,CAAM,mBAAA,EAAqB;AAAA,QAClD,aAAA,EAAe,OAAO,OAAA,CAAQ,aAAA;AAAA,QAC9B,UAAA,EAAY,OAAO,OAAA,CAAQ,UAAA;AAAA,QAC3B,SAAA,EAAW,OAAO,OAAA,CAAQ,SAAA;AAAA,QAC1B,cAAA,EAAgB,OAAO,OAAA,CAAQ,cAAA;AAAA,QAC/B,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,UAAA,EAAY,CAAC,CAAC,KAAA,CAAM,aAAa,CAAA;AAAA,QACjC,MAAA,EAAQ,CAAC,CAAC,KAAA,CAAM,SAAS;AAAA,OAC1B,CAAA;AAGD,MAAA,IAAI,KAAA,CAAM,aAAa,CAAA,EAAG;AACxB,QAAA,IAAI,MAAA,CAAO,OAAA,CAAQ,SAAA,KAAc,CAAA,EAAG;AAClC,UAAA,IAAI,MAAM,IAAA,EAAM;AACd,YAAA,EAAA,EAAI,OAAO,EAAE,OAAA,EAAS,qBAAA,EAAuB,GAAG,QAAQ,CAAA;AAAA,UAC1D,CAAA,MAAO;AACL,YAAA,EAAA,EAAI,OAAA,GAAU,yCAAA,EAA2C,EAAE,CAAA;AAAA,UAC7D;AACA,UAAA,OAAO,EAAE,QAAA,EAAU,CAAA,EAAG,MAAA,EAAO;AAAA,QAC/B;AAEA,QAAA,MAAM,aAAA,GAAgB,MAAM,eAAA,CAAgB,GAAA,CAAI,KAAK,MAAA,EAAQ;AAAA,UAC3D,MAAA,EAAQ,MAAM,SAAS;AAAA,SACxB,CAAA;AAED,QAAA,IAAI,MAAM,IAAA,EAAM;AACd,UAAA,EAAA,EAAI,OAAO,aAAa,CAAA;AAAA,QAC1B,CAAA,MAAO;AACL,UAAA,mBAAA,CAAoB,aAAA,EAAe,OAAO,EAAE,CAAA;AAAA,QAC9C;AAEA,QAAA,OAAO,EAAE,QAAA,EAAU,CAAA,EAAG,MAAA,EAAQ,aAAA,EAAc;AAAA,MAC9C;AAGA,MAAA,oBAAA,CAAqB,EAAE,GAAG,MAAA,EAAQ,QAAQ,KAAA,EAAM,EAAG,OAAO,EAAE,CAAA;AAE5D,MAAA,OAAO;AAAA,QACL,QAAA,EAAU,MAAA,CAAO,OAAA,CAAQ,SAAA,GAAY,IAAI,CAAA,GAAI,CAAA;AAAA,QAC7C;AAAA,OACF;AAAA,IACF;AAAA;AAEJ,CAAC;AAID,SAAS,oBAAA,CACP,MAAA,EACA,KAAA,EACA,EAAA,EACM;AACN,EAAA,IAAI,MAAM,IAAA,EAAM;AACd,IAAA,EAAA,EAAI,OAAO,MAAM,CAAA;AACjB,IAAA;AAAA,EACF;AAEA,EAAA,MAAM,WAAuD,EAAC;AAG9D,EAAA,MAAM,gBAAA,GAAmB,OAAO,QAAA,CAAS,MAAA,CAAO,OAAK,CAAA,CAAE,SAAA,CAAU,SAAS,CAAC,CAAA;AAE3E,EAAA,IAAI,gBAAA,CAAiB,SAAS,CAAA,EAAG;AAC/B,IAAA,MAAM,QAAkB,EAAC;AACzB,IAAA,KAAA,MAAW,OAAO,gBAAA,EAAkB;AAClC,MAAA,KAAA,CAAM,IAAA,CAAK,CAAA,EAAG,GAAA,CAAI,WAAW,KAAK,GAAA,CAAI,SAAA,CAAU,MAAM,CAAA,UAAA,EAAa,IAAI,SAAA,CAAU,MAAA,KAAW,CAAA,GAAI,EAAA,GAAK,GAAG,CAAA,CAAA,CAAG,CAAA;AAC3G,MAAA,KAAA,MAAW,QAAQ,GAAA,CAAI,SAAA,CAAU,KAAA,CAAM,CAAA,EAAG,CAAC,CAAA,EAAG;AAC5C,QAAA,MAAM,MAAA,GAAA,CAAU,IAAA,CAAK,SAAA,GAAY,IAAA,EAAM,QAAQ,CAAC,CAAA;AAChD,QAAA,KAAA,CAAM,KAAK,CAAA,EAAA,EAAK,IAAA,CAAK,YAAY,CAAA,EAAA,EAAK,MAAM,CAAA,IAAA,CAAM,CAAA;AAAA,MACpD;AACA,MAAA,IAAI,GAAA,CAAI,SAAA,CAAU,MAAA,GAAS,CAAA,EAAG;AAC5B,QAAA,KAAA,CAAM,KAAK,CAAA,UAAA,EAAa,GAAA,CAAI,SAAA,CAAU,MAAA,GAAS,CAAC,CAAA,KAAA,CAAO,CAAA;AAAA,MACzD;AAAA,IACF;AACA,IAAA,QAAA,CAAS,IAAA,CAAK,EAAE,MAAA,EAAQ,YAAA,EAAc,OAAO,CAAA;AAAA,EAC/C;AAGA,EAAA,IAAI,MAAM,OAAA,EAAS;AACjB,IAAA,KAAA,MAAW,GAAA,IAAO,OAAO,QAAA,EAAU;AACjC,MAAA,IAAI,GAAA,CAAI,WAAA,CAAY,MAAA,GAAS,CAAA,EAAG;AAC9B,QAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,WAAA,CAAY,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,CAAE,GAAA,CAAI,CAAA,EAAA,KAAM,CAAA,EAAA,EAAK,EAAE,CAAA,CAAE,CAAA;AAC9D,QAAA,IAAI,GAAA,CAAI,WAAA,CAAY,MAAA,GAAS,EAAA,EAAI;AAC/B,UAAA,KAAA,CAAM,KAAK,CAAA,UAAA,EAAa,GAAA,CAAI,WAAA,CAAY,MAAA,GAAS,EAAE,CAAA,KAAA,CAAO,CAAA;AAAA,QAC5D;AACA,QAAA,QAAA,CAAS,IAAA,CAAK,EAAE,MAAA,EAAQ,CAAA,cAAA,EAAiB,IAAI,WAAW,CAAA,CAAA,EAAI,OAAO,CAAA;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AAGA,EAAA,MAAM,cAAc,MAAA,CAAO,QAAA,CAAS,OAAA,CAAQ,CAAA,CAAA,KAAK,EAAE,QAAQ,CAAA;AAC3D,EAAA,IAAI,WAAA,CAAY,SAAS,CAAA,EAAG;AAC1B,IAAA,QAAA,CAAS,IAAA,CAAK;AAAA,MACZ,MAAA,EAAQ,UAAA;AAAA,MACR,KAAA,EAAO,WAAA,CAAY,KAAA,CAAM,CAAA,EAAG,EAAE;AAAA,KAC/B,CAAA;AAAA,EACH;AAGA,EAAA,MAAM,eAAe,MAAA,CAAO,OAAA,CAAQ,cAAA,GAAiB,IAAA,EAAM,QAAQ,CAAC,CAAA;AACpE,EAAA,MAAM,YAAA,GAAe;AAAA,IACnB,CAAA,kBAAA,EAAqB,MAAA,CAAO,OAAA,CAAQ,aAAa,CAAA,CAAA;AAAA,IACjD,CAAA,oBAAA,EAAuB,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,CAAA;AAAA,IAChD,CAAA,aAAA,EAAgB,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,CAAA;AAAA,IACzC,CAAA,YAAA,EAAe,MAAA,CAAO,OAAA,CAAQ,SAAS,CAAA,CAAA;AAAA,IACvC,OAAO,OAAA,CAAQ,SAAA,GAAY,CAAA,GAAI,CAAA,gBAAA,EAAmB,WAAW,CAAA,GAAA,CAAA,GAAQ,IAAA;AAAA,IACrE,MAAA,CAAO,OAAA,CAAQ,gBAAA,CAAiB,MAAA,GAAS,CAAA,GACrC,sBAAsB,MAAA,CAAO,OAAA,CAAQ,gBAAA,CAAiB,MAAM,CAAA,CAAA,GAC5D,IAAA;AAAA,IACJ,cAAc,MAAA,CAAO,QAAA,GAAW,GAAA,EAAM,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA,CAAA;AAAA,IAChD,MAAA,CAAO,SAAS,yCAAA,GAAuC;AAAA,GACzD,CAAE,OAAO,OAAO,CAAA;AAChB,EAAA,QAAA,CAAS,KAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,KAAA,EAAO,cAAc,CAAA;AAGxD,EAAA,IAAI,MAAA,CAAO,OAAA,CAAQ,SAAA,GAAY,CAAA,EAAG;AAChC,IAAA,QAAA,CAAS,IAAA,CAAK;AAAA,MACZ,MAAA,EAAQ,YAAA;AAAA,MACR,KAAA,EAAO;AAAA,QACL,qDAAA;AAAA,QACA,oDAAA;AAAA,QACA;AAAA;AACF,KACD,CAAA;AAAA,EACH;AAEA,EAAA,MAAM,KAAA,GACJ,OAAO,OAAA,CAAQ,SAAA,KAAc,IACzB,qBAAA,GACA,CAAA,EAAG,MAAA,CAAO,OAAA,CAAQ,SAAS,CAAA,mBAAA,CAAA;AAEjC,EAAA,EAAA,EAAI,OAAA,GAAU,8BAAA,EAAgC,EAAE,KAAA,EAAO,UAAU,CAAA;AACnE;AAEA,SAAS,mBAAA,CACP,MAAA,EACA,KAAA,EACA,EAAA,EACM;AACN,EAAA,MAAM,QAAA,GAAW,MAAM,SAAS,CAAA;AAChC,EAAA,MAAM,MAAA,GAAS,WAAW,iBAAA,GAAoB,cAAA;AAE9C,EAAA,MAAM,WAAuD,EAAC;AAE9D,EAAA,MAAM,KAAA,GAAQ;AAAA,IACZ,CAAA,EAAG,MAAM,CAAA,QAAA,EAAW,MAAA,CAAO,YAAY,CAAA,QAAA,CAAA;AAAA,IACvC,CAAA,EAAG,MAAM,CAAA,MAAA,EAAA,CAAU,MAAA,CAAO,eAAe,IAAA,EAAM,OAAA,CAAQ,CAAC,CAAC,CAAA,GAAA;AAAA,GAC3D;AAEA,EAAA,IAAI,MAAA,CAAO,mBAAmB,CAAA,EAAG;AAC/B,IAAA,KAAA,CAAM,IAAA,CAAK,CAAA,EAAG,MAAM,CAAA,QAAA,EAAW,MAAA,CAAO,gBAAgB,CAAA,eAAA,EAAkB,MAAA,CAAO,gBAAA,KAAqB,CAAA,GAAI,GAAA,GAAM,KAAK,CAAA,CAAE,CAAA;AAAA,EACvH;AACA,EAAA,IAAI,MAAA,CAAO,mBAAmB,CAAA,EAAG;AAC/B,IAAA,KAAA,CAAM,KAAK,CAAA,EAAG,MAAM,CAAA,OAAA,EAAU,MAAA,CAAO,gBAAgB,CAAA,uBAAA,CAAyB,CAAA;AAAA,EAChF;AAEA,EAAA,QAAA,CAAS,KAAK,EAAE,MAAA,EAAQ,WAAW,SAAA,GAAY,kBAAA,EAAoB,OAAO,CAAA;AAE1E,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,QAAA,CAAS,IAAA,CAAK;AAAA,MACZ,MAAA,EAAQ,QAAA;AAAA,MACR,KAAA,EAAO;AAAA,QACL,CAAA,WAAA,EAAc,OAAO,QAAQ,CAAA,CAAA;AAAA,QAC7B,CAAA,gDAAA,EAAmD,OAAO,QAAQ,CAAA;AAAA;AACpE,KACD,CAAA;AAAA,EACH;AAGA,EAAA,MAAM,YAAsB,EAAC;AAC7B,EAAA,KAAA,MAAW,QAAQ,MAAA,CAAO,QAAA,CAAS,aAAa,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,EAAG;AAC5D,IAAA,MAAM,MAAA,GAAA,CAAU,IAAA,CAAK,SAAA,GAAY,IAAA,EAAM,QAAQ,CAAC,CAAA;AAChD,IAAA,SAAA,CAAU,KAAK,CAAA,EAAG,IAAA,CAAK,UAAU,CAAA,EAAA,EAAK,MAAM,CAAA,IAAA,CAAM,CAAA;AAAA,EACpD;AACA,EAAA,IAAI,MAAA,CAAO,QAAA,CAAS,YAAA,CAAa,MAAA,GAAS,EAAA,EAAI;AAC5C,IAAA,SAAA,CAAU,KAAK,CAAA,QAAA,EAAW,MAAA,CAAO,SAAS,YAAA,CAAa,MAAA,GAAS,EAAE,CAAA,KAAA,CAAO,CAAA;AAAA,EAC3E;AACA,EAAA,QAAA,CAAS,KAAK,EAAE,MAAA,EAAQ,OAAA,EAAS,KAAA,EAAO,WAAW,CAAA;AAEnD,EAAA,MAAM,KAAA,GAAQ,WACV,CAAA,uBAAA,EAA0B,MAAA,CAAO,YAAY,CAAA,QAAA,CAAA,GAC7C,CAAA,QAAA,EAAW,OAAO,YAAY,CAAA,QAAA,CAAA;AAElC,EAAA,EAAA,EAAI,OAAA,GAAU,KAAA,EAAO,EAAE,KAAA,EAAO,UAAU,CAAA;AAC1C;AAEA,SAAS,gBAAA,CACP,SACA,EAAA,EACM;AACN,EAAA,IAAI,OAAA,CAAQ,WAAW,CAAA,EAAG;AACxB,IAAA,EAAA,EAAI,OAAO,mBAAmB,CAAA;AAC9B,IAAA;AAAA,EACF;AAEA,EAAA,MAAM,WAAuD,EAAC;AAE9D,EAAA,KAAA,MAAW,UAAU,OAAA,EAAS;AAC5B,IAAA,MAAM,OAAO,IAAI,IAAA,CAAK,MAAA,CAAO,SAAS,EAAE,cAAA,EAAe;AACvD,IAAA,MAAM,KAAA,GAAQ;AAAA,MACZ,SAAS,IAAI,CAAA,CAAA;AAAA,MACb,CAAA,KAAA,EAAQ,OAAO,SAAS,CAAA,GAAA,EAAM,OAAO,MAAA,CAAO,KAAA,CAAM,CAAA,EAAG,CAAC,CAAC,CAAA,CAAA;AAAA,MACvD,CAAA,OAAA,EAAU,OAAO,iBAAiB,CAAA,CAAA;AAAA,MAClC,UAAU,MAAA,CAAO,iBAAA,GAAoB,IAAA,EAAM,OAAA,CAAQ,CAAC,CAAC,CAAA,GAAA,CAAA;AAAA,MACrD,CAAA,6CAAA,EAAgD,OAAO,EAAE,CAAA;AAAA,KAC3D;AACA,IAAA,QAAA,CAAS,IAAA,CAAK,EAAE,MAAA,EAAQ,CAAA,QAAA,EAAW,OAAO,EAAE,CAAA,CAAA,EAAI,OAAO,CAAA;AAAA,EACzD;AAEA,EAAA,EAAA,EAAI,OAAA,GAAU,CAAA,EAAG,OAAA,CAAQ,MAAM,CAAA,gBAAA,CAAA,EAAoB;AAAA,IACjD,KAAA,EAAO,mBAAA;AAAA,IACP;AAAA,GACD,CAAA;AACH","file":"dead-code.js","sourcesContent":["/**\n * quality:dead-code - Detect and optionally remove dead source files\n *\n * Uses reachability analysis: builds import graph, walks from entry points,\n * files not reachable are dead. Zero false positives by design.\n */\n\nimport { defineCommand, type PluginContextV3 } from '@kb-labs/sdk';\nimport type { UIFacade } from '@kb-labs/sdk';\nimport type { DeadCodeResult, DeadCodeRemovalResult, DeadCodeBackupManifest } from '@kb-labs/quality-contracts';\nimport { CACHE_KEYS } from '@kb-labs/quality-contracts';\nimport {\n  scanDeadFiles,\n  removeDeadFiles,\n  restoreFromBackup,\n  listBackups,\n} from '@kb-labs/quality-core/dead-code';\nimport type { DeadCodeFlags } from './flags.js';\n\ntype DeadCodeInput = DeadCodeFlags & { argv?: string[] };\n\ntype DeadCodeCommandResult = {\n  exitCode: number;\n  result?: DeadCodeResult | DeadCodeRemovalResult | DeadCodeBackupManifest[];\n  meta?: Record<string, unknown>;\n};\n\nexport default defineCommand({\n  id: 'quality:dead-code',\n  description: 'Detect and optionally remove dead (unreachable) source files',\n\n  handler: {\n    async execute(\n      ctx: PluginContextV3,\n      input: DeadCodeInput,\n    ): Promise<DeadCodeCommandResult> {\n      const { ui, platform } = ctx;\n      // V3: Flags may come wrapped in input.flags or passed directly\n      const flags = ('flags' in input && typeof (input as { flags?: unknown }).flags === 'object' && (input as { flags?: unknown }).flags !== null)\n        ? (input as { flags: DeadCodeInput }).flags\n        : input;\n\n      // --- Sub-operations ---\n\n      // List backups\n      if (flags['list-backups']) {\n        const backups = listBackups(ctx.cwd);\n        if (flags.json) {\n          ui?.json?.(backups);\n        } else {\n          outputBackupList(backups, ui);\n        }\n        return { exitCode: 0, result: backups };\n      }\n\n      // Restore from backup\n      if (flags.restore) {\n        try {\n          const result = await restoreFromBackup(ctx.cwd, flags.restore);\n          if (flags.json) {\n            ui?.json?.(result);\n          } else {\n            ui?.success?.(`Restored ${result.restoredFiles} file(s) from backup ${flags.restore}`, {});\n            if (result.restoredExports > 0) {\n              ui?.info?.(`Note: ${result.restoredExports} package.json export(s) were cleaned. You may need to rebuild.`);\n            }\n          }\n          return { exitCode: 0 };\n        } catch (err: unknown) {\n          if (flags.json) {\n            ui?.json?.({ error: err instanceof Error ? err.message : String(err) });\n          } else {\n            ui?.error?.(err instanceof Error ? err.message : String(err));\n          }\n          return { exitCode: 1 };\n        }\n      }\n\n      // --- Main scan flow ---\n\n      // Check cache\n      const cacheKey = `${CACHE_KEYS.DEAD_CODE}:${flags.package || 'all'}`;\n      if (!flags.refresh && !flags['auto-remove']) {\n        const cached = await platform.cache.get<DeadCodeResult>(cacheKey);\n        if (cached) {\n          outputDeadCodeReport({ ...cached, cached: true }, flags, ui);\n          return { exitCode: cached.summary.totalDead > 0 ? 1 : 0, result: cached };\n        }\n      }\n\n      // Run scan\n      const result = await scanDeadFiles(ctx.cwd, {\n        packageFilter: flags.package,\n        verbose: flags.verbose,\n      });\n\n      // Cache results for 5 minutes\n      await platform.cache.set(cacheKey, result, 5 * 60 * 1000);\n\n      // Track analytics\n      await platform.analytics.track('quality:dead-code', {\n        totalPackages: result.summary.totalPackages,\n        totalFiles: result.summary.totalFiles,\n        totalDead: result.summary.totalDead,\n        totalDeadBytes: result.summary.totalDeadBytes,\n        duration: result.duration,\n        autoRemove: !!flags['auto-remove'],\n        dryRun: !!flags['dry-run'],\n      });\n\n      // Auto-remove flow\n      if (flags['auto-remove']) {\n        if (result.summary.totalDead === 0) {\n          if (flags.json) {\n            ui?.json?.({ message: 'No dead files found', ...result });\n          } else {\n            ui?.success?.('No dead files found. Nothing to remove.', {});\n          }\n          return { exitCode: 0, result };\n        }\n\n        const removalResult = await removeDeadFiles(ctx.cwd, result, {\n          dryRun: flags['dry-run'],\n        });\n\n        if (flags.json) {\n          ui?.json?.(removalResult);\n        } else {\n          outputRemovalReport(removalResult, flags, ui);\n        }\n\n        return { exitCode: 0, result: removalResult };\n      }\n\n      // Output scan results\n      outputDeadCodeReport({ ...result, cached: false }, flags, ui);\n\n      return {\n        exitCode: result.summary.totalDead > 0 ? 1 : 0,\n        result,\n      };\n    },\n  },\n});\n\n// --- Output helpers ---\n\nfunction outputDeadCodeReport(\n  result: DeadCodeResult & { cached?: boolean },\n  flags: DeadCodeFlags,\n  ui: UIFacade | undefined,\n): void {\n  if (flags.json) {\n    ui?.json?.(result);\n    return;\n  }\n\n  const sections: Array<{ header: string; items: string[] }> = [];\n\n  // Per-package results (only packages with dead files)\n  const packagesWithDead = result.packages.filter(p => p.deadFiles.length > 0);\n\n  if (packagesWithDead.length > 0) {\n    const items: string[] = [];\n    for (const pkg of packagesWithDead) {\n      items.push(`${pkg.packageName} (${pkg.deadFiles.length} dead file${pkg.deadFiles.length === 1 ? '' : 's'})`);\n      for (const dead of pkg.deadFiles.slice(0, 5)) {\n        const sizeKb = (dead.sizeBytes / 1024).toFixed(1);\n        items.push(`  ${dead.relativePath} (${sizeKb} KB)`);\n      }\n      if (pkg.deadFiles.length > 5) {\n        items.push(`  ... and ${pkg.deadFiles.length - 5} more`);\n      }\n    }\n    sections.push({ header: 'Dead Files', items });\n  }\n\n  // Verbose: show entry points\n  if (flags.verbose) {\n    for (const pkg of result.packages) {\n      if (pkg.entryPoints.length > 0) {\n        const items = pkg.entryPoints.slice(0, 10).map(ep => `  ${ep}`);\n        if (pkg.entryPoints.length > 10) {\n          items.push(`  ... and ${pkg.entryPoints.length - 10} more`);\n        }\n        sections.push({ header: `Entry Points: ${pkg.packageName}`, items });\n      }\n    }\n  }\n\n  // Warnings\n  const allWarnings = result.packages.flatMap(p => p.warnings);\n  if (allWarnings.length > 0) {\n    sections.push({\n      header: 'Warnings',\n      items: allWarnings.slice(0, 10),\n    });\n  }\n\n  // Summary\n  const totalDeadKb = (result.summary.totalDeadBytes / 1024).toFixed(1);\n  const summaryItems = [\n    `Packages scanned: ${result.summary.totalPackages}`,\n    `Total source files: ${result.summary.totalFiles}`,\n    `Alive files: ${result.summary.totalAlive}`,\n    `Dead files: ${result.summary.totalDead}`,\n    result.summary.totalDead > 0 ? `Dead code size: ${totalDeadKb} KB` : null,\n    result.summary.emptyDirectories.length > 0\n      ? `Empty directories: ${result.summary.emptyDirectories.length}`\n      : null,\n    `Duration: ${(result.duration / 1000).toFixed(1)}s`,\n    result.cached ? '(cached — use --refresh to rescan)' : null,\n  ].filter(Boolean) as string[];\n  sections.push({ header: 'Summary', items: summaryItems });\n\n  // Recommendations\n  if (result.summary.totalDead > 0) {\n    sections.push({\n      header: 'Next Steps',\n      items: [\n        'Run with --auto-remove --dry-run to preview removal',\n        'Run with --auto-remove to remove and create backup',\n        'Run with --verbose to see entry points',\n      ],\n    });\n  }\n\n  const title =\n    result.summary.totalDead === 0\n      ? 'No dead files found'\n      : `${result.summary.totalDead} dead file(s) found`;\n\n  ui?.success?.('Dead code analysis completed', { title, sections });\n}\n\nfunction outputRemovalReport(\n  result: DeadCodeRemovalResult,\n  flags: DeadCodeFlags,\n  ui: UIFacade | undefined,\n): void {\n  const isDryRun = flags['dry-run'];\n  const prefix = isDryRun ? '[DRY RUN] Would' : 'Successfully';\n\n  const sections: Array<{ header: string; items: string[] }> = [];\n\n  const items = [\n    `${prefix} remove ${result.filesRemoved} file(s)`,\n    `${prefix} free ${(result.bytesRemoved / 1024).toFixed(1)} KB`,\n  ];\n\n  if (result.emptyDirsRemoved > 0) {\n    items.push(`${prefix} remove ${result.emptyDirsRemoved} empty director${result.emptyDirsRemoved === 1 ? 'y' : 'ies'}`);\n  }\n  if (result.exportsCleanedUp > 0) {\n    items.push(`${prefix} clean ${result.exportsCleanedUp} package.json export(s)`);\n  }\n\n  sections.push({ header: isDryRun ? 'Preview' : 'Removal Complete', items });\n\n  if (!isDryRun) {\n    sections.push({\n      header: 'Backup',\n      items: [\n        `Backup ID: ${result.backupId}`,\n        `To restore: pnpm kb quality:dead-code --restore ${result.backupId}`,\n      ],\n    });\n  }\n\n  // Show removed files\n  const fileItems: string[] = [];\n  for (const file of result.manifest.removedFiles.slice(0, 10)) {\n    const sizeKb = (file.sizeBytes / 1024).toFixed(1);\n    fileItems.push(`${file.backupPath} (${sizeKb} KB)`);\n  }\n  if (result.manifest.removedFiles.length > 10) {\n    fileItems.push(`... and ${result.manifest.removedFiles.length - 10} more`);\n  }\n  sections.push({ header: 'Files', items: fileItems });\n\n  const title = isDryRun\n    ? `[DRY RUN] Would remove ${result.filesRemoved} file(s)`\n    : `Removed ${result.filesRemoved} file(s)`;\n\n  ui?.success?.(title, { title, sections });\n}\n\nfunction outputBackupList(\n  backups: DeadCodeBackupManifest[],\n  ui: UIFacade | undefined,\n): void {\n  if (backups.length === 0) {\n    ui?.info?.('No backups found.');\n    return;\n  }\n\n  const sections: Array<{ header: string; items: string[] }> = [];\n\n  for (const backup of backups) {\n    const date = new Date(backup.createdAt).toLocaleString();\n    const items = [\n      `Date: ${date}`,\n      `Git: ${backup.gitBranch} @ ${backup.gitSha.slice(0, 8)}`,\n      `Files: ${backup.totalFilesRemoved}`,\n      `Size: ${(backup.totalBytesRemoved / 1024).toFixed(1)} KB`,\n      `Restore: pnpm kb quality:dead-code --restore ${backup.id}`,\n    ];\n    sections.push({ header: `Backup: ${backup.id}`, items });\n  }\n\n  ui?.success?.(`${backups.length} backup(s) found`, {\n    title: 'Dead Code Backups',\n    sections,\n  });\n}\n"]}
+{"version":3,"sources":["../../../src/cli/commands/dead-code.ts"],"names":[],"mappings":"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","file":"dead-code.js","sourcesContent":["import {\n  defineCommand,\n  useConfig,\n  type CLIInput,\n  type PluginContextV3,\n} from '@kb-labs/sdk';\nimport { runKnip } from '@kb-labs/quality-core';\nimport { defaultQualityConfig, type QualityPluginConfig } from '@kb-labs/quality-contracts';\nimport type { DeadCodeFlags } from './flags.js';\n\nexport default defineCommand<unknown, CLIInput<DeadCodeFlags>, { exitCode: number }>({\n  id: 'quality:dead-code',\n  description: 'Detect unused files, exports, and deps via knip',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<DeadCodeFlags>): Promise<{ exitCode: number }> {\n      const { flags } = input;\n      const config = await useConfig<QualityPluginConfig>();\n      const cwd = ctx.cwd ?? process.cwd();\n      const cfg = config ?? defaultQualityConfig;\n\n      if (!cfg.knip.enabled) {\n        ctx.ui?.success?.('knip is disabled in config (knip.enabled = false)');\n        return { exitCode: 0 };\n      }\n\n      const report = await runKnip({ shell: ctx.api.shell, rootDir: cwd });\n\n      if (flags.json) {\n        ctx.ui?.json?.(report);\n        return { exitCode: report.totalIssues > 0 ? 1 : 0 };\n      }\n\n      if (report.totalIssues === 0) {\n        ctx.ui?.success?.('No dead code detected');\n        return { exitCode: 0 };\n      }\n\n      const sections: Array<{ header: string; items: string[] }> = [];\n\n      if (report.unusedFiles.length > 0) {\n        sections.push({\n          header: `Unused files (${report.unusedFiles.length})`,\n          items: report.unusedFiles,\n        });\n      }\n\n      if (report.unusedExports.length > 0) {\n        sections.push({\n          header: `Unused exports (${report.unusedExports.length})`,\n          items: report.unusedExports.map(e => `${e.file}  ${e.symbol}`),\n        });\n      }\n\n      if (report.unusedDependencies.length > 0) {\n        sections.push({\n          header: `Unused dependencies (${report.unusedDependencies.length})`,\n          items: report.unusedDependencies.map(d => `${d.package}  in ${d.workspace}`),\n        });\n      }\n\n      if (report.unlistedDependencies.length > 0) {\n        sections.push({\n          header: `Unlisted dependencies (${report.unlistedDependencies.length})`,\n          items: report.unlistedDependencies.map(d => `${d.package}  in ${d.workspace}`),\n        });\n      }\n\n      ctx.ui?.error?.(`${report.totalIssues} dead code issue(s) found`, { sections });\n      return { exitCode: 1 };\n    },\n  },\n});\n"]}

package/dist/cli/commands/fix-deps.d.ts

@@ -1,9 +1,7 @@
 import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
 import { FixDepsFlags } from './flags.js';
 
-type FixDepsInput = FixDepsFlags & {
-    argv?: string[];
-};
 interface FixResult {
     packagesScanned: number;
     removedDeps: Array<{
@@ -21,8 +19,7 @@ interface FixResult {
         to: string;
         packages: string[];
     }>;
-    dryRun: boolean;
 }
-declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, FixDepsInput, FixResult>;
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<FixDepsFlags>, FixResult>;
 
 export { _default as default };

package/dist/cli/commands/fix-deps.js

@@ -1,4 +1,4 @@
-import { defineCommand, useLoader } from '@kb-labs/sdk';
+import { defineCommand, validationError, useLoader } from '@kb-labs/sdk';
 import fs from 'fs';
 import path from 'path';
 
@@ -7,10 +7,39 @@ var fix_deps_default = defineCommand({
   id: "quality:fix-deps",
   description: "Auto-fix dependency issues",
   handler: {
+    async intent(_ctx, input) {
+      const flags = input.flags;
+      const removeUnused = flags["remove-unused"] || flags.all;
+      const addMissing = flags["add-missing"] || flags.all;
+      const alignVersions = flags["align-versions"] || flags.all;
+      const packages = findPackages(_ctx.cwd);
+      const preview = await runAnalysis(packages, { removeUnused, addMissing, alignVersions, dryRun: true });
+      const operations = [
+        ...preview.alignedDeps.map((a) => ({
+          type: "update",
+          resource: "dependency",
+          details: { dep: a.dep, from: a.from, to: a.to, packages: a.packages }
+        })),
+        ...preview.addedDeps.map((a) => ({
+          type: "create",
+          resource: "dependency",
+          details: { package: a.package, dep: a.dep, version: a.version }
+        })),
+        ...preview.removedDeps.map((r) => ({
+          type: "delete",
+          resource: "dependency",
+          details: { package: r.package, dep: r.dep }
+        }))
+      ];
+      const total = operations.length;
+      return {
+        summary: total > 0 ? `Fix ${total} dependency issue(s) across ${preview.packagesScanned} packages` : `No dependency issues found in ${preview.packagesScanned} packages`,
+        operations
+      };
+    },
     async execute(ctx, input) {
       const { ui, platform } = ctx;
-      const flags = "flags" in input && typeof input.flags === "object" && input.flags !== null ? input.flags : input;
-      const dryRun = flags["dry-run"] ?? false;
+      const flags = input.flags;
       const removeUnused = flags["remove-unused"] || flags.all;
       const addMissing = flags["add-missing"] || flags.all;
       const alignVersions = flags["align-versions"] || flags.all;
@@ -21,52 +50,45 @@ var fix_deps_default = defineCommand({
         return { exitCode: 0 };
       }
       if (!removeUnused && !addMissing && !alignVersions) {
-        ui?.error?.("No fix options specified. Use --remove-unused, --add-missing, --align-versions, or --all");
+        validationError(ctx, "No fix options specified", "Use --remove-unused, --add-missing, --align-versions, or --all", flags.json);
         return { exitCode: 1 };
       }
       const loader = useLoader("Scanning packages...");
       loader.start();
-      const result = {
-        packagesScanned: 0,
-        removedDeps: [],
-        addedDeps: [],
-        alignedDeps: [],
-        dryRun
-      };
       const packages = findPackages(ctx.cwd);
-      result.packagesScanned = packages.length;
       loader.update({ text: `Scanned ${packages.length} packages` });
-      if (alignVersions) {
-        loader.update({ text: "Analyzing duplicate dependencies..." });
-        const aligned = await alignDuplicateVersions(packages, dryRun);
-        result.alignedDeps = aligned;
-      }
-      if (addMissing) {
-        loader.update({ text: "Checking for missing workspace dependencies..." });
-        const added = await addMissingWorkspaceDeps(packages, dryRun);
-        result.addedDeps = added;
-      }
-      if (removeUnused) {
-        loader.update({ text: "Checking for unused dependencies..." });
-        const removed = await removeUnusedDeps(packages, dryRun);
-        result.removedDeps = removed;
-      }
+      const result = await runAnalysis(packages, { removeUnused, addMissing, alignVersions, dryRun: false });
       loader.succeed("Dependency analysis completed");
       await platform.analytics.track("quality:fix-deps", {
-        dryRun,
+        dryRun: false,
         packagesScanned: result.packagesScanned,
         removedCount: result.removedDeps.length,
         addedCount: result.addedDeps.length,
         alignedCount: result.alignedDeps.length
       });
-      outputResults(result, flags, ui);
-      return {
-        exitCode: 0,
-        result
-      };
+      outputResults({ ...result, dryRun: false }, flags, ui);
+      return { exitCode: 0, result };
     }
   }
 });
+async function runAnalysis(packages, opts) {
+  const result = {
+    packagesScanned: packages.length,
+    removedDeps: [],
+    addedDeps: [],
+    alignedDeps: []
+  };
+  if (opts.alignVersions) {
+    result.alignedDeps = await alignDuplicateVersions(packages, opts.dryRun);
+  }
+  if (opts.addMissing) {
+    result.addedDeps = await addMissingWorkspaceDeps(packages, opts.dryRun);
+  }
+  if (opts.removeUnused) {
+    result.removedDeps = await removeUnusedDeps(packages, opts.dryRun);
+  }
+  return result;
+}
 function findPackages(rootDir) {
   const packages = [];
   if (!fs.existsSync(rootDir)) {
@@ -161,12 +183,7 @@ async function alignDuplicateVersions(packages, dryRun) {
       continue;
     }
     for (const { version, packages: pkgNames } of versionCounts.slice(1)) {
-      aligned.push({
-        dep,
-        from: version,
-        to: targetVersion,
-        packages: pkgNames
-      });
+      aligned.push({ dep, from: version, to: targetVersion, packages: pkgNames });
       if (!dryRun) {
         for (const pkgName of pkgNames) {
           const pkg = packages.find((p) => p.name === pkgName);
@@ -207,11 +224,7 @@ async function addMissingWorkspaceDeps(packages, dryRun) {
     };
     for (const imp of imports) {
       if (imp.startsWith("@kb-labs/") && workspacePackages.has(imp) && !currentDeps[imp]) {
-        added.push({
-          package: pkg.name,
-          dep: imp,
-          version: "workspace:*"
-        });
+        added.push({ package: pkg.name, dep: imp, version: "workspace:*" });
         if (!dryRun) {
           if (!pkg.json.dependencies) {
             pkg.json.dependencies = {};
@@ -242,10 +255,7 @@ async function removeUnusedDeps(packages, dryRun) {
         continue;
       }
       if (!imports.has(dep)) {
-        removed.push({
-          package: pkg.name,
-          dep
-        });
+        removed.push({ package: pkg.name, dep });
         if (!dryRun) {
           delete pkg.json.dependencies?.[dep];
           delete pkg.json.devDependencies?.[dep];
@@ -321,7 +331,7 @@ function outputStats(stats, flags, ui) {
     });
   }
   ui?.success?.("Dependency statistics", {
-    title: "\u{1F4CA} Dependency Statistics",
+    title: "Dependency Statistics",
     sections
   });
 }
@@ -331,55 +341,36 @@ function outputResults(result, flags, ui) {
     return;
   }
   const sections = [];
-  const summaryItems = [
-    `Packages Scanned: ${result.packagesScanned}`,
-    `Mode: ${result.dryRun ? "\u{1F50D} Dry Run (no changes applied)" : "\u2705 Changes Applied"}`
-  ];
-  sections.push({ header: "Summary", items: summaryItems });
+  sections.push({
+    header: "Summary",
+    items: [`Packages Scanned: ${result.packagesScanned}`]
+  });
   if (result.alignedDeps.length > 0) {
-    const alignedItems = result.alignedDeps.map(
-      (a) => `${a.dep}: ${a.from} \u2192 ${a.to} (${a.packages.length} packages)`
-    );
-    sections.push({ header: "Aligned Versions", items: alignedItems.slice(0, 10) });
+    const items = result.alignedDeps.slice(0, 10).map((a) => `${a.dep}: ${a.from} \u2192 ${a.to} (${a.packages.length} packages)`);
     if (result.alignedDeps.length > 10) {
-      const lastSection = sections[sections.length - 1];
-      if (lastSection) {
-        lastSection.items.push(`... and ${result.alignedDeps.length - 10} more`);
-      }
+      items.push(`... and ${result.alignedDeps.length - 10} more`);
     }
+    sections.push({ header: "Aligned Versions", items });
   }
   if (result.addedDeps.length > 0) {
-    const addedItems = result.addedDeps.map((a) => `${a.package}: +${a.dep}`);
-    sections.push({ header: "Added Dependencies", items: addedItems.slice(0, 10) });
+    const items = result.addedDeps.slice(0, 10).map((a) => `${a.package}: +${a.dep}`);
     if (result.addedDeps.length > 10) {
-      const lastSection = sections[sections.length - 1];
-      if (lastSection) {
-        lastSection.items.push(`... and ${result.addedDeps.length - 10} more`);
-      }
+      items.push(`... and ${result.addedDeps.length - 10} more`);
     }
+    sections.push({ header: "Added Dependencies", items });
   }
   if (result.removedDeps.length > 0) {
-    const removedItems = result.removedDeps.map((r) => `${r.package}: -${r.dep}`);
-    sections.push({ header: "Removed Dependencies", items: removedItems.slice(0, 10) });
+    const items = result.removedDeps.slice(0, 10).map((r) => `${r.package}: -${r.dep}`);
     if (result.removedDeps.length > 10) {
-      const lastSection = sections[sections.length - 1];
-      if (lastSection) {
-        lastSection.items.push(`... and ${result.removedDeps.length - 10} more`);
-      }
+      items.push(`... and ${result.removedDeps.length - 10} more`);
     }
+    sections.push({ header: "Removed Dependencies", items });
   }
   if (result.alignedDeps.length === 0 && result.addedDeps.length === 0 && result.removedDeps.length === 0) {
-    sections.push({ header: "Result", items: ["\u2705 No issues found!"] });
-  }
-  if (result.dryRun && (result.alignedDeps.length > 0 || result.addedDeps.length > 0 || result.removedDeps.length > 0)) {
-    sections.push({
-      header: "Next Steps",
-      items: ["Remove --dry-run flag to apply changes", "Run `pnpm install` after applying changes"]
-    });
+    sections.push({ header: "Result", items: ["No issues found!"] });
   }
-  const title = result.dryRun ? "\u{1F50D} Dependency Fix Preview" : "\u2705 Dependency Fix Complete";
   ui?.success?.("Dependency fix completed", {
-    title,
+    title: "Dependency Fix Complete",
     sections
   });
 }