feat: implement core application architecture, UI rendering utilities, and GitHub release automation

Author: programmersd21

.github/workflows/release.yml

@@ -53,5 +53,6 @@ jobs:
           version: latest
           args: release --clean
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          # A Personal Access Token (PAT) is required to push to the external tap repo
+          GITHUB_TOKEN: ${{ secrets.TAP_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
 

.goreleaser.yaml

@@ -77,7 +77,7 @@ release:
 homebrew_casks:
   - repository:
       owner: programmersd21
-      name: kairo
+      name: kairo_tap
 
     directory: Casks
 

CHANGELOG.md

@@ -9,10 +9,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+* **Theme Previews**: The Theme Menu now displays intuitive mini-swatches for every theme, accurately rendering the background, foreground, accent, and success colors side-by-side for flawless visual previewing on any terminal background.
+* **Header Breathing Room**: Added a subtle top margin to the header, pushing the "KAIRO" logo and tabs down slightly for a more balanced, uncrowded layout.
 * **GitHub Discussions (`u`)**: Added dedicated shortcut to open the project's GitHub Discussions page.
-* **Empty State Redesign**: Removed the box border in the empty state and introduced an attractive, centered layout with a minimalist rocket icon and inspiring prompt.
+* **Footer UI Update**: Redesigned the footer with individual, circular pill containers (using powerline-style caps) for each keybinding to maximize readability and aesthetic appeal. Keybindings are left-aligned while version and sync status remain anchored to the right.
+* **Settings Menu**: Added an interactive settings menu (accessible via `ctrl+s`) to live-configure application settings, with support for live config file watching, reloading, and a shortcut (`g`) to directly open `config.toml` for advanced configuration.
+* **Empty State Dashboard**: Transformed the empty home screen into a personal productivity dashboard with compressed, elegant greetings, a minimalist rocket icon, and real-time task completion statistics.
 * **Theme Improvements**: Updated the `Nord` theme's muted color to a more prominent tone for improved legibility.
 
+### Fixed
+
+* **Responsive Auto-Resize Engine**: Fully implemented dynamic width constraints across the application. 
+    * The Header Tabs now dynamically shrink and truncate titles (`Upc…`) to guarantee they never overflow the window horizontally.
+    * The overall Header block and task count pill perfectly anchor to the exact center (`Align(lipgloss.Center)`), surviving aggressive terminal resizing without drifting.
+    * The Footer (`render.BarLine`) correctly clips to the terminal width without shattering the layout grid.
+* **Tab Switch Panics**: Fixed a crash (`strings: negative Repeat count`) that triggered when switching tabs rapidly during narrow terminal conditions.
+* **Menu Box Centering**: Resolved an issue where the Help and Theme menu overlays would drift to the left; they now properly inherit the viewport dimensions and float perfectly dead-center.
+* **Help Menu Alignment**: Corrected the text alignment inside the Help box to render cleanly on the left instead of forcing awkward center-justification.
+* **Cohesive Pill Caps**: Extended the premium powerline pill styling (`` / ``) to the Header Tabs (including smooth animated bubble transitions), the `DELETE?` / `QUIT?` footer badges, and all Task Priority labels (P0-P3).
+* **Linear Rainbow Animation Fix**: Resolved a race condition where toggling the rainbow logo multiple times (or changing other settings) would spawn multiple ticker loops, causing the animation to accelerate. It now maintains a consistent, buttery-smooth frame rate.
+
+### Changed
+
+* **Homebrew Repository Modularity**: Migrated the Homebrew Cask publishing from the primary application repository to a dedicated, independent tap repository (`programmersd21/kairo_tap`) to maintain cleaner git history, modularity, and separation of distribution concerns.
+
 ## [1.2.2]
 
 ### Added

Casks/.gitkeep

@@ -51,6 +51,7 @@ Built with [Bubble Tea](https://github.com/charmbracelet/bubbletea) (TUI framewo
 | **Smart Filtering** | Multiple views: Inbox, Today, Upcoming, Completed, by Tag, by Priority |
 | **Fuzzy Search** | Lightning-fast command palette with ranked results |
 | **Cinematic Animations** | Smooth vertical shutter, cascading row reveals, and glitch/vaporize deletions |
+| **Responsive Auto-Resize**| Strict grid enforcement with dynamic title truncation preventing layout drifts |
 | **Offline Storage** | SQLite with WAL for reliability and concurrent access |
 | **Git Sync** | Optional repository-backed sync with per-task JSON files |
 | **Import/Export** | JSON and Markdown support for data portability |
@@ -74,8 +75,8 @@ Built with [Bubble Tea](https://github.com/charmbracelet/bubbletea) (TUI framewo
 ### macOS (Homebrew)
 
 ```bash
-brew tap programmersd21/kairo https://github.com/programmersd21/kairo
-brew install --cask programmersd21/kairo/kairo
+brew tap programmersd21/kairo_tap
+brew install --cask kairo
 ```
 
 ### Linux / macOS (curl)
@@ -112,7 +113,7 @@ Downloads the latest GitHub Release for your OS/arch, verifies it against `check
 On Windows, Kairo will automatically close to apply the update; simply re-run `kairo` once the terminal returns.
 
 **Startup Notifications:**
-Kairo automatically checks for updates on startup. If a newer version is available, a notification will appear in the footer (e.g., `Update: v1.2.1 → v1.2.2`) directing you to run the update command.
+Kairo automatically checks for updates on startup. If a newer version is available, a notification will appear in the footer (e.g., `Update: v1.2.2 → v1.2.3`) directing you to run the update command.
 
 ---
 
@@ -250,6 +251,7 @@ Kairo features a **minimalist design system** optimized for clarity and focus.
 | `enter` | 👁️ View task details |
 | `d` | 🗑️ Delete task |
 | `t` | 🎨 Cycle themes |
+| `ctrl+s` | ⚙️ Open Settings Menu |
 | `i` | 📢 Open GitHub issues |
 | `c` | 📝 Show changelog |
 | `?` | ❓ Show help menu |
@@ -283,6 +285,25 @@ Kairo features a **minimalist design system** optimized for clarity and focus.
 
 ---
 
+## ⌨️ Vim Mode
+
+For users who live in the terminal, Kairo offers a built-in **Vim Mode** for seamless navigation without leaving the home row.
+
+### Enabling Vim Mode
+You can toggle Vim Mode in two ways:
+1. **Settings Menu**: Press `ctrl+s` and toggle "Vim Mode" to `true`.
+2. **Configuration File**: Set `vim_mode = true` in your `config.toml`.
+
+### Vim Shortcuts
+When enabled, the following classic Vim keys are activated for list navigation:
+- `j`: Move selection down
+- `k`: Move selection up
+- `G`: Jump to the bottom of the list
+
+*Note: Standard arrow keys, `pgup`/`pgdown`, and `home`/`end` remain functional regardless of this setting.*
+
+---
+
 ## ⚙️ Configuration
 
 ### Config Location
@@ -299,14 +320,15 @@ Kairo features a **minimalist design system** optimized for clarity and focus.
 cp configs/kairo.example.toml ~/.config/kairo/config.toml
 ```
 
-Then edit to customize:
+Then edit the file or use the built-in Settings menu (`ctrl+s` in Kairo) to customize:
 - **Theme selection** — Choose from 32 built-in themes:
     - **Premium Dark:** `catppuccin` (Default), `midnight`, `aurora`, `cyberpunk`, `dracula`, `nord`, `obsidian_bloom`, `neon_reef`, `carbon_sunset`, `vanta_aurora`, `plasma_grape`, `midnight_jade`, `synthwave_minimal`, `graphite_matcha`
     - **Premium Light:** `vanilla`, `solarized`, `rose`, `matcha`, `cloud`, `sepia`, `cloud_dancer`, `sakura_sand`, `olive_mist`, `terracotta_air`, `vanilla_sky`, `peach_fuzz_neo`, `coastal_drift`, `matcha_latte`
     - **Hybrid/Specialized:** `digital_lavender`, `neo_mint_system`, `sunset_gradient_pro`, `forest_sanctuary`
 - **Keybindings** — Rebind any keyboard shortcut
 - **View ordering** — Customize your task view tabs
 - **Sync settings** — Configure Git repository sync
+- **Plugins** — Toggle and manage your Lua plugins
 
 ---
 
@@ -372,115 +394,110 @@ UI Re-render → Instant User Feedback
 
 ```
 kairo/
-├── .github/
-│   ├── ISSUE_TEMPLATE/
-│   │   ├── bug_report.md
-│   │   └── feature_request.md
-│   ├── workflows/
-│   │   ├── ci.yml
-│   │   └── release.yml
-│   └── PULL_REQUEST_TEMPLATE.md
-├── cmd/
-│   └── kairo/
+├── CHANGELOG.md
+├── cmd
+│   └── kairo
 │       └── main.go
-├── internal/
-│   ├── api/
+├── CODE_OF_CONDUCT.md
+├── configs
+│   └── kairo.example.toml
+├── CONTRIBUTING.md
+├── go.mod
+├── go.sum
+├── internal
+│   ├── api
 │   │   └── api.go
-│   ├── app/
+│   ├── app
 │   │   ├── model.go
 │   │   └── msg.go
-│   ├── buildinfo/
+│   ├── buildinfo
 │   │   └── buildinfo.go
-│   ├── completion/
+│   ├── completion
 │   │   └── completion.go
-│   ├── config/
+│   ├── config
 │   │   ├── config.go
 │   │   └── config_test.go
-│   ├── core/
-│   │   ├── codec/
+│   ├── core
+│   │   ├── codec
 │   │   │   ├── json.go
 │   │   │   └── markdown.go
-│   │   ├── nlp/
-│   │   │   └── deadline.go
 │   │   ├── core_test.go
 │   │   ├── ids.go
+│   │   ├── nlp
+│   │   │   └── deadline.go
 │   │   ├── task.go
 │   │   └── view.go
-│   ├── hooks/
+│   ├── hooks
 │   │   └── hooks.go
-│   ├── lua/
+│   ├── lua
 │   │   └── engine.go
-│   ├── plugins/
+│   ├── plugins
 │   │   └── host.go
-│   ├── search/
+│   ├── search
 │   │   ├── fuzzy.go
 │   │   ├── fuzzy_test.go
 │   │   └── index.go
-│   ├── service/
+│   ├── service
 │   │   └── service.go
-│   ├── storage/
+│   ├── storage
 │   │   ├── migrations.go
 │   │   ├── repo.go
 │   │   └── repo_test.go
-│   ├── sync/
+│   ├── sync
 │   │   └── engine.go
-│   ├── ui/
-│   │   ├── detail/
+│   ├── ui
+│   │   ├── detail
 │   │   │   └── model.go
-│   │   ├── editor/
+│   │   ├── editor
 │   │   │   └── model.go
-│   │   ├── help/
+│   │   ├── help
 │   │   │   └── model.go
-│   │   ├── keymap/
+│   │   ├── keymap
 │   │   │   ├── keymap.go
 │   │   │   ├── keymap_test.go
 │   │   │   ├── normalize.go
 │   │   │   └── normalize_test.go
-│   │   ├── palette/
+│   │   ├── palette
 │   │   │   └── model.go
-│   │   ├── plugin_menu/
+│   │   ├── plugin_menu
 │   │   │   └── model.go
-│   │   ├── render/
+│   │   ├── render
 │   │   │   ├── easing.go
 │   │   │   └── render.go
-│   │   ├── styles/
+│   │   ├── settings
+│   │   │   └── model.go
+│   │   ├── styles
 │   │   │   └── styles.go
-│   │   ├── tasklist/
+│   │   ├── tasklist
 │   │   │   └── model.go
-│   │   ├── theme/
+│   │   ├── theme
 │   │   │   └── theme.go
-│   │   └── theme_menu/
+│   │   └── theme_menu
 │   │       └── model.go
-│   ├── updater/
+│   ├── updater
 │   │   ├── checksums.go
 │   │   ├── download.go
 │   │   ├── extract.go
 │   │   ├── github.go
 │   │   ├── updater.go
 │   │   └── windows_helper.go
-│   └── util/
+│   └── util
 │       ├── paths.go
 │       └── util_test.go
-├── plugins/
+├── LICENSE
+├── Makefile
+├── plugins
 │   ├── auto-cleanup.lua
 │   ├── auto-tagger.lua
 │   ├── sample.lua
 │   └── task-logger.lua
-├── screenshots/
+├── README.md
+├── screenshots
 │   └── demo.gif
-├── scripts/
+├── scripts
 │   ├── install.ps1
 │   └── install.sh
-├── local/
-│   └── demo_preset.json
-├── .gitignore
-├── .goreleaser.yaml
-├── CHANGELOG.md
-├── go.mod
-├── go.sum
-├── LICENSE
-├── Makefile
-├── README.md
+├── SECURITY.md
 └── VERSION.txt
 ```
 

Casks/kairo.rb

@@ -1 +1 @@
-1.2.2
+1.2.3