# ISIS v2 Music Cue Pack Quality Evaluator and Acceptance Gate

Generated: 2026-03-03T18:31:55.127Z Checklist: `MXA-0573` (ISIS2-00771) Asset
Family: `music-cue-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Deliver deterministic music-cue-pack quality evaluation using cue timing
alignment, motif alignment, integrated LUFS delta, and harmonic drift metrics
with threshold-based acceptance gating in workflow execution APIs and auditable
diagnostics.

## Workflow Coverage

| Workflow                           | Quality Utils Coverage | Jobs Strategy Coverage | Workflow Surface Coverage |
| ---------------------------------- | ---------------------- | ---------------------- | ------------------------- |
| music-cue-pack-baseline            | yes                    | yes                    | no                        |
| music-cue-pack-image-conditioned   | yes                    | yes                    | no                        |
| music-cue-pack-control-conditioned | yes                    | yes                    | yes                       |
| music-cue-pack-consistency-locked  | yes                    | yes                    | yes                       |

## Quality Environment Coverage

| Environment Key                                      | Quality Utils Coverage | Jobs Strategy Coverage |
| ---------------------------------------------------- | ---------------------- | ---------------------- |
| ISIS_MUSIC_CUE_PACK_QUALITY_GATE_ENABLED             | yes                    | yes                    |
| ISIS_MUSIC_CUE_PACK_MIN_QUALITY_SCORE                | yes                    | yes                    |
| ISIS_MUSIC_CUE_PACK_QUALITY_GATE_RETRY_AFTER_SECONDS | yes                    | yes                    |
| ISIS_MUSIC_CUE_PACK_CUE_TIMING_ALIGNMENT_SCORE_MIN   | yes                    | yes                    |
| ISIS_MUSIC_CUE_PACK_MOTIF_ALIGNMENT_SCORE_MIN        | yes                    | yes                    |
| ISIS_MUSIC_CUE_PACK_INTEGRATED_LUFS_DELTA_MAX        | yes                    | yes                    |
| ISIS_MUSIC_CUE_PACK_HARMONIC_DRIFT_SCORE_MAX         | yes                    | yes                    |

## Verification

- `pnpm --filter @isis/generation-api exec vitest run src/routes/music-cue-pack-quality-gate-utils.spec.ts src/routes/workflows.spec.ts src/routes/jobs.spec.ts`

## Acceptance Criteria

- `music-cue-pack` workflow variants evaluate cue timing alignment, motif
  alignment, integrated LUFS delta, and harmonic drift deterministically.
- Quality threshold violations enforce acceptance-gate rejection before dispatch
  with explicit response code and retry metadata.
- Workflow run responses and metadata persist quality score and gate-status
  diagnostics for operator visibility and downstream auditing.
- Provider compatibility diagnostics expose music-cue-pack quality-gate policy
  metadata and environment-key governance coverage.

## References

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_MUSIC_CUE_PACK_COST_ESTIMATION_BUDGET_GUARDRAILS.json`
- `apps/isis/generation-api/src/routes/workflows.ts`
- `apps/isis/generation-api/src/routes/workflows.spec.ts`
- `apps/isis/generation-api/src/routes/jobs.ts`
- `apps/isis/generation-api/src/routes/jobs.spec.ts`
- `apps/isis/generation-api/src/routes/music-cue-pack-quality-gate-utils.ts`
- `apps/isis/generation-api/src/routes/music-cue-pack-quality-gate-utils.spec.ts`
- `ISIS_TODOS_2.md`
