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

Metadata Manifest Schema#

  • 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