@pjmendonca/devflow 1.19.0 → 1.20.1

package/tooling/scripts/new-doc.py

@@ -21,7 +21,7 @@ from pathlib import Path
 SCRIPT_DIR = Path(__file__).parent
 sys.path.insert(0, str(SCRIPT_DIR / "lib"))
 
-from platform import get_platform
+from lib.platform import get_platform
 
 
 def run_windows(args):

package/tooling/scripts/run-collab.py

@@ -5,7 +5,6 @@ Collaborative Story Runner - Unified CLI for Agent Collaboration
 Integrates all collaboration features:
 - Agent routing (auto-select best agents)
 - Swarm mode (multi-agent debate)
-- Pair programming (DEV + REVIEWER interleaved)
 - Shared memory and knowledge graph
 - Automatic handoffs
 
@@ -15,13 +14,11 @@ Usage:
 Modes:
     --auto          Auto-route to best agents (default)
     --swarm         Multi-agent debate/consensus
-    --pair          DEV + REVIEWER pair programming
     --sequential    Traditional sequential pipeline
 
 Examples:
     python run-collab.py 3-5 --auto
     python run-collab.py 3-5 --swarm --agents ARCHITECT,DEV,REVIEWER
-    python run-collab.py 3-5 --pair
     python run-collab.py "fix login bug" --auto
 """
 
@@ -38,10 +35,10 @@ from typing import Optional
 SCRIPT_DIR = Path(__file__).parent
 sys.path.insert(0, str(SCRIPT_DIR / "lib"))
 
-from platform import IS_MACOS, IS_WINDOWS
-
 from colors import Colors
 
+from lib.platform import IS_MACOS, IS_WINDOWS
+
 
 def detect_claude_cli() -> Optional[str]:
     """Detect Claude CLI across platforms.
@@ -158,7 +155,6 @@ def get_cache_dir() -> Path:
 # Import collaboration modules
 from lib.agent_handoff import HandoffGenerator, create_handoff  # noqa: E402
 from lib.agent_router import AgentRouter, RoutingResult  # noqa: E402
-from lib.pair_programming import PairConfig, PairSession  # noqa: E402
 from lib.shared_memory import get_knowledge_graph, get_shared_memory, share_learning  # noqa: E402
 from lib.swarm_orchestrator import ConsensusType, SwarmConfig, SwarmOrchestrator  # noqa: E402
 
@@ -182,7 +178,7 @@ def print_banner():
 {Colors.CYAN}╔═══════════════════════════════════════════════════════════════╗
 ║        DEVFLOW COLLABORATIVE STORY RUNNER                     ║
 ╠═══════════════════════════════════════════════════════════════╣
