Eve library
ISIS v2 FLAC Output Schema and Metadata Contract
Guide
Revision 1
On this page
Generated: 2026-03-06T09:01:42.930Z Checklist: MXD-0033 (ISIS2-01223) Format:
flac (audio/flac) Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)
Objective#
Define a canonical schema and metadata contract for FLAC outputs with
metadata-block validation, cue-sheet and picture safeguards, deterministic
integrity metadata, and workflow provenance suitable for mastered music, voice,
and SFX renders.
Canonical Schema#
Schema ID: isis.v2.output.flac.package
Schema Version: 1.0.0
Binary signature: 66 4C 61 43
Required top-level fields:
schemaVersion
format
durationSeconds
sampleRateHz
bitDepth
channelCount
channelLayout
compressionLevel
artifactRole
integratedLufs
truePeakDbtp
md5Signature
metadataBlockInventory
hasCueSheet
hasPicture
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#
STREAMINFO metadata block is mandatory for every FLAC output.
FLAC metadataBlockInventory values must be unique.
channelCount must match the declared FLAC channelLayout.
FLAC outputs with hasCueSheet require CUESHEET metadata block coverage.
FLAC outputs with hasPicture require PICTURE metadata block coverage.
Audio-master FLAC outputs require integratedLufs at or below -6 LUFS.
RegisterOutputRequest duration must match flacPackage.durationSeconds when
supplied.
RegisterOutputRequest mimeType must be audio/flac, type must be audio, and
storage.key must end with .flac when flacPackage is supplied.
FLAC 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-flac-output-schema-metadata-contract.mjs
Acceptance Criteria#
Output registry accepts first-class FLAC package metadata with strict
validation over metadata-block inventory, channel layout, cue-sheet signaling,
picture signaling, loudness metadata, and manifest checksum fields.
Canonical FLAC contract enumerates the package classes and output classes that
legitimately emit FLAC artifacts under the shared output taxonomy.
FLAC manifest provenance preserves workflow-variant and dependency-manifest
linkage needed for deterministic downstream ingest of mastered lossless audio
renders.
Validator and schema tests catch invalid FLAC registrations and enforce the
canonical metadata surface.
Traceability#
Checklist item: MXD-0033
Ticket key: ISIS2-01223
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