AI consultant post-public-alpha H2 — build log
Tier: Public
Status: In progress (2026-05)
Plan: Post-α H2 AI consultant expansion (Cursor plan, not checked in)
1. Wave table
| Wave | Focus | Status | Surface doc |
|---|---|---|---|
| A | Design surfaces + ROADMAP | Shipped | reporting / RAG / propose-write surfaces |
| B | MRP/CRP propose-write MVP | Shipped | canonical-ai-propose-write-surface.md |
| C | Reporting DSL MVP | Shipped | canonical-ai-reporting-dsl-surface.md |
| D | RAG D1 (product docs) | Shipped | canonical-ai-rag-surface.md |
| E | Multi-provider BYOK router; managed-AI deferred | Shipped (router only) | PLATFORM-ARCHITECTURE.md §7.3 |
2. Wave A — documentation
| Artifact | Path |
|---|---|
| Reporting DSL surface | canonical-ai-reporting-dsl-surface.md |
| RAG surface | canonical-ai-rag-surface.md |
| Propose-write surface | canonical-ai-propose-write-surface.md |
| ROADMAP wave table | ROADMAP.md § H2 2026 AI consultant |
3. Wave B — propose-write
4. Wave C — reporting DSL
| Area | Paths |
|---|---|
| AST + executor | services/api/src/services/ai/reporting/ |
| Tool | services/api/src/services/ai/tools/platform/reportingQuery.ts |
| Migration | services/api/prisma/migrations/*_reporting_views/ |
5. Wave D — RAG D1
| Area | Paths |
|---|---|
| pgvector init | infra/postgres/init/03-ai-pgvector.sql |
| pgvector migration | services/api/prisma/migrations/20260527120200_ai_pgvector_rag_schema/ (conditional) |
| CI pgvector | .github/workflows/api.yml uses pgvector/pgvector:pg16 |
| Ingest | services/api/src/services/ai/rag/ingestPublicDocs.ts |
| Tool | services/api/src/services/ai/tools/platform/searchProductDocs.ts |
6. Wave E — provider router (managed-AI deferred)
| Area | Notes |
|---|---|
| Adapters | services/api/src/services/ai/providers/ |
| Deferral | WorkspaceBillingAddon + credits documented in ROADMAP → H1 2027 |
7. Verification
cd packages/sdk/ai-tool-sdk && npm run build
cd packages/platform/contracts && npm run build
cd packages/platform/ui && npm run build
cd services/api && npm run typecheck
docker compose exec -T api sh -c 'cd /app && npm test -- src/tests/ai/'
8. Known limits
- Propose apply is preview-only until MRP/CRP domain write routes ship.
- Reporting MVP: two views only; no cross-module joins.
- RAG D1: local deterministic embeddings; not provider-quality semantic search.
- Managed-AI credits: not shipped; OpenAI BYOK adapter + router only.