Phase 2.5 provider generalization

Phase 2.5 — Tracks

Six execution tracks for provider generalization.

Phase 2.5 — Tracks

Track A — Multi-Provider Adapters

Prove the Provider interface generalizes beyond OpenAI by implementing structurally different providers.

Status: Complete (G1.M1–M3 on main)

Preferred sequencing within track: 2.5.G1.M1 → 2.5.G1.M2 → 2.5.G1.M3

Related tracks: Track B uses TokenizerFamily from the capability registry.

Track B — Tokenizer Registry

Accurate token counting across provider-specific tokenizers, required for downstream budget calculation.

Status: Complete (G2.M1)

Preferred sequencing within track: single milestone; depends on Track A capability registry for TokenizerFamily.

Track C — Response-Side Processing Pipeline

Typed response decode/re-encode pipeline enabling post-provider processing stages (usage normalization, metadata injection).

Preferred sequencing within track: 2.5.G3.M1 → 2.5.G3.M2 (streaming is design/spike after non-streaming seam)

Status: Complete (G3.M1–M2)

Track D — Pluggable Embedding Service

Abstract embedding behind a backend interface so the memory system can swap models without changing callers. Profile choice is a deployment setting; dimensionalities are not interchangeable without migration.

Status: Complete (G4.M1–M4 on main)

Preferred sequencing within track: 2.5.G4.M1 → 2.5.G4.M2 / 2.5.G4.M3 → 2.5.G4.M4

Track E — Schema Pre-Work

Migration-only, additive schema changes preparing Postgres for Phase 3's write pipeline — temporal validity, multi-label categories, relationship graph indexes. Migration sketches on linked milestones are orientation only and may change during schema work.

Status: Completed (G5.M1–M3)

Preferred sequencing within track: 2.5.G5.M1 → 2.5.G5.M2 → 2.5.G5.M3 (can run in parallel with Tracks A/B)

Track F — MCP Server Skeleton

Auth-boundary-scoped MCP server with stub tools, proving the resource-server auth boundary and audit-log wiring before Phase 3's real memory service exists.

Status: Completed

Preferred sequencing within track: single milestone; prefer after Track A auth/provider patterns are stable.

Track G — Exit / Ops Pack-Up

Formal Phase 2.5 exit: local LGTM observability, multi-service verify gate, thin K8s observability chart, and roadmap sign-off before Phase 3.

Status: Completed

Preferred sequencing within track: single milestone after Tracks A–F.

Edit on GitHub

Last updated on

On this page

0%