# ISIS v2 WAV Output Schema and Metadata Contract

Generated: 2026-03-06T08:56:12.384Z Checklist: `MXD-0029` (ISIS2-01219) Format:
`wav` (audio/wav) Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Define a canonical schema and metadata contract for WAV outputs with RIFF chunk
validation, broadcast-wave and cue-sheet safeguards, deterministic integrity
metadata, and workflow provenance suitable for mastered dialogue, SFX, and music
renders.

## Canonical Schema

- Schema ID: `isis.v2.output.wav.package`
- Schema Version: `1.0.0`
- Binary signature: `52 49 46 46 / 57 41 56 45`
- Required top-level fields:
  - `schemaVersion`
  - `format`
  - `durationSeconds`
  - `sampleRateHz`
  - `bitDepth`
  - `channelCount`
  - `channelLayout`
  - `audioCodec`
  - `artifactRole`
  - `integratedLufs`
  - `truePeakDbtp`
  - `chunkInventory`
  - `broadcastWave`
  - `cueSheetEmbedded`
  - `manifest`
- Manifest fields:
  - `filename`
  - `mimeType`
  - `checksumAlgorithm`
  - `checksum`
  - `generatedAt`
  - `provenance`
- Provenance fields:
  - `assetFamilyId`
  - `workflowId`
  - `workflowVariant`
  - `promptFingerprint`
  - `seed`
  - `modelId`
  - `dependencyManifestRef`

## Supported Package Classes

| Package Class  | Storage Tier | Required Artifacts                     |
| -------------- | ------------ | -------------------------------------- |
| `audio-master` | HOT          | `masters/audio-master.{wav,flac,aiff}` |

## Supported Output Classes

| Output Class   | Package Classes |
| -------------- | --------------- |
| `audio_master` | `audio-master`  |

## Applicable Asset Families

| Asset Family      | Output Classes | Naming Rules |
| ----------------- | -------------- | ------------ |
| `audio-sfx-pack`  | `audio_master` | `FN-001`     |
| `music-cue-pack`  | `audio_master` | `FN-001`     |
| `voice-line-pack` | `audio_master` | `FN-001`     |

## Validation Invariants

- RIFF, WAVE, fmt , and data chunks are mandatory for every WAV output.
- WAV chunkInventory values must be unique.
- channelCount must match the declared WAV channelLayout.
- bitDepth must match the declared WAV audioCodec.
- Broadcast WAV outputs require bext chunk coverage.
- WAV outputs with cueSheetEmbedded require cue chunk coverage.
- Audio-master WAV outputs require integratedLufs at or below -6 LUFS.
- RegisterOutputRequest duration must match wavPackage.durationSeconds when
  supplied.
- RegisterOutputRequest mimeType must be audio/wav, type must be audio, and
  storage.key must end with .wav when wavPackage is supplied.
- WAV manifest checksum uses sha256 and must preserve workflow/dependency
  provenance linkage.

## Verification Commands

- `pnpm --filter @isis/output-registry exec vitest run src/schemas/output.schema.spec.ts`
- `node scripts/isis/validate-v2-wav-output-schema-metadata-contract.mjs`

## Acceptance Criteria

- Output registry accepts first-class WAV package metadata with strict
  validation over RIFF chunk inventory, channel layout and codec alignment,
  broadcast-wave signaling, cue-sheet signaling, loudness metadata, and manifest
  checksum fields.
- Canonical WAV contract enumerates the package classes and output classes that
  legitimately emit WAV artifacts under the shared output taxonomy.
- WAV manifest provenance preserves workflow-variant and dependency-manifest
  linkage needed for deterministic downstream ingest of mastered audio renders.
- Validator and schema tests catch invalid WAV registrations and enforce the
  canonical metadata surface.

## Traceability

- Checklist item: `MXD-0029`
- Ticket key: `ISIS2-01219`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json`
  - `apps/isis/output-registry/src/schemas/output.schema.ts`
  - `apps/isis/output-registry/src/schemas/output.schema.spec.ts`
  - `apps/isis/output-registry/src/services/output.service.ts`
  - `apps/isis/output-registry/src/types.ts`
  - `docs/domains/isis/remediation-v2/ISIS_V2_AUDIO_SFX_PACK_OUTPUT_PACKAGE_CONTRACT.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_OUTPUT_PACKAGE_CONTRACT.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_VOICE_LINE_PACK_OUTPUT_PACKAGE_CONTRACT.json`
  - `ISIS_TODOS_2.md`
