Generated: 2026-03-03T17:34:18.411Z Checklist: MXA-0569 (ISIS2-00767) Asset
Family: music-cue-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)
Objective#
Expose music-cue-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 |
|---|---|
music-cue-pack-baseline |
yes |
music-cue-pack-image-conditioned |
yes |
music-cue-pack-control-conditioned |
yes |
music-cue-pack-consistency-locked |
yes |
Ergonomic Controls#
Cue ID (required): presentPrompt (required): presentCue Purpose (required): presentMood (required): presentInstrumentation (required): presentTempo (BPM) (required): presentDuration Seconds (required): presentKey Signature (required): presentTime Signature (required): presentSample Rate (Hz) (required): presentTarget LUFS (required): presentOutput Format (required): presentAudio Prompt Hint: presentSeed (required): presentConditioning Strength (required): presentReference Audio URL (required): presentReference Audio URLs (comma-separated): presentStyle Reference ID: presentConditioning Mode (required): presentProvider Capability Mode (required): presentReference Mix Strategy (required): presentPreserve Prompt Intent: presentPrompt Template ID (required): presentStyle Profile ID (required): presentModel Name (required): presentControl Applicability Mode (required): presentControl Signal Fusion (required): presentControl Profile ID (required): presentControl Timeline FPS (required): presentEvent Alignment Mode (required): presentUse Pose Control: presentPose Map: presentPose Strength: presentUse Depth Control: presentDepth Map: presentDepth Strength: presentUse Segmentation Control: presentSegmentation Map: presentSegmentation Strength: presentUse Canny Control: presentEdge Map: presentCanny Strength: presentUse Lineart Control: presentLineart Map: presentLineart Strength: presentContinuity Profile ID: presentContinuity Profile Revision: presentContinuity Locked Dimensions: presentContinuity Notes (required): presentContinuity Window Size (required): presentTimbre Reference Audio URL (required): presentCue Timing Reference Audio URL: presentAmbience Reference Audio URL: presentSpatial Reference Audio URL: presentUse Timbre Reference: presentUse Cue Timing Reference: presentUse Ambience Reference: presentUse Spatial Reference: presentContinuity Lock Strength: presentMotif Lock Strength: presentCue Timing Lock Strength: presentAmbience Lock Strength: presentSpatial Lock Strength: presentCue Timing Alignment Target Score: presentMotif Alignment Target Score: presentIntegrated LUFS Delta Tolerance: presentHarmonic Drift Tolerance: present
Validation Rules#
- present: Music cue pack workflows require generation type music-generation.
- present: Cue ID is required.
- present: Cue ID must be at least 3 characters.
- present: Prompt is required.
- present: Prompt must be at least 5 characters.
- present: Reference Audio URL is required.
- present: Reference Audio URLs must contain at least one value when provided.
- present: Reference Audio URLs must include at most 32 entries.
- present: Reference Audio URLs entries must be at most 1200 characters.
- present: Style Reference ID must be at most 128 characters.
- present: Prompt Template ID is required.
- present: Style Profile ID is required.
- present: Model Name is required.
- present: Control Profile ID 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: 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 must contain at least one value.
- present: Continuity Notes is required.
- present: Timbre Reference Audio URL is required.
- present: Cue Timing Reference Audio URL is required when cue timing reference is enabled.
- present: Ambience Reference Audio URL is required when ambience reference is enabled.
- present: Spatial Reference Audio URL is required when spatial reference is enabled.
Verification Commands#
pnpm --filter @isis/web exec vitest run src/pages/music-cue-pack-ui-utils.spec.tspnpm --filter @isis/web exec vitest run src/pages/WorkflowDetailsPage.spec.tsx -t "music cue pack"node scripts/isis/validate-v2-music-cue-pack-web-ui-controls-validation.mjs
Acceptance Criteria#
- Workflow details page renders ergonomic variant-specific music-cue-pack controls for all four workflow IDs.
- Web UI validation enforces typed contract constraints (music-generation lock, required fields, and conditional control/reference dependencies).
- 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-0569 - Ticket key:
ISIS2-00767 - Source references:
docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.jsondocs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_REQUIREMENTS_BRIEF.jsondocs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_SDK_END_TO_END_EXAMPLES.jsonapps/isis/web/src/pages/WorkflowDetailsPage.tsxapps/isis/web/src/pages/WorkflowDetailsPage.spec.tsxapps/isis/web/src/pages/music-cue-pack-ui-utils.tsapps/isis/web/src/pages/music-cue-pack-ui-utils.spec.tsapps/isis/web/src/pages/workflow-run-utils.tsISIS_TODOS_2.md