feat: witness ID-property delete and USD evaluation_mode

Witness the custom ID-property delete contract and wm.usd_export evaluation_mode RENDER vs VIEWPORT.

Author: TMHSDigital

.cursor-plugin/plugin.json

@@ -67,6 +67,7 @@
     "examples/collision-hull-proxy",
     "examples/color-attribute-wheel",
     "examples/compositor-glare",
+    "examples/cross-version-property-delete",
     "examples/curve-bevel-arc",
     "examples/custom-normals-shade",
     "examples/damped-track-aim",
@@ -99,6 +100,7 @@
     "examples/text-version-stamp",
     "examples/triangulate-tangents",
     "examples/turntable",
+    "examples/usd-export-evaluation-mode",
     "examples/uv-layer-grid",
     "examples/vertex-color-ao",
     "examples/vertex-weight-limit",

AGENTS.md

@@ -20,7 +20,7 @@ a `.cursor-plugin/plugin.json` manifest so the ecosystem drift checker
 classifies it as a `cursor-plugin`. This is content the AI loads when the user
 asks Blender questions or works on Blender add-ons in Cursor or Claude Code.
 
-The content base is 13 skills, 6 rules, 2 templates, 17 snippets, and 45
+The content base is 13 skills, 6 rules, 2 templates, 17 snippets, and 47
 examples (counts are CI-enforced against README.md and the manifest). The full
 inventory tables and per-item purposes live in `CLAUDE.md`. Example anatomy
 and authoring rules: copy `examples/bmesh-gear/`; the render look is specified
@@ -35,7 +35,7 @@ Blender-Developer-Tools/
   rules/<rule-name>.mdc          # 6 rule files
   templates/<template-name>/     # 2 starter templates
   snippets/<snippet-name>.py     # 17 standalone Python snippets
-  examples/<name>/               # 45 runnable smoke-gated examples (+ gallery.json)
+  examples/<name>/               # 47 runnable smoke-gated examples (+ gallery.json)
   examples/gallery_framing.py    # shared Layer 1 framing measurement (render path only)
   scripts/build_gallery.py       # generates docs/gallery/ (stdlib only)
   scripts/site/                  # vendored landing-page build (build_site.py + template)

CLAUDE.md

@@ -21,7 +21,7 @@ skills/<skill-name>/SKILL.md   - AI workflow definitions, 13 total
 rules/<rule-name>.mdc          - Anti-pattern rules, 6 total
 templates/<template-name>/     - Starter projects, 2 total
 snippets/<snippet-name>.py     - Standalone code patterns, 17 total
-examples/<name>/               - Runnable smoke-gated examples, 45 total (+ gallery.json)
+examples/<name>/               - Runnable smoke-gated examples, 47 total (+ gallery.json)
 scripts/build_gallery.py       - Regenerates docs/gallery/ from gallery.json (stdlib only)
 scripts/site/                  - Vendored landing-page build (Jinja2)
 docs/gallery/                  - Committed generated gallery pages + hero renders
@@ -83,7 +83,7 @@ v0.1.0: canonical object creation and deletion, depsgraph evaluated mesh, bmesh
 
 v0.2.0: Principled BSDF material, driver-with-custom-function via `driver_namespace`, application handler registration, shader node group with cross-version `interface` API, `foreach_get` bulk vertex read, version-branch skeleton, and USD export with `evaluation_mode='RENDER'`.
 
-## Examples (45)
+## Examples (47)
 
 Runnable scripts at `examples/<name>/`, each asserting a real API contract with
 deterministic checks (exit non-zero on failure) and optionally rendering a still via

README.md

@@ -18,7 +18,7 @@
 </p>
 
 <p align="center">
-  <strong>13 skills</strong> &nbsp;&bull;&nbsp; <strong>6 rules</strong> &nbsp;&bull;&nbsp; <strong>2 templates</strong> &nbsp;&bull;&nbsp; <strong>17 snippets</strong> &nbsp;&bull;&nbsp; <strong>45 examples</strong>
+  <strong>13 skills</strong> &nbsp;&bull;&nbsp; <strong>6 rules</strong> &nbsp;&bull;&nbsp; <strong>2 templates</strong> &nbsp;&bull;&nbsp; <strong>17 snippets</strong> &nbsp;&bull;&nbsp; <strong>47 examples</strong>
 </p>
 
 <p align="center">
@@ -36,7 +36,7 @@
 
 ## Overview
 
-This repository ships **13 skills, 6 rules, 2 templates, 17 snippets, and 45 runnable examples** for Blender Python development targeting Blender 5.2 LTS (current stable) with Blender 4.5 LTS fallback support. Blender 5.1 is prior stable.
+This repository ships **13 skills, 6 rules, 2 templates, 17 snippets, and 47 runnable examples** for Blender Python development targeting Blender 5.2 LTS (current stable) with Blender 4.5 LTS fallback support. Blender 5.1 is prior stable.
 
 The content is consumed by AI coding agents (Cursor, Claude Code, any MCP-capable client) when working on Blender add-ons, geometry nodes scripts, batch pipelines, or animation tooling. There is no build step. Edit the markdown and Python files directly.
 
