# ISIS v2 Material PBR Pack Output Package Contract

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`
