@pjmendonca/devflow 1.13.2 → 1.19.0

package/tooling/.automation/validation/history/2025-12-30_val_ddd4f4e6.json

@@ -0,0 +1,32 @@
+{
+  "id": "val_ddd4f4e6",
+  "timestamp": "2025-12-30T10:18:39.910558",
+  "story_key": "validation-check",
+  "tier": 3,
+  "gate_results": [
+    {
+      "gate_name": "tests_pass",
+      "result": "fail",
+      "message": "Validation failed",
+      "duration_ms": 327.0759582519531,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    }
+  ],
+  "overall_result": "fail",
+  "total_duration_ms": 327.1300792694092,
+  "passed": false,
+  "context": {
+    "story_key": "validation-check",
+    "iteration": 0,
+    "max_iterations": 3,
+    "accumulated_issues": [],
+    "accumulated_fixes": [],
+    "cost_so_far": 0.0,
+    "time_elapsed_seconds": 0.0,
+    "phase": "tier_3",
+    "from_agent": "",
+    "to_agent": ""
+  }
+}

package/tooling/.automation/validation/history/2025-12-30_val_f2e1394b.json

@@ -0,0 +1,32 @@
+{
+  "id": "val_f2e1394b",
+  "timestamp": "2025-12-30T10:50:21.312897",
+  "story_key": "test",
+  "tier": 1,
+  "gate_results": [
+    {
+      "gate_name": "fail_gate",
+      "result": "fail",
+      "message": "Validation failed",
+      "duration_ms": 0.0011920928955078125,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    }
+  ],
+  "overall_result": "fail",
+  "total_duration_ms": 0.0030994415283203125,
+  "passed": false,
+  "context": {
+    "story_key": "test",
+    "iteration": 0,
+    "max_iterations": 3,
+    "accumulated_issues": [],
+    "accumulated_fixes": [],
+    "cost_so_far": 0.0,
+    "time_elapsed_seconds": 0.0,
+    "phase": "",
+    "from_agent": "",
+    "to_agent": ""
+  }
+}

package/tooling/.automation/validation/history/2025-12-30_val_f4a7fa06.json

@@ -0,0 +1,41 @@
+{
+  "id": "val_f4a7fa06",
+  "timestamp": "2025-12-30T10:31:36.397579",
+  "story_key": "test",
+  "tier": 1,
+  "gate_results": [
+    {
+      "gate_name": "pass",
+      "result": "pass",
+      "message": "Validation passed",
+      "duration_ms": 0.0,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    },
+    {
+      "gate_name": "fail",
+      "result": "fail",
+      "message": "Validation failed",
+      "duration_ms": 0.0,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    }
+  ],
+  "overall_result": "fail",
+  "total_duration_ms": 0.00476837158203125,
+  "passed": false,
+  "context": {
+    "story_key": "test",
+    "iteration": 0,
+    "max_iterations": 3,
+    "accumulated_issues": [],
+    "accumulated_fixes": [],
+    "cost_so_far": 0.0,
+    "time_elapsed_seconds": 0.0,
+    "phase": "",
+    "from_agent": "",
+    "to_agent": ""
+  }
+}

package/tooling/.automation/validation/history/2025-12-30_val_ffea3369.json

@@ -0,0 +1,32 @@
+{
+  "id": "val_ffea3369",
+  "timestamp": "2025-12-30T10:31:36.398799",
+  "story_key": "test",
+  "tier": 1,
+  "gate_results": [
+    {
+      "gate_name": "block",
+      "result": "fail",
+      "message": "Validation failed",
+      "duration_ms": 0.0007152557373046875,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    }
+  ],
+  "overall_result": "fail",
+  "total_duration_ms": 0.016689300537109375,
+  "passed": false,
+  "context": {
+    "story_key": "test",
+    "iteration": 0,
+    "max_iterations": 3,
+    "accumulated_issues": [],
+    "accumulated_fixes": [],
+    "cost_so_far": 0.0,
+    "time_elapsed_seconds": 0.0,
+    "phase": "",
+    "from_agent": "",
+    "to_agent": ""
+  }
+}

package/tooling/.automation/validation/history/2026-01-03_val_1287a74c.json

