mirror of
https://github.com/allaunthefox/SilverSight.git
synced 2026-07-31 01:25:21 +00:00
allaun
4490dc28a7
- Move canonical FixedPoint to Core/SilverSight/FixedPoint.lean - Add SilverSightRRC library: RRC logogram gates, receipt bridge, AVM ISA - Add AVMIsa.Emit as the sole top-level JSON output boundary - Add rrc-emit-fixture executable and Python I/O shims - Update AGENTS.md, glossary, project map, and build baseline Build: 2981 jobs, 0 errors (lake build)
172 lines
14 KiB
Markdown
172 lines
14 KiB
Markdown
# SilverSight Glossary
|
||
|
||
A living dictionary of terms used across the SilverSight core, libraries,
|
||
documentation, and receipts. When you introduce a new domain term, add it here
|
||
and cite the module that owns the definition.
|
||
|
||
**Rule:** every entry must name the authoritative source file or module. A
|
||
glossary entry without a source module is a draft; it must be promoted to a
|
||
bound definition before it is used in a receipt or gate.
|
||
|
||
---
|
||
|
||
## Standard terminology crosswalk
|
||
|
||
SilverSight invents names only when necessary. When a concept already exists
|
||
under a standard name, the glossary binds the SilverSight name to the standard
|
||
name and explains the delta.
|
||
|
||
| SilverSight term | Standard terminology | Delta / note |
|
||
|------------------|----------------------|--------------|
|
||
| **Sidon set** | B₂ sequence, Erdős–Sidon set | Standard combinatorial object; SilverSight uses it for deterministic strand addressing. |
|
||
| **Sidon label** | Sidon-set element, B₂ address | Chosen from the canonical powers-of-2 set for 8-strand braids. |
|
||
| **Q16_16** | Fixed-point arithmetic, Q15.16 / s16.16 | Signed 32-bit fixed point with 16 integer and 16 fractional bits. |
|
||
| **BraidStorm** | Braid group representation, Artin braid | 8-strand braid action used as a compression/determinism substrate. |
|
||
| **eigensolid** | Fixed point, attractor | Fixed point of the `crossStep` operator; not a physical solid. |
|
||
| **crossStep** | Braid generator / crossing operator | One deterministic update step in the braid dynamics. |
|
||
| **AVM** | Abstract/virtual machine, stack machine | SilverSight-specific instruction set and transition relation. |
|
||
| **TIC** | Logical clock, event counter | Monotone counter derived from AVM transitions. |
|
||
| **Receipt** | Attestation, certificate, proof certificate | Machine-readable record of a gate result; the compressed state. |
|
||
| **Hachimoji** | 8-letter alphabet, octal state | The 8-symbol output alphabet of the core classifier. |
|
||
| **Finsler-Randers** | Asymmetric metric, quasimetric | Directed routing cost with anisotropy parameter β. |
|
||
| **QUBO** | Ising model, binary quadratic optimization | Energy minimization over binary variables. |
|
||
| **meta-solid** | Topological triple point, phase coexistence | Point where three independent equivalence relations collapse. |
|
||
| **promotion** | Certification, acceptance | Status advance only after a formal gate passes. |
|
||
| **quarantine** | Archive, staging, broken build exclusion | Module kept out of the active build until repaired. |
|
||
|
||
---
|
||
|
||
## Core terms
|
||
|
||
| Term | Definition | Source module |
|
||
|------|------------|---------------|
|
||
| **Hachimoji state** | One of the 8 output symbols `Φ Λ Ρ Κ Ω Σ Π Ζ` produced by the core classifier. | `Core/SilverSightCore.lean` |
|
||
| **Receipt** | The compressed, machine-readable attestation record that crosses the Core/library boundary. It is not metadata around a result; it *is* the result. | `Core/SilverSightCore.lean` |
|
||
| **AVM** | Adaptive Virtual Machine. The stack-machine transition semantics `δ` defined in the core; the universal bridge between math languages and executable traces. | `Core/SilverSightCore.lean` |
|
||
| **TIC** | Temporal Index of Computation. A monotone event counter derived from AVM state transitions. | `Core/SilverSightCore.lean` |
|
||
| **pathCost** | Raw integer cost metric carried on a `Receipt`; never a `Float`. | `Core/SilverSightCore.lean` |
|
||
| **Library method** | The architecture rule: `Core/` defines contracts, libraries implement them, and no library imports another library. | `AGENTS.md` |
|
||
| **Core** | The invariant center of SilverSight: `Core/SilverSightCore.lean` and `Core/SilverSight/FixedPoint.lean`. Defines Receipt, AVM, TIC, and canonical Q16_16. | `AGENTS.md` |
|
||
|
||
## RRC / AVM ISA
|
||
|
||
| Term | Definition | Source module |
|
||
|------|------------|---------------|
|
||
| **RRC** | Receipt Routing Classifier. Aligns PIST structural labels with RRC semantic routing shapes and emits gate receipts. | `formal/SilverSight/RRC/Emit.lean` |
|
||
| **CoreFormalism** | The SilverSight foundational library containing canonical Q16_16, Sidon sets, braid dynamics, and related lemmas. | `formal/CoreFormalism/` |
|
||
| **RRCShape** | One of six lawful routing shapes: `cognitiveLoadField`, `signalShapedRouteCompiler`, `logogramProjection`, `projectableGeometryTopology`, `cadForceProbeReceipt`, `holdForUnlawfulOrUnderspecifiedShape`. | `formal/SilverSight/RRCLogogramProjection.lean` |
|
||
| **WitnessStatus** | `candidate` (admits next-stage checks) or `hold` (blocked pending more evidence). | `formal/SilverSight/RRCLogogramProjection.lean` |
|
||
| **LogogramReceipt** | Receipt core for one compiled logogram projection, carrying shape, status, regime, and tear evidence. | `formal/SilverSight/RRCLogogramProjection.lean` |
|
||
| **FixtureRow** | One compiled equation record with raw features and optional PIST labels; input to the RRC alignment gate. | `formal/SilverSight/RRC/Emit.lean` |
|
||
| **AlignmentStatus** | Result of `determineAlignment`: `alignedExact`, `alignedProxy`, `compatibleStructuralProjection`, `alignmentWarning`, or `missingPrediction`. | `formal/SilverSight/RRC/Emit.lean` |
|
||
| **determineAlignment** | RRC alignment gate that maps a `FixtureRow` and optional PIST labels to an `AlignmentStatus`. | `formal/SilverSight/RRC/Emit.lean` |
|
||
| **AvmTy** | Closed-world AVM type universe: `q0_16`, `q16_16`, `bool`. | `formal/SilverSight/AVMIsa/Types.lean` |
|
||
| **AvmVal** | Typed AVM value payload indexed by `AvmTy`. | `formal/SilverSight/AVMIsa/Value.lean` |
|
||
| **Instr** | AVM instruction set: `push`, `pop`, `dup`, `swap`, `load`, `store`, `jump`, `jumpIf`, `prim`, `halt`. | `formal/SilverSight/AVMIsa/Instr.lean` |
|
||
| **Prim** | Finite AVM primitive set: boolean ops and saturating Q0_16/Q16_16 add/sub. | `formal/SilverSight/AVMIsa/Instr.lean` |
|
||
| **AVMIsa.Emit** | Top-level JSON output boundary. Stamps AVM canary receipts and RRC corpus bundles. | `formal/SilverSight/AVMIsa/Emit.lean` |
|
||
|
||
## Fixed-point and numerics
|
||
|
||
| Term | Definition | Source module |
|
||
|------|------------|---------------|
|
||
| **Q16_16** | Canonical 32-bit fixed-point type: 16 integer bits and 16 fractional bits. The sole source of truth for core arithmetic. | `Core/SilverSight/FixedPoint.lean` |
|
||
| **Q0_16** | 16.16-style fixed-point interpretation used for bounded unit-interval quantities. | `Core/SilverSight/FixedPoint.lean` |
|
||
| **ofFloat** | Conversion from `Float` to `Q16_16`. Permitted **only** at external boundaries (JSON parsing, sensor input); must be immediately bracketed. | `AGENTS.md` |
|
||
| **ofNat / ofRatio / ofRawInt** | Canonical constructors for `Q16_16` values in compute paths. | `Core/SilverSight/FixedPoint.lean` |
|
||
| **Float** | IEEE-754 floating-point type. Forbidden in SilverSight compute paths; permitted only at external JSON/sensor boundaries and must be immediately converted to `Q16_16`. | `AGENTS.md` |
|
||
|
||
## Braid / eigensolid compression
|
||
|
||
| Term | Definition | Source module |
|
||
|------|------------|---------------|
|
||
| **BraidStorm** | The 8-strand braid topology used by the eigensolid compressor. Strands cross pairwise; each crossing merges phase and produces a residual. | `formal/CoreFormalism/BraidEigensolid.lean` |
|
||
| **eigensolid** | The converged, stable state of a braid crossing loop; detected when `crossStep(s) = s`. | `formal/CoreFormalism/BraidEigensolid.lean` |
|
||
| **crossStep** | One braid-crossing iteration that merges phase and emits a residual. | `formal/CoreFormalism/BraidCross.lean` |
|
||
| **strand** | A single braided carrier with phase accumulator, parity, slot, residue, jitter, and admissibility bracket. | `formal/CoreFormalism/BraidStrand.lean` |
|
||
| **Yang-Baxter** | The braid relation `βij βjk βij = βjk βij βjk` that defines braid-order invariance. | `formal/CoreFormalism/BraidEigensolid.lean` |
|
||
| **Anti-BraidStorm** | Adversarial dual that tests Yang-Baxter invariance and receipt aliasing. | `PORTING_MAP.md` (planned) |
|
||
|
||
## Sidon / number theory
|
||
|
||
| Term | Definition | Source module |
|
||
|------|------------|---------------|
|
||
| **Sidon set** | A set where all pairwise sums `a + b` are unique up to reordering. | `formal/CoreFormalism/SidonSets.lean` |
|
||
| **Sidon label** | An address from a Sidon set. Powers of 2 `{1,2,4,8,16,32,64,128}` are canonical for 8 strands. | `formal/CoreFormalism/InteractionGraphSidon.lean` |
|
||
| **Sidon slack** | Address budget minus the maximum label used; encodes capacity headroom. | `formal/CoreFormalism/SidonSets.lean` |
|
||
| **IsIntervalSidon** | Predicate stating that a finite set is a Sidon subset of `{1,…,N}`. | `formal/CoreFormalism/SidonSets.lean` |
|
||
| **IsSidonMod** | Predicate stating that a set is Sidon modulo `M`: sums are unique up to congruence. | `formal/CoreFormalism/SidonSets.lean` |
|
||
| **sidonMaximum** | Extremal function `h(N)` returning the maximum size of an interval Sidon set. | `formal/CoreFormalism/SidonSets.lean` |
|
||
| **Singer theorem** | Existence of a Sidon set of size `q+1` modulo `q²+q+1` for prime powers `q`. | `formal/CoreFormalism/SidonSets.lean` |
|
||
| **Lindström bound** | Upper bound `|A| ≤ √N + O(N^{1/4})` for interval Sidon sets. | `formal/CoreFormalism/SidonSets.lean` |
|
||
| **interaction graph** | Typed directed graph whose adjacency matrix is tested for the Sidon witness property. | `formal/CoreFormalism/InteractionGraphSidon.lean` |
|
||
| **weak-axis CRT** | Chinese Remainder Theorem reconstruction used for RRC weak-axis classification. | `formal/CoreFormalism/SieveLemmas.lean` |
|
||
|
||
## RRC / receipt classification
|
||
|
||
| Term | Definition | Source module |
|
||
|------|------------|---------------|
|
||
| **RRC** | Receipt / Rank / Classify pipeline. The decision layer that admits or rejects prediction rows. | `PORTING_MAP.md` |
|
||
| **Corpus250** | The 250-equation raw-feature corpus used for RRC training and alignment. | Research Stack `Semantics.RRC.Corpus250` (planned) |
|
||
| **emit** | The sole output boundary for top-level receipt JSON. Only the designated emitter may stamp a receipt. | `AGENTS.md` |
|
||
| **promotion** | Status advance from `not_promoted` to `promoted` only after a Lean gate explicitly passes. | `AGENTS.md` |
|
||
|
||
## Physics / applied math (ported concepts)
|
||
|
||
| Term | Definition | Source module |
|
||
|------|------------|---------------|
|
||
| **meta-solid** | Topological triple point where trace closure, local Yang-Baxter isotopy, and braid class are simultaneously exact. | ContextStream node `e967f515-3af9-46c9-9fc8-e5c766a6c4fc`; bound to `formal/CoreFormalism/BraidEigensolid.lean` |
|
||
| **Finsler-Randers** | Directed routing metric used in the QUBO/TSP benchmark. | `qubo/finsler_metric.py` (planned) |
|
||
| **QUBO** | Quadratic Unconstrained Binary Optimization; a classical/quantum optimization encoding. | `qubo/qubo_builder.py` (planned) |
|
||
|
||
## Modules and library layers
|
||
|
||
| Term | Definition | Source module |
|
||
|------|------------|---------------|
|
||
| **FixedPoint** | The Lean module that defines the canonical `Q16_16`/`Q0_16` fixed-point implementation. | `Core/SilverSight/FixedPoint.lean` |
|
||
| **SieveLemmas** | Lean module for coprime-sieve observers and CRT reconstruction. | `formal/CoreFormalism/SieveLemmas.lean` |
|
||
| **InteractionGraphSidon** | Lean module for typed interaction graphs and Sidon witnesses. | `formal/CoreFormalism/InteractionGraphSidon.lean` |
|
||
| **BraidEigensolid** | Lean module for the braid crossing loop and eigensolid fixed-point theorems. | `formal/CoreFormalism/BraidEigensolid.lean` |
|
||
| **BraidSpherionBridge** | Lean module bridging braid dynamics to spherion / twin-prime constructions. | `formal/CoreFormalism/BraidSpherionBridge.lean` |
|
||
| **SilverSightRRC** | Lean library containing the RRC decision surface, receipt bridge, and AVM ISA emit boundary. | `lakefile.lean` |
|
||
| **RRCLib** | User-facing symlink directory for the Receipt / Rank / Classify surface. | `formal/RRCLib/` |
|
||
| **RrcEmitFixture** | Lean executable that emits the AVM-stamped RRC fixture corpus JSON. | `exe/RrcEmitFixture.lean` |
|
||
| **emitFixtureCorpus** | Top-level JSON bundle for the 6-row RRC fixture corpus. | `formal/SilverSight/AVMIsa/Emit.lean` |
|
||
| **toSilverSightReceipt** | Bridge from `SilverSight.ReceiptCore.Receipt` to `SilverSight.Core.Receipt`. | `formal/SilverSight/ReceiptCore.lean` |
|
||
| **SearchLib** | Planned library layer for search-space exploration (chaos game, entropy candidates). | `PORTING_MAP.md` |
|
||
| **LexLib** | Planned library layer for lexical / symbolic encodings. | `PORTING_MAP.md` |
|
||
| **StructureLib** | Planned library layer for structural / manifold encodings. | `PORTING_MAP.md` |
|
||
| **QUBOLib** | Planned library layer for QUBO/QAOA optimization bridges. | `PORTING_MAP.md` |
|
||
| **PVGSLib** | Planned library layer for photon-varied Gaussian state bridges. | `PORTING_MAP.md` |
|
||
|
||
## Infrastructure terms
|
||
|
||
| Term | Definition | Source module |
|
||
|------|------------|---------------|
|
||
| **Headroom** | Context-compression proxy that shrinks tool outputs before they reach the LLM. | `AGENTS.md` |
|
||
| **ContextStream** | Persistent memory / decision graph system (workspace-scoped; currently unavailable in this session). | `AGENTS.md` |
|
||
| **cornfield** | Legacy branch / archive state. Retrieve only the named artifact, never merge wholesale. | `AGENTS.md` |
|
||
| **quarantine** | A file or module that is kept out of the active build because it is broken, hairy, or not yet ported. | `AGENTS.md` |
|
||
|
||
---
|
||
|
||
## How to add or update an entry
|
||
|
||
1. Add a row to the appropriate table.
|
||
2. Make the **Source module** column point at the Lean module, Python shim, or
|
||
`AGENTS.md` section that owns the definition.
|
||
3. If the term has a standard name in mathematics, CS, or physics, add it to
|
||
the **Standard terminology crosswalk** and explain the delta.
|
||
4. If the term is used in a receipt or gate, ensure the source module proves or
|
||
witnesses the property before the term is promoted.
|
||
5. Run `python3 -m py_compile` on any touched Python and `lake build` on any
|
||
touched Lean.
|
||
|
||
## Draft terms (not yet bound)
|
||
|
||
Use this section for terms that appear in conversation but do not yet have an
|
||
authoritative module definition.
|
||
|
||
| Term | Notes | Proposed owner |
|
||
|------|-------|----------------|
|
||
| *none* | — | — |
|