feat(ui): add project status filters and compact nav hints

Improve project triage by adding completed/abandoned/settled visibility toggles that keep inactive work out of the default list when desired.
Rework nav-mode status hints to be state-first and width-aware so operators keep key discoverability without a noisy, overflowing status bar.

Closes #24
Closes #72
Closes #73

Author: cpcloud

docs/content/guide/projects.md

@@ -44,6 +44,14 @@ Projects move through these statuses. Each has a distinct color in the table:
 - <span class="status-completed">**completed**</span> -- done
 - <span class="status-abandoned">**abandoned**</span> -- decided not to do it
 
+## Status filters
+
+In Normal mode on the Projects tab:
+
+- Press `z` to toggle hiding projects with status `completed`
+- Press `a` to toggle hiding projects with status `abandoned`
+- Press `t` to toggle hiding **settled projects** (`completed` + `abandoned`)
+
 ## Description
 
 The edit form includes a `Description` textarea (in the "Timeline" group) for

docs/content/reference/keybindings.md

@@ -45,6 +45,9 @@ Complete reference of every keybinding in micasa, organized by mode.
 |-----|--------|
 | `s` | Cycle sort on current column (none -> asc -> desc -> none) |
 | `S` | Clear all sorts |
+| `z` | Projects tab: toggle hiding completed projects |
+| `a` | Projects tab: toggle hiding abandoned projects |
+| `t` | Projects tab: toggle hiding settled projects (`completed` + `abandoned`) |
 | `/` | Jump to column (fuzzy find) |
 | `c` | Hide current column |
 | `C` | Show all hidden columns |

images/demo.gif

@@ -146,6 +146,188 @@ func TestProjectHandlerSnapshot(t *testing.T) {
 	}
 }
 
