human-experience-filter-art/sessions/0001/SESSION-0001.0-TRANSCRIPT-2026-06-04T05-36--INPROGRESS.md

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