feat!: rename 'backlog' status to 'draft'

hmans · hmans · commit 3673945aed10 · 2025-12-13T03:01:45.000+01:00
- Rename status from "backlog" to "draft" to better communicate that
  these beans need refinement before being actionable
- Update prompt.tmpl to exclude "draft" from actionable beans query
- Migrate all existing beans from backlog to draft
- Update all tests
diff --git a/.beans/beans-8olg--add-unblocked-filter-to-find-actionable-beans.md b/.beans/beans-8olg--add-unblocked-filter-to-find-actionable-beans.md
@@ -1,6 +1,6 @@
 ---
 title: Add --unblocked filter to find actionable beans
-status: backlog
+status: draft
 type: feature
 tags:
     - cli
diff --git a/.beans/beans-digu--support-custom-properties-on-beans.md b/.beans/beans-digu--support-custom-properties-on-beans.md
@@ -1,6 +1,6 @@
 ---
 title: Support custom properties on beans
-status: backlog
+status: draft
 type: feature
 created_at: 2025-12-13T00:52:24Z
 updated_at: 2025-12-13T00:52:24Z
diff --git a/.beans/beans-iggk--add-beans-graph-command-for-relationship-visualiza.md b/.beans/beans-iggk--add-beans-graph-command-for-relationship-visualiza.md
@@ -1,6 +1,6 @@
 ---
 title: Add beans graph command for relationship visualization
-status: backlog
+status: draft
 type: feature
 priority: normal
 tags:
diff --git a/.beans/beans-ikw9--beans-release-release-management-integration.md b/.beans/beans-ikw9--beans-release-release-management-integration.md
@@ -1,6 +1,6 @@
 ---
 title: beans release - Release management integration
-status: backlog
+status: draft
 type: feature
 tags:
     - idea
diff --git a/.beans/beans-j03e--show-relationship-counts-in-list-output.md b/.beans/beans-j03e--show-relationship-counts-in-list-output.md
@@ -1,6 +1,6 @@
 ---
 title: Show relationship counts in list output
-status: backlog
+status: draft
 type: feature
 tags:
     - cli
diff --git a/.beans/beans-j7hd--research-claude-code-pluginmarketplace.md b/.beans/beans-j7hd--research-claude-code-pluginmarketplace.md
@@ -1,6 +1,6 @@
 ---
 title: Research Claude Code plugin/marketplace
-status: backlog
+status: draft
 type: task
 created_at: 2025-12-13T01:53:55Z
 updated_at: 2025-12-13T01:53:55Z
diff --git a/.beans/beans-jwy7--use-semantic-markdown-sections-in-bean-bodies.md b/.beans/beans-jwy7--use-semantic-markdown-sections-in-bean-bodies.md
@@ -1,6 +1,6 @@
 ---
 title: Use semantic markdown sections in bean bodies
-status: backlog
+status: draft
 type: feature
 tags:
   - parsing
diff --git a/.beans/beans-l3jg--add-tag-editing-ui-to-tui.md b/.beans/beans-l3jg--add-tag-editing-ui-to-tui.md
@@ -1,6 +1,6 @@
 ---
 title: Add tag editing UI to TUI
-status: backlog
+status: draft
 type: feature
 created_at: 2025-12-12T22:58:14Z
 updated_at: 2025-12-12T22:58:14Z
diff --git a/.beans/beans-lbjp--beans-web-web-ui-server.md b/.beans/beans-lbjp--beans-web-web-ui-server.md
@@ -1,6 +1,6 @@
 ---
 title: beans web - Web UI server
-status: backlog
+status: draft
 type: feature
 tags:
     - idea
diff --git a/.beans/beans-mbi9--graphql-add-filter-parameter-to-relationship-field.md b/.beans/beans-mbi9--graphql-add-filter-parameter-to-relationship-field.md
@@ -1,6 +1,6 @@
 ---
 title: 'GraphQL: add filter parameter to relationship fields'
-status: backlog
+status: draft
 type: feature
 created_at: 2025-12-13T00:49:39Z
 updated_at: 2025-12-13T00:49:39Z
