# ISIS v2 NPC Crowd Variation Pack Consistency-Locked Workflow Graph

Generated: 2026-08-02T17:39:31.321Z Checklist: `MXA-0095` (ISIS2-00293) Asset
Family: `npc-crowd-variation-pack` Phase: Phase 4 | Milestone: M3 Launch
(2026-07-27 to 2026-10-30)

## Objective

Define a consistency-locked npc-crowd-variation-pack workflow graph that
enforces continuity profile state across identity, wardrobe, layout-depth,
lighting, and color-script dimensions while retaining deterministic generation
defaults and crowd-cohort staging controls.

## Continuity Profile

| Profile ID                     | Minimum Passing Dimensions | Locked Dimensions                                          |
| ------------------------------ | -------------------------- | ---------------------------------------------------------- |
| `character-continuity-profile` | 5                          | `identity`, `wardrobe`, `prop`, `lighting`, `color-script` |

## Deterministic Defaults

| Setting                     | Value                                   |
| --------------------------- | --------------------------------------- |
| `checkpointModel`           | `sd_xl_base_1.0.safetensors`            |
| `identityAdapterModel`      | `ip-adapter-faceid-plusv2_sdxl.bin`     |
| `styleAdapterModel`         | `ip-adapter_sdxl.safetensors`           |
| `segmentationControlModel`  | `control_v11p_sd15_seg.safetensors`     |
| `depthControlModel`         | `control_v11f1p_sd15_depth.safetensors` |
| `seed`                      | `2026090205`                            |
| `width`                     | `1920`                                  |
| `height`                    | `1080`                                  |
| `steps`                     | `36`                                    |
| `cfgScale`                  | `6.2`                                   |
| `samplerName`               | `dpmpp_2m_sde`                          |
| `scheduler`                 | `karras`                                |
| `denoise`                   | `1`                                     |
| `identityLockStrength`      | `0.85`                                  |
| `wardrobeLockStrength`      | `0.8`                                   |
| `layoutLockStrength`        | `0.74`                                  |
| `lightingLockStrength`      | `0.76`                                  |
| `styleLockStrength`         | `0.79`                                  |
| `continuityProfileId`       | `character-continuity-profile`          |
| `continuityProfileRevision` | `1`                                     |
| `consistencyWindowSize`     | `5`                                     |
| `outputFormat`              | `png`                                   |
| `outputChannels`            | `4`                                     |

## Input Contract

| Input                          | Type     | Required | Default                                        |
| ------------------------------ | -------- | -------- | ---------------------------------------------- |
| `continuity_profile_id`        | string   | yes      | `character-continuity-profile`                 |
| `continuity_profile_revision`  | integer  | yes      | `1`                                            |
| `continuity_locked_dimensions` | string[] | yes      | `identity,wardrobe,prop,lighting,color-script` |
| `identity_profile_id`          | string   | yes      | `hero-identity-profile`                        |
| `style_profile_id`             | string   | yes      | `hero-style-profile`                           |
| `identity_reference_image`     | image    | yes      | n/a                                            |
| `wardrobe_reference_sheet`     | image    | no       | n/a                                            |
| `crowd_layout_reference_map`   | image    | no       | n/a                                            |
| `use_wardrobe_reference`       | boolean  | yes      | `true`                                         |
| `use_crowd_layout_reference`   | boolean  | yes      | `true`                                         |
| `character_archetype`          | enum     | yes      | `hero`                                         |
| `style_preset`                 | enum     | yes      | `stylized`                                     |
| `crowd_role_profile`           | enum     | yes      | `civilians-mixed`                              |
| `crowd_activity_profile`       | enum     | yes      | `market-flow`                                  |
| `crowd_layout_pattern`         | enum     | yes      | `staggered-depth-lanes`                        |
| `wardrobe_variation_profile`   | enum     | yes      | `neutral-market-tones`                         |
| `crowd_density_tier`           | enum     | yes      | `balanced`                                     |
| `lighting_profile`             | enum     | yes      | `day-neutral`                                  |
| `color_script_profile`         | enum     | yes      | `neutral-market`                               |
| `environment_context`          | enum     | yes      | `market-square`                                |
| `camera_framing`               | enum     | yes      | `wide-crowd`                                   |
| `seed`                         | integer  | yes      | `2026090205`                                   |
| `width`                        | integer  | yes      | `1920`                                         |
| `height`                       | integer  | yes      | `1080`                                         |
| `steps`                        | integer  | yes      | `36`                                           |
| `cfg_scale`                    | float    | yes      | `6.2`                                          |
| `identity_lock_strength`       | float    | yes      | `0.85`                                         |
| `wardrobe_lock_strength`       | float    | yes      | `0.8`                                          |
| `layout_lock_strength`         | float    | yes      | `0.74`                                         |

