chore(release): 4.4.14 [skip ci]

## [4.4.14](https://github.com/antialias/soroban-abacus-flashcards/compare/v4.4.13...v4.4.14) (2025-10-18) ### Bug Fixes * **complement-race:** remove dual game loop conflict preventing route progression ([84d42e2](84d42e22ac))
fix(complement-race): remove dual game loop conflict preventing route progression
2025-10-18 00:54:05 +00:00 · 2025-10-17 19:53:02 -05:00 · 2025-10-17 18:18:06 -05:00
7 changed files with 40 additions and 33 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [4.4.14](https://github.com/antialias/soroban-abacus-flashcards/compare/v4.4.13...v4.4.14) (2025-10-18)
+
+
+### Bug Fixes
+
+* **complement-race:** remove dual game loop conflict preventing route progression ([84d42e2](https://github.com/antialias/soroban-abacus-flashcards/commit/84d42e22ac0cdd25e87e45dc698029ad7ed78559))
+
 ## [4.4.13](https://github.com/antialias/soroban-abacus-flashcards/compare/v4.4.12...v4.4.13) (2025-10-17)


--- a/apps/web/src/app/arcade/complement-race/hooks/useSteamJourney.ts
+++ b/apps/web/src/app/arcade/complement-race/hooks/useSteamJourney.ts
@@ -92,37 +92,9 @@ export function useSteamJourney() {

      // Steam Sprint is infinite - no time limit

-      // Get decay rate based on timeout setting (skill level)
-      const decayRate =
-        MOMENTUM_DECAY_RATES[state.timeoutSetting as keyof typeof MOMENTUM_DECAY_RATES] ||
-        MOMENTUM_DECAY_RATES.normal
-
-      // Calculate momentum decay for this frame
-      const momentumLoss = (decayRate * deltaTime) / 1000
-
-      // Update momentum (don't go below 0)
-      const newMomentum = Math.max(0, state.momentum - momentumLoss)
-
-      // Calculate speed from momentum (% per second)
-      const speed = newMomentum * SPEED_MULTIPLIER
-
-      // Update train position (accumulate, never go backward)
-      // Allow position to go past 100% so entire train (including cars) can exit tunnel
-      const positionDelta = (speed * deltaTime) / 1000
-      const trainPosition = state.trainPosition + positionDelta
-
-      // Calculate pressure (0-150 PSI) - based on momentum as percentage of max
-      const maxMomentum = 100 // Theoretical max momentum
-      const pressure = Math.min(150, (newMomentum / maxMomentum) * 150)
-
-      // Update state
-      dispatch({
-        type: 'UPDATE_STEAM_JOURNEY',
-        momentum: newMomentum,
-        trainPosition,
-        pressure,
-        elapsedTime: elapsed,
-      })
+      // Train position, momentum, and pressure are all managed by the Provider's game loop
+      // This hook only reads those values and handles game logic (boarding, delivery, route completion)
+      const trainPosition = state.trainPosition

      // Check for passengers that should board
      // Passengers board when an EMPTY car reaches their station
--- a/apps/web/src/app/games/complement-race/components/RaceTrack/tests/GameHUD.test.tsx
+++ b/apps/web/src/app/games/complement-race/components/RaceTrack/tests/GameHUD.test.tsx
@@ -29,6 +29,7 @@ describe('GameHUD', () => {

  const mockPassenger: Passenger = {
    id: 'passenger-1',
+    name: 'Test Passenger',
    avatar: '👨',
    originStationId: 'station-1',
    destinationStationId: 'station-2',
--- a/apps/web/src/app/games/complement-race/hooks/tests/usePassengerAnimations.test.ts
+++ b/apps/web/src/app/games/complement-race/hooks/tests/usePassengerAnimations.test.ts
@@ -44,6 +44,7 @@ describe('usePassengerAnimations', () => {
    // Create mock passengers
    mockPassenger1 = {
      id: 'passenger-1',
+      name: 'Passenger 1',
      avatar: '👨',
      originStationId: 'station-1',
      destinationStationId: 'station-2',
@@ -54,6 +55,7 @@ describe('usePassengerAnimations', () => {

    mockPassenger2 = {
      id: 'passenger-2',
+      name: 'Passenger 2',
      avatar: '👩',
      originStationId: 'station-1',
      destinationStationId: 'station-2',
--- a/apps/web/src/app/games/complement-race/hooks/tests/useTrackManagement.test.ts
+++ b/apps/web/src/app/games/complement-race/hooks/tests/useTrackManagement.test.ts
@@ -52,6 +52,7 @@ describe('useTrackManagement', () => {
    mockPassengers = [
      {
        id: 'passenger-1',
+        name: 'Test Passenger',
        avatar: '👨',
        originStationId: 'station-1',
        destinationStationId: 'station-2',
@@ -73,6 +74,8 @@ describe('useTrackManagement', () => {
        pathRef: mockPathRef,
        stations: mockStations,
        passengers: mockPassengers,
+        maxCars: 3,
+        carSpacing: 7,
      })
    )

@@ -90,6 +93,8 @@ describe('useTrackManagement', () => {
        pathRef: mockPathRef,
        stations: mockStations,
        passengers: mockPassengers,
+        maxCars: 3,
+        carSpacing: 7,
      })
    )

@@ -107,6 +112,8 @@ describe('useTrackManagement', () => {
        pathRef: mockPathRef,
        stations: mockStations,
        passengers: mockPassengers,
+        maxCars: 3,
+        carSpacing: 7,
      })
    )

@@ -123,6 +130,8 @@ describe('useTrackManagement', () => {
        pathRef: mockPathRef,
        stations: mockStations,
        passengers: mockPassengers,
+        maxCars: 3,
+        carSpacing: 7,
      })
    )

@@ -142,6 +151,8 @@ describe('useTrackManagement', () => {
        pathRef: mockPathRef,
        stations: mockStations,
        passengers: mockPassengers,
+        maxCars: 3,
+        carSpacing: 7,
      })
    )

@@ -161,6 +172,8 @@ describe('useTrackManagement', () => {
          pathRef: mockPathRef,
          stations: mockStations,
          passengers: mockPassengers,
+          maxCars: 3,
+          carSpacing: 7,
        }),
      {
        initialProps: { route: 1, position: 0 },
@@ -187,6 +200,8 @@ describe('useTrackManagement', () => {
          pathRef: mockPathRef,
          stations: mockStations,
          passengers: mockPassengers,
+          maxCars: 3,
+          carSpacing: 7,
        }),
      {
        initialProps: { route: 1, position: 0 },
@@ -214,6 +229,8 @@ describe('useTrackManagement', () => {
          pathRef: mockPathRef,
          stations: mockStations,
          passengers: mockPassengers,
+          maxCars: 3,
+          carSpacing: 7,
        }),
      {
        initialProps: { route: 1, position: -5 },
@@ -233,6 +250,7 @@ describe('useTrackManagement', () => {
    const newPassengers: Passenger[] = [
      {
        id: 'passenger-2',
+        name: 'New Passenger',
        avatar: '👩',
        originStationId: 'station-1',
        destinationStationId: 'station-2',
@@ -273,6 +291,7 @@ describe('useTrackManagement', () => {
    const newPassengers: Passenger[] = [
      {
        id: 'passenger-2',
+        name: 'New Passenger',
        avatar: '👩',
        originStationId: 'station-1',
        destinationStationId: 'station-2',
@@ -354,6 +373,8 @@ describe('useTrackManagement', () => {
        pathRef: mockPathRef,
        stations: mockStations,
        passengers: mockPassengers,
+        maxCars: 3,
+        carSpacing: 7,
      })
    )

--- a/apps/web/src/arcade-games/complement-race/Provider.tsx
+++ b/apps/web/src/arcade-games/complement-race/Provider.tsx
@@ -495,10 +495,13 @@ export function ComplementRaceProvider({ children }: { children: ReactNode }) {
    const currentRoute = multiplayerState.currentRoute
    // When route changes, reset position and give starting momentum
    if (currentRoute > 1 && compatibleState.style === 'sprint') {
+      console.log(
+        `[Provider] Route changed to ${currentRoute}, resetting position. Passengers: ${multiplayerState.passengers.length}`
+      )
      setClientPosition(0)
      setClientMomentum(10) // Reset to starting momentum (gentle push)
    }
-  }, [multiplayerState.currentRoute, compatibleState.style])
+  }, [multiplayerState.currentRoute, compatibleState.style, multiplayerState.passengers.length])

  // Keep lastLogRef for future debugging needs
  // (removed debug logging)
@@ -713,6 +716,7 @@ export function ComplementRaceProvider({ children }: { children: ReactNode }) {
        case 'START_NEW_ROUTE':
          // Send route progression to server
          if (action.routeNumber !== undefined) {
+            console.log(`[Provider] Dispatching START_NEW_ROUTE for route ${action.routeNumber}`)
            sendMove({
              type: 'START_NEW_ROUTE',
              playerId: activePlayers[0] || '',
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "soroban-monorepo",
-  "version": "4.4.13",
+  "version": "4.4.14",
  "private": true,
  "description": "Beautiful Soroban Flashcard Generator - Monorepo",
  "workspaces": [