Epic: 003-collectors (v0.3)

[ichinya]

Goal

Normalize multiple provider sources into one core-owned usage model.

Scope

• add OpenAI collector support
• add GitHub Copilot collector support
• normalize provider payloads into shared usage and subscription entities
• expose configured provider state through contracts

Done When

• OpenAI and Copilot data can be ingested by core
• API responses use shared provider-independent structures
• collector failures degrade gracefully without corrupting totals

Dependencies

Blocked by

• Epic: 001-core-base (v0.1) #1

Enables

• Epic: 005-tray-ui (v0.4) quiverkeep-ui#1
• Epic: 010-mvp (v1.0) #6

Cross-repo / version gate

• Provider normalization is required before MVP-level product surfaces.

[ichinya]

Planning note after proxy-mode docs/roadmap sync:

• 0.3 / 003-collectors is the passive collector lane, separate from transport proxy.
• Collectors should ingest provider APIs, logs, files, or tool state into the shared normalized usage model.
• Do not move API proxy or HTTP proxy transport behavior into this epic; transport proxy remains in #2 and #8.
• Shared usage/storage contracts should be reused across proxy and collectors, but the implementation boundary stays explicit.