Eve library
ISIS v2 MP4 Output Schema and Metadata Contract
Guide
Revision 1
On this page
Generated: 2026-03-06T08:37:01.798Z Checklist: MXD-0021 (ISIS2-01211) Format:
mp4 (video/mp4) Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)
Objective#
Define a canonical schema and metadata contract for MP4 outputs with ISO BMFF
box-level validation, deterministic integrity metadata, and workflow provenance
suitable for preview renders, turntables, social cutdowns, and
distribution-grade video masters.
Canonical Schema#
Schema ID: isis.v2.output.mp4.package
Schema Version: 1.0.0
Binary signature: 66 74 79 70
Required top-level fields:
schemaVersion
format
width
height
durationSeconds
frameCount
frameRate
videoCodec
videoProfile
pixelFormat
colorSpace
artifactRole
majorBrand
compatibleBrands
boxInventory
moovPlacement
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
preview
HOT
preview/hero-preview.{png,jpg,webp,mp4}, preview/thumbnail.{png,jpg,webp}
video-master
HOT
masters/video-master.{mp4,mov,mxf}
Supported Output Classes#
Output Class
Package Classes
preview_image
preview
video_master
video-master, preview
Applicable Asset Families#
Asset Family
Output Classes
Naming Rules
animatic-shot-set
n/a
n/a
architecture-kitbash-pack
n/a
n/a
audio-sfx-pack
n/a
n/a
character-concept-art
n/a
n/a
character-costume-variant-pack
n/a
n/a
character-expression-sheet
n/a
n/a
character-prop-interaction-sheet
n/a
n/a
character-turnaround-sheet
n/a
n/a
cinematic-shot-sequence
video_master
FN-001
creature-concept-art
n/a
n/a
decal-pack
n/a
n/a
environment-concept-art
n/a
n/a
environment-matte-painting
n/a
n/a
environment-tileset-pack
n/a
n/a
foliage-pack
n/a
n/a
hud-element-pack
n/a
n/a
interior-scene-pack
n/a
n/a
marketing-key-art-pack
n/a
n/a
material-pbr-pack
n/a
n/a
music-cue-pack
n/a
n/a
npc-crowd-variation-pack
n/a
n/a
prop-pack-general
n/a
n/a
sky-atmosphere-pack
n/a
n/a
social-cutdown-pack
n/a
n/a
storyboard-frame-set
n/a
n/a
terrain-heightmap-pack
n/a
n/a
ui-icon-pack
n/a
n/a
vehicle-exterior-pack
n/a
n/a
vehicle-interior-pack
n/a
n/a
vfx-element-pack
n/a
n/a
voice-line-pack
n/a
n/a
weapon-pack
n/a
n/a
Validation Invariants#
ftyp, moov, mdat, mvhd, trak, mdia, hdlr, minf, stbl, stsd, stts, stsc, stsz,
and stco boxes are mandatory for every MP4 output.
MP4 boxInventory values must be unique.
compatibleBrands must include the declared majorBrand.
10-bit MP4 pixel formats require h265 or av1 videoCodec and videoProfile
main10.
AV1 MP4 outputs must declare av01 in compatibleBrands.
h265 MP4 outputs must declare hvc1 in compatibleBrands.
RegisterOutputRequest dimensions, duration, and frameCount must match
mp4Package metadata when supplied.
RegisterOutputRequest mimeType must be video/mp4 and storage.key must end with
.mp4 when mp4Package is supplied.
MP4 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-mp4-output-schema-metadata-contract.mjs
Acceptance Criteria#
Output registry accepts first-class MP4 package metadata with strict
validation over ISO BMFF box inventory, container brands, codec/profile
compatibility, timing fields, and manifest checksum fields.
Canonical MP4 contract enumerates the package classes and output classes that
legitimately emit MP4 artifacts under the shared output taxonomy.
MP4 manifest provenance preserves workflow-variant and dependency-manifest
linkage needed for deterministic downstream ingest of preview renders and
video masters.
Validator and schema tests catch invalid MP4 registrations and enforce the
canonical metadata surface.
Traceability#
Checklist item: MXD-0021
Ticket key: ISIS2-01211
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_ANIMATIC_SHOT_SET_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_ARCHITECTURE_KITBASH_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_AUDIO_SFX_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_CHARACTER_CONCEPT_ART_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_CHARACTER_COSTUME_VARIANT_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_CHARACTER_EXPRESSION_SHEET_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_CHARACTER_PROP_INTERACTION_SHEET_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_CHARACTER_TURNAROUND_SHEET_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_CINEMATIC_SHOT_SEQUENCE_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_CREATURE_CONCEPT_ART_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_DECAL_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_ENVIRONMENT_CONCEPT_ART_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_ENVIRONMENT_MATTE_PAINTING_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_ENVIRONMENT_TILESET_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_HUD_ELEMENT_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_INTERIOR_SCENE_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_MARKETING_KEY_ART_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_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_NPC_CROWD_VARIATION_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_PROP_PACK_GENERAL_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_SOCIAL_CUTDOWN_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_STORYBOARD_FRAME_SET_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_UI_ICON_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_VEHICLE_EXTERIOR_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_VEHICLE_INTERIOR_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_VFX_ELEMENT_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_VOICE_LINE_PACK_OUTPUT_PACKAGE_CONTRACT.json
docs/domains/isis/remediation-v2/ISIS_V2_WEAPON_PACK_OUTPUT_PACKAGE_CONTRACT.json
ISIS_TODOS_2.md