savepoint 1.0.0

package/go.mod

@@ -0,0 +1,33 @@
+module github.com/opencode/savepoint
+
+go 1.26.2
+
+require github.com/charmbracelet/bubbletea v1.3.10
+
+require (
+	github.com/atotto/clipboard v0.1.4 // indirect
+	github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect
+	github.com/charmbracelet/bubbles v1.0.0 // indirect
+	github.com/charmbracelet/colorprofile v0.4.1 // indirect
+	github.com/charmbracelet/lipgloss v1.1.0 // indirect
+	github.com/charmbracelet/x/ansi v0.11.6 // indirect
+	github.com/charmbracelet/x/cellbuf v0.0.15 // indirect
+	github.com/charmbracelet/x/term v0.2.2 // indirect
+	github.com/clipperhouse/displaywidth v0.9.0 // indirect
+	github.com/clipperhouse/stringish v0.1.1 // indirect
+	github.com/clipperhouse/uax29/v2 v2.5.0 // indirect
+	github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirect
+	github.com/lucasb-eyer/go-colorful v1.3.0 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/mattn/go-localereader v0.0.1 // indirect
+	github.com/mattn/go-runewidth v0.0.19 // indirect
+	github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect
+	github.com/muesli/cancelreader v0.2.2 // indirect
+	github.com/muesli/termenv v0.16.0 // indirect
+	github.com/rivo/uniseg v0.4.7 // indirect
+	github.com/sahilm/fuzzy v0.1.1 // indirect
+	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
+	golang.org/x/sys v0.38.0 // indirect
+	golang.org/x/text v0.3.8 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+)

package/go.sum

