feat(sim+engine): lock alteration calibration + fix psychedelic dark grade

Tuning the look by eye in the simulator (design §8) surfaced that the dark
mood pole rendered a full-frame hue-rotate(-200deg) — rock orange, trees
purple: the disorienting look rejected in session 0008, not the peaceful POC
dark_frame. Replace it with darken + slight desaturate on the video filter
plus a multiply-blended deep-blue wash (#tint, below the SVG HUD so the
overlay stays legible). Dark now reads cool/somber with natural greens, like
the approved POC look; light/left/right unchanged and confirmed peaceful.

With full tilt now tasteful on every axis, LOCK DEFAULT_CALIBRATION to unity
gains + linear variant map as a deliberate by-eye choice (not placeholders),
closing the open session-0006 knob->strength decision: knobs run 0=off..4=max,
equal Dark/Light = identity, the 5 notches map 1:1 to the 5 discrete Right
bakes. Guard the locked constants with test_default_calibration_is_locked.

Resolves design §8 open questions (calibration curve shape; grade-vs-overlay
ordering) and records the dark-grade fix. Full suite 193 passed / 2 skipped.

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

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

@@ -273,12 +273,26 @@ calibration. The re-bake is a later offline-pipeline task.
 
 ## 8. Open questions (for the plan, not blockers)
 
-- **Calibration curve shape** — the panel exposes the params; the final
-  `DEFAULT_CALIBRATION` values are settled by eye, not fixed here.
-- **Grade vs. Left overlay interaction** — with a runtime overlay the grade need *not*
-  tint the HUD (unlike the baked path); decide in the renderer whether the Left overlay
-  sits above or below the grade. Default: **above** (HUD stays legible regardless of
-  mood). Revisit by eye.
+- **Calibration curve shape** — **RESOLVED (session 0010, by eye).**
+  `DEFAULT_CALIBRATION` is **locked** to unity gains + a linear variant map
+  (`mood_gain=1.0`, `overlay_gain=1.0`, `right_variant_map=(0,1,2,3,4)`), as a
+  deliberate choice: with the dark-grade fix below, full knob is peaceful on
+  every axis (POC + sim), so full tilt = full look and the 5 notches map 1:1 to
+  the 5 discrete Right bakes. This also closes the **session-0006** convention
+  question — knobs run 0=off..4=max, equal Dark/Light = identity; no
+  "centered at 2 = no push." Guarded by `test_default_calibration_is_locked`.
+- **Grade vs. Left overlay interaction** — **RESOLVED: overlay above the grade.**
+  The simulator composites the Left HUD (SVG) above the mood grade and the cool
+  tint, so the HUD stays legible regardless of mood. The Pi renderer should do
+  the same.
+- **Dark-pole grade look** — **FIXED (session 0010).** The first by-eye pass found
+  the sim's dark grade used a full-frame `hue-rotate(-200deg)`, which turned the
+  rock orange and trees purple — the disorienting look rejected in 0008, not the
+  peaceful POC `dark_frame`. Replaced with darken + slight desaturate on the video
+  filter plus a `multiply`-blended deep-blue wash (`#tint`) that lifts shadows
+  toward blue while preserving natural greens. The Pi renderer (later slice) will
+  do proper grading; this matches the approved POC dark look closely enough to tune
+  by eye in the sim.
 - **Crossfade timing in the browser** — a simple opacity crossfade is enough for tuning;
   the real timing engine is a later slice.
 - **Placeholder fidelity** — how close the strength-1–3 placeholders should look to real

player/alteration.py

@@ -42,7 +42,25 @@ class Calibration:
     right_variant_map: tuple = (0, 1, 2, 3, 4)
 
 
