parameter registry: scientific naming - genus.species, full definitions, no bare values

docs/PARAMETER-REGISTRY.md

@@ -0,0 +1,35 @@
+# Parameter Registry — Naming Convention
+
+Scientific style: every parameter carries its genus (which system owns it)
+and its species (what it does). `genus.species` — like Homo sapiens, the
+name alone places the thing in the world.
+
+Rules:
+1. Software references ONLY the short name (`genus.species`).
+2. Every short name is registered with a full-sentence definition.
+3. No bare values anywhere in code — a number never appears without its name.
+4. Values live as registry rows (data), revisable, history logged per change.
+
+## Registered parameters
+
+### hebbian (activation learning)
+- `hebbian.warmth-per-use` — How much each use strengthens a memory toward +1.
+- `hebbian.cool-off` — Days ignored before warmth fades to half.
+
+### validity (truth-now)
+- `validity.fade` — How fast unasserted truth cools toward doubt.
+
+### groundedness (evidence)
+- `groundedness.staleness` — How old evidence gets before it stops counting fresh.
+
+### memory (time-sense)
+- `memory.recent-horizon` — What still counts as "recently," in days.
+
+### retrieval (attention during search)
+- `retrieval.opinion-volume` — How much louder judgment speaks than word-matching.
+- `retrieval.surface-line` — Lowest score worth showing to anyone.
+- `attention.spotlight` — How many things can be shown at once.
+
+### pulse (the float)
+- `pulse.float-size` — How much raw experience fits in the loop at once.
+- `pulse.forget-after` — How long raw experience lasts before evaporating.

docs/architecture/README.md

@@ -1090,3 +1090,10 @@ Never build a rung before standing on the previous one.
     not home. Zero is the tunnel: the narrow balance point you pass
     THROUGH while discerning what's real from what's not — suspended
     judgment mid-crossing — then you emerge on one side and live there.
+39. No scalar constants exist in this system. Every quantity that means
+    anything is a signed dimensional reading, contextual and fuzzy.
+    Even driver parameters — decay clocks, learning rates, thresholds —
+    are configuration DATA owned by their dimensions, revisable like
+    rules: never physical truths. A bare number floating outside a
+    dimension is an abstraction with no authority here. Right itself is
+    irrational: approximated to tolerance, never terminated.