# ISIS v2 Audio SFX Pack Quality Evaluator and Acceptance Gate

Generated: 2026-08-02T19:12:26.394Z Checklist: `MXA-0537` (ISIS2-00735) Asset
Family: `audio-sfx-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Deliver deterministic audio-sfx-pack quality evaluation using prompt fidelity,
transient clarity, timbral stability, and loudness compliance 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 |
| ---------------------------------- | ---------------------- | ---------------------- | ------------------------- |
| audio-sfx-pack-baseline            | yes                    | yes                    | no                        |
| audio-sfx-pack-image-conditioned   | yes                    | yes                    | no                        |
| audio-sfx-pack-control-conditioned | yes                    | yes                    | yes                       |
| audio-sfx-pack-consistency-locked  | yes                    | yes                    | yes                       |

## Quality Environment Coverage

| Environment Key                                      | Quality Utils Coverage | Jobs Strategy Coverage |
| ---------------------------------------------------- | ---------------------- | ---------------------- |
| ISIS_AUDIO_SFX_PACK_QUALITY_GATE_ENABLED             | yes                    | yes                    |
| ISIS_AUDIO_SFX_PACK_MIN_QUALITY_SCORE                | yes                    | yes                    |
| ISIS_AUDIO_SFX_PACK_QUALITY_GATE_RETRY_AFTER_SECONDS | yes                    | yes                    |
| ISIS_AUDIO_SFX_PACK_PROMPT_FIDELITY_SCORE_MIN        | yes                    | yes                    |
| ISIS_AUDIO_SFX_PACK_TRANSIENT_CLARITY_SCORE_MIN      | yes                    | yes                    |
| ISIS_AUDIO_SFX_PACK_TIMBRAL_STABILITY_SCORE_MIN      | yes                    | yes                    |
| ISIS_AUDIO_SFX_PACK_LOUDNESS_COMPLIANCE_SCORE_MIN    | yes                    | yes                    |

## Verification

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

## Acceptance Criteria

- `audio-sfx-pack` workflow variants evaluate prompt fidelity, transient
  clarity, timbral stability, and loudness compliance 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 audio-sfx-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_AUDIO_SFX_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_AUDIO_SFX_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/audio-sfx-pack-quality-gate-utils.ts`
- `apps/isis/generation-api/src/routes/audio-sfx-pack-quality-gate-utils.spec.ts`
- `ISIS_TODOS_2.md`
