Commit
Β·
1f17689
1
Parent(s):
690f673
docs: Update README, META_PLAN, ACTIVE_BUGS for post-cleanup state
Browse filesREADME.md:
- Removed Modal tag and feature
- Removed analyze_hypothesis tool (deleted)
- Updated tech stack (Agent Framework, ChromaDB, LangGraph)
- Added OpenAlex to search sources
META_PLAN.md:
- Marked Step 3 (Anthropic + Modal removal) COMPLETE
- Updated test count (302)
- All success criteria checked
ACTIVE_BUGS.md:
- Removed P3 tech debt section (now resolved)
- Added P3 resolved items to history
- META_PLAN.md +24 -20
- README.md +12 -14
- docs/bugs/ACTIVE_BUGS.md +4 -24
META_PLAN.md
CHANGED
|
@@ -1,7 +1,8 @@
|
|
| 1 |
# META_PLAN: DeepBoner Stabilization Roadmap
|
| 2 |
|
| 3 |
**Created**: 2025-12-03
|
| 4 |
-
**
|
|
|
|
| 5 |
**Purpose**: Single source of truth for what to do next before adding features
|
| 6 |
|
| 7 |
---
|
|
@@ -9,14 +10,14 @@
|
|
| 9 |
## Executive Summary
|
| 10 |
|
| 11 |
**Codebase Health**: PRODUCTION-READY
|
| 12 |
-
-
|
| 13 |
- No type errors (mypy clean)
|
| 14 |
- No linting issues (ruff clean)
|
| 15 |
-
-
|
| 16 |
|
| 17 |
-
**Key Finding**: Architecture is sound.
|
| 18 |
|
| 19 |
-
**
|
| 20 |
|
| 21 |
---
|
| 22 |
|
|
@@ -38,7 +39,7 @@
|
|
| 38 |
| Component | Status | Notes |
|
| 39 |
|-----------|--------|-------|
|
| 40 |
| `src/orchestrators/` | COMPLETE | Factory pattern, protocols |
|
| 41 |
-
| `src/clients/` | COMPLETE | OpenAI/HuggingFace working,
|
| 42 |
| `src/tools/` | COMPLETE | Deduplication + outcomes extraction done |
|
| 43 |
| `src/agents/` | FUNCTIONAL | All agents wired, some experimental |
|
| 44 |
| `src/services/` | COMPLETE | Embeddings, RAG, memory all working |
|
|
@@ -49,8 +50,9 @@
|
|
| 49 |
|-------|----------|--------|
|
| 50 |
| ~~Evidence deduplication (SPEC_13)~~ | ~~HIGH~~ | β
DONE |
|
| 51 |
| ~~ClinicalTrials outcomes (SPEC_14)~~ | ~~HIGH~~ | β
DONE |
|
| 52 |
-
| Remove Anthropic wiring (P3) | P3 |
|
| 53 |
-
|
|
|
|
|
| 54 |
| P3 Progress Bar positioning | P3 | 30 min |
|
| 55 |
|
| 56 |
---
|
|
@@ -85,18 +87,19 @@
|
|
| 85 |
|
| 86 |
---
|
| 87 |
|
| 88 |
-
### Step 3: Remove Anthropic Tech Debt
|
| 89 |
-
**Priority**: P3 | **Effort**: 1 hour | **Impact**: Code clarity
|
| 90 |
|
| 91 |
-
|
| 92 |
|
| 93 |
-
**Files
|
| 94 |
-
- `src/utils/
|
| 95 |
-
- `src/
|
| 96 |
-
- `src/
|
| 97 |
-
- `
|
|
|
|
| 98 |
|
| 99 |
-
**
|
| 100 |
|
| 101 |
---
|
| 102 |
|
|
@@ -163,9 +166,10 @@ After completing Steps 1-5:
|
|
| 163 |
|
| 164 |
- [x] Evidence deduplication reduces duplicate papers by 80%+ β
|
| 165 |
- [x] ClinicalTrials shows outcome measures and results status β
|
| 166 |
-
- [
|
| 167 |
-
- [
|
| 168 |
-
- [ ]
|
|
|
|
| 169 |
|
| 170 |
---
|
| 171 |
|
|
|
|
| 1 |
# META_PLAN: DeepBoner Stabilization Roadmap
|
| 2 |
|
| 3 |
**Created**: 2025-12-03
|
| 4 |
+
**Updated**: 2025-12-04
|
| 5 |
+
**Status**: β
COMPLETE
|
| 6 |
**Purpose**: Single source of truth for what to do next before adding features
|
| 7 |
|
| 8 |
---
|
|
|
|
| 10 |
## Executive Summary
|
| 11 |
|
| 12 |
**Codebase Health**: PRODUCTION-READY
|
| 13 |
+
- 302 tests passing
|
| 14 |
- No type errors (mypy clean)
|
| 15 |
- No linting issues (ruff clean)
|
| 16 |
+
- All P3 tech debt resolved
|
| 17 |
|
| 18 |
+
**Key Finding**: Architecture is sound. All specs implemented. Tech debt cleaned.
|
| 19 |
|
| 20 |
+
**Status**: Steps 1-3 COMPLETE. Ready for feature development or documentation polish.
|
| 21 |
|
| 22 |
---
|
| 23 |
|
|
|
|
| 39 |
| Component | Status | Notes |
|
| 40 |
|-----------|--------|-------|
|
| 41 |
| `src/orchestrators/` | COMPLETE | Factory pattern, protocols |
|
| 42 |
+
| `src/clients/` | COMPLETE | OpenAI/HuggingFace working, Provider Registry pattern |
|
| 43 |
| `src/tools/` | COMPLETE | Deduplication + outcomes extraction done |
|
| 44 |
| `src/agents/` | FUNCTIONAL | All agents wired, some experimental |
|
| 45 |
| `src/services/` | COMPLETE | Embeddings, RAG, memory all working |
|
|
|
|
| 50 |
|-------|----------|--------|
|
| 51 |
| ~~Evidence deduplication (SPEC_13)~~ | ~~HIGH~~ | β
DONE |
|
| 52 |
| ~~ClinicalTrials outcomes (SPEC_14)~~ | ~~HIGH~~ | β
DONE |
|
| 53 |
+
| ~~Remove Anthropic wiring (P3)~~ | ~~P3~~ | β
DONE (PR #130) |
|
| 54 |
+
| ~~Remove Modal wiring (P3)~~ | ~~P3~~ | β
DONE (PR #130) |
|
| 55 |
+
| Expand ARCHITECTURE.md | LOW | 2 hours |
|
| 56 |
| P3 Progress Bar positioning | P3 | 30 min |
|
| 57 |
|
| 58 |
---
|
|
|
|
| 87 |
|
| 88 |
---
|
| 89 |
|
| 90 |
+
### ~~Step 3: Remove Anthropic + Modal Tech Debt~~ β
COMPLETE
|
| 91 |
+
**Priority**: ~~P3~~ DONE | **Effort**: ~~1 hour~~ | **Impact**: Code clarity
|
| 92 |
|
| 93 |
+
β
**COMPLETED** - Both Anthropic and Modal partial integrations removed in PR #130.
|
| 94 |
|
| 95 |
+
**Files removed/modified**:
|
| 96 |
+
- `src/utils/llm_factory.py` - DELETED
|
| 97 |
+
- `src/tools/code_execution.py` - DELETED
|
| 98 |
+
- `src/services/statistical_analyzer.py` - DELETED
|
| 99 |
+
- `src/agents/analysis_agent.py`, `code_executor_agent.py` - DELETED
|
| 100 |
+
- All config, factory, and agent files cleaned
|
| 101 |
|
| 102 |
+
**Docs archived**: `docs/bugs/archive/P3_REMOVE_ANTHROPIC_PARTIAL_WIRING.md`, `P3_MODAL_INTEGRATION_REMOVAL.md`
|
| 103 |
|
| 104 |
---
|
| 105 |
|
|
|
|
| 166 |
|
| 167 |
- [x] Evidence deduplication reduces duplicate papers by 80%+ β
|
| 168 |
- [x] ClinicalTrials shows outcome measures and results status β
|
| 169 |
+
- [x] No Anthropic references in codebase β
(PR #130)
|
| 170 |
+
- [x] No Modal references in codebase β
(PR #130)
|
| 171 |
+
- [ ] ARCHITECTURE.md has flow diagrams (optional)
|
| 172 |
+
- [ ] All 14 implementation phases marked DONE/TODO (optional)
|
| 173 |
|
| 174 |
---
|
| 175 |
|
README.md
CHANGED
|
@@ -20,7 +20,6 @@ tags:
|
|
| 20 |
- wellness-research
|
| 21 |
- pydantic-ai
|
| 22 |
- llamaindex
|
| 23 |
-
- modal
|
| 24 |
- pubmed
|
| 25 |
- clinical-trials
|
| 26 |
- evidence-based
|
|
@@ -51,12 +50,12 @@ Sexual health is health. Period. Yet it remains one of the most under-researched
|
|
| 51 |
|
| 52 |
## Features
|
| 53 |
|
| 54 |
-
- π **Multi-Source Deep Search**: PubMed, ClinicalTrials.gov, Europe PMC - simultaneously
|
| 55 |
- π€ **MCP Integration**: Use our tools from Claude Desktop or any MCP client
|
| 56 |
-
- π **Modal Sandbox**: Secure execution of AI-generated statistical analysis
|
| 57 |
- π§ **Smart Evidence Synthesis**: LLM-powered judge evaluates and synthesizes findings
|
|
|
|
| 58 |
- β‘ **Unified Architecture**: Same powerful multi-agent orchestration for everyone
|
| 59 |
-
- π **Free Tier**: Works without API keys (HuggingFace
|
| 60 |
- π **Paid Tier**: Unlocks GPT-5 automatically when OpenAI key is provided
|
| 61 |
|
| 62 |
## Example Queries
|
|
@@ -111,11 +110,10 @@ Add this to your `claude_desktop_config.json`:
|
|
| 111 |
```
|
| 112 |
|
| 113 |
**Available Tools**:
|
| 114 |
-
- `search_pubmed`: Search peer-reviewed biomedical literature
|
| 115 |
-
- `search_clinical_trials`: Search ClinicalTrials.gov
|
| 116 |
-
- `search_europepmc`: Search Europe PMC preprints and papers
|
| 117 |
-
- `
|
| 118 |
-
- `analyze_hypothesis`: Secure statistical analysis using Modal sandboxes.
|
| 119 |
|
| 120 |
## Development
|
| 121 |
|
|
@@ -140,11 +138,11 @@ DeepBoner uses a Vertical Slice Architecture:
|
|
| 140 |
3. **Orchestrator Slice**: Managing the research loop and UI.
|
| 141 |
|
| 142 |
Built with:
|
| 143 |
-
- **
|
| 144 |
-
- **Gradio**: For the streaming user interface
|
| 145 |
-
- **PubMed, ClinicalTrials.gov, Europe PMC**: For biomedical data
|
| 146 |
-
- **
|
| 147 |
-
- **
|
| 148 |
|
| 149 |
## Team
|
| 150 |
|
|
|
|
| 20 |
- wellness-research
|
| 21 |
- pydantic-ai
|
| 22 |
- llamaindex
|
|
|
|
| 23 |
- pubmed
|
| 24 |
- clinical-trials
|
| 25 |
- evidence-based
|
|
|
|
| 50 |
|
| 51 |
## Features
|
| 52 |
|
| 53 |
+
- π **Multi-Source Deep Search**: PubMed, ClinicalTrials.gov, Europe PMC, OpenAlex - simultaneously
|
| 54 |
- π€ **MCP Integration**: Use our tools from Claude Desktop or any MCP client
|
|
|
|
| 55 |
- π§ **Smart Evidence Synthesis**: LLM-powered judge evaluates and synthesizes findings
|
| 56 |
+
- π¬ **Evidence Deduplication**: Cross-source dedup by PMID/DOI prevents duplicate papers
|
| 57 |
- β‘ **Unified Architecture**: Same powerful multi-agent orchestration for everyone
|
| 58 |
+
- π **Free Tier**: Works without API keys (HuggingFace Qwen 2.5 7B)
|
| 59 |
- π **Paid Tier**: Unlocks GPT-5 automatically when OpenAI key is provided
|
| 60 |
|
| 61 |
## Example Queries
|
|
|
|
| 110 |
```
|
| 111 |
|
| 112 |
**Available Tools**:
|
| 113 |
+
- `search_pubmed`: Search peer-reviewed biomedical literature
|
| 114 |
+
- `search_clinical_trials`: Search ClinicalTrials.gov for active/completed trials
|
| 115 |
+
- `search_europepmc`: Search Europe PMC preprints and papers
|
| 116 |
+
- `search_all_sources`: Search all sources simultaneously with deduplication
|
|
|
|
| 117 |
|
| 118 |
## Development
|
| 119 |
|
|
|
|
| 138 |
3. **Orchestrator Slice**: Managing the research loop and UI.
|
| 139 |
|
| 140 |
Built with:
|
| 141 |
+
- **Agent Framework**: Microsoft's agent-framework-core for multi-agent orchestration
|
| 142 |
+
- **Gradio**: For the streaming user interface with MCP server
|
| 143 |
+
- **PubMed, ClinicalTrials.gov, Europe PMC, OpenAlex**: For biomedical data
|
| 144 |
+
- **ChromaDB + Sentence-Transformers**: For evidence deduplication and RAG
|
| 145 |
+
- **LangGraph**: For workflow state management
|
| 146 |
|
| 147 |
## Team
|
| 148 |
|
docs/bugs/ACTIVE_BUGS.md
CHANGED
|
@@ -20,30 +20,6 @@
|
|
| 20 |
|
| 21 |
---
|
| 22 |
|
| 23 |
-
## Tech Debt (Future Roadmap)
|
| 24 |
-
|
| 25 |
-
### P3 - Remove Anthropic Partial Wiring
|
| 26 |
-
|
| 27 |
-
**File:** `docs/future-roadmap/P3_REMOVE_ANTHROPIC_PARTIAL_WIRING.md`
|
| 28 |
-
**Status:** OPEN - Tech Debt
|
| 29 |
-
|
| 30 |
-
**Problem:** Anthropic is partially wired but NOT fully supported (no embeddings API). Creates confusion.
|
| 31 |
-
|
| 32 |
-
**Fix:** Remove all Anthropic references from codebase. See doc for file list.
|
| 33 |
-
|
| 34 |
-
---
|
| 35 |
-
|
| 36 |
-
### P3 - Remove Modal Integration
|
| 37 |
-
|
| 38 |
-
**File:** `docs/future-roadmap/P3_MODAL_INTEGRATION_REMOVAL.md`
|
| 39 |
-
**Status:** OPEN - Tech Debt
|
| 40 |
-
|
| 41 |
-
**Problem:** Modal (cloud functions) is integrated in 9 files but was decided against for this project. Creates dead code paths and confusion.
|
| 42 |
-
|
| 43 |
-
**Fix:** Remove all Modal references from codebase (config, services, agents, tools).
|
| 44 |
-
|
| 45 |
-
---
|
| 46 |
-
|
| 47 |
## Resolved Bugs (December 2025)
|
| 48 |
|
| 49 |
All resolved bugs have been moved to `docs/bugs/archive/`. Summary:
|
|
@@ -73,6 +49,10 @@ All resolved bugs have been moved to `docs/bugs/archive/`. Summary:
|
|
| 73 |
- **P2 Advanced Mode Cold Start No Feedback** - FIXED, all phases complete
|
| 74 |
- **P2 Architectural BYOK Gaps** - FIXED, end-to-end BYOK support in PR #119
|
| 75 |
|
|
|
|
|
|
|
|
|
|
|
|
|
| 76 |
---
|
| 77 |
|
| 78 |
## How to Report Bugs
|
|
|
|
| 20 |
|
| 21 |
---
|
| 22 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 23 |
## Resolved Bugs (December 2025)
|
| 24 |
|
| 25 |
All resolved bugs have been moved to `docs/bugs/archive/`. Summary:
|
|
|
|
| 49 |
- **P2 Advanced Mode Cold Start No Feedback** - FIXED, all phases complete
|
| 50 |
- **P2 Architectural BYOK Gaps** - FIXED, end-to-end BYOK support in PR #119
|
| 51 |
|
| 52 |
+
### P3 Tech Debt (All RESOLVED)
|
| 53 |
+
- **P3 Remove Anthropic Partial Wiring** - DONE in PR #130, all Anthropic code removed
|
| 54 |
+
- **P3 Remove Modal Integration** - DONE in PR #130, all Modal code removed (~1400 lines deleted)
|
| 55 |
+
|
| 56 |
---
|
| 57 |
|
| 58 |
## How to Report Bugs
|