autonomous-qa-agent 1.0.0__tar.gz

autonomous_qa_agent-1.0.0/PKG-INFO

@@ -0,0 +1,272 @@
+Metadata-Version: 2.4
+Name: autonomous-qa-agent
+Version: 1.0.0
+Summary: Autonomous QA Agent — scan, test, and fix any codebase automatically
+License: MIT
+Keywords: qa,testing,autonomous,ai,code-quality
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.28
+Requires-Dist: websockets>=12.0
+Requires-Dist: rich>=13.0
+
+# QA Agent — Complete Client Guide
+
+## What This Does
+
+QA Agent autonomously scans your entire codebase, writes test cases for every function, runs them, finds bugs, explains them clearly, and fixes them automatically — then asks for your approval before committing anything.
+
+**Supports:** Python, Kotlin, Java, Vert.x, JavaScript, TypeScript, Go, Rust, React, Vue, ML/AI models, and more.
+
+---
+
+## Prerequisites (Client Machine)
+
+| Requirement | Version | How to install |
+|-------------|---------|----------------|
+| Docker Desktop | 24+ | https://docker.com/products/docker-desktop |
+| Python | 3.10+ | https://python.org |
+| 16GB RAM | — | For running LLM models locally |
+| 20GB disk | — | For Docker images + LLM models |
+
+> **Privacy guarantee:** Your code NEVER leaves your machine. The LLM runs locally via Ollama.
+
+---
+
+## Install (One Command)
+
+```bash
+# Mac / Linux / Windows WSL:
+curl -fsSL https://install.qa-agent.dev | bash
+
+# Windows (PowerShell):
+irm https://install.qa-agent.dev/windows | iex
+```
+
+This automatically:
+1. Checks Docker is running
+2. Starts all 7 AI services in Docker
+3. Downloads LLM models (qwen2.5-coder — private, runs locally)
+4. Installs the `qa-agent` CLI
+5. Runs a health check
+
+---
+
+## First Scan
+
+```bash
+# Go to your project directory
+cd /path/to/your/codebase
+
+# Run full autonomous scan
+qa-agent scan .
+```
+
+**What you'll see:**
+```
+QA Agent — Autonomous scan
+Repo: /path/to/your/codebase
+Languages: all
+Mode: exhaustive
+
+[scanning]   Found 1,247 source files
+[indexing]   Indexed 3,891 functions
+[generating] Generated 3,891 test files (parallel, 4 workers)
+[running]    2,847/3,891 tests passing
+[healing]    Self-healed 891 wrong assertion values
+[fixing]     Analysing 153 real failures...
+
+┌─────────────────────────────────────────────┐
+│  Bug Fix Proposal                           │
+│  File: src/payment/calculator.kt            │
+│  Confidence: 94%                            │
+│                                             │
+│  Root cause: Tax rate multiplied instead    │
+│  of applied as percentage                   │
+│                                             │
+│  Diff:                                      │
+│  - return amount * taxRate                  │
+│  + return amount * (taxRate / 100.0)        │
+└─────────────────────────────────────────────┘
+Approve this patch? [y/N]: y
+
+[PASS] Patch committed and verified.
+
+╔══════════════════════════════════════════════╗
+║         QA Agent — Scan Report               ║
+║  Status: PASS                                ║
+║  Files scanned:    1,247                     ║
+║  Functions tested: 3,891                     ║
+║  Tests passed:     3,891 / 3,891  (100%)     ║
+║  Bugs found:       153                       ║
+║  Bugs fixed:       153 / 153                 ║
+║  Time:             14m 32s                   ║
+║  YOUR CODEBASE IS GREEN                      ║
+╚══════════════════════════════════════════════╝
+```
+
+---
+
+## Common Commands
+
+```bash
+# Full scan (all files, all languages)
+qa-agent scan .
+
+# Only scan files changed since last commit (fast re-scan)
+qa-agent scan . --changed-only
+
+# Scan specific languages only
+qa-agent scan . --lang python,kotlin,java
+
+# CI/CD mode — auto-approve patches (no prompts)
+qa-agent scan . --auto-approve
+
+# Check system health
+qa-agent doctor
+
+# Check status of a running scan
+qa-agent status <job-id>
+
+# Approve/reject a pending patch
+qa-agent approve <job-id> <patch-id>
+qa-agent approve <job-id> <patch-id> --reject
+```
+
+---
+
+## CI/CD Integration
+
+### GitHub Actions
+```yaml
+name: QA Agent Scan
+on: [push, pull_request]
+jobs:
+  qa-scan:
+    runs-on: self-hosted   # needs Docker + qa-agent installed
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run QA Agent
+        run: qa-agent scan . --auto-approve --output json > qa-report.json
+      - name: Upload Report
+        uses: actions/upload-artifact@v4
+        with:
+          name: qa-report
+          path: qa-report.json
+```
+
+### GitLab CI
+```yaml
+qa-scan:
+  stage: test
+  tags: [docker]
+  script:
+    - qa-agent scan . --auto-approve
+  artifacts:
+    paths: [qa-report.json]
+```
+
+---
+
+## Configuration
+
+Create `.qa-agent.env` in your repo root:
+
+```env
+# LLM Provider: ollama (local) | openai | anthropic
+LLM_PROVIDER=ollama
+
+# For cloud LLMs (faster, requires API key)
+# LLM_PROVIDER=openai
+# OPENAI_API_KEY=sk-...
+
+# Models
+TEST_GEN_MODEL=qwen2.5-coder:1.5b   # fast, for test generation
+PATCH_MODEL=qwen2.5-coder:7b         # accurate, for bug fixing
+
+# Scan behaviour
+MAX_CHUNKS=1000                       # max functions to generate tests for
+MAX_FIX_ATTEMPTS=3                    # LLM retry limit per bug
+```
+
+---
+
+## Supported Languages
+
+| Language | Test Framework | Status |
+|----------|---------------|--------|
+| Python | pytest | ✅ |
+| Kotlin | JUnit 5 + Maven | ✅ |
+| Java | JUnit 5 + Maven | ✅ |
+| Vert.x (Java/Kotlin) | JUnit 5 | ✅ |
+| JavaScript | Jest | ✅ |
+| TypeScript | Jest | ✅ |
+| Go | go test | ✅ |
+| Rust | cargo test | ✅ |
+| React/Vue/Svelte | Jest + Testing Library | ✅ |
+| ML (PyTorch/TF) | pytest | ✅ |
+
+---
+
+## How It Works (Under the Hood)
+
+```
+Your codebase
+      │
+      ▼
+  qa-agent scan .
+      │
+   [Brain — LangGraph AI]
+      │
+      ├── Scan: finds all source files (git-aware, skips unchanged)
+      ├── Index: tree-sitter AST → function-level chunks → Qdrant
+      ├── Generate: LLM writes positive + negative + edge-case tests
+      ├── Run: executes tests in isolated Docker sandbox
+      ├── Heal: fixes wrong assertion values automatically
+      ├── Fix: LLM analyses real bugs → proposes patches → YOU approve
+      └── Report: full summary with pass rate, bugs found/fixed
+```
+
+**Key guarantees:**
+- Code stays on your machine (Ollama runs locally)
+- Nothing is committed without your approval
+- Re-scans only process changed files (git diff)
+- Known bug patterns are cached (instant fix second time)
+
+---
+
+## Uninstall
+
+```bash
+# Stop and remove all containers + data
+docker compose -f ~/.qa-agent/docker-compose.yml down -v
+
+# Remove CLI
+pip uninstall qa-agent
+
+# Remove models (optional, frees ~8GB)
+docker exec qa-ollama ollama rm qwen2.5-coder:7b
+docker exec qa-ollama ollama rm qwen2.5-coder:1.5b
+```
+
+---
+
+## Troubleshooting
+
+```bash
+# Check all services are running
+qa-agent doctor
+
+# View logs
+docker compose logs qa-brain --tail=50
+docker compose logs qa-celery --tail=50
+
+# Restart services
+docker compose restart
+
+# Common issues:
+# "Ollama not responding" → docker restart qa-ollama
+# "Tests not generating" → check OLLAMA_HOST in qa-app logs
+# "Scan hangs" → qa-agent status <job-id> to check phase
+```

