M2 delivers the read-only MCP capability broker gateway and four Day-1 infrastructure adapters (Proxmox, SSH/Linux, GitHub, Gitea). 13 REQs (015-027) all pass. 656 tests green. M1 non-regression verified. MCP spec 2025-06-18 conformance verified (PROTOCOL.md + 7 tests). Defense-in-depth SSH (broker layer 1 + Relay Agent layer 2 + no-shell exec). Two-track LLM smoke (Track A mock-path P0 gate passes). CI: Gitea Actions (.gitea/workflows/ci.yml) with Postgres 16 + RLS verification. Phases shipped: P0 pre-execution v0.1.0 P1 Wave F — MCP gateway v0.1.1 P2 Wave G — Proxmox v0.1.2 P3 Wave H — SSH/Linux v0.1.3 P4 Wave I — Git adapters v0.1.4 P5 Wave J — SSE+smoke+UI v0.1.5 P6 Final — review+ship v0.1.6 ← milestone release ---ci--- phase: 6 milestone: v0.2 status: complete phase_role: final milestone_complete: true requirements: covered: [REQ-015, REQ-016, REQ-017, REQ-018, REQ-019, REQ-020, REQ-021, REQ-022, REQ-023, REQ-024, REQ-025, REQ-026, REQ-027] partial: [] ---/ci---
6.6 KiB
Roadmap
Overview
Placeholder roadmap for the coreci-chat project. The full phase breakdown will be produced by the roadmapper once the project specification is supplied in a follow-up session and the specify → clarify → research stages complete. The current milestone is v0.1 (branch milestone/v0.1-bootstrap); phase 0 is in progress on phase/00-pre-execution.
Milestone type: NFR (placeholder — to be re-evaluated by getMilestoneType() once phases are defined). Tags will run on the previous minor's patch line: phase 0 → v0.0.1 (no prior tags exist, so the v0.0.x line is seeded here).
Milestones
- v0.1 — M1: Read-Only Diagnostic MVP (COMPLETE, shipped v0.0.1..v0.0.7). All 17 M1 REQs (001-014, 038, 039, 040) pass. 189 tests green. Verified in
.ciagent/M1-REVIEW.md. - v0.2 — M2: MCP Layer & Day 1 Adapters (COMPLETE, shipped v0.1.0..v0.1.6). All 13 M2 REQs (015-027) pass. 656 tests green. Verified in
.ciagent/M2-REVIEW.md.
Phases
v0.0.x — M1: Read-Only Diagnostic MVP
- Phase 0: pre-execution - Capture specification, clarification, research, and plan artifacts before any implementation (SHIPPED v0.0.1)
- Phase 1: Wave A — Foundations - Monorepo, Postgres+RLS, audit hash-chain, SecretProvider, Trigger.dev bootstrap (REQ-038, 039, 040) (SHIPPED v0.0.2)
- Phase 2: Wave B — Identity & RBAC - WorkOS SSO, tenant provisioning, RBAC at gateway, invitations, roles (REQ-001..005) (SHIPPED v0.0.3)
- Phase 3: Wave C — BYOM - Endpoint registry, validate-on-save, routing shim, REQ-009 reject (REQ-006..009) (SHIPPED v0.0.4)
- Phase 4: Wave D — Relay Agent - Modular install script, Go binary, WebSocket, heartbeat, SSH whitelist hook (REQ-010..013, REQ-026 hook) (SHIPPED v0.0.5)
- Phase 5: Wave E — Dashboard surfacing - Status fan-out, green/yellow/red, logs, RLS views (REQ-014) (SHIPPED v0.0.6)
- Phase 6: Final — Review + Ship - Multi-persona review, audit, milestone ship v0.1.0 (SHIPPED v0.0.7)
v0.1.x — M2: MCP Layer & Day 1 Adapters
- Phase 0: pre-execution - M2 spec, clarify (D-006/D-007), research (R-001..R-009), plan (Waves F/G/H/I/J + Final + Wave 0), grill (G-011..G-022, all 12 binding fixes applied) (SHIPPED v0.1.0)
- Phase 1: Wave F — MCP Gateway core - Closed 9-tool registry, adapter router, write-method blocklist (INV-7 at broker), token-bucket rate limiter, SSE stream manager, OpenAI↔MCP translator, in-process + stdio transports, synthetic lifecycle handshake,
mcp_adapterstable + RLS, 5 API routes, audit type widening, MCP conformance artifact (PROTOCOL.md + 7 tests) (REQ-015, 016, 017, 018, 019, 024) (SHIPPED v0.1.1) - Phase 2: Wave G — Proxmox adapter - Read-only Proxmox VE adapter with PVEAuditor role validation, 3 capabilities (list_vms/get_vm_status/get_node_metrics), inventory TTL cache, SecretProvider integration (REQ-020, 025) (SHIPPED v0.1.2)
- Phase 3: Wave H — SSH/Linux adapter (Relay Agent) - Read-only SSH adapter via M1 Relay Agent, 6-command whitelist, defense-in-depth (broker layer 1 + Relay CheckCommand layer 2 + no-shell exec layer 3), tool_call WebSocket round-trip, G-013 divergence matrix, G-021 relay-ws regression test (REQ-021, 026 full) (SHIPPED v0.1.3)
- Phase 4: Wave I — Git adapters - Read-only GitHub + Gitea adapters, fine-grained PAT validation (D-006), version-aware Gitea scope routing (R-005), per-invocation scope-via-403 (R-004), rate-limit handling, inventory cache (REQ-022, 023, 027) (SHIPPED v0.1.4)
- Phase 5: Wave J — SSE integration + LLM smoke + adapter UI - SSE consumer in Test-Call UI,
packages/llm-mockCI-only LLM smoke (two-track: Track A mock-path P0 gate + Track B real-GitHub allow-failure, G-018/G-019), Settings → Adapters UI + Test-Call UI, CI/CD pipeline (.gitea/workflows/ci.yml, G-011/G-022) (REQ-017 integration, gate item 8) (SHIPPED v0.1.5) - Phase 6: Final — Review + Audit + Ship - Multi-persona code review, project health audit, M2 gate verification (15 items), milestone ship (SHIPPED v0.1.6 ← M2 milestone release)
Milestone Status
v0.1 — M1: Read-Only Diagnostic MVP: COMPLETE. All 17 M1 REQs (001-014, 038, 039, 040) pass their acceptance criteria. 189 tests green across 7 TS packages + 1 Go package + install script. M1 acceptance gate (spec §2.3) verified in .ciagent/M1-REVIEW.md.
v0.2 — M2: MCP Layer & Day 1 Adapters: COMPLETE. All 13 M2 REQs (015-027) pass their acceptance criteria. 656 tests green (618 unit/integration + 38 conformance/LLM smoke) across 9 TS packages + 1 Go package. M2 acceptance gate (spec §6, 15 items) verified in .ciagent/M2-REVIEW.md. MCP capability broker gateway + 4 Day-1 adapters (Proxmox, SSH/Linux, GitHub, Gitea) + SSE streaming + token-bucket rate limiting + LLM tool-calling smoke + CI/CD pipeline (Postgres 16 RLS). All 12 GRILL binding fixes (G-011..G-022) applied. M1 non-regression holds.
Phase Details
Phase 0: pre-execution
Goal.: Run the pre-execution pipeline stages (SPECIFY → CLARIFY → RESEARCH → PLAN → GRILL → MVP/UX CHECK) and land all .ciagent/ reference files.
Depends on: Nothing
Requirements: REQ-001 (specification), REQ-002 (clarification), REQ-003 (research), REQ-004 (plan)
Success Criteria:
- Full project specification parsed and recorded in PROJECT.md ✓
- Clarify stage completed with all ambiguities resolved (5 decisions D-001..D-005) ✓
- Research artifacts committed under
.ciagent/(R-001..R-007 + PERSONAS.md) ✓ - Plan committed and ready for execution-phase decomposition (5 waves + final) ✓
- Grill passed (PASS-WITH-FIXES, 10 fixes applied) ✓
- MVP/UX check passed (3 sections present) ✓ Status: complete (shipped v0.0.1)
Phase 0 (M2): pre-execution
Goal.: Run the M2 pre-execution pipeline stages (SPECIFY → CLARIFY → RESEARCH → PLAN → GRILL → MVP/UX CHECK) and land all M2 .ciagent/ reference files.
Depends on: M1 complete (v0.0.7)
Requirements: REQ-015..027 (specification), D-006/D-007 (clarification), R-001..R-009 (research), Waves F/G/H/I/J + Final (plan), G-011..G-022 (grill)
Success Criteria:
- M2 engineering spec locked in
steer-m2-spec.md(13 REQs, 9 open questions resolved) ✓ - Clarify stage completed (decisions D-006 GitHub scopes, D-007 MCP transport) ✓
- Research artifacts committed (R-001..R-009, 7 flagged risks integrated) ✓
- Plan committed (Waves F/G/H/I/J + Final + Wave 0; 12 grill fixes applied) ✓
- Grill passed (FAIL → auto-resolved, G-011..G-022 all binding fixes applied) ✓
- MVP/UX check passed (2 user-facing surfaces + BDD happy paths) ✓ Status: complete (shipped v0.1.0)