🌌 Aura

The Semantic Time Machine & Orchestrator for AI-Generated Code.

"We are opening Aura for the world with love from Mo Ashique Kuthini and the team at Naridon, Inc. Sharing years of research and work for the betterment of the agentic coding future. Logic is the asset. Text is the noise. Welcome to the era of Semantic Sovereignty."
— Mo Ashique Kuthini, CEO

---

🚀 The AI-Native Version Control Era

For 50 years, Version Control Systems (VCS) like Git have tracked changes using line-by-line text diffs. This was perfect for humans typing sequentially.

However, in the era of Autonomous AI Agents (Cursor, Claude Code, Aider), code is generated non-linearly. An AI might write 4,000 lines, alter a database schema, and update 14 files in 10 seconds. If the AI hallucinates, a human cannot simply git revert—the text diffs will result in catastrophic merge conflicts.

Aura is the Semantic Time Machine. It abandons text diffs. Instead, it compiles your codebase into an Abstract Syntax Tree (AST) locally and tracks the mathematical logic of functions and classes.

---

✨ Key Features (v0.2.0-alpha: The "Amnesia" Release)

1. The Semantic Gatekeeper (aura capture-context)

Aura acts as a "Parasitic Gatekeeper" on top of standard Git. It mathematically guarantees that an AI agent's commit message (.gemini.intent) matches the actual logic changes (AST) it made.

• Intent Poisoning Detection: Blocks commits if the AI lies about what it modified.
• Full-Stack Support: Natively parses Rust, Python, TypeScript, and JavaScript.

2. The Semantic Scalpel (aura rewind)

Revert a single broken function or class to a previous state without touching the rest of the file or the project.

• The Amnesia Protocol (--amnesia): Surgically reverts code AND programmatically injects a "System Override" into local AI chat logs (Aider, Gemini, Claude), forcing the agent to forget its mistake and stop hallucination loops.

3. Master Class Orchestration (aura plan & aura execute)

Aura integrates the "Get Shit Done" (GSD) methodology directly into the Rust core, powered by the local Merkle-Graph.

• X-Ray Planning: Aura queries your local AST dependency graph and feeds it to the LLM before writing a plan. It sees the mathematical "blast radius" of changes.
• Dual-Output Logic: Generates machine-readable XML waves for the executor, and a human-readable PLAN.md roadmap for you.
• Interactive UX: Beautiful, sequential terminal prompts to configure Execution Modes and Git Strategies.

4. Zero-Friction Enterprise Security

• Sovereign Allowlist (aura request-access): Explicitly authorize legitimate logic nodes (like Auth headers) to contain high-entropy strings without triggering the Semantic Sentinel.
• Semantic Audit (aura audit): Scans Git history to catch any rogue commits that bypassed the Gatekeeper using --no-verify.
• Local Dev Mode (--dev): Bypass heavy enterprise multi-sig keys for instantaneous local prototyping.

---

🛠️ Installation & Configuration

Aura is distributed as a standalone, pre-compiled Rust binary.

# Universal Installer (Mac/Linux)
curl -fsSL https://auravcs.com/install.sh | bash

Initialization

Inside any existing Git repository, simply run:

aura init

Aura hooks into your Git workflow instantly. You just git commit exactly as you always have. Aura handles the math.

Autonomous Agent Configuration

Aura is built for both humans and AI agents. Agents can configure it non-interactively:

aura config set dev-mode true
aura config set telemetry false
aura config set api-key YOUR_GEMINI_KEY

---

📜 Licensing & The Open-Core Doctrine

Aura operates under an Open-Core model to earn developer trust while ensuring sustainable enterprise development.

1. The Core Engine (Apache 2.0)

This repository (The Aura CLI, AST Parsers, Semantic Scalpel, and GSD Orchestrator) is released under the highly permissive Apache License, Version 2.0.

• Why? Developers will not install a closed-source binary that reads their entire codebase. We open-sourced the Core Engine so security teams can audit the Rust code, the community can build new language parsers, and you are guaranteed freedom from vendor lock-in.

2. Enterprise Features (Business Source License)

Features designed for massive team synchronization and corporate compliance (such as The Sovereign Vault, Aura Cloud Sync, Cross-Repo Tracing, and Remote Node-Level RBAC) are proprietary.

• These components are kept under a Business Source License (BSL) and are not included in this public repository.
• To manage a fleet of 50+ AI agents across an enterprise organization, contact sales at auravcs.com/enterprise.

---

🧠 Telemetry & Privacy

By default, Aura collects completely anonymous, high-level CLI usage data (e.g., "Command Run: aura execute") to help us understand growth. We never track your code, your IP, your AST hashes, or your PII.

• To opt-out instantly: aura config set telemetry false

---

Naridon, Inc. Delaware, USA Building the Foundational Infrastructure for the Autonomous Agent Era.