# LLMHosts.com -- Roadmap Index & Sync Mechanism

## META
- created: 2026-02-13
- updated: 2026-02-22
- version: 4.0 (STATUS SYNC)
- status: ACTIVE
- ssot: GitHub Issues, Milestones, and Projects V2 board

## ROADMAP LAYERS

| Layer | File | Purpose | Audience |
|-------|------|---------|----------|
| 1. Executive | [executive.md](executive.md) | Phases, milestones, decision gates, success criteria | Founder, investors, stakeholders |
| 2. Detailed | [detailed.md](detailed.md) | Week-by-week, dependencies, critical path, risks | Development team, project management |
| 3. Full PM | [full-pm.md](full-pm.md) | User stories, acceptance criteria, sprint planning | Developers, QA, product management |

## NAMING DISAMBIGUATION
> **Hive Mode** = Phase 3 user-facing GPU pooling feature (social compute, karma, privacy routing, self-hosted Rust relay per ADR-009; Headscale deprecated).
> **Hive.CEO** = Cross-cutting embedded self-aware agent system (self-monitoring, self-improvement, self-healing, admin panel).
> These are DIFFERENT systems. Do not conflate them in any documentation.

## HOW LAYERS STAY SYNCHRONIZED

### Cascade Rules
- **Executive change** (phase/milestone moved) → Update detailed (week assignments) → Update PM (story phase assignments)
- **Detailed change** (task added/removed) → Update PM (add/remove user stories) → Update executive if milestone affected
- **PM change** (story scope change) → Update detailed if timeline affected → Update executive if milestone affected
- **Requirement change** → Update all 3 layers + knowledge base + backlog

### Sync Checklist (Run After Any Roadmap Edit)
1. [ ] Phase dates consistent across all 3 layers?
2. [ ] Milestone definitions match between executive and detailed?
3. [ ] All user stories in PM trace to backlog items?
4. [ ] All backlog items assigned to a phase?
5. [ ] Risk register in detailed reflects current risks?
6. [ ] Success criteria in executive match PM acceptance criteria?

## CHANGE LOG

| Date | Layer | Change | Cascade |
|------|-------|--------|---------|
| 2026-02-13 | ALL | Initial roadmap creation (v1.0) | N/A -- baseline |
| 2026-02-14 | ALL | **POST-PIVOT v2.0**: 6 phases → 4 phases, platform-first → CLI-first, 8B Conductor → kNN router, OpenZiti → Headscale, three-engine → Ollama-primary, self-evolution deferred | Full cascade: all 3 layers + ADRs + backlog + business model |
| 2026-02-14 | ALL | **COURSE CORRECTION v3.0**: kNN-only → three-tier hybrid router, Headscale-for-all → Tailscale/Cloudflare auto-detect, GPTCache → vCache, $15/mo credits → $19/mo flat, monolithic pip → tiered install, added Anthropic API dialect, `llmhosts tunnel` as killer feature, revenue targets per phase | Full cascade: all 3 layers + ADRs + backlog + business model + debate-002 + AGENTS.md |
| 2026-03-08 | ALL | **ADR-009**: Headscale deprecated; replaced by self-hosted Rust relay. Relay is primary tunnel; Tailscale/Cloudflare are fallback only. | Roadmap layers + ADRs + project-context + .env.example |
| 2026-02-22 | META | **STATUS SYNC v4.0**: Aligned roadmap docs with execution reality. Phase 1 ✅ (54 issues closed), Phase 2 ✅ (44 issues closed), Phase 3 IN PROGRESS (11 open issues). Closed stale milestones. GitHub is now explicitly the SSOT — these docs are supplementary narrative. | Milestones, project board, issue assignments |

## CROSS-REFERENCES

### Roadmap → Backlog
| Phase | Primary Epics |
|-------|--------------|
| 1: CLI + Local Intelligence | Onboarding (tiered pip install, serve, discover), Conductor (OpenAI + Anthropic proxy, rule-based + kNN + ModernBERT prototypes), Compute Fabric (Ollama discovery, BYOK), Caching (vCache: hash + namespace + adaptive), Frontend (TUI + web dashboard, honest savings, routing transparency) |
| 2: Your GPU From Anywhere | Conductor (full three-tier router), Compute Fabric (`llmhosts tunnel`, multi-device mesh, vLLM, LAN, exo), Frontend (Next.js web dashboard, accounts, Pro $19/mo), Backend (auth, Stripe flat subscription) |
| 3: The Hive | Hive Mode (self-hosted Rust relay coordination per ADR-009; Headscale deprecated), karma, privacy routing, Frontend (gamification, admin panel, landing page), Backend (Team $49/seat + Enterprise $50/user), Email & Ops (Zoho, auto-reply), Growth (PH, HN, Discord launch) |
| 4: Intelligence | Conductor (global router intelligence, aggregate anonymized data), Compute Fabric (assisted model discovery), Caching (cross-user dedup, GenCache for agentic workflows) |

