mirror of
https://github.com/allaunthefox/SilverSight.git
synced 2026-08-10 04:40:35 +00:00
allaun
4f7c554981
New modules in formal/SilverSight/: - Schema.lean: Schema class with 6 type instances - WireFormat.lean: WireFormat structure + Layout enum - ProductSchema.lean: Schema (α × β) instance - ProductWireFormat.lean: Row-major pair encoders - Receipt.lean: Receipt structure + GateType enum - Bind.lean: bindReceipt composition primitive Build: 3307 jobs, 0 errors (from Research Stack lake build SilverSight) All modules use Semantics.FixedPoint cross-project import.
63 lines
1.9 KiB
Markdown
63 lines
1.9 KiB
Markdown
# 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 |
|