@@ -0,0 +1,41 @@
+{
+  "id": "val_1287a74c",
+  "timestamp": "2026-01-03T14:30:38.228447",
+  "story_key": "test",
+  "tier": 1,
+  "gate_results": [
+    {
+      "gate_name": "pass",
+      "result": "pass",
+      "message": "Validation passed",
+      "duration_ms": 0.0,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    },
+    {
+      "gate_name": "fail",
+      "result": "fail",
+      "message": "Validation failed",
+      "duration_ms": 0.0,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    }
+  ],
+  "overall_result": "fail",
+  "total_duration_ms": 0.004291534423828125,
+  "passed": false,
+  "context": {
+    "story_key": "test",
+    "iteration": 0,
+    "max_iterations": 3,
+    "accumulated_issues": [],
+    "accumulated_fixes": [],
+    "cost_so_far": 0.0,
+    "time_elapsed_seconds": 0.0,
+    "phase": "",
+    "from_agent": "",
+    "to_agent": ""
+  }
+}

package/tooling/.automation/validation/history/2026-01-03_val_3b24071f.json

@@ -0,0 +1,32 @@
+{
+  "id": "val_3b24071f",
+  "timestamp": "2026-01-03T14:30:38.229579",
+  "story_key": "test",
+  "tier": 1,
+  "gate_results": [
+    {
+      "gate_name": "block",
+      "result": "fail",
+      "message": "Validation failed",
+      "duration_ms": 0.00095367431640625,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    }
+  ],
+  "overall_result": "fail",
+  "total_duration_ms": 0.017881393432617188,
+  "passed": false,
+  "context": {
+    "story_key": "test",
+    "iteration": 0,
+    "max_iterations": 3,
+    "accumulated_issues": [],
+    "accumulated_fixes": [],
+    "cost_so_far": 0.0,
+    "time_elapsed_seconds": 0.0,
+    "phase": "",
+    "from_agent": "",
+    "to_agent": ""
+  }
+}

package/tooling/.automation/validation/history/2026-01-03_val_44d77573.json

@@ -0,0 +1,32 @@
+{
+  "id": "val_44d77573",
+  "timestamp": "2026-01-03T14:30:38.230732",
+  "story_key": "test",
+  "tier": 1,
+  "gate_results": [
+    {
+      "gate_name": "test",
+      "result": "pass",
+      "message": "Validation passed",
+      "duration_ms": 0.0,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    }
+  ],
+  "overall_result": "pass",
+  "total_duration_ms": 0.00286102294921875,
+  "passed": true,
+  "context": {
+    "story_key": "test",
+    "iteration": 0,
+    "max_iterations": 3,
+    "accumulated_issues": [],
+    "accumulated_fixes": [],
+    "cost_so_far": 0.0,
+    "time_elapsed_seconds": 0.0,
+    "phase": "",
+    "from_agent": "",
+    "to_agent": ""
+  }
+}

package/tooling/.automation/validation/history/2026-01-03_val_5b31dc51.json

@@ -0,0 +1,32 @@
+{
+  "id": "val_5b31dc51",
+  "timestamp": "2026-01-03T14:30:38.231882",
+  "story_key": "test",
+  "tier": 3,
+  "gate_results": [
+    {
+      "gate_name": "test",
+      "result": "pass",
+      "message": "Validation passed",
+      "duration_ms": 0.00095367431640625,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    }
+  ],
+  "overall_result": "pass",
+  "total_duration_ms": 0.00286102294921875,
+  "passed": true,
+  "context": {
+    "story_key": "test",
+    "iteration": 0,
+    "max_iterations": 3,
+    "accumulated_issues": [],
+    "accumulated_fixes": [],
+    "cost_so_far": 0.0,
+    "time_elapsed_seconds": 0.0,
+    "phase": "",
+    "from_agent": "",
+    "to_agent": ""
+  }
+}

package/tooling/.automation/validation/history/2026-01-03_val_74267244.json

