allaun/SilverSight
1
0
Fork 0
mirror of https://github.com/allaunthefox/SilverSight.git synced 2026-07-31 01:25:21 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
SilverSight/docs/RRC_REFACTOR_READINESS.md
allaun 670e7617c3 refactor(rrc): rename corpus250→allFixtures/emitManifold, generic n-dimensional modules, Authentik deploy 
- Rename python/build_corpus250.py → python/build_manifold.py
- Rename emitCorpus250 → emitManifold, corpus250 → allFixtures
- Schema: avm_rrc_corpus250_v1 → avm_rrc_manifold_v1
- Classify.lean now delegates to ClassifyN (generic n-dim module)
- ClassifyN.hashTable8: extracted 119-entry hash table from old Classify
- build_manifold.py now emits ClassifyN.classifyProxy hashTable8 + classifyExact 8
- build_pist_matrices_250.py: added pistMatrixDim constant
- SilverSight docs/AGENTS.md updated for renames
- Research Stack AGENTS.md updated for toolchain references
- Authentik deployed on neon-64gb (port 30001, working)
- cross_domain_significance.py: statistical significance test (all phases <6σ with n=3)
- setup_authentik.sh: fixed image, password, port, key sharing

Build: 3307 jobs, 0 errors (lake build)
2026-06-30 04:54:40 -05:00

4.8 KiB
Raw Blame History

RRC Refactor Status

Date: 2026-06-21 Goal: Port the Research-Stack RRC (Receipt Routing Classifier) decision surface into SilverSight.

Status

Bare-minimum refactor is complete and building.

  • ✅ RRC logogram projection and admission gates
  • ✅ Receipt core with SilverSight.Core receipt bridge
  • ✅ RRC alignment gate (determineAlignment) + 6 canonical fixture rows
  • ✅ AVM ISA (Types, Value, Instr, State, Step, Run)
  • ✅ AVM canary bundle + top-level JSON emitter (AVMIsa.Emit)
  • ✅ AVM-stamped RRC fixture corpus emitter (emitFixtureCorpus)
  • ✅ Python raw-feature shims (pist_matrix_builder.py, validate_rrc_predictions.py)
  • ✅ Executable rrc-emit-fixture to extract the JSON bundle
  • ✅ RRC gates ported: ReceiptDensity, PolyFactorIdentity, EntropyCandidates
  • ✅ Q16_16 cross-language roundtrip test (Lean ↔ C ↔ Python)
  • ✅ Glossary entries for all new domain terms

Location

The RRC layer lives under formal/SilverSight/ (Lake module namespace SilverSight.*). User-facing symlinks are in formal/RRCLib/.

File Module Role
formal/SilverSight/RRCLogogramProjection.lean SilverSight.RRCLogogramProjection RRCShape, WitnessStatus, projection/merge gates
formal/SilverSight/ReceiptCore.lean SilverSight.ReceiptCore ReceiptKind, Receipt, ledger, core bridge
formal/SilverSight/RRC/Emit.lean SilverSight.RRC.Emit Alignment gate, FixtureRow, JSON emitter
formal/SilverSight/AVMIsa/Types.lean SilverSight.AVMIsa AvmTy closed-world type universe
formal/SilverSight/AVMIsa/Value.lean SilverSight.AVMIsa AvmVal typed values
formal/SilverSight/AVMIsa/Instr.lean SilverSight.AVMIsa Instr / Prim opcodes
formal/SilverSight/AVMIsa/State.lean SilverSight.AVMIsa AVM execution state
formal/SilverSight/AVMIsa/Step.lean SilverSight.AVMIsa step transition function
formal/SilverSight/AVMIsa/Run.lean SilverSight.AVMIsa Fuel-bounded run
formal/SilverSight/AVMIsa/Emit.lean SilverSight.AVMIsa.Emit Top-level JSON output boundary

Key architectural decisions

  1. Canonical fixed point moved to Core.

    • Core/SilverSight/FixedPoint.lean defines SilverSight.FixedPoint.Q16_16 / Q0_16.
    • formal/CoreFormalism/FixedPoint.lean is now a compatibility shim.
    • This lets SilverSightRRC import only Core/ + Mathlib, preserving the library method.

  2. Two receipt types with a bridge.

    • Core/SilverSightCore.lean keeps the external Receipt boundary.
    • formal/SilverSight/ReceiptCore.lean adds the internal validation receipt model and a toSilverSightReceipt bridge.

  3. Core AVM stays conceptual; concrete ISA lives in RRC.

    • Core/SilverSightCore.lean defines the abstract δ, Instruction, AVMState contract.
    • formal/SilverSight/AVMIsa/ implements the closed-world typed ISA.

Build commands

# All libraries
lake build

# Individual libraries
lake build SilverSightCore
lake build SilverSightFormal
lake build SilverSightRRC

# Emit and validate the fixture corpus JSON
lake build rrc-emit-fixture
.lake/build/bin/rrc-emit-fixture > /tmp/rrc_fixture_emitted.json
python3 python/validate_rrc_predictions.py /tmp/rrc_fixture_emitted.json

Verification results

Gate Result
lake build ✅ 2987 jobs, 0 errors
lake build SilverSightCore ✅ 2987 jobs, 0 errors
lake build SilverSightFormal ✅ 3132 jobs, 0 errors
lake build SilverSightRRC ✅ 3006 jobs, 0 errors
lake build rrc-emit-fixture ✅ green
lake build q16-roundtrip ✅ 5949 jobs, 0 errors
python3 -m py_compile python/pist_matrix_builder.py python/validate_rrc_predictions.py tests/test_q16_canonical.py .github/scripts/check_doc_sync.py .github/scripts/glossary_lint.py ✅ green
python3 .github/scripts/glossary_lint.py ✅ no warnings
python3 .github/scripts/check_doc_sync.py ✅ OK
rrc-emit-fixture | validate_rrc_predictions.py ✅ OK: 6 rows
python3 tests/test_q16_roundtrip.py ✅ 21 tests passed
.lake/build/bin/q16-roundtrip ✅ 35 Lean ↔ C tests passed
pytest tests/test_q16_canonical.py ⚠️ not run — pytest not installed in this environment

Out of scope (future work)

  • Full 250-equation Q16_16Manifold (requires PIST.Classify, PIST.Matrices250, source JSON).
  • python/build_manifold.py generator for the full corpus.
  • PIST classifier surface to populate pistProxyLabel / pistExactLabel from real matrices.
  • Concrete WireFormat/LayoutBridge instances for multi-field Core types such as BraidState.

References

  • Research-Stack sources: 0-Core-Formalism/lean/Semantics/Semantics/{RRC,AVMIsa,RRCLogogramProjection,ReceiptCore}.lean
  • SilverSight project map: docs/PROJECT_MAP.md