adaptationio/ac-task-executor

AC Task Executor

Execute implementation tasks for autonomous coding features.

Purpose

Orchestrates the execution of feature implementations, managing the task queue and coordinating between planning, implementation, and verification phases.

Quick Start

from scripts.task_executor import TaskExecutor

executor = TaskExecutor(project_dir)
result = await executor.execute_next_feature()

Execution Modes

Single Feature

Execute one feature at a time:

result = await executor.execute_feature("auth-001")

Queue Mode

Process feature queue continuously:

await executor.execute_queue(max_features=10)

Batch Mode

Execute multiple features in a batch:

results = await executor.execute_batch(["auth-001", "auth-002"])

Task Lifecycle

1. SELECT   → Choose next feature from queue
2. PREPARE  → Load context, generate tests (RED)
3. IMPLEMENT → Write code to pass tests (GREEN)
4. REFACTOR → Clean up while tests pass
5. VALIDATE → Run criteria validation
6. COMMIT   → Git commit changes
7. UPDATE   → Mark feature as passes: true
8. NEXT     → Continue to next feature

Execution Result

{
  "feature_id": "auth-001",
  "status": "completed",
  "phases": {
    "prepare": {"success": true, "duration_ms": 1500},
    "implement": {"success": true, "duration_ms": 45000},
    "validate": {"success": true, "duration_ms": 5000},
    "commit": {"success": true, "commit_hash": "abc123"}
  },
  "tests": {
    "total": 5,
    "passed": 5,
    "failed": 0
  },
  "metrics": {
    "tokens_used": 15000,
    "estimated_cost": 0.23
  }
}

Error Handling

• Validation Failure: Retry implementation up to 3 times
• Test Failure: Analyze failures, adjust approach
• Timeout: Save state, create handoff for continuation
• Critical Error: Rollback to last checkpoint

Integration

• Uses: ac-state-tracker, ac-test-generator, ac-criteria-validator
• Triggers: ac-commit-manager, ac-qa-reviewer
• Reports to: ac-session-manager

API Reference

See scripts/task_executor.py for full implementation.