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)
72 lines
3 KiB
Markdown
72 lines
3 KiB
Markdown
# SilverSight
|
||
|
||
A deterministic equation search and classification system built on chaos game theory, Sidon set addressing, and Fisher information geometry. Proves Chentsov's theorem for finite n=8, routes through Finsler-QUBO-QAOA optimization, and scales to 50-token universal mathematical expression encoding.
|
||
|
||
## Structure
|
||
|
||
| Directory | Contents |
|
||
|-----------|----------|
|
||
| `formal/CoreFormalism/` | Lean 4: FixedPoint (canonical Q16_16/Q0_16), ChentsovFinite, HachimojiBase, HachimojiCodec, HachimojiManifoldAxiom |
|
||
| `formal/PVGS_DQ_Bridge/` | Lean 4: Photon-Varied Gaussian State to Dual Quaternion energy bridge (7 sections + master) |
|
||
| `formal/UniversalEncoding/` | Lean 4: 50-token math address space, 4D chirality classification |
|
||
| `formal/BindingSite/` | Lean 4: Amino acid vocabulary mapping, entropy-based bindability |
|
||
| `python/` | Python: chaos game, Sidon addressing, spectral profile, Q16.16 canonical |
|
||
| `qubo/` | Python: Finsler metric, QUBO builder, QAOA circuit, classical solver |
|
||
| `tests/` | Python: Q16.16 roundtrip tests |
|
||
| `.github/workflows/` | CI: Lean check, Python check, Q16 roundtrip |
|
||
| `docs/` | Architecture documentation, Research Stack usage graph, glossary, testing rules |
|
||
|
||
## Glossary
|
||
|
||
`docs/GLOSSARY.md` is the authoritative living dictionary for SilverSight terms.
|
||
Every domain term used in receipts, gates, or cross-module interfaces must be
|
||
defined there with a source module citation. `docs/GLOSSARY_ALLOWLIST.md`
|
||
contains generic terms that do not need glossary entries.
|
||
|
||
## Testing
|
||
|
||
`docs/TESTING.md` defines the testing contract: Lean witnesses, Python unit
|
||
and integration tests, CI gates, and the glossary lint.
|
||
|
||
## Research Stack Usage Map
|
||
|
||
The `docs/research_stack_usage_graph.*` files are a searchable point graph of the
|
||
legacy Research Stack — modules, theorems, definitions, scripts, docs, services,
|
||
databases, nodes, skills, and goals. Use them to discover what is worth porting.
|
||
|
||
- `docs/research_stack_usage_graph.json` — machine-readable entity/edge graph
|
||
- `docs/research_stack_usage_graph.md` — human-readable summary
|
||
- `docs/research_stack_usage_graph.dot` — visual graph source (Graphviz)
|
||
- `docs/research_stack_usage_graph.svg` — rendered vector graph
|
||
- `docs/research_stack_usage_graph_thumb.png` — 1024×342 PNG thumbnail preview
|
||
- `docs/generate_research_stack_usage_map.py` — regeneration script
|
||
- `docs/research_stack_porting_candidates.md` — ranked porting shortlist
|
||
- `docs/generate_porting_candidates.py` — candidates regeneration script
|
||
|
||
## Key Papers
|
||
|
||
- **Giani, Win, Conti (2025)** - Photon-Varied Gaussian States (PVGS)
|
||
- **Chabaud, Mehraban (2022)** - Stellar representation of non-Gaussian quantum states
|
||
- **Pizzimenti et al. (2024)** - Wigner negativity of superpositions
|
||
- **Wassner et al. (2025)** - Single quadrature noise tomography
|
||
|
||
## Quick Start
|
||
|
||
```bash
|
||
# Run Q16.16 roundtrip test
|
||
python tests/q16_roundtrip_test.py
|
||
|
||
# Run chaos game search
|
||
python python/chaos_game.py
|
||
|
||
# Run optimization suite
|
||
python qubo/test_optimize.py
|
||
```
|
||
|
||
## Citation
|
||
|
||
See `CITATION.cff`.
|
||
|
||
## License
|
||
|
||
MIT
|