# ISIS v2 Music Cue Pack Side-by-Side Comparison Tools

Generated: 2026-03-03T18:00:53.330Z Checklist: `MXA-0570` (ISIS2-00768) Asset
Family: `music-cue-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Deliver side-by-side comparison tools specialized for music-cue-pack outputs
with profile-aware workflow filtering, recommended dimension presets, and
cue/prompt/purpose/mood/instrumentation/tempo/key/time-signature/duration/sample-rate/lufs/format/conditioning/reference/template/profile/model/control/continuity/motif-lock/alignment/tolerance/seed
scoring layered over generic consistency checks.

## Comparison Profile Modes

- `auto`
- `general`
- `architecture-kitbash-pack`
- `interior-scene-pack`
- `prop-pack-general`
- `environment-tileset-pack`
- `environment-matte-painting`
- `environment-concept-art`
- `creature-concept-art`
- `character-concept-art`
- `character-turnaround-sheet`
- `character-expression-sheet`
- `character-costume-variant-pack`
- `character-prop-interaction-sheet`
- `npc-crowd-variation-pack`
- `weapon-pack`
- `vehicle-exterior-pack`
- `vehicle-interior-pack`
- `ui-icon-pack`
- `hud-element-pack`
- `material-pbr-pack`
- `decal-pack`
- `terrain-heightmap-pack`
- `foliage-pack`
- `sky-atmosphere-pack`
- `animatic-shot-set`
- `cinematic-shot-sequence`
- `marketing-key-art-pack`
- `social-cutdown-pack`
- `audio-sfx-pack`
- `voice-line-pack`
- `music-cue-pack`
- `storyboard-frame-set`
- `vfx-element-pack`

## Music Cue Pack Side-by-Side Metrics

- `Music Cue Pack Family Match`: present
- `Workflow Variant Alignment`: present
- `Cue ID Match`: present
- `Prompt Similarity`: present
- `Cue Purpose Match`: present
- `Mood Match`: present
- `Instrumentation Match`: present
- `Tempo (BPM) Alignment`: present
- `Key Signature Match`: present
- `Time Signature Match`: present
- `Duration Alignment`: present
- `Sample Rate Alignment`: present
- `Target LUFS Alignment`: present
- `Output Format Match`: present
- `Audio Prompt Hint Similarity`: present
- `Conditioning Strength Alignment`: present
- `Reference Audio URL Match`: present
- `Reference Audio URL List Similarity`: present
- `Style Reference ID Match`: present
- `Conditioning Mode Match`: present
- `Provider Capability Mode Match`: present
- `Reference Mix Strategy Match`: present
- `Preserve Prompt Intent Alignment`: present
- `Prompt Template Match`: present
- `Style Profile Match`: present
- `Model Name Match`: present
- `Control Mode Alignment`: present
- `Control Toggle Alignment`: present
- `Control Strength Alignment`: present
- `Control Timeline FPS Alignment`: present
- `Continuity Profile Match`: present
- `Continuity Revision Match`: present
- `Continuity Dimensions Match`: present
- `Continuity Notes Similarity`: present
- `Continuity Window Size Alignment`: present
- `Reference Toggle Alignment`: present
- `Reference URL Alignment`: present
- `Lock Strength Alignment`: present
- `Cue Timing Alignment Target Score Alignment`: present
- `Motif Alignment Target Score Alignment`: present
- `Integrated LUFS Delta Tolerance Alignment`: present
- `Harmonic Drift Tolerance Alignment`: present
- `Seed Alignment`: present

## Implementation Surface

| Group                           | Method/Signal                                     | Present |
| ------------------------------- | ------------------------------------------------- | ------- |
| output-consistency-utils        | `readComparisonWorkspaceStateFromSearch`          | yes     |
| output-consistency-utils        | `buildComparisonWorkspacePath`                    | yes     |
| output-consistency-utils        | `calculateAverageConsistencyScore`                | yes     |
| music-cue-pack-comparison-utils | `isMusicCuePackOutput`                            | yes     |
| music-cue-pack-comparison-utils | `buildMusicCuePackComparisonContext`              | yes     |
| music-cue-pack-comparison-utils | `resolveMusicCuePackComparisonProfileFromOutputs` | yes     |
| music-cue-pack-comparison-utils | `buildMusicCuePackConsistencyReport`              | yes     |
| OutputComparisonWorkspacePage   | `comparisonProfileState`                          | yes     |
| OutputComparisonWorkspacePage   | `profileSelectorRendered`                         | yes     |
| OutputComparisonWorkspacePage   | `profileOptionRendered`                           | yes     |
| OutputComparisonWorkspacePage   | `profilePresetActionRendered`                     | yes     |
| OutputComparisonWorkspacePage   | `profileMismatchGuard`                            | yes     |
| OutputComparisonWorkspacePage   | `profileAwareMetrics`                             | yes     |

## Verification Commands

- `pnpm --filter @isis/web exec vitest run src/pages/music-cue-pack-comparison-utils.spec.ts src/pages/output-consistency-utils.spec.ts`
- `pnpm --filter @isis/web exec vitest run src/pages/OutputComparisonWorkspacePage.spec.tsx -t "music-cue-pack"`

## Acceptance Criteria

- Comparison workspace supports explicit music-cue-pack profile selection with
  query-string persistence and auto-detect fallback.
- Music-cue-pack profile exposes recommended comparison dimensions and narrows
  selectable outputs to music-cue-pack candidates.
- Music-cue-pack side-by-side report adds
  family/workflow/cue/prompt/purpose/mood/instrumentation/tempo/key/time-signature/duration/sample-rate/lufs/format/conditioning/reference/template/profile/model/control/continuity/motif-lock/alignment/tolerance/seed
  metrics in addition to base consistency metrics.
- Web tests validate music-cue profile URL state, specialized metric rendering,
  mismatch guarding, and preset dimension behavior.

## Traceability

- Checklist item: `MXA-0570`
- Ticket key: `ISIS2-00768`
- Source TODO: `ISIS_TODOS_2.md`

## 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_WEB_UI_CONTROLS_VALIDATION.json`
- `apps/isis/web/src/pages/OutputComparisonWorkspacePage.tsx`
- `apps/isis/web/src/pages/OutputComparisonWorkspacePage.spec.tsx`
- `apps/isis/web/src/pages/output-consistency-utils.ts`
- `apps/isis/web/src/pages/output-consistency-utils.spec.ts`
- `apps/isis/web/src/pages/music-cue-pack-comparison-utils.ts`
- `apps/isis/web/src/pages/music-cue-pack-comparison-utils.spec.ts`
- `ISIS_TODOS_2.md`
