6100565578
Addresses Devin Review on PR #11 ("Staged regression test passes vacuously — git diff runs in real repo, not temp repo"). Root cause: scripts/math-first/require_math_evidence.py hardcoded cwd=REPO_ROOT on the git subprocess. REPO_ROOT is computed from __file__, which always resolves to the REAL repo path -- even when the test invokes the script with cwd=tmp_path. So 'git diff --cached --name-only' queried the real (clean) repo, returned an empty list, and the script exited 0 via the noop short-circuit. The regression test then printed OK while never actually exercising the --staged classification logic. Fix: Introduce _git_toplevel() in require_math_evidence.py that runs 'git rev-parse --show-toplevel' from the *inherited* cwd. Both _files_from_staged() and _files_from_git_diff() now use that toplevel as their subprocess cwd. Pre-commit and CI both invoke the script from inside the repo root anyway, so behaviour in production is unchanged; only the test (and any other caller that runs the script from a non-Research-Stack directory) now works correctly. Test hardening: test_require_math_evidence.py's staged regression now drives the script via plain subprocess with cwd=tmp_path (no runpy wrapper, no os.chdir trickery) and covers three sub-cases against the same temp repo: (a) math-track-only staged -> expect exit 1 (negative) (b) math-track + receipt staged -> expect exit 0 (the bug) (c) math-track + claims.yaml -> expect exit 0 (registry) Sub-case (a) is the key addition: with the pre-fix script, this case wrongly returns 0 (real repo is clean -> noop), so the test fails loudly. Verified locally by temporarily reverting the cwd fix -- the test correctly reports 'FAIL staged_regression_negative: expected exit 1, got 0'. Docs: docs/math-first-tooling.md notes that receipt-required-for-math-content is a no-op in the CI pre-commit job (pre-commit's --from-ref/--to-ref mode does not touch the index, so --staged returns an empty list and the hook exits 0). PR-scope enforcement of the same rule lives in the dedicated require-evidence CI job. This addresses the Devin Review info comment on .pre-commit-config.yaml. Co-Authored-By: Allaun Silverfox <bigdataiscoming+9i37y6j2@protonmail.com> |
||
|---|---|---|
| .agents/plugins | ||
| .consolidation-manifests | ||
| .github | ||
| .vscode | ||
| 0-Core-Formalism | ||
| 1-Distributed-Systems | ||
| 2-Search-Space | ||
| 3-Mathematical-Models | ||
| 4-Infrastructure | ||
| 5-Applications | ||
| 6-Documentation | ||
| 6-Kernel-Shim | ||
| ai-math-discovery-systems | ||
| docs | ||
| hardware/tangnano9k/rtl/generated | ||
| hooks | ||
| info | ||
| plugins/substack-connector | ||
| scripts | ||
| shared-data | ||
| tools/kotc | ||
| workspace-config | ||
| .codeiumignore | ||
| .gitattributes | ||
| .gitignore | ||
| .gitmodules | ||
| .mcp.json | ||
| .pre-commit-config.yaml | ||
| .python-version | ||
| Agda_Test.agda | ||
| Agda_Test.agdai | ||
| AGENTS.md | ||
| ARCHITECTURE.md | ||
| CHANGELOG.md | ||
| changes.zip | ||
| CITATION.cff | ||
| claims.yaml | ||
| CONCEPTS.md | ||
| config | ||
| description | ||
| GETTING_STARTED.md | ||
| HEAD | ||
| lean_hardware_checker_summary.json | ||
| LICENSE | ||
| NOTICE | ||
| package-lock.json | ||
| package.json | ||
| PROJECT_MAP.md | ||
| pyrightconfig.json | ||
| README.md | ||
| test.lean | ||
| THIRD_PARTY_NOTICES.md | ||
| TODO_MAP.md | ||
Research-Stack (OTOM)
Ultra-low power, zero-decimal data routing and compression.
If you just stumbled across this repository, you might see words like "Topological State Machine" and "Manifold Points" and assume this is dense, academic magic. It isn't.
This project is actually built on a very simple, grounded idea: Modern computing is incredibly wasteful.
Right now, running AI or compressing massive datasets requires giant, power-hungry GPUs because they rely on Floating-Point Math (heavy decimals like 3.14159...). We prove that you don't need decimals. You can map complex data (like the grammar of the English language) into structural shapes, and navigate them using only simple integers (whole numbers).
Because we only use addition, subtraction, multiplication, and modulo, this system can run on a $15 blank-slate microchip (an FPGA) instead of a massive server farm.
🛠️ How we know it works (Zero Guesswork)
We do not guess that our integer math works. We prove it. The core of this project is written in Lean 4, a strict mathematical theorem prover. If our logic has a flaw, the code physically will not compile. We currently have over 3,500 mathematically verified proofs securing this engine.
Python, Rust, and Verilog only exist in this repository to act as "dumb pipes" to feed data into our proven mathematical core.
📁 Repository Structure (By Goal)
Everything is numbered so you know exactly what depends on what.
| Folder | What it actually is (Plain English) |
|---|---|
0-Core-Formalism/ |
The Brain. Lean 4 code. The mathematically proven integer arithmetic. This is the source of truth. |
1-Distributed-Systems/ |
The Network. Code for making multiple computers talk to each other to share the workload. |
2-Search-Space/ |
The Navigator. Algorithms that search through our data shapes to find the best routes. |
3-Mathematical-Models/ |
The Library. Where we store our databases of equations and compressed English grammar shapes. |
4-Infrastructure/ |
The Drivers. Code that physically talks to the hardware, GPUs, and APIs. |
5-Applications/ |
The Executables. Python scripts that run the system end-to-end. (These are just shims connecting data to our Lean 4 Brain). |
6-Documentation/ |
The Manual. Where you'll find plain-English explanations and our theoretical papers. |
shared-data/ |
Raw data, cache, and exported files. |
📖 Where to start?
If you are new here, read these two files first:
- Explanation for Humans - A translation guide for our technical jargon.
- Calculator-Plain Math - Proof that every complex concept we use can be calculated on a high-school graphing calculator.
🚀 Quick Start
# 1. Compile the mathematically proven core (Takes ~1-2 minutes)
cd "0-Core-Formalism/lean/Semantics"
lake build
# 2. Run the English Manifold Builder (Compresses English via grammar shapes)
cd "../../.."
python3 5-Applications/scripts/redpajama_english_manifold.py
⚖️ The One Rule for Contributors
Lean is the source of truth.
If you add logic, it goes in 0-Core-Formalism/lean/Semantics/ and must be mathematically proven. Python scripts may not contain complex math, branching logic, or cost functions. Python is just the delivery boy for Lean.
Research Stack — All Rights Reserved