feat(ring): fast-spin blended pass past a speed threshold (scales design §3) #10

2026-06-08T07:18:09Z

benstull commented

2026-06-08 07:18:09 +00:00

Implements the design §3 fast-spin behavior — the one footage-independent tuning dimension of the ring goal.

Problem: a multi-detent spin chained one full transition per scale crossed (+5 ≈ 5 placeholder morphs ≈ 12-15s), feeling sluggish for a fast spin. Design §3: "transitions chain, or past a speed threshold a faster blended pass is used."

Change: advance_ring gains opt-in fast_spin_threshold (canonical default DEFAULT_FAST_SPIN_THRESHOLD = 3). abs(delta) is the input layer's spin-speed proxy (a spin batches detents into one advance call); at/above the threshold the move collapses to a single blended pass — one TransitionStep (arrival edge, blended=True, landing straight on the destination, RingMove.fast=True). Landing index, wrapped, and arrival edge/direction match the full chain exactly; only the in-between transitions drop.

Opt-in (default off) keeps the pure function complete and all existing tests green — the simulator/firmware (which can observe wall-clock speed) enables it. Sim plays the blended step at 2.5× (FAST_BLEND_RATE).

Tests: +9 (ring policy, serializer, API). Suite 224 passed / 2 skipped. Verified live end-to-end on the running sim (slow chains, fast collapses, correct wrap + arrival).

🤖 Generated with Claude Code

Implements the design §3 fast-spin behavior — the one footage-independent tuning dimension of the ring goal. **Problem:** a multi-detent spin chained one full transition per scale crossed (+5 ≈ 5 placeholder morphs ≈ 12-15s), feeling sluggish for a fast spin. Design §3: "transitions chain, or past a speed threshold a faster blended pass is used." **Change:** `advance_ring` gains opt-in `fast_spin_threshold` (canonical default `DEFAULT_FAST_SPIN_THRESHOLD = 3`). `abs(delta)` is the input layer's spin-speed proxy (a spin batches detents into one advance call); at/above the threshold the move collapses to a single blended pass — one `TransitionStep` (arrival edge, `blended=True`, landing straight on the destination, `RingMove.fast=True`). Landing index, `wrapped`, and arrival edge/direction match the full chain exactly; only the in-between transitions drop. Opt-in (default off) keeps the pure function complete and all existing tests green — the simulator/firmware (which can observe wall-clock speed) enables it. Sim plays the blended step at 2.5× (`FAST_BLEND_RATE`). **Tests:** +9 (ring policy, serializer, API). Suite 224 passed / 2 skipped. Verified live end-to-end on the running sim (slow chains, fast collapses, correct wrap + arrival). 🤖 Generated with [Claude Code](https://claude.com/claude-code)

benstull added 1 commit 2026-06-08 07:18:09 +00:00

feat(ring): fast-spin blended pass past a speed threshold (scales design §3) f11b9ee72d

A multi-detent encoder spin previously chained one full transition per scale
crossed (e.g. +5 ≈ 5 placeholder morphs ≈ 12-15s), which feels sluggish for a
fast spin. Design §3 anticipates this: "transitions chain, or past a speed
threshold a faster blended pass is used."

`player.ring.advance_ring` gains an opt-in `fast_spin_threshold` (canonical
default `DEFAULT_FAST_SPIN_THRESHOLD = 3`). A spin batches its detents into one
advance() call, so `abs(delta)` is the input layer's proxy for spin speed; at or
above the threshold the move collapses to a single blended pass — one
`TransitionStep` (the arrival edge, marked `blended`, landing straight on the
destination, `RingMove.fast=True`) instead of the full chain. Landing index,
seam-crossing (`wrapped`), and arrival edge/direction are exactly the full
chain's; only the in-between transitions are dropped.

The policy is opt-in (default off) because the pure function cannot observe
wall-clock spin speed — the simulator/firmware, which can, enables it. This keeps
all existing complete-chain behavior and tests intact. The simulator passes the
default threshold and plays the blended step at 2.5× (FAST_BLEND_RATE); a
dedicated fast-blend clip can replace the accelerated arrival-edge placeholder
when real transition media exists.

- player/ring.py: TransitionStep.blended, RingMove.fast, threshold param + policy
- simulator/clips.py: serialize fast/blended in ring_move_to_dict
- simulator/app.py: apply DEFAULT_FAST_SPIN_THRESHOLD at /api/ring/advance
- simulator/static/app.js: play a blended step at FAST_BLEND_RATE
- docs: scales design §3, USER_GUIDE, ROADMAP slice-3 note

Tests: +9 (ring policy, serializer, API). Suite 224 passed / 2 skipped.

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

benstull merged commit 49b1f0a549 into main

2026-06-08 07:18:17 +00:00

benstull deleted branch feature/ring-fast-spin-blended-pass

2026-06-08 07:18:17 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: benstull/human-experience-filter-art#10