Research-Stack/0-Core-Formalism/lean/SilverSight/AGENTS.md
allaun b6ab3e5f22 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
2026-06-22 15:05:14 -05:00

1.9 KiB

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