# ISIS v2 Terrain Heightmap Pack Regression Tests and Golden Datasets

Generated: 2026-08-02T18:14:05.423Z Checklist: `MXA-0376` (ISIS2-00574) Asset
Family: `terrain-heightmap-pack` Phase: Phase 4 | Milestone: M3 Launch
(2026-07-27 to 2026-10-30)

## Objective

Establish deterministic terrain-heightmap-pack golden datasets and regression
checks that validate typed workflow contracts, quality-gate stability, and
output-package contract compliance across all workflow variants.

## Workflow Coverage

| Workflow                                     | Regression Dataset Coverage | Regression Test Coverage |
| -------------------------------------------- | --------------------------- | ------------------------ |
| `terrain-heightmap-pack-baseline`            | yes                         | yes                      |
| `terrain-heightmap-pack-image-conditioned`   | yes                         | yes                      |
| `terrain-heightmap-pack-control-conditioned` | yes                         | yes                      |
| `terrain-heightmap-pack-consistency-locked`  | yes                         | yes                      |

## Golden/Regression Case Coverage

| Case ID                                                             | Dataset Coverage | Test Coverage |
| ------------------------------------------------------------------- | ---------------- | ------------- |
| `golden-terrain-heightmap-pack-baseline-temperate-forest`           | yes              | yes           |
| `golden-terrain-heightmap-pack-image-conditioned-neon-district`     | yes              | yes           |
| `golden-terrain-heightmap-pack-control-conditioned-industrial-rift` | yes              | yes           |
| `golden-terrain-heightmap-pack-consistency-locked-transit-hub`      | yes              | yes           |
| `regression-terrain-heightmap-pack-consistency-drift`               | yes              | yes           |
| `regression-terrain-heightmap-pack-package-contract-miss`           | yes              | yes           |

## Verification Commands

- `pnpm --filter @isis/generation-api exec vitest run src/routes/terrain-heightmap-pack-regression-golden-dataset.spec.ts src/routes/terrain-heightmap-pack-quality-gate-utils.spec.ts src/routes/workflows.spec.ts src/routes/jobs.spec.ts`

## Acceptance Criteria

- Golden dataset includes deterministic approved cases for baseline,
  image-conditioned, control-conditioned, and consistency-locked workflow
  variants.
- Regression suite includes explicit drift scenarios for quality-threshold
  failure and output-package contract non-compliance.
- Regression execution validates typed workflow request contracts and
  deterministic replay stability semantics.
- Suite-level reporting exposes expectation accuracy, replay stability ratio,
  quality-gate acceptance ratio, and output-package compliance ratio.

## Traceability

- Checklist item: `MXA-0376`
- Ticket key: `ISIS2-00574`
- Upstream dependency: `MXA-0375`