@@ -0,0 +1,32 @@
+{
+  "id": "val_74267244",
+  "timestamp": "2026-01-03T14:30:38.235432",
+  "story_key": "test",
+  "tier": 1,
+  "gate_results": [
+    {
+      "gate_name": "fail_gate",
+      "result": "fail",
+      "message": "Validation failed",
+      "duration_ms": 0.0,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    }
+  ],
+  "overall_result": "fail",
+  "total_duration_ms": 0.0040531158447265625,
+  "passed": false,
+  "context": {
+    "story_key": "test",
+    "iteration": 0,
+    "max_iterations": 3,
+    "accumulated_issues": [],
+    "accumulated_fixes": [],
+    "cost_so_far": 0.0,
+    "time_elapsed_seconds": 0.0,
+    "phase": "",
+    "from_agent": "",
+    "to_agent": ""
+  }
+}

package/tooling/.automation/validation/history/2026-01-03_val_8b2d95c7.json

@@ -0,0 +1,59 @@
+{
+  "id": "val_8b2d95c7",
+  "timestamp": "2026-01-03T14:30:38.341537",
+  "story_key": "validation-check",
+  "tier": 3,
+  "gate_results": [
+    {
+      "gate_name": "tests_pass",
+      "result": "pass",
+      "message": "Validation passed",
+      "duration_ms": 548.0339527130127,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    },
+    {
+      "gate_name": "lint_clean",
+      "result": "pass",
+      "message": "Validation passed",
+      "duration_ms": 14.641046524047852,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    },
+    {
+      "gate_name": "types_valid",
+      "result": "pass",
+      "message": "Validation passed",
+      "duration_ms": 14.327049255371094,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    },
+    {
+      "gate_name": "version_synced",
+      "result": "pass",
+      "message": "Validation passed",
+      "duration_ms": 28.564929962158203,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    }
+  ],
+  "overall_result": "pass",
+  "total_duration_ms": 605.6423187255859,
+  "passed": true,
+  "context": {
+    "story_key": "validation-check",
+    "iteration": 0,
+    "max_iterations": 3,
+    "accumulated_issues": [],
+    "accumulated_fixes": [],
+    "cost_so_far": 0.0,
+    "time_elapsed_seconds": 0.0,
+    "phase": "tier_3",
+    "from_agent": "",
+    "to_agent": ""
+  }
+}

package/tooling/.automation/validation/history/2026-01-03_val_d875b297.json

@@ -0,0 +1,41 @@
+{
+  "id": "val_d875b297",
+  "timestamp": "2026-01-03T14:30:38.226651",
+  "story_key": "test",
+  "tier": 1,
+  "gate_results": [
+    {
+      "gate_name": "gate1",
+      "result": "pass",
+      "message": "Validation passed",
+      "duration_ms": 0.00095367431640625,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    },
+    {
+      "gate_name": "gate2",
+      "result": "pass",
+      "message": "Validation passed",
+      "duration_ms": 0.0,
+      "retry_count": 0,
+      "auto_fixed": false,
+      "details": {}
+    }
+  ],
+  "overall_result": "pass",
+  "total_duration_ms": 0.006198883056640625,
+  "passed": true,
+  "context": {
+    "story_key": "test",
+    "iteration": 0,
+    "max_iterations": 3,
+    "accumulated_issues": [],
+    "accumulated_fixes": [],
+    "cost_so_far": 0.0,
+    "time_elapsed_seconds": 0.0,
+    "phase": "",
+    "from_agent": "",
+    "to_agent": ""
+  }
+}

package/tooling/.automation/validation-config.yaml

