ci: detect graphql schema drift (#761)

* ci: detect drift between committed graphql snapshot and live schema (#754)

Adds a CI step that regenerates packages/api-types/graphql/schema.graphql
and fails on any diff, so a Pothos type/resolver change without the paired
regen surfaces in CI rather than as a runtime mismatch in codegen consumers.

Also refreshes the snapshot itself — graphql-js's printer collapses
single-line descriptions to inline """...""", and the committed copy
predated that formatting, so the new check would have failed on its own
PR without this regen.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* ci: ignore generated graphql snapshot in prettier

graphql-js's printSchema collapses single-line descriptions inline
(""text""), but prettier expands them to multi-line. The two formatters
were silently fighting — every regen triggers a prettier diff, and every
prettier-write triggers a schema-drift diff. Add the snapshot to
.prettierignore so the print script is the sole source of truth for
its format.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: zachdunn

.github/workflows/ci.yml

@@ -80,5 +80,14 @@ jobs:
           echo "Found new wrangler migration file(s):"
           echo "$added" | sed 's/^/  /'
 
+      - name: Verify GraphQL schema snapshot is up to date
+        run: |
+          bun workers/api/scripts/print-graphql-schema.ts
+          if ! git diff --exit-code packages/api-types/graphql/schema.graphql; then
+            echo "ERROR: packages/api-types/graphql/schema.graphql is stale." >&2
+            echo "Regenerate with: bun workers/api/scripts/print-graphql-schema.ts" >&2
+            exit 1
+          fi
+
       - name: Run tests
         run: bun run test

.prettierignore

@@ -11,3 +11,4 @@ package-lock.json
 plugins/claude-code/skills
 packages/*/dist
 tests/evals/fixtures/tool-ux/runs
+packages/api-types/graphql/schema.graphql

packages/api-types/graphql/schema.graphql

@@ -5,19 +5,15 @@ scalar DateTime
 
 scalar JSON
 
-"""
-An image, video, or GIF attached to a release.
-"""
+"""An image, video, or GIF attached to a release."""
 type Media {
   alt: String
   r2Url: String
   type: MediaKind!
   url: String!
 }
 
-"""
-Kind of media attached to a release.
-"""
+"""Kind of media attached to a release."""
 enum MediaKind {
   gif
   image
@@ -46,17 +42,13 @@ type Org {
   updatedAt: DateTime!
 }
 
-"""
-Catalog-shaped page of organizations.
-"""
+"""Catalog-shaped page of organizations."""
 type OrgConnection {
   items: [Org!]!
   pagination: Pagination!
 }
 
-"""
-Page-based pagination envelope. Mirrors REST's Pagination shape.
-"""
+"""Page-based pagination envelope. Mirrors REST's Pagination shape."""
 type Pagination {
   hasMore: Boolean
   page: Int!
@@ -66,9 +58,7 @@ type Pagination {
   totalPages: Int
 }
 
-"""
-Optional grouping layer between an Org and its Sources.
-"""
+"""Optional grouping layer between an Org and its Sources."""
 type Product {
   category: String
   createdAt: DateTime!
@@ -88,27 +78,19 @@ type Query {
   latestReleases(
     cursor: String
 
-    """
-    Drop releases whose source.type is in this list.
-    """
+    """Drop releases whose source.type is in this list."""
     excludeSourceTypes: [SourceType!]
     limit: Int = 20
     orgIdOrSlug: String
   ): ReleaseFeed!
 
-  """
-  Look up an organization by id (org_…) or slug.
-  """
+  """Look up an organization by id (org_…) or slug."""
   org(idOrSlug: String!): Org
 
-  """
-  Catalog-shaped page of organizations, newest first.
-  """
+  """Catalog-shaped page of organizations, newest first."""
   orgs(limit: Int = 20, page: Int = 1): OrgConnection!
 
-  """
-  Look up a release by id (rel_…) — or by url for legacy callers.
-  """
+  """Look up a release by id (rel_…) — or by url for legacy callers."""
   release(idOrUrl: String!): Release
 
   """
@@ -117,9 +99,7 @@ type Query {
   source(id: String!): Source
 }
 
-"""
-A single release (changelog entry).
-"""
+"""A single release (changelog entry)."""
 type Release {
   """
   Full markdown body. Often large — request only when you need it (this is the field-selection win).
@@ -129,9 +109,7 @@ type Release {
   fetchedAt: DateTime!
   id: ID!
 
-  """
-  Images / videos / GIFs attached to the release. Empty list if none.
-  """
+  """Images / videos / GIFs attached to the release. Empty list if none."""
   media: [Media!]!
   publishedAt: DateTime
   source: Source!
@@ -149,9 +127,7 @@ type ReleaseFeed {
   nextCursor: String
 }
 
-"""
-A changelog source (github / scrape / feed / agent).
-"""
+"""A changelog source (github / scrape / feed / agent)."""
 type Source {
   createdAt: DateTime!
   discovery: String!