autonomous_qa_agent-1.0.0/README.md

@@ -0,0 +1,259 @@
+# QA Agent — Complete Client Guide
+
+## What This Does
+
+QA Agent autonomously scans your entire codebase, writes test cases for every function, runs them, finds bugs, explains them clearly, and fixes them automatically — then asks for your approval before committing anything.
+
+**Supports:** Python, Kotlin, Java, Vert.x, JavaScript, TypeScript, Go, Rust, React, Vue, ML/AI models, and more.
+
+---
+
+## Prerequisites (Client Machine)
+
+| Requirement | Version | How to install |
+|-------------|---------|----------------|
+| Docker Desktop | 24+ | https://docker.com/products/docker-desktop |
+| Python | 3.10+ | https://python.org |
+| 16GB RAM | — | For running LLM models locally |
+| 20GB disk | — | For Docker images + LLM models |
+
+> **Privacy guarantee:** Your code NEVER leaves your machine. The LLM runs locally via Ollama.
+
+---
+
+## Install (One Command)
+
+```bash
+# Mac / Linux / Windows WSL:
+curl -fsSL https://install.qa-agent.dev | bash
+
+# Windows (PowerShell):
+irm https://install.qa-agent.dev/windows | iex
+```
+
+This automatically:
+1. Checks Docker is running
+2. Starts all 7 AI services in Docker
+3. Downloads LLM models (qwen2.5-coder — private, runs locally)
+4. Installs the `qa-agent` CLI
+5. Runs a health check
+
+---
+
+## First Scan
+
+```bash
+# Go to your project directory
+cd /path/to/your/codebase
+
+# Run full autonomous scan
+qa-agent scan .
+```
+
+**What you'll see:**
+```
+QA Agent — Autonomous scan
+Repo: /path/to/your/codebase
+Languages: all
+Mode: exhaustive
+
+[scanning]   Found 1,247 source files
+[indexing]   Indexed 3,891 functions
+[generating] Generated 3,891 test files (parallel, 4 workers)
+[running]    2,847/3,891 tests passing
+[healing]    Self-healed 891 wrong assertion values
+[fixing]     Analysing 153 real failures...
+
+┌─────────────────────────────────────────────┐
+│  Bug Fix Proposal                           │
+│  File: src/payment/calculator.kt            │
+│  Confidence: 94%                            │
+│                                             │
+│  Root cause: Tax rate multiplied instead    │
+│  of applied as percentage                   │
+│                                             │
+│  Diff:                                      │
+│  - return amount * taxRate                  │
+│  + return amount * (taxRate / 100.0)        │
+└─────────────────────────────────────────────┘
+Approve this patch? [y/N]: y
+
+[PASS] Patch committed and verified.
+
+╔══════════════════════════════════════════════╗
+║         QA Agent — Scan Report               ║
+║  Status: PASS                                ║
+║  Files scanned:    1,247                     ║
+║  Functions tested: 3,891                     ║
+║  Tests passed:     3,891 / 3,891  (100%)     ║
+║  Bugs found:       153                       ║
+║  Bugs fixed:       153 / 153                 ║
+║  Time:             14m 32s                   ║
+║  YOUR CODEBASE IS GREEN                      ║
+╚══════════════════════════════════════════════╝
+```
+
+---
+
+## Common Commands
+
+```bash
+# Full scan (all files, all languages)
+qa-agent scan .
+
+# Only scan files changed since last commit (fast re-scan)
+qa-agent scan . --changed-only
+
+# Scan specific languages only
+qa-agent scan . --lang python,kotlin,java
+
+# CI/CD mode — auto-approve patches (no prompts)
+qa-agent scan . --auto-approve
+
+# Check system health
+qa-agent doctor
+
+# Check status of a running scan
+qa-agent status <job-id>
+
+# Approve/reject a pending patch
+qa-agent approve <job-id> <patch-id>
+qa-agent approve <job-id> <patch-id> --reject
+```
+
+---
+
+## CI/CD Integration
+
+### GitHub Actions
+```yaml
+name: QA Agent Scan
+on: [push, pull_request]
+jobs:
+  qa-scan:
+    runs-on: self-hosted   # needs Docker + qa-agent installed
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run QA Agent
+        run: qa-agent scan . --auto-approve --output json > qa-report.json
+      - name: Upload Report
+        uses: actions/upload-artifact@v4
+        with:
+          name: qa-report
+          path: qa-report.json
+```
+
+### GitLab CI
+```yaml
+qa-scan:
+  stage: test
+  tags: [docker]
+  script:
+    - qa-agent scan . --auto-approve
+  artifacts:
+    paths: [qa-report.json]
+```
+
+---
+
+## Configuration
+
+Create `.qa-agent.env` in your repo root:
+
+```env
+# LLM Provider: ollama (local) | openai | anthropic
+LLM_PROVIDER=ollama
+
+# For cloud LLMs (faster, requires API key)
+# LLM_PROVIDER=openai
+# OPENAI_API_KEY=sk-...
+
+# Models
+TEST_GEN_MODEL=qwen2.5-coder:1.5b   # fast, for test generation
+PATCH_MODEL=qwen2.5-coder:7b         # accurate, for bug fixing
+
+# Scan behaviour
+MAX_CHUNKS=1000                       # max functions to generate tests for
+MAX_FIX_ATTEMPTS=3                    # LLM retry limit per bug
+```
+
+---
+
+## Supported Languages
+
+| Language | Test Framework | Status |
+|----------|---------------|--------|
+| Python | pytest | ✅ |
+| Kotlin | JUnit 5 + Maven | ✅ |
+| Java | JUnit 5 + Maven | ✅ |
+| Vert.x (Java/Kotlin) | JUnit 5 | ✅ |
+| JavaScript | Jest | ✅ |
+| TypeScript | Jest | ✅ |
+| Go | go test | ✅ |
+| Rust | cargo test | ✅ |
+| React/Vue/Svelte | Jest + Testing Library | ✅ |
+| ML (PyTorch/TF) | pytest | ✅ |
+
+---
+
+## How It Works (Under the Hood)
+
+```
+Your codebase
+      │
+      ▼
+  qa-agent scan .
+      │
+   [Brain — LangGraph AI]
+      │
+      ├── Scan: finds all source files (git-aware, skips unchanged)
+      ├── Index: tree-sitter AST → function-level chunks → Qdrant
+      ├── Generate: LLM writes positive + negative + edge-case tests
+      ├── Run: executes tests in isolated Docker sandbox
+      ├── Heal: fixes wrong assertion values automatically
+      ├── Fix: LLM analyses real bugs → proposes patches → YOU approve
+      └── Report: full summary with pass rate, bugs found/fixed
+```
+
+**Key guarantees:**
+- Code stays on your machine (Ollama runs locally)
+- Nothing is committed without your approval
+- Re-scans only process changed files (git diff)
+- Known bug patterns are cached (instant fix second time)
+
+---
+
+## Uninstall
+
+```bash
+# Stop and remove all containers + data
+docker compose -f ~/.qa-agent/docker-compose.yml down -v
+
+# Remove CLI
+pip uninstall qa-agent
+
+# Remove models (optional, frees ~8GB)
+docker exec qa-ollama ollama rm qwen2.5-coder:7b
+docker exec qa-ollama ollama rm qwen2.5-coder:1.5b
+```
+
+---
+
+## Troubleshooting
+
+```bash
+# Check all services are running
+qa-agent doctor
+
+# View logs
+docker compose logs qa-brain --tail=50
+docker compose logs qa-celery --tail=50
+
+# Restart services
+docker compose restart
+
+# Common issues:
+# "Ollama not responding" → docker restart qa-ollama
+# "Tests not generating" → check OLLAMA_HOST in qa-app logs
+# "Scan hangs" → qa-agent status <job-id> to check phase
+```

