manual_slop/conductor/tracks/codebase_migration_20260302/plan.md

Implementation Plan: Codebase Migration to src & Cleanup (codebase_migration_20260302)

Phase 1: Unused File Identification & Removal

• Task: Initialize MMA Environment activate_skill mma-orchestrator
• Task: Audit Codebase for Dead Files (1eb9d29)
• Task: Delete Unused Files (1eb9d29)
• [-] Task: Conductor - User Manual Verification 'Phase 1: Unused File Identification & Removal' (SKIPPED)

Phase 2: Directory Restructuring & Migration

• Task: Create src/ Directory
• Task: Move Application Files to src/
• Task: Conductor - User Manual Verification 'Phase 2: Directory Restructuring & Migration' (Protocol in workflow.md)

Phase 3: Entry Point & Import Resolution

• Task: Create sloppy.py Entry Point
  • WHERE: Project root (sloppy.py)
  • WHAT: Create the script to act as the primary launch point. It should import App from src.gui_2 and pass CLI args.
  • HOW: Write a standard Python script wrapper.
  • SAFETY: Ensure it correctly propagates sys.argv.
• Task: Resolve Absolute and Relative Imports
  • WHERE: src/*.py, tests/*.py, simulation/*.py
  • WHAT: Update import statements. E.g., import gui_2 becomes from src import gui_2 or adjust sys.path.append in tests.
  • HOW: Surgical string replacements. Ensure pytest can still find fixtures and test modules.
  • SAFETY: Run uv run pytest to aggressively check for ModuleNotFoundErrors.
• Task: Conductor - User Manual Verification 'Phase 3: Entry Point & Import Resolution' (Protocol in workflow.md)

Phase 4: Final Validation & Documentation

• Task: Full Test Suite Validation
  • WHERE: Project root
  • WHAT: Run uv run pytest. Fix any remaining path resolution issues for logs, artifacts, and configs.
  • HOW: Verify 100% pass rate.
  • SAFETY: Artifacts must still be written to tests/artifacts/.
• Task: Update Core Documentation
  • WHERE: Readme.md, docs/, conductor/tech-stack.md
  • WHAT: Document sloppy.py as the new entry point. Document the src/ directory layout.
  • HOW: Surgical text replacement.
  • SAFETY: Accurate representation of new structure.
• Task: Conductor - User Manual Verification 'Phase 4: Final Validation & Documentation' (Protocol in workflow.md)