3.0 KiB
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:
- Per-archive ingest fetchers — Internet Archive/Prelinger, Musopen, LibriVox, NASA, Free Music Archive, Freesound.
- Mechanical tagging —
mode(ffprobe streams),license/attribution/source_*(from origin),duration_s,resolution,dominant_color(computed from video). - Assistant coordinate-drafting — propose
left/right/dark/light+ one-linerationale, writereview_status: proposed. - Review CLI — walk proposed records (coords + rationale + preview frame),
accept/correct, flip to
approved, stampreviewed_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. Empty if none.