Eve library
ISIS v2 Foliage Pack Output Package Contract
Guide
Revision 1
On this page
Generated: 2026-03-02T04:53:58.628Z Checklist: MXA-0385 (ISIS2-00583) Asset
Family: foliage-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)
Objective#
Define a canonical output package contract for foliage-pack workflows with
deterministic foliage-parameter-aware file naming, canopy/species continuity
artifacts, and metadata provenance requirements for reproducible downstream
ingest.
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}_{foliage_theme}_{biome_context}_{canopy_structure_profile}_{species_mix_profile}_{seasonality_profile}_{seed}_{revision}_preview.{png,jpg,webp}
FN-002
source_frames
frames/{asset_family}/{workflow_variant}/{run_date}/{job_id}/{asset_family}_{workflow_variant}_{foliage_theme}_{biome_context}_{canopy_structure_profile}_{species_mix_profile}_{seasonality_profile}_{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
foliage-pack-baseline
foliage_pack_baseline
not-required
image-conditioned
foliage-pack-image-conditioned
foliage_pack_image_conditioned
not-required
control-conditioned
foliage-pack-control-conditioned
foliage_pack_control_conditioned
not-required
consistency-locked
foliage-pack-consistency-locked
foliage_pack_consistency_locked, foliage_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
foliageTheme
biomeContext
canopyStructureProfile
speciesMixProfile
groundCoverDensityClass
leafClusterScaleProfile
stemBranchComplexityProfile
windResponseProfile
seasonalityProfile
tilingMode
seamBlendStrategy
foliageResolutionClass
leafSpecularProfile
branchBarkProfile
colorPaletteProfile
colorScript
promptTemplateId
styleProfileId
checkpointId
lensProfile
canopyLayoutReferenceDigest
densityReferenceDigest
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 foliage-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-0385
Ticket key: ISIS2-00583
Source references:
docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_REQUIREMENTS_BRIEF.json
docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json
docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_MODEL_NODE_DEPENDENCY_MANIFEST.json
docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_BASELINE_WORKFLOW_GRAPH.json
docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_IMAGE_CONDITIONED_WORKFLOW_GRAPH.json
docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_CONTROL_CONDITIONED_WORKFLOW_GRAPH.json
docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_CONSISTENCY_LOCKED_WORKFLOW_GRAPH.json
docs/domains/isis/remediation-v2/ISIS_V2_ACCEPTANCE_CRITERIA.md
ISIS_TODOS_2.md