Extract monolithic lakefile into 14 standalone module targets
Some checks failed
Anti-Smuggle Gate / gate (push) Has been cancelled
Doc Sync Check / check (push) Has been cancelled
Lean Check / build (push) Has been cancelled
Python Check / test (push) Has been cancelled
Q16_16 Roundtrip / roundtrip (push) Has been cancelled

Replaced 3 monolithic lean_lib (SilverSightCore, SilverSightFormal, SilverSightRRC)
with 14 focused modules:
  Layer 0: SilverSightCore (foundation)
  Layer 1: SilverSightNumerics (Q16_16, fixed-point)
  Layer 2: SilverSightCanal (dynamic canal, Bind)
  Layer 3a: SilverSightBraid (braid theory)
  Layer 3b: SilverSightSidon (Sidon sets, CRT, sieve)
  Layer 3c: SilverSightHachimoji (DNA encoding, N=8 proof)
  Layer 4: SilverSightPIST (spectral classification)
  Layer 5: SilverSightAVM (ISA)
  Layer 6: SilverSightRRC (receipt pipeline)
  Layer 7: SilverSightBindingSite (binding site codec)
  Layer 8: SilverSightFeasible (QUBO relaxation)
  Standalone: SilverSightGeometry, SilverSightMisc

Each module is independently buildable with clear dependency ordering.
This commit is contained in:
allaunthefox 2026-07-08 07:42:39 +08:00
parent e588b3b7a4
commit 6d2136c328
2 changed files with 296 additions and 48 deletions

184
MODULE_MAP.md Normal file
View file

