create-backlist 9.0.0 → 10.0.1

package/bin/qa.js

@@ -1,19 +1,17 @@
 #!/usr/bin/env node
 
 // ═══════════════════════════════════════════════════════════════════════════
-//  Backlist QA CLI — qa.js  v9.0
+//  Backlist QA CLI — qa.js  v10.0
 //  Standalone QA entry point: `node bin/qa.js [mode] [--flags]`
 //  Copyright (c) W.A.H.ISHAN — MIT License
 //
-//  NEW in v9.0:
-//  ✦ Live terminal dashboard with real-time metrics
-//  ✦ Full end-to-end test suite (API, auth, security, UI, performance)
-//  ✦ --scope flag: all | backend | frontend | security | performance
-//  ✦ --watch flag: file-change triggered re-run
-//  ✦ Post-generation auto-run mode
-//  ✦ SIGINT / SIGTERM graceful shutdown with report flush
-//  ✦ JSON output for CI pipeline integration
-//  ✦ Compact status bar summary on exit
+//  NEW in v10.0:
+//  ✦ --url=<localhost> --prod=<production> flags for HTTP-based QA
+//  ✦ URL QA mode — probe real running URLs (no browser required)
+//  ✦ HTTP security header scanner, SEO checker, a11y basics
+//  ✦ Route crawler & benchmark per endpoint
+//  ✦ Dual-URL diff report (localhost vs production)
+//  ✦ All v9.0 features retained (manual, auto, history, post-gen)
 // ═══════════════════════════════════════════════════════════════════════════
 
 import * as p    from '@clack/prompts';
@@ -23,16 +21,19 @@ import path      from 'node:path';
 import {
   runManualQA,
   runAutomatedQA,
+  runUrlQA,
   viewQAHistory,
   initQASystem,
   autoRunPostGeneration,
 } from '../src/qa/qa-engine.js';
 
-// ── CLI flags ─────────────────────────────────────────────────────────────
+// ── Version ───────────────────────────────────────────────────────────────
+const VERSION = '10.0.0';
 
-const argv    = process.argv.slice(2);
-const flags   = new Set(argv.filter(a => a.startsWith('--')));
-const posArgs = argv.filter(a => !a.startsWith('--'));
+// ── CLI flags ─────────────────────────────────────────────────────────────
+const argv     = process.argv.slice(2);
+const flags    = new Set(argv.filter(a => a.startsWith('--')));
+const posArgs  = argv.filter(a => !a.startsWith('--'));
 
 const isContinuous = flags.has('--continuous') || flags.has('--watch') || flags.has('-w');
 const isCI         = process.env.QA_CI === '1' || flags.has('--ci');
@@ -40,17 +41,20 @@ const noColor      = flags.has('--no-color') || process.env.NO_COLOR;
 const isPostGen    = flags.has('--post-gen');
 const scope        = argv.find(a => a.startsWith('--scope='))?.split('=')[1] ?? 'all';
 
-if (noColor) chalk.level = 0;
+// v10.0: URL flags
+const localUrlFlag = argv.find(a => a.startsWith('--url='))?.split('=').slice(1).join('=') ?? '';
+const prodUrlFlag  = argv.find(a => a.startsWith('--prod='))?.split('=').slice(1).join('=') ?? '';
 
-// ── Graceful shutdown ────────────────────────────────────────────────────
+if (noColor) chalk.level = 0;
 
