runtime usage service

[raphael-goetz]

Resolves: #779

[Copilot]

Pull request overview

Implements a “runtime usage” pipeline end-to-end: persists daily aggregated runtime usage per flow/namespace, exposes it via GraphQL connections (with date filtering), and accepts updates via a new gRPC RuntimeUsage service.

Changes:

• Add daily_runtime_usages persistence (migration, model, associations) and a gRPC update service/handler to record/increment usage.
• Expose daily runtime usage via GraphQL (Namespace.dailyRuntimeUsages, Flow.dailyRuntimeUsages) plus a Date scalar and new GraphQL type.
• Add request/service/type specs and generate GraphQL docs for the new schema surface and error code.

Reviewed changes

Copilot reviewed 33 out of 33 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
spec/services/runtimes/grpc/runtime_usage_update_service_spec.rb	Unit coverage for usage update service behavior and validation.
spec/requests/grpc/sagittarius/runtime_usage_service_spec.rb	gRPC request spec for RuntimeUsageService update behavior.
spec/requests/graphql/query/namespace_runtime_usages_query_spec.rb	GraphQL query coverage for namespace-level usage retrieval and filters.
spec/requests/graphql/query/flow_runtime_usages_query_spec.rb	GraphQL query coverage for flow-level usage retrieval and date filtering.
spec/graphql/types/namespace_type_spec.rb	Updates Namespace type field expectations to include dailyRuntimeUsages.
spec/graphql/types/flow_type_spec.rb	Adds Flow type spec including dailyRuntimeUsages.
spec/graphql/types/date_type_spec.rb	Adds tests for the new Types::DateType scalar coercion.
spec/graphql/types/daily_runtime_usage_type_spec.rb	Adds GraphQL type coverage for DailyRuntimeUsage.
spec/factories/daily_runtime_usages.rb	Factory for DailyRuntimeUsage records.
extensions/cloud/spec/graphql/types/cloud/types/namespace_type_spec.rb	Updates Cloud extension Namespace type field expectations.
docs/graphql/scalar/float.md	Adds/records Float scalar documentation entry.
docs/graphql/scalar/date.md	Adds Date scalar documentation entry.
docs/graphql/scalar/dailyruntimeusageid.md	Adds scalar doc entry for DailyRuntimeUsageID.
docs/graphql/object/namespace.md	Documents Namespace.dailyRuntimeUsages field and arguments.
docs/graphql/object/flow.md	Documents Flow.dailyRuntimeUsages field and arguments.
docs/graphql/object/dailyruntimeusageedge.md	Adds connection edge documentation for daily runtime usage.
docs/graphql/object/dailyruntimeusageconnection.md	Adds connection documentation for daily runtime usage.
docs/graphql/object/dailyruntimeusage.md	Adds object documentation for daily runtime usage.
docs/graphql/enum/errorcodeenum.md	Documents the new INVALID_RUNTIME_USAGE error code.
db/structure.sql	Reflects the new daily_runtime_usages table and indexes.
db/schema_migrations/20260510081622	Adds checksum file for the new migration per repo convention.
db/migrate/20260510081622_create_daily_runtime_usage.rb	Migration creating daily_runtime_usages table and FK behavior.
app/services/runtimes/grpc/runtime_usage_update_service.rb	Implements the transactional upsert/increment logic for daily usage.
app/services/error_code.rb	Registers invalid_runtime_usage error code.
app/models/namespace.rb	Adds has_many :daily_runtime_usages association.
app/models/flow.rb	Adds has_many :daily_runtime_usages association.
app/models/daily_runtime_usage.rb	New model for daily runtime usage with validations and relations.
app/grpc/runtime_usage_handler.rb	New gRPC handler wiring RuntimeUsageService update to the new service.
app/graphql/types/namespace_type.rb	Adds daily_runtime_usages connection field and resolver with filters.
app/graphql/types/namespace_project_type.rb	Fixes project flow lookup to use GlobalID model_id with find_by.
app/graphql/types/flow_type.rb	Adds daily_runtime_usages connection field and resolver with date filters.
app/graphql/types/date_type.rb	Adds custom Date scalar (ISO8601) for GraphQL.
app/graphql/types/daily_runtime_usage_type.rb	Adds GraphQL object type for DailyRuntimeUsage with auth subject.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

GitLab Pipeline Action

General information

Link to pipeline: https://gitlab.com/code0-tech/development/sagittarius/-/pipelines/2554246960

Status: Failed
Duration: 6 minutes

Job summaries

rspec: [cloud]

Coverage report available at https://code0-tech.gitlab.io/-/development/sagittarius/-/jobs/14551116376/artifacts/tmp/coverage/index.html
Test summary available at https://gitlab.com/code0-tech/development/sagittarius/-/pipelines/2554246960/test_report
Finished in 24.82 seconds (files took 16.66 seconds to load)
1504 examples, 0 failures
Line Coverage: 92.79% (5162 / 5563)
[TEST PROF INFO] Time spent in factories: 00:15.711 (50.8% of total time)

rspec: [ee]

Coverage report available at https://code0-tech.gitlab.io/-/development/sagittarius/-/jobs/14551116375/artifacts/tmp/coverage/index.html
Test summary available at https://gitlab.com/code0-tech/development/sagittarius/-/pipelines/2554246960/test_report
Finished in 28.84 seconds (files took 14.06 seconds to load)
1468 examples, 0 failures
Line Coverage: 93.0% (5009 / 5386)
[TEST PROF INFO] Time spent in factories: 00:17.601 (46.11% of total time)

rspec: [ce]

Coverage report available at https://code0-tech.gitlab.io/-/development/sagittarius/-/jobs/14551116374/artifacts/tmp/coverage/index.html
Test summary available at https://gitlab.com/code0-tech/development/sagittarius/-/pipelines/2554246960/test_report
Finished in 24.83 seconds (files took 11.03 seconds to load)
1418 examples, 0 failures
Line Coverage: 92.52% (4833 / 5224)
[TEST PROF INFO] Time spent in factories: 00:15.598 (51.05% of total time)

rubocop

855 files inspected, no offenses detected

[raphael-goetz]

@Taucher2003 needs to fix the docs gen