@merlean/analyzer 2.2.0 → 3.0.0

package/README.md

@@ -0,0 +1,75 @@
+# @merlean/analyzer
+
+AI-powered codebase analyzer that generates site maps for the Merlean AI assistant widget.
+
+## Installation
+
+```bash
+npm install -g @merlean/analyzer
+```
+
+## Usage
+
+```bash
+# Analyze current directory
+ai-bot-analyze --name "My App"
+
+# Analyze specific path
+ai-bot-analyze ./my-project --name "My App"
+
+# Merge into existing site map
+ai-bot-analyze ./admin-panel --merge-with site_abc123
+```
+
+Or use with npx (no installation required):
+
+```bash
+npx @merlean/analyzer ./my-project --name "My App"
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--name, -n <name>` | Site name (required for new analysis) |
+| `--merge-with, -m <siteId>` | Merge into existing site map |
+| `--backend, -b <url>` | Custom backend URL |
+| `--output, -o <file>` | Save site map locally |
+| `--help, -h` | Show help |
+
+## Supported Frameworks
+
+- **JavaScript/TypeScript**: Express, Fastify, NestJS, React, Vue, Angular
+- **PHP**: CodeIgniter, Laravel, Symfony
+- **Python**: Flask, FastAPI, Django
+- **Ruby**: Rails, Sinatra
+- **Go**: Gin, Echo, Chi
+- **Java/Kotlin**: Spring Boot
+
+## How It Works
+
+1. Scans your codebase for API patterns
+2. Extracts route definitions and request schemas
+3. Uploads to Merlean backend for AI analysis
+4. Returns a site ID for widget integration
+
+## Integration
+
+After analysis, add the widget to your site:
+
+```html
+<script src="https://ai-bot-backend.fly.dev/bot.js" data-site-id="YOUR_SITE_ID"></script>
+```
+
+## Platform Support
+
+Pre-compiled binaries are available for:
+- macOS (Apple Silicon / ARM64)
+- macOS (Intel / x64)
+- Linux (x64)
+- Windows (x64)
+
+## Links
+
+- [Documentation](https://github.com/zmaren/merlean#readme)
+- [Report Issues](https://github.com/zmaren/merlean/issues)

package/bin/cli.js

@@ -1,152 +1,67 @@
 #!/usr/bin/env node
 
 /**
- * Merlean Analyzer CLI
+ * Merlean Analyzer - Platform Binary Loader
  * 
- * Scans your codebase and uploads to Merlean backend for AI analysis.
- * No API keys required - analysis happens on our servers.
- * 
- * Usage:
- *   npx @merlean/analyzer ./my-project --name "My App"
+ * This wrapper loads the platform-specific binary for your OS/architecture.
+ * The actual analysis logic is compiled into native binaries.
  */
 
-const { scanCodebase } = require('../lib/analyzer');
+const { spawn } = require('child_process');
 const path = require('path');
 const fs = require('fs');
 
-const DEFAULT_BACKEND = 'https://ai-bot-backend.fly.dev';
-
-// Parse CLI arguments
-function parseArgs() {
-  const args = process.argv.slice(2);
-  const options = {
-    path: null,
-    name: null,
-    backend: DEFAULT_BACKEND,
-    output: null
-  };
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    
-    if (arg === '--name' || arg === '-n') {
-      options.name = args[++i];
-    } else if (arg === '--backend' || arg === '-b') {
-      options.backend = args[++i];
-    } else if (arg === '--output' || arg === '-o') {
-      options.output = args[++i];
-    } else if (arg === '--help' || arg === '-h') {
-      printHelp();
-      process.exit(0);
-    } else if (!arg.startsWith('-') && !options.path) {
-      options.path = arg;
-    }
-  }
-
-  return options;
-}
-
-function printHelp() {
-  console.log(`
-Merlean Analyzer - AI-powered codebase analysis
-
-Usage:
-  npx @merlean/analyzer --name <name>
-  npx @merlean/analyzer <path> --name <name>
-
-Arguments:
-  <path>              Path to codebase (default: current directory)
-
-Options:
-  --name, -n <name>   Site name (required)
-  --backend, -b <url> Backend URL (default: ${DEFAULT_BACKEND})
-  --output, -o <file> Save site map locally (optional)
-  --help, -h          Show this help
-
-Examples:
-  # Analyze current directory
-  npx @merlean/analyzer --name "My App"
-
-  # Analyze specific path
-  npx @merlean/analyzer ./my-app --name "My App"
-
-  # Use custom backend (for local dev)
-  npx @merlean/analyzer --name "My App" --backend http://localhost:3004
-`);
+const PLATFORMS = {
+  'darwin-arm64': '@merlean/analyzer-darwin-arm64',
+  'darwin-x64': '@merlean/analyzer-darwin-x64',
+  'linux-x64': '@merlean/analyzer-linux-x64',
+  'win32-x64': '@merlean/analyzer-win32-x64',
+};
+
+const platformKey = `${process.platform}-${process.arch}`;
+const packageName = PLATFORMS[platformKey];
+
+if (!packageName) {
+  console.error(`\n❌ Unsupported platform: ${platformKey}`);
+  console.error(`\nSupported platforms:`);
+  Object.keys(PLATFORMS).forEach(p => console.error(`  - ${p}`));
+  console.error(`\nPlease open an issue at https://github.com/zmaren/merlean/issues`);
+  process.exit(1);
 }
 
-async function main() {
-  console.log('\n🔍 Merlean Analyzer\n');
-
-  const options = parseArgs();
-
-  // Validate required args
-  if (!options.name) {
-    console.error('❌ Error: --name is required');
-    console.log('   Run with --help for usage');
-    process.exit(1);
-  }
-
-  // Default to current directory if no path provided
-  const codebasePath = path.resolve(options.path || '.');
+let binaryPath;
+try {
+  // Find the platform-specific package
+  const packagePath = require.resolve(`${packageName}/package.json`);
+  const packageDir = path.dirname(packagePath);
+  const binaryName = process.platform === 'win32' ? 'ai-bot-analyze.exe' : 'ai-bot-analyze';
+  binaryPath = path.join(packageDir, 'bin', binaryName);
   
-  if (!fs.existsSync(codebasePath)) {
-    console.error(`❌ Error: Path does not exist: ${codebasePath}`);
-    process.exit(1);
+  if (!fs.existsSync(binaryPath)) {
+    throw new Error('Binary not found in package');
   }
+} catch (e) {
+  console.error(`\n❌ Failed to find binary for ${platformKey}`);
+  console.error(`\nPackage: ${packageName}`);
+  console.error(`Error: ${e.message}`);
+  console.error(`\nTry reinstalling:`);
+  console.error(`  npm install -g @merlean/analyzer`);
+  console.error(`\nOr with npx (downloads fresh):`);
+  console.error(`  npx @merlean/analyzer@latest --help`);
+  process.exit(1);
+}
 
-  console.log(`📁 Scanning: ${codebasePath}`);
-  console.log(`📛 Site name: ${options.name}`);
-
-  try {
-    // Scan codebase locally
-    const fileContents = await scanCodebase(codebasePath);
-    
-    console.log(`\n📤 Uploading to backend for analysis...`);
-    
-    // Send to backend for LLM analysis
-    const response = await fetch(`${options.backend}/api/analyze`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        siteName: options.name,
-        files: fileContents
-      })
-    });
-
-    if (!response.ok) {
-      const error = await response.text();
-      throw new Error(`Backend error: ${response.status} ${error}`);
-    }
-
-    const result = await response.json();
-
-    console.log('\n✅ Analysis complete!');
-    console.log('\n📊 Summary:');
-    console.log(`   Site ID:    ${result.siteId}`);
-    console.log(`   Framework:  ${result.framework || 'Unknown'}`);
-    console.log(`   Routes:     ${result.routes?.length || 0}`);
-    console.log(`   Forms:      ${result.forms?.length || 0}`);
-    console.log(`   Actions:    ${result.actions?.length || 0}`);
-
-    // Save locally if requested
-    if (options.output) {
-      const outputPath = path.resolve(options.output);
-      fs.writeFileSync(outputPath, JSON.stringify(result, null, 2));
-      console.log(`\n💾 Saved to: ${outputPath}`);
-    }
-
-    // Show integration instructions
-    console.log('\n' + '─'.repeat(50));
-    console.log('\n🎉 Integration Ready!\n');
-    console.log('Add this to your website:\n');
-    console.log(`<script src="${options.backend}/bot.js" data-site-id="${result.siteId}"></script>`);
-    console.log('\n' + '─'.repeat(50) + '\n');
+// Run the binary with all arguments
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  env: process.env
+});
 
