# ISIS v2 Interior Scene Pack Web UI Controls and Validation

Generated At: 2026-02-28T18:00:43.401Z Report Date: 2026-02-28 Checklist:
MXA-0209 Ticket: ISIS2-00407

## Asset Family

Family: `interior-scene-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27
to 2026-10-30) Owner Team: @oshun/creative-tech Priority: P1 | Severity: medium

## Objective

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

Route Path: `/workflows/:workflowId`

## Typed Workflow IDs

- `interior-scene-pack-baseline`
- `interior-scene-pack-consistency-locked`
- `interior-scene-pack-control-conditioned`
- `interior-scene-pack-image-conditioned`

## Ergonomic Controls

| Control Label                             | Present in WorkflowDetailsPage |
| ----------------------------------------- | ------------------------------ |
| `Scene Program (required)`                | yes                            |
| `Design Style (required)`                 | yes                            |
| `Era Influence (required)`                | yes                            |
| `Room Scale (required)`                   | yes                            |
| `Occupancy State (required)`              | yes                            |
| `Circulation Pattern (required)`          | yes                            |
| `Camera Framing (required)`               | yes                            |
| `Lens Profile (required)`                 | yes                            |
| `Furniture Density (required)`            | yes                            |
| `Prop Narrative Theme (required)`         | yes                            |
| `Material Stack (required)`               | yes                            |
| `Floor Finish (required)`                 | yes                            |
| `Wall Finish (required)`                  | yes                            |
| `Lighting Rig (required)`                 | yes                            |
| `Spatial Depth Profile (required)`        | yes                            |
| `Color Palette Profile (required)`        | yes                            |
| `Clutter Budget (required)`               | yes                            |
| `Seed (required)`                         | yes                            |
| `Width (required)`                        | yes                            |
| `Height (required)`                       | yes                            |
| `Steps (required)`                        | yes                            |
| `CFG Scale (required)`                    | yes                            |
| `Negative Prompt`                         | yes                            |
| `Style Reference Image (required)`        | yes                            |
| `Use Composition Reference`               | yes                            |
| `Composition Reference Image`             | yes                            |
| `Reference Strength`                      | yes                            |
| `Composition Strength`                    | yes                            |
| `Look Treatment Preset (required)`        | yes                            |
| `Use Depth Control`                       | yes                            |
| `Depth Map`                               | yes                            |
| `Depth Strength`                          | yes                            |
| `Use Segmentation Control`                | yes                            |
| `Segmentation Map`                        | yes                            |
| `Segmentation Strength`                   | yes                            |
| `Use Canny Control`                       | yes                            |
| `Canny Map`                               | yes                            |
| `Canny Strength`                          | yes                            |
| `Continuity Profile ID`                   | yes                            |
| `Continuity Profile Revision`             | yes                            |
| `Continuity Locked Dimensions`            | yes                            |
| `Scene Profile ID (required)`             | yes                            |
| `Style Profile ID (required)`             | yes                            |
| `Scene Anchor Reference Image (required)` | yes                            |
| `Use Scene Anchor Reference`              | yes                            |
| `Use Layout Reference`                    | yes                            |
| `Layout Reference Map`                    | yes                            |
| `Use Lighting Reference`                  | yes                            |
| `Lighting Reference Frame`                | yes                            |
| `Use Lens Reference`                      | yes                            |
| `Lens Reference Frame`                    | yes                            |
| `Focal Length mm (required)`              | yes                            |
| `Use Style Lock`                          | yes                            |
| `Scene Anchor Lock Strength`              | yes                            |
| `Layout Lock Strength`                    | yes                            |
| `Lighting Lock Strength`                  | yes                            |
| `Lens Lock Strength`                      | yes                            |
| `Style Lock Strength`                     | yes                            |

## Validation Rules

| Validation Rule                                                                  | Present in UI Utils |
| -------------------------------------------------------------------------------- | ------------------- |
| `Interior scene pack workflows require generation type text-to-image.`           | yes                 |
| `Scene Program is required.`                                                     | yes                 |
| `Design Style is required.`                                                      | yes                 |
| `Era Influence is required.`                                                     | yes                 |
| `Room Scale is required.`                                                        | yes                 |
| `Occupancy State is required.`                                                   | yes                 |
| `Circulation Pattern is required.`                                               | yes                 |
| `Camera Framing is required.`                                                    | yes                 |
| `Lens Profile is required.`                                                      | yes                 |
| `Furniture Density is required.`                                                 | yes                 |
| `Prop Narrative Theme is required.`                                              | yes                 |
| `Material Stack is required.`                                                    | yes                 |
| `Floor Finish is required.`                                                      | yes                 |
| `Wall Finish is required.`                                                       | yes                 |
| `Lighting Rig is required.`                                                      | yes                 |
| `Spatial Depth Profile is required.`                                             | yes                 |
| `Color Palette Profile is required.`                                             | yes                 |
| `Clutter Budget is required.`                                                    | yes                 |
| `Style Reference Image is required.`                                             | yes                 |
| `Look Treatment Preset is required.`                                             | yes                 |
| `Composition Reference Image is required when composition reference is enabled.` | yes                 |
| `At least one control must be enabled for control-conditioned workflows.`        | yes                 |
| `Depth Map is required when depth control is enabled.`                           | yes                 |
| `Segmentation Map is required when segmentation control is enabled.`             | yes                 |
| `Canny Map is required when canny control is enabled.`                           | yes                 |
| `Continuity Profile ID must be scene-continuity-profile.`                        | yes                 |
| `Continuity Locked Dimensions is required.`                                      | yes                 |
| `Scene Profile ID is required.`                                                  | yes                 |
| `Style Profile ID is required.`                                                  | yes                 |
| `Scene Anchor Reference Image is required.`                                      | yes                 |
| `Layout Reference Map is required when layout reference is enabled.`             | yes                 |
| `Lighting Reference Frame is required when lighting reference is enabled.`       | yes                 |
| `Lens Reference Frame is required when lens reference is enabled.`               | yes                 |

## Implementation Surface

### WorkflowDetailsPage Methods

- `renderInteriorScenePackRunForm`: present
- `runWorkflow`: present

### UI Utils Methods

- `resolveInteriorScenePackWorkflowId`: present
- `createInitialInteriorScenePackRunFormValues`: present
- `validateInteriorScenePackRunFormValues`: present
- `buildInteriorScenePackRunParameters`: present

### Run Payload Integration

- `workflowRunMutationIncludesGenerationType`: true
- `workflowRunMutationIncludesTypeAlias`: true
- `fallbackDetectionPresent`: true
- `workflowRunUtilsPreserved`: true

## Verification Commands

- `pnpm --filter @isis/web exec vitest run src/pages/interior-scene-pack-ui-utils.spec.ts src/pages/WorkflowDetailsPage.spec.tsx src/pages/workflow-run-utils.spec.ts`
- `pnpm --filter @isis/web exec tsc -p tsconfig.json --noEmit`
- `pnpm --filter @isis/web run build`

## Acceptance Criteria

- Workflow details page renders ergonomic variant-specific interior-scene-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.

## References

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_INTERIOR_SCENE_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_INTERIOR_SCENE_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/interior-scene-pack-ui-utils.ts`
- `apps/isis/web/src/pages/interior-scene-pack-ui-utils.spec.ts`
- `apps/isis/web/src/pages/workflow-run-utils.ts`
- `ISIS_TODOS_2.md`

## Summary

- typedWorkflowIdCount: 4
- requiredWorkflowIdCount: 4
- ergonomicControlCount: 58
- validationRuleCount: 33
- verificationCommandCount: 3
- acceptanceCriteriaCount: 4
- webUiSpecAssertions: 66
