VeriQA v3.0 🎯

🇮🇳 Made in India 🇮🇳

Smart Manual QA Test Advisor with AI-Powered Regression Suggestions

VeriQA v3.0 is a completely rewritten, modern tool that helps QA teams identify critical regression test scenarios by analyzing git commits using AI intelligence.

✨ Proudly supporting Indian innovation in AI & Testing ✨

✨ Features

• 🔍 Smart Project Scanning - Automatically detects testing frameworks and project structure
• 📊 Git Commit Analysis - Analyzes code changes between commits to identify risk areas
• 🤖 AI-Powered Suggestions - Uses Google Gemini to generate intelligent test recommendations
• 📄 Beautiful Reports - Creates comprehensive HTML and PDF reports with html-pdf-node
• ⚡ Lightning Fast - Modern, lightweight architecture with minimal dependencies
• 🔧 Easy Setup - Simple 3-step workflow: init → analyze → report

🚀 Quick Start

Installation

# Install globally via NPM
npm install -g veriqa

# Or install locally in your project
npm install veriqa --save-dev

Usage

# Step 1: Initialize and scan your project
veriqa init

# Step 2: Analyze commits for regression testing
veriqa analyze <old-commit> <new-commit>

# Step 3: Generate comprehensive report
veriqa report

# NEW: Advanced Git Integration (v3.1.0)
veriqa status                    # Enhanced git status with stash detection
veriqa compare main feature      # Compare branches for regression analysis
veriqa hooks                     # Install pre-commit hooks for automation
veriqa blame src/app.js 45       # Analyze blame information for targeted testing

Example Workflow

# Initialize VeriQA in your project
cd my-project
veriqa init

# Check enhanced project status with stash detection
veriqa status

# Compare branches for comprehensive analysis
veriqa compare main feature-branch

# Install automated pre-commit hooks
veriqa hooks

# Analyze specific commits
veriqa analyze abc123 def456

# Get blame info for specific files/lines
veriqa blame src/components/Login.js 120

# Generate beautiful reports
veriqa report

🔧 Configuration

AI Setup

VeriQA automatically creates a .env file for AI configuration:

# Get your API key from: https://ai.google.dev/
GEMINI_API_KEY=your_gemini_api_key_here

# Optional: Customize AI behavior
AI_MODEL=gemini-pro
AI_TEMPERATURE=0.7
MAX_SUGGESTIONS=10

Supported Testing Frameworks

VeriQA automatically detects:

• Unit Testing: Jest, Mocha, Jasmine, Vitest, Ava, Tape, QUnit
• E2E Testing: Cypress, Playwright, TestCafe, WebdriverIO
• React: React Testing Library, Enzyme
• Vue: Vue Test Utils
• Angular: Angular Testing utilities

📊 What You Get

Comprehensive Analysis

• File Changes: Detailed diff analysis with additions/deletions
• Risk Assessment: AI-powered risk evaluation of changes
• Impact Analysis: Understanding of affected components

Smart Suggestions (Even Without AI!)

• With AI: Gemini-powered intelligent test case generation
• Fallback Mode: Rule-based suggestions when AI is disabled
• Framework-specific: Targeted suggestions based on detected frameworks
• Priority Levels: High/Medium/Low priority recommendations

Beautiful Reports

• HTML Report: Interactive, responsive web report
• PDF Report: Professional document using html-pdf-node (lightweight!)
• JSON Data: Raw data for integration with other tools

🌿 Advanced Git Integration (v3.1.0)

VeriQA now includes powerful Git integration features for enhanced workflow:

Enhanced Git Status

• Current branch detection with detailed tracking information
• Stash detection and warnings before analysis
• Ahead/behind tracking with remote branches
• Staged, modified, and untracked file counts

Branch Comparison

• Smart branch analysis between any two branches
• Merge base detection for accurate comparisons
• Comprehensive diff analysis with AI-powered suggestions
• Automatic test suggestion generation for branch differences

Pre-commit Hooks

• Automated VeriQA analysis before each commit
• Intelligent hook installation with error handling
• Non-blocking analysis that allows commits to proceed
• Integration suggestions displayed in commit workflow

Blame Analysis

• File-level blame information for any source file
• Line-specific analysis for targeted debugging
• Author and commit tracking for change history
• Integration with test suggestions for focused reviews

🎯 Example Output

$ veriqa init

    ██╗   ██╗███████╗██████╗ ██╗ ██████╗  █████╗ 
    ██║   ██║██╔════╝██╔══██╗██║██╔═══██╗██╔══██╗
    ██║   ██║█████╗  ██████╔╝██║██║   ██║███████║
    ╚██╗ ██╔╝██╔══╝  ██╔══██╗██║██║▄▄ ██║██╔══██║
     ╚████╔╝ ███████╗██║  ██║██║╚██████╔╝██║  ██║
      ╚═══╝  ╚══════╝╚═╝  ╚═╝╚═╝ ╚══▀▀═╝ ╚═╝  ╚═╝
    
    🎯 VeriQA v3.0 - Smart Manual QA Test Advisor

✅ Project initialized successfully!
📁 Project: my-awesome-app
🧪 Frameworks: Jest, Cypress
📄 Test Files: 23
📄 Source Files: 156

$ veriqa analyze abc123 def456
🔍 Analyzing commits for regression testing...
✅ Analysis complete!
📊 Files changed: 5
🤖 AI Suggestions: 8

$ veriqa report  
📊 Generating comprehensive test report...
✅ Reports generated successfully!
📄 HTML Report: /path/to/veriqa-report-2025-11-16.html
📄 PDF Report: /path/to/veriqa-report-2025-11-16.pdf
📄 JSON Data: /path/to/veriqa-report-2025-11-16.json

🔧 Architecture

Modern, Lightweight Dependencies:

• Commander.js - CLI framework (lightweight)
• Simple-git - Git operations
• Chalk - Terminal styling
• html-pdf-node - PDF generation (fast, no browser overhead!)
• Google Generative AI - Gemini integration
• Ora - Loading spinners
• Inquirer - Interactive prompts

Key Benefits:

✅ Fast Installation - Minimal dependencies, quick npm install
✅ No Browser Overhead - html-pdf-node instead of heavy Puppeteer
✅ Works Offline - Fallback suggestions when AI is disabled
✅ Cross-Platform - Works on Windows, macOS, Linux
✅ Framework Agnostic - Supports any testing framework

📝 Requirements

• Node.js 14.0.0 or higher
• Git repository
• Google Gemini API Key (optional - for AI features)

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

MIT License - see LICENSE file for details.

🎯 Made with ❤️ by VeriQA Team

Making regression testing smarter with AI

Why VeriQA v3.0?

• 🚀 3x Faster than v2.x due to lightweight dependencies
• 🤖 AI-Enhanced with Google Gemini integration
• 📊 Better Reports with modern HTML and reliable PDF generation
• 🔧 Easier Setup with automatic configuration
• 💡 Smarter fallback suggestions even without AI

Workflow test - Fri Nov 21 20:58:55 IST 2025

GitHub Actions Test - Sun Nov 23 07:38:27 IST 2025