Last updated: 2026-06-28
Development roadmap for Memory Context Browser (MCB) — a high-performance MCP server for semantic code search, persistent memory, and agent-aware context management.
| Field | Value |
|---|---|
| Version | v0.4.0 from Cargo.toml |
| Branch | feat/v0.4.0-multitenant-weaviate |
| Build | cargo check -p mcb-server clean; make check WHAT=ci green |
| Tests | 578 passing in mcb-server (251 unit + 154 integration + 145 e2e + 28 contract) |
| Crates | 7 first-party workspace crates |
| ADRs | 56 tracked ADRs |
| Metric | Value |
|---|---|
| Beads issues | Use bd status --json for current totals |
| Avg lead time | Use bd status --json for current lead-time metrics |
| TODO/FIXME | make check WHAT=guard clean |
| Languages | 14 via tree-sitter |
| Embedding providers | 6 (FastEmbed, OpenAI, VoyageAI, Ollama, Gemini, Anthropic) |
| Vector stores | 5+ (EdgeVec, Milvus, Qdrant, Pinecone, Encrypted) |
Current work, blockers, and technical-debt ordering are tracked in beads.
- Use
bd ready --jsonfor actionable work. - Use
bd list --status open,in_progress --jsonfor the full open graph. - Use
bd show <id> --jsonfor an individual item's acceptance criteria and evidence.
Tracking: bd show mcb-6pjx.1 --json
Branch: feat/v0.4.0-multitenant-weaviate
Tracking bead: mcb-6pjx.1
Closes the MCP server and Admin UI surface as stable and green. All 24 public MCP tools, 9 handler families, Admin UI pages, and Admin API endpoints are implemented, tested, and passing gates.
| Area | Status |
|---|---|
| MCP handlers (24 tools / 9 families) | Implemented; 28 contract tests green |
| Admin UI pages (dashboard, jobs, health, config, browse, 404) | Implemented; auth middleware tests green |
| Admin API (health, jobs, collections, config, dashboard) | Implemented; integration tests green |
| Org-scoped entity CRUD + data isolation | Implemented; golden e2e tests green |
| Version bump + docs sync | Released |
Status: In planning
Tracking: bd show mcb-9cft --json
Branch: feat/v0.4.0-multitenant-weaviate (continues v0.4.0 branch)
Tracking bead: mcb-9cft
Work discovered during v0.4.0 closure that was not in the released scope:
per-request authenticated principal (RequestPrincipal), Keycloak OIDC JWT
validation, scope enforcement, AgentSession conformance to
agent-session.schema.json, webhook ingress for session creation, and OTEL
spans for the session lifecycle.
| Area | Status |
|---|---|
| RequestPrincipal + Keycloak JWT + scope enforcement | Open; bead mcb-6pjx.1.2 |
| AgentSession schema conformance + migration | Open; bead mcb-6pjx.1.5 |
| Webhook ingress (cosmos-hook) → AgentSession | Open; bead mcb-6pjx.1.7 |
| OTEL spans for session lifecycle | Open; bead mcb-6pjx.1.6 |
Status: Released
Tracking: bd show mcb-v5an --json
Branch: feat/v0.3.2-ci-gates
Tracking bead: mcb-v5an
Hardens the release pipeline and development gates after v0.3.1 shipped. The scope is CI cache efficiency, nextest/test-gate reliability, hook enforcement, typos/doc validation, and release workflow resilience.
| Area | Status |
|---|---|
| Release workflow resilience | Released |
| Rust cache and nextest CI tuning | Released |
| Typos and hook gates | Released |
| Docs/governance cleanup | Released |
| Final PR/check validation | Released |
Stabilizes the SeaQL + Loco baseline for release by closing handler response format drift, Docker runtime configuration, test helper reuse, and agent instruction canonicalization.
| Area | Status |
|---|---|
| MCP JSON response formatting cleanup | Released |
| Loco inline config for Docker profiles | Released |
| Docker app/stdio compose profiles | Released |
| Agent instruction canonicalization | Released |
| Release gates | Completed for v0.3.1 release publication |
Status: Released
Branch: release/v0.2.1
Consolidates all pre-v0.3.0 work: admin UI, data model hardening, modernization cleanup. No intermediate 0.2.x release exists between this track and v0.3.0.
| Area | Status |
|---|---|
| Admin UI (Handlebars CRUD) | ✅ Complete |
| P0 modernization (org context, lock/cache, dead code) | ✅ Complete |
| P1/P2 modernization (provider consolidation, docs) | ✅ Complete |
| CI pipeline modernization | ✅ Complete |
Status: Released Released: 2026-02-27 Key ADRs: 049 (Axum), 050 (Composition Root), 051 (SeaQL+Loco master plan), 052 (Schema Resolution)
Full platform rebuild on SeaQL (SeaORM, SeaQuery, SeaSchema, SeaStreamer) and Loco.rs. Replaces Figment/TOML config, dill DI, and adds native Axum + rmcp Tower support.
| Component | Description |
|---|---|
| Loco.rs | Framework for server lifecycle, YAML config, migrations, workers |
| SeaORM | Async ORM for all persistence (replaces raw SQLx) |
| SeaORM Pro | Admin UI with CRUD, GraphQL, and seaography |
| Axum Native | rmcp Tower compatibility via Axum (ADR-049) |
| Manual Composition Root | linkme + Handle pattern, dill removed (ADR-050) |
| SeaStreamer | Event architecture (replaces ADR-004 event bus) |
Unblocks: v0.4.0 Workflow System
Tracking: bd show mcb-6pjx --json
Key ADRs: 034 (FSM), 035 (Scout), 036 (Policies), 037 (Orchestrator), 038 (Tiers)
Implements complete workflow system with FSM-based task orchestration, context scouting, and policy enforcement.
| Component | Description |
|---|---|
| WorkflowFSM | 12-state machine for task orchestration with transitions and compensation |
| ContextScout | Freshness tracking (Fresh/Acceptable/Stale/StaleWithRisk) |
| PolicyEngine | 11+ policies for workflow validation and enforcement |
| TaskOrchestrator | Multi-layer coordination with event broadcasting |
| ExecutionTiers | Hierarchical execution (immediate, scheduled, deferred) |
Unblocks: v0.5.0 Integrated Context System
Tracking: future beads created from ADR-041 through ADR-046 when this milestone becomes active Key ADRs: 041-046 Multi-source integrated context with knowledge graphs, hybrid search, and temporal queries.
| Component | Description |
|---|---|
| Knowledge Graph | petgraph-based relationships (calls, imports, extends) |
| Hybrid Search | RRF fusion of semantic embeddings + BM25 keyword ranking |
| Freshness Tracking | Temporal metadata, immutable snapshots, time-travel queries |
| Context Versioning | Immutable captures at commits/tags with temporal query API |
| Policy Integration | Workflow state gates freshness requirements |
Tracking: conceptual milestone; create beads before implementation work starts
Enterprise-grade platform with SLA guarantees, compliance certifications, and high-availability deployment.
| Feature | Description |
|---|---|
| SLA Guarantees | 99.9% uptime with monitoring |
| High Availability | Multi-region with automatic failover |
| Disaster Recovery | Backup/restore with point-in-time recovery |
| Compliance | SOC 2 Type II, ISO 27001, GDPR |
- ADR-Driven: Architectural decisions documented before implementation
- Test-First: Core functionality developed with comprehensive tests
- Clean Architecture: 7-crate first-party workspace with trait-based DI
- Documentation First: Documentation updated with each code change
- Architecture: ARCHITECTURE.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- ADR Index: docs/adr/README.md
- Knowledge Graph Spec: v040-KNOWLEDGE-GRAPH-SPEC.md