feat: add interactive HTML report generator (Phase 2)

.gitignore

@@ -2,6 +2,9 @@
 dist/
 coverage/
 
+# Generated reports
+report/
+
 # Dependencies
 node_modules/
 

package.json

@@ -4,7 +4,7 @@
   "description": "Analyze source code and generate interactive dependency graphs",
   "type": "module",
   "bin": {
-    "codeviz": "./dist/cli.js"
+    "codeviz": "./dist/cli.cjs"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

src/cli.ts

@@ -3,6 +3,7 @@ import { Command } from 'commander'
 import { VERSION } from './index.js'
 import { analyze } from './analyze.js'
 import { renderToTerminal } from './renderer.js'
+import { generateHtmlReport } from './html-report.js'
 
 const program = new Command()
 
@@ -11,19 +12,28 @@ program
   .description('Analyze source code and generate interactive dependency graphs')
   .version(VERSION)
   .argument('[directory]', 'source directory to analyze', '.')
-  .option('--html', 'generate an interactive HTML report (coming in Phase 2)')
+  .option('--html', 'generate an interactive HTML report in the report/ directory')
+  .option('--out-dir <dir>', 'output directory for the HTML report', 'report')
   .option('--show-external', 'include external npm packages in the output')
   .option('--ignore <dirs>', 'comma-separated list of directory names to ignore', '')
-  .action(async (directory: string, options: { html?: boolean; showExternal?: boolean; ignore?: string }) => {
-    if (options.html) {
-      console.warn('--html report generation is not yet implemented (Phase 2).')
-    }
-
+  .action(async (
+    directory: string,
+    options: { html?: boolean; outDir?: string; showExternal?: boolean; ignore?: string },
+  ) => {
     const ignore = options.ignore ? options.ignore.split(',').map((d) => d.trim()).filter(Boolean) : []
 
     try {
       const graph = await analyze(directory, { ignore })
-      renderToTerminal(graph, { showExternal: options.showExternal })
+
+      if (options.html) {
+        const { htmlFile, jsonFile } = await generateHtmlReport(graph, { outDir: options.outDir })
+        console.log(`\n  HTML report generated:`)
+        console.log(`    ${htmlFile}`)
+        console.log(`    ${jsonFile}`)
+        console.log(`\n  Open in browser: file://${htmlFile}\n`)
+      } else {
+        renderToTerminal(graph, { showExternal: options.showExternal })
+      }
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err)
       console.error(`\nError: ${message}\n`)