# ISIS v2 NPC Crowd Variation Pack Regression Tests and Golden Datasets

Generated: 2026-08-02T17:39:32.033Z Checklist: `MXA-0106` (ISIS2-00304) Asset
Family: `npc-crowd-variation-pack` Phase: Phase 4 | Milestone: M3 Launch
(2026-07-27 to 2026-10-30)

## Objective

Establish deterministic npc-crowd-variation-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 |
| ---------------------------------------------- | --------------------------- | ------------------------ |
| `npc-crowd-variation-pack-baseline`            | yes                         | yes                      |
| `npc-crowd-variation-pack-image-conditioned`   | yes                         | yes                      |
| `npc-crowd-variation-pack-control-conditioned` | yes                         | yes                      |
| `npc-crowd-variation-pack-consistency-locked`  | yes                         | yes                      |

## Golden/Regression Case Coverage

| Case ID                                          | Dataset Coverage | Test Coverage |
| ------------------------------------------------ | ---------------- | ------------- |
| `golden-npc-crowd-baseline-market`               | yes              | yes           |
| `golden-npc-crowd-image-conditioned-festival`    | yes              | yes           |
| `golden-npc-crowd-control-conditioned-guards`    | yes              | yes           |
| `golden-npc-crowd-consistency-locked-resistance` | yes              | yes           |
| `regression-npc-crowd-consistency-drift`         | yes              | yes           |
| `regression-npc-crowd-package-contract-miss`     | yes              | yes           |

## Verification Commands

- `pnpm --filter @isis/generation-api exec vitest run src/routes/npc-crowd-variation-pack-regression-golden-dataset.spec.ts src/routes/npc-crowd-variation-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-0106`
- Ticket key: `ISIS2-00304`
- Upstream dependency: `MXA-0105`
