TURNCRAFT/docs/INTEGRATION_NOTES.md

TURNCRAFT — Integration Notes (what the integrator changed and why)

Integration performed per INTEGRATION.md after all five lanes landed. Every cross-lane glue decision is listed here.

Contract changes (core is integrator-owned)

1. Y_RECORD_TOP: 85 → 81 (src/core/constants.ts). At 85 the vinyl surface was a 5-voxel cliff above the plinth (jump height ≈ 1.3 — the record was unreachable), and Lane D's platter stack floated on the plinth top, ignoring the 6-deep well Lane C carved. Now the record sits 1 proud of the plinth (auto-steppable, like a real 1200) and the platter body fills the well. Everything downstream (tonearm heights, audio panner positions, FX rim sparkle, D's quest defaults) derives from the constant and moved automatically. Added PLATTER.wellDepth = 6 alongside.
2. Lane B's requested velocityAt out-param overload was NOT taken: Lane D already returns a reused per-collider scratch array (no allocation), which satisfies the hot-path concern with no contract change.

Cross-lane glue (in src/main.ts)

• QuestPositions adapter: Lane C's nested QUEST_POS is mapped to Lane D's flat QuestPositions; the crossfader slot span is derived from C's MIXER anchors (centerX ± halfLen, faceTopY−depth+1 … faceTopY−1, z −1…+2) so D's slide gate covers exactly the tram volume C carved.
• machines.attachPlayer(player) called after the player is built (Lane D's added step "6.5") — enables walk-push faders and walk-press plates.
• Hotbar: D's Hotbar structurally satisfies E's HotbarModel; passed directly as getHotbar, with hotbar.onChange(() => hud.refreshHotbar()).
• Input wiring: LMB hold = mine, RMB = place, E = use, 1–9/wheel = hotbar, all gated on pointer lock (matching Lane B's own key gating). Start splash click → audio.init() + pointer lock; resume click → re-lock only.
• Fixed-step loop: machines → player → interaction → fx at FIXED_DT, with MAX_SUBSTEPS catch-up and an accumulator clamp so a backgrounded tab doesn't spiral; audio.updateListener + chunks.update() + render per frame.
• Debug handle window.TURNCRAFT (world/player/machines/quest/hotbar/audio/ fx/hud/chunks/interaction) — used by the smoke tests, harmless in play.

Lane-file adjustments (documented per CONTRACTS "integrator resolves")

• src/machines/platter.ts — platter body now spans the well floor to 1 below the vinyl (visuals) and its collider spans well floor → Y_RECORD_TOP so the spinning body also pushes the player out of the well's 2-voxel gap ring (which is now a real, intentional fall-in hazard).
• src/fx/layout.ts — VU overlay sprites aligned to Lane C's physical LED towers (x = mixer minX+18 / maxX−18, 12 segments, in front of the open casing face) per Lane E's friction note #5.
• src/interact/interaction.ts — per-material break times (soft 0.12 s, glass 0.25 s, default 0.4 s). The crossfader jam is ~240 dust blocks; at a flat 0.4 s it was a 96-second chore.
• docs/DESIGN.md — elevation table updated for the Y_RECORD_TOP change.

Deviations accepted as-is

• 45 speed available pre-win (D's reading; DESIGN's "45 unlocked at win" treated as flavor). Platter.unlocked45 exists if we ever gate it.
• fader_cross does not drive audio (E maps pitch + channel digits only); crossfader is quest/physical-only in v1.
• Both deck pitch faders drive the one global mix pitch (E has a single transport; fine until per-deck stems exist).
• Tonearm pedestal (C's voxels) vs D's arm pivot are ~11 voxels apart — cosmetic misalignment, queued for polish, gameplay unaffected.

Verified at integration (live browser, real code paths)

• Boot: booth builds + meshes in ~670 ms dev / 46 modules build in 0.5 s; fillBox fast path ENABLED; 120 fps; zero console errors all session.
• Ride: standing on the record at 33 → clean circle, r drift 20.00→20.02 over 4 s, y = 81 exactly, spin-up ramp visible; at 45 near the rim → 10.7 v/s (= ω×r), jump lands back on the moving disc.
• Mining: real DDA aim → dust breaks into hotbar; crossfader stays gated while dust remains.
• Quest chain: stems stack 0→5 per signal:repair, power switch arms exactly after the 4th repair, real button press → game:win once, both platters auto-start, HUD banner + tracker 5/5, AudioContext running.
• The platter-well gap ring behaves as a trench (collider pushes, no clipping).

Concept-art pass (post-integration, from John's Gemini mockup)

• Terraced records: the flat disc became a stepped "groove amphitheater" — 3 vinyl tiers rising 1 voxel each to the label plateau, then a 4-tier stepped spindle tower with an amber lamp (all in TIERS, platter.ts). Each tier is its own stacked kinematic cylinder; you walk/spiral up a SPINNING staircase. Tonearm raised (HEAD_Y +2.6) and R_INNER pulled to 16 so the needle clears the terraces and never hits the tower.
• Player physics upgrades this required (PlayerController.ts): cylinder contacts now resolve by minimum penetration (up vs radial), which fixes a latent slingshot bug (feet dipping below a disc's top while deep inside its footprint used to teleport the player radially to the rim); 1-voxel collider lips auto-step like voxel ledges; cylinder tops have a half-foot radius grace so you can stand on rims.
• Well seam: the platter well's outer ring was a 7-deep inescapable trench; floor raised to 1 below the plinth top (worldgen) — now a Technics seam you step out of.
• Room feel: plywood ceiling with six recessed amber lamp panels (worldgen) + matching warm PointLights (main.ts), warmer/brighter hemi/ambient/fog (renderer.ts).
• Mixer color pop: knob caps get a deterministic palette scatter (red/ white/gold/LED) in buildMixer. Rim crumble: vinyl chips/dust/screws scattered around the well mouths in buildDeck.
• Dev nicety: window.TURNCRAFT_CINE = { pos, look } detaches the camera for screenshots/trailers; window.TURNCRAFT exposes camera/render too.
• Verified: walk-in from the rim spirals up to the label plateau at 33 rpm (fighting the spin is intentional physics — stop the deck for an easy climb); tower fully climbable (83→87 by walking); seam escape 1-step; 121 fps with ceiling + lights; quest/win chain re-verified end-to-end.

Not yet done (deploy phase)

Run /ship-check before exposing anything publicly; deploy per deploy-map conventions (static dist/ — 156 KB gzipped). Cloudflare/host wiring is a separate step, to be done with the token holder present.