[ImLunaHey]

Defines the public depot.core.v1.UsageAnalyticsService contract for organization-scoped usage analysis.

• Daily series, product/project/repository/workflow breakdowns, report rows, agent usage, and current-period totals.
• Time windows, filters, pagination, coverage metadata, stable attribution keys, and documented units.
• Additive service; existing UsageService remains unchanged.

Merge this first. The existing main-branch workflow publishes buf.build/depot/api; downstream PRs must consume the resulting artifacts before release:

• API implementation: https://github.com/depot/api/pull/6555
• Node SDK: feat(usage): expose analytics reads and period comparison example sdk-node#41
• CLI: feat(usage): add structured usage analysis commands cli#662
• Documentation: docs(usage): document self-service analysis across API CLI and MCP docs#192

MCP consumes the published Node SDK from the API build. It requires an SDK release and an API dependency/lockfile bump; it must not add a separate SDK implementation.

Validation: Buf lint, FILE breaking check against main, and formatting of the new schema pass. Existing build.proto has unrelated formatting drift.

Refs DEP-7658.

[linear-code]

DEP-7658

[cursor]

Risk: medium. Approved this additive public usage-analytics proto contract; lint passed, Cursor Bugbot was not present, and no approval policy required human review. No reviewers were assigned.

  

_{Sent by Cursor Approval Agent: Pull Request Router and Approver}