itdove/devaiflow#330: Feature orchestration: Multi-session workflow with integrated verification

[itdove]

Description

This PR introduces feature orchestration capabilities to enable multi-session workflows with integrated verification in DevAIFlow. This enhancement allows developers to manage complex features that span multiple work sessions and repositories, with automated validation and progress tracking.

Key Changes:

• New orchestration system (devflow/orchestration/):

  • feature.py: Core feature orchestration logic for managing multi-session workflows
  • parent_discovery.py: Automatic discovery of parent feature contexts
  • storage.py: Persistent storage for feature state and session relationships

• New verification framework (devflow/verification/):

  • artifact_validator.py: Validates artifacts produced during feature development
  • criteria_checker.py: Checks completion criteria and readiness gates
  • report_generator.py: Generates comprehensive verification reports
  • test_runner.py: Orchestrates test execution across sessions

• Enhanced CLI commands:

  • Updated feature_command.py to support feature lifecycle management
  • Modified complete_command.py to integrate verification before completion
  • Extended open_command.py to handle feature context initialization

• Client integrations:

  • Enhanced GitHub/GitLab/JIRA clients to support feature-level issue tracking
  • Updated config/models.py for feature orchestration configuration

• Documentation:

  • Added comprehensive architecture documentation for feature orchestration
  • Updated command reference and workflow guides
  • Created experimental feature documentation

Assisted-by: Claude

Testing

Steps to test

1. Pull down the PR
2. Initialize a new feature workflow: daf feature create --name "test-feature" --description "Multi-session test"
3. Create a child session: daf open --feature test-feature --goal "Implement component A"
4. Make code changes and commit them
5. Run verification: daf verify to check artifacts and criteria
6. Complete the session: daf complete (should trigger integrated verification)
7. Open another child session: daf open --feature test-feature --goal "Implement component B"
8. Complete the feature: daf feature complete test-feature (should verify all child sessions)
9. Verify feature storage and state persistence across sessions
10. Test parent feature discovery with nested feature hierarchies
11. Review generated verification reports for completeness

Scenarios tested

• Created multi-session feature workflows with 2-3 child sessions
• Verified artifact validation for code changes, tests, and documentation
• Tested completion criteria checking with both passing and failing scenarios
• Validated feature state persistence across CLI restarts
• Confirmed parent discovery works with nested feature contexts
• Verified integration with GitHub, GitLab, and JIRA issue tracking

Deployment considerations

• This code change requires the following considerations before being deployed:
  • Database migration may be needed for feature storage schema (check devflow/orchestration/storage.py for schema requirements)
  • Configuration update required: users should add feature_orchestration.enabled: true to their config if they want to opt into this experimental feature
  • Backward compatibility maintained: existing single-session workflows continue to work without changes
  • No breaking changes to existing CLI commands or workflows