SilverSight/docs/GLOSSARY.md

17 KiB
Raw Blame History

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, IsIntervalSidon
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
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, ofFloat
BraidStorm Braid group representation, Artin braid 8-strand braid action used as a compression/determinism substrate. formal/CoreFormalism/BraidEigensolid.lean:L1 #mathematical #core eigensolid, crossStep
eigensolid Fixed point, attractor Fixed point of the crossStep operator; not a physical solid. formal/CoreFormalism/BraidEigensolid.lean:L42 #mathematical #core crossStep, BraidStorm
crossStep Braid generator / crossing operator One deterministic update step in the braid dynamics. formal/CoreFormalism/BraidCross.lean:L1 #mathematical #core eigensolid, BraidStorm
AVM Abstract/virtual machine, stack machine SilverSight-specific instruction set and transition relation. Core/SilverSightCore.lean:L1 #core #implementation TIC, AvmTy
TIC Logical clock, event counter Monotone counter derived from AVM transitions. Core/SilverSightCore.lean:L1 #core #implementation AVM
Receipt Attestation, certificate, proof certificate Machine-readable record of a gate result; the compressed state. Core/SilverSightCore.lean:L1 #core #protocol FixtureRow, emit
Hachimoji 8-letter alphabet, octal state The 8-symbol output alphabet of the core classifier. formal/CoreFormalism/HachimojiLUT.lean:L1 #core #mathematical Hachimoji state
Finsler-Randers Asymmetric metric, quasimetric Directed routing cost with anisotropy parameter beta. qubo/finsler_metric.py:L1 #mathematical #planned QUBO
QUBO Ising model, binary quadratic optimization Energy minimization over binary variables. qubo/qubo_builder.py:L1 #mathematical #planned Finsler-Randers
meta-solid Topological triple point, phase coexistence Point where three independent equivalence relations collapse. formal/CoreFormalism/BraidEigensolid.lean:L1 #mathematical eigensolid
promotion Certification, acceptance Status advance only after a formal gate passes. AGENTS.md:L1 #protocol quarantine
quarantine Archive, staging, broken build exclusion Module kept out of the active build until repaired. AGENTS.md:L1 #protocol promotion
Genome18 Codon LUT, k=6 fixed-point address Research Stack vocabulary-lock name for CodonLUT (k=6): 6 x 3-bit Hachimoji inputs -> 18-bit address. SilverSight binds this to formal/CoreFormalism/HachimojiLUT.lean CodonLUT. formal/CoreFormalism/HachimojiLUT.lean:L1 #mathematical CodonLUT
equationPosition Manifold localization, equation embedding The deterministic map EquationShape -> SpherePoint that answers where does this equation live on the manifold? formal/CoreFormalism/HachimojiLUT.lean:L4 #mathematical SpherePoint

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
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:L1 #core #protocol FixtureRow
AVM Adaptive Virtual Machine. The stack-machine transition semantics delta defined in the core; the universal bridge between math languages and executable traces. Core/SilverSightCore.lean:L1 #core #implementation TIC, AvmTy
TIC Temporal Index of Computation. A monotone event counter derived from AVM state transitions. Core/SilverSightCore.lean:L1 #core #implementation AVM
pathCost Raw integer cost metric carried on a Receipt; never a Float. Core/SilverSightCore.lean:L1 #core Receipt
Library method The architecture rule: Core/ defines contracts, libraries implement them, and no library imports another library. AGENTS.md:L1 #protocol Core
Core The invariant center of SilverSight: Core/SilverSightCore.lean and Core/SilverSight/FixedPoint.lean. Defines Receipt, AVM, TIC, and canonical Q16_16. AGENTS.md:L1 #core Library method
Schema Typeclass describing fixed-size, well-formed data: byteSize and wellFormed. Core/SilverSight/Semantics/Schema.lean:L1 #core #implementation byteSize, wellFormed
byteSize Number of bytes occupied by a value of a Schema type; constant and statically known. Core/SilverSight/Semantics/Schema.lean:L1 #core #implementation Schema
wellFormed Predicate asserting that a value satisfies its Schema invariants. Core/SilverSight/Semantics/Schema.lean:L1 #core #implementation Schema
Layout Physical data placement: rowMajor, columnar, compact, mmapView. Core/SilverSight/Semantics/Layout.lean:L1 #core #implementation AccessProfile, rowMajor
AccessProfile Read/write mix used by the layout cost model. Core/SilverSight/Semantics/Layout.lean:L1 #core #implementation Layout
WireFormat Certified encoder/decoder pair for a Schema under a Layout. Core/SilverSight/Semantics/WireFormat.lean:L1 #core #implementation roundTrip
roundTrip WireFormat axiom: decode (encode a) = some a for every value. Core/SilverSight/Semantics/WireFormat.lean:L1 #core #protocol WireFormat
View Zero-copy, address-bounded window into a ByteArray. Core/SilverSight/Semantics/View.lean:L1 #core #implementation LayoutBridge
LayoutBridge Certified conversion between two Layouts with a round-trip guarantee. Core/SilverSight/Semantics/LayoutBridge.lean:L1 #core #implementation Layout, View
CanalRegime Storage regime (cold, warm, hot, flash) used by layout selection. Core/SilverSight/Semantics/CanalLayout.lean:L1 #core #implementation CanalLayout
CanalLayout Module that maps CanalRegime to a preferred Layout and profile. Core/SilverSight/Semantics/CanalLayout.lean:L1 #core #implementation CanalRegime
rowMajor Default Layout: fields stored contiguously in declaration order. Core/SilverSight/Semantics/Layout.lean:L1 #core #implementation Layout
mmapView Layout optimized for memory-mapped, read-only access. Core/SilverSight/Semantics/Layout.lean:L1 #core #implementation Layout
BraidState Aggregated braid carrier state used by the eigensolid compressor. formal/CoreFormalism/BraidState.lean:L1 #mathematical #core BraidStorm

