@aiready/cli 0.14.13 → 0.14.15

package/src/commands/upload.ts

@@ -1,129 +0,0 @@
-import fs from 'fs';
-import { resolve as resolvePath } from 'path';
-import chalk from 'chalk';
-import { handleCLIError } from '@aiready/core';
-
-interface UploadOptions {
-  apiKey?: string;
-  repoId?: string;
-  server?: string;
-}
-
-export async function uploadAction(file: string, options: UploadOptions) {
-  const startTime = Date.now();
-  const filePath = resolvePath(process.cwd(), file);
-  const serverUrl =
-    options.server ??
-    process.env.AIREADY_SERVER ??
-    'https://dev.platform.getaiready.dev';
-  const apiKey = options.apiKey ?? process.env.AIREADY_API_KEY;
-
-  if (!apiKey) {
-    console.error(chalk.red('❌ API Key is required for upload.'));
-    console.log(
-      chalk.dim(
-        '   Set AIREADY_API_KEY environment variable or use --api-key flag.'
-      )
-    );
-    console.log(
-      chalk.dim(
-        '   Get an API key from https://platform.getaiready.dev/dashboard'
-      )
-    );
-    process.exit(1);
-  }
-
-  if (!fs.existsSync(filePath)) {
-    console.error(chalk.red(`❌ File not found: ${filePath}`));
-    process.exit(1);
-  }
-
-  try {
-    console.log(chalk.blue(`🚀 Uploading report to ${serverUrl}...`));
-
-    // Read the report file
-    console.log(chalk.dim(`   Reading report from ${filePath}...`));
-    const reportContent = fs.readFileSync(filePath, 'utf-8');
-    const reportData = JSON.parse(reportContent);
-    console.log(chalk.dim(`   Successfully parsed report JSON.`));
-
-    // Prepare upload payload
-    // Note: repoId is optional if the metadata contains it, but for now we'll require it or infer from metadata
-    const repoId = options.repoId ?? reportData.repository?.repoId;
-
-    const response = await fetch(`${serverUrl}/api/analysis/upload`, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        Authorization: `Bearer ${apiKey}`,
-      },
-      body: JSON.stringify({
-        data: reportData,
-        repoId, // Might be null, server will handle mapping
-      }),
-    });
-
-    const contentType = response.headers.get('content-type');
-    let uploadResult: any = {};
-
-    if (contentType?.includes('application/json')) {
-      uploadResult = await response.json();
-    } else {
-      const text = await response.text();
-      uploadResult = { error: text ?? response.statusText };
-    }
-
-    if (!response.ok) {
-      console.error(
-        chalk.red(
-          `❌ Upload failed: ${uploadResult.error ?? response.statusText}`
-        )
-      );
-
-      // Special case for redirects or HTML error pages
-      if (contentType?.includes('text/html')) {
-        console.log(
-          chalk.yellow(
-            '   Note: Received an HTML response. This often indicates a redirect (e.g., to a login page) or a server error.'
-          )
-        );
-        if (uploadResult.error?.includes('Redirecting')) {
-          console.log(
-            chalk.dim(
-              '   Detected redirect. Check if the API endpoint requires authentication or has changed.'
-            )
-          );
-        }
-      }
-
-      if (response.status === 401) {
-        console.log(
-          chalk.dim('   Hint: Your API key may be invalid or expired.')
-        );
-      }
-      process.exit(1);
-    }
-
-    const duration = ((Date.now() - startTime) / 1000).toFixed(2);
-    console.log(chalk.green(`\n✅ Upload successful! (${duration}s)`));
-    console.log(chalk.cyan(`   View results: ${serverUrl}/dashboard`));
-
-    if (uploadResult.analysis) {
-      console.log(chalk.dim(`   Analysis ID: ${uploadResult.analysis.id}`));
-      console.log(chalk.dim(`   Score: ${uploadResult.analysis.aiScore}/100`));
-    }
-  } catch (error) {
-    handleCLIError(error, 'Upload');
-  }
-}
-
-export const uploadHelpText = `
-EXAMPLES:
-  $ aiready upload report.json --api-key ar_...
-  $ aiready upload .aiready/latest.json
-  $ AIREADY_API_KEY=ar_... aiready upload report.json
-
-ENVIRONMENT VARIABLES:
-  AIREADY_API_KEY    Your platform API key
-  AIREADY_SERVER     Custom platform URL (default: https://dev.platform.getaiready.dev)
-`;

package/src/commands/visualize.ts

