# ISIS v2 Material PBR Pack Quality Evaluator and Acceptance Gate

Generated: 2026-08-02T16:03:35.336Z Checklist: `MXA-0339` (ISIS2-00537) Asset
Family: `material-pbr-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Deliver deterministic material-pbr-pack quality evaluation using albedo energy
conservation, normal continuity, roughness/metallic accuracy, and
seam-tileability 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 |
| ------------------------------------- | ---------------------- | ---------------------- | ------------------------- |
| material-pbr-pack-baseline            | yes                    | yes                    | no                        |
| material-pbr-pack-image-conditioned   | yes                    | yes                    | no                        |
| material-pbr-pack-control-conditioned | yes                    | yes                    | yes                       |
| material-pbr-pack-consistency-locked  | yes                    | yes                    | yes                       |

## Quality Gate Environment Coverage

| Environment Key                                         | Quality Utils | Jobs Strategy |
| ------------------------------------------------------- | ------------- | ------------- |
| ISIS_MATERIAL_PBR_PACK_QUALITY_GATE_ENABLED             | yes           | yes           |
| ISIS_MATERIAL_PBR_PACK_MIN_QUALITY_SCORE                | yes           | yes           |
| ISIS_MATERIAL_PBR_PACK_QUALITY_GATE_RETRY_AFTER_SECONDS | yes           | yes           |
| ISIS_MATERIAL_PBR_PACK_ALBEDO_ENERGY_CONSERVATION_MIN   | yes           | yes           |
| ISIS_MATERIAL_PBR_PACK_NORMAL_CONTINUITY_MIN            | yes           | yes           |
| ISIS_MATERIAL_PBR_PACK_ROUGHNESS_METALLIC_ACCURACY_MIN  | yes           | yes           |
| ISIS_MATERIAL_PBR_PACK_SEAM_TILEABILITY_MIN             | yes           | yes           |

## Verification Commands

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

## Acceptance Criteria

- material-pbr-pack workflow variants evaluate albedo energy conservation,
  normal continuity, roughness/metallic accuracy, and seam tileability 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 material-pbr-pack quality-gate
  policy metadata and environment-key governance coverage.
