🚀 Hanoi — Recursive Ternary Virtual Machine

Hanoi is a recursive, AI-augmented ternary virtual machine built on a symbolic base-81 architecture. It is the execution core of the Axion + T81Lang ecosystem, enabling stack-tier promotion, symbolic AI opcodes, and entropy-aware transformations across three levels of logic:

• 🔹 T81: 81-bit operand logic (register-like)
• 🔸 T243: Symbolic BigInt + FSM state logic
• 🔺 T729: Tensor-based AI macros with semantic dispatch

Designed for research, language development, and future ternary hardware acceleration, Hanoi is literate, modular, and fully recursive.

Join us as we move beyond binary. Explore the power of HanoiVM.

---

🔍 Core Features

• 🔢 Ternary Operand Architecture:

• Supports uint81_t, T243BigInt, and T729Tensor data types

• 🌀 Recursive Stack Tiering:

• Auto-promotes through T81 → T243 → T729 based on depth/entropy

• 🧠 Symbolic AI Execution:

• Includes FSM logic, pattern recognition, entropy-driven dispatch

• AI macros: TNN_ACCUM, T81_MATMUL, T729Intent, T729MetaOpcode

• 🧬 Tensor Engine + Holomorphic Support:

• DOT, SLICE, TRANSPOSE, RESHAPE, CLONE, PRINT, FFT

• ⚙️ Axion Kernel AI:

• AI introspection + rollback via NLP-style commands (optimize, snapshot)

• Integrated Axion telemetry, logs, entropy weighting

• ⚡ GPU Acceleration via GAIA:

• AMD: gaia_handle_request.cweb (HIP)

• NVIDIA: cuda_handle_request.cu (CUDA)

• 🖼️ 3D Visualization via Looking Glass:

• FrameSceneBuilder.cweb renders recursion traces in jMonkeyEngine

• Axion overlays, ternary geometry, and entropy pulse animation

• 🔐 Secure Trace Export:

• recursion_exporter.cweb + nist_encryption.cweb for audit-safe symbolic traces

• 📦 Synergistic Coordination Layer:

• synergy.cweb enables orchestration across all AI, GPU, recursion, and symbolic tiers

• 📄 Literate Codebase (.cweb):

• Every module is self-documenting and extractable via cweave/ctangle

• 🧪 Disassembler + Test Infrastructure:

• Disassembles .hvm with symbolic introspection
• CI-compatible tests + kernel-mode driver for system-level validation

---

📦 New: T81Lang Compiler Stack

The T81Lang toolchain is now fully integrated with HanoiVM:

• ✅ Lexer + Parser → AST via t81lang_parser.cweb
• ✅ Semantic Analyzer with scope/symbol resolution
• ✅ Intermediate Representation (IR) with symbolic ops
• ✅ .hvm Emitter for virtual machine execution
• ✅ HVM Interpreter with register-based runtime
• ✅ CLI Compiler via t81lang_compiler.cweb

---

🗂️ Repository Overview

src/
├── hanoivm_vm.cweb               # Main interpreter engine
├── advanced_ops.cweb             # TNN, matrix, AI primitive opcodes
├── advanced_ops_ext.cweb         # T243/T729 extensions: FSM, intent, FFT
├── t243bigint.cweb               # BigInt math in ternary (T243)
├── t729tensor.cweb               # Tensor logic for T729 tier
├── t81_patterns.cweb             # Symbolic AI patterns & dispatch
├── t81recursion.cweb             # Canonical ternary recursion patterns
├── gaia_handle_request.cweb      # HIP symbolic GPU backend
├── cuda_handle_request.cu        # CUDA symbolic tensor support
├── axion-ai.cweb                 # Kernel AI optimizer and rollback hooks
├── disassembler.cweb             # Human-readable `.hvm` introspector
├── recursion_exporter.cweb       # Export symbolic trace to `.t81viz`
├── synergy.cweb                  # Cross-module synergy + integration layer
├── FrameSceneBuilder.cweb        # 3D recursion visualizer with jMonkeyEngine
├── tisc_backend.cweb             # TISC backend compiler
├── TISCQueryCompiler.cweb        # Semantic query-to-TISC compiler
├── nist_encryption.cweb          # AES/RSA/SHA support for secure data flows






tests/
├── hanoivm-test.cweb             # Kernel-mode debugfs test harness
├── test_advanced_hvm.cweb        # Test AI macros, recursion, control flow
├── t729tensor_to_string.cweb     # Tensor stringification for debug/logs

docs/
├── ROADMAP.md
├── CHANGELOG.md
├── t243_t729.md                  # Documentation for FSM, Intent, FFT

scripts/
├── disasm_*.sh                   # Bytecode disassembler tests

bazel/
├── BUILD                         # Bazel config for modular builds

README.md                         # You are here

---

⚙️ Getting Started

🔧 Build

bazel build //...

✅ Run Tests

bazel test //:disasm_advanced_test
bazel test //:disasm_controlflow_test
bazel test //:disasm_logic_test

🧠 Kernel Test Harness

sudo insmod hanoivm-test.ko
cat /sys/kernel/debug/hanoivm-test

🔬 Tier Execution Demo

bazel run //:recursive_tier_execution -- --max-depth=36

---

🤖 Axion + GAIA Integration

• GPU Execution Paths:
• NVIDIA: cuda_handle_request.cu

• AMD: gaia_handle_request.cweb

• Ternary AI Macros:

• T729Intent for symbolic AI behavior
• T729MetaOpcode for entropy-weighted logic switching

• T729HoloTensor for FFT and multi-dimensional signal composition

• Signal Control:

• Axion tracks recursive entropy, triggers promotion/demotion
• rollback, optimize, snapshot available via NLP hooks

---

🔁 Pattern + Symbolic Opcode Summary

Opcode	Tier	Function
T81_MATMUL	T81	Matrix multiply over base-81
T243_STATE_ADV	T243	FSM state vector logic
T729_INTENT	T729	Dispatch symbolic AI intent
T729_HOLO_FFT	T729	FFT over holomorphic ternary tensor
T729_META_EXEC	T729	Meta-instruction, conditional entropy

---

📈 Project Status

✅ Recursive execution engine ✅ Literate .cweb modular design ✅ Full symbolic tier stack (T81 → T243 → T729) ✅ Pattern dispatch and entropy signal handling ✅ Axion AI integration with rollback and NLP ✅ GPU offload (HIP + CUDA) for symbolic macros ✅ Verbose .hvm disassembler and type introspection ✅ Kernel-level testing (debugfs) ✅ .t81viz recursion trace export ✅ .synergy.cweb for unified tier integration ✅ AES-encrypted symbolic trace exports (nist_encryption.cweb) ✅ 3D visualizer: FrameSceneBuilder.cweb + PulseControl

🔜 TISC query compiler with entropy scoring 🔜 Live REPL for .t81 to .hvm 🔜 LLVM IR export for hybrid backend 🔜 Axion log streaming in Looking Glass

---

🔗 Related Projects

• [Axion AI] — AI optimizer and rollback kernel
• T81Lang — Ternary language for symbolic logic + AI macros
• [Alexis Linux] — AI-first OS with ternary kernel base
• Project Looking Glass — 3D GUI for recursion visualization and stack tiering

---

📜 License

MIT License — see LICENSE for full terms.

---

🧠 “Recursion is not just a structure — it’s the soul of ternary.”