# ISIS v2 Music Cue Pack Image-Conditioned Workflow Graph

Generated: 2026-03-03T16:20:15.978Z Checklist: `MXA-0561` (ISIS2-00759) Asset
Family: `music-cue-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Define an image-conditioned music-cue-pack workflow graph that satisfies the
image-conditioned ticket lane through provider-capable reference-audio guidance
while preserving deterministic cue-composition defaults and mastered-audio
delivery contracts.

## Deterministic Defaults

| Setting                  | Value                                 |
| ------------------------ | ------------------------------------- |
| `modelName`              | `ace_step_multilingual.safetensors`   |
| `promptTemplateId`       | `music-cue-pack-image-conditioned-v1` |
| `styleProfileId`         | `music-cue-pack-style-anchor-v1`      |
| `seed`                   | `2026073104`                          |
| `durationSeconds`        | `20`                                  |
| `tempoBpm`               | `96`                                  |
| `conditioningStrength`   | `0.7`                                 |
| `conditioningMode`       | `reference-audio`                     |
| `providerCapabilityMode` | `required`                            |
| `referenceMixStrategy`   | `weighted-blend`                      |
| `maxReferenceCount`      | `4`                                   |
| `preservePromptIntent`   | `true`                                |
| `sampleRateHz`           | `48000`                               |
| `targetLufs`             | `-14`                                 |
| `outputFormat`           | `wav`                                 |
| `outputChannels`         | `2`                                   |
| `outputBitDepth`         | `24`                                  |

## Input Contract

| Input                      | Type    | Required | Default                                                                                                                    |
| -------------------------- | ------- | -------- | -------------------------------------------------------------------------------------------------------------------------- |
| `cue_id`                   | string  | yes      | `"MUSIC_CUE_M3_IMAGE_CONDITIONED_01"`                                                                                      |
| `prompt`                   | string  | yes      | `"Heroic ascent cue with rhythmic ostinato, evolving strings, and resolved brass cadence."`                                |
| `cue_purpose`              | enum    | yes      | `"character_theme"`                                                                                                        |
| `mood`                     | enum    | yes      | `"heroic"`                                                                                                                 |
| `instrumentation`          | enum    | yes      | `"hybrid_orchestral"`                                                                                                      |
| `tempo_bpm`                | integer | yes      | `96`                                                                                                                       |
| `duration_seconds`         | integer | yes      | `20`                                                                                                                       |
| `key_signature`            | enum    | yes      | `"D_minor"`                                                                                                                |
| `time_signature`           | enum    | yes      | `"4/4"`                                                                                                                    |
| `audio_prompt_hint`        | string  | no       | `"Preserve motif contour and orchestration arc from references while respecting cue purpose timing."`                      |
| `reference_audio_url`      | string  | yes      | `"asset://references/audio/music-cue-style-anchor-001.wav"`                                                                |
| `reference_audio_urls`     | array   | no       | `["asset://references/audio/music-cue-rhythm-anchor-002.wav","asset://references/audio/music-cue-harmony-anchor-003.wav"]` |
| `style_reference_id`       | string  | no       | `"MUSIC_CUE_STYLE_ANCHOR_V1"`                                                                                              |
| `conditioning_strength`    | float   | yes      | `0.7`                                                                                                                      |
| `conditioning_mode`        | enum    | yes      | `"reference-audio"`                                                                                                        |
| `provider_capability_mode` | enum    | yes      | `"required"`                                                                                                               |
| `reference_mix_strategy`   | enum    | yes      | `"weighted-blend"`                                                                                                         |
| `preserve_prompt_intent`   | boolean | yes      | `true`                                                                                                                     |
| `prompt_template_id`       | string  | yes      | `"music-cue-pack-image-conditioned-v1"`                                                                                    |
| `style_profile_id`         | string  | yes      | `"music-cue-pack-style-anchor-v1"`                                                                                         |
| `sample_rate_hz`           | integer | yes      | `48000`                                                                                                                    |
| `target_lufs`              | float   | yes      | `-14`                                                                                                                      |
| `output_format`            | enum    | yes      | `"wav"`                                                                                                                    |
| `model_name`               | string  | yes      | `"ace_step_multilingual.safetensors"`                                                                                      |
| `seed`                     | integer | yes      | `2026073104`                                                                                                               |

## Graph Nodes

| Node ID | Class                       | Role                     | Output Count |
| ------- | --------------------------- | ------------------------ | ------------ |
| `n1`    | `LoadAudio`                 | primary-reference-load   | 1            |
| `n2`    | `LoadAudio`                 | secondary-reference-load | 1            |
| `n3`    | `ACEStepPromptBuilder`      | prompt-construction      | 1            |
| `n4`    | `ACEModelLoader`            | model-load               | 1            |
| `n5`    | `AudioReferenceConditioner` | reference-conditioning   | 2            |
| `n6`    | `ACEStepAudioGenerator`     | audio-generation         | 1            |
| `n7`    | `AudioLoudnessNormalize`    | audio-post               | 1            |
| `n8`    | `SaveAudio`                 | artifact-output          | 0            |

## Graph Edges

| Edge ID | From   | To                          |
| ------- | ------ | --------------------------- |
| `e1`    | `n1:0` | `n5.primary_reference`      |
| `e2`    | `n2:0` | `n5.secondary_references`   |
| `e3`    | `n3:0` | `n5.prompt`                 |
| `e4`    | `n5:0` | `n6.conditioned_prompt`     |
| `e5`    | `n5:1` | `n6.reference_conditioning` |
| `e6`    | `n4:0` | `n6.model`                  |
| `e7`    | `n6:0` | `n7.audio`                  |
| `e8`    | `n7:0` | `n8.audio`                  |

## Topological Node Order

`n1` -> `n2` -> `n3` -> `n4` -> `n5` -> `n6` -> `n7` -> `n8`

## Research Alignment

| Workflow                    | Path                                                                       | Reference Conditioning Support | Conditioning Input Keys                                                                                                 | Node Classes                                                                                                        |
| --------------------------- | -------------------------------------------------------------------------- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| SFX Sound Designer          | `libs/isis/workflows/src/workflows/audio/sfx-sound-designer.json`          | yes                            | `reference_audio_url`, `reference_audio_urls`, `conditioning_strength`, `conditioning_mode`, `provider_capability_mode` | `AudioLoudnessNormalize`, `SaveAudio`, `StableAudioNode`, `StableAudioOpenModelLoader`, `StableAudioPromptComposer` |
| Music Cue Composer          | `libs/isis/workflows/src/workflows/audio/music-cue-composer.json`          | yes                            | `reference_audio_url`, `reference_audio_urls`, `conditioning_strength`, `conditioning_mode`, `provider_capability_mode` | `ACEModelLoader`, `ACEStepAudioGenerator`, `ACEStepPromptBuilder`, `AudioLimiter`, `SaveAudio`                      |
| Voice Performance Synthesis | `libs/isis/workflows/src/workflows/audio/voice-performance-synthesis.json` | yes                            | `reference_audio_url`, `reference_audio_urls`, `conditioning_strength`, `conditioning_mode`, `provider_capability_mode` | `AudioDeesser`, `KokoroModelLoader`, `KokoroPromptBuilder`, `KokoroTextToSpeech`, `SaveAudio`                       |

## Acceptance Criteria

- Graph is acyclic and topologically sortable.
- Reference conditioning path is explicit and includes required primary
  reference audio and optional multi-reference stack.
- Deterministic defaults are explicitly locked (seed, model, prompt template,
  style profile, conditioning mode/provider mode, loudness, and export format).
- Output contract aligns to MXA-0559 required output classes for music-cue-pack.

## Traceability

- Checklist item: `MXA-0561`
- Ticket key: `ISIS2-00759`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_BASELINE_WORKFLOW_GRAPH.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_WORKFLOW_AUTHORING_GUIDE.json`
  - `libs/isis/workflows/src/workflows/audio/sfx-sound-designer.json`
  - `libs/isis/workflows/src/workflows/audio/music-cue-composer.json`
  - `libs/isis/workflows/src/workflows/audio/voice-performance-synthesis.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_AUDIO_CONDITIONING_SUPPORT.md`
  - `docs/domains/isis/remediation-v2/ISIS_V2_CONTROL_TAXONOMY.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json`
  - `ISIS_TODOS_2.md`
