Select stream.id in upload-status operations so the cache stays normalized

UploadStreamWithDetails and the editUploadStream response selected
stream fields without id. Apollo cannot normalize an object with no id
selected, so every upload-service poll rewrote VideoGQL.stream as an
anonymous inline object — clobbering the id that feed/detail queries
select. Their cache reads went partial and useQuery silently fell back
to the last network result, rendered as the home feed collapsing to
the first page (and bouncing the viewport) whenever an upload was
polling.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

src/operations/feed.gql

@@ -41,6 +41,7 @@ fragment VideoCardFields on VideoGQL {
   stream {
     id
     lastIntendedSegmentBound
+    uploadCompletionCursor
     streamSegmentType
     isCompleted
     lastSegmentUploadedAt

src/operations/recorded_shots.gql

@@ -33,6 +33,30 @@ query GetRecordedStreamShots($videoId: Int!, $limit: Int! = 200) {
       videoId
       startFrame
       endFrame
+      serializedShotPaths {
+        b64EncodedBuffer
+      }
+      cueObjectFeatures {
+        cueObjectDistance
+        cueObjectAngle
+        cueBallSpeed
+        shotDirection
+        spinType
+      }
+      pocketingIntentionFeatures {
+        make
+        targetPocketDistance
+        targetPocketAngle
+        targetPocketAngleDirection
+        marginOfErrorInDegrees
+        intendedPocketType
+        difficulty
+      }
+      pocketingIntentionInfo {
+        ballId
+        pocketId
+        pathMetadataIndex
+      }
     }
   }
 }

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,53 +85,3 @@ 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/operations/usage_stats.gql

@@ -12,6 +12,13 @@ query getUsageStats($days: Int! = 30) {
       retentionPrevActive
       retentionReturned
     }
+    cohorts {
+      weekStart
+      signups
+      activated7d
+      paid7d
+      activatedNotPaid7d
+    }
     totalUsers
     totalVideos
     totalShots

src/operations/video_upload.gql

@@ -48,6 +48,7 @@ mutation GetUploadLink($videoId: Int!, $segmentIndex: Int!) {
       }
     }
     stream {
+      id
       uploadCompletionCursor
     }
   }
@@ -127,6 +128,7 @@ fragment UploadStreamWithDetails on VideoGQL {
   name
   startTime
   stream {
+    id
     isCompleted
     lastIntendedSegmentBound
     uploadCompletionCursor

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,9 +81,6 @@ type Query {
     targetBallId: Int!
     pocket: PocketIdentifier!
   ): PotAimGQL!
-  suggestPositionShot(
-    suggestionInput: SuggestPositionShotInputGQL!
-  ): PositionSuggestionGQL!
   getOrderedShots(
     filterInput: FilterInput!
     ids: [Int!] = null
@@ -998,6 +996,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!
@@ -1146,44 +1219,6 @@ 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
@@ -1224,6 +1259,7 @@ type UsageStatsGQL {
   totalVideos: Int!
   totalShots: Int!
   totalRuns: Int!
+  cohorts: [CohortStatsGQL!]!
   windows: [UsageStatsWindowGQL!]!
   daily: [UsageStatsDailyGQL!]!
   processingLast24h: [ProcessingStatusCountGQL!]!
@@ -1242,6 +1278,14 @@ type FunnelStatsGQL {
   retentionReturned: Int!
 }
 
+type CohortStatsGQL {
+  weekStart: Date!
+  signups: Int!
+  activated7d: Int!
+  paid7d: Int!
+  activatedNotPaid7d: Int!
+}
+
 type UsageStatsWindowGQL {
   label: String!
   newUsers: Int!