Last Updated: 2026-02-26
Scope: MXA-0099 generation API exposure for npc-crowd-variation-pack
workflows with typed request contracts.
Purpose#
Generate and validate the canonical API contract artifact for
npc-crowd-variation-pack workflow run requests, including route exposure,
workflow ID coverage, typed parameter requirements, and validation guard
behavior.
Artifacts#
docs/domains/isis/remediation-v2/ISIS_V2_NPC_CROWD_VARIATION_PACK_GENERATION_API_TYPED_REQUEST_CONTRACTS.jsondocs/domains/isis/remediation-v2/ISIS_V2_NPC_CROWD_VARIATION_PACK_GENERATION_API_TYPED_REQUEST_CONTRACTS.md
Generator#
bash
node scripts/isis/generate-v2-npc-crowd-variation-pack-generation-api-typed-request-contracts.mjs
Options:
--report-date=YYYY-MM-DD(default: current UTC date)
Validator#
bash
node scripts/isis/validate-v2-npc-crowd-variation-pack-generation-api-typed-request-contracts.mjs
Source Inputs#
docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.jsondocs/domains/isis/remediation-v2/ISIS_V2_NPC_CROWD_VARIATION_PACK_REQUIREMENTS_BRIEF.jsonapps/isis/generation-api/src/schemas/npc-crowd-variation-pack.schema.tsapps/isis/generation-api/src/routes/workflows.tsapps/isis/generation-api/src/schemas/npc-crowd-variation-pack.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-0100,MXA-0101) 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/npc-crowd-variation-pack.schema.tsapps/isis/generation-api/src/routes/workflows.tsdocs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_BACKLOG.md