diff --git a/docs/research/geonodes-translation-corpus.md b/docs/research/geonodes-translation-corpus.md index b7e5ea1..3b0869d 100644 --- a/docs/research/geonodes-translation-corpus.md +++ b/docs/research/geonodes-translation-corpus.md @@ -258,6 +258,7 @@ Completed Blender raycast minigame foothold: Completed IRCSS French Houses foothold: - `docs/research/translations/ircss-french-houses.md` +- File-level map: `docs/research/translations/ircss-french-houses-system-map.md` - Source groups: `MakeSpiral`, `PointyGothicCone` - Verification: spiral output curve converted to points matches source with ordered max vertex delta `0.0`; plain and ornamented gothic cone cases match diff --git a/docs/research/translations/ircss-french-houses-system-map.md b/docs/research/translations/ircss-french-houses-system-map.md new file mode 100644 index 0000000..06d15bf --- /dev/null +++ b/docs/research/translations/ircss-french-houses-system-map.md @@ -0,0 +1,307 @@ +# IRCSS French Houses System Map + +## Scope + +Source file: +`experiments/source-blends/ircss-french-houses.blend` + +Inspection cache: +`experiments/inspection/ircss-french-houses-node-groups.json` + +Generated with Blender 5.1.1 after extending +`tools/inspect_blend_node_groups.py` to record nested `GeometryNodeGroup` +`node_tree` references. + +## High-Level Shape + +This `.blend` is a procedural town kit, not one scene graph. The file contains: + +- 108 geometry node groups, 107 unique names. +- One duplicate group name: `Is Edge Manifold`. +- 63 distinct modifier root groups used by scene objects. +- 62 groups that call at least one nested group. +- 163 distinct group dependency edges. + +The useful mental split: + +- **Composers** create recognizable buildings and scene pieces: houses, towers, + church fronts, gates, walls, windmills, bridges, stalls, terrain, and roads. +- **Organs** make reusable architectural parts: arcs, windows, doors, roof caps, + stairs, beams, rails, columns, banners, terraces, and covers. +- **Utilities** carry field logic, edge tests, ranges, auto-smoothing, wrapping, + curve facts, random seeding, and geometry selection. + +Metaphor in use: the town is not poured from one mold. It is an assembly yard. +Composers bolt together organs; organs lean on utilities; utilities are the +measuring jigs and clamps. + +## Modifier Entrypoints + +Most reused scene roots: + +| Modifier root | Scene users | Dependency closure | +| --- | ---: | ---: | +| `GenerateHouse` | 5 | 9 | +| `Generate Cliff Type 2` | 3 | 2 | +| `MakeStallCover` | 3 | 0 | +| `GenerateDoorsWithAlcove` | 2 | 2 | +| `Tree On Geo Points` | 2 | 5 | +| `GenerateCover` | 2 | 1 | +| `GenerateStairCase` | 2 | 9 | +| `Generate Tower` | 2 | 10 | +| `GenerateAlcoveWindows` | 2 | 6 | + +Large single-root systems: + +| Modifier root | Dependency closure | Role | +| --- | ---: | --- | +| `Geometry Nodes.002` | 28 | cathedral root | +| `GenerateChurchBuildingB` | 22 | church side/body composer | +| `ChurchA-Front` | 20 | church front facade composer | +| `CreateGate` | 18 | gate composer | +| `HousesOnCurves` | 13 | curve-distributed houses | +| `DomaTower` | 12 | domed tower composer | +| `ChurchFrontTowers` | 11 | church tower front system | +| `Generate Tower` | 10 | tower composer | +| `TownWall` | 10 | wall composer | +| `WindMill` | 10 | windmill composer | + +## Major Composer Wiring + +`GenerateHouse` depends on: + +- `GetPositionBasedSeed` +- `Switch On Roof Type` +- `Generate Windows` +- `Curve Info` +- `CreateDiagonalBeams` +- `WindowBeams` +- `Is Edge Manifold` + +Interpretation: houses are facade assemblers. They choose roof type, place +windows, derive local curve facts, add diagonal beams, and use edge-manifold +tests as selection guards. + +`GenerateStairCase` depends on: + +- `MakeSpiral` +- `MakeStairs` +- `GenerateTerrace` + +Interpretation: this is the cleanest staircase chain. `MakeSpiral` provides the +spine, `MakeStairs` hangs tread geometry on the spine, and `GenerateTerrace` +builds the surrounding rail/ground system. + +`DomaTower` depends on: + +- `PointWindowsFromEdges` +- `PointyGothicCone` +- `WindowWalls` +- `Generate Gothic Square Tower` + +Interpretation: domed towers are edge/window systems with gothic cone ornament. +The accepted `PointyGothicCone` translation is not isolated trivia; it is a +reused ornament organ in this tower family. + +`GenerateChurchBuildingB` depends on: + +- `Switch On Roof Type` +- `DistancingType` +- `ResampleEdgesAndSpawnWindowedWalld` +- `Is Edge Manifold` +- `Gothic SupportColumn From EDge` +- `GenerateWindowsFromEdges` +- `ChurchA-Front` +- `WindowWalls` + +Interpretation: church bodies are facade/edge pipelines. They resample edges, +spawn windowed walls, add gothic supports, and reuse the church front. + +`CreateGate` depends on: + +- `DoorTileFromArc` +- `Is Edge Manifold` +- `Spawn Normals on faces` +- `GenerateUpperWindowWithAlcove` +- `GetSteppeddirectionFrom position` +- `StonesOnSurface` +- `GenerateMedialAxisRectangleTopology` + +Interpretation: gates are topology-first structures. A medial-axis rectangle +topology lays out the plan; arcs and upper windows turn that skeleton into +visible architecture; stones finish surfaces. + +## Dependency Hubs + +Most reused groups: + +| Group | Callers | Role | +| --- | ---: | --- | +| `Is Edge Manifold` | 9 | edge-validity guard | +| `Switch On Roof Type` | 9 | roof/menu router | +| `Curve Info` | 7 | curve endpoint/root/tip facts | +| `Gothic SupportColumn From EDge` | 6 | gothic column organ | +| `Select Original Geometry After Edge Extrude` | 6 | post-extrude selection utility | +| `SetAutoSmooth` | 6 | surface finishing utility | +| `StonesOnSurface` | 6 | stone scatter/finish organ | +| `Generate Windows` | 5 | reusable window generator | +| `Curve Tip` | 4 | curve endpoint helper | +| `GenerateUpperWindowWithAlcove` | 4 | upper window organ | +| `GetPositionBasedSeed` | 4 | deterministic spatial seed helper | +| `RailsFromEdge` | 4 | rail organ | +| `Random Rotation` | 4 | randomized orientation helper | +| `WindowWalls` | 4 | window-wall organ | + +These hubs define the file's real language. Translating one thousand-node +composer before these hubs are mapped would be pure ceremony. + +## Feature Pressure + +Node-feature counts across groups: + +| Feature | Groups | Translation meaning | +| --- | ---: | --- | +| repeat zones | 35 | major blocker for accumulators and iterative topology | +| geometry-node gizmos | 31 | authoring/UI blocker, often mixed into large systems | +| foreach zones | 9 | blocker for element-wise geometry workflows | +| closures | 7 | Blender 5 closure/menu workflows need careful converter handling | +| menu switches | 17 | control-surface and socket-default pressure | +| capture attributes | 66 | attribute survival is central | +| store named attributes | 61 | named field/attribute contracts are central | + +Captures and stored attributes are not blockers; they are the bloodstream of the +file. Repeat, foreach, gizmo, and closure nodes are the hard toolchain pressure. + +## Materials And Assets + +The file has: + +- 502 objects. +- 56 materials. +- 23 collections. +- 16 `Collection Info` nodes. +- 45 `Object Info` nodes. +- 14 material interface sockets. +- 81 color interface sockets. +- 257 material assignment or material-selection nodes. + +Material usage is concentrated around a small palette: + +| Material | Node references | Role | +| --- | ---: | --- | +| `GroundFloorWalls` | 86 | dominant wall/base material | +| `Roof` | 42 | roof surfaces | +| `Beam` | 30 | timber and rail pieces | +| `UpperFloorsPaint` | 13 | painted alcove/window systems | +| `Greenery` | 9 | vegetation | +| `RoundWindwos` | 7 | round/gothic windows | +| `Copper` | 6 | domes and metal roof accents | +| `FakeRoof` | 6 | alternate roof material | +| `WindowGlass` | 4 | glass | +| `Rock` | 4 | stones/terrain | + +Important material sockets: + +- `DomaTower.DomeMaterial -> Copper` +- `Geometry Nodes.002.DomeMaterial -> FakeRoof` +- `GenerateAlcoveWindows.AlcoveMaterial -> UpperFloorsPaint` +- `GenerateDoorsWithAlcove.AlcoveMaterial -> UpperFloorsPaint` +- `GenerateUpperWindowWithAlcove.AlcoveMaterial -> UpperFloorsPaint` +- `Wooden Bridge.Material -> Beam` +- `Fence Type A.Material -> Beam` +- `Generate Cliff Type 2.Walls Material -> Cliff2Walls` +- `Generate Cliff Type 2.Top Ground Materials -> Cliff2Top` + +Collection dependencies: + +| Collection | Used by | Meaning | +| --- | --- | --- | +| `Bricks` | `MakeStairs`, `StonesOnSurface` | instanced brick/stone assets | +| `BouldersSet` | `Geometry Nodes.001` | landscape scatter assets | +| `Paths` | `Geometry Nodes.001` | landscape/path interaction | +| `Plants` | `Generate Cliff Type 2` | cliff vegetation scatter | +| `RiverBank` | `Make River` | riverbank geometry | + +Most `Object Info` nodes have no default object set. The one explicit object +reference observed is `DoorTileFromArc`, used by an object-info node as an +asset handle. + +Interpretation: material and collection state is part of the procedural +contract. A translation that matches vertices while dropping materials, +collections, or color sockets may preserve shape but not the authored city kit. + +## Accepted Footholds + +`MakeSpiral -> VG Make Spiral` + +- Role: architectural spine. +- Verified with 200 ordered curve points at max delta `0.0`. +- Used by `GenerateStairCase`. + +`PointyGothicCone -> VG Pointy Gothic Cone` + +- Role: roof/gothic ornament grown from an input point host. +- Verified with plain and detailed cases at sorted max delta `0.0`. +- Used by `DomaTower`, `Gothic SupportColumn From EDge`, and + `PointWindowsFromEdges`. + +## Current Toolchain State + +The Geometry Script fork now emits compiling `nodes_to_script` drafts for these +IRCSS targets: + +- `MakeSpiral` +- `PointyGothicCone` +- `GenerateArc` +- `MakeStairs` +- `GenerateStairCase` +- `GenerateBricks` +- `GenerateMedialAxisRectangleTopology` +- `GenerateWindowsFromEdges` +- `Pole` +- `Round Bottom` +- `WindowBeams` + +This only proves the converter can produce syntactically valid drafts. It does +not prove runtime graph construction or behavioral equivalence. The drafts are +source probes, not house style. + +## Translation Strategy + +The next useful city-organ translations should come from dependency hubs or +clean chains, not top-level composers. + +Best next candidates: + +| Candidate | Why it matters | Risk | +| --- | --- | --- | +| `GenerateArc` | core arch primitive for gates, doors, and gothic systems | large but non-zone | +| `MakeStairs` | direct child of `GenerateStairCase`; now has compiling draft | closures and collection asset dependency | +| `GenerateStairCase` | clean chain proving spine -> treads -> terrace | depends on `MakeStairs` and `GenerateTerrace` | +| `Switch On Roof Type` | tiny, heavily reused roof router | menu contract must be preserved | +| `Is Edge Manifold` | tiny, heavily reused guard | duplicate source names need disambiguation | +| `GenerateUpperWindowWithAlcove` | reused by towers, gates, alcove windows | 128 nodes, nested dependencies | +| `Generate Windows` | reused facade organ | 188 nodes but no zone blocker | + +Avoid as first next targets: + +- `CreateGate`, `GenerateHouse`, `GenerateChurchBuildingB`, `Generate Tower`, + `Generate Square Tower`, `ChurchFrontTowers`, `WindMill`: too much composer + surface before their organs are mapped. +- Repeat/foreach/gizmo-heavy systems unless the explicit goal is toolchain + support. +- Empty-output harnesses such as the rejected `WindowBeams` case. + +## What Is Still Not Understood + +- Exact visual appearance of every modifier root under render lighting. +- Runtime behavior of all converter drafts; compile success is only the first + gate. +- Repeat-zone state semantics for topology accumulators. +- Foreach-zone semantics for edge/window/wall systems. +- Geometry-node gizmo behavior as editable authoring controls. +- How unset object/collection inputs are meant to be supplied by modifier users + in every root object. + +This is enough understanding to choose translation targets intelligently. It is +not enough to claim the whole town can be regenerated from script. diff --git a/docs/research/translations/ircss-french-houses.md b/docs/research/translations/ircss-french-houses.md index f4f939a..568b385 100644 --- a/docs/research/translations/ircss-french-houses.md +++ b/docs/research/translations/ircss-french-houses.md @@ -10,6 +10,8 @@ - `PointyGothicCone` - Geometry Script recreation: `examples/geometry_script/ircss_french_houses.py` +- File-level system map: + `docs/research/translations/ircss-french-houses-system-map.md` ## Why This File diff --git a/notes/fresh-workspace-handoff.md b/notes/fresh-workspace-handoff.md index e4d7da7..eb9dcfc 100644 --- a/notes/fresh-workspace-handoff.md +++ b/notes/fresh-workspace-handoff.md @@ -49,7 +49,8 @@ repeat-zone feedback state, repeat `Top` boolean outputs, foreach zones, gizmo nodes, and a rejected empty-output harness for `WindowBeams`. The previous `nodes_to_script` duplicate-key failure around axes-to-rotation is fixed in the Geometry Script fork, so `GenerateArc` and `MakeStairs` now have compiling -converter drafts. +converter drafts. The file-level dependency map lives at +`docs/research/translations/ircss-french-houses-system-map.md`. Current authoring prior: use the full Python stack. Python structures intent, tables, loops, variants, cleanup, validation, docs, and scene/render diff --git a/state/evidence.jsonl b/state/evidence.jsonl index b2c1f9f..eaf7caa 100644 --- a/state/evidence.jsonl +++ b/state/evidence.jsonl @@ -30,3 +30,4 @@ {"ts": "2026-05-04T18:01:03+00:00", "type": "maintenance", "status": "accepted", "note": "Distilled persistent state: handoff now points to corpus docs instead of duplicating completed graph lists; implementation plan reflects post-corpus contract and IRCSS frontier; compaction helper warns on bloated handoff and stale first-corpus planning."} {"ts": "2026-05-04T19:01:27+00:00", "type": "verification", "status": "accepted", "note": "Added IRCSS PointyGothicCone translation as VG Pointy Gothic Cone; plain and ornamented harness cases match source evaluated geometry with sorted max vertex delta 0.0, proving ornament can be grown from captured structural ribs after instancing."} {"ts": "2026-05-04T19:05:41+00:00", "type": "tooling", "status": "accepted", "note": "Patched Geometry Script nodes_to_script on branch vibegeometry/blender-5-nodes-to-script to drop duplicate property keywords when a same-named input socket exists; GenerateArc and MakeStairs now compile from converter drafts, and expanded IRCSS smoke passes for 11 target groups."} +{"ts": "2026-05-04T22:03:08+00:00", "type": "research", "status": "accepted", "note": "Mapped IRCSS French Houses at file level: 108 node groups, 63 modifier roots, 163 dependency edges, composer/organ/utility hierarchy, dependency hubs, blocker feature counts, and next target candidates. Inspector now records nested GeometryNodeGroup node_tree references."} diff --git a/state/map.yaml b/state/map.yaml index ddcdd4c..ca145bd 100644 --- a/state/map.yaml +++ b/state/map.yaml @@ -68,6 +68,7 @@ current_artifacts: - docs/architecture/pipeline-overview.md - docs/research/procedural-doctrine.md - docs/research/geometry-script-fork-notes.md + - docs/research/translations/ircss-french-houses-system-map.md tools: - tools/vibegeometry_state.py - tools/vibegeometry_prepare_compaction.py @@ -91,7 +92,7 @@ data_flow: - If state grows faster than understanding, cut it back. current_status: - summary: VibeGeometry has an initial persistence scaffold plus verified Geometry Script translations for local math/utility samples, a first official Blender demo tranche, and two IRCSS French Houses city-scale footholds. The IRCSS pass verified MakeSpiral as an architectural spine and PointyGothicCone as ornament grown from a structural host, while mapping blockers in larger systems: repeat-zone feedback, repeat Top outputs, foreach zones, and gizmo nodes. The repo-local Geometry Script fork includes a Blender 5.1 nodes_to_script converter port plus nested-group, menu-socket, and duplicate-key fixes needed by these translations. + summary: VibeGeometry has an initial persistence scaffold plus verified Geometry Script translations for local math/utility samples, a first official Blender demo tranche, and two IRCSS French Houses city-scale footholds. The IRCSS pass verified MakeSpiral as an architectural spine and PointyGothicCone as ornament grown from a structural host, and now includes a file-level dependency map of the 108-group town kit. The remaining large-system blockers are repeat-zone feedback, repeat Top outputs, foreach zones, and gizmo nodes. The repo-local Geometry Script fork includes a Blender 5.1 nodes_to_script converter port plus nested-group, menu-socket, and duplicate-key fixes needed by these translations. next_action: Continue IRCSS French Houses by using the newly compiling GenerateArc/MakeStairs converter drafts as candidates for the next city-organ translation, or select another non-zone architectural helper with a non-empty behavioral harness. remotes: vibegeometry: https://github.com/GameCult/VibeGeometry diff --git a/tools/inspect_blend_node_groups.py b/tools/inspect_blend_node_groups.py index 05a22c2..1aba7dd 100644 --- a/tools/inspect_blend_node_groups.py +++ b/tools/inspect_blend_node_groups.py @@ -95,7 +95,7 @@ def _node_summary(node: Any) -> dict[str, Any]: continue if value is None or isinstance(value, (str, int, float, bool)): properties[prop.identifier] = value - return { + summary = { "name": node.name, "label": node.label, "bl_idname": node.bl_idname, @@ -105,6 +105,10 @@ def _node_summary(node: Any) -> dict[str, Any]: "inputs": [_socket_summary(socket) for socket in node.inputs], "outputs": [_socket_summary(socket) for socket in node.outputs], } + node_tree = getattr(node, "node_tree", None) + if node_tree is not None: + summary["node_tree"] = getattr(node_tree, "name", "") + return summary def _link_summary(link: Any) -> dict[str, str]: