agent-pages

Clutch cutaway: open issue log for PR #1 (81cca6e)

Download

Clutch cutaway: open issue log for PR #1

PR: yachint/car-demos #1 (cursor/clutch-cutaway-demo-ec31 → main) State checked: 81cca6e (PR version 6). There are no commits after the re-check. Date: 2026-10-19

This is the working list of everything still open. It adds three things to the earlier pages:

  1. A live run in Chrome, with the window in front and the page running at about 120 fps.
  2. One new issue (F19).
  3. A pass/fail check for each issue, so each fix can be verified.

Earlier pages, with the full evidence and fix sketches:

All file:line references point at 81cca6e.


1. Live run in Chrome

The app ran from the Vite dev server in Chrome (Claude in Chrome extension) at a 1512×748 viewport. I recorded the Pull away lesson as a 14-frame GIF (pull_away_lesson.gif, 5.2 MB, kept locally because Origin comments are text-only; available on request). A logger in the page read the on-screen values every 0.5 s.

t (s) Step on screen Engine / disc rpm Link readout km/h Clutch readout
0.3–1.8 Neutral, engine idling 850 / 850 Locked together 0 Up
2.3–3.8 Pedal down, plates apart 850 / 797 → 153 Disconnected 0 Down
4.3–5.3 First gear, while that gap is open 850 / 0 Disconnected 0 Down
5.8 A small rise in revs ("about 1,200–1,500 rpm") 763 / 6 Slipping · 757 rpm 0 Bite
6.3 " 768 / 176 Slipping · 592 rpm 2 Bite
6.8 " 835 / 400 Slipping · 435 rpm 4 Bite
7.3 " 857 / 629 Slipping · 228 rpm 6 Bite
7.8 Hold the bite ("The surfaces meet and slip") 906 / 906 Locked together 8 Up
8.3–9.3 " 1153 → 1483, matched Locked together 10–13 Up
9.8–10.8 Pedal up — the clamp shuts 1598 → 1772 Locked together 14–16 Up
11.3–14.3 Idle alone is enough 1761 → 868 Locked together 16 → 8 Up

What the live run confirms:


2. New issue

F19. Pedal positions from a lesson stay on in free drive, and the keyboard can't clear them (input / UX, low–medium)


3. Open-issue tracker

Severity: H high, M medium, L low. Each row's "Done when" is the check for that fix.

