Metadata-Version: 2.4
Name: qvc-overseer
Version: 0.6.1
Summary: QVC - AI Agent code quality external overseer. Review only, never modify.
Project-URL: Homepage, https://github.com/qvc-overseer/qvc
Project-URL: Repository, https://github.com/qvc-overseer/qvc
Author: QVC Team
License: MIT
Keywords: ai-agent,bug-detection,code-review,quality-assurance,static-analysis
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# QVC — QA of Vebe Coding

<p align="center">
  <img src="https://img.shields.io/badge/version-0.6.1-blue" alt="version">
  <img src="https://img.shields.io/badge/python-3.11+-green" alt="python">
  <img src="https://img.shields.io/badge/license-MIT-brightgreen" alt="license">
  <img src="https://img.shields.io/badge/tests-42%2F45%20passing-success" alt="tests">
  <img src="https://img.shields.io/badge/rules-21-orange" alt="rules">
  <img src="https://img.shields.io/badge/languages-6-purple" alt="languages">
</p>

<p align="center">
  <b>The external overseer for AI-generated code.</b><br>
  Finds what your AI Agent missed in its own review.<br>
  <b>Never modifies a single line.</b>
</p>

```bash
pip install qvc && qvc setup && qvc scan .
```

---

## What makes QVC different

| Tool | Perspective | AI Blind Spots | Modifies Code |
|------|------------|---------------|---------------|
| ESLint / Pylint | Rules | No | Sometimes |
| SonarQube / CodeQL | Enterprise SAST | No | No |
| AI Self-Review | Internal (blind) | No | Yes |
| **QVC** | **External overseer** | **Yes** | **Never** |

> When an AI Agent writes code and reviews it, it follows the **same mental path** both times.
> QVC comes from **outside that loop** — it sees what the Agent cannot.

---

## Quick Demo

```
$ pip install qvc
$ qvc setup
$ qvc scan .

Scanning: ai-corp V7.1
Found 120 files, 19,705 lines
Static analysis... [====================] 100%

Report: qvc-report.md
Done! 1.0s, 2 bugs

[AHA] Your AI cannot see these:
  [90%] API signature mismatch (context loss blind spot)
  [85%] Silenced exception (boundary condition blind spot)

  AI missed rate: 67%
  Tasks: 2 -> .qvc/tasks/pending.md
  Say 'fix qvc tasks' to your AI.
```

---

## Features

### External Overseer Perspective
- **Blind spot classifier**: Memory residue, context loss, self-review gaps
- **Self-review miss rate**: Quantifies what your AI Agent missed
- **Cross-file consistency**: Catches drift across multi-file AI generations

### AI-Native Task Pool (V6)
- Scan results auto-converted to AI-consumable tasks
- Your AI Agent reads `.qvc/tasks/pending.md` and fixes issues
- You just say: **"fix qvc tasks"**

### Self-Evolving Gene Pool
- 50 seed fingerprints from CWE Top 25
- Learns from every scan — grows smarter locally
- Community gene pool sync (optional, git-free fallback)

### Works Everywhere
- **Zero config**: No API keys, no GitHub, no setup
- **Offline-first**: Core scanning fully offline
- **6 languages**: Python, JavaScript, TypeScript, React, Go, Universal
- **Any AI Agent**: Codex, Cursor, GPT, Claude

### Production Ready
- 99.8% noise reduction: 2,000+ candidates -> 2-5 actionable issues
- 42/45 tests passing, self-scan verified (0 real bugs)
- 4 output formats: Markdown, JSON, SARIF, AI Fix Prompt
- VS Code extension + GitHub Actions included

---

## Installation

```bash
# One command
pip install qvc

# Or from source
git clone https://github.com/qvc-project/qvc.git
cd qvc && pip install -e .
```

### One-click installers
- Windows: Double-click `install.bat`
- Mac/Linux: `bash install.sh`

---

## Quick Start

```bash
qvc setup          # Initialize project (one time)
qvc scan .         # Full scan
qvc scan . --diff  # Scan changed files only
qvc watch .        # Auto-scan on file changes
```

Then say to your AI Agent: **"fix qvc tasks"**

---

## Documentation

| Document | For |
|----------|-----|
| [User Manual](docs/QVC_用户使用手册.md) | End users (Chinese) |
| [Project Report](docs/V6.1_完整项目报告.md) | Developers |
| [Business Pitch](docs/QVC_商业宣传报告.md) | Investors / Partners |
| [Contributing](CONTRIBUTING.md) | Open source contributors |

---

## vs Alternatives

| | QVC | ESLint | SonarQube | CodeQL |
|---|---|---|---|---|
| AI blind spot detection | Yes | No | No | No |
| Self-review gap analysis | Yes | No | No | No |
| AI Agent task integration | Yes | No | No | No |
| Zero config | Yes | Partial | No | No |
| Offline | Yes | Yes | No | No |
| Free / OSS | MIT | MIT | Paid | Open |
| Setup time | 0 min | 5 min | 1 hour | 30 min |

---

## QVC's self-scan

```
QVC V6.1 scanned itself:
  71 files / 7,875 lines / 0.5s
  Result: 0 real bugs found
  BOM: clean   Caches: clean   Log: clean
```

---

## License

MIT — Free forever. Use it, fork it, ship it.