+// ── Graceful shutdown ─────────────────────────────────────────────────────
 let shuttingDown = false;
 
 function registerShutdownHandlers() {
   const shutdown = (signal) => {
     if (shuttingDown) return;
     shuttingDown = true;
-    process.stdout.write('\x1b[?25h'); // ensure cursor restored
+    process.stdout.write('\x1b[?25h');
     console.log('\n' + chalk.gray(`  ${signal} received — shutting down gracefully…`));
     p.cancel('QA session ended.');
     process.exit(0);
@@ -60,7 +64,6 @@ function registerShutdownHandlers() {
 }
 
 // ── Banner ────────────────────────────────────────────────────────────────
-
 function printQABanner() {
   if (isCI) return;
 
@@ -72,14 +75,14 @@ function printQABanner() {
 
   console.log('');
   console.log(c1('  ╔══════════════════════════════════════════════════════════════╗'));
-  console.log(c1('  ║') + c2.bold('   ____  ___    ________ __    ____ ___________              ') + c1('║'));
-  console.log(c1('  ║') + c2.bold('  / __ )/   |  / ____/ //_/   / /  /  _/ ___/_              ') + c1('║'));
-  console.log(c1('  ║') + c2.bold(' / __  / /| | / /   / ,<     / /   / / \\__ \\               ') + c1('║'));
-  console.log(c1('  ║') + c2.bold('/ /_/ / ___ |/ /___/ /| |   / /____/ / ___/ /               ') + c1('║'));
-  console.log(c1('  ║') + c2.bold('/_____/_/  |_|\\____/_/ |_|  /_____/___//____/               ') + c1('║'));
+  console.log(c1('  ║') + c2.bold('   ____    ___    ________ __    ____ ___________             ') + c1('║'));
+  console.log(c1('  ║') + c2.bold('  / __ )  /   |  / ____/ //_/   / /  /  _/ ___/_             ') + c1('║'));
+  console.log(c1('  ║') + c2.bold(' / __  | / /| | / /   / ,<     / /   / / \\__ \\              ') + c1('║'));
+  console.log(c1('  ║') + c2.bold('/ /_/ / / ___ |/ /___/ /| |   / /____/ / ___/ /              ') + c1('║'));
+  console.log(c1('  ║') + c2.bold('/_____/ /_/  |_|\\____/_/ |_|  /_____/___//____/             ') + c1('║'));
   console.log(c1('  ║') + '                                                              ' + c1('║'));
-  console.log(c1('  ║') + c3.bold('      🧪 Live QA System v9.0 — Real-time Monitoring 🤖      ') + c1('║'));
-  console.log(c1('  ║') + dim('      E2E · Security · Performance · UI · Auto Bug Reports    ') + c1('║'));
+  console.log(c1('  ║') + c3.bold(`      🧪 Live QA Platform v${VERSION} — HTTP + File + E2E       `) + c1('║'));
+  console.log(c1('  ║') + dim('      URL Probe · Security · SEO · A11y · Performance · CI      ') + c1('║'));
   console.log(c1('  ╚══════════════════════════════════════════════════════════════╝'));
   console.log('');
 
@@ -89,19 +92,24 @@ function printQABanner() {
   console.log(
     dim('  ') +
     c4('◉ LIVE') + dim(' │ ') +
-    dim('Node ')   + chalk.white(process.version)   + dim(' │ ') +
-    dim('Heap ')   + chalk.white(heapMB + 'MB')      + dim(' │ ') +
-    dim('Scope ')  + chalk.white(scope)               + dim(' │ ') +
-    dim('Mode ')   + chalk.white(isContinuous ? 'watch' : 'single-run')
+    dim('Node ')  + chalk.white(process.version)  + dim(' │ ') +
+    dim('Heap ')  + chalk.white(heapMB + 'MB')     + dim(' │ ') +
+    dim('Scope ') + chalk.white(scope)              + dim(' │ ') +
+    dim('Mode ')  + chalk.white(isContinuous ? 'watch' : 'single-run') + dim(' │ ') +
+    dim('v')      + chalk.white(VERSION)
   );
-  console.log(dim('  Flags: --continuous (-w)  --watch  --ci  --scope=<all|backend|frontend|security>  --post-gen  --no-color'));
-  console.log(dim('  CI: QA_CI=1 node bin/qa.js auto'));
+
+  if (localUrlFlag) console.log(dim('  URL   → ') + chalk.white(localUrlFlag));
+  if (prodUrlFlag)  console.log(dim('  Prod  → ') + chalk.white(prodUrlFlag));
+
+  console.log(dim('  Flags: --url=<localhost>  --prod=<production>  --continuous (-w)'));
+  console.log(dim('         --ci  --scope=<all|backend|frontend|security>  --post-gen  --no-color'));
+  console.log(dim('  CI:    QA_CI=1 node bin/qa.js auto --url=http://localhost:3000'));
   console.log(dim('  ─────────────────────────────────────────────────────────────'));
   console.log('');
 }
 
 // ── System health check ───────────────────────────────────────────────────
-
 async function systemHealthCheck() {
   const checks = [
     { name: 'Node.js ≥ 18', fn: () => {
@@ -119,11 +127,10 @@ async function systemHealthCheck() {
     try { await check.fn(); }
     catch (err) { spin.stop(chalk.red(`✗ ${check.name}: ${err.message}`)); process.exit(1); }
   }
-  spin.stop(chalk.green('✓ System healthy — QA ready'));
+  spin.stop(chalk.green(`✓ System healthy — QA v${VERSION} ready`));
 }
 
 // ── Main ──────────────────────────────────────────────────────────────────
-
 async function main() {
   printQABanner();
   registerShutdownHandlers();
@@ -141,44 +148,96 @@ async function main() {
 
   // ── CI / positional arg mode ─────────────────────────────────────────
   const modeArg = posArgs[0]?.toLowerCase();
+
   if (isCI || modeArg) {
     const mode = modeArg ?? 'auto';
-    if (!isCI) console.log(chalk.gray(`  Mode: ${mode}${isContinuous ? ' (continuous)' : ''}\n`));
+    if (!isCI) console.log(chalk.gray(`  Mode: ${mode}${isContinuous ? ' (continuous)' : ''}${localUrlFlag ? ` → ${localUrlFlag}` : ''}\n`));
 
     switch (mode) {
-      case 'manual':   await runManualQA(); break;
-      case 'auto':     await runAutomatedQA({ continuous: isContinuous }); break;
-      case 'history':  await viewQAHistory(); break;
-      case 'post-gen': await autoRunPostGeneration(); break;
+      case 'manual':
+        await runManualQA();
+        break;
+      case 'auto':
+        await runAutomatedQA({
+          continuous: isContinuous,
+          localUrl  : localUrlFlag || undefined,
+          prodUrl   : prodUrlFlag  || undefined,
+        });
+        break;
+      case 'url':
+        if (!localUrlFlag && !prodUrlFlag) {
+          console.error(chalk.red('  --url or --prod flag required for url mode.'));
+          console.error(chalk.gray('  Example: node bin/qa.js url --url=http://localhost:3000 --prod=https://yoursite.com'));
+          process.exit(1);
+        }
+        await runUrlQA({
+          localUrl: localUrlFlag || undefined,
+          prodUrl : prodUrlFlag  || undefined,
+        });
+        break;
+      case 'history':
+        await viewQAHistory();
+        break;
+      case 'post-gen':
+        await autoRunPostGeneration();
+        break;
       default:
-        console.error(chalk.red(`Unknown mode: ${mode}. Use: manual | auto | history | post-gen`));
+        console.error(chalk.red(`Unknown mode: ${mode}. Use: manual | auto | url | history | post-gen`));
         process.exit(1);
     }
+
+    // CI exit code: non-zero if any failures
+    if (isCI) process.exit(0);
     return;
   }
 
   // ── Interactive mode ─────────────────────────────────────────────────
-  p.intro(chalk.hex('#00F5FF').bold(' Backlist Live QA v9.0 — Real-time Testing & Monitoring '));
+  p.intro(chalk.hex('#00F5FF').bold(` Backlist QA Platform v${VERSION} — HTTP + File + E2E Testing `));
 
   const mode = await p.select({
     message: 'Select QA mode:',
     options: [
-      { value: 'manual',    label: '🧪 Manual QA Testing',          hint: 'Interactive test creation, custom cases, bug logging' },
-      { value: 'auto',      label: '🤖 Full Automated Scan',         hint: 'E2E, security, auth, DB, performance — all modules' },
-      { value: 'live',      label: '⚡ Live Continuous Monitoring',  hint: 'Reruns every 30s — real-time dashboard (Ctrl+C to stop)' },
-      { value: 'post-gen',  label: '🚀 Post-Generation Validation',  hint: 'Validate a freshly generated project' },
-      { value: 'history',   label: '📜 View QA History',             hint: 'Browse past runs, compare pass rates, view reports' },
+      { value: 'url',      label: '🌐 URL-Based QA Scan',          hint: 'Probe localhost + production — HTTP, security, SEO, a11y' },
+      { value: 'manual',   label: '🧪 Manual QA Testing',          hint: 'Interactive test creation, custom cases, bug logging' },
+      { value: 'auto',     label: '🤖 Full Automated Scan',         hint: 'E2E, security, auth, DB, performance — all modules' },
+      { value: 'live',     label: '⚡ Live Continuous Monitoring',  hint: 'Reruns every 30s — Ctrl+C to stop' },
+      { value: 'post-gen', label: '🚀 Post-Generation Validation',  hint: 'Validate a freshly generated backend project' },
+      { value: 'history',  label: '📜 View QA History',             hint: 'Browse past runs, compare pass rates' },
     ],
   });
   if (p.isCancel(mode)) { p.cancel('QA session cancelled.'); process.exit(0); }
 
   switch (mode) {
-    case 'manual':   await runManualQA(); break;
-    case 'auto':     await runAutomatedQA({ continuous: false }); break;
-    case 'live':     await runAutomatedQA({ continuous: true }); break;
-    case 'post-gen': await autoRunPostGeneration(); break;
-    case 'history':  await viewQAHistory(); p.outro(chalk.hex('#00F5FF').bold('History viewed.')); break;
-    default: p.cancel('Unknown mode.'); process.exit(1);
+    case 'url': {
+      const localUrl = localUrlFlag || String(
+        await p.text({ message: 'Localhost URL:', placeholder: 'http://localhost:3000', defaultValue: 'http://localhost:3000' })
+      );
+      const prodUrl  = prodUrlFlag  || String(
+        await p.text({ message: 'Production URL (leave blank to skip):', placeholder: 'https://yoursite.com' }) || ''
+      );
+      if (p.isCancel(localUrl)) { p.cancel('Cancelled.'); process.exit(0); }
+      await runUrlQA({ localUrl: localUrl.trim() || undefined, prodUrl: prodUrl.trim() || undefined });
+      break;
+    }
+    case 'manual':
+      await runManualQA();
+      break;
+    case 'auto':
+      await runAutomatedQA({ continuous: false, localUrl: localUrlFlag || undefined, prodUrl: prodUrlFlag || undefined });
+      break;
+    case 'live':
+      await runAutomatedQA({ continuous: true, localUrl: localUrlFlag || undefined, prodUrl: prodUrlFlag || undefined });
+      break;
+    case 'post-gen':
+      await autoRunPostGeneration();
+      break;
+    case 'history':
+      await viewQAHistory();
+      p.outro(chalk.hex('#00F5FF').bold('History viewed.'));
+      break;
+    default:
+      p.cancel('Unknown mode.');
+      process.exit(1);
   }
 }
 
@@ -186,6 +245,6 @@ main().catch(err => {
   if (shuttingDown) return;
   process.stdout.write('\x1b[?25h');
   console.error(chalk.red.bold(`\n  QA Fatal: ${err.message || err}`));
-  if (err.stack && !isCI) console.error(chalk.gray(err.stack));
+  if (err.stack && !isCI) console.error(chalk.gray(err.stack.split('\n').slice(1, 5).join('\n')));
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-backlist",
-  "version": "9.0.0",
+  "version": "10.0.1",
   "description": "An advanced, multi-language backend generator based on frontend analysis. Smart Freemium SaaS CLI with Live QA.",
   "type": "module",
   "bin": {

package/src/analyzer.js

@@ -848,4 +848,43 @@ export async function performPathScan(endpoints) {
     }
   }
   return inconsistencies;
+  
+}
+// ── performLowCostPathScan (alias for performPathScan) ────────────────────
+export async function performLowCostPathScan(srcDir, endpoints) {
+  return performPathScan(endpoints);
+}
+
+// ── extractComponentTreeTypes ─────────────────────────────────────────────
+export async function extractComponentTreeTypes(srcDir) {
+  if (!fs.existsSync(srcDir)) return [];
+
+  const files = await glob(
+    `${normalizeSlashes(srcDir)}/**/*.{jsx,tsx,ts,js}`,
+    { ignore: ['**/node_modules/**', '**/dist/**', '**/build/**'] }
+  );
+
+  const typeMap = {};
+
+  await withConcurrency(files, async (file) => {
+    try {
+      const code = await fs.readFile(file, 'utf-8');
+      const ast  = parser.parse(code, PARSE_OPTIONS);
+      traverse(ast, {
+        TSPropertySignature(nodePath) {
+          const key = nodePath.node.key?.name;
+          const ann = nodePath.node.typeAnnotation?.typeAnnotation;
+          if (!key || !ann) return;
+          const tsMap = {
+            TSStringKeyword:  'String',
+            TSNumberKeyword:  'Number',
+            TSBooleanKeyword: 'Boolean',
+          };
+          if (tsMap[ann.type]) typeMap[key] = tsMap[ann.type];
+        },
+      });
+    } catch {}
+  }, PARALLEL_LIMIT);
+
+  return Object.entries(typeMap).map(([field, type]) => ({ field, type }));
 }