## Graph Nodes

| Node ID | Class                      | Role                    | Output Count |
| ------- | -------------------------- | ----------------------- | ------------ |
| `n1`    | `LoadImage`                | identity-reference-load | 2            |
| `n2`    | `LoadImage`                | wardrobe-reference-load | 2            |
| `n3`    | `LoadImage`                | layout-reference-load   | 2            |
| `n4`    | `ConsistencyProfileLoader` | continuity-profile-load | 1            |
| `n5`    | `CheckpointLoaderSimple`   | model-load              | 3            |
| `n6`    | `IPAdapterLoader`          | identity-adapter-load   | 1            |
| `n7`    | `IPAdapterLoader`          | style-adapter-load      | 1            |
| `n8`    | `IPAdapterFaceID`          | identity-lock-apply     | 1            |
| `n9`    | `IPAdapterApply`           | style-lock-apply        | 1            |
| `n10`   | `ControlNetLoader`         | wardrobe-control-load   | 1            |
| `n11`   | `ControlNetLoader`         | layout-control-load     | 1            |
| `n12`   | `CLIPTextEncode`           | positive-conditioning   | 1            |
| `n13`   | `CLIPTextEncode`           | negative-conditioning   | 1            |
| `n14`   | `ControlNetApply`          | wardrobe-lock-apply     | 1            |
| `n15`   | `ControlNetApply`          | layout-lock-apply       | 1            |
| `n16`   | `ProfileLockMerge`         | continuity-lock-merge   | 1            |
| `n17`   | `EmptyLatentImage`         | latent-init             | 1            |
| `n18`   | `KSampler`                 | latent-sample           | 1            |
| `n19`   | `VAEDecode`                | image-decode            | 1            |
| `n20`   | `MetadataManifestBuilder`  | metadata-build          | 1            |
| `n21`   | `SaveImage`                | artifact-output         | 0            |
| `n22`   | `SaveJSON`                 | manifest-output         | 0            |

## Graph Edges

| Edge ID | From    | To                       |
| ------- | ------- | ------------------------ |
| `e1`    | `n5:0`  | `n8.model`               |
| `e2`    | `n6:0`  | `n8.ipadapter`           |
| `e3`    | `n1:0`  | `n8.image`               |
| `e4`    | `n8:0`  | `n9.model`               |
| `e5`    | `n7:0`  | `n9.ipadapter`           |
| `e6`    | `n2:0`  | `n9.image`               |
| `e7`    | `n5:1`  | `n12.clip`               |
| `e8`    | `n5:1`  | `n13.clip`               |
| `e9`    | `n12:0` | `n14.conditioning`       |
| `e10`   | `n10:0` | `n14.control_net`        |
| `e11`   | `n2:0`  | `n14.image`              |
| `e12`   | `n14:0` | `n15.conditioning`       |
| `e13`   | `n11:0` | `n15.control_net`        |
| `e14`   | `n3:0`  | `n15.image`              |
| `e15`   | `n15:0` | `n16.conditioning`       |
| `e16`   | `n4:0`  | `n16.profile`            |
| `e17`   | `n9:0`  | `n18.model`              |
| `e18`   | `n16:0` | `n18.positive`           |
| `e19`   | `n13:0` | `n18.negative`           |
| `e20`   | `n17:0` | `n18.latent_image`       |
| `e21`   | `n18:0` | `n19.samples`            |
| `e22`   | `n5:2`  | `n19.vae`                |
| `e23`   | `n19:0` | `n21.images`             |
| `e24`   | `n4:0`  | `n20.continuity_profile` |
| `e25`   | `n18:0` | `n20.sampling_trace`     |
| `e26`   | `n20:0` | `n22.payload`            |

