# Isis Character Turnaround Sheet Generation API Typed Request Contracts Runbook

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

## Purpose

Generate and validate the canonical API contract artifact for
`character-turnaround-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_TURNAROUND_SHEET_GENERATION_API_TYPED_REQUEST_CONTRACTS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_CHARACTER_TURNAROUND_SHEET_GENERATION_API_TYPED_REQUEST_CONTRACTS.md`

## Generator

```bash
node scripts/isis/generate-v2-character-turnaround-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-turnaround-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_TURNAROUND_SHEET_REQUIREMENTS_BRIEF.json`
- `apps/isis/generation-api/src/schemas/character-turnaround-sheet.schema.ts`
- `apps/isis/generation-api/src/routes/workflows.ts`
- `apps/isis/generation-api/src/schemas/character-turnaround-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-0028`, `MXA-0029`) and
   parity/regression tasks.
3. 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-turnaround-sheet.schema.ts`
- `apps/isis/generation-api/src/routes/workflows.ts`
- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_BACKLOG.md`
