Expose timebox stats explicitly

Update GraphQL API to explicitly expose complete, incomplete, total
stats for a given timebox

doc/api/graphql/reference/gitlab_schema.graphql

@@ -20515,6 +20515,41 @@ Time represented in ISO 8601
 """
 scalar Time
 
+"""
+Represents the time report stats for timeboxes
+"""
+type TimeReportStats {
+  """
+  Completed issues metrics
+  """
+  complete: TimeboxMetrics
+
+  """
+  Incomplete issues metrics
+  """
+  incomplete: TimeboxMetrics
+
+  """
+  Total issues metrics
+  """
+  total: TimeboxMetrics
+}
+
+"""
+Represents measured stats metrics for timeboxes
+"""
+type TimeboxMetrics {
+  """
+  The count metric
+  """
+  count: Int!
+
+  """
+  The weight metric
+  """
+  weight: Int!
+}
+
 """
 Represents a historically accurate report about the timebox
 """
@@ -20523,6 +20558,11 @@ type TimeboxReport {
   Daily scope and completed totals for burnup charts
   """
   burnupTimeSeries: [BurnupChartDailyTotals!]
+
+  """
+  Represents the time report stats for the timebox
+  """
+  stats: TimeReportStats
 }
 
 interface TimeboxReportInterface {

doc/api/graphql/reference/gitlab_schema.json

@@ -59588,6 +59588,110 @@
           "enumValues": null,
           "possibleTypes": null
         },
+        {
+          "kind": "OBJECT",
+          "name": "TimeReportStats",
+          "description": "Represents the time report stats for timeboxes",
+          "fields": [
+            {
+              "name": "complete",
+              "description": "Completed issues metrics",
+              "args": [
+
+              ],
+              "type": {
+                "kind": "OBJECT",
+                "name": "TimeboxMetrics",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "incomplete",
+              "description": "Incomplete issues metrics",
+              "args": [
+
+              ],
+              "type": {
+                "kind": "OBJECT",
+                "name": "TimeboxMetrics",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "total",
+              "description": "Total issues metrics",
+              "args": [
+
+              ],
+              "type": {
+                "kind": "OBJECT",
+                "name": "TimeboxMetrics",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            }
+          ],
+          "inputFields": null,
+          "interfaces": [
+
+          ],
+          "enumValues": null,
+          "possibleTypes": null
+        },
+        {
+          "kind": "OBJECT",
+          "name": "TimeboxMetrics",
+          "description": "Represents measured stats metrics for timeboxes",
+          "fields": [
+            {
+              "name": "count",
+              "description": "The count metric",
+              "args": [
+
+              ],
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "SCALAR",
+                  "name": "Int",
+                  "ofType": null
+                }
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "weight",
+              "description": "The weight metric",
+              "args": [
+
+              ],
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "SCALAR",
+                  "name": "Int",
+                  "ofType": null
+                }
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            }
+          ],
+          "inputFields": null,
+          "interfaces": [
+
+          ],
+          "enumValues": null,
+          "possibleTypes": null
+        },
         {
           "kind": "OBJECT",
           "name": "TimeboxReport",
@@ -59614,6 +59718,20 @@
               },
               "isDeprecated": false,
               "deprecationReason": null
+            },
+            {
+              "name": "stats",
+              "description": "Represents the time report stats for the timebox",
+              "args": [
+
+              ],
+              "type": {
+                "kind": "OBJECT",
+                "name": "TimeReportStats",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
             }
           ],
           "inputFields": null,

doc/api/graphql/reference/index.md

@@ -3013,6 +3013,25 @@ Represents a requirement test report.
 | `id` | ID! | ID of the test report |
 | `state` | TestReportState! | State of the test report |
 
+### TimeReportStats
+
+Represents the time report stats for timeboxes.
+
+| Field | Type | Description |
+| ----- | ---- | ----------- |
+| `complete` | TimeboxMetrics | Completed issues metrics |
+| `incomplete` | TimeboxMetrics | Incomplete issues metrics |
+| `total` | TimeboxMetrics | Total issues metrics |
+
+### TimeboxMetrics
+
+Represents measured stats metrics for timeboxes.
+
+| Field | Type | Description |
+| ----- | ---- | ----------- |
+| `count` | Int! | The count metric |
+| `weight` | Int! | The weight metric |
+
 ### TimeboxReport
 
 Represents a historically accurate report about the timebox.
