Tau Qodq

Chart and CSV semantics

quota.svg shows one line for each selected subscription. It explicitly selects the canonical default codex/primary series: the Codex adapter maps an official nameless rate-limit observation to the canonical default codex pool, and primary is the provider-normalized primary window. It retains the maximum actual remaining_percent observation per subscription and UTC hour, breaking the line for every missing hour. This display-only reduction never averages, interpolates, predicts, or alters CSV evidence. Ties retain the latest (observation time, sequence, profile epoch). quota.csv still retains every pool, window, and process epoch. The SVG legend contains only the supplied subscription labels; it exposes no pool/window or epoch IDs. Its values are remaining_percent = 100 - used_basis_points / 100. It guides and labels every UTC day boundary.

tokens.csv retains selected canonical terminals in UTC-aligned half-open one-hour rows [HH:00, HH+1:00), selected by the terminal's recorded_at_micros. tokens.svg reduces those rows to UTC-aligned six-hour buckets starting at 00:00, 06:00, 12:00, and 18:00, with connected lines only across consecutive buckets. It renders all three six-hour measurements on one shared logarithmic log1p Y axis:

Cache hits    = Σ prompt_cached_tokens / 21,600 tokens/s
Cache misses  = Σ (prompt_sent_tokens - prompt_cached_tokens) / 21,600 tokens/s
Output tokens = Σ response_received_tokens / 21,600 tokens/s

Those denominators apply to full buckets. At either range boundary, hourly CSV and six-hour display rates divide by the seconds in the bucket's intersection with [since, until), not by a full hour/six hours or the span between observations. CSV interval_start, interval_end, elapsed_seconds, and partial_bucket label partial hourly rows; the SVG labels boundary normalization and the exact range, and summary.txt counts partial hourly/six-hour rows. Bucket points use the clipped interval midpoint, so current partial buckets stay within the axis. The axis reaches the selected endpoint; the charts do not fabricate observations there, extend evidence to it, or connect across missing evidence.

Subscription color identifies the selected profile; line style identifies the metric. The chart contains exactly those six profile/metric lines. Its zero-preserving transform is log(1 + six-hour tokens/s) / log(1 + largest displayed six-hour tokens/s): an observed zero remains at the baseline, rather than being dropped or replaced with a positive value. Y ticks label actual tokens/s values, not transformed coordinates.

The SVG never invents a six-hour bucket for absent evidence and never connects across a missing UTC six-hour bucket. Missing hourly rows are unknown/missing evidence, not zero use. An absent usage record is unavailable usage. An old canonical record lacking the serialized prompt_cached_tokens field is also unavailable for this chart: the extractor does not reinterpret it as Cache hits zero, and excludes that terminal's three categories. A present zero is used because the current canonical schema serializes the field as a non-optional count.

For token replay/catch-up deduplication, one terminal identity is (selected profile label, agent_id, agent_prompt_id, provider_attempt). Repeated identities retain the earliest (recorded_at_micros, selected file path, line number) record before the time filter; a replay inside a range does not turn an original terminal outside it into new consumption. Conflicting complete-usage counts are reported once per terminal identity, not summed. If the retained earliest copy lacks prompt_cached_tokens, later explicit-zero replays cannot replace it and that terminal remains omitted. This is intentionally separate from quota plotting: quota is snapshot evidence, not additive consumption.

Summary and interpretation

summary.txt reports selected profiles/files/bytes, candidate and validated canonical events, malformed data, missing usage/cache fields, out-of-range and unselected-model terminals, duplicate/conflicting token identities, retained quota rows, omitted unchanged quota rows, hourly token rows, rendered values, and elapsed time. Report these exact values, the exact selection/range, and the artifact paths with any conclusion.

Remember:

• A quota plateau is repeated observed state, not continuous metering.
• A rise in remaining quota or reset shift can be reset/reconciliation, not negative consumption.
• Gaps, empty snapshots, missing terminal usage, and absent hourly rows are unknown, not zero.
• Token timestamps are canonical log-admission/accepted-terminal times, not provider metering instants.

Run the focused oracle after changing the generator:

nix shell .#diagnostics -c tau-diagnostics-cargo test \
  --manifest-path .agents/skills/tau-qodq/extract_quota.rs