@ -0,0 +1,184 @@
# SilverSight Module Map
**Date:** 2026-07-08
**Status:** Extraction complete — 14 standalone lake targets replacing 3 monolithic ones
---
## Architecture
```
Layer 0 SilverSightCore .............. Core foundation (Semantics schema, layout, wire format)
Layer 1 SilverSightNumerics .......... Q16_16 fixed-point, tactics, prime LUT
Layer 2 SilverSightCanal ............. Dynamic canal, Bind infrastructure
Layer 3a SilverSightBraid ............. Braid theory (strand → cross → field → eigensolid)
Layer 3b SilverSightSidon ............. Sidon sets, CRT, sieve lemmas, E8
Layer 3c SilverSightHachimoji ......... Hachimoji DNA encoding (N=8 proof, phi pipeline)
Layer 4 SilverSightPIST .............. PIST spectral classification (matrix → spectral → classify)
Layer 5 SilverSightAVM ............... AVM instruction set architecture (types → safety → emit)
Layer 6 SilverSightRRC ............... RRC receipt pipeline (emit, density, Q16_16 manifold)
Layer 7 SilverSightBindingSite ....... Binding site codec (types → hachimoji → entropy → codec)
Layer 8 SilverSightFeasible .......... QUBO relaxation, feasible set theorems
SilverSightGeometry .......... Complex projective space, Hopf fibration, Chentsov
SilverSightMisc .............. Standalone modules (Collatz, GoldenSpiral, AngrySphinx, etc.)
```
## Dependency Graph
```
SilverSightCore (Layer 0)
└─► SilverSightNumerics (Layer 1)
├─► SilverSightCanal (Layer 2)
│ ├─► SilverSightBraid (Layer 3a)
│ │ └─► [standalone]
│ └─► [standalone]
├─► SilverSightSidon (Layer 3b) ──► [standalone, Mathlib only]
├─► SilverSightHachimoji (Layer 3c) ──► [depends on Core + FixedPoint]
├─► SilverSightPIST (Layer 4) ──► [depends on Numerics]
├─► SilverSightAVM (Layer 5) ──► [self-contained ISA]
├─► SilverSightRRC (Layer 6) ──► [depends on Hachimoji + PIST]
├─► SilverSightBindingSite (Layer 7) ──► [depends on Hachimoji]
├─► SilverSightFeasible (Layer 8) ──► [standalone]
├─► SilverSightGeometry ──► [standalone, Mathlib only]
└─► SilverSightMisc ──► [standalone, mixed deps]
```
## Module Details
### SilverSightCore (Layer 0)
**Files:** 7 | **srcDir:** `Core/`
- SilverSightCore.lean
- SilverSight.FixedPoint.lean
- SilverSight.Semantics.Schema.lean
- SilverSight.Semantics.Layout.lean
- SilverSight.Semantics.WireFormat.lean
- SilverSight.Semantics.View.lean
- SilverSight.Semantics.LayoutBridge.lean
- SilverSight.Semantics.CanalLayout.lean
### SilverSightNumerics (Layer 1)
**Files:** 5 | **srcDir:** `formal/`
- CoreFormalism.FixedPoint
- CoreFormalism.Tactics
- CoreFormalism.Q16_16Numerics
- SilverSight.PrimeLut
- SilverSight.FixedPointBridge
### SilverSightCanal (Layer 2)
**Files:** 2 | **srcDir:** `formal/`
- CoreFormalism.DynamicCanal
- CoreFormalism.Bind
### SilverSightBraid (Layer 3a)
**Files:** 8 | **srcDir:** `formal/`
- CoreFormalism.BraidBracket
- CoreFormalism.BraidStrand
- CoreFormalism.BraidCross
- CoreFormalism.BraidField
- CoreFormalism.BraidStateN
- CoreFormalism.BraidEigensolid
- CoreFormalism.BraidSpherionBridge
- CoreFormalism.ContractedCrossStep
### SilverSightSidon (Layer 3b)
**Files:** 9 | **srcDir:** `formal/`
- CoreFormalism.SidonSets
- CoreFormalism.SieveLemmas
- CoreFormalism.InteractionGraphSidon
- CoreFormalism.CRTSidon
- CoreFormalism.CRTSidonN
- CoreFormalism.E8Sidon
- CoreFormalism.EisensteinSeries
- CoreFormalism.GoormaghtighEnumeration
- CoreFormalism.StrandCapacityBound
### SilverSightHachimoji (Layer 3c)
**Files:** 11 | **srcDir:** `formal/`
- CoreFormalism.HachimojiBase
- CoreFormalism.HachimojiCodec
- CoreFormalism.HachimojiLUT
- CoreFormalism.HachimojiBridging
- CoreFormalism.HachimojiManifoldAxiom
- SilverSight.HachimojiN8
- SilverSight.HachimojiN8Bridge
- SilverSight.HachimojiCharClass
- SilverSight.PhiDNALayout
- SilverSight.PhiConsistency
- SilverSight.PhiPipelineReceipt
### SilverSightPIST (Layer 4)
**Files:** 21 | **srcDir:** `formal/`
- SilverSight.PIST.Spectral, SpectralN, MatrixN, CharPoly
- SilverSight.PIST.FisherRigidity, FisherRigidityN
- SilverSight.PIST.Classify, ClassifyN
- SilverSight.PIST.Matrices250, UnifiedCovariant, CartanConnection
- SilverSight.PIST.YangBaxter, SidonMirrorNotch, Tdoku16D
- SilverSight.PIST.CrossDomainSynthesis, MultiSurfacePacker, ManifoldShortcut
- SilverSight.PIST.SidonAdapter, WeightCandidateGen, UnitDistCandidateGen, CMYKColoringCore
### SilverSightAVM (Layer 5)
**Files:** 9 | **srcDir:** `formal/`
- SilverSight.AVMIsa.Types, Value, Instr, State, Step
- SilverSight.AVMIsa.TypeCheck, TypeSafety, Run, Emit
### SilverSightRRC (Layer 6)
**Files:** 8 | **srcDir:** `formal/`
- SilverSight.RRCLogogramProjection
- SilverSight.ReceiptCore
- SilverSight.RRC.Emit, ReceiptDensity, PolyFactorIdentity, EntropyCandidates, Q16_16Manifold
- RRCLib.RRCEmit
### SilverSightBindingSite (Layer 7)
**Files:** 4 | **srcDir:** `formal/`
- BindingSite.BindingSiteTypes
- BindingSite.BindingSiteHachimoji
- BindingSite.BindingSiteEntropy
- BindingSite.BindingSiteCodec
### SilverSightFeasible (Layer 8)
**Files:** 2 | **srcDir:** `formal/`
- SilverSight.FeasibleSet.Theorem
- SilverSight.FeasibleSet.QUBORelaxation
### SilverSightGeometry
**Files:** 4 | **srcDir:** `formal/`
- CoreFormalism.ComplexProjectiveSpace
- CoreFormalism.ChentsovFinite
- CoreFormalism.HopfFibration
- CoreFormalism.AutoProof
### SilverSightMisc
**Files:** 19 | **srcDir:** `formal/`
- SilverSight.AngrySphinx, BlockCoprimeDensity, CollatzBraid, GoldenSpiral, GCCL
- SilverSight.WireFormat, ProductSchema, ProductWireFormat, Receipt
- SilverSight.AdjugateMatrix, ChiralClockModel, ColdReviewer, HCMR, CacheSieve
- SilverSight.Blitter6502OISC, YangMillsPerformance, WorkloadTestbench, Rollup
- SilverSight.CollectiveIntelligence.CostTransparency
---
## What Changed
| Before | After |
|--------|-------|
| 3 monolithic libraries | 14 standalone modules |
| SilverSightFormal (~50 roots) | Split into 9 focused modules |
| SilverSightRRC (~50 roots) | Split into PIST, AVM, RRC, BindingSite, Feasible, Misc |
| Any change rebuilds everything | Change in Braid? Only rebuilds SilverSightBraid |
| Circular import risk | Clear layered dependency graph |
## Build Commands
```bash
# Build everything
lake build
# Build individual modules
lake build SilverSightNumerics
lake build SilverSightBraid
lake build SilverSightHachimoji
lake build SilverSightPIST
lake build SilverSightAVM
lake build SilverSightRRC
# etc.
```

