aidp 0.9.6 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f524705593a3496a0959020afc83df09af23091ac3fe057e1e63e995598cd3ca
-  data.tar.gz: cf5e3b842c2a0e2976b1e5d49698ec1394d588122c8e20fabcc6225c069231bc
+  metadata.gz: ffba477d4ca2e297b4fe81d7ecb32ccf37d161df6bcd2dceaa91e94ccbc8ea8f
+  data.tar.gz: 851fdc47c7a12bd8f6f8304badf60ffdb6855787d0982645d80a309d9caee40b
 SHA512:
-  metadata.gz: 656cbf7e645cf77062014d1c83b62555e57cdd9e4c7752ceb93d8b79baad1e2e91038a7d810735aff49ae097e5c22e06a6897c9fc58de7fba8e98fddc9706e98
-  data.tar.gz: 47a07ad75ce545dba7ba73746f8444f30e4a8c0da1cee1e92d6d3b7a020c8e30010dfb266a84f0cf0f5d4aad6f8c7085283cbd7b6bff9f1c641d205270d1d4f1
+  metadata.gz: ef68650e5a8c55d8b219a00a42ba7fbff2c87bdd5cacf5f450c8bf406c481d6d1e4c00cd7edabbf41b07928bb28c2b5246c54392e67f52ee8381bac1668d9463
+  data.tar.gz: d2ae0a1bc041b0f8c0cdf1ccb3c328fc7bb1c4ba3cbb0599c983f4937056a8ad1f47e0bcb475a96dd8d4d936cfc6d7452a0333121ed36e29a14708b8e4bd15ec

data/README.md

@@ -1,6 +1,6 @@
 # AI Dev Pipeline (aidp) - Ruby Gem
 
-A portable CLI that automates a complete AI development workflow from idea to implementation using your existing IDE assistants. Now with **Enhanced TUI** - a rich terminal interface that runs complete workflows with intelligent provider management and error recovery.
+A portable CLI that automates AI development workflows from idea to implementation using your existing IDE assistants. Features autonomous work loops, background execution, and comprehensive progress tracking.
 
 ## Quick Start
 
@@ -11,13 +11,16 @@ gem install aidp
 # Navigate to your project
 cd /your/project
 
