mirror of
https://github.com/allaunthefox/Research-Stack.git
synced 2026-07-31 03:05:21 +00:00
Squash the four overlapping feature branches into a single change set against main, eliminating cross-PR merge conflicts and the duplicated CI-fix scripts. What this brings in (merge order #79 -> #80 -> #81 -> #89): - #79 refactor(infra): shared utilities (4-Infrastructure/lib/*: q16, hashing, jsonl, fraction_utils) + the scripts/math-first/* validators that the math-check CI requires. - #80 feat(lean): Semantics.E8Sidon (1025 lines) -- Eisenstein coefficient identity E4^2 = E8 and the Sidon framework. E4_sq_eq_E8_coeff is fully proved (all Fourier-coefficient extraction machine-checked); the single residual gap is pinned to E4_sq_eq_E8_qExpansion (Mathlib lacks the valence formula / dim M8 = 1). 4 sorries + 1 axiom (e8_additive_completeness), all TODO(lean-port). - #81 refactor(lean): Float-free FixedPoint core (integer-only sqrt/log2/expNeg). E8Sidon.lean kept at #80's final 1025-line version (the #81 intermediate 438-line copy was overridden by merge order). - #89 feat(lean): Semantics.RRC.PolyFactorIdentity -- short-sleeve polynomial detection at the zerocopy limb boundary; now imports Semantics.E8Sidon for sigma3/sigma7/convolutionLHS (single source of truth) instead of inlining them. Conflict resolution: - flake.nix -> canonical rs-surface removal (Garnix shutdown). - scripts/math-first/* -> byte-identical across branches, clean. - .cursorrules / AGENTS.md -> unified; baselines + sorry inventory refreshed. Verification: - lake build (default aggregator): 3573 jobs, 0 errors. - lake build Semantics.RRC.PolyFactorIdentity (E8Sidon + FixedPoint + PolyFactor): 3655 jobs, 0 errors. Witnesses verified (sigma7 4 = 16513, convolutionLHS 6 = 2350). - Python tests: 68/68 pass. Note: the "Workers Builds: researchstack" check is a preexisting external Cloudflare build unrelated to this change (no branch touches 4-Infrastructure/cloudflare/). Build: 3573 jobs (default), 3655 jobs (narrow), 0 errors Co-Authored-By: Allaun Silverfox <bigdataiscoming+9i37y6j2@protonmail.com>
89 lines
3.3 KiB
Text
89 lines
3.3 KiB
Text
import Semantics.FixedPoint
|
|
|
|
/-!
|
|
# FixedPointBoundary — Float ↔ Q16_16 / Q0_16 / Q0_64 conversion
|
|
|
|
These functions are **only** for the I/O boundary: parsing JSON, reading sensor
|
|
data, or displaying values in `#eval` witnesses. They must NOT be used in any
|
|
compute-path definition that feeds into a receipt, score, or gate.
|
|
|
|
The core `Semantics.FixedPoint` module is Float-free by design.
|
|
-/
|
|
|
|
namespace Semantics.FixedPoint
|
|
|
|
-- ═══════════════════════════════════════════════════════════════════════════
|
|
-- Q0.16 Float boundary
|
|
-- ═══════════════════════════════════════════════════════════════════════════
|
|
|
|
namespace Q0_16
|
|
|
|
def toFloat (q : Q0_16) : Float :=
|
|
Float.ofInt q.toInt / 32767.0
|
|
|
|
def ofFloat (f : Float) : Q0_16 :=
|
|
if f.isNaN then zero
|
|
else if f ≥ 1.0 then one
|
|
else if f ≤ -1.0 then neg one
|
|
else if f < 0.0 then
|
|
ofRawInt (-(Int.ofNat ((-f * 32767.0).round.toUInt16.toNat)))
|
|
else
|
|
ofRawInt (Int.ofNat ((f * 32767.0).round.toUInt16.toNat))
|
|
|
|
end Q0_16
|
|
|
|
-- ═══════════════════════════════════════════════════════════════════════════
|
|
-- Q16.16 Float boundary
|
|
-- ═══════════════════════════════════════════════════════════════════════════
|
|
|
|
namespace Q16_16
|
|
|
|
@[inline]
|
|
def ofFloat (f : Float) : Q16_16 :=
|
|
if f.isNaN || f ≥ 32768.0 then infinity
|
|
else if f ≤ -32768.0 then minVal
|
|
else if f < 0.0 then
|
|
ofRawInt (-(Int.ofNat ((-f * 65536.0).floor.toUInt32.toNat)))
|
|
else
|
|
ofRawInt (Int.ofNat ((f * 65536.0).floor.toUInt32.toNat))
|
|
|
|
@[inline]
|
|
def toFloat (q : Q16_16) : Float :=
|
|
Float.ofInt q.toInt / 65536.0
|
|
|
|
end Q16_16
|
|
|
|
-- ═══════════════════════════════════════════════════════════════════════════
|
|
-- Q0.64 Float boundary
|
|
-- ═══════════════════════════════════════════════════════════════════════════
|
|
|
|
def q0_64ScaleFloat : Float := 9223372036854775808.0
|
|
|
|
namespace Q0_64
|
|
|
|
def ofFloat (f : Float) : Q0_64 :=
|
|
if f.isNaN || f ≥ 1.0 then one
|
|
else if f ≤ -1.0 then ofRawInt q0_64MinRaw
|
|
else if f < 0.0 then
|
|
ofRawInt (-(Int.ofNat ((-f * q0_64ScaleFloat).floor.toUInt64.toNat)))
|
|
else
|
|
ofRawInt (Int.ofNat ((f * q0_64ScaleFloat).floor.toUInt64.toNat))
|
|
|
|
def toFloat (q : Q0_64) : Float :=
|
|
Float.ofInt q.toInt / q0_64ScaleFloat
|
|
|
|
end Q0_64
|
|
|
|
end Semantics.FixedPoint
|
|
|
|
namespace Semantics
|
|
namespace Q16_16
|
|
export FixedPoint.Q16_16 (ofFloat toFloat)
|
|
end Q16_16
|
|
namespace Q0_16
|
|
export FixedPoint.Q0_16 (toFloat ofFloat)
|
|
end Q0_16
|
|
namespace Q0_64
|
|
export FixedPoint.Q0_64 (ofFloat toFloat)
|
|
end Q0_64
|
|
end Semantics
|