Commit Graph

59 Commits

Author SHA1 Message Date
Ben Stull 6d6cbb5cad plan: sub-project 2 — ingest & tagging / review tools
Task-by-task TDD plan implementing the approved sub-project-2 spec: tools/
scaffolding, the additive hef.catalog change (validate_catalog/index_by_id),
ffprobe/ffmpeg mechanical tagging with cover-art guard, per-archive license
normalization, heuristic coordinate drafting, the ingest pipeline + first-ship
fetchers (LibriVox/NASA/Internet Archive, others deferred stubs), the review
transition core + interactive CLI, and hermetic + opt-in integration tests.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-04 06:14:28 -07:00
Ben Stull dd02c2c36a docs: revise design + roadmap for single pano projector
Operator decision (2026-06-04): single panoramic projector spanning the
three walls showing the real selected video (nature-video focus), replacing
four projectors + a procedural side-wall renderer.

- Design spec: revision banner; updated §1, §6 (one pano projector), §7
  (procedural side walls REMOVED), §10 layout, §12 open questions.
- ROADMAP: sub-project 5 marked Dropped; diagram + dependency order updated;
  §3 player drives one pano output; cross-cutting decisions reconciled.
- Sub-project-2 spec: follow-up note updated to past tense (design spec done).

dominant_color's only consumer was the side walls, so it stays optional/opt-in
in the sub-project-2 tooling (already specced).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-04 06:12:09 -07:00
Ben Stull b5f5ee6663 docs: link the sub-project 2 spec from ROADMAP
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-04 06:07:32 -07:00
Ben Stull 4c1ec6e02e spec: fold in operator approval + pano-projector design change
Operator approved the spec and confirmed first-ship archives
(LibriVox + NASA + IA). Folds in the 2026-06-04 design change (single
panoramic projector across all three walls, nature-video content):
demotes dominant_color to optional/opt-in (its only consumer was the
procedural side walls), ffmpeg-only when computed, never an image lib.
Flags the design-spec/ROADMAP follow-up as out of scope here.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-04 06:06:45 -07:00
Ben Stull f80ec65553 spec: sub-project 2 — ingest & tagging / review tools
Develops the draft-then-review pipeline spec (design §5/§8, ROADMAP §2):
per-archive fetchers, mechanical tagging (ffprobe mode/duration/resolution,
ffmpeg dominant_color, origin license/attribution), heuristic coordinate
drafting (review_status=proposed + one-line rationale), and the review CLI
(walk proposed -> approve + reviewed_at).

Builds on hef.catalog additively: schema unchanged (Record defaults already
match the proposed shape); the only required core addition is a catalog-level
validate_catalog (unique-id integrity), with optional index_by_id.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-04 05:45:37 -07:00
Ben Stull 7f0e92d130 docs: roadmap for the five sub-projects (catalog core done, tools next)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-04 01:51:35 -07:00
Ben Stull 8c8291a94a docs: user guide for configuring media (hand-authoring + validating the catalog)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-04 01:48:14 -07:00
Ben Stull f15fe739ee docs: implementation plan for catalog+selection core (sub-project 1/5)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-04 01:31:10 -07:00
Ben Stull 46e5d8e475 docs: human-experience-filter design spec
Single-viewer four-wall projection installation. Coordinate model
(content mode + brain plane + mood plane), nearest-match selection from a
tagged JSONL catalog, Arduino-controller/Pi-player hardware split,
procedural side walls, public-domain sourcing strategy, lean-to-dense
sizing.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-04 01:22:01 -07:00