Add files via upload

Author: EmergentMonk

HERESY_README.md

@@ -0,0 +1,131 @@
+# 🐍 HERESY v1.0.0 — C-in-Rust, Rust-in-C, Makefiles in Tears
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+[![CI: Passed (Sanity Failed)](https://img.shields.io/badge/CI-passed_(sanity_failed)-red.svg)](https://github.com/QSOLKCB/HERESY/actions)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.17588734.svg)](https://doi.org/10.5281/zenodo.17588734)
+[![Status: Unholy](https://img.shields.io/badge/status-unholy-black.svg)](#)
+[![Build: Recursive](https://img.shields.io/badge/build-ouroboros-8e44ad.svg)](#)
+
+> *"Because one build system was never enough."*  
+> — QSOL-IMC, Department of Recursive Theology  
+
+---
+
+               _       _                     
+      _      / \~~~/\ \      _
+   /~   \   (   . .   )   /   ~\
+  (  . .  )  \  vvv  /  (  . .  )
+   \  vvv  / /       \  \  vvv  /
+    /     \/  C-in-Rust \     \ 
+    | Rust-in-C-in-Rust |      |
+    |   Build Ouroboros |      |
+    |   ___       ___   |      |
+    |  (___)----(___)  |      |
+     \      ~~~~      /       
+      ~\           /~
+        \         /
+         ~-.___.-~
+
+      "CI Passed, Sanity Failed."
+
+        .-""""-.
+       / -   -  \\
+      |  o   o  |
+      |    ^    |      # CARGO CULT
+       \\  '-'  /      "Just trust the build."
+        '-._.-'
+
+  "I don't know why it works. But the README says to run cargo run."
+
+## 👹 Build System Heresy One-Liners
+“If your build system makes sense, you’re doing it wrong.”
+
+“Recursive cargo calls? That’s not a bug, that’s a feature.”
+
+“Makefiles are for mortals. Ouroboros builds are for legends.”
+
+“If CI passes but nobody understands how, you’ve achieved enlightenment.”
+
+“I wrote a compiler that compiles a compiler that compiles my excuses.”
+
+“Build so complex, even Stack Overflow asks you for help.”
+
+“If it works on my machine, it’s production-ready.”
+
+“Why settle for dependency hell when you can have dependency recursion?”
+
+“The only thing more infinite than this build loop is my sense of irony.”
+
+“Documentation is just a list of things you’ll forget you did.”
+
+## 🚀 What’s New
+Full C program now embedded as a string literal in Rust (src/main.rs).
+
+Rust will:
+
+Write the C source for a “generator” program
+
+Compile it
+
+Run it
+
+That C generator then writes, compiles, and links alpha.c, beta.c, and runner.c at runtime
+
+Finally builds & executes heresy_exe for maximum recursive build vibes
+
+Recursion guard via HERESY_ONCE=1 — infinite loops are opt-in only
+
+CI/CD included — proves this abomination works under a sterile, corporate GitHub Actions pipeline
+
+Zero dependencies beyond Rust and GCC, zero mercy for code purists
+
+## 📦 How to Experience the Blasphemy
+git clone https://github.com/QSOLKCB/HERESY.git
+cd HERESY
+cargo run -q
+
+Watch Rust write, build, and run C, which writes, builds, and runs more C.
+Experience existential dread in your terminal.
+
+## 🧙‍♂️ Why?
+To prove that software heresy is reproducible science
+
+To upset both Rust and C purists with equal efficiency
+
+To ensure your CI pipeline is just as confused as your colleagues
+
+## ⚠️ Warnings
+This is a meme, not a framework.
+
+Removing the recursion guard voids the warranty on your soul and your CPU.
+
+Using this in production constitutes an OSHA violation.
+
+## 🏆 Attribution
+Concept and spiritual guidance: Stack Overflow answer 79802354
+
+Artisanal upgrades, memes, and further heresy: Trent Slade / QSOL-IMC
+
+## 🦄 Next Steps
+Uncomment the forbidden cargo build line in the C generator to summon recursion.
+
+File an issue requesting the badge: “CI Passed: Sanity Failed.”
+
+## 📜 Citation
+If you cite this, you accept moral responsibility for the recursion.
+
+@software{slade_heresy_2025,
+  author       = {Trent Slade},
+  title        = {{HERESY v1.0.0 — C-in-Rust, Rust-in-C, Makefiles in Tears}},
+  month        = nov,
+  year         = 2025,
+  publisher    = {Zenodo},
+  version      = {1.0.0},
+  doi          = {10.5281/zenodo.17588734},
+  url          = {https://zenodo.org/records/17588734}
+}
+“May future archaeologists wonder why.”
+
+## 🔚 Epilogue
+Enjoy the only build system that needs an exorcist.
+HERESY v1.0.0 — Now with 100% more existential recursion.