# Build Readiness Index — LLMHosts.com

> **Purpose**: Every shipped capability cross-referenced to its code path, issue, PR, tests, and docs. Any AI or developer can find the implementation of any feature in under 30 seconds.
>
> **Last updated**: 2026-03-10 (GitHub Harmony v2.0.0 bootstrap)
> **Maintained by**: Update this file in every PR that ships a new capability. See `.github/SSOT.md` for the protocol.

---

## Index

| # | Capability | Status | Issue | PR | Code Path | Tests | Docs/ADR |
|---|-----------|--------|-------|----|-----------|-------|----------|
| 1 | CLI entrypoint (`llmhosts` command) | ✅ Shipped | — | — | `llmhosts/cli.py` | `tests/test_cli.py` | `CLAUDE.md` |
| 2 | FastAPI server + route mounting | ✅ Shipped | — | — | `llmhosts/server.py` | `tests/test_server.py` | `CLAUDE.md` |
| 3 | TOML + env config system | ✅ Shipped | — | — | `llmhosts/config.py` | `tests/test_config.py` | `CLAUDE.md` |
| 4 | OpenAI-compatible proxy (`/v1/chat/completions`) | ✅ Shipped | — | — | `llmhosts/proxy/` | `tests/test_proxy.py` | ADR-003 |
| 5 | Anthropic-compatible proxy (`/v1/messages`) | ✅ Shipped | — | — | `llmhosts/proxy/` | `tests/test_proxy.py` | ADR-003 |
| 6 | BackendDispatcher — backend selection | ✅ Shipped | — | — | `llmhosts/proxy/dispatcher.py` | `tests/test_dispatcher.py` | ADR-001 |
| 7 | Three-tier hybrid router (kNN + ModernBERT + Qwen) | ✅ Shipped | — | — | `llmhosts/router/` | `tests/test_router.py` | ADR-001 |
| 8 | IslandRun privacy routing (PII detection) | ✅ Shipped | — | — | `llmhosts/router/engine.py` | `tests/test_router.py` | `CLAUDE.md` |
| 9 | Three-tier semantic cache (vCache) | ✅ Shipped | — | — | `llmhosts/cache/manager.py` | `tests/test_cache.py` | `docs/knowledge-base/` |
| 10 | Zero-config auto-discovery (GPU + Ollama) | ✅ Shipped | — | #264, #265 | `llmhosts/discovery/` | `tests/test_discovery.py` | — |
| 11 | `llmhosts up` 5-phase pipeline | ✅ Shipped | — | #266 | `llmhosts/up.py` | `tests/test_up.py` | — |
| 12 | Self-hosted Rust relay (M1 — skeleton + pyo3) | ✅ Shipped | #438, #439 | #449 | `relay_core/`, `llmhosts/tunnel/` | — | ADR-009 |
| 13 | LLMHosts Core F1 — custom Rust engine (CPU) | ✅ Shipped | #450, #451 | #465 | `llmhosts_core/src/` | — | ADR-010 |
| 14 | GPU compute (CUDA/WGPU kernels) | ✅ Shipped | #450 | #466 | `llmhosts_core/src/compute/mod.rs` | — | ADR-010 |
| 15 | maturin wheel build (PyO3 bridge) | ✅ Shipped | #450 | #465 | `Cargo.toml`, `pyproject.toml` | — | ADR-010 |
| 16 | GGUF + chat templates + model validation | ✅ Shipped | — | #458 | `llmhosts_core/src/` | — | ADR-010 |
| 17 | BYOK encrypted key storage | ✅ Shipped | — | — | `llmhosts/keys/` | `tests/test_keys.py` | — |
| 18 | Textual TUI dashboard | ✅ Shipped | — | — | `llmhosts/dashboard/` | — | — |
| 19 | OWASP security tests | ✅ Shipped | — | — | `tests/test_owasp*.py` | — | — |
| 20 | Next.js 16 frontend (App Router) | ✅ Shipped | — | — | `frontend/src/app/` | `frontend/src/**/*.test.*` | ADR-005 |
| 21 | NextAuth v5 (Auth.js) authentication | ✅ Shipped | — | — | `frontend/src/app/api/auth/` | — | — |
| 22 | Prisma + SQLite schema (21+ models) | ✅ Shipped | — | — | `frontend/prisma/schema.prisma` | — | — |
| 23 | Token AI — conversational fleet orchestrator | ✅ Shipped | #267 | #268 | `frontend/src/app/dashboard/token/`, `frontend/src/lib/token/` | `frontend/src/lib/token/**/*.test.*` | — |
| 24 | Token — multi-agent routing (Sonnet/Flash/R1) | ✅ Shipped | #267 | #268 | `frontend/src/lib/token/agents/` | — | — |
| 25 | Token — intent classifier (Gemini Flash Lite) | ✅ Shipped | #267 | #268 | `frontend/src/lib/token/classifier.ts` | — | — |
| 26 | Token — cost analytics + proactive alerts | ✅ Shipped | #267 | #268 | `frontend/src/lib/token/analytics.ts` | — | — |
| 27 | GPU Marketplace — device registration | ✅ Shipped | — | — | `frontend/src/app/api/devices/` | — | — |
| 28 | GPU Marketplace — reputation scoring engine | ✅ Shipped | — | #404 | `llmhosts/marketplace/` | `tests/test_reputation.py` | — |
| 29 | GPU Marketplace — remote dispatch + routing | ✅ Shipped | — | #405 | `llmhosts/proxy/dispatcher.py` | `tests/test_dispatcher.py` | — |
| 30 | GPU Marketplace — Stripe Connect billing | ✅ Shipped | — | #406 | `frontend/src/app/api/billing/` | — | — |
| 31 | At-capacity cloud fallback | ✅ Shipped | — | #396 | `llmhosts/proxy/dispatcher.py` | — | — |
| 32 | Phase 5B auto-removal (low uptime nodes) | ✅ Shipped | #290 | #430 | `llmhosts/marketplace/probes.py` | — | — |
| 33 | Hybrid documentation (9 pages) | ✅ Shipped | #403 | #407 | `frontend/src/app/docs/` | — | — |
| 34 | Monitoring stack (Prometheus + Grafana + Loki) | ✅ Shipped | — | — | `monitoring/docker-compose.monitoring.yml` | — | — |
| 35 | Self-healing CI (17-check verification gate) | ✅ Shipped | — | — | `.github/workflows/ci.yml` | — | — |
| 36 | CodeQL security analysis | ✅ Shipped | — | — | `.github/workflows/codeql.yml` | — | — |
| 37 | Wheel + PyPI release workflow | ✅ Shipped | — | — | `.github/workflows/release.yml` | — | — |
| 38 | Hive.CEO embedded agent system | ✅ Shipped | — | — | `hive/`, `.hive/` | — | — |
| 39 | Device Code Auth (RFC 8628) | ✅ Shipped | — | — | `llmhosts/auth/device_flow.py` | — | — |
| 40 | GPU Remit System | ✅ Shipped | — | #393 | `llmhosts/marketplace/remit.py` | — | — |
| 41 | `llmhosts doctor` diagnostics | ✅ Shipped | — | — | `llmhosts/cli.py` | — | — |

