@@ -63,7 +63,7 @@ matching its `globs` does. Changing a glob changes when the rule fires.
 | always-free-bmesh | `*.py` | `bmesh.new()` without paired `bm.free()` in a `try`/`finally` block |
 | target-extensions-platform-format | Add-on roots | Legacy `bl_info` only add-ons missing `blender_manifest.toml` |
 | type-annotate-props-and-defend-context | `*.py` | `bpy.props` defined as assignments, unguarded `context.active_object` |
-| prefer-temp-override-over-context-copy | `*.py` | `bpy.context.copy()` passed to operators (deprecated 4.x, removed 5.x) |
+| prefer-temp-override-over-context-copy | `*.py` | `bpy.context.copy()` passed to operators (deprecated 3.2, removed 4.0) |
 | use-foreach-set-for-bulk-data | `*.py` | Python loops over `mesh.vertices` setting bulk attributes one at a time |
 | validate-imported-mesh-scale | `*.py` | glTF/FBX import then mesh work with no `transform_apply` and no unit-scale check |
 | no-unapplied-modifiers-on-export | `*.py` | Export with live modifiers when the export does not request evaluated geometry |
 
@@ -2,6 +2,8 @@
 
 _Audit date: 2026-06-20 · Repo @ v0.5.0 · Auditor: Principal Eng review_
 
+> **Historical.** The audit sections describe the repository as of v0.5.0 and are kept as a record; counts and file references in them are not current. Only "Findings the release notes did not list" below is a standing, maintained log.
+
 ## Findings the release notes did not list
 
 _Standing log. Notes-derived 5.1→5.2 (and later) deltas are incomplete by default._
 
@@ -196,11 +196,11 @@ api_key = prefs.api_key
 ## Why "just use Python attributes" does not work
 
 ```python
-# WRONG: this attribute does not survive save and load.
+# WRONG: raises AttributeError: 'Scene' object has no attribute 'my_intensity'
 bpy.context.scene.my_intensity = 1.5
 ```
 
-Properties attached as plain Python attributes to a Blender datablock are not serialized into the `.blend` file. The .blend file format only saves registered `bpy.props`. Reload the file and the value is gone.
+Blender datablocks do not accept arbitrary Python attributes: the assignment fails immediately, on 4.5 LTS and 5.x alike. Only registered `bpy.props` (or ID properties set with `scene["key"] = value`) exist on a datablock and are saved into the `.blend` file.
 
 This is a frequent AI mistake when generating quick scripts. Always wrap state in a `PropertyGroup` bound via `PointerProperty` if it must persist.
 
@@ -218,9 +218,11 @@ This is a frequent AI mistake when generating quick scripts. Always wrap state i
 2. **Storing complex state on Python attributes**:
 
    ```python
-   scene.my_data = {"items": [...]}  # gone after save and reload
+   scene.my_data = {"items": [...]}  # AttributeError: not a registered property
    ```
 
+   Ad-hoc ID properties (`scene["my_data"] = ...`) do save, but they are untyped and invisible to the UI; use a `PropertyGroup` for anything an add-on owns.
+
 3. **Wrong unregister order** (unregister class before deleting binding) -> crash on save.
 
 4. **Binding individual properties directly to Scene** instead of grouping into a `PropertyGroup`. Hard to unregister cleanly, pollutes the namespace.
 
@@ -28,15 +28,15 @@ Use this skill when the user:
 import bpy
 
 
-class MESH_OT_extrude_normal(bpy.types.Operator):
-    bl_idname = "mesh.extrude_normal"
-    bl_label = "Extrude Along Normal"
-    bl_description = "Extrude active mesh by a fixed amount along its normal"
+class MESH_OT_offset_along_normals(bpy.types.Operator):
+    bl_idname = "mesh.offset_along_normals"
+    bl_label = "Offset Along Normals"
+    bl_description = "Move every vertex of the active mesh a fixed distance along its normal"
     bl_options = {'REGISTER', 'UNDO'}
 
     distance: bpy.props.FloatProperty(
         name="Distance",
-        description="How far to extrude",
+        description="How far to move each vertex",
         default=0.5,
         min=-100.0,
         max=100.0,
@@ -54,14 +54,20 @@ class MESH_OT_extrude_normal(bpy.types.Operator):
             self.report({'ERROR'}, "No active object")
             return {'CANCELLED'}
 
-        # Operate on bpy.data, not bpy.ops, in tight loops.
-        # See the mesh-editing-and-bmesh skill for the full pattern.
+        # Operate on bpy.data, not bpy.ops, and in bulk: one foreach_get /
+        # foreach_set pair instead of a Python loop over mesh.vertices (rule
+        # use-foreach-set-for-bulk-data). See the mesh-editing-and-bmesh skill.
         mesh = obj.data
-        for v in mesh.vertices:
-            v.co += v.normal * self.distance
+        n = len(mesh.vertices)
+        co = [0.0] * (n * 3)
+        nor = [0.0] * (n * 3)
+        mesh.vertices.foreach_get("co", co)
+        mesh.vertices.foreach_get("normal", nor)
+        d = self.distance
+        mesh.vertices.foreach_set("co", [c + k * d for c, k in zip(co, nor)])
 
         mesh.update()
-        self.report({'INFO'}, f"Extruded {len(mesh.vertices)} vertices by {self.distance:.3f}")
+        self.report({'INFO'}, f"Offset {n} vertices by {d:.3f}")
         return {'FINISHED'}
 ```
 
@@ -71,7 +77,7 @@ class MESH_OT_extrude_normal(bpy.types.Operator):
 | --- | --- | --- | --- |
 | `poll(cls, context)` | Optional | Every UI redraw to decide if the operator is enabled. Must be cheap. | `True` to enable, `False` or falsy to disable |
 | `invoke(self, context, event)` | Optional | The user triggers the operator interactively (button, menu, keymap). Default forwards to `execute`. | `{'FINISHED'}`, `{'CANCELLED'}`, `{'PASS_THROUGH'}`, `{'RUNNING_MODAL'}` |
-| `execute(self, context)` | Yes | The operator runs, either after `invoke` or directly via `bpy.ops.mesh.extrude_normal()` | `{'FINISHED'}` or `{'CANCELLED'}` |
+| `execute(self, context)` | Yes | The operator runs, either after `invoke` or directly via `bpy.ops.mesh.offset_along_normals()` | `{'FINISHED'}` or `{'CANCELLED'}` |
 | `modal(self, context, event)` | Optional | After `invoke` returns `{'RUNNING_MODAL'}`. Called for each event until you return `{'FINISHED'}` or `{'CANCELLED'}`. | Standard return set |
 | `draw(self, context)` | Optional | The redo panel after the operator runs. Defaults to drawing all properties. | None |