# ISIS v2 HUD Element Pack Quality Evaluator and Acceptance Gate

Generated: 2026-03-01T18:30:32.160Z Checklist: `MXA-0321` (ISIS2-00519) Asset
Family: `hud-element-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Deliver deterministic hud-element-pack quality evaluation using layout
alignment, typography legibility, color-contrast compliance, and continuity-lock
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 |
| ------------------------------------ | ---------------------- | ---------------------- | ------------------------- |
| hud-element-pack-baseline            | yes                    | yes                    | no                        |
| hud-element-pack-image-conditioned   | yes                    | yes                    | no                        |
| hud-element-pack-control-conditioned | yes                    | yes                    | yes                       |
| hud-element-pack-consistency-locked  | yes                    | yes                    | yes                       |

## Quality Gate Environment Coverage

| Environment Key                                        | Quality Utils | Jobs Strategy |
| ------------------------------------------------------ | ------------- | ------------- |
| ISIS_HUD_ELEMENT_PACK_QUALITY_GATE_ENABLED             | yes           | yes           |
| ISIS_HUD_ELEMENT_PACK_MIN_QUALITY_SCORE                | yes           | yes           |
| ISIS_HUD_ELEMENT_PACK_QUALITY_GATE_RETRY_AFTER_SECONDS | yes           | yes           |
| ISIS_HUD_ELEMENT_PACK_LAYOUT_ALIGNMENT_MIN             | yes           | yes           |
| ISIS_HUD_ELEMENT_PACK_TYPOGRAPHY_LEGIBILITY_MIN        | yes           | yes           |
| ISIS_HUD_ELEMENT_PACK_COLOR_CONTRAST_RATIO_MIN         | yes           | yes           |
| ISIS_HUD_ELEMENT_PACK_CONTINUITY_LOCK_MIN              | yes           | yes           |

## Verification Commands

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

## Acceptance Criteria

- hud-element-pack workflow variants evaluate layout alignment, typography
  legibility, contrast-compliance, and continuity-lock metrics
  deterministically.
- Quality threshold violations enforce hard 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 hud-element-pack quality-gate policy
  metadata and environment-key governance coverage.
