feat: implement initial project structure with core models, sqlite migrations, and UI theme styling

Author: programmersd21

CHANGELOG.md

@@ -5,6 +5,20 @@ 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).
 
+## [1.5.0]
+
+### Added
+- **Command Center Dashboard**: A next-generation interactive stats dashboard accessible via `s`.
+  - **Productivity DNA**: Visualizes task distribution across peak hours with theme-aware color mapping.
+  - **Momentum Engine**: Real-time momentum score calculation based on task completions and focus sessions over the last 3 days.
+  - **Behavioral Insights**: Data-driven, dynamic insights that automatically adapt to your task completion patterns and focus trends.
+  - **Activity Timeline**: Adaptive graph showing task completion trends, with intelligent rendering that cleans up labels when data is low.
+  - **Tag Intelligence**: Heatmap-style visualization of tag clusters, identifying your primary areas of focus.
+- **Deep Analytics Data Model**: 
+  - Added `completed_at` tracking to tasks for precise velocity metrics.
+  - Introduced `sessions` and `events` tables for granular focus and interaction logging.
+- **Premium UI Polish**: Keyboard-driven navigation, thick borders, and adaptive centered layouts that sync seamlessly with global theme colors.
+
 ## [1.4.3]
 ### Added
 - **Enhanced Data Portability**: All export and import formats (JSON, CSV, Markdown, Text) now fully support nested task hierarchies and folders.

README.md

@@ -86,6 +86,9 @@ Tasks reappear automatically on a schedule. Weekly (`mon,wed,fri`) or monthly (`
 ### 🔒 Your Data, Locally
 SQLite with WAL mode. Fully offline. Optional Git-backed sync — no backend, no account, no lock-in. Export to JSON, CSV, Markdown, or plain text on demand.
 
+### 🧭 Interactive Stats Dashboard
+Press `s` to open a next-gen "Command Center". Visualize your **Productivity DNA**, track real-time momentum, and get behavioral insights like "You complete 73% more tasks at night". Fully animated, keyboard-driven, and deeply insightful.
+
 ### 🤖 AI — Optional, Never Intrusive
 Gemini integration (`gemini-3.1-flash-lite-preview` / `gemini-2.5-flash-lite` / `gemini-2.0-flash-lite`). Toggle with `ctrl+a`. Create and manage complex recurring tasks with natural language. Invisible until you need it.
 
@@ -106,6 +109,7 @@ A Lua plugin system hooks into task events. A headless CLI API enables full scri
 | `z` | Complete task |
 | `d` | Delete task |
 | `Space` | Collapse / expand subtasks |
+| `s` | Stats dashboard |
 | `f` | Filter by tag |
 | `t` | Switch theme |
 | `ctrl+p` | Command palette / Markdown preview |
@@ -119,10 +123,8 @@ A Lua plugin system hooks into task events. A headless CLI API enables full scri
   <img src="screenshots/filter_tags.png" width="30%" />
   <img src="screenshots/help_menu.png" width="30%" />
   <img src="screenshots/settings_menu.png" width="30%" />
-</div>
-
-<div align="center">
   <img src="screenshots/theme_menu.png" width="30%" />
+  <img src="screenshots/dashboard.png" width="30%" />
 </div>
 
 ---

VERSION.txt

@@ -1 +1 @@
-1.4.3
+1.5.0

internal/app/model.go

@@ -25,6 +25,7 @@ import (
 	"github.com/programmersd21/kairo/internal/plugins"
 	"github.com/programmersd21/kairo/internal/search"
 	"github.com/programmersd21/kairo/internal/service"
+	istats "github.com/programmersd21/kairo/internal/stats"
 	ksync "github.com/programmersd21/kairo/internal/sync"
 	"github.com/programmersd21/kairo/internal/ui/ai_panel"
 	"github.com/programmersd21/kairo/internal/ui/detail"
@@ -37,6 +38,7 @@ import (
 	"github.com/programmersd21/kairo/internal/ui/plugin_menu"
 	"github.com/programmersd21/kairo/internal/ui/render"
 	"github.com/programmersd21/kairo/internal/ui/settings"
+	"github.com/programmersd21/kairo/internal/ui/stats"
 	"github.com/programmersd21/kairo/internal/ui/styles"
 	"github.com/programmersd21/kairo/internal/ui/tasklist"
 	"github.com/programmersd21/kairo/internal/ui/theme"
@@ -96,6 +98,7 @@ const (
 	ModeSettings
 	ModeImportExport
 	ModeOnboarding
+	ModeStats
 )
 
 type Model struct {
@@ -129,6 +132,7 @@ type Model struct {
 	pm         plugin_menu.Model
 	set        settings.Model
 	iem        import_export_menu.Model
+	stats      stats.Model
 	aiPanel    ai_panel.Model
 	aiClient   *ai.Client
 	aiKey      string
@@ -184,6 +188,20 @@ type Model struct {
 	animationGen int
 }
 
+type statsLoadedMsg struct {
+	Data istats.DashboardData
+}
+
+func (m *Model) loadStatsCmd() tea.Cmd {
+	return func() tea.Msg {
+		tasks, _ := m.svc.ListAll(m.ctx)
+		sessions, _ := m.svc.ListSessions(m.ctx)
+		events, _ := m.svc.ListEvents(m.ctx)
+		data := istats.ComputeDashboard(tasks, sessions, events)
+		return statsLoadedMsg{Data: data}
+	}
+}
+
 func (m *Model) rainbowTickCmd() tea.Cmd {
 	return tea.Tick(150*time.Millisecond, func(time.Time) tea.Msg {
 		return rainbowTickMsg{}
@@ -230,6 +248,7 @@ func New(ctx context.Context, cfg config.Config, svc service.TaskService) (tea.M
 	m.pm = plugin_menu.New(m.s)
 	m.set = settings.New(m.s, cfg)
 	m.iem = import_export_menu.New(m.s)
+	m.stats = stats.New(m.s)
 	m.aiPanel = ai_panel.New(m.s)
 	m.aiChan = make(chan ai_panel.AIChunkMsg, 100)
 	m.aiKey = cfg.App.GeminiAPIKey
@@ -443,6 +462,10 @@ func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		m.rebuildPaletteIndex()
 		return m, nil
 
+	case statsLoadedMsg:
+		m.stats.SetData(x.Data)
+		return m, nil
+
 	case allTasksLoadedMsg:
 		m.all = x.Tasks
 		m.list.SetAllTasks(m.all)
@@ -1147,6 +1170,16 @@ func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 					}
 					return m, nil
 				}
+				if keymapMatch(m.km.Stats, km) {
+					m.mode = ModeStats
+					var animCmd tea.Cmd
+					if m.cfg.App.Animations {
+						m.transitioning = m.cfg.App.Animations
+						m.transitionStarted = time.Now()
+						animCmd = m.viewTransitionTickCmd()
+					}
+					return m, tea.Batch(m.loadStatsCmd(), m.stats.Init(), animCmd)
+				}
 			}
 
 			if m.mode == ModeList {
@@ -1239,6 +1272,9 @@ func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 						t := item.Task
 						m.animationGen++
 						m.animationReverse = (t.Status == core.StatusDone)
+						m.animatingTaskID = t.ID
+						m.animationStarted = time.Now()
+						m.animationDuration = 600 * time.Millisecond
 						if m.cfg.App.Animations {
 							return m, m.strikeAnimationTickCmd(t.ID)
 						}
@@ -1277,6 +1313,9 @@ func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 					t := m.det.Task()
 					m.animationGen++
 					m.animationReverse = (t.Status == core.StatusDone)
+					m.animatingTaskID = t.ID
+					m.animationStarted = time.Now()
+					m.animationDuration = 600 * time.Millisecond
 					if m.cfg.App.Animations {
 						return m, m.strikeAnimationTickCmd(t.ID)
 					}
@@ -1374,6 +1413,21 @@ func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		var cmd tea.Cmd
 		m.onb, cmd = m.onb.Update(msg)
 		return m, cmd
+	case ModeStats:
+		if km, ok := msg.(tea.KeyMsg); ok {
+			if keymapMatch(m.km.Back, km) || km.String() == "q" {
+				m.mode = ModeList
+				if m.cfg.App.Animations {
+					m.transitioning = m.cfg.App.Animations
+					m.transitionStarted = time.Now()
+					return m, m.viewTransitionTickCmd()
+				}
+				return m, nil
+			}
+		}
+		var cmd tea.Cmd
+		m.stats, cmd = m.stats.Update(msg)
+		return m, cmd
 	}
 
 	return m, nil
@@ -1447,6 +1501,7 @@ func (m *Model) renderMainUI() string {
 	m.hlp.AIEnabled = m.aiKey != ""
 	m.tm.SetSize(mainW, availableHeight)
 	m.iem.SetSize(mainW, availableHeight)
+	m.stats.SetSize(mainW, availableHeight)
 	if m.edit != nil {
 		m.edit.SetSize(mainW, availableHeight)
 	}
@@ -1488,6 +1543,8 @@ func (m *Model) renderMainUI() string {
 		}
 	case ModeImportExport:
 		body = m.iem.View()
+	case ModeStats:
+		body = m.stats.View()
 	case ModeOnboarding:
 		body = m.list.View()
 	default:
@@ -1874,6 +1931,7 @@ func (m *Model) renderFooter() string {
 					makePill(fk(m.km.NewTask) + " " + styles.IconNew + "new"),
 					makePill("f " + styles.IconTag + "tag"),
 					makePill(fk(m.km.ToggleStrike) + " " + styles.IconStrike + "done"),
+					makePill(fk(m.km.Stats) + " stats"),
 					makePill(fk(m.km.DeleteTask) + " " + styles.IconDelete + "delete"),
 					makePill(fk(m.km.Settings) + " settings"),
 				}

internal/config/config.go

@@ -93,6 +93,7 @@ type KeymapConfig struct {
 	Settings       string `toml:"settings"`
 	ImportExport   string `toml:"import_export"`
 	AIPanelToggle  string `toml:"ai_panel_toggle"`
+	Stats          string `toml:"stats"`
 }
 
 func Default() Config {
@@ -161,6 +162,7 @@ func Default() Config {
 			Settings:       "ctrl+s",
 			ImportExport:   "x",
 			AIPanelToggle:  "ctrl+a",
+			Stats:          "s",
 		},
 	}
 }
@@ -302,6 +304,9 @@ func Load() (Config, error) {
 	if cfg.Keymap.ImportExport == "" {
 		cfg.Keymap.ImportExport = defaults.Keymap.ImportExport
 	}
+	if cfg.Keymap.Stats == "" {
+		cfg.Keymap.Stats = defaults.Keymap.Stats
+	}
 
 	appDir, _ := util.AppDataDir(appName)
 

internal/core/stats.go

@@ -0,0 +1,26 @@
+package core
+
+import "time"
+
+type Session struct {
+	ID         string
+	StartTime  time.Time
+	EndTime    *time.Time
+	FocusScore int
+}
+
+type Event struct {
+	ID        int64
+	Type      string
+	TaskID    string
+	Timestamp time.Time
+	Metadata  string
+}
+
+const (
+	EventTypeTaskCreated   = "task_created"
+	EventTypeTaskCompleted = "task_completed"
+	EventTypeTaskDeleted   = "task_deleted"
+	EventTypeAppOpened     = "app_opened"
+	EventTypeStatsOpened   = "stats_opened"
+)

internal/core/task.go

@@ -77,6 +77,7 @@ type Task struct {
 	Collapsed         bool
 	CreatedAt         time.Time
 	UpdatedAt         time.Time
+	CompletedAt       *time.Time
 }
 
 func (t Task) NormalizedTags() []string {
@@ -144,6 +145,7 @@ type TaskPatch struct {
 	RecurrenceMonthly *int
 	ParentID          *string
 	Collapsed         *bool
+	CompletedAt       **time.Time
 }
 
 func (p TaskPatch) ApplyTo(t Task) Task {
@@ -180,6 +182,9 @@ func (p TaskPatch) ApplyTo(t Task) Task {
 	if p.Collapsed != nil {
 		t.Collapsed = *p.Collapsed
 	}
+	if p.CompletedAt != nil {
+		t.CompletedAt = *p.CompletedAt
+	}
 	return t
 }
 
@@ -199,12 +204,18 @@ func (t Task) MarshalJSON() ([]byte, error) {
 		Collapsed         bool      `json:"collapsed,omitempty"`
 		CreatedAt         time.Time `json:"created_at"`
 		UpdatedAt         time.Time `json:"updated_at"`
+		CompletedAt       *string   `json:"completed_at,omitempty"`
 	}
 	var d *string
 	if t.Deadline != nil {
 		s := t.Deadline.UTC().Format(time.RFC3339Nano)
 		d = &s
 	}
+	var c *string
+	if t.CompletedAt != nil {
+		s := t.CompletedAt.UTC().Format(time.RFC3339Nano)
+		c = &s
+	}
 	return json.Marshal(wire{
 		ID:                t.ID,
 		Title:             t.Title,
@@ -220,5 +231,6 @@ func (t Task) MarshalJSON() ([]byte, error) {
 		Collapsed:         t.Collapsed,
 		CreatedAt:         t.CreatedAt.UTC(),
 		UpdatedAt:         t.UpdatedAt.UTC(),
+		CompletedAt:       c,
 	})
 }

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

internal/service/service.go

@@ -57,6 +57,15 @@ type TaskService interface {
 	// Prune performs a hard delete of soft-deleted tasks and optimizes the database.
 	Prune(ctx context.Context) error
 
+	// Sessions
+	CreateSession(ctx context.Context, session core.Session) error
+	UpdateSession(ctx context.Context, id string, endTime time.Time, focusScore int) error
+	ListSessions(ctx context.Context) ([]core.Session, error)
+
+	// Events
+	LogEvent(ctx context.Context, event core.Event) error
+	ListEvents(ctx context.Context) ([]core.Event, error)
+
 	// Hooks returns the event manager for this service.
 	Hooks() *hooks.Manager
 
@@ -239,3 +248,26 @@ func (s *taskService) Prune(ctx context.Context) error {
 	}
 	return nil
 }
+
+func (s *taskService) CreateSession(ctx context.Context, session core.Session) error {
+	return s.repo.CreateSession(ctx, session)
+}
+
+func (s *taskService) UpdateSession(ctx context.Context, id string, endTime time.Time, focusScore int) error {
+	return s.repo.UpdateSession(ctx, id, endTime, focusScore)
+}
+
+func (s *taskService) ListSessions(ctx context.Context) ([]core.Session, error) {
+	return s.repo.ListSessions(ctx)
+}
+
+func (s *taskService) LogEvent(ctx context.Context, event core.Event) error {
+	if event.Timestamp.IsZero() {
+		event.Timestamp = time.Now()
+	}
+	return s.repo.CreateEvent(ctx, event)
+}
+
+func (s *taskService) ListEvents(ctx context.Context) ([]core.Event, error) {
+	return s.repo.ListEvents(ctx)
+}