@@ -0,0 +1,73 @@
+github.com/atotto/clipboard v0.1.4 h1:EH0zSVneZPSuFR11BlR9YppQTVDbh5+16AmcJi4g1z4=
+github.com/atotto/clipboard v0.1.4/go.mod h1:ZY9tmq7sm5xIbd9bOK4onWV4S6X0u6GY7Vn0Yu86PYI=
+github.com/aymanbagabas/go-osc52/v2 v2.0.1 h1:HwpRHbFMcZLEVr42D4p7XBqjyuxQH5SMiErDT4WkJ2k=
+github.com/aymanbagabas/go-osc52/v2 v2.0.1/go.mod h1:uYgXzlJ7ZpABp8OJ+exZzJJhRNQ2ASbcXHWsFqH8hp8=
+github.com/charmbracelet/bubbles v1.0.0 h1:12J8/ak/uCZEMQ6KU7pcfwceyjLlWsDLAxB5fXonfvc=
+github.com/charmbracelet/bubbles v1.0.0/go.mod h1:9d/Zd5GdnauMI5ivUIVisuEm3ave1XwXtD1ckyV6r3E=
+github.com/charmbracelet/bubbletea v1.3.10 h1:otUDHWMMzQSB0Pkc87rm691KZ3SWa4KUlvF9nRvCICw=
+github.com/charmbracelet/bubbletea v1.3.10/go.mod h1:ORQfo0fk8U+po9VaNvnV95UPWA1BitP1E0N6xJPlHr4=
+github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc h1:4pZI35227imm7yK2bGPcfpFEmuY1gc2YSTShr4iJBfs=
+github.com/charmbracelet/colorprofile v0.2.3-0.20250311203215-f60798e515dc/go.mod h1:X4/0JoqgTIPSFcRA/P6INZzIuyqdFY5rm8tb41s9okk=
+github.com/charmbracelet/colorprofile v0.4.1 h1:a1lO03qTrSIRaK8c3JRxJDZOvhvIeSco3ej+ngLk1kk=
+github.com/charmbracelet/colorprofile v0.4.1/go.mod h1:U1d9Dljmdf9DLegaJ0nGZNJvoXAhayhmidOdcBwAvKk=
+github.com/charmbracelet/lipgloss v1.1.0 h1:vYXsiLHVkK7fp74RkV7b2kq9+zDLoEU4MZoFqR/noCY=
+github.com/charmbracelet/lipgloss v1.1.0/go.mod h1:/6Q8FR2o+kj8rz4Dq0zQc3vYf7X+B0binUUBwA0aL30=
+github.com/charmbracelet/x/ansi v0.10.1 h1:rL3Koar5XvX0pHGfovN03f5cxLbCF2YvLeyz7D2jVDQ=
+github.com/charmbracelet/x/ansi v0.10.1/go.mod h1:3RQDQ6lDnROptfpWuUVIUG64bD2g2BgntdxH0Ya5TeE=
+github.com/charmbracelet/x/ansi v0.11.6 h1:GhV21SiDz/45W9AnV2R61xZMRri5NlLnl6CVF7ihZW8=
+github.com/charmbracelet/x/ansi v0.11.6/go.mod h1:2JNYLgQUsyqaiLovhU2Rv/pb8r6ydXKS3NIttu3VGZQ=
+github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd h1:vy0GVL4jeHEwG5YOXDmi86oYw2yuYUGqz6a8sLwg0X8=
+github.com/charmbracelet/x/cellbuf v0.0.13-0.20250311204145-2c3ea96c31dd/go.mod h1:xe0nKWGd3eJgtqZRaN9RjMtK7xUYchjzPr7q6kcvCCs=
+github.com/charmbracelet/x/cellbuf v0.0.15 h1:ur3pZy0o6z/R7EylET877CBxaiE1Sp1GMxoFPAIztPI=
+github.com/charmbracelet/x/cellbuf v0.0.15/go.mod h1:J1YVbR7MUuEGIFPCaaZ96KDl5NoS0DAWkskup+mOY+Q=
+github.com/charmbracelet/x/term v0.2.1 h1:AQeHeLZ1OqSXhrAWpYUtZyX1T3zVxfpZuEQMIQaGIAQ=
+github.com/charmbracelet/x/term v0.2.1/go.mod h1:oQ4enTYFV7QN4m0i9mzHrViD7TQKvNEEkHUMCmsxdUg=
+github.com/charmbracelet/x/term v0.2.2 h1:xVRT/S2ZcKdhhOuSP4t5cLi5o+JxklsoEObBSgfgZRk=
+github.com/charmbracelet/x/term v0.2.2/go.mod h1:kF8CY5RddLWrsgVwpw4kAa6TESp6EB5y3uxGLeCqzAI=
+github.com/clipperhouse/displaywidth v0.9.0 h1:Qb4KOhYwRiN3viMv1v/3cTBlz3AcAZX3+y9OLhMtAtA=
+github.com/clipperhouse/displaywidth v0.9.0/go.mod h1:aCAAqTlh4GIVkhQnJpbL0T/WfcrJXHcj8C0yjYcjOZA=
+github.com/clipperhouse/stringish v0.1.1 h1:+NSqMOr3GR6k1FdRhhnXrLfztGzuG+VuFDfatpWHKCs=
+github.com/clipperhouse/stringish v0.1.1/go.mod h1:v/WhFtE1q0ovMta2+m+UbpZ+2/HEXNWYXQgCt4hdOzA=
+github.com/clipperhouse/uax29/v2 v2.5.0 h1:x7T0T4eTHDONxFJsL94uKNKPHrclyFI0lm7+w94cO8U=
+github.com/clipperhouse/uax29/v2 v2.5.0/go.mod h1:Wn1g7MK6OoeDT0vL+Q0SQLDz/KpfsVRgg6W7ihQeh4g=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6baUTXGLOoWe4PQhGxaX0KpnayAqC48p4=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM=
+github.com/lucasb-eyer/go-colorful v1.2.0 h1:1nnpGOrhyZZuNyfu1QjKiUICQ74+3FNCN69Aj6K7nkY=
+github.com/lucasb-eyer/go-colorful v1.2.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
+github.com/lucasb-eyer/go-colorful v1.3.0 h1:2/yBRLdWBZKrf7gB40FoiKfAWYQ0lqNcbuQwVHXptag=
+github.com/lucasb-eyer/go-colorful v1.3.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/mattn/go-localereader v0.0.1 h1:ygSAOl7ZXTx4RdPYinUpg6W99U8jWvWi9Ye2JC/oIi4=
+github.com/mattn/go-localereader v0.0.1/go.mod h1:8fBrzywKY7BI3czFoHkuzRoWE9C+EiG4R1k4Cjx5p88=
+github.com/mattn/go-runewidth v0.0.16 h1:E5ScNMtiwvlvB5paMFdw9p4kSQzbXFikJ5SQO6TULQc=
+github.com/mattn/go-runewidth v0.0.16/go.mod h1:Jdepj2loyihRzMpdS35Xk/zdY8IAYHsh153qUoGf23w=
+github.com/mattn/go-runewidth v0.0.19 h1:v++JhqYnZuu5jSKrk9RbgF5v4CGUjqRfBm05byFGLdw=
+github.com/mattn/go-runewidth v0.0.19/go.mod h1:XBkDxAl56ILZc9knddidhrOlY5R/pDhgLpndooCuJAs=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo=
+github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
+github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
+github.com/muesli/termenv v0.16.0 h1:S5AlUN9dENB57rsbnkPyfdGuWIlkmzJjbFf0Tf5FWUc=
+github.com/muesli/termenv v0.16.0/go.mod h1:ZRfOIKPFDYQoDFF4Olj7/QJbW60Ol/kL1pU3VfY/Cnk=
+github.com/rivo/uniseg v0.2.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc=
+github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
+github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
+github.com/sahilm/fuzzy v0.1.1 h1:ceu5RHF8DGgoi+/dR5PsECjCDH1BE3Fnmpo7aVXOdRA=
+github.com/sahilm/fuzzy v0.1.1/go.mod h1:VFvziUEIMCrT6A6tw2RFIXPXXmzXbOsSHF0DOI8ZK9Y=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no=
+github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
+golang.org/x/exp v0.0.0-20220909182711-5c715a9e8561 h1:MDc5xs78ZrZr3HMQugiXOAkSZtfTpbJLDr/lwfgO53E=
+golang.org/x/exp v0.0.0-20220909182711-5c715a9e8561/go.mod h1:cyybsKvd6eL0RnXn6p/Grxp8F5bW7iYuBgsNCOHpMYE=
+golang.org/x/exp v0.0.0-20231006140011-7918f672742d h1:jtJma62tbqLibJ5sFQz8bKtEM8rJBtfilJ2qTU199MI=
+golang.org/x/sys v0.0.0-20210809222454-d867a43fc93e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.36.0 h1:KVRy2GtZBrk1cBYA7MKu5bEZFxQk4NIDV6RLVcC8o0k=
+golang.org/x/sys v0.36.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc=
+golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
+golang.org/x/text v0.3.8 h1:nAL+RVCQ9uMn3vJZbV+MRnydTJFPf8qqY42YiA6MrqY=
+golang.org/x/text v0.3.8/go.mod h1:E6s5w1FMmriuDzIBO73fBruAKo1PCIq6d2Q6DHfQ8WQ=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

