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

This commit is contained in:
2026-08-23 06:07:48 -05:00
parent ab29db4cef
commit 8f3b7074aa
+16 -13
View File
@@ -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`).
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.
1. Every parameter has THREE names, all registered:
- **Technical name** — the machine-precise constant (e.g. `HEBBIAN_LEARN_RATE_DAYS_30`), kept for grep, logs, stack traces, and interop with plain code.
- **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.cool-off` — Days ignored before warmth fades to half.
- `hebbian.warmth-per-use` tech: `HEBBIAN_WARMTH_PER_USE` How much each use strengthens a memory toward +1.
- `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.surface-line` — Lowest score worth showing to anyone.
- `attention.spotlight` — How many things can be shown at once.
- `retrieval.opinion-volume` tech: `RETRIEVAL_OPINION_VOLUME` How much louder judgment speaks than word-matching.
- `retrieval.surface-line` tech: `RETRIEVAL_SURFACE_LINE_MIN_SCORE` Lowest score worth showing to anyone.
- `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.forget-after` — How long raw experience lasts before evaporating.
- `pulse.float-size` tech: `PULSE_FLOAT_CAPACITY_ENTRIES` How much raw experience fits in the loop at once.
- `pulse.forget-after` tech: `PULSE_FORGET_AFTER_DAYS` How long raw experience lasts before evaporating.