# ISIS v2 Output Package Taxonomy

Date: 2026-02-23 Scope: WS01-004 canonical required output package taxonomy.

## Purpose

Define mandatory output package classes and profile-level requirements so every
workflow delivers externally consumable, reproducible artifacts.

## Source of Truth

- Machine-readable taxonomy:
  `docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json`
- Validation script: `scripts/isis/validate-v2-output-package-taxonomy.mjs`
- Renderer: `scripts/isis/render-v2-output-package-taxonomy.mjs`

## Required Package Classes

- `preview`
- `source-frames`
- `metadata`
- `manifest`
- `engine-bundle`
- `dcc-bundle`

## Package Class Definitions

| Package Class   | Default Storage Tier | Output File Types                            | Required Artifacts                                                                                |
| --------------- | -------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `preview`       | HOT                  | IMAGE, VIDEO                                 | preview/hero-preview.{png,jpg,webp,mp4}; preview/thumbnail.{png,jpg,webp}                         |
| `source-frames` | WARM                 | IMAGE, ANIMATION, DATA                       | frames/frame\_%06d.{png,exr,tiff}; frames/frame-index.json                                        |
| `metadata`      | WARM                 | DATA, DOCUMENT                               | metadata/generation-metadata.json; metadata/provenance.json                                       |
| `manifest`      | WARM                 | DOCUMENT, DATA                               | manifest/package-manifest.json; manifest/checksums.sha256                                         |
| `engine-bundle` | WARM                 | MODEL_3D, TEXTURE, MATERIAL, DATA, OTHER     | engine-bundle/README.md; engine-bundle/package.json                                               |
| `dcc-bundle`    | WARM                 | MODEL_3D, TEXTURE, MATERIAL, DOCUMENT, OTHER | dcc-bundle/README.md; dcc-bundle/package.json                                                     |
| `video-master`  | HOT                  | VIDEO                                        | masters/video-master.{mp4,mov,mxf}                                                                |
| `audio-master`  | HOT                  | AUDIO, DATA                                  | masters/audio-master.{wav,flac,aiff}                                                              |
| `mesh-package`  | WARM                 | MODEL_3D, DATA                               | mesh/main.{obj,fbx,gltf,glb}; mesh/topology-report.json                                           |
| `texture-set`   | WARM                 | TEXTURE, MATERIAL                            | textures/albedo.{png,tiff,exr}; textures/normal.{png,tiff,exr}; textures/roughness.{png,tiff,exr} |
| `archive`       | COLD                 | DOCUMENT, DATA, OTHER                        | archive/package-archive.{zip,tar,tar.gz}                                                          |

## Asset Output Class Mappings

| Asset Output Class  | Required Package Classes                         |
| ------------------- | ------------------------------------------------ |
| `preview_image`     | preview, metadata, manifest                      |
| `source_frames`     | source-frames, metadata, manifest                |
| `image_sequence`    | source-frames, metadata, manifest                |
| `video_master`      | video-master, preview, metadata, manifest        |
| `audio_master`      | audio-master, metadata, manifest                 |
| `mesh_package`      | mesh-package, metadata, manifest, dcc-bundle     |
| `texture_set`       | texture-set, metadata, manifest, engine-bundle   |
| `sprite_sheet`      | source-frames, metadata, manifest, engine-bundle |
| `engine_bundle`     | engine-bundle, metadata, manifest                |
| `dcc_bundle`        | dcc-bundle, metadata, manifest                   |
| `metadata_manifest` | metadata, manifest                               |
| `project_archive`   | archive, metadata, manifest                      |

## Package Profiles

| Profile                      | Required Classes                                                                  | Optional Classes                    |
| ---------------------------- | --------------------------------------------------------------------------------- | ----------------------------------- |
| `image-single-profile`       | preview, metadata, manifest                                                       | source-frames, archive              |
| `image-sequence-profile`     | preview, source-frames, metadata, manifest                                        | video-master, archive               |
| `video-master-profile`       | preview, source-frames, video-master, metadata, manifest                          | audio-master, archive               |
| `audio-master-profile`       | preview, audio-master, metadata, manifest                                         | source-frames, archive              |
| `game-ready-3d-profile`      | preview, mesh-package, texture-set, engine-bundle, dcc-bundle, metadata, manifest | source-frames, archive              |
| `marketing-campaign-profile` | preview, source-frames, metadata, manifest                                        | video-master, audio-master, archive |

## Governance Rules

1. Every workflow must map to one package profile and inherit its required
   classes.
2. Output registry records must include at least one artifact per required
   package class.
3. Package manifests and metadata are mandatory for all profile types.
4. Engine and DCC bundles are mandatory when outputs target game/DCC
   integrations.

## Traceability

- Checklist item: `WS01-004`
- Related asset taxonomy:
  `docs/domains/isis/remediation-v2/ISIS_V2_ASSET_TAXONOMY.json`
