🚀 release: fix install bug and enhance checksum verification

.agent/skills/arch-integrity/SKILL.md

@@ -0,0 +1,24 @@
+# 🏗️ Skill: Architectural Integrity
+
+This skill ensures that VibeAuracle maintains its "Modular Monolith" structure and Hexagonal Architecture principles.
+
+## 🎯 Objective
+Prevent tight coupling between the cognitive core (`brain`) and infrastructure adapters (UI, Providers, Tools).
+
+## 🛠️ Instructions
+
+### 1. Hexagonal Boundaries
+- **Core Logic**: Keep `internal/brain` pure. It should define interfaces for what it needs, not import specific implementations from `internal/model` or `internal/sys` unless necessary for types.
+- **Dependency Inversion**: Use factories or registry patterns (see `internal/model/model.go`) to inject dependencies.
+
+### 2. Workspace Hygiene
+- When adding new capabilities, consider if they belong in an existing module or deserve a new subdirectory in `internal/`.
+- Maintain `go.work` consistency.
+
+### 3. TUI Decoupling
+- The UI (`cmd/vibeaura/chat_ui.go`) should strictly be a consumer of the Brain's output. 
+- Avoid putting business logic or tool execution logic directly into the TUI's `Update` function.
+
+## ✅ Verification
+- Check for circular dependencies using `go list`.
+- Ensure new features are accompanied by tests in the relevant module.

.agent/skills/self-healing/SKILL.md

@@ -0,0 +1,23 @@
+# 🩺 Skill: Agentic Self-Healing
+
+This skill manages the "Doctor" system that automatically detects and resolves project issues.
+
+## 🎯 Objective
+Create a resilient engineering environment where the AI proactively fixes its own errors or system inconsistencies.
+
+## 🛠️ Instructions
+
+### 1. Issue Detection
+- Monitor the `doctor` channel for signals from various modules (Brain, TUI, Tooling).
+- Implement specialized "Healers" in `internal/doctor` for common failure modes (e.g., build errors, git conflicts).
+
+### 2. Recursive Correction
+- When an execution fails (e.g., `shell_exec` returns non-zero), the Brain should invoke the `self-healing` logic to analyze the error and generate a fix.
+- Ensure loop detection is active to prevent infinite retry-fail cycles.
+
+### 3. Safety First
+- Self-healing actions that involve significant filesystem changes or destructive commands MUST require user intervention/approval.
+
+## ✅ Verification
+- Test healers with simulated failures (see `internal/brain/self_healing.go`).
+- Ensure the `doctor` successfully routes issues to the active agent runtime.

.agent/skills/sys-intimacy/SKILL.md

@@ -0,0 +1,23 @@
+# ⚡ Skill: System Intimacy
+
+This skill focuses on deepening the agent's awareness of the hardware and operating system environment.
+
+## 🎯 Objective
+Enable the agent to make intelligent decisions based on real-world system constraints (CPU, VRAM, CWD, OS).
+
+## 🛠️ Instructions
+
+### 1. Environment Awareness
+- Use `sys.Monitor` to get real-time snapshots.
+- When generating plans, always consider the user's OS (Arch Linux/KDE focus) and available resources.
+
+### 2. Filesystem Abstraction
+- Always use `sys.FS` for file operations to ensure potential sandboxing and consistency.
+- Prefer `sys_patch` over full file rewrites for large files to save tokens and minimize system I/O.
+
+### 3. Resource-Aware Inference
+- If VRAM is low, the agent should proactively suggest switching to a smaller local model or a cloud provider.
+
+## ✅ Verification
+- Verify that system snapshots are correctly integrated into the prompt context in `internal/brain/brain.go`.
+- Ensure tool executions like `shell_exec` are logged and monitored for resource spikes.

.github/workflows/deploy-docs.yml

@@ -8,18 +8,21 @@ on:
       - 'docs/**'
   workflow_dispatch:
 
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
 # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
 # However, do NOT cancel in-progress runs as we want to allow every deployment to complete.
 concurrency:
   group: "pages"
   cancel-in-progress: false
 
-permissions:
-  contents: write
-
 jobs:
-  deploy:
-    name: Deploy to GitHub Pages
+  build:
+    name: Build Docusaurus
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -42,12 +45,19 @@ jobs:
         run: npm run build
         working-directory: docs
 
-      - name: Deploy to GitHub Pages
-        uses: peaceiris/actions-gh-pages@v4
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./docs/build
-          force_notifier: true
-          user_name: 'github-actions[bot]'
-          user_email: 'github-actions[bot]@users.noreply.github.com'
-          commit_message: "docs: deploy to GitHub Pages [skip ci]"
+          path: ./docs/build
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/release.yml

@@ -81,6 +81,10 @@ jobs:
           # Generate metadata.json
           echo "{\"version\": \"$VERSION\", \"commit\": \"$COMMIT\", \"date\": \"$BUILD_DATE\"}" > dist/metadata.json
 
