claude-flow-novice 2.10.5 → 2.10.6

package/claude-assets/commands/validate-commands.js

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+
+/**
+ * Validate All Slash Commands
+ * 
+ * Tests that all slash commands are properly implemented and working
+ */
+
+import { globalRegistry, executeSlashCommand } from './register-all-commands.js';
+
+/**
+ * Command Validator
+ */
+export class CommandValidator {
+  constructor() {
+    this.registry = globalRegistry;
+    this.results = [];
+  }
+
+  /**
+   * Validate all commands
+   */
+  async validateAll() {
+    console.log('🔍 Validating all slash commands...');
+    
+    const commands = this.registry.listCommands();
+    
+    for (const cmd of commands) {
+      await this.validateCommand(cmd.name);
+    }
+    
+    this.printResults();
+    return this.results;
+  }
+
+  /**
+   * Validate individual command
+   * @param {string} commandName - Command to validate
+   */
+  async validateCommand(commandName) {
+    const result = {
+      command: commandName,
+      tests: {
+        help: false,
+        execute: false,
+        errorHandling: false
+      },
+      errors: []
+    };
+
+    try {
+      // Test 1: Help functionality
+      const helpResult = this.registry.getHelp(commandName);
+      result.tests.help = helpResult.success;
+      if (!helpResult.success) {
+        result.errors.push(`Help failed: ${helpResult.error}`);
+      }
+
+      // Test 2: Basic execution (should fail gracefully with no args)
+      try {
+        const execResult = await executeSlashCommand(`/${commandName}`);
+        result.tests.execute = true;
+      } catch (error) {
+        result.tests.execute = false;
+        result.errors.push(`Execution failed: ${error.message}`);
+      }
+
+      // Test 3: Error handling (invalid args)
+      try {
+        const errorResult = await executeSlashCommand(`/${commandName} invalid-arg-test`);
+        result.tests.errorHandling = true;
+      } catch (error) {
+        result.tests.errorHandling = false;
+        result.errors.push(`Error handling failed: ${error.message}`);
+      }
+
+    } catch (error) {
+      result.errors.push(`Validation failed: ${error.message}`);
+    }
+
+    this.results.push(result);
+  }
+
+  /**
+   * Print validation results
+   */
+  printResults() {
+    console.log('\n📈 **VALIDATION RESULTS**\n');
+    
+    let totalTests = 0;
+    let passedTests = 0;
+    
+    for (const result of this.results) {
+      const tests = Object.values(result.tests);
+      const passed = tests.filter(t => t).length;
+      const total = tests.length;
+      
+      totalTests += total;
+      passedTests += passed;
+      
+      const status = passed === total ? '✅' : '⚠️';
+      console.log(`${status} /${result.command} - ${passed}/${total} tests passed`);
+      
+      if (result.errors.length > 0) {
+        result.errors.forEach(error => {
+          console.log(`   ❌ ${error}`);
+        });
+      }
+    }
+    
+    console.log(`\n📉 **Overall: ${passedTests}/${totalTests} tests passed**`);
+    
+    if (passedTests === totalTests) {
+      console.log('✅ All commands validated successfully!');
+    } else {
+      console.log('⚠️ Some commands need attention.');
+    }
+  }
+
+  /**
+   * Test specific command with args
+   * @param {string} commandName - Command name
+   * @param {string[]} args - Arguments to test
+   */
+  async testCommand(commandName, args = []) {
+    const input = `/${commandName} ${args.join(' ')}`.trim();
+    
+    console.log(`\n🔍 Testing: ${input}`);
+    
+    try {
+      const result = await executeSlashCommand(input);
+      
+      if (result.success) {
+        console.log('✅ Command executed successfully');
+        if (result.result && result.result.prompt) {
+          console.log('Generated prompt preview:');
+          console.log(result.result.prompt.substring(0, 200) + '...');
+        }
+      } else {
+        console.log(`⚠️ Command failed: ${result.error}`);
+      }
+      
+      return result;
+    } catch (error) {
+      console.log(`❌ Test failed: ${error.message}`);
+      return { success: false, error: error.message };
+    }
+  }
+}
+
+/**
+ * Run interactive command testing
+ */
+export async function interactiveTest() {
+  const validator = new CommandValidator();
+  
+  console.log('🚀 **INTERACTIVE COMMAND TESTING**\n');
+  
+  // Test each command with example arguments
+  const testCases = [
+    { command: 'swarm', args: ['init', 'mesh', '8'] },
+    { command: 'hooks', args: ['enable'] },
+    { command: 'neural', args: ['status'] },
+    { command: 'performance', args: ['report'] },
+    { command: 'github', args: ['analyze', 'owner/repo'] },
+    { command: 'workflow', args: ['create', 'Test Workflow'] },
+    { command: 'sparc', args: ['spec', 'Build API'] }
+  ];
+  
+  for (const testCase of testCases) {
+    await validator.testCommand(testCase.command, testCase.args);
+    
+    // Small delay for readability
+    await new Promise(resolve => setTimeout(resolve, 100));
+  }
+}
+
+/**
+ * Quick validation - just check structure
+ */
+export function quickValidation() {
+  console.log('⚡ **QUICK VALIDATION**\n');
+  
+  const commands = globalRegistry.listCommands();
+  
+  console.log(`✅ Registry loaded with ${commands.length} commands`);
+  
+  commands.forEach(cmd => {
+    console.log(`✅ /${cmd.name} - ${cmd.description}`);
+    if (cmd.aliases.length > 0) {
+      console.log(`   Aliases: ${cmd.aliases.map(a => `/${a}`).join(', ')}`);
+    }
+  });
+  
+  console.log('\n✅ All commands loaded successfully!');
+}
+
+// Main execution
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const mode = process.argv[2] || 'quick';
+  
+  switch (mode) {
+    case 'full':
+      const validator = new CommandValidator();
+      await validator.validateAll();
+      break;
+    
+    case 'interactive':
+      await interactiveTest();
+      break;
+    
+    case 'quick':
+    default:
+      quickValidation();
+      break;
+  }
+}
+
+export default {
+  CommandValidator,
+  interactiveTest,
+  quickValidation
+};

