Add suggestPositionShot schema types and operation

Mirrors the backend's position-play search: SuggestPositionShotInputGQL
(pot lock + target-area polygon), PositionSuggestionGQL /
PositionShotCandidateGQL / CueStrikeGQL, the Query field, and a
SuggestPositionShot operation with a shared candidate fragment. Rebased
onto master's gql; index.tsx regenerated.

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

src/operations/session-coach.gql

@@ -0,0 +1,51 @@
+query GetSessionCoach($videoId: Int!) {
+  getSessionCoach(videoId: $videoId) {
+    videoId
+    processingId
+    analysisVersion
+    state
+    generatedAt
+    processingStatus
+    ineligibilityReason
+    summary
+    shotCount
+    madeCount
+    missedCount
+    unknownOutcomeCount
+    analyzedShotCount
+    makePercentage
+    primaryCandidate {
+      ...SessionCoachCandidateFields
+    }
+    candidates {
+      ...SessionCoachCandidateFields
+    }
+  }
+}
+
+fragment SessionCoachCandidateFields on SessionCoachCandidateGQL {
+  id
+  rank
+  family
+  kind
+  title
+  body
+  action
+  supportingShotIds
+  drillId
+  limitations
+  evidence {
+    bucketKey
+    bucketLabel
+    attemptCount
+    madeCount
+    missedCount
+    makePercentage
+    comparisonAttemptCount
+    comparisonMadeCount
+    comparisonMakePercentage
+    patternShotCount
+    score
+    rankReason
+  }
+}

src/operations/shot_simulation.gql

@@ -85,3 +85,53 @@ query ComputePotAim(
     occludingBallIds
   }
 }
+
+fragment PositionShotCandidate on PositionShotCandidateGQL {
+  strike {
+    v0
+    phi
+    theta
+    a
+    b
+  }
+  cueFinalPosition
+  inTargetArea
+  distanceToTargetArea
+  robustness
+  potted
+  scratched
+  projection {
+    trajectories {
+      ballId
+      points {
+        time
+        position
+      }
+    }
+    events {
+      eventType
+      time
+      ballIds
+      position
+    }
+    finalState {
+      ballId
+      position
+    }
+    pottedBallIds
+  }
+}
+
+query SuggestPositionShot($suggestionInput: SuggestPositionShotInputGQL!) {
+  suggestPositionShot(suggestionInput: $suggestionInput) {
+    achievable
+    evaluatedCount
+    successfulCount
+    best {
+      ...PositionShotCandidate
+    }
+    alternates {
+      ...PositionShotCandidate
+    }
+  }
+}

src/schema.gql

@@ -65,6 +65,7 @@ type Query {
     limit: Int! = 500
     countRespectsLimit: Boolean! = false
   ): GetRunsResult!
