Eve library

ISIS Storyboard Frame Set Generation API Typed Request Contracts Runbook

Runbook

Revision 1

On this page

Last Updated: 2026-03-02
Scope: MXA-0441 generation API exposure for storyboard-frame-set typed request contracts.

Purpose#

Generate and validate the canonical API typed-request contract artifacts for storyboard-frame-set, including route coverage, workflow ID coverage, parameter requirements per variant, and route-level invalid-request guard signals.

Artifacts#

  • docs/domains/isis/remediation-v2/ISIS_V2_STORYBOARD_FRAME_SET_GENERATION_API_TYPED_REQUEST_CONTRACTS.json
  • docs/domains/isis/remediation-v2/ISIS_V2_STORYBOARD_FRAME_SET_GENERATION_API_TYPED_REQUEST_CONTRACTS.md

Generator#

bash
node scripts/isis/generate-v2-storyboard-frame-set-generation-api-typed-request-contracts.mjs

Options:

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

Validator#

bash
node scripts/isis/validate-v2-storyboard-frame-set-generation-api-typed-request-contracts.mjs

Source Inputs#

  • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
  • docs/domains/isis/remediation-v2/ISIS_V2_STORYBOARD_FRAME_SET_REQUIREMENTS_BRIEF.json
  • apps/isis/generation-api/src/schemas/storyboard-frame-set.schema.ts
  • apps/isis/generation-api/src/schemas/storyboard-frame-set.schema.spec.ts
  • apps/isis/generation-api/src/routes/workflows.ts
  • apps/isis/generation-api/src/routes/workflows.spec.ts

Operational Cadence#

  1. Regenerate when storyboard-frame-set typed workflow IDs, request parameters, or route integration logic changes.
  2. Validate before SDK and web UI parity tasks consume the API contract shape (MXA-0442, MXA-0443, MXA-0444).
  3. Keep acceptance criteria aligned with route-level test coverage and invalid-request error signaling.
  • docs/domains/isis/remediation-v2/ISIS_V2_STORYBOARD_FRAME_SET_WORKFLOW_TEMPLATES_PRESETS.json
  • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_BACKLOG.md