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