+func TestProjectTabStatusFiltersRows(t *testing.T) {
+	m := newTestModelWithStore(t)
+	types, _ := m.store.ProjectTypes()
+
+	for _, p := range []data.Project{
+		{
+			Title:         "Kitchen Plan",
+			ProjectTypeID: types[0].ID,
+			Status:        data.ProjectStatusPlanned,
+		},
+		{
+			Title:         "Fence Done",
+			ProjectTypeID: types[0].ID,
+			Status:        data.ProjectStatusCompleted,
+		},
+		{
+			Title:         "Basement Work",
+			ProjectTypeID: types[0].ID,
+			Status:        data.ProjectStatusInProgress,
+		},
+		{
+			Title:         "Old Patio Idea",
+			ProjectTypeID: types[0].ID,
+			Status:        data.ProjectStatusAbandoned,
+		},
+	} {
+		if err := m.store.CreateProject(p); err != nil {
+			t.Fatalf("CreateProject(%q): %v", p.Title, err)
+		}
+	}
+
+	m.active = tabIndex(tabProjects)
+	if err := m.reloadActiveTab(); err != nil {
+		t.Fatalf("reloadActiveTab: %v", err)
+	}
+	tab := m.activeTab()
+	if tab == nil {
+		t.Fatal("expected active projects tab")
+	}
+	if len(tab.Rows) != 4 {
+		t.Fatalf("expected 4 rows before filtering, got %d", len(tab.Rows))
+	}
+
+	tab.HideCompleted = true
+	if err := m.reloadActiveTab(); err != nil {
+		t.Fatalf("reloadActiveTab with HideCompleted: %v", err)
+	}
+	if len(tab.Rows) != 3 {
+		t.Fatalf("expected 3 rows with completed hidden, got %d", len(tab.Rows))
+	}
+	for i, cells := range tab.CellRows {
+		if len(cells) > 3 && cells[3].Value == data.ProjectStatusCompleted {
+			t.Fatalf("row %d still has completed status after filtering", i)
+		}
+	}
+
+	tab.HideCompleted = false
+	tab.HideAbandoned = true
+	if err := m.reloadActiveTab(); err != nil {
+		t.Fatalf("reloadActiveTab with HideAbandoned: %v", err)
+	}
+	if len(tab.Rows) != 3 {
+		t.Fatalf("expected 3 rows with abandoned hidden, got %d", len(tab.Rows))
+	}
+	for i, cells := range tab.CellRows {
+		if len(cells) > 3 && cells[3].Value == data.ProjectStatusAbandoned {
+			t.Fatalf("row %d still has abandoned status after filtering", i)
+		}
+	}
+
+	tab.HideAbandoned = false
+	tab.HideCompleted = true
+	tab.HideAbandoned = true
+	if err := m.reloadActiveTab(); err != nil {
+		t.Fatalf("reloadActiveTab with settled filters: %v", err)
+	}
+	if len(tab.Rows) != 2 {
+		t.Fatalf("expected 2 rows with settled hidden, got %d", len(tab.Rows))
+	}
+	for i, cells := range tab.CellRows {
+		if len(cells) <= 3 {
+			continue
+		}
+		status := cells[3].Value
+		if status == data.ProjectStatusCompleted || status == data.ProjectStatusAbandoned {
+			t.Fatalf("row %d still has settled status %q after filtering", i, status)
+		}
+	}
+
+	tab.HideCompleted = false
+	tab.HideAbandoned = false
+	if err := m.reloadActiveTab(); err != nil {
+		t.Fatalf("reloadActiveTab after clearing filters: %v", err)
+	}
+	if len(tab.Rows) != 4 {
+		t.Fatalf("expected 4 rows after showing all projects, got %d", len(tab.Rows))
+	}
+}
+
+func TestProjectStatusFilterToggleKeysReloadRows(t *testing.T) {
+	m := newTestModelWithStore(t)
+	types, _ := m.store.ProjectTypes()
+
+	if err := m.store.CreateProject(data.Project{
+		Title:         "Done Project",
+		ProjectTypeID: types[0].ID,
+		Status:        data.ProjectStatusCompleted,
+	}); err != nil {
+		t.Fatalf("CreateProject completed: %v", err)
+	}
+	if err := m.store.CreateProject(data.Project{
+		Title:         "Live Project",
+		ProjectTypeID: types[0].ID,
+		Status:        data.ProjectStatusInProgress,
+	}); err != nil {
+		t.Fatalf("CreateProject in-progress: %v", err)
+	}
+	if err := m.store.CreateProject(data.Project{
+		Title:         "Abandoned Project",
+		ProjectTypeID: types[0].ID,
+		Status:        data.ProjectStatusAbandoned,
+	}); err != nil {
+		t.Fatalf("CreateProject abandoned: %v", err)
+	}
+
+	m.active = tabIndex(tabProjects)
+	if err := m.reloadActiveTab(); err != nil {
+		t.Fatalf("reloadActiveTab: %v", err)
+	}
+	if got := len(m.activeTab().Rows); got != 3 {
+		t.Fatalf("expected 3 rows before toggles, got %d", got)
+	}
+
+	sendKey(m, "z")
+	if got := len(m.activeTab().Rows); got != 2 {
+		t.Fatalf("expected 2 rows after hiding completed, got %d", got)
+	}
+	if m.activeTab().HideCompleted != true {
+		t.Fatal("HideCompleted should be enabled after first toggle")
+	}
+
+	sendKey(m, "a")
+	if got := len(m.activeTab().Rows); got != 1 {
+		t.Fatalf("expected 1 row after hiding abandoned too, got %d", got)
+	}
+	if !m.activeTab().HideAbandoned {
+		t.Fatal("HideAbandoned should be enabled after toggle")
+	}
+
+	sendKey(m, "t")
+	if got := len(m.activeTab().Rows); got != 3 {
+		t.Fatalf("expected 3 rows after clearing settled filters, got %d", got)
+	}
+	if m.activeTab().HideCompleted || m.activeTab().HideAbandoned {
+		t.Fatal("settled toggle should disable both filters when both are active")
+	}
+
+	sendKey(m, "t")
+	if got := len(m.activeTab().Rows); got != 1 {
+		t.Fatalf("expected 1 row after settled-only filter, got %d", got)
+	}
+	if !m.activeTab().HideCompleted || !m.activeTab().HideAbandoned {
+		t.Fatal("settled toggle should enable both filters")
+	}
+
+	sendKey(m, "z")
+	if m.activeTab().HideCompleted {
+		t.Fatal("HideCompleted should be disabled after toggling z")
+	}
+	if got := len(m.activeTab().Rows); got != 2 {
+		t.Fatalf("expected 2 rows when only abandoned filter is active, got %d", got)
+	}
+
+	sendKey(m, "a")
+	if m.activeTab().HideAbandoned {
+		t.Fatal("HideAbandoned should be disabled after toggling a")
+	}
+	if got := len(m.activeTab().Rows); got != 3 {
+		t.Fatalf("expected 3 rows after clearing individual filters, got %d", got)
+	}
+}
+
 // ---------------------------------------------------------------------------
 // applianceHandler CRUD
 // ---------------------------------------------------------------------------