RRC / AVM ISA

Term Definition File:Line Tags See Also
RRC Receipt Routing Classifier. Aligns PIST structural labels with RRC semantic routing shapes and emits gate receipts. formal/SilverSight/RRC/Emit.lean:L1 #core #protocol RRCShape, FixtureRow
CoreFormalism The SilverSight foundational library containing canonical Q16_16, Sidon sets, braid dynamics, and related lemmas. formal/CoreFormalism/:L1 #core #mathematical SidonSets
RRCShape One of six lawful routing shapes: cognitiveLoadField, signalShapedRouteCompiler, logogramProjection, projectableGeometryTopology, cadForceProbeReceipt, holdForUnlawfulOrUnderspecifiedShape. formal/SilverSight/RRCLogogramProjection.lean:L1 #core #protocol WitnessStatus
WitnessStatus candidate (admits next-stage checks) or hold (blocked pending more evidence). formal/SilverSight/RRCLogogramProjection.lean:L1 #protocol RRCShape
LogogramReceipt Receipt core for one compiled logogram projection, carrying shape, status, regime, and tear evidence. formal/SilverSight/RRCLogogramProjection.lean:L1 #core #protocol RRCShape
FixtureRow One compiled equation record with raw features and optional PIST labels; input to the RRC alignment gate. formal/SilverSight/RRC/Emit.lean:L1 #core AlignmentStatus
AlignmentStatus Result of determineAlignment: alignedExact, alignedProxy, compatibleStructuralProjection, alignmentWarning, or missingPrediction. formal/SilverSight/RRC/Emit.lean:L1 #protocol FixtureRow
determineAlignment RRC alignment gate that maps a FixtureRow and optional PIST labels to an AlignmentStatus. formal/SilverSight/RRC/Emit.lean:L1 #protocol FixtureRow
AvmTy Closed-world AVM type universe: q0_16, q16_16, bool. formal/SilverSight/AVMIsa/Types.lean:L1 #core #implementation AvmVal
AvmVal Typed AVM value payload indexed by AvmTy. formal/SilverSight/AVMIsa/Value.lean:L1 #core #implementation AvmTy
Instr AVM instruction set: push, pop, dup, swap, load, store, jump, jumpIf, prim, halt. formal/SilverSight/AVMIsa/Instr.lean:L1 #core #implementation Prim
Prim Finite AVM primitive set: boolean ops and saturating Q0_16/Q16_16 add/sub. formal/SilverSight/AVMIsa/Instr.lean:L1 #core #implementation Instr
AVMIsa.Emit Top-level JSON output boundary. Stamps AVM canary receipts and RRC corpus bundles. formal/SilverSight/AVMIsa/Emit.lean:L1 #core #protocol RRC
TDoku16D Projected gradient descent constraint propagation on the 16D subspace. formal/SilverSight/PIST/Tdoku16D.lean:L1 #mathematical Q16_16
CrossDomainSynthesis Enclosure and defect proof boundaries validating critical ratios. formal/SilverSight/PIST/CrossDomainSynthesis.lean:L1 #mathematical MultiSurfacePacker
MultiSurfacePacker Multi-surface Lagrangian optimization decision logic. formal/SilverSight/PIST/MultiSurfacePacker.lean:L1 #mathematical CrossDomainSynthesis