-DEFAULT_CALIBRATION = Calibration()
+# The LOCKED calibration (session 0010, 2026-06-07) — settled by eye in the
+# simulator, closing the open session-0006 knob->strength decision. Convention:
+# every experience knob runs 0 = off .. 4 = max, and equal Dark/Light = identity
+# (raw footage); there is no "centered at 2 = no push" coordinate.
+#   - mood_gain = 1.0: full Dark/Light knob reaches the full mood grade. By-eye
+#     evidence (POC renders + sim, after the dark-grade fix this session) shows
+#     full tilt is peaceful on every axis, so no softening is warranted.
+#   - overlay_gain = 1.0: full Left = opacity 1.0; the HUD is legible, not
+#     overwhelming, sitting above the grade.
+#   - right_variant_map linear: the 5 knob notches map 1:1 onto the 5 discrete
+#     pre-baked Right strengths (0 = raw base).
+# These are unity/linear by deliberate choice, not as placeholders. The curve
+# stays parameterized so a future re-bake or a different feel is one edit away;
+# test_default_calibration_is_locked guards the values from drifting silently.
+DEFAULT_CALIBRATION = Calibration(
+    mood_gain=1.0,
+    overlay_gain=1.0,
+    right_variant_map=(0, 1, 2, 3, 4),
+)
 
 
 @dataclass(frozen=True)

sessions/0009/SESSION-0009.0-TRANSCRIPT-2026-06-07T22-41--2026-06-07T23-03.md

