gavindiaz/world-intel-mcp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: fix ROADMAP tool inventory (110/110) and test count (344)

Browse Source
This commit is contained in:
Marc Shade
2026-03-08 13:17:06 -04:00
parent 346e26deb1
commit 75d29d2ae7
2 changed files with 193 additions and 168 deletions
Download Patch File Download Diff File Expand all files Collapse all files
ROADMAP.md
+69 -8
View File
@@ -2,7 +2,7 @@
**Benchmark**: [koala73/worldmonitor](https://github.com/koala73/worldmonitor)
**Updated**: 2026-03-08
**Current tools**: 109 (108 intel + 1 status)
**Current tools**: 110 (109 intel + 1 status)
---
@@ -20,11 +20,11 @@
| Area | Finding | Status | Action |
|------|---------|--------|--------|
| MCP tool parity | 109 tools declared in `TOOLS`; 109 routed in `_dispatch()` | :white_check_mark: | Keep as an invariant |
| MCP tool parity | 110 tools declared in `TOOLS`; 110 routed in `_dispatch()` | :white_check_mark: | Keep as an invariant |
| Optional vector runtime | Missing `qdrant-client` / `fastembed` previously surfaced as runtime failures | :white_check_mark: Fixed | Vector features now degrade cleanly and report availability |
| Base-environment test run | `pytest -q` fails collection without dev extras because `respx` is not installed | :yellow_circle: | Run `pip install -e ".[dev]"` before full-suite validation |
| Core verification | 77 infrastructure/vector tests pass in the base environment | :white_check_mark: | `test_cache.py`, `test_analysis.py`, `test_vector_store.py` |
| Documentation drift | Prior roadmap documented 89 tools while the codebase exposed 109 | :white_check_mark: Updated below | Keep roadmap synced with phase increments |
| Core verification | 127 infrastructure/report/vector tests pass in the base environment | :white_check_mark: | `test_reports.py`, `test_cache.py`, `test_analysis.py`, `test_vector_store.py` |
| Documentation drift | Prior roadmap documented 89 tools while the codebase exposed 110 | :white_check_mark: Updated below | Keep roadmap synced with phase increments |
| Maintainability | `src/world_intel_mcp/server.py` is ~2.5k lines and remains the main refactor target | :yellow_circle: | Split tool registry and dispatch by domain |
### Implemented Addendum Missing From Prior Roadmap
@@ -59,6 +59,12 @@
| `intel_domain_summary` | Per-category summary of stored intelligence | :white_check_mark: |
| `intel_trend_detection` | Recent-vs-baseline activity surge/drop detection | :white_check_mark: |
#### Intelligence Reports (1 tool)
| Tool | Purpose | Status |
|------|---------|--------|
| `intel_generate_report` | Generate PDF/HTML multi-domain intelligence reports with HTML fallback when `.[pdf]` is unavailable | :white_check_mark: |
---
## 1. Data Sources — Complete Inventory
@@ -207,6 +213,56 @@
| `intel_news_clusters` | Jaccard similarity clustering | :white_check_mark: |
| `intel_keyword_spikes` | Welford's algorithm spike detection | :white_check_mark: |
### Extended Geospatial (10 tools)
| Tool | WM Equivalent | Status |
|------|---------------|--------|
| `intel_undersea_cables` | 34 cables with landing points | :white_check_mark: |
| `intel_ai_datacenters` | 48 global AI/cloud clusters | :white_check_mark: |
| `intel_spaceports` | 27 launch facilities | :white_check_mark: |
| `intel_critical_minerals` | 27 deposit types | :white_check_mark: |
| `intel_stock_exchanges` | 82 global exchanges | :white_check_mark: |
| `intel_trade_routes` | 19 maritime chokepoints/routes | :white_check_mark: |
| `intel_cloud_regions` | 28 AWS/Azure/GCP regions | :white_check_mark: |
| `intel_financial_centers` | 20 GFCI-ranked cities | :white_check_mark: |
| `intel_nuclear_facilities` | 24 power/enrichment/research | :white_check_mark: |
### Financial Intelligence (12 tools)
| Tool | Purpose | Status |
|------|---------|--------|
| `intel_forex_rates` | Latest FX rates by base + symbol filters | :white_check_mark: |
| `intel_forex_timeseries` | Historical FX series with configurable lookback | :white_check_mark: |
| `intel_major_crosses` | Major crosses + DXY proxy snapshot | :white_check_mark: |
| `intel_yield_curve` | Treasury curve + inversion analysis | :white_check_mark: |
| `intel_bond_indices` | Bond ETF summary (AGG, TLT, HYG, LQD, TIP) | :white_check_mark: |
| `intel_earnings_calendar` | Upcoming earnings calendar | :white_check_mark: |
| `intel_earnings_surprise` | Historical earnings surprise analysis | :white_check_mark: |
| `intel_sec_filings` | Full-text SEC EDGAR filing search | :white_check_mark: |
| `intel_company_filings` | Company-specific 10-K / 10-Q / 8-K retrieval | :white_check_mark: |
| `intel_recent_8k` | Recent material-event 8-K stream | :white_check_mark: |
| `intel_company_profile` | Composite company enrichment profile | :white_check_mark: |
| `intel_macro_composite` | Weighted market regime / macro composite score | :white_check_mark: |
### Vector Intelligence (5 tools)
| Tool | Purpose | Status |
|------|---------|--------|
| `intel_semantic_search` | Natural-language search across accumulated intelligence | :white_check_mark: |
| `intel_similar_events` | Similarity search against historical events | :white_check_mark: |
| `intel_timeline` | Chronological timeline from vector store history | :white_check_mark: |
| `intel_vector_stats` | Qdrant collection statistics | :white_check_mark: |
| `intel_collect` | On-demand collection cycle for vector population | :white_check_mark: |
### Cross-Domain Analytics (3 tools)
| Tool | Purpose | Status |
|------|---------|--------|
| `intel_cross_correlate` | Cross-category correlation for a topic/query | :white_check_mark: |
| `intel_domain_summary` | Per-category summary of stored intelligence | :white_check_mark: |
| `intel_trend_detection` | Recent-vs-baseline activity surge/drop detection | :white_check_mark: |
### Reports (1 tool)
| Tool | Purpose | Status |
|------|---------|--------|
| `intel_generate_report` | PDF/HTML multi-domain intelligence reports | :white_check_mark: |
### System (1 tool)
| Tool | Purpose | Status |
|------|---------|--------|
@@ -361,17 +417,22 @@ Qdrant-backed semantic retrieval added across all fetched intelligence, plus tim
Added historical cross-category correlation, stored-data summarization, and recent-vs-baseline trend detection on top of the vector archive for early-warning and activity-shift analysis.
### Phase 17: Intelligence Reports (+1 = 110 tools)
`intel_generate_report`
Added PDF/HTML intelligence report generation over the existing multi-domain data collection stack. PDF output remains optional behind `.[pdf]`, with HTML fallback available when WeasyPrint is not installed.
---
## Summary
| Category | Current | Notes |
|----------|---------|-------|
| Total MCP tools | 109 | 108 intelligence tools + `intel_status` |
| Tool parity | 109 / 109 | `TOOLS` and `_dispatch()` are aligned |
| Total MCP tools | 110 | 109 intelligence tools + `intel_status` |
| Tool parity | 110 / 110 | `TOOLS` and `_dispatch()` are aligned |
| Static datasets | 18 | Bases, ports, pipelines, nuclear, cables, datacenters, spaceports, minerals, exchanges, trade routes, cloud regions, financial centers |
| RSS feeds | 119 | 24 categories |
| Tests in repo | 186 | Full suite requires `.[dev]`; 77 core tests validated in the base environment |
| Tests in repo | 344 | 11 test files; full suite requires `.[dev]` |
| Primary remaining gap | Architecture | `server.py` monolith remains the main refactor target |
**Bottom line**: 109 tools across 30+ domains, with the roadmap now aligned to the live MCP registry. The main remaining gaps are full-environment test bootstrapping (`.[dev]`) and continued modularization of the monolithic `server.py` tool registry/dispatcher.
**Bottom line**: 110 tools across 30+ domains, with the roadmap now aligned to the live MCP registry. The main remaining gaps are full-environment test bootstrapping (`.[dev]`) and continued modularization of the monolithic `server.py` tool registry/dispatcher.