Eve library
ISIS v2 EXR Output Schema and Metadata Contract
Guide
Revision 1
On this page
Generated: 2026-03-06T08:19:22.516Z Checklist: MXD-0013 (ISIS2-01203) Format:
exr (image/x-exr) Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)
Objective#
Define a canonical schema and metadata contract for OpenEXR outputs with
channel-level validation, tiled/scanline storage safeguards, deterministic
integrity metadata, and workflow provenance suitable for HDR source frames and
texture interchange.
Canonical Schema#
Schema ID: isis.v2.output.exr.package
Schema Version: 1.0.0
Binary signature: 76 2F 31 01
Required top-level fields:
schemaVersion
format
width
height
channelLayout
channels
compression
storageMode
lineOrder
colorSpace
artifactRole
multipart
deepData
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
source-frames
WARM
frames/frame_%06d.{png,exr,tiff}, frames/frame-index.json
texture-set
WARM
textures/albedo.{png,tiff,exr}, textures/normal.{png,tiff,exr}, textures/roughness.{png,tiff,exr}
Supported Output Classes#
Output Class
Package Classes
image_sequence
source-frames
source_frames
source-frames
sprite_sheet
source-frames
texture_set
texture-set
Applicable Asset Families#
Asset Family
Output Classes
Naming Rules
animatic-shot-set
source_frames
FN-002
architecture-kitbash-pack
source_frames
FN-002
character-concept-art
source_frames
FN-002
character-costume-variant-pack
source_frames
FN-002
character-expression-sheet
source_frames
FN-002
character-prop-interaction-sheet
source_frames
FN-002
character-turnaround-sheet
source_frames
FN-002
cinematic-shot-sequence
source_frames
FN-002
creature-concept-art
source_frames
FN-002
decal-pack
source_frames
FN-002
environment-concept-art
source_frames
FN-002
environment-matte-painting
source_frames
FN-002
environment-tileset-pack
source_frames
FN-002
foliage-pack
source_frames
FN-002
hud-element-pack
source_frames
FN-002
interior-scene-pack
source_frames
FN-002
marketing-key-art-pack
source_frames
FN-002
material-pbr-pack
source_frames
FN-002
npc-crowd-variation-pack
source_frames
FN-002
prop-pack-general
source_frames
FN-002
sky-atmosphere-pack
source_frames
FN-002
social-cutdown-pack
source_frames
FN-002
storyboard-frame-set
source_frames
FN-002
terrain-heightmap-pack
source_frames
FN-002
ui-icon-pack
source_frames
FN-002
vehicle-exterior-pack
source_frames
FN-002
vehicle-interior-pack
source_frames
FN-002
vfx-element-pack
source_frames
FN-002
weapon-pack
source_frames
FN-002
Validation Invariants#
EXR channel names must be unique for every output package.
Multipart EXR outputs require partCount; single-part EXR outputs must omit
partCount.
Tiled EXR outputs require tileDescription, while scanline outputs must not
supply tileDescription.
deepData must exactly match whether channelLayout is deep.
rgb, rgba, y, and ya layouts require their canonical channel sets; deep
layouts require at least one depth- or alpha-oriented deep channel.
dataWindow extents must resolve to the declared width and height when
dataWindow is present.
RegisterOutputRequest dimensions must match exrPackage width and height when
both are supplied.
RegisterOutputRequest mimeType must be image/x-exr and storage.key must end
with .exr when exrPackage is supplied.
EXR 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-exr-output-schema-metadata-contract.mjs
Acceptance Criteria#
Output registry accepts first-class EXR package metadata with strict
validation over channel inventory, tiled/scanline storage, deep data
signaling, and manifest checksum fields.
Canonical EXR contract enumerates the package classes and output classes that
legitimately emit EXR artifacts under the shared output taxonomy.
EXR manifest provenance preserves workflow-variant and dependency-manifest
linkage needed for deterministic downstream ingest of HDR frames and texture
maps.
Validator and schema tests catch invalid EXR registrations and enforce the
canonical metadata surface.
Traceability#
Checklist item: MXD-0013
Ticket key: ISIS2-01203
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_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_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_WEAPON_PACK_OUTPUT_PACKAGE_CONTRACT.json
ISIS_TODOS_2.md