SilverSight/archive/2026-07-02/docs/LIBRARY_MANIFEST.md
2026-07-02 03:35:32 +02:00

3.3 KiB

SilverSight Library Manifest

Core (SilverSightCore.lean — 200 lines)

Defines: HachimojiState, Receipt, Instruction, δ, TIC axiom, loop invariant Imports: Nothing (only Std/Mathlib basics) Policy: Never imports a library. Never depends on external code.


Library Map

Each library imports the core. None are imported by the core.

                    SilverSightCore.lean
                         │
        ┌────────────────┼────────────────┐
        │                │                │
   LexLib.lean    SearchLib.lean   StructureLib.lean
   (tokenizing)   (chaos game)     (chirality)
        │                │                │
   ┌────┴────┐      ┌────┴────┐     ┌────┴────┐
   │         │      │         │     │         │
MathLib  AuditLib  QUBOLib  PVGSLib EventLib  MetricLib
(tokens) (verify)  (route)  (quant) (count)  (finsler)
   │         │      │         │     │         │
   └─────────┴──────┴─────────┴─────┴─────────┘
                         │
                  SilverSight.lean
                     (orchestrator)

Library Descriptions

LexLib — Tokenization Library

Input: String (LaTeX or ASCII math expression) Output: List MathToken + Receipt Maps to: Your UniversalMathEncoding.lean, expressionToReceipt

SearchLib — Chaos Game Library

Input: MathExpressionAddress Output: HachimojiState + Receipt (with convergence info) Maps to: Your chaos_game.py, sidon_address.py, spectral_profile.py

MetricLib — Finsler Metric Library

Input: Two HachimojiStates Output: Distance + Receipt Maps to: Your finsler_metric.py

QUBOLib — Optimization Router

Input: Source HachimojiState, target HachimojiState Output: Optimal path + Receipt Maps to: Your qubo_builder.py, qaoa_circuit.py, classical_solver.py

StructureLib — Chirality Classifier

Input: HachimojiState + token list Output: ChiralClassification + Receipt Maps to: Your ChiralitySpace.lean

PVGSLib — Quantum Sensing Bridge

Input: Photon-varied Gaussian state parameters Output: DualQuaternion energy + Receipt Maps to: Your PVGS_DQ_Bridge_fixed.lean

EventLib — TIC Counter

Input: List Instruction (executed) Output: Nat (TIC count) + Receipt Maps to: Implicit in chaos game iteration count

AuditLib — Receipt Validator

Input: Receipt Output: Bool (valid/invalid) + verification trace Maps to: Your pvgs_receipt_hash.py, hash-chain verification


The Key Rule

No library ever imports another library. Each library only imports the core.

If libraries need to compose, they do so through the orchestrator layer, not by direct dependency.

-- Library A: imports Core only
import SilverSightCore

-- Library B: imports Core only  
import SilverSightCore

-- NOT this:
-- import LibraryA  -- FORBIDDEN

-- Orchestrator: imports Core + all libraries
import SilverSightCore
import LexLib
import SearchLib
-- ... etc

This is what prevents the "hairy" problem. The core is 200 lines and never changes. Libraries come and go. The core doesn't care.