qa360 2.2.1 → 2.2.13

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

@@ -1,233 +0,0 @@
-/**
- * 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

@@ -1,14 +0,0 @@
-#!/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

@@ -1,44 +0,0 @@
-/**
- * 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

@@ -1,166 +0,0 @@
-/**
- * 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

@@ -1,94 +0,0 @@
-/**
- * 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

@@ -1,80 +0,0 @@
-/**
- * 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;
-}