@merlean/analyzer 2.3.0 → 3.0.1

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
+merleanalyze --name "My App"
+
+# Analyze specific path
+merleanalyze ./my-project --name "My App"
+
+# Merge into existing site map
+merleanalyze ./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,187 +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,
-    mergeWith: null  // Existing siteId to merge into
-  };
-
-  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 === '--merge-with' || arg === '-m') {
-      options.mergeWith = 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 for new analysis)
-  --merge-with, -m <siteId>  Merge into existing site map (appends routes/forms/actions)
-  --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"
-
-  # Merge another frontend into existing site map
-  npx @merlean/analyzer ./admin-panel --merge-with site_abc123
-
-  # 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 && !options.mergeWith) {
-    console.error('❌ Error: --name is required (or use --merge-with to merge into existing site)');
-    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' ? 'merleanalyze.exe' : 'merleanalyze';
+  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}`);
-  if (options.mergeWith) {
-    console.log(`🔗 Merging into: ${options.mergeWith}`);
-    if (options.name) {
-      console.log(`📛 Site name: ${options.name} (will update existing)`);
-    }
-  } else {
-    console.log(`📛 Site name: ${options.name}`);
-  }
-
-  try {
-    // Scan codebase locally
-    const scanResult = await scanCodebase(codebasePath);
-    // Handle both old format (array) and new format (object with files + preExtractedRoutes)
-    const fileContents = Array.isArray(scanResult) ? scanResult : scanResult.files;
-    const preExtractedRoutes = Array.isArray(scanResult) ? [] : (scanResult.preExtractedRoutes || []);
-    
-    console.log(`\n📤 Uploading to backend for analysis...`);
-    
-    // Build request body
-    const requestBody = {
-      siteName: options.name,
-      files: fileContents,
-      preExtractedRoutes  // Include convention-based routes
-    };
-    
-    // Add merge parameter if specified
-    if (options.mergeWith) {
-      requestBody.mergeWithSiteId = options.mergeWith;
-    }
-    
-    // Send to backend for LLM analysis
-    const response = await fetch(`${options.backend}/api/analyze`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(requestBody)
-    });
-
-    if (!response.ok) {
-      const error = await response.text();
-      throw new Error(`Backend error: ${response.status} ${error}`);
-    }
-
-    const result = await response.json();
-
-    if (options.mergeWith) {
-      console.log('\n✅ Merge complete!');
-      console.log('\n📊 Updated Summary:');
-    } else {
-      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}`);
-    
-    if (result.merged) {
-      console.log(`\n   📎 Merged from: ${result.merged.sourcesCount} source(s)`);
-    }
-
-    // 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.3.0",
-  "description": "AI Bot codebase analyzer - generates site maps for AI assistant integration",
-  "keywords": ["ai", "bot", "analyzer", "claude", "anthropic", "widget"],
+  "version": "3.0.1",
+  "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"
+    "merleanalyze": "./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.1",
+    "@merlean/analyzer-darwin-x64": "3.0.1",
+    "@merlean/analyzer-linux-x64": "3.0.1",
+    "@merlean/analyzer-win32-x64": "3.0.1"
   },
   "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');
-  }
-}
-