feat: implement robust configuration system and initial application structure for version 1.5.4

- closes #34

Author: programmersd21

CHANGELOG.md

@@ -5,6 +5,16 @@ 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.4]
+
+### Added
+- Minimal Due Text Mode: A new toggleable field mode that abbreviates "overdue" to "OD" and uses a fixed-width column for perfect task list alignment.
+- Configuration for due field: Added `[list.fields.due] minimal = true` to `config.toml`.
+- Settings Toggle: Added "Minimal Due Text" toggle to the settings menu (ctrl+s) for live configuration.
+
+### Improved
+- Task List Alignment: When minimal mode is enabled, the due column width is automatically calculated across all visible tasks to ensure consistent left-alignment.
+
 ## [1.5.3]
 
 ### Fixed

README.md

@@ -218,6 +218,11 @@ right = ["tags", "due", "priority"]
 Valid values for `right` are: `tags`, `due`, `priority`.
 
 ### Task Fields
+*   **Minimal Due Mode**: Abbreviate "overdue" to "OD" and use a fixed-width column for consistent task list alignment. Enabled by default.
+    ```toml
+    [list.fields.due]
+    minimal = true
+    ```
 *   **wait_until**: Hide a task from the task list until the specified datetime. If the task is recurring, new instances are not generated/shown until `wait_until` has passed. Format: `yyyy-MM-dd HH:mm`.
 *   **until**: Stop generating new recurring instances after the specified datetime. Existing instances may remain visible. Format: `yyyy-MM-dd HH:mm`.
 

VERSION.txt

@@ -1 +1 @@
-1.5.3
+1.5.4

configs/kairo.example.toml

@@ -33,6 +33,11 @@ onboarding_completed = false
 # Valid values: "tags", "due", "priority"
 right = ["tags", "due", "priority"]
 
+[list.fields.due]
+# Enable minimal mode for the due date field (default: true).
+# Abbreviates "overdue" to "OD" and aligns the column.
+minimal = true
+
 [theme]
 # Any field set here overrides the built-in theme colors.
 # bg = "#0B0F14"

internal/app/model.go

@@ -240,7 +240,7 @@ func New(ctx context.Context, cfg config.Config, svc service.TaskService) (tea.M
 		tagFilterInput:         tagInput,
 		RainbowAnimationOffset: 0,
 	}
-	m.list = tasklist.New(m.s, cfg.App.VimMode, cfg.App.Animations, m.km)
+	m.list = tasklist.New(m.s, cfg.App.VimMode, cfg.App.Animations, m.km, cfg.List.Fields.Due.Minimal)
 	m.list.SetRightOrder(cfg.List.Order.Right)
 	m.pal = palette.New(m.s)
 	m.det = detail.New(m.s)
