adversarial-workflow 0.5.0__tar.gz → 0.6.1__tar.gz

{adversarial_workflow-0.5.0 → adversarial_workflow-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: adversarial-workflow
-Version: 0.5.0
+Version: 0.6.1
 Summary: Multi-stage AI code review system preventing phantom work - Author/Evaluator pattern
 Author: Fredrik Matheson
 License: MIT
@@ -35,6 +35,10 @@ Dynamic: license-file
 
 # Adversarial Workflow
 
+[![PyPI version](https://badge.fury.io/py/adversarial-workflow.svg)](https://pypi.org/project/adversarial-workflow/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 **A multi-stage AI code review system that makes your code better**
 
 Evaluate proposals, sort out ideas, and prevent "phantom work" (AI claiming to implement but not delivering) through adversarial verification using independent review stages. A battle-tested workflow from the [thematic-cuts](https://github.com/movito/thematic-cuts) project that achieved 96.9% test pass rate improvement.
@@ -51,6 +55,31 @@ Evaluate proposals, sort out ideas, and prevent "phantom work" (AI claiming to i
 - 🎯 **Tool-agnostic**: Use with Claude Code, Cursor, Aider, manual coding, or any workflow
 - ✨ **Interactive onboarding**: Guided setup wizard gets you started in <5 minutes
 
+## What's New in v0.6.0
+
+🔌 **Plugin Architecture** - Define custom evaluators without modifying the package:
+
+```bash
+# Create a custom evaluator
+mkdir -p .adversarial/evaluators
+cat > .adversarial/evaluators/athena.yml << 'EOF'
+name: athena
+description: Knowledge evaluation using Gemini 2.5 Pro
+model: gemini-2.5-pro
+api_key_env: GEMINI_API_KEY
+prompt: |
+  You are Athena, a knowledge evaluation specialist...
+EOF
+
+# Use it immediately
+adversarial athena docs/research-plan.md
+
+# List all available evaluators
+adversarial list-evaluators
+```
+
+See [Custom Evaluators](#custom-evaluators) for full documentation, or check the [CHANGELOG](CHANGELOG.md) for complete release history.
+
 ## Prerequisites
 
 Before installing, ensure you have:
@@ -382,8 +411,68 @@ adversarial split task.md               # Split large files into smaller parts
 adversarial split task.md --dry-run     # Preview split without creating files
 adversarial review                      # Phase 3: Review implementation
 adversarial validate "pytest"           # Phase 4: Validate with tests
+adversarial list-evaluators             # List all available evaluators
+```
+
+## Custom Evaluators
+
+Starting with v0.6.0, you can define project-specific evaluators without modifying the package.
+
+### Creating a Custom Evaluator
+
+1. Create the evaluators directory:
+   ```bash
+   mkdir -p .adversarial/evaluators
+   ```
+
+2. Create a YAML definition:
+   ```yaml
+   # .adversarial/evaluators/athena.yml
+   name: athena
+   description: Knowledge evaluation using Gemini 2.5 Pro
+   model: gemini-2.5-pro
+   api_key_env: GEMINI_API_KEY
+   output_suffix: KNOWLEDGE-EVALUATION
+   prompt: |
+     You are Athena, a knowledge evaluation specialist...
+
+   # Optional
+   aliases:
+     - knowledge
+   ```
+
+3. Use it like any built-in evaluator:
+   ```bash
+   adversarial athena docs/research-plan.md
+   ```
+
+### Evaluator YAML Schema
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `name` | Yes | Command name |
+| `description` | Yes | Help text shown in CLI |
+| `model` | Yes | Model to use (e.g., `gpt-4o`, `gemini-2.5-pro`) |
+| `api_key_env` | Yes | Environment variable for API key |
+| `output_suffix` | Yes | Log file suffix (e.g., `KNOWLEDGE-EVAL`) |
+| `prompt` | Yes | The evaluation prompt |
+| `aliases` | No | Alternative command names |
+| `log_prefix` | No | CLI output prefix |
+| `fallback_model` | No | Fallback model if primary fails |
+| `version` | No | Evaluator version (default: 1.0.0) |
+
+### Listing Available Evaluators
+
+```bash
+adversarial list-evaluators
 ```
 
+### Example: Athena Knowledge Evaluator
+
+See [docs/examples/athena.yml](docs/examples/athena.yml) for a complete example of a knowledge-focused evaluator using Gemini 2.5 Pro.
+
+For full documentation on custom evaluators, see [docs/CUSTOM_EVALUATORS.md](docs/CUSTOM_EVALUATORS.md).
+
 ## Configuration
 
 ### Option 1: YAML Config (persistent)
@@ -796,12 +885,13 @@ From the [thematic-cuts](https://github.com/movito/thematic-cuts) project:
 
 ## Documentation
 
-- **Interaction Patterns**: How Author-Reviewer collaboration works
+- **[Custom Evaluators Guide](docs/CUSTOM_EVALUATORS.md)**: Create project-specific evaluators
+- **[Integration Guide](docs/INTEGRATION-GUIDE.md)**: Detailed integration strategies
+- **[CHANGELOG](CHANGELOG.md)**: Release history and version notes
+- **Interaction Patterns**: How Author-Evaluator collaboration works
 - **Token Optimization**: Detailed Aider configuration guide
 - **Workflow Phases**: Step-by-step guide for each phase
 - **Troubleshooting**: Common issues and solutions
-- **Examples**: Real integration scenarios
-- **Terminology**: Official standards for Author/Reviewer concepts
 
 See `docs/` directory for comprehensive guides.
 

{adversarial_workflow-0.5.0 → adversarial_workflow-0.6.1}/README.md

@@ -1,5 +1,9 @@
 # Adversarial Workflow
 
+[![PyPI version](https://badge.fury.io/py/adversarial-workflow.svg)](https://pypi.org/project/adversarial-workflow/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 **A multi-stage AI code review system that makes your code better**
 
 Evaluate proposals, sort out ideas, and prevent "phantom work" (AI claiming to implement but not delivering) through adversarial verification using independent review stages. A battle-tested workflow from the [thematic-cuts](https://github.com/movito/thematic-cuts) project that achieved 96.9% test pass rate improvement.
@@ -16,6 +20,31 @@ Evaluate proposals, sort out ideas, and prevent "phantom work" (AI claiming to i
 - 🎯 **Tool-agnostic**: Use with Claude Code, Cursor, Aider, manual coding, or any workflow
 - ✨ **Interactive onboarding**: Guided setup wizard gets you started in <5 minutes
 
+## What's New in v0.6.0
+
+🔌 **Plugin Architecture** - Define custom evaluators without modifying the package:
+
+```bash
+# Create a custom evaluator
+mkdir -p .adversarial/evaluators
+cat > .adversarial/evaluators/athena.yml << 'EOF'
+name: athena
+description: Knowledge evaluation using Gemini 2.5 Pro
+model: gemini-2.5-pro
+api_key_env: GEMINI_API_KEY
+prompt: |
+  You are Athena, a knowledge evaluation specialist...
+EOF
+
+# Use it immediately
+adversarial athena docs/research-plan.md
+
+# List all available evaluators
+adversarial list-evaluators
+```
+
+See [Custom Evaluators](#custom-evaluators) for full documentation, or check the [CHANGELOG](CHANGELOG.md) for complete release history.
+
 ## Prerequisites
 
 Before installing, ensure you have:
@@ -347,8 +376,68 @@ adversarial split task.md               # Split large files into smaller parts
 adversarial split task.md --dry-run     # Preview split without creating files
 adversarial review                      # Phase 3: Review implementation
 adversarial validate "pytest"           # Phase 4: Validate with tests
+adversarial list-evaluators             # List all available evaluators
+```
+
+## Custom Evaluators
+
+Starting with v0.6.0, you can define project-specific evaluators without modifying the package.
+
+### Creating a Custom Evaluator
+
+1. Create the evaluators directory:
+   ```bash
+   mkdir -p .adversarial/evaluators
+   ```
+
+2. Create a YAML definition:
+   ```yaml
+   # .adversarial/evaluators/athena.yml
+   name: athena
+   description: Knowledge evaluation using Gemini 2.5 Pro
+   model: gemini-2.5-pro
+   api_key_env: GEMINI_API_KEY
+   output_suffix: KNOWLEDGE-EVALUATION
+   prompt: |
+     You are Athena, a knowledge evaluation specialist...
+
+   # Optional
+   aliases:
+     - knowledge
+   ```
+
+3. Use it like any built-in evaluator:
+   ```bash
+   adversarial athena docs/research-plan.md
+   ```
+
+### Evaluator YAML Schema
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `name` | Yes | Command name |
+| `description` | Yes | Help text shown in CLI |
+| `model` | Yes | Model to use (e.g., `gpt-4o`, `gemini-2.5-pro`) |
+| `api_key_env` | Yes | Environment variable for API key |
+| `output_suffix` | Yes | Log file suffix (e.g., `KNOWLEDGE-EVAL`) |
+| `prompt` | Yes | The evaluation prompt |
+| `aliases` | No | Alternative command names |
+| `log_prefix` | No | CLI output prefix |
+| `fallback_model` | No | Fallback model if primary fails |
+| `version` | No | Evaluator version (default: 1.0.0) |
+
+### Listing Available Evaluators
+
+```bash
+adversarial list-evaluators
 ```
 
+### Example: Athena Knowledge Evaluator
+
+See [docs/examples/athena.yml](docs/examples/athena.yml) for a complete example of a knowledge-focused evaluator using Gemini 2.5 Pro.
+
+For full documentation on custom evaluators, see [docs/CUSTOM_EVALUATORS.md](docs/CUSTOM_EVALUATORS.md).
+
 ## Configuration
 
 ### Option 1: YAML Config (persistent)
@@ -761,12 +850,13 @@ From the [thematic-cuts](https://github.com/movito/thematic-cuts) project:
 
 ## Documentation
 
-- **Interaction Patterns**: How Author-Reviewer collaboration works
+- **[Custom Evaluators Guide](docs/CUSTOM_EVALUATORS.md)**: Create project-specific evaluators
+- **[Integration Guide](docs/INTEGRATION-GUIDE.md)**: Detailed integration strategies
+- **[CHANGELOG](CHANGELOG.md)**: Release history and version notes
+- **Interaction Patterns**: How Author-Evaluator collaboration works
 - **Token Optimization**: Detailed Aider configuration guide
 - **Workflow Phases**: Step-by-step guide for each phase
 - **Troubleshooting**: Common issues and solutions
-- **Examples**: Real integration scenarios
-- **Terminology**: Official standards for Author/Reviewer concepts
 
 See `docs/` directory for comprehensive guides.
 

{adversarial_workflow-0.5.0 → adversarial_workflow-0.6.1}/adversarial_workflow/__init__.py

@@ -12,7 +12,7 @@ Usage:
     adversarial validate "pytest"
 """
 
-__version__ = "0.5.0"
+__version__ = "0.6.1"
 __author__ = "Fredrik Matheson"
 __license__ = "MIT"