# ISIS v2 Cinematic Shot Sequence Side-by-Side Comparison Tools

Generated: 2026-08-02T19:12:19.413Z Checklist: `MXA-0480` (ISIS2-00678) Asset
Family: `cinematic-shot-sequence` Phase: Phase 4 | Milestone: M3 Launch
(2026-07-27 to 2026-10-30)

## Objective

Deliver side-by-side comparison tools specialized for cinematic-shot-sequence
outputs with profile-aware workflow filtering, recommended dimension presets,
and
sequence/scene/goal/camera/style/continuity/control/reference/lock/lens/aspect-ratio/duration/frame-rate/resolution/sampler/seed
scoring layered over generic style/identity 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`
- `storyboard-frame-set`
- `cinematic-shot-sequence`
- `vfx-element-pack`

## Cinematic Shot Sequence Side-by-Side Metrics

- `Cinematic Shot Sequence Family Match`: present
- `Workflow Variant Alignment`: present
- `Sequence ID Match`: present
- `Scene Description Similarity`: present
- `Shot Goal Similarity`: present
- `Camera Setup Match`: present
- `Camera Motion Match`: present
- `Style Preset Match`: present
- `Continuity Notes Similarity`: present
- `Prompt Template Match`: present
- `Style Profile Anchor Match`: present
- `Scene Profile Match`: present
- `Lens Profile Match`: present
- `Continuity Profile Match`: present
- `Continuity Revision Match`: present
- `Continuity Dimensions Match`: present
- `Control Toggle Alignment`: present
- `Control Strength Alignment`: present
- `Reference Toggle Alignment`: present
- `Reference Strength Alignment`: present
- `Style Lock Alignment`: present
- `Lock Strength Alignment`: present
- `Lens mm Alignment`: present
- `Aspect Ratio Match`: present
- `Duration Alignment`: present
- `Frame Rate Alignment`: present
- `Resolution Alignment`: present
- `Sampler 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     |
| cinematic-shot-sequence-comparison-utils | `isCinematicShotSequenceOutput`                            | yes     |
| cinematic-shot-sequence-comparison-utils | `buildCinematicShotSequenceComparisonContext`              | yes     |
| cinematic-shot-sequence-comparison-utils | `resolveCinematicShotSequenceComparisonProfileFromOutputs` | yes     |
| cinematic-shot-sequence-comparison-utils | `buildCinematicShotSequenceConsistencyReport`              | 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/cinematic-shot-sequence-comparison-utils.spec.ts src/pages/output-consistency-utils.spec.ts`
- `pnpm --filter @isis/web exec vitest run src/pages/OutputComparisonWorkspacePage.spec.tsx -t "cinematic-shot-sequence"`

## Acceptance Criteria

- Comparison workspace supports explicit cinematic-shot-sequence profile
  selection with query-string persistence and auto-detect fallback.
- Cinematic-shot-sequence profile exposes recommended comparison dimensions and
  narrows selectable outputs to cinematic-shot-sequence candidates.
- Cinematic-shot-sequence side-by-side report adds cinematic family and
  cinematic
  metadata/control/reference/continuity/lock/lens/aspect-ratio/duration/frame-rate/resolution/sampler/seed
  alignment metrics in addition to base consistency metrics.
- Web tests validate cinematic profile URL state, specialized metric rendering,
  mismatch guarding, and preset dimension behavior.

## Traceability

- Checklist item: `MXA-0480`
- Ticket key: `ISIS2-00678`
- Source TODO: `ISIS_TODOS_2.md`

## References

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_CINEMATIC_SHOT_SEQUENCE_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_CINEMATIC_SHOT_SEQUENCE_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/cinematic-shot-sequence-comparison-utils.ts`
- `apps/isis/web/src/pages/cinematic-shot-sequence-comparison-utils.spec.ts`
- `ISIS_TODOS_2.md`
