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