# ISIS v2 Voice Line Pack Output Package Contract

Generated: 2026-03-03T12:19:29.076Z Checklist: `MXA-0547` (ISIS2-00745) Asset
Family: `voice-line-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Define a canonical output package contract for voice-line-pack workflows with
deterministic dialogue-master naming, variant-aware metadata/manifest artifacts,
and provenance requirements for reproducible downstream ingest.

## Output Class Contracts

| Output Class        | Package Classes                        | Naming Rules       |
| ------------------- | -------------------------------------- | ------------------ |
| `audio_master`      | `audio-master`, `metadata`, `manifest` | `FN-001`           |
| `metadata_manifest` | `metadata`, `manifest`                 | `FN-002`, `FN-003` |
| `project_archive`   | `archive`, `metadata`, `manifest`      | `FN-004`           |

## File Naming Rules

| Rule ID  | Applies To          | Template                                                                                                                                                                                                                                                                              |
| -------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `FN-001` | `audio_master`      | `masters/{asset_family}/{workflow_variant}/{run_date}/{speaker_id}/{language_locale}/{job_id}/{asset_family}_{workflow_variant}_{cue_id}_{speaker_id}_{language_locale}_{emotion}_{duration_seconds}s_{style_profile_id}_{sample_rate_hz}hz_{seed}_{revision}_master.{wav,flac,aiff}` |
| `FN-002` | `metadata_manifest` | `metadata/{asset_family}/{workflow_variant}/{run_date}/{job_id}/{asset_family}_{workflow_variant}_{cue_id}_{job_id}_manifest.json`                                                                                                                                                    |
| `FN-003` | `metadata_manifest` | `manifest/{asset_family}/{workflow_variant}/{run_date}/{job_id}/checksums.sha256`                                                                                                                                                                                                     |
| `FN-004` | `project_archive`   | `archive/{asset_family}/{workflow_variant}/{run_date}/{job_id}/{asset_family}_{workflow_variant}_{cue_id}_{job_id}_archive.{zip,tar,tar.gz}`                                                                                                                                          |

## Package Class Contracts

| Package Class  | Storage Tier | Required Artifacts                                                            |
| -------------- | ------------ | ----------------------------------------------------------------------------- |
| `archive`      | COLD         | `archive/package-archive.{zip,tar,tar.gz}`                                    |
| `audio-master` | HOT          | `masters/audio-master.{wav,flac,aiff}`                                        |
| `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}` |

## Variant Packaging Overrides

| Variant               | Workflow ID                           | Filename Prefixes                                                                                                                 | Continuity Manifest |
| --------------------- | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ------------------- |
| `baseline`            | `voice-line-pack-baseline`            | `voice_line_pack_baseline`                                                                                                        | not-required        |
| `image-conditioned`   | `voice-line-pack-image-conditioned`   | `voice_line_pack_image_conditioned`                                                                                               | not-required        |
| `control-conditioned` | `voice-line-pack-control-conditioned` | `voice_line_pack_control_conditioned`                                                                                             | not-required        |
| `consistency-locked`  | `voice-line-pack-consistency-locked`  | `voice_line_pack_consistency_locked`, `voice_line_pack_consistency_locked_manifest`, `voice_line_pack_consistency_locked_archive` | required            |

## Metadata Manifest Schema

- Required top-level fields:
  - `manifestVersion`
  - `assetFamilyId`
  - `workflowVariant`
  - `workflowId`
  - `cueId`
  - `speakerId`
  - `languageLocale`
  - `emotion`
  - `durationSeconds`
  - `speakingRate`
  - `voiceStability`
  - `jobId`
  - `generatedAt`
  - `runDate`
  - `seed`
  - `sampleRateHz`
  - `targetLufs`
  - `outputClasses`
  - `artifacts`
  - `checksums`
  - `provenance`
  - `dependencyManifestRef`
- Required artifact entry fields:
  - `artifactId`
  - `outputClass`
  - `packageClass`
  - `relativePath`
  - `mimeType`
  - `bytes`
  - `sha256`
  - `storageTier`
- Required provenance fields:
  - `modelDependenciesDigest`
  - `nodeClassDependenciesDigest`
  - `promptFingerprint`
  - `conditioningSnapshot`
  - `cueId`
  - `speakerId`
  - `languageLocale`
  - `emotion`
  - `durationSeconds`
  - `speakingRate`
  - `pitchShiftSemitones`
  - `voiceStability`
  - `targetLufs`
  - `sampleRateHz`
  - `outputFormat`
  - `promptTemplateId`
  - `styleProfileId`
  - `modelName`
  - `referenceAudioDigests`
  - `referenceImageDigests`
  - `controlSignalSnapshot`
  - `voiceConsistencyProfileId`
  - `continuityProfileId`
  - `phonemeAlignmentScore`
  - `intelligibilityScore`
  - `integratedLufsDelta`
  - `prosodyDriftScore`

## 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,
  dialogue mastering artifacts, and preserve workflow-specific filename
  prefixes.
- Metadata manifest schema requires cue-level voice provenance, quality metrics,
  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-0547`
- Ticket key: `ISIS2-00745`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_VOICE_LINE_PACK_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_VOICE_LINE_PACK_MODEL_NODE_DEPENDENCY_MANIFEST.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_VOICE_LINE_PACK_BASELINE_WORKFLOW_GRAPH.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_VOICE_LINE_PACK_IMAGE_CONDITIONED_WORKFLOW_GRAPH.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_VOICE_LINE_PACK_CONTROL_CONDITIONED_WORKFLOW_GRAPH.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_VOICE_LINE_PACK_CONSISTENCY_LOCKED_WORKFLOW_GRAPH.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_ACCEPTANCE_CRITERIA.md`
  - `docs/domains/isis/remediation-v2/ISIS_V2_AUDIO_CONDITIONING_SUPPORT.md`
  - `docs/domains/isis/remediation-v2/ISIS_V2_VOICE_CONSISTENCY_PROFILES.md`
  - `ISIS_TODOS_2.md`
