offbyt 1.0.0 → 1.0.2

package/cli.js

@@ -9,6 +9,7 @@ import { connectFrontendBackend } from './lib/modes/connect.js';
 import { runDoctor } from './lib/utils/doctor.js';
 import { getInteractiveSetup, displaySetupSummary } from './lib/modes/interactiveSetup.js';
 import { generateWithConfig } from './lib/modes/configBasedGenerator.js';
+import { printBanner, printSection, printSuccess, printStep, printSummary, printFooter } from './lib/utils/cliFormatter.js';
 
 const program = new Command();
 
@@ -21,6 +22,15 @@ function parsePort(value) {
   return port;
 }
 
+function parsePositiveInteger(value) {
+  const parsed = Number.parseInt(value, 10);
+  if (Number.isNaN(parsed) || parsed < 1) {
+    throw new Error('Value must be a positive integer');
+  }
+
+  return parsed;
+}
+
 program
   .name('offbyt')
   .description('Hybrid Backend Generator - Offline + AI Powered')
@@ -32,8 +42,12 @@ program
   .option('--no-auto-connect', 'Skip auto-connect after generation')
   .option('--quick', 'Use default configuration (no questions)')
   .option('--no-api-detect', 'Skip automatic API detection from frontend')
+  .option('--no-verify', 'Skip Phase-2 backend verification (startup + health check)')
+  .option('--verify-timeout <ms>', 'Health-check timeout in milliseconds', parsePositiveInteger, 45000)
+  .option('--strict-verify', 'Fail command if Phase-2 verification does not pass')
   .action(async (projectPath, options) => {
     try {
+      printBanner();
       const workingPath = projectPath || process.cwd();
       let config;
 
@@ -49,7 +63,8 @@ program
           enableCaching: false,
           enableLogging: true
         };
-        console.log(chalk.cyan('Using default configuration...\n'));
+        printSection('Quick Mode: Using Default Configuration');
+        printSuccess('Configuration ready - MongoDB + Express + Auth enabled');
       } else {
         // Interactive setup
         config = await getInteractiveSetup();
@@ -64,7 +79,7 @@ program
 
       // AUTOMATIC: Smart API detection & generation
       if (options.apiDetect !== false) {
-        console.log(chalk.cyan('\n\n🎯 Running Smart API Detection...\n'));
+        console.log(chalk.cyan('\n\n[PIPELINE] Running Smart API Detection...\n'));
         const { generateSmartAPI } = await import('./lib/modes/generateApi.js');
         try {
           await generateSmartAPI(workingPath, { inject: true, config });
@@ -78,6 +93,48 @@ program
         }
       }
 
+      let shouldRunVerify = options.verify !== false;
+      if (options.verify !== false) {
+        const verifyChoice = await inquirer.prompt([
+          {
+            type: 'confirm',
+            name: 'runVerify',
+            message: 'Run post-generation health check (Phase-2)?',
+            default: true
+          }
+        ]);
+        shouldRunVerify = verifyChoice.runVerify;
+      }
+
+      if (shouldRunVerify) {
+        console.log(chalk.cyan('\n\n[VERIFY] Running Phase-2 verification...\n'));
+        const { verifyGeneratedBackend } = await import('./lib/utils/postGenerationVerifier.js');
+        const verification = await verifyGeneratedBackend(workingPath, {
+          timeoutMs: options.verifyTimeout,
+          maxAttempts: 2
+        });
+
+        if (verification.ok) {
+          console.log(chalk.green(`\n[OK] Phase-2 passed at http://localhost:${verification.port}${verification.healthEndpoint}\n`));
+        } else {
+          console.log(chalk.yellow('\n[WARN] Phase-2 verification did not fully pass.'));
+          console.log(chalk.yellow(`   Reason: ${verification.issue}`));
+          if (verification.fixesApplied.length > 0) {
+            console.log(chalk.gray('   Auto-fixes attempted:'));
+            for (const fix of verification.fixesApplied) {
+              console.log(chalk.gray(`   - ${fix}`));
+            }
+          }
+          console.log(chalk.gray('   You can skip this step next time using --no-verify.\n'));
+
+          if (options.strictVerify) {
+            throw new Error(`Phase-2 verification failed: ${verification.issue}`);
+          }
+        }
+      } else {
+        console.log(chalk.gray('\n[SKIP] Post-generation health check skipped by user choice.\n'));
+      }
+
       // Auto-connect if enabled
       if (options.autoConnect) {
         console.log(chalk.cyan('Auto-connecting frontend & backend...\n'));
@@ -189,6 +246,64 @@ program
     }
   });
 
