Eve library

ISIS v2 WAV Output Schema and Metadata Contract

Guide

Revision 1

On this page

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