[tallnato]

What

Extends the catalog JSON contract (the feed scripts/build.ts emits and the VOLTS app consumes) so the app can show media specs and thumbnails. Touches scripts/build.ts and SCHEMA.md only.

Changes

• schemaVersion — new top-level integer (1) on catalog.json and every <category>.json. Lets the app gate parsing of newer optional fields.
• thumbnailUrl — per item: <baseurl>/content/<category>/<slug>/<thumbnail> (root-relative, same /Volts prefix convention as files[].downloadUrl) when front matter declares thumbnail; otherwise null. The raw thumbnail field is kept as-is.
• specs — per item, best-effort and fully nullable { channels, sampleRate, durationSeconds }:
  • lightshows: .fseq header parse (PSEQ magic; channelCount@10, frameCount@14, stepTime@18) → channels, durationSeconds = frameCount*stepTime/1000.
  • locksounds / hornsounds / boombox / any .wav: RIFF chunk-walk for fmt (sampleRate, channels, bitsPerSample) + data (size) → sampleRate, durationSeconds = dataSize/(sampleRate*channels*bitsPerSample/8).
  • mp3-only: left null (VBR — not worth a header parse).

Robustness

Every parser is wrapped in try/catch and returns null on any failure. The committed fixtures are tiny placeholder stubs (e.g. a 36-byte .fseq) — these parse gracefully (degenerate values / nulls), never throw.

Verification

• npm run build → exit 0; new fields present. Samples:
  • lightshow (stub .fseq): specs: { channels: 0, sampleRate: null, durationSeconds: 0.025 }
  • hornsound (real .wav): specs: { channels: 1, sampleRate: 44100, durationSeconds: 5 }
  • wrap: thumbnailUrl: "/Volts/content/wraps/cybertruck-camo/cybertruck-camo.png"
  • mp3-only: all-null specs
• npm run validate → exit 0 (pre-existing placeholder-stub warnings only).
• Jekyll (Ruby) not run locally — no _config.yml/_layouts/Liquid touched in this unit, so no Jekyll-side change to validate; the PR's build-check CI runs jekyll build.

SCHEMA.md documents schemaVersion, thumbnailUrl, and specs (which categories populate which fields, all best-effort/nullable) and updates the cross-repo invariants.

🤖 Generated with Claude Code