Eve library

Isis Character Expression Sheet Generation API Typed Request Contracts Runbook

Runbook

Revision 1

On this page

Last Updated: 2026-02-25
Scope: MXA-0045 generation API exposure for character-expression-sheet workflows with typed request contracts.

Purpose#

Generate and validate the canonical API contract artifact for character-expression-sheet workflow run requests, including route exposure, workflow ID coverage, typed parameter requirements, and validation guard behavior.

Artifacts#

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

Generator#

bash
node scripts/isis/generate-v2-character-expression-sheet-generation-api-typed-request-contracts.mjs

Options:

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

Validator#

bash
node scripts/isis/validate-v2-character-expression-sheet-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_CHARACTER_EXPRESSION_SHEET_REQUIREMENTS_BRIEF.json
  • apps/isis/generation-api/src/schemas/character-expression-sheet.schema.ts
  • apps/isis/generation-api/src/routes/workflows.ts
  • apps/isis/generation-api/src/schemas/character-expression-sheet.schema.spec.ts
  • apps/isis/generation-api/src/routes/workflows.spec.ts

Operational Cadence#

  1. Regenerate whenever typed workflow IDs or required parameter contracts change.
  2. Validate before closing SDK/UI exposure tasks (MXA-0046, MXA-0047) and parity/regression tasks.
  3. Keep route guard error codes and typed schema coverage synchronized with API tests and public contract docs.
  • apps/isis/generation-api/src/schemas/character-expression-sheet.schema.ts
  • apps/isis/generation-api/src/routes/workflows.ts
  • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_BACKLOG.md