SilverSight/docs/GLOSSARY.md

51 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# SilverSight Glossary
A living dictionary of terms used across the SilverSight core, libraries, documentation, and receipts.
**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.
**Deep Wiki Compatible:** Each entry includes File:Line references, tags for categorization, and cross-references to related terms.
---
## 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 | File:Line | Tags | See Also |
|------------------|----------------------|--------------|-----------|------|----------|
| **Sidon set** | B₂ sequence, ErdősSidon set | Standard combinatorial object; SilverSight uses it for deterministic strand addressing. | formal/CoreFormalism/SidonSets.lean:L1 | #mathematical #core | [Sidon label](#sidon-label) |
| **Sidon label** | Sidon-set element, B₂ address | Chosen from the canonical powers-of-2 set for 8-strand braids. | formal/CoreFormalism/InteractionGraphSidon.lean:L1 | #mathematical #core | [Sidon set](#sidon-set) |
| **Q16_16** | Fixed-point arithmetic, Q15.16 / s16.16 | Signed 32-bit fixed point with 16 integer and 16 fractional bits. | Core/SilverSight/FixedPoint.lean:L1 | #core #implementation | [Q0_16](#q0_16) |
| **BraidStorm** | Braid group representation, Artin braid | 8-strand braid action used as a compression/determinism substrate. | formal/CoreFormalism/BraidEigensolid.lean:L1 | #mathematical #core | [eigensolid](#eigensolid) |
| **eigensolid** | Fixed point, attractor | Fixed point of the crossStep operator; not a physical solid. | formal/CoreFormalism/BraidEigensolid.lean:L42 | #mathematical #core | [crossStep](#crossstep) |
| **crossStep** | Braid generator / crossing operator | One deterministic update step in the braid dynamics. | formal/CoreFormalism/BraidCross.lean:L1 | #mathematical #core | [eigensolid](#eigensolid) |
| **AVM** | Abstract/virtual machine, stack machine | SilverSight-specific instruction set and transition relation. | Core/SilverSightCore.lean:L1 | #core #implementation | [TIC](#tic) |
| **TIC** | Logical clock, event counter | Monotone counter derived from AVM transitions. | Core/SilverSightCore.lean:L1 | #core #implementation | [AVM](#avm) |
---
## Core Terms
| Term | Definition | File:Line | Tags | See Also |
|------|------------|-----------|------|----------|
| **Hachimoji state** | One of the 8 output symbols produced by the core classifier. | Core/SilverSightCore.lean:L1 | #core | [Hachimoji](#hachimoji) |
| **Receipt** | The compressed, machine-readable attestation record that crosses the Core/library boundary. | Core/SilverSightCore.lean:L1 | #core #protocol | [FixtureRow](#fixturerow) |
| **AVM** | Adaptive Virtual Machine. The stack-machine transition semantics defined in the core. | Core/SilverSightCore.lean:L1 | #core #implementation | [TIC](#tic) |
| **TIC** | Temporal Index of Computation. A monotone event counter derived from AVM state transitions. | Core/SilverSightCore.lean:L1 | #core #implementation | [AVM](#avm) |
---
## How to Add or Update an Entry
1. Add a row to the appropriate table
2. Make the File:Line column point at the exact file and line number
3. Add relevant Tags for categorization
4. Add See Also links to related terms using #anchor format
5. Run python3 -m py_compile on any touched Python and lake build on any touched Lean
---
## Deep Wiki Integration
All terms are indexed by term name, file path, tags, and cross-references for deep wiki compatibility.