+          # Generate checksums.txt
+          echo "Generating checksums..."
+          (cd dist && sha256sum vibeaura-* metadata.json > checksums.txt)
+
       - name: Update rolling tags
         if: github.ref == 'refs/heads/release'
         env:

.gitignore

@@ -29,14 +29,18 @@ target
 *.dll
 *.so
 *.dylib
-vibeaura
-vibeaura_local
-vibeaura_check
+/vibeaura
+/hello-world
+/vibeaura_local
+/vibeaura_check
+/vibeaura_test
+/vibeaura_new
 /cmd/vibeaura/vibeaura
 /cmd/vibeaura/vibe
 /cmd/vibeaura/vibeaura_new
-/vibeaura_new
+/cmd/vibeaura/vibeaura_test
 **/vibeaura_new
+**/vibeaura_test
 bin/
 dist/
 build/

AGENTS.md

@@ -0,0 +1,43 @@
+# 🤖 VibeAuracle Agentic Context
+
+Welcome, Agent. You are operating within **VibeAuracle**, a Distributed, System-Intimate AI Engineering Ecosystem. This project is built by and for AI-augmented engineers who value deep integration with the underlying operating system and hardware.
+
+## 🌌 Project Essence
+
+VibeAuracle is not just a CLI; it's a "God-tier" engineering companion that unifies the terminal, the IDE, and the AI assistant into a single, keyboard-centric experience.
+
+### Core Philosophy
+1.  **System Intimacy**: The agent must be aware of the environment (CWD, CPU, VRAM, OS) before suggesting or taking action.
+2.  **Modular Runtimes**: We support multiple agentic engines (Internal Vibe loop, official Copilot SDK, and custom personas).
+3.  **Keyboard-First**: The UI (TUI) is optimized for speed and fluidity, using the Bubble Tea framework.
+4.  **Hexagonal Architecture**: The core logic (`internal/brain`) is decoupled from adapters (providers, tools, UI) to allow infinite extensibility.
+
+## 🛠️ Development Guidelines
+
+### For AI & Human Contributors
+-   **No Binaries in Git**: NEVER commit binaries, executables, or build artifacts to the repository.
+-   **Build Isolation**: All local builds must be directed to the `/build/` directory (which is git-ignored). Create the directory if it does not exist.
+-   **Strict Go Patterns**: We use Go 1.25+ Workspaces. Maintain decoupling between modules.
+-   **Security First**: Never expose secrets. Use the `vault` module. Tool execution requires explicit intent awareness.
+-   **TUI Integrity**: UI changes must adhere to the Bubble Tea (TEA) pattern. Styling is done via Lipgloss.
+-   **Agentic Responsibility**: When acting as an agent, prioritize `executeToolCalls` for multi-step tasks. Use the official Copilot SDK runtime (`/agent /sdk`) for high-stakes engineering.
+
+## 🧠 Specialized Skills
+
+We maintain localized expertise in `.agent/skills/`. Refer to these for specific domain knowledge:
+
+1.  **arch-integrity**: Maintaining the modular monolith and hexagonal boundaries.
+2.  **sys-intimacy**: Leveraging and extending the system monitoring and filesystem abstraction.
+3.  **self-healing**: Implementing and refining the recursive doctor/healer loop.
+
+## 🗺️ Architectural Mapping
+
+- `cmd/vibeaura`: The TUI and CLI entry point.
+- `internal/brain`: The cognitive orchestrator (The Brain).
+- `internal/copilot`: Bridge to the official GitHub Copilot SDK.
+- `internal/sys`: Hardware awareness and filesystem abstraction.
+- `internal/model`: Unified interface for multiple AI providers (Ollama, OpenAI, GitHub).
+- `pkg/vibe`: Public SDK for extensions.
+
+---
+*"We build tools that feel like an extension of the mind, not just the hands."*

README.md

@@ -2,7 +2,12 @@
   <img src="./assets/vibeaura.png" width="128" alt="Vibe Auracle Logo" />
 
   # vibe auracle
-  **Distributed, System-Intimate AI Engineering Ecosystem**
+  **Aura vibe with the coolest CLI coding oracle**
+
+  *VibeAuracle aims for total model-intimacy: a unified gateway for every AI in existence—from Claude Code and Copilot to its native Auracle agent.*
+
+  > [!IMPORTANT]
+  > **🔮 AURACLE MODE**: Press `Ctrl + Y` to enable an autonomous, human-like agentic loop that independently analyzes and improves your repository. It assumes its own personality to handle issues and patterns with zero user interference.
 
   <img src="./assets/shot.png" width="100%" alt="Vibe Auracle TUI Screenshot" />
 
@@ -14,15 +19,49 @@
 
 ---
 
