# ISIS v2 Weapon Pack Control-Conditioned Workflow Graph

Generated: 2026-02-28T22:33:40.032Z Checklist: `MXA-0238` (ISIS2-00436) Asset
Family: `weapon-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Define a control-conditioned workflow graph for weapon-pack that supports
depth/segmentation/canny constraints while preserving deterministic
weapon-generation defaults.

## Deterministic Defaults

| Setting                    | Value                                   |
| -------------------------- | --------------------------------------- |
| `checkpointModel`          | `sd_xl_base_1.0.safetensors`            |
| `seed`                     | `2026112504`                            |
| `width`                    | `1792`                                  |
| `height`                   | `1024`                                  |
| `steps`                    | `34`                                    |
| `cfgScale`                 | `6.1`                                   |
| `samplerName`              | `dpmpp_2m_sde`                          |
| `scheduler`                | `karras`                                |
| `denoise`                  | `1`                                     |
| `depthControlModel`        | `control_v11f1p_sd15_depth.safetensors` |
| `segmentationControlModel` | `control_v11p_sd15_seg.safetensors`     |
| `cannyControlModel`        | `control_v11p_sd15_canny.safetensors`   |
| `depthStrength`            | `0.74`                                  |
| `segmentationStrength`     | `0.62`                                  |
| `cannyStrength`            | `0.68`                                  |
| `batchSize`                | `1`                                     |
| `outputFormat`             | `png`                                   |
| `outputChannels`           | `4`                                     |

## Input Contract

| Input                      | Type    | Required | Default                                                                                                                                                                   |
| -------------------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `depth_map`                | image   | no       | n/a                                                                                                                                                                       |
| `segmentation_map`         | image   | no       | n/a                                                                                                                                                                       |
| `canny_map`                | image   | no       | n/a                                                                                                                                                                       |
| `use_depth_control`        | boolean | yes      | `true`                                                                                                                                                                    |
| `use_segmentation_control` | boolean | yes      | `false`                                                                                                                                                                   |
| `use_canny_control`        | boolean | yes      | `true`                                                                                                                                                                    |
| `depth_strength`           | float   | yes      | `0.74`                                                                                                                                                                    |
| `segmentation_strength`    | float   | yes      | `0.62`                                                                                                                                                                    |
| `canny_strength`           | float   | yes      | `0.68`                                                                                                                                                                    |
| `weapon_class`             | enum    | yes      | `assault-rifle`                                                                                                                                                           |
| `manufacturer_style`       | enum    | yes      | `military-industrial`                                                                                                                                                     |
| `era_technology`           | enum    | yes      | `modern`                                                                                                                                                                  |
| `faction_alignment`        | enum    | yes      | `allied-regiment`                                                                                                                                                         |
| `intended_use`             | enum    | yes      | `mid-range`                                                                                                                                                               |
| `scale_class`              | enum    | yes      | `standard`                                                                                                                                                                |
| `material_stack`           | enum    | yes      | `blued-steel-polymer`                                                                                                                                                     |
| `silhouette_profile`       | enum    | yes      | `balanced`                                                                                                                                                                |
| `grip_configuration`       | enum    | yes      | `stocked`                                                                                                                                                                 |
| `attachment_profile`       | enum    | yes      | `optic-and-light`                                                                                                                                                         |
| `condition_grade`          | enum    | yes      | `field-worn`                                                                                                                                                              |
| `safety_state`             | enum    | yes      | `safe`                                                                                                                                                                    |
| `render_view_set`          | enum    | yes      | `hero-3q-front`                                                                                                                                                           |
| `lighting_setup`           | enum    | yes      | `neutral-studio`                                                                                                                                                          |
| `color_palette_profile`    | string  | yes      | `graphite black, brushed steel, olive drab polymer, brass accent wear`                                                                                                    |
| `emblem_policy`            | enum    | yes      | `faction-insignia-subtle`                                                                                                                                                 |
| `style_preset`             | enum    | yes      | `stylized`                                                                                                                                                                |
| `negative_prompt`          | string  | no       | `blurry, low resolution, malformed weapon geometry, impossible mechanics, mirrored trigger guards, clipped muzzles, floating components, text, watermark, jpeg artifacts` |
| `seed`                     | integer | yes      | `2026112504`                                                                                                                                                              |
| `width`                    | integer | yes      | `1792`                                                                                                                                                                    |
| `height`                   | integer | yes      | `1024`                                                                                                                                                                    |
| `steps`                    | integer | yes      | `34`                                                                                                                                                                      |
| `cfg_scale`                | float   | yes      | `6.1`                                                                                                                                                                     |

## Graph Nodes

| Node ID | Class                    | Role                       | Output Count |
| ------- | ------------------------ | -------------------------- | ------------ |
| `n1`    | `LoadImage`              | depth-control-input        | 2            |
| `n2`    | `LoadImage`              | segmentation-control-input | 2            |
| `n3`    | `LoadImage`              | canny-control-input        | 2            |
| `n4`    | `CheckpointLoaderSimple` | model-load                 | 3            |
| `n5`    | `ControlNetLoader`       | depth-control-load         | 1            |
| `n6`    | `ControlNetLoader`       | segmentation-control-load  | 1            |
| `n7`    | `ControlNetLoader`       | canny-control-load         | 1            |
| `n8`    | `CLIPTextEncode`         | positive-conditioning      | 1            |
| `n9`    | `CLIPTextEncode`         | negative-conditioning      | 1            |
| `n10`   | `ControlNetApply`        | depth-control-apply        | 1            |
| `n11`   | `ControlNetApply`        | segmentation-control-apply | 1            |
| `n12`   | `ControlNetApply`        | canny-control-apply        | 1            |
| `n13`   | `EmptyLatentImage`       | latent-init                | 1            |
| `n14`   | `KSampler`               | latent-sample              | 1            |
| `n15`   | `VAEDecode`              | image-decode               | 1            |
| `n16`   | `SaveImage`              | artifact-output            | 0            |

## Graph Edges

| Edge ID | From    | To                 |
| ------- | ------- | ------------------ |
| `e1`    | `n4:0`  | `n14.model`        |
| `e2`    | `n4:1`  | `n8.clip`          |
| `e3`    | `n4:1`  | `n9.clip`          |
| `e4`    | `n4:2`  | `n15.vae`          |
| `e5`    | `n8:0`  | `n10.conditioning` |
| `e6`    | `n5:0`  | `n10.control_net`  |
| `e7`    | `n1:0`  | `n10.image`        |
| `e8`    | `n10:0` | `n11.conditioning` |
| `e9`    | `n6:0`  | `n11.control_net`  |
| `e10`   | `n2:0`  | `n11.image`        |
| `e11`   | `n11:0` | `n12.conditioning` |
| `e12`   | `n7:0`  | `n12.control_net`  |
| `e13`   | `n3:0`  | `n12.image`        |
| `e14`   | `n12:0` | `n14.positive`     |
| `e15`   | `n9:0`  | `n14.negative`     |
| `e16`   | `n13:0` | `n14.latent_image` |
| `e17`   | `n14:0` | `n15.samples`      |
| `e18`   | `n15:0` | `n16.images`       |

## Topological Node Order

`n1` -> `n13` -> `n2` -> `n3` -> `n4` -> `n5` -> `n6` -> `n7` -> `n8` -> `n10`
-> `n11` -> `n12` -> `n9` -> `n14` -> `n15` -> `n16`

## Research Alignment

| Workflow                          | Path                                                                  | Control Nodes |
| --------------------------------- | --------------------------------------------------------------------- | ------------- |
| AnimateDiff with ControlNet       | `libs/isis/workflows/src/workflows/video/animatediff-controlnet.json` | 3             |
| Sacred Artifact 3D Reconstruction | `libs/isis/workflows/src/workflows/3d/artifact-reconstruction.json`   | 0             |
| 3D Texture Generator              | `libs/isis/workflows/src/workflows/texture/3d-texture.json`           | 0             |

## Acceptance Criteria

- Graph is acyclic and topologically sortable.
- Depth/segmentation/canny control paths are explicitly represented through
  ControlNet loaders and apply nodes.
- At least one control mode can be enabled per run without breaking
  deterministic sampler/model defaults.
- Output contract aligns to MXA-0235 required output classes.
- Weapon class, attachment profile, safety state, and silhouette controls are
  first-class required inputs for controlled generation.

## Traceability

- Checklist item: `MXA-0238`
- Ticket key: `ISIS2-00436`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_WEAPON_PACK_REQUIREMENTS_BRIEF.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_WEAPON_PACK_BASELINE_WORKFLOW_GRAPH.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_WEAPON_PACK_IMAGE_CONDITIONED_WORKFLOW_GRAPH.json`
  - `libs/isis/workflows/src/workflows/video/animatediff-controlnet.json`
  - `libs/isis/workflows/src/workflows/3d/artifact-reconstruction.json`
  - `libs/isis/workflows/src/workflows/texture/3d-texture.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_CONTROL_TAXONOMY.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json`
  - `ISIS_TODOS_2.md`
