# ISIS v2 Storyboard Frame Set Cost Estimation and Budget Guardrails

Generated: 2026-08-02T19:12:16.417Z Checklist: `MXA-0446` (ISIS2-00644) Asset
Family: `storyboard-frame-set` 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 storyboard-frame-set 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                            |
| ---------------------------------------- | ---------- | ------------- | ----------------- | ---------------------------------------- |
| storyboard-frame-set-baseline            | true       | true          | false             | storyboard-frame-set-flux-standard       |
| storyboard-frame-set-image-conditioned   | true       | true          | false             | storyboard-frame-set-flux-standard       |
| storyboard-frame-set-control-conditioned | true       | true          | true              | storyboard-frame-set-control-conditioned |
| storyboard-frame-set-consistency-locked  | true       | true          | true              | storyboard-frame-set-consistency-locked  |

## Guardrail Environment-Key Coverage

| Env Key                                                                  | Cost Utils | Jobs Strategy |
| ------------------------------------------------------------------------ | ---------- | ------------- |
| ISIS_STORYBOARD_FRAME_SET_BUDGET_GUARDRAIL_ENABLED                       | true       | true          |
| ISIS_STORYBOARD_FRAME_SET_BUDGET_SOFT_LIMIT_USD                          | true       | true          |
| ISIS_STORYBOARD_FRAME_SET_BUDGET_HARD_LIMIT_USD                          | true       | true          |
| ISIS_STORYBOARD_FRAME_SET_RUNTIME_SOFT_LIMIT_SECONDS                     | true       | true          |
| ISIS_STORYBOARD_FRAME_SET_RUNTIME_HARD_LIMIT_SECONDS                     | true       | true          |
| ISIS_STORYBOARD_FRAME_SET_BUDGET_RETRY_AFTER_SECONDS                     | true       | true          |
| ISIS_STORYBOARD_FRAME_SET_COST_RATE_FLUX_USD_PER_SECOND                  | true       | true          |
| ISIS_STORYBOARD_FRAME_SET_COST_RATE_CHARACTER_CONSISTENCY_USD_PER_SECOND | true       | true          |

## Implementation Signals

- Cost utility methods:
  - estimateStoryboardFrameSetRunCost: present
  - evaluateStoryboardFrameSetBudgetGuardrail: present
  - applyStoryboardFrameSetBudgetGuardrailHeaders: present
- Workflows route signals:
  - budgetGuardrailErrorClassImported: true
  - budgetGuardrailHeadersApplied: true
  - budgetGuardrailErrorCodeExposed: true
  - estimatedCostInWorkflowResponse: true
  - budgetMetadataStoredOnJob: true
- Jobs route signals:
  - costEstimationProfilesExposed: true
  - budgetGuardrailsExposed: true
  - storyboardFrameSetPolicyConstantPresent: true
- Test coverage signals:
  - costUtilsSpecAssertions: 4
  - workflowsSpecBudgetGuardrailAssertionPresent: true
  - jobsSpecCompatibilityAssertionPresent: true

## Verification

- `pnpm --filter @isis/generation-api exec vitest run src/routes/storyboard-frame-set-budget-utils.spec.ts src/routes/workflows.spec.ts src/routes/jobs.spec.ts`

## Acceptance Criteria

- `storyboard-frame-set` workflow 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 storyboard-frame-set cost estimation
  profiles and budget guardrail policy metadata.

## References

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_STORYBOARD_FRAME_SET_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_STORYBOARD_FRAME_SET_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/storyboard-frame-set-budget-utils.ts`
- `apps/isis/generation-api/src/routes/storyboard-frame-set-budget-utils.spec.ts`
- `ISIS_TODOS_2.md`