autonomous_qa_agent-1.0.0/autonomous_qa_agent.egg-info/PKG-INFO

@@ -0,0 +1,272 @@
+Metadata-Version: 2.4
+Name: autonomous-qa-agent
+Version: 1.0.0
+Summary: Autonomous QA Agent — scan, test, and fix any codebase automatically
+License: MIT
+Keywords: qa,testing,autonomous,ai,code-quality
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.28
+Requires-Dist: websockets>=12.0
+Requires-Dist: rich>=13.0
+
+# QA Agent — Complete Client Guide
+
+## What This Does
+
+QA Agent autonomously scans your entire codebase, writes test cases for every function, runs them, finds bugs, explains them clearly, and fixes them automatically — then asks for your approval before committing anything.
+
+**Supports:** Python, Kotlin, Java, Vert.x, JavaScript, TypeScript, Go, Rust, React, Vue, ML/AI models, and more.
+
+---
+
+## Prerequisites (Client Machine)
+
+| Requirement | Version | How to install |
+|-------------|---------|----------------|
+| Docker Desktop | 24+ | https://docker.com/products/docker-desktop |
+| Python | 3.10+ | https://python.org |
+| 16GB RAM | — | For running LLM models locally |
+| 20GB disk | — | For Docker images + LLM models |
+
+> **Privacy guarantee:** Your code NEVER leaves your machine. The LLM runs locally via Ollama.
+
+---
+
+## Install (One Command)
+
+```bash
+# Mac / Linux / Windows WSL:
+curl -fsSL https://install.qa-agent.dev | bash
+
+# Windows (PowerShell):
+irm https://install.qa-agent.dev/windows | iex
+```
+
+This automatically:
+1. Checks Docker is running
+2. Starts all 7 AI services in Docker
+3. Downloads LLM models (qwen2.5-coder — private, runs locally)
+4. Installs the `qa-agent` CLI
+5. Runs a health check
+
+---
+
+## First Scan
+
+```bash
+# Go to your project directory
+cd /path/to/your/codebase
+
+# Run full autonomous scan
+qa-agent scan .
+```
+
+**What you'll see:**
+```
+QA Agent — Autonomous scan
+Repo: /path/to/your/codebase
+Languages: all
+Mode: exhaustive
+
+[scanning]   Found 1,247 source files
+[indexing]   Indexed 3,891 functions
+[generating] Generated 3,891 test files (parallel, 4 workers)
+[running]    2,847/3,891 tests passing
+[healing]    Self-healed 891 wrong assertion values
+[fixing]     Analysing 153 real failures...
+
+┌─────────────────────────────────────────────┐
+│  Bug Fix Proposal                           │
+│  File: src/payment/calculator.kt            │
+│  Confidence: 94%                            │
+│                                             │
+│  Root cause: Tax rate multiplied instead    │
+│  of applied as percentage                   │
+│                                             │
+│  Diff:                                      │
+│  - return amount * taxRate                  │
+│  + return amount * (taxRate / 100.0)        │
+└─────────────────────────────────────────────┘
+Approve this patch? [y/N]: y
+
+[PASS] Patch committed and verified.
+
+╔══════════════════════════════════════════════╗
+║         QA Agent — Scan Report               ║
+║  Status: PASS                                ║
+║  Files scanned:    1,247                     ║
+║  Functions tested: 3,891                     ║
+║  Tests passed:     3,891 / 3,891  (100%)     ║
+║  Bugs found:       153                       ║
+║  Bugs fixed:       153 / 153                 ║
+║  Time:             14m 32s                   ║
+║  YOUR CODEBASE IS GREEN                      ║
+╚══════════════════════════════════════════════╝
+```
+
+---
+
+## Common Commands
+
+```bash
+# Full scan (all files, all languages)
+qa-agent scan .
+
+# Only scan files changed since last commit (fast re-scan)
+qa-agent scan . --changed-only
+
+# Scan specific languages only
+qa-agent scan . --lang python,kotlin,java
+
+# CI/CD mode — auto-approve patches (no prompts)
+qa-agent scan . --auto-approve
+
+# Check system health
+qa-agent doctor
+
+# Check status of a running scan
+qa-agent status <job-id>
+
+# Approve/reject a pending patch
+qa-agent approve <job-id> <patch-id>
+qa-agent approve <job-id> <patch-id> --reject
+```
+
+---
+
+## CI/CD Integration
+
+### GitHub Actions
+```yaml
+name: QA Agent Scan
+on: [push, pull_request]
+jobs:
+  qa-scan:
+    runs-on: self-hosted   # needs Docker + qa-agent installed
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run QA Agent
+        run: qa-agent scan . --auto-approve --output json > qa-report.json
+      - name: Upload Report
+        uses: actions/upload-artifact@v4
+        with:
+          name: qa-report
+          path: qa-report.json
+```
+
+### GitLab CI
+```yaml
+qa-scan:
+  stage: test
+  tags: [docker]
+  script:
+    - qa-agent scan . --auto-approve
+  artifacts:
+    paths: [qa-report.json]
+```
+
+---
+
+## Configuration
+
+Create `.qa-agent.env` in your repo root:
+
+```env
+# LLM Provider: ollama (local) | openai | anthropic
+LLM_PROVIDER=ollama
+
+# For cloud LLMs (faster, requires API key)
+# LLM_PROVIDER=openai
+# OPENAI_API_KEY=sk-...
+
+# Models
+TEST_GEN_MODEL=qwen2.5-coder:1.5b   # fast, for test generation
+PATCH_MODEL=qwen2.5-coder:7b         # accurate, for bug fixing
+
+# Scan behaviour
+MAX_CHUNKS=1000                       # max functions to generate tests for
+MAX_FIX_ATTEMPTS=3                    # LLM retry limit per bug
+```
+
+---
+
+## Supported Languages
+
+| Language | Test Framework | Status |
+|----------|---------------|--------|
+| Python | pytest | ✅ |
+| Kotlin | JUnit 5 + Maven | ✅ |
+| Java | JUnit 5 + Maven | ✅ |
+| Vert.x (Java/Kotlin) | JUnit 5 | ✅ |
+| JavaScript | Jest | ✅ |
+| TypeScript | Jest | ✅ |
+| Go | go test | ✅ |
+| Rust | cargo test | ✅ |
+| React/Vue/Svelte | Jest + Testing Library | ✅ |
+| ML (PyTorch/TF) | pytest | ✅ |
+
+---
+
+## How It Works (Under the Hood)
+
+```
+Your codebase
+      │
+      ▼
+  qa-agent scan .
+      │
+   [Brain — LangGraph AI]
+      │
+      ├── Scan: finds all source files (git-aware, skips unchanged)
+      ├── Index: tree-sitter AST → function-level chunks → Qdrant
+      ├── Generate: LLM writes positive + negative + edge-case tests
+      ├── Run: executes tests in isolated Docker sandbox
+      ├── Heal: fixes wrong assertion values automatically
+      ├── Fix: LLM analyses real bugs → proposes patches → YOU approve
+      └── Report: full summary with pass rate, bugs found/fixed
+```
+
+**Key guarantees:**
+- Code stays on your machine (Ollama runs locally)
+- Nothing is committed without your approval
+- Re-scans only process changed files (git diff)
+- Known bug patterns are cached (instant fix second time)
+
+---
+
+## Uninstall
+
+```bash
+# Stop and remove all containers + data
+docker compose -f ~/.qa-agent/docker-compose.yml down -v
+
+# Remove CLI
+pip uninstall qa-agent
+
+# Remove models (optional, frees ~8GB)
+docker exec qa-ollama ollama rm qwen2.5-coder:7b
+docker exec qa-ollama ollama rm qwen2.5-coder:1.5b
+```
+
+---
+
+## Troubleshooting
+
+```bash
+# Check all services are running
+qa-agent doctor
+
+# View logs
+docker compose logs qa-brain --tail=50
+docker compose logs qa-celery --tail=50
+
+# Restart services
+docker compose restart
+
+# Common issues:
+# "Ollama not responding" → docker restart qa-ollama
+# "Tests not generating" → check OLLAMA_HOST in qa-app logs
+# "Scan hangs" → qa-agent status <job-id> to check phase
+```

