qa360 2.1.6 → 2.2.0

package/packages/mcp/src/cli/init.ts

@@ -0,0 +1,233 @@
+/**
+ * qa360-mcp init - Auto-configure VS Code settings.json for 
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { parse, modify, applyEdits } from 'jsonc-parser';
+import inquirer from 'inquirer';
+
+interface InitOptions {
+  vscode?: boolean;
+  force?: boolean;
+  nonInteractive?: boolean;
+}
+
+export async function initCommand(target: string, options: InitOptions): Promise<void> {
+  console.log(chalk.blue.bold('\n🧠 Initializing QA360 MCP for VS Code...\n'));
+
+  const spinner = ora('Detecting VS Code installation').start();
+
+  try {
+    // 1. Detect VS Code settings.json path
+    const settingsPath = await detectVSCodeSettings();
+    
+    if (!settingsPath) {
+      spinner.fail('VS Code settings.json not found');
+      console.log(chalk.yellow('\n⚠️  VS Code not detected. Running in local mode.'));
+      console.log(chalk.gray('You can still use: qa360-mcp up --port 3000\n'));
+      return;
+    }
+
+    spinner.succeed(`Found VS Code settings: ${chalk.gray(settingsPath)}`);
+
+    // 2. Check if  extension is installed
+    spinner.start('Checking  extension');
+    const claudeInstalled = await isInstalled();
+    
+    if (!claudeInstalled) {
+      spinner.warn(' extension not detected');
+      console.log(chalk.yellow('\n⚠️  Install  extension first:'));
+      console.log(chalk.white('   https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code\n'));
+      
+      const { proceed } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'proceed',
+        message: 'Continue anyway?',
+        default: false
+      }]);
+      
+      if (!proceed) {
+        return;
+      }
+    } else {
+      spinner.succeed(' extension detected');
+    }
+
+    // 3. Backup existing settings (local + centralized)
+    spinner.start('Creating backup');
+    const timestamp = Date.now();
+    const backupPath = `${settingsPath}.qa360.backup.${timestamp}.json`;
+    await fs.copy(settingsPath, backupPath);
+    
+    // Also copy to centralized backup directory
+    const centralBackupDir = path.join(os.homedir(), '.qa360', 'backups');
+    await fs.ensureDir(centralBackupDir);
+    const centralBackupPath = path.join(centralBackupDir, `settings.${timestamp}.json`);
+    await fs.copy(settingsPath, centralBackupPath);
+    
+    spinner.succeed(`Backup created: ${chalk.gray(backupPath)}`);
+
+    // 4. Read and parse settings.json (with comments support)
+    spinner.start('Updating settings.json');
+    const settingsContent = await fs.readFile(settingsPath, 'utf-8');
+    const settings = parse(settingsContent);
+
+    // 5. Determine MCP config key (try both variants)
+    const mcpKey = settings['claude.mcpServers'] !== undefined 
+      ? 'claude.mcpServers'
+      : 'claude.experimental.mcpServers';
+
+    // 6. Check if QA360 already configured
+    const existingQA360 = settings[mcpKey]?.qa360;
+    
+    if (existingQA360 && !options.force) {
+      spinner.info('QA360 MCP already configured');
+      
+      if (options.nonInteractive) {
+        console.log(chalk.yellow('\n⚠️  Configuration already exists (use --force to overwrite)\n'));
+        return;
+      }
+      
+      const { overwrite } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'overwrite',
+        message: 'Overwrite existing configuration?',
+        default: false
+      }]);
+      
+      if (!overwrite) {
+        console.log(chalk.green('\n✅ Configuration unchanged\n'));
+        return;
+      }
+    }
+
+    // 7. Get qa360-mcp binary path
+    const binPath = await getQA360MCPBinPath();
+
+    // 8. Create MCP server config
+    const qa360Config = {
+      command: 'qa360-mcp-server',
+      args: [],
+      env: {
+        QA360_HOME: path.join(os.homedir(), '.qa360')
+      }
+    };
+
+    // 9. Apply modifications using jsonc-parser
+    const edits = modify(
+      settingsContent,
+      [mcpKey, 'qa360'],
+      qa360Config,
+      { formattingOptions: { tabSize: 2, insertSpaces: true } }
+    );
+
+    const updatedContent = applyEdits(settingsContent, edits);
+    await fs.writeFile(settingsPath, updatedContent, 'utf-8');
+
+    spinner.succeed('Configuration updated in settings.json');
+
+    // 10. Success message
+    console.log(chalk.green.bold('\n✅ QA360 MCP initialized successfully!\n'));
+    console.log(chalk.white('Next steps:'));
+    console.log(chalk.white('  1. Restart VS Code'));
+    console.log(chalk.white('  2. Open '));
+    console.log(chalk.white('  3. Try: ') + chalk.cyan('/qa360.health\n'));
+
+    console.log(chalk.gray('Configuration added:'));
+    console.log(chalk.gray(JSON.stringify({ [mcpKey]: { qa360: qa360Config } }, null, 2)));
+    console.log();
+
+  } catch (error) {
+    spinner.fail('Initialization failed');
+    console.error(chalk.red('\n❌ Error:'), error instanceof Error ? error.message : error);
+    console.log(chalk.yellow('\n💡 Try: qa360-mcp fix\n'));
+    process.exit(1);
+  }
+}
+
+/**
+ * Detect VS Code settings.json path
+ */
+async function detectVSCodeSettings(): Promise<string | null> {
+  const platform = os.platform();
+  const home = os.homedir();
+
+  const possiblePaths = [
+    // macOS
+    path.join(home, 'Library', 'Application Support', 'Code', 'User', 'settings.json'),
+    // Linux
+    path.join(home, '.config', 'Code', 'User', 'settings.json'),
+    // Windows
+    path.join(home, 'AppData', 'Roaming', 'Code', 'User', 'settings.json'),
+    // VS Code Insiders
+    path.join(home, 'Library', 'Application Support', 'Code - Insiders', 'User', 'settings.json'),
+    path.join(home, '.config', 'Code - Insiders', 'User', 'settings.json'),
+    path.join(home, 'AppData', 'Roaming', 'Code - Insiders', 'User', 'settings.json')
+  ];
+
+  for (const p of possiblePaths) {
+    if (await fs.pathExists(p)) {
+      return p;
+    }
+  }
+
+  // Create default if not exists
+  const defaultPath = platform === 'darwin'
+    ? path.join(home, 'Library', 'Application Support', 'Code', 'User', 'settings.json')
+    : platform === 'win32'
+    ? path.join(home, 'AppData', 'Roaming', 'Code', 'User', 'settings.json')
+    : path.join(home, '.config', 'Code', 'User', 'settings.json');
+
+  await fs.ensureFile(defaultPath);
+  await fs.writeFile(defaultPath, '{}', 'utf-8');
+  
+  return defaultPath;
+}
+
+/**
+ * Check if  extension is installed
+ */
+async function isInstalled(): Promise<boolean> {
+  const platform = os.platform();
+  const home = os.homedir();
+
+  const extensionsPaths = [
+    // macOS
+    path.join(home, '.vscode', 'extensions'),
+    // Linux
+    path.join(home, '.vscode', 'extensions'),
+    // Windows
+    path.join(home, '.vscode', 'extensions')
+  ];
+
+  for (const extPath of extensionsPaths) {
+    if (await fs.pathExists(extPath)) {
+      const extensions = await fs.readdir(extPath);
+      const claudeExt = extensions.find(ext => ext.includes('anthropic.claude'));
+      if (claudeExt) {
+        return true;
+      }
+    }
+  }
+
+  return false;
+}
+
+/**
+ * Get qa360-mcp binary path
+ */
+async function getQA360MCPBinPath(): Promise<string> {
+  // Try global npm bin
+  try {
+    const { execa } = await import('execa');
+    const { stdout } = await execa('which', ['qa360-mcp']);
+    return stdout.trim();
+  } catch {
+    // Fallback to npx
+    return 'npx';
+  }
+}

