From 73bab90bcafb4d1aa4b3ef95dc5cbdc4c87488ec Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Mon, 4 May 2026 15:32:51 +0100 Subject: [PATCH] Clarify converter output is not style guidance --- docs/research/geometry-script-fork-notes.md | 4 +++- docs/research/procedural-doctrine.md | 5 +++++ state/evidence.jsonl | 1 + 3 files changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/research/geometry-script-fork-notes.md b/docs/research/geometry-script-fork-notes.md index 6f3f9d9..ae865b3 100644 --- a/docs/research/geometry-script-fork-notes.md +++ b/docs/research/geometry-script-fork-notes.md @@ -112,13 +112,15 @@ Current acceptance: - Converter runs in Blender 5.1.1. - Generated drafts compile as Python for the tested groups. - The full 176-node `Field Value` source group emits a 179-line draft script. -- Generated text is a bootstrap draft, not doctrine-quality final code. +- Generated text is a bootstrap draft, not doctrine-quality final code or style + guidance. Known limits: - Nested source group calls are emitted by source group name, so dependency groups must be converted or replaced by hand-authored equivalents. - The generated script preserves node-level wiring and therefore can be noisy. +- Generated names and ordering reflect extraction mechanics, not spatial intent. - Behavioral equivalence still needs the same evaluated-geometry or scalar harness verification used by the hand translations. diff --git a/docs/research/procedural-doctrine.md b/docs/research/procedural-doctrine.md index be7934e..2c36e04 100644 --- a/docs/research/procedural-doctrine.md +++ b/docs/research/procedural-doctrine.md @@ -16,6 +16,11 @@ Code snippets are excerpts from the verified translation scripts unless noted. They may omit surrounding setup or sibling branches, but they should keep the same explicit Geometry Script call style that passed Blender verification. +`nodes_to_script` output is evidence, not style guidance. Use generated drafts +to recover wiring, defaults, socket order, and hidden graph structure. Do not +copy their naming, ordering, or mechanical transcript shape into accepted +Geometry Script. A useful draft can still be ugly enough to need supervision. + ## Start With A Pipeline Reach for this when the form feels like it has stages: a seed shape, a sampling diff --git a/state/evidence.jsonl b/state/evidence.jsonl index fa4ebf1..2036785 100644 --- a/state/evidence.jsonl +++ b/state/evidence.jsonl @@ -20,3 +20,4 @@ {"ts": "2026-05-04T13:47:26+00:00", "type": "documentation", "status": "accepted", "note": "Reframed procedural doctrine as a spatial reasoning playbook rather than abstraction glossary. Each doctrine pattern should describe the visual cue, mental move, Geometry Script code shape, and verification cue so metaphors help an agent choose tools while reasoning about form."} {"ts": "2026-05-04T13:51:58+00:00", "type": "documentation", "status": "accepted", "note": "Audited procedural doctrine snippets against the verified Geometry Script translations and removed conceptual shorthand. Doctrine snippets should use the same explicit Geometry Script node-call style as the scripts that passed Blender verification, with excerpts clearly behaving as excerpts rather than pseudocode."} {"ts": "2026-05-04T14:10:09+00:00", "type": "tooling", "status": "accepted", "note": "Ported upstream Geometry Script nodes_to_script prototype onto GameCult fork branch vibegeometry/blender-5-nodes-to-script. Added callable convert_node_tree(tree), UI operator registration, patch persistence, and a Blender smoke harness. In Blender 5.1.1 the converter emits compiling draft scripts for Create Decimal, Digit At, Next Digit, Seven Segments, Delete Segments, and the 176-node Field Value group; generated output is a bootstrap draft requiring cleanup and behavioral verification."} +{"ts": "2026-05-04T14:32:43+00:00", "type": "doctrine", "status": "accepted", "note": "nodes_to_script output is evidence and scaffolding, not style guidance. Use it to recover wiring/defaults/socket order and hidden graph structure, then rewrite into doctrine-quality Geometry Script with spatial names, intentional decomposition, and behavioral verification."}