agentic-qe 1.0.0

package/.claude/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 verify check --file src/app.js
+claude-flow verify check --task "task-123"
+claude-flow verify check --threshold 0.98
+```
+
+### `verify rollback`
+Automatically rollback changes that fail verification.
+
+```bash
+claude-flow verify rollback --to-commit abc123
+claude-flow verify rollback --last-good
+claude-flow verify rollback --interactive
+```
+
+### `verify report`
+Generate verification reports and metrics.
+
+```bash
+claude-flow verify report --format json
+claude-flow verify report --export metrics.html
+claude-flow verify report --period 7d
+```
+
+### `verify dashboard`
+Launch interactive verification dashboard.
+
+```bash
+claude-flow verify dashboard
+claude-flow verify dashboard --port 3000
+claude-flow 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 swarm --verify --threshold 0.98
+claude-flow hive-mind --verify
+```
+
+### With Training Pipeline
+```bash
+claude-flow train --verify --rollback-on-fail
+```
+
+### With Pair Programming
+```bash
+claude-flow 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 verify check
+
+# Verify with custom threshold
+claude-flow verify check --threshold 0.99
+
+# Verify and auto-fix
+claude-flow verify check --auto-fix
+```
+
+### Advanced Workflows
+```bash
+# Continuous verification during development
+claude-flow verify watch --directory src/
+
+# Batch verification
+claude-flow verify batch --files "*.js" --parallel
+
+# Integration testing
+claude-flow 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

package/.claude/commands/workflows/README.md

@@ -0,0 +1,9 @@
+# Workflows Commands
+
+Commands for workflows operations in Claude Flow.
+
+## Available Commands
+
+- [workflow-create](./workflow-create.md)
+- [workflow-execute](./workflow-execute.md)
+- [workflow-export](./workflow-export.md)

package/.claude/commands/workflows/development.md

@@ -0,0 +1,78 @@
+# Development Workflow Coordination
+
+## Purpose
+Structure Claude Code's approach to complex development tasks for maximum efficiency.
+
+## Step-by-Step Coordination
+
+### 1. Initialize Development Framework
+```
+Tool: mcp__claude-flow__swarm_init
+Parameters: {"topology": "hierarchical", "maxAgents": 8, "strategy": "specialized"}
+```
+Creates hierarchical structure for organized, top-down development.
+
+### 2. Define Development Perspectives
+```
+Tool: mcp__claude-flow__agent_spawn
+Parameters: {
+  "type": "architect",
+  "name": "System Design",
+  "capabilities": ["api-design", "database-schema"]
+}
+```
+```
+Tool: mcp__claude-flow__agent_spawn
+Parameters: {
+  "type": "coder",
+  "name": "Implementation Focus",
+  "capabilities": ["nodejs", "typescript", "express"]
+}
+```
+```
+Tool: mcp__claude-flow__agent_spawn
+Parameters: {
+  "type": "tester",
+  "name": "Quality Assurance",
+  "capabilities": ["unit-testing", "integration-testing"]
+}
+```
+Sets up architectural and implementation thinking patterns.
+
+### 3. Coordinate Implementation
+```
+Tool: mcp__claude-flow__task_orchestrate
+Parameters: {
+  "task": "Build REST API with authentication",
+  "strategy": "parallel",
+  "priority": "high",
+  "dependencies": ["database setup", "auth system"]
+}
+```
+
+### 4. Monitor Progress
+```
+Tool: mcp__claude-flow__task_status
+Parameters: {"taskId": "api-build-task-123"}
+```
+
+## What Claude Code Actually Does
+1. Uses **Write** tool to create new files
+2. Uses **Edit/MultiEdit** tools for code modifications
+3. Uses **Bash** tool for testing and building
+4. Uses **TodoWrite** tool for task tracking
+5. Follows coordination patterns for systematic implementation
+
+Remember: All code is written by Claude Code using its native tools!
+
+## CLI Usage
+```bash
+# Start development workflow via CLI
+npx claude-flow workflow dev "REST API with auth"
+
+# Create custom workflow
+npx claude-flow workflow create --name "api-dev" --steps "design,implement,test,deploy"
+
+# Execute saved workflow
+npx claude-flow workflow execute api-dev
+```

package/.claude/commands/workflows/research.md