package/packages/mcp/src/cli/postinstall.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script - Display welcome message
+ */
+
+import chalk from 'chalk';
+
+console.log(chalk.blue.bold('\n🎉 QA360 MCP installed successfully!\n'));
+console.log(chalk.white('Quick start:'));
+console.log(chalk.cyan('  1. qa360-mcp init     ') + chalk.gray('# Configure VS Code'));
+console.log(chalk.cyan('  2. qa360-mcp up       ') + chalk.gray('# Start MCP server'));
+console.log(chalk.cyan('  3. Open    ') + chalk.gray('# Try: /qa360.health\n'));
+console.log(chalk.gray('Documentation: https://github.com/qa360/mcp\n'));

package/packages/mcp/src/cli/reset.ts

@@ -0,0 +1,44 @@
+/**
+ * qa360-mcp reset - Clean all configurations
+ */
+
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+
+interface ResetOptions {
+  yes?: boolean;
+}
+
+export async function resetCommand(options: ResetOptions): Promise<void> {
+  console.log(chalk.yellow.bold('\n⚠️  QA360 MCP Reset\n'));
+  console.log(chalk.white('This will remove all QA360 MCP configurations.\n'));
+
+  if (!options.yes) {
+    const { confirm } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'confirm',
+      message: 'Are you sure you want to reset?',
+      default: false
+    }]);
+
+    if (!confirm) {
+      console.log(chalk.gray('\nReset cancelled.\n'));
+      return;
+    }
+  }
+
+  console.log(chalk.blue('\n🧹 Cleaning configurations...\n'));
+
+  // Remove QA360 home
+  const qa360Home = process.env.QA360_HOME || path.join(os.homedir(), '.qa360');
+  if (await fs.pathExists(qa360Home)) {
+    await fs.remove(qa360Home);
+    console.log(chalk.green('✓'), `Removed: ${qa360Home}`);
+  }
+
+  console.log(chalk.green.bold('\n✅ Reset completed!\n'));
+  console.log(chalk.white('Start fresh: qa360-mcp init\n'));
+}

