# ISIS v2 UI Icon Pack Quality Evaluator and Acceptance Gate

Generated: 2026-08-02T18:38:29.182Z Checklist: `MXA-0303` (ISIS2-00501) Asset
Family: `ui-icon-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Deliver deterministic ui-icon-pack quality evaluation using contour alignment,
stroke consistency, palette delta, and accessibility-contrast 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 |
| -------------------------------- | ---------------------- | ---------------------- | ------------------------- |
| ui-icon-pack-baseline            | yes                    | yes                    | no                        |
| ui-icon-pack-image-conditioned   | yes                    | yes                    | no                        |
| ui-icon-pack-control-conditioned | yes                    | yes                    | yes                       |
| ui-icon-pack-consistency-locked  | yes                    | yes                    | yes                       |

## Quality Gate Environment Coverage

| Environment Key                                    | Quality Utils | Jobs Strategy |
| -------------------------------------------------- | ------------- | ------------- |
| ISIS_UI_ICON_PACK_QUALITY_GATE_ENABLED             | yes           | yes           |
| ISIS_UI_ICON_PACK_MIN_QUALITY_SCORE                | yes           | yes           |
| ISIS_UI_ICON_PACK_QUALITY_GATE_RETRY_AFTER_SECONDS | yes           | yes           |
| ISIS_UI_ICON_PACK_CONTOUR_ALIGNMENT_IOU_MIN        | yes           | yes           |
| ISIS_UI_ICON_PACK_STROKE_WEIGHT_CONSISTENCY_MIN    | yes           | yes           |
| ISIS_UI_ICON_PACK_PALETTE_DELTA_E_MAX              | yes           | yes           |
| ISIS_UI_ICON_PACK_CONTRAST_COMPLIANCE_RATIO_MIN    | yes           | yes           |

## Verification Commands

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

## Acceptance Criteria

- ui-icon-pack workflow variants evaluate contour alignment, stroke consistency,
  palette continuity, and contrast-compliance 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 ui-icon-pack quality-gate policy
  metadata and environment-key governance coverage.
