Repository navigation
Usage projection：derive-on-demand vs durable daily aggregates #37
Description
Part of #34
Blocked by: #35, #36
Decision to make
在 #36 验证可查询 usage facts 后，确定 Usage Projection 的计算与持久化边界：
- 哪些查询可以直接从 DSH SessionEvent / Session Query derive-on-demand；
- 哪些规模或延迟要求需要
(PersonaBot, day, model, purpose)token buckets 的 durable daily projection； - rebuild cursor、schema version、late event、retry/compaction correction 与 price-era recomputation；
- raw usage facts、derived token aggregate 与按价格表计算出的 cost estimate 三者如何区分。
Locked boundaries
- Foundation：operational database owner / writer lease / schema generation #79 的 botharness.db 是唯一 BotHarness operational database physical host。
- 若采用日汇总，由 Usage module 拥有自己的 derived projection tables，并可从已验证的 durable usage facts 重建。
- 不再重新选择
ctx.storageDomainJSON/SQLite、独立数据库或 Dashboard-owned cache 作为 authority。 - Cordis Event 只能在 projection commit 后通知，不能作为 replay source。
- 金额估算可按 价格与计费口径：官方来源、币种/时段/缓存规则 #35 的 price era 重算；不可只存一个不可解释的 money total。
Expected output
- 一项明确的 derive/persist 决策及 rebuild/failure semantics。
- 对 ADR-0005 与 Foundation：operational database owner / writer lease / schema generation #79 后续现状的修订建议。
- 为 Usage read model / Typert remote / Profile contract #39 提供稳定 query shape 与 freshness contract。
Activity
[-]存储与汇总粒度：derive vs 日汇总；json/sqlite（ADR-0005）[/-][+]Usage projection：derive-on-demand vs durable daily aggregates[/+]DoodleBears commentedon Sep 28, 2026
Resolved 2026-09-29（v1.0）：采用 durable daily aggregates。Usage module 在
botharness.db自持(bot, day, provider, model, purpose)token 日桶，可从 DSH Session 日志重建；live 增量 + 迟到事件修正；金额不落库（价格 era 重算留 #35 / #39）。bucket 由assistant/message.usage+assistant/attemptstream usage 经deriveTurnTokenUsage折出，sessionProjections.tokenUsage只做每 Session 对账。实现与 ADR-0005 / #79 修订随 #428。详见 #34 Decisions。