Skip to content

docs(obs): mark the gateway prerequisite satisfied and T2 superseded (RIG-2867) #1273

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
rigel-mintaka wants to merge 5 commits into
base: main
Choose a base branch
from
+24 −0
Open

docs(obs): mark the gateway prerequisite satisfied and T2 superseded (RIG-2867) #1273

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
03500f3
docs(obs): mark the gateway prerequisite satisfied and T2 superseded …
rigel-mintaka Sep 17, 2026
10017e7
docs(obs): annotate the three remaining stale prerequisite claims (RI…
rigel-mintaka Sep 17, 2026
af0fa25
docs(obs): finish the dependency flip across all six sites (RIG-2867)
rigel-mintaka Sep 17, 2026
9a4a2d8
docs(obs): mark the interface annotations as corrections (RIG-2867)
rigel-mintaka Sep 17, 2026
4c48445
docs(obs): drop the T3-executable over-claim, finish the T2 pointers …
rigel-mintaka Sep 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions docs/designs/observability/compass-observability-architecture/design.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,9 @@ instrumentation **T1 owns** on the write path (distinct from T4b's OTel
telemetry: billing compute cannot be derived from traces any more than from
token counts).

[SATISFIED (RIG-1715): the gateway record has landed; see the Plan's
prerequisite note.]

**Store and read path.** Usage/spend events land in Postgres rollup tables in
the compass-server store (the store today is a single squashed migration,
`go/internal/store/migrations/0001_init.sql:1-8`), behind an append-only write
Expand Down Expand Up @@ -505,6 +508,9 @@ Grafana) is the posture Matt explicitly declined.
yet): bundling the OMP gateway into the Server.** The gateway is the Class-2
event source; T1-T3 depend on it. Its design record must land first.

[SATISFIED (RIG-1715): that record has since landed at
`docs/designs/server/compass-server-llm-gateway/design.md`.]

**Out of scope (managed-plane — named, deferred):** the managed control
plane — cross-tenant analytics and aggregate observability, billing, any
OLAP-backend adoption (Class 3), tenant scheduling, per-tenant telemetry export.
Expand Down Expand Up @@ -539,6 +545,8 @@ Interfaces:
today) and **token-usage** events from the bundled OMP gateway (the upstream
prerequisite); the existing store open/migration machinery behind
`0001_init.sql`.
- Since (RIG-1715): the token-usage events are that record's
`TokenUsageEvent`, emitted by its T4 into the `UsageStore` this task owns.
- Produces: a **`UsageStore` interface** over an append-only event write plus
rollup/series reads (keyed by tenant × account × window), with a Postgres
implementation as the sole backend the core ships, plus an in-memory reference.
Expand Down Expand Up @@ -587,6 +595,8 @@ Interfaces:
{bucket, tokensIn, tokensOut, cost}`), regenerated Go + TS clients via
`moon run compass-proto:gen`; tenant scope enforced server-side, never
client-supplied trust.
- Correction: these RPCs are superseded by RIG-1715 `UsageService` — one
service, so there is no duplicate proto surface to add here.

### T3 — In-app charts (Plane A UI)

Expand All @@ -602,6 +612,9 @@ time-series charts are needed.
Interfaces:

- Consumes: T2's generated `@compass/client` RPCs.
- Correction (RIG-1715): those RPCs are `UsageService.GetUsageSeries` and
`GetProviderQuota`, consumed directly — T2 adds no usage surface of its
own, so the series JSON below comes from `GetUsageSeries`, not T2.
- Produces: `UsageBar` reading live per-account usage (replacing the
`STUB_USAGE` import); a usage/spend view rendering T2's time-series JSON.

Expand Down Expand Up @@ -679,6 +692,9 @@ code. **Track A (Plane A) is blocked** on the undesigned OMP-gateway-into-Server
prerequisite. Execute Track B first; Track A unblocks when the gateway record
lands.

[UNBLOCKED (RIG-1715): the gateway record has landed, so Track A's
prerequisite is met.]

Track B — unblocked (do first):

- [ ] T4 — Plane-B fan-in collector (Owner: compass-server/distribution) —
Expand All @@ -692,8 +708,14 @@ Track B — unblocked (do first):

Track A — blocked on the OMP-gateway prerequisite:

[UNBLOCKED (RIG-1715): the gateway record has landed, so the prerequisite is
met. T1 is executable now; T3 additionally waits on that record's T4 shipping
the UsageService RPCs. T2 is superseded — see its entry below.]

- [ ] PREREQUISITE (upstream, not a task here — write its design record FIRST):
OMP-gateway-into-Server — gates T1-T3.
SATISFIED (RIG-1715) by the LLM-gateway record,
`docs/designs/server/compass-server-llm-gateway/design.md`.
- [ ] T1 — Usage/event store + write contract (Owner: compass-server) — the
runtime compute-usage accounting instrumentation (new in `go/`) + two
append-only event kinds (compute-usage = billing-grade from the runtime;
Expand All @@ -702,6 +724,8 @@ Track A — blocked on the OMP-gateway prerequisite:
- [ ] T2 — Tenant-scoped read gRPC (Owner: compass-server) — `compass.v1`
schema change (fixed granularity enum) + regenerated clients + server-side
tenant scoping.
SUPERSEDED (RIG-1715): the usage RPCs merge into that record's
`UsageService`; no `compass.v1` usage surface to add here.
- [ ] T3 — In-app charts (Owner: compass-ui) — UsageBar wired to live data,
then time-series usage/spend views, native Solid rendering.
- [ ] T6 — PostHog embed + correlation-key join seam (Owner: compass-ui +
Expand Down
Loading