@theihtisham/agent-shadow-brain 2.1.0 → 3.0.0

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// src/cli.ts — CLI entry point for Shadow Brain v2.1.0
+// src/cli.ts — CLI entry point for Shadow Brain v3.0.0
 import { Command } from 'commander';
 import chalk from 'chalk';
 import Conf from 'conf';
@@ -7,7 +7,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { Orchestrator } from './brain/orchestrator.js';
 import { detectRunningAgents, createAdapter } from './adapters/index.js';
-const VERSION = '2.1.0';
+const VERSION = '3.0.0';
 const config = new Conf({
     projectName: 'shadow-brain',
     defaults: {
@@ -1460,11 +1460,404 @@ meshCmd.command('aggregate')
         process.exit(1);
     }
 });
+// ─── AST (Complexity Analysis) ────────────────────────────────────────────────
+const astCmd = new Command('ast')
+    .description('Run AST-level complexity analysis — cyclomatic complexity, nesting, function size')
+    .argument('[project-dir]', 'Project directory', process.cwd())
+    .option('--json', 'Output as JSON')
+    .option('--max-files <n>', 'Max files to analyze', '200')
+    .action(async (projectDir, opts) => {
+    const brainConfig = mergeConfig({ projectDir, watchMode: false });
+    const orchestrator = new Orchestrator(brainConfig);
+    try {
+        console.log(chalk.cyan('  Running AST complexity analysis...'));
+        const insights = await orchestrator.runASTAnalysis(parseInt(opts.maxFiles));
+        if (opts.json) {
+            console.log(JSON.stringify(insights, null, 2));
+            return;
+        }
+        console.log(chalk.magenta.bold(`\n  SHADOW BRAIN AST Analysis (${insights.length} findings)\n`));
+        if (insights.length === 0) {
+            console.log(chalk.green('  No complexity issues detected!'));
+            return;
+        }
+        for (const insight of insights) {
+            const color = insight.priority === 'critical' ? 'red' : insight.priority === 'high' ? 'yellow' : 'blue';
+            console.log(chalk `  {${color}.bold [${insight.priority.toUpperCase()}]} ${insight.title}`);
+            console.log(chalk.dim(`    Files: ${insight.files?.join(', ') || 'none'}`));
+            console.log(`    ${insight.content.slice(0, 200)}${insight.content.length > 200 ? '...' : ''}`);
+            console.log();
+        }
+    }
+    catch (err) {
+        console.error(chalk.red('  Error:'), err.message);
+        process.exit(1);
+    }
+});
+// ─── A11Y (Accessibility Audit) ──────────────────────────────────────────────
+const a11yCmd = new Command('a11y')
+    .description('Run WCAG accessibility audit on frontend code')
+    .argument('[project-dir]', 'Project directory', process.cwd())
+    .option('--json', 'Output as JSON')
+    .option('--max-files <n>', 'Max files to analyze', '200')
+    .action(async (projectDir, opts) => {
+    const brainConfig = mergeConfig({ projectDir, watchMode: false });
+    const orchestrator = new Orchestrator(brainConfig);
+    try {
+        console.log(chalk.cyan('  Running accessibility audit...'));
+        const insights = await orchestrator.runA11yCheck(parseInt(opts.maxFiles));
+        if (opts.json) {
+            console.log(JSON.stringify(insights, null, 2));
+            return;
+        }
+        console.log(chalk.magenta.bold(`\n  SHADOW BRAIN Accessibility Audit (${insights.length} issues)\n`));
+        if (insights.length === 0) {
+            console.log(chalk.green('  No accessibility issues found!'));
+            return;
+        }
+        for (const insight of insights) {
+            const color = insight.priority === 'critical' ? 'red' : insight.priority === 'high' ? 'yellow' : 'blue';
+            console.log(chalk `  {${color}.bold [${insight.priority.toUpperCase()}]} ${insight.title}`);
+            console.log(chalk.dim(`    Files: ${insight.files?.join(', ') || 'none'}`));
+            console.log(`    ${insight.content.slice(0, 200)}${insight.content.length > 200 ? '...' : ''}`);
+            console.log();
+        }
+    }
+    catch (err) {
+        console.error(chalk.red('  Error:'), err.message);
+        process.exit(1);
+    }
+});
+// ─── I18N (Internationalization) ──────────────────────────────────────────────
+const i18nCmd = new Command('i18n')
+    .description('Check internationalization readiness — hardcoded strings, locale support')
+    .argument('[project-dir]', 'Project directory', process.cwd())
+    .option('--json', 'Output as JSON')
+    .option('--max-files <n>', 'Max files to analyze', '200')
+    .action(async (projectDir, opts) => {
+    const brainConfig = mergeConfig({ projectDir, watchMode: false });
+    const orchestrator = new Orchestrator(brainConfig);
+    try {
+        console.log(chalk.cyan('  Running i18n readiness check...'));
+        const insights = await orchestrator.runI18nAnalysis(parseInt(opts.maxFiles));
+        if (opts.json) {
+            console.log(JSON.stringify(insights, null, 2));
+            return;
+        }
+        console.log(chalk.magenta.bold(`\n  SHADOW BRAIN i18n Analysis (${insights.length} findings)\n`));
+        if (insights.length === 0) {
+            console.log(chalk.green('  No i18n issues found!'));
+            return;
+        }
+        for (const insight of insights) {
+            const color = insight.priority === 'high' ? 'yellow' : 'blue';
+            console.log(chalk `  {${color}.bold [${insight.priority.toUpperCase()}]} ${insight.title}`);
+            console.log(chalk.dim(`    Files: ${insight.files?.join(', ') || 'none'}`));
+            console.log(`    ${insight.content.slice(0, 200)}${insight.content.length > 200 ? '...' : ''}`);
+            console.log();
+        }
+    }
+    catch (err) {
+        console.error(chalk.red('  Error:'), err.message);
+        process.exit(1);
+    }
+});
+// ─── DEAD-CODE ────────────────────────────────────────────────────────────────
+const deadCodeCmd = new Command('dead-code')
+    .description('Detect dead code — unreachable code, unused exports, unused variables')
+    .argument('[project-dir]', 'Project directory', process.cwd())
+    .option('--json', 'Output as JSON')
+    .option('--max-files <n>', 'Max files to analyze', '200')
+    .action(async (projectDir, opts) => {
+    const brainConfig = mergeConfig({ projectDir, watchMode: false });
+    const orchestrator = new Orchestrator(brainConfig);
+    try {
+        console.log(chalk.cyan('  Scanning for dead code...'));
+        const insights = await orchestrator.runDeadCodeAnalysis(parseInt(opts.maxFiles));
+        if (opts.json) {
+            console.log(JSON.stringify(insights, null, 2));
+            return;
+        }
+        console.log(chalk.magenta.bold(`\n  SHADOW BRAIN Dead Code Detection (${insights.length} findings)\n`));
+        if (insights.length === 0) {
+            console.log(chalk.green('  No dead code detected!'));
+            return;
+        }
+        for (const insight of insights) {
+            const color = insight.priority === 'high' ? 'yellow' : 'blue';
+            console.log(chalk `  {${color}.bold [${insight.priority.toUpperCase()}]} ${insight.title}`);
+            console.log(chalk.dim(`    Files: ${insight.files?.join(', ') || 'none'}`));
+            console.log(`    ${insight.content.slice(0, 200)}${insight.content.length > 200 ? '...' : ''}`);
+            console.log();
+        }
+    }
+    catch (err) {
+        console.error(chalk.red('  Error:'), err.message);
+        process.exit(1);
+    }
+});
+// ─── MUTATION (Mutation Testing Advisor) ──────────────────────────────────────
+const mutationCmd = new Command('mutation')
+    .description('Suggest mutation testing cases — tests that would catch real bugs')
+    .argument('[project-dir]', 'Project directory', process.cwd())
+    .option('--json', 'Output as JSON')
+    .option('--max-files <n>', 'Max files to analyze', '200')
+    .action(async (projectDir, opts) => {
+    const brainConfig = mergeConfig({ projectDir, watchMode: false });
+    const orchestrator = new Orchestrator(brainConfig);
+    try {
+        console.log(chalk.cyan('  Running mutation testing advisor...'));
+        const insights = await orchestrator.runMutationAnalysis(parseInt(opts.maxFiles));
+        if (opts.json) {
+            console.log(JSON.stringify(insights, null, 2));
+            return;
+        }
+        console.log(chalk.magenta.bold(`\n  SHADOW BRAIN Mutation Advisor (${insights.length} suggestions)\n`));
+        if (insights.length === 0) {
+            console.log(chalk.green('  No mutation suggestions — code looks well-tested or analysis found nothing!'));
+            return;
+        }
+        for (const insight of insights) {
+            const color = insight.priority === 'high' ? 'yellow' : 'blue';
+            console.log(chalk `  {${color}.bold [${insight.priority.toUpperCase()}]} ${insight.title}`);
+            console.log(chalk.dim(`    Files: ${insight.files?.join(', ') || 'none'}`));
+            console.log(`    ${insight.content.slice(0, 200)}${insight.content.length > 200 ? '...' : ''}`);
+            console.log();
+        }
+    }
+    catch (err) {
+        console.error(chalk.red('  Error:'), err.message);
+        process.exit(1);
+    }
+});
+// ─── CODE-AGE ─────────────────────────────────────────────────────────────────
+const codeAgeCmd = new Command('code-age')
+    .description('Analyze code freshness — stale files, ownership, change frequency')
+    .argument('[project-dir]', 'Project directory', process.cwd())
+    .option('--json', 'Output as JSON')
+    .action(async (projectDir, opts) => {
+    const brainConfig = mergeConfig({ projectDir, watchMode: false });
+    const orchestrator = new Orchestrator(brainConfig);
+    try {
+        console.log(chalk.cyan('  Analyzing code age and freshness...'));
+        const insights = await orchestrator.runCodeAgeAnalysis();
+        if (opts.json) {
+            console.log(JSON.stringify(insights, null, 2));
+            return;
+        }
+        console.log(chalk.magenta.bold(`\n  SHADOW BRAIN Code Age Analysis (${insights.length} findings)\n`));
+        if (insights.length === 0) {
+            console.log(chalk.green('  Code looks fresh and well-maintained!'));
+            return;
+        }
+        for (const insight of insights) {
+            const color = insight.priority === 'high' ? 'yellow' : 'blue';
+            console.log(chalk `  {${color}.bold [${insight.priority.toUpperCase()}]} ${insight.title}`);
+            console.log(chalk.dim(`    Files: ${insight.files?.join(', ') || 'none'}`));
+            console.log(`    ${insight.content.slice(0, 200)}${insight.content.length > 200 ? '...' : ''}`);
+            console.log();
+        }
+    }
+    catch (err) {
+        console.error(chalk.red('  Error:'), err.message);
+        process.exit(1);
+    }
+});
+// ─── API (API Contract Analysis) ──────────────────────────────────────────────
+const apiCmd = new Command('api')
+    .description('Analyze API contracts — endpoint discovery, security, consistency')
+    .argument('[project-dir]', 'Project directory', process.cwd())
+    .option('--json', 'Output as JSON')
+    .option('--max-files <n>', 'Max files to analyze', '200')
+    .action(async (projectDir, opts) => {
+    const brainConfig = mergeConfig({ projectDir, watchMode: false });
+    const orchestrator = new Orchestrator(brainConfig);
+    try {
+        console.log(chalk.cyan('  Running API contract analysis...'));
+        const insights = await orchestrator.runAPIContractAnalysis(parseInt(opts.maxFiles));
+        if (opts.json) {
+            console.log(JSON.stringify(insights, null, 2));
+            return;
+        }
+        console.log(chalk.magenta.bold(`\n  SHADOW BRAIN API Contract Analysis (${insights.length} findings)\n`));
+        if (insights.length === 0) {
+            console.log(chalk.green('  No API contract issues detected!'));
+            return;
+        }
+        for (const insight of insights) {
+            const color = insight.priority === 'critical' ? 'red' : insight.priority === 'high' ? 'yellow' : 'blue';
+            console.log(chalk `  {${color}.bold [${insight.priority.toUpperCase()}]} ${insight.title}`);
+            console.log(chalk.dim(`    Files: ${insight.files?.join(', ') || 'none'}`));
+            console.log(`    ${insight.content.slice(0, 200)}${insight.content.length > 200 ? '...' : ''}`);
+            console.log();
+        }
+    }
+    catch (err) {
+        console.error(chalk.red('  Error:'), err.message);
+        process.exit(1);
+    }
+});
+// ─── ENV (Environment Variable Analysis) ──────────────────────────────────────
+const envCmd = new Command('env')
+    .description('Analyze environment variables — secrets, validation, naming conventions')
+    .argument('[project-dir]', 'Project directory', process.cwd())
+    .option('--json', 'Output as JSON')
+    .option('--max-files <n>', 'Max files to analyze', '200')
+    .action(async (projectDir, opts) => {
+    const brainConfig = mergeConfig({ projectDir, watchMode: false });
+    const orchestrator = new Orchestrator(brainConfig);
+    try {
+        console.log(chalk.cyan('  Analyzing environment variables...'));
+        const insights = await orchestrator.runEnvAnalysis(parseInt(opts.maxFiles));
+        if (opts.json) {
+            console.log(JSON.stringify(insights, null, 2));
+            return;
+        }
+        console.log(chalk.magenta.bold(`\n  SHADOW BRAIN Environment Analysis (${insights.length} findings)\n`));
+        if (insights.length === 0) {
+            console.log(chalk.green('  No environment variable issues detected!'));
+            return;
+        }
+        for (const insight of insights) {
+            const color = insight.priority === 'critical' ? 'red' : insight.priority === 'high' ? 'yellow' : 'blue';
+            console.log(chalk `  {${color}.bold [${insight.priority.toUpperCase()}]} ${insight.title}`);
+            console.log(chalk.dim(`    Files: ${insight.files?.join(', ') || 'none'}`));
+            console.log(`    ${insight.content.slice(0, 200)}${insight.content.length > 200 ? '...' : ''}`);
+            console.log();
+        }
+    }
+    catch (err) {
+        console.error(chalk.red('  Error:'), err.message);
+        process.exit(1);
+    }
+});
+// ─── LICENSE (License Compliance) ─────────────────────────────────────────────
+const licenseCmd = new Command('license')
+    .description('Audit dependency licenses — restricted, copyleft, unknown licenses')
+    .argument('[project-dir]', 'Project directory', process.cwd())
+    .option('--json', 'Output as JSON')
+    .action(async (projectDir, opts) => {
+    const brainConfig = mergeConfig({ projectDir, watchMode: false });
+    const orchestrator = new Orchestrator(brainConfig);
+    try {
+        console.log(chalk.cyan('  Running license compliance audit...'));
+        const insights = await orchestrator.runLicenseCompliance();
+        if (opts.json) {
+            console.log(JSON.stringify(insights, null, 2));
+            return;
+        }
+        console.log(chalk.magenta.bold(`\n  SHADOW BRAIN License Compliance (${insights.length} findings)\n`));
+        if (insights.length === 0) {
+            console.log(chalk.green('  All dependency licenses are compliant!'));
+            return;
+        }
+        for (const insight of insights) {
+            const color = insight.priority === 'critical' ? 'red' : insight.priority === 'high' ? 'yellow' : 'blue';
+            console.log(chalk `  {${color}.bold [${insight.priority.toUpperCase()}]} ${insight.title}`);
+            console.log(chalk.dim(`    Files: ${insight.files?.join(', ') || 'none'}`));
+            console.log(`    ${insight.content.slice(0, 200)}${insight.content.length > 200 ? '...' : ''}`);
+            console.log();
+        }
+    }
+    catch (err) {
+        console.error(chalk.red('  Error:'), err.message);
+        process.exit(1);
+    }
+});
+// ─── CONFIG-DRIFT ─────────────────────────────────────────────────────────────
+const configDriftCmd = new Command('config-drift')
+    .description('Detect configuration drift — missing configs, inconsistent settings')
+    .argument('[project-dir]', 'Project directory', process.cwd())
+    .option('--json', 'Output as JSON')
+    .action(async (projectDir, opts) => {
+    const brainConfig = mergeConfig({ projectDir, watchMode: false });
+    const orchestrator = new Orchestrator(brainConfig);
+    try {
+        console.log(chalk.cyan('  Detecting configuration drift...'));
+        const insights = await orchestrator.runConfigDriftDetection();
+        if (opts.json) {
+            console.log(JSON.stringify(insights, null, 2));
+            return;
+        }
+        console.log(chalk.magenta.bold(`\n  SHADOW BRAIN Config Drift Detection (${insights.length} findings)\n`));
+        if (insights.length === 0) {
+            console.log(chalk.green('  No configuration drift detected!'));
+            return;
+        }
+        for (const insight of insights) {
+            const color = insight.priority === 'high' ? 'yellow' : 'blue';
+            console.log(chalk `  {${color}.bold [${insight.priority.toUpperCase()}]} ${insight.title}`);
+            console.log(chalk.dim(`    Files: ${insight.files?.join(', ') || 'none'}`));
+            console.log(`    ${insight.content.slice(0, 200)}${insight.content.length > 200 ? '...' : ''}`);
+            console.log();
+        }
+    }
+    catch (err) {
+        console.error(chalk.red('  Error:'), err.message);
+        process.exit(1);
+    }
+});
+// ─── HYPER (Full Hyper-Analysis) ──────────────────────────────────────────────
+const hyperCmd = new Command('hyper')
+    .description('Run ALL v3.0.0 hyper-intelligence analyses at once')
+    .argument('[project-dir]', 'Project directory', process.cwd())
+    .option('--json', 'Output as JSON')
+    .option('--max-files <n>', 'Max files per analysis', '200')
+    .action(async (projectDir, opts) => {
+    const brainConfig = mergeConfig({ projectDir, watchMode: false });
+    const orchestrator = new Orchestrator(brainConfig);
+    try {
+        console.log(chalk.magenta.bold(`\n  SHADOW BRAIN v${VERSION} — Hyper-Intelligence Full Scan\n`));
+        console.log(chalk.cyan('  Running all 10 hyper-intelligence modules in parallel...'));
+        console.log(chalk.dim('  This may take a moment for large projects.\n'));
+        const results = await orchestrator.runFullHyperAnalysis({
+            maxFiles: parseInt(opts.maxFiles),
+        });
+        if (opts.json) {
+            console.log(JSON.stringify(results, null, 2));
+            return;
+        }
+        const modules = [
+            { name: 'ast', label: 'AST Complexity', insights: results.ast },
+            { name: 'a11y', label: 'Accessibility (WCAG)', insights: results.a11y },
+            { name: 'i18n', label: 'Internationalization', insights: results.i18n },
+            { name: 'deadCode', label: 'Dead Code', insights: results.deadCode },
+            { name: 'mutation', label: 'Mutation Testing', insights: results.mutation },
+            { name: 'codeAge', label: 'Code Age', insights: results.codeAge },
+            { name: 'apiContract', label: 'API Contracts', insights: results.apiContract },
+            { name: 'env', label: 'Environment Variables', insights: results.env },
+            { name: 'license', label: 'License Compliance', insights: results.license },
+            { name: 'configDrift', label: 'Config Drift', insights: results.configDrift },
+        ];
+        for (const mod of modules) {
+            const count = mod.insights.length;
+            const color = count === 0 ? 'green' : count < 5 ? 'yellow' : 'red';
+            const icon = count === 0 ? '✓' : '⚠';
+            console.log(chalk `  {${color}.bold ${icon}} ${chalk.bold(mod.label)}: ${count} finding(s)`);
+        }
+        console.log(chalk.bold(`\n  Total findings: ${results.total}\n`));
+        // Show critical/high priority details
+        const allCritical = modules.flatMap(m => m.insights.filter(i => i.priority === 'critical' || i.priority === 'high'));
+        if (allCritical.length > 0) {
+            console.log(chalk.red.bold(`  Critical/High Priority (${allCritical.length}):\n`));
+            for (const insight of allCritical.slice(0, 20)) {
+                const color = insight.priority === 'critical' ? 'red' : 'yellow';
+                console.log(chalk `  {${color}.bold [${insight.priority.toUpperCase()}]} ${insight.title}`);
+                console.log(chalk.dim(`    Files: ${insight.files?.join(', ') || 'none'}`));
+                console.log();
+            }
+        }
+    }
+    catch (err) {
+        console.error(chalk.red('  Error:'), err.message);
+        process.exit(1);
+    }
+});
 // ─── MAIN ─────────────────────────────────────────────────────────────────────
 const program = new Command();
 program
     .name('shadow-brain')
-    .description('Shadow Brain v2.1.0 — Super-Intelligence Layer for AI Coding Agents with Quantum Neural Mesh')
+    .description('Shadow Brain v3.0.0 — Hyper-Intelligence Layer for AI Coding Agents with Quantum Neural Mesh')
     .version(VERSION);
 program.addCommand(startCmd);
 program.addCommand(reviewCmd);
@@ -1497,5 +1890,17 @@ program.addCommand(contextCmd);
 program.addCommand(learnCmd);
 // v2.1.0 commands
 program.addCommand(meshCmd);
+// v3.0.0 hyper-intelligence commands
+program.addCommand(astCmd);
+program.addCommand(a11yCmd);
+program.addCommand(i18nCmd);
+program.addCommand(deadCodeCmd);
+program.addCommand(mutationCmd);
+program.addCommand(codeAgeCmd);
+program.addCommand(apiCmd);
+program.addCommand(envCmd);
+program.addCommand(licenseCmd);
+program.addCommand(configDriftCmd);
+program.addCommand(hyperCmd);
 program.parse();
 //# sourceMappingURL=cli.js.map