Merge branch '37102-expose-human-readable-time-estimate-via-graphql' into 'master'

Expose humanTimeEstimate and humanTotalTimeSpent via graphql

See merge request gitlab-org/gitlab!45508

app/graphql/types/issue_type.rb

@@ -74,6 +74,10 @@ module Types
           description: 'Time estimate of the issue'
     field :total_time_spent, GraphQL::INT_TYPE, null: false,
           description: 'Total time reported as spent on the issue'
+    field :human_time_estimate, GraphQL::STRING_TYPE, null: true,
+          description: 'Human-readable time estimate of the issue'
+    field :human_total_time_spent, GraphQL::STRING_TYPE, null: true,
+          description: 'Human-readable total time reported as spent on the issue'
 
     field :closed_at, Types::TimeType, null: true,
           description: 'Timestamp of when the issue was closed'

changelogs/unreleased/37102-expose-human-readable-time-estimate-via-graphql.yml

+---
+title: Expose humanTimeEstimate and humanTotalTimeSpent via graphql
+merge_request: 45508
+author:
+type: changed

doc/api/graphql/reference/gitlab_schema.graphql

@@ -6807,6 +6807,16 @@ type EpicIssue implements CurrentUserTodos & Noteable {
   """
   healthStatus: HealthStatus
 
+  """
+  Human-readable time estimate of the issue
+  """
+  humanTimeEstimate: String
+
+  """
+  Human-readable total time reported as spent on the issue
+  """
+  humanTotalTimeSpent: String
+
   """
   Global ID of the epic-issue relation
   """
@@ -9020,6 +9030,16 @@ type Issue implements CurrentUserTodos & Noteable {
   """
   healthStatus: HealthStatus
 
+  """
+  Human-readable time estimate of the issue
+  """
+  humanTimeEstimate: String
+
+  """
+  Human-readable total time reported as spent on the issue
+  """
+  humanTotalTimeSpent: String
+
   """
   ID of the issue
   """

doc/api/graphql/reference/gitlab_schema.json

@@ -18716,6 +18716,34 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "humanTimeEstimate",
+              "description": "Human-readable time estimate of the issue",
+              "args": [
+
+              ],
+              "type": {
+                "kind": "SCALAR",
+                "name": "String",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "humanTotalTimeSpent",
+              "description": "Human-readable total time reported as spent on the issue",
+              "args": [
+
+              ],
+              "type": {
+                "kind": "SCALAR",
+                "name": "String",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "id",
               "description": "Global ID of the epic-issue relation",
@@ -24526,6 +24554,34 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "humanTimeEstimate",
+              "description": "Human-readable time estimate of the issue",
+              "args": [
+
+              ],
+              "type": {
+                "kind": "SCALAR",
+                "name": "String",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "humanTotalTimeSpent",
+              "description": "Human-readable total time reported as spent on the issue",
+              "args": [
+
+              ],
+              "type": {
+                "kind": "SCALAR",
+                "name": "String",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "id",
               "description": "ID of the issue",

doc/api/graphql/reference/index.md

@@ -1081,6 +1081,8 @@ Relationship between an epic and an issue.
 | `epic` | Epic | Epic to which this issue belongs |
 | `epicIssueId` | ID! | ID of the epic-issue relation |
 | `healthStatus` | HealthStatus | Current health status. Returns null if `save_issuable_health_status` feature flag is disabled. |
+| `humanTimeEstimate` | String | Human-readable time estimate of the issue |
+| `humanTotalTimeSpent` | String | Human-readable total time reported as spent on the issue |
 | `id` | ID | Global ID of the epic-issue relation |
 | `iid` | ID! | Internal ID of the issue |
 | `iteration` | Iteration | Iteration of the issue |
@@ -1273,6 +1275,8 @@ Represents a recorded measurement (object count) for the Admins.
 | `dueDate` | Time | Due date of the issue |
 | `epic` | Epic | Epic to which this issue belongs |
 | `healthStatus` | HealthStatus | Current health status. Returns null if `save_issuable_health_status` feature flag is disabled. |
+| `humanTimeEstimate` | String | Human-readable time estimate of the issue |
+| `humanTotalTimeSpent` | String | Human-readable total time reported as spent on the issue |
 | `id` | ID! | ID of the issue |
 | `iid` | ID! | Internal ID of the issue |
 | `iteration` | Iteration | Iteration of the issue |

spec/graphql/types/issue_type_spec.rb

@@ -16,7 +16,7 @@ RSpec.describe GitlabSchema.types['Issue'] do
   it 'has specific fields' do
     fields = %i[id iid title description state reference author assignees participants labels milestone due_date
                 confidential discussion_locked upvotes downvotes user_notes_count web_path web_url relative_position
-                subscribed time_estimate total_time_spent closed_at created_at updated_at task_completion_status
+                subscribed time_estimate total_time_spent human_time_estimate human_total_time_spent closed_at created_at updated_at task_completion_status
                 designs design_collection alert_management_alert severity current_user_todos]
 
     fields.each do |field_name|