Curated research repository for the HCT/abc research line within the research-line organization and open-bricks umbrella.
Note
Machine-readable repository context guidelines, canonical search phrases, and safety boundaries are maintained in llms.txt. Discoverability dossier in MARKETING-LOG.txt. Third-party open-science dependency inventory in THIRD_PARTY_LICENSES.md. Security guarantees and 48-hour SLA are outlined in SECURITY.md. Last checked: 2026-09-19.
| # | Section | Description |
|---|---|---|
| 1 | Quick Reference | Core metadata, runtime stack & operational guarantees |
| 2 | Key Scientific Findings | Breakthrough computational results in Hecke curve arithmetic |
| 3 | Target Personas & Discoverability | Four scientific personas & high-intent search phrases |
| 4 | Comparative Matrix vs. Alternatives | Invariant-mapped benchmark against 4 computing approaches |
| 5 | Dual Mermaid Diagrams & Verification Flow | Visual 5-tier architecture & sequence diagrams |
| 6 | System Architecture & Pipeline | Modular computation and certifier architecture |
| 7 | Curated Verification Lifecycle | Deterministic proof-verification sequence flow |
| 8 | Core Capabilities & Research Invariants | 10 architectural, privacy & governance guarantees |
| 9 | Evidence Mapping & Paper References | Citation ledger backing Zenodo Paper A & Paper B |
| 10 | Computational Milestones & Batches | Chronological computation milestones & H3a certificates |
| 11 | Modular Symbol Pairing & Basket Elimination Artifacts | Deep dive into GF(3863) quotient elimination artifacts |
| 12 | Repository Policy & Staged Disclosure | Public release policy & proof-scratch isolation rules |
| 13 | Sibling Research & Ecosystem Matrix | 16 cross-organization research & software siblings |
| 14 | Discovery & LLM Context | Machine-readable manifests & AI indexing specifications |
| 15 | Project Structure | Repository layout and script taxonomy |
| 16 | Testing & Verification | Pytest, compile check, and verification reproduction commands |
| 17 | Third-Party Licenses | Open-source licenses for Python, SageMath, and PARI/GP |
| 18 | Security Policy & Statutory Notice | Vulnerability disclosure SLA, zero-egress policy & § 521 BGB disclaimer |
| Property | Value |
|---|---|
| Canonical Repository | research-line/abc-hct |
| Parent Organization | research-line |
| Umbrella Ecosystem | open-bricks |
| Scientific Backing | Zenodo Paper A (10.5281/zenodo.21916900) & Paper B |
| Mathematics Stack | Python 3.10-3.13, SageMath 10.x, PARI/GP 2.15 |
| Execution Boundary | 100% Offline, Local-First, Zero-Egress, Non-Elevation (RunAsInvoker) |
| Result Ledger | 120+ Curated Certificates (_results/) |
| Security SLA | 48h Response Acknowledgment / 5-Day Triage SLA |
| License | MIT License |
-
No-Magma Manin-Hecke Quotient (Basket Kill): Open-source SageMath/Python modular symbol pairing over
$\text{GF}(3863)$ has successfully eliminated the mapped basket levels60168,80224,120336, and240672in bothrawandancmodes without proprietary software. - H3a Residue-Line Witnesses (RC3c): Deterministic per-level witnesses, cusp-fan rank chains, and prefix profiles verified across all 4 mapped levels.
-
M-DET Block-Rank & Drop-Primes: Verified rank drop certificates for levels
60168and240672documenting non-trivial kernel structures. -
R1 Faithful-AL
$\mathbb{Q}_B$ -Schur Certificate: Automated field-check verified for level80224/raw, confirming character orthogonality. -
Frey-Watkins Saturation Dynamics: Empirical analysis of 15 classical Frey triples falsifying naive universal bounds while sustaining quality-conditional bounds
$\rho \ge (q-1)+c$ .
abc-hct is engineered to serve four distinct research personas across the international mathematical and computational sciences community:
| Persona ID | Target Audience | Primary Mission & Use Case | Key Repository Interfaces |
|---|---|---|---|
[PERSONA-01] |
Arithmetic Geometers & Number Theorists | Investigating Hecke curves, modular Jacobians, and Frey curve invariants without commercial software |
_scripts/frey_watkins_phase2.gp, _scripts/mstar_*.py
|
[PERSONA-02] |
Computational Algebraists & Open-Science Researchers | Replicating Manin symbol pairings over finite fields |
_results/*.json, REPRODUCIBILITY_H3A_2026-05-17.md
|
[PERSONA-03] |
Mathematical Software Engineers & Proof Engineers | Constructing zero-egress, offline-first deterministic CI verification pipelines under strict PEP 621 |
.github/workflows/, pyproject.toml, pytest
|
[PERSONA-04] |
Research Program Evaluators & Zenodo Auditors | Auditing reproducible computational artifacts cited in Zenodo Paper A (DOI 10.5281/zenodo.21916900) |
CHANGELOG.md, llms.txt, THIRD_PARTY_LICENSES.md
|
- abc conjecture computational verification python sagemath
- no magma manin symbol pairing modular curves sagemath
- hecke algebra modular symbol quotient gf 3863 rank drop
- frey watkins saturation bounds pari gp
- reproducible arithmetic geometry open science zenodo
The following matrix benchmarks abc-hct against standard commercial, cloud, and ad-hoc mathematical computing environments across all 10 project invariants:
| Invariant / Architectural Criterion | abc-hct (research-line) | Proprietary Magma Scripts | Raw Ad-Hoc PARI/GP Scripts | Cloud CAS / CoCalc | General CAS (Mathematica/Maple) |
|---|---|---|---|---|---|
INV-DET-01 Deterministic Verification |
✅ 100% Deterministic | ❌ Stochastic container runs | ❌ Black-box heuristic solves | ||
INV-ZE-02 Zero-Egress Offline Privacy |
✅ Complete local isolation | ✅ Fully offline | ❌ Required cloud network | ||
INV-CUR-03 Curated Evidence Isolation |
✅ Strict .gitignore boundaries |
❌ Undisciplined disk dumps | ❌ Mixed scratch & notes | ❌ Cloud notebook sync leaks | ❌ Proprietary notebook dumps |
INV-CERT-04 Machine-Readable Ledger |
✅ 120+ JSON/MD Certificates | ❌ Ad-hoc terminal printouts | ❌ Raw unparsed text logs | ❌ Unstructured notebook output | ❌ Proprietary binary cells |
INV-ENV-05 Bounded Compute Harness |
✅ Sandboxed compute queues | ❌ Unbounded manual scripts | ❌ Unbounded shell scripts | ||
INV-MSTAR-06 No-Magma Symbolic Engine |
✅ SageMath GF(3863) Symbols | ❌ Hard Magma dependency | ❌ Cloud-dependent | ❌ Incompatible symbol core | |
INV-SEC-07 Unprivileged RunAsInvoker |
✅ Standard unprivileged user | ✅ Standard user mode | ❌ Shared multi-tenant VM | ||
INV-LIC-08 Permissive Open-Science |
✅ Permissive MIT License | ❌ Expensive commercial license | ❌ Proprietary subscription | ❌ Expensive commercial license | |
INV-DOC-09 Bilingual & LLM-Ready |
✅ 100% DE/EN & llms.txt |
❌ Sparse / undocumented | ❌ Minimal comments only | ❌ Scattered notebooks | ❌ Closed proprietary docs |
INV-SLA-10 Security & Triage SLA |
✅ 48h Response / 5d Triage | ❌ No public issue tracker | ❌ No security disclosures |
Visual architectural breakdown providing both structural module dependencies and dynamic proof certification execution:
flowchart TD
subgraph T1["1. Entrypoints & Driver Layer"]
CLI["_scripts/ CLI & Drivers"]
Queue["_compute_queue/ Bounded Harness"]
end
subgraph T2["2. Computer Algebra Engines"]
SageEngine["SageMath 10.x Engine"]
PariEngine["PARI/GP 2.15 CLI Engine"]
end
subgraph T3["3. Algebraic Quotient Core (No-Magma)"]
ManinPairs["Manin Symbol Pairing over GF(3863)"]
HeckeOps["Hecke Annihilator Operators (T_5, T_7)"]
SchurCert["R1 Faithful-AL Q_B Schur Certifier"]
FWSat["Frey-Watkins Saturation Analyzer"]
end
subgraph T4["4. Quality Gates & Security Hygiene"]
PytestSuite["pytest (42 Contract Tests)"]
RuffCheck["Ruff Code Hygiene & Linter"]
PolicyGate["test_policy.py (Zero Leaks)"]
end
subgraph T5["5. Curated Open-Science Ledger"]
ResultLedger["_results/ (120+ JSON/MD Certificates)"]
ZenodoRef["Zenodo Paper A Concept DOI"]
end
CLI --> SageEngine
CLI --> PariEngine
Queue --> SageEngine
SageEngine --> ManinPairs
ManinPairs --> HeckeOps
HeckeOps --> SchurCert
PariEngine --> FWSat
SchurCert --> ResultLedger
FWSat --> ResultLedger
ResultLedger --> PytestSuite
PytestSuite --> RuffCheck
RuffCheck --> PolicyGate
PolicyGate --> ZenodoRef
The computational pipeline of abc-hct connects offline CLI drivers with rigorous computer algebra engines to produce immutable proof certificates:
flowchart TD
A["SageMath / Python Driver (_scripts/)"] --> B["Manin Symbol Pairing Engine"]
B --> C["Hecke Algebra Operators (T_5, T_7)"]
C --> D["Manin-Hecke Quotient Kernel Certifier"]
D --> E["Machine-Readable Results (_results/)"]
F["PARI/GP Script (_scripts/frey_watkins_phase2.gp)"] --> G["Frey-Watkins Saturation Checker"]
G --> E
H["Compute Queue Harness (_compute_queue/)"] --> D
The lifecycle sequence coordinates mathematical pairing, Hecke operator annihilation, deterministic certificate persistence, and automated quality gate assertions:
sequenceDiagram
autonumber
participant D as Driver / Verifier (_scripts/)
participant M as Manin Symbol Engine
participant H as Hecke Algebra (T_5, T_7)
participant C as Certificate Ledger (_results/)
participant G as Gate Hygiene (pytest / CI)
D->>M: Compute modular symbol pairings over GF(3863)
M->>H: Apply sparse Hecke operator annihilators
H->>C: Emit deterministic rank certificate
C->>G: Verify certificate hash and dimension drops
G-->>D: Output verified quotient status
abc-hct strictly enforces ten architectural, scientific, and governance invariants across all calculation modules, certificates, and test gates:
| Invariant ID | Guarantee Name | Architectural & Operational Description |
|---|---|---|
INV-DET-01 |
Deterministic Algebraic Verification | All Hecke operator applications, modular symbol pairings over |
INV-ZE-02 |
100% Offline & Zero-Egress Privacy | All calculations, verification scripts, and test runners operate completely offline with zero external network calls or telemetry exfiltration. |
INV-CUR-03 |
Curated Evidence & Non-Pollution | Strict separation between curated publishable reproduction harnesses and private research proof scratch; uncurated notes, handoffs, and raw snapshots remain isolated. |
INV-CERT-04 |
Machine-Readable Certificate Ledger | Every milestone computational result is stored as a machine-readable JSON/text certificate in _results/ with verifiable checksums and exact script reproducibility mapping. |
INV-ENV-05 |
Cross-Platform Math Environment Isolation | Python 3.10-3.13 harness with explicit dependencies on SageMath 10.x and PARI/GP 2.15, bounded compute queue execution, and clean fallback handling. |
INV-MSTAR-06 |
No-Magma Modular Symbol Engine | Manin-Hecke quotient computations execute via self-contained open-source SageMath/Python algorithms without proprietary Magma computational dependencies. |
INV-SEC-07 |
Local-First Sandboxing & Non-Elevation | Compute queue scripts and pytest test runners execute strictly in unprivileged user-mode (RunAsInvoker) without system elevation or modifying files outside the repository tree. |
INV-LIC-08 |
Permissive Open-Science Licensing | Code and reproduction harnesses released under the standard MIT License, fully compatible with open science dissemination and Zenodo archival. |
INV-DOC-09 |
Bilingual & LLM-Ready Parity | 100% structural and anchor parity between README.md and README_de.md, complemented by machine-readable architectural manifests in llms.txt. |
INV-SLA-10 |
48-Hour Security Response & 5-Day Triage SLA | Guaranteed acknowledgement of security and vulnerability disclosures within 48 hours and formal triage within 5 business days via security@open-bricks.org and GitHub Advisories. |
Every result category below is cited in at least one of the papers that this repository backs. DOI is the Zenodo concept DOI (always resolves to the latest version); Paper/Reference names the citing manuscript and, where the paper pins an exact filename, that filename.
| Result category | Levels / scope | Reproducer script(s) | Result files (_results/) |
Cited by |
|---|---|---|---|---|
| No-Magma Manin-Hecke quotient (basket kill) | 60168, 80224, 120336, 240672 (raw+anc) over GF(3863) |
_scripts/mstar_nomagma_*.py |
mstar_nomagma_* (127 files) |
Paper A "Global Congruence Routes"/"Hecke Diagnostics"; Paper B mstar_nomagma_result_audit_2026-05-12.md, mstar_nomagma_rc3d_rowhash_60168_raw*_2026-05-12.md |
| H3a residue-line witnesses (RC3c) | all 4 levels, raw+anc |
_scripts/mstar_h3a_*.py |
mstar_h3a_* (per-level witnesses, cusp-fan rank chains, prefix profiles) |
Paper A "The bridge search" (Table 1, raw/anc per-level ledger); REPRODUCIBILITY_H3A_2026-05-17.md |
| M-DET block-rank / rank-drop-primes | 60168, 240672 |
_scripts/mdet3_block_rank_60168.py |
mdet3_block_rank_60168_2026-06-14.*, mdet_240672_rank_drop_primes_2026-06-13.* |
Paper B (exact filenames cited) |
| R1 faithful-AL Q_B-Schur certificate | 80224/raw |
Compute-queue job r1_faithful_al_80224_raw_2026-06-14 + r1_faithful_al_80224_raw_field_check_2026-06-27.py |
r1_faithful_al_80224_raw_2026-06-14.*, r1_faithful_al_80224_raw_field_check_2026-06-27.* |
Paper B (exact filename cited; field-check added 2026-08-17) |
| Self-averaging diagnostic | quality tail, dyadic buckets | _scripts/abc_quality_self_averaging_probe*.py |
abc_quality_self_averaging_probe_2026-06-14.* |
Paper A "Self-averaging diagnostic" (subsec:self_averaging) |
| Frey-Watkins saturation (Phase 1-3b, h_delta) | 15 classical Frey triples + 60-point Sage sample | _scripts/frey_watkins_phase2.gp, _scripts/frey_watkins_phase2.py, _scripts/frey_watkins_phase3.py, _scripts/frey_watkins_phase3b.py |
frey_watkins_saturation_phase*, frey_faltings_sandwich_phase3b_2026-05-17.* |
Paper A (naive-FWS-falsified / quality-conditional-FWS-c framing) |
| CX2/CX3 Codex-suggested kill-or-go tests | de-Smit-champion sample (n=230-240) | _scripts/cx2_cx3_codex_tests.py |
cx2_cx3_codex_tests_2026-06-11.* |
Negative controls referenced across the programme's route audits |
| Paper | DOI (concept) | Status |
|---|---|---|
| Paper A -- "From Landscape to Atlas: Multi-Route Cartography of an Ongoing Expedition Toward the abc Conjecture" | 10.5281/zenodo.21916900 | Live, versioned on Zenodo |
| Paper B -- "Beneath the abc Landscape: Hecke Quotients and the HCT Route" | Upcoming | Draft, in progress |
-
Current Computational Milestone: The no-Magma Sage/Python Manin-Hecke quotient over
$\text{GF}(3863)$ has eliminated the mapped basket60168/80224/120336/240672in bothrawandancmodes. The remaining work focuses on theoretical embedding, rank certification, and uniform FAQS/M* transfer. -
H3a Reproducibility Batch (
2026-05-17): Reproduction scripts and machine-readable certificates added under_scripts/and_results/. Includes the240672/rawstandard certificate ($T_5$ leaves dimension 1, then$T_7$ annihilates the final line). -
Frey-Watkins Exploratory Batch (
2026-05-17): Phase-1/Phase-2 saturation outputs under_results/._scripts/frey_watkins_phase2.gpreproduces the PARI/GP Phase-2 calculation for 15 classical Frey triples.
The core computational achievement of this repository is the complete open-source elimination of the target level basket without requiring commercial Magma licenses:
-
Finite Field Arithmetic over
$\text{GF}(3863)$ : Modular symbol pairings are computed deterministically, mapping Manin symbol generators directly to modular curve Jacobians. -
Sequential Annihilator Action (
$T_5 \to T_7$ ): Hecke operators act sequentially on quotient spaces. In level240672/raw,$T_5$ reduces the quotient kernel to a 1-dimensional subspace, which is subsequently eliminated by$T_7$ . -
Reproducibility Harness: Every calculation is accompanied by standalone verification drivers under
_scripts/allowing any researcher with standard Python, SageMath, and PARI/GP to independently verify the rank drop certificates in seconds.
- Public since 2026-08-18 (DOI/public release gate reached: Paper A live since 2026-08-13, DOI 10.5281/zenodo.21916900).
- GitHub normally receives computation scripts and reproducible results, not internal proof notebooks.
- Do not push
BEWEISNOTIZ*,_proof-notes/, handoffs, raw agent transcripts, credentials, or proof scratch by default. - Internal control/state files such as
TODO.md,GAPS.md,AKTIONSPLAN.md,MEMORY.md,IDEENSPEICHER*.md, local source caches, and raw_data/snapshots stay local by default. - Internal proof notes become repo-publishable only after journal publication and explicit release as attached notes.
- Exploratory result notes become repo-eligible only together with the reproducer script they cite.
- Public release contains only curated paper files, reproducibility scripts, selected results, and a clean disclosure/status note.
abc-hct collaborates within the broader open-bricks open-source and open-science ecosystem:
| Repository | Organization | Focus & Scientific Domain | Language / Stack |
|---|---|---|---|
| functional-stability-theory | research-line |
Functional Stability Theory core framework & contract forms | Python / LaTeX |
| fst-nash | research-line |
Algorithmic game theory and evolutionary Nash equilibrium stability | Python / SageMath |
| economic-sanctions-coercive-diplomacy | research-line |
Formal quantitative analysis of economic sanctions & diplomacy | Python / LaTeX |
| prompt-archaeology-casestudy2 | research-line |
Prompt archaeology & LLM reasoning trajectory provenance | Python |
| connes-cvs | research-line |
Connes trace formula & global field distributions | Python / SageMath |
| direct-beam | research-line |
Optical beam & diffraction pattern modeling | Python / NumPy |
| rh-even-dominance | research-line |
Riemann Hypothesis even dominance & spectral bounds | Python / SageMath |
| CultureEvolution | entertain-and-more |
Cultural evolution models & 4X civilization game | Luau / Rojo |
| DevCenter | dev-bricks |
Developer workspace & project orchestration | TypeScript / Electron |
| CodeBox | dev-bricks |
Multi-language sandboxing & code execution | Rust / TypeScript |
| automation-master | dev-bricks |
Multi-agent pipeline orchestration | Python |
| cleaner-tree | file-bricks |
Local-first filesystem maintenance & deduplication | Python / PySide6 |
| SoftwareCenter | file-bricks |
Desktop software package manager & catalog | Python / PySide6 |
| USR_pic2pic | doc-bricks |
Unprivileged local batch image conversion | Python / Tkinter |
| ellmos-installer | ellmos-ai |
Non-elevated dual-gate installer engine | Python |
| open-bricks | open-bricks |
Umbrella open source software & research portfolio | Python / Markdown |
abc-hct provides structured, machine-readable specifications to ensure autonomous agents and scholars can ingest architecture and status without token overhead:
llms.txt: Fast-loading LLM index detailing module boundaries, invariants, testing gates, and research interfaces.MARKETING-LOG.txt: Discoverability dossier covering value propositions, research personas, search phrases, and strategic roadmaps.THIRD_PARTY_LICENSES.md: Open-source licensing inventory covering engine runtimes, toolchains, and mathematical libraries.
abc-hct/
├── .github/workflows/ # GitHub Actions CI workflow (abc-hct-hygiene.yml, stale, welcome)
├── _compute_queue/ # Compute queue jobs, runner harnesses & local logs
├── _results/ # 120+ Curated machine-readable result certificates
├── _scripts/ # SageMath, PARI/GP & Python reproduction scripts
├── assets/ # Repository branding banner
├── tests/ # Automated metadata, contract & syntax test suite
│ ├── test_metadata.py # Metadata, navigation parity & invariant contracts
│ ├── test_policy.py # Gitignore, path leak & boundary policy tests
│ └── test_scripts_compilation.py # Python syntax compilation tests
├── pyproject.toml # PEP 621 metadata, toolchain & pytest configuration
├── CHANGELOG.md # Semantic version release changelog
├── MARKETING-LOG.txt # Discoverability, SEO, & Persona audit
├── THIRD_PARTY_LICENSES.md # Mathematical engine & toolchain license inventory
├── SECURITY.md # Bilingual security policy & 48h SLA commitments
├── REPRODUCIBILITY_H3A_2026-05-17.md # H3a reproducibility overview
├── LICENSE # MIT License
└── llms.txt # Machine-readable context index
abc-hct maintains a comprehensive automated testing pipeline verifying documentation contracts, syntax hygiene, and repository security policies:
# Run full automated pytest suite (42 tests)
pytest -ra -v
# Run Python bytecode compilation check across all scripts and tests
python -m compileall _scripts tests
# Run Ruff code hygiene check
ruff check .
# Execute Frey-Watkins Phase-2 reproduction check (PARI/GP)
gp _scripts/frey_watkins_phase2.gp
# Verify quotient rank certificates
python _scripts/mstar_h3a_rc3c_witness_verify_rank.pyabc-hct relies exclusively on permissive and open-source mathematical systems and testing toolchains:
- Python Standard Library: Python Software Foundation License (PSFL-2.0)
- SageMath: GNU General Public License Version 2 or later (GPL-2.0+)
- PARI/GP: GNU General Public License Version 2 or later (GPL-2.0+)
- pytest & Ruff: MIT License / Apache License 2.0
All third-party copyrights, license terms, and the Level 1 SBOM Invariant Cross-Reference Matrix are inventoried in THIRD_PARTY_LICENSES.md.
For security advisories, vulnerability disclosures, and safety invariants, see SECURITY.md.
abc-hct commits to:
- 48-Hour Response SLA: Initial confirmation of security vulnerability reports within 48 hours.
- 5-Day Triage Commitment: Structured assessment and remediation roadmap within 5 business days.
- Zero-Egress Privacy: 100% offline local computation with zero external telemetry.
- Unprivileged Execution: Strictly unprivileged user-mode execution (
RunAsInvoker).
This mathematical open-science research repository and all verification scripts are provided free of charge as open-source software. Pursuant to Section 521 of the German Civil Code (BGB), liability for defects in quality and title is limited to intent and gross negligence. Computational results are generated deterministically according to rigorous scientific standards, but do not replace formal peer review.
Dieses mathematische Open-Science-Forschungsprojekt und sämtliche Berechnungs- und Verifikationsskripte werden unentgeltlich als Open-Source-Software zur Verfügung gestellt. Gemäß § 521 BGB (Haftung des Schenkers) ist die Haftung für etwaige Sach- und Rechtsmängel auf Vorsatz und grobe Fahrlässigkeit beschränkt. Berechnungen und wissenschaftliche Artefakte erfolgen nach bestem Wissen deterministisch, ersetzen jedoch keine formale mathematische Peer-Review-Begutachtung.
This project is licensed under the MIT License — see the LICENSE file for details.
