Initial Commit

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

@@ -0,0 +1,71 @@
+# 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`