Add createShotShareLink for short share links

index.tsx is graphql-codegen output. schema.gql carries only the new
type, input and mutation field, deliberately left in the file's existing
formatting: package.json pins prettier as ^3.2.5, so a local install and
CI's yarn install can resolve different 3.x versions that disagree about
GraphQL union indentation. Committing a locally-reformatted schema.gql
makes CI's 'graphql-codegen causes no changes' check fail when its
prettier reformats it back.

The schema is verified semantically identical to the backend export via
lexicographic_sort_schema.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

src/index.tsx

@@ -315,6 +315,11 @@ export type CreatePoolHallInput = {
   timezone?: InputMaybe<Scalars["String"]["input"]>;
 };
 
+export type CreateShotShareLinkInput = {
+  paddingSeconds?: InputMaybe<Scalars["Float"]["input"]>;
+  shotIds: Array<Scalars["Int"]["input"]>;
+};
+
 export type CreateSubscriptionResultGql = {
   __typename?: "CreateSubscriptionResultGQL";
   checkoutUrl: Scalars["String"]["output"];
@@ -2530,6 +2535,7 @@ export type Mutation = {
   createPoolHall: PoolHall;
   createPoolHallCamera: PoolHallCameraStreamCredentials;
   createRuleSet: RuleSet;
+  createShotShareLink: ShareLinkGql;
   createSubscription: CreateSubscriptionResultGql;
   createUploadStream: CreateUploadStreamReturn;
   deleteComment: Scalars["Boolean"]["output"];
@@ -2644,6 +2650,10 @@ export type MutationCreateRuleSetArgs = {
   name: Scalars["String"]["input"];
 };
 
+export type MutationCreateShotShareLinkArgs = {
+  input: CreateShotShareLinkInput;
+};
+
 export type MutationCreateSubscriptionArgs = {
   priceId: Scalars["String"]["input"];
 };
@@ -3595,12 +3605,21 @@ export type SerializedShotPathsGql = {
   b64EncodedBuffer?: Maybe<Scalars["String"]["output"]>;
 };
 
+export type SessionCoachBaselineGql = {
+  __typename?: "SessionCoachBaselineGQL";
+  attemptCount: Scalars["Int"]["output"];
+  madeCount: Scalars["Int"]["output"];
+  makePercentage: Scalars["Float"]["output"];
+  sessionCount: Scalars["Int"]["output"];
+};
+
 export enum SessionCoachCandidateFamilyEnum {
   Aiming = "AIMING",
   BackCut = "BACK_CUT",
   CueToObjectDistance = "CUE_TO_OBJECT_DISTANCE",
   CutAngle = "CUT_ANGLE",
   ObjectToPocketDistance = "OBJECT_TO_POCKET_DISTANCE",
+  Overall = "OVERALL",
   Spin = "SPIN",
 }
 
@@ -3620,8 +3639,11 @@ export type SessionCoachCandidateGql = {
 };
 
 export enum SessionCoachCandidateKindEnum {
+  BaselineComparison = "BASELINE_COMPARISON",
   DirectionalMiss = "DIRECTIONAL_MISS",
   OutcomePattern = "OUTCOME_PATTERN",
+  SessionStreak = "SESSION_STREAK",
+  StrengthPattern = "STRENGTH_PATTERN",
   UsagePattern = "USAGE_PATTERN",
 }
 
@@ -3630,16 +3652,26 @@ export type SessionCoachDecisionGql = {
   body?: Maybe<Scalars["String"]["output"]>;
   drillId?: Maybe<Scalars["String"]["output"]>;
   drillReason?: Maybe<Scalars["String"]["output"]>;
+  positiveBody?: Maybe<Scalars["String"]["output"]>;
+  positiveTitle?: Maybe<Scalars["String"]["output"]>;
   practiceAttemptCount?: Maybe<Scalars["Int"]["output"]>;
   practiceTarget?: Maybe<Scalars["String"]["output"]>;
   selectedCandidateId?: Maybe<Scalars["ID"]["output"]>;
+  selectedPositiveCandidateId?: Maybe<Scalars["ID"]["output"]>;
+  sessionSummary?: Maybe<Scalars["String"]["output"]>;
   suggestedAction?: Maybe<Scalars["String"]["output"]>;
+  supportingCandidateIds: Array<Scalars["ID"]["output"]>;
+  supportingShotIds: Array<Scalars["Int"]["output"]>;
   title?: Maybe<Scalars["String"]["output"]>;
 };
 
 export type SessionCoachEvidenceGql = {
   __typename?: "SessionCoachEvidenceGQL";
   attemptCount: Scalars["Int"]["output"];
+  baselineAttemptCount: Scalars["Int"]["output"];
+  baselineMadeCount: Scalars["Int"]["output"];
+  baselineMakePercentage?: Maybe<Scalars["Float"]["output"]>;
+  baselineSessionCount: Scalars["Int"]["output"];
   bucketKey: Scalars["String"]["output"];
   bucketLabel: Scalars["String"]["output"];
   comparisonAttemptCount: Scalars["Int"]["output"];
@@ -3661,12 +3693,15 @@ export type SessionCoachGql = {
   candidates: Array<SessionCoachCandidateGql>;
   generatedAt: Scalars["DateTime"]["output"];
   ineligibilityReason?: Maybe<SessionCoachIneligibilityReasonEnum>;
+  longestMakeStreak: Scalars["Int"]["output"];
   madeCount: Scalars["Int"]["output"];
   makePercentage?: Maybe<Scalars["Float"]["output"]>;
   missedCount: Scalars["Int"]["output"];
+  positiveCandidates: Array<SessionCoachCandidateGql>;
   primaryCandidate?: Maybe<SessionCoachCandidateGql>;
   processingId?: Maybe<Scalars["Int"]["output"]>;
   processingStatus?: Maybe<Scalars["String"]["output"]>;
+  recentBaseline?: Maybe<SessionCoachBaselineGql>;
   shotCount: Scalars["Int"]["output"];
   state: SessionCoachStateEnum;
   summary?: Maybe<Scalars["String"]["output"]>;
@@ -3692,6 +3727,7 @@ export type SessionCoachGenerationDiagnosticsGql = {
   promptVersion: Scalars["String"]["output"];
   providerKey: Scalars["String"]["output"];
   startedAt?: Maybe<Scalars["DateTime"]["output"]>;
+  synthesisRationale?: Maybe<Scalars["String"]["output"]>;
   updatedAt: Scalars["DateTime"]["output"];
 };
 
@@ -3724,6 +3760,12 @@ export enum SessionCoachStateEnum {
   Ready = "READY",
 }
 
+export type ShareLinkGql = {
+  __typename?: "ShareLinkGQL";
+  slug: Scalars["String"]["output"];
+  url: Scalars["String"]["output"];
+};
+
 export type ShotAnnotationGql = {
   __typename?: "ShotAnnotationGQL";
   createdAt?: Maybe<Scalars["DateTime"]["output"]>;
@@ -7007,6 +7049,46 @@ export type GetSessionCoachQuery = {
     unknownOutcomeCount: number;
     analyzedShotCount: number;
     makePercentage?: number | null;
+    longestMakeStreak: number;
+    recentBaseline?: {
+      __typename?: "SessionCoachBaselineGQL";
+      sessionCount: number;
+      attemptCount: number;
+      madeCount: number;
+      makePercentage: number;
+    } | null;
+    positiveCandidates: Array<{
+      __typename?: "SessionCoachCandidateGQL";
+      id: string;
+      rank: number;
+      family: SessionCoachCandidateFamilyEnum;
+      kind: SessionCoachCandidateKindEnum;
+      title: string;
+      body: string;
+      action: string;
+      supportingShotIds: Array<number>;
+      drillId?: string | null;
+      limitations: Array<string>;
+      evidence: {
+        __typename?: "SessionCoachEvidenceGQL";
+        bucketKey: string;
+        bucketLabel: string;
+        attemptCount: number;
+        madeCount: number;
+        missedCount: number;
+        makePercentage: number;
+        comparisonAttemptCount: number;
+        comparisonMadeCount: number;
+        comparisonMakePercentage?: number | null;
+        patternShotCount: number;
+        score: number;
+        rankReason: string;
+        baselineSessionCount: number;
+        baselineAttemptCount: number;
+        baselineMadeCount: number;
+        baselineMakePercentage?: number | null;
+      };
+    }>;
     primaryCandidate?: {
       __typename?: "SessionCoachCandidateGQL";
       id: string;
@@ -7033,6 +7115,10 @@ export type GetSessionCoachQuery = {
         patternShotCount: number;
         score: number;
         rankReason: string;
+        baselineSessionCount: number;
+        baselineAttemptCount: number;
+        baselineMadeCount: number;
+        baselineMakePercentage?: number | null;
       };
     } | null;
     candidates: Array<{
@@ -7061,6 +7147,10 @@ export type GetSessionCoachQuery = {
         patternShotCount: number;
         score: number;
         rankReason: string;
+        baselineSessionCount: number;
+        baselineAttemptCount: number;
+        baselineMadeCount: number;
+        baselineMakePercentage?: number | null;
       };
     }>;
     agentGeneration?: {
@@ -7071,7 +7161,13 @@ export type GetSessionCoachQuery = {
       completedAt?: any | null;
       decision?: {
         __typename?: "SessionCoachDecisionGQL";
+        selectedPositiveCandidateId?: string | null;
+        positiveTitle?: string | null;
+        positiveBody?: string | null;
         selectedCandidateId?: string | null;
+        supportingCandidateIds: Array<string>;
+        supportingShotIds: Array<number>;
+        sessionSummary?: string | null;
         title?: string | null;
         body?: string | null;
         suggestedAction?: string | null;
@@ -7099,6 +7195,7 @@ export type GetSessionCoachQuery = {
         startedAt?: any | null;
         lastEnqueuedAt?: any | null;
         abstentionReason?: string | null;
+        synthesisRationale?: string | null;
       } | null;
     } | null;
   };
@@ -7121,7 +7218,13 @@ export type RequestSessionCoachGenerationMutation = {
       completedAt?: any | null;
       decision?: {
         __typename?: "SessionCoachDecisionGQL";
+        selectedPositiveCandidateId?: string | null;
+        positiveTitle?: string | null;
+        positiveBody?: string | null;
         selectedCandidateId?: string | null;
+        supportingCandidateIds: Array<string>;
+        supportingShotIds: Array<number>;
+        sessionSummary?: string | null;
         title?: string | null;
         body?: string | null;
         suggestedAction?: string | null;
@@ -7149,6 +7252,7 @@ export type RequestSessionCoachGenerationMutation = {
         startedAt?: any | null;
         lastEnqueuedAt?: any | null;
         abstentionReason?: string | null;
+        synthesisRationale?: string | null;
       } | null;
     } | null;
   };
@@ -7180,6 +7284,10 @@ export type SessionCoachCandidateFieldsFragment = {
     patternShotCount: number;
     score: number;
     rankReason: string;
+    baselineSessionCount: number;
+    baselineAttemptCount: number;
+    baselineMadeCount: number;
+    baselineMakePercentage?: number | null;
   };
 };
 
@@ -7191,7 +7299,13 @@ export type SessionCoachGenerationFieldsFragment = {
   completedAt?: any | null;
   decision?: {
     __typename?: "SessionCoachDecisionGQL";
+    selectedPositiveCandidateId?: string | null;
+    positiveTitle?: string | null;
+    positiveBody?: string | null;
     selectedCandidateId?: string | null;
+    supportingCandidateIds: Array<string>;
+    supportingShotIds: Array<number>;
+    sessionSummary?: string | null;
     title?: string | null;
     body?: string | null;
     suggestedAction?: string | null;
@@ -7219,9 +7333,24 @@ export type SessionCoachGenerationFieldsFragment = {
     startedAt?: any | null;
     lastEnqueuedAt?: any | null;
     abstentionReason?: string | null;
+    synthesisRationale?: string | null;
   } | null;
 };
 
+export type CreateShotShareLinkMutationVariables = Exact<{
+  shotIds: Array<Scalars["Int"]["input"]> | Scalars["Int"]["input"];
+  paddingSeconds?: InputMaybe<Scalars["Float"]["input"]>;
+}>;
+
+export type CreateShotShareLinkMutation = {
+  __typename?: "Mutation";
+  createShotShareLink: {
+    __typename?: "ShareLinkGQL";
+    slug: string;
+    url: string;
+  };
+};
+
 export type PlayerSummaryFieldsFragment = {
   __typename?: "PlayerSummaryGQL";
   clusterId: number;
@@ -9764,6 +9893,10 @@ export const SessionCoachCandidateFieldsFragmentDoc = gql`
       patternShotCount
       score
       rankReason
+      baselineSessionCount
+      baselineAttemptCount
+      baselineMadeCount
+      baselineMakePercentage
     }
   }
 `;
@@ -9774,7 +9907,13 @@ export const SessionCoachGenerationFieldsFragmentDoc = gql`
     createdAt
     completedAt
     decision {
+      selectedPositiveCandidateId
+      positiveTitle
+      positiveBody
       selectedCandidateId
+      supportingCandidateIds
+      supportingShotIds
+      sessionSummary
       title
       body
       suggestedAction
@@ -9801,6 +9940,7 @@ export const SessionCoachGenerationFieldsFragmentDoc = gql`
       startedAt
       lastEnqueuedAt
       abstentionReason
+      synthesisRationale
     }
   }
 `;
@@ -15433,6 +15573,16 @@ export const GetSessionCoachDocument = gql`
       unknownOutcomeCount
       analyzedShotCount
       makePercentage
+      longestMakeStreak
+      recentBaseline {
+        sessionCount
+        attemptCount
+        madeCount
+        makePercentage
+      }
+      positiveCandidates {
+        ...SessionCoachCandidateFields
+      }
       primaryCandidate {
         ...SessionCoachCandidateFields
       }
@@ -15568,6 +15718,63 @@ export type RequestSessionCoachGenerationMutationOptions =
     RequestSessionCoachGenerationMutation,
     RequestSessionCoachGenerationMutationVariables
   >;
+export const CreateShotShareLinkDocument = gql`
+  mutation CreateShotShareLink(
+    $shotIds: [Int!]!
+    $paddingSeconds: Float = null
+  ) {
+    createShotShareLink(
+      input: { shotIds: $shotIds, paddingSeconds: $paddingSeconds }
+    ) {
+      slug
+      url
+    }
+  }
+`;
+export type CreateShotShareLinkMutationFn = Apollo.MutationFunction<
+  CreateShotShareLinkMutation,
+  CreateShotShareLinkMutationVariables
+>;
+
+/**
+ * __useCreateShotShareLinkMutation__
+ *
+ * To run a mutation, you first call `useCreateShotShareLinkMutation` within a React component and pass it any options that fit your needs.
+ * When your component renders, `useCreateShotShareLinkMutation` returns a tuple that includes:
+ * - A mutate function that you can call at any time to execute the mutation
+ * - An object with fields that represent the current status of the mutation's execution
+ *
+ * @param baseOptions options that will be passed into the mutation, supported options are listed on: https://www.apollographql.com/docs/react/api/react-hooks/#options-2;
+ *
+ * @example
+ * const [createShotShareLinkMutation, { data, loading, error }] = useCreateShotShareLinkMutation({
+ *   variables: {
+ *      shotIds: // value for 'shotIds'
+ *      paddingSeconds: // value for 'paddingSeconds'
+ *   },
+ * });
+ */
+export function useCreateShotShareLinkMutation(
+  baseOptions?: Apollo.MutationHookOptions<
+    CreateShotShareLinkMutation,
+    CreateShotShareLinkMutationVariables
+  >,
+) {
+  const options = { ...defaultOptions, ...baseOptions };
+  return Apollo.useMutation<
+    CreateShotShareLinkMutation,
+    CreateShotShareLinkMutationVariables
+  >(CreateShotShareLinkDocument, options);
+}
+export type CreateShotShareLinkMutationHookResult = ReturnType<
+  typeof useCreateShotShareLinkMutation
+>;
+export type CreateShotShareLinkMutationResult =
+  Apollo.MutationResult<CreateShotShareLinkMutation>;
+export type CreateShotShareLinkMutationOptions = Apollo.BaseMutationOptions<
+  CreateShotShareLinkMutation,
+  CreateShotShareLinkMutationVariables
+>;
 export const VideoPlayerClustersDocument = gql`
   query VideoPlayerClusters($videoId: Int!) {
     videoPlayerClusters(videoId: $videoId) {

src/operations/session-coach.gql

@@ -14,6 +14,16 @@ query GetSessionCoach($videoId: Int!) {
     unknownOutcomeCount
     analyzedShotCount
     makePercentage
+    longestMakeStreak
+    recentBaseline {
+      sessionCount
+      attemptCount
+      madeCount
+      makePercentage
+    }
+    positiveCandidates {
+      ...SessionCoachCandidateFields
+    }
     primaryCandidate {
       ...SessionCoachCandidateFields
     }
@@ -59,6 +69,10 @@ fragment SessionCoachCandidateFields on SessionCoachCandidateGQL {
     patternShotCount
     score
     rankReason
+    baselineSessionCount
+    baselineAttemptCount
+    baselineMadeCount
+    baselineMakePercentage
   }
 }
 
@@ -68,7 +82,13 @@ fragment SessionCoachGenerationFields on SessionCoachGenerationGQL {
   createdAt
   completedAt
   decision {
+    selectedPositiveCandidateId
+    positiveTitle
+    positiveBody
     selectedCandidateId
+    supportingCandidateIds
+    supportingShotIds
+    sessionSummary
     title
     body
     suggestedAction
@@ -95,5 +115,6 @@ fragment SessionCoachGenerationFields on SessionCoachGenerationGQL {
     startedAt
     lastEnqueuedAt
     abstentionReason
+    synthesisRationale
   }
 }

src/operations/share_link.gql

@@ -0,0 +1,8 @@
+mutation CreateShotShareLink($shotIds: [Int!]!, $paddingSeconds: Float = null) {
+  createShotShareLink(
+    input: { shotIds: $shotIds, paddingSeconds: $paddingSeconds }
+  ) {
+    slug
+    url
+  }
+}

src/schema.gql

@@ -249,6 +249,11 @@ input CreatePoolHallCameraInput {
   claimTermsText: String = null
 }
 
+input CreateShotShareLinkInput {
+  shotIds: [Int!]!
+  paddingSeconds: Float = null
+}
+
 input CreatePoolHallInput {
   name: String!
   address: String = null
@@ -719,6 +724,7 @@ type Mutation {
   cancelCameraClaimSession(claimSessionId: ID!): CameraClaimSession!
   endCameraLease(leaseId: ID!): CameraLease!
   extendCameraLease(leaseId: ID!, additionalMinutes: Int! = 60): CameraLease!
+  createShotShareLink(input: CreateShotShareLinkInput!): ShareLinkGQL!
   finalizePlayerAssignments(
     input: FinalizePlayerAssignmentsInput!
   ): [PlayerClusterGQL!]!
@@ -1312,7 +1318,15 @@ type SerializedShotPathsGQL {
   b64EncodedBuffer: String
 }
 
+type SessionCoachBaselineGQL {
+  sessionCount: Int!
+  attemptCount: Int!
+  madeCount: Int!
+  makePercentage: Float!
+}
+
 enum SessionCoachCandidateFamilyEnum {
+  OVERALL
   AIMING
   CUT_ANGLE
   SPIN
@@ -1336,13 +1350,22 @@ type SessionCoachCandidateGQL {
 }
 
 enum SessionCoachCandidateKindEnum {
+  BASELINE_COMPARISON
+  SESSION_STREAK
+  STRENGTH_PATTERN
   DIRECTIONAL_MISS
   OUTCOME_PATTERN
   USAGE_PATTERN
 }
 
 type SessionCoachDecisionGQL {
+  selectedPositiveCandidateId: ID
+  positiveTitle: String
+  positiveBody: String
   selectedCandidateId: ID
+  supportingCandidateIds: [ID!]!
+  supportingShotIds: [Int!]!
+  sessionSummary: String
   title: String
   body: String
   suggestedAction: String
@@ -1365,6 +1388,10 @@ type SessionCoachEvidenceGQL {
   patternShotCount: Int!
   score: Float!
   rankReason: String!
+  baselineSessionCount: Int!
+  baselineAttemptCount: Int!
+  baselineMadeCount: Int!
+  baselineMakePercentage: Float
 }
 
 type SessionCoachGQL {
@@ -1382,6 +1409,9 @@ type SessionCoachGQL {
   unknownOutcomeCount: Int!
   analyzedShotCount: Int!
   makePercentage: Float
+  longestMakeStreak: Int!
+  recentBaseline: SessionCoachBaselineGQL
+  positiveCandidates: [SessionCoachCandidateGQL!]!
   primaryCandidate: SessionCoachCandidateGQL
   candidates: [SessionCoachCandidateGQL!]!
   agentGeneration: SessionCoachGenerationGQL
@@ -1405,6 +1435,7 @@ type SessionCoachGenerationDiagnosticsGQL {
   startedAt: DateTime
   lastEnqueuedAt: DateTime
   abstentionReason: String
+  synthesisRationale: String
 }
 
 type SessionCoachGenerationGQL {
@@ -1888,6 +1919,11 @@ type UserSubscriptionStatusGQL {
   stripeSubscriptionId: String
 }
 
+type ShareLinkGQL {
+  slug: String!
+  url: String!
+}
+
 type VideoExportJobGQL {
   id: Int!
   videoId: Int!