SilverSight/README.md
allaun 974b4768ad docs: add Research Stack porting candidates shortlist
Generate a ranked shortlist of high-value Research Stack modules to port,
scored by theorem count, in-degree (foundational), definitions, and sorry
penalty. Filtered to SilverSight-relevant math kinds.

- docs/research_stack_porting_candidates.md — top 50 + by-kind breakdown +
  zero-sorry foundation modules + script/database links
- docs/generate_porting_candidates.py — regeneration from usage graph JSON

Build: 2978 jobs, 0 errors (lake build)
2026-06-21 06:42:53 -05:00

58 lines
2.4 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 |
## 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 (render with Graphviz)
- `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