refactor(silversight): move to correct location + set no-write on Research Stack

SilverSight modules moved from Semantics/Semantics/SilverSight/ to
SilverSight/SilverSight/ (separate directory, same lake project).

Changes:
- SilverSight Lean modules: Schema, WireFormat, ProductSchema,
  ProductWireFormat, Receipt, Bind → 0-Core-Formalism/lean/SilverSight/
- Imports updated: Semantics.SilverSight.* → SilverSight.*
- Namespace updated: Semantics.SilverSight → SilverSight
- Cross-project imports preserved: Semantics.FixedPoint, open Semantics.FixedPoint
- lakefile.toml: SilverSight lean_lib now uses srcDir = ../SilverSight
- AGENTS.md: READ-ONLY notice added — Research Stack is archived,
  all new formal work goes to SilverSight
- SilverSight/AGENTS.md: clean-slate operating contract

Build: SilverSight 3307 jobs, 0 errors
Build: Compiler 3314 jobs, 0 errors
This commit is contained in:
allaun 2026-06-22 15:05:14 -05:00
parent 0d387902bb
commit b6ab3e5f22
11 changed files with 115 additions and 28 deletions

View file

@ -1,8 +0,0 @@
import Semantics.SilverSight.Schema
import Semantics.SilverSight.WireFormat
import Semantics.SilverSight.ProductSchema
import Semantics.SilverSight.ProductWireFormat
import Semantics.SilverSight.Receipt
import Semantics.SilverSight.Bind
namespace Semantics.SilverSight

View file

@ -52,11 +52,13 @@ name = "ExtensionScaffold"
[[lean_lib]]
name = "Biology"
# ── SilverSight: schema/layout/wireformat core ──────────────────────────────
# Phase 1 core: product-type encoders, Receipt/Bind composition primitive.
# ── SilverSight: clean-slate rebase ─────────────────────────────────────────
# Lives at 0-Core-Formalism/lean/SilverSight/ (separate from Semantics tree).
# Imports Semantics.FixedPoint cross-project. Build: lake build SilverSight
[[lean_lib]]
name = "SilverSight"
roots = ["Semantics.SilverSight"]
srcDir = "../SilverSight"
roots = ["SilverSight"]
# OTOM external proofs — uncomment when resolving sorries.
# Build: lake build OTOMProofs

View file

