Skip to content

Releases

ram-tui v1.0.3-1 — Maintenance & Installer Hardening

Choose a tag to compare

@github-actions github-actions released this 04 Sep 20:23

🛡️ RAM-TUI v1.0.3-1 — Maintenance & Installer Hardening

This maintenance release adds atomic installer protections and official visual branding assets.

Highlights

  • Atomic Installer Downloads (C-501): install.sh and install.ps1 now download to isolated temporary files and atomically move the binary only after cryptographic SHA-256 verification succeeds, preventing symlink overwrite / TOCTOU issues.
  • Official Brand Assets: Added transparent header logo (assets/logo.png), high-res project avatar (assets/avatar.png), and documented brand iconography in README.md.
  • Audit Verification: Full workspace passing 71 automated tests with zero-allocation, safe FFI, and hardened signal handling certified.

Quick Install

curl -fsSL https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.sh | bash

ram-tui v1.0.3 — Security Hardening, Fail-Closed Installers & Visual Polish

Choose a tag to compare

@BlackFeather-git BlackFeather-git released this 03 Sep 18:59

🚀 RAM-TUI v1.0.3 — Maintenance & Hardening Release

This maintenance release hardens terminal escape safety, upgrades bootstrap installers to fail-closed cryptographic verification, refines Windows swap telemetry, optimizes the render loop, and resolves visual border alignment in the Theme Selector modal.


🛡️ Security & Hardening Fixes

  1. Sanitized Hostname Against Terminal Escape Injection:

    • Consolidated system hostname extraction into core_render::format::get_hostname().
    • The live TUI header now sanitizes raw HOSTNAME / COMPUTERNAME environment values through sanitize_text(), stripping ANSI escape sequences, control bytes, and Unicode directional overrides.
    • Added unit test test_get_hostname_sanitized.
  2. Strict Fail-Closed Installer Checksum Verification:

    • Updated both install.sh and install.ps1 to be strictly fail-closed: if the release .sha256 digest cannot be retrieved, or hashing utilities are absent, or checksum verification fails, the installer aborts immediately with an error and cleans up the binary instead of continuing unverified.
  3. Input Sanitization on --filter CLI Argument:

    • Enforced the printable ASCII allowlist (' '..='~') on the startup --filter flag, matching the live interactive search box and preventing terminal escape injection through wrapper scripts.

🐛 Bug Fixes & Architectural Enhancements

  1. Theme Selector Modal Border Alignment:

    • Fixed a visual glitch where right borders (│) on theme selection rows were shifted by 8 characters due to static space counts.
    • All rows now dynamically calculate exact column width via visible_cell_width() and pad to the 38-column box width.
    • Centered and dynamically padded the modal footer key navigation legend.
    • Added regression test test_theme_modal_box_alignment verifying box width consistency across all 13 themes.
  2. Real Windows Pagefile Swap Telemetry:

    • Replaced hardcoded swap_used = 0 on Windows with accurate committed memory differential commit_as.saturating_sub(total).min(swap_total).
  3. Render Loop Performance & Code Deduplication:

    • Cached TrueColor Palette state across frames, eliminating ~10-20 heap string allocations per frame on unchanged ticks.
    • Reused FrameBuffer::prev vector capacity with clear() + extend_from_slice() instead of cloning every line.
    • Unified tick-loop and post-keypress rendering call sites into a single macro.
    • Wired FrameBuffer::invalidate() to trigger on terminal window resize and display mode switches.

📦 Quick Install / Upgrade

Linux & macOS

curl -fsSL https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.ps1 | iex

ram-tui v1.0.2 — Maintenance Release (PSS/USS Fix & Cryptographic Integrity)

Choose a tag to compare

@BlackFeather-git BlackFeather-git released this 02 Sep 19:10

🚀 RAM-TUI v1.0.2 — Maintenance Release

🐛 Bug Fixes & Enhancements

  1. PSS/USS Candidate Pre-Sorting:

    • Resolved an issue in collector/src/processes.rs where process candidate sampling for smaps_rollup PSS/USS enrichment occurred prior to sorting the process vector.
    • The candidate pool is now pre-sorted by RSS before sampling, guaranteeing that the top memory consumers are consistently enriched with exact PSS and USS telemetry.
    • Added unit test test_rss_presort_candidate_enrichment verifying top-process enrichment.
  2. Process Count Range Validation:

    • Enforced range constraint 1..=10000 on the --count / -n command-line argument, matching documented specifications and preventing zero-count edge cases.
    • Added integration test test_count_range_enforcement.
  3. Cryptographic SHA-256 Installer Verification:

    • Automated CI generation and upload of .sha256 checksum digests for all precompiled binary assets.
    • Both install.sh and install.ps1 now automatically download and verify the binary SHA-256 digest before marking as executable.
  4. Hotkey Documentation:

    • Formally documented x / X alongside K for process termination in keybindings tables.

