Metadata-Version: 2.3
Name: vaahai
Version: 0.2.3
Summary: AI-augmented code review CLI tool
License: MIT
Keywords: code-review,ai,llm,static-analysis,cli
Author: WebReinvent
Author-email: info@webreinvent.com
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Dist: bandit (>=1.7.5,<2.0.0)
Requires-Dist: click (>=8.1.3,<9.0.0)
Requires-Dist: colorama (>=0.4.6,<0.5.0)
Requires-Dist: flake8 (>=6.0.0,<7.0.0)
Requires-Dist: jinja2 (>=3.1.2,<4.0.0)
Requires-Dist: markdown (>=3.4.3,<4.0.0)
Requires-Dist: openai (>=1.0.0,<2.0.0)
Requires-Dist: pathspec (>=0.11.1,<0.12.0)
Requires-Dist: pydantic (>=2.0.0,<3.0.0)
Requires-Dist: pylint (>=2.17.0,<3.0.0)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Requires-Dist: rich (>=13.4.2,<14.0.0)
Requires-Dist: tomli (>=2.0.1,<3.0.0)
Requires-Dist: tomli-w (>=1.0.0,<2.0.0)
Requires-Dist: typer (==0.9.0)
Project-URL: Documentation, https://github.com/webreinvent/vaahai/docs
Project-URL: Repository, https://github.com/webreinvent/vaahai
Description-Content-Type: text/markdown

# Vaahai

Agentic Coding, Review, Audit and Generation

## Overview

Vaahai is an AI-augmented code review CLI tool that combines static analysis with LLM capabilities to provide comprehensive code reviews, suggestions, and automated fixes.

## Installation

```bash
# Install from PyPI
pip install vaahai

# Verify installation
vaahai --version
```

## Quick Start

```bash
# Set up your configuration
vaahai config init

# Review a single file
vaahai review main path/to/file.py

# Review a directory recursively
vaahai review main src/

# Review with specific include/exclude patterns
vaahai review main src/ --include="*.py" --exclude="*_test.py"

# Review with specific focus and depth
vaahai review main important_module.py --depth thorough --focus security
```

## Features

- **Code Scanning**: Scan directories with customizable filters for file extensions, patterns, and content
- **Static Analysis**: Integrate with static analysis tools for code quality checks
- **LLM Integration**: Leverage LLMs for contextual code review and suggestions
- **Interactive Fixes**: Apply suggested fixes interactively
- **Multiple Output Formats**: Generate reports in terminal, markdown, or HTML formats

## Implementation Status

| Component | Status | Description |
|-----------|--------|-------------|
| Configuration System | ✅ Complete | Modular configuration with environment variables, validation, and migration |
| Code Scanner | ✅ Complete | File scanning with filtering by extension, pattern, size, and content |
| CLI Application | 🔄 In Progress | Command structure with review command implemented |
| Static Analysis | ⏳ Planned | Integration with static analysis tools |
| LLM Integration | ⏳ Planned | Support for multiple LLM providers |
| Interactive Fixes | ⏳ Planned | Interactive application of suggested fixes |

For detailed implementation status, see the [Implementation Status](/specs/implementation/implementation_status.md) documentation.
For the complete development roadmap, see the [Implementation Roadmap](/specs/implementation/implementation_roadmap.md).

## Available Commands

### `review`

Review code files with customizable filters and analysis.

```bash
vaahai review main [PATH] [OPTIONS]
```

**Arguments:**
- `PATH`: Path to file or directory to review (required)

**Options:**
- `--depth {quick,standard,thorough}`: Review depth (default: standard)
- `--focus {all,security,performance,style}`: Focus area (default: all)
- `--output {terminal,markdown,html}`: Output format (default: terminal)
- `--output-file FILE`: Save output to a file
- `--include PATTERN`: Patterns to include (can be used multiple times)
- `--exclude PATTERN`: Patterns to exclude (can be used multiple times)
- `--max-file-size SIZE`: Maximum file size in bytes (default: 1MB)
- `--interactive`: Enable interactive fix application
- `--save-history`: Save review results to history
- `--private`: Use only local resources

### `config`

Manage Vaahai configuration.

```bash
vaahai config [ACTION] [OPTIONS]
```

**Actions:**
- `init`: Initialize configuration
- `get KEY`: Get a configuration value
- `set KEY VALUE`: Set a configuration value
- `list`: List all configuration values
- `reset`: Reset configuration to defaults
- `locations`: Show configuration file locations

**Options:**
- `--global`: Apply to global configuration
- `--local`: Apply to local configuration
- `--env`: Show environment variable override

### `analyze`

Run static analysis on code files.

```bash
vaahai analyze [PATH] [OPTIONS]
```

**Arguments:**
- `PATH`: Path to file or directory to analyze

**Options:**
- `--analyzer {pylint,eslint,all}`: Analyzer to use
- `--format {text,json,html}`: Output format
- `--output-file FILE`: Save output to a file

## Documentation

Comprehensive documentation is available in the `/docs` directory:

- [Installation Guide](docs/installation.md)
- [Getting Started](docs/getting_started.md)
- [Usage Guide](docs/usage.md)
- [Commands Reference](docs/commands.md)
- [Configuration Guide](docs/configuration.md)
- [Code Scanner](docs/scanner.md)

To view the documentation in your browser:

```bash
# Install Docsify (if not already installed)
npm install -g docsify-cli

# Start the documentation server
docsify serve docs

# Access at http://localhost:3000
```

## Contributing

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