-║  Multi-agent collaboration with swarm, pair, and auto-routing ║
+║  Multi-agent collaboration with swarm and auto-routing        ║
 ╚═══════════════════════════════════════════════════════════════╝{Colors.END}
 """)
 
@@ -213,9 +209,6 @@ def run_auto_mode(story_key: str, task: str, args: argparse.Namespace):
     if result.workflow == "swarm":
         print(f"\n{Colors.YELLOW}-> Using swarm mode for multi-agent collaboration{Colors.END}")
         return run_swarm_mode(story_key, task, result.agents, args)
-    elif result.workflow == "pair":
-        print(f"\n{Colors.YELLOW}-> Using pair programming mode{Colors.END}")
-        return run_pair_mode(story_key, task, args)
     else:
         print(f"\n{Colors.YELLOW}-> Using sequential execution{Colors.END}")
         return run_sequential_mode(story_key, task, result.agents, args)
@@ -245,29 +238,6 @@ def run_swarm_mode(story_key: str, task: str, agents: list[str], args: argparse.
     return result
 
 
-def run_pair_mode(story_key: str, task: str, args: argparse.Namespace):
-    """Run pair programming mode."""
-    print_section("Pair Programming Mode", "DEV + REVIEWER interleaved")
-
-    config = PairConfig(
-        max_revisions_per_chunk=args.max_revisions,
-        verbose=not args.quiet,
-        dev_model=args.model,
-        reviewer_model=args.model,
-    )
-
-    session = PairSession(story_key, task, config)
-    result = session.run()
-
-    # Print result
-    print(f"\n{Colors.GREEN}{result.to_summary()}{Colors.END}")
-
-    # Save result
-    save_result(story_key, "pair", result.to_dict())
-
-    return result
-
-
 def run_sequential_mode(story_key: str, task: str, agents: list[str], args: argparse.Namespace):
     """Run sequential agent execution with handoffs."""
     print_section("Sequential Mode", f"Pipeline: {' -> '.join(agents)}")
@@ -400,7 +370,6 @@ def parse_args():
 Examples:
   python run-collab.py 3-5 --auto
   python run-collab.py 3-5 --swarm --agents ARCHITECT,DEV,REVIEWER
-  python run-collab.py 3-5 --pair --max-revisions 3
   python run-collab.py "fix login bug" --auto
   python run-collab.py 3-5 --memory      # Show shared memory
   python run-collab.py 3-5 --query "What did ARCHITECT decide about auth?"
@@ -416,7 +385,6 @@ Examples:
         "--auto", action="store_true", default=True, help="Auto-route to best agents (default)"
     )
     mode_group.add_argument("--swarm", action="store_true", help="Multi-agent swarm/debate mode")
-    mode_group.add_argument("--pair", action="store_true", help="DEV + REVIEWER pair programming")
     mode_group.add_argument(
         "--sequential", action="store_true", help="Traditional sequential pipeline"
     )
@@ -448,14 +416,6 @@ Examples:
     )
     parser.add_argument("--parallel", action="store_true", help="Enable parallel agent execution")
 
-    # Pair programming options
-    parser.add_argument(
-        "--max-revisions",
-        type=int,
-        default=3,
-        help="Max revisions per chunk in pair mode (default: 3)",
-    )
-
     # General options
     parser.add_argument(
         "--model",
@@ -601,10 +561,6 @@ def main():
                 agents = ["ARCHITECT", "DEV", "REVIEWER"]
             run_swarm_mode(story_key, task, agents, args)
 
-        elif args.pair:
-            print("Pair Programming")
-            run_pair_mode(story_key, task, args)
-
         elif args.sequential:
             print("Sequential")
             if not agents:

package/tooling/scripts/run-story.py

@@ -39,13 +39,13 @@ SCRIPT_DIR = Path(__file__).parent
 # Add lib directory for imports
 sys.path.insert(0, str(SCRIPT_DIR / "lib"))
 
-from platform import IS_WINDOWS, get_platform
-
 from colors import Colors
 
+from lib.platform import IS_WINDOWS, get_platform
+
 # Try to import context monitor
 try:
-    from context_monitor import ContextMonitor, StatusLine, get_status_manager
+    from context_monitor import ContextMonitor, StatusLine
 
     HAS_CONTEXT_MONITOR = True
 except ImportError:
@@ -208,11 +208,15 @@ class NativeRunner:
             print("Recommendation: Save checkpoint NOW and clear session.")
             self._trigger_auto_checkpoint("emergency")
         elif level == ContextLevel.CRITICAL:
-            print(f"\n{Colors.BOLD_RED}[CRITICAL]{Colors.RESET} Context at {state.context_usage_percent:.0f}%")
+            print(
+                f"\n{Colors.BOLD_RED}[CRITICAL]{Colors.RESET} Context at {state.context_usage_percent:.0f}%"
+            )
             print("Recommendation: Consider wrapping up and checkpointing soon.")
             self._trigger_auto_checkpoint("critical")
         elif level == ContextLevel.WARNING:
-            print(f"\n{Colors.YELLOW}[WARNING]{Colors.RESET} Context at {state.context_usage_percent:.0f}%")
+            print(
+                f"\n{Colors.YELLOW}[WARNING]{Colors.RESET} Context at {state.context_usage_percent:.0f}%"
+            )
             print(f"~{state.exchanges_remaining} exchanges remaining before compaction.")
 
     def _trigger_auto_checkpoint(self, reason: str):
@@ -223,7 +227,9 @@ class NativeRunner:
             from context_checkpoint import ContextCheckpointManager
 
             manager = ContextCheckpointManager()
-            context_level = self.context_monitor.state.context_usage_ratio if self.context_monitor else 0.0
+            context_level = (
+                self.context_monitor.state.context_usage_ratio if self.context_monitor else 0.0
+            )
             checkpoint_file = manager.create_checkpoint(context_level, reason=reason)
             print(f"[CHECKPOINT] Saved to: {checkpoint_file.name}")
 
@@ -438,11 +444,15 @@ class NativeRunner:
         # Print header with status line
         print(f"{Colors.DIM}{'─' * 70}{Colors.RESET}")
         print(f"{Colors.BOLD}DEVFLOW STORY RUNNER{Colors.RESET}")
-        print(f"Story: {self.args.story_key} | Model: {self.args.model} | Budget: ${self.args.budget:.2f}")
+        print(
+            f"Story: {self.args.story_key} | Model: {self.args.model} | Budget: ${self.args.budget:.2f}"
+        )
         if self.validation_enabled:
             print("Validation: Enabled")
         if self.context_monitor:
-            print(f"Context Monitor: Active (window: {self.context_monitor.state.context_window:,} tokens)")
+            print(
+                f"Context Monitor: Active (window: {self.context_monitor.state.context_window:,} tokens)"
+            )
         print(f"{Colors.DIM}{'─' * 70}{Colors.RESET}")
         print()
 
@@ -470,7 +480,9 @@ class NativeRunner:
 
             # Set initial activity state
             if self.context_monitor:
-                self.context_monitor.set_current_activity(total_phases=total_phases, phases_completed=0)
+                self.context_monitor.set_current_activity(
+                    total_phases=total_phases, phases_completed=0
+                )
 
             # Context phase
             if run_context:

package/tooling/scripts/setup-checkpoint-service.py

@@ -24,7 +24,7 @@ from pathlib import Path
 SCRIPT_DIR = Path(__file__).parent
 sys.path.insert(0, str(SCRIPT_DIR / "lib"))
 
-from platform import get_platform
+from lib.platform import get_platform
 
 
 def run_windows(action):

package/.claude/commands/pair.md

@@ -1,23 +0,0 @@
----
-description: Run pair programming mode (DEV + REVIEWER interleaved)
-argument-hint: <story-key>
----
-
-Run Devflow pair programming for: $ARGUMENTS
-
-Execute: `npx @pjmendonca/devflow pair $ARGUMENTS`
-
-This runs DEV and REVIEWER in an interleaved pair programming mode:
-- DEV implements code in small, reviewable chunks
-- REVIEWER provides immediate feedback after each chunk
-- DEV addresses issues before continuing to next chunk
-- Results in higher quality code with fewer late-stage revisions
-
-Benefits:
-- Real-time feedback loops during implementation
-- Issues caught early, not at final review
-- Better knowledge sharing between agents
-- Higher approval rates
-
-Example:
-- `/pair 3-5` - Run pair programming for story 3-5