Map IRCSS French Houses system structure

This commit is contained in:
Meta Vens 2026-05-04 23:04:36 +01:00
commit 216fe77589
7 changed files with 320 additions and 3 deletions

View file

@ -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

View file

@ -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.

View file

@ -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

View file

@ -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

View file

@ -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."}

View file

@ -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

View file

@ -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]: