feat: reconciled simulator-first alteration slice (sessions 0007+0008) #7

2026-06-08T06:00:17Z

benstull commented

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

Summary

Reconciles the two unmerged session-0007/0008 design threads and ships the first simulator-runnable alteration slice.

Design decision (operator-approved, session 0009): the Left analytical HUD is a runtime overlay (authored annotation track + per-language string tables, text shaped live — browser in the sim, Pango/HarfBuzz on the Pi), not baked pixels. Consequently the pre-baked variant set is 1-D over Right strength, not session-0007's 2-D 5x5 Left x Right grid; 0007's baked-HUD position is superseded. The merged slice-1 engine already kept a runtime AnalyticalOverlay, so the engine change is surgical.

Engine (player/):

Restyle.blend (continuous) -> Restyle.variant (discrete pre-baked Right strength; 0 = raw).
AnalyticalOverlay gains level (Left knob) driving annotation selection.
new frozen Calibration (+DEFAULT_CALIBRATION, behavior-preserving) parameterizes the grade/overlay/variant curves, tuned by eye in the sim.
render_plan_to_dict for the API.

Simulator (simulator/):

retired the selection era (/api/select, /api/catalog/meta, X-ray, fixtures.py).
clips.py manifest model; POST /api/alteration + GET /api/clips.
alteration-preview UI: live Dark/Light grade, Right-variant crossfade, live Left overlay (boxes + shaped text), content dial, calibration panel, RenderPlan readout.
ONE neutral clip wired with a real flow-stabilized Right restyle from the session-0008 POC (right_flow.mp4), placeholder intermediate strengths; media gitignored, populated via setup_sample_media.py.

Docs: parent design §4.3/§10 pointer to the reconciliation; ROADMAP slice 2 marked done + deferred slices; USER_GUIDE simulator section rewritten.

Spec: docs/superpowers/specs/2026-06-07-reconciled-simulator-alteration-slice-design.md
Plan: docs/superpowers/plans/2026-06-07-reconciled-simulator-alteration-slice.md

Test Plan

pytest -q — 192 passed, 2 skipped
Sim boots; /api/clips + /api/alteration return correct plans; real right4.mp4 + base served as video/mp4; index served

Co-authored with Claude Opus 4.8 (1M context). Session 0009.

## Summary Reconciles the two unmerged session-0007/0008 design threads and ships the first **simulator-runnable** alteration slice. **Design decision (operator-approved, session 0009):** the Left analytical HUD is a **runtime overlay** (authored annotation track + per-language string tables, text shaped live — browser in the sim, Pango/HarfBuzz on the Pi), **not** baked pixels. Consequently the pre-baked variant set is 1-D over **Right** strength, not session-0007's 2-D 5x5 Left x Right grid; 0007's baked-HUD position is superseded. The merged slice-1 engine already kept a runtime `AnalyticalOverlay`, so the engine change is surgical. **Engine (`player/`):** - `Restyle.blend` (continuous) -> `Restyle.variant` (discrete pre-baked Right strength; 0 = raw). - `AnalyticalOverlay` gains `level` (Left knob) driving annotation selection. - new frozen `Calibration` (+`DEFAULT_CALIBRATION`, behavior-preserving) parameterizes the grade/overlay/variant curves, tuned by eye in the sim. - `render_plan_to_dict` for the API. **Simulator (`simulator/`):** - retired the selection era (`/api/select`, `/api/catalog/meta`, X-ray, `fixtures.py`). - `clips.py` manifest model; `POST /api/alteration` + `GET /api/clips`. - alteration-preview UI: live Dark/Light grade, Right-variant crossfade, live Left overlay (boxes + shaped text), content dial, calibration panel, RenderPlan readout. - ONE neutral clip wired with a **real flow-stabilized Right restyle** from the session-0008 POC (`right_flow.mp4`), placeholder intermediate strengths; media gitignored, populated via `setup_sample_media.py`. **Docs:** parent design §4.3/§10 pointer to the reconciliation; ROADMAP slice 2 marked done + deferred slices; USER_GUIDE simulator section rewritten. Spec: `docs/superpowers/specs/2026-06-07-reconciled-simulator-alteration-slice-design.md` Plan: `docs/superpowers/plans/2026-06-07-reconciled-simulator-alteration-slice.md` ## Test Plan - [x] `pytest -q` — 192 passed, 2 skipped - [x] Sim boots; `/api/clips` + `/api/alteration` return correct plans; real `right4.mp4` + base served as video/mp4; index served Co-authored with Claude Opus 4.8 (1M context). Session 0009.

benstull added 9 commits 2026-06-08 06:00:17 +00:00

docs(spec): reconcile 0007/0008 sim-alteration designs (session 0009) eda259e5b8

Bring the unmerged session-0007 simulator-alteration-preview design onto a
single thread and add the reconciliation design that resolves the load-bearing
Left-HUD conflict between it and the merged session-0008 scales-library /
right-axis design.

Decision (operator-approved): Left is a RUNTIME overlay (authored annotation
track + per-language string tables, shaped live — browser in the sim, Pango/
HarfBuzz on the Pi), not baked pixels. Consequently the pre-baked variant set is
1-D over Right strength, not 0007's 2-D 5x5 Left x Right grid; 0007's baked-HUD
position (its sec 4/5/8) is superseded. Engine change is surgical — the merged
slice-1 engine already keeps a runtime AnalyticalOverlay.

Scopes the first simulator-runnable slice: deterministic Dark/Light/Left +
discrete pre-baked flow-stabilized Right variants over ONE neutral clip, wired
into the simulator, with a parameterized Calibration tuned by eye.

Spec: docs/superpowers/specs/2026-06-07-reconciled-simulator-alteration-slice-design.md

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

docs(plan): implementation plan for reconciled simulator-alteration slice e5ca07e2a4

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

feat(player): discrete Right variant + Left level + Calibration (slice design §2) 12a8177793

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

refactor(player): state.py tests track discrete Restyle.variant 825d68c653

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

feat(simulator): clips.py manifest model; retire selection fixtures c316309fc6

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

feat(simulator): /api/alteration + /api/clips; retire selection endpoints eb3aa0949d

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

feat(simulator): sample-media manifest + POC setup/placeholder generator c3f9262a73

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

feat(simulator): alteration preview UI (grade + variant crossfade + Left overlay) d2d63c0184

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

docs: point parent design at reconciliation; roadmap + user guide for sim alteration b8543906be

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

benstull merged commit 554eb5076f into main

2026-06-08 06:00:32 +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#7