Release Notes

[0.65.32-beta] - 2026-02-19 - [Hot Fixes]

Fixed

• AUR update inside AppImage — cleaned AppImage env vars from subprocess calls so pacman detection works; added /opt/hei-datahub/ path-based AUR fallback; AUR helpers (yay/paru) no longer wrapped in sudo (credentials cached via sudo -v instead); AppImage PermissionError at /opt/ now redirects to AUR update flow
• auth doctor false write failure — write test was hitting WebDAV root (/seafdav/) instead of inside the library; now uses correct path
• Deleted datasets reappearing in search — _DELETED_DATASETS folder excluded from indexer via SKIP_FOLDERS filter
• Delete notification — now mentions recovery via Heibox

Changed

• Update progress messages cleaned up — removed tool-specific references; generic wording for all install methods

[0.65.28-beta] - 2026-02-18 - Wide Search

Bug fixes & UX improvements — macOS Keychain, FTS5 robustness, search completeness, and mode indicator.

Fixed

• #60 Windows CI extracting wrong version for artifacts — the "Get version info" step only read version.yaml (which could be stale). Now prefers github.ref_name (the git tag) and falls back to version.yaml only for workflow_dispatch runs
• macOS Keychain password prompt on every launch — skipped the get_password() availability probe on macOS (it triggered a Keychain dialog just to test), cached the KeyringAuthStore as a singleton, and added in-memory secret caching so the Keychain is accessed at most once per session
• FTS5 syntax errors from special characters (: / | , ") — all FTS-breaking characters are now stripped from search tokens before building the MATCH query; if cleaning removes all content, falls through to filter-only search instead of crashing
• Spatial/temporal info missing in search results — search_indexed() and get_all_indexed() were missing spatial_resolution, temporal_resolution, and access_method in their metadata dicts (only _search_all() had them), so tag searches and free-text searches showed incomplete spatial/temporal info
• hdh command not working on macOS — the Homebrew build tarball only contained the hei-datahub binary; added an hdh symlink to the macOS build script so both commands work after brew install
• Special-character-only queries showing all data — typing ., ?, >, etc. now immediately shows a helpful hint ("Type a keyword to search…") instead of triggering the indexer timer that refilled the table with all datasets
• Mode indicator stuck on Normal while typing — set search_mode = True on mount and on every input change so the indicator correctly shows "Insert" from the moment the app starts and while actively typing
• CI changes — Fix Linux artifact naming inconsistent with other platforms.

[0.65.14-beta] - 2026-02-16 - Wide Search (Hotfix)

Fixed:

• Windows auto-update failing due to missing UAC elevation — replaced subprocess.Popen with ShellExecuteW (runas) and improved installer error reporting
• #58 Windows update crash when GitHub release fields (body, tag_name, html_url) were null — added safe coalescing (x.get(key) or "") across update modules
• macOS Homebrew upgrade not applying — added brew update before brew upgrade
• macOS restart launching old binary after upgrade — _restart_app now resolves executable via shutil.which("hei-datahub") instead of sys.executable
• Restart process ordering improved — os.execv now executes before app.exit() to avoid race conditions
• Update badge not appearing — ensured UI updates from background threads are dispatched to the main event loop via call_from_thread()

[0.65.0-beta] - 2026-02-12 - Wide Search

Extended Search & UX Improvements! This release brings a powerful structured-tag search system with 10 filter tags, smart autocomplete, AND-accumulation for multiple filters, a redesigned About screen, and many bug fixes.

Added

• Structured search tags — 10 short tags: project, source, category, method, format, size, sr, sc, tr, tc
• Search autocomplete — context-aware field name + field value suggestions ranked by frequency/recency
• Tags help overlay (F3 in search mode) — shows all tag names, aliases, and descriptions
• all keyword — type all to list every dataset (no colon needed)
• FTS fallback — when structured tag filters return no results, falls back to free-text search
• h/l vim-style horizontal scroll in DataTable
• Operator-pending open-link mode in About screen (o → g:GitHub / d:Docs)
• Redesigned About screen — new origin/philosophy/links layout
• Version control for data backups (read-only unless modified directly in Heibox)

Changed

• Tags help shortcut changed from ? to F3 (printable chars can't be intercepted in Input widget)
• all changed from all:* syntax to plain all keyword
• Tag generator deduplicated into shared tag_generator.py — keeps hyphenated words (e.g. ERA5-Land), extracts from source/access_method/temporal, caps description to 3 words, broad stop-word list
• Autocomplete suggests first word only for cleaner values (e.g. sr:500 not sr:"500 m")
• Multiple same-field tags are now AND-accumulated — sr:0.5 sr:500 narrows results progressively instead of only using the last value

Fixed

• Critical: Data not appearing after setting up auth until restart — settings save now calls reload_configuration() to trigger re-index
• Incremental sync wiping spatial_resolution, temporal_resolution, access_method, storage_location, reference
• Tag suggestions using DB column names (spatial_resolution:500) instead of short aliases (sr:500)
• access_method prefix not stripped in suggestions (FILE: CSV → method:CSV)
• Mode indicator stuck on "Normal" — now syncs with Input focus
• Tag comma handling — edit screen now lowercases tags consistently with add screen

KNOWN ISSUES

• FTS5 syntax errors from special characters (: / | , ") — quoted phrases now cleaned

[0.64.25-beta] - 2026-02-12 - Hotfix

Hotfix: Fixes the update badge not appearing on app launch after a new release is published.

Fixed

• Update badge no longer hidden by 8-hour throttle cache on startup — every app launch now performs a fresh network check (non-blocking)
• Stale update badge is automatically hidden when a fresh check confirms no update is available

[0.64.24-beta] - 2026-02-12 - Hotfix

Hotfix: Fixes Report Issue shortcut, update detection order, cross-platform URL opening, and redesigns the update overlay.

Changed

• Update UI with improved user feedback during updates
• Update service with improved logging and error handling
• Installation method detection with improved logging

Fixed

• Report Issue shortcut changed from Ctrl+I to F2 (Ctrl+I is aliased to Tab in terminals and never fired)
• Update detection order — UV and pipx installs are now correctly detected before AUR/Homebrew
• Update badge only appears when a new update is genuinely available
• xdg-open on Linux no longer causes TTY issues (double-forking fix)
• URL opening refactored to shared cross-platform utility with browser fallback

PS: The app hasn't been extensivly tested in Windows/MacOS

[0.64.20-beta] - 2026-02-09 - Hot fixes

Hot fixes: Fixes Ctrl+I browser opening, update detection order, and redesigns the update overlay.

Fixed

• Ctrl+I (Report Issue) now reliably opens GitHub Issues in the default browser
• Update detection order — UV and pipx installs are now correctly detected before AUR/Homebrew
• AUR updates now run inside the TUI with a minimalistic password prompt
• Update badge only appears when a new update is genuinely available

[0.64.14-beta] - 2026-02-04 - Hot fixes

Silent Update Check & Bug Fixes! This release adds automatic background update checking on app launch with a visual badge notification.

Fixed

• Fixed the update badge not showing up
• Fixed "Change Theme" command not working from command palette (Ctrl+P)
• Fixed undefined symbol: rl_print_keybinding error when using Ctrl+I on AUR-installed package

[0.64.11-beta] - 2026-01-29 - Hot fixes

Fixed

• Fixed binaries naming version

[0.64.1-beta] - 2026-01-20 - macOS Auth Hotfix

Hotfix: Enables settings and authentication on macOS.

Fixed

• macOS Authentication Support
  • Fixed settings wizard not working on macOS (was showing "only supported on Windows and Linux")
  • Added Darwin (macOS) to supported platforms for auth setup, auth clear, and auth doctor commands
  • macOS now uses the native Keychain for secure credential storage

[0.64.0-beta] - 2026-01-16 - macOS Support & UI Refinements

macOS Support & UX Improvements! This release adds official macOS support via Homebrew and significantly improves the UI responsiveness and navigation.

Added

• macOS Support
  • Official Homebrew Tap available (brew tap 0xpix/homebrew-tap)
  • Native arm64 and x86_64 builds
• Improved rendering on smaller terminal screens
• Minimalistic copy buttons added to dataset details fields
• VIM-like Yanking: Press multiple keys to copy specific fields in details view
• Dynamic footer showing available yank shortcuts
• Dedicated shortcut to report issues directly

Changed

• ID is now auto-generated from the title (manual entry removed)
• Category field is now optional
• Empty fields display as "Not specified" instead of blank
• Improved column layout in the dataset table

Fixed

• Navigation & Shortcuts
  • Fixed o shortcut in details view (now opens Access/Location link correctly)
  • Fixed Esc navigation flow (Search -> Home)
  • Fixed Ctrl+T (Theme) focus issues interfering with search bar
  • Fixed Windows-specific Shift+Ctrl+S shortcut issue
• State Management
  • Fixed data updates not reflecting immediately (save/delete no longer requires restart)
  • Fixed search results being cleared when navigating back from details
  • Fixed focus loss when returning to the list view

[0.63.0-beta] - 2026-01-14 - Multi-Platform CI/CD

Full CI/CD Pipeline & Cross-Platform Distribution! This release introduces automated builds and distribution for Windows and Linux, MacOS coming soon.

Added

• GitHub Actions CI/CD Workflows

  • windows-build.yml - Builds Windows .exe and NSIS installer
  • linux-build.yml - Builds Linux binary, .deb package, and .AppImage
  • aur-publish.yml - Automatic AUR package updates on new releases

• Build Scripts

  • scripts/build_linux.sh - Linux build with PyInstaller, creates .deb and .AppImage

• AUR Package - Hei-DataHub is now available on Arch Linux via AUR

  • Install with: yay -S hei-datahub
  • System-wide installation with desktop integration
  • Automatic updates when new versions are released

• Release Automation

  • All artifacts automatically uploaded to GitHub Releases on tag push
  • Support for any tag format (not just v* prefixed tags)

Distribution Formats

Platform	Formats
Windows	.exe (portable), .exe (NSIS installer)
Linux	Binary, .deb, .AppImage
Arch	AUR package (hei-datahub)

[0.62.0-beta] - 2026-01-13 - Re-design

UI Overhaul & Keyboard Navigation! This release brings a redesigned interface with improved keyboard navigation.

Added

• New Ctrl+P command palette for quick access to all actions
• Custom theme selector replacing Textual's default (Ctrl+T)
• Confirmation dialog when pressing Esc on the main page
• Dynamic shortcuts that change based on current screen/context
  • Home: Add, Commands, Settings, Theme
  • Results: Navigate (j/k), Top (gg), Bottom (G), Open, Clear
  • Details: Edit, Delete, Copy URL, Open URL, Back
  • Edit/Add: Save, Next/Prev Field, Cancel
• Run the app with hdh or hei-datahub

Changed

• Cleaner layout with improved visual
• Enhanced metadata presentation
• New Keyboard Shortcuts
  • Ctrl+N Add Dataset, Ctrl+Shift+S Settings, Ctrl+U Check Updates
  • Ctrl+R Refresh, Ctrl+Q Quit, Ctrl+I About
• Removed Ctrl+H help shortcut (replaced by command palette)

Fixed

• Search bar focus issues after pressing Esc or Enter
• Accidental dataset selection when pressing Enter with unfocused search
• Footer shortcuts persisting incorrectly after navigating between screens
• Command palette not showing all shortcuts on home screen
• About page footer shortcuts
• Logo display on small terminal screens

[0.61.0-beta] - 2026-01-07 - Windows-Compatibility

Windows Support Arrives! This release brings full Windows compatibility to Hei-DataHub.

Added

• Windows Support - Fully functional Windows executable (.exe).
  • Automated build scripts (scripts/build_windows_exe.ps1).
  • Windows credential management integration.
  • Cross-platform path handling for data directories.

Changed

• Updated authentication backend to support both Linux Keyring and Windows Credential Locker.
• Refactored platform-specific checks in CLI tools to allow Windows execution.
• Move the documentations to the main website.

[0.60.1-beta] - 2026-01-04

Hotfix Release - Critical fixes for authentication, installation, and legacy code removal.

Fixed

• Fixed issue where desktop integration was installed.
• Fixed crash caused by missing data directory on first run.
• Resolved multiple issues with Authentication Wizard:
  • Explicitly asks for HeiBox WebDAV credentials instead of generic username/password.
  • Fixed compatibility between GUI and CLI authentication.
  • Fixed "Auth Setup Required" bug that persisted even after successful in-app setup.
• Fixed save function failure in dataset creation.
• Fixed hei-datahub --version showing "0.0.0-dev" in installed packages.

Changed

• Removed automatic dataset seeding on first run (Cloud-Only Mode).
• Completely removed mini-datahub alias and legacy code references.
• version.yaml is now correctly bundled with the package.

[0.60.0-beta] — 2025-10-28 "Clean-up"

Added

• About Screen — Press Ctrl+a for retro-style project info
• Enhanced Search Filters — New metadata queries

Changed

• Leaner UI — Header/footer reduced to 1 line, optimized spacing
• Better Filters — Hash-based badge colors, vertical overflow support
• Improved Search — Fixed metadata field mappings, better logging

Removed

• Outbox Feature — Redundant with WebDAV (v0.59), removed entirely
• GitHub Integration — Removed PR workflow, Git stash, GitHub API client
• Legacy Code — Cleaned up mini_datahub package, unused imports, deprecated keybindings

Fixed

• Stable Scrollbars — Consistent across all screens (settings, wizard, help, details)
• Search gg jump-to-top sequence
• Keybinding footer labels
• Scrollbar flickering
• Badge color consistency

Documentation

• Dev Docs Rebranded — Complete upgrade to hei-datahub (from mini-datahub)
• Updated all examples, imports, CLI commands
• Version banners, compatibility matrix, ADR-004
• Enhanced navigation with breadcrumbs and visual polish

Install pkg

• Download the tar.gz file
• RUN: tar xzf hei-datahub_0.60.0-beta_linux_amd64.tar.gz && cd hei-datahub-0.60.0-beta && sudo ./install.sh && cd .. && rm -rf hei-datahub_0.60.0-beta_linux_amd64.tar.gz && rm -rf hei-datahub-0.60.0-beta

[0.58.1-beta] — 2025-10-09

Fixed

• Data directory — Data now loads correctly on linux:
  • Linux: ~/.local/share/Hei-DataHub
• Filename handling: Unified globbing and case-sensitivity across OSes
• Re-design some of the CLI output for clarity and consistency

Added

• hei-datahub doctor — Full system diagnostics with clear, actionable output
  • Exit codes: 0 = OK, 1 = dir issue, 2 = permission, 3 = data
  • Checks: OS info, data directory, datasets, DB, migrations, filenames
• --data-dir flag — Override data directory for any command (highest priority)
• HEIDATAHUB_DATA_DIR — Environment variable for persistent override

Notes

• Internal build only — no PyPI/public release
• Fully backward-compatible with 0.58.0-beta

---

[0.58.0-beta] — 2025-10-07 “Streamline”

Added

• UV-based installation

  • Install directly from private repo via SSH / HTTPS (for now will be changed later)
  • Supports version pinning, uvx ephemeral runs, and uv tool install
  • Full guides for only Linux, (macOS, and Windows will come in future releases)

• Packaged data & assets — All configs, schemas, and resources now included

• Linux desktop integration

  • .desktop launcher script and standalone PyInstaller build
  • Optional AppImage support

• Comprehensive docs

  • New docs/installation/ section with setup and troubleshooting guides
  • Updated main README with quickstart examples

Changed

• Package renamed to hei-datahub (alias mini-datahub still works, will be deprecated later)
• New src/hei_datahub/ structure
• Both hei-datahub and mini-datahub commands available

Fixed

• Missing data files in installs
• Import and module-not-found errors after installation

[0.57.2-beta] - 2025-10-09

Added

• Version tag under logo: Right-aligned version tag now appears under ASCII logo by default
• Version tag configuration: New config options show_version_tag, version_format, version_style under ui.logo
• Direct version loading: Python now reads version.yaml directly at runtime (no more sync script)
• Version consistency checker: New CI check verifies version consistency across all files

Changed

• Simplified version management: Eliminated _version.py and sync_version.py - version.yaml is now single source of truth
• CI workflow updated: Version sync check replaced with consistency checker

Fixed

• Version tag properly detects and displays current version and codename
• Config migration handles missing version tag fields gracefully

---

[0.57.1-beta] - 2025-10-08

Fixed

• Config reload: Theme and keybinding changes now apply without restart
• Persistent edits: Dataset edits now save correctly and persist across app restarts
• Search autocomplete: Field name suggestions now work properly in search

Known Issues

• Nested fields (arrays like schema_fields) not editable yet
• Metadata doesn't auto-refresh - requires manual reindex or press 'r'

---

[0.57.0-beta] - 2025-10-06

Added

• Documentation overhaul: Complete rewrite with 8 new pages
  • Getting Started guides (Welcome, Installation, Navigation, Basics)
  • How-to guides (GitHub workflow, datasets, search, customization)
  • Reference docs (UI, data/SQL, configuration)
  • Help & troubleshooting
• New logo design: Multiple variants (circle, inline, H-large, square) in dark/light themes
• Better navigation: Logical structure with clear categories

Changed

• Documentation structure reorganized for better discoverability
• All features now properly documented with examples

---

Details: whats-new in 0.57-beta

[0.56.0-beta] - 2025-10-05 - "Precision"

Major Release – Structured Search and Inline Editing

• Highlights:

  • Introduced inline editing for direct dataset modification in the TUI
  • Added field-specific search with structured queries and operators
  • Implemented atomic save and reindex workflow with rollback safety
  • Enhanced query parser and integrated it with the search engine
  • Added auto-publish and update PR workflows for dataset submissions

• Added:

  • Inline Editing: Edit dataset metadata directly in the Details screen

    • Editable fields: name, description, source, storage, format, size, type, project, dates
    • Save with Ctrl+S, cancel with Esc, undo/redo with Ctrl+Z / Ctrl+Shift+Z
    • Atomic YAML writes with fsync and rollback on error
    • Automatic SQLite reindex after save
    • Field-level validation on save and on blur
    • Confirmation dialog when canceling with unsaved changes

  • Field-Specific Search Integration: Structured query syntax with mixed search support

    • Filters: source:github, format:csv, tag:climate
    • Operators: >, <, >=, <= for numeric and date fields
    • Quoted phrases for exact matches ("climate data")
    • Unknown fields gracefully fall back to free-text search

  • Search Filter Badges: Real-time visual indicators for active field filters and phrases

  • Auto-Publish Workflow: Automatically creates and opens Pull Requests on save

    • Detects new vs. update datasets
    • Generates appropriate PR titles and workflow actions

  • Update PR Support: Allows modifications to existing datasets without errors

  • Query Syntax Help: Added examples and syntax guide to the Help overlay (?)

  • Custom Keybindings: Configurable shortcuts through ~/.config/hei-datahub/config.yaml

  • Theme Support: 12 built-in Textual themes including Gruvbox, Monokai, Nord, and Dracula

  • Config System: Persistent XDG-compliant configuration with inline documentation

  • Action Registry: Centralized system for managing and documenting all key actions

• Changed:

  • Search engine rebuilt to use structured query parsing with FTS5 integration
  • FTS5 phrase matching improved with exact-phrase support
  • Numeric and date filters properly type-cast in SQL queries
  • Inline editing refreshes metadata in real time without full reload
  • Storage system uses atomic write with backup and rollback
  • Auto-publish system distinguishes between new and update PRs
  • Help overlay now context-aware and displays query syntax examples

• Fixed:

  • FTS5 “no such column” error resolved with schema auto-migration
  • PR publishing works for existing datasets (update PRs supported)
  • Search crash on unknown field names resolved
  • Empty and quoted query handling corrected
  • Duplicate SQL executions removed
  • Display refresh after save now correctly updates view
  • Type-casting and numeric filter issues resolved

• Performance:

  • Search latency improved (P50: 15–20 ms on small datasets)
  • Target performance: P50 < 120 ms on 2k datasets
  • Atomic writes optimized for small YAML files (<10 ms average)

• Known Issues:

  • Keybinding and theme changes require restart
  • Keybinding conflict detection not yet implemented
  • Search field autocomplete planned for future release
  • Edit form scrolling limited for very large datasets
  • Nested array fields (schema_fields) not editable yet

• Documentation:

  • Updated search syntax and query examples
  • Added inline editing usage guide
  • Expanded configuration and keybinding reference
  • Added theme customization documentation