# ISIS v2 Character Costume Variant Pack Web UI Controls and Validation

Generated: 2026-02-26T06:55:31.192Z Checklist: `MXA-0065` (ISIS2-00263) Asset
Family: `character-costume-variant-pack` Phase: Phase 4 | Milestone: M3 Launch
(2026-07-27 to 2026-10-30)

## Objective

Expose character-costume-variant-pack workflows in Isis web UI with ergonomic
variant-specific controls and deterministic validation aligned to API and SDK
typed contracts.

## Workflow Coverage

| Workflow ID                                          | Covered |
| ---------------------------------------------------- | ------- |
| `character-costume-variant-pack-baseline`            | yes     |
| `character-costume-variant-pack-image-conditioned`   | yes     |
| `character-costume-variant-pack-control-conditioned` | yes     |
| `character-costume-variant-pack-consistency-locked`  | yes     |

## Ergonomic Controls

- `Character Archetype (required)`: present
- `Style Preset (required)`: present
- `Base Outfit Profile (required)`: present
- `Variant Theme (required)`: present
- `Material Palette (required)`: present
- `Silhouette Profile (required)`: present
- `Accessory Set (required)`: present
- `Camera Framing (required)`: present
- `Seed (required)`: present
- `Style Reference Image (required)`: present
- `Use Pose Control`: present
- `Pose Map`: present
- `Use Depth Control`: present
- `Depth Map`: present
- `Use Segmentation Control`: present
- `Segmentation Map`: present
- `Continuity Profile ID`: present
- `Identity Reference Image (required)`: present
- `Identity Profile ID (required)`: present
- `Style Profile ID (required)`: present

## Validation Rules

- present: Character costume variant pack workflows require generation type
  text-to-image.
- present: Base Outfit Profile is required.
- present: Variant Theme is required.
- present: Material Palette is required.
- present: Silhouette Profile is required.
- present: Accessory Set is required.
- present: Pose Map is required when pose control is enabled.
- present: Depth Map is required when depth control is enabled.
- present: Segmentation Map is required when segmentation control is enabled.
- present: Style Reference Image is required.
- present: Camera Framing is required.
- present: Identity Reference Image is required.
- present: Identity Profile ID is required.
- present: Style Profile ID is required.

## Verification Commands

- `pnpm --filter @isis/web exec vitest run src/pages/character-costume-variant-pack-ui-utils.spec.ts src/pages/WorkflowDetailsPage.spec.tsx src/pages/workflow-run-utils.spec.ts`
- `pnpm --filter @isis/client exec vitest run src/resources/workflows.character-costume-variant-pack.spec.ts src/examples/character-costume-variant-pack.spec.ts`
- `pnpm nx build @isis/web`

## Acceptance Criteria

- Workflow details page renders ergonomic variant-specific
  character-costume-variant-pack controls for all four workflow IDs.
- Web UI validation enforces typed contract constraints (generation type lock,
  required fields, and conditional map requirements).
- Workflow run dispatch includes explicit generationType/type fields for typed
  API contract alignment.
- Web UI tests cover ergonomic form rendering, validation errors, and successful
  workflow run payload dispatch.

## Traceability

- Checklist item: `MXA-0065`
- Ticket key: `ISIS2-00263`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_CHARACTER_COSTUME_VARIANT_PACK_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_CHARACTER_COSTUME_VARIANT_PACK_SDK_END_TO_END_EXAMPLES.json`
  - `apps/isis/web/src/pages/WorkflowDetailsPage.tsx`
  - `apps/isis/web/src/pages/WorkflowDetailsPage.spec.tsx`
  - `apps/isis/web/src/pages/character-costume-variant-pack-ui-utils.ts`
  - `apps/isis/web/src/pages/character-costume-variant-pack-ui-utils.spec.ts`
  - `apps/isis/web/src/pages/workflow-run-utils.ts`
  - `ISIS_TODOS_2.md`
