# Isis Cinematic Shot Sequence Web UI Controls Validation Runbook

Last Updated: 2026-03-02  
Scope: `MXA-0479` web UI exposure for `cinematic-shot-sequence` workflows with
ergonomic controls and deterministic validation.

## Purpose

Generate and validate the canonical web UI remediation artifact for
`cinematic-shot-sequence`, confirming workflow details page control coverage,
typed validation behavior, and run payload integration.

## Artifacts

- `docs/domains/isis/remediation-v2/ISIS_V2_CINEMATIC_SHOT_SEQUENCE_WEB_UI_CONTROLS_VALIDATION.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_CINEMATIC_SHOT_SEQUENCE_WEB_UI_CONTROLS_VALIDATION.md`

## Generator

```bash
node scripts/isis/generate-v2-cinematic-shot-sequence-web-ui-controls-validation.mjs
```

Options:

- `--report-date=YYYY-MM-DD` (default: current UTC date)

## Validator

```bash
node scripts/isis/validate-v2-cinematic-shot-sequence-web-ui-controls-validation.mjs
```

## Source Inputs

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_CINEMATIC_SHOT_SEQUENCE_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_CINEMATIC_SHOT_SEQUENCE_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/cinematic-shot-sequence-ui-utils.ts`
- `apps/isis/web/src/pages/cinematic-shot-sequence-ui-utils.spec.ts`
- `apps/isis/web/src/pages/workflow-run-utils.ts`

## Operational Cadence

1. Regenerate whenever cinematic-shot-sequence workflow controls, defaults, or
   validation rules change in web UI.
2. Validate before closing web/SDK parity tasks (`MXA-0479`, `MXA-0480`) and
   before operator documentation reconciliation.
3. Keep web validation aligned with SDK/API typed contracts from `MXA-0477` and
   `MXA-0478`.

## Related Artifacts

- `apps/isis/web/src/pages/cinematic-shot-sequence-ui-utils.ts`
- `apps/isis/web/src/pages/WorkflowDetailsPage.tsx`
- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_BACKLOG.md`
