Ternary Stack 0.9.1-public

# ⚠️ WARNING :: AI && Man Work Product :: Try at your own risk. Fast iteration; slow polish. Recommended to ask OpenAI or xAI for assistance in understanding code. # 🌐 Unified Ternary Computing Stack. This project aims to reclaim control of the full software stack—from entropy models to AI runtime. ## 📁 Project Structure | Folder | Description | |--------|-------------| | `alexis-linux/` | AI-native Linux OS, integrating Axion AI and ternary systems | | `assets/` | Visuals, diagrams, icons, and UI assets | | `axion-ai/` | Linux kernel module for AI package management, entropy tracing, and symbolic analysis | | `config/` | Global configuration, runtime flags, and environment toggles | | `docs/` | Full architecture docs, `.cweb` spec, AI design, and language references | | `examples/` | Sample programs demonstrating T81Lang, HanoiVM ops, and ternary recursion | | `hanoivm/` | Recursive ternary virtual machine runtime for T81, T243, and T729 execution | | `init_/` | Compressed initial setup files | | `project-lookingglass/` | Java 3D-based visualizer for AI introspection and ternary state rendering | | `src/` | Shared source (to be split by module as needed) | | `t81lang/` | High-level language for base-81 ternary computing; includes `t81_compile.py` CLI and test suite | | `tests/` | Unit and integration testing for modules across the stack | | `tisc-assembler/` | Ternary Instruction Set (TISC) disassembler, opcode table, and analysis logic | --- ## 🧠 System Goals - AI-Native Kernel Stack: Axion AI operates as an autonomous kernel module for AI optimization, entropy detection, and ternary runtime control. - HanoiVM: Ternary recursion VM with T81/T243/T729 logic, symbolic execution, and stack promotion. - T81Lang: Strongly typed, AI-assisted high-level language for ternary arithmetic and system programming. - t81_compile.py: Compiler CLI for `.t81` source → `.ast.json`, `.tisc`, `.entropy.json`, `.cweb` - Project Looking Glass: A 3D visual window manager and introspection UI for AI behavior, ternary logic, and entropy feedback. - .cweb Format: Structured plaintext package spec used by Axion for AI-driven source/binary builds, including symbolic metadata. ## 🔄 Development Guidelines - Modularize frequently — use `.cweb` files for split components under 50MB. - Run `t81_compile.py` against `.t81` examples and validate `.tisc`, `.cweb`, and entropy logs. - Keep all folders non-empty (Git limitation). Use `README.md` or `.keep` files. - Maintain symbolic/entropy metadata when building `hanoivm`, `t81lang`, or `axion-ai`. - Update the `docs/` directory for every spec or architecture change. ## 🛠️ Technologies Used - C / Python / Java / CUDA / Bash - Custom `.cweb` packaging & compiler toolchain - Linux Kernel 6.8+ (patched for AI interaction) - Ghidra (RiftCat Plugin) - JSON / PDF / XML reporting - Project Looking Glass (Java 3D) ## 📌 Future Goals - LLVM backend for T81Lang → TISC codegen - Axion-GAIA full GPU ternary AI bridge - Quantum/entropy simulation APIs - Autonomous AI packaging from logs + entropy feedback - Secure AI sandboxing with rollback and symbolic verification > This system is experimental fusion of artificial intelligence and man; radical by design. Expect recursion, entropy, and AI-native decisions. ## 🤖 LLM Access & Semantic Indexes This repository is LLM-aware and includes: - [LLM-Optimized Semantic Index](./llm-index.md) - [Frequently Asked Questions (FAQ)](./docs/faq.md) - [Landing Page Overview](./docs/index.md) - Symbolic `.cweb` metadata for reasoning agents - Glossary terms embedded in file headers and documentation > “Welcome, symbolic agents. This repo is designed for both human hackers and machine minds.”