package/packages/mcp/src/cli/telemetry.ts

@@ -0,0 +1,166 @@
+/**
+ * qa360-mcp telemetry - Opt-in anonymous usage analytics
+ */
+
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+
+interface TelemetryConfig {
+  enabled: boolean;
+  userId: string;
+  lastUpdated: string;
+}
+
+interface TelemetryOptions {
+  status?: boolean;
+}
+
+const TELEMETRY_FILE = path.join(os.homedir(), '.qa360', 'telemetry.json');
+
+export async function telemetryCommand(action: string, options: TelemetryOptions): Promise<void> {
+  console.log(chalk.blue.bold('\n📊 QA360 MCP Telemetry\n'));
+
+  try {
+    // Ensure .qa360 directory exists
+    await fs.ensureDir(path.dirname(TELEMETRY_FILE));
+
+    switch (action) {
+      case 'on':
+        await enableTelemetry();
+        break;
+      case 'off':
+        await disableTelemetry();
+        break;
+      case 'status':
+      default:
+        await showStatus();
+        break;
+    }
+  } catch (error) {
+    console.error(chalk.red('\n❌ Error:'), error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+}
+
+async function enableTelemetry(): Promise<void> {
+  const config: TelemetryConfig = {
+    enabled: true,
+    userId: generateAnonymousId(),
+    lastUpdated: new Date().toISOString()
+  };
+
+  await fs.writeJson(TELEMETRY_FILE, config, { spaces: 2 });
+
+  console.log(chalk.green('✅ Telemetry enabled\n'));
+  console.log(chalk.white('What we collect (anonymously):'));
+  console.log(chalk.gray('  • CLI version'));
+  console.log(chalk.gray('  • Operating system'));
+  console.log(chalk.gray('  • Command execution times'));
+  console.log(chalk.gray('  • Anonymous error reports'));
+  console.log(chalk.white('\nWhat we DO NOT collect:'));
+  console.log(chalk.gray('  • Personal information'));
+  console.log(chalk.gray('  • File paths or content'));
+  console.log(chalk.gray('  • VS Code settings'));
+  console.log(chalk.gray('  • Project names or URLs\n'));
+  console.log(chalk.cyan('Your anonymous ID: ') + chalk.gray(config.userId));
+  console.log(chalk.gray('This helps us improve QA360 MCP for everyone. Thank you! 🙏\n'));
+}
+
+async function disableTelemetry(): Promise<void> {
+  if (await fs.pathExists(TELEMETRY_FILE)) {
+    const config = await fs.readJson(TELEMETRY_FILE);
+    config.enabled = false;
+    config.lastUpdated = new Date().toISOString();
+    await fs.writeJson(TELEMETRY_FILE, config, { spaces: 2 });
+  } else {
+    const config: TelemetryConfig = {
+      enabled: false,
+      userId: '',
+      lastUpdated: new Date().toISOString()
+    };
+    await fs.writeJson(TELEMETRY_FILE, config, { spaces: 2 });
+  }
+
+  console.log(chalk.green('✅ Telemetry disabled\n'));
+  console.log(chalk.gray('No data will be collected.\n'));
+}
+
+async function showStatus(): Promise<void> {
+  if (await fs.pathExists(TELEMETRY_FILE)) {
+    const config: TelemetryConfig = await fs.readJson(TELEMETRY_FILE);
+    
+    console.log(chalk.white('Status: ') + (config.enabled ? chalk.green('Enabled ✓') : chalk.red('Disabled ✗')));
+    
+    if (config.enabled) {
+      console.log(chalk.white('Anonymous ID: ') + chalk.gray(config.userId));
+      console.log(chalk.white('Last updated: ') + chalk.gray(new Date(config.lastUpdated).toLocaleString()));
+    }
+    
+    console.log();
+    console.log(chalk.gray('Commands:'));
+    console.log(chalk.white('  qa360-mcp telemetry on   ') + chalk.gray('# Enable telemetry'));
+    console.log(chalk.white('  qa360-mcp telemetry off  ') + chalk.gray('# Disable telemetry'));
+    console.log();
+  } else {
+    console.log(chalk.yellow('Status: Not configured (default: disabled)\n'));
+    console.log(chalk.white('To enable telemetry:'));
+    console.log(chalk.cyan('  qa360-mcp telemetry on\n'));
+  }
+}
+
+function generateAnonymousId(): string {
+  const timestamp = Date.now().toString(36);
+  const random = Math.random().toString(36).substring(2, 15);
+  return `qa360_${timestamp}_${random}`;
+}
+
+/**
+ * Check if telemetry is enabled
+ */
+export async function isTelemetryEnabled(): Promise<boolean> {
+  try {
+    if (await fs.pathExists(TELEMETRY_FILE)) {
+      const config: TelemetryConfig = await fs.readJson(TELEMETRY_FILE);
+      return config.enabled === true;
+    }
+  } catch {
+    // Ignore errors
+  }
+  return false;
+}
+
+/**
+ * Send telemetry event (if enabled)
+ */
+export async function sendTelemetryEvent(event: string, data: Record<string, any>): Promise<void> {
+  if (!(await isTelemetryEnabled())) {
+    return;
+  }
+
+  try {
+    const config: TelemetryConfig = await fs.readJson(TELEMETRY_FILE);
+    
+    const payload = {
+      event,
+      userId: config.userId,
+      timestamp: new Date().toISOString(),
+      version: '1.0.0',
+      platform: os.platform(),
+      arch: os.arch(),
+      nodeVersion: process.version,
+      data
+    };
+
+    // In a real implementation, this would send to an analytics endpoint
+    // For now, we just log to a local file for debugging
+    const logsDir = path.join(os.homedir(), '.qa360', 'telemetry-logs');
+    await fs.ensureDir(logsDir);
+    
+    const logFile = path.join(logsDir, `telemetry-${new Date().toISOString().split('T')[0]}.jsonl`);
+    await fs.appendFile(logFile, JSON.stringify(payload) + '\n');
+  } catch {
+    // Silently fail - telemetry should never break the CLI
+  }
+}

package/packages/mcp/src/cli/test-dx.ts

@@ -0,0 +1,94 @@
+/**
+ * qa360-mcp test:dx - DX compliance testing
+ */
+
+import chalk from 'chalk';
+import { execa } from 'execa';
+
+interface TestDxOptions {
+  ci?: boolean;
+}
+
+export async function testDxCommand(options: TestDxOptions): Promise<void> {
+  console.log(chalk.blue.bold('\n🧪 QA360 DX Compliance Test\n'));
+  
+  const tests: Array<{ name: string; fn: () => Promise<boolean> }> = [
+    { name: 'CLI executable', fn: testCLIExecutable },
+    { name: 'Help command', fn: testHelpCommand },
+    { name: 'Version command', fn: testVersionCommand },
+    { name: 'Doctor command', fn: testDoctorCommand }
+  ];
+
+  let passed = 0;
+  let failed = 0;
+
+  for (const test of tests) {
+    process.stdout.write(chalk.white(`  ${test.name}... `));
+    try {
+      const result = await test.fn();
+      if (result) {
+        console.log(chalk.green('✓'));
+        passed++;
+      } else {
+        console.log(chalk.red('✗'));
+        failed++;
+      }
+    } catch (error) {
+      console.log(chalk.red('✗'));
+      failed++;
+    }
+  }
+
+  console.log(chalk.white('\n' + '─'.repeat(60)));
+  console.log(chalk.white(`\nResults: ${chalk.green(passed + ' passed')}, ${failed > 0 ? chalk.red(failed + ' failed') : chalk.gray('0 failed')}`));
+
+  const compliance = Math.round((passed / tests.length) * 100);
+  console.log(chalk.white(`\nDX Compliance: ${compliance}%`));
+
+  if (compliance === 100) {
+    console.log(chalk.green.bold('\n✅ QA360 DX Compliance: 100%\n'));
+    process.exit(0);
+  } else {
+    console.log(chalk.red.bold('\n❌ DX Compliance below 100%\n'));
+    if (options.ci) {
+      process.exit(1);
+    }
+  }
+}
+
+async function testCLIExecutable(): Promise<boolean> {
+  try {
+    await execa('qa360-mcp', ['--version']);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function testHelpCommand(): Promise<boolean> {
+  try {
+    const { stdout } = await execa('qa360-mcp', ['--help']);
+    return stdout.includes('init') && stdout.includes('up');
+  } catch {
+    return false;
+  }
+}
+
+async function testVersionCommand(): Promise<boolean> {
+  try {
+    const { stdout } = await execa('qa360-mcp', ['--version']);
+    return /\d+\.\d+\.\d+/.test(stdout);
+  } catch {
+    return false;
+  }
+}
+
+async function testDoctorCommand(): Promise<boolean> {
+  try {
+    await execa('qa360-mcp', ['doctor']);
+    return true;
+  } catch {
+    // Doctor may fail but should execute
+    return true;
+  }
+}

package/packages/mcp/src/cli/uninstall.ts

@@ -0,0 +1,80 @@
+/**
+ * qa360-mcp uninstall - Clean removal
+ */
+
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { parse, modify, applyEdits } from 'jsonc-parser';
+
+interface UninstallOptions {
+  yes?: boolean;
+}
+
+export async function uninstallCommand(options: UninstallOptions): Promise<void> {
+  console.log(chalk.yellow.bold('\n⚠️  QA360 MCP Uninstall\n'));
+
+  if (!options.yes) {
+    const { confirm } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'confirm',
+      message: 'Remove QA360 MCP completely?',
+      default: false
+    }]);
+
+    if (!confirm) {
+      console.log(chalk.gray('\nUninstall cancelled.\n'));
+      return;
+    }
+  }
+
+  console.log(chalk.blue('\n🧹 Removing QA360 MCP...\n'));
+
+  // 1. Remove from VS Code settings
+  const settingsPath = await findVSCodeSettings();
+  if (settingsPath && await fs.pathExists(settingsPath)) {
+    try {
+      const content = await fs.readFile(settingsPath, 'utf-8');
+      const settings = parse(content);
+      
+      const mcpKey = settings['claude.mcpServers'] !== undefined 
+        ? 'claude.mcpServers' 
+        : 'claude.experimental.mcpServers';
+
+      if (settings[mcpKey]?.qa360) {
+        const edits = modify(content, [mcpKey, 'qa360'], undefined, {});
+        const updated = applyEdits(content, edits);
+        await fs.writeFile(settingsPath, updated, 'utf-8');
+        console.log(chalk.green('✓'), 'Removed from VS Code settings');
+      }
+    } catch (error) {
+      console.log(chalk.yellow('⚠️ '), 'Could not update VS Code settings');
+    }
+  }
+
+  // 2. Remove QA360 home
+  const qa360Home = process.env.QA360_HOME || path.join(os.homedir(), '.qa360');
+  if (await fs.pathExists(qa360Home)) {
+    await fs.remove(qa360Home);
+    console.log(chalk.green('✓'), `Removed: ${qa360Home}`);
+  }
+
+  console.log(chalk.green.bold('\n✅ QA360 MCP uninstalled\n'));
+  console.log(chalk.gray('Hope to see you again soon! 👋\n'));
+}
+
+async function findVSCodeSettings(): Promise<string | null> {
+  const home = os.homedir();
+  const paths = [
+    path.join(home, 'Library', 'Application Support', 'Code', 'User', 'settings.json'),
+    path.join(home, '.config', 'Code', 'User', 'settings.json'),
+    path.join(home, 'AppData', 'Roaming', 'Code', 'User', 'settings.json')
+  ];
+
+  for (const p of paths) {
+    if (await fs.pathExists(p)) return p;
+  }
+  return null;
+}