Eve library

ISIS v2 Music Cue Pack Quality Evaluator and Acceptance Gate

Guide

Revision 1

On this page

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