create-backlist 7.3.1 → 9.0.0

package/bin/qa.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+
+// ═══════════════════════════════════════════════════════════════════════════
+//  Backlist QA CLI — qa.js  v9.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
+// ═══════════════════════════════════════════════════════════════════════════
+
+import * as p    from '@clack/prompts';
+import chalk     from 'chalk';
+import fs        from 'fs-extra';
+import path      from 'node:path';
+import {
+  runManualQA,
+  runAutomatedQA,
+  viewQAHistory,
+  initQASystem,
+  autoRunPostGeneration,
+} from '../src/qa/qa-engine.js';
+
+// ── 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');
+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;
+
+// ── Graceful shutdown ────────────────────────────────────────────────────
+
+let shuttingDown = false;
+
+function registerShutdownHandlers() {
+  const shutdown = (signal) => {
+    if (shuttingDown) return;
+    shuttingDown = true;
+    process.stdout.write('\x1b[?25h'); // ensure cursor restored
+    console.log('\n' + chalk.gray(`  ${signal} received — shutting down gracefully…`));
+    p.cancel('QA session ended.');
+    process.exit(0);
+  };
+  process.on('SIGINT',  () => shutdown('SIGINT'));
+  process.on('SIGTERM', () => shutdown('SIGTERM'));
+}
+
+// ── Banner ────────────────────────────────────────────────────────────────
+
+function printQABanner() {
+  if (isCI) return;
+
+  const c1  = chalk.hex('#00F5FF');
+  const c2  = chalk.hex('#BF40FF');
+  const c3  = chalk.hex('#FF6B6B');
+  const c4  = chalk.hex('#00FF9F');
+  const dim = chalk.gray;
+
+  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('  ║') + '                                                              ' + 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('  ╚══════════════════════════════════════════════════════════════╝'));
+  console.log('');
+
+  const mem    = process.memoryUsage();
+  const heapMB = (mem.heapUsed / 1024 / 1024).toFixed(0);
+
+  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')
+  );
+  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'));
+  console.log(dim('  ─────────────────────────────────────────────────────────────'));
+  console.log('');
+}
+
+// ── System health check ───────────────────────────────────────────────────
+
+async function systemHealthCheck() {
+  const checks = [
+    { name: 'Node.js ≥ 18', fn: () => {
+      const maj = parseInt(process.version.replace('v','').split('.')[0]);
+      if (maj < 18) throw new Error(`Node.js ${process.version} — requires v18+`);
+    }},
+    { name: 'QA directories', fn: async () => {
+      await fs.ensureDir(path.join(process.cwd(), '.backlist', 'qa', 'reports'));
+    }},
+  ];
+
+  const spin = p.spinner();
+  spin.start('System health check…');
+  for (const check of checks) {
+    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'));
+}
+
+// ── Main ──────────────────────────────────────────────────────────────────
+
+async function main() {
+  printQABanner();
+  registerShutdownHandlers();
+
+  await initQASystem();
+  await systemHealthCheck();
+
+  // ── Post-generation auto-run ─────────────────────────────────────────
+  if (isPostGen) {
+    const projectDir  = posArgs[0] ? path.resolve(posArgs[0]) : process.cwd();
+    const projectName = path.basename(projectDir);
+    await autoRunPostGeneration({ projectDir, projectName });
+    process.exit(0);
+  }
+
+  // ── 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`));
+
+    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;
+      default:
+        console.error(chalk.red(`Unknown mode: ${mode}. Use: manual | auto | history | post-gen`));
+        process.exit(1);
+    }
+    return;
+  }
+
+  // ── Interactive mode ─────────────────────────────────────────────────
+  p.intro(chalk.hex('#00F5FF').bold(' Backlist Live QA v9.0 — Real-time Testing & Monitoring '));
+
+  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' },
+    ],
+  });
+  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);
+  }
+}
+
+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));
+  process.exit(1);
+});

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "create-backlist",
-  "version": "7.3.1",
-  "description": "An advanced, multi-language backend generator based on frontend analysis. Smart Freemium SaaS CLI.",
+  "version": "9.0.0",
+  "description": "An advanced, multi-language backend generator based on frontend analysis. Smart Freemium SaaS CLI with Live QA.",
   "type": "module",
   "bin": {
-    "create-backlist": "bin/index.js"
+    "create-backlist": "bin/index.js",
+    "backlist-qa": "bin/qa.js"
   },
   "files": [
     "bin",
@@ -12,23 +13,31 @@
     "AiModuls"
   ],
   "scripts": {
-    "start": "node bin/index.js"
+    "start"       : "node bin/index.js",
+    "qa"          : "node bin/qa.js",
+    "qa:auto"     : "node bin/qa.js auto",
+    "qa:live"     : "node bin/qa.js auto --continuous",
+    "qa:manual"   : "node bin/qa.js manual",
+    "qa:history"  : "node bin/qa.js history",
+    "qa:security" : "node bin/qa.js auto --scope=security",
+    "qa:post-gen" : "node bin/qa.js --post-gen",
+    "qa:ci"       : "QA_CI=1 node bin/qa.js auto"
   },
   "author": "W.A.H.ISHAN",
   "license": "MIT",
   "dependencies": {
-    "@babel/parser": "^7.22.7",
-    "@babel/traverse": "^7.22.8",
-    "@clack/prompts": "^0.7.0",
-    "axios": "^1.13.1",
-    "chalk": "^5.3.0",
-    "ejs": "^3.1.9",
-    "execa": "^8.0.1",
-    "fs-extra": "^11.1.1",
-    "glob": "^10.3.3",
-    "inquirer": "^9.2.12",
-    "ora": "^7.0.1",
-    "together-ai": "^0.39.0",
-    "unzipper": "^0.12.3"
+    "@babel/parser"   : "^7.22.7",
+    "@babel/traverse" : "^7.22.8",
+    "@clack/prompts"  : "^0.7.0",
+    "axios"           : "^1.13.1",
+    "chalk"           : "^5.3.0",
+    "ejs"             : "^3.1.9",
+    "execa"           : "^8.0.1",
+    "fs-extra"        : "^11.1.1",
+    "glob"            : "^10.3.3",
+    "inquirer"        : "^9.2.12",
+    "ora"             : "^7.0.1",
+    "together-ai"     : "^0.39.0",
+    "unzipper"        : "^0.12.3"
   }
-}
+}