docs/bugs/ACTIVE_BUGS.md

Active Bugs

Last updated: 2025-11-29

P0 - Blocker

P0 - Simple Mode Never Synthesizes

File: P0_SIMPLE_MODE_NEVER_SYNTHESIZES.md

Symptom: Simple mode finds 455 sources but outputs only citations (no synthesis).

Root Causes:

1. Judge never recommends "synthesize" (prompt too conservative)
2. Confidence drops to 0% in late iterations (context overflow / API failure)
3. Search derails to tangential topics (bone health instead of libido)
4. _generate_partial_synthesis() outputs garbage (just citations, no analysis)

Status: Documented, fix plan ready.

---

P3 - Edge Case

(None)

---

Resolved Bugs

P3 - Magentic Mode Missing Termination Guarantee FIXED

Commit: d36ce3c (2025-11-29)

• Added final_event_received tracking in orchestrator_magentic.py
• Added fallback yield for "max iterations reached" scenario
• Verified with test_magentic_termination.py

P0 - Magentic Mode Report Generation FIXED

Commit: 9006d69 (2025-11-29)

• Fixed _extract_text() to handle various message object formats
• Increased max_rounds=10 (was 3)
• Added temperature=1.0 for reasoning model compatibility
• Advanced mode now produces full research reports

P1 - Streaming Spam + API Key Persistence FIXED

Commit: 0c9be4a (2025-11-29)

• Streaming events now buffered (not token-by-token spam)
• API key persists across example clicks via gr.State
• Examples use explicit None values to avoid overwriting keys

P2 - Missing "Thinking" State FIXED

Commit: 9006d69 (2025-11-29)

• Added "thinking" event type with hourglass icon
• Yields "Multi-agent reasoning in progress..." before blocking workflow call
• Users now see feedback during 2-5 minute initial processing

P2 - Gradio Example Not Filling Chat Box FIXED

Commit: 2ea01fd (2025-11-29)

• Third example (HSDD) wasn't populating chat box when clicked
• Root cause: Parentheses in HSDD (Hypoactive Sexual Desire Disorder)
• Fix: Simplified to Testosterone therapy for Hypoactive Sexual Desire Disorder?

P1 - Gradio Settings Accordion WONTFIX

Decision: Removed nested Blocks, using ChatInterface directly. Accordion behavior is default Gradio - acceptable for demo.

---

How to Report Bugs

1. Create docs/bugs/P{N}_{SHORT_NAME}.md
2. Include: Symptom, Root Cause, Fix Plan, Test Plan
3. Update this index
4. Priority: P0=blocker, P1=important, P2=UX, P3=edge case