-  } catch (error) {
-    console.error(`\n❌ Error: ${error.message}`);
-    process.exit(1);
-  }
-}
+child.on('error', (err) => {
+  console.error(`\n❌ Failed to execute binary: ${err.message}`);
+  process.exit(1);
+});
 
-main();
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@merlean/analyzer",
-  "version": "2.2.0",
-  "description": "AI Bot codebase analyzer - generates site maps for AI assistant integration",
-  "keywords": ["ai", "bot", "analyzer", "claude", "anthropic", "widget"],
+  "version": "3.0.0",
+  "description": "AI-powered codebase analyzer - generates site maps for AI assistant integration",
+  "keywords": ["ai", "bot", "analyzer", "claude", "anthropic", "widget", "merlean"],
   "author": "zmaren",
   "license": "MIT",
   "repository": {
@@ -15,32 +15,18 @@
     "access": "public"
   },
   "bin": {
-    "ai-bot-analyze": "./bin/wrapper.js"
+    "ai-bot-analyze": "./bin/cli.js"
   },
-  "main": "lib/analyzer.js",
   "files": [
-    "bin/",
-    "lib/",
-    "scripts/"
+    "bin/"
   ],
-  "scripts": {
-    "postinstall": "node scripts/postinstall.js",
-    "build": "pkg . --targets node18-linux-x64,node18-macos-x64,node18-macos-arm64,node18-win-x64 --output dist/ai-bot-analyze",
-    "build:local": "pkg bin/cli.js --targets node18-macos-arm64 --output dist/ai-bot-analyze-macos-arm64"
-  },
-  "pkg": {
-    "scripts": ["lib/**/*.js", "bin/cli.js"],
-    "assets": [],
-    "targets": ["node18-linux-x64", "node18-macos-x64", "node18-macos-arm64", "node18-win-x64"],
-    "outputPath": "dist"
+  "optionalDependencies": {
+    "@merlean/analyzer-darwin-arm64": "3.0.0",
+    "@merlean/analyzer-darwin-x64": "3.0.0",
+    "@merlean/analyzer-linux-x64": "3.0.0",
+    "@merlean/analyzer-win32-x64": "3.0.0"
   },
   "engines": {
     "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "glob": "^10.3.10"
-  },
-  "devDependencies": {
-    "pkg": "^5.8.1"
   }
 }

