Skip to content

Conversation

@jdolle
Copy link
Collaborator

@jdolle jdolle commented Jan 6, 2026

… to the schema definition node

Background

Fix proposal diff view to correctly show what's been added or removed to the schema definition node

https://linear.app/the-guild/issue/CONSOLE-1701/schema-proposals-root-schema-definition-should-show-defined-root

Description

Screenshot 2026-01-06 at 10 55 39 AM

@jdolle jdolle requested a review from n1ru4l January 6, 2026 18:56
@jdolle jdolle self-assigned this Jan 6, 2026
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @jdolle, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request resolves a bug in the schema proposal diff view that led to incorrect visualization of changes to the root schema definition. By refining the type definitions and implementing conditional rendering logic, the system now accurately highlights when Query, Mutation, or Subscription types are added or removed, providing a clearer and more precise diff experience for schema proposals.

Highlights

  • Corrected Schema Diff View: The pull request fixes an issue where the proposal diff view did not correctly display additions or removals of root schema definition nodes (Query, Mutation, Subscription).
  • Improved Root Type Handling: The RootFieldsType now explicitly allows null for query, mutation, and subscription fields, enabling more accurate representation when these root types are absent.
  • Conditional DiffField Rendering: The SchemaDefinitionDiff component has been updated to conditionally render DiffField components for Query, Mutation, and Subscription based on their presence in either the old or new schema, preventing display of non-existent types.
  • Enhanced Schema Definition Change Detection: New logic was introduced to determine if the entire schema definition node represents an addition, removal, or mutual change, improving the visual clarity of the diff.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request refactors the SchemaDefinitionDiff component to correctly display additions or removals of root operation types (query, mutation, subscription) in the schema definition. The changes correctly handle cases where these root types are not defined. My review includes a critical fix for a potential runtime crash caused by incorrect non-null assertions and a suggestion to refactor duplicated logic for better maintainability.

Comment on lines +748 to 824
const oldQuery = oldSchema?.getQueryType();
const oldMutation = oldSchema?.getMutationType();
const oldSubscription = oldSchema?.getSubscriptionType();
const oldRoot: RootFieldsType = {
query: {
args: [],
name: 'query',
type:
oldSchema?.getQueryType() ??
({ name: defaultNames.query, toString: () => defaultNames.query } as GraphQLOutputType),
astNode: null,
deprecationReason: null,
description: null,
extensions: {},
},
mutation: {
args: [],
name: 'mutation',
type:
oldSchema?.getMutationType() ??
({
name: defaultNames.mutation,
toString: () => defaultNames.mutation,
} as GraphQLOutputType),
astNode: null,
deprecationReason: null,
description: null,
extensions: {},
},
subscription: {
args: [],
name: 'subscription',
type:
oldSchema?.getSubscriptionType() ??
({
name: defaultNames.subscription,
toString: () => defaultNames.subscription,
} as GraphQLOutputType),
astNode: null,
deprecationReason: null,
description: null,
extensions: {},
},
query: oldQuery
? {
args: [],
name: 'query',
type: oldQuery,
astNode: null,
deprecationReason: null,
description: null,
extensions: {},
}
: null,
mutation: oldMutation
? {
args: [],
name: 'mutation',
type: oldMutation,
astNode: null,
deprecationReason: null,
description: null,
extensions: {},
}
: null,
subscription: oldSubscription
? {
args: [],
name: 'subscription',
type: oldSubscription,
astNode: null,
deprecationReason: null,
description: null,
extensions: {},
}
: null,
};

