LOGAR/RELEASE_NOTES.md

LOGAR Release Notes

[v0.3.5.1] - 2026-09-30

🗄️ Multi-Engine Storage Architecture

• Dynamic Backend Switching: LOGAR Server Hub supports runtime switching between lightweight Local SQLite (WAL Mode) and Enterprise SQL servers (PostgreSQL and MySQL / MariaDB) via SQLAlchemy.
• Automated Schema Provisioning: Database switching automatically verifies connectivity, provisions normalized tables (telemetry_events, client_seats, license_config, admin_users), and generates optimized query indices.
• Config Isolation: Runtime backend parameters are stored persistently in server_config.json under db_engine and safely isolated from ephemeral test runs.

⚡ Ingestion Ring Buffer & Burst Protection

• In-Memory Queue Buffering: Built-in ring buffer with an asynchronous background flusher decoupled from mTLS socket I/O.
• Cache Mode: High-velocity log spikes are absorbed in memory without blocking incoming mTLS 1.3 frame streams.
• Configurable Batching: Configurable flush interval (buffer_flush_interval_sec, default 2.0s) and batch size (buffer_batch_size, default 100).
• Graceful Shutdown: Unflushed queue items are flushed and committed cleanly during server shutdown.
• Opt-In Security Policy: Buffering remains an explicit administrative choice and is not auto-enabled upon license activation.

🔐 Zero-Knowledge OpenPGP Data Encryption at Rest

• Public-Key Envelope Encryption: External SQL payloads (event_data) can be encrypted at rest using the server's X.509 RSA-2048 / OpenPGP public key with AES-256-GCM symmetric session keys.
• Zero-Knowledge on Database Host: External DBAs or compromised database hosts cannot read plaintext telemetry without the server's private key.
• Opt-In Security Policy: Payload encryption is strictly opt-in and configurable per compliance requirements.

📜 Dynamic Licensing Introspection & Clean Dashboard WebUI

• Modular Capability Introspection: PKI X.509 extension OID 1.3.6.1.4.1.58888.1.3 and persistent license records are dynamically parsed to display active modules (enterprise_db, etc.) in a dedicated card on the 📜 Sub-CA & Licensing tab.
• Distraction-Free Tab Navigation: Cleaned all dashboard tab headers to remove redundant item counts and visual badges for a streamlined administrative interface.
• Graceful Feature Locking: Unlicensed enterprise controls remain visible but gracefully disabled in the WebUI and rejected by backend API validation.

📖 WebUI Administrator Guide & 51 Automated Tests

• WebUI Administrator Guide: Published comprehensive WebUI management guide on the Gitea Wiki covering console access, telemetry filtering, seat management, licensing, database switching, queue tuning, zero-knowledge crypto, Hermes AI, and 2FA.
• Expanded Test Suite: 51 automated unit and integration tests passing with 100% test coverage.

---

[v0.3.4.2] - 2026-09-30

🔒 Exclusive Hardware Host-Binding & Reassignment Controls

• Automated Host Binding on First Activation: Licenses automatically lock to the specific server hardware fingerprint (server_fingerprint) and hostname upon first activation/enrollment, preventing multi-host cloning or license hijacking.
• Manual Host Reassignment Control: Added 🔓 Reset Host Binding button to the Master License Authority dashboard (licenseDetailsModal), allowing administrators to unbind a license so it can be cleanly transferred or reassigned to a new server instance.
• REST & CLI Management: Added POST /api/license/reset-binding and CLI argument --reset-binding LIC_ID for automated provisioning pipelines.

---

[v0.3.4.1] - 2026-09-27

🎨 Installer Dialog UI Spacing & Branding Enhancements

