Finished up most documentation

spikes/card-harness/CURRENT-DEFAULTS.md

@@ -6,10 +6,19 @@
 - Approved: September 7, 2026
 - Scope: card geometry, front-face materials, substrate distinction, foil, holographic response, and current finish-mask policy
 - Follow-up approval: rigid pack prototype and artifact-free individual card inspection; retained as the foundation for the foil iteration below
+- Linen follow-up: `linen-relief-v1-2026-09-10`, visually approved September 10, 2026
+- Metal and wood follow-up: `metal-wood-relief-v1-2026-09-10`, visually approved September 10, 2026
 - Not yet approved: the new foil treatment/choreography, lighting presets, mobile performance, or wear
 
 These values represent the current visual baseline. Changes should be deliberate and compared against this revision rather than treated as incidental shader cleanup.
 
+The approved September 10 depth follow-ups supersede the v4 linen, metal, and wood
+surface responses below: raised-looking weave, recessed metal etching, and raised
+wood grain with shader parallax, including Printed ink at oblique angles.
+Paper, Plastic, card geometry, backs, and renderer settings retain the v4 baseline.
+This visual approval is not
+a mobile performance sign-off or approval of the remaining pack choreography.
+
 ## Geometry
 
 The card is generated procedurally at runtime. Blender and GLB files are not required.
@@ -128,10 +137,21 @@ Finish and material are independent concepts, but combinations should exist only
 
 - Roughness floor: `0.70`
 - Interlaced thread frequency: `52 x 73`
-- Relief amplitude: `0.005 * detail`
-- Reflection strength: `0.025`
+- Raised weave height span: `0.010 * min(detail, 1.5)` scene units
+- Analytic thread slopes keep normal response readable at oblique angles
+- Two procedural weave evaluations add bounded view-dependent parallax; artwork,
+  finish-mask, and wear UVs stay anchored
+- Grazing denominator floor: `0.30`; detail is capped at `1.5` for linen relief
+- Subpixel threads fade using screen-space derivatives
+- Base reflection strength: `0.025`; broad thread-ridge highlight strength:
+  `0.025 + 0.055 * grazing`, modulated by resolved ridge height and surface detail
 - Edge: `#a89772`, roughness `0.78`, metalness `0`, clear coat `0`
 
+This is shader relief, not displaced geometry: the card silhouette and physical
+thickness are unchanged. The Surface detail control scales the effect, including
+turning it off at zero. Printed ink retains the thread lighting without requiring
+a foil finish; foil and holographic coating formulas are unchanged.
+
 ### Plastic
 
 - Roughness ceiling: `0.25`
@@ -142,9 +162,13 @@ Finish and material are independent concepts, but combinations should exist only
 
 ### Metal
 
+- Visually approved September 10, 2026
 - Roughness ceiling: `0.20`
 - Artwork-driven etch: darker values are recessed more deeply
-- Etch relief amplitude: `-0.0065 * depth * min(detail, 1.5)`
+- Etch relief amplitude: `-0.010 * depth * min(detail, 1.5)` (previously `-0.0065`)
+- Bounded predictor/corrector parallax shifts artwork and finish mask together;
+  grazing denominator floor `0.35`, fading within `0.025` UV of the card edges
+- Directional recess shadow strength: `0.22`, scaled by detail and local ridge depth
 - Cavity shading: `0.12` on the metal underprint and `0.06` on the combined printed result
 - Metal underprint blend: `0.42`
 - Edge: `#a8adb7`, roughness `0.20`, metalness `0.86`, clear coat `0.18`
@@ -158,11 +182,18 @@ Metal + Foil is a special intentional combination:
 - Plating weight is capped at `0.34`
 - Must not turn the illustration into opaque gold
 
+Parallax and directional recess shading add depth cues beyond the stronger relief.
+The existing underprint tint and foil/plating recipes are retained; the finish
+mask follows the shifted artwork. Card thickness and geometry are unchanged.
+
 ### Wood
 
+- Visually approved September 10, 2026
 - Roughness floor: `0.48`
 - Warped longitudinal grain frequency: `170`
-- Relief amplitude: `0.007 * detail`
+- Relief amplitude: `0.012 * min(detail, 1.5)` (previously `0.007 * detail`)
+- Two procedural grain evaluations provide bounded parallax; grazing denominator
+  floor `0.35`. Artwork stays anchored; tint and relief use the same shifted grain.
 - Warm tint blend: `0.25`
 - Reflection strength: `0.09`
 - Edge: `#6b3f21`, roughness `0.56`, metalness `0`, clear coat `0.08`