registry: three names per parameter - technical, short, full

docs/PARAMETER-REGISTRY.md

@@ -5,31 +5,34 @@ 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`).
+1. Every parameter has THREE names, all registered:
-2. Every short name is registered with a full-sentence definition.
+   - **Technical name** — the machine-precise constant (e.g. `HEBBIAN_LEARN_RATE_DAYS_30`), kept for grep, logs, stack traces, and interop with plain code.
-3. No bare values anywhere in code — a number never appears without its name.
+   - **Short name** — `genus.species`, human-readable; what the software references day to day.
+   - **Full name** — the complete sentence describing exactly what it is.
+2. All three resolve to the same registry row; changing the value changes it everywhere at once.
+3. No bare values anywhere in code — a number never appears without its technical 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.warmth-per-use` — tech: `HEBBIAN_WARMTH_PER_USE` — How much each use strengthens a memory toward +1.
-- `hebbian.cool-off` — Days ignored before warmth fades to half.
+- `hebbian.cool-off` — tech: `HEBBIAN_COOL_OFF_DAYS` — Days ignored before warmth fades to half.
 
 ### validity (truth-now)
-- `validity.fade` — How fast unasserted truth cools toward doubt.
+- `validity.fade` — tech: `VALIDITY_FADE_DAYS` — How fast unasserted truth cools toward doubt.
 
 ### groundedness (evidence)
-- `groundedness.staleness` — How old evidence gets before it stops counting fresh.
+- `groundedness.staleness` — tech: `GROUNDEDNESS_STALENESS_DAYS` — How old evidence gets before it stops counting fresh.
 
 ### memory (time-sense)
-- `memory.recent-horizon` — What still counts as "recently," in days.
+- `memory.recent-horizon` — tech: `MEMORY_RECENT_HORIZON_DAYS` — What still counts as "recently," in days.
 
 ### retrieval (attention during search)
-- `retrieval.opinion-volume` — How much louder judgment speaks than word-matching.
+- `retrieval.opinion-volume` — tech: `RETRIEVAL_OPINION_VOLUME` — How much louder judgment speaks than word-matching.
-- `retrieval.surface-line` — Lowest score worth showing to anyone.
+- `retrieval.surface-line` — tech: `RETRIEVAL_SURFACE_LINE_MIN_SCORE` — Lowest score worth showing to anyone.
-- `attention.spotlight` — How many things can be shown at once.
+- `attention.spotlight` — tech: `ATTENTION_SPOTLIGHT_MAX_RESULTS` — 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.float-size` — tech: `PULSE_FLOAT_CAPACITY_ENTRIES` — How much raw experience fits in the loop at once.
-- `pulse.forget-after` — How long raw experience lasts before evaporating.
+- `pulse.forget-after` — tech: `PULSE_FORGET_AFTER_DAYS` — How long raw experience lasts before evaporating.