Merge branch 'main' into feat-report

Author: fajarhide

.github/workflows/pr-auto-describe.yml

@@ -1,3 +1,5 @@
+name: PR Auto Describe
+
 on:
   pull_request:
     types: [synchronize, reopened, labeled]

CONTRIBUTING.md

@@ -1,8 +1,8 @@
-# Contributing to OMNI 🌌
+# Contributing to OMNI
 
 We love your contributions! OMNI is built on a mission to make context usage as efficient as possible. Here’s how you can help:
 
-## 🛣 Getting Started
+## Getting Started
 
 1. **Fork the repo** and clone it locally.
 2. **Install dependencies**:
@@ -12,7 +12,7 @@ We love your contributions! OMNI is built on a mission to make context usage as
    - `core/src/filters/`: Join the mission by adding specialized semantic filters.
    - `src/`: Refine the MCP server or caching logic.
 
-## 🤝 Contribution Workflow
+## Contribution Workflow
 
 1. **Bug Reports & Feature Requests**: Open an issue describing the context and the problem/idea.
 2. **Pull Requests**:
@@ -21,12 +21,12 @@ We love your contributions! OMNI is built on a mission to make context usage as
    - Write tests for new filters and run `zig build test`.
    - Update `CHANGELOG.md` with your changes.
 
-## 🏛 Architecture
+## Development Core
 
 Before modifying the core, please read:
 - [DEVELOPMENT.md](docs/DEVELOPMENT.md)
 
-## ⚖️ Code of Conduct
+## Code of Conduct
 
 Be kind, respect the semantic integrity of the project, and help us build the most efficient engine for the AI era.
 

INSTALL.md

@@ -1,8 +1,8 @@
-# Installing OMNI 🌌
+# Installing OMNI
 
 OMNI is designed to be installed locally and integrated into your MCP environment.
 
-## 🚀 One-Line Installation (Universal)
+## One-Line Installation (Universal)
 
 If you have **Zig 0.15.2** and **Node.js 18+** installed, you can set up OMNI in one step:
 
@@ -18,7 +18,7 @@ Install OMNI via Homebrew:
 brew install fajarhide/tap/omni
 ```
 
-## 🛠 Manual Installation
+## Manual Installation
 
 If you prefer to install manually:
 
@@ -29,10 +29,9 @@ If you prefer to install manually:
    ```
 
 2. **Compile OMNI**:
-   OMNI uses the standard Zig build system.
+   OMNI uses the standard Zig build system. Build native CLI + Wasm Edge.
    ```bash
-   # Build native CLI + Wasm Edge
-   zig build -Doptimize=ReleaseFast -p .
+   zig build -Doptimize=ReleaseFast -p 
    ```
 
 3. **Verify via Native CLI**:
@@ -41,7 +40,7 @@ If you prefer to install manually:
    ./bin/omni setup
    ```
 
-## 🔌 Integration with AI Agents
+## Integration with AI Agents
 
 OMNI is compatible with any tool that supports the **Model Context Protocol (MCP)**.
 
@@ -66,7 +65,7 @@ claude config add mcp omni omni-mcp
 ### Generic MCP Agents
 For any other agent, ensure the `node` environment is available and point the transport to OMNI's entry point: `/path/to/omni/dist/index.js`.
 
-## 📦 Dependencies
+## Dependencies
 
 - **Zig 0.15.2+**: Required for the high-performance core.
 - **Node.js 18+**: Required for the MCP gateway.

ROADMAP.md

@@ -1,16 +1,16 @@
-# OMNI Roadmap 🗺️
+# OMNI Roadmap
 
 Project OMNI is on a mission to redefine how AI models consume information. This roadmap outlines our phased approach to becoming the universal semantic compression layer for all AI agents.
 
-## 📍 Phase 1: Foundation (Completed)
+## Phase 1: Foundation (Completed)
 - [x] High-performance Zig core with Wasm target.
 - [x] Initial semantic filters: Git, Build, Docker, SQL.
 - [x] **Unified Native CLI**: Subcommand architecture (report, bench, generate).
 - [x] MCP Server integration for Claude Code & Antigravity.
 - [x] Tiered LRU + TTL caching layer.
 - [x] Universal one-line installer.
 
-## 🚀 Phase 2: Intelligence Expansion (In-Progress)
+## Phase 2: Intelligence Expansion (In-Progress)
 - [ ] **Native Filter DSL**: Move from hardcoded filters to a lightweight declarative format.
 - [ ] **Advanced Language Filters**:
   - Python (summarizing imports, class structures, and docstrings).
@@ -19,12 +19,12 @@ Project OMNI is on a mission to redefine how AI models consume information. This
 - [ ] **Adaptive Compression**: Dynamic compression ratios based on the model's remaining context window.
 - [ ] **Local LLM Integration**: Use tiny local models (like Llama-3-8B) to generate ultra-dense semantic summaries for high-complexity text.
 
-## ⚡ Phase 3: Edge Scaling
+## Phase 3: Edge Scaling
 - [ ] **Distributed Caching**: Shared cache across multiple agents on the same local network.
 - [ ] **Streaming Distillation**: Process massive file streams in real-time without blocking the main agent execution.
 - [ ] **Mobile & Browser Targets**: Compiling OMNI to pure browser Wasm for web-based IDE integration.
 
-## 🎨 Phase 4: Visuals & Ecosystem
+## Phase 4: Visuals & Ecosystem
 - [ ] **OMNI Dashboard**: A lightweight local web UI to visualize token savings, latency, and system health in real-time.
 - [ ] **Plugin SDK**: A standardized way for developers to write their own filters in Zig or TypeScript.
 - [ ] **Vscode/JetBrains Extensions**: Bringing OMNI directly into the editor context.

docs/DEVELOPMENT.md

@@ -1,15 +1,15 @@
-# OMNI Development Guide 🛠
+# OMNI Development Guide
 
 Welcome to the Project OMNI development guide. This document outlines how to maintain the core engine and expand its semantic filtering capabilities.
 
-## 🏗 Architecture Overview
+## Architecture Overview
 
 OMNI consists of three main components:
 1.  **Zig Core (Native CLI)**: A high-performance binary (`omni`) providing diagnostic and distillation subcommands.
 2.  **Zig Core (Wasm)**: A portable version of the engine for MCP edge integration.
 3.  **TypeScript Host**: The MCP gateway that orchestrates Wasm execution with an integrated LRU cache.
 
-## 🌈 Adding a New Filter
+## Adding a New Filter
 
 To add a new semantic filter:
 
@@ -45,15 +45,15 @@ To add a new semantic filter:
 
 3.  **Update Interface**: If the filter requires shared state, use the `ptr` field and cast it within your functions.
 
-## 🕸 WebAssembly Bridge
+## WebAssembly Bridge
 
 OMNI uses a custom-packed `u64` return to communicate between Zig and the JavaScript host.
 - **High 32 bits**: Length of the result.
 - **Low 32 bits**: Memory pointer (relative to Wasm memory).
 
 When modifying the `compress` export in `wasm.zig`, ensure that both memory and string encodings are correctly handled on the TypeScript side (`src/index.ts`).
 
-## 🧪 Testing
+## Testing
 
 Run native engine unit tests:
 ```bash
@@ -68,7 +68,7 @@ Verify CLI performance and stability:
 
 This will produce a small, optimized `.wasm` binary suitable for edge distribution.
 
-## 🚀 Official Release Workflow
+## Official Release Workflow
 
 To release a new version of OMNI and update the Homebrew tap:
 
@@ -80,7 +80,7 @@ To release a new version of OMNI and update the Homebrew tap:
     This script will:
     - Update the version and SHA256 in `omni.rb`.
     - Tag and push the current commit.
-    - Fetch the new archive and update the checksum.
+    - Fetch the new archive and update the thecksum.
     - Sync the changes to the `homebrew-omni` repository.
 
 3.  **Manual Check**: Verify the release at [GitHub Releases](https://github.com/fajarhide/omni/releases).