@pjmendonca/devflow 1.13.2 → 1.18.0

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-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

package/tooling/completions/run-story-completion.bash

@@ -23,10 +23,10 @@ _run_story_completion() {
     COMPREPLY=()
     cur="${COMP_WORDS[COMP_CWORD]}"
     prev="${COMP_WORDS[COMP_CWORD-1]}"
-    
+
     # Main options
     opts="--swarm --pair --auto-route --sequential --agents --max-iterations --model --budget --memory --query --route-only --quiet --debug --dry-run --help"
-    
+
     case "${prev}" in
         --agents|-a)
             # Support comma-separated agent completion
@@ -38,7 +38,7 @@ _run_story_completion() {
                 existing_agents=""
                 current_part="$cur"
             fi
-            
+
             local suggestions=""
             for agent in $_devflow_agents; do
                 if [[ "$agent" == ${current_part}* ]]; then
@@ -67,7 +67,7 @@ _run_story_completion() {
         *)
             ;;
     esac
-    
+
     # Complete options
     if [[ ${cur} == -* ]]; then
         COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
@@ -81,9 +81,9 @@ _run_collab_completion() {
     COMPREPLY=()
     cur="${COMP_WORDS[COMP_CWORD]}"
     prev="${COMP_WORDS[COMP_CWORD-1]}"
-    
+
     opts="--swarm --pair --auto --sequential --agents --max-iterations --model --budget --memory --query --route-only --quiet --help"
-    
+
     case "${prev}" in
         --agents)
             local existing_agents current_part
@@ -94,7 +94,7 @@ _run_collab_completion() {
                 existing_agents=""
                 current_part="$cur"
             fi
-            
+
             local suggestions=""
             for agent in $_devflow_agents; do
                 if [[ "$agent" == ${current_part}* ]]; then
@@ -119,7 +119,7 @@ _run_collab_completion() {
         *)
             ;;
     esac
-    
+
     if [[ ${cur} == -* ]]; then
         COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
         return 0

package/tooling/docs/DOC-STANDARD.md

@@ -1,14 +1,14 @@
-# Documentation Standard - Stronger Project
+# Documentation Standard - Devflow
 
-**Version**: 1.0
-**Last Updated**: 2025-12-20
+**Version**: 1.1
+**Last Updated**: 2025-12-27
 **Applies To**: All documentation in `tooling/docs/`
 
 ---
 
 ## Purpose
 
-This document defines the standard format, structure, and conventions for all documentation in the Stronger project's `tooling/docs/` directory.
+This document defines the standard format, structure, and conventions for all documentation in the Devflow project's `tooling/docs/` directory.
 
 ---
 
@@ -212,26 +212,26 @@ Always include header separator:
 
 ### Alerts/Callouts
 
-Use these emoji conventions:
+Use these text-based conventions (no emojis per project policy):
 
 ```markdown
-  **WARNING**: Important warning
+**[WARNING]**: Important warning
 
- **TIP**: Helpful tip
+**[TIP]**: Helpful tip
 
- **NOTE**: Additional information
+**[NOTE]**: Additional information
 
- **CRITICAL**: Critical information
+**[CRITICAL]**: Critical information
 
- **SUCCESS**: Successful outcome
+**[OK]**: Successful outcome
 
- **ERROR**: Error or failure
+**[ERROR]**: Error or failure
 
-**GOAL**: Objective or target
+**[GOAL]**: Objective or target
 
- **DATA**: Data or statistics
+**[INFO]**: Data or statistics
 
- **TECHNICAL**: Technical details
+**[TECHNICAL]**: Technical details
 ```
 
 ---

package/tooling/docs/templates/migration-spec.md

@@ -96,7 +96,7 @@
 1. **[Change Description 1]**
    - Files affected: `path/to/file`
    - Changes needed: [describe the code changes]
-   
+
 2. **[Change Description 2]**
    - Files affected: `path/to/file`
    - Changes needed: [describe the code changes]
@@ -243,13 +243,13 @@ If automated rollback fails:
 *To be filled after migration*
 
 ### What Went Well
-- 
+-
 
 ### What Could Be Improved
-- 
+-
 
 ### Action Items
-- 
+-
 
 ## Notes
 

package/tooling/scripts/context_checkpoint.py

@@ -25,12 +25,15 @@ from datetime import datetime
 from pathlib import Path
 from typing import Optional
 
+from lib.colors import Colors
+from lib.platform import IS_WINDOWS
+
 # Configuration
 PROJECT_ROOT = Path(__file__).parent.parent.parent
 CHECKPOINT_DIR = PROJECT_ROOT / "tooling" / ".automation" / "checkpoints"
 LOGS_DIR = PROJECT_ROOT / "tooling" / ".automation" / "logs"
 # Platform-specific CLI command
-CLAUDE_CLI = "claude.cmd" if sys.platform == "win32" else "claude"
+CLAUDE_CLI = "claude.cmd" if IS_WINDOWS else "claude"
 
 # Context thresholds
 CONTEXT_WARNING_THRESHOLD = 0.75  # 75% - Start warning
@@ -38,19 +41,6 @@ CONTEXT_CRITICAL_THRESHOLD = 0.85  # 85% - Auto-checkpoint
 CONTEXT_EMERGENCY_THRESHOLD = 0.95  # 95% - Force checkpoint
 
 
-# Colors for terminal output
-class Colors:
-    HEADER = "\033[95m"
-    BLUE = "\033[94m"
-    CYAN = "\033[96m"
-    GREEN = "\033[92m"
-    YELLOW = "\033[93m"
-    RED = "\033[91m"
-    BOLD = "\033[1m"
-    UNDERLINE = "\033[4m"
-    END = "\033[0m"
-
-
 class ContextCheckpointManager:
     """Manages context checkpointing for Claude Code sessions."""
 
@@ -69,7 +59,7 @@ class ContextCheckpointManager:
         # Handle graceful shutdown (Windows-compatible)
         signal.signal(signal.SIGINT, self._signal_handler)
         # SIGTERM is not available on Windows
-        if sys.platform != "win32":
+        if not IS_WINDOWS:
             signal.signal(signal.SIGTERM, self._signal_handler)
 
     def _signal_handler(self, signum, frame):