package/internal/board/board.go

@@ -0,0 +1,121 @@
+package board
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+
+	tea "github.com/charmbracelet/bubbletea"
+	"github.com/opencode/savepoint/internal/data"
+)
+
+func Run() error {
+	model, err := newProjectModel(".")
+	if err != nil {
+		return err
+	}
+
+	p := tea.NewProgram(model, tea.WithAltScreen())
+	if _, err := p.Run(); err != nil {
+		fmt.Fprintf(os.Stderr, "Error: %v\n", err)
+		return err
+	}
+	return nil
+}
+
+func newProgramModel() Model {
+	return NewModel(nil, "v1", "E03-board-tui-core")
+}
+
+func newProjectModel(start string) (Model, error) {
+	d := data.NewDiscover()
+	root, err := d.FindSavepointRoot(start)
+	if err != nil {
+		return Model{}, err
+	}
+
+	routerState, err := readRouterState(root)
+	if err != nil {
+		return Model{}, err
+	}
+
+	releases, err := d.ListReleases(root)
+	if err != nil {
+		return Model{}, err
+	}
+
+	releaseIDs := make([]string, 0, len(releases))
+	releaseEpics := make(map[string][]string, len(releases))
+	tasks := []data.Task{}
+
+	for _, release := range releases {
+		releaseIDs = append(releaseIDs, release.ID)
+		epics, err := d.ListEpics(root, release.ID)
+		if err != nil {
+			return Model{}, err
+		}
+		for _, epic := range epics {
+			releaseEpics[release.ID] = append(releaseEpics[release.ID], epic.ID)
+			epicTasks, err := loadEpicTasks(d, root, release.ID, epic.ID)
+			if err != nil {
+				return Model{}, err
+			}
+			tasks = append(tasks, epicTasks...)
+		}
+	}
+
+	release := firstKnown(routerState.Release, releaseIDs)
+	epic := firstKnown(routerState.Epic, releaseEpics[release])
+
+	model := NewModel(tasks, release, epic)
+	model.Root = root
+	model.Releases = releaseIDs
+	model.ReleaseEpics = releaseEpics
+	model.refreshEpicsForRelease()
+	model.refreshTasks()
+
+	return model, nil
+}
+
+func readRouterState(root string) (*data.RouterState, error) {
+	content, err := os.ReadFile(filepath.Join(root, "router.md"))
+	if err != nil {
+		return nil, err
+	}
+
+	return data.NewRouterReader().ReadState(string(content))
+}
+
+func loadEpicTasks(d *data.Discover, root, release, epic string) ([]data.Task, error) {
+	taskInfos, err := d.ListTasks(root, release, epic)
+	if err != nil {
+		return nil, err
+	}
+
+	parser := data.NewParser()
+	tasks := make([]data.Task, 0, len(taskInfos))
+	for _, taskInfo := range taskInfos {
+		content, err := os.ReadFile(taskInfo.Path)
+		if err != nil {
+			return nil, err
+		}
+		task, err := parser.ParseTaskFile(taskInfo.Path, string(content))
+		if err != nil {
+			return nil, err
+		}
+		tasks = append(tasks, *task)
+	}
+	return tasks, nil
+}
+
+func firstKnown(preferred string, values []string) string {
+	for _, value := range values {
+		if value == preferred {
+			return preferred
+		}
+	}
+	if len(values) == 0 {
+		return ""
+	}
+	return values[0]
+}

