feat: implement Lua plugin engine and add help and onboarding UI models

Author: programmersd21

CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## v1.6.1 (2026-05-09)
+
+### Added
+* **Onboarding Enhancement**: Added "Filter by Tag" step to the Welcome Tour.
+* **Help Menu Clarity**: Included the Focus Engine and updated Filter by Tag shortcuts in the in-app help screen.
+
+### Changed
+* **Shortcut Synchronization**: Standardized documentation across TUI help, Welcome Tour, and README to reflect the new `f` (Focus) and `ctrl+f` (Filter) keybindings.
+
 ## v1.6.0 (2026-05-09)
 
 ### Added

VERSION.txt

@@ -1 +1 @@
-1.6.0
+1.6.1

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.6.0"))
+	L.SetField(kairo, "version", lua.LString("1.6.1"))
 
 	// Set as global
 	L.SetGlobal("kairo", kairo)

internal/ui/help/model.go

@@ -100,7 +100,8 @@ func (m Model) View() string {
 			"Navigation",
 			[]struct{ key, desc string }{
 				{"1-9", styles.IconView + "Switch views (tabs)"},
-				{"f", styles.IconTag + "Filter by tag (Tag view)"},
+				{"f", "󰔟 " + "Focus engine"},
+				{"ctrl+f", styles.IconTag + "Filter by tag (Tag view)"},
 				{getK(m.km.OpenTask), styles.IconView + "View task details"},
 				{getK(m.km.ProjectSwitcher), "󰜎 " + "Switch project"},
 				{getK(m.km.Back), "󰌍 " + "Back / Close"},

internal/ui/onboarding/model.go

@@ -18,6 +18,7 @@ const (
 	StepNavigation
 	StepCreation
 	StepCompletion
+	StepFilter
 	StepDashboard
 	StepAI
 	StepRecurring
@@ -102,6 +103,10 @@ func (m Model) Update(msg tea.Msg) (Model, tea.Cmd) {
 			}
 		case StepCompletion:
 			if x.String() == "z" {
+				m.step = StepFilter
+			}
+		case StepFilter:
+			if x.Type == tea.KeyCtrlF || strings.EqualFold(x.String(), "ctrl+f") {
 				m.step = StepDashboard
 			}
 		case StepDashboard:
@@ -177,6 +182,10 @@ func (m Model) View() string {
 		title = "MARK AS DONE"
 		body = "The best part of productivity is checking things off."
 		action = "Press [Z] to complete a task"
+	case StepFilter:
+		title = "ORGANIZE BY TAG"
+		body = "Keep your tasks categorized and find what you need instantly."
+		action = "Press [CTRL+F] to filter by tag"
 	case StepDashboard:
 		title = "COMMAND CENTER"
 		body = "Analyze your productivity, momentum, and focus trends in the Command Center."
@@ -236,7 +245,7 @@ func (m Model) View() string {
 }
 
 func (m Model) renderProgress() string {
-	steps := 11
+	steps := 12
 	var b strings.Builder
 	for i := 0; i < steps; i++ {
 		if i == int(m.step) {