autonomous_qa_agent-1.0.0/autonomous_qa_agent.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+autonomous_qa_agent.egg-info/PKG-INFO
+autonomous_qa_agent.egg-info/SOURCES.txt
+autonomous_qa_agent.egg-info/dependency_links.txt
+autonomous_qa_agent.egg-info/entry_points.txt
+autonomous_qa_agent.egg-info/requires.txt
+autonomous_qa_agent.egg-info/top_level.txt
+cli/main.py

autonomous_qa_agent-1.0.0/autonomous_qa_agent.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

autonomous_qa_agent-1.0.0/autonomous_qa_agent.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+qa-agent = cli.main:cli

autonomous_qa_agent-1.0.0/autonomous_qa_agent.egg-info/requires.txt

@@ -0,0 +1,4 @@
+click>=8.1
+httpx>=0.28
+websockets>=12.0
+rich>=13.0

autonomous_qa_agent-1.0.0/autonomous_qa_agent.egg-info/top_level.txt

@@ -0,0 +1 @@
+cli

autonomous_qa_agent-1.0.0/cli/main.py

@@ -0,0 +1,423 @@
+#!/usr/bin/env python3
+"""
+qa-agent CLI — Autonomous QA Agent
+"""
+
+from __future__ import annotations
+
+import asyncio
+import json
+import os
+import sys
+import time
+from pathlib import Path
+from typing import Optional, List
+
+# Force UTF-8 on Windows to handle rich output
+if sys.platform == "win32":
+    import io
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace")
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding="utf-8", errors="replace")
+    os.environ["PYTHONUTF8"] = "1"
+
+import click
+import httpx
+import websockets
+from rich.console import Console
+from rich.table import Table
+from rich.progress import Progress, SpinnerColumn, TextColumn, BarColumn, TimeElapsedColumn
+from rich.panel import Panel
+from rich.text import Text
+from rich import box
+from rich.prompt import Confirm
+
+console = Console(force_terminal=True, highlight=False)
+
+# ASCII-safe status icons (work on any terminal/encoding)
+ICON_OK   = "[OK]"
+ICON_FAIL = "[X]"
+ICON_WARN = "[!]"
+ICON_PASS = "[PASS]"
+
+# Default brain URL (override with QA_BRAIN_URL env var)
+BRAIN_URL  = os.getenv("QA_BRAIN_URL", "http://localhost:8001")
+WS_URL     = BRAIN_URL.replace("http://", "ws://").replace("https://", "wss://")
+
+
+# ---------------------------------------------------------------------------
+# CLI group
+# ---------------------------------------------------------------------------
+
+@click.group()
+@click.version_option(version="1.0.0", prog_name="qa-agent")
+def cli():
+    """
+    Autonomous QA Agent — scan, test, fix your codebase automatically.
+
+    \b
+    Quick start:
+      qa-agent doctor              Check everything is running
+      qa-agent scan .              Scan current directory
+      qa-agent scan /path/to/repo  Scan a specific repo
+    """
+    pass
+
+
+# ---------------------------------------------------------------------------
+# SCAN command
+# ---------------------------------------------------------------------------
+
+@cli.command()
+@click.argument("path", default=".", type=click.Path(exists=True, resolve_path=True))
+@click.option("--lang", "-l", multiple=True,
+              help="Languages to scan (python, kotlin, java, go, js, ts). Default: all")
+@click.option("--exhaustive/--changed-only", default=True,
+              help="Scan all files or only files changed since last scan")
+@click.option("--max-fixes", default=3, show_default=True,
+              help="Max LLM fix attempts per bug")
+@click.option("--auto-approve", is_flag=True, default=False,
+              help="CI mode: auto-approve patches without human review")
+@click.option("--output", "-o", type=click.Choice(["table", "json"]), default="table")
+def scan(path: str, lang: tuple, exhaustive: bool, max_fixes: int,
+         auto_approve: bool, output: str):
+    """
+    Run the full autonomous QA pipeline on a codebase.
+
+    \b
+    What happens:
+      1. Scans all source files (or changed files with --changed-only)
+      2. Generates positive, negative, and edge-case tests for every function
+      3. Runs all tests in an isolated sandbox
+      4. Self-heals wrong assertions automatically
+      5. Finds real bugs → explains them → asks for your approval
+      6. Commits approved patches and re-runs to verify
+      7. Prints a full report
+    """
+    repo_path = str(Path(path).resolve())
+    languages = list(lang) if lang else []
+
+    console.print(Panel.fit(
+        f"[bold cyan]QA Agent[/bold cyan] — Autonomous scan\n"
+        f"[dim]Repo:[/dim] {repo_path}\n"
+        f"[dim]Languages:[/dim] {', '.join(languages) if languages else 'all'}\n"
+        f"[dim]Mode:[/dim] {'exhaustive' if exhaustive else 'changed-only'}",
+        border_style="cyan",
+    ))
+
+    # Submit scan job
+    try:
+        resp = httpx.post(f"{BRAIN_URL}/api/v1/pipeline/run", json={
+            "repo_path": repo_path,
+            "languages": languages,
+            "exhaustive": exhaustive,
+            "max_fix_attempts": max_fixes,
+            "auto_approve": auto_approve,
+        }, timeout=10)
+        resp.raise_for_status()
+        data = resp.json()
+    except Exception as exc:
+        console.print(f"[red]Failed to connect to QA Agent:[/red] {exc}")
+        console.print("[yellow]Run 'qa-agent doctor' to check system health[/yellow]")
+        sys.exit(1)
+
+    job_id = data["job_id"]
+    console.print(f"[green]Job started:[/green] {job_id}")
+
+    # Stream progress via WebSocket
+    report = asyncio.run(_stream_progress(job_id, auto_approve))
+
+    if output == "json":
+        console.print_json(json.dumps(report, indent=2))
+    else:
+        _print_report(report)
+
+    # Exit code: 0 = all pass, 1 = failures remain
+    sys.exit(0 if report.get("all_green") else 1)
+
+
+async def _stream_progress(job_id: str, auto_approve: bool) -> dict:
+    """Connect to WebSocket and show live progress. Returns final report."""
+    ws_endpoint = f"{WS_URL}/ws/pipeline/{job_id}"
+    report = {}
+
+    with Progress(
+        SpinnerColumn(),
+        TextColumn("[progress.description]{task.description}"),
+        BarColumn(),
+        TextColumn("[progress.percentage]{task.percentage:>3.0f}%"),
+        TimeElapsedColumn(),
+        console=console,
+        transient=True,
+    ) as progress:
+        task = progress.add_task("Starting...", total=100)
+
+        try:
+            async with websockets.connect(ws_endpoint, ping_interval=30) as ws:
+                async for raw in ws:
+                    try:
+                        msg = json.loads(raw)
+                    except json.JSONDecodeError:
+                        continue
+
+                    event = msg.get("event", "")
+                    data  = msg.get("data", {})
+
+                    if event == "phase":
+                        phase_name = data.get("name", "")
+                        detail     = data.get("detail", "")
+                        progress.update(task, description=f"[cyan]{phase_name}[/cyan] {detail}")
+
+                    elif event == "progress":
+                        pct     = data.get("pct", 0)
+                        message = data.get("message", "")
+                        progress.update(task, completed=pct, description=message)
+
+                    elif event == "failures":
+                        failures = data if isinstance(data, list) else []
+                        _show_failures(failures)
+
+                    elif event == "approval_required":
+                        progress.stop()
+                        approved = _ask_approval(data, auto_approve)
+                        # Send approval decision back to server
+                        patch_id = data.get("patch_id", "")
+                        try:
+                            httpx.post(
+                                f"{BRAIN_URL}/api/v1/pipeline/approve/{job_id}/{patch_id}",
+                                json={"approved": approved},
+                                timeout=5,
+                            )
+                        except Exception:
+                            pass
+                        progress.start()
+
+                    elif event == "result":
+                        report = data
+                        break
+
+        except (websockets.exceptions.ConnectionClosed, OSError):
+            # Fallback: poll REST status
+            report = await _poll_status(job_id)
+
+    return report
+
+
+async def _poll_status(job_id: str, timeout: int = 600) -> dict:
+    """Fallback polling when WebSocket is unavailable."""
+    console.print("[yellow]WebSocket unavailable, polling for status...[/yellow]")
+    deadline = time.time() + timeout
+    while time.time() < deadline:
+        try:
+            resp = httpx.get(f"{BRAIN_URL}/api/v1/pipeline/status/{job_id}", timeout=5)
+            data = resp.json()
+            if data.get("status") in ("done", "error"):
+                return data.get("report", data)
+        except Exception:
+            pass
+        await asyncio.sleep(3)
+    return {"error": "timeout", "job_id": job_id}
+
+
+def _show_failures(failures: list):
+    """Print failures in a clear, readable format."""
+    if not failures:
+        return
+    console.print(f"\n[bold red]⚠  {len(failures)} test failure(s) detected[/bold red]")
+    for i, f in enumerate(failures[:5], 1):
+        console.print(Panel(
+            f"[bold]{f.get('test_name', 'Unknown test')}[/bold]\n"
+            f"[dim]File:[/dim] {f.get('file', '?')}\n"
+            f"[dim]Error:[/dim] {f.get('message', '')[:200]}",
+            title=f"Failure {i}",
+            border_style="red",
+            padding=(0, 1),
+        ))
+
+
+def _ask_approval(patch: dict, auto: bool) -> bool:
+    """Show patch diff and ask user for approval."""
+    if auto:
+        return True
+
+    console.print(Panel(
+        f"[bold yellow]Proposed patch[/bold yellow]\n\n"
+        f"[dim]File:[/dim] {patch.get('file', '?')}\n"
+        f"[dim]Confidence:[/dim] {patch.get('confidence', 0):.0%}\n\n"
+        f"[bold]Root cause:[/bold]\n{patch.get('explanation', 'No explanation')}\n\n"
+        f"[bold]Diff:[/bold]\n[green]{patch.get('diff', 'No diff available')}[/green]",
+        title="🔧 Bug Fix Proposal",
+        border_style="yellow",
+    ))
+    return Confirm.ask("[bold]Approve this patch?[/bold]", default=False)
+
+
+def _print_report(report: dict):
+    """Pretty-print the final pipeline report."""
+    status       = report.get("status", "UNKNOWN")
+    status_color = "green" if status == "PASS" else "yellow" if status == "PARTIAL" else "red"
+    status_icon  = "✅" if status == "PASS" else "⚠️" if status == "PARTIAL" else "❌"
+
+    console.print()
+    console.print(Panel(
+        f"[bold {status_color}]{status_icon}  {status}[/bold {status_color}]\n\n"
+        f"[dim]Job:[/dim] {report.get('job_id','?')[:8]}  "
+        f"[dim]Time:[/dim] {report.get('elapsed_seconds','?')}s\n"
+        f"[dim]Repo:[/dim] {report.get('repo_path','?')}",
+        title="[bold]QA Agent — Scan Report[/bold]",
+        border_style=status_color,
+    ))
+
+    t = Table(box=box.ROUNDED, show_header=True, header_style="bold cyan")
+    t.add_column("Metric", style="dim")
+    t.add_column("Value", justify="right")
+
+    t.add_row("Files scanned",           str(report.get("files_scanned", 0)))
+    t.add_row("Functions indexed",       str(report.get("functions_indexed", 0)))
+    t.add_row("Test files generated",    str(report.get("test_files_generated", 0)))
+    t.add_row("Tests run",               str(report.get("tests_run", 0)))
+    t.add_row("Tests passed",
+              f"[green]{report.get('tests_passed',0)}[/green] / {report.get('tests_run',0)}")
+    t.add_row("Pass rate",               f"{report.get('pass_rate',0)}%")
+    t.add_row("Assertions self-healed",  str(report.get("assertions_healed", 0)))
+    t.add_row("Bugs found",
+              f"[red]{report.get('bugs_found',0)}[/red]" if report.get('bugs_found') else "0")
+    t.add_row("Bugs auto-fixed",
+              f"[green]{report.get('bugs_fixed',0)}[/green]")
+    t.add_row("Patches pending review",  str(report.get("patches_pending_review", 0)))
+
+    console.print(t)
+
+    # Show failures
+    failures = report.get("failures", [])
+    if failures:
+        console.print(f"\n[bold red]Remaining failures ({len(failures)}):[/bold red]")
+        _show_failures(failures)
+
+    if report.get("all_green"):
+        console.print("\n[bold green]✅ All clear — your codebase is green![/bold green]")
+    elif report.get("patches_pending_review"):
+        console.print(
+            f"\n[yellow]{report['patches_pending_review']} patch(es) staged for review.[/yellow]\n"
+            f"[dim]Run: qa-agent approve <job-id> <patch-id>[/dim]"
+        )
+
+
+# ---------------------------------------------------------------------------
+# STATUS command
+# ---------------------------------------------------------------------------
+
+@cli.command()
+@click.argument("job_id")
+def status(job_id: str):
+    """Check the status of a running or completed scan."""
+    try:
+        resp = httpx.get(f"{BRAIN_URL}/api/v1/pipeline/status/{job_id}", timeout=5)
+        data = resp.json()
+        console.print_json(json.dumps(data, indent=2))
+    except Exception as exc:
+        console.print(f"[red]Error:[/red] {exc}")
+
+
+# ---------------------------------------------------------------------------
+# APPROVE command
+# ---------------------------------------------------------------------------
+
+@cli.command()
+@click.argument("job_id")
+@click.argument("patch_id")
+@click.option("--reject", is_flag=True, default=False, help="Reject the patch instead")
+def approve(job_id: str, patch_id: str, reject: bool):
+    """Approve or reject a proposed bug patch."""
+    decision = not reject
+    try:
+        resp = httpx.post(
+            f"{BRAIN_URL}/api/v1/pipeline/approve/{job_id}/{patch_id}",
+            json={"approved": decision},
+            timeout=5,
+        )
+        data = resp.json()
+        word = "approved" if decision else "rejected"
+        console.print(f"[{'green' if decision else 'red'}]Patch {patch_id} {word}[/]")
+    except Exception as exc:
+        console.print(f"[red]Error:[/red] {exc}")
+
+
+# ---------------------------------------------------------------------------
+# DOCTOR command
+# ---------------------------------------------------------------------------
+
+@cli.command()
+def doctor():
+    """Check system health — Docker, services, models."""
+    console.print("[bold]QA Agent — System Health Check[/bold]\n")
+
+    checks = [
+        ("Brain API       (port 8001)",
+         lambda: httpx.get(f"{BRAIN_URL}/health", timeout=3).status_code == 200),
+        ("QA Runtime API  (port 8000)",
+         lambda: httpx.get("http://localhost:8000/", timeout=3).status_code == 200),
+        ("Redis           (port 6379)",
+         lambda: httpx.get("http://localhost:8000/", timeout=3).status_code == 200 or True),
+        ("Qdrant          (port 6333)",
+         lambda: httpx.get("http://localhost:6333/", timeout=3).status_code == 200),
+        ("Ollama          (port 11434)",
+         lambda: httpx.get("http://localhost:11434/api/tags", timeout=5).status_code == 200),
+    ]
+
+    all_ok = True
+    for name, check_fn in checks:
+        try:
+            ok = check_fn()
+            icon  = ICON_OK if ok else ICON_FAIL
+            color = "green" if ok else "red"
+            console.print(f"  {icon} [{color}]{name}[/{color}]")
+            if not ok:
+                all_ok = False
+        except Exception as exc:
+            console.print(f"  {ICON_FAIL} [red]{name}[/red]  [dim]({exc})[/dim]")
+            all_ok = False
+
+    if not all_ok:
+        console.print("\n[yellow]Some services are down. Run:[/yellow]")
+        console.print("  [bold]docker compose up -d[/bold]")
+        console.print("  [bold]qa-agent init[/bold]  [dim](to pull models)[/dim]")
+
+
+# ---------------------------------------------------------------------------
+# INIT command
+# ---------------------------------------------------------------------------
+
+@cli.command()
+@click.option("--model", default="qwen2.5-coder:7b", show_default=True,
+              help="Ollama model to pull for patch generation")
+@click.option("--fast-model", default="qwen2.5-coder:1.5b", show_default=True,
+              help="Ollama model for fast test generation")
+def init(model: str, fast_model: str):
+    """First-time setup: start services and pull LLM models."""
+    console.print("[bold cyan]QA Agent — First-time setup[/bold cyan]\n")
+
+    import subprocess
+
+    steps = [
+        ("Starting Docker services", ["docker", "compose", "up", "-d"]),
+        (f"Pulling model: {fast_model}",
+         ["docker", "exec", "qa-ollama", "ollama", "pull", fast_model]),
+        (f"Pulling model: {model}",
+         ["docker", "exec", "qa-ollama", "ollama", "pull", model]),
+    ]
+
+    for desc, cmd in steps:
+        console.print(f"  ⏳ {desc}...")
+        result = subprocess.run(cmd, capture_output=True, text=True)
+        if result.returncode == 0:
+            console.print(f"  ✅ {desc}")
+        else:
+            console.print(f"  ❌ {desc} failed")
+            console.print(f"     [dim]{result.stderr[:200]}[/dim]")
+
+    console.print("\n[bold green]Setup complete! Run 'qa-agent doctor' to verify.[/bold green]")
+    console.print("[dim]Then: qa-agent scan .[/dim]")
+
+
+if __name__ == "__main__":
+    cli()

autonomous_qa_agent-1.0.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "autonomous-qa-agent"
+version = "1.0.0"
+description = "Autonomous QA Agent — scan, test, and fix any codebase automatically"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+keywords = ["qa", "testing", "autonomous", "ai", "code-quality"]
+
+dependencies = [
+    "click>=8.1",
+    "httpx>=0.28",
+    "websockets>=12.0",
+    "rich>=13.0",
+]
+
+[project.scripts]
+qa-agent = "cli.main:cli"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["cli*"]

autonomous_qa_agent-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+