• NSIS Client Config Profile Dialog Fix: Adjusted vertical coordinates and label boundaries in the Windows Client NSIS installer (installer_client.nsi) to prevent input field overlap and ensure multi-line instructional text renders without visual clipping.
• Installer Footer Branding Clean-Up: Escaped ampersands in Windows installer branding labels (BrandingText) to avoid character truncation in native win32 footer panels.
• License Authority UI Clean-Up: Simplified table ACTIONS column in the Licensing Authority portal to exclusively display ⚙️ Manage, keeping secondary actions (Reinstate, Delete) inside the dedicated management modal.

---

[v0.3.4] - 2026-09-27

🔄 In-Place Installer Upgrades & Mutual Exclusion Guards

• Seamless In-Place Upgrades: Windows (Inno Setup & NSIS) and Linux installers detect existing installations automatically. In upgrade mode, installers stop background services, update core binaries and runtime in-place, and restart services without overwriting configuration files (server_config.json, client_config.json), database state (logar_state.db), state tracking (client_state.json), or mTLS certificates.
• Host Mutual Exclusion Validation: Added pre-installation validation across all installers to prevent accidental co-installation of LOGAR Server and LOGAR Client on the same host, showing descriptive guidance to administrators.

🛡️ WebUI 2FA & Telemetry Stability

• Server Hub TOTP Two-Factor Authentication: Implemented RFC 6238 TOTP 2FA for the LOGAR Server Hub web portal (:8443), featuring interactive QR code setup, secret generation, and secure session validation.
• Telemetry Stream UI Buffer Capping: Limited the live verified telemetry stream view to the latest 50 events in the Server Hub dashboard for enhanced browser performance and UI stability.

🔑 Licensing Authority Management & Registry Tooling

• Revocation, Reinstatement & License Deletion: Enhanced the Master Licensing Authority (logar.eibl.tech) with instant license revocation, reinstatement of revoked licenses, and conditional permanent deletion of revoked records.
• Interactive Capability Explorer: Added interactive implementation breakdown modals across core capabilities on the public project landing page.
• Automated Gitea Container Pruning: Added prune_images.py utility to maintain clean container registries by keeping only the latest active image versions.

---

[v0.3.3] - 2026-09-27

🎨 Brand Identity, Centralized Asset Library & Design System

• Centralized /assets Repository: Added official vector graphics (logo.svg, logo_transparent.svg, logo_dark.svg, logo_banner.svg), high-resolution master PNGs (16px to 512px), multi-resolution Windows ICOs (logo.ico, favicon.ico), and installer dialog bitmaps (wizard_header.bmp, wizard_small.bmp, wizard_sidebar.bmp).
• Official Wiki Branding Guide: Published comprehensive visual identity standards on the Gitea Wiki detailing logo anatomy, color palettes (Cyber Cyan #00E5FF, Emerald #00FFA3, Dark Navy #0E1A2E), typography, clear-space rules, dos and don'ts, and strict non-SIEM positioning.
• Unified Interface & Tab Branding: Implemented transparent vector logos on all web navigation bars and browser tabs across both the LOGAR Server Hub (:8443) and Master Licensing Authority (logar.eibl.tech).
• Clean Installer Bitmaps: Regenerated 24-bit RGB header bitmaps with seamless white backgrounds (#FFFFFF) matching native Windows Inno Setup wizard dialogs.
• Automated Asset Pipeline: Enhanced compilation/generate_branding_assets.py to deterministically compile and distribute assets across main repo, compilation subdirectories, and the licensing submodule without third-party graphics dependencies.

---

[v0.3.2] - 2026-09-27

🪟 Windows Installer & Web Portal Enhancements

• Project Showcase Landing Page: Deployed public homepage at GET / on the licensing authority with architecture diagrams, quickstart commands, and direct navigation to Gitea, Wiki, and the Licensing Portal (/licensing).
• Standalone Windows Binaries & Python Runtime: Resolved issues with standalone Windows executable execution and bundled runtime paths.
• Data Directory Selection & Permissions: Added custom data directory selection during setup and fixed permissions for background Windows services.
• Service Lifecycle & Clean Uninstallation: Resolved service startup issues and ensured complete cleanup of state files upon uninstallation.