📦 Quick Install / Upgrade

Linux & macOS (One-Line Installer)

curl -fsSL https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.ps1 | iex

Cargo (From Source)

cargo install --git https://github.com/BlackFeather-git/ram-tui.git

ram-tui v1.0.1 — Automated Multi-Platform Release Assets

Choose a tag to compare

@BlackFeather-git BlackFeather-git released this 02 Sep 05:19

🚀 RAM-TUI v1.0.1 — Maintenance Release

📦 Automated Multi-Platform Binary Assets

This release introduces automated CI release builds and publishes standalone precompiled binary assets for all major operating systems and architectures directly on GitHub Releases:

  • Linux x86_64: ram-tui-linux-x86_64
  • macOS Apple Silicon (aarch64 / M-series): ram-tui-darwin-aarch64
  • macOS Intel (x86_64): ram-tui-darwin-x86_64
  • Windows x86_64: ram-windows-x86_64.exe (and ram-tui-windows-x86_64.exe)

🛠️ Installer Improvements

  • Windows PowerShell (install.ps1): Added HTTP error handling, basic parsing, and binary size verification to ensure failed downloads fail with explicit diagnostic feedback rather than capturing error HTML.
  • Universal POSIX (install.sh): Added -fsSL curl flag and asset download failure guards.

📦 Quick Install / Upgrade

Linux & macOS (One-Line Installer)

curl -fsSL https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.ps1 | iex

Cargo (From Source)

cargo install --git https://github.com/BlackFeather-git/ram-tui.git

ram-tui v1.0.0 - Official Stable Release

Choose a tag to compare

@BlackFeather-git BlackFeather-git released this 01 Sep 19:51

🚀 RAM-TUI v1.0.0 — Official Stable Release (Native Rust Engine)

🦀 The Ground-Up Rust Rewrite

RAM-TUI v1.0.0 is a complete, ground-up rewrite in pure, native Rust with zero external runtime dependencies. It delivers sub-millisecond execution latency, deep kernel telemetry, flicker-free rendering, and honest multi-platform support across Linux, macOS, and Windows.


✨ Key Features & Architecture

  • Deep Kernel Telemetry: Real-time physical RSS, Proportional Set Size (PSS via smaps_rollup), and Unique Set Size (USS) tracking with single-pass procfs traversal.
  • Container Boundary Awareness: Native Linux Cgroups v2 (/sys/fs/cgroup/memory.max) and Cgroups v1 limit detection for Docker, Podman, and Kubernetes workloads.
  • Multi-Platform Native Backends:
    • Linux: Zero-subprocess /proc kernel parsing with race-free pidfd signaling.
    • macOS (Darwin): Direct Mach kernel FFI (host_statistics64) and libproc process enumeration.
    • Windows: Win32 GlobalMemoryStatusEx, PSAPI K32GetProcessMemoryInfo, and native console event polling.
  • Double-Buffered Frame Diffing: Custom FrameBuffer flushes only modified terminal cells and rows to stdout, eliminating terminal flicker.
  • 13 TrueColor Gradient Palettes: Live TrueColor RGB color themes with real-time in-memory cycling (t / T).
  • Live 60-Second Sparkline: Dynamic spread calculation rendering fluid historical trend glyphs (g).
  • Interactive Process Tree: Collapse and expand process groups live with hierarchical child PIDs.

📦 Installation & Upgrade

Linux & macOS (One-Line Installer)

curl -fsSL https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.ps1 | iex

Cargo (From Source)

cargo install --git https://github.com/BlackFeather-git/ram-tui.git

🛡️ Verified Automated Test Suite

  • 67 / 67 automated workspace tests passed across Linux (ubuntu-latest), macOS (macos-latest), and Windows (windows-latest).
  • Strict Clippy linted with zero warnings (-D warnings).

Note: RAM-TUI v1.0.0 is the official stable baseline. Feature development is frozen; maintenance and stability patches only.

ram-tui v0.7.0 - Stable Release

Choose a tag to compare

@BlackFeather-git BlackFeather-git released this 01 Sep 11:02

What's New in v0.7.0