package/internal/board/board_test.go

@@ -0,0 +1,99 @@
+package board
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/opencode/savepoint/internal/data"
+)
+
+func TestNewProgramModelUsesBoardCore(t *testing.T) {
+	m := newProgramModel()
+	m.Width = 100
+
+	got := m.View()
+	if strings.Contains(got, "Welcome to Savepoint") {
+		t.Fatal("program model still renders placeholder welcome screen")
+	}
+	for _, title := range []string{"PLANNED", "IN PROGRESS", "DONE"} {
+		if !strings.Contains(got, title) {
+			t.Fatalf("program model view missing board column %q", title)
+		}
+	}
+}
+
+func TestNewProjectModelLoadsReleasesEpicsAndTasks(t *testing.T) {
+	projectRoot := t.TempDir()
+	savepointRoot := filepath.Join(projectRoot, ".savepoint")
+	writeFile(t, filepath.Join(savepointRoot, "router.md"), `# Agent State Machine
+
+## Current state
+
+`+"```"+`yaml
+state: task-building
+release: v2
+epic: E03-live
+task: ""
+next_action: "test"
+`+"```"+`
+`)
+	writeTask(t, savepointRoot, "v1", "E01-old", "T001-old", data.ColumnPlanned)
+	writeTask(t, savepointRoot, "v2", "E03-live", "T001-live", data.ColumnInProgress)
+
+	model, err := newProjectModel(projectRoot)
+	if err != nil {
+		t.Fatalf("newProjectModel() error = %v", err)
+	}
+
+	if model.Root != savepointRoot {
+		t.Errorf("Root = %q, want %q", model.Root, savepointRoot)
+	}
+	if model.SelectedRelease != "v2" {
+		t.Errorf("SelectedRelease = %q, want v2", model.SelectedRelease)
+	}
+	if model.SelectedEpic != "E03-live" {
+		t.Errorf("SelectedEpic = %q, want E03-live", model.SelectedEpic)
+	}
+	if len(model.Releases) != 2 {
+		t.Errorf("Releases = %v, want two releases", model.Releases)
+	}
+	if len(model.Epics) != 1 || model.Epics[0] != "E03-live" {
+		t.Errorf("Epics = %v, want [E03-live]", model.Epics)
+	}
+	tasks := model.Tasks[data.ColumnInProgress]
+	if len(tasks) != 1 || tasks[0].ID != "E03-live/T001-live" {
+		t.Errorf("visible in-progress tasks = %v, want E03-live/T001-live", tasks)
+	}
+}
+
+func writeTask(t *testing.T, root, release, epic, task string, column data.ColumnType) {
+	t.Helper()
+	path := filepath.Join(root, "releases", release, "epics", epic, "tasks", task+".md")
+	phase := ""
+	if column == data.ColumnInProgress {
+		phase = "phase: build\n"
+	}
+	content := `---
+id: ` + epic + `/` + task + `
+release: ` + release + `
+status: ` + string(column) + `
+` + phase + `objective: "Test task"
+depends_on: []
+---
+
+# Test task
+`
+	writeFile(t, path, content)
+}
+
+func writeFile(t *testing.T, path, content string) {
+	t.Helper()
+	if err := os.MkdirAll(filepath.Dir(path), 0755); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(path, []byte(content), 0644); err != nil {
+		t.Fatal(err)
+	}
+}