internal/app/handler_crud_test.go

@@ -365,13 +365,86 @@ func TestEscClearsStatusInNormalMode(t *testing.T) {
 	}
 }
 
+func TestProjectStatusFilterToggleKeys(t *testing.T) {
+	m := newTestModel()
+	tab := m.activeTab()
+	if tab == nil || tab.Kind != tabProjects {
+		t.Fatal("expected projects tab to be active")
+	}
+	if tab.HideCompleted || tab.HideAbandoned {
+		t.Fatal("project status filters should start disabled")
+	}
+
+	sendKey(m, "z")
+	if !tab.HideCompleted {
+		t.Fatal("expected HideCompleted enabled after first z")
+	}
+	if m.status.Text != "Completed projects hidden." {
+		t.Fatalf("unexpected status after hide: %q", m.status.Text)
+	}
+
+	sendKey(m, "z")
+	if tab.HideCompleted {
+		t.Fatal("expected HideCompleted disabled after second z")
+	}
+	if m.status.Text != "Completed projects shown." {
+		t.Fatalf("unexpected status after show: %q", m.status.Text)
+	}
+
+	sendKey(m, "a")
+	if !tab.HideAbandoned {
+		t.Fatal("expected HideAbandoned enabled after first a")
+	}
+	if m.status.Text != "Abandoned projects hidden." {
+		t.Fatalf("unexpected status after hide abandoned: %q", m.status.Text)
+	}
+	sendKey(m, "a")
+	if tab.HideAbandoned {
+		t.Fatal("expected HideAbandoned disabled after second a")
+	}
+
+	sendKey(m, "t")
+	if !tab.HideCompleted || !tab.HideAbandoned {
+		t.Fatal("expected settled toggle to enable both completed and abandoned filters")
+	}
+	if m.status.Text != "Settled projects hidden." {
+		t.Fatalf("unexpected status after hide settled: %q", m.status.Text)
+	}
+	sendKey(m, "t")
+	if tab.HideCompleted || tab.HideAbandoned {
+		t.Fatal("expected settled toggle to disable both filters on second press")
+	}
+}
+
+func TestProjectStatusFilterToggleIgnoredOutsideProjects(t *testing.T) {
+	m := newTestModel()
+	m.active = tabIndex(tabQuotes)
+	tab := m.activeTab()
+	if tab == nil || tab.Kind != tabQuotes {
+		t.Fatal("expected quotes tab to be active")
+	}
+
+	for _, key := range []string{"z", "a", "t"} {
+		_, handled := m.handleNormalKeys(tea.KeyMsg{Type: tea.KeyRunes, Runes: []rune(key)})
+		if handled {
+			t.Fatalf("expected %s to be ignored outside projects tab", key)
+		}
+	}
+	if tab.HideCompleted || tab.HideAbandoned {
+		t.Fatal("project status filters should remain disabled on non-project tabs")
+	}
+	if m.status.Text != "" {
+		t.Fatalf("expected no status change, got %q", m.status.Text)
+	}
+}
+
 func TestKeyDispatchEditModeOnly(t *testing.T) {
 	m := newTestModel()
 
-	// 'a' should not be handled in normal mode.
-	_, handled := m.handleNormalKeys(tea.KeyMsg{Type: tea.KeyRunes, Runes: []rune("a")})
+	// 'p' should not be handled in normal mode.
+	_, handled := m.handleNormalKeys(tea.KeyMsg{Type: tea.KeyRunes, Runes: []rune("p")})
 	if handled {
-		t.Fatal("'a' should not be handled in normal mode")
+		t.Fatal("'p' should not be handled in normal mode")
 	}
 
 	// 'esc' should be handled in edit mode (back to normal).