suaveplan/openspec/archive/2026-05-19-add-audio-ir-core/tasks.md

Tasks — Add @suaveplan/audio-ir-core

Every checkbox MUST reflect work actually done in this change. No retroactive ticking.

1. Spec authoring

• 1.1 Read openspec/AGENTS.md §§ 13, 14, 14a, 2c, 6a, 193
• 1.2 proposal.md (this change) — including ## Impact per §14a
• 1.3 design.md — cross-cutting model for the IR family (referenced by every sibling change)
• 1.4 specs/audio-ir-core/spec.md — every requirement carries **Verified by:**
• 1.5 Working-notes checklist enumerates every ### Requirement and #### Scenario

2. Package scaffold

• 2.1 mkdir -p packages/audio-ir/audio-ir-core/src/{types,registry,otel,error-codes}
• 2.2 package.json — version: 0.0.0, sideEffects: false, deps @suaveplan/{error,types,opentelemetry}, zod, tslib
• 2.3 tsconfig.lib.json, vite.config.ts, biome.json
• 2.4 Subpath exports: ., ./types, ./registry, ./error-codes
• 2.5 README.md linking every .md under ## Modules

3. Implementation

• 3.1 src/types/manifest-entry.ts + .md + Zod schema + frozen invariant
• 3.2 src/types/manifest.ts + .md + Zod schema with id-prefix & family refinements
• 3.3 src/types/impulse-response.ts + .md + Zod schema (used by audio-ir-loader)
• 3.4 src/error-codes/error-codes.ts + .md — defineCodes("AUDIO_IR", [...])
• 3.5 src/registry/registry.ts + .md — createIrRegistry, all five methods
• 3.6 src/registry/register-manifest.ts + .md — registerManifest helper
• 3.7 src/otel/otel.ts + .md — tracer, counters, observable gauge
• 3.8 src/index.ts — explicit named re-exports (rule 10)

4. Tests

• 4.1 src/types/manifest-entry.test.ts — Zod parsing + freeze invariant
• 4.2 src/types/manifest.test.ts — manifest-level refinements
• 4.3 src/registry/registry.test.ts — every scenario from registry requirement
• 4.4 src/registry/registry.spec-conformance.test.ts — strict-mode + insertion-order invariants
• 4.5 src/registry/register-manifest.test.ts — well-formed + partial-failure paths
• 4.6 src/otel/otel.test.ts — real in-memory MeterProvider
• 4.7 src/error-codes/error-codes.test.ts — exhaustion
• 4.8 Every it(...) carries { timeout: 5000 } (or 30000 for async)

5. Documentation

• 5.1 Sibling .md for every .ts (≥200 words, basic + advanced examples)
• 5.2 README ## Modules section
• 5.3 Update root CLAUDE.md Packages section — add new "Audio IR" subsection

6. Pre-archive verification (5-gate triple)

• 6.1 bun run check — 0/0/0/0
• 6.2 bunx turbo lint typecheck test --filter=@suaveplan/audio-ir-core — green
• 6.3 bunx turbo test:coverage --filter=@suaveplan/audio-ir-core — 100/100/100/100
• 6.4 bun scripts/openspec-conformance.ts @suaveplan/audio-ir-core — exit 0
• 6.5 bunx turbo build --filter=@suaveplan/audio-ir-core — green

7. Pre-archive 7-row checklist (AGENTS §13)

• 7.1 Generics threaded; expectTypeOf assertions on literal-type claims
• 7.2 Zod schemas wired at every boundary
• 7.3 Every AUDIO_IR_CODES code thrown by at least one production path
• 7.4 Strict-mode behaviors tested both on and off
• 7.5 OTel instruments asserted with real in-memory MeterProvider
• 7.6 Lifecycle dedup tested (registry idempotency, freeze invariant)
• 7.7 No retroactive tick

8. Archive

• 8.1 Fold delta into new openspec/specs/audio-ir-core/spec.md
• 8.2 Move folder to openspec/archive/<yyyy-mm-dd>-add-audio-ir-core/
• 8.3 Refresh MANIFEST.md