diff --git a/.beans/beans-ss0c--rename-backlog-status-to-draft.md b/.beans/beans-ss0c--rename-backlog-status-to-draft.md
@@ -0,0 +1,15 @@
+---
+title: Rename 'backlog' status to 'draft'
+status: completed
+type: task
+priority: normal
+created_at: 2025-12-13T01:58:26Z
+updated_at: 2025-12-13T02:01:05Z
+---
+
+Rename the backlog status to draft to better communicate that these beans need refinement before being actionable.
+
+## Changes
+- Rename backlog → draft in status definitions
+- Update prompt.tmpl to exclude draft status when finding work
+- Change default status for new beans from backlog to todo
diff --git a/cmd/list_test.go b/cmd/list_test.go
@@ -83,7 +83,7 @@ func TestSortBeans(t *testing.T) {
 		}
 		sortBeans(beans, "status", testCfg)
 
-		// Should be ordered by status config order (in-progress, todo, backlog, completed, scrapped), then by ID within same status
+		// Should be ordered by status config order (in-progress, todo, draft, completed, scrapped), then by ID within same status
 		expected := []string{"i1", "t1", "t2", "c1"}
 		for i, want := range expected {
 			if beans[i].ID != want {
diff --git a/cmd/prompt.tmpl b/cmd/prompt.tmpl
@@ -27,10 +27,10 @@ If you identify something that should be changed or fixed after completing the u
 
 ## Finding work
 
-Use GraphQL to query for actionable beans (not completed, not blocked):
+Use GraphQL to query for actionable beans (not completed, not draft, not blocked):
 
 ```bash
-beans query '{ beans(filter: { excludeStatus: ["completed", "scrapped"], isBlocked: false }) { id title status type priority } }'
+beans query '{ beans(filter: { excludeStatus: ["completed", "scrapped", "draft"], isBlocked: false }) { id title status type priority } }'
 ```
 
 Other useful queries:
diff --git a/internal/bean/bean_test.go b/internal/bean/bean_test.go
@@ -199,7 +199,7 @@ priority: high
 			name: "with deferred priority",
 			input: `---
 title: Later Task
-status: backlog
+status: draft
 priority: deferred
 ---`,
 			expectedPriority: "deferred",
diff --git a/internal/bean/sort_test.go b/internal/bean/sort_test.go
@@ -5,21 +5,21 @@ import (
 )
 
 func TestSortByStatusPriorityAndType(t *testing.T) {
-	statusNames := []string{"backlog", "todo", "in-progress", "completed"}
+	statusNames := []string{"draft", "todo", "in-progress", "completed"}
 	priorityNames := []string{"critical", "high", "normal", "low", "deferred"}
 	typeNames := []string{"bug", "feature", "task"}
 
 	t.Run("sorts by status first", func(t *testing.T) {
 		beans := []*Bean{
 			{ID: "1", Title: "A", Status: "completed", Priority: "critical"},
 			{ID: "2", Title: "B", Status: "todo", Priority: "low"},
-			{ID: "3", Title: "C", Status: "backlog", Priority: "high"},
+			{ID: "3", Title: "C", Status: "draft", Priority: "high"},
 		}
 
 		SortByStatusPriorityAndType(beans, statusNames, priorityNames, typeNames)
 
-		if beans[0].Status != "backlog" {
-			t.Errorf("First bean status = %q, want \"backlog\"", beans[0].Status)
+		if beans[0].Status != "draft" {
+			t.Errorf("First bean status = %q, want \"draft\"", beans[0].Status)
 		}
 		if beans[1].Status != "todo" {
 			t.Errorf("Second bean status = %q, want \"todo\"", beans[1].Status)
diff --git a/internal/config/config.go b/internal/config/config.go
@@ -19,11 +19,11 @@ const (
 
 // DefaultStatuses defines the hardcoded status configuration.
 // Statuses are not configurable - they are hardcoded like types.
-// Order determines sort priority: in-progress first (active work), then todo, backlog, and done states last.
+// Order determines sort priority: in-progress first (active work), then todo, draft, and done states last.
 var DefaultStatuses = []StatusConfig{
 	{Name: "in-progress", Color: "yellow", Description: "Currently being worked on"},
 	{Name: "todo", Color: "green", Description: "Ready to be worked on"},
-	{Name: "backlog", Color: "blue", Description: "Not yet ready to be worked on"},
+	{Name: "draft", Color: "blue", Description: "Needs refinement before it can be worked on"},
 	{Name: "completed", Color: "gray", Archive: true, Description: "Finished successfully"},
 	{Name: "scrapped", Color: "gray", Archive: true, Description: "Will not be done"},
 }
diff --git a/internal/config/config_test.go b/internal/config/config_test.go
@@ -49,7 +49,7 @@ func TestIsValidStatus(t *testing.T) {
 		status string
 		want   bool
 	}{
-		{"backlog", true},
+		{"draft", true},
 		{"todo", true},
 		{"in-progress", true},
 		{"completed", true},
@@ -62,6 +62,7 @@ func TestIsValidStatus(t *testing.T) {
 		{"done", false},
 		{"ready", false},
 		{"not-ready", false},
+		{"backlog", false}, // renamed to draft
 	}
 
 	for _, tt := range tests {
@@ -77,7 +78,7 @@ func TestIsValidStatus(t *testing.T) {
 func TestStatusList(t *testing.T) {
 	cfg := Default()
 	got := cfg.StatusList()
-	want := "in-progress, todo, backlog, completed, scrapped"
+	want := "in-progress, todo, draft, completed, scrapped"
 
 	if got != want {
 		t.Errorf("StatusList() = %q, want %q", got, want)
@@ -91,7 +92,7 @@ func TestStatusNames(t *testing.T) {
 	if len(got) != 5 {
 		t.Fatalf("len(StatusNames()) = %d, want 5", len(got))
 	}
-	expected := []string{"in-progress", "todo", "backlog", "completed", "scrapped"}
+	expected := []string{"in-progress", "todo", "draft", "completed", "scrapped"}
 	for i, name := range expected {
 		if got[i] != name {
 			t.Errorf("StatusNames()[%d] = %q, want %q", i, got[i], name)
@@ -165,7 +166,7 @@ func TestIsArchiveStatus(t *testing.T) {
 	}{
 		{"completed", true},
 		{"scrapped", true},
-		{"backlog", false},
+		{"draft", false},
 		{"todo", false},
 		{"in-progress", false},
 		{"invalid", false},
@@ -285,7 +286,7 @@ func TestStatusesAreHardcoded(t *testing.T) {
 	cfg := Default()
 
 	// All hardcoded statuses should be valid
-	hardcodedStatuses := []string{"backlog", "todo", "in-progress", "completed", "scrapped"}
+	hardcodedStatuses := []string{"draft", "todo", "in-progress", "completed", "scrapped"}
 	for _, status := range hardcodedStatuses {
 		if !cfg.IsValidStatus(status) {
 			t.Errorf("IsValidStatus(%q) = false, want true", status)
@@ -491,7 +492,7 @@ func TestStatusDescriptions(t *testing.T) {
 		cfg := Default()
 
 		expectedDescriptions := map[string]string{
-			"backlog":     "Not yet ready to be worked on",
+			"draft":       "Needs refinement before it can be worked on",
 			"todo":        "Ready to be worked on",
 			"in-progress": "Currently being worked on",
 			"completed":   "Finished successfully",
diff --git a/internal/graph/model/models_gen.go b/internal/graph/model/models_gen.go
diff --git a/internal/graph/schema.graphqls b/internal/graph/schema.graphqls
@@ -54,7 +54,7 @@ input CreateBeanInput {
   title: String!
   "Bean type (defaults to 'task')"
   type: String
-  "Status (defaults to 'backlog')"
+  "Status (defaults to 'todo')"
   status: String
   "Priority level (defaults to 'normal')"
   priority: String
@@ -98,7 +98,7 @@ type Bean {
   path: String!
   "Bean title"
   title: String!
-  "Current status (backlog, todo, in-progress, completed, scrapped)"
+  "Current status (draft, todo, in-progress, completed, scrapped)"
   status: String!
   "Bean type (milestone, epic, bug, feature, task)"
   type: String!
diff --git a/internal/tui/list_test.go b/internal/tui/list_test.go
@@ -8,22 +8,22 @@ import (
 
 func TestSortBeans(t *testing.T) {
 	// Define the expected order from DefaultStatuses, DefaultPriorities, and DefaultTypes
-	statusNames := []string{"backlog", "todo", "in-progress", "completed", "scrapped"}
+	statusNames := []string{"draft", "todo", "in-progress", "completed", "scrapped"}
 	priorityNames := []string{"critical", "high", "normal", "low", "deferred"}
 	typeNames := []string{"milestone", "epic", "bug", "feature", "task"}
 
 	t.Run("sorts by status order first", func(t *testing.T) {
 		beans := []*bean.Bean{
 			{ID: "1", Status: "completed", Type: "task", Title: "A"},
-			{ID: "2", Status: "backlog", Type: "task", Title: "B"},
+			{ID: "2", Status: "draft", Type: "task", Title: "B"},
 			{ID: "3", Status: "in-progress", Type: "task", Title: "C"},
 			{ID: "4", Status: "todo", Type: "task", Title: "D"},
 			{ID: "5", Status: "scrapped", Type: "task", Title: "E"},
 		}
 
 		bean.SortByStatusPriorityAndType(beans, statusNames, priorityNames, typeNames)
 
-		expected := []string{"backlog", "todo", "in-progress", "completed", "scrapped"}
+		expected := []string{"draft", "todo", "in-progress", "completed", "scrapped"}
 		for i, want := range expected {
 			if beans[i].Status != want {
 				t.Errorf("index %d: got status %q, want %q", i, beans[i].Status, want)
@@ -110,13 +110,13 @@ func TestSortBeans(t *testing.T) {
 			{ID: "2", Status: "todo", Type: "task", Priority: "low", Title: "A"},
 			{ID: "3", Status: "todo", Type: "bug", Priority: "high", Title: "B"},
 			{ID: "4", Status: "todo", Type: "bug", Priority: "high", Title: "A"},
-			{ID: "5", Status: "backlog", Type: "epic", Title: "X"},
+			{ID: "5", Status: "draft", Type: "epic", Title: "X"},
 		}
 
 		bean.SortByStatusPriorityAndType(beans, statusNames, priorityNames, typeNames)
 
 		// Expected order:
-		// 1. backlog/epic/X (ID: 5)
+		// 1. draft/epic/X (ID: 5)
 		// 2. todo/high/bug/A (ID: 4)
 		// 3. todo/high/bug/B (ID: 3)
 		// 4. todo/low/task/A (ID: 2)
@@ -134,7 +134,7 @@ func TestSortBeans(t *testing.T) {
 		beans := []*bean.Bean{
 			{ID: "1", Status: "unknown", Type: "task", Title: "A"},
 			{ID: "2", Status: "todo", Type: "task", Title: "B"},
-			{ID: "3", Status: "backlog", Type: "task", Title: "C"},
+			{ID: "3", Status: "draft", Type: "task", Title: "C"},
 		}
 
 		bean.SortByStatusPriorityAndType(beans, statusNames, priorityNames, typeNames)
@@ -178,20 +178,20 @@ func TestSortBeans(t *testing.T) {
 }
 
 func TestCompareBeansByStatusPriorityAndType(t *testing.T) {
-	statusNames := []string{"backlog", "todo", "in-progress", "completed", "scrapped"}
+	statusNames := []string{"draft", "todo", "in-progress", "completed", "scrapped"}
 	priorityNames := []string{"critical", "high", "normal", "low", "deferred"}
 	typeNames := []string{"milestone", "epic", "bug", "feature", "task"}
 
 	t.Run("compares by status first", func(t *testing.T) {
 		a := &bean.Bean{ID: "1", Status: "todo", Type: "task", Title: "A"}
-		b := &bean.Bean{ID: "2", Status: "backlog", Type: "task", Title: "B"}
+		b := &bean.Bean{ID: "2", Status: "draft", Type: "task", Title: "B"}
 
-		// backlog < todo, so b should come before a
+		// draft < todo, so b should come before a
 		if compareBeansByStatusPriorityAndType(a, b, statusNames, priorityNames, typeNames) {
-			t.Error("backlog bean should come before todo bean")
+			t.Error("draft bean should come before todo bean")
 		}
 		if !compareBeansByStatusPriorityAndType(b, a, statusNames, priorityNames, typeNames) {
-			t.Error("backlog bean should come before todo bean")
+			t.Error("draft bean should come before todo bean")
 		}
 	})
 
diff --git a/internal/ui/styles.go b/internal/ui/styles.go
@@ -172,7 +172,7 @@ var Header = lipgloss.NewStyle().
 // RenderStatus returns a styled status badge based on the status string (legacy, uses hardcoded colors)
 func RenderStatus(status string) string {
 	switch status {
-	case "todo", "backlog":
+	case "todo", "draft":
 		return StatusOpen.Render(status)
 	case "completed", "scrapped":
 		return StatusDone.Render(status)
@@ -186,7 +186,7 @@ func RenderStatus(status string) string {
 // RenderStatusText returns styled status text (for tables, no background) (legacy, uses hardcoded colors)
 func RenderStatusText(status string) string {
 	switch status {
-	case "todo", "backlog":
+	case "todo", "draft":
 		return StatusOpenText.Render(status)
 	case "completed", "scrapped":
 		return StatusDoneText.Render(status)
