# 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
