# ISIS v2 Sky Atmosphere Pack Quality Evaluator and Acceptance Gate

Generated: 2026-03-02T14:18:38.336Z Checklist: `MXA-0411` (ISIS2-00609) Asset
Family: `sky-atmosphere-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27
to 2026-10-30)

## Objective

Deliver deterministic sky-atmosphere-pack quality evaluation using
cloud-structure consistency, horizon alignment, atmospheric color continuity,
and celestial palette-delta metrics, and enforce threshold-based acceptance
gating in workflow execution APIs with auditable diagnostics.

## Workflow Coverage

| Workflow                                  | Quality Utils Coverage | Jobs Strategy Coverage | Workflow Surface Coverage |
| ----------------------------------------- | ---------------------- | ---------------------- | ------------------------- |
| `sky-atmosphere-pack-baseline`            | yes                    | yes                    | no                        |
| `sky-atmosphere-pack-image-conditioned`   | yes                    | yes                    | no                        |
| `sky-atmosphere-pack-control-conditioned` | yes                    | yes                    | yes                       |
| `sky-atmosphere-pack-consistency-locked`  | yes                    | yes                    | yes                       |

## Quality Gate Environment Keys

| Env Key                                                     | Quality Utils Coverage | Jobs Strategy Coverage |
| ----------------------------------------------------------- | ---------------------- | ---------------------- |
| `ISIS_SKY_ATMOSPHERE_PACK_QUALITY_GATE_ENABLED`             | yes                    | yes                    |
| `ISIS_SKY_ATMOSPHERE_PACK_MIN_QUALITY_SCORE`                | yes                    | yes                    |
| `ISIS_SKY_ATMOSPHERE_PACK_QUALITY_GATE_RETRY_AFTER_SECONDS` | yes                    | yes                    |
| `ISIS_SKY_ATMOSPHERE_PACK_CLOUD_STRUCTURE_CONSISTENCY_MIN`  | yes                    | yes                    |
| `ISIS_SKY_ATMOSPHERE_PACK_HORIZON_ALIGNMENT_MIN`            | yes                    | yes                    |
| `ISIS_SKY_ATMOSPHERE_PACK_ATMOSPHERIC_COLOR_CONTINUITY_MIN` | yes                    | yes                    |
| `ISIS_SKY_ATMOSPHERE_PACK_CELESTIAL_PALETTE_DELTA_E_MAX`    | yes                    | yes                    |

## Verification Commands

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

## Acceptance Criteria

- Sky atmosphere pack workflow variants evaluate cloud-structure consistency,
  horizon alignment, atmospheric color continuity, and celestial palette-delta
  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 sky-atmosphere-pack quality-gate
  policy metadata and environment-key governance coverage.

## Traceability

- Checklist item: `MXA-0411`
- Ticket key: `ISIS2-00609`
- Enforcement route: `/api/v1/workflows/:workflowId/run`
- Error code: `SKY_ATMOSPHERE_PACK_QUALITY_GATE_FAILED`
