# Isis Marketing Key Art Pack Web UI Controls Validation Runbook

Last Updated: 2026-03-03  
Scope: `MXA-0497` web UI exposure for `marketing-key-art-pack` workflows with
ergonomic controls and validation.

## Purpose

Generate and validate the canonical web UI contract artifact for
`marketing-key-art-pack` workflow execution in `WorkflowDetailsPage`, covering
variant-specific form controls, typed validation rules, and route-level run
dispatch alignment.

## Artifacts

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

## Generator

```bash
node scripts/isis/generate-v2-marketing-key-art-pack-web-ui-controls-validation.mjs
```

Options:

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

## Validator

```bash
node scripts/isis/validate-v2-marketing-key-art-pack-web-ui-controls-validation.mjs
```

## Source Inputs

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_MARKETING_KEY_ART_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_MARKETING_KEY_ART_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/marketing-key-art-pack-ui-utils.ts`
- `apps/isis/web/src/pages/marketing-key-art-pack-ui-utils.spec.ts`
- `apps/isis/web/src/pages/workflow-run-utils.ts`

## Operational Cadence

1. Regenerate when any marketing-key-art-pack form field or validation rule
   changes in web UI.
2. Validate before closing downstream comparison/cost/quality tasks that depend
   on web-surface parity.
3. Keep web validation rules synchronized with API/SDK typed contracts
   (`MXA-0495`, `MXA-0496`) to avoid cross-surface drift.

## Related Artifacts

- `apps/isis/web/src/pages/WorkflowDetailsPage.tsx`
- `apps/isis/web/src/pages/marketing-key-art-pack-ui-utils.ts`
- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_BACKLOG.md`