@@ -203,7 +203,7 @@ Gallery still is a dual-elevation diptych so the contract reads at thumbnail sca
 </details>
 
 <details>
-<summary><strong>Mesh, curves &amp; text</strong> — 10 examples</summary>
+<summary><strong>Mesh, curves &amp; text</strong> — 11 examples</summary>
 
 <table>
 <tr>
@@ -308,6 +308,21 @@ A depsgraph-evaluated export — builds a cube with `SUBSURF`, measures the eval
 `evaluated_get().to_mesh()` / `to_mesh_clear()`, and asserts `wm.obj_export` ships the
 modifier-applied geometry (exported vertex count == evaluated > base).
 
+</td>
+</tr>
+<tr>
+<td width="46%" valign="middle">
+<a href="examples/usd-export-evaluation-mode/"><img src="examples/usd-export-evaluation-mode/preview.webp" alt="USD export evaluation_mode: two steel SUBSURF cubes on a dark studio floor — left faceted viewport tessellation, right smoother render tessellation, warm wedge on the back wall" /></a>
+</td>
+<td valign="middle">
+
+### [usd-export-evaluation-mode](examples/usd-export-evaluation-mode/)
+
+`wm.usd_export` `evaluation_mode='RENDER'` versus `'VIEWPORT'`. TESSELLATE writes
+the closed-form Catmull-Clark counts (26/24 vs 98/96); default BEST_MATCH writes
+the 8-vert cage and the mode is silent. Asserts the USDA point counts, not the
+still.
+
 </td>
 </tr>
 <tr>
@@ -496,7 +511,7 @@ and every orbit lands on its closed form.
 </details>
 
 <details>
-<summary><strong>Context &amp; Grease Pencil</strong> — 3 examples</summary>
+<summary><strong>Context &amp; Grease Pencil</strong> — 4 examples</summary>
 
 <table>
 <tr>
@@ -511,6 +526,20 @@ Three unit cubes joined into a staircase under `bpy.context.temp_override` — t
 replacement for the removed `context.copy()` dict-pass form. Asserts one mesh remains,
 sources are gone, and local Z spans all three steps.
 
+</td>
+</tr>
+<tr>
+<td width="46%" valign="middle">
+<a href="examples/cross-version-property-delete/"><img src="examples/cross-version-property-delete/preview.webp" alt="Cross-version property delete: two brass specimen tags on a dark studio stand — left tag with a cyan emissive enamel inlay (ID property kept), right tag with an empty grey pocket (ID property deleted)" /></a>
+</td>
+<td valign="middle">
+
+### [cross-version-property-delete](examples/cross-version-property-delete/)
+
+Custom ID properties are removed with `del id_block[key]`, not `property_unset`.
+IDs are built with `bpy.data.objects.new` — the snippet `__main__` keys off
+`active_object` and is dark headless. Same `del` on 4.5 LTS and 5.x.
+
 </td>
 </tr>
 <tr>

ROADMAP.md

@@ -91,6 +91,9 @@ Audit pass on v0.1.0 content: standards-version markers bumped from `1.9.1` to `
 
 Not committed; target list for the next content version. (v0.3.0 shipped the smoke-gated `examples/` track.)
 
+- ~~Custom ID-property delete witness~~ **SHIPPED** as `examples/cross-version-property-delete/` — IDs built via `bpy.data.objects.new` (not `active_object`); `property_unset` is TypeError and leaves the key; `del` removes it on 4.5 LTS and 5.x
+- ~~USD export evaluation_mode witness~~ **SHIPPED** as `examples/usd-export-evaluation-mode/` — probed `wm.usd_export` on CI Linux portables 5.2.1 (`9e2066aef7ef`) and 4.5.13 (`daeeeca98fb0`); TESSELLATE+VIEWPORT 26/24, TESSELLATE+RENDER 98/96; BEST_MATCH writes the 8-vert catmullClark cage so the mode is silent
+- Tighten inverted smoke canaries: assert the expected `[FAIL]` marker text (`skipped on ... should run` / `missing post-exit sidecar`) alongside wrapper exit 1, so a canary that dies for the wrong reason does not satisfy the gate
 - ~~Fleet Pages facelift + examples support~~ **RESOLVED differently (2026-07-03)**: the meta-repo migration was dropped — the fleet template only scaffolds new tools, and each tool's site evolves independently after that. This repo vendored the site build into `scripts/site/`, redesigned landing + gallery as the Blender-viewport system (see `docs/gallery/DESIGN_NOTES.md`), added the examples grid, nav link, and full hero stats locally. `scripts/build_gallery.py` and `examples/gallery.json` are now permanent, not a prototype awaiting lift-and-shift.
 - `modal-operators` skill -- `invoke` returning `RUNNING_MODAL`, the `modal()` event handler, modal cancellation patterns
 - `usd-pipelines` skill -- USD export options, `evaluation_mode`, instancing, the USD vs glTF tradeoffs