style: Add Prettier config and format all JavaScript

- Added .prettierrc.json with consistent code style rules
- Added .prettierignore to exclude non-source files
- Formatted 267 JavaScript files with Prettier
- Fixed 797 ESLint errors with auto-fix
- Reduced total errors from 1100+ to 305

Code is now consistently formatted across the entire codebase

Author: flyingrobots

.prettierignore

@@ -0,0 +1,32 @@
+# Dependencies
+node_modules/
+package-lock.json
+pnpm-lock.yaml
+yarn.lock
+
+# Build outputs
+dist/
+build/
+coverage/
+.vitest/
+.nyc_output/
+
+# IDE
+.obsidian/
+.vscode/
+.idea/
+
+# Git
+.git/
+
+# Misc
+*.min.js
+*.min.css
+test-results/
+junit.xml
+*.tap
+*.log
+
+# Generated files
+migrations/
+.migration_archive/

.prettierrc.json

@@ -0,0 +1,15 @@
+{
+  "semi": true,
+  "trailingComma": "none",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "proseWrap": "preserve",
+  "htmlWhitespaceSensitivity": "css",
+  "embeddedLanguageFormatting": "auto"
+}

bin/data.js

@@ -21,7 +21,7 @@ config();
 import { cli } from '../src/index.js';
 
 // Run the CLI with process arguments
-cli(process.argv).catch(error => {
+cli(process.argv).catch((error) => {
   console.error('Fatal error:', error.message);
   if (process.env.DEBUG) {
     console.error(error.stack);

eslint.config.js

@@ -35,7 +35,7 @@ export default [
       }
     },
     plugins: {
-      'promise': promisePlugin
+      promise: promisePlugin
     },
     rules: {
       // Promise-specific rules for proper async handling
@@ -56,23 +56,25 @@ export default [
       // ESM-specific rules
       'no-console': 'off',
       'no-undef': 'error',
-      'no-unused-vars': ['error', {
-        'argsIgnorePattern': '^_',
-        'varsIgnorePattern': '^_'
-      }],
+      'no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_'
+        }
+      ],
 
       // Modern JavaScript best practices
       'prefer-const': 'error',
       'prefer-arrow-callback': 'error',
       'no-var': 'error',
       'object-shorthand': 'error',
-      'semi': ['error', 'always'],
-      'quotes': ['error', 'single', { 'avoidEscape': true }],
+      semi: ['error', 'always'],
+      quotes: ['error', 'single', { avoidEscape: true }],
       'comma-dangle': ['error', 'never'],
-      'indent': ['error', 2],
+      indent: ['error', 2],
       'no-trailing-spaces': 'error',
       'eol-last': 'error'
     }
   }
 ];
-

package.json

@@ -54,6 +54,7 @@
     "eslint-plugin-promise": "^7.2.1",
     "husky": "^9.1.7",
     "jscodeshift": "^17.3.0",
+    "prettier": "^3.6.2",
     "recast": "^0.23.11",
     "vitest": "^2.0.0"
   },

scripts/jsdoc-ai.js

@@ -2,11 +2,11 @@
 
 /**
  * @fileoverview AI-Powered JSDoc Generation Script
- * 
+ *
  * Automatically generates comprehensive JSDoc comments for JavaScript files
  * using AI analysis. Integrates with git pre-commit hooks for seamless
  * developer experience.
- * 
+ *
  * @module JSDocAI
  * @since 1.0.0
  */
