refactor: xstate animation state machine, fix walk/run timescale, delete orphans

- Rewrite AnimationStateMachine.js to use xstate createMachine/createActor
  instead of hand-rolled state machine. All locomotion transitions now go
  through xstate actor with proper state validation via snap.can().
- Fix walk/run/sprint timeScale values (24.0→1.0, 4.5→1.0, 7.0→1.0) —
  previous values made walk animation play at absurd speed.
- Delete orphaned files: BotHarness.js, draco_wasm_wrapper.js, WebRTCClient.js
  (zero imports across entire codebase).

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

Author: lanmower

apps/world/index.js

@@ -162,9 +162,9 @@ export default {
   },
   animation: {
     mixerTimeScale: 1.3,
-    walkTimeScale: 24.0,
-    jogTimeScale: 4.5,
-    sprintTimeScale: 7.0,
+    walkTimeScale: 1.0,
+    jogTimeScale: 1.0,
+    sprintTimeScale: 1.0,
     fadeTime: 0.15
   },
   entities: [

client/AnimationStateMachine.js

@@ -1,5 +1,8 @@
 import * as THREE from 'three'
 
+const _isNode = typeof process !== 'undefined' && process.versions?.node
+const { createMachine, createActor } = await import(_isNode ? 'xstate' : '/node_modules/xstate/dist/xstate.esm.js')
+
 export const FADE_TIME = 0.15
 
 export const STATES = {
@@ -38,6 +41,22 @@ export const LOWER_BODY_BONES = new Set([
   'footL', 'footR', 'toesL', 'toesR'
 ])
 
+const locoMachine = createMachine({
+  id: 'loco',
+  initial: 'IdleLoop',
+  states: {
+    IdleLoop: { on: { WALK: 'WalkLoop', JOG: 'JogFwdLoop', SPRINT: 'SprintLoop', CROUCH_IDLE: 'CrouchIdleLoop', JUMP: 'JumpLoop', DEATH: 'Death' } },
+    WalkLoop: { on: { IDLE: 'IdleLoop', JOG: 'JogFwdLoop', SPRINT: 'SprintLoop', CROUCH_FWD: 'CrouchFwdLoop', JUMP: 'JumpLoop', DEATH: 'Death' } },
+    JogFwdLoop: { on: { IDLE: 'IdleLoop', WALK: 'WalkLoop', SPRINT: 'SprintLoop', JUMP: 'JumpLoop', DEATH: 'Death' } },
+    SprintLoop: { on: { IDLE: 'IdleLoop', WALK: 'WalkLoop', JOG: 'JogFwdLoop', JUMP: 'JumpLoop', DEATH: 'Death' } },
+    CrouchIdleLoop: { on: { IDLE: 'IdleLoop', CROUCH_FWD: 'CrouchFwdLoop', JUMP: 'JumpLoop', DEATH: 'Death' } },
+    CrouchFwdLoop: { on: { IDLE: 'IdleLoop', CROUCH_IDLE: 'CrouchIdleLoop', JUMP: 'JumpLoop', DEATH: 'Death' } },
+    JumpLoop: { on: { IDLE: 'IdleLoop', LAND: 'JumpLand', DEATH: 'Death' } },
+    JumpLand: { on: { IDLE: 'IdleLoop', WALK: 'WalkLoop', JOG: 'JogFwdLoop', DEATH: 'Death' } },
+    Death: { on: { REVIVE: 'IdleLoop' } }
+  }
+})
+
 export function createAnimationStateMachine(mixer, root, actions, additiveActions, animConfig = {}) {
   const FADE = animConfig.fadeTime || FADE_TIME
   const LOCO_STATES = new Set(['IdleLoop', 'WalkLoop', 'JogFwdLoop', 'SprintLoop', 'CrouchIdleLoop', 'CrouchFwdLoop'])
@@ -46,6 +65,8 @@ export function createAnimationStateMachine(mixer, root, actions, additiveAction
   const TIMESCALE_SMOOTH = 10.0
   const LOCO_COOLDOWN = 0.3
 
+  const actor = createActor(locoMachine)
+  actor.start()
   let current = null
   let oneShot = null
   let oneShotTimer = 0
@@ -67,18 +88,22 @@ export function createAnimationStateMachine(mixer, root, actions, additiveAction
     if (LOCO_STATES.has(name) && name !== 'IdleLoop' && name !== 'CrouchIdleLoop') locomotionCooldown = LOCO_COOLDOWN
   }
 
-  if (actions.has('IdleLoop')) {
-    actions.get('IdleLoop').play()
-    current = 'IdleLoop'
+  function sendLoco(event) {
+    const snap = actor.getSnapshot()
+    if (snap.can({ type: event })) {
+      actor.send({ type: event })
+      transitionTo(actor.getSnapshot().value)
+    }
   }
 
+  if (actions.has('IdleLoop')) { actions.get('IdleLoop').play(); current = 'IdleLoop' }
+
   mixer.addEventListener('finished', () => {
     if (oneShot && !STATES[oneShot]?.additive) {
       const cfg = STATES[oneShot]
       if (cfg?.clamp) return
-      oneShot = null
-      oneShotTimer = 0
-      if (cfg?.next) transitionTo(cfg.next)
+      oneShot = null; oneShotTimer = 0
+      if (cfg?.next) sendLoco(cfg.next === 'IdleLoop' ? 'IDLE' : cfg.next)
     }
   })
 
@@ -89,65 +114,60 @@ export function createAnimationStateMachine(mixer, root, actions, additiveAction
     else { if (action.isRunning()) action.fadeOut(FADE) }
   }
 
+  function resolveLocoEvent(smoothSpeed, crouching, skipWalk) {
+    if (crouching) return smoothSpeed < 0.8 ? 'CROUCH_IDLE' : 'CROUCH_FWD'
+    if (skipWalk) {
+      const idle2jog = current === 'IdleLoop' ? 2.0 : 0.8
+      const jog2sprint = current === 'JogFwdLoop' ? 15.5 : 15.0
+      if (smoothSpeed < idle2jog) return 'IDLE'
+      if (smoothSpeed < jog2sprint) return 'JOG'
+      return 'SPRINT'
+    }
+    const idle2walk = current === 'IdleLoop' ? 0.5 : 0.3
+    const walk2jog = current === 'WalkLoop' ? 4.0 : 3.5
+    const jog2sprint = current === 'JogFwdLoop' ? 15.5 : 15.0
+    if (smoothSpeed < idle2walk) return 'IDLE'
+    if (smoothSpeed < walk2jog) return 'WALK'
+    if (smoothSpeed < jog2sprint) return 'JOG'
+    return 'SPRINT'
+  }
+
   function update(dt, velocity, onGround, health, aiming, crouching) {
     if (locomotionCooldown > 0) locomotionCooldown -= dt
     if (oneShotTimer > 0) {
       oneShotTimer -= dt
       if (oneShotTimer <= 0) {
         const cfg = STATES[oneShot]
         oneShot = null
-        if (cfg?.next) transitionTo(cfg.next)
+        if (cfg?.next) sendLoco(cfg.next === 'IdleLoop' ? 'IDLE' : cfg.next)
       }
     }
     if (!onGround) airTime += dt; else airTime = 0
     const effectiveOnGround = onGround || airTime < AIR_GRACE
 
     if (health <= 0 && current !== 'Death') {
-      transitionTo('Death')
-      oneShot = 'Death'
+      sendLoco('DEATH'); oneShot = 'Death'
     } else if (health > 0 && (oneShot === 'Death' || current === 'Death')) {
       const deathAction = actions.get('Death')
       if (deathAction) { deathAction.stop(); deathAction.reset() }
       oneShot = null; oneShotTimer = 0; current = null
-      transitionTo('IdleLoop')
+      sendLoco('REVIVE')
     } else if (!oneShot || STATES[oneShot]?.additive) {
       const vx = velocity?.[0] || 0, vz = velocity?.[2] || 0
       const rawSpeed = Math.sqrt(vx * vx + vz * vz)
       smoothSpeed += (rawSpeed - smoothSpeed) * Math.min(1, SPEED_SMOOTH * dt)
-
-      if (!effectiveOnGround && !wasOnGround) {
-        transitionTo('JumpLoop')
-      } else if (!wasOnGround && effectiveOnGround && smoothSpeed < 1.5) {
-        transitionTo('JumpLand')
-        oneShot = 'JumpLand'
-        oneShotTimer = STATES.JumpLand.duration
-      } else if (effectiveOnGround) {
-        if (crouching) {
-          if (smoothSpeed < 0.8) transitionTo('CrouchIdleLoop'); else transitionTo('CrouchFwdLoop')
-        } else if (animConfig.skipWalk) {
-          const idle2jog   = current === 'IdleLoop'   ? 2.0 : 0.8
-          const jog2sprint = current === 'JogFwdLoop' ? 15.5 : 15.0
-          if (smoothSpeed < idle2jog) transitionTo('IdleLoop')
-          else if (smoothSpeed < jog2sprint) transitionTo('JogFwdLoop')
-          else transitionTo('SprintLoop')
-        } else {
-          const idle2walk  = current === 'IdleLoop'   ? 0.5 : 0.3
-          const walk2jog   = current === 'WalkLoop'   ? 4.0 : 3.5
-          const jog2sprint = current === 'JogFwdLoop' ? 15.5 : 15.0
-          if (smoothSpeed < idle2walk) transitionTo('IdleLoop')
-          else if (smoothSpeed < walk2jog) transitionTo('WalkLoop')
-          else if (smoothSpeed < jog2sprint) transitionTo('JogFwdLoop')
-          else transitionTo('SprintLoop')
-        }
-      }
+      if (!effectiveOnGround && !wasOnGround) sendLoco('JUMP')
+      else if (!wasOnGround && effectiveOnGround && smoothSpeed < 1.5) {
+        sendLoco('LAND'); oneShot = 'JumpLand'; oneShotTimer = STATES.JumpLand.duration
+      } else if (effectiveOnGround) sendLoco(resolveLocoEvent(smoothSpeed, crouching, animConfig.skipWalk))
     }
 
     if (current && LOCO_STATES.has(current) && current !== 'IdleLoop' && current !== 'CrouchIdleLoop') {
       const locoAction = actions.get(current)
       if (locoAction) {
-        const baseScale = current === 'WalkLoop' ? (animConfig.walkTimeScale || 16.0)
-          : current === 'JogFwdLoop' ? (animConfig.jogTimeScale || 0.667)
-          : current === 'SprintLoop' ? (animConfig.sprintTimeScale || 0.56) : 1.0
+        const baseScale = current === 'WalkLoop' ? (animConfig.walkTimeScale || 1.0)
+          : current === 'JogFwdLoop' ? (animConfig.jogTimeScale || 1.0)
+          : current === 'SprintLoop' ? (animConfig.sprintTimeScale || 1.0) : 1.0
         const stateMin = current === 'WalkLoop' ? 0.3 : current === 'JogFwdLoop' ? 3.5 : current === 'SprintLoop' ? 12.0 : 0.3
         const stateMax = current === 'WalkLoop' ? 4.0 : current === 'JogFwdLoop' ? 15.5 : current === 'SprintLoop' ? 24.0 : 6.0
         const ratio = Math.max(0.5, Math.min(1.5, smoothSpeed / Math.max(1, (stateMin + stateMax) * 0.5)))
@@ -156,31 +176,25 @@ export function createAnimationStateMachine(mixer, root, actions, additiveAction
         locoAction.timeScale = smoothTimeScale
       }
     }
-
     aim(aiming)
     wasOnGround = effectiveOnGround
     mixer.update(dt)
   }
-
   function shoot() {
     const action = actions.get('PistolShoot')
     if (!action) return
     action.reset().fadeIn(0.05).play()
   }
-
   function reload() {
     const action = actions.get('PistolReload')
-    if (!action) { console.log('[anim] PistolReload animation not found'); return }
-    console.log('[anim] Playing reload animation')
+    if (!action) throw new Error('[anim] PistolReload animation not found')
     action.reset().fadeIn(0.1).play()
   }
-
   function dispose() {
+    actor.stop()
     mixer.stopAllAction()
     mixer.uncacheRoot(root)
   }
-
   function getState() { return current }
-
   return { transitionTo, update, aim, shoot, reload, dispose, getState }
-}
+}