---

## In Progress (Not Yet Shipped)

| # | Capability | Status | Issue | Target PR | Entry Point | Blocker |
|---|-----------|--------|-------|-----------|------------|---------|
| 42 | LLMHosts Core F2: Performance (PagedAttention, batching) | 🚧 Planned | #452 | — | `llmhosts_core/src/` | None — unblocked |
| 43 | LLMHosts Core F3: Intelligence (HIM, hot-swap) | 📋 Planned | #453 | — | — | Needs F2 |
| 44 | LLMHosts Core F4: Scale (phase-split, multi-node) | 📋 Planned | #454 | — | — | Needs F3 |
| 45 | LLMHosts Core F5: Polish | 📋 Planned | #455 | — | — | Needs F4 |
| 46 | Relay M2: Noise Protocol NK encryption | 🚧 Planned | #440 | — | `relay_core/` | None — unblocked |
| 47 | Relay M3: yamux stream multiplexing | 📋 Planned | #441 | — | — | Needs M2 |
| 48 | Relay M4: relay_server binary (VPS) | 📋 Planned | #442 | — | — | Needs M3 |
| 49 | Relay M5: Production hardening | 📋 Planned | #443 | — | — | Needs M4 |
| 50 | Smart Install — Universal Platform Detection | 📋 Vision 2026 | #472 | — | — | Planning |
| 51 | Self-Healing Zero-Ops | 📋 Vision 2026 | #473 | — | — | Planning |
| 52 | Goal-Based Intelligent Onboarding | 📋 Vision 2026 | #474 | — | — | Planning |
| 53 | Collective Intelligence (federated learning) | 📋 Vision 2026 | #475 | — | — | Planning |
| 54 | One Unified API + Multi-Backend Router | 📋 Vision 2026 | #476 | — | — | Planning |
| 55 | Fine-Tuning as a Service | 📋 Vision 2026 | #477 | — | — | Planning |
| 56 | Benchmark Suite + Performance Proof | 📋 Vision 2026 | #478 | — | — | Planning |

---

## Key Metrics

| Metric | Value | Date |
|--------|-------|------|
| Total Python tests | 2,373 | 2026-03-09 |
| Total frontend tests | 808 | 2026-03-09 |
| Total E2E tests (Playwright) | 29 | 2026-03-09 |
| **Grand total tests** | **3,181+** | 2026-03-09 |
| Python files | ~200+ | 2026-03-09 |
| Current version | v0.5.1 | 2026-03-10 |
| CI checks | 17 | 2026-03-09 |

---

## How to Update This File

Add a row to the **In Progress** table when you open a new issue for a capability.
Move it to the **Shipped** table (with all columns filled) when the implementing PR merges.

Column guide:
- **Code Path**: Relative path to the primary implementation file
- **Tests**: Relative path to the primary test file(s)
- **Docs/ADR**: Link to the ADR or design doc (use `docs/architecture/adr-NNN.md`)
