Eve library
ISIS v2 Material PBR Pack Output Package Contract
Guide
Revision 1
On this page
Generated: 2026-08-02T16:03:34.548Z Checklist: MXA-0331 (ISIS2-00529) Asset
Family: material-pbr-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)
Objective#
Define a canonical output package contract for material-pbr-pack workflows with
deterministic material-parameter-aware file naming, variant-level material
specification artifacts, and metadata provenance requirements for reproducible
downstream ingest and shader-pipeline review.
Output Class Contracts#
Output Class
Package Classes
Naming Rules
preview_image
preview, metadata, manifest
FN-001
source_frames
source-frames, metadata, manifest
FN-002
metadata_manifest
metadata, manifest
FN-003, FN-004
File Naming Rules#
Rule ID
Applies To
Template
FN-001
preview_image
preview/{asset_family}/{workflow_variant}/{run_date}/{job_id}/{asset_family}_{workflow_variant}_{material_category}_{material_subtype}_{surface_age_profile}_{tileability_mode}_{texture_resolution_tier}_{seed}_{revision}_preview.{png,jpg,webp}
FN-002
source_frames
frames/{asset_family}/{workflow_variant}/{run_date}/{job_id}/{asset_family}_{workflow_variant}_{material_category}_{material_subtype}_{surface_age_profile}_{tileability_mode}_{texture_resolution_tier}_{seed}_{revision}_frame_{frame_index:06d}.{png,exr,tiff}
FN-003
metadata_manifest
metadata/{asset_family}/{workflow_variant}/{run_date}/{job_id}/{asset_family}_{workflow_variant}_{job_id}_manifest.json
FN-004
metadata_manifest
manifest/{asset_family}/{workflow_variant}/{run_date}/{job_id}/checksums.sha256
Package Class Contracts#
Package Class
Storage Tier
Required Artifacts
manifest
WARM
manifest/package-manifest.json, manifest/checksums.sha256
metadata
WARM
metadata/generation-metadata.json, metadata/provenance.json
preview
HOT
preview/hero-preview.{png,jpg,webp,mp4}, preview/thumbnail.{png,jpg,webp}
source-frames
WARM
frames/frame_%06d.{png,exr,tiff}, frames/frame-index.json
Variant Packaging Overrides#
Variant
Workflow ID
Filename Prefixes
Continuity Manifest
baseline
material-pbr-pack-baseline
material_pbr_pack_baseline
not-required
image-conditioned
material-pbr-pack-image-conditioned
material_pbr_pack_image_conditioned
not-required
control-conditioned
material-pbr-pack-control-conditioned
material_pbr_pack_control_conditioned
not-required
consistency-locked
material-pbr-pack-consistency-locked
material_pbr_pack_consistency_locked, material_pbr_pack_consistency_locked_manifest
required
Required top-level fields:
manifestVersion
assetFamilyId
workflowVariant
workflowId
jobId
generatedAt
runDate
seed
dimensions
outputClasses
artifacts
checksums
provenance
dependencyManifestRef
Required artifact entry fields:
artifactId
outputClass
packageClass
relativePath
mimeType
bytes
sha256
storageTier
Required provenance fields:
modelDependenciesDigest
nodeClassDependenciesDigest
promptFingerprint
controlSnapshot
materialCategory
materialSubtype
surfaceAgeProfile
albedoPaletteProfile
roughnessProfile
metallicProfile
normalIntensityProfile
microdetailProfile
macroPatternScale
tileabilityMode
uvRepeatTarget
displacementIntent
renderLightingContext
textureResolutionTier
channelPackProfile
seamSuppressionProfile
materialFinishPreset
styleProfileId
checkpointId
promptTemplateId
platformTarget
renderIntent
colorScript
lensProfile
continuityProfileId
Acceptance Criteria#
Output class contracts map each required output class to package classes and
deterministic naming rules.
All variant overrides include mandatory metadata + checksum artifacts and
preserve workflow-specific filename prefixes.
Metadata manifest schema requires material-specific provenance and
dependency-manifest linkage fields for reproducibility.
Package profile and class requirements remain synchronized with output package
taxonomy source of truth.
Traceability#
Checklist item: MXA-0331
Ticket key: ISIS2-00529
Source references:
docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_REQUIREMENTS_BRIEF.json
docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json
docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_MODEL_NODE_DEPENDENCY_MANIFEST.json
docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_BASELINE_WORKFLOW_GRAPH.json
docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_IMAGE_CONDITIONED_WORKFLOW_GRAPH.json
docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_CONTROL_CONDITIONED_WORKFLOW_GRAPH.json
docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_CONSISTENCY_LOCKED_WORKFLOW_GRAPH.json
docs/domains/isis/remediation-v2/ISIS_V2_ACCEPTANCE_CRITERIA.md
ISIS_TODOS_2.md