@ -0,0 +1,63 @@
# AGENTS.md — SilverSight
**SilverSight is the clean-slate rebase of the Research Stack.**
## Location
```
0-Core-Formalism/lean/SilverSight/
SilverSight/
Schema.lean
WireFormat.lean
ProductSchema.lean
ProductWireFormat.lean
Receipt.lean
Bind.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 here.
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 (3307 jobs, 0 errors as of 2026-06-22).
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)
## 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 |

View file

@ -0,0 +1,8 @@
import SilverSight.Schema
import SilverSight.WireFormat
import SilverSight.ProductSchema
import SilverSight.ProductWireFormat
import SilverSight.Receipt
import SilverSight.Bind
namespace Semantics.SilverSight

View file

@ -1,6 +1,6 @@
import Semantics.SilverSight.Receipt
import SilverSight.Receipt
namespace Semantics.SilverSight
namespace SilverSight
open Semantics.FixedPoint
open Semantics.FixedPoint.Q16_16
@ -111,4 +111,4 @@ def r3 := mkReceipt .validate (Q16_16.ofInt 20) "wellformed" 3
#eval (bindReceipt r1 r2).cost -- expected: 5242880 (Q16_16 of 80)
#eval (bindReceipt r1 r2).wellFormed -- expected: true
end Semantics.SilverSight
end SilverSight

View file

@ -1,6 +1,6 @@
import Semantics.SilverSight.Schema
import SilverSight.Schema
namespace Semantics.SilverSight
namespace SilverSight
open Semantics.FixedPoint
@ -45,4 +45,4 @@ theorem prod_wellFormed [Schema α] [Schema β] (a : α) (b : β) :
#eval Schema.byteSize ((UInt8 × UInt8) × UInt32) -- expected: 6
#eval Schema.byteSize (UInt8 × UInt8 × UInt32) -- expected: 6
end Semantics.SilverSight
end SilverSight

View file

@ -1,7 +1,7 @@
import Semantics.SilverSight.WireFormat
import Semantics.SilverSight.ProductSchema
import SilverSight.WireFormat
import SilverSight.ProductSchema
namespace Semantics.SilverSight
namespace SilverSight
open Semantics.FixedPoint
@ -64,4 +64,4 @@ def boolPairRowMajor : WireFormat (Bool × Bool) Layout.rowMajor where
#eval uint8BoolRowMajor.decode (ByteArray.mk #[42, 1]) -- expected: some (42, true)
#eval Schema.byteSize (UInt8 × Bool) -- expected: 2
end Semantics.SilverSight
end SilverSight

View file

@ -1,6 +1,6 @@
import Semantics.FixedPoint
namespace Semantics.SilverSight
namespace SilverSight
open Semantics.FixedPoint
open Semantics.FixedPoint.Q16_16
@ -74,4 +74,4 @@ def Receipt.sharesInvariant (r1 r2 : Receipt) : Bool := r1.invariant == r2.invar
#eval (mkReceipt .encode Q16_16.zero "A" 1).sharesInvariant (mkReceipt .decode Q16_16.zero "A" 2) -- expected: true
#eval (mkReceipt .encode Q16_16.zero "A" 1).sharesInvariant (mkReceipt .decode Q16_16.zero "B" 2) -- expected: false
end Semantics.SilverSight
end SilverSight

View file

@ -1,6 +1,6 @@
import Semantics.FixedPoint
namespace Semantics.SilverSight
namespace SilverSight
open Semantics.FixedPoint
@ -65,4 +65,4 @@ instance : Schema Q0_16 where
#eval Schema.byteSize Q16_16 -- expected: 4
#eval Schema.byteSize Q0_16 -- expected: 2
end Semantics.SilverSight
end SilverSight

View file

@ -1,6 +1,6 @@
import Semantics.SilverSight.Schema
import SilverSight.Schema
namespace Semantics.SilverSight
namespace SilverSight
open Semantics.FixedPoint
@ -71,4 +71,4 @@ def boolRowMajor : WireFormat Bool Layout.rowMajor where
#eval boolRowMajor.decode (boolRowMajor.encode true) -- expected: some true
#eval boolRowMajor.decode (boolRowMajor.encode false) -- expected: some false
end Semantics.SilverSight
end SilverSight

View file

@ -2,6 +2,28 @@
This file is the first stop for coding agents working in this repository.
## ⛔ READ-ONLY NOTICE — SilverSight Has Replaced This Repo
**The Research Stack is a READ-ONLY archive.** SilverSight is the clean-slate
successor. All new formal work MUST go to `0-Core-Formalism/lean/SilverSight/`.
| Action | Allowed? |
|--------|----------|
| Add new Lean modules to `Semantics/Semantics/` | **NO** → use `SilverSight/` |
| Add new Python shims to `4-Infrastructure/shim/` | **NO** → use SilverSight shim dir |
| Edit existing Research Stack files (bug fixes, doc updates) | **YES** |
| Run `lake build` on existing modules | **YES** |
| Run DB sync scripts | **YES** |
| Add new AGENTS.md rules to Research Stack | **NO** → add to SilverSight |
**Enforcement:** Any agent that adds new files to the Research Stack Lean tree
(`0-Core-Formalism/lean/Semantics/Semantics/`) instead of SilverSight
(`0-Core-Formalism/lean/SilverSight/`) is violating this contract.
**SilverSight location:** `0-Core-Formalism/lean/SilverSight/`
**SilverSight AGENTS.md:** `0-Core-Formalism/lean/SilverSight/AGENTS.md`
**SilverSight build:** `lake build SilverSight` (from `0-Core-Formalism/lean/Semantics/`)
## Local Hermes Deployment (2026-06-20)
Hermes Agent v0.14.0 is the primary chat/dashboard gateway, serving the