Metadata-Version: 2.4
Name: agentops-ai
Version: 0.2.0
Summary: AgentOps: Requirements-driven test automation for vibe coders
Author-email: Karthik Naig <agentops_info@protonmail.com>
Maintainer-email: Karthik Naig <agentops_info@protonmail.com>
License: MIT
Project-URL: Homepage, https://github.com/knaig/agentops_ai
Project-URL: Repository, https://github.com/knaig/agentops_ai
Project-URL: Documentation, https://github.com/knaig/agentops_ai/tree/main/docs
Project-URL: Issues, https://github.com/knaig/agentops_ai/issues
Keywords: testing,requirements,ai,automation,code-analysis
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: click>=8.1.3
Requires-Dist: rich>=13.3.5
Requires-Dist: openai>=1.0.0
Requires-Dist: python-dotenv>=1.1.0
Provides-Extra: dev
Requires-Dist: pytest>=8.3.5; extra == "dev"
Requires-Dist: pytest-json-report>=1.5.0; extra == "dev"
Requires-Dist: coverage>=7.8.2; extra == "dev"
Requires-Dist: pydoc-markdown>=4.7.0; extra == "dev"
Requires-Dist: mkdocs-material>=9.4.0; extra == "dev"
Requires-Dist: mkdocs>=1.5.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: pydocstyle>=6.3.0; extra == "dev"

# AgentOps

AI-powered QA co-pilot for vibe coders - Requirements-driven test automation.

## 🚀 Quick Start

```bash
# Install dependencies
poetry install

# Set up your OpenAI API key
export OPENAI_API_KEY="your-api-key-here"

# Try the demo
cd examples/demo-project
agentops init
agentops infer --all
agentops import-requirements
agentops generate-tests
agentops run --all
```

## 📁 Project Structure

```
AgentOps/
├── agentops_ai/              # Main package
│   ├── agentops_cli/         # Command-line interface
│   ├── agentops_core/        # Core business logic
│   ├── docs/                 # Documentation
│   ├── prompts/              # LLM prompt templates
│   └── .tours/               # CodeTour files
├── examples/                 # Example projects
│   └── demo-project/         # Demo project
├── .github/                  # CI/CD workflows
├── .private/                 # Internal documentation
└── docs/                     # Project documentation
```

## 🛠️ Development

### Prerequisites

- Python 3.11+
- Poetry
- OpenAI API key

### Setup

```bash
# Clone and install
git clone <repository-url>
cd AgentOps
poetry install

# Set environment variables
export OPENAI_API_KEY="your-api-key"
```

### Running Tests

```bash
# Run all tests
poetry run pytest

# Run with coverage
poetry run pytest --cov=agentops_ai

# Run linting
poetry run ruff check agentops_ai
poetry run black --check agentops_ai
```

### Documentation

```bash
# Start documentation server
cd agentops_ai/docs
poetry run mkdocs serve
```

## 📚 Documentation

- **[Quick Start Guide](agentops_ai/docs/QUICK_START.md)** - Get up and running
- **[Architecture Overview](agentops_ai/docs/ARCHITECTURE_OVERVIEW.md)** - System design
- **[API Reference](agentops_ai/docs/api/)** - Complete API docs
- **[Readiness Checklist](agentops_ai/docs/READINESS_CHECKLIST.md)** - Engineer onboarding

## 🎯 Core Workflow

AgentOps follows a simple **Infer → Approve → Test** workflow:

1. **Infer**: Extract requirements from code changes using LLM
2. **Approve**: Review and approve requirements (interactive or bulk)
3. **Test**: Generate and execute comprehensive test suites

## 🔧 CLI Commands

```bash
agentops init                    # Initialize project
agentops infer <file>            # Infer requirements from file
agentops infer --all             # Infer for all Python files
agentops import-requirements     # Import edited requirements
agentops generate-tests          # Generate tests from requirements
agentops run --all               # Run tests with RCA
agentops traceability            # Export traceability matrix
```

## 🏗️ Architecture

AgentOps uses a modular architecture:

- **CLI Layer**: Command-line interface with Click
- **Core Engine**: Business logic and orchestration
- **Service Layer**: LLM-based test generation
- **Storage Layer**: SQLite database for requirements

## 🤝 Contributing

1. Read the [Architecture Overview](agentops_ai/docs/ARCHITECTURE_OVERVIEW.md)
2. Complete the [Readiness Checklist](agentops_ai/docs/READINESS_CHECKLIST.md)
3. Explore the CodeTours in `.tours/`
4. Follow the development workflow

## 📄 License

[Add your license here]

---

**Built for vibe coders who want to ship fast without sacrificing quality! 🚀** 