Aesthetic & UI Engine

  • Centered 6-Line Large Block ASCII Banner: Added prominent 6-line block ASCII title art (RAM-TUI), perfectly centered on top and dynamically colorized with the active theme gradient on spacious viewports (>=22 rows, >=60 cols).
  • Curated Multi-Stop TrueColor Palettes Across All 13 Themes: Re-engineered palettes and gradients for all 13 built-in themes to match official community specifications (Catppuccin Mocha, Dracula Pro, Tokyo Night, Nord Arctic, Gruvbox Dark, Cyberpunk 2077, Rosé Pine, Everforest, Kanagawa Wave, Monokai Pro, Solarized Dark, and Monochrome).
  • Midnight Velvet & Neon Lavender Default Theme: Introduced vibrant cyber-violet default palette with Electric Violet (#7030EF) -> Neon Purple (#A846FF) -> Vivid Fuchsia (#DB1FFF) -> Light Lilac (#E0B3FF) gradient.
  • Visual Theme Showcase Gallery: Expanded documentation with pixel-perfect terminal previews for all 13 built-in themes in assets/themes/.
  • Dynamic 2D Window Centering: Centered layout in both horizontal and vertical dimensions on large terminals.

Security & Release Infrastructure

  • Mandatory Authenticated Installer Trust Chain: Upgraded install.sh (Linux/macOS) and install.ps1 (Windows) to strictly enforce mandatory SHA-256 integrity checks and maintainer RSA-2048 PKCS#1 v1.5 digital signature verification (ram.sig) before file installation (fail-closed).
  • Reproducible Release Tag Pinning: Supported immutable release tag pinning via RAM_INSTALL_TAG / REF across Unix and Windows installers.
  • Cryptographic In-Place Self-Updater: Built-in self-updater (ram --update) with RSA-2048 root of trust, AST validation, and atomic executable replacement.
  • Python 3.8+ Compatibility Baseline: Formally updated runtime baseline to Python 3.8+ across Linux, macOS, and Windows.
  • Automated CI Matrix: 52 automated tests passing 100% green across 12 cross-platform matrix jobs.

ram-tui v0.6.1

Choose a tag to compare

@BlackFeather-git BlackFeather-git released this 01 Sep 08:25

ram-tui v0.6.1 — Stable Release

Small enough to understand. Accurate enough to trust. Fast enough to leave running.


Highlights in v0.6.1

  • Trademark RAM-TUI Branding Header: Elevated title header to bold RAM-TUI across all interactive and mini display modes (RAM-TUI · hostname · Linux x86_64 · theme).
  • Dynamic 2D Window Centering: Automatically centers the entire dashboard in both dimensions (horizontal and vertical) on wide and tall viewports with dynamic padding, preventing header clocks and divider rules from stretching or sticking to window edges.
  • 50 Automated Cross-Platform Tests: Added test_window_vertical_and_horizontal_centering verifying 2D padding and bounds across Python 3.8 through 3.13 on Linux, macOS, and Windows.
  • Cryptographic Self-Updater (ram --update): Fail-closed in-place updates verified against embedded maintainer RSA-2048 public key, SHA-256 digests, and AST validation.
  • 50ms Real-Time Fluid Refresh: Sub-millisecond differential cursor rendering (<0.3ms/frame) with <0.6% single-core CPU overhead.
  • 13 Built-in 24-bit TrueColor Themes: Live runtime cycling (t) with default, dracula, catppuccin, nord, tokyo-night, gruvbox, cyberpunk, rose-pine, everforest, kanagawa, monokai, solarized, and monochrome.

Verification & Checksums

Asset SHA-256 Checksum
ram 1d416da515722507c4f0296e73a162344c774a1d7f09a4d0274ee4b29a44c773
# Verify checksum
sha256sum -c ram.sha256

Quick Install

# Linux & macOS
curl -fsSL https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.ps1 | iex

ram-tui v0.6.0

Choose a tag to compare

@BlackFeather-git BlackFeather-git released this 31 Aug 17:01

ram-tui v0.6.0 — Stable Release

Small enough to understand. Accurate enough to trust. Fast enough to leave running.


Highlights

  • Cryptographic Self-Updater (ram --update): Fail-closed in-place updates verified against embedded maintainer RSA-2048 public key, SHA-256 digests, and AST validation.
  • 50ms Real-Time Fluid Refresh: Sub-millisecond differential cursor rendering (<0.3ms/frame) with <0.6% single-core CPU overhead.
  • Dynamic Horizontal Centering: Automatically centers the TUI on wide monitors without stretched divider lines or displaced clocks.
  • Terminal Resize Reflow Protection: SIGWINCH signal handling and per-line \033[K (Erase to End of Line) clear to eliminate resize ghost artifacts.
  • Zero External Dependencies: 100% standard library implementation across Linux, macOS, and Windows.
  • 13 Built-in 24-bit TrueColor Themes: Live runtime cycling (t) with default, dracula, catppuccin, nord, tokyo-night, gruvbox, cyberpunk, rose-pine, everforest, kanagawa, monokai, solarized, and monochrome.
  • 4 Display Modes: hero (full dashboard), --compact (meters only), --mini (single bar), and --tiny (status bars for Waybar/tmux).

Verification & Checksums

Asset SHA-256 Checksum
ram 5e57aa7b27357e3e2e2bf70136bbc7f3fc13eb02158184050fefca4f71101f1f
# Verify checksum
sha256sum -c ram.sha256

Quick Install

# Linux & macOS
curl -fsSL https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/BlackFeather-git/ram-tui/main/install.ps1 | iex