# ISIS v2 Social Cutdown Pack Web UI Controls and Validation

Generated: 2026-08-02T19:14:05.637Z Checklist: `MXA-0515` (ISIS2-00713) Asset
Family: `social-cutdown-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27
to 2026-10-30)

## Objective

Expose social-cutdown-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 |
| ----------------------------------------- | ------- |
| `social-cutdown-pack-baseline`            | yes     |
| `social-cutdown-pack-image-conditioned`   | yes     |
| `social-cutdown-pack-control-conditioned` | yes     |
| `social-cutdown-pack-consistency-locked`  | yes     |

## Ergonomic Controls

- `Campaign ID (required)`: present
- `Source Asset ID (required)`: present
- `Narrative Goal (required)`: present
- `Platform Target (required)`: present
- `Aspect Ratio (required)`: present
- `Hook Window Seconds (required)`: present
- `Cutdown Duration Seconds (required)`: present
- `Caption Safe Area (required)`: present
- `Style Preset (required)`: present
- `Brand Palette (required)`: present
- `Audio Sync Profile (required)`: present
- `Prompt Template ID`: present
- `Style Profile ID`: present
- `Lens Profile`: present
- `Seed (required)`: present
- `Width (required)`: present
- `Height (required)`: present
- `Steps (required)`: present
- `CFG Scale (required)`: present
- `Negative Prompt`: present
- `Color Script (required)`: present
- `Style Reference Image (required)`: present
- `Use Composition Reference`: present
- `Composition Reference Image`: present
- `Use Face Reference`: present
- `Face Reference Image`: present
- `Reference Strength`: present
- `Composition Strength`: present
- `Face Strength`: present
- `Control Emphasis Profile (required)`: present
- `Overlay Constraints (required)`: present
- `Use Pose Control`: present
- `Pose Map`: present
- `Pose Strength`: present
- `Use Depth Control`: present
- `Depth Map`: present
- `Depth Strength`: present
- `Use Segmentation Control`: present
- `Segmentation Map`: present
- `Segmentation Strength`: present
- `Use Normal Control`: present
- `Normal Map`: present
- `Normal Strength`: present
- `Use Canny Control`: present
- `Edge Map`: present
- `Canny Strength`: present
- `Use Lineart Control`: present
- `Lineart Map`: present
- `Lineart Strength`: present
- `Use Mask Region Guide`: present
- `Mask Region Map`: present
- `Mask Guide Strength`: present
- `Control Blend Precedence`: present
- `Control Blend Conflict Policy`: present
- `Control Blend ControlNet Scale`: present
- `Control Blend IPAdapter Scale`: present
- `Control Blend InstantID Scale`: present
- `Control Blend ControlNet Schedule Start`: present
- `Control Blend ControlNet Schedule End`: present
- `Control Blend ControlNet Schedule Curve`: present
- `Control Blend IPAdapter Schedule Start`: present
- `Control Blend IPAdapter Schedule End`: present
- `Control Blend IPAdapter Schedule Curve`: present
- `Control Blend InstantID Schedule Start`: present
- `Control Blend InstantID Schedule End`: present
- `Control Blend InstantID Schedule Curve`: present
- `Continuity Profile ID`: present
- `Continuity Profile Revision`: present
- `Continuity Locked Dimensions`: present
- `Continuity Notes (required)`: present
- `Identity Profile ID (required)`: present
- `Identity Reference Image (required)`: present
- `Use Identity Reference`: present
- `Use Wardrobe Reference`: present
- `Wardrobe Reference Map`: present
- `Use Environment Reference`: present
- `Environment Reference Map`: present
- `Use Lighting Reference`: present
- `Lighting Reference Frame`: present
- `Use Style Lock`: present
- `Focal Length (mm) (required)`: present
- `Identity Lock Strength`: present
- `Wardrobe Lock Strength`: present
- `Environment Lock Strength`: present
- `Lighting Lock Strength`: present
- `Style Lock Strength`: present

## Validation Rules

- present: Social cutdown pack workflows require generation type text-to-image.
- present: Campaign ID is required.
- present: Source Asset ID is required.
- present: Narrative Goal is required.
- present: Narrative Goal must be at least 5 characters.
- present: Platform Target is required.
- present: Aspect Ratio is required.
- present: Caption Safe Area is required.
- present: Style Preset is required.
- present: Brand Palette is required.
- present: Audio Sync Profile is required.
- present: Color Script is required.
- present: Style Reference Image is required.
- present: Prompt Template ID is required.
- present: Style Profile ID is required.
- present: Lens Profile is required.
- present: Composition Reference Image is required when composition reference is
  enabled.
- present: Face Reference Image is required when face reference is enabled.
- present: Control Emphasis Profile is required.
- present: Overlay Constraints is required.
- present: At least one control must be enabled for control-conditioned
  workflows.
- 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: Normal Map is required when normal control is enabled.
- present: Edge Map is required when canny control is enabled.
- present: Lineart Map is required when lineart control is enabled.
- present: Mask Region Map is required when mask region guide is enabled.
- present: Control Blend Precedence entries must be unique.
- present: Control Blend ControlNet Scale must be between 0 and 2.
- present: Control Blend IPAdapter Scale must be between 0 and 2.
- present: Control Blend InstantID Scale must be between 0 and 2.
- present: Control Blend ControlNet schedule start must be less than or equal to
  end.
- present: Control Blend IPAdapter schedule start must be less than or equal to
  end.
- present: Control Blend InstantID schedule start must be less than or equal to
  end.
- present: Continuity Profile ID is required.
- present: Continuity Locked Dimensions must contain at least one value.
- present: Continuity Notes is required.
- present: Identity Profile ID is required.
- present: Identity Reference Image is required.
- present: Identity Reference Image is required when identity reference is
  enabled.
- present: Wardrobe Reference Map is required when wardrobe reference is
  enabled.
- present: Environment Reference Map is required when environment reference is
  enabled.
- present: Lighting Reference Frame is required when lighting reference is
  enabled.

## Verification Commands

- `pnpm --filter @isis/web exec vitest run src/pages/social-cutdown-pack-ui-utils.spec.ts`
- `pnpm --filter @isis/web exec vitest run src/pages/WorkflowDetailsPage.spec.tsx -t "social cutdown pack"`
- `pnpm --filter @isis/web exec playwright test e2e/normal-control-family-parity.spec.ts`
- `pnpm --filter @isis/web exec vitest run src/pages/workflow-run-utils.spec.ts`

## Acceptance Criteria

- Workflow details page renders ergonomic variant-specific social-cutdown-pack
  controls for all four workflow IDs.
- Web UI validation enforces typed contract constraints (generation type lock,
  required fields, control toggles, and conditional map/reference 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-0515`
- Ticket key: `ISIS2-00713`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_SOCIAL_CUTDOWN_PACK_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_SOCIAL_CUTDOWN_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/WorkflowControlBlendPanel.tsx`
  - `apps/isis/web/src/pages/social-cutdown-pack-ui-utils.ts`
  - `apps/isis/web/src/pages/social-cutdown-pack-ui-utils.spec.ts`
  - `apps/isis/web/src/pages/workflow-control-blend-ui-utils.ts`
  - `apps/isis/web/src/pages/workflow-run-utils.ts`
  - `ISIS_TODOS_2.md`
