allaun/Research-Stack
1
0
Fork 0
mirror of https://github.com/allaunthefox/Research-Stack.git synced 2026-08-07 18:15:47 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Research-Stack/0-Core-Formalism/lean/SilverSight/AGENTS.md
allaun f346cf55d1 feat(lean): HardwareContentionMarkov — OISC throughput as Markov chain mixing rate 
New module SilverSight.HardwareContentionMarkov formalizes the EPYC 9645 KVM
contention model: 3 chains (ring/word/CL) with self-loop probabilities, mixing
rate = baseRate * (1 - selfLoop), and native_decide-proven ordering theorems.

Verified by #eval: wordRate = 186.07 M/s, ringRate = 1051.27 M/s.
Build: 3308 jobs, 0 errors (lake build SilverSight)
2026-07-01 00:30:31 -05:00

2.3 KiB
Raw Blame History

AGENTS.md — SilverSight

SilverSight is the clean-slate rebase of the Research Stack.

Repository

GitHub: https://github.com/allaunthefox/SilverSight Local clone: /home/allaun/SilverSight Formal modules: formal/SilverSight/

Location (in Research Stack — for lake build integration)

0-Core-Formalism/lean/SilverSight/
  SilverSight/
    Schema.lean
    WireFormat.lean
    ProductSchema.lean
    ProductWireFormat.lean
    Receipt.lean
    Bind.lean
    HardwareContentionMarkov.lean
  SilverSight.lean          ← root import

Rules

  1. SilverSight is the ONLY target for new formal work. Do NOT add new modules to 0-Core-Formalism/lean/Semantics/Semantics/. All new Lean code goes to the SilverSight repository.

  2. Imports from Semantics are allowed (cross-project): import Semantics.FixedPoint, import Semantics.Spectrum, etc.

  3. No sorry in committed code. Same rule as the Research Stack.

  4. No Float in compute paths. Use Q0_16 or Q16_16.

  5. Build gate: lake build SilverSight must pass (3308 jobs, 0 errors as of 2026-06-30).

  6. Every new module needs:

    • @[simp] theorems for key computations
    • #eval witnesses with expected output in comments
    • A docstring explaining the module's purpose

  7. The claim manifest lives at 6-Documentation/docs/claims/manifest_v1.json (shared with Research Stack docs).

What Belongs Here

  • Schema/Layout/WireFormat core (YaFF-inspired)
  • Product-type encoders
  • Receipt/Bind composition primitive
  • DynamicCanal physics (when ported)
  • RRC corpus and PIST pipeline (when ported)
  • Compression theorems (when ported)
  • Hardware-contention Markov chain (OISC throughput on cache+DRAM machines)

What Does NOT Belong Here

  • Research Stack legacy modules (stay in Semantics/Semantics/)
  • Python shims (stay in 4-Infrastructure/shim/)
  • Documentation (stay in 6-Documentation/)
  • Extraction JSONs (stay in extraction/)

Current Status

Module Status Sorry
Schema.lean Complete 0
WireFormat.lean Complete 0
ProductSchema.lean Complete 0
ProductWireFormat.lean Complete 0
Receipt.lean Complete 0
Bind.lean Complete 0
HardwareContentionMarkov.lean Complete 0