refactor(types): auto -> None sweep across entire codebase

Applied 236 return type annotations to functions with no return values
across 100+ files (core modules, tests, scripts, simulations).
Added Phase 4 to python_style_refactor track for remaining 597 items
(untyped params, vars, and functions with return values).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

conductor/tests/test_infrastructure.py

@@ -18,7 +18,7 @@ def run_ps_script(role, prompt):
   print(f"\n[Sub-Agent {role} Error]:\n{result.stderr}")
  return result
 
-def test_subagent_script_qa_live():
+def test_subagent_script_qa_live() -> None:
  """Verify that the QA role works and returns a compressed fix."""
  prompt = "Traceback (most recent call last): File 'test.py', line 1, in <module> 1/0 ZeroDivisionError: division by zero"
  result = run_ps_script("QA", prompt)
@@ -28,7 +28,7 @@ def test_subagent_script_qa_live():
  # It should be short (QA agents compress)
  assert len(result.stdout.split()) < 40
 
-def test_subagent_script_worker_live():
+def test_subagent_script_worker_live() -> None:
  """Verify that the Worker role works and returns code."""
  prompt = "Write a python function that returns 'hello world'"
  result = run_ps_script("Worker", prompt)
@@ -36,14 +36,14 @@ def test_subagent_script_worker_live():
  assert "def" in result.stdout.lower()
  assert "hello" in result.stdout.lower()
 
-def test_subagent_script_utility_live():
+def test_subagent_script_utility_live() -> None:
  """Verify that the Utility role works."""
  prompt = "Tell me 'True' if 1+1=2, otherwise 'False'"
  result = run_ps_script("Utility", prompt)
  assert result.returncode == 0
  assert "true" in result.stdout.lower()
 
-def test_subagent_isolation_live():
+def test_subagent_isolation_live() -> None:
  """Verify that the sub-agent is stateless and does not see the parent's conversation context."""
  # This prompt asks the sub-agent about a 'secret' mentioned only here, not in its prompt.
  prompt = "What is the secret code I just told you? If I didn't tell you, say 'UNKNOWN'."

conductor/tests/test_mma_exec.py

@@ -3,7 +3,7 @@ import os
 from unittest.mock import patch, MagicMock
 from scripts.mma_exec import create_parser, get_role_documents, execute_agent, get_model_for_role, get_dependencies
 
-def test_parser_role_choices():
+def test_parser_role_choices() -> None:
  """Test that the parser accepts valid roles and the prompt argument."""
  parser = create_parser()
  valid_roles = ['tier1', 'tier2', 'tier3', 'tier4']
@@ -13,13 +13,13 @@ def test_parser_role_choices():
   assert args.role == role
   assert args.prompt == test_prompt
 
-def test_parser_invalid_role():
+def test_parser_invalid_role() -> None:
  """Test that the parser rejects roles outside the specified choices."""
  parser = create_parser()
  with pytest.raises(SystemExit):
   parser.parse_args(['--role', 'tier5', 'Some prompt'])
 
-def test_parser_prompt_optional():
+def test_parser_prompt_optional() -> None:
  """Test that the prompt argument is optional if role is provided (or handled in main)."""
  parser = create_parser()
  # Prompt is now optional (nargs='?')
@@ -27,28 +27,28 @@ def test_parser_prompt_optional():
  assert args.role == 'tier3'
  assert args.prompt is None
 
-def test_parser_help():
+def test_parser_help() -> None:
  """Test that the help flag works without raising errors (exits with 0)."""
  parser = create_parser()
  with pytest.raises(SystemExit) as excinfo:
   parser.parse_args(['--help'])
  assert excinfo.value.code == 0
 
-def test_get_role_documents():
+def test_get_role_documents() -> None:
  """Test that get_role_documents returns the correct documentation paths for each tier."""
  assert get_role_documents('tier1') == ['conductor/product.md', 'conductor/product-guidelines.md']
  assert get_role_documents('tier2') == ['conductor/tech-stack.md', 'conductor/workflow.md']
  assert get_role_documents('tier3') == ['conductor/workflow.md']
  assert get_role_documents('tier4') == []
 
-def test_get_model_for_role():
+def test_get_model_for_role() -> None:
  """Test that get_model_for_role returns the correct model for each role."""
  assert get_model_for_role('tier1-orchestrator') == 'gemini-3.1-pro-preview'
  assert get_model_for_role('tier2-tech-lead') == 'gemini-2.5-flash-lite'
  assert get_model_for_role('tier3-worker') == 'gemini-2.5-flash-lite'
  assert get_model_for_role('tier4-qa') == 'gemini-2.5-flash-lite'
 
-def test_execute_agent():
+def test_execute_agent() -> None:
  """
     Test that execute_agent calls subprocess.run with powershell and the correct gemini CLI arguments
     including the model specified for the role.

conductor/tests/test_mma_skeleton.py

@@ -1,7 +1,7 @@
 import pytest
 from scripts.mma_exec import generate_skeleton
 
-def test_generate_skeleton():
+def test_generate_skeleton() -> None:
  sample_code = '''
 class Calculator:
     """Performs basic math operations."""

conductor/tracks/python_style_refactor_20260227/plan.md

@@ -21,6 +21,14 @@
 - [x] Task: Conductor - Update `conductor/code_styleguides/python.md` with the new AI-optimized standard. [602cea6]
 - [x] Task: Conductor - User Manual Verification 'Phase 3: Metadata and Final Documentation' (Protocol in workflow.md)
 
+## Phase 4: Codebase-Wide Type Hint Sweep
+- [ ] Task: Conductor - Type hint pass on core modules (`api_hook_client.py`, `api_hooks.py`, `log_registry.py`, `performance_monitor.py`, `theme.py`, `theme_2.py`, `gemini_cli_adapter.py`, `multi_agent_conductor.py`, `dag_engine.py`, `events.py`, `file_cache.py`, `models.py`, `log_pruner.py`, `gemini.py`, `orchestrator_pm.py`, `conductor_tech_lead.py`, `outline_tool.py`, `summarize.py`)
+- [ ] Task: Conductor - Type hint pass on remaining variable-only files (`ai_client.py` vars, `mcp_client.py` vars, `mma_prompts.py` vars)
+- [ ] Task: Conductor - Type hint pass on scripts (`scripts/*.py`)
+- [ ] Task: Conductor - Type hint pass on simulation modules (`simulation/*.py`)
+- [ ] Task: Conductor - Type hint pass on test files (`tests/*.py`, `conductor/tests/*.py`)
+- [ ] Task: Conductor - User Manual Verification 'Phase 4: Codebase-Wide Type Hint Sweep' (Protocol in workflow.md)
+
 ---
 
 **Protocol Note:** Each task will follow the Standard Task Workflow (Red/Green phases with Tier 3 Worker delegation). Phase completion will trigger the mandatory Verification and Checkpointing protocol.