@@ -1,321 +0,0 @@
-/**
- * Visualize command - Generate interactive visualization from an AIReady report
- */
-
-import chalk from 'chalk';
-import { writeFileSync, readFileSync, existsSync, copyFileSync } from 'fs';
-import { resolve as resolvePath } from 'path';
-import { spawn } from 'child_process';
-import { handleCLIError } from '@aiready/core';
-import { generateHTML, findLatestReport } from '@aiready/core';
-
-interface VisualizeOptions {
-  report?: string;
-  output?: string;
-  open?: boolean;
-  serve?: boolean | number;
-  dev?: boolean;
-}
-
-/**
- * CLI action handler for the "visualize" command.
- * Generates an interactive dependency graph visualization of the project
- * to help understand code structure and AI context usage.
- *
- * @param directory - The directory to analyze and visualize
- * @param options - CLI options from commander
- */
-export async function visualizeAction(
-  directory: string,
-  options: VisualizeOptions
-) {
-  try {
-    const dirPath = resolvePath(process.cwd(), directory ?? '.');
-    let reportPath = options.report
-      ? resolvePath(dirPath, options.report)
-      : null;
-
-    // If report not provided or not found, try to find latest scan report
-    if (!reportPath || !existsSync(reportPath)) {
-      const latestScan = findLatestReport(dirPath);
-      if (latestScan) {
-        reportPath = latestScan;
-        console.log(
-          chalk.dim(`Found latest report: ${latestScan.split('/').pop()}`)
-        );
-      } else {
-        console.error(chalk.red('❌ No AI readiness report found'));
-        console.log(
-          chalk.dim(
-            `\nGenerate a report with:\n  aiready scan --output json\n\nOr specify a custom report:\n  aiready visualise --report <path-to-report.json>`
-          )
-        );
-        return;
-      }
-    }
-
-    const raw = readFileSync(reportPath, 'utf8');
-    const report = JSON.parse(raw);
-
-    // Load config to extract graph caps
-    const configPath = resolvePath(dirPath, 'aiready.json');
-    let graphConfig = { maxNodes: 400, maxEdges: 600 };
-
-    if (existsSync(configPath)) {
-      try {
-        const rawConfig = JSON.parse(readFileSync(configPath, 'utf8'));
-        if (rawConfig.visualizer?.graph) {
-          graphConfig = {
-            maxNodes:
-              rawConfig.visualizer.graph.maxNodes ?? graphConfig.maxNodes,
-            maxEdges:
-              rawConfig.visualizer.graph.maxEdges ?? graphConfig.maxEdges,
-          };
-        }
-      } catch (e) {
-        void e;
-        // Silently ignore parse errors and use defaults
-      }
-    }
-
-    // Store config in env for vite middleware to pass to client
-    const envVisualizerConfig = JSON.stringify(graphConfig);
-    process.env.AIREADY_VISUALIZER_CONFIG = envVisualizerConfig;
-
-    console.log('Building graph from report...');
-    const { GraphBuilder } = await import('@aiready/visualizer/graph');
-    const graph = GraphBuilder.buildFromReport(report, dirPath);
-
-    // Check if --dev mode is requested and available
-    let useDevMode = options.dev ?? false;
-    let devServerStarted = false;
-
-    if (useDevMode) {
-      try {
-        const localWebDir = resolvePath(dirPath, 'packages/visualizer');
-        let webDir = '';
-        let visualizerAvailable = false;
-
-        if (existsSync(localWebDir)) {
-          webDir = localWebDir;
-          visualizerAvailable = true;
-        } else {
-          // Try to resolve installed @aiready/visualizer package from node_modules
-          const nodemodulesLocations: string[] = [
-            resolvePath(dirPath, 'node_modules', '@aiready', 'visualizer'),
-            resolvePath(
-              process.cwd(),
-              'node_modules',
-              '@aiready',
-              'visualizer'
-            ),
-          ];
-
-          // Walk up directory tree to find node_modules in parent directories
-          let currentDir = dirPath;
-          while (currentDir !== '/' && currentDir !== '.') {
-            nodemodulesLocations.push(
-              resolvePath(currentDir, 'node_modules', '@aiready', 'visualizer')
-            );
-            const parent = resolvePath(currentDir, '..');
-            if (parent === currentDir) break;
-            currentDir = parent;
-          }
-
-          for (const location of nodemodulesLocations) {
-            if (
-              existsSync(location) &&
-              existsSync(resolvePath(location, 'package.json'))
-            ) {
-              webDir = location;
-              visualizerAvailable = true;
-              break;
-            }
-          }
-
-          // Fallback: try require.resolve
-          if (!visualizerAvailable) {
-            try {
-              const vizPkgPath =
-                require.resolve('@aiready/visualizer/package.json');
-              webDir = resolvePath(vizPkgPath, '..');
-              visualizerAvailable = true;
-            } catch (err) {
-              void err;
-              // Visualizer not found
-            }
-          }
-        }
-
-        // Check if web directory with vite config exists (required for dev mode)
-        const webViteConfigExists =
-          webDir && existsSync(resolvePath(webDir, 'web', 'vite.config.ts'));
-
-        if (visualizerAvailable && webViteConfigExists) {
-          // Dev mode is available - start Vite dev server
-          const spawnCwd = webDir!;
-
-          // Inline report watcher: copy report to web/report-data.json and watch for changes
-          const { watch } = await import('fs');
-          const copyReportToViz = () => {
-            try {
-              const destPath = resolvePath(spawnCwd, 'web', 'report-data.json');
-              copyFileSync(reportPath!, destPath);
-              console.log(`📋 Report synced to ${destPath}`);
-            } catch (e) {
-              console.error('Failed to sync report:', e);
-            }
-          };
-
-          // Initial copy
-          copyReportToViz();
-
-          // Watch source report for changes
-          let watchTimeout: NodeJS.Timeout | null = null;
-          const reportWatcher = watch(reportPath, () => {
-            if (watchTimeout) clearTimeout(watchTimeout);
-            watchTimeout = setTimeout(copyReportToViz, 100);
-          });
-
-          const envForSpawn = {
-            ...process.env,
-            AIREADY_REPORT_PATH: reportPath,
-            AIREADY_VISUALIZER_CONFIG: envVisualizerConfig,
-          };
-          const vite = spawn('pnpm', ['run', 'dev:web'], {
-            cwd: spawnCwd,
-            stdio: 'inherit',
-            shell: true,
-            env: envForSpawn,
-          });
-          const onExit = () => {
-            try {
-              reportWatcher.close();
-            } catch (err) {
-              void err;
-            }
-            try {
-              vite.kill();
-            } catch (err) {
-              void err;
-            }
-            process.exit(0);
-          };
-          process.on('SIGINT', onExit);
-          process.on('SIGTERM', onExit);
-          devServerStarted = true;
-          void devServerStarted;
-          return;
-        } else {
-          console.log(
-            chalk.yellow(
-              '⚠️  Dev server not available (requires local @aiready/visualizer with web assets).'
-            )
-          );
-          console.log(
-            chalk.cyan('   Falling back to static HTML generation...\n')
-          );
-          useDevMode = false;
-        }
-      } catch (err) {
-        console.error('Failed to start dev server:', err);
-        console.log(
-          chalk.cyan('   Falling back to static HTML generation...\n')
-        );
-        useDevMode = false;
-      }
-    }
-
-    // Generate static HTML (default behavior or fallback from failed --dev)
-    console.log('Generating HTML...');
-    const html = generateHTML(graph as any);
-    const defaultOutput = 'visualization.html';
-    const outPath = resolvePath(dirPath, options.output ?? defaultOutput);
-    writeFileSync(outPath, html, 'utf8');
-    console.log(chalk.green(`✅ Visualization written to: ${outPath}`));
-
-    if (options.open || options.serve) {
-      const opener =
-        process.platform === 'darwin'
-          ? 'open'
-          : process.platform === 'win32'
-            ? 'start'
-            : 'xdg-open';
-
-      if (options.serve) {
-        try {
-          const port = typeof options.serve === 'number' ? options.serve : 5173;
-          const http = await import('http');
-          const fsp = await import('fs/promises');
-
-          const server = http.createServer(async (req, res) => {
-            try {
-              const urlPath = req.url ?? '/';
-              if (urlPath === '/' || urlPath === '/index.html') {
-                const content = await fsp.readFile(outPath, 'utf8');
-                res.writeHead(200, {
-                  'Content-Type': 'text/html; charset=utf-8',
-                });
-                res.end(content);
-                return;
-              }
-              res.writeHead(404, { 'Content-Type': 'text/plain' });
-              res.end('Not found');
-            } catch (e: any) {
-              void e;
-              res.writeHead(500, { 'Content-Type': 'text/plain' });
-              res.end('Server error');
-            }
-          });
-
-          server.listen(port, () => {
-            const addr = `http://localhost:${port}/`;
-            console.log(
-              chalk.cyan(`🌐 Local visualization server running at ${addr}`)
-            );
-            spawn(opener, [`"${addr}"`], { shell: true });
-          });
-
-          process.on('SIGINT', () => {
-            server.close();
-            process.exit(0);
-          });
-        } catch (err) {
-          console.error('Failed to start local server:', err);
-        }
-      } else if (options.open) {
-        spawn(opener, [`"${outPath}"`], { shell: true });
-      }
-    }
-  } catch (err: any) {
-    handleCLIError(err, 'Visualization');
-  }
-}
-
-export const visualizeHelpText = `
-EXAMPLES:
-  $ aiready visualize .  # Auto-detects latest report, generates HTML
-  $ aiready visualize . --report .aiready/aiready-report-20260217-143022.json
-  $ aiready visualize . --report report.json -o out/visualization.html --open
-  $ aiready visualize . --report report.json --serve
-  $ aiready visualize . --report report.json --serve 8080
-  $ aiready visualize . --report report.json --dev
-
-NOTES:
-  - The value passed to --report is interpreted relative to the directory argument (first positional).
-    If the report is not found, the CLI will suggest running 'aiready scan' to generate it.
-  - Default output path: visualization.html (in the current directory).
-  - --serve starts a tiny single-file HTTP server (default port: 5173) and opens your browser.
-  - --dev starts a Vite dev server with live reload (requires local @aiready/visualizer installation).
-    When --dev is not available, it falls back to static HTML generation.
-`;
-
-export const visualiseHelpText = `
-EXAMPLES:
-  $ aiready visualise .  # Auto-detects latest report
-  $ aiready visualise . --report .aiready/aiready-report-20260217-143022.json
-  $ aiready visualise . --report report.json --serve 8080
-
-NOTES:
-  - Same options as 'visualize'. Use --serve to host the static HTML, or --dev for live reload.
-`;