### Roadmap → ADRs
| Phase | ADRs Exercised |
|-------|---------------|
| 1 | ADR-001 (rule-based + kNN + ModernBERT prototypes), ADR-002 (Ollama-primary), ADR-003 (LiteLLM + Anthropic dialect), ADR-007 (Docker), ADR-008 (tiered pip install) |
| 2 | ADR-001 (full three-tier router), ADR-002 (vLLM opt-in, exo LAN), ADR-004 (Tailscale/Cloudflare auto-detect, `llmhosts tunnel`), ADR-005 (Next.js dashboard) |
| 3 | ADR-004 + ADR-009 (Headscale deprecated; self-hosted Rust relay for Hive), ADR-006 (MCP), all prior ADRs |
| 4 | All ADRs fully exercised, global router intelligence |

### Roadmap → Knowledge Base
| Phase | Key Docs |
|-------|---------|
| 1 | litellm.md, caching-strategies.md, saas-business-model.md, financial-model.md |
| 2 | exo.md, nat-traversal.md, hive-intelligence.md, vllm.md |
| 3 | hive-mode.md, market-reaction-reference.md, email-operations.md, zoho-mail-free-guide.md |
| 4 | self-evolution.md, toolorchestra.md |

## SINGLE SOURCE OF TRUTH

**GitHub is the single source of truth for all tracking.** These roadmap docs provide narrative context and strategic framing. For live status, always check:

```bash
gh issue list --state open --limit 30          # Open work
gh pr list --state open                         # In-flight PRs
gh project item-list 5 --owner LookNoHandsMom   # Project board
gh api repos/LookNoHandsMom/LLMHosts.com/milestones --jq '.[] | "\(.title): \(.open_issues) open, \(.closed_issues) closed (\(.state))"'
```

## CURRENT STATUS (as of 2026-02-22)

| Phase | Status | Milestone | Issues |
|-------|--------|-----------|--------|
| 1: CLI + Local Intelligence | **COMPLETE** | Closed (54 issues) | 0 open |
| 2: Your GPU From Anywhere | **COMPLETE** | Closed (44 issues) | 0 open |
| 3: The Hive | **IN PROGRESS** | Open (11 open, 4 closed) | 11 open |
| 4: Intelligence | PLANNED | Open (0 issues) | Not started |
| MVP Launch v0.1.0 | **NEAR COMPLETE** | 1 open (#134) | Soft launch pending |
| Production Ready v0.2.0 | **NEAR COMPLETE** | 1 open (#135) | Real PyPI + Stripe live pending |

### Phase 3 Open Issues (13 total)

**Launch gates:**
- #134 — Soft launch decision and announcement (P0-blocker)
- #135 — Production launch: Real PyPI + Stripe Live (P1-critical)

**Hive core (3):**
- #95 — Team accounts ($49/seat/mo)
- #96 — Email infrastructure (Zoho Mail)
- #97 — Enterprise tier ($50/user, SSO, SLA)

**Security hardening (3):**
- #122 — Adaptive rate limiting with sliding window
- #123 — Structured audit log export with tamper-evident checksums
- #124 — Mutual TLS (mTLS) for backend-to-proxy

**Performance & observability (3):**
- #117 — HTTP/2 connection pooling for Ollama backends
- #118 — Batch inference for non-streaming requests
- #120 — OpenTelemetry distributed tracing

**Platform extensibility (2):**
- #115 — Plugin system for custom middleware and backends
- #121 — Configurable alerting rules with webhook/email notifications

### Critical Human Action
- **Issue #187** (closed but incomplete) — `RESEND_API_KEY` must be set in production `.env` for email verification to work. Until then, no customer signups.

### What Was Built (Phases 1-2 highlights)
- Three-tier hybrid router (rule-based + kNN + ModernBERT) with IslandRun privacy routing
- Three-tier cache (exact hash + namespace filter + vCache semantic, ICLR 2026)
- LRU eviction with Prometheus metrics across all cache tiers
- OpenAI + Anthropic compatible proxy via LiteLLM
- Next.js 16 web dashboard with Stripe billing, auth, achievements
- Textual TUI dashboard
- `llmhosts tunnel` (Tailscale/Cloudflare auto-detect)
- Monitoring stack (Prometheus + Grafana + Loki + AlertManager)
- 678 tests (536 backend + 113 frontend + 29 E2E)
- CI/CD: 3 GitHub Actions workflows (CI + CodeQL + Release)
- ~~Headscale running, API integrated, ACLs configured~~ *Deprecated; replaced by self-hosted Rust relay (ADR-009)*
