Generated: 2026-08-02T16:03:35.296Z Checklist: MXA-0338 (ISIS2-00536) Asset
Family: material-pbr-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)
Objective#
Deliver deterministic per-run cost/runtime estimation and threshold-based budget guardrails for material-pbr-pack workflow execution, with enforcement and observability integrated into workflow run APIs and provider compatibility diagnostics.
Workflow Coverage#
| Workflow | Cost Utils | Jobs Strategy | Workflows Surface | Sizing Policy |
|---|---|---|---|---|
| material-pbr-pack-baseline | true | true | false | material-pbr-pack-flux-standard |
| material-pbr-pack-image-conditioned | true | true | false | material-pbr-pack-flux-standard |
| material-pbr-pack-control-conditioned | true | true | true | material-pbr-pack-control-conditioned |
| material-pbr-pack-consistency-locked | true | true | true | material-pbr-pack-consistency-locked |
Guardrail Environment-Key Coverage#
| Env Key | Cost Utils | Jobs Strategy |
|---|---|---|
| ISIS_MATERIAL_PBR_PACK_BUDGET_GUARDRAIL_ENABLED | true | true |
| ISIS_MATERIAL_PBR_PACK_BUDGET_SOFT_LIMIT_USD | true | true |
| ISIS_MATERIAL_PBR_PACK_BUDGET_HARD_LIMIT_USD | true | true |
| ISIS_MATERIAL_PBR_PACK_RUNTIME_SOFT_LIMIT_SECONDS | true | true |
| ISIS_MATERIAL_PBR_PACK_RUNTIME_HARD_LIMIT_SECONDS | true | true |
| ISIS_MATERIAL_PBR_PACK_BUDGET_RETRY_AFTER_SECONDS | true | true |
| ISIS_MATERIAL_PBR_PACK_COST_RATE_FLUX_USD_PER_SECOND | true | true |
| ISIS_MATERIAL_PBR_PACK_COST_RATE_CHARACTER_CONSISTENCY_USD_PER_SECOND | true | true |
Implementation Signals#
- Cost utility methods:
- estimateMaterialPbrPackRunCost: present
- evaluateMaterialPbrPackBudgetGuardrail: present
- applyMaterialPbrPackBudgetGuardrailHeaders: present
- Workflows route signals:
- budgetGuardrailErrorClassImported: true
- budgetGuardrailHeadersApplied: true
- budgetGuardrailErrorCodeExposed: true
- estimatedCostInWorkflowResponse: true
- budgetMetadataStoredOnJob: true
- Jobs route signals:
- costEstimationProfilesExposed: true
- budgetGuardrailsExposed: true
- materialPbrPackPolicyConstantPresent: true
- Test coverage signals:
- costUtilsSpecAssertions: 4
- workflowsSpecBudgetGuardrailAssertionPresent: true
- jobsSpecCompatibilityAssertionPresent: true
Verification#
pnpm --filter @isis/generation-api exec vitest run src/routes/material-pbr-pack-budget-utils.spec.ts src/routes/workflows.spec.ts src/routes/jobs.spec.ts
Acceptance Criteria#
material-pbr-packworkflow variants return deterministic estimated runtime/cost signals before dispatch.- Budget guardrail thresholds enforce hard-fail rejection when estimated runtime/cost envelopes exceed configured limits.
- Workflow run responses and headers expose estimation and guardrail diagnostics for operator visibility and downstream tooling.
- Provider compatibility diagnostics expose material-pbr-pack cost estimation profiles and budget guardrail policy metadata.
References#
docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.jsondocs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_REQUIREMENTS_BRIEF.jsondocs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_RUNPOD_ENDPOINT_CLASS_SIZING_POLICIES.jsonapps/isis/generation-api/src/routes/workflows.tsapps/isis/generation-api/src/routes/workflows.spec.tsapps/isis/generation-api/src/routes/jobs.tsapps/isis/generation-api/src/routes/jobs.spec.tsapps/isis/generation-api/src/routes/material-pbr-pack-budget-utils.tsapps/isis/generation-api/src/routes/material-pbr-pack-budget-utils.spec.tsISIS_TODOS_2.md