@@ -25,15 +25,15 @@ const __dirname = dirname(__filename);
  */
 function getStagedJSFiles() {
   try {
-    const output = execSync('git diff --cached --name-only --diff-filter=ACM', { 
+    const output = execSync('git diff --cached --name-only --diff-filter=ACM', {
       encoding: 'utf8',
       cwd: join(__dirname, '..')
     });
-    
+
     return output
       .split('\n')
-      .filter(file => file.trim() && file.endsWith('.js'))
-      .map(file => file.trim());
+      .filter((file) => file.trim() && file.endsWith('.js'))
+      .map((file) => file.trim());
   } catch (error) {
     console.log('No staged files found or not in git repository');
     return [];
@@ -54,35 +54,35 @@ function analyzeCodeStructure(code) {
     imports: /import\s+.*?from\s+['"`]([^'"`]+)['"`]/g
   };
 
-  let analysis = "Analyze this JavaScript code and generate comprehensive JSDoc comments:\n\n";
-  
+  let analysis = 'Analyze this JavaScript code and generate comprehensive JSDoc comments:\n\n';
+
   // Detect patterns
   const classes = [...code.matchAll(patterns.classes)];
   const functions = [...code.matchAll(patterns.functions)];
   const imports = [...code.matchAll(patterns.imports)];
-  
+
   if (classes.length > 0) {
-    analysis += `Classes found: ${classes.map(m => m[1]).join(', ')}\n`;
+    analysis += `Classes found: ${classes.map((m) => m[1]).join(', ')}\n`;
   }
-  
+
   if (functions.length > 0) {
-    analysis += `Functions found: ${functions.map(m => m[1]).join(', ')}\n`;
+    analysis += `Functions found: ${functions.map((m) => m[1]).join(', ')}\n`;
   }
-  
+
   if (imports.length > 0) {
-    analysis += `Dependencies: ${imports.map(m => m[1]).join(', ')}\n`;
+    analysis += `Dependencies: ${imports.map((m) => m[1]).join(', ')}\n`;
   }
 
-  analysis += "\nGenerate JSDoc with:\n";
-  analysis += "- @fileoverview for file header\n";
-  analysis += "- @param with accurate types for all parameters\n";
-  analysis += "- @returns with specific return types\n";  
-  analysis += "- @throws for error conditions\n";
-  analysis += "- @example for complex functions\n";
-  analysis += "- @since version tags\n";
-  analysis += "- @module declarations\n\n";
-  analysis += "IMPORTANT: Only add JSDoc where missing. Preserve existing JSDoc comments.\n";
-  
+  analysis += '\nGenerate JSDoc with:\n';
+  analysis += '- @fileoverview for file header\n';
+  analysis += '- @param with accurate types for all parameters\n';
+  analysis += '- @returns with specific return types\n';
+  analysis += '- @throws for error conditions\n';
+  analysis += '- @example for complex functions\n';
+  analysis += '- @since version tags\n';
+  analysis += '- @module declarations\n\n';
+  analysis += 'IMPORTANT: Only add JSDoc where missing. Preserve existing JSDoc comments.\n';
+
   return analysis;
 }
 
@@ -95,11 +95,11 @@ async function generateJSDocForFile(filePath) {
   try {
     const absolutePath = join(process.cwd(), filePath);
     const code = readFileSync(absolutePath, 'utf8');
-    
+
     // Skip if already has comprehensive JSDoc
     const jsdocCount = (code.match(/\/\*\*[\s\S]*?\*\//g) || []).length;
     const functionsCount = (code.match(/(?:function|class|\w+\s*\([^)]*\)\s*{)/g) || []).length;
-    
+
     if (jsdocCount >= functionsCount * 0.8) {
       console.log(`✓ ${filePath} already has good JSDoc coverage`);
       return false;
@@ -108,19 +108,18 @@ async function generateJSDocForFile(filePath) {
     const prompt = analyzeCodeStructure(code);
     console.log(`📝 Analysis for ${filePath}:`);
     console.log(prompt);
-    
+
     // For demo purposes, just indicate what would be done
     // In production, this would call Claude API or use local AI
     console.log(`\n🤖 AI JSDoc generation would be applied to ${filePath}`);
     console.log(`   Found ${functionsCount} functions/classes, ${jsdocCount} have JSDoc`);
-    console.log(`   📋 Prompt ready for AI processing`);
-    
+    console.log('   📋 Prompt ready for AI processing');
+
     // For safety in demo, don't modify files
     // Uncomment below to enable actual file modification:
     // writeFileSync(absolutePath, enhancedCode);
-    
+
     return false; // Return true when actually modifying files
-    
   } catch (error) {
     console.error(`✗ Error processing ${filePath}:`, error.message);
     return false;
@@ -134,16 +133,16 @@ async function generateJSDocForFile(filePath) {
  */
 async function main(targetFiles = null) {
   const files = targetFiles || getStagedJSFiles();
-  
+
   if (files.length === 0) {
     console.log('No JavaScript files to process');
     return;
   }
 
   console.log(`🤖 Processing ${files.length} JavaScript files for JSDoc enhancement...`);
-  
+
   let modifiedCount = 0;
-  
+
   for (const file of files) {
     const wasModified = await generateJSDocForFile(file);
     if (wasModified) {
@@ -156,7 +155,7 @@ async function main(targetFiles = null) {
       }
     }
   }
-  
+
   console.log(`🚀 Enhanced ${modifiedCount}/${files.length} files with AI-generated JSDoc`);
 }
 
@@ -166,4 +165,4 @@ if (process.argv[1] === __filename) {
   main(targetFiles.length > 0 ? targetFiles : null).catch(console.error);
 }
 
-export { main, generateJSDocForFile, analyzeCodeStructure, getStagedJSFiles };
+export { main, generateJSDocForFile, analyzeCodeStructure, getStagedJSFiles };

scripts/jsdoc/generate-jsdoc.js

@@ -105,7 +105,9 @@ Please return only the updated JavaScript code with JSDoc comments added.`;
       // Fallback to heuristic-based JSDoc generation
       return this.generateHeuristicJSDoc(originalContent, filePath);
     } catch (error) {
-      console.warn(`⚠️  AI generation failed, falling back to heuristic approach: ${error.message}`);
+      console.warn(
+        `⚠️  AI generation failed, falling back to heuristic approach: ${error.message}`
+      );
       return this.generateHeuristicJSDoc(originalContent, filePath);
     }
   }
@@ -200,17 +202,19 @@ Please return only the updated JavaScript code with JSDoc comments added.`;
       const line = lines[i];
 
       // Check if this line defines a function and doesn't already have JSDoc
-      const functionMatch = line.match(/^\s*(export\s+)?(async\s+)?function\s+(\w+)\s*\(([^)]*)\)|^\s*(\w+)\s*[:=]\s*(async\s+)?\(?([^)]*)\)?\s*=>/);
+      const functionMatch = line.match(
+        /^\s*(export\s+)?(async\s+)?function\s+(\w+)\s*\(([^)]*)\)|^\s*(\w+)\s*[:=]\s*(async\s+)?\(?([^)]*)\)?\s*=>/
+      );
 
-      if (functionMatch && i > 0 && !lines[i-1].includes('/**')) {
+      if (functionMatch && i > 0 && !lines[i - 1].includes('/**')) {
         const functionName = functionMatch[3] || functionMatch[5];
-        const params = (functionMatch[4] || functionMatch[7] || '').split(',').map(p => p.trim()).filter(p => p);
+        const params = (functionMatch[4] || functionMatch[7] || '')
+          .split(',')
+          .map((p) => p.trim())
+          .filter((p) => p);
 
         // Generate basic JSDoc
-        const jsdocLines = [
-          '/**',
-          ` * ${functionName} function`
-        ];
+        const jsdocLines = ['/**', ` * ${functionName} function`];
 
         // Add parameter documentation
         for (const param of params) {
@@ -251,16 +255,11 @@ Please return only the updated JavaScript code with JSDoc comments added.`;
       // Check if this line defines a class and doesn't already have JSDoc
       const classMatch = line.match(/^\s*(export\s+)?class\s+(\w+)/);
 
-      if (classMatch && i > 0 && !lines[i-1].includes('/**')) {
+      if (classMatch && i > 0 && !lines[i - 1].includes('/**')) {
         const className = classMatch[2];
 
         // Generate basic class JSDoc
-        const jsdocLines = [
-          '/**',
-          ` * ${className} class`,
-          ' * @class',
-          ' */'
-        ];
+        const jsdocLines = ['/**', ` * ${className} class`, ' * @class', ' */'];
 
         // Add JSDoc before the class
         for (const docLine of jsdocLines) {
@@ -281,12 +280,13 @@ Please return only the updated JavaScript code with JSDoc comments added.`;
    */
   hasComprehensiveJSDoc(content) {
     const jsdocBlocks = (content.match(/\/\*\*[\s\S]*?\*\//g) || []).length;
-    const functions = (content.match(/function\s+\w+|=>\s*{|\w+\s*[:=]\s*(?:async\s+)?\(/g) || []).length;
+    const functions = (content.match(/function\s+\w+|=>\s*{|\w+\s*[:=]\s*(?:async\s+)?\(/g) || [])
+      .length;
     const classes = (content.match(/class\s+\w+/g) || []).length;
 
     // Consider comprehensive if we have JSDoc for most functions/classes
     const totalItems = functions + classes;
-    return totalItems > 0 && (jsdocBlocks / totalItems) >= 0.5;
+    return totalItems > 0 && jsdocBlocks / totalItems >= 0.5;
   }
 
   /**
@@ -367,7 +367,7 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   };
 
   // Get file paths from arguments or stdin
-  const filePaths = args.filter(arg => !arg.startsWith('--') && !arg.startsWith('-'));
+  const filePaths = args.filter((arg) => !arg.startsWith('--') && !arg.startsWith('-'));
 
   if (filePaths.length === 0) {
     console.error('Usage: generate-jsdoc.js [options] <file1.js> [file2.js] ...');
@@ -380,8 +380,9 @@ if (import.meta.url === `file://${process.argv[1]}`) {
 
   const generator = new JSDocGenerator(options);
 
-  generator.processFiles(filePaths)
-    .then(results => {
+  generator
+    .processFiles(filePaths)
+    .then((results) => {
       console.log('\n📊 JSDoc Generation Summary:');
       console.log(`   Updated: ${results.updated} files`);
       console.log(`   Skipped: ${results.skipped} files`);
@@ -393,11 +394,10 @@ if (import.meta.url === `file://${process.argv[1]}`) {
 
       return results;
     })
-    .catch(error => {
+    .catch((error) => {
       process.stderr.write(`❌ JSDoc generation failed: ${error.message}\n`);
       process.exit(1);
     });
 }
 
 export { JSDocGenerator };
-