hopefully done refining

conductor/tracks/pipeline_pause_resume_20260306/plan.md

@@ -1,32 +1,68 @@
 # Implementation Plan: Pipeline Pause/Resume (pipeline_pause_resume_20260306)
 
+> **Reference:** [Spec](./spec.md) | [Architecture Guide](../../../docs/guide_architecture.md)
+
 ## Phase 1: Pause Mechanism
-- [ ] Task: Initialize MMA Environment
-- [ ] Task: Add pause state
-    - WHERE: src/multi_agent_conductor.py
-    - WHAT: Global pause flag
-    - HOW: threading.Event
-- [ ] Task: Implement pause
-    - WHERE: src/multi_agent_conductor.py
-    - WHAT: Stop worker spawning
-    - HOW: Check pause flag
+Focus: Add pause event to ConductorEngine
 
-## Phase 2: Resume Mechanism
-- [ ] Task: Implement resume
-    - WHERE: src/multi_agent_conductor.py
-    - WHAT: Continue from pause
-    - HOW: Clear flag, restart workers
+- [ ] Task 1.1: Initialize MMA Environment
+- [ ] Task 1.2: Add pause event to ConductorEngine
+    - WHERE: `src/multi_agent_conductor.py` `ConductorEngine.__init__`
+    - WHAT: Threading event for pause control
+    - HOW:
+      ```python
+      self._pause_event: threading.Event = threading.Event()
+      ```
 
-## Phase 3: UI
-- [ ] Task: Add pause button
-    - WHERE: src/gui_2.py
-    - WHAT: Toggle pause state
-    - HOW: imgui.button
-- [ ] Task: Add visual indicator
-    - WHERE: src/gui_2.py
-    - WHAT: Show paused status
-    - HOW: Banner or icon
+- [ ] Task 1.3: Check pause in run loop
+    - WHERE: `src/multi_agent_conductor.py` `run()`
+    - WHAT: Wait while paused
+    - HOW:
+      ```python
+      while True:
+       if self._pause_event.is_set():
+        time.sleep(0.5)
+        continue
+       # Normal processing...
+      ```
 
-## Phase 4: Verification
-- [ ] Test pause/resume
-- [ ] Conductor - Phase Verification
+## Phase 2: Pause/Resume Methods
+Focus: Add control methods
+
+- [ ] Task 2.1: Add pause method
+    - WHERE: `src/multi_agent_conductor.py`
+    - HOW: `self._pause_event.set()`
+
+- [ ] Task 2.2: Add resume method
+    - WHERE: `src/multi_agent_conductor.py`
+    - HOW: `self._pause_event.clear()`
+
+## Phase 3: UI Controls
+Focus: Add pause/resume buttons
+
+- [ ] Task 3.1: Add pause/resume button
+    - WHERE: `src/gui_2.py` MMA dashboard
+    - WHAT: Toggle button for pause state
+    - HOW:
+      ```python
+      is_paused = engine._pause_event.is_set()
+      label = "Resume" if is_paused else "Pause"
+      if imgui.button(label):
+       if is_paused:
+        engine.resume()
+       else:
+        engine.pause()
+      ```
+
+- [ ] Task 3.2: Add visual indicator
+    - WHERE: `src/gui_2.py`
+    - WHAT: Banner or color when paused
+    - HOW:
+      ```python
+      if engine._pause_event.is_set():
+       imgui.text_colored(vec4(255, 200, 100, 255), "PIPELINE PAUSED")
+      ```
+
+## Phase 4: Testing
+- [ ] Task 4.1: Write unit tests
+- [ ] Task 4.2: Conductor - Phase Verification