Fixed-point and Numerics

Term Definition File:Line Tags See Also
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:L1 #core #implementation Q0_16, ofFloat
Q0_16 16.16-style fixed-point interpretation used for bounded unit-interval quantities. Core/SilverSight/FixedPoint.lean:L1 #core #implementation Q16_16
ofFloat Conversion from Float to Q16_16. Permitted only at external boundaries (JSON parsing, sensor input); must be immediately bracketed. AGENTS.md:L1 #protocol #implementation Q16_16, Float
ofNat / ofRatio / ofRawInt Canonical constructors for Q16_16 values in compute paths. Core/SilverSight/FixedPoint.lean:L1 #core #implementation Q16_16
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:L1 #protocol #deprecated ofFloat

Braid / Eigensolid Compression

Term Definition File:Line Tags See Also
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:L1 #mathematical #core eigensolid, crossStep
eigensolid The converged, stable state of a braid crossing loop; detected when crossStep(s) = s. formal/CoreFormalism/BraidEigensolid.lean:L42 #mathematical #core crossStep, BraidStorm
crossStep One braid-crossing iteration that merges phase and emits a residual. formal/CoreFormalism/BraidCross.lean:L1 #mathematical #core eigensolid, BraidStorm
strand A single braided carrier with phase accumulator, parity, slot, residue, jitter, and admissibility bracket. formal/CoreFormalism/BraidStrand.lean:L1 #mathematical #core BraidStorm
Yang-Baxter The braid relation that defines braid-order invariance. formal/CoreFormalism/BraidEigensolid.lean:L1 #mathematical BraidStorm

Sidon / Number Theory

Term Definition File:Line Tags See Also
Sidon set A set where all pairwise sums a + b are unique up to reordering. formal/CoreFormalism/SidonSets.lean:L1 #mathematical #core Sidon label
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:L1 #mathematical #core Sidon set
Sidon slack Address budget minus the maximum label used; encodes capacity headroom. formal/CoreFormalism/SidonSets.lean:L1 #mathematical Sidon set
IsIntervalSidon Predicate stating that a finite set is a Sidon subset of {1,...,N}. formal/CoreFormalism/SidonSets.lean:L1 #mathematical Sidon set
IsSidonMod Predicate stating that a set is Sidon modulo M: sums are unique up to congruence. formal/CoreFormalism/SidonSets.lean:L1 #mathematical Sidon set
sidonMaximum Extremal function h(N) returning the maximum size of an interval Sidon set. formal/CoreFormalism/SidonSets.lean:L1 #mathematical Sidon set
Singer theorem Existence of a Sidon set of size q+1 modulo q^2+q+1 for prime powers q. formal/CoreFormalism/SidonSets.lean:L1 #mathematical Sidon set
Lindstrom bound Upper bound for interval Sidon sets. formal/CoreFormalism/SidonSets.lean:L1 #mathematical Sidon set
interaction graph Typed directed graph whose adjacency matrix is tested for the Sidon witness property. formal/CoreFormalism/InteractionGraphSidon.lean:L1 #mathematical Sidon label
weak-axis CRT Chinese Remainder Theorem reconstruction used for RRC weak-axis classification. formal/CoreFormalism/SieveLemmas.lean:L1 #mathematical SieveLemmas

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. If the term has a standard name, add it to the Standard Terminology Crosswalk
  6. If the term is used in a receipt or gate, ensure the source module proves the property
  7. 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.