{
  "track_id": "rag_phase4_sync_fix_20260610",
  "name": "Fix RAG phase 4 final verify test - sync never reaches 'ready' (2026-06-10)",
  "created_at": "2026-06-10",
  "status": "shipped",
  "priority": "A",
  "blocked_by": [],
  "blocks": [],
  "inherits_from": [
    "conductor/tracks/mma_tier_usage_reset_fix_20260610/"
  ],
  "supersedes": [],
  "domain": "RAG (live_gui integration test)",
  "scope_summary": "One pre-existing bug in src/rag_engine.py or src/app_controller.py: tests/test_rag_phase4_final_verify.py::test_phase4_final_verify fails because rag_status stays at 'idle' after the test sets rag_enabled/rag_source/rag_emb_provider via the Hook API. The _do_rag_sync worker either never runs, never sets the status, or the status is reset before the test polls. Discovered as the out-of-scope failure that halted the tier-3-live_gui batch during the mma_tier_usage_reset_fix_20260610 verification run on 2026-06-10.",
  "estimated_effort": "1-2 hours",
  "phases": 1,
  "verification_criteria": [
    "tests/test_rag_phase4_final_verify.py::test_phase4_final_verify passes in isolation",
    "tests/test_rag_phase4_final_verify.py::test_phase4_final_verify passes in the tier-3-live_gui full batch (or at least gets past it without halting)",
    "tests/test_extended_sims.py::test_context_sim_live still passes in batch (regression check)",
    "All 4 sim tests in tests/test_extended_sims.py still pass in isolation (regression check)"
  ],
  "out_of_scope": [
    "Refactoring _do_rag_sync logic",
    "Changing the RAG test design",
    "Adding new RAG features",
    "Updating documentation",
    "Follow-up tracks"
  ],
  "risks": [
    {
      "risk": "RAG test requires sentence-transformers, which may not be installed",
      "mitigation": "Check installation first; if missing, document the install command and consider marking the test with skipif marker"
    },
    {
      "risk": "The fix might break other RAG tests that depend on the current behavior",
      "mitigation": "Run all RAG tests in the test_rag_*.py files to verify regression"
    }
  ],
  "tier_2_supervision_required_for": []
}
