# Node Responsibility Matrix

This reference captures the intended focus area for each exported node.
It was generated by reviewing `noxprompter.nodes.NODE_CLASSES` and the
runtime inspection helper at `tools/inspect_node_inputs.py`.

| Node | Category | Primary Deliverable | Key Input Buckets | Potential Overlap Notes |
| --- | --- | --- | --- | --- |
| `NoxPromptUsageGuide` | Guidance | Onboarding copy | detail level toggles | None observed |
| `NoxPromptWorkflowNavigator` | Guidance | Suggested node routes | goal, feature toggles | None observed |
| `NoxPromptKontextHelper` | Editing | Repair instructions | edit focus, troubleshooting flags | None observed |
| `NoxPromptOrganizer` | Planning | Prompt buckets summary | character/action/lighting/camera notes, structure | Camera notes accepted as plain text (not option driven) |
| `NoxPromptPromptBoard` | Planning | Pitch board text | story/lighting/camera summaries | Camera entries are free-form text |
| `NoxPromptShotlistOrganizer` | Planning | Shotlist with prep checklist | shot metadata incl. camera text | Camera entries are free-form text |
| `NoxPromptProductionPlanner` | Planning | Departmental callouts | schedule + departmental notes | Camera notes are free-form text |
| `NoxPromptBlueprintGenerator` | Builder | Structured blueprint tuple | archetype/environment/motion/style presets | Shares palette + motion controls with builder |
| `NoxPromptBuilder` | Builder | Final positive/negative prompt | formula, subject briefs, palette strings, camera notes | Palette-driven assembly that consumes outputs from specialist nodes |
| `NoxPromptPaletteMixer` | Builder | Palette strings | mood/intensity + toggles | None observed |
| `NoxPromptPromptInspector` | QA | Fragment analysis | parsing/filter settings | None observed |
| `NoxPromptAnalyzer` | QA | Focused review snippet | prompt + analysis type | None observed |
| `NoxPromptPipelineCombiner` | QA/Assembly | Canonical pipeline prompt | upstream prompt fragments, overrides | Accepts camera overrides as text |
| `NoxPromptCameraMaster` (`NoxPromptCameraLanguage`) | Camera | Rig + language bundle | comprehensive camera option sets | Source of truth for camera selections |
| `NoxPromptAdvancedCamera` | Camera | (Not registered) advanced rig variants | TBD | Needs audit for registration |
| `NoxPromptLightingMaster` | Lighting | Lighting blueprint + notes | lighting option sets, lighting notes, camera notes text | Camera rig capture removed; relies on notes only |
| `NoxPromptActionDirector` | Action | Action beat prompt | action presets, camera language text | Camera language accepted via text |
| `NoxPromptEnhancer` | Action | Prompt augmentation | emphasis toggles | None observed |
| `NoxPromptPoseMaster` | Pose | Pose brief tuple | pose profile, safety brief, camera notes text | Camera framing presets removed in favor of freeform notes |
| `NoxPromptHumanDesigner` | Character | Body/face prompt | morphology switches | None observed |
| `NoxPromptCharacterCreator` | Character | Character spec | archetype/profession/temperament presets | Shares presets with BlueprintGenerator |
| `NoxPromptWardrobeDesigner` | Wardrobe | Wardrobe prompt bundle | garment style controls | None observed |
| `NoxPromptNarrativeWeaver` | Narrative | Story hook prompt | archetype/tone/environment | Shares fields with BlueprintGenerator |
| `NoxPromptBlueprintGenerator` | Narrative | Blueprint tuple | archetype/environment/motion/style presets | Overlaps with CharacterCreator & Builder palettes |
| `NoxPromptPaletteMixer` | Narrative | Palette string | mood/intensity | None observed |
| `NoxPromptCamz` | Live persona | Streaming persona prompt | persona/stage/camera style | Camera style uses presets outside CameraMaster |
| `NoxPromptNSFWDesigner` | NSFW | Styled NSFW blueprint | wardrobe/tone notes, safety brief, camera notes text | Camera framing presets removed in favor of freeform notes |
| `NoxPromptNSFWPoseMaster` | NSFW Pose | Pose brief | pose profile, risk brief, camera notes text | Camera framing presets removed in favor of freeform notes |
| `NoxPromptNSFWAIO` | NSFW | Aggregated blueprint | designer/action/safety prompts | Camera notes accepted as text |
| `NoxPromptNSFWActionDirector` | NSFW Action | Action beat prompt | action presets + camera language text | Camera language accepted as text |

## Highlights

* The shared inspection script outputs the raw required/optional input keys for
  every node. Run it with:

```powershell
C:/Users/James/Documents/GitHub/ComfyNoxPrompter/.venv/Scripts/python.exe tools/inspect_node_inputs.py
```

* True **camera option sets** (enumerated selections backed by
  `CAMERA_*` constants) now reside solely in dedicated camera nodes:
  - `NoxPromptCameraMaster`
  - `NoxPromptCameraLanguage`
  - `NoxPromptAdvancedCamera`
  - `NoxPromptCamz` (`camera_style` preset family)

* Several non-camera nodes also expose *text* fields for camera notes; these can
  stay once preset-driven overlaps are resolved.

* Remaining shared preset libraries:
  - Character archetype/profession tables shared across `BlueprintGenerator` and `CharacterCreator`.
  - Motion/emotion tables used in both `Builder` and action/pipeline nodes.

This document will be updated as overlaps are resolved.