jamesk9526-NoxPrompter-ComfyUI-CustomNode/docs/node_responsibilities.md

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:

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.