p3x-redis-ui 2026.4.2010 → 2026.4.2012

package/COMPARISON.md

@@ -166,7 +166,7 @@ All my domains, including [patrikx3.com](https://patrikx3.com), [corifeus.eu](ht
 **🚨 Important Changes:** Any breaking changes are prominently noted in the readme to keep you informed.
 
 
-[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2010
+[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2012
 
  [![NPM](https://img.shields.io/npm/v/p3x-redis-ui.svg)](https://www.npmjs.com/package/p3x-redis-ui)  [![Donate for PatrikX3 / P3X](https://img.shields.io/badge/Donate-PatrikX3-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6)  [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)
 

package/README.md

@@ -6,7 +6,7 @@
 
 
 
-# 📡 P3X Redis UI: A highly functional and convenient database GUI that fits in your pocket, accessible on both responsive web and desktop applications v2026.4.2010
+# 📡 P3X Redis UI: A highly functional and convenient database GUI that fits in your pocket, accessible on both responsive web and desktop applications v2026.4.2012
 
 
   
@@ -83,336 +83,11 @@ Try the latest version at [p3x.redis.patrikx3.com](https://p3x.redis.patrikx3.co
 
 ## Features
 
-### Triple GUI: Angular + React + Vue
-
-P3X Redis UI was originally built with AngularJS and has been fully migrated to three modern frontends — **Angular**, **React/MUI**, and **Vue/Vuetify** — all at full feature parity. You can switch between them live in **Settings → GUI**.
-
-- **Angular** (`/ng/`) — Angular CLI with esbuild, CDK virtual scrolling, standalone components with signals
-- **React** (`/react/`) — Zustand state management, @tanstack/react-virtual, MUI (Material UI), Vite
-- **Vue** (`/vue/`) — Pinia state management, Vue 3 Composition API, Vuetify, Vite
-- `/` auto-redirects to your last used frontend
-- **Shared across all three:** same Socket.IO protocol, same 54-language translation system, same 7 themes (4 dark + 3 light), Web Worker tree building, Playwright E2E tests
-- Works in the Electron desktop app, Docker, and standalone server
-
-### AI-Powered Redis Query Translation
-- **Natural language queries:** type plain English (or any language) in the console — if Redis doesn't recognize the command, AI translates it to a valid Redis command and replaces the console input; the command is **not executed automatically** — you review, edit if needed, and press Enter to run it
-- **Multi-command AI:** AI can generate multiple commands or multi-line EVAL scripts — they are placed in the textarea for review, then executed with Enter
-- **Input replacement:** after AI translation, the console input is replaced with the generated Redis command so you can see exactly what will be executed before running it
-- **Multilingual:** understands 54 languages, explanations are returned in the language you type in
-- **Context-aware:** sends Redis version, loaded modules, available RediSearch indexes, current page, active connection, and selected database to the AI for accurate, situation-aware answers
-- **Agentic tool-use:** for investigation prompts ("why is memory high?", "show me the 10 busiest keys"), the AI can call safe read-only Redis tools (INFO, MEMORY STATS, SLOWLOG, SCAN, ACL WHOAMI, etc.) in a bounded loop and surfaces every tool call + result in the console scrollback for transparency
-- **AI Cheatsheet:** dedicated dialog (replaces the old Redis Commands popup) with categorized, searchable prompts grouped by feature (diagnostics, keys, data types, RedisJSON, RediSearch, TimeSeries, Bloom, VectorSet, scripting, cluster, ACL, translation). Module- and version-aware: groups only appear when the relevant module is loaded
-- **Stop button:** click the stop icon in the console input to cancel a running AI query instantly — the input is cleared and re-enabled while the server-side loop finishes in the background and its response is discarded
-- **Bring your own key:** optionally set your own free Groq API key in Settings for better performance (get one at [console.groq.com](https://console.groq.com))
-- **`ai:` prefix:** explicitly trigger AI translation by starting your input with `ai:` — works when AI is enabled in Settings
-- **AI toggle in console:** when AI is globally enabled in Settings, a slide toggle appears in the console toolbar to control auto-detect behavior:
-  - **AI ON** (default): unrecognized commands automatically try AI translation
-  - **AI OFF**: only the explicit `ai:` prefix triggers AI — console errors are instant with no Groq round-trip delay
-  - When AI is disabled in Settings, the toggle is hidden and all AI features are off
-
-  | Settings AI | Console Toggle | `ai:` prefix | Auto-detect on errors |
-  |---|---|---|---|
-  | Disabled | Hidden | Off | Off |
-  | Enabled | ON (default) | Works | Works |
-  | Enabled | OFF | Works | Off (instant errors) |
+See [**Features**](artifacts/readme/features.md) — Triple GUI (Angular + React + Vue), AI-powered queries, real-time monitoring (Pulse / Profiler / PubSub / Analysis), RediSearch, RedisTimeSeries, ReJSON, RedisBloom, VectorSet, Redis 8.x, ACL, and more.
 
 ## AI Configuration
 
-The AI query translation feature works out of the box — natural language queries are automatically translated to Redis commands via the Groq API.
-
-### How It Works
-
-By default, AI queries are routed through `network.corifeus.com`, which handles the Groq API call. No configuration needed.
-
-If you set your own Groq API key, you can choose to:
-- **Keep routing via `network.corifeus.com`** (default) — your key is used but queries still go through the proxy for analytics
-- **Route directly to Groq** — toggle "Route via network.corifeus.com" OFF in AI Settings to bypass the proxy entirely
-
-### AI Settings in the UI
-
-The **Settings** page has an **AI Settings** panel with:
-- **AI Enabled** — toggle AI on/off (enabled by default)
-- **Route via network.corifeus.com** — toggle routing (only visible with a valid Groq API key)
-- **Groq API Key** — set via the Edit button (validated against Groq before saving)
-
-### Configuration Options
-
-**Recommended:** Configure AI settings via the GUI first (Settings > AI Settings). Once configured, you can optionally add `groqApiKeyReadonly: true` to `p3xrs.json` or `--groq-api-key-readonly` CLI flag to lock the settings.
-
-All settings can also be configured via `p3xrs.json` or CLI options.
-
-Config (`p3xrs.json`):
-
-```json
-{
-  "p3xrs": {
-    "groqApiKey": "gsk_your_key_here",
-    "aiEnabled": true,
-    "aiUseOwnKey": false
-  }
-}
-```
-
-| Key | Type | Default | Description |
-|-----|------|---------|-------------|
-| `groqApiKey` | string | `""` | Your Groq API key (get free at [console.groq.com](https://console.groq.com)) |
-| `aiEnabled` | boolean | `true` | Enable/disable AI auto-detect on unrecognized commands; `ai:` prefix always works regardless |
-| `aiUseOwnKey` | boolean | `false` | `true` = route directly to Groq, `false` = route via network.corifeus.com |
-| `groqApiKeyReadonly` | boolean | `false` | Lock all AI settings (toggles disabled, Edit hidden) |
-
-CLI options:
-
-```bash
-p3xrs --groq-api-key gsk_your_key_here
-p3xrs --groq-api-key-readonly
-```
-
-### Readonly Mode
-
-To prevent users from changing AI settings (e.g. on a public instance):
-
-Config (`p3xrs.json`):
-
-```json
-{
-  "p3xrs": {
-    "groqApiKey": "gsk_your_key_here",
-    "groqApiKeyReadonly": true
-  }
-}
-```
-
-CLI:
-
-```bash
-p3xrs --groq-api-key gsk_your_key_here --groq-api-key-readonly
-```
-
-Or combine with readonly connections (`-r`) which also disables AI settings:
-
-```bash
-p3xrs -r --groq-api-key gsk_your_key_here
-```
-
-Example systemd service (public instance):
-
-```ini
-[Unit]
-Description=p3x-redis-ui
-After=network.target
-
-[Service]
-Type=simple
-User=user
-WorkingDirectory=/home/user/p3x-redis-ui
-ExecStart=/var/p3x-redis-ui-server/bin/p3xrs.mjs -r --groq-api-key-readonly --config /home/user/p3x-redis-ui/p3xrs.json
-Restart=on-abort
-
-[Install]
-WantedBy=multi-user.target
-```
-
-### Connection Resilience
-- **Auto-reconnect** — when the server disconnects, a spinner overlay appears and Socket.IO automatically retries the connection
-- **Seamless recovery** — when the server comes back, the page reloads and reconnects to the same Redis instance automatically
-
-### Compatibility
-- **Redis 6+ with TLS** — see [Configuring Redis TLS](https://spin.atomicobject.com/2021/08/05/configuring-redis-tls/) for setup details
-- **Pika compatible** (not fully optimized)
-- **SSH tunneling** for single instances, cluster, and sentinel
-- **Environment variables:** customize server port and home directory via `P3XRS_PORT` and `P3XRS_DOCKER_HOME`
-
-### Data Handling
-- **Auto data decompression** — automatically detects and decompresses compressed values stored in Redis. Supports GZIP, ZIP (PKZip), zlib/deflate, Zstandard (zstd), LZ4, Snappy, and Brotli. Shows a compression badge with the algorithm name and space savings ratio. Only decompresses when the result is valid text — binary uploads (e.g., gzipped images) are left untouched. Works for string, list, hash, set, and sorted set values.
-- **Value format toggle** — switch between Raw, JSON, Hex, and Base64 display for all key types (string, hash, list, set, zset, stream); display-only — copy and edit always use the raw original value
-- **Hex dump viewer** — proper hex editor layout with address column, hex bytes (16 per line), and ASCII representation
-- **JSON pretty-print** — auto-formats valid JSON values with indentation
-- **Base64 encoding** — encodes values including Unicode and binary data via TextEncoder
-- **Binary data:** use the download button for binary content; direct text editing is not supported for binary values
-- **Large values (>256 kB):** shown as `[object ArrayBuffer]`; use binary upload/download
-- **Clipboard:** text can be copied directly; binary data requires the download button
-
-### Editing Safety
-- **Diff view before save** — optional diff dialog shows inline or side-by-side comparison of old vs. new value before committing changes; works for string, hash, list, and JSON key types including the JSON editor; collapsible unchanged sections with context lines; toggle in Redis Settings (default: off)
-- **Undo after save** — after saving a string or JSON key, a toast notification appears with an Undo button; clicking it restores the previous value immediately; works for both direct edits and JSON editor saves
-
-### Key Export / Import
-- **Export:** download keys as a JSON file — supports string, list, set, zset, hash, stream, and JSON types with binary data encoded as base64 and TTL preservation
-- **Search-aware:** when a search is active, export only the matching results; otherwise export all keys in the current database
-- **Import:** upload a previously exported JSON file with a preview dialog showing all keys with their translated types, virtual scrolling for large key sets, and conflict handling (overwrite or skip existing keys)
-- **Hamburger menu:** export and import actions are accessible from the `⋮` menu in the tree controls toolbar; the menu label dynamically shows the key count and whether it's exporting all keys or search results
-- **Bulk delete:** delete all keys matching the current search pattern directly from the hamburger menu; when no search is active, deletes all keys using `FLUSHDB` for efficiency
-
-### Real-Time Monitoring (Pulse / Profiler / PubSub)
-
-Three dedicated tabs accessible from the monitoring page:
-
-#### Pulse — Live Dashboard
-- **Live metrics:** memory usage (used, RSS, peak, fragmentation), ops/sec, connected/blocked clients, hit rate, network I/O, expired/evicted keys — updating every 2 seconds
-- **Dashboard info cards:** server info (OS, port, PID, config file, CPU usage), persistence status (RDB last save, AOF), replication (role, replicas, master host), keyspace breakdown (keys + expires per database), loaded modules with versions — all with individual export buttons
-- **uPlot charts:** four lightweight canvas charts (~35 KB) for memory, ops/sec, clients, and network I/O with theme-aware colors
-- **Slow log viewer:** recent slow queries with execution duration
-- **Client list:** all connected Redis clients with address, name, database, current command, idle time, and kill button
-- **Memory top keys:** top 20 biggest keys by memory usage with byte sizes
-- **Auto-refresh:** toggle auto-polling for client list and memory top keys
-- **Pause/resume:** pause live updates without leaving the page
-- **Export:** download overview data, dashboard info, charts (PNG), slow log, client list, and top keys as text files; Export All bundles everything into a ZIP with TXT + PNG + PDF
-- **Theme + language reactive:** charts reinitialize on theme or language change
-
-#### Profiler — Real-Time Command Stream
-- **Redis MONITOR:** streams every command executed on the server in real time via a dedicated Redis connection
-- **Command display:** timestamp (ms precision), database number, source IP, and full command with arguments
-- **Performance:** renders max 66 DOM entries for smooth scrolling, stores up to 10,000 entries in memory
-- **Persistence:** last 100 entries saved to localStorage
-- **Export:** download all entries as a text file
-
-#### PubSub — Channel Message Monitoring
-- **Pattern subscription:** subscribe with configurable glob patterns (default `*` for all channels) via `PSUBSCRIBE`
-- **Message display:** timestamp, channel name, and full message content in real time
-- **Restart:** re-subscribe with a new pattern without leaving the page
-- **Performance:** same 66 DOM / 10,000 memory / 100 localStorage limits as Profiler
-- **Export:** download all entries as a text file
-
-#### Analysis — Memory Analysis Dashboard
-- **One-click snapshot:** capture the full state of your Redis server at a point in time — type distribution, memory allocation per namespace, key expiration stats, and INFO memory breakdown
-- **Type distribution chart:** canvas bar chart showing how many keys and how much memory each data type (string, hash, list, set, zset, stream) uses
-- **Memory by prefix:** groups keys by their first `:` segment and ranks prefixes by total memory — quickly find which namespace is consuming the most resources
-- **Key expiration overview:** shows the count of keys with TTL vs persistent keys, plus the average TTL across all expiring keys (formatted with `humanize-duration`)
-- **Memory breakdown:** total, RSS, peak, overhead, dataset, Lua, fragmentation ratio, and allocator — all from `INFO memory`
-- **Server info header:** Redis version, mode (standalone/cluster/sentinel), and uptime displayed in the accordion header
-- **Configurable scan:** adjust "Top N" and "Max Scan Keys" to control scan depth; the UI shows how many keys were sampled out of the total database size
-- **Export All (ZIP):** download a complete analysis bundle as a ZIP file (`{connection}-analysis.zip`) containing the full text report and all chart images (PNG) — useful for sharing with your team or attaching to incident reports when investigating server issues
-- **Chart export:** each chart accordion has its own Export button to download individual charts as PNG
-- **Theme-aware:** bar charts use CSS custom property colors and automatically redraw on theme or window resize
-
-### User Interface
-- **Responsive design:** works on phones, tablets, and desktops
-- **7 themes:** Light, Enterprise, Redis (light) + Dark, Dark Neu, Darko Bluo, Matrix (dark) — with **auto-switch** that follows your system's dark/light preference in real time
-- **Theme auto-switch:** defaults to system preference on first visit; manually selecting a theme overrides auto mode
-- **Info page:** dedicated page with keyboard shortcuts reference, about section (version, Redis info, links), and supported languages list
-- **Command palette:** VS Code-style quick command palette (`Ctrl+K` in Electron) with search and keyboard navigation
-- **Desktop shortcuts:** press ALT to access menus in the desktop version
-- **Tree view:** adjustable key count (100–100,000) with virtual scrolling for performance
-- **Smart tree memory:** expanded/collapsed folder state is saved per connection and database in session storage — survives page refreshes and database switches, restored automatically when reconnecting to the same server
-
-### Keyboard Shortcuts (Electron Desktop)
-| Shortcut | Action |
-|----------|--------|
-| `Ctrl+R` / `F5` | Refresh current view |
-| `Ctrl+F` | Focus search input |
-| `Ctrl+N` | New key dialog |
-| `Ctrl+K` | Command palette |
-| `Ctrl+D` | Disconnect |
-
-### Connection Management
-- **Connection groups:** organize connections into named groups with collapsible headers in Settings
-- **Drag-and-drop:** reorder connections within a group and reorder groups themselves by dragging headers
-- **Group toggle:** enable/disable grouped view with a single click — persisted in localStorage
-- **Group field:** optional group name in the connection dialog with autocomplete from existing groups
-
-### Console and Search
-- **Global console drawer:** bottom slide-up drawer accessible from any page — toggle via the footer Console button or **Ctrl+`** shortcut. Lets you run commands without leaving the Keys / Monitoring / Settings page you're on. Preference persists across reloads (per-connection — drawer stays hidden when disconnected)
-- **Multi-line input:** the console uses a textarea that supports multi-line commands
-  - **Shift+Enter** inserts a new line, **Enter** executes
-  - Multiple commands (one per line) are executed sequentially
-  - Multi-line `EVAL`/`EVALSHA` scripts are sent as a single command — Lua newlines are preserved
-  - The textarea auto-grows up to 3 lines when focused, with a scrollbar for longer content
-  - On blur the textarea collapses to a single line to keep the output visible
-- **Command history:** **Shift+ArrowUp/Down** navigates history (plain arrows scroll the textarea)
-- **AI multi-line:** AI-generated commands can be multiple lines — they are placed in the textarea for review before execution
-- **Channel monitoring:** toggle monitoring for all channel messages via a checkbox; the last 20 entries are stored in local storage
-- **Database selection:** choose databases via the console or dropdown (shows empty/filled status)
-- **Search modes:** client-side for small key sets, server-side for large key sets; search by prefix or substring
-
-### Networking
-- **Sub-directory support:** use Nginx/Ingress path rewriting — see [Issue #43](https://github.com/patrikx3/redis-ui/issues/43)
-- **Cluster support:** continuously improving, with significant contributions by [@devthejo](https://github.com/devthejo)
-
-
-### RediSearch Full-Text Search
-- **Search page:** full-text search UI with index selector, query input, and paginated results — only visible when RediSearch module is detected
-- **Index management:** create indexes with schema builder (TEXT, NUMERIC, TAG, GEO, VECTOR fields), drop indexes with confirmation
-- **Index info:** view index metadata and statistics after running a search
-- **Module-aware:** header button automatically appears when the `search` module is loaded (Redis 8+ or Redis Stack)
-
-### RedisTimeSeries Visualization
-- **Module auto-detection** — TimeSeries UI automatically appears when the `timeseries` module is loaded (Redis Stack or Redis 8+)
-- **Interactive line chart** — uPlot canvas chart with theme-aware colors (dark/light), responsive resizing, and locale-aware time formatting via native `Intl`
-- **Live auto-refresh** — toggle auto-polling (10-second interval) to watch incoming data in real time
-- **Reactive inputs** — chart auto-reloads on any input change (from/to, aggregation, overlay, label filter) with debounced updates
-- **Time range & aggregation** — filter by from/to timestamps, apply aggregation functions (avg, min, max, sum, count, first, last, range, std.p, std.s, var.p, var.s) with configurable time buckets
-- **Data point management** — add, edit, and delete individual data points with confirmation dialogs; inline add form directly below the chart
-- **Bulk edit** — edit all data points at once via the Edit button in the chart header; monospace textarea with `timestamp value` per line; `*` timestamps are auto-spread by a configurable interval (1s to 24h)
-- **Bulk generate on create** — toggle "Bulk generate" in the Add Key dialog to create a new timeseries key with multiple data points at once using the formula generator
-- **Formula generator** — generate test data with mathematical formulas (sin, cos, linear, random, sawtooth) with configurable point count, amplitude, and offset
-- **TS.INFO panel** — view retention, total samples, memory usage, chunk info, duplicate policy, labels, and compaction rules in a settings-style mat-list
-- **Labels editor** — edit retention, duplicate policy, and labels on existing keys via `TS.ALTER`; labels are also editable from the Edit dialog
-- **Default labels** — keys created from the GUI automatically get a `key=<keyname>` label for discoverability; keys without labels get the default label assigned on first view
-- **Multiple series overlay** — overlay additional timeseries keys on the same chart by entering comma-separated key names
-- **TS.MRANGE label filter** — query across multiple keys by label filter (e.g. `sensor=temp`) and overlay all matching series on the chart with different colors
-- **Export chart as PNG** — download the chart as a PNG image with proper background (dark/light aware), title, and color legend
-- **Key creation** — create new timeseries keys with configurable retention, duplicate policy (`LAST`, `FIRST`, `MIN`, `MAX`, `SUM`, `BLOCK`), and labels
-- **Tree integration** — timeseries keys show with a chart-area icon and display the data point count (totalSamples) in the tree view
-- **Theme + language reactive** — charts reinitialize on theme or language change
-- **No external date library** — all date formatting uses native `Intl.DateTimeFormat`, no dayjs dependency for the timeseries component
-
-### Redis 8 Module Support (ReJSON)
-- **ReJSON (JSON data type)** — view, create, edit, format, copy, and download JSON documents stored with `JSON.SET`
-- **Module auto-detection** — available modules are detected on connection via `MODULE LIST`
-- **JSON keys** appear in the tree with a `</>` icon; JSON type is available in the "Add Key" dialog when the module is detected
-- **Inline JSON tree** — JSON keys display as an expandable/collapsible tree with syntax coloring
-- **CodeMirror editor** — edit JSON documents with syntax highlighting, GitHub dark/light themes, line wrapping toggle, and code folding
-
-### RedisBloom Probabilistic Data Structures
-- **Full support for 5 types** — Bloom filter, Cuckoo filter, Top-K, Count-Min Sketch, and T-Digest
-- **Module auto-detection** — probabilistic types appear when the `bf` (RedisBloom) module is detected via `MODULE LIST`
-- **Info display** — click any probabilistic key to see its metadata (capacity, size, error rate, items inserted, etc.) in a clean card layout
-- **Inline actions** — add items, check membership (Bloom/Cuckoo), query counts (CMS), query quantiles (T-Digest), and list top items (Top-K) — all from the key view
-- **Key creation** — create new keys with smart defaults pre-filled (error rate, capacity, K, width, depth, decay, compression)
-- **Tree integration** — each type has its own icon (filter, trophy, chart) and shows item count in the tree view
-- **Console hints** — full autocomplete support for all BF.*, CF.*, TOPK.*, CMS.*, and TDIGEST.* commands
-- **AI query support** — the AI console understands all RedisBloom types and commands
-
-### Redis 8 VectorSet Support
-- **Native vector type** — full support for Redis 8's built-in `VECTORSET` data type (no module required)
-- **Vector info** — view metadata (dimensions, element count, quantization, projection) via `VINFO`
-- **Element browser** — paginated list of all vector elements with search, attribute inspection, and delete actions
-- **Similarity search** — search by element name or by raw vector with configurable COUNT; results displayed with similarity scores
-- **Attribute viewer** — inspect `VGETATTR` attributes on individual elements via info icon + toast
-- **Add elements** — inline form to add new vector elements with `VADD` (element name, vector, optional attributes)
-- **Key creation** — create new VectorSet keys from the "Add Key" dialog with dimension and initial element
-- **Tree integration** — VectorSet keys show with a data-array icon and display element count (VCARD) in the tree view
-- **Console hints** — autocomplete for VADD, VSIM, VCARD, VDIM, VGETATTR, VSETATTR, VREM, VINFO, VLINKS
-- **VSIM IN filter** (Redis 8.2+) — filter expression input for similarity search, narrow results by attribute values
-- **AI query support** — the AI console understands VectorSet types and commands
-
-### Redis 8.x Advanced Features
-- **Per-field hash TTL** (Redis 8.0+) — set expiration on individual hash fields via `HEXPIRE`; schedule icon per field row with live countdown, color-coded (green >1h, yellow <1h, red <5min, pulsing <30s), tooltip with humanized duration; auto-refresh when a field expires
-- **String digest** (Redis 8.4+) — view the hash digest of any string key value via the `DIGEST` command; one-click button in string key actions
-- **Hybrid search** (Redis 8.4+) — toggle `FT.HYBRID` mode on the search page to combine text queries with vector similarity using Reciprocal Rank Fusion; requires a RediSearch index with a VECTOR field
-- **Cluster slot stats** (Redis 8.2+) — monitoring dashboard accordion showing top slots by key count, CPU time, or memory usage via `CLUSTER SLOT-STATS`; only visible in cluster mode
-- **Console command hints** — autocomplete for all new Redis 8.0–8.6 commands: HGETEX, HSETEX, HGETDEL, HTTL, HEXPIRE, HPERSIST, MSETEX, XDELEX, XCFGSET, DIGEST, FT.HYBRID, CLUSTER SLOT-STATS, CLUSTER MIGRATION
-- **AI query support** — AI prompt updated with all Redis 8.0–8.6 commands; Redis server version now correctly sent to AI for version-aware command generation
-- **Version-gated UI** — all Redis 8.x features automatically appear/hide based on the connected Redis server version
-
-### ES Modules Backend
-The server codebase has been fully migrated from CommonJS to **ES Modules** (`.mjs`), enabling native Node.js ESM support and better tree-shaking.
-
-### ACL Management (Redis 6.0+)
-- **User list** — view all ACL users with status (enabled/disabled), current user indicator, and rules summary
-- **Create / Edit / Delete** — full ACL user management via a dialog with chip-based rule editing
-- **Chip inputs** — commands, key patterns, and pub/sub channels are entered as chips with placeholder hints
-- **Deny highlighting** — commands starting with `-` (e.g. `-@dangerous`) are visually highlighted with the warning color
-- **Default user warning** — editing the `default` user shows an inline warning alert explaining the risk of locking out connections
-- **Save confirmation** — every ACL save shows a themed confirm dialog
-- **Consistent across GUIs** — identical chip styling, layout, and behavior in Angular, React, and Vue
-
-### Security
-- **Secure configuration:** passwords and sensitive data are protected with unique identifiers for both main and node configurations
-
-<!--
-👷 **The first full complete version was created in 20 days in September of 2018.**
--->
+See [**AI Configuration**](artifacts/readme/ai.md) — works out of the box; covers GUI/CLI config, readonly mode, and the Groq API key.
 
 
 ## Important Notice
@@ -421,124 +96,8 @@ Do not manually create the configuration `JSON` file with a text editor. Use the
 
 ## Optional HTTP Basic Authentication
 
-Protect both HTTP routes and Socket.IO with HTTP Basic authentication.
-
-Config (`p3xrs.json`):
-
-```json
-{
-  "p3xrs": {
-    "httpAuth": {
-      "enabled": true,
-      "username": "admin",
-      "passwordHash": "$2b$10$..."
-    }
-  }
-}
-```
-
-Generate a BCrypt password hash:
-
-```bash
-node ./node_modules/p3x-redis-ui-server/bin/bcrypt-password.js -p myplainpass
-```
-
-Environment variables:
-
-- `HTTP_USER`
-- `HTTP_PASSWORD`
-- `HTTP_PASSWORD_HASH`
-- `HTTP_PASSWORD_HASH_FILE`
-- `HTTP_AUTH_ENABLED` (`true|false`)
-
-CLI options:
-
-- `--http-auth-enable`
-- `--http-auth-disable`
-- `--http-auth-username`
-- `--http-auth-password`
-- `--http-auth-password-hash`
-- `--http-auth-password-hash-file`
-
-Notes:
-
-- `passwordHash` is preferred over plain `password`.
-- Use HTTPS or a reverse proxy with TLS when HTTP auth is enabled.
+See [**HTTP Basic Auth**](artifacts/readme/http-basic-auth.md) — config, env vars, CLI flags.
 
-## All Features Are Free
-
-All features including SSH tunneling, Cluster/Sentinel, ReJSON, binary upload/download, and readonly connections are available for free. No license required.
-
-
-<!--
-## License Integration
-
-The app validates licenses through `network.corifeus.com` for product `p3x-redis-ui`.
-
-- Validation endpoint: `GET https://network.corifeus.com/public/license/check/:licenseKey`
-- Returned data is shown in `Settings -> License`:
-  - tier, validity and status, reason
-  - starts/expires/check timestamps, days left
-  - enabled features
-- License key is displayed only in masked form on the client.
-- License state refreshes every 60 minutes (server + client refresh flow).
-- License validation requires internet access.
-
-### Tier Feature Policy
-
-- `free`
-  - Core Redis UI only; no SSH tunneling, no Readonly connection mode, no Cluster/Sentinel, no Edit JSON/Upload binary/Download binary, no ReJSON.
-  - Price: `0 HUF/month (€0/month)`.
-- `pro`
-  - SSH tunneling, Readonly connection mode (including `--readonly-connections`/`-r`), Edit JSON, Upload binary, Download binary, ReJSON (JSON data type).
-  - Base price: `400 HUF/month (€1/month)` or `4,000 HUF/year (€10/year)`.
-  - Total with `27%` VAT: `500 HUF/month (€1.27/month)` or `5,100 HUF/year (€12.70/year)`.
-- `enterprise`
-  - SSH tunneling, Cluster and Sentinel, Edit JSON, Upload binary, Download binary, ReJSON (JSON data type); `--readonly-connections`/`-r` also works.
-  - Base price: `1,200 HUF/month (€3/month)` or `12,000 HUF/year (€30/year)`.
-  - Total with `27%` VAT: `1,500 HUF/month (€3.81/month)` or `15,200 HUF/year (€38.10/year)`.
-- Yearly price is `10x` the monthly price.
-- Default license includes `5 seats`; for more seats, contact [`support@corifeus.com`](mailto:support@corifeus.com).
-- Enterprise trial: `10 days` free with a valid email address.
-- Billing info required: `Name, Billing e-mail, Country code, Postal code, City, Address, VAT ID (optional)`.
-- PayPal payment accepted only in `HUF` (Hungarian forint).
-- VAT (`27%` in Hungary) is added to paid plan prices.
-- Invoice/license communication is in English; invoice currency is HUF.
-- Contact: [`support@corifeus.com`](mailto:support@corifeus.com).
-
-Enforcement:
-- Backend enforces tier rules on connection save/connect/test paths
-- Backend enforces Pro+ for binary value writes (`key-set`, `key-new-or-set`)
-- Backend enforces Pro+ for ReJSON (JSON data type) operations (`key-get`, `key-new-or-set`, `key-json-set`)
-- Frontend mirrors the rules in UI controls (hide/disable + localized messages)
-- `--readonly-connections` (`-r`) requires `pro` or `enterprise` tier
-
-### License Editing Policy (`p3xrs.json`)
-
-License editability is controlled by server config:
-
-- `p3xrs.licenseEditable` (recommended)
-- Legacy fallback: `p3xrs.editableActive`
-- Legacy fallback: `p3xrs.disabled` (inverted)
-
-If license editing is disabled:
-
-- the `Edit` button is disabled in the UI
-- the UI shows a terminal-only notice (EN/ZH/RU)
-- the server blocks license updates (`license_readonly`), preventing bypass from browser/API
-
-Example:
-
-```json
-{
-  "p3xrs": {
-    "licenseEditable": false
-  }
-}
-```
-
-Restart the server after changing `p3xrs.json`.
--->
 
 ## Installation
 
@@ -645,6 +204,8 @@ kubectl apply -f generated.yaml
 
 ### Desktop Applications
 
+> **Stuck on the loading screen?** Reinstall the app (Snap / Flatpak / deb / rpm / AppImage / dmg / msi). A cached or partial install from a previous auto-update is the usual cause; reinstall clears it and the GUI loads on next launch.
+
 #### macOS
 
 Supports both Intel and Apple Silicon builds. If you download the `zip` for the `arm64` version, remove the quarantine attribute:
@@ -708,33 +269,7 @@ The app is listed on [ElectronJs Apps](https://electronjs.org/apps) — search f
 
 ## Architecture
 
-This application uses Socket.IO instead of REST for client-server communication. While unconventional, Socket.IO provides better responsiveness by avoiding HTTP protocol overhead, resulting in a smoother interaction experience.
-
-[REST vs WebSocket benchmarks](https://www.google.com/search?q=rest+vs+websocket+comparison+benchmarks)
-
-
-### Communication Flow
-
-```
-Browser / Electron App / VS Code Extension
-        ↓
-redis-ui-material
-  ├── Angular frontend (/ng/)  — Angular + Angular Material
-  ├── React frontend (/react/) — React + MUI + Vite + Zustand
-  └── Vue frontend (/vue/)     — Vue 3 + Vuetify + Vite + Pinia
-        ↓ Socket.IO + HTTP
-redis-ui-server (Express + ioredis)
-        ↓
-Redis Instance (standalone / cluster / sentinel, optional SSH tunnel)
-```
-
-### Related Repositories
-
-| Repository | Description |
-|------------|-------------|
-| [p3x-redis-ui](https://github.com/patrikx3/redis-ui) | Electron desktop app + CLI (this repo) |
-| [p3x-redis-ui-server](https://github.com/patrikx3/redis-ui-server) | HTTP + Socket.IO server backend |
-| [p3x-redis-ui-material](https://github.com/patrikx3/redis-ui-material) | Angular + React + Vue frontends |
+See [**Architecture**](artifacts/readme/architecture.md) — Socket.IO + Express + ioredis, three frontends (Angular / React / Vue), related repositories.
 
 ## Adoption Notes
 
@@ -824,7 +359,7 @@ All my domains, including [patrikx3.com](https://patrikx3.com), [corifeus.eu](ht
 **🚨 Important Changes:** Any breaking changes are prominently noted in the readme to keep you informed.
 
 
-[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2010
+[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2012
 
  [![NPM](https://img.shields.io/npm/v/p3x-redis-ui.svg)](https://www.npmjs.com/package/p3x-redis-ui)  [![Donate for PatrikX3 / P3X](https://img.shields.io/badge/Donate-PatrikX3-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6)  [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)
 

package/change-log.2018.md

@@ -143,7 +143,7 @@ All my domains, including [patrikx3.com](https://patrikx3.com), [corifeus.eu](ht
 **🚨 Important Changes:** Any breaking changes are prominently noted in the readme to keep you informed.
 
 
-[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2010
+[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2012
 
  [![NPM](https://img.shields.io/npm/v/p3x-redis-ui.svg)](https://www.npmjs.com/package/p3x-redis-ui)  [![Donate for PatrikX3 / P3X](https://img.shields.io/badge/Donate-PatrikX3-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6)  [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)
 

package/change-log.2019.md

@@ -312,7 +312,7 @@ All my domains, including [patrikx3.com](https://patrikx3.com), [corifeus.eu](ht
 **🚨 Important Changes:** Any breaking changes are prominently noted in the readme to keep you informed.
 
 
-[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2010
+[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2012
 
  [![NPM](https://img.shields.io/npm/v/p3x-redis-ui.svg)](https://www.npmjs.com/package/p3x-redis-ui)  [![Donate for PatrikX3 / P3X](https://img.shields.io/badge/Donate-PatrikX3-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6)  [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)
 

package/change-log.2020.md

@@ -706,7 +706,7 @@ All my domains, including [patrikx3.com](https://patrikx3.com), [corifeus.eu](ht
 **🚨 Important Changes:** Any breaking changes are prominently noted in the readme to keep you informed.
 
 
-[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2010
+[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2012
 
  [![NPM](https://img.shields.io/npm/v/p3x-redis-ui.svg)](https://www.npmjs.com/package/p3x-redis-ui)  [![Donate for PatrikX3 / P3X](https://img.shields.io/badge/Donate-PatrikX3-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6)  [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)
 

package/change-log.2021.md

@@ -355,7 +355,7 @@ All my domains, including [patrikx3.com](https://patrikx3.com), [corifeus.eu](ht
 **🚨 Important Changes:** Any breaking changes are prominently noted in the readme to keep you informed.
 
 
-[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2010
+[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2012
 
  [![NPM](https://img.shields.io/npm/v/p3x-redis-ui.svg)](https://www.npmjs.com/package/p3x-redis-ui)  [![Donate for PatrikX3 / P3X](https://img.shields.io/badge/Donate-PatrikX3-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6)  [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)
 

package/change-log.2022.md

@@ -102,7 +102,7 @@ All my domains, including [patrikx3.com](https://patrikx3.com), [corifeus.eu](ht
 **🚨 Important Changes:** Any breaking changes are prominently noted in the readme to keep you informed.
 
 
-[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2010
+[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2012
 
  [![NPM](https://img.shields.io/npm/v/p3x-redis-ui.svg)](https://www.npmjs.com/package/p3x-redis-ui)  [![Donate for PatrikX3 / P3X](https://img.shields.io/badge/Donate-PatrikX3-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6)  [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)
 

package/change-log.2023.md

@@ -139,7 +139,7 @@ All my domains, including [patrikx3.com](https://patrikx3.com), [corifeus.eu](ht
 **🚨 Important Changes:** Any breaking changes are prominently noted in the readme to keep you informed.
 
 
-[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2010
+[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2012
 
  [![NPM](https://img.shields.io/npm/v/p3x-redis-ui.svg)](https://www.npmjs.com/package/p3x-redis-ui)  [![Donate for PatrikX3 / P3X](https://img.shields.io/badge/Donate-PatrikX3-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6)  [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)
 

package/change-log.2024.md

@@ -483,7 +483,7 @@ All my domains, including [patrikx3.com](https://patrikx3.com), [corifeus.eu](ht
 **🚨 Important Changes:** Any breaking changes are prominently noted in the readme to keep you informed.
 
 
-[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2010
+[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2012
 
  [![NPM](https://img.shields.io/npm/v/p3x-redis-ui.svg)](https://www.npmjs.com/package/p3x-redis-ui)  [![Donate for PatrikX3 / P3X](https://img.shields.io/badge/Donate-PatrikX3-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6)  [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)
 

package/change-log.2025.md

@@ -111,7 +111,7 @@ All my domains, including [patrikx3.com](https://patrikx3.com), [corifeus.eu](ht
 **🚨 Important Changes:** Any breaking changes are prominently noted in the readme to keep you informed.
 
 
-[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2010
+[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2012
 
  [![NPM](https://img.shields.io/npm/v/p3x-redis-ui.svg)](https://www.npmjs.com/package/p3x-redis-ui)  [![Donate for PatrikX3 / P3X](https://img.shields.io/badge/Donate-PatrikX3-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6)  [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)
 

package/change-log.md

@@ -5,6 +5,24 @@
                         
 [//]: #@corifeus-header:end
 
+### v2026.4.2011
+Released on 05/08/2026
+* BUGFIX: Bumped @codemirror/view resolution to 6.42.1 to fix duplicate KeyBinding type error.
+* DOCS: Trimmed README from 835 to 370 lines and moved long sections to artifacts/readme/.
+* CHORE: Updated dependencies across all packages.
+
+### v2026.4.2010
+Released on 05/08/2026
+* FEATURE: Added Meet Assistant SaaS promo alongside AI Network Assistant on demo site.
+* FEATURE: Registered forum icon for Meet Assistant SaaS promo button.
+* BUGFIX: AI explanations now default to English when no UI language is set instead of biasing toward Hungarian.
+* REFACTOR: Extracted shared AI prompt and parser to a common library module.
+* REFACTOR: Moved callGroq, runSingleShotQuery, and AI utilities into the shared layer.
+* DOCS: Added COMPARISON.md comparing P3X Redis UI against other Redis tools, linked from README.
+* DOCS: Updated repository URL references across documentation.
+* DOCS: Updated documentation headers across packages.
+* CHORE: Updated dependencies to the latest versions across all packages.
+
 ### v2026.4.2007
 Released on 04/20/2026
 * BUGFIX: Updated info component in Material UI.
@@ -852,7 +870,7 @@ All my domains, including [patrikx3.com](https://patrikx3.com), [corifeus.eu](ht
 **🚨 Important Changes:** Any breaking changes are prominently noted in the readme to keep you informed.
 
 
-[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2010
+[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2012
 
  [![NPM](https://img.shields.io/npm/v/p3x-redis-ui.svg)](https://www.npmjs.com/package/p3x-redis-ui)  [![Donate for PatrikX3 / P3X](https://img.shields.io/badge/Donate-PatrikX3-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6)  [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)
 

package/contributors.md

@@ -73,7 +73,7 @@ All my domains, including [patrikx3.com](https://patrikx3.com), [corifeus.eu](ht
 **🚨 Important Changes:** Any breaking changes are prominently noted in the readme to keep you informed.
 
 
-[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2010
+[**P3X-REDIS-UI**](https://corifeus.com/redis-ui) Build v2026.4.2012
 
  [![NPM](https://img.shields.io/npm/v/p3x-redis-ui.svg)](https://www.npmjs.com/package/p3x-redis-ui)  [![Donate for PatrikX3 / P3X](https://img.shields.io/badge/Donate-PatrikX3-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6)  [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "p3x-redis-ui",
-    "version": "2026.4.2010",
+    "version": "2026.4.2012",
     "description": "📡 P3X Redis UI: A highly functional and convenient database GUI that fits in your pocket, accessible on both responsive web and desktop applications",
     "corifeus": {
         "description-snap": "P3X Redis UI: A highly functional and convenient database GUI that fits in your pocket, accessible on both responsive web and desktop applications",
@@ -33,7 +33,7 @@
         "publish-electron-snap-arm64": "rimraf dist && electron-builder --linux snap -p never --arm64",
         "publish-electron-yml": "node ./node_modules/corifeus-builder/src/utils/appimage/post-build.js",
         "publish-electron-flatpak": "rm -rf dist && electron-builder -p always --linux flatpak  --x64  --arm64",
-        "publish-macos": "electron-builder --mac --publish never",
+        "publish-macos": "electron-builder --mac --x64 --arm64 --publish never",
         "publish-macos-mas": "source ./secure/apple-env.sh && sudo rm -rf build && sudo rm -rf dist && mkdir build && cp secure/apple/p3xredisuimacos.provisionprofile ./build && cp -R artifacts/apple/entitlements/ ./build  && electron-builder --mac mas --universal  --publish never",
         "publish-macos-mas-save": "source ./secure/apple-env.sh && sudo rm -rf build && sudo rm -rf dist && cp -R artifacts/apple/entitlements/ ./build  && cp secure/apple/p3xredisuimacos.provisionprofile ./build  && electron-builder --mac mas --universal  --publish never"
     },
@@ -87,8 +87,8 @@
         "corifeus-utils": "^2026.4.135",
         "electron-store": "^11.0.2",
         "electron-updater": "^6.8.3",
-        "p3x-redis-ui-material": "^2026.4.459",
-        "p3x-redis-ui-server": "^2026.4.374"
+        "p3x-redis-ui-material": "^2026.4.461",
+        "p3x-redis-ui-server": "^2026.4.376"
     },
     "build-save": {
         "mac": {