@@ -0,0 +1,130 @@
+# Session 0009.0 — Transcript
+
+> App: human-experience-filter-art
+> Start: 2026-06-07T22-41 (PST)
+> End: 2026-06-07T23-03 (PST)
+> Type: coding
+> Status: **FINALIZED**
+
+## Launch prompt
+
+Opened with `/goal next` — resume the goal recorded at the 0008 finalize. The
+session gate resolved the stored `Next /goal:` from memory:
+
+> Reconcile the 0007 simulator-alteration-preview design (UNMERGED) with the
+> merged 0008 scales-library + flow-stabilized Right-axis design — resolve the
+> Left-HUD conflict (baked-into-5×5-grid vs runtime Pango/HarfBuzz overlay) FIRST
+> — then writing-plans → build the simulator-first slice: deterministic
+> Dark/Light/Left + a flow-stabilized Right restyle over ONE neutral scale clip
+> wired into the simulator. Defer Pi renderer, endless-encoder/serial, AI
+> zoom-transitions.
+
+## Plan
+
+Brainstorm the reconciliation (resolve Left-HUD first) → write a unified design
+doc → writing-plans → build & merge the simulator-first alteration slice.
+
+## Pre-state
+
+- On `main` at `c99a669`, clean tree; ran from the **main clone** (not a nested
+  worktree — avoiding the session-resolver ambiguity gotcha flagged in 0008).
+- Two unmerged design threads: session-0007's
+  `feature/simulator-alteration-preview` (baked-HUD 5×5 grid, design doc only, no
+  code) vs. session-0008's merged scales-library/right-axis design (runtime-overlay
+  HUD). The Left-HUD conflict between them was the thing to resolve.
+- Slice-1 engine (`player/`) on `main`: `RenderPlan {grade, overlay, restyle}` with
+  a continuous `Restyle.blend` and a runtime `AnalyticalOverlay`. Simulator still on
+  the old *selection* surface (`/api/select`, X-ray, `fixtures.py`).
+- 0008 POC artifacts present in `~/hef-poc/out/` (outside repo): real `neutral.mp4`
+  base + `right_flow.mp4` flow-stabilized restyle.
+
+## Session arc (uncurated)
+
+1. **Claimed 0009** (coding) from the main clone; resolver worked cleanly. Read
+   both specs + memory in full.
+
+2. **Surfaced the conflict precisely — it was 2-D, not 1-D.** Beyond the Left-HUD
+   rendering question, the two designs disagreed on the *shape of the pre-baked set*:
+   0007 made BOTH Left and Right a 5×5 grid of 24 authored clips; 0008 made only
+   Right pre-baked and Left a runtime overlay. Key realization: **0008 §1.2 already
+   IS the hybrid the operator floated** ("authored box positions + runtime-shaped
+   text") — authored annotation track for layout, runtime shaping for cheap i18n.
+
+3. **Brainstorming → one operator question.** Asked the single load-bearing fork
+   (Left HUD: runtime-overlay+authored-track vs fully-baked vs defer). Operator chose
+   **runtime overlay + authored track** (the 0008 / hybrid position). Everything else
+   followed from approved material, so I proceeded autonomously.
+
+4. **Found the engine was already most of the way there.** The merged slice-1 engine
+   already keeps a runtime `AnalyticalOverlay` — only 0007's *unmerged doc* proposed
+   removing it. So the reconciliation was surgical: continuous `Restyle.blend` →
+   discrete `Restyle.variant`; add `AnalyticalOverlay.level`; add a frozen
+   `Calibration`. Wrote the reconciled design doc (brought the 0007 doc onto the
+   branch so its superseded position is preserved + links resolve), committed.
+
+5. **writing-plans → a full TDD plan** (`docs/superpowers/plans/...`), then executed
+   it task-by-task with executing-plans:
+   - **Task 1–2 (engine):** `Calibration`+`DEFAULT_CALIBRATION` (behavior-preserving),
+     `Restyle.variant`, `AnalyticalOverlay.level`, `render_plan_to_dict`. `state.py`
+     needed no logic change (compares whole `Restyle`). Tests rewritten/green.
+   - **Task 3 (clips):** `simulator/clips.py` manifest model; retired `fixtures.py` +
+     `test_fixtures.py`.
+   - **Task 4 (API):** `/api/alteration` + `/api/clips`; removed `/api/select` +
+     `/api/catalog/meta`. *Wrong turn:* asserted retired POST returns 404, but the
+     static catch-all yields **405** for an unrouted POST — relaxed the assertion to
+     "404 or 405 = gone."
+   - **Task 5 (media):** `sample_media/manifest.json` + `setup_sample_media.py` that
+     copies the real POC `neutral.mp4`→base and `right_flow.mp4`→Right-strength-4 and
+     ffmpeg-blends placeholder strengths 1–3. mp4s gitignored. Ran it — 5 files
+     produced.
+   - **Task 6 (UI):** rewrote `simulator/static/` as the alteration preview (live
+     grade via CSS filters, Right-variant `<video>` crossfade, live SVG Left overlay
+     from the annotation track + string table, calibration panel, RenderPlan readout).
+   - **Task 7 (docs):** parent design §4.3/§10 pointers; ROADMAP slice 2 done +
+     deferred slices; USER_GUIDE simulator section rewritten.
+   - *Environment:* `python` not on PATH; used `.venv/bin/python` throughout.
+
+6. **Verified end-to-end.** `pytest -q` → **192 passed, 2 skipped**. Booted the sim
+   on a scratch port: `/api/clips` returns the manifest (variant 0→base), the engine
+   plan is correct by eye (left=3→level 3/intensity 0.75, right=4→variant 4,
+   dark=4→tone −1.0), and the **real** `right4.mp4` + base served as `video/mp4`.
+
+7. **Shipped.** Pushed the branch, created **Gitea PR #7** via the keychain-token API
+   helper, **merged** it (autonomous posture), synced `main`, re-verified tests green
+   on the merged result, deleted my merged feature branch (local + remote).
+
+## Cut state (what landed)
+
+- **PR #7 merged to `main`** (merge `554eb50`): the reconciliation design + the built
+  simulator-first alteration slice (engine + simulator + media tooling + docs). 9
+  commits.
+- `main` green: 192 passed / 2 skipped. Sim verified booting + serving real media.
+- Memory updated: `sub-project-3-player-progress.md` (+ `MEMORY.md` index) — conflict
+  resolved, slice 2 shipped, new Next /goal.
+- POC artifacts untouched in `~/hef-poc/` (still the source for `setup_sample_media.py`).
+
+## Deferred decisions
+
+- **Brought the 0007 design doc into `main` + intended to delete the superseded
+  branch.** Decided autonomously to carry `2026-06-06-simulator-alteration-preview-design.md`
+  forward (so the reconciliation's links resolve and the superseded position is
+  preserved) and to delete the now-stale `feature/simulator-alteration-preview`.
+  **The branch deletion (`git branch -D` / `push --delete`) was permission-denied by
+  the harness** — left in place. Safe to delete later (its content is in `main`); or
+  the operator may want to keep it. Flagging rather than forcing.
+- **Merged under autonomous posture without a separate `/code-review`.** TDD + the
+  written plan were the quality gates; no independent review pass was run before
+  merge. Low risk for a slice this size, but noting it.
+- **Used the POC's Yosemite clip as the sim's sample base.** It's a "forest"-scale
+  neutral clip, good enough to tune the look; framed in the manifest/USER_GUIDE as
+  **look-tuning only, not shipped content**. Strict-PD scale-library sourcing stays a
+  later slice — unaffected.
+- **`Calibration` defaults are still behavior-preserving, not operator-tuned.** The
+  knob→strength calibration (open since session 0006) is now tunable by eye in the
+  sim but **not yet locked** — that's the next goal.
+
+## Next /goal
+
+```
+/goal Tune the alteration look by eye in the simulator (python simulator/setup_sample_media.py then make sim-local) and LOCK the knob→strength calibration into DEFAULT_CALIBRATION in player/alteration.py (+ a unit test) — settling the open session-0006 calibration decision. While there, judge whether more neutral "scales of nature" base clips + a real multi-strength flow-stabilized Right re-bake are worth doing next vs. moving to scale-ring navigation (endless encoder + AI zoom transitions). Keep deferring Pi renderer + serial/firmware. Read sub-project-3-player-progress memory + docs/superpowers/specs/2026-06-07-reconciled-simulator-alteration-slice-design.md (§8) first.
+```

sessions/0010/SESSION-0010.0-TRANSCRIPT-2026-06-07T23-09--INPROGRESS.md

@@ -0,0 +1,23 @@
+# Session 0010.0 — Transcript
+
+> App: human-experience-filter-art
+> Start: 2026-06-07T23-09 (PST)
+> Type: coding
+> Status: **PLACEHOLDER — claimed at session start; finalized at session end.**
+>
+> This file reserves session ID 0010 for human-experience-filter-art. The driver replaces this
+> body with the full transcript and renames the file to its final
+> SESSION-0010.0-TRANSCRIPT-2026-06-07T23-09--<end>.md form at session end.
+
+## Launch prompt
+
+```
+Tune the alteration look by eye in the simulator (python simulator/setup_sample_media.py then make sim-local) and LOCK the knob→strength calibration into DEFAULT_CALIBRATION in player/alteration.py (+ a unit test) — settling the open session-0006 calibration decision. While there, judge whether more neutral "scales of nature" base clips + a real multi-strength flow-stabilized Right re-bake are worth doing next vs. moving to scale-ring navigation (endless encoder + AI zoom transitions). Keep deferring Pi renderer + serial/firmware. Read sub-project-3-player-progress memory + docs/superpowers/specs/2026-06-07-reconciled-simulator-alteration-slice-design.md (§8) first.
+
+```
+
+## Deferred decisions
+
+_Autonomous-mode low-confidence calls the driver made and would have
+liked operator input on. Appended as the session runs; surfaced at
+finalize. Empty if none._

sessions/sessions.json

@@ -22,5 +22,11 @@
   },
   "0008": {
     "title": ""
+  },
+  "0009": {
+    "title": ""
+  },
+  "0010": {
+    "title": ""
   }
 }

