# ISIS v2 WS09-002: Dedicated RunPod Endpoint Families

## Scope

`WS09-002` provisions dedicated desired-state endpoint families for:

- character consistency
- cinematic video
- 3D workloads
- texture workloads
- audio lanes (continued coverage)

across both production and staging RunPod environments.

## Research and Existing Implementation Alignment

Pre-existing baseline:

- audio-dedicated lanes were already present from `WS08-008`
- provider compatibility/routing contracts existed for `comfyui`, `sd`, `flux`,
  and audio families
- desired-state inventory did not yet include dedicated families for character,
  cinematic video, 3D, and texture lanes

Implementation was extended from these existing contracts rather than creating a
parallel routing model.

## Deliverables

1. Desired-state endpoint families

- Updated `infra/runpod/endpoints/desired-state.json` with dedicated endpoint
  entries for production and staging:
  - `character-consistency`
  - `cinematic-video`
  - `three-d`
  - `texture`

2. Feature-flag and runtime config contracts

- Added endpoint ID and canary routing feature flags in
  `libs/shared/config/src/features.ts` for all new families.
- Extended `getRunPodConfig()` and `validateRunPodConfiguration()` to include
  new family contracts and canary validation.
- Extended config tests in `libs/shared/config/src/features.spec.ts`.

3. Generation API routing and compatibility contracts

- Extended `RunPodEndpointFamily` and endpoint support matrix in
  `apps/isis/generation-api/src/routes/jobs.ts`.
- Added dedicated generation-type support declarations for new families.
- Wired endpoint IDs and canary routing resolution for new families.
- Extended provider compatibility tests in
  `apps/isis/generation-api/src/routes/jobs.spec.ts`.

4. SDK/web exposure updates

- Extended client type contracts (`libs/isis/client/src/types.ts`) so endpoint
  IDs/canary mappings and compatibility enums include new families.
- Updated RunPod and Feature Flags UI family lists:
  - `apps/isis/web/src/pages/RunPodPage.tsx`
  - `apps/isis/web/src/pages/FeatureFlagsPage.tsx`
- Updated corresponding page tests and RunPod parity fixtures.

5. Infrastructure documentation updates

- Expanded `docs/infrastructure/runpod-integration.md` endpoint inventory and
  endpoint ID variable list to include new dedicated families.

## Verification Commands

```bash
python3 scripts/isis/validate_runpod_desired_state.py --file infra/runpod/endpoints/desired-state.json
pnpm --filter @oshun/config exec vitest run src/features.spec.ts --reporter=dot
pnpm --filter @isis/generation-api exec vitest run src/routes/jobs.spec.ts --reporter=dot
pnpm --filter @isis/web exec vitest run src/pages/RunPodPage.spec.tsx src/pages/FeatureFlagsPage.spec.tsx src/pages/RunPodParityPage.spec.tsx --reporter=dot
node scripts/isis/generate-remediation-backlog-v2.mjs
node scripts/isis/validate-v2-compliance-gate.mjs
```

## Result

`WS09-002` now provides dedicated endpoint family contracts across
desired-state, config, API, SDK, and web diagnostics for character consistency,
cinematic video, 3D, texture, and audio routing lanes.