@@ -0,0 +1,63 @@
+# Research Workflow Coordination
+
+## Purpose
+Coordinate Claude Code's research activities for comprehensive, systematic exploration.
+
+## Step-by-Step Coordination
+
+### 1. Initialize Research Framework
+```
+Tool: mcp__claude-flow__swarm_init
+Parameters: {"topology": "mesh", "maxAgents": 5, "strategy": "balanced"}
+```
+Creates a mesh topology for comprehensive exploration from multiple angles.
+
+### 2. Define Research Perspectives
+```
+Tool: mcp__claude-flow__agent_spawn
+Parameters: {"type": "researcher", "name": "Literature Review"}
+```
+```
+Tool: mcp__claude-flow__agent_spawn  
+Parameters: {"type": "analyst", "name": "Data Analysis"}
+```
+Sets up different analytical approaches for Claude Code to use.
+
+### 3. Execute Coordinated Research
+```
+Tool: mcp__claude-flow__task_orchestrate
+Parameters: {
+  "task": "Research modern web frameworks performance",
+  "strategy": "adaptive",
+  "priority": "medium"
+}
+```
+
+### 4. Store Research Findings
+```
+Tool: mcp__claude-flow__memory_usage
+Parameters: {
+  "action": "store",
+  "key": "research_findings",
+  "value": "framework performance analysis results",
+  "namespace": "research"
+}
+```
+
+## What Claude Code Actually Does
+1. Uses **WebSearch** tool for finding resources
+2. Uses **Read** tool for analyzing documentation
+3. Uses **Task** tool for parallel exploration
+4. Synthesizes findings using coordination patterns
+5. Stores insights in memory for future reference
+
+Remember: The swarm coordinates HOW Claude Code researches, not WHAT it finds.
+
+## CLI Usage
+```bash
+# Start research workflow via CLI
+npx claude-flow workflow research "modern web frameworks"
+
+# Export research workflow
+npx claude-flow workflow export research --format json
+```

package/.claude/commands/workflows/workflow-create.md

@@ -0,0 +1,25 @@
+# workflow-create
+
+Create reusable workflow templates.
+
+## Usage
+```bash
+npx claude-flow workflow create [options]
+```
+
+## Options
+- `--name <name>` - Workflow name
+- `--from-history` - Create from history
+- `--interactive` - Interactive creation
+
+## Examples
+```bash
+# Create workflow
+npx claude-flow workflow create --name "deploy-api"
+
+# From history
+npx claude-flow workflow create --name "test-suite" --from-history
+
+# Interactive mode
+npx claude-flow workflow create --interactive
+```

package/.claude/commands/workflows/workflow-execute.md

@@ -0,0 +1,25 @@
+# workflow-execute
+
+Execute saved workflows.
+
+## Usage
+```bash
+npx claude-flow workflow execute [options]
+```
+
+## Options
+- `--name <name>` - Workflow name
+- `--params <json>` - Workflow parameters
+- `--dry-run` - Preview execution
+
+## Examples
+```bash
+# Execute workflow
+npx claude-flow workflow execute --name "deploy-api"
+
+# With parameters
+npx claude-flow workflow execute --name "test-suite" --params '{"env": "staging"}'
+
+# Dry run
+npx claude-flow workflow execute --name "deploy-api" --dry-run
+```

package/.claude/commands/workflows/workflow-export.md

@@ -0,0 +1,25 @@
+# workflow-export
+
+Export workflows for sharing.
+
+## Usage
+```bash
+npx claude-flow workflow export [options]
+```
+
+## Options
+- `--name <name>` - Workflow to export
+- `--format <type>` - Export format
+- `--include-history` - Include execution history
+
+## Examples
+```bash
+# Export workflow
+npx claude-flow workflow export --name "deploy-api"
+
+# As YAML
+npx claude-flow workflow export --name "test-suite" --format yaml
+
+# With history
+npx claude-flow workflow export --name "deploy-api" --include-history
+```

package/.claude/helpers/checkpoint-manager.sh