package/internal/board/card.go

@@ -0,0 +1,72 @@
+package board
+
+import (
+	"fmt"
+	"strings"
+
+	"github.com/opencode/savepoint/internal/data"
+	"github.com/opencode/savepoint/internal/styles"
+)
+
+const (
+	glyphBuild = "▣"
+	glyphTest  = "◇"
+	glyphAudit = "◆"
+
+	cardOverhead = 4 // border (2) + padding (2×1)
+)
+
+// RenderCard renders a task card with phase glyph, truncated ID+title, and focus styling.
+func RenderCard(t data.Task, width int, focused bool) string {
+	inner := width - cardOverhead
+	if inner < 2 {
+		inner = 2
+	}
+
+	glyph := phaseGlyphStyled(t.Stage)
+	// glyph is 1 rune + 1 space prefix; leave room for "▣ "
+	idLine := fmt.Sprintf("%s %s", glyph, truncate(shortID(t.ID), inner-2))
+	titleLine := styles.CardMeta.Render(truncate(t.Title, inner))
+
+	content := idLine + "\n" + titleLine
+
+	if focused {
+		return styles.CardFocused.Width(width).Render(content)
+	}
+	return styles.Card.Width(width).Render(content)
+}
+
+func phaseGlyphStyled(stage data.ProgressStage) string {
+	switch stage {
+	case data.StageTest:
+		return styles.GlyphTest.Render(glyphTest)
+	case data.StageAudit:
+		return styles.GlyphAudit.Render(glyphAudit)
+	default:
+		return styles.GlyphBuild.Render(glyphBuild)
+	}
+}
+
+// shortID strips the epic prefix and slug from a task ID.
+// "E06-atari-noir-layout/T004-component-refinement" → "T004"
+func shortID(id string) string {
+	if idx := strings.LastIndex(id, "/"); idx >= 0 {
+		id = id[idx+1:]
+	}
+	if idx := strings.Index(id, "-"); idx >= 0 {
+		id = id[:idx]
+	}
+	return id
+}
+
+// truncate clips s to max runes, appending "…" if clipped.
+func truncate(s string, max int) string {
+	runes := []rune(s)
+	if len(runes) <= max {
+		return s
+	}
+	if max <= 1 {
+		return "…"
+	}
+	return string(runes[:max-1]) + "…"
+}

package/internal/board/card_test.go

