feat: implement onboarding system, add tag filter state management, and update version to 1.5.7

- closes #43
- closes #48
- closes #49

Author: programmersd21

CHANGELOG.md

@@ -26,8 +26,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Added `[projects] default = "project_name"` config to set startup project.
   - Added `<All Projects>` view to see tasks across all contexts.
   - Projects are now visible in the header and can be optionally displayed in the list view.
-  - Added per-tag color highlighting via `[tags.highlight]` in config.toml with `ui-*` theme alias support.
-  - Added `edit.preview` config option to persist the preview panel's default state.
+  - Added per-tag color highlighting via `[tags.highlight]` in config.toml with theme-aware alias support.  - Added `edit.preview` config option to persist the preview panel's default state.
   - Added task duplication with `D` shortcut; automatically opens edit mode on the duplicate.
   - Added Multi-Selection support:
     - Toggle task selection with `Space`.
@@ -144,7 +143,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- **Interactive Onboarding**: A complete, keyboard-driven welcome tour for new users with a "smooth af" animated slanted logo that cycles through theme colors. Teaches core navigation, task creation, and completion in under 60 seconds.
+* **Interactive Onboarding**: A complete, keyboard-driven welcome tour for new users with a "smooth af" animated slanted logo that cycles through theme colors. Teaches core navigation, task creation, completion, and now includes **Undo/Redo (ctrl+z/y)**.
 - **Onboarding Trigger**: Added `ctrl+d` as a global shortcut to relaunch the welcome tour at any time.
 - **Auto-Onboarding**: Kairo now automatically launches the welcome tour on new installations to ensure a smooth first-time experience.
 - **AI Assistant Polish**: The AI Assistant shortcut (`ctrl+a`), footer pill, and help menu entry are now fully disabled and hidden if no Gemini API key is configured, providing a cleaner interface for new users.

README.md

@@ -101,13 +101,13 @@ A Lua plugin system hooks into task events. A headless CLI API enables full scri
 Kairo now tracks your every move with a local history engine. Instantly reverse mistakes with `ctrl+z` or re-apply undone actions with `ctrl+y`. Supports task creation, deletion (including bulk), editing, and status changes. Everything is synchronized live with the database.
 
 ### 🎨 Tag Highlighting
-Color-code your tags directly in `config.toml`. Supports hex codes or theme-aware `ui-*` aliases (e.g., `ui-accent`).
+Color-code your tags directly in `config.toml`. Supports hex codes or theme-aware aliases (e.g., `accent`).
 
 ```toml
 [tags.highlight]
 work    = { fg = "#CCCCCC" }
 private = "fg=#EEEEEE,bg=#0000FF,bold"
-diy     = "bg=ui-accent"
+diy     = "bg=accent"
 ```
 
 ---
@@ -143,6 +143,7 @@ diy     = "bg=ui-accent"
   <img src="screenshots/settings_menu.png" width="30%" />
   <img src="screenshots/theme_menu.png" width="30%" />
   <img src="screenshots/dashboard.png" width="30%" />
+  <img src="screenshots/welcome_tour.png" width="30%" />
 </div>
 
 ---

VERSION.txt

@@ -1 +1 @@
-1.5.6
+1.5.7

internal/app/model.go

@@ -1003,6 +1003,21 @@ func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 				}
 				m.mode = ModeList
 				return m, m.deleteTasksCmd(ids)
+			case "t":
+				visible := m.list.GetVisibleTasks()
+				var ids []string
+				for _, item := range visible {
+					ids = append(ids, item.ID)
+				}
+				m.mode = ModeList
+				var animCmd tea.Cmd
+				if m.cfg.App.Animations {
+					m.transitioning = m.cfg.App.Animations
+					m.transitionStarted = time.Now()
+					m.animationGen++
+					animCmd = m.viewTransitionTickCmd()
+				}
+				return m, tea.Batch(m.deleteTasksCmd(ids), animCmd)
 			case "a":
 				m.mode = ModeList
 				var animCmd tea.Cmd
