# ISIS v2 Sky Atmosphere Pack Web UI Controls and Validation

Generated: 2026-03-06T11:41:30.629Z Checklist: `MXA-0407` (ISIS2-00605) Asset
Family: `sky-atmosphere-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27
to 2026-10-30)

## Objective

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

## Ergonomic Controls

- `Sky Style Profile (required)`: present
- `Biome Context (required)`: present
- `Time Of Day (required)`: present
- `Weather System (required)`: present
- `Cloud Coverage Profile (required)`: present
- `Cloud Formation Profile (required)`: present
- `Atmospheric Scattering Profile (required)`: present
- `Horizon Visibility Profile (required)`: present
- `Celestial Body Profile (required)`: present
- `Volumetric Fog Profile (required)`: present
- `Panorama Projection (required)`: present
- `Sky Resolution Class (required)`: present
- `Color Palette Profile (required)`: present
- `Seed (required)`: present
- `Width (required)`: present
- `Height (required)`: present
- `Steps (required)`: present
- `CFG Scale (required)`: present
- `Negative Prompt`: present
- `Style Reference Image (required)`: present
- `Use Composition Reference`: present
- `Composition Reference Image`: present
- `Reference Strength`: present
- `Composition Strength`: present
- `Horizon Anchor Profile (required)`: present
- `Cloud Detail Profile (required)`: present
- `Prompt Template ID (required)`: present
- `Style Profile ID (required)`: present
- `Color Script (required)`: present
- `Lens Profile (required)`: 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
- `Continuity Profile ID`: present
- `Continuity Profile Revision`: present
- `Continuity Locked Dimensions`: present
- `Scene Profile ID (required)`: present
- `Scene Anchor Reference Image (required)`: present
- `Use Scene Anchor Reference`: present
- `Use Horizon Layout Reference`: present
- `Horizon Layout Reference Map`: present
- `Use Cloud Density Reference`: present
- `Cloud Density Reference Map`: present
- `Use Lens Reference`: present
- `Lens Reference Frame`: present
- `Weather Transition Profile (required)`: present
- `Focal Length mm (required)`: present
- `Use Style Lock`: present
- `Scene Anchor Lock Strength`: present
- `Horizon Layout Lock Strength`: present
- `Cloud Density Lock Strength`: present
- `Lens Lock Strength`: present
- `Style Lock Strength`: present

## Validation Rules

- present: Sky atmosphere pack workflows require generation type text-to-image.
- present: Sky Style Profile is required.
- present: Biome Context is required.
- present: Time Of Day is required.
- present: Weather System is required.
- present: Cloud Coverage Profile is required.
- present: Cloud Formation Profile is required.
- present: Atmospheric Scattering Profile is required.
- present: Horizon Visibility Profile is required.
- present: Celestial Body Profile is required.
- present: Volumetric Fog Profile is required.
- present: Panorama Projection is required.
- present: Sky Resolution Class is required.
- present: Color Palette Profile is required.
- present: Style Reference Image is required.
- present: Horizon Anchor Profile is required.
- present: Cloud Detail Profile is required.
- present: Prompt Template ID is required.
- present: Style Profile ID is required.
- present: Color Script is required.
- present: Lens Profile is required.
- present: Composition Reference Image is required when composition reference is
  enabled.
- present: At least one control must be enabled for control-conditioned
  workflows.
- 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: Continuity Profile ID must be scene-continuity-profile.
- present: Continuity Locked Dimensions is required.
- present: Scene Profile ID is required.
- present: Scene Anchor Reference Image is required.
- present: Weather Transition Profile is required.
- present: Horizon Layout Reference Map is required when horizon layout
  reference is enabled.
- present: Cloud Density Reference Map is required when cloud density reference
  is enabled.
- present: Lens Reference Frame is required when lens reference is enabled.

## Verification Commands

- `pnpm --filter @isis/web exec vitest run src/pages/sky-atmosphere-pack-ui-utils.spec.ts src/pages/WorkflowDetailsPage.spec.tsx -t "sky atmosphere pack"`
- `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 sky-atmosphere-pack
  controls for all four workflow IDs.
- Web UI validation enforces typed contract constraints for shared sky fields,
  image-conditioning references, control toggles/maps, and consistency-lock
  references.
- Workflow run dispatch includes explicit generationType/type fields for typed
  API contract alignment.
- Web UI tests cover ergonomic form rendering, validation failures, and
  successful workflow run payload dispatch.

## Traceability

- Checklist item: `MXA-0407`
- Ticket key: `ISIS2-00605`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_PACK_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_SKY_ATMOSPHERE_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/sky-atmosphere-pack-ui-utils.ts`
  - `apps/isis/web/src/pages/sky-atmosphere-pack-ui-utils.spec.ts`
  - `apps/isis/web/src/pages/workflow-run-utils.ts`
  - `ISIS_TODOS_2.md`
