3.8 KiB
M10-04 Status
status: done task: Geometry Nodes field/domain materialization budgets updated: 2026-08-16 America/New_York
Scope
Field materialization schema 1 binds every request to a graph ID/hash, Main revision, source and target domain, data type, transport, and an exact seven-domain cardinality snapshot. The parser derives element, scalar, and byte counts rather than accepting caller-provided counts. JSON never carries field values in this contract; the current native Depsgraph path only publishes a small verified point-Float payload.
This task establishes budgets and transport boundaries. It does not claim actual evaluation for arbitrary POINT/EDGE/FACE/CORNER/CURVE/INSTANCE/LAYER conversions, complete Blender lazy-function semantics, graph writing, or Simulation Zones.
Budgets
- Domain maxima: POINT 1,000,000; EDGE/FACE 2,000,000 each; CORNER 4,000,000; CURVE/INSTANCE 100,000 each; LAYER 4,096.
- Batch maxima: 64 fields, 32 real domain conversions, 4,000,000 target elements, and 64 MiB of materialized data.
- Per-field JSON maximum: 65,536 scalar values. Larger fields must stay binary or
return
GN_FIELD_JSON_BUDGET_EXCEEDED. - Supported bounded layouts are Boolean, Int, Float, Vector, and Color. Element, component, and byte multiplication is checked before a receipt is returned.
Native Contract
The full-Main Depsgraph reports exact POINT/EDGE/FACE/CORNER cardinality from the
evaluated Blender Mesh and zeroes the non-Mesh domains for the current fixture. The
observable m10_value point-Float attribute carries schema version, element/scalar
counts, materialized byte length, and transport. The TypeScript parser cross-checks
the receipt against mesh vertex count, domain cardinality, the Float32 byte layout,
and the actual attribute payload. Unknown receipt fields and hidden JSON arrays are
rejected.
Evidence
WEB_TEST_PORT=5448 npm --prefix web run test:geometry-node-field-budget: unit 6/6 and real Chromium Worker 1/1 passed.- The real
M10GN_StoreAttributeevaluated mesh reported cardinality POINT/EDGE/FACE/CORNER8/12/6/24, schema 1, eight Float scalars, 32 bytes, and eight values equal to0.375. - Chromium negative checks rejected POINT cardinality drift, byte-length drift, and
a hidden
valuesarray in the receipt. - M10-01/02/03 regressions passed on ports 5449/5450/5451. M10-03 still covers all 16 allowlisted nodes across 11 desktop/full-Main WASM/Chromium cases with zero maximum and RMS position error.
- Full unit suite 133/133, typecheck, lint, production build (73 modules), local
dependency checks,
git diff --check, and the three-fixture 100-iteration Depsgraph regression passed.
The first Chromium rerun on port 5447 was not accepted as evidence: the negative
check used a browser-relative dynamic import that resolved to a nonexistent
/protocol/depsgraph.ts. The check was moved to Playwright's Node-side static import,
then the complete task command was rerun on port 5448.
Implementation Hashes
- Geometry Nodes protocol:
8d04291c29e9ce30e3f2f6d4141bc4101d49529bf7f7edf109d67d059efa58b1. - Depsgraph protocol:
df7e0e29422f5b605f20fd5ab939d170d35048020968d2f6aea86603d0633cd6. - Native Depsgraph:
5bcc17416fd4d45985bc1529288127b9eeed4a30b47836e687dc5321182c0b11. - Unit test:
1aa4df021731d7ba4c4191d56f88c663b223443f78c9fdc1b88c2a43423239c7. - Chromium spec:
95d8380d6a17a5b85df695a3cb850dffa8705f574ae0b9c97422bb802899eb8e. - Full-Main WASM:
1bb4a947da4332471f3d7bab8f3f628c83d1703244093a554a188668ddafafd7.
Rollback
Remove the field materialization schema/parser, native Depsgraph cardinality and receipt fields, M10-04 unit/Chromium checks, package script, and this status file together. Revert the M10 count to 3/15; do not leave the native attribute JSON path without its receipt and cardinality validation.