-# Start the interactive TUI (default)
-aidp
+# Start an interactive workflow
+aidp execute
+
+# Or run in background
+aidp execute --background
 ```
 
 ### First-Time Setup
 
-On the first run in a project without an `aidp.yml`, AIDP now launches a **First-Time Setup Wizard** instead of failing with a configuration error. You'll be prompted to choose one of:
+On the first run in a project without an `aidp.yml`, AIDP launches a **First-Time Setup Wizard**. You'll be prompted to choose one of:
 
 1. Minimal (single provider: cursor)
 2. Development template (multiple providers, safe defaults)
@@ -27,43 +30,156 @@ On the first run in a project without an `aidp.yml`, AIDP now launches a **First
 
 Non-interactive environments (CI, scripts, pipes) automatically receive a minimal `aidp.yml` so workflows can proceed without manual intervention.
 
-You can re-run the wizard manually by removing `aidp.yml` and starting `aidp` again.
+You can re-run the wizard manually:
+
+```bash
+aidp --setup-config
+```
+
+## Core Features
+
+### Work Loops
+
+AIDP implements **work loops** - an iterative execution pattern where AI agents autonomously work on tasks until completion, with automatic testing and linting feedback.
+
+- **Iterative refinement**: Agent works in loops until task is 100% complete
+- **Self-management**: Agent edits PROMPT.md to track its own progress
+- **Automatic validation**: Tests and linters run after each iteration
+- **Self-correction**: Only failures are fed back for the next iteration
+
+See [Work Loops Guide](docs/WORK_LOOPS_GUIDE.md) for details.
+
+### Background Execution
+
+Run workflows in the background while monitoring progress from separate terminals:
+
+```bash
+# Start in background
+aidp execute --background
+✓ Started background job: 20251005_235912_a1b2c3d4
+
+# Monitor progress
+aidp jobs list                        # List all jobs
+aidp jobs status <job_id>             # Show job status
+aidp jobs logs <job_id> --tail        # View recent logs
+aidp checkpoint summary --watch       # Watch metrics in real-time
+
+# Control jobs
+aidp jobs stop <job_id>               # Stop a running job
+```
+
+### Progress Checkpoints
 
-## Enhanced TUI
+Track code quality metrics and task progress throughout execution:
 
-AIDP features a rich terminal interface that transforms it from a step-by-step tool into an intelligent development assistant. The enhanced TUI provides beautiful, interactive terminal components while running complete workflows automatically.
+```bash
+# View current progress
+aidp checkpoint summary
+
+# Watch with auto-refresh
+aidp checkpoint summary --watch
+
+# View historical data
+aidp checkpoint history 20
+```
 
-### Features
+**Tracked Metrics:**
 
-- **🎨 Rich Terminal Interface**: Beautiful CLI UI components with progress bars, spinners, and frames
-- **📋 Interactive Navigation**: Hierarchical menu system with breadcrumb navigation
-- **⌨️ Keyboard Shortcuts**: Full keyboard navigation and control
-- **📊 Real-time Progress**: Live monitoring of progress and system status
-- **🔄 Workflow Control**: Pause, resume, cancel, and stop workflows with visual feedback
-- **💬 Smart Question Collection**: Interactive prompts with validation and error handling
+- Lines of code
+- Test coverage
+- Code quality scores
+- PRD task completion percentage
+- File count and growth trends
 
-### Usage
+## Command Reference
+
+### Execution Modes
 
 ```bash
-# Start the interactive TUI (default)
-aidp
+# Execute mode - Build new features
+aidp execute                    # Interactive workflow selection
+aidp execute --background       # Run in background
+aidp execute --background --follow  # Start and follow logs
+
+# Analyze mode - Analyze codebase
+aidp analyze                    # Interactive analysis
+aidp analyze --background       # Background analysis
+```
 
-# Show version information
-aidp --version
+### Job Management
+
+```bash
+# List all background jobs
+aidp jobs list
 
-# Show help information
-aidp --help
+# Show job status
+aidp jobs status <job_id>
+aidp jobs status <job_id> --follow  # Follow with auto-refresh
+
+# View job logs
+aidp jobs logs <job_id>
+aidp jobs logs <job_id> --tail      # Last 50 lines
+aidp jobs logs <job_id> --follow    # Stream in real-time
+
+# Stop a running job
+aidp jobs stop <job_id>
+```
+
+### Checkpoint Monitoring
+
+```bash
+# View latest checkpoint
+aidp checkpoint show
+
+# Progress summary with trends
+aidp checkpoint summary
+aidp checkpoint summary --watch             # Auto-refresh every 5s
+aidp checkpoint summary --watch --interval 10  # Custom interval
+
+# View checkpoint history
+aidp checkpoint history           # Last 10 checkpoints
+aidp checkpoint history 50        # Last 50 checkpoints
+
+# Detailed metrics
+aidp checkpoint metrics
+
+# Clear checkpoint data
+aidp checkpoint clear
+aidp checkpoint clear --force     # Skip confirmation
+```
+
+### System Commands
+
+```bash
+# Show system status
+aidp status
+
+# Provider health dashboard
+aidp providers
+
+# Harness state management
+aidp harness status
+aidp harness reset
+
+# Configuration
+aidp --setup-config             # Re-run setup wizard
+aidp --help                     # Show all commands
+aidp --version                  # Show version
 ```
 
 ## AI Providers
 
 AIDP intelligently manages multiple providers with automatic switching:
 
-- **Claude API** - Primary provider for complex analysis and code generation
-- **Gemini API** - Cost-effective fallback for general tasks
+- **Anthropic Claude CLI** - Primary provider for complex analysis and code generation
+- **Codex CLI** - OpenAI's Codex command-line interface for code generation
 - **Cursor CLI** - IDE-integrated provider for code-specific tasks
+- **Gemini CLI** - Google's Gemini command-line interface for general tasks
+- **GitHub Copilot CLI** - GitHub's AI pair programmer command-line interface
+- **macOS UI** - macOS-specific UI automation provider
+- **OpenCode** - Alternative open-source code generation provider
 
-The TUI automatically switches providers when:
+The system automatically switches providers when:
 
 - Rate limits are hit
 - Providers fail or timeout
@@ -74,6 +190,15 @@ The TUI automatically switches providers when:
 
 ```yaml
 # aidp.yml