+  getSessionCoach(videoId: Int!): SessionCoachGQL!
   videoPlayerClusters(videoId: Int!): [PlayerClusterGQL!]!
   getShotAnnotationTypes(errorTypes: Boolean = false): [ShotAnnotationTypeGQL!]!
   getTableState(
@@ -80,6 +81,9 @@ type Query {
     targetBallId: Int!
     pocket: PocketIdentifier!
   ): PotAimGQL!
+  suggestPositionShot(
+    suggestionInput: SuggestPositionShotInputGQL!
+  ): PositionSuggestionGQL!
   getOrderedShots(
     filterInput: FilterInput!
     ids: [Int!] = null
@@ -995,6 +999,81 @@ input DatetimeOrdering {
   startingAt: DateTime = null
 }
 
+type SessionCoachGQL {
+  videoId: Int!
+  processingId: Int
+  analysisVersion: String!
+  state: SessionCoachStateEnum!
+  generatedAt: DateTime!
+  processingStatus: String
+  ineligibilityReason: SessionCoachIneligibilityReasonEnum
+  summary: String
+  shotCount: Int!
+  madeCount: Int!
+  missedCount: Int!
+  unknownOutcomeCount: Int!
+  analyzedShotCount: Int!
+  makePercentage: Float
+  primaryCandidate: SessionCoachCandidateGQL
+  candidates: [SessionCoachCandidateGQL!]!
+}
+
+enum SessionCoachStateEnum {
+  PROCESSING
+  READY
+  NO_TRACKED_SHOTS
+  INELIGIBLE
+  FAILED
+}
+
+enum SessionCoachIneligibilityReasonEnum {
+  MULTIPLAYER
+}
+
+type SessionCoachCandidateGQL {
+  id: ID!
+  rank: Int!
+  family: SessionCoachCandidateFamilyEnum!
+  kind: SessionCoachCandidateKindEnum!
+  title: String!
+  body: String!
+  action: String!
+  supportingShotIds: [Int!]!
+  drillId: String
+  evidence: SessionCoachEvidenceGQL!
+  limitations: [String!]!
+}
+
+enum SessionCoachCandidateFamilyEnum {
+  AIMING
+  CUT_ANGLE
+  SPIN
+  OBJECT_TO_POCKET_DISTANCE
+  CUE_TO_OBJECT_DISTANCE
+  BACK_CUT
+}
+
+enum SessionCoachCandidateKindEnum {
+  DIRECTIONAL_MISS
+  OUTCOME_PATTERN
+  USAGE_PATTERN
+}
+
+type SessionCoachEvidenceGQL {
+  bucketKey: String!
+  bucketLabel: String!
+  attemptCount: Int!
+  madeCount: Int!
+  missedCount: Int!
+  makePercentage: Float!
+  comparisonAttemptCount: Int!
+  comparisonMadeCount: Int!
+  comparisonMakePercentage: Float
+  patternShotCount: Int!
+  score: Float!
+  rankReason: String!
+}
+
 type PlayerClusterGQL {
   videoId: Int!
   clusterId: Int!
@@ -1143,6 +1222,44 @@ type PotAimGQL {
   occludingBallIds: [Int!]!
 }
 
+type PositionSuggestionGQL {
+  achievable: Boolean!
+  best: PositionShotCandidateGQL
+  alternates: [PositionShotCandidateGQL!]!
+  evaluatedCount: Int!
+  successfulCount: Int!
+}
+
+type PositionShotCandidateGQL {
+  strike: CueStrikeGQL!
+  cueFinalPosition: [Float!]!
+  inTargetArea: Boolean!
+  distanceToTargetArea: Float!
+  robustness: Int!
+  potted: Boolean!
+  scratched: Boolean!
+  projection: ShotProjectionGQL
+}
+
+type CueStrikeGQL {
+  v0: Float!
+  phi: Float!
+  theta: Float!
+  a: Float!
+  b: Float!
+}
+
+input SuggestPositionShotInputGQL {
+  cueBallId: Int!
+  targetBallId: Int!
+  pocket: PocketIdentifier!
+  targetArea: [[Float!]!]!
+  balls: [SimulationBallStateInputGQL!] = null
+  b64Image: String = null
+  useHomography: HomographyInputGQL = null
+  tableSize: Float = null
+}
+
 type GetShotsResult {
   shots: [ShotGQL!]!
   count: Int
@@ -1825,6 +1942,7 @@ input VideoMetadataInput {
   clientUploadStatus: ClientUploadStatusEnum = null
   resolution: VideoResolution = null
   framesPerSecond: Float = null
+  homographyBackend: HomographyBackendGQL = null
 }
 
 input VideoResolution {
@@ -1832,6 +1950,11 @@ input VideoResolution {
   height: Int!
 }
 
+enum HomographyBackendGQL {
+  CLASSIC
+  TABLENET
+}
+
 type GetUploadLinkReturn {
   value: UploadLinkGetUploadLinkErrors!
   stream: UploadStreamGQL