@@ -2035,7 +2050,7 @@ func (m *Model) renderFooter() string {
 		delLeft := m.s.TagLeft.Foreground(m.s.Theme.Bad).Render()
 		delRight := m.s.TagRight.Foreground(m.s.Theme.Bad).Render()
 		delPill := delLeft + m.s.BadgeDelete.Render("DELETE?") + delRight
-		left = " " + delPill + " " + makePill("y/enter confirm") + sep + makePill("a delete all") + sep + makePill("n/esc cancel")
+		left = " " + delPill + " " + makePill("y/enter confirm") + sep + makePill("t delete tab") + sep + makePill("a delete all") + sep + makePill("n/esc cancel")
 	case ModeConfirmQuit:
 		quitLeft := m.s.TagLeft.Foreground(m.s.Theme.Warn).Render()
 		quitRight := m.s.TagRight.Foreground(m.s.Theme.Warn).Render()

internal/lua/engine.go

@@ -61,7 +61,7 @@ func (e *Engine) SetupKairoAPI(L *lua.LState) {
 	L.SetField(kairo, "notify", L.NewFunction(e.luaNotify))
 
 	// Meta
-	L.SetField(kairo, "version", lua.LString("1.5.6"))
+	L.SetField(kairo, "version", lua.LString("1.5.7"))
 
 	// Set as global
 	L.SetGlobal("kairo", kairo)

internal/ui/onboarding/model.go

@@ -22,6 +22,7 @@ const (
 	StepAI
 	StepRecurring
 	StepAdvanced
+	StepUndoRedo
 	StepFinish
 )
 
@@ -118,6 +119,10 @@ func (m Model) Update(msg tea.Msg) (Model, tea.Cmd) {
 			}
 		case StepAdvanced:
 			if x.String() == "ctrl+s" {
+				m.step = StepUndoRedo
+			}
+		case StepUndoRedo:
+			if x.Type == tea.KeyCtrlZ || strings.EqualFold(x.String(), "ctrl+z") {
 				m.step = StepFinish
 			}
 		case StepFinish:
@@ -183,6 +188,10 @@ func (m Model) View() string {
 		title = "ADVANCED CONFIG"
 		body = "Fine-tune Kairo's behavior, themes, and keybindings in the Settings menu."
 		action = "Press [CTRL+S] for Settings"
+	case StepUndoRedo:
+		title = "UNDO & REDO"
+		body = "Made a mistake? Instantly reverse any action with Undo [CTRL+Z] or re-apply with Redo [CTRL+Y]."
+		action = "Press [CTRL+Z] to continue"
 	case StepFinish:
 		title = "YOU'RE ALL SET"
 		body = "You're now proficient with Kairo! Explore more via the palette [CTRL+P].\n\n(Tip: Relaunch tour anytime with [CTRL+W])"
@@ -218,7 +227,7 @@ func (m Model) View() string {
 }
 
 func (m Model) renderProgress() string {
-	steps := 9
+	steps := 10
 	var b strings.Builder
 	for i := 0; i < steps; i++ {
 		if i == int(m.step) {

internal/ui/theme/theme.go

@@ -18,35 +18,6 @@ type Theme struct {
 	Overlay lipgloss.Color
 }
 
-func (t Theme) GetColor(alias string) (lipgloss.Color, bool) {
-	switch alias {
-	case "ui-red":
-		return t.Bad, true
-	case "ui-green":
-		return t.Good, true
-	case "ui-yellow":
-		return t.Warn, true
-	case "ui-blue":
-		return t.Accent, true
-	case "ui-magenta":
-		return t.Bad, true // Fallback
-	case "ui-cyan":
-		return t.Accent, true // Fallback
-	case "ui-warn":
-		return t.Warn, true
-	case "ui-info":
-		return t.Accent, true
-	case "ui-error":
-		return t.Bad, true
-	case "ui-accent":
-		return t.Accent, true
-	case "ui-muted":
-		return t.Muted, true
-	default:
-		return "", false
-	}
-}
-
 // --- DARK THEMES ---
 
 var Catppuccin = Theme{