+program
+  .command('industry-validate [path]')
+  .description('Run offline Industry Mode contract validation and print report')
+  .option('--json', 'Print JSON output')
+  .action(async (projectPath, options) => {
+    try {
+      const {
+        runIndustryContractCheck,
+        printIndustryReport
+      } = await import('./lib/utils/industryMode.js');
+
+      const report = await runIndustryContractCheck(projectPath || process.cwd());
+      if (options.json) {
+        console.log(JSON.stringify(report, null, 2));
+      } else {
+        printIndustryReport(report);
+      }
+
+      process.exit(report.ok ? 0 : 1);
+    } catch (error) {
+      console.error(chalk.red('Error:', error.message));
+      process.exit(1);
+    }
+  });
+
+program
+  .command('industry-smoke [path]')
+  .description('Run offline Industry Mode smoke checks and save report file')
+  .option('--timeout <ms>', 'Smoke timeout in milliseconds', parsePositiveInteger, 45000)
+  .option('--json', 'Print JSON output')
+  .action(async (projectPath, options) => {
+    try {
+      const {
+        runIndustrySmoke,
+        writeIndustryReport,
+        printIndustryReport
+      } = await import('./lib/utils/industryMode.js');
+
+      const workingPath = projectPath || process.cwd();
+      const report = await runIndustrySmoke(workingPath, {
+        timeoutMs: options.timeout
+      });
+
+      const filePath = writeIndustryReport(workingPath, report);
+      if (options.json) {
+        console.log(JSON.stringify({ ...report, reportFile: filePath }, null, 2));
+      } else {
+        printIndustryReport(report);
+        console.log(chalk.cyan(`Report saved: ${filePath}`));
+      }
+
+      process.exit(report.ok ? 0 : 1);
+    } catch (error) {
+      console.error(chalk.red('Error:', error.message));
+      process.exit(1);
+    }
+  });
+
 program.parse(process.argv);
 
 if (!process.argv.slice(2).length) {

package/industry-mode.json

@@ -0,0 +1,22 @@
+{
+  "requiredContract": [
+    "database",
+    "framework",
+    "auth",
+    "resources"
+  ],
+  "minResources": 1,
+  "requireAuth": true,
+  "requiredSecurity": [
+    "validation",
+    "rateLimit",
+    "helmet",
+    "cors"
+  ],
+  "smoke": {
+    "checkHealth": true,
+    "checkResourceList": true,
+    "maxResources": 10,
+    "timeoutMs": 45000
+  }
+}

package/lib/ir-integration.js

@@ -18,7 +18,7 @@ import {
 /**
  * Complete pipeline: Frontend → IR → Backend
  */
-export async function offbyteWithIR(frontendPath, outputPath, options = {}) {
+export async function offbytWithIR(frontendPath, outputPath, options = {}) {
   console.log('\n' + '='.repeat(70));
   console.log('🚀 offbyt - IR-Based Backend Generation');
   console.log('='.repeat(70) + '\n');
@@ -303,7 +303,7 @@ export async function quickGenerate(frontendPath, options = {}) {
   const projectName = path.basename(frontendPath);
   const outputPath = `./offbyt-${projectName}`;
 
-  return offbyteWithIR(frontendPath, outputPath, {
+  return offbytWithIR(frontendPath, outputPath, {
     projectName,
     ...options
   });
@@ -331,7 +331,7 @@ export async function runFromCLI(args) {
   const out = outputPath || `./offbyt-${path.basename(frontendPath)}`;
 
   try {
-    await offbyteWithIR(frontendPath, out, {
+    await offbytWithIR(frontendPath, out, {
       hasAuth: true,
       projectName: path.basename(frontendPath)
     });
@@ -345,5 +345,5 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   runFromCLI(process.argv.slice(2));
 }
 
-export default offbyteWithIR;
+export default offbytWithIR;
 

package/lib/modes/configBasedGenerator.js

@@ -1,4 +1,4 @@
-/**
+/**
  * Configuration-Based Backend Generator
  * Generates production-level backend for selected tech stack
  */
@@ -21,61 +21,61 @@ export async function generateWithConfig(projectPath, config) {
     // Step 1: Create structure
     const step1 = ora('Creating backend structure...').start();
     createBackendStructure(backendPath, config);
-    step1.succeed('✅ Backend structure created');
+    step1.succeed('Backend structure created');
 
     // Step 2: Setup database
     const step2 = ora('Setting up database configuration...').start();
     setupDatabaseConfig(backendPath, config);
-    step2.succeed('✅ Database configured');
+    step2.succeed('Database configured');
 
     // Step 3: Create middleware
     const step3 = ora('Setting up middleware...').start();
     setupMiddleware(backendPath, config);
-    step3.succeed('✅ Middleware configured');
+    step3.succeed('Middleware configured');
 
     // Step 4: Create authentication (if enabled)
     if (config.enableAuth) {
       const step4 = ora('Setting up authentication system...').start();
       setupAuthentication(backendPath, config);
-      step4.succeed('✅ Authentication configured');
+      step4.succeed('Authentication configured');
     }
 
     // Step 5: Create main server
     const step5 = ora('Creating main server file...').start();
     createServerFile(backendPath, config);
-    step5.succeed('✅ Server created');
+    step5.succeed('Server created');
 
     // Step 6: Setup Socket.io (if enabled)
     if (config.enableSocket) {
       const step6 = ora('Setting up realtime sockets...').start();
       setupSockets(backendPath, config);
-      step6.succeed('✅ Sockets configured');
+      step6.succeed('Sockets configured');
     }
 
     // Step 7: Create package.json
     const step7 = ora('Creating package.json...').start();
     createPackageJson(backendPath, config);
-    step7.succeed('✅ Dependencies configured');
+    step7.succeed('Dependencies configured');
 
     // Step 8: Create .env
     const step8 = ora('Creating environment configuration...').start();
     createEnvFile(backendPath, config);
-    step8.succeed('✅ Environment files created (.env, .env.example, .gitignore)');
+    step8.succeed('Environment files created (.env, .env.example, .gitignore)');
 
     // Step 9: Scan frontend and generate detected resources (skip - will be done by smart API)
     const step9 = ora('Skipping sample generation (using Smart API detection instead)...').start();
-    step9.succeed('✅ Backend structure ready for Smart API generation');
+    step9.succeed('Backend structure ready for Smart API generation');
     
     // Step 10: Generate SQL files for SQL databases
     if (['mysql', 'postgresql', 'sqlite'].includes(config.database)) {
       const step10 = ora('Generating SQL scripts...').start();
-      step10.succeed(`✅ SQL scripts created in backend/sql/ (ready for ${config.database.toUpperCase()})`);
+      step10.succeed(`SQL scripts created in backend/sql/ (ready for ${config.database.toUpperCase()})`);
     }
 
-    console.log(chalk.cyan('\n🎉 Backend structure created!\n'));
-    console.log(chalk.cyan('✅ Smart API detection will run automatically next...\n'));
+    console.log(chalk.cyan('\n[OK] Backend structure created.\n'));
+    console.log(chalk.cyan('[OK] Smart API detection will run automatically next...\n'));
    
-    console.log(chalk.yellow('📝 Next steps:'));
+    console.log(chalk.yellow('Next steps:'));
     console.log(chalk.yellow(`   1. cd ${projectPath}/backend`));
     console.log(chalk.yellow('   2. npm install'));
     console.log(chalk.yellow('   3. Review & update .env file:'));
@@ -95,10 +95,10 @@ export async function generateWithConfig(projectPath, config) {
       console.log(chalk.yellow('   4. npm run dev'));
     }
     
-    console.log(chalk.cyan('\n💡 Tip: Never commit .env to git! Use .env.example instead.\n'));
+    console.log(chalk.cyan('\nTip: Never commit .env to git! Use .env.example instead.\n'));
 
   } catch (error) {
-    console.error(chalk.red('❌ Error generating backend:'), error.message);
+    console.error(chalk.red('Error generating backend:'), error.message);
     throw error;
   }
 }
@@ -364,9 +364,9 @@ app.use(requestLogger);
 
 // Database Connection
 connectDatabase().then(() => {
-  console.log('✅ Database connected');
+  console.log('[OK] Database connected');
 }).catch(error => {
-  console.error('❌ Database connection failed:', error);
+  console.error('[ERR] Database connection failed:', error);
   process.exit(1);
 });
 
@@ -397,11 +397,11 @@ io.on('connection', (socket) => {
 });
 
 server.listen(PORT, () => {
-  console.log(\`🚀 Server running on http://localhost:\${PORT}\`);
+  console.log(\`[OK] Server running on http://localhost:\${PORT}\`);
 });`;
   } else {
     serverContent += `app.listen(PORT, () => {
-  console.log(\`🚀 Server running on http://localhost:\${PORT}\`);
+  console.log(\`[OK] Server running on http://localhost:\${PORT}\`);
 });`;
   }
 
@@ -430,9 +430,9 @@ await fastify.register(fastifyCors, { origin: '*' });
 
 // Database Connection
 connectDatabase().then(() => {
-  fastify.log.info('✅ Database connected');
+  fastify.log.info('[OK] Database connected');
 }).catch(error => {
-  fastify.log.error('❌ Database connection failed:', error);
+  fastify.log.error('[ERR] Database connection failed:', error);
   process.exit(1);
 });
 
@@ -468,7 +468,7 @@ io.on('connection', (socket) => {
   serverContent += `// Start server
 try {
   await fastify.listen({ port: PORT, host: '0.0.0.0' });
-  console.log(\`🚀 Fastify server running on http://localhost:\${PORT}\`);
+  console.log(\`[OK] Fastify server running on http://localhost:\${PORT}\`);
 } catch (err) {
   fastify.log.error(err);
   process.exit(1);
@@ -535,7 +535,7 @@ async function bootstrap() {
     });
   });
 ` : ''}
-  console.log(\`🚀 NestJS server running on http://localhost:\${PORT}\`);
+  console.log(\`[OK] NestJS server running on http://localhost:\${PORT}\`);
 }
 
 bootstrap();`;
@@ -815,7 +815,7 @@ async function detectAndGenerateResources(projectPath, backendPath, config) {
         generateRoute(backendPath, resourceName, resourceInfo, config, apiAnalysis);
         generatedResources.push(resourceName);
       } catch (e) {
-        console.warn(`⚠️  Skipped ${resourceName}:`, e.message);
+        console.warn(`[WARN] Skipped ${resourceName}:`, e.message);
       }
     });
 
@@ -847,7 +847,7 @@ async function detectAndGenerateResources(projectPath, backendPath, config) {
 
     return { resources: generatedResources };
   } catch (error) {
-    console.warn('⚠️  Auto-detection error:', error.message);
+    console.warn('[WARN] Auto-detection error:', error.message);
     createSampleResources(backendPath, config);
     return { resources: ['User (sample)'] };
   }
@@ -2251,7 +2251,7 @@ npm run dev
 ## Environment Variables
 See \`../.env\` for required environment variables.
 
-Generated by offbyt âš¡`;
+Generated by offbyt`;
 
   fs.writeFileSync(path.join(backendPath, 'README.md'), readme);
 }

package/lib/modes/connect.js

@@ -18,36 +18,38 @@ import ora from 'ora';
 // ============================================================
 export async function connectFrontendBackend(projectPath) {
   try {
-    console.log(chalk.cyan('\n🔗 offbyt Auto-Connection Engine\n'));
-    console.log(chalk.gray('Scanner: Frontend → Backend Connection Analysis\n'));
+    console.log(chalk.cyan('\n============================================================'));
+    console.log(chalk.cyan('OFFBYT AUTO-CONNECTION ENGINE'));
+    console.log(chalk.cyan('============================================================\n'));
+    console.log(chalk.gray('Scanner: Frontend -> Backend Connection Analysis\n'));
 
     const backendPath = path.join(projectPath, 'backend');
     
     // Verify project structure
     if (!fs.existsSync(backendPath)) {
-      console.error(chalk.red('❌ Backend not found. Run "offbyt generate" first.\n'));
+      console.error(chalk.red('Backend not found. Run "offbyt generate" first.\n'));
       process.exit(1);
     }
 
     // Step 1: Scan React components
     const step1 = ora('Step 1/5: Scanning React components...').start();
     const reactAnalysis = scanReactComponents(projectPath);
-    step1.succeed(`✅ Found ${reactAnalysis.components.length} API components`);
+    step1.succeed(`Found ${reactAnalysis.components.length} API components`);
 
     // Step 2: Scan backend structure
     const step2 = ora('Step 2/5: Analyzing backend routes...').start();
     const backendAnalysis = scanBackendRoutes(backendPath);
-    step2.succeed(`✅ Found ${backendAnalysis.routes.length} backend routes`);
+    step2.succeed(`Found ${backendAnalysis.routes.length} backend routes`);
 
     // Step 3: Detect mismatches
     const step3 = ora('Step 3/5: Analyzing mismatches...').start();
     const mismatches = detectMismatches(reactAnalysis, backendAnalysis);
-    step3.succeed(`✅ Detected ${mismatches.issues.length} issues`);
+    step3.succeed(`Detected ${mismatches.issues.length} issues`);
 
     // Step 4: Auto-fix issues
     const step4 = ora('Step 4/5: Auto-fixing components...').start();
     const fixResults = applyAutoFixes(projectPath, backendPath, mismatches, reactAnalysis, backendAnalysis);
-    step4.succeed(`✅ Fixed ${fixResults.fixed} issues`);
+    step4.succeed(`Fixed ${fixResults.fixed} issues`);
 
     // Detect Vite
     let isVite = false;
@@ -64,18 +66,18 @@ export async function connectFrontendBackend(projectPath) {
     // Step 5: Create/Update .env
     const step5 = ora('Step 5/5: Configuring environment...').start();
     createFrontendEnv(projectPath, backendAnalysis.serverPort, isVite);
-    step5.succeed('✅ .env file configured');
+    step5.succeed('.env file configured');
 
     // Summary
-    console.log(chalk.green('\n✅ Auto-Connection Complete!\n'));
-    console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk.green('\n[OK] Auto-Connection Complete!\n'));
+    console.log(chalk.gray('------------------------------------------------------------'));
     console.log(chalk.white('  Components Updated:'), reactAnalysis.components.length);
     console.log(chalk.white('  Issues Fixed:'), fixResults.fixed);
     console.log(chalk.white('  API URL Configured:'), `http://localhost:${backendAnalysis.serverPort}`);
-    console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+    console.log(chalk.gray('------------------------------------------------------------\n'));
     
     if (mismatches.issues.length > 0) {
-      console.log(chalk.yellow('⚠️  Issues Found (Auto-Fixed):\n'));
+      console.log(chalk.yellow('[WARN] Issues Found (Auto-Fixed):\n'));
       mismatches.issues.forEach((issue, i) => {
         console.log(chalk.gray(`  ${i+1}. ${issue.type}`));
         console.log(chalk.gray(`     File: ${issue.file}`));
@@ -83,13 +85,13 @@ export async function connectFrontendBackend(projectPath) {
       });
     }
 
-    console.log(chalk.cyan('🚀 Ready to start:\n'));
+    console.log(chalk.cyan('Ready to start:\n'));
     console.log(chalk.white('  Frontend:', chalk.bold(`npm start`)));
     console.log(chalk.white('  Backend:', chalk.bold(`npm start`)));
     console.log(chalk.cyan('\n'));
 
   } catch (error) {
-    console.error(chalk.red('❌ Connection Error:', error.message));
+    console.error(chalk.red('Connection Error:'), error.message);
     process.exit(1);
   }
 }
@@ -152,7 +154,7 @@ function scanReactComponents(projectPath) {
         });
       }
     } catch (error) {
-      console.warn(chalk.gray(`  ⚠️  Skipped: ${path.relative(projectPath, file)}`));
+      console.warn(chalk.gray(`  [WARN] Skipped: ${path.relative(projectPath, file)}`));
     }
   });
 
@@ -306,7 +308,7 @@ function scanBackendRoutes(backendPath) {
 
     return { routes, models, serverPort };
   } catch (error) {
-    console.warn(chalk.yellow(`⚠️  Backend scan error: ${error.message}`));
+    console.warn(chalk.yellow(`[WARN] Backend scan error: ${error.message}`));
     return { routes: [], models: [], serverPort: 5000 };
   }
 }
@@ -581,7 +583,7 @@ function applyAutoFixes(projectPath, backendPath, mismatches, reactAnalysis, bac
         }
       }
     } catch (error) {
-      console.warn(chalk.gray(`    ⚠️  Could not fix: ${issue.file} - ${error.message}`));
+      console.warn(chalk.gray(`    [WARN] Could not fix: ${issue.file} - ${error.message}`));
     }
   });
 