View file

@ -4,75 +4,84 @@ open System
package «SilverSight» where package «SilverSight» where
leanOptions := #[ leanOptions := #[
⟨`pp.unicode.fun, true⟩ -- pretty-prints `fun a ↦ b` ⟨`pp.unicode.fun, true⟩
] ]
-- Add any additional package configuration options here
-- ─── Layer 0: Core Foundation ────────────────────────────────────────────────
@[default_target] @[default_target]
lean_lib «SilverSightCore» where lean_lib «SilverSightCore» where
-- Add any library configuration options here
srcDir := "Core" srcDir := "Core"
roots := #[`SilverSightCore, `SilverSight.FixedPoint, `SilverSight.Semantics.Schema, `SilverSight.Semantics.Layout, `SilverSight.Semantics.WireFormat, `SilverSight.Semantics.View, `SilverSight.Semantics.LayoutBridge, `SilverSight.Semantics.CanalLayout] roots := #[`SilverSightCore, `SilverSight.FixedPoint, `SilverSight.Semantics.Schema, `SilverSight.Semantics.Layout, `SilverSight.Semantics.WireFormat, `SilverSight.Semantics.View, `SilverSight.Semantics.LayoutBridge, `SilverSight.Semantics.CanalLayout]
lean_lib «SilverSightFormal» where -- ─── Layer 1: Numerics & Fixed-Point ─────────────────────────────────────────
lean_lib «SilverSightNumerics» where
srcDir := "formal" srcDir := "formal"
roots := #[ roots := #[
`CoreFormalism.FixedPoint, `CoreFormalism.FixedPoint,
`SilverSight.PrimeLut,
`SilverSight.FixedPointBridge,
`CoreFormalism.Tactics, `CoreFormalism.Tactics,
`CoreFormalism.Q16_16Numerics, `CoreFormalism.Q16_16Numerics,
`SilverSight.PrimeLut,
`SilverSight.FixedPointBridge
]
-- ─── Layer 2: Canal / Dynamic Infrastructure ─────────────────────────────────
lean_lib «SilverSightCanal» where
srcDir := "formal"
roots := #[
`CoreFormalism.DynamicCanal, `CoreFormalism.DynamicCanal,
`CoreFormalism.Bind, `CoreFormalism.Bind
]
-- ─── Layer 3a: Braid Theory ──────────────────────────────────────────────────
lean_lib «SilverSightBraid» where
srcDir := "formal"
roots := #[
`CoreFormalism.BraidBracket, `CoreFormalism.BraidBracket,
`CoreFormalism.BraidStrand, `CoreFormalism.BraidStrand,
`CoreFormalism.BraidCross, `CoreFormalism.BraidCross,
`CoreFormalism.BraidField, `CoreFormalism.BraidField,
`CoreFormalism.BraidStateN, `CoreFormalism.BraidStateN,
`CoreFormalism.BraidEigensolid,
`CoreFormalism.BraidSpherionBridge,
`CoreFormalism.ContractedCrossStep
]
-- ─── Layer 3b: Sidon / Number Theory ─────────────────────────────────────────
lean_lib «SilverSightSidon» where
srcDir := "formal"
roots := #[
`CoreFormalism.SidonSets, `CoreFormalism.SidonSets,
`CoreFormalism.SieveLemmas, `CoreFormalism.SieveLemmas,
`CoreFormalism.InteractionGraphSidon, `CoreFormalism.InteractionGraphSidon,
`CoreFormalism.BraidEigensolid, `CoreFormalism.CRTSidon,
`CoreFormalism.ContractedCrossStep, `CoreFormalism.CRTSidonN,
`CoreFormalism.BraidSpherionBridge,
`CoreFormalism.E8Sidon, `CoreFormalism.E8Sidon,
`CoreFormalism.EisensteinSeries, `CoreFormalism.EisensteinSeries,
`CoreFormalism.ComplexProjectiveSpace,
`CoreFormalism.GoormaghtighEnumeration, `CoreFormalism.GoormaghtighEnumeration,
`CoreFormalism.StrandCapacityBound
]
-- ─── Layer 3c: Hachimoji DNA Encoding ────────────────────────────────────────
lean_lib «SilverSightHachimoji» where
srcDir := "formal"
roots := #[
`CoreFormalism.HachimojiBase, `CoreFormalism.HachimojiBase,
`CoreFormalism.HachimojiCodec, `CoreFormalism.HachimojiCodec,
`CoreFormalism.HachimojiLUT, `CoreFormalism.HachimojiLUT,
`CoreFormalism.HachimojiBridging, `CoreFormalism.HachimojiBridging,
`CoreFormalism.HachimojiManifoldAxiom, `CoreFormalism.HachimojiManifoldAxiom,
`CoreFormalism.ChentsovFinite,
`CoreFormalism.HopfFibration,
`CoreFormalism.StrandCapacityBound,
`CoreFormalism.CRTSidon,
`CoreFormalism.CRTSidonN,
`SilverSight.AngrySphinx,
`SilverSight.BlockCoprimeDensity,
`SilverSight.CollatzBraid,
`SilverSight.GoldenSpiral,
`SilverSight.GCCL,
`SilverSight.WireFormat,
`SilverSight.ProductSchema,
`SilverSight.ProductWireFormat,
`SilverSight.Receipt,
`BindingSite.BindingSiteTypes,
`BindingSite.BindingSiteHachimoji,
`BindingSite.BindingSiteEntropy,
`BindingSite.BindingSiteCodec
]
lean_lib «SilverSightRRC» where
srcDir := "formal"
roots := #[
`SilverSight.HachimojiN8, `SilverSight.HachimojiN8,
`SilverSight.HachimojiN8Bridge, `SilverSight.HachimojiN8Bridge,
`SilverSight.HachimojiCharClass, `SilverSight.HachimojiCharClass,
`SilverSight.PhiDNALayout, `SilverSight.PhiDNALayout,
`SilverSight.PhiConsistency, `SilverSight.PhiConsistency,
`SilverSight.PhiPipelineReceipt, `SilverSight.PhiPipelineReceipt
]
-- ─── Layer 4: PIST / Spectral Classification ─────────────────────────────────
lean_lib «SilverSightPIST» where
srcDir := "formal"
roots := #[
`SilverSight.PIST.Spectral, `SilverSight.PIST.Spectral,
`SilverSight.PIST.SpectralN, `SilverSight.PIST.SpectralN,
`SilverSight.PIST.MatrixN, `SilverSight.PIST.MatrixN,
@ -93,14 +102,13 @@ lean_lib «SilverSightRRC» where
`SilverSight.PIST.SidonAdapter, `SilverSight.PIST.SidonAdapter,
`SilverSight.PIST.WeightCandidateGen, `SilverSight.PIST.WeightCandidateGen,
`SilverSight.PIST.UnitDistCandidateGen, `SilverSight.PIST.UnitDistCandidateGen,
`SilverSight.PIST.CMYKColoringCore, `SilverSight.PIST.CMYKColoringCore
`SilverSight.RRCLogogramProjection, ]
`SilverSight.ReceiptCore,
`SilverSight.RRC.Emit, -- ─── Layer 5: AVM Instruction Set Architecture ───────────────────────────────
`SilverSight.RRC.ReceiptDensity, lean_lib «SilverSightAVM» where
`SilverSight.RRC.PolyFactorIdentity, srcDir := "formal"
`SilverSight.RRC.EntropyCandidates, roots := #[
`SilverSight.RRC.Q16_16Manifold,
`SilverSight.AVMIsa.Types, `SilverSight.AVMIsa.Types,
`SilverSight.AVMIsa.Value, `SilverSight.AVMIsa.Value,
`SilverSight.AVMIsa.Instr, `SilverSight.AVMIsa.Instr,
@ -109,7 +117,54 @@ lean_lib «SilverSightRRC» where
`SilverSight.AVMIsa.TypeCheck, `SilverSight.AVMIsa.TypeCheck,
`SilverSight.AVMIsa.TypeSafety, `SilverSight.AVMIsa.TypeSafety,
`SilverSight.AVMIsa.Run, `SilverSight.AVMIsa.Run,
`SilverSight.AVMIsa.Emit, `SilverSight.AVMIsa.Emit
]
-- ─── Layer 6: RRC Receipt Pipeline ───────────────────────────────────────────
lean_lib «SilverSightRRC» where
srcDir := "formal"
roots := #[
`SilverSight.RRCLogogramProjection,
`SilverSight.ReceiptCore,
`SilverSight.RRC.Emit,
`SilverSight.RRC.ReceiptDensity,
`SilverSight.RRC.PolyFactorIdentity,
`SilverSight.RRC.EntropyCandidates,
`SilverSight.RRC.Q16_16Manifold,
`RRCLib.RRCEmit
]
-- ─── Layer 7: Binding Site Codec ─────────────────────────────────────────────
lean_lib «SilverSightBindingSite» where
srcDir := "formal"
roots := #[
`BindingSite.BindingSiteTypes,
`BindingSite.BindingSiteHachimoji,
`BindingSite.BindingSiteEntropy,
`BindingSite.BindingSiteCodec
]
-- ─── Layer 8: Optimisation / Feasible Set ────────────────────────────────────
lean_lib «SilverSightFeasible» where
srcDir := "formal"
roots := #[
`SilverSight.FeasibleSet.Theorem,
`SilverSight.FeasibleSet.QUBORelaxation
]
-- ─── Standalone / Miscellaneous ──────────────────────────────────────────────
lean_lib «SilverSightMisc» where
srcDir := "formal"
roots := #[
`SilverSight.AngrySphinx,
`SilverSight.BlockCoprimeDensity,
`SilverSight.CollatzBraid,
`SilverSight.GoldenSpiral,
`SilverSight.GCCL,
`SilverSight.WireFormat,
`SilverSight.ProductSchema,
`SilverSight.ProductWireFormat,
`SilverSight.Receipt,
`SilverSight.AdjugateMatrix, `SilverSight.AdjugateMatrix,
`SilverSight.ChiralClockModel, `SilverSight.ChiralClockModel,
`SilverSight.ColdReviewer, `SilverSight.ColdReviewer,
@ -119,10 +174,17 @@ lean_lib «SilverSightRRC» where
`SilverSight.YangMillsPerformance, `SilverSight.YangMillsPerformance,
`SilverSight.WorkloadTestbench, `SilverSight.WorkloadTestbench,
`SilverSight.Rollup, `SilverSight.Rollup,
`SilverSight.FeasibleSet.Theorem, `SilverSight.CollectiveIntelligence.CostTransparency
`SilverSight.FeasibleSet.QUBORelaxation, ]
`SilverSight.CollectiveIntelligence.CostTransparency,
`RRCLib.RRCEmit -- ─── Geometry (standalone) ───────────────────────────────────────────────────
lean_lib «SilverSightGeometry» where
srcDir := "formal"
roots := #[
`CoreFormalism.ComplexProjectiveSpace,
`CoreFormalism.ChentsovFinite,
`CoreFormalism.HopfFibration,
`CoreFormalism.AutoProof
] ]
/-! Dead code archived 2026-07-03. See archive/dead_code_2026-07-03/README.md /-! Dead code archived 2026-07-03. See archive/dead_code_2026-07-03/README.md
@ -134,6 +196,8 @@ lean_lib «SilverSightRRC» where
- SilverSight/FeasibleSet/TestChain.lean - SilverSight/FeasibleSet/TestChain.lean
-/ -/
-- ─── Executables ─────────────────────────────────────────────────────────────
lean_exe «rrc-emit-fixture» where lean_exe «rrc-emit-fixture» where
root := `RrcEmitFixture root := `RrcEmitFixture
srcDir := "exe" srcDir := "exe"