npm - zyphor - Versions diffs - 0.1.1 → 1.0.0 - Mend

zyphor 0.1.1 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/README.md +265 -136
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1,52 +1,252 @@
 <div align="center">
-  <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/docs/assets/logo.png" alt="Zyphor Logo" width="120" />
+  <picture>
+    <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/assets/logo.svg" alt="ZYPHOR Logo" width="700">
+  </picture>
+  <p align="center">
+    <strong>A mercilessly optimized, zero-allocation native systems observatory, real-time diagnostic engine, and process profiler.</strong>
+  </p>
+  [![Build Status](https://img.shields.io/github/actions/workflow/status/miyaniakshar1234/Zyphor/release.yml?branch=master&style=for-the-badge&logo=github)](https://github.com/miyaniakshar1234/Zyphor/actions)
+  [![Zig Version](https://img.shields.io/badge/Zig-0.15.2+-F7A41D?style=for-the-badge&logo=zig)](https://ziglang.org)
+  [![Binary Size](https://img.shields.io/badge/Binary_Size-1.1_MB-00f0ff?style=for-the-badge)](https://github.com/miyaniakshar1234/Zyphor/releases)
+  [![Memory Footprint](https://img.shields.io/badge/RAM_Footprint-<3_MB-00ff66?style=for-the-badge)](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/architecture.md)
+  [![License](https://img.shields.io/badge/License-MIT-purple.svg?style=for-the-badge)](https://github.com/miyaniakshar1234/Zyphor/blob/master/LICENSE)
+  <p align="center">
+    <a href="#-why-zyphor-the-manifesto">The Manifesto</a> •
+    <a href="#-interface-gallery--subsystems">Interface Gallery</a> •
+    <a href="#-feature-matrix--comparison">Comparison</a> •
+    <a href="#-core-architecture--systems-design">Architecture</a> •
+    <a href="#-cli-toolchain--automation">CLI Suite</a> •
+    <a href="#-keyboard-controls--navigation">Keybinds</a> •
+    <a href="#-installation--getting-started">Installation</a> •
+    <a href="#-about-the-developer">Author</a> •
+    <a href="https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/user-manual.md">User Manual</a>
+  </p>
+  <br>
+  <!-- Primary Hero Live Dashboard -->
+  <picture>
+    <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/01-overview.png" alt="Zyphor Overview Dashboard" width="920">
+  </picture>
+</div>
-  # Zyphor
+---
-  **The Next-Generation Terminal Operating Environment**
-  *Zero-allocation, blazing-fast system observatory written in pure Zig.*
+## 🛑 Why Zyphor? (The Manifesto)
-  [![Zig 0.15+](https://img.shields.io/badge/Zig-0.15%2B-F7A41D?logo=zig)](https://ziglang.org)
-  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-  [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
-  [![Platform: Windows | Linux | macOS](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey)](#)
-</div>
+Modern system monitoring software has lost its way.
+On one side, we have **bloated GUI applications and Electron wrappers** that consume hundreds of megabytes of RAM, take seconds to boot, and spin up entire Chromium browser instances just to display a CPU percentage. On the other side, we have **legacy terminal monitors** that write raw ANSI streams directly to `stdout`, causing severe visual tearing, flickering at high frame rates, and dropping frames when rendering complex graphs.
+**Zyphor was designed and engineered by Akshar Miyani to eliminate this compromise.**
+Built from bare metal in **Zig**, Zyphor operates on pure systems-programming principles:
+1. **Direct Kernel Interfacing:** Bypasses slow management abstraction layers (like Windows WMI) in favor of raw ring-0 telemetry via `ntdll.dll` (`NtQuerySystemInformation`) on Windows and zero-copy `/proc` parsing on Linux.
+2. **Zero-Allocation Render Loop:** The entire rendering pipeline runs with **zero general-purpose heap allocations** in the hot path. All frame allocations utilize dual swapping `ArenaAllocators` with instantaneous pointer resets.
+3. **Double-Buffered Differential ANSI Engine:** Frames are rendered to an off-screen virtual framebuffer and diffed against the previous frame at the cell level. Only modified screen cells emit ANSI escape codes, yielding absolute zero flicker and rock-solid 30–60 FPS rendering at less than **0.1% CPU overhead**.
+4. **Autonomous Root-Cause Diagnostics:** Zyphor does not simply dump numbers; an embedded heuristic engine mathematically correlates telemetry (thermal velocity, VMM swap thrashing, I/O wait) to provide actionable English playbooks for resolving system bottlenecks.
+5. **Standalone 1.1 MB Single-File Executable:** Statically linked with zero runtime dependencies. No DLLs, no Python virtual environments, no node_modules.
+---
+## 📸 Interface Gallery & Subsystems
+Zyphor provides 7 dedicated observatory panels alongside interactive profilers, command palettes, and custom themes.
+### 1. Process Explorer & Storage Fabric
+| Process Explorer & Lineage Trees (`2`) | Storage Fabric & Disk I/O (`3`) |
+| :--- | :--- |
+| <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/02-processes.png" width="450" alt="Process Explorer"> | <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/03-storage.png" width="450" alt="Storage Analyzer"> |
+| Recursive DFS parent/child tree hierarchy (`t`), live sorting (`c`, `m`, `p`, `n`), real-time search (`/`), deep inspector (`Enter`), and process termination (`x`, `s`, `u`). | Real-time partition space distribution across all mounted drives (`NTFS`, `ext4`, `apfs`, `btrfs`), transfer throughput (MB/s), and storage IOPS. |
+---
+### 2. Network Observability & AI Root-Cause Diagnostics
+| Network Observability & Active Sockets (`4`) | Autonomous Health & AI Diagnostics (`5`) |
+| :--- | :--- |
+| <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/04-network.png" width="450" alt="Network Dashboard"> | <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/05-health-diagnostics.png" width="450" alt="AI Diagnostics"> |
+| Sub-cell Unicode Braille throughput curves, NIC adapter status cards, active TCP/UDP socket process mapping, and broadband speed testing (`s`, `S`). | 5-subsystem health radar (0–100 score), deterministic anomaly detection, explainable root-cause insights, and defensive action playbooks. |
+---
+### 3. Background Services & Container Observatory
+| System Services & Background Daemons (`6`) | Container Observatory (Docker/OCI) (`7`) |
+| :--- | :--- |
+| <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/06-services.png" width="450" alt="System Services"> | <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/07-containers.png" width="450" alt="Containers"> |
+| Real-time OS background service monitoring (Windows Services / systemd units), status tracking, startup modes, and binary inspector cards. | Direct cgroup telemetry, container RAM usage vs hard memory quota limits, CPU utilization, image tags, and isolated network I/O. |
+---
+### 4. Interactive Profiler & Fast Command Launcher
+| Microsecond Process Profiler (`P`) | Quick Action Command Palette (`:` / `Ctrl+P`) |
+| :--- | :--- |
+| <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/09-profiler.png" width="450" alt="Process Profiler"> | <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/08-command-palette.png" width="450" alt="Command Palette"> |
+| 10-second high-frequency rolling telemetry trace on any selected PID. Computes Peak Jitter, Rolling Averages, and Memory Leaks. | Floating keyboard launcher for instant jumps, theme cycling, hardware benchmarks, telemetry freezing, and instant state exports. |
+---
+### 5. Hand-Tuned 24-Bit TrueColor Theme Catalog
+| Anthropic (Default Warm Aesthetic) | Cyber (High-Contrast Neon Cyberpunk) |
+| :--- | :--- |
+| <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/10-theme-anthropic.png" width="450" alt="Anthropic Theme"> | <img src="https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/screenshot/11-theme-cyber.png" width="450" alt="Cyber Theme"> |
+| Warm dark charcoal (`#1F1D1C`), terracotta accents (`#D97757`), sand highlights, and sage green nominal meters. | High-contrast synthwave palette featuring electric cyan (`#00F0FF`) and vibrant neon magenta (`#FF0080`). |
+*Zyphor includes 10 built-in palettes (Anthropic, Cyber, Tokyo Night, Hacker, Midnight, Aurora, Nord, Solarized Dark, Gruvbox, High Contrast). Hot-swap instantly with <kbd>]</kbd> or <kbd>Shift+T</kbd>.*
 ---
-> **Why Zyphor?** `htop` is from 2004, and `btm` is too heavy. Zyphor is raw Zig performance combined with an unprecedented Sci-Fi HUD utilizing true sub-pixel Braille rendering, dynamic masonry layouts, and root-cause diagnostics.
+## 📊 Feature Matrix & Comparison
+| Feature / Metric | **Zyphor** | **btop++** | **htop** | **Glances** | **Windows Task Mgr** |
+| :--- | :---: | :---: | :---: | :---: | :---: |
+| **Implementation Language** | **Zig (Native)** | C++ | C | Python | C++ / WinUI |
+| **Binary Size** | **1.1 MB** | ~8.2 MB | ~3.5 MB | ~45 MB (deps) | System Native |
+| **Memory Usage (RAM)** | **< 3 MB** | ~25 MB | ~5 MB | ~90 MB | ~60 MB |
+| **Zero-Allocation Render Path** | **Yes (Dual Arena)** | No | No | No | No |
+| **Double-Buffered Diff Engine** | **Yes (Zero Flicker)** | Partial | No (Flickers) | No | N/A |
+| **Autonomous AI Diagnostics** | **Yes (Deterministic)**| No | No | Basic Alerts | No |
+| **Time-Bound Process Profiler** | **Yes (Hotkey `P`)** | No | No | No | No |
+| **Remote HTTP / TCP JSON Daemon**| **Yes (`zyphor daemon`)**| No | No | Yes (Web UI) | No |
+| **Instant Telemetry Snapshot (`E`)**| **Yes (`.json`)** | No | No | Export flags | No |
+| **Container Engine Telemetry** | **Yes (Docker/OCI)** | No | No | Yes | No |
+| **Parent-Child Lineage Tree** | **Yes (`t` DFS)** | Yes | Yes | No | Partial |
+| **Command Palette (`Ctrl+P`)** | **Yes** | No | No | No | No |
+| **24-Bit TrueColor Palettes** | **10 Built-in** | Custom RGB | 16-color | 16-color | OS Theme |
+---
+## 🧠 Core Architecture & Systems Design
+Zyphor's extreme performance is achieved through strict adherence to **Data-Oriented Design (DOD)** and cache-locality principles.
+```
+                    ┌──────────────────────────────────────────────┐
+                    │               OPERATING SYSTEM               │
+                    │   Windows (ntdll)   /   Linux (/proc)        │
+                    └──────────────────────┬───────────────────────┘
+                                           │ Direct Syscalls / Zero-Copy Reads
+                                           ▼
+                    ┌──────────────────────────────────────────────┐
+                    │         CORE TELEMETRY ENGINE                │
+                    │   CPU • RAM • Disks • Network • Services     │
+                    └──────────────────────┬───────────────────────┘
+                                           │
+                                           ├──────────────────────────┐
+                                           │ Snapshot Data            │
+                                           ▼                          ▼
+        ┌──────────────────────────────────────────────┐   ┌────────────────────────┐
+        │        DOUBLE ARENA ALLOCATION MODEL         │   │ HEURISTIC AI ENGINE    │
+        │  [FrameArenaA] ──swap──> [FrameArenaB]       │   │ Thermal / Thrashing    │
+        │  (Zero heap mallocs in critical loop)        │   │ Anomaly Correlator     │
+        └──────────────────────┬───────────────────────┘   └──────────┬─────────────┘
+                               │                                      │
+                               ▼                                      ▼
+        ┌───────────────────────────────────────────────────────────────────────────┐
+        │                  DOUBLE-BUFFERED DIFFERENTIAL RENDERER                    │
+        │                                                                           │
+        │  [Current Virtual Framebuffer]  <───diff───>  [Previous Screen Framebuffer]│
+        │                                                                           │
+        │                      Compute Cell Mutex Deltas:                           │
+        │                      dirty_cells = (curr[i] != prev[i])                   │
+        └──────────────────────────────────────┬────────────────────────────────────┘
+                                               │
+                                               ▼ Only modified ANSI sequences emitted
+                                ┌──────────────────────────────┐
+                                │     TERMINAL EMULATOR        │
+                                │   Zero Tearing • 30–60 FPS   │
+                                └──────────────────────────────┘
+```
+### Key Architectural Invariants:
+1. **The Double-Arena Memory Model:** Two static arenas (`ArenaAllocator`) alternate every frame. Dynamic process lists and strings are allocated into the active arena. At the start of the next cycle, the inactive arena is completely cleared via an `O(1)` pointer reset, preventing heap fragmentation and memory leaks entirely.
+2. **Cell-Level Differential Rendering:** The screen is maintained as an array of `Cell` structures containing glyphs and 24-bit RGB values. The rendering pass updates an off-screen buffer. The diffing pass compares `current_cells[i]` against `prev_cells[i]` and generates an optimized ANSI sequence that positions the cursor only where data has changed.
+3. **Low-Latency Platform Probes:**
+   * On **Windows**, Zyphor links dynamically against `ntdll.dll` to invoke `NtQuerySystemInformation(SystemProcessInformation)`, retrieving global thread and process states in a single atomic kernel transition.
+   * On **Linux**, Zyphor performs zero-copy parsing of `/proc/stat`, `/proc/meminfo`, `/proc/net/dev`, and `/proc/[pid]/stat` using pre-allocated stack buffers without regular expression engines.
+---
+## 🛠️ CLI Toolchain & Automation
+Zyphor is designed for both interactive monitoring and automated headless scripting in CI/CD pipelines.
+```bash
+# 1. Start the interactive Zero-Flicker TUI
+zyphor
+# 2. Start TUI with a specific TrueColor theme (e.g., cyber, tokyo_night, hacker, nord)
+zyphor --theme cyber
+# 3. Plain ASCII mode for minimal or legacy terminals
+zyphor --plain
+# 4. Run an automated environment audit (Kernel probes, permissions, sensors)
+zyphor doctor
+# 5. Run native CPU compute (Integer MOP/s) and RAM bandwidth (GB/s) benchmarks
+zyphor bench
-Zyphor entirely re-imagines what a terminal system monitor can be. We use $2 \times 4$ Braille matrices to push sub-pixel resolution graphs, custom trigonometric radial dials, and a zero-flicker double-buffered rendering engine that sips CPU cycles.
+# 6. Prove Zyphor's lightweight nature (Measures telemetry sampling latency & RAM footprint)
+zyphor overhead
-## 🚀 The Next-Gen Vibe
+# 7. Start the headless TCP daemon streaming live JSON telemetry on port 7777
+zyphor daemon
-Unlike traditional tabular layouts, Zyphor renders real-time telemetry like a **High-Density Sci-Fi Command Center**:
-- **Radial Dials & CPU Matrices:** Sub-pixel circular Braille load gauges for CPU and Memory, coupled with per-core activity heatmaps.
-- **Topological Process Lineage:** True depth-first search (`DFS`) process trees using Unicode box-drawing (`├─`, `└─`, `│`). Instantly suspend, resume, or kill misbehaving trees.
-- **Masonry Storage & Directory Tree Analyzer (PRD §16):** Responsive 2D masonry cards for mounted partitions coupled with a directory-level capacity tree explorer (`Program Files`, `AppData`, `Projects`).
-- **Global Network & Active Socket Map (PRD §18):** Massive flowing Braille waveforms for aggregate Ingress/Egress, alongside live process-to-socket mapping (`PID`, `Local Port`, `Remote IP:Port`, `State`).
-- **Explainable Root-Cause Diagnostics (PRD §30):** A composite 0-100 Health Score radar that detects memory leaks, swap thrashing, thermal throttling, and anomalies automatically with actionable remediation advice.
-- **System Services & Daemons Observatory (PRD §23):** Real-time tracking of OS background services with startup type and status monitoring.
-- **Quick Command Palette (PRD §33):** Instant developer-tool command launcher (`Ctrl+P` or `:`) for 17 direct actions, sorting modes, theme switches, and process controls.
-- **Native Hardware Benchmark Engine (PRD §25):** Built-in single-core integer MOP/s, multi-threaded GFLOPS, and memory bandwidth (GB/s) profiler.
+# 8. Export an instantaneous, comprehensive system telemetry snapshot to JSON
+zyphor snapshot -o system-state.json
+# 9. Query top processes from the CLI without launching the TUI
+zyphor process --sort cpu --limit 10
+```
 ---
-## ⚡ Zero-Flicker Architecture
+## 🎮 Keyboard Controls & Navigation
-Zyphor operates entirely on a **Double-Buffered Differential Rendering Engine**:
-1. Telemetry snapshot sampled with near-zero overhead (`NtQuerySystemInfo` on Windows, `/proc` on Linux).
-2. Renders all viewport layers to a virtual off-screen `ScreenBuffer`.
-3. Computes a strict `Cell`-level diff against the previous frame.
-4. Emits only the exact ANSI escape sequences for cells that changed.
+Zyphor supports standard navigation keys, arrow keys, and full **Vim-style navigation** (`h`, `j`, `k`, `l`, `g`, `G`).
-The result? Absolute zero tearing, zero flickering, and sub-0.1% CPU overhead even at high refresh rates.
+### Viewport Navigation
+| Hotkey | Action | Description |
+| :--- | :---: | :--- |
+| <kbd>1</kbd> .. <kbd>7</kbd> | Direct Jump | Switch to Overview, Processes, Disks, Network, Health, Services, or Containers. |
+| <kbd>Tab</kbd> / <kbd>Shift+Tab</kbd> | Next / Prev Tab | Advance viewport sequentially across panels. |
+| <kbd>:</kbd> or <kbd>Ctrl+P</kbd> | Command Palette | Open floating quick-action command launcher. |
+| <kbd>?</kbd> | Help Overlay | Display full modal cheatsheet of all keyboard shortcuts. |
+| <kbd>q</kbd> or <kbd>Ctrl+C</kbd> | Clean Exit | Restore terminal cursor state and exit cleanly. |
+### Process & List Manipulation
+| Hotkey | Action | Description |
+| :--- | :---: | :--- |
+| <kbd>j</kbd> / <kbd>k</kbd> or <kbd>↓</kbd> / <kbd>↑</kbd> | Navigate Cursor | Move process / service selection down or up. |
+| <kbd>g</kbd> / <kbd>G</kbd> | Top / Bottom | Jump cursor to the top or bottom of the list. |
+| <kbd>PgUp</kbd> / <kbd>PgDn</kbd> | Page Scroll | Scroll list by 10 items at a time. |
+| <kbd>/</kbd> | Global Search | Enter live search filter mode (filters active panel in real time). |
+| <kbd>Esc</kbd> | Clear / Close | Clear active search query or close the open modal. |
+| <kbd>Enter</kbd> | Deep Inspector | Toggle side-pane telemetry inspector for selected item. |
+| <kbd>t</kbd> | Lineage Tree | Toggle hierarchical DFS process parent/child tree mode. |
+| <kbd>c</kbd> / <kbd>m</kbd> / <kbd>p</kbd> / <kbd>n</kbd> | Sort Modes | Instantly sort by CPU%, Memory (RSS), PID, or Name. |
+| <kbd>x</kbd> | Terminate (Kill) | Send `SIGKILL` / `TerminateProcess` to highlighted process. |
+| <kbd>s</kbd> | Suspend | Send `SIGSTOP` to pause execution of target process. |
+| <kbd>u</kbd> | Resume | Send `SIGCONT` to unpause execution of target process. |
+### Telemetry & Diagnostics Control
+| Hotkey | Action | Description |
+| :--- | :---: | :--- |
+| <kbd>P</kbd> | Process Profiler | Launch 10-second high-frequency telemetry trace on selected PID. |
+| <kbd>E</kbd> | Export Snapshot | Dump instantaneous machine state to `zyphor-export-[timestamp].json`. |
+| <kbd>Space</kbd> | Freeze Telemetry | Pause live sampling loop to freeze screen metrics for inspection. |
+| <kbd>]</kbd> or <kbd>Shift+T</kbd> | Cycle Theme | Hot-swap between all 10 built-in 24-bit TrueColor palettes. |
 ---
-## 📦 Installation
+## 📦 Installation & Getting Started
+Zyphor compiles to a single, standalone `1.1 MB` static executable.
-### 1. Universal One-Line Installers
+### 1. One-Line Universal Installers
 #### Linux & macOS (Bash / Zsh):
 ```bash
@@ -60,15 +260,11 @@ irm https://raw.githubusercontent.com/miyaniakshar1234/Zyphor/master/install.ps1
 ---
-### 2. JavaScript & Web Toolchains (NPM, Bun, PNPM, Yarn)
-Execute immediately without installing or install globally:
+### 2. JavaScript & Web Toolchains (NPM, Bun, PNPM)
 ```bash
-# Run immediately via npx, bunx, or pnpm dlx
+# Execute immediately via npx
 npx zyphor
-bunx zyphor
-pnpm dlx zyphor
 # Or install globally
 npm install -g zyphor
@@ -86,20 +282,20 @@ cargo install zyphor
 ---
-### 4. Native OS Package Managers
+### 4. Native Package Managers
-#### Homebrew (macOS & Linux):
+#### macOS & Linux (Homebrew):
 ```bash
 brew tap miyaniakshar1234/zyphor
 brew install zyphor
 ```
-#### Windows Package Manager (Winget):
+#### Windows (Winget):
 ```powershell
 winget install miyaniakshar1234.Zyphor
 ```
-#### Scoop (Windows):
+#### Windows (Scoop):
 ```powershell
 scoop bucket add zyphor https://github.com/miyaniakshar1234/scoop-zyphor
 scoop install zyphor
@@ -108,129 +304,62 @@ scoop install zyphor
 #### Arch Linux (AUR):
 ```bash
 yay -S zyphor-bin
-# or with paru:
+# or
 paru -S zyphor-bin
 ```
 ---
-### 5. Docker / Podman Container (GHCR)
+### 5. Build from Source
-Run with host PID access for complete host telemetry:
-```bash
-docker run -it --rm --pid=host ghcr.io/miyaniakshar1234/zyphor
-```
----
-### 6. Pre-built Standalone Binaries
-Download the compiled single-file binary directly from [GitHub Releases](https://github.com/miyaniakshar1234/Zyphor/releases):
-- `zyphor-linux-x86_64.tar.gz`
-- `zyphor-linux-aarch64.tar.gz`
-- `zyphor-macos-x86_64.tar.gz`
-- `zyphor-windows-x86_64.zip`
-- `zyphor-windows-aarch64.zip`
----
-### 7. Build from Source
-Building Zyphor requires [Zig 0.15+](https://ziglang.org/download/):
+Building Zyphor requires [Zig 0.15.2+](https://ziglang.org/download/):
 ```bash
+# Clone the repository
 git clone https://github.com/miyaniakshar1234/Zyphor.git
 cd Zyphor
-zig build -Doptimize=ReleaseFast
-./zig-out/bin/zyphor
-```
-### CLI Automation & Diagnostics Pipelines
-Zyphor isn't just a TUI; it's a scriptable observability engine:
-```bash
-# Full environment readiness, permissions, and sensor audit
-zyphor doctor
-# Run native CPU compute and RAM bandwidth benchmark
-zyphor bench
-# Explainable root-cause health & diagnostics audit
-zyphor health
-# Storage partitions and directory space consumer tree
-zyphor disk
-# Network interfaces and active process socket connection table
-zyphor net
-# OS background services and daemons
-zyphor services
-# Top 10 processes sorted by CPU utilization
-zyphor process --sort cpu --limit 10
+# Compile with ReleaseFast optimizations
+zig build -Doptimize=ReleaseFast
-# Export comprehensive instantaneous system snapshot to JSON
-zyphor snapshot -o system-state.json
+# The optimized static binary is generated at:
+./zig-out/bin/zyphor
 ```
 ---
-## 🎮 Global Controls & Navigation
-Zyphor supports standard arrow keys, numerical hotkeys, and full **Vim-style navigation** (`h`, `j`, `k`, `l`, `g`, `G`):
-| Key | Action | Description |
-| :--- | :---: | :--- |
-| <kbd>Tab</kbd> / <kbd>Shift+Tab</kbd> | Next / Prev Tab | Advances viewport across the 6 sub-system panels. |
-| <kbd>1</kbd> .. <kbd>6</kbd> | Direct Jump | Switch to Overview, Processes, Storage, Net, Health, or Services. |
-| <kbd>:</kbd> / <kbd>Ctrl+P</kbd> | Command Palette | Opens floating quick action command palette (PRD §33). |
-| <kbd>/</kbd> | Search / Filter | Activates live search mode to filter processes or services. |
-| <kbd>Enter</kbd> | Deep Inspector | Opens full-screen process inspector modal for highlighted task. |
-| <kbd>t</kbd> | Lineage Tree | Toggles hierarchical process parent/child trees. |
-| <kbd>c</kbd> / <kbd>m</kbd> / <kbd>p</kbd> / <kbd>n</kbd>| Sort Modes | Instantly sort by CPU, Memory, PID, or Name. |
-| <kbd>x</kbd> / <kbd>s</kbd> / <kbd>u</kbd> | Process Actions | Kill, Suspend (SIGSTOP), or Resume (SIGCONT) selected process. |
-| <kbd>Space</kbd> | Pause/Resume | Toggles freeze mode on live telemetry sampling. |
-| <kbd>T</kbd> | Cycle Theme | Cycles through 10 built-in 24-bit TrueColor palettes (Default: `Anthropic`). |
-| <kbd>?</kbd> | Help Modal | Opens full keyboard shortcut overlay. |
-| <kbd>q</kbd> | Exit | Restores terminal cursor and exits cleanly. |
----
+## 📚 Exhaustive Documentation Index
-## 🎨 Hand-Tuned TrueColor Themes
+For in-depth operational and engineering guides, explore the dedicated documentation suite:
-Zyphor ships with 10 built-in 24-bit TrueColor palettes. The default theme is **Anthropic**:
-* 🏺 **Anthropic (Default):** Warm dark charcoal `#1F1D1C`, terracotta `#D97757`, biscuit sand `#E5C07B`, and sage green `#718E75`.
-* ⚡ **Cyber:** High-contrast cyberpunk palette with magenta `#FF0080` and neon blue `#00F0FF`.
-* 🌃 **Tokyo Night:** Deep indigo `#1a1b26`, electric cyan `#7dcfff`, and magenta `#bb9af7`.
-* 💻 **Hacker:** Classic terminal aesthetic with CRT phosphors `#20C20E` and dark obsidian `#0C100C`.
-* 🌌 **Midnight:** Deep slate-navy base with electric cyan and emerald accents.
-* 🌿 **Aurora:** Nordic evening glow featuring seafoam greens and soft amethyst.
-* ❄️ **Nord:** Arctic slate aesthetic based on authentic Nord design tokens.
-* ☀️ **Solarized Dark:** Classic low-glare palette tuned for long diagnostic sessions.
-* ☕ **Gruvbox:** Warm retro contrast with amber accents and terracotta highlights.
-* ⬛ **High Contrast:** Pure monochrome black/white for maximum accessibility.
+| Document | Focus Area |
+| :--- | :--- |
+| 📖 [**Observatory User Manual**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/user-manual.md) | Complete guide to all 7 panels, process trees, inspector cards, profiling workflows, and metrics. |
+| 🧠 [**Internal Systems Architecture**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/architecture.md) | Low-level design, memory models, double arenas, differential rendering, and zero-allocation invariants. |
+| 🚨 [**Alerts & Diagnostics Engine**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/alerts-and-diagnostics.md) | Heuristic algorithms, 0–100 health scoring formulas, anomaly detection, and remediation playbooks. |
+| 🧬 [**Platform Internals & Probes**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/platform-internals.md) | Kernel telemetry implementations: Windows NT direct syscalls, Linux `/proc` zero-copy, and macOS Mach probes. |
+| 🤖 [**CLI & Automation Reference**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/cli-reference.md) | Comprehensive subcommand reference, JSON export schemas, Prometheus exporter integration, and scripting recipes. |
+| 🎨 [**Theming & Customization**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/theming-and-customization.md) | 24-bit TrueColor tokens, custom palette configuration, and visual overrides. |
+| 🔧 [**Troubleshooting & FAQ**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/troubleshooting.md) | Terminal compatibility, Windows console modes, Linux capability permissions (`CAP_SYS_PTRACE`), and FAQ. |
+| 🤝 [**Contributing Guide**](https://github.com/miyaniakshar1234/Zyphor/blob/master/docs/contributing.md) | Coding standards, memory safety invariants, testing harness, benchmarking requirements, and PR workflows. |
 ---
-## 📚 Comprehensive Documentation
+## 👨‍💻 About the Developer
-Exhaustive, deeply technical documentation is available in the [`docs/`](docs/) directory:
+Zyphor was architected, designed, and built by **Akshar Miyani**.
-| Document | Focus Area |
-| :--- | :--- |
-| 📖 [**Observatory User Manual**](docs/user-manual.md) | Full guide to all 6 panels, process tree inspection, kill/suspend workflows, and telemetry metrics. |
-| 🚀 [**Getting Started & Setup**](docs/getting-started.md) | Prebuilt binaries, distribution packages, source builds, permissions, and configuration. |
-| 🤖 [**CLI & Automation Reference**](docs/cli-reference.md) | Subcommands, JSON schemas, pipeable automation scripts, and Prometheus exporters. |
-| 🧠 [**Internal Systems Architecture**](docs/architecture.md) | Low-level systems design, zero-allocation memory models, double arenas, and differential rendering engine. |
-| 🚨 [**Alerts & Diagnostics Engine**](docs/alerts-and-diagnostics.md) | Root-cause analysis heuristics, 0-100 health scoring formulas, anomaly detection, and hysteresis. |
-| 🧬 [**Platform Internals & Probes**](docs/platform-internals.md) | Deep kernel telemetry implementation: Windows NT, Linux `/proc` & netlink, and macOS Mach ports. |
-| 🤝 [**Contributing Guide**](CONTRIBUTING.md) | Coding standards, memory safety invariants, testing harness, benchmarking, and PR workflows. |
+* **Philosophy:** Software should treat hardware with absolute respect. A diagnostic tool should never impose a significant burden on the system it is tasked with observing.
+* **Focus:** Low-level systems engineering, cache-friendly data-oriented design, kernel telemetry, compiler-level optimizations, and modern terminal user experiences.
+* **GitHub:** [@miyaniakshar1234](https://github.com/miyaniakshar1234)
+* **Repository:** [https://github.com/miyaniakshar1234/Zyphor](https://github.com/miyaniakshar1234/Zyphor)
 ---
-## 🤝 Contributing
+## 📄 License
-We want to make Zyphor the undisputed king of terminal monitors. If you want to contribute new OS abstractions, UI widgets, or analytics engines, read our [Contributing Guide](CONTRIBUTING.md) to get started!
+Zyphor is open-source software licensed under the **MIT License**. See the [LICENSE](https://github.com/miyaniakshar1234/Zyphor/blob/master/LICENSE) file for details.
 <div align="center">
-  <i>Created and maintained with precision for the systems engineering community.</i>
+  <sub>Engineered with precision for the global systems community by <b>Akshar Miyani</b>.</sub>
 </div>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "zyphor",
-  "version": "0.1.1",
+  "version": "1.0.0",
   "description": "Next-generation native terminal system observatory written in pure Zig",
   "main": "bin/zyphor.js",
   "bin": {