+harness:
+  work_loop:
+    enabled: true
+    max_iterations: 50
+    test_commands:
+      - "bundle exec rspec"
+    lint_commands:
+      - "bundle exec standardrb"
+
 providers:
   claude:
     type: "usage_based"
@@ -190,6 +315,49 @@ When the AI creates a questions file, follow these steps:
 
 The questions file is only created when the AI needs additional information beyond what it can infer from your project structure and existing files. Your answers are preserved for future reference.
 
+## Workflow Examples
+
+### Standard Interactive Workflow
+
+```bash
+# Start execute mode
+aidp execute
+
+# Select workflow type (e.g., "Full PRD to Implementation")
+# Answer any questions interactively
+# Review generated files (PRD, architecture, etc.)
+# Workflow runs automatically with harness managing retries
+```
+
+### Background Workflow with Monitoring
+
+```bash
+# Terminal 1: Start background execution
+aidp execute --background
+✓ Started background job: 20251005_235912_a1b2c3d4
+
+# Terminal 2: Watch progress in real-time
+aidp checkpoint summary --watch
+
+# Terminal 3: Monitor job status
+aidp jobs status 20251005_235912_a1b2c3d4 --follow
+
+# Later: Check final results
+aidp checkpoint summary
+aidp jobs logs 20251005_235912_a1b2c3d4 --tail
+```
+
+### Quick Analysis
+
+```bash
+# Run analysis in background
+aidp analyze --background
+
+# Check progress
+aidp jobs list
+aidp checkpoint summary
+```
+
 ## Debug and Logging
 
 ```bash
@@ -247,7 +415,8 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and conventional co
 
 For detailed information:
 
-- **[TUI User Guide](docs/TUI_USER_GUIDE.md)** - Complete guide to using the enhanced TUI
+- **[CLI User Guide](docs/CLI_USER_GUIDE.md)** - Complete guide to using AIDP commands
+- **[Work Loops Guide](docs/WORK_LOOPS_GUIDE.md)** - Iterative workflows with automatic validation
 - **[Configuration Guide](docs/harness-configuration.md)** - Detailed configuration options and examples
 - **[Troubleshooting Guide](docs/harness-troubleshooting.md)** - Common issues and solutions
 

data/lib/aidp/analyze/error_handler.rb

@@ -8,7 +8,8 @@ module Aidp
     class ErrorHandler
       attr_reader :logger, :error_counts, :recovery_strategies
 
-      def initialize(log_file: nil, verbose: false)
+      def initialize(log_file: nil, verbose: false, output: nil)
+        @output = output
         @logger = setup_logger(log_file, verbose)
         @error_counts = Hash.new(0)
         @recovery_strategies = setup_recovery_strategies
@@ -87,7 +88,8 @@ module Aidp
       private
 
       def setup_logger(log_file, verbose)
-        logger = Logger.new(log_file || $stdout)
+        output_stream = log_file || @output || $stdout
+        logger = Logger.new(output_stream)
         logger.level = verbose ? Logger::DEBUG : Logger::INFO
         logger.formatter = proc do |severity, datetime, progname, msg|
           "#{datetime.strftime("%Y-%m-%d %H:%M:%S")} [#{severity}] #{msg}\n"