# ISIS v2 Weapon Pack Side-by-Side Comparison Tools

Generated: 2026-03-01T06:58:12.380Z Checklist: `MXA-0246` (ISIS2-00444) Asset
Family: `weapon-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Deliver side-by-side comparison tools specialized for weapon-pack outputs with
profile-aware workflow filtering, recommended dimension presets, and weapon
class/style/era/faction/use/scale/material/silhouette/grip/attachment/condition/safety/view/lighting/palette/emblem/continuity/control/reference/focal-length/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`

## Weapon-Specific Metrics

- `Weapon Pack Family Match`: present
- `Workflow Variant Alignment`: present
- `Weapon Class Match`: present
- `Manufacturer Style Match`: present
- `Era Technology Match`: present
- `Faction Alignment Match`: present
- `Intended Use Match`: present
- `Scale Class Match`: present
- `Material Stack Match`: present
- `Silhouette Profile Match`: present
- `Grip Configuration Match`: present
- `Attachment Profile Match`: present
- `Condition Grade Match`: present
- `Safety State Match`: present
- `Render View Set Match`: present
- `Lighting Setup Match`: present
- `Color Palette Profile Match`: present
- `Emblem Policy Match`: present
- `Style Preset Match`: present
- `Scene Profile Match`: present
- `Style Profile Match`: present
- `Continuity Profile Match`: present
- `Continuity Revision Match`: present
- `Continuity Locked Dimensions Match`: present
- `Control Toggle Alignment`: present
- `Control Strength Alignment`: present
- `Reference Toggle Alignment`: present
- `Reference Strength Alignment`: present
- `Style Lock Alignment`: present
- `Continuity Lock Strength Alignment`: present
- `Focal Length 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     |
| weapon-pack-comparison-utils  | `isWeaponPackOutput`                            | yes     |
| weapon-pack-comparison-utils  | `buildWeaponPackComparisonContext`              | yes     |
| weapon-pack-comparison-utils  | `resolveWeaponPackComparisonProfileFromOutputs` | yes     |
| weapon-pack-comparison-utils  | `buildWeaponPackConsistencyReport`              | 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/weapon-pack-comparison-utils.spec.ts src/pages/output-consistency-utils.spec.ts src/pages/OutputComparisonWorkspacePage.spec.tsx`
- `pnpm nx build @isis/web`

## Acceptance Criteria

- Comparison workspace supports explicit weapon-pack profile selection with
  query-string persistence and auto-detect fallback.
- Weapon-pack profile exposes recommended comparison dimensions and narrows
  selectable outputs to weapon-pack candidates.
- Weapon-pack side-by-side report adds weapon-family and weapon contract
  alignment metrics
  (class/style/era/faction/use/material/grip/attachment/continuity/control/reference/focal-length/seed)
  in addition to base consistency metrics.
- Web tests validate weapon profile URL state, specialized metric rendering,
  mismatch guarding, and preset dimension behavior.

## Traceability

- Checklist item: `MXA-0246`
- Ticket key: `ISIS2-00444`
- Source TODO: `ISIS_TODOS_2.md`

## References

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_WEAPON_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_WEAPON_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/weapon-pack-comparison-utils.ts`
- `apps/isis/web/src/pages/weapon-pack-comparison-utils.spec.ts`
- `ISIS_TODOS_2.md`