package/bin/wrapper.js

@@ -1,51 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * AI Bot Analyzer - Wrapper Script
- * 
- * Attempts to run the compiled binary, falls back to source if not available.
- * This allows the package to work even if binary download failed.
- */
-
-const { spawn, execFileSync } = require('child_process');
-const path = require('path');
-const fs = require('fs');
-
-const binDir = __dirname;
-const binaryName = process.platform === 'win32' ? 'ai-bot-analyze.exe' : 'ai-bot-analyze';
-const binaryPath = path.join(binDir, binaryName);
-const sourcePath = path.join(binDir, 'cli.js');
-const sourceModeFlagPath = path.join(binDir, '..', '.source-mode');
-
-// Check if we should use source mode
-const useSourceMode = fs.existsSync(sourceModeFlagPath) || !fs.existsSync(binaryPath);
-
-if (useSourceMode) {
-  // Run source directly with Node.js
-  require('./cli.js');
-} else {
-  // Run compiled binary
-  const args = process.argv.slice(2);
-  
-  try {
-    const result = spawn(binaryPath, args, {
-      stdio: 'inherit',
-      env: process.env
-    });
-
-    result.on('error', (err) => {
-      // If binary fails, fall back to source
-      console.error('Binary execution failed, falling back to source mode...');
-      require('./cli.js');
-    });
-
-    result.on('exit', (code) => {
-      process.exit(code || 0);
-    });
-
-  } catch (err) {
-    // Fall back to source mode
-    require('./cli.js');
-  }
-}
-

package/lib/analyzer.js

