feat(sdm): inject structural dependency mapping tags across codebase

Adds [C: caller] tags to functions/methods and [M: mutation] / [U: usage] tags to class variables based on cross-module call analysis.
2026-05-13 22:35:41 -04:00
parent 5bb3a9026f
commit b5e512f483
110 changed files with 1673 additions and 1008 deletions
@@ -48,7 +48,8 @@ from src.dag_engine import TrackDAG, ExecutionEngine
 class WorkerPool:
 """
 
-  Manages a pool of worker threads with a concurrency limit.
+  
+   Manages a pool of worker threads with a concurrency limit.
 """
 def __init__(self, max_workers: int = 4):
  self.max_workers = max_workers
@@ -59,8 +60,9 @@ class WorkerPool:
 def spawn(self, ticket_id: str, target: Callable, args: tuple) -> Optional[threading.Thread]:
  """
  
-    Spawns a new worker thread if the pool is not full.
-    Returns the thread object or None if full.
+    
+      Spawns a new worker thread if the pool is not full.
+      Returns the thread object or None if full.
    [C: tests/test_parallel_execution.py:test_worker_pool_completion_cleanup, tests/test_parallel_execution.py:test_worker_pool_limit, tests/test_parallel_execution.py:test_worker_pool_tracking]
  """
  with self._lock:
@@ -83,7 +85,7 @@ class WorkerPool:

 def join_all(self, timeout: float = None) -> None:
  """
-  [C: tests/test_parallel_execution.py:test_conductor_engine_pool_integration, tests/test_parallel_execution.py:test_worker_pool_limit, tests/test_parallel_execution.py:test_worker_pool_tracking]
+    [C: tests/test_parallel_execution.py:test_conductor_engine_pool_integration, tests/test_parallel_execution.py:test_worker_pool_limit, tests/test_parallel_execution.py:test_worker_pool_tracking]
  """
  with self._lock:
   threads = list(self._active.values())
@@ -94,21 +96,22 @@ class WorkerPool:

 def get_active_count(self) -> int:
  """
-  [C: tests/test_parallel_execution.py:test_conductor_engine_pool_integration, tests/test_parallel_execution.py:test_worker_pool_completion_cleanup, tests/test_parallel_execution.py:test_worker_pool_limit]
+    [C: tests/test_parallel_execution.py:test_conductor_engine_pool_integration, tests/test_parallel_execution.py:test_worker_pool_completion_cleanup, tests/test_parallel_execution.py:test_worker_pool_limit]
  """
  with self._lock:
   return len(self._active)

 def is_full(self) -> bool:
  """
-  [C: tests/test_parallel_execution.py:test_worker_pool_limit]
+    [C: tests/test_parallel_execution.py:test_worker_pool_limit]
  """
  return self.get_active_count() >= self.max_workers

 class ConductorEngine:
 """
 
-     Orchestrates the execution of tickets within a track.
+  
+      Orchestrates the execution of tickets within a track.
 """

 def __init__(self, track: Track, event_queue: Optional[events.AsyncEventQueue] = None, auto_queue: bool = False) -> None:
@@ -148,21 +151,24 @@ class ConductorEngine:

 def pause(self) -> None:
  """
-  Pauses the pipeline execution.
+  
+    Pauses the pipeline execution.
    [C: tests/test_pipeline_pause.py:test_pause_method, tests/test_pipeline_pause.py:test_resume_method]
  """
  self._pause_event.set()

 def resume(self) -> None:
  """
-  Resumes the pipeline execution.
+  
+    Resumes the pipeline execution.
    [C: tests/test_pipeline_pause.py:test_resume_method]
  """
  self._pause_event.clear()

 def approve_task(self, task_id: str) -> None:
  """
-  Manually transition todo to in_progress and mark engine dirty.
+  
+    Manually transition todo to in_progress and mark engine dirty.
    [C: tests/test_execution_engine.py:test_execution_engine_approve_task, tests/test_execution_engine.py:test_execution_engine_step_mode]
  """
  self.engine.approve_task(task_id)
@@ -170,7 +176,8 @@ class ConductorEngine:

 def update_task_status(self, task_id: str, status: str) -> None:
  """
-  Force-update ticket status and mark engine dirty.
+  
+    Force-update ticket status and mark engine dirty.
    [C: tests/test_arch_boundary_phase3.py:TestArchBoundaryPhase3.test_manual_unblock_restores_todo, tests/test_execution_engine.py:test_execution_engine_auto_queue, tests/test_execution_engine.py:test_execution_engine_basic_flow, tests/test_execution_engine.py:test_execution_engine_status_persistence, tests/test_execution_engine.py:test_execution_engine_update_nonexistent_task]
  """
  self.engine.update_task_status(task_id, status)