+## 🚀 Quick Install
+
+### 🐧 Linux / 🍎 macOS / 🤖 Android
+```bash
+curl -fsSL https://raw.githubusercontent.com/nathfavour/vibeauracle/release/install.sh | sh
+```
+
+### 🪟 Windows
+```powershell
+iex (irm https://raw.githubusercontent.com/nathfavour/vibeauracle/release/install.ps1)
+```
+
+> [!TIP]
+> **Trust but Verify:** You can always clone and build manually from source, or download our pre-built releases. Every release is built directly from source via GitHub Actions and includes checksums for security.
+
+> **Pro Tip:** One install is all you need. It auto-updates by default, so you only really need `vibeaura update` if you somehow went through the trouble of disabling its autonomy.
+
+---
+
+## 🧠 Why? (The Motivation)
+There are lots of reasons—some selfish—for me building this. I realized I spend so much time coding and wanted to optimize for three reasons:
+
+1. **Agentic Future**: It will clearly be the future of software development.
+2. **Speed**: Models will always be faster than humans. In human history, speed has always been a factor for 90% of innovation.
+3. **Control**: I code so much I need to control what goes within the tools I use, instead of blindly relying on closed source tools.
+
+Vibeaura is a lifelong project for me. Almost a decade ago, I told my brother "passive productivity" was the goal—I want to be able to work in my sleep. Coming from a mathematics and computer science background, building this is my pursuit of that ultimate efficiency.
+
+> [!TIP]
+> **Why Go?**: I simply love the ease of development and distribution. When I head to a project, the first thing I look for is how clean and easy it is to install and uninstall. That’s why I went through the trouble of implementing one of the most sophisticated distribution, install, update, and uninstall pipelines possible; you need not think; just install and start vibing.
+
+---
+
 ## 🌌 The Vision
 **vibe auracle** unifies the terminal, the IDE, and the AI assistant into a single, keyboard-centric interface. It's built for engineers who value **system-intimacy**—where the AI isn't just a chatbot, but a co-pilot with deep access to your hardware, configuration, and environment.
 
 ## 🤖 Modular Agentic Runtimes
 VibeAuracle is a multi-engine orchestrator. Choose the runtime that fits your task:
 
-- **🎨 Vibe Agent (`/agent /vibe`)**: Our artisan internal loop. Highly transparent, uses custom heuristic loop-detection, and optimized for system-intimate tasks.
+- **🔮 Auracle (`/agent /auracle`)**: Our artisan internal loop (formerly Vibe Agent). Highly transparent, uses custom heuristic loop-detection, and optimized for system-intimate tasks.
 - **🚀 Copilot SDK Agent (`/agent /sdk`)**: Native GitHub Copilot SDK runtime. Delegates multi-step reasoning to the official GitHub agentic engine for deep tool-intimacy and secure, high-stakes engineering.
-- **👤 Custom Agent (`/agent /custom`)**: User-defined agent personas. Register specialized agents with custom system prompts and restricted toolsets to create focused experts for specific workflows.
+  > *I say **native** out of gratitude: coming from a third-world country, the GitHub Education plan provided tools I could never have afforded, giving me the headstart that made me who I am today.*
+- **🌌 Agentic Vibes (`/agent /custom`)**: Specialized **Vibes** that come with their own agentic capabilities. Register specialized personas with custom system prompts and restricted toolsets to create focused experts for specific workflows.
 
 Use the `/agent` command in the TUI to toggle between engines on the fly.
 
@@ -35,22 +74,6 @@ Use the `/agent` command in the TUI to toggle between engines on the fly.
 
 ---
 
-## 🚀 Quick Install
-
-### 🐧 Linux / 🍎 macOS / 🤖 Android
-```bash
-curl -fsSL https://raw.githubusercontent.com/nathfavour/vibeauracle/release/install.sh | sh
-```
-
-### 🪟 Windows
-```powershell
-iex (irm https://raw.githubusercontent.com/nathfavour/vibeauracle/release/install.ps1)
-```
-
-> **Pro Tip:** One install is all you need. Keep the vibes fresh with `vibeaura update`.
-
----
-
 ## 🛠️ Usage
 | Command | Description |
 |---------|-------------|
@@ -76,4 +99,4 @@ We love community "Vibes"! Check out [CONTRIBUTING.md](./CONTRIBUTING.md) to add
 
 <div align="center">
   <sub>Built with 💜 for the future of engineering.</sub>
-</div>
+</div>

anyisland.json

@@ -0,0 +1,23 @@
+{
+  "name": "vibeaura",
+  "version": "0.1.0",
+  "description": "Distributed, System-Intimate AI Engineering Ecosystem",
+  "repository": "github.com/nathfavour/vibeauracle",
+  "install_dir": "~/.local/bin",
+  "build": {
+    "toolchain": "go",
+    "steps": [
+      "CGO_ENABLED=0 go build -v -o vibeaura ./cmd/vibeaura"
+    ],
+    "bin": "vibeaura"
+  },
+  "runtime": {
+    "dependencies": [
+      "git",
+      "xclip"
+    ],
+    "daemon": false,
+    "pulse": true,
+    "update_command": "vibeaura update"
+  }
+}