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.jsondocs/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.jsondocs/domains/isis/remediation-v2/ISIS_V2_CHARACTER_EXPRESSION_SHEET_REQUIREMENTS_BRIEF.jsonapps/isis/generation-api/src/schemas/character-expression-sheet.schema.tsapps/isis/generation-api/src/routes/workflows.tsapps/isis/generation-api/src/schemas/character-expression-sheet.schema.spec.tsapps/isis/generation-api/src/routes/workflows.spec.ts
Operational Cadence#
- Regenerate whenever typed workflow IDs or required parameter contracts change.
- Validate before closing SDK/UI exposure tasks (
MXA-0046,MXA-0047) and parity/regression tasks. - Keep route guard error codes and typed schema coverage synchronized with API tests and public contract docs.
Related Artifacts#
apps/isis/generation-api/src/schemas/character-expression-sheet.schema.tsapps/isis/generation-api/src/routes/workflows.tsdocs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_BACKLOG.md