chore(conductor): Add debrief for botched tech debt track

This commit is contained in:
2026-03-02 22:02:10 -05:00
parent 72000c18d5
commit 5c6e93e1dd

View File

@@ -0,0 +1,42 @@
# Track Debrief: Tech Debt & Test Discipline Cleanup (tech_debt_and_test_cleanup_20260302)
## Status: Botched / Partially Resolved
**CRITICAL NOTE:** This track was initialized with a flawed specification and executed with insufficient validation rigor. While some deduplication goals were achieved, it introduced significant regressions and left the test suite in a fractured state.
### 1. Specification Failures
- **Incorrect "Dead Code" Identification:** The spec incorrectly marked essential FastAPI endpoints (Remote Confirmation Protocol) as "leftovers." Removing them broke `test_headless_service.py` and the application's documented headless features. These had to be re-added mid-track.
- **Underestimated Dependency Complexity:** The spec assumed `app_instance` could be globally centralized without accounting for unique patching requirements in several files (e.g., `test_gui2_events.py`, `test_mma_dashboard_refresh.py`).
### 2. Removed / Modified Tests
- **Deleted:** `tests/test_ast_parser_curated.py` (Confirmed as a duplicate of `tests/test_ast_parser.py`).
- **Fixture Removal:** Local `app_instance` and `mock_app` fixtures were removed from the following files, now resolving from `tests/conftest.py`:
- `tests/test_gui2_layout.py`
- `tests/test_gui2_mcp.py`
- `tests/test_gui_phase3.py`
- `tests/test_gui_phase4.py`
- `tests/test_gui_streaming.py`
- `tests/test_live_gui_integration.py`
- `tests/test_mma_agent_focus_phase1.py`
- `tests/test_mma_agent_focus_phase3.py`
- `tests/test_mma_orchestration_gui.py`
- `tests/test_mma_ticket_actions.py`
- `tests/test_token_viz.py`
### 3. Exposed Zero-Assertion Tests (Marked with `pytest.fail`)
The following tests now fail loudly to prevent false-positive coverage:
- `tests/test_agent_capabilities.py`
- `tests/test_agent_tools_wiring.py`
- `tests/test_api_events.py::test_send_emits_events`
- `tests/test_execution_engine.py::test_execution_engine_update_nonexistent_task`
- `tests/test_token_usage.py`
- `tests/test_vlogger_availability.py`
### 4. Known Regressions / Unresolved Issues
- **Simulation Failures:** `test_extended_sims.py::test_context_sim_live` fails with `AssertionError: Expected at least 2 entries, found 0`.
- **Asyncio RuntimeErrors:** Widespread `RuntimeError: Event loop is closed` warnings and potential hangs in `test_spawn_interception.py` (partially addressed but not fully stable).
- **Broken Logic:** The centralization of fixtures may have masked subtle timing issues in UI event processing that were previously "fixed" by local, idiosyncratic patches.
### 5. Guidance for Tier 1 / Next Track
- **Immediate Priority:** The next track MUST focus on "unfucking" the testing suite. Do not attempt further feature implementation until the `Event loop is closed` errors and simulation failures are resolved.
- **Audit Requirement:** Re-audit all files where fixtures were removed to ensure no side-effect-heavy patches were lost.
- **Validation Mandate:** Future Tech Lead agents MUST be forbidden from claiming "passed perfectly" without a verifiable, green `pytest` output for the full suite.