Add player cluster + labeling mutation types

Schema additions for the per-video player labeling UI:
  * `PlayerClusterGQL` / `PlayerClusterShotGQL` — read shape.
  * `FinalizePlayerAssignmentsInput` + `ClusterAssignmentInput` +
    `ShotMoveInput` — write shape.
  * Query: `videoPlayerClusters(videoId)`.
  * Mutation: `finalizePlayerAssignments(input)`.

Generated by `just gql` from the backend type definitions in
`railbird/datatypes/gql/shooter.py` and resolvers in
`railbird/server/resolvers/shooter.py`.

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

src/index.tsx

@@ -205,6 +205,11 @@ export enum ClientUploadStatusEnum {
   UploadEnabled = "UPLOAD_ENABLED",
 }
 
+export type ClusterAssignmentInput = {
+  clusterId: Scalars["Int"]["input"];
+  userId?: InputMaybe<Scalars["Int"]["input"]>;
+};
+
 export type CommentGql = {
   __typename?: "CommentGQL";
   id: Scalars["Int"]["output"];
@@ -224,6 +229,11 @@ export type CreateBucketSetInput = {
   keyName: Scalars["String"]["input"];
 };
 
+export type CreateCustomerPortalSessionResultGql = {
+  __typename?: "CreateCustomerPortalSessionResultGQL";
+  portalUrl: Scalars["String"]["output"];
+};
+
 export type CreateSubscriptionResultGql = {
   __typename?: "CreateSubscriptionResultGQL";
   checkoutUrl: Scalars["String"]["output"];
@@ -2177,6 +2187,12 @@ export type FilterInput =
       videoId: Array<Scalars["Int"]["input"]>;
     };
 
+export type FinalizePlayerAssignmentsInput = {
+  clusterAssignments?: Array<ClusterAssignmentInput>;
+  shotMoves?: Array<ShotMoveInput>;
+  videoId: Scalars["Int"]["input"];
+};
+
 export type FloatOrdering = {
   descending?: Scalars["Boolean"]["input"];
   startingAt?: InputMaybe<Scalars["Float"]["input"]>;
@@ -2191,6 +2207,26 @@ export type FloatRangeFilter = {
   lessThanInclusive?: Scalars["Boolean"]["input"];
 };
 
+export type GameTypeTagMetric = {
+  __typename?: "GameTypeTagMetric";
+  madeShots: Scalars["Int"]["output"];
+  makeRate: Scalars["Float"]["output"];
+  shotCount: Scalars["Int"]["output"];
+  tableSize?: Maybe<Scalars["Float"]["output"]>;
+  tagLabel: Scalars["String"]["output"];
+  tagName: Scalars["String"]["output"];
+};
+
+export type GameTypeTagMetricsInput = {
+  createdAt?: InputMaybe<DateRangeFilter>;
+  groupByTableSize?: Scalars["Boolean"]["input"];
+  includePrivate?: IncludePrivateEnum;
+  includeUnknown?: Scalars["Boolean"]["input"];
+  maxTags?: InputMaybe<Scalars["Int"]["input"]>;
+  tagClass?: InputMaybe<Scalars["String"]["input"]>;
+  userId: Scalars["Int"]["input"];
+};
+
 export type GetProfileUploadLinkErrors = {
   __typename?: "GetProfileUploadLinkErrors";
   error: TooManyProfileImageUploadsErr;
@@ -2353,6 +2389,7 @@ export type Mutation = {
   commentOnVideo: Scalars["Boolean"]["output"];
   createBucketSet: BucketSetGql;
   createChallenge: Challenge;
+  createCustomerPortalSession: CreateCustomerPortalSessionResultGql;
   createRuleSet: RuleSet;
   createSubscription: CreateSubscriptionResultGql;
   createUploadStream: CreateUploadStreamReturn;
@@ -2368,6 +2405,7 @@ export type Mutation = {
   editUploadStream: Scalars["Boolean"]["output"];
   editUser: UserGql;
   ensureStripeCustomerExists: UserGql;
+  finalizePlayerAssignments: Array<PlayerClusterGql>;
   findPrerecordTableLayout?: Maybe<HomographyInfoGql>;
   followUser: UserGql;
   getHlsInitUploadLink: GetUploadLinkReturn;
@@ -2491,6 +2529,10 @@ export type MutationEditUserArgs = {
   input: EditUserInputGql;
 };
 
+export type MutationFinalizePlayerAssignmentsArgs = {
+  input: FinalizePlayerAssignmentsInput;
+};
+
 export type MutationFindPrerecordTableLayoutArgs = {
   b64Image: Scalars["String"]["input"];
   videoId: Scalars["Int"]["input"];
@@ -2653,6 +2695,29 @@ export type PageInfoGql = {
   hasNextPage: Scalars["Boolean"]["output"];
 };
 
+export type PlayerClusterGql = {
+  __typename?: "PlayerClusterGQL";
+  clusterId: Scalars["Int"]["output"];
+  confirmed: Scalars["Boolean"]["output"];
+  nShots: Scalars["Int"]["output"];
+  shots: Array<PlayerClusterShotGql>;
+  userId?: Maybe<Scalars["Int"]["output"]>;
+  videoId: Scalars["Int"]["output"];
+};
+
+export type PlayerClusterShotGql = {
+  __typename?: "PlayerClusterShotGQL";
+  bboxX1: Scalars["Int"]["output"];
+  bboxX2: Scalars["Int"]["output"];
+  bboxY1: Scalars["Int"]["output"];
+  bboxY2: Scalars["Int"]["output"];
+  confidence: Scalars["Float"]["output"];
+  cropUrl?: Maybe<Scalars["String"]["output"]>;
+  fullFrameUrl?: Maybe<Scalars["String"]["output"]>;
+  isConfirmed: Scalars["Boolean"]["output"];
+  shotId: Scalars["Int"]["output"];
+};
+
 export enum PocketEnum {
   Corner = "CORNER",
   Side = "SIDE",
@@ -2732,6 +2797,7 @@ export type Query = {
   getBucketSet?: Maybe<BucketSetGql>;
   getDeployedConfig: DeployedConfigGql;
   getFeedVideos: VideoHistoryGql;
+  getGameTypeTagMetrics: Array<GameTypeTagMetric>;
   getLoggedInUser?: Maybe<UserGql>;
   getLongestRunsLeaderboard: RunLeaderboardGql;
   getMakesLeaderboard: CountLeaderboardGql;
@@ -2762,6 +2828,7 @@ export type Query = {
   notifications: NotificationConnection;
   ruleSets: Array<RuleSet>;
   unreadNotificationCount: Scalars["Int"]["output"];
+  videoPlayerClusters: Array<PlayerClusterGql>;
   waitFor: Scalars["Float"]["output"];
 };
 
@@ -2799,6 +2866,10 @@ export type QueryGetFeedVideosArgs = {
   limit?: Scalars["Int"]["input"];
 };
 
+export type QueryGetGameTypeTagMetricsArgs = {
+  input: GameTypeTagMetricsInput;
+};
+
 export type QueryGetLongestRunsLeaderboardArgs = {
   interval?: InputMaybe<TimeInterval>;
   limit?: Scalars["Int"]["input"];
@@ -2924,6 +2995,10 @@ export type QueryNotificationsArgs = {
   offset?: Scalars["Int"]["input"];
 };
 
+export type QueryVideoPlayerClustersArgs = {
+  videoId: Scalars["Int"]["input"];
+};
+
 export type QueryWaitForArgs = {
   duration: Scalars["Float"]["input"];
 };
@@ -3141,6 +3216,11 @@ export type ShotGql = {
   videoId: Scalars["Int"]["output"];
 };
 
+export type ShotMoveInput = {
+  newClusterId: Scalars["Int"]["input"];
+  shotId: Scalars["Int"]["input"];
+};
+
 export type ShotsOrderingComponent =
   | {
       difficulty: FloatOrdering;
@@ -3239,6 +3319,7 @@ export type StripeProductGql = {
 export type StripeSubscriptionOptionsGql = {
   __typename?: "StripeSubscriptionOptionsGQL";
   products: Array<StripeProductGql>;
+  trialPeriodDays?: Maybe<Scalars["Int"]["output"]>;
 };
 
 export enum StripeSubscriptionStatusEnum {
@@ -5546,6 +5627,23 @@ export type GetUserTagsQuery = {
   }>;
 };
 
+export type GetGameTypeTagMetricsQueryVariables = Exact<{
+  input: GameTypeTagMetricsInput;
+}>;
+
+export type GetGameTypeTagMetricsQuery = {
+  __typename?: "Query";
+  getGameTypeTagMetrics: Array<{
+    __typename?: "GameTypeTagMetric";
+    tagName: string;
+    tagLabel: string;
+    tableSize?: number | null;
+    shotCount: number;
+    madeShots: number;
+    makeRate: number;
+  }>;
+};
+
 export type FollowUserMutationVariables = Exact<{
   followedUserId: Scalars["Int"]["input"];
 }>;
@@ -11529,6 +11627,84 @@ export type GetUserTagsQueryResult = Apollo.QueryResult<
   GetUserTagsQuery,
   GetUserTagsQueryVariables
 >;
+export const GetGameTypeTagMetricsDocument = gql`
+  query GetGameTypeTagMetrics($input: GameTypeTagMetricsInput!) {
+    getGameTypeTagMetrics(input: $input) {
+      tagName
+      tagLabel
+      tableSize
+      shotCount
+      madeShots
+      makeRate
+    }
+  }
+`;
+
+/**
+ * __useGetGameTypeTagMetricsQuery__
+ *
+ * To run a query within a React component, call `useGetGameTypeTagMetricsQuery` and pass it any options that fit your needs.
+ * When your component renders, `useGetGameTypeTagMetricsQuery` returns an object from Apollo Client that contains loading, error, and data properties
+ * you can use to render your UI.
+ *
+ * @param baseOptions options that will be passed into the query, supported options are listed on: https://www.apollographql.com/docs/react/api/react-hooks/#options;
+ *
+ * @example
+ * const { data, loading, error } = useGetGameTypeTagMetricsQuery({
+ *   variables: {
+ *      input: // value for 'input'
+ *   },
+ * });
+ */
+export function useGetGameTypeTagMetricsQuery(
+  baseOptions: Apollo.QueryHookOptions<
+    GetGameTypeTagMetricsQuery,
+    GetGameTypeTagMetricsQueryVariables
+  >,
+) {
+  const options = { ...defaultOptions, ...baseOptions };
+  return Apollo.useQuery<
+    GetGameTypeTagMetricsQuery,
+    GetGameTypeTagMetricsQueryVariables
+  >(GetGameTypeTagMetricsDocument, options);
+}
+export function useGetGameTypeTagMetricsLazyQuery(
+  baseOptions?: Apollo.LazyQueryHookOptions<
+    GetGameTypeTagMetricsQuery,
+    GetGameTypeTagMetricsQueryVariables
+  >,
+) {
+  const options = { ...defaultOptions, ...baseOptions };
+  return Apollo.useLazyQuery<
+    GetGameTypeTagMetricsQuery,
+    GetGameTypeTagMetricsQueryVariables
+  >(GetGameTypeTagMetricsDocument, options);
+}
+export function useGetGameTypeTagMetricsSuspenseQuery(
+  baseOptions?: Apollo.SuspenseQueryHookOptions<
+    GetGameTypeTagMetricsQuery,
+    GetGameTypeTagMetricsQueryVariables
+  >,
+) {
+  const options = { ...defaultOptions, ...baseOptions };
+  return Apollo.useSuspenseQuery<
+    GetGameTypeTagMetricsQuery,
+    GetGameTypeTagMetricsQueryVariables
+  >(GetGameTypeTagMetricsDocument, options);
+}
+export type GetGameTypeTagMetricsQueryHookResult = ReturnType<
+  typeof useGetGameTypeTagMetricsQuery
+>;
+export type GetGameTypeTagMetricsLazyQueryHookResult = ReturnType<
+  typeof useGetGameTypeTagMetricsLazyQuery
+>;
+export type GetGameTypeTagMetricsSuspenseQueryHookResult = ReturnType<
+  typeof useGetGameTypeTagMetricsSuspenseQuery
+>;
+export type GetGameTypeTagMetricsQueryResult = Apollo.QueryResult<
+  GetGameTypeTagMetricsQuery,
+  GetGameTypeTagMetricsQueryVariables
+>;
 export const FollowUserDocument = gql`
   mutation followUser($followedUserId: Int!) {
     followUser(followedUserId: $followedUserId) {

src/operations/user.gql

@@ -92,6 +92,17 @@ query GetUserTags {
   }
 }
 
+query GetGameTypeTagMetrics($input: GameTypeTagMetricsInput!) {
+  getGameTypeTagMetrics(input: $input) {
+    tagName
+    tagLabel
+    tableSize
+    shotCount
+    madeShots
+    makeRate
+  }
+}
+
 mutation followUser($followedUserId: Int!) {
   followUser(followedUserId: $followedUserId) {
     id

src/schema.gql

@@ -28,7 +28,7 @@ type Query {
   getLongestRunsLeaderboard(
     interval: TimeInterval = null
     when: DateTime = null
-    limit: Int! = 100
+    limit: Int! = 50
     requiredTags: [String!] = null
   ): RunLeaderboardGQL!
   getMakesLeaderboard(
@@ -49,6 +49,7 @@ type Query {
     limit: Int! = 500
     countRespectsLimit: Boolean! = false
   ): GetRunsResult!
+  videoPlayerClusters(videoId: Int!): [PlayerClusterGQL!]!
   getShotAnnotationTypes(errorTypes: Boolean = false): [ShotAnnotationTypeGQL!]!
   getTableState(
     b64Image: String!
@@ -106,6 +107,7 @@ type Query {
     filters: VideoFilterInput = null
   ): VideoHistoryGQL!
   getUserTags(includeRetiredTags: Boolean = false): [TagGQL!]!
+  getGameTypeTagMetrics(input: GameTypeTagMetricsInput!): [GameTypeTagMetric!]!
   getVideo(videoId: Int!, debuggingJson: JSON = null): VideoGQL!
   getVideos(videoIds: [Int!]!): [VideoGQL!]!
 }
@@ -859,6 +861,27 @@ input DatetimeOrdering {
   startingAt: DateTime = null
 }
 
+type PlayerClusterGQL {
+  videoId: Int!
+  clusterId: Int!
+  nShots: Int!
+  userId: Int
+  confirmed: Boolean!
+  shots: [PlayerClusterShotGQL!]!
+}
+
+type PlayerClusterShotGQL {
+  shotId: Int!
+  bboxX1: Int!
+  bboxY1: Int!
+  bboxX2: Int!
+  bboxY2: Int!
+  confidence: Float!
+  isConfirmed: Boolean!
+  cropUrl: String
+  fullFrameUrl: String
+}
+
 type TableStateGQL {
   identifierToPosition: [[Float!]!]!
   homography: HomographyInfoGQL
@@ -939,6 +962,7 @@ type UserRelationship {
 
 type StripeSubscriptionOptionsGQL {
   products: [StripeProductGQL!]!
+  trialPeriodDays: Int
 }
 
 type StripeProductGQL {
@@ -1017,6 +1041,25 @@ type TagClassGQL {
   name: String!
 }
 
+type GameTypeTagMetric {
+  tagName: String!
+  tagLabel: String!
+  tableSize: Float
+  shotCount: Int!
+  madeShots: Int!
+  makeRate: Float!
+}
+
+input GameTypeTagMetricsInput {
+  userId: Int!
+  createdAt: DateRangeFilter = null
+  maxTags: Int = null
+  groupByTableSize: Boolean! = true
+  includeUnknown: Boolean! = true
+  tagClass: String = "game_type"
+  includePrivate: IncludePrivateEnum! = MINE
+}
+
 """
 The `JSON` scalar type represents JSON values as specified by [ECMA-404](https://ecma-international.org/wp-content/uploads/ECMA-404_2nd_edition_december_2017.pdf).
 """
@@ -1073,6 +1116,9 @@ type Mutation {
   markAllNotificationsAsRead: Boolean!
   markNotificationsAsRead(notificationIds: [Int!]!): Boolean!
   deleteNotification(notificationId: Int!): Boolean!
+  finalizePlayerAssignments(
+    input: FinalizePlayerAssignmentsInput!
+  ): [PlayerClusterGQL!]!
   addAnnotationToShot(
     shotId: Int!
     annotationName: String!
@@ -1097,6 +1143,7 @@ type Mutation {
   ensureStripeCustomerExists: UserGQL!
   deleteUser: Boolean!
   createSubscription(priceId: String!): CreateSubscriptionResultGQL!
+  createCustomerPortalSession: CreateCustomerPortalSessionResultGQL!
   cancelSubscription: UserSubscriptionStatusGQL!
   grantManualEntitlement(
     userId: Int!
@@ -1143,6 +1190,22 @@ enum ReportReasonEnum {
   OTHER
 }
 
+input FinalizePlayerAssignmentsInput {
+  videoId: Int!
+  clusterAssignments: [ClusterAssignmentInput!]! = []
+  shotMoves: [ShotMoveInput!]! = []
+}
+
+input ClusterAssignmentInput {
+  clusterId: Int!
+  userId: Int = null
+}
+
+input ShotMoveInput {
+  shotId: Int!
+  newClusterId: Int!
+}
+
 type AddShotAnnotationReturn {
   value: SuccessfulAddAddShotAnnotationErrors!
 }
@@ -1236,6 +1299,10 @@ type CreateSubscriptionResultGQL {
   sessionId: String!
 }
 
+type CreateCustomerPortalSessionResultGQL {
+  portalUrl: String!
+}
+
 enum CancellationReasonEnum {
   DONT_PLAY_ENOUGH
   TOO_EXPENSIVE