@@ -1,535 +0,0 @@
-/**
- * Framework-Agnostic Codebase Scanner
- * 
- * Scans ANY codebase (frontend or backend) to extract API patterns:
- * - Express/Fastify/Koa/Hapi route definitions
- * - NestJS decorators (@Get, @Post, @Body, @Query, etc.)
- * - Frontend HTTP calls (fetch, axios, HttpClient, etc.)
- * - Swagger/OpenAPI annotations
- * - Request body schemas and query parameters
- * - TypeScript interfaces/DTOs
- * - Validation schemas (Zod, Joi, class-validator)
- * 
- * The goal is to understand what APIs exist, their parameters,
- * and body structures - regardless of framework or code style.
- */
-
-const fs = require('fs');
-const path = require('path');
-const { glob } = require('glob');
-
-// File patterns to scan (be inclusive)
-const FILE_PATTERNS = [
-  '**/*.js',
-  '**/*.jsx',
-  '**/*.ts',
-  '**/*.tsx',
-  '**/*.vue',
-  '**/*.svelte',
-  '**/*.mjs',
-  '**/*.cjs'
-];
-
-// Only ignore truly irrelevant directories
-const IGNORE_PATTERNS = [
-  '**/node_modules/**',
-  '**/vendor/**',
-  '**/.git/**',
-  '**/dist/**',
-  '**/build/**',
-  '**/coverage/**',
-  '**/__pycache__/**',
-  '**/venv/**',
-  '**/*.min.js',
-  '**/*.map',
-  '**/*.d.ts',           // TypeScript declaration files
-  '**/*.spec.ts',        // Test files
-  '**/*.spec.js',
-  '**/*.test.ts',
-  '**/*.test.js',
-  '**/__tests__/**',
-  '**/__mocks__/**'
-];
-
-// Files that are highly likely to contain API definitions
-const HIGH_PRIORITY_PATTERNS = [
-  /routes?\.ts$/i,
-  /routes?\.js$/i,
-  /router\.ts$/i,
-  /router\.js$/i,
-  /controller\.ts$/i,
-  /controller\.js$/i,
-  /\.controller\.ts$/i,
-  /\.controller\.js$/i,
-  /service\.ts$/i,
-  /service\.js$/i,
-  /\.service\.ts$/i,
-  /\.service\.js$/i,
-  /api\.ts$/i,
-  /api\.js$/i,
-  /endpoints?\.ts$/i,
-  /endpoints?\.js$/i,
-  /http\.ts$/i,
-  /http\.js$/i,
-  /client\.ts$/i,
-  /client\.js$/i,
-  /dto\.ts$/i,
-  /\.dto\.ts$/i,
-  /interfaces?\.ts$/i,
-  /types?\.ts$/i,
-  /schema\.ts$/i,
-  /schemas?\.ts$/i,
-  /validation\.ts$/i
-];
-
-// Medium priority - might contain API patterns
-const MEDIUM_PRIORITY_PATTERNS = [
-  /index\.ts$/i,
-  /index\.js$/i,
-  /app\.ts$/i,
-  /app\.js$/i,
-  /main\.ts$/i,
-  /main\.js$/i,
-  /server\.ts$/i,
-  /server\.js$/i
-];
-
-/**
- * Scan codebase and collect API patterns from any framework
- */
-async function scanCodebase(codebasePath) {
-  console.log('   Scanning files...');
-
-  // Get all matching files
-  const files = await glob(FILE_PATTERNS, {
-    cwd: codebasePath,
-    ignore: IGNORE_PATTERNS,
-    absolute: true
-  });
-
-  console.log(`   Found ${files.length} files`);
-
-  // Categorize and prioritize files
-  const { highPriority, mediumPriority, other } = categorizeFiles(files, codebasePath);
-  
-  console.log(`   High priority: ${highPriority.length}, Medium: ${mediumPriority.length}, Other: ${other.length}`);
-
-  // Analyze high priority files first (routes, controllers, services, DTOs)
-  // Then medium priority, then scan others for API patterns
-  const filesToAnalyze = [
-    ...highPriority,
-    ...mediumPriority.slice(0, 20),
-    ...other.slice(0, 50)
-  ];
-
-  console.log(`   Analyzing ${filesToAnalyze.length} files for API patterns...`);
-
-  const fileContents = [];
-  let filesWithPatterns = 0;
-
-  for (const file of filesToAnalyze) {
-    try {
-      const content = fs.readFileSync(file, 'utf-8');
-      const relativePath = path.relative(codebasePath, file);
-      
-      // Extract API patterns from the file
-      const extracted = extractApiPatterns(content, relativePath, file);
-      
-      if (extracted.hasApiPatterns) {
-        filesWithPatterns++;
-        fileContents.push({
-          path: relativePath,
-          content: extracted.content
-        });
-      }
-    } catch (error) {
-      // Skip files that can't be read
-    }
-  }
-
-  console.log(`   Found API patterns in ${filesWithPatterns} files`);
-
-  return fileContents;
-}
-
-/**
- * Categorize files by priority
- */
-function categorizeFiles(files, basePath) {
-  const highPriority = [];
-  const mediumPriority = [];
-  const other = [];
-
-  for (const file of files) {
-    const relativePath = path.relative(basePath, file);
-    
-    if (HIGH_PRIORITY_PATTERNS.some(p => p.test(relativePath))) {
-      highPriority.push(file);
-    } else if (MEDIUM_PRIORITY_PATTERNS.some(p => p.test(relativePath))) {
-      mediumPriority.push(file);
-    } else {
-      other.push(file);
-    }
-  }
-
-  return { highPriority, mediumPriority, other };
-}
-
-/**
- * Extract Swagger/OpenAPI documentation blocks
- */
-function extractSwaggerBlocks(content) {
-  const swaggerBlocks = [];
-  
-  // Match JSDoc blocks with @swagger
-  const swaggerRegex = /\/\*\*[\s\S]*?@swagger[\s\S]*?\*\//g;
-  let match;
-  
-  while ((match = swaggerRegex.exec(content)) !== null) {
-    swaggerBlocks.push(match[0]);
-  }
-  
-  return swaggerBlocks;
-}
-
-/**
- * Extract TypeScript interfaces and types that look like DTOs/schemas
- */
-function extractTypeDefinitions(content, filePath) {
-  const typeBlocks = [];
-  const lines = content.split('\n');
-  
-  // Look for interfaces and types that might be request/response schemas
-  const typeKeywords = [
-    /interface\s+\w*(Request|Response|Dto|Body|Query|Params|Payload|Input|Output)\w*\s*\{/i,
-    /type\s+\w*(Request|Response|Dto|Body|Query|Params|Payload|Input|Output)\w*\s*=/i,
-    /interface\s+\w+\s*\{/,  // Any interface in DTO/schema files
-    /type\s+\w+\s*=/         // Any type in DTO/schema files
-  ];
-  
-  // Only extract type definitions from files that look like DTOs/types
-  const isDtoFile = /dto|interface|type|schema|model/i.test(filePath);
-  
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    
-    const isTypeDefinition = typeKeywords.some(regex => regex.test(line));
-    
-    if (isTypeDefinition || (isDtoFile && /^(export\s+)?(interface|type)\s+/.test(line))) {
-      // Find the complete type block (until closing brace at same indent level)
-      let braceCount = 0;
-      let started = false;
-      let endLine = i;
-      
-      for (let j = i; j < lines.length && j < i + 50; j++) {
-        const l = lines[j];
-        for (const char of l) {
-          if (char === '{') {
-            braceCount++;
-            started = true;
-          } else if (char === '}') {
-            braceCount--;
-          }
-        }
-        endLine = j;
-        if (started && braceCount === 0) break;
-      }
-      
-      const block = lines.slice(i, endLine + 1)
-        .map((l, idx) => `${i + idx + 1}: ${l}`)
-        .join('\n');
-      
-      typeBlocks.push(block);
-      i = endLine; // Skip processed lines
-    }
-  }
-  
-  return typeBlocks;
-}
-
-/**
- * Extract request body and query parameter patterns
- */
-function extractRequestPatterns(content) {
-  const patterns = [];
-  const lines = content.split('\n');
-  
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    
-    // Destructuring patterns for req.body, req.query, req.params
-    if (/(?:const|let|var)\s*\{[^}]+\}\s*=\s*req\.(body|query|params)/i.test(line) ||
-        /req\.(body|query|params)\s*[;.]/.test(line)) {
-      
-      // Get context around it
-      const startLine = Math.max(0, i - 2);
-      const endLine = Math.min(lines.length - 1, i + 5);
-      
-      const block = lines.slice(startLine, endLine + 1)
-        .map((l, idx) => `${startLine + idx + 1}: ${l}`)
-        .join('\n');
-      
-      patterns.push(`// Request parameter extraction:\n${block}`);
-      i = endLine;
-    }
-    
-    // NestJS decorators: @Body(), @Query(), @Param()
-    if (/@(Body|Query|Param|Headers)\s*\(/i.test(line)) {
-      const startLine = Math.max(0, i - 1);
-      const endLine = Math.min(lines.length - 1, i + 3);
-      
-      const block = lines.slice(startLine, endLine + 1)
-        .map((l, idx) => `${startLine + idx + 1}: ${l}`)
-        .join('\n');
-      
-      patterns.push(`// NestJS parameter decorator:\n${block}`);
-      i = endLine;
-    }
-    
-    // Validation schemas: Joi, Zod, class-validator
-    if (/Joi\.(object|string|number|array|boolean)\s*\(/i.test(line) ||
-        /z\.(object|string|number|array|boolean)\s*\(/i.test(line) ||
-        /@(IsString|IsNumber|IsArray|IsBoolean|IsOptional|ValidateNested)/i.test(line)) {
-      
-      const startLine = Math.max(0, i - 2);
-      const endLine = Math.min(lines.length - 1, i + 10);
-      
-      const block = lines.slice(startLine, endLine + 1)
-        .map((l, idx) => `${startLine + idx + 1}: ${l}`)
-        .join('\n');
-      
-      patterns.push(`// Validation schema:\n${block}`);
-      i = endLine;
-    }
-  }
-  
-  return patterns;
-}
-
-/**
- * Extract API patterns from file content - framework agnostic
- */
-function extractApiPatterns(content, filePath, absolutePath) {
-  const lines = content.split('\n');
-  let hasApiPatterns = false;
-  const extractedBlocks = [];
-
-  // Check if this is a route/controller file - if so, include more context
-  const isRouteFile = HIGH_PRIORITY_PATTERNS.some(p => p.test(filePath));
-  const isDtoFile = /dto|interface|types?|schema/i.test(filePath);
-  
-  // ============================================
-  // PATTERN 0: Swagger/OpenAPI documentation
-  // ============================================
-  const swaggerBlocks = extractSwaggerBlocks(content);
-  if (swaggerBlocks.length > 0) {
-    hasApiPatterns = true;
-    extractedBlocks.push(`// Swagger/OpenAPI documentation found:\n${swaggerBlocks.join('\n\n')}`);
-  }
-  
-  // ============================================
-  // PATTERN 1: TypeScript interfaces/types (DTOs, schemas)
-  // ============================================
-  const typeBlocks = extractTypeDefinitions(content, filePath);
-  if (typeBlocks.length > 0) {
-    hasApiPatterns = true;
-    extractedBlocks.push(`// TypeScript type definitions:\n${typeBlocks.join('\n\n')}`);
-  }
-  
-  // ============================================
-  // PATTERN 2: Request body/query extraction
-  // ============================================
-  const requestPatterns = extractRequestPatterns(content);
-  if (requestPatterns.length > 0) {
-    hasApiPatterns = true;
-    extractedBlocks.push(requestPatterns.join('\n\n'));
-  }
-
-  // ============================================
-  // PATTERN 3: Express/Koa/Fastify Router definitions
-  // ============================================
-  const routerPatterns = [
-    // Express Router: router.get('/path', handler)
-    /\.(get|post|put|patch|delete|all|use)\s*\(\s*['"`]([^'"`]+)['"`]/gi,
-    // Express app: app.get('/path', handler)
-    /app\.(get|post|put|patch|delete|all|use)\s*\(\s*['"`]([^'"`]+)['"`]/gi,
-    // Fastify: fastify.get('/path', handler)
-    /fastify\.(get|post|put|patch|delete|all)\s*\(\s*['"`]([^'"`]+)['"`]/gi,
-  ];
-
-  // ============================================
-  // PATTERN 4: NestJS/Decorators
-  // ============================================
-  const decoratorPatterns = [
-    /@(Get|Post|Put|Patch|Delete|All)\s*\(\s*['"`]?([^'"`\)]*)/gi,
-    /@Controller\s*\(\s*['"`]([^'"`]+)/gi,
-  ];
-
-  // ============================================
-  // PATTERN 5: Frontend HTTP calls
-  // ============================================
-  const httpCallPatterns = [
-    // fetch() calls
-    /fetch\s*\(\s*[`'"](.*?)[`'"]/g,
-    /fetch\s*\(\s*`([^`]*)`/g,
-    // axios calls
-    /axios\.(get|post|put|patch|delete)\s*\(\s*[`'"](.*?)[`'"]/g,
-    /axios\s*\(\s*\{[^}]*url\s*:\s*[`'"](.*?)[`'"]/g,
-    // Angular HttpClient
-    /this\.http\.(get|post|put|patch|delete)\s*[<(]/g,
-    /httpClient\.(get|post|put|patch|delete)\s*[<(]/g,
-    // jQuery ajax
-    /\$\.(ajax|get|post)\s*\(\s*[`'"](.*?)[`'"]/g,
-    // Generic request libraries
-    /request\.(get|post|put|patch|delete)\s*\(/g,
-    /got\.(get|post|put|patch|delete)\s*\(/g,
-    /superagent\.(get|post|put|patch|delete)\s*\(/g,
-  ];
-
-  // ============================================
-  // PATTERN 6: API URL definitions
-  // ============================================
-  const urlPatterns = [
-    // API endpoints in strings
-    /['"`](\/api\/[^'"`\s]+)['"`]/g,
-    /['"`](\/v\d+\/[^'"`\s]+)['"`]/g,
-    /['"`](https?:\/\/[^'"`\s]*\/api[^'"`\s]*)['"`]/g,
-    // Base URL definitions
-    /(?:API_BASE|API_URL|BASE_URL|baseURL|apiUrl|apiBase|API_ENDPOINT|BACKEND_URL)\s*[:=]\s*['"`]([^'"`]+)['"`]/gi,
-  ];
-
-  // ============================================
-  // PATTERN 7: Method + URL combinations
-  // ============================================
-  const methodUrlPatterns = [
-    /(GET|POST|PUT|PATCH|DELETE)\s*[,:]?\s*['"`](\/[^'"`]+)['"`]/gi,
-    /method:\s*['"`](GET|POST|PUT|PATCH|DELETE)['"`]/gi,
-  ];
-
-  // Combine all patterns for line scanning
-  const allPatterns = [
-    ...routerPatterns,
-    ...decoratorPatterns,
-    ...httpCallPatterns,
-    ...urlPatterns,
-    ...methodUrlPatterns
-  ];
-
-  // If this is a route/controller file with swagger docs, include the whole file
-  if (isRouteFile && swaggerBlocks.length > 0) {
-    hasApiPatterns = true;
-    // Include entire file content (truncated if too long)
-    const maxLines = 300;
-    const truncatedContent = lines.length > maxLines 
-      ? lines.slice(0, maxLines).join('\n') + `\n// ... ${lines.length - maxLines} more lines ...`
-      : content;
-    
-    return {
-      hasApiPatterns: true,
-      content: `// File: ${filePath}\n// Route/Controller file with Swagger docs - full content:\n\n${truncatedContent}`
-    };
-  }
-  
-  // If this is a route file without swagger, still include more content
-  if (isRouteFile) {
-    const hasRouteContent = allPatterns.some(p => {
-      p.lastIndex = 0;
-      return p.test(content);
-    });
-    
-    if (hasRouteContent) {
-      hasApiPatterns = true;
-      const maxLines = 200;
-      const truncatedContent = lines.length > maxLines 
-        ? lines.slice(0, maxLines).join('\n') + `\n// ... ${lines.length - maxLines} more lines ...`
-        : content;
-      
-      return {
-        hasApiPatterns: true,
-        content: `// File: ${filePath}\n// Route/Controller file - full content:\n\n${truncatedContent}`
-      };
-    }
-  }
-  
-  // If this is a DTO/types file, include full content
-  if (isDtoFile && typeBlocks.length > 0) {
-    hasApiPatterns = true;
-    const maxLines = 150;
-    const truncatedContent = lines.length > maxLines 
-      ? lines.slice(0, maxLines).join('\n') + `\n// ... ${lines.length - maxLines} more lines ...`
-      : content;
-    
-    return {
-      hasApiPatterns: true,
-      content: `// File: ${filePath}\n// DTO/Types file - full content:\n\n${truncatedContent}`
-    };
-  }
-
-  // For non-route files, extract relevant sections
-  // First, extract imports and base URL definitions
-  const baseUrlLines = [];
-  
-  for (let i = 0; i < Math.min(lines.length, 50); i++) {
-    const line = lines[i];
-    if (/(?:API_BASE|API_URL|BASE_URL|baseURL|apiUrl|BACKEND)/i.test(line)) {
-      baseUrlLines.push(`${i + 1}: ${line}`);
-    }
-  }
-
-  if (baseUrlLines.length > 0) {
-    extractedBlocks.push('// Base URL definitions:\n' + baseUrlLines.join('\n'));
-    hasApiPatterns = true;
-  }
-
-  // Line-by-line extraction with context
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    
-    // Check all patterns
-    let hasPattern = false;
-    for (const pattern of allPatterns) {
-      pattern.lastIndex = 0;
-      if (pattern.test(line)) {
-        hasPattern = true;
-        break;
-      }
-    }
-    
-    // Also check for common API keywords
-    const hasKeyword = /\.get\(|\.post\(|\.put\(|\.patch\(|\.delete\(|fetch\(|axios|\/api\/|endpoint|@Get|@Post|@Put|@Delete/i.test(line);
-    
-    if (hasPattern || hasKeyword) {
-      hasApiPatterns = true;
-      
-      // Determine context needed
-      const isPostOrPut = /post|put|patch/i.test(line);
-      const contextBefore = isPostOrPut ? 20 : 5;  // More context for mutations
-      const contextAfter = isPostOrPut ? 10 : 5;
-      
-      const startLine = Math.max(0, i - contextBefore);
-      const endLine = Math.min(lines.length - 1, i + contextAfter);
-      
-      const block = lines.slice(startLine, endLine + 1)
-        .map((l, idx) => `${startLine + idx + 1}: ${l}`)
-        .join('\n');
-      
-      extractedBlocks.push(block);
-      
-      // Skip ahead to avoid duplicates
-      i = endLine;
-    }
-  }
-
-  if (hasApiPatterns && extractedBlocks.length > 0) {
-    // Deduplicate blocks
-    const uniqueBlocks = [...new Set(extractedBlocks)];
-    return {
-      hasApiPatterns: true,
-      content: `// File: ${filePath}\n// API patterns extracted:\n\n${uniqueBlocks.join('\n\n// ---\n\n')}`
-    };
-  }
-
-  return { hasApiPatterns: false, content: '' };
-}
-
-module.exports = { scanCodebase };

package/scripts/postinstall.js

@@ -1,156 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Postinstall script - Downloads the correct binary for the user's platform
- * from GitHub Releases
- */
-
-const https = require('https');
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
-
-const REPO = 'zmaren/merlean';
-const BINARY_NAME = 'ai-bot-analyze';
-const VERSION = require('../package.json').version;
-
-// Map Node.js platform/arch to binary names
-function getBinaryName() {
-  const platform = process.platform;
-  const arch = process.arch;
-
-  const platformMap = {
-    'darwin-arm64': 'ai-bot-analyze-macos-arm64',
-    'darwin-x64': 'ai-bot-analyze-macos-x64',
-    'linux-x64': 'ai-bot-analyze-linux-x64',
-    'win32-x64': 'ai-bot-analyze-win-x64.exe'
-  };
-
-  const key = `${platform}-${arch}`;
-  const binaryName = platformMap[key];
-
-  if (!binaryName) {
-    console.error(`❌ Unsupported platform: ${platform}-${arch}`);
-    console.error('   Supported: darwin-arm64, darwin-x64, linux-x64, win32-x64');
-    console.error('   Falling back to source mode (requires Node.js)');
-    return null;
-  }
-
-  return binaryName;
-}
-
-// Download binary from GitHub Releases
-async function downloadBinary(binaryName) {
-  const binDir = path.join(__dirname, '..', 'bin');
-  const binaryPath = path.join(binDir, process.platform === 'win32' ? `${BINARY_NAME}.exe` : BINARY_NAME);
-
-  // Skip if binary already exists
-  if (fs.existsSync(binaryPath)) {
-    console.log('✓ Binary already exists');
-    return true;
-  }
-
-  const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${binaryName}`;
-  
-  console.log(`📦 Downloading ${binaryName}...`);
-  console.log(`   From: ${url}`);
-
-  return new Promise((resolve) => {
-    const download = (downloadUrl, redirectCount = 0) => {
-      if (redirectCount > 5) {
-        console.error('❌ Too many redirects');
-        resolve(false);
-        return;
-      }
-
-      const protocol = downloadUrl.startsWith('https') ? https : require('http');
-      
-      protocol.get(downloadUrl, (response) => {
-        // Handle redirects (GitHub releases redirect to S3)
-        if (response.statusCode === 301 || response.statusCode === 302) {
-          download(response.headers.location, redirectCount + 1);
-          return;
-        }
-
-        if (response.statusCode === 404) {
-          console.log(`⚠️  Binary not found for v${VERSION}`);
-          console.log('   Falling back to source mode');
-          resolve(false);
-          return;
-        }
-
-        if (response.statusCode !== 200) {
-          console.error(`❌ Download failed: HTTP ${response.statusCode}`);
-          resolve(false);
-          return;
-        }
-
-        // Ensure bin directory exists
-        if (!fs.existsSync(binDir)) {
-          fs.mkdirSync(binDir, { recursive: true });
-        }
-
-        const file = fs.createWriteStream(binaryPath);
-        response.pipe(file);
-
-        file.on('finish', () => {
-          file.close();
-          
-          // Make executable on Unix
-          if (process.platform !== 'win32') {
-            fs.chmodSync(binaryPath, 0o755);
-          }
-          
-          console.log('✓ Binary downloaded successfully');
-          resolve(true);
-        });
-
-        file.on('error', (err) => {
-          fs.unlink(binaryPath, () => {}); // Clean up
-          console.error(`❌ Write error: ${err.message}`);
-          resolve(false);
-        });
-
-      }).on('error', (err) => {
-        console.error(`❌ Download error: ${err.message}`);
-        resolve(false);
-      });
-    };
-
-    download(url);
-  });
-}
-
-// Mark that we're using source mode
-function setSourceMode() {
-  const flagPath = path.join(__dirname, '..', '.source-mode');
-  fs.writeFileSync(flagPath, 'true');
-}
-
-// Main
-async function main() {
-  // Skip in CI environments during package build
-  if (process.env.CI || process.env.PKG_EXECPATH) {
-    console.log('⏭️  Skipping binary download (CI/build environment)');
-    return;
-  }
-
-  const binaryName = getBinaryName();
-  
-  if (!binaryName) {
-    setSourceMode();
-    return;
-  }
-
-  const success = await downloadBinary(binaryName);
-  
-  if (!success) {
-    setSourceMode();
-  }
-}
-
-main().catch((err) => {
-  console.error('Postinstall error:', err.message);
-  // Don't fail install, fall back to source mode
-});
-