# ISIS v2 Voice Line Pack Side-by-Side Comparison Tools

Generated: 2026-03-03T15:04:51.796Z Checklist: `MXA-0552` (ISIS2-00750) Asset
Family: `voice-line-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Deliver side-by-side comparison tools specialized for voice-line-pack outputs
with profile-aware workflow filtering, recommended dimension presets, and
cue/script/speaker/language/emotion/rate/pitch/duration/stability/sample-rate/lufs/format/conditioning/reference/template/profile/model/control/continuity/voice-lock/alignment/tolerance/pronunciation/style-token/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`
- `voice-line-pack`
- `storyboard-frame-set`
- `vfx-element-pack`

## Voice Line Pack Side-by-Side Metrics

- `Voice Line Pack Family Match`: present
- `Workflow Variant Alignment`: present
- `Cue ID Match`: present
- `Script Text Similarity`: present
- `Speaker ID Match`: present
- `Language Locale Match`: present
- `Emotion Match`: present
- `Speaking Rate Alignment`: present
- `Pitch Shift (Semitones) Alignment`: present
- `Duration Alignment`: present
- `Voice Stability Alignment`: present
- `Sample Rate Alignment`: present
- `Target LUFS Alignment`: present
- `Output Format Match`: present
- `Text Prompt Hint Similarity`: present
- `Conditioning Strength Alignment`: present
- `Reference Image URL Match`: present
- `Reference Image URL List Similarity`: present
- `Speaker Style Reference ID Match`: present
- `Voice Consistency Profile 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
- `Voice Consistency Revision Match`: present
- `Voice Consistency Provider Mode Match`: present
- `Voice ID Match`: present
- `Speaker Embedding Alignment`: present
- `Reference Toggle Alignment`: present
- `Reference URL Alignment`: present
- `Lock Strength Alignment`: present
- `Phoneme Alignment Target Score Alignment`: present
- `Intelligibility Target Score Alignment`: present
- `Integrated LUFS Delta Tolerance Alignment`: present
- `Prosody Drift Tolerance Alignment`: present
- `Pronunciation Resource Alignment`: present
- `Style Tokens 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     |
| voice-line-pack-comparison-utils | `isVoiceLinePackOutput`                            | yes     |
| voice-line-pack-comparison-utils | `buildVoiceLinePackComparisonContext`              | yes     |
| voice-line-pack-comparison-utils | `resolveVoiceLinePackComparisonProfileFromOutputs` | yes     |
| voice-line-pack-comparison-utils | `buildVoiceLinePackConsistencyReport`              | 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/voice-line-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 "voice-line-pack"`

## Acceptance Criteria

- Comparison workspace supports explicit voice-line-pack profile selection with
  query-string persistence and auto-detect fallback.
- Voice-line-pack profile exposes recommended comparison dimensions and narrows
  selectable outputs to voice-line-pack candidates.
- Voice-line-pack side-by-side report adds
  family/workflow/cue/script/speaker/language/emotion/rate/pitch/duration/stability/sample-rate/lufs/format/conditioning/reference/template/profile/model/control/continuity/voice-lock/alignment/tolerance/pronunciation/style-token/seed
  metrics in addition to base consistency metrics.
- Web tests validate voice-line profile URL state, specialized metric rendering,
  mismatch guarding, and preset dimension behavior.

## Traceability

- Checklist item: `MXA-0552`
- Ticket key: `ISIS2-00750`
- Source TODO: `ISIS_TODOS_2.md`

## 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_VOICE_LINE_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/voice-line-pack-comparison-utils.ts`
- `apps/isis/web/src/pages/voice-line-pack-comparison-utils.spec.ts`
- `ISIS_TODOS_2.md`
