feat: Enhanced Task Generation with Scheduling and Templates

[frankbria]

Summary

• Add effort estimation to task decomposition with hours-based tracking
• Implement critical path analysis and dependency conflict detection
• Add CPM-based task scheduling with multi-agent support
• Create task template system with 7 builtin templates
• Add CLI commands for schedule management (cf schedule show/predict/bottlenecks)
• Add CLI commands for templates (cf templates list/show/apply)
• Add API endpoints for schedule and templates (Phase 6)

Changes

Phase 1: Task Decomposition

• Tasks now support estimated_hours field
• Task decomposer generates effort estimates

Phase 2: Dependency Analysis

• Critical path analysis identifies longest task chains
• Conflict detection finds circular dependencies
• DependencyResolver updated for v2 API compatibility

Phase 3: Task Scheduling

• TaskScheduler with CPM (Critical Path Method) algorithm
• Multi-agent parallel scheduling support
• Completion date prediction
• Bottleneck identification

Phase 4: Task Templates

• 7 builtin templates (api-endpoint, react-component, database-model, etc.)
• Template categories (backend, frontend, database, testing, infrastructure)
• Context variable substitution

Phase 5: CLI Commands

• cf schedule show - Display project schedule
• cf schedule predict - Predict completion date
• cf schedule bottlenecks - Identify bottlenecks
• cf templates list - List available templates
• cf templates show <id> - Show template details
• cf templates apply <id> - Create tasks from template

Phase 6: API Endpoints

• Schedule endpoints: GET schedule, predict, bottlenecks
• Templates endpoints: list, categories, get, apply

Test plan

• Run uv run pytest -m v2 - 795 tests pass
• Run uv run pytest tests/planning/ - All scheduling/template tests pass
• Run uv run pytest tests/cli/test_schedule_commands.py tests/cli/test_templates_commands.py - CLI tests pass
• Run uv run pytest tests/api/test_schedule_api.py tests/api/test_templates_api.py - API tests pass
• Verify cf schedule show works in initialized workspace
• Verify cf templates list shows 7 builtin templates

Summary by CodeRabbit

• New Features

  • Project scheduling: timeline, multi‑agent assignments, optimization, completion prediction, bottleneck & critical‑path analysis.
  • Task templates: browse, view, and apply builtin templates with context substitution and estimated totals.
  • Effort estimation: tasks now carry estimated hours, complexity, uncertainty, and resource hints.

• API / CLI / UI

  • New CLI commands and HTTP endpoints for schedule and template operations (show, predict, bottlenecks, list, show, apply).

• Bug Fixes

  • Clearer, typed error responses for invalid phase transitions and missing projects.

• Chores

  • DB migrations and a transaction API to support new task fields.

• Tests

  • Extensive unit/integration tests for scheduling, templates, decomposition, and dependency analysis.

_{✏️ Tip: You can customize this high-level summary in your review settings.}