Athanor

Athanor is a sovereign, high-performance development orchestrator that serves as the "Cockpit" for agentic code mutation.

Built in Rust, it interfaces with AI (via Gemini) and delegates structural mutation to the Rust-native Patchiest CLI using the Patchiest Protocol.

Features

• Advanced Terminal User Interface (TUI): A full-screen, adaptive interface built with the ratatui framework. It provides a professional IDE/IRC-like experience.
• Real-time Observability: Absolute visibility into AI thought processes, tool action logs, and real-time financial telemetry for every AI turn.
• Agentic Sovereignty: Manages a node-less, phase-based agent cycle (Discover -> Analyze -> Transmute -> Verify).
• High Performance: Designed to achieve significant speed improvements over traditional "vibe coding" while drastically reducing output tokens.

Architecture

Athanor manages the TUI, Gemini session, and tooling loop. For mutation execution, it shells out to the Patchiest Rust binary (PATCHIEST_BIN, patchiest in PATH, or fallback cargo run --manifest-path patchiest/Cargo.toml).

Mutation Bridge Contract

The transmute tool sends JSON action payloads to Patchiest over stdin and consumes stdout status strings:

• SUCCESS: ...
• NO_MUTATIONS: ...
• ROLLBACK: ...

Current runtime support is focused on MUTATE_CALL actions.

Polyglot Execution Support (Planned / Early)

Athanor is being evolved toward a Wasmtime-based polyglot execution layer while Patchiest expands surgical manipulation with ast-grep. The matrix below reflects roadmap intent, not complete production readiness.

Maturity disclaimer: Current end-to-end implementation maturity is approximately 5% and under active development.

Language	Patchiest (ast-grep manipulation)	Athanor (Wasmtime execution target)	Note
Rust	✅	✅ (Tier 1)	Strong long-term synergy.
C / C++	✅	✅ (Tier 1)	WASI-SDK path.
Go	✅	✅ (via TinyGo)	Standard Go Wasm still maturing.
JavaScript / TypeScript	✅	✅ (via Javy/QuickJS)	TS requires transpilation for Wasm paths.
Python	✅	✅ (componentize-py)
Ruby	✅	✅ (ruby.wasm)	WASI-VFS model.
C# (.NET)	✅	✅ (NativeAOT)	Growing Bytecode Alliance momentum.
Java	✅	✅ (TeaVM/Graal)	JVM/Wasm constraints apply.
Swift	✅	✅	Official Wasm support emerging.
Kotlin	✅	✅ (K/Wasm)	Strong roadmap via WasmGC.
Zig	❌ (planned via custom grammar)	✅	Requires custom Tree-sitter plumbing.
PHP	✅	✅	Available precompiled runtimes.
Elixir / Erlang	✅	⚠️ Experimental	Execution side still experimental.
Bash	✅	❌	Athanor intentionally does not execute Bash; planned future scripting path is KILN.
Solidity	✅	❌	Important for contract editing workflows.
Haskell	✅	✅ (GHC Wasm)
Lua	✅	✅
Scala	✅	✅ (via Native)
Mojo	🧩 Custom	⚠️ WIP	Requires custom grammar and runtime maturation.

Polyglot Gap (State vs. Structure)

The execution layer validates running behavior (state), while the surgical layer validates source structure. The target architecture is a tight feedback loop: mutate code safely via Patchiest and then immediately verify runtime behavior via Athanor.