docs: Organize and archive resolved bug documentation

Archive resolved bugs to docs/bugs/archive/:
- P0: Repr bug, AIFunction serialization, HF tool calling, synthesis issues
- P1: HuggingFace 401/500 errors, chain-of-thought, synthesis fallback
- P2: Cold start feedback, BYOK gaps

Move analysis docs to appropriate folders:
- HF_FREE_TIER_ANALYSIS.md → docs/architecture/
- TOOL_ANALYSIS_CRITICAL.md → docs/future-roadmap/
- P3_REMOVE_ANTHROPIC_PARTIAL_WIRING.md → docs/future-roadmap/

Active bugs remaining:
- P2: 7B model garbage output (investigating)
- P3: Progress bar positioning (low priority)

docs/bugs/ACTIVE_BUGS.md

@@ -1,167 +1,77 @@
 # Active Bugs
 
-> Last updated: 2025-12-02 (07:30 EST)
+> Last updated: 2025-12-03
 >
 > **Note:** Completed bug docs archived to `docs/bugs/archive/`
-> **See also:** [Code Quality Audit Findings (2025-11-30)](AUDIT_FINDINGS_2025_11_30.md)
 > **See also:** [ARCHITECTURE.md](../ARCHITECTURE.md) for unified architecture plan
 
-## P1 - High (ACTIVE)
-
-### HuggingFace Novita Provider 500 Error
-
-**File:** `docs/bugs/P1_HUGGINGFACE_NOVITA_500_ERROR.md`
-**Status:** ACTIVE - Upstream Infrastructure Issue
-
-**Problem:** Free tier (no API key) fails with 500 error from Novita provider.
-
-**Cause:** HuggingFace routes Qwen/Qwen2.5-72B-Instruct to Novita (third-party), and Novita is returning 500 errors.
-
-**Fix Options:**
-1. Switch to a model hosted natively by HuggingFace
-2. Implement fallback model logic
-3. Wait for Novita to fix their infrastructure
-
 ---
 