ID Sev Area Issue Where Done when
F1 H Physics Idle control adds its full 88 Nm at any rpm above the fade, so every gear keeps running from about 380 rpm and speeds up with the throttle closed. 5th from 20 km/h → 27 km/h with no throttle. src/sim.js:124–136, :36 5th at 20 km/h, throttle 0, clutch up stalls within 3 s with stallReason === 'gear'. Neutral idle stays at 850 ± 80 rpm, 1st-gear creep still settles at 800–870 rpm, and a 1.0 s release in 1st still creeps.
F2 M Narration The engine-braking text shows while the engine is driving (flow +0.5). src/explain.js:124–130 explain() never returns the engine-braking text when flow >= 0, and shows a lugging message when flow > 0 with rpm below idle.
F3 M Lessons Pull away text doesn't match: the revs dip rather than rise, and "Hold the bite" plays while locked. Confirmed live (section 1). src/lessons.js:29–56 During the "find the bite" step mode === 'slipping'; revs before the bite are 1,000–1,300; peak under 2,000; the run ends in an idle creep. A tested timeline is in the re-check page (F3).
F4 M 3D The clutch parts don't touch: plate 11 mm from the disc when clamped, bearing 10–20 mm from the fingers, finger tips swing 33 mm through the disc hub into the flywheel. src/vehicle.js:134–149, :253–331 At pedal 0 the plate-to-disc gap is at most 1 mm. At every pedal position the bearing touches the finger tips (gap at most 1 mm). The finger tips never pass the pressure plate's front face.
F5 M UI / 3D The inset is off-screen at 1512×714, nearly black (scene.environment = null), and Face view is blocked by the input-to-countershaft gear teeth and the bearing; no disc is visible. src/main.js:226–278, src/vehicle.js:410, :521–523 At 1512×714 the inset is fully visible without scrolling. The plates are lit, not near-black. Face view shows the diaphragm fingers and the disc with the pedal up and down.
F6 M 3D / cabin The pedals are at x 0.12, behind the steering wheel (x 0.28), next to 1st/2nd gear. The Pedals camera frames the gearbox and the pedals sit under the control dock. src/vehicle.js:719–725, src/main.js:17 The pedal pads are at least 0.25 m ahead of the steering wheel. Nothing intersects the bellhousing, gearbox or flywheel over full travel. The Pedals camera shows all three pads above the dock.
F7 L–M Audio Road noise bypasses master; turning Sound off doesn't silence it. src/audio.js:65–76, :120–135 With Sound off, nothing is audible while the car moves (roadGain at 0, or the context suspended).
F8 L–M Rules With the engine off, every gear-change check is skipped: 1st at 100 km/h spins the dead engine to 7,853 rpm, and R at 60 km/h forward is accepted. src/sim.js:242–266 With the engine off and rolling above 5 km/h, requestGear(-1) is refused, and so is any gear that would put the engine past the redline. Parking in gear while stationary still works.
F9 L Rules / copy Shifting to neutral with the clutch up is refused with synchro "grind" text and the grind sound. src/sim.js:242–247 Neutral is either allowed with the throttle low, or refused with accurate copy and no grind.
F10 L Copy Coasting in neutral with the clutch up at 50 km/h says "which is why the wheels do not turn". src/explain.js:73–77 Above 10 km/h in neutral, the text never says the wheels aren't turning.
F11 L Copy "At this speed 5 holds…" and "Reverse the engine reaches idle…". src/explain.js:33, :81–85 One helper writes "5th gear" and "In reverse".
F12 L UI The clutch readout says "Up" while the pedal is at 0.40–0.5 and the plates grip. Confirmed live. src/ui.js:149–153 The readout follows pedal position: Down at or above CLUTCH_TOUCH, Up at or below about 0.1, otherwise Bite (or "Gripping" when locked).
F13 L 3D Reverse: the idler turns the same way as the countershaft, the reverse main gear spins against its own shaft in R, and the reverse pair overlaps by 9 mm. src/vehicle.js:156, :419, :430–434 In R the selected gear and the output shaft turn the same way. Each meshing pair turns in opposite directions. Gears that shouldn't mesh don't overlap.
F14 L 3D The ring and pinion are 47:13 (3.62) but FINAL is 3.9. src/vehicle.js:464, :481 The tooth ratio is within 1% of FINAL (e.g. 43:11).
F15 L UI The status, Flywheel, Pressure plate and Clutch disc labels overlap, so two of them are hidden. src/vehicle.js:527–535 No two label rectangles overlap in the Layout and Clutch views at 1512×714.
F16 L 3D The hydraulic line (looping to y 0.74) and steering column cross the Clutch camera. src/vehicle.js:356–364, :765–768 Neither is in front of the clutch stack from the Clutch camera.
F17 L Consistency The engine is drawn at 1.6 L (80 × 80 × 4) against the sim's 2.0 L. The driveshaft comment says 3° but it is 5.8°. STALL_RPM is no longer used. The input shaft and mainshaft overlap for 24 cm. src/vehicle.js:566–607, src/layout.js:7, src/sim.js:20, src/vehicle.js:316–319, :390–393 The values agree, the dead export is gone, and the shafts don't overlap.
F18 L Input Holding C is on/off, so a keyboard release is an instant dump and keyboard-only users always stall pulling away. src/main.js:183 Releasing C brings the pedal up over at least about 1 s of real time, so a keyboard-only user can pull away.
F19 L–M Input / UX A lesson's pedal positions stay on in free drive (brake 90% after Why it stalls, throttle 12% after Change gear) and the keys can't clear them. src/main.js:287–296, :183–185, :147–151 After any lesson then "Drive it", a keyboard user can bring brake and throttle to 0 (or they start at 0).

4. Suggested order

  1. F1 + F2 (with the 5th-gear lugging test).
  2. F3 (tested timeline in the re-check page).
  3. F4 + F5 (clutch parts touching, and the inset).
  4. F6 (footwell and Pedals camera).
  5. F19 + F18 + F12 (pedal input and readout).
  6. F7–F11 (audio mute, engine-off shifts, neutral and coasting copy, grammar).
  7. F13–F17 (reverse gears, ring and pinion, labels, cable routing, consistency).