@@ -0,0 +1,251 @@
+#!/bin/bash
+# Claude Checkpoint Manager
+# Provides easy rollback and management of Claude Code checkpoints
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+CHECKPOINT_DIR=".claude/checkpoints"
+BACKUP_DIR=".claude/backups"
+
+# Help function
+show_help() {
+    cat << EOF
+Claude Checkpoint Manager
+========================
+
+Usage: $0 <command> [options]
+
+Commands:
+  list              List all checkpoints
+  show <id>         Show details of a specific checkpoint
+  rollback <id>     Rollback to a specific checkpoint
+  diff <id>         Show diff since checkpoint
+  clean             Clean old checkpoints (older than 7 days)
+  summary           Show session summary
+  
+Options:
+  --hard            For rollback: use git reset --hard (destructive)
+  --soft            For rollback: use git reset --soft (default)
+  --branch          For rollback: create new branch from checkpoint
+
+Examples:
+  $0 list
+  $0 show checkpoint-20240130-143022
+  $0 rollback checkpoint-20240130-143022 --branch
+  $0 diff session-end-session-20240130-150000
+EOF
+}
+
+# List all checkpoints
+function list_checkpoints() {
+    echo -e "${BLUE}📋 Available Checkpoints:${NC}"
+    echo ""
+    
+    # List checkpoint tags
+    echo -e "${YELLOW}Git Tags:${NC}"
+    local tags=$(git tag -l 'checkpoint-*' -l 'session-end-*' -l 'task-*' --sort=-creatordate | head -20)
+    if [ -n "$tags" ]; then
+        echo "$tags"
+    else
+        echo "No checkpoint tags found"
+    fi
+    
+    echo ""
+    
+    # List checkpoint branches
+    echo -e "${YELLOW}Checkpoint Branches:${NC}"
+    local branches=$(git branch -a | grep "checkpoint/" | sed 's/^[ *]*//')
+    if [ -n "$branches" ]; then
+        echo "$branches"
+    else
+        echo "No checkpoint branches found"
+    fi
+    
+    echo ""
+    
+    # List checkpoint files
+    if [ -d "$CHECKPOINT_DIR" ]; then
+        echo -e "${YELLOW}Recent Checkpoint Files:${NC}"
+        find "$CHECKPOINT_DIR" -name "*.json" -type f -printf "%T@ %p\n" | \
+            sort -rn | head -10 | cut -d' ' -f2- | xargs -I {} basename {}
+    fi
+}
+
+# Show checkpoint details
+function show_checkpoint() {
+    local checkpoint_id="$1"
+    
+    echo -e "${BLUE}📍 Checkpoint Details: $checkpoint_id${NC}"
+    echo ""
+    
+    # Check if it's a tag
+    if git tag -l "$checkpoint_id" | grep -q "$checkpoint_id"; then
+        echo -e "${YELLOW}Type:${NC} Git Tag"
+        echo -e "${YELLOW}Commit:${NC} $(git rev-list -n 1 "$checkpoint_id")"
+        echo -e "${YELLOW}Date:${NC} $(git log -1 --format=%ai "$checkpoint_id")"
+        echo -e "${YELLOW}Message:${NC}"
+        git log -1 --format=%B "$checkpoint_id" | sed 's/^/  /'
+        echo ""
+        echo -e "${YELLOW}Files changed:${NC}"
+        git diff-tree --no-commit-id --name-status -r "$checkpoint_id" | sed 's/^/  /'
+    # Check if it's a branch
+    elif git branch -a | grep -q "$checkpoint_id"; then
+        echo -e "${YELLOW}Type:${NC} Git Branch"
+        echo -e "${YELLOW}Latest commit:${NC}"
+        git log -1 --oneline "$checkpoint_id"
+    else
+        echo -e "${RED}❌ Checkpoint not found: $checkpoint_id${NC}"
+        exit 1
+    fi
+}
+
+# Rollback to checkpoint
+function rollback_checkpoint() {
+    local checkpoint_id="$1"
+    local mode="$2"
+    
+    echo -e "${YELLOW}🔄 Rolling back to checkpoint: $checkpoint_id${NC}"
+    echo ""
+    
+    # Verify checkpoint exists
+    if ! git tag -l "$checkpoint_id" | grep -q "$checkpoint_id" && \
+       ! git branch -a | grep -q "$checkpoint_id"; then
+        echo -e "${RED}❌ Checkpoint not found: $checkpoint_id${NC}"
+        exit 1
+    fi
+    
+    # Create backup before rollback
+    local backup_name="backup-$(date +%Y%m%d-%H%M%S)"
+    echo "Creating backup: $backup_name"
+    git tag "$backup_name" -m "Backup before rollback to $checkpoint_id"
+    
+    case "$mode" in
+        "--hard")
+            echo -e "${RED}⚠️  Performing hard reset (destructive)${NC}"
+            git reset --hard "$checkpoint_id"
+            echo -e "${GREEN}✅ Rolled back to $checkpoint_id (hard reset)${NC}"
+            ;;
+        "--branch")
+            local branch_name="rollback-$checkpoint_id-$(date +%Y%m%d-%H%M%S)"
+            echo "Creating new branch: $branch_name"
+            git checkout -b "$branch_name" "$checkpoint_id"
+            echo -e "${GREEN}✅ Created branch $branch_name from $checkpoint_id${NC}"
+            ;;
+        "--stash"|*)
+            echo "Stashing current changes..."
+            git stash push -m "Stash before rollback to $checkpoint_id"
+            git reset --soft "$checkpoint_id"
+            echo -e "${GREEN}✅ Rolled back to $checkpoint_id (soft reset)${NC}"
+            echo "Your changes are stashed. Use 'git stash pop' to restore them."
+            ;;
+    esac
+}
+
+# Show diff since checkpoint
+function diff_checkpoint() {
+    local checkpoint_id="$1"
+    
+    echo -e "${BLUE}📊 Changes since checkpoint: $checkpoint_id${NC}"
+    echo ""
+    
+    if git tag -l "$checkpoint_id" | grep -q "$checkpoint_id"; then
+        git diff "$checkpoint_id"
+    elif git branch -a | grep -q "$checkpoint_id"; then
+        git diff "$checkpoint_id"
+    else
+        echo -e "${RED}❌ Checkpoint not found: $checkpoint_id${NC}"
+        exit 1
+    fi
+}
+
+# Clean old checkpoints
+function clean_checkpoints() {
+    local days=${1:-7}
+    
+    echo -e "${YELLOW}🧹 Cleaning checkpoints older than $days days...${NC}"
+    echo ""
+    
+    # Clean old checkpoint files
+    if [ -d "$CHECKPOINT_DIR" ]; then
+        find "$CHECKPOINT_DIR" -name "*.json" -type f -mtime +$days -delete
+        echo "✅ Cleaned old checkpoint files"
+    fi
+    
+    # List old tags (but don't delete automatically)
+    echo ""
+    echo "Old checkpoint tags (manual deletion required):"
+    git tag -l 'checkpoint-*' --sort=-creatordate | tail -n +50 || echo "No old tags found"
+}
+
+# Show session summary
+function show_summary() {
+    echo -e "${BLUE}📊 Session Summary${NC}"
+    echo ""
+    
+    # Find most recent session summary
+    if [ -d "$CHECKPOINT_DIR" ]; then
+        local latest_summary=$(find "$CHECKPOINT_DIR" -name "summary-*.md" -type f -printf "%T@ %p\n" | \
+            sort -rn | head -1 | cut -d' ' -f2-)
+        
+        if [ -n "$latest_summary" ]; then
+            echo -e "${YELLOW}Latest session summary:${NC}"
+            cat "$latest_summary"
+        else
+            echo "No session summaries found"
+        fi
+    fi
+}
+
+# Main command handling
+case "$1" in
+    list)
+        list_checkpoints
+        ;;
+    show)
+        if [ -z "$2" ]; then
+            echo -e "${RED}Error: Please specify a checkpoint ID${NC}"
+            show_help
+            exit 1
+        fi
+        show_checkpoint "$2"
+        ;;
+    rollback)
+        if [ -z "$2" ]; then
+            echo -e "${RED}Error: Please specify a checkpoint ID${NC}"
+            show_help
+            exit 1
+        fi
+        rollback_checkpoint "$2" "$3"
+        ;;
+    diff)
+        if [ -z "$2" ]; then
+            echo -e "${RED}Error: Please specify a checkpoint ID${NC}"
+            show_help
+            exit 1
+        fi
+        diff_checkpoint "$2"
+        ;;
+    clean)
+        clean_checkpoints "$2"
+        ;;
+    summary)
+        show_summary
+        ;;
+    help|--help|-h)
+        show_help
+        ;;
+    *)
+        echo -e "${RED}Error: Unknown command: $1${NC}"
+        echo ""
+        show_help
+        exit 1
+        ;;
+esac