@@ -178,7 +185,8 @@ class ConductorEngine:

 def kill_worker(self, ticket_id: str) -> None:
  """
-  Sets the abort event for a worker and attempts to join its thread.
+  
+    Sets the abort event for a worker and attempts to join its thread.
    [C: tests/test_conductor_engine_abort.py:test_kill_worker_sets_abort_and_joins_thread]
  """
  if ticket_id in self._abort_events:
@@ -213,8 +221,9 @@ class ConductorEngine:
 def parse_json_tickets(self, json_str: str) -> None:
  """
  
-          Parses a JSON string of ticket definitions (Godot ECS Flat List format)
-          and populates the Track's ticket list.
+    
+            Parses a JSON string of ticket definitions (Godot ECS Flat List format)
+            and populates the Track's ticket list.
    [C: tests/test_conductor_engine_v2.py:test_conductor_engine_dynamic_parsing_and_execution, tests/test_orchestration_logic.py:test_conductor_engine_parse_json_tickets]
  """
  try:
@@ -244,11 +253,12 @@ class ConductorEngine:
 def run(self, md_content: str = "", max_ticks: Optional[int] = None) -> None:
  """
  
-          Main execution loop using the DAG engine.
-          Args:
-              md_content: The full markdown context (history + files) for AI workers.
-              max_ticks: Optional limit on number of iterations (for testing).
-    [C: simulation/sim_base.py:run_sim, src/project_manager.py:get_git_commit, src/project_manager.py:get_git_log, src/rag_engine.py:RAGEngine._search_mcp, src/shell_runner.py:run_powershell, tests/conftest.py:kill_process_tree, tests/conftest.py:live_gui, tests/test_conductor_abort_event.py:test_conductor_abort_event_populated, tests/test_conductor_engine_v2.py:test_conductor_engine_dynamic_parsing_and_execution, tests/test_conductor_engine_v2.py:test_conductor_engine_run_executes_tickets_in_order, tests/test_extended_sims.py:test_ai_settings_sim_live, tests/test_extended_sims.py:test_context_sim_live, tests/test_extended_sims.py:test_execution_sim_live, tests/test_extended_sims.py:test_tools_sim_live, tests/test_external_editor_gui.py:get_vscode_processes, tests/test_external_editor_gui.py:test_vscode_launches_with_diff_view, tests/test_gui_custom_window.py:test_app_window_is_borderless, tests/test_headless_simulation.py:module, tests/test_headless_verification.py:test_headless_verification_error_and_qa_interceptor, tests/test_headless_verification.py:test_headless_verification_full_run, tests/test_mock_gemini_cli.py:run_mock, tests/test_orchestration_logic.py:test_conductor_engine_run, tests/test_parallel_execution.py:test_conductor_engine_pool_integration, tests/test_sim_ai_settings.py:test_ai_settings_simulation_run, tests/test_sim_context.py:test_context_simulation_run, tests/test_sim_execution.py:test_execution_simulation_run, tests/test_sim_tools.py:test_tools_simulation_run]
+    
+            Main execution loop using the DAG engine.
+            Args:
+                md_content: The full markdown context (history + files) for AI workers.
+                max_ticks: Optional limit on number of iterations (for testing).
+    [C: simulation/sim_base.py:run_sim, src/project_manager.py:get_git_commit, src/rag_engine.py:RAGEngine._search_mcp, src/shell_runner.py:run_powershell, tests/conftest.py:kill_process_tree, tests/conftest.py:live_gui, tests/test_conductor_abort_event.py:test_conductor_abort_event_populated, tests/test_conductor_engine_v2.py:test_conductor_engine_dynamic_parsing_and_execution, tests/test_conductor_engine_v2.py:test_conductor_engine_run_executes_tickets_in_order, tests/test_extended_sims.py:test_ai_settings_sim_live, tests/test_extended_sims.py:test_context_sim_live, tests/test_extended_sims.py:test_execution_sim_live, tests/test_extended_sims.py:test_tools_sim_live, tests/test_external_editor_gui.py:get_vscode_processes, tests/test_external_editor_gui.py:test_vscode_launches_with_diff_view, tests/test_gui_custom_window.py:test_app_window_is_borderless, tests/test_headless_simulation.py:module, tests/test_headless_verification.py:test_headless_verification_error_and_qa_interceptor, tests/test_headless_verification.py:test_headless_verification_full_run, tests/test_mock_gemini_cli.py:run_mock, tests/test_orchestration_logic.py:test_conductor_engine_run, tests/test_parallel_execution.py:test_conductor_engine_pool_integration, tests/test_sim_ai_settings.py:test_ai_settings_simulation_run, tests/test_sim_context.py:test_context_simulation_run, tests/test_sim_execution.py:test_execution_simulation_run, tests/test_sim_tools.py:test_tools_simulation_run]
  """
  tick_count = 0
  while True:
