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:
- A live run in Chrome, with the window in front and the page running at about 120 fps.
- One new issue (F19).
- A pass/fail check for each issue, so each fix can be verified.
Earlier pages, with the full evidence and fix sketches:
- First review (R, P, T, M, A): https://pages.yachint.in/p/clutch-cutaway-review-findings-and-accuracy-plan-ome5uevk
- Re-check at
81cca6e(F1–F18): https://pages.yachint.in/p/clutch-cutaway-re-check-of-pr-1-at-81cca6e-rp8egh8u
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:
- F3, live. "A small rise in revs" shows while the revs dip to 763. "Hold the bite… slip" shows while the panel says Locked together.
- F12, live. The clutch readout says Up from 7.8 s, while the pedal is at 0.40 (the lesson moves it to 0.02 only at 9.3 s).
- Correct behaviour seen along the way:
- With the clutch down in neutral, the input shaft spins down (797 → 153 rpm over 1.5 s).
- It is held at 0 once 1st is selected with the car stopped, as the synchro would do.
- The lesson ends in a steady idle creep of about 7 km/h at about 835 rpm.
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)
-
Where:
src/main.js:287–296(takeOver),:183–185(pedal inputs),:147–151(key release) -
Problem:
- "Drive it", Escape, any pedal key or any gear key mid-lesson calls
takeOver(), which copies the lesson's current pedal positions intolatched. - The keys W, S and C are momentary on top of
latched:brake = held.brake ? 1 : latched.brake. Letting go of a key returns that pedal to the lesson's value, not to 0.
- "Drive it", Escape, any pedal key or any gear key mid-lesson calls
-
Examples (lesson end values from
src/lessons.js):- After Why it stalls, "Drive it" leaves the brake at 90%. Pressing and releasing S leaves it at 90%.
- After Stop cleanly, the brake stays at 45%.
- After Change gear, the throttle stays at 12%, so the car keeps driving in 3rd with no key pressed. Releasing W returns to 12%.
- Seen in the browser during the re-check: leaving Pull away early left the brake readout at 40% in free drive.
- Only the pointer, or focusing a slider and pressing ArrowUp many times, clears these.
-
Fix: choose one of these:
- (a) On "Drive it" or Escape, keep the clutch and the gear but reset brake and throttle to 0.
- (b) On keyup for W, S or C, set that pedal's
latchedvalue to its rest value (throttle 0, brake 0, clutch 0), so a keyboard user can always return a pedal to rest.
Option (b) is the smaller change and also fixes the case where the lesson ended in a "holding" state.
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
- F1 + F2 (with the 5th-gear lugging test).
- F3 (tested timeline in the re-check page).
- F4 + F5 (clutch parts touching, and the inset).
- F6 (footwell and Pedals camera).
- F19 + F18 + F12 (pedal input and readout).
- F7–F11 (audio mute, engine-off shifts, neutral and coasting copy, grammar).
- F13–F17 (reverse gears, ring and pinion, labels, cable routing, consistency).