@@ -3020,6 +3039,7 @@ Represents a historically accurate report about the timebox.
 | Field | Type | Description |
 | ----- | ---- | ----------- |
 | `burnupTimeSeries` | BurnupChartDailyTotals! => Array | Daily scope and completed totals for burnup charts |
+| `stats` | TimeReportStats | Represents the time report stats for the timebox |
 
 ### Timelog
 

ee/app/graphql/types/time_report_stats_type.rb

+# frozen_string_literal: true
+
+module Types
+  # rubocop: disable Graphql/AuthorizeTypes
+  class TimeReportStatsType < BaseObject
+    graphql_name 'TimeReportStats'
+    description 'Represents the time report stats for timeboxes'
+
+    field :complete, ::Types::TimeboxMetricsType, null: true,
+          description: 'Completed issues metrics'
+
+    field :incomplete, ::Types::TimeboxMetricsType, null: true,
+          description: 'Incomplete issues metrics'
+
+    field :total, ::Types::TimeboxMetricsType, null: true,
+          description: 'Total issues metrics'
+  end
+end

ee/app/graphql/types/timebox_metrics_type.rb

+# frozen_string_literal: true
+
+module Types
+  # rubocop: disable Graphql/AuthorizeTypes
+  class TimeboxMetricsType < BaseObject
+    graphql_name 'TimeboxMetrics'
+    description 'Represents measured stats metrics for timeboxes'
+
+    field :count, GraphQL::INT_TYPE, null: false,
+          description: 'The count metric'
+
+    field :weight, GraphQL::INT_TYPE, null: false,
+          description: 'The weight metric'
+  end
+end

ee/app/graphql/types/timebox_report_type.rb

@@ -6,6 +6,8 @@ module Types
     graphql_name 'TimeboxReport'
     description 'Represents a historically accurate report about the timebox'
 
+    field :stats, ::Types::TimeReportStatsType, null: true,
+          description: 'Represents the time report stats for the timebox'
     field :burnup_time_series, [::Types::BurnupChartDailyTotalsType], null: true,
           description: 'Daily scope and completed totals for burnup charts'
   end

ee/app/services/timebox_report_service.rb

@@ -36,7 +36,8 @@ class TimeboxReportService
     end
 
     ServiceResponse.success(payload: {
-      burnup_time_series: chart_data
+      burnup_time_series: chart_data,
+      stats: build_stats
     })
   end
 
@@ -218,4 +219,24 @@ class TimeboxReportService
       raise ArgumentError, 'Cannot handle timebox type'
     end
   end
+
+  def build_stats
+    stats_data = chart_data.last
+    return unless stats_data
+
+    {
+      complete: {
+        count: stats_data[:completed_count],
+        weight: stats_data[:completed_weight]
+      },
+      incomplete: {
+        count: stats_data[:scope_count] - stats_data[:completed_count],
+        weight: stats_data[:scope_weight] - stats_data[:completed_weight]
+      },
+      total: {
+        count: stats_data[:scope_count],
+        weight: stats_data[:scope_weight]
+      }
+    }
+  end
 end

ee/changelogs/unreleased/issue-233707-expose-timebox-total-stats.yml

+---
+title: Expose timebox stats explicitly
+merge_request: 46774
+author:
+type: changed

ee/spec/graphql/resolvers/timebox_report_resolver_spec.rb

@@ -34,7 +34,13 @@ RSpec.describe Resolvers::TimeboxReportResolver do
       end
 
       it 'returns burnup chart data' do
-        expect(subject).to eq(burnup_time_series: [
+        expect(subject).to eq(
+          stats: {
+            complete: { count: 0, weight: 0 },
+            incomplete: { count: 2, weight: 0 },
+            total: { count: 2, weight: 0 }
+          },
+          burnup_time_series: [
           {
             date: start_date + 4.days,
             scope_count: 1,