# ISIS Terrain Heightmap Pack Output Package Contract Runbook

Last Updated: 2026-03-02  
Scope: `MXA-0367` output package contract for `terrain-heightmap-pack`,
including file naming and metadata manifest rules.

## Purpose

Generate and validate the canonical output package contract for
`terrain-heightmap-pack` workflows, including output-class mappings, package
class requirements, deterministic file naming, and metadata-manifest schema.

## Artifacts

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

## Generator

```bash
node scripts/isis/generate-v2-terrain-heightmap-pack-output-package-contract.mjs
```

Options:

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

## Validator

```bash
node scripts/isis/validate-v2-terrain-heightmap-pack-output-package-contract.mjs
```

## Source Inputs

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_MODEL_NODE_DEPENDENCY_MANIFEST.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_BASELINE_WORKFLOW_GRAPH.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_IMAGE_CONDITIONED_WORKFLOW_GRAPH.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_CONTROL_CONDITIONED_WORKFLOW_GRAPH.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_CONSISTENCY_LOCKED_WORKFLOW_GRAPH.json`

## Operational Cadence

1. Regenerate when output classes, naming templates, or metadata schema fields
   change.
2. Validate before closing API/SDK/UI exposure tasks and regression suite tasks
   that depend on output package guarantees (`MXA-0368`, `MXA-0369`, `MXA-0370`,
   `MXA-0371`, `MXA-0376`, `MXA-0377`).
3. Keep package profile mappings synchronized with output package taxonomy and
   dependency manifest revisions.

## Related Artifacts

- `docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_MODEL_NODE_DEPENDENCY_MANIFEST.json`
- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_BACKLOG.md`