## Topological Node Order

`n1` -> `n10` -> `n11` -> `n17` -> `n2` -> `n3` -> `n4` -> `n5` -> `n12` ->
`n13` -> `n14` -> `n15` -> `n16` -> `n6` -> `n7` -> `n8` -> `n9` -> `n18` ->
`n19` -> `n20` -> `n21` -> `n22`

## Continuity Metric Thresholds

| Dimension      | Metric                             | Operator | Threshold |
| -------------- | ---------------------------------- | -------- | --------- |
| `identity`     | `face_embedding_cosine_similarity` | >=       | 0.82      |
| `identity`     | `facial_landmark_drift_px`         | <=       | 12        |
| `wardrobe`     | `garment_attribute_match_ratio`    | >=       | 0.9       |
| `wardrobe`     | `wardrobe_palette_delta_e`         | <=       | 7.5       |
| `prop`         | `prop_embedding_similarity`        | >=       | 0.86      |
| `prop`         | `prop_shape_iou`                   | >=       | 0.74      |
| `lighting`     | `key_light_angle_delta_deg`        | <=       | 10        |
| `lighting`     | `cct_delta_kelvin`                 | <=       | 450       |
| `color-script` | `palette_emd`                      | <=       | 0.12      |
| `color-script` | `mean_luma_delta_pct`              | <=       | 6         |

## Research Alignment

| Workflow                       | Path                                                                  | IPAdapter Nodes | ControlNet Nodes |
| ------------------------------ | --------------------------------------------------------------------- | --------------- | ---------------- |
| Consistent Character Generator | `libs/isis/workflows/src/workflows/avatar/consistent-character.json`  | 1               | 0                |
| Base Avatar Generator          | `libs/isis/workflows/src/workflows/avatar/base-avatar.json`           | 0               | 0                |
| AnimateDiff with ControlNet    | `libs/isis/workflows/src/workflows/video/animatediff-controlnet.json` | 0               | 2                |

## Acceptance Criteria

- Graph is acyclic and topologically sortable.
- Continuity profile support is explicit through profile loader and profile-lock
  merge nodes.
- Identity/wardrobe/layout continuity paths are represented with deterministic
  lock strengths and optional fallbacks.
- Output contract aligns to MXA-0091 required preview/source/metadata classes
  and includes continuity manifest output.

## Traceability

- Checklist item: `MXA-0095`
- Ticket key: `ISIS2-00293`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_NPC_CROWD_VARIATION_PACK_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_NPC_CROWD_VARIATION_PACK_BASELINE_WORKFLOW_GRAPH.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_NPC_CROWD_VARIATION_PACK_IMAGE_CONDITIONED_WORKFLOW_GRAPH.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_NPC_CROWD_VARIATION_PACK_CONTROL_CONDITIONED_WORKFLOW_GRAPH.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_CONSISTENCY_TAXONOMY.json`
  - `libs/isis/workflows/src/workflows/avatar/consistent-character.json`
  - `libs/isis/workflows/src/workflows/avatar/base-avatar.json`
  - `libs/isis/workflows/src/workflows/video/animatediff-controlnet.json`
  - `libs/isis/workflows/src/consistency/orchestration.ts`
  - `docs/domains/isis/remediation-v2/ISIS_V2_CONTROL_TAXONOMY.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_WORKFLOW_AUTHORING_GUIDE.json`
  - `ISIS_TODOS_2.md`