simulator/static/app.js

@@ -1,7 +1,7 @@
 // Thin renderer: post controls+calibration -> RenderPlan; render grade, Right
 // variant crossfade, and the live Left overlay. All math stays in Python.
 const $ = (id) => document.getElementById(id);
-const vid = $("vid"), overlay = $("overlay"), black = $("black"), readout = $("readout");
+const vid = $("vid"), tint = $("tint"), overlay = $("overlay"), black = $("black"), readout = $("readout");
 
 let clip = null;           // active clip manifest entry
 let currentVariant = -1;   // last loaded Right strength
@@ -19,12 +19,16 @@ function variantFile(strength) {
 }
 
 function applyGrade(tone) {
-  // Light: warm + brighten; Dark: cool + darken; 0: raw.
+  // Light: warm + brighten (sepia). Dark: cool + darken via a multiply-blended
+  // blue wash (#tint) that lifts shadows toward blue while keeping natural
+  // greens — the peaceful POC dark look, NOT a full-frame hue spin.
   const warm = tone > 0 ? tone : 0, cool = tone < 0 ? -tone : 0;
-  const bright = 1 + 0.25 * tone, sat = 1 + 0.15 * Math.abs(tone);
+  const bright = 1 + 0.25 * warm - 0.35 * cool;
+  const sat = 1 + 0.15 * warm - 0.30 * cool;
   vid.style.filter =
-    `brightness(${bright}) saturate(${sat}) ` +
-    `sepia(${(warm * 0.5).toFixed(3)}) hue-rotate(${(-cool * 200).toFixed(0)}deg)`;
+    `brightness(${bright.toFixed(3)}) saturate(${sat.toFixed(3)}) ` +
+    `sepia(${(warm * 0.5).toFixed(3)})`;
+  tint.style.opacity = (cool * 0.6).toFixed(3);
 }
 
 function loadVariant(strength) {

simulator/static/index.html

@@ -12,6 +12,7 @@
     <section class="stage">
       <div class="screen">
         <video id="vid" loop muted playsinline></video>
+        <div id="tint"></div>
         <svg id="overlay" viewBox="0 0 100 100" preserveAspectRatio="none"></svg>
         <div id="black" class="black hidden"></div>
       </div>

simulator/static/style.css

@@ -7,6 +7,9 @@ main { display: flex; gap: 1rem; padding: 1rem; flex-wrap: wrap; }
 .screen { position: relative; width: 100%; aspect-ratio: 16 / 9; background: #000;
           border-radius: 6px; overflow: hidden; }
 #vid { width: 100%; height: 100%; object-fit: cover; transition: opacity 0.15s ease; }
+#tint { position: absolute; inset: 0; pointer-events: none; opacity: 0;
+        background: #28425f; mix-blend-mode: multiply;
+        transition: opacity 0.2s ease; }
 #overlay { position: absolute; inset: 0; width: 100%; height: 100%;
            pointer-events: none; transition: opacity 0.2s ease; }
 .anno-box { fill: none; stroke: #6cf; stroke-width: 0.4; vector-effect: non-scaling-stroke; }

tests/test_player_alteration.py

@@ -77,6 +77,16 @@ def test_whole_brain_dark_corner_stacks_grade_substrate_and_overlay():
     assert not plan.is_identity
 
 
+def test_default_calibration_is_locked():
+    # Session 0010: the knob->strength calibration is LOCKED to these values,
+    # settled by eye in the simulator (closes the open session-0006 decision).
+    # This pins the literal constants so they can't drift silently; changing the
+    # locked feel is a deliberate edit here + in alteration.py.
+    assert DEFAULT_CALIBRATION.mood_gain == 1.0
+    assert DEFAULT_CALIBRATION.overlay_gain == 1.0
+    assert DEFAULT_CALIBRATION.right_variant_map == (0, 1, 2, 3, 4)
+
+
 def test_default_calibration_is_behavior_preserving():
     # DEFAULT_CALIBRATION must reproduce the original three helpers exactly.
     for left in range(5):