cursor-quality-suite 1.0.0

package/README.md

@@ -0,0 +1,155 @@
+# 🧪 Cursor Quality Suite
+
+> Code Quality & Testing Commands for Cursor IDE - Test Generation, Mutation Testing, Architecture
+
+[![npm version](https://badge.fury.io/js/cursor-quality-suite.svg)](https://www.npmjs.com/package/cursor-quality-suite)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 🚀 Quick Install
+
+```bash
+npx cursor-quality-suite
+```
+
+One command installs 7 code quality commands for Cursor.
+
+## What is Quality Suite?
+
+Quality Suite provides advanced testing and code quality tools:
+
+- **Risk-Based Testing** - Generate tests for high-risk code paths
+- **Mutation Testing** - Verify test quality catches real bugs
+- **Architecture Visualization** - Generate Mermaid diagrams
+- **Pattern Detection** - Find architectural drift
+
+## 📦 Command Bundles
+
+| Bundle | Commands | Use Case |
+|--------|----------|----------|
+| **Minimal** | 3 | Testing only |
+| **Standard** | 7 | + Code quality |
+
+## 🔧 Commands Reference
+
+### 🧪 Testing
+
+| Command | Description |
+|---------|-------------|
+| `/risk-test-gen` | Generate tests for high-risk paths (payments, auth) |
+| `/mutation-audit` | Verify test quality via mutation testing |
+| `/write-unit-tests` | Generate comprehensive unit tests |
+
+### 📊 Code Quality
+
+| Command | Description |
+|---------|-------------|
+| `/visualize-architecture` | Generate Mermaid diagrams for any scope |
+| `/code-standards` | Reference guide for quality enforcement |
+| `/pattern-drift` | Detect when code diverges from patterns |
+| `/churn-map` | Find high-churn files needing attention |
+
+## 💡 Example Usage
+
+### Generate High-Risk Tests
+
+```
+/risk-test-gen src/features/checkout
+
+════════════════════════════════════════════════════════════════
+  RISK ANALYSIS
+════════════════════════════════════════════════════════════════
+
+| Line | Risk | Type | Coverage |
+|------|------|------|----------|
+| 45 | 🔴 CRITICAL | Booking modification | ❌ Untested |
+| 78 | 🟠 HIGH | API call | ✅ Partial |
+
+════════════════════════════════════════════════════════════════
+  GENERATED TESTS
+════════════════════════════════════════════════════════════════
+
+## 1. Integration Test: Booking Modification (CRITICAL)
+
+✅ Generated: 3 test suites, 8 test cases
+✅ Coverage improvement: +35% on high-risk paths
+```
+
+### Mutation Testing Audit
+
+```
+/mutation-audit src/components/Checkout.tsx
+
+════════════════════════════════════════════════════════════════
+  MUTATION TESTING RESULTS
+════════════════════════════════════════════════════════════════
+
+| Metric | Value |
+|--------|-------|
+| Total Mutants | 45 |
+| Killed | 32 |
+| Survived | 13 |
+| **Mutation Score** | **71%** 🟠 |
+
+## Survived Mutants (Tests Failed to Catch)
+
+| Line | Original | Mutation |
+|------|----------|----------|
+| 78 | `price > 0` | `price >= 0` |
+```
+
+### Architecture Diagram
+
+```
+/visualize-architecture src/components/Packages
+
+Output:
+```mermaid
+graph TD
+    subgraph Packages
+        A[PackagesV2] --> B[ProtectionPackageCard]
+        A --> C[ExtrasPackageCard]
+        B --> D[LineItems]
+        B --> E[PackageHeader]
+    end
+```
+
+## 🛠️ CLI Commands
+
+```bash
+npx cursor-quality-suite              # Interactive install
+npx cursor-quality-suite --bundle standard -y  # Non-interactive
+npx cursor-quality-suite status       # Check installation
+npx cursor-quality-suite list         # List all commands
+npx cursor-quality-suite help         # Show help
+```
+
+## 📂 Installation Structure
+
+After installation:
+
+```
+.cursor/
+└── commands/
+    ├── risk-test-gen.md
+    ├── mutation-audit.md
+    ├── write-unit-tests.md
+    ├── visualize-architecture.md
+    ├── code-standards.md
+    ├── pattern-drift.md
+    └── churn-map.md
+```
+
+## 🤝 Works With
+
+- [Buddy OS](https://github.com/sharath317/buddy-os) - Role-aware autonomous agent
+- [Cursor Full-Flow](https://github.com/sharath317/cursor-full-flow) - Jira to PR automation
+- [Cursor AI Toolkit](https://github.com/sharath317/cursor-ai-toolkit) - Learning & context
+
+## 📄 License
+
+MIT © Sharath Chandra
+
+---
+
+**Ship higher quality code with AI-powered testing.**
+

package/bin/cli.js

@@ -0,0 +1,303 @@
+#!/usr/bin/env node
+
+/**
+ * cursor-quality-suite CLI
+ * Code Quality & Testing Commands for Cursor IDE
+ * Test Generation, Mutation Testing, Architecture Visualization
+ */
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+const VERSION = '1.0.0';
+const CURSOR_DIR = '.cursor';
+const COMMANDS_DIR = 'commands';
+
+const colors = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    cyan: '\x1b[36m',
+};
+
+const log = {
+    info: (msg) => console.log(`${colors.cyan}ℹ${colors.reset} ${msg}`),
+    success: (msg) => console.log(`${colors.green}✓${colors.reset} ${msg}`),
+    warn: (msg) => console.log(`${colors.yellow}⚠${colors.reset} ${msg}`),
+    error: (msg) => console.log(`${colors.red}✗${colors.reset} ${msg}`),
+    step: (msg) => console.log(`  ${colors.dim}→${colors.reset} ${msg}`),
+    header: (msg) => console.log(`\n${colors.bold}${colors.cyan}${msg}${colors.reset}\n`),
+};
+
+const BUNDLES = {
+    minimal: {
+        name: 'Minimal (Testing Only)',
+        description: 'Test generation and mutation testing',
+        commands: ['testing'],
+        count: 3,
+    },
+    standard: {
+        name: 'Standard (Testing + Quality)',
+        description: 'Full testing and code quality suite',
+        commands: ['testing', 'code-quality'],
+        count: 7,
+    },
+};
+
+function prompt(question, defaultValue = '') {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+
+    const defaultText = defaultValue ? ` (${defaultValue})` : '';
+
+    return new Promise((resolve) => {
+        rl.question(`${question}${defaultText}: `, (answer) => {
+            rl.close();
+            resolve(answer || defaultValue);
+        });
+    });
+}
+
+function ensureDir(dir) {
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+
+function copyCommands(sourceDir, targetDir, categories) {
+    let copiedCount = 0;
+
+    categories.forEach((category) => {
+        const srcCategoryDir = path.join(sourceDir, category);
+
+        if (fs.existsSync(srcCategoryDir)) {
+            const files = fs.readdirSync(srcCategoryDir).filter((f) => f.endsWith('.md'));
+
+            files.forEach((file) => {
+                const srcFile = path.join(srcCategoryDir, file);
+                const tgtFile = path.join(targetDir, file);
+
+                if (!fs.existsSync(tgtFile)) {
+                    fs.copyFileSync(srcFile, tgtFile);
+                    log.step(`Installed: ${file}`);
+                    copiedCount++;
+                } else {
+                    log.step(`Exists: ${file} (skipped)`);
+                }
+            });
+        }
+    });
+
+    return copiedCount;
+}
+
+async function init(flags = {}) {
+    console.log(`
+${colors.bold}${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🧪 CURSOR QUALITY SUITE v${VERSION}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+Code Quality: Testing, Architecture & Analysis
+
+`);
+
+    const projectDir = process.cwd();
+    const cursorDir = path.join(projectDir, CURSOR_DIR);
+    const commandsDir = path.join(cursorDir, COMMANDS_DIR);
+
+    log.header('📦 Select Command Bundle');
+
+    Object.entries(BUNDLES).forEach(([key, bundle], idx) => {
+        console.log(`  ${idx + 1}. ${colors.bold}${bundle.name}${colors.reset}`);
+        console.log(`     ${bundle.description} (${bundle.count} commands)\n`);
+    });
+
+    let selectedBundle = 'standard';
+    if (!flags.bundle && !flags.yes) {
+        const bundleAnswer = await prompt('Select bundle (1-2)', '2');
+        selectedBundle = Object.keys(BUNDLES)[parseInt(bundleAnswer, 10) - 1] || 'standard';
+    } else if (flags.bundle) {
+        selectedBundle = flags.bundle;
+    }
+
+    const bundle = BUNDLES[selectedBundle];
+    log.success(`Selected: ${bundle.name}`);
+
+    log.header('📥 Installing Commands');
+
+    ensureDir(commandsDir);
+
+    const packageDir = path.dirname(__dirname);
+    const packageCommandsDir = path.join(packageDir, 'commands');
+
+    const copiedCount = copyCommands(packageCommandsDir, commandsDir, bundle.commands);
+
+    console.log(`
+${colors.bold}${colors.green}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✓ INSTALLATION COMPLETE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+
+${colors.cyan}Commands installed:${colors.reset} ${copiedCount}
+${colors.cyan}Location:${colors.reset}          ${commandsDir}
+
+${colors.bold}Commands Reference:${colors.reset}
+
+  ${colors.cyan}🧪 Testing${colors.reset}
+  /risk-test-gen       Generate tests for high-risk paths
+  /mutation-audit      Verify test quality via mutations
+  /write-unit-tests    Generate unit tests for components
+
+  ${colors.cyan}📊 Code Quality${colors.reset}
+  /visualize-architecture   Generate Mermaid diagrams
+  /code-standards           Reference guide for quality
+  /churn-map                Find high-churn files
+  /pattern-drift            Detect pattern violations
+
+${colors.dim}Documentation: https://github.com/sharath317/cursor-quality-suite${colors.reset}
+`);
+}
+
+async function status() {
+    const projectDir = process.cwd();
+    const commandsDir = path.join(projectDir, CURSOR_DIR, COMMANDS_DIR);
+
+    if (!fs.existsSync(commandsDir)) {
+        log.warn('Quality Suite not installed. Run: npx cursor-quality-suite');
+        process.exit(0);
+    }
+
+    const commands = fs.readdirSync(commandsDir).filter((f) => f.endsWith('.md'));
+
+    console.log(`
+${colors.bold}${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 QUALITY SUITE STATUS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+
+${colors.cyan}Version:${colors.reset}  ${VERSION}
+${colors.cyan}Commands:${colors.reset} ${commands.length} installed
+${colors.cyan}Location:${colors.reset} ${commandsDir}
+
+${colors.bold}Installed Commands:${colors.reset}`);
+
+    commands.forEach((cmd) => {
+        console.log(`  - /${cmd.replace('.md', '')}`);
+    });
+
+    console.log('');
+}
+
+async function listCommands() {
+    const packageDir = path.dirname(__dirname);
+    const packageCommandsDir = path.join(packageDir, 'commands');
+
+    console.log(`
+${colors.bold}${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📋 AVAILABLE COMMANDS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+`);
+
+    const categories = ['testing', 'code-quality'];
+    const icons = { testing: '🧪', 'code-quality': '📊' };
+
+    categories.forEach((cat) => {
+        const catDir = path.join(packageCommandsDir, cat);
+        if (fs.existsSync(catDir)) {
+            console.log(`\n${icons[cat]} ${colors.bold}${cat.toUpperCase()}${colors.reset}`);
+
+            const files = fs.readdirSync(catDir).filter((f) => f.endsWith('.md'));
+            files.forEach((file) => {
+                const name = file.replace('.md', '');
+                console.log(`  /${name}`);
+            });
+        }
+    });
+
+    console.log('');
+}
+
+function showHelp() {
+    console.log(`
+${colors.bold}cursor-quality-suite v${VERSION}${colors.reset}
+
+Code Quality & Testing Commands for Cursor IDE
+
+${colors.bold}Usage:${colors.reset}
+  npx cursor-quality-suite [command] [options]
+
+${colors.bold}Commands:${colors.reset}
+  init          Install commands (default)
+  status        Show current configuration
+  list          List all available commands
+  help          Show this help
+
+${colors.bold}Options:${colors.reset}
+  --bundle      Select bundle (minimal, standard)
+  -y, --yes     Non-interactive mode
+
+${colors.bold}Examples:${colors.reset}
+  npx cursor-quality-suite                   Interactive install
+  npx cursor-quality-suite --bundle standard Install all commands
+  npx cursor-quality-suite status            Check installation
+
+${colors.bold}After Installation:${colors.reset}
+  /risk-test-gen           Generate high-risk tests
+  /mutation-audit          Verify test quality
+  /visualize-architecture  Generate architecture diagrams
+  /code-standards          View quality guidelines
+
+${colors.dim}https://github.com/sharath317/cursor-quality-suite${colors.reset}
+`);
+}
+
+const args = process.argv.slice(2);
+const flags = {};
+let command = null;
+const skipNextArg = new Set();
+
+args.forEach((arg, idx) => {
+    if (arg === '--bundle' && args[idx + 1]) {
+        skipNextArg.add(idx + 1);
+    }
+});
+
+args.forEach((arg, idx) => {
+    if (skipNextArg.has(idx)) {
+        return;
+    } else if (arg === '-y' || arg === '--yes') {
+        flags.yes = true;
+    } else if (arg === '--bundle' && args[idx + 1]) {
+        flags.bundle = args[idx + 1];
+    } else if (!arg.startsWith('-') && command === null) {
+        command = arg;
+    }
+});
+
+switch (command) {
+    case 'init':
+    case null:
+        init(flags);
+        break;
+    case 'status':
+        status();
+        break;
+    case 'list':
+        listCommands();
+        break;
+    case 'help':
+    case '-h':
+    case '--help':
+        showHelp();
+        break;
+    default:
+        log.error(`Unknown command: ${command}`);
+        console.log('Run "npx cursor-quality-suite help" for usage');
+        process.exit(1);
+}
+