@@ -0,0 +1,103 @@
+# Validation Loop Configuration
+# Controls automated feedback and validation gates
+
+validation:
+  enabled: true
+
+  tiers:
+    # Tier 1: Pre-flight validation (before any agent runs)
+    preflight:
+      enabled: true
+      gates:
+        - name: story_exists
+          enabled: true
+          on_fail: block
+        - name: budget_available
+          enabled: true
+          on_fail: block
+        - name: dependencies_valid
+          enabled: true
+          on_fail: warn
+      on_all_fail: block
+
+    # Tier 2: Inter-phase validation (between agents/phases)
+    inter_phase:
+      enabled: true
+      max_retries: 3
+      retry_cooldown_seconds: 5
+      gates:
+        context_to_dev:
+          - name: context_complete
+            enabled: true
+            on_fail: retry
+            retry_with_agent: SM
+        dev_to_review:
+          - name: code_compiles
+            enabled: true
+            on_fail: retry
+            retry_with_agent: DEV
+          - name: lint_pass
+            enabled: true
+            on_fail: retry
+            auto_fix: true
+        review_to_complete:
+          - name: review_approved
+            enabled: true
+            on_fail: retry
+            retry_with_agent: DEV
+
+    # Tier 3: Post-completion validation (after pipeline completes)
+    post_completion:
+      enabled: true
+      gates:
+        - name: tests_pass
+          enabled: true
+          on_fail: block
+          timeout_seconds: 300
+        - name: lint_clean
+          enabled: true
+          on_fail: warn
+          auto_fix: true
+        - name: types_valid
+          enabled: true
+          on_fail: warn
+        - name: version_synced
+          enabled: true
+          on_fail: warn
+        - name: changelog_updated
+          enabled: true
+          on_fail: warn
+      on_fail: warn  # Don't block, just warn
+
+  automation:
+    auto_fix:
+      enabled: true
+      safe_fixes_only: true  # Only run fixes marked as safe
+
+    escalation:
+      after_retries: 3
+      notify: user  # Options: user, slack, email, github_issue
+
+    learning:
+      track_patterns: true
+      suggest_improvements: true
+
+  # Gate-specific overrides
+  gate_overrides:
+    tests_pass:
+      timeout_seconds: 300
+      command: "python -m pytest -x -q"
+    lint_pass:
+      timeout_seconds: 60
+      command: "python -m ruff check ."
+      auto_fix_command: "python -m ruff check --fix ."
+    types_valid:
+      timeout_seconds: 120
+      command: "python -m mypy --ignore-missing-imports ."
+
+  # Output and reporting
+  reporting:
+    format: text  # text, json, markdown
+    verbose: false
+    save_reports: true
+    report_dir: tooling/.automation/validation/history

package/tooling/completions/DevflowCompletion.ps1

