refactor: preserve GraphQL payload shape in project update list JSON

Author: schpet

src/commands/project-update/project-update-list.ts

@@ -1,33 +1,12 @@
 import { Command } from "@cliffy/command"
+import { gql } from "../../__codegen__/gql.ts"
 import { getGraphQLClient } from "../../utils/graphql.ts"
 import { getTimeAgo, padDisplay, truncateText } from "../../utils/display.ts"
 import { resolveProjectId } from "../../utils/linear.ts"
 import { shouldShowSpinner } from "../../utils/hyperlink.ts"
 import { handleError, NotFoundError } from "../../utils/errors.ts"
 
-interface ProjectUpdateNode {
-  id: string
-  body: string | null
-  health: string | null
-  url: string
-  createdAt: string
-  user: {
-    name: string
-    displayName: string
-  } | null
-}
-
-interface ListProjectUpdatesQueryResult {
-  project: {
-    name: string
-    slugId: string
-    projectUpdates: {
-      nodes: ProjectUpdateNode[]
-    } | null
-  } | null
-}
-
-const ListProjectUpdatesQuery = /* GraphQL */ `
+const ListProjectUpdatesQuery = gql(`
   query ListProjectUpdates($id: String!, $first: Int) {
     project(id: $id) {
       name
@@ -44,10 +23,14 @@ const ListProjectUpdatesQuery = /* GraphQL */ `
             displayName
           }
         }
+        pageInfo {
+          hasNextPage
+          endCursor
+        }
       }
     }
   }
-`
+`)
 
 export const listCommand = new Command()
   .name("list")
@@ -67,13 +50,10 @@ export const listCommand = new Command()
       const resolvedProjectId = await resolveProjectId(projectId)
 
       const client = getGraphQLClient()
-      const result = await client.request<ListProjectUpdatesQueryResult>(
-        ListProjectUpdatesQuery,
-        {
-          id: resolvedProjectId,
-          first: limit,
-        },
-      )
+      const result = await client.request(ListProjectUpdatesQuery, {
+        id: resolvedProjectId,
+        first: limit,
+      })
       spinner?.stop()
 
       const project = result.project
@@ -84,17 +64,7 @@ export const listCommand = new Command()
       const updates = project.projectUpdates?.nodes || []
 
       if (json) {
-        console.log(JSON.stringify(
-          {
-            project: {
-              name: project.name,
-              slugId: project.slugId,
-            },
-            updates,
-          },
-          null,
-          2,
-        ))
+        console.log(JSON.stringify(project, null, 2))
         return
       }
 

test/commands/project-update/__snapshots__/project-update-list.test.ts.snap

@@ -0,0 +1,31 @@
+export const snapshot = {};
+
+snapshot[`Project Update List Command - JSON Output 1`] = `
+stdout:
+'{
+  "name": "JSON Project",
+  "slugId": "json-project",
+  "projectUpdates": {
+    "nodes": [
+      {
+        "id": "project-update-1",
+        "body": "Project is healthy.",
+        "health": "onTrack",
+        "url": "https://linear.app/test/project-update-1",
+        "createdAt": "2026-02-10T09:00:00Z",
+        "user": {
+          "name": "alex.active",
+          "displayName": "Alex Active"
+        }
+      }
+    ],
+    "pageInfo": {
+      "hasNextPage": false,
+      "endCursor": null
+    }
+  }
+}
+'
+stderr:
+""
+`;

test/commands/project-update/project-update-list.test.ts

@@ -0,0 +1,62 @@
+import { snapshotTest as cliffySnapshotTest } from "@cliffy/testing"
+import { listCommand } from "../../../src/commands/project-update/project-update-list.ts"
+import { commonDenoArgs } from "../../utils/test-helpers.ts"
+import { MockLinearServer } from "../../utils/mock_linear_server.ts"
+
+await cliffySnapshotTest({
+  name: "Project Update List Command - JSON Output",
+  meta: import.meta,
+  colors: false,
+  args: ["550e8400-e29b-41d4-a716-446655440000", "--json"],
+  denoArgs: commonDenoArgs,
+  async fn() {
+    const server = new MockLinearServer([
+      {
+        queryName: "ListProjectUpdates",
+        variables: {
+          id: "550e8400-e29b-41d4-a716-446655440000",
+          first: 10,
+        },
+        response: {
+          data: {
+            project: {
+              name: "JSON Project",
+              slugId: "json-project",
+              projectUpdates: {
+                nodes: [
+                  {
+                    id: "project-update-1",
+                    body: "Project is healthy.",
+                    health: "onTrack",
+                    url: "https://linear.app/test/project-update-1",
+                    createdAt: "2026-02-10T09:00:00Z",
+                    user: {
+                      name: "alex.active",
+                      displayName: "Alex Active",
+                    },
+                  },
+                ],
+                pageInfo: {
+                  hasNextPage: false,
+                  endCursor: null,
+                },
+              },
+            },
+          },
+        },
+      },
+    ])
+
+    try {
+      await server.start()
+      Deno.env.set("LINEAR_GRAPHQL_ENDPOINT", server.getEndpoint())
+      Deno.env.set("LINEAR_API_KEY", "Bearer test-token")
+
+      await listCommand.parse()
+    } finally {
+      await server.stop()
+      Deno.env.delete("LINEAR_GRAPHQL_ENDPOINT")
+      Deno.env.delete("LINEAR_API_KEY")
+    }
+  },
+})