# Isis Terrain Heightmap Pack Cost Estimation and Budget Guardrails Runbook

Last Updated: 2026-03-02  
Scope: `MXA-0374` cost-estimation and budget-guardrail enforcement for
`terrain-heightmap-pack` workflows.

## Purpose

Generate and validate the canonical artifact that captures deterministic
runtime/cost estimation, hard-fail budget guardrail enforcement, and
compatibility-route policy exposure for `terrain-heightmap-pack` workflow
execution.

## Artifacts

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

## Generator

```bash
node scripts/isis/generate-v2-terrain-heightmap-pack-cost-estimation-budget-guardrails.mjs
```

Options:

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

## Validator

```bash
node scripts/isis/validate-v2-terrain-heightmap-pack-cost-estimation-budget-guardrails.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_TERRAIN_HEIGHTMAP_PACK_RUNPOD_ENDPOINT_CLASS_SIZING_POLICIES.json`
- `apps/isis/generation-api/src/routes/workflows.ts`
- `apps/isis/generation-api/src/routes/workflows.spec.ts`
- `apps/isis/generation-api/src/routes/jobs.ts`
- `apps/isis/generation-api/src/routes/jobs.spec.ts`
- `apps/isis/generation-api/src/routes/terrain-heightmap-pack-budget-utils.ts`
- `apps/isis/generation-api/src/routes/terrain-heightmap-pack-budget-utils.spec.ts`

## Operational Cadence

1. Regenerate when terrain-heightmap-pack cost model factors, thresholds, or
   route response contracts change.
2. Validate before closing downstream quality/regression/operator tasks that
   rely on stable budget enforcement and observability.
3. Keep cost model defaults and environment-key policy metadata synchronized
   between workflow execution enforcement and provider compatibility
   diagnostics.

## Related Artifacts

- `apps/isis/generation-api/src/routes/workflows.ts`
- `apps/isis/generation-api/src/routes/terrain-heightmap-pack-budget-utils.ts`
- `apps/isis/generation-api/src/routes/jobs.ts`
- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_BACKLOG.md`
