suaveplan/openspec/archive/2026-04-19-enterprise-metadata/tasks.md

Tasks: enterprise-metadata

1. Scaffold

• 1.1 universal/data/metadata/; 100/100/100/100; guard tests; CLAUDE/README/FOLDERS.

2. Errors + schemas

• 2.1 src/errors/metadata-error.ts — codes.
• 2.2 Zod schemas for Track, AudioMetadata.

3. Format parsers

• 3.1 src/parsers/id3v2/*.
• 3.2 src/parsers/id3v1/*.
• 3.3 src/parsers/mp4-atom/* (iTunes ilst).
• 3.4 src/parsers/flac-vorbis/*.
• 3.5 src/parsers/ogg-vorbis/*.
• 3.6 src/parsers/wav-riff/*.
• 3.7 src/parsers/aiff-id3/*.
• 3.8 Fixture tests per format with real files.

4. Extractor façade

• 4.1 src/metadata-extractor.ts — MetadataExtractor singleton; runtime-agnostic fetch adapter (Node: undici, browser: fetch).
• 4.2 OTel histogram + counter.

5. Docs / barrel / subpath exports / README

6. Benchmarks

• 6.1 extract.bench.ts on MP3 / M4A / FLAC 5 MB fixtures.

7. Ship gate

• 7.1 Verification sequence; fold + archive.