Skip to content

ELX-25: Observability — corpus-state snapshot, the remaining 2 signals #5

Description

@cdevarenne

Four of the six observability signals ship today: router decision, canonical hit/miss, refusal
rate, and per-path latency. All four fall out of one event per answered query.

The remaining two are a different shape. Concepts past stale_after and trust-tier
distribution
are not about a query at all — they are a scan over knowledge/ describing the
bundle's governance state at a moment, on a much slower cadence. That is why they were split
out rather than padded into the per-query slice.

A time series of these snapshots is what turns "is governance keeping up?" into a line on a
chart, and it is also what closes the staleness early-warning gap.

Done when

  • gctx telemetry snapshot scans knowledge/ and prints locally, with no cluster
  • --as-of time-travels, so a governance cliff is visible before it arrives
  • staleness and trust tier are derived by the same code the deterministic lookup uses
    a snapshot that disagreed with lookup() about a concept would mean one of them is wrong
  • aggregates plus a bounded list of stale ids, never a per-concept dump: the instrument
    built to answer "does curation scale?" must not itself scale with the corpus
  • projected into its own index, with Kibana panels over the time series

Contract: docs/specs/observability-corpus-state.md.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

P2Planned

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions