# Isis UI Icon Pack Quality Evaluator and Acceptance Gate Runbook

Last Updated: 2026-03-01  
Scope: `MXA-0303` quality-evaluation and acceptance-gate enforcement for
`ui-icon-pack` workflows.

## Purpose

Generate and validate the canonical artifact that captures deterministic ui-icon
quality-metric evaluation, threshold-based acceptance gate behavior, and
compatibility-route policy exposure for `ui-icon-pack` workflow execution.

## Artifacts

- `docs/domains/isis/remediation-v2/ISIS_V2_UI_ICON_PACK_QUALITY_EVALUATOR_ACCEPTANCE_GATE.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_UI_ICON_PACK_QUALITY_EVALUATOR_ACCEPTANCE_GATE.md`

## Generator

```bash
node scripts/isis/generate-v2-ui-icon-pack-quality-evaluator-acceptance-gate.mjs
```

Options:

- `--report-date=YYYY-MM-DD` (default: current UTC date)

## Validator

```bash
node scripts/isis/validate-v2-ui-icon-pack-quality-evaluator-acceptance-gate.mjs
```

## Source Inputs

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_UI_ICON_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_UI_ICON_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/ui-icon-pack-quality-gate-utils.ts`
- `apps/isis/generation-api/src/routes/ui-icon-pack-quality-gate-utils.spec.ts`

## Operational Cadence

1. Regenerate when ui-icon quality-metric thresholds, weighted scoring model, or
   route response contracts change.
2. Validate before closing downstream regression/integration/operator tasks that
   depend on acceptance-gate stability.
3. Keep threshold defaults and environment-key policy metadata synchronized
   between workflow enforcement and provider compatibility diagnostics.

## Related Artifacts

- `apps/isis/generation-api/src/routes/workflows.ts`
- `apps/isis/generation-api/src/routes/ui-icon-pack-quality-gate-utils.ts`
- `apps/isis/generation-api/src/routes/jobs.ts`
- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_BACKLOG.md`