@@ -25,7 +25,7 @@ $script:DevflowModes = @('swarm', 'pair', 'auto', 'sequential')
 # Argument completer for run-story.ps1
 Register-ArgumentCompleter -CommandName 'run-story.ps1', 'run-story' -Native -ScriptBlock {
     param($wordToComplete, $commandAst, $cursorPosition)
-    
+
     $params = @(
         @{ Name = '-Swarm'; Tooltip = 'Enable swarm mode (multi-agent debate)' }
         @{ Name = '-Pair'; Tooltip = 'Enable pair programming mode' }
@@ -41,18 +41,18 @@ Register-ArgumentCompleter -CommandName 'run-story.ps1', 'run-story' -Native -Sc
         @{ Name = '-Quiet'; Tooltip = 'Reduce output verbosity' }
         @{ Name = '-Help'; Tooltip = 'Show help' }
     )
-    
+
     # Get the current word being typed
     $commandElements = $commandAst.CommandElements
-    $lastWord = if ($commandElements.Count -gt 1) { 
-        $commandElements[-1].Extent.Text 
+    $lastWord = if ($commandElements.Count -gt 1) {
+        $commandElements[-1].Extent.Text
     } else { '' }
-    
+
     # Check if completing a parameter value
     $previousWord = if ($commandElements.Count -gt 2) {
         $commandElements[-2].Extent.Text
     } else { '' }
-    
+
     # Model completion
     if ($previousWord -eq '-Model') {
         $script:DevflowModels | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
@@ -65,18 +65,18 @@ Register-ArgumentCompleter -CommandName 'run-story.ps1', 'run-story' -Native -Sc
         }
         return
     }
-    
+
     # Agent completion
     if ($previousWord -eq '-Agents') {
         # Support comma-separated completion
         $existingAgents = if ($wordToComplete -match ',') {
             $wordToComplete -replace ',[^,]*$', ','
         } else { '' }
-        
+
         $currentPart = if ($wordToComplete -match ',') {
             ($wordToComplete -split ',')[-1]
         } else { $wordToComplete }
-        
+
         $script:DevflowAgents | Where-Object { $_.Name -like "$currentPart*" } | ForEach-Object {
             [System.Management.Automation.CompletionResult]::new(
                 "$existingAgents$($_.Name)",
@@ -87,7 +87,7 @@ Register-ArgumentCompleter -CommandName 'run-story.ps1', 'run-story' -Native -Sc
         }
         return
     }
-    
+
     # Parameter completion
     $params | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object {
         [System.Management.Automation.CompletionResult]::new(
@@ -102,7 +102,7 @@ Register-ArgumentCompleter -CommandName 'run-story.ps1', 'run-story' -Native -Sc
 # Argument completer for run-collab.ps1
 Register-ArgumentCompleter -CommandName 'run-collab.ps1', 'run-collab' -Native -ScriptBlock {
     param($wordToComplete, $commandAst, $cursorPosition)
-    
+
     $params = @(
         @{ Name = '-Swarm'; Tooltip = 'Enable swarm mode' }
         @{ Name = '-Pair'; Tooltip = 'Enable pair programming' }
@@ -118,12 +118,12 @@ Register-ArgumentCompleter -CommandName 'run-collab.ps1', 'run-collab' -Native -
         @{ Name = '-Quiet'; Tooltip = 'Quiet mode' }
         @{ Name = '-StoryKey'; Tooltip = 'Story key or description' }
     )
-    
+
     $commandElements = $commandAst.CommandElements
     $previousWord = if ($commandElements.Count -gt 2) {
         $commandElements[-2].Extent.Text
     } else { '' }
-    
+
     # Model completion
     if ($previousWord -eq '-Model') {
         $script:DevflowModels | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
@@ -131,17 +131,17 @@ Register-ArgumentCompleter -CommandName 'run-collab.ps1', 'run-collab' -Native -
         }
         return
     }
-    
+
     # Agent completion
     if ($previousWord -eq '-Agents') {
         $existingAgents = if ($wordToComplete -match ',') {
             $wordToComplete -replace ',[^,]*$', ','
         } else { '' }
-        
+
         $currentPart = if ($wordToComplete -match ',') {
             ($wordToComplete -split ',')[-1]
         } else { $wordToComplete }
-        
+
         $script:DevflowAgents | Where-Object { $_.Name -like "$currentPart*" } | ForEach-Object {
             [System.Management.Automation.CompletionResult]::new(
                 "$existingAgents$($_.Name)",
@@ -152,7 +152,7 @@ Register-ArgumentCompleter -CommandName 'run-collab.ps1', 'run-collab' -Native -
         }
         return
     }
-    
+
     # Parameter completion
     $params | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object {
         [System.Management.Automation.CompletionResult]::new(
@@ -167,22 +167,22 @@ Register-ArgumentCompleter -CommandName 'run-collab.ps1', 'run-collab' -Native -
 # Helper function to show available commands
 function Get-DevflowCommands {
     @"
-    
+
 Devflow Collaboration Commands
 ==============================
 
 run-story.ps1 / run-story.sh
   Main story runner with collaboration modes
-  
+
   Modes:
     -Swarm        Multi-agent debate/consensus
-    -Pair         DEV + REVIEWER pair programming  
+    -Pair         DEV + REVIEWER pair programming
     -Auto         Intelligent auto-routing (default)
     -Sequential   Traditional sequential pipeline
 
 run-collab.ps1 / run-collab.py
   Direct Python collaboration CLI
-  
+
   Same modes as run-story with additional:
     -Memory       View shared memory
     -Query        Query knowledge graph

package/tooling/completions/_run-story

@@ -1,12 +1,12 @@
 #compdef run-story.sh run-story run-collab.sh run-collab
 
 # Devflow Story Runner Zsh Completion
-# 
+#
 # Installation:
 # 1. Copy this file to a directory in your $fpath (e.g., ~/.zsh/completions/)
 # 2. Add to ~/.zshrc: fpath=(~/.zsh/completions $fpath)
 # 3. Reload: source ~/.zshrc
-# 
+#
 # Or for quick setup, add to ~/.zshrc:
 #   source /path/to/devflow/tooling/completions/_run-story
 
@@ -106,7 +106,7 @@ _run-collab() {
         '--help[Show help]'
 }
 
-# Alias completions  
+# Alias completions
 compdef _run-story run-story.sh
 compdef _run-story run-story
 compdef _run-collab run-collab.py