@@ -0,0 +1,111 @@
+package board
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/opencode/savepoint/internal/data"
+)
+
+func TestRenderCard_containsID(t *testing.T) {
+	task := data.Task{ID: "E04/T002", Title: "Build card", Stage: data.StageBuild}
+	got := RenderCard(task, 30, false)
+	if !strings.Contains(got, "T002") {
+		t.Error("RenderCard missing short task ID")
+	}
+}
+
+func TestRenderCard_containsTitle(t *testing.T) {
+	task := data.Task{ID: "T1", Title: "My title", Stage: data.StageBuild}
+	got := RenderCard(task, 30, false)
+	if !strings.Contains(got, "My title") {
+		t.Error("RenderCard missing task title")
+	}
+}
+
+func TestRenderCard_containsBuildGlyph(t *testing.T) {
+	task := data.Task{ID: "T1", Stage: data.StageBuild}
+	got := RenderCard(task, 30, false)
+	if !strings.Contains(got, glyphBuild) {
+		t.Errorf("RenderCard missing build glyph %q", glyphBuild)
+	}
+}
+
+func TestRenderCard_containsTestGlyph(t *testing.T) {
+	task := data.Task{ID: "T1", Stage: data.StageTest}
+	got := RenderCard(task, 30, false)
+	if !strings.Contains(got, glyphTest) {
+		t.Errorf("RenderCard missing test glyph %q", glyphTest)
+	}
+}
+
+func TestRenderCard_containsAuditGlyph(t *testing.T) {
+	task := data.Task{ID: "T1", Stage: data.StageAudit}
+	got := RenderCard(task, 30, false)
+	if !strings.Contains(got, glyphAudit) {
+		t.Errorf("RenderCard missing audit glyph %q", glyphAudit)
+	}
+}
+
+func TestRenderCard_focusedDoesNotPanic(t *testing.T) {
+	task := data.Task{ID: "T1", Title: "hello", Stage: data.StageBuild}
+	got := RenderCard(task, 30, true)
+	if got == "" {
+		t.Error("RenderCard focused returned empty string")
+	}
+}
+
+func TestRenderCard_titleTruncated(t *testing.T) {
+	long := "This is a very long title that should be truncated for sure"
+	task := data.Task{ID: "T1", Title: long, Stage: data.StageBuild}
+	got := RenderCard(task, 20, false)
+	if strings.Contains(got, long) {
+		t.Error("RenderCard should truncate long title")
+	}
+	if !strings.Contains(got, "…") {
+		t.Error("RenderCard should include ellipsis when title truncated")
+	}
+}
+
+func TestRenderCard_idTruncated(t *testing.T) {
+	long := "E04-board-components/T999-very-long-id"
+	task := data.Task{ID: long, Stage: data.StageBuild}
+	got := RenderCard(task, 20, false)
+	if strings.Contains(got, long) {
+		t.Error("RenderCard should truncate long ID")
+	}
+}
+
+func TestTruncate_shortString(t *testing.T) {
+	if truncate("hi", 10) != "hi" {
+		t.Error("truncate should not clip short string")
+	}
+}
+
+func TestTruncate_exactLength(t *testing.T) {
+	if truncate("hello", 5) != "hello" {
+		t.Error("truncate should not clip string at exact max")
+	}
+}
+
+func TestTruncate_clipsWithEllipsis(t *testing.T) {
+	got := truncate("hello", 4)
+	if got != "hel…" {
+		t.Errorf("truncate got %q, want %q", got, "hel…")
+	}
+}
+
+func TestTruncate_maxOne(t *testing.T) {
+	got := truncate("hello", 1)
+	if got != "…" {
+		t.Errorf("truncate(max=1) got %q, want %q", got, "…")
+	}
+}
+
+func TestRenderCard_defaultStageUsesBuildGlyph(t *testing.T) {
+	task := data.Task{ID: "T1", Stage: ""}
+	got := RenderCard(task, 30, false)
+	if !strings.Contains(got, glyphBuild) {
+		t.Error("RenderCard with empty stage should use build glyph")
+	}
+}

package/internal/board/column.go

@@ -0,0 +1,61 @@
+package board
+
+import (
+	"fmt"
+	"strings"
+
+	"github.com/opencode/savepoint/internal/data"
+	"github.com/opencode/savepoint/internal/styles"
+)
+
+// RenderColumn renders a board column: header with label+count, task list, bordered container.
+func RenderColumn(tasks []data.Task, col data.ColumnType, width, focusedTask int, focused bool) string {
+	inner := width - colOverhead
+	if inner < minColWidth {
+		inner = minColWidth
+	}
+
+	title := columnTitle(col)
+	header := fmt.Sprintf("%s (%d)", title, len(tasks))
+	if focused {
+		header = styles.ColumnTitleFocused.Render(header)
+	} else {
+		header = styles.ColumnTitle.Render(header)
+	}
+
+	lines := []string{header, strings.Repeat("─", inner)}
+	if len(tasks) == 0 {
+		lines = append(lines, styles.TaskItem.Render("(empty)"))
+	} else {
+		for i, t := range tasks {
+			lines = append(lines, RenderCard(t, inner, focused && i == focusedTask))
+		}
+	}
+
+	content := strings.Join(lines, "\n")
+	st := styles.Column.Width(width)
+	if focused {
+		st = styles.ColumnFocused.Width(width)
+	}
+	return st.Render(content)
+}
+
+func columnTitle(col data.ColumnType) string {
+	switch col {
+	case data.ColumnPlanned:
+		return "PLANNED"
+	case data.ColumnInProgress:
+		return "IN PROGRESS"
+	case data.ColumnDone:
+		return "DONE"
+	default:
+		return strings.ToUpper(string(col))
+	}
+}
+
+func taskLabel(t data.Task) string {
+	if t.Title == "" {
+		return t.ID
+	}
+	return fmt.Sprintf("%s  %s", t.ID, t.Title)
+}