@@ -368,7 +378,8 @@ def _queue_put(event_queue: events.AsyncEventQueue, event_name: str, payload) ->
 def confirm_execution(payload: str, event_queue: events.AsyncEventQueue, ticket_id: str) -> bool:
 """
 
-     Pushes an approval request to the GUI and waits for response.
+  
+      Pushes an approval request to the GUI and waits for response.
 """
 dialog_container = [None]
 task = {
@@ -391,8 +402,9 @@ def confirm_execution(payload: str, event_queue: events.AsyncEventQueue, ticket_
 def confirm_spawn(role: str, prompt: str, context_md: str, event_queue: events.AsyncEventQueue, ticket_id: str) -> Tuple[bool, str, str]:
 """
 
-     Pushes a spawn approval request to the GUI and waits for response.
-     Returns (approved, modified_prompt, modified_context)
+  
+      Pushes a spawn approval request to the GUI and waits for response.
+      Returns (approved, modified_prompt, modified_context)
  [C: tests/test_spawn_interception_v2.py:run_confirm]
 """
 dialog_container = [None]
@@ -432,15 +444,16 @@ def confirm_spawn(role: str, prompt: str, context_md: str, event_queue: events.A
 def run_worker_lifecycle(ticket: Ticket, context: WorkerContext, context_files: List[str] | None = None, event_queue: events.AsyncEventQueue | None = None, engine: Optional['ConductorEngine'] = None, md_content: str = "") -> None:
 """
 
-     Simulates the lifecycle of a single agent working on a ticket.
-     Calls the AI client and updates the ticket status based on the response.
-     Args:
-         ticket: The ticket to process.
-         context: The worker context.
-         context_files: List of files to include in the context.
-         event_queue: Queue for pushing state updates and receiving approvals.
-         engine: The conductor engine.
-         md_content: The markdown context (history + files) for AI workers.
+  
+      Simulates the lifecycle of a single agent working on a ticket.
+      Calls the AI client and updates the ticket status based on the response.
+      Args:
+          ticket: The ticket to process.
+          context: The worker context.
+          context_files: List of files to include in the context.
+          event_queue: Queue for pushing state updates and receiving approvals.
+          engine: The conductor engine.
+          md_content: The markdown context (history + files) for AI workers.
  [C: tests/test_conductor_engine_v2.py:test_run_worker_lifecycle_calls_ai_client_send, tests/test_conductor_engine_v2.py:test_run_worker_lifecycle_context_injection, tests/test_conductor_engine_v2.py:test_run_worker_lifecycle_handles_blocked_response, tests/test_conductor_engine_v2.py:test_run_worker_lifecycle_pushes_response_via_queue, tests/test_conductor_engine_v2.py:test_run_worker_lifecycle_step_mode_confirmation, tests/test_conductor_engine_v2.py:test_run_worker_lifecycle_step_mode_rejection, tests/test_conductor_engine_v2.py:test_run_worker_lifecycle_token_usage_from_comms_log, tests/test_context_pruner.py:test_token_reduction_logging, tests/test_orchestration_logic.py:test_run_worker_lifecycle_blocked, tests/test_phase6_engine.py:test_worker_streaming_intermediate, tests/test_run_worker_lifecycle_abort.py:TestRunWorkerLifecycleAbort.test_run_worker_lifecycle_returns_early_on_abort, tests/test_spawn_interception_v2.py:test_run_worker_lifecycle_approved, tests/test_spawn_interception_v2.py:test_run_worker_lifecycle_rejected, tests/test_tiered_aggregation.py:test_run_worker_lifecycle_uses_strategy]
 """
 # Enforce Context Amnesia: each ticket starts with a clean slate.
@@ -645,4 +658,4 @@ def run_worker_lifecycle(ticket: Ticket, context: WorkerContext, context_files:
 
 if event_queue:
  _queue_put(event_queue, "ticket_completed", {"ticket_id": ticket.id, "timestamp": time.time()})
- return response
+ return response