package/claude-assets/commands/verify/check.md

@@ -0,0 +1,50 @@
+# verify check
+
+Run verification checks on code, tasks, or agent outputs.
+
+## Usage
+
+```bash
+claude-flow-novice verify check [options]
+```
+
+## Options
+
+- `--file <path>` - Verify specific file
+- `--task <id>` - Verify task output
+- `--directory <path>` - Verify entire directory
+- `--threshold <0-1>` - Override default threshold (0.95)
+- `--auto-fix` - Attempt automatic fixes
+- `--json` - Output results as JSON
+- `--verbose` - Show detailed verification steps
+
+## Examples
+
+```bash
+# Basic file verification
+claude-flow-novice verify check --file src/app.js
+
+# Verify with higher threshold
+claude-flow-novice verify check --file src/critical.js --threshold 0.99
+
+# Verify and auto-fix issues
+claude-flow-novice verify check --directory src/ --auto-fix
+
+# Get JSON output for CI/CD
+claude-flow-novice verify check --json > verification.json
+```
+
+## Truth Scoring
+
+The check command evaluates:
+- Code correctness
+- Best practices adherence
+- Security vulnerabilities
+- Performance implications
+- Documentation completeness
+
+## Exit Codes
+
+- `0` - Verification passed
+- `1` - Verification failed
+- `2` - Error during verification

package/claude-assets/commands/verify/start.md

@@ -0,0 +1,128 @@
+# 🔍 Verification Commands
+
+Truth verification system for ensuring code quality and correctness with a 0.95 accuracy threshold.
+
+## Overview
+
+The verification system provides real-time truth checking and validation for all agent tasks, ensuring high-quality outputs and automatic rollback on failures.
+
+## Subcommands
+
+### `verify check`
+Run verification checks on current code or agent outputs.
+
+```bash
+claude-flow-novice verify check --file src/app.js
+claude-flow-novice verify check --task "task-123"
+claude-flow-novice verify check --threshold 0.98
+```
+
+### `verify rollback`
+Automatically rollback changes that fail verification.
+
+```bash
+claude-flow-novice verify rollback --to-commit abc123
+claude-flow-novice verify rollback --last-good
+claude-flow-novice verify rollback --interactive
+```
+
+### `verify report`
+Generate verification reports and metrics.
+
+```bash
+claude-flow-novice verify report --format json
+claude-flow-novice verify report --export metrics.html
+claude-flow-novice verify report --period 7d
+```
+
+### `verify dashboard`
+Launch interactive verification dashboard.
+
+```bash
+claude-flow-novice verify dashboard
+claude-flow-novice verify dashboard --port 3000
+claude-flow-novice verify dashboard --export
+```
+
+## Configuration
+
+Default threshold: **0.95** (95% accuracy required)
+
+Configure in `.claude-flow/config.json`:
+```json
+{
+  "verification": {
+    "threshold": 0.95,
+    "autoRollback": true,
+    "gitIntegration": true,
+    "hooks": {
+      "preCommit": true,
+      "preTask": true,
+      "postEdit": true
+    }
+  }
+}
+```
+
+## Integration
+
+### With Swarm Commands
+```bash
+claude-flow-novice swarm --verify --threshold 0.98
+claude-flow-novice hive-mind --verify
+```
+
+### With Training Pipeline
+```bash
+claude-flow-novice train --verify --rollback-on-fail
+```
+
+### With Pair Programming
+```bash
+claude-flow-novice pair --verify --real-time
+```
+
+## Metrics
+
+- **Truth Score**: 0.0 to 1.0 (higher is better)
+- **Confidence Level**: Statistical confidence in verification
+- **Rollback Rate**: Percentage of changes rolled back
+- **Quality Improvement**: Trend over time
+
+## Examples
+
+### Basic Verification
+```bash
+# Verify current directory
+claude-flow-novice verify check
+
+# Verify with custom threshold
+claude-flow-novice verify check --threshold 0.99
+
+# Verify and auto-fix
+claude-flow-novice verify check --auto-fix
+```
+
+### Advanced Workflows
+```bash
+# Continuous verification during development
+claude-flow-novice verify watch --directory src/
+
+# Batch verification
+claude-flow-novice verify batch --files "*.js" --parallel
+
+# Integration testing
+claude-flow-novice verify integration --test-suite full
+```
+
+## Performance
+
+- Verification latency: <100ms for most checks
+- Rollback time: <1s for git-based rollback
+- Dashboard refresh: Real-time via WebSocket
+
+## Related Commands
+
+- `truth` - View truth scores and metrics
+- `pair` - Collaborative development with verification
+- `train` - Training with verification feedback