package/internal/board/column_test.go

@@ -0,0 +1,81 @@
+package board
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/opencode/savepoint/internal/data"
+)
+
+func TestRenderColumn_headerContainsLabel(t *testing.T) {
+	got := RenderColumn(nil, data.ColumnPlanned, 30, 0, false)
+	if !strings.Contains(got, "PLANNED") {
+		t.Error("RenderColumn missing PLANNED label")
+	}
+}
+
+func TestRenderColumn_headerContainsCount(t *testing.T) {
+	tasks := []data.Task{{ID: "T1", Title: "Task one", Column: data.ColumnPlanned}}
+	got := RenderColumn(tasks, data.ColumnPlanned, 30, 0, false)
+	if !strings.Contains(got, "(1)") {
+		t.Error("RenderColumn missing task count")
+	}
+}
+
+func TestRenderColumn_emptyShowsPlaceholder(t *testing.T) {
+	got := RenderColumn(nil, data.ColumnDone, 30, 0, false)
+	if !strings.Contains(got, "(empty)") {
+		t.Error("RenderColumn missing (empty) for empty column")
+	}
+}
+
+func TestRenderColumn_focusedDoesNotPanic(t *testing.T) {
+	tasks := []data.Task{{ID: "T1", Column: data.ColumnInProgress}}
+	got := RenderColumn(tasks, data.ColumnInProgress, 30, 0, true)
+	if got == "" {
+		t.Error("RenderColumn returned empty string for focused column")
+	}
+}
+
+func TestRenderColumn_allColumnTitles(t *testing.T) {
+	cases := []struct {
+		col   data.ColumnType
+		label string
+	}{
+		{data.ColumnPlanned, "PLANNED"},
+		{data.ColumnInProgress, "IN PROGRESS"},
+		{data.ColumnDone, "DONE"},
+	}
+	for _, tc := range cases {
+		got := RenderColumn(nil, tc.col, 30, 0, false)
+		if !strings.Contains(got, tc.label) {
+			t.Errorf("RenderColumn missing label %q for col %q", tc.label, tc.col)
+		}
+	}
+}
+
+func TestRenderColumn_taskTitleRendered(t *testing.T) {
+	tasks := []data.Task{{ID: "T2", Title: "Build it", Column: data.ColumnPlanned}}
+	got := RenderColumn(tasks, data.ColumnPlanned, 30, 0, false)
+	if !strings.Contains(got, "Build it") {
+		t.Error("RenderColumn missing task title")
+	}
+}
+
+func TestRenderColumn_rendersTaskCards(t *testing.T) {
+	tasks := []data.Task{{ID: "T2", Title: "Build it", Column: data.ColumnPlanned, Stage: data.StageAudit}}
+	got := RenderColumn(tasks, data.ColumnPlanned, 30, 0, true)
+	if !strings.Contains(got, glyphAudit) {
+		t.Error("RenderColumn should render task phase glyph from card")
+	}
+	if !strings.Contains(got, "╭") {
+		t.Error("RenderColumn should render bordered card")
+	}
+}
+
+func TestRenderColumn_emptyCountIsZero(t *testing.T) {
+	got := RenderColumn(nil, data.ColumnPlanned, 30, 0, false)
+	if !strings.Contains(got, "(0)") {
+		t.Error("RenderColumn missing (0) count for empty column")
+	}
+}