const newQuery = newSchema?.getQueryType();
const newMutation = newSchema?.getMutationType();
const newSubscription = newSchema?.getSubscriptionType();
const newRoot: RootFieldsType = {
query: {
args: [],
name: 'query',
type:
newSchema?.getQueryType() ??
({ name: defaultNames.query, toString: () => defaultNames.query } as GraphQLOutputType),
astNode: null,
deprecationReason: null,
description: null,
extensions: {},
},
mutation: {
args: [],
name: 'mutation',
type:
newSchema?.getMutationType() ??
({
name: defaultNames.mutation,
toString: () => defaultNames.mutation,
} as GraphQLOutputType),
astNode: null,
deprecationReason: null,
description: null,
extensions: {},
},
subscription: {
args: [],
name: 'subscription',
type:
newSchema?.getSubscriptionType() ??
({
name: defaultNames.subscription,
toString: () => defaultNames.subscription,
} as GraphQLOutputType),
astNode: null,
deprecationReason: null,
description: null,
extensions: {},
},
query: newQuery
? {
args: [],
name: 'query',
type: newQuery,
astNode: null,
deprecationReason: null,
description: null,
extensions: {},
}
: null,
mutation: newMutation
? {
args: [],
name: 'mutation',
type: newMutation,
astNode: null,
deprecationReason: null,
description: null,
extensions: {},
}
: null,
subscription: newSubscription
? {
args: [],
name: 'subscription',
type: newSubscription,
astNode: null,
deprecationReason: null,
description: null,
extensions: {},
}
: null,
};
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The logic for creating oldRoot and newRoot is duplicated. This can be extracted into a helper function to improve readability and maintainability by reducing code duplication.

  const createRootFieldsForSchema = (schema: GraphQLSchema | undefined | null): RootFieldsType => {
    const createField = (
      type: import('graphql').GraphQLObjectType<any, any> | null | undefined,
      name: 'query' | 'mutation' | 'subscription',
    ): GraphQLField<any, any> | null => {
      if (!type) {
        return null;
      }
      return {
        args: [],
        name,
        type,
        astNode: null,
        deprecationReason: null,
        description: null,
        extensions: {},
      };
    };

    return {
      query: createField(schema?.getQueryType(), 'query'),
      mutation: createField(schema?.getMutationType(), 'mutation'),
      subscription: createField(schema?.getSubscriptionType(), 'subscription'),
    };
  };

  const oldRoot = createRootFieldsForSchema(oldSchema);
  const newRoot = createRootFieldsForSchema(newSchema);

@github-actions
Copy link
Contributor

github-actions bot commented Jan 6, 2026

🚀 Snapshot Release (alpha)

The latest changes of this PR are available as alpha on npm (based on the declared changesets):

Package Version Info
@graphql-hive/apollo 0.46.0-alpha-20260106185704-7b667cb7abdec9538ef770c5767ceaf1e20938e2 npm ↗︎ unpkg ↗︎
@graphql-hive/cli 0.57.0-alpha-20260106185704-7b667cb7abdec9538ef770c5767ceaf1e20938e2 npm ↗︎ unpkg ↗︎
@graphql-hive/core 0.19.0-alpha-20260106185704-7b667cb7abdec9538ef770c5767ceaf1e20938e2 npm ↗︎ unpkg ↗︎
@graphql-hive/envelop 0.40.1-alpha-20260106185704-7b667cb7abdec9538ef770c5767ceaf1e20938e2 npm ↗︎ unpkg ↗︎
@graphql-hive/yoga 0.46.1-alpha-20260106185704-7b667cb7abdec9538ef770c5767ceaf1e20938e2 npm ↗︎ unpkg ↗︎
hive 8.14.0-alpha-20260106185704-7b667cb7abdec9538ef770c5767ceaf1e20938e2 npm ↗︎ unpkg ↗︎
hive-apollo-router-plugin 2.3.6-alpha-20260106185704-7b667cb7abdec9538ef770c5767ceaf1e20938e2 npm ↗︎ unpkg ↗︎
hive-console-sdk-rs 0.2.3-alpha-20260106185704-7b667cb7abdec9538ef770c5767ceaf1e20938e2 npm ↗︎ unpkg ↗︎

@github-actions
Copy link
Contributor

github-actions bot commented Jan 6, 2026

📚 Storybook Deployment

The latest changes are available as preview in: https://pr-7465.hive-storybook.pages.dev

@github-actions
Copy link
Contributor

github-actions bot commented Jan 6, 2026

💻 Website Preview

The latest changes are available as preview in: https://pr-7465.hive-landing-page.pages.dev

@github-actions
Copy link
Contributor

github-actions bot commented Jan 6, 2026

🐋 This PR was built and pushed to the following Docker images:

Targets: build

Platforms: linux/amd64

Image Tag: 7b667cb7abdec9538ef770c5767ceaf1e20938e2

@jdolle jdolle merged commit b793b27 into main Jan 7, 2026
26 checks passed
@jdolle jdolle deleted the proposal-schema-def-diff branch January 7, 2026 17:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants