# Session 0001.0 — Transcript

> App: human-experience-filter-art
> Start: 2026-06-04T05-36 (PST)
> Type: spec
> Status: **PLACEHOLDER — claimed at session start; finalized at session end.**
>
> This file reserves session ID 0001 for human-experience-filter-art. The driver replaces this
> body with the full transcript and renames the file to its final
> SESSION-0001.0-TRANSCRIPT-2026-06-04T05-36--<end>.md form at session end.

## Launch prompt

```
/goal Develop the spec for sub-project 2 — "Ingest & Tagging / Review tools" — of
the Human Experience Filter, the next item in docs/ROADMAP.md. Ground it in
docs/superpowers/specs/2026-06-04-human-experience-filter-design.md (especially §5
division-of-labor and §8 sourcing) and the roadmap's sub-project-2 section.

The spec must cover: per-archive ingest fetchers (Internet Archive/Prelinger,
Musopen, LibriVox, NASA, Free Music Archive, Freesound); automatic mechanical
tagging (mode via ffprobe, license/attribution/source from origin, duration_s,
resolution, dominant_color computed from video); assistant coordinate-drafting
that writes a one-line rationale and sets review_status=proposed; and the review
CLI that walks proposed records (proposed coords + rationale + preview frame) and
flips them to approved with reviewed_at. It must build on the existing
hef.catalog API without breaking it — call out explicitly any additions the
tools need.

```

## Plan

**Spec session — develop the sub-project 2 spec.** Sub-project 1 (Catalog &
Selection Core) is done and merged. This session writes the spec for
sub-project 2 (**Ingest & Tagging / Review tools**) to
`docs/superpowers/specs/`, grounded in the design doc
(`2026-06-04-human-experience-filter-design.md`, esp. §5 division-of-labor and
§8 sourcing) and the ROADMAP §2 section.

Scope the spec must cover:
1. Per-archive ingest fetchers — Internet Archive/Prelinger, Musopen, LibriVox,
   NASA, Free Music Archive, Freesound.
2. Mechanical tagging — `mode` (ffprobe streams), `license`/`attribution`/
   `source_*` (from origin), `duration_s`, `resolution`, `dominant_color`
   (computed from video).
3. Assistant coordinate-drafting — propose `left/right/dark/light` + one-line
   `rationale`, write `review_status: proposed`.
4. Review CLI — walk proposed records (coords + rationale + preview frame),
   accept/correct, flip to `approved`, stamp `reviewed_at`.

Hard constraint: build on existing `hef.catalog` API without breaking it; call
out explicitly any additions the tools need.

Done when: spec written + self-reviewed + operator-approved; any plan saved
under `docs/superpowers/plans/`; working tree clean, merged to `main`, branches
deleted, `main` pushed to origin.

Note: app has no BDD corpus (`BDD_REMOTE` empty) — grounding input is the design
spec, not a gherkin corpus.

## 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._

- **Major design change surfaced mid-approval (operator, 2026-06-04):** switch to
  a **single panoramic projector spanning all three walls, content = nature
  videos**, and "we may not need any video manipulation at all." This supersedes
  the design spec §6 (four projectors) / §7 (procedural side walls) and reshapes
  sub-projects 3 (player → one pano output) and 5 (side walls likely dropped).
  **Handled in this spec** by demoting `dominant_color` to optional/opt-in (its
  only consumer was the side walls). **Follow-up for the operator:** the design
  spec + ROADMAP need a separate update pass to reflect the pano/nature-video
  direction — out of scope for the sub-project-2 spec. Captured in memory.
- Operator confirmed first-ship archives (LibriVox + NASA + IA) and approved the
  spec "as written"; remaining §11 defaults (file_path relative-to-root, two
  `python -m` CLIs, `index_by_id` in hef.catalog) taken as accepted.