-## Resolved Bugs
-
-### ~~P0 - Repr Bug (Display Garbage)~~ FIXED
-
-**File:** `P0_REPR_BUG_ROOT_CAUSE_ANALYSIS.md`, `docs/specs/SPEC_17_ACCUMULATOR_PATTERN.md`
-**Found:** 2025-12-01
-**Resolved:** 2025-12-02 (PR #117)
-
-- Problem: Free tier showed `<agent_framework._types.ChatMessage object at 0x...>` instead of text
-- Root Cause: We were using API incorrectly - reading from `MagenticAgentMessageEvent.message` instead of `MagenticAgentDeltaEvent.text`
-- Fix: Implemented **Accumulator Pattern** (SPEC-17) - bypasses the upstream bug by using the API correctly
-- Note: Upstream fix (PR #2566) is now moot - we don't need it anymore
-
-### ~~P0 - AIFunction Not JSON Serializable~~ FIXED
-
-**File:** `docs/bugs/P0_AIFUNCTION_NOT_JSON_SERIALIZABLE.md`
-**Found:** 2025-12-01
-**Resolved:** 2025-12-01
-
-- Problem: `HuggingFaceChatClient` crashed with "Object of type AIFunction is not JSON serializable".
-- Fix: Implemented full bi-directional tool support:
-    1. **Serialization**: Added `_convert_tools` (AIFunction → OpenAI JSON)
-    2. **Parsing (Sync/Async)**: Added `_parse_tool_calls` and streaming accumulator
-- Result: Free Tier now supports full function calling capabilities with Qwen2.5-72B.
-
-### ~~P1 - HuggingFace Router 401 Unauthorized~~ FIXED
-
-**File:** `docs/bugs/P1_HUGGINGFACE_ROUTER_401_HYPERBOLIC.md`
-**Found:** 2025-12-01
-**Resolved:** 2025-12-01
-
-- Problem: 401 errors from HuggingFace Router (Hyperbolic/Novita providers)
-- **Actual Root Cause:** HF_TOKEN in `.env` and Spaces secrets was **invalid/expired**
-- Fix: Generated new valid HF_TOKEN, updated `.env` and Spaces secrets
-- Also switched default model to `Qwen/Qwen2.5-72B-Instruct` for better reliability
-
-### ~~P1 - Advanced Mode Exposes Uninterpretable Chain-of-Thought~~ FIXED
-
-**File:** `docs/bugs/P1_ADVANCED_MODE_UNINTERPRETABLE_CHAIN_OF_THOUGHT.md`
-**PR:** [#107](https://github.com/The-Obstacle-Is-The-Way/DeepBoner/pull/107)
-**Found:** 2025-12-01
-**Resolved:** 2025-12-01
+## Currently Active Bugs
 
-- Problem: Advanced mode exposed raw `task_ledger` and `instruction` events, truncated mid-word.
-- Fix: Filtered internal events, transformed `user_task` to progress type, smart sentence-aware truncation.
-- Tests: `tests/unit/orchestrators/test_advanced_events.py` (5 tests)
-- CodeRabbit review addressed: test markers, edge case handling, truncation test coverage.
+### P2 - 7B Model Produces Garbage Streaming Output
 
-### ~~P0 - Advanced Mode Timeout Yields No Synthesis~~ FIXED
+**File:** `docs/bugs/P2_7B_MODEL_GARBAGE_OUTPUT.md`
+**Status:** OPEN - Investigating
 
-**File:** `docs/bugs/P0_ADVANCED_MODE_TIMEOUT_NO_SYNTHESIS.md`
-**Found:** 2025-11-30 (Manual Testing)
-**Resolved:** 2025-12-01
+**Problem:** When running Free Tier (Qwen2.5-7B-Instruct), the streaming output shows garbage tokens like "yarg", "PostalCodes", "FunctionFlags" instead of coherent agent reasoning.
 
-- Problem: Advanced mode timed out and displayed "Synthesizing..." but no synthesis occurred.
-- Root Causes:
-  1. Timeout handler yielded misleading message without calling ReportAgent
-  2. Factory used wrong setting (`max_iterations=10` instead of `advanced_max_rounds=5`)
-  3. Missing `get_context_summary()` in ResearchMemory
-- Fix:
-  1. Implemented actual synthesis on timeout via ReportAgent invocation
-  2. Factory now uses `settings.advanced_max_rounds` (5)
-  3. Added `get_context_summary()` to ResearchMemory
-- Tests: `tests/unit/orchestrators/test_advanced_timeout.py`
-- Key files: `src/orchestrators/advanced.py`, `src/orchestrators/factory.py`, `src/services/research_memory.py`
+**Root Cause:** The 7B model has insufficient reasoning capacity for the complex multi-agent framework prompts.
 
-### ~~P0 - Free Tier Synthesis Incorrectly Uses Server-Side API Keys~~ FIXED (Historical)
+**Potential Fixes:**
+1. Switch to a better small model (Mistral-7B, Phi-3, Gemma-2-9B, Qwen2.5-14B)
+2. Simplify Free Tier architecture to single-agent mode
+3. Add output filtering/validation
+4. Prompt engineering specifically for 7B models
 
-**File:** `docs/bugs/P1_SYNTHESIS_BROKEN_KEY_FALLBACK.md`
-**PR:** [#103](https://github.com/The-Obstacle-Is-The-Way/DeepBoner/pull/103)
-**Found:** 2025-11-30 (Testing)
-**Resolved:** 2025-11-30
-
-- Problem: Simple Mode crashed with "OpenAIError" on HuggingFace Spaces.
-- Note: This was in the OLD Simple Mode. Now we use Unified Architecture.
-
-### ~~P0 - Synthesis Fails with OpenAIError in Free Mode~~ FIXED (Historical)
-
-**File:** `docs/bugs/P0_SYNTHESIS_PROVIDER_MISMATCH.md`
-**Found:** 2025-11-30 (Code Audit)
-**Resolved:** 2025-11-30
-
-- Problem: "Simple Mode" (Free Tier) crashed with `OpenAIError`.
-- Note: This was in the OLD Simple Mode. Now we use Unified Architecture.
-
-### ~~P0 - Simple Mode Never Synthesizes~~ FIXED (Historical)
-
-**PR:** [#71](https://github.com/The-Obstacle-Is-The-Way/DeepBoner/pull/71) (SPEC_06)
-**Commit**: `5cac97d` (2025-11-29)
-
-- Root cause: LLM-as-Judge recommendations were being IGNORED
-- Note: This was in the OLD Simple Mode. Now we use Unified Architecture.
-
-### ~~P3 - Magentic Mode Missing Termination Guarantee~~ FIXED
+---
 
-**Commit**: `d36ce3c` (2025-11-29)
+### P3 - Progress Bar Positioning in ChatInterface
 
-- Added `final_event_received` tracking in `orchestrator_magentic.py`
-- Added fallback yield for "max iterations reached" scenario
-- Verified with `test_magentic_termination.py`
+**File:** `docs/bugs/P3_PROGRESS_BAR_POSITIONING.md`
+**Status:** OPEN - Low Priority UX Polish
 
-### ~~P0 - Magentic Mode Report Generation~~ FIXED
+**Problem:** The `gr.Progress()` bar renders in a strange position when used inside ChatInterface, causing visual overlap with chat messages.
 
-**Commit**: `9006d69` (2025-11-29)
+**Recommended Fix:** Remove `gr.Progress()` entirely and rely on emoji status messages in chat output.
 
-- 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
+## Tech Debt (Future Roadmap)
 
-**Commit**: `0c9be4a` (2025-11-29)
+### P3 - Remove Anthropic Partial Wiring
 
-- 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
+**File:** `docs/future-roadmap/P3_REMOVE_ANTHROPIC_PARTIAL_WIRING.md`
+**Status:** OPEN - Tech Debt
 
-### ~~P2 - Missing "Thinking" State~~ FIXED
+**Problem:** Anthropic is partially wired but NOT fully supported (no embeddings API). Creates confusion.
 
-**Commit**: `9006d69` (2025-11-29)
+**Fix:** Remove all Anthropic references from codebase. See doc for file list.
 
-- 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
+## Resolved Bugs (December 2025)
 
-**Commit**: `2ea01fd` (2025-11-29)
+All resolved bugs have been moved to `docs/bugs/archive/`. Summary:
 
-- 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?`
+### P0 Bugs (All FIXED)
+- **P0 Repr Bug** - FIXED in PR #117 via Accumulator Pattern
+- **P0 AIFunction Not JSON Serializable** - FIXED, full tool support for HuggingFace
+- **P0 HuggingFace Tool Calling Broken** - FIXED, history serialization + Accumulator Pattern
+- **P0 Simple Mode Forced Synthesis Bypass** - N/A, simple.py deleted (Unified Architecture)
+- **P0 Synthesis Provider Mismatch** - FIXED, auto-detect in judges.py
+- **P0 Advanced Mode Timeout No Synthesis** - FIXED, actual synthesis on timeout
 
-### ~~P1 - Gradio Settings Accordion~~ WONTFIX
+### P1 Bugs (All FIXED)
+- **P1 HuggingFace Router 401 Hyperbolic** - FIXED, invalid token was root cause
+- **P1 HuggingFace Novita 500 Error** - SUPERSEDED, switched to 7B model
+- **P1 Advanced Mode Uninterpretable Chain-of-Thought** - FIXED in PR #107
+- **P1 Synthesis Broken Key Fallback** - FIXED in PR #103
+- **P1 Simple Mode Removed Breaks Free Tier UX** - FIXED via Accumulator Pattern (PR #117)
 
-Decision: Removed nested Blocks, using ChatInterface directly.
-Accordion behavior is default Gradio - acceptable for demo.
+### P2 Bugs (All FIXED)
+- **P2 Advanced Mode Cold Start No Feedback** - FIXED, all phases complete
+- **P2 Architectural BYOK Gaps** - FIXED, end-to-end BYOK support in PR #119
 
 ---
 
@@ -170,4 +80,18 @@ Accordion behavior is default Gradio - acceptable for demo.
 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
+4. Priority: P0=blocker, P1=important, P2=UX, P3=edge case/tech debt
+
+---
+
+## Archived Documentation
+
+The following have been moved to `docs/bugs/archive/`:
+- All resolved P0-P2 bug reports
+- Code quality audit findings (2025-11-30)
+- Gradio example vs chat arrow analysis
+
+Additional documentation moved:
+- `HF_FREE_TIER_ANALYSIS.md` → `docs/architecture/`
+- `TOOL_ANALYSIS_CRITICAL.md` → `docs/future-roadmap/`
+- `P3_REMOVE_ANTHROPIC_PARTIAL_WIRING.md` → `docs/future-roadmap/`