WIP: Blender node graphs: design

libby commented

2026-11-07 12:45:22 +00:00

Member

Design only, no code. Adds docs/blender-node-graphs.md: how Brokkr creates, configures and reads back Blender shader/material, world, geometry-node and compositor graphs.

Covers: the typed graph document brokkr.blender.node_graph.v0 (nodes by Brokkr-owned id, blIdname, location; sockets by Blender identifier with type and default; links; group nodes and group interfaces; tree kinds material | world | geometry | compositor | shaderGroup), snapshot read-back with caps and revision/contentHash, the actions (createNodeTree, createNodeGroup, addNode, removeNode, setNodeInput, setNodeProperty, linkSockets, unlinkSockets, assignNodeTree, setModifierInput) plus an atomic editNodeTree batch, idempotency by node id, error slugs, what must not be exposed (script nodes/OSL, evaluated strings, file-touching nodes), what is testable without Blender versus what needs a live one, a Blender version matrix, a five-cut plan and open questions.

Nothing in it has been run against Blender (not installed). Rows of the version matrix marked "confirm" are unverified claims and are labelled as such in the doc.

Draft; not merged.

🤖 Generated with Claude Code

**Design only, no code.** Adds `docs/blender-node-graphs.md`: how Brokkr creates, configures and reads back Blender shader/material, world, geometry-node and compositor graphs. Covers: the typed graph document `brokkr.blender.node_graph.v0` (nodes by Brokkr-owned id, `blIdname`, location; sockets by Blender identifier with type and default; links; group nodes and group interfaces; tree kinds material | world | geometry | compositor | shaderGroup), snapshot read-back with caps and `revision`/`contentHash`, the actions (`createNodeTree`, `createNodeGroup`, `addNode`, `removeNode`, `setNodeInput`, `setNodeProperty`, `linkSockets`, `unlinkSockets`, `assignNodeTree`, `setModifierInput`) plus an atomic `editNodeTree` batch, idempotency by node id, error slugs, what must not be exposed (script nodes/OSL, evaluated strings, file-touching nodes), what is testable without Blender versus what needs a live one, a Blender version matrix, a five-cut plan and open questions. Nothing in it has been run against Blender (not installed). Rows of the version matrix marked "confirm" are unverified claims and are labelled as such in the doc. Draft; not merged. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

libby added 1 commit

2026-11-07 12:45:22 +00:00

docs: Blender node graph design (typed graph document, actions, safety) d1f888f7ac

Design only. Typed brokkr.blender.node_graph.v0 document, tree kinds, read-back,
the node actions, idempotency by node id, error slugs, exclusion of script nodes,
testable-without-Blender split, version matrix, cut plan.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

libby added 3 commits

2026-11-07 13:16:20 +00:00

Merge remote-tracking branch 'origin/main' into libby/blender-node-graphs-design 69da689429

docs: worked node-graph examples and the design gaps they expose f7d211a74d

Five real setups (grass tuft, index-of-nearest helpers, raycast helpers, shortest-path
labyrinth, Blender essentials as library groups) plus the scripted habitats, expressed
as Brokkr ops where possible, with eleven numbered design gaps. Nothing run in Blender.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

docs: link the worked examples, tighten example 3, zones recommendation 521d3f0625

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

libby added 1 commit

2026-11-07 13:38:02 +00:00

docs: close node-graph design gaps 1-6, 8, 11; add headless Blender 5.2.3 probe 349d8160b2

Folds item sockets (addNodeItem), zones (addZone, in v1), interface field-ness,
multi-input sockets, library groups (linkNodeGroupAsset) and evaluated read-back
(queryEvaluated) into the design. node_graph_probe.py ran 37 checks on Blender
5.2.3 LTS; it corrected the modifier input API, opaque interface identifiers,
capture item identifiers, Poisson socket availability and the library asset counts.
A verification-status table records what was and was not run.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

libby added 1 commit

2026-11-10 13:57:32 +00:00

docs: setModifierInput spelling is getattr(inputs, id).value on 5.2.3 f45e1abafe

inputs[id] returns a raw ID property group without .value; found by the implementation (surfaces/blender node_actions.py on libby/blender-gn-recreation).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

libby referenced this pull request from a commit

2026-11-10 17:53:47 +00:00

Blender node actions: refuse image-texture nodes in code; point docs at PR #3

libby referenced this pull request

2026-11-10 17:54:17 +00:00

Blender add-on: geometry node graph actions, modifier inputs, evaluated snapshot #5

libby added 1 commit

2026-11-10 23:15:39 +00:00

Merge origin/main into libby/blender-node-graphs-design 64a99f9c1f

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

libby referenced this pull request

2026-11-10 23:15:56 +00:00

node-actions.md: point to the parked design tag #10

libby commented

2026-11-10 23:15:56 +00:00

Author

Member

Closing by Persona decision: trim to what #5 implements leaves nothing, because #5 already documents its eight actions in surfaces/blender/docs/node-actions.md. What remains here is design for unbuilt parts (zones, item sockets, library groups, queryEvaluated, editNodeTree batch, setNodeInput/setNodeProperty) plus Blender 5.2.3 probe facts; parked at tag parked/blender-node-graphs-design.

libby closed this pull request

2026-11-10 23:15:56 +00:00

Pull request closed

Please reopen this pull request to perform a merge.

Rows
Columns

WIP: Blender node graphs: design #3

Pull request closed