@@ -613,10 +615,10 @@ function applyAutoFixes(projectPath, backendPath, mismatches, reactAnalysis, bac
 function fixResponseParsing(content) {
   // Fix common response parsing patterns
   
-  // Pattern 1: res.data.data.token → res.data.token (if response is {data: {...}})
+  // Pattern 1: res.data.data.token → res.data.token (if response is {data: {...}})
   content = content.replace(/data\.data\.(\w+)/g, 'data.$1');
   
-  // Pattern 2: response.data.data.user → response.data.user
+  // Pattern 2: response.data.data.user → response.data.user
   content = content.replace(/response\.data\.data\.(\w+)/g, 'response.data.$1');
 
   // Pattern 3: const x = await response.json();
@@ -639,7 +641,7 @@ function fixApiUrls(content, isVite = false) {
   // Ensure API calls use environment variables for base URL
   const API_URL = isVite ? 'import.meta.env.VITE_API_URL' : 'process.env.REACT_APP_API_URL';
   
-  // Pattern 1: fetch('/api/... → fetch(`/api/...
+  // Pattern 1: fetch('/api/... → fetch(`/api/...
   content = content.replace(
     /fetch\s*\(\s*['"`](\/api\/[^'"`]+)['"`]/g,
     `fetch(\`\${${API_URL}}$1\``
@@ -661,7 +663,7 @@ function fixApiUrls(content, isVite = false) {
     `fetch(\`\${${API_URL}}$1\``
   );
 
-  // Pattern 3: const url = '/api/... → const url = `/api/...
+  // Pattern 3: const url = '/api/... → const url = `/api/...
   content = content.replace(
     /(const|let|var)\s+(\w+)\s*=\s*['"`](\/api\/[^'"`]+)['"`]/g,
     `$1 $2 = \`\${${API_URL}}$3\``
@@ -1020,9 +1022,9 @@ function escapeRegex(string) {
 /**
  * Parse API path to extract resource name and route path
  * Examples:
- * /api/admin/dashboard → {resourceName: 'admin', routePath: '/dashboard'}
- * /api/user/invoices → {resourceName: 'user', routePath: '/invoices'}
- * /api/products/:id → {resourceName: 'products', routePath: '/:id'}
+ * /api/admin/dashboard → {resourceName: 'admin', routePath: '/dashboard'}
+ * /api/user/invoices → {resourceName: 'user', routePath: '/invoices'}
+ * /api/products/:id → {resourceName: 'products', routePath: '/:id'}
  */
 function parseApiPath(apiPath) {
   const normalizedPath = normalizeRoutePath(apiPath);
@@ -1122,4 +1124,3 @@ router.${methodLower}('${cleanPath}', async (req, res) => {
   }
 });`;
 }
-