@@ -2280,7 +2280,7 @@ func (m *Model) fetchOpenEditCmd(id string) tea.Cmd {
 
 func (m *Model) refreshStyles() {
 	m.s = styles.New(m.theme)
-	m.list = tasklist.New(m.s, m.cfg.App.VimMode, m.cfg.App.Animations, m.km)
+	m.list = tasklist.New(m.s, m.cfg.App.VimMode, m.cfg.App.Animations, m.km, m.cfg.List.Fields.Due.Minimal)
 	m.list.SetRightOrder(m.cfg.List.Order.Right)
 	m.list.SetTasks(m.tasks)
 	m.list.SetAllTasks(m.all)

internal/config/config.go

@@ -23,7 +23,16 @@ type Config struct {
 }
 
 type ListConfig struct {
-	Order ListOrderConfig `toml:"order"`
+	Order  ListOrderConfig  `toml:"order"`
+	Fields ListFieldsConfig `toml:"fields"`
+}
+
+type ListFieldsConfig struct {
+	Due DueFieldConfig `toml:"due"`
+}
+
+type DueFieldConfig struct {
+	Minimal bool `toml:"minimal"`
 }
 
 type ListOrderConfig struct {
@@ -152,6 +161,11 @@ func Default() Config {
 			Order: ListOrderConfig{
 				Right: []string{"tags", "due", "priority"},
 			},
+			Fields: ListFieldsConfig{
+				Due: DueFieldConfig{
+					Minimal: true,
+				},
+			},
 		},
 		Theme: ThemeConfig{
 			Bg:      "", // Use theme default

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

internal/ui/settings/model.go

@@ -57,6 +57,7 @@ func (m *Model) rebuildItems() {
 		{"Auto Push (Git)", "auto_push", "bool", m.cfg.Sync.AutoPush},
 		{"MCP Server Enabled", "mcp_enabled", "bool", m.cfg.App.MCPEnabled},
 		{"Animations", "animations", "bool", m.cfg.App.Animations},
+		{"Minimal Due Text", "minimal_due", "bool", m.cfg.List.Fields.Due.Minimal},
 		{"AI Model (←/→)", "ai_model", "enum", m.cfg.App.AIModel},
 		{"Gemini API Key", "gemini_api_key", "string", m.cfg.App.GeminiAPIKey},
 		{"AI Assistant Shortcut", "ai_toggle", "string", m.cfg.Keymap.AIPanelToggle},
@@ -186,6 +187,8 @@ func (m Model) Update(msg tea.Msg) (Model, tea.Cmd) {
 					m.cfg.App.MCPEnabled = val
 				case "animations":
 					m.cfg.App.Animations = val
+				case "minimal_due":
+					m.cfg.List.Fields.Due.Minimal = val
 				}
 				m.rebuildItems()
 				// Save config immediately and notify app

internal/ui/tasklist/model.go

@@ -50,16 +50,19 @@ type Model struct {
 	DeletingTaskID string
 	DeleteProgress float64
 
+	DueMinimal bool
+
 	lastKey string // For tracking key sequences like 'gg'
 }
 
-func New(s styles.Styles, vimMode bool, animations bool, km keymap.Keymap) Model {
+func New(s styles.Styles, vimMode bool, animations bool, km keymap.Keymap, dueMinimal bool) Model {
 	return Model{
 		styles:     s,
 		vimMode:    vimMode,
 		Animations: animations,
 		km:         km,
 		rightOrder: []string{"tags", "due", "priority"},
+		DueMinimal: dueMinimal,
 	}
 }
 
@@ -279,6 +282,21 @@ func (m Model) View() string {
 	start := clamp(m.sel-visible/2, 0, max(0, len(m.items)-visible))
 	end := min(len(m.items), start+visible)
 
+	maxDueWidth := 0
+	if m.DueMinimal {
+		for i := start; i < end; i++ {
+			item := m.items[i]
+			if item.Deadline != nil {
+				d := humanDeadline(*item.Deadline, time.Now())
+				d = formatDue(d, true)
+				w := lipgloss.Width(styles.IconDeadline + d)
+				if w > maxDueWidth {
+					maxDueWidth = w
+				}
+			}
+		}
+	}
+
 	lines := make([]string, 0, visible)
 	for i := start; i < end; i++ {
 		item := m.items[i]
@@ -298,7 +316,7 @@ func (m Model) View() string {
 			}
 		}
 
-		line := m.renderRow(item, i == m.sel)
+		line := m.renderRow(item, i == m.sel, maxDueWidth)
 		lines = append(lines, line)
 	}
 
@@ -392,7 +410,7 @@ func (m Model) renderEmpty() string {
 		Align(lipgloss.Center, lipgloss.Center).
 		Render(m.styles.Overlay.Width(boxWidth).Padding(2).Render(dashboard))
 }
-func (m Model) renderRow(item TaskItem, selected bool) string {
+func (m Model) renderRow(item TaskItem, selected bool, maxDueWidth int) string {
 	t := item.Task
 	// Compute animation progress for strike (completion toggle).
 	// Progress is always clamped to [0, 1] — no overshoot.
@@ -544,7 +562,7 @@ func (m Model) renderRow(item TaskItem, selected bool) string {
 					deadStyleColor = m.styles.Theme.Bad
 				}
 
-				dueContent := styles.IconDeadline + deadText
+				dueContent := styles.IconDeadline + formatDue(deadText, m.DueMinimal)
 
 				// Create pill badge for due date
 				badge := m.styles.BadgeMuted.
@@ -557,6 +575,11 @@ func (m Model) renderRow(item TaskItem, selected bool) string {
 					badge.Background(deadStyleColor).Render(dueContent),
 					m.styles.TagRight.Foreground(deadStyleColor).Render(),
 				)
+
+				if m.DueMinimal && maxDueWidth > 0 {
+					// container width = max content width + padding (2) + caps (2)
+					pill = lipgloss.NewStyle().Width(maxDueWidth + 4).Align(lipgloss.Left).Render(pill)
+				}
 				rightParts = append(rightParts, pill)
 			}
 		case "tags":
@@ -673,6 +696,13 @@ func humanDeadline(t time.Time, now time.Time) string {
 	return fmt.Sprintf("%dd", int(d.Hours()/24))
 }
 
+func formatDue(due string, minimal bool) string {
+	if !minimal {
+		return due
+	}
+	return strings.ReplaceAll(due, "overdue", "OD")
+}
+
 func clamp(x, lo, hi int) int {
 	if x < lo {
 		return lo