savepoint 1.0.1 → 1.0.2

package/README.md

@@ -34,11 +34,11 @@ Savepoint turns your project into a series of hard gates, enforced by **six bund
 
 Small scopes. Small context windows. No wandering.
 
-- **The PRD Gate (`draft-prd`):** The agent interviews you to ensure your idea is crisp enough for a V1 before writing any architecture.
-- **The Design Gate (`system-design`):** Write down what you actually want. If you can't explain it simply in a markdown file, the AI is going to make a mess of it.
-- **The Plan Gate (`create-plan` & `create-task`):** Break the idea down into small, manageable steps. No giant leaps. This becomes the checklist the AI _must_ follow.
-- **The Build Gate (`build-task`):** The AI writes code for one small step at a time. The scope stays tight so it doesn't wander off into the weeds. It logs "Drift Notes" instead of cowboy-coding architectural changes.
-- **The Audit Gate (`audit`):** Before moving on, we stop and check. Does the code match the plan? We don't advance until the map matches the territory.
+- **The PRD Gate (`savepoint-draft-prd`):** The agent interviews you to ensure your idea is crisp enough for a V1 before writing any architecture.
+- **The Design Gate (`savepoint-system-design`):** Write down what you actually want. If you can't explain it simply in a markdown file, the AI is going to make a mess of it.
+- **The Plan Gate (`savepoint-create-plan` & `savepoint-create-task`):** Break the idea down into small, manageable steps. No giant leaps. This becomes the checklist the AI _must_ follow.
+- **The Build Gate (`savepoint-build-task`):** The AI writes code for one small step at a time. The scope stays tight so it doesn't wander off into the weeds. It logs "Drift Notes" instead of cowboy-coding architectural changes.
+- **The Audit Gate (`savepoint-audit`):** Before moving on, we stop and check. Does the code match the plan? We don't advance until the map matches the territory.
 
 > 🔒 **The Audit Loop** — When the last task in an epic moves to `done`, the next epic stays _locked_ until your docs (`Design.md`, `AGENTS.md`, and the epic's own design) are reconciled with the actual code via the audit agent. **No existing markdown-first task tool has this gate.**
 
@@ -76,3 +76,4 @@ I’m sharing it to prove a point: The real power of AI isn't just the size of t
 
 **License:** MIT  
 **Status:** Recursive Construction (v1 MVP in progress)
+us:** Recursive Construction (v1 MVP in progress)

package/agent-skills/savepoint-audit/SKILL.md

@@ -10,8 +10,8 @@ The Audit Gate is Savepoint's wedge. It prevents projects from degrading into ch
 This skill is activated when the `.savepoint/router.md` state is `audit-pending`.
 
 ## Input
-- `.savepoint/audit/{E##-slug}/snapshot.md` (what changed).
-- `.savepoint/releases/v1/epics/{E##-slug}/Design.md` (the epic design).
+- `.savepoint/audit/{release}/{E##-slug}/snapshot.md` (what changed).
+- `.savepoint/releases/{release}/epics/{E##-slug}/E##-Detail.md` (the epic design).
 - `.savepoint/Design.md` (project architecture).
 - `AGENTS.md` (agent guide and codebase map).
 - The source and test files modified during the Epic.
@@ -21,15 +21,15 @@ This skill is activated when the `.savepoint/router.md` state is `audit-pending`
 1.  **Fresh Eyes Check:** If you are the exact same agent session that just built the `build-task` code for this Epic, you MUST STOP. Tell the user: "Epic complete. Start a new agent session for the audit."
 2.  **Verify ACs:** Review the completed tasks for the Epic. Ensure the Acceptance Criteria were actually met by the committed code.
 3.  **Process Drift Notes (Reconciliation):** Read every task file in the Epic and look for `## Drift Notes`.
-4.  **Draft Proposals:** Based on the code changes and the Drift Notes, write exactly ONE file: `.savepoint/audit/{E##-slug}/proposals.md`. It must contain:
+4.  **Draft Proposals:** Based on the code changes and the Drift Notes, write exactly ONE file: `.savepoint/audit/{release}/{E##-slug}/proposals.md`. It must contain:
     *   **Design.md section:** Propose updates to merge the epic's architectural changes into the project-level `Design.md`.
     *   **AGENTS.md section:** Propose updates to refresh the Codebase Map table with new or changed modules.
-    *   **Epic-Design.md section:** Add "Implemented as:" notes showing where reality deviated from the original plan.
+    *   **Epic-E##-Detail.md section:** Add "Implemented as:" notes showing where reality deviated from the original plan.
     *   **Quality Review section:** List any minor code-style infractions that must be fixed before the next Epic.
 5.  **Review Format:** Use `## Target File`, `## Replace`, and `## With` formatting in the proposals document so it is easy for a human (or an agent) to apply later.
-6.  **Handoff:** Do not apply the proposals yourself. Do not mark the epic audited. Stop and prompt the user to review `.savepoint/audit/{E##-slug}/proposals.md` (often via the TUI). Once the user approves, the proposals are applied, and the router moves to the next Epic.
+6.  **Handoff:** Do not apply the proposals yourself. Do not mark the epic audited. Stop and prompt the user to review `.savepoint/audit/{release}/{E##-slug}/proposals.md` (often via the TUI). Once the user approves, the proposals are applied, and the router moves to the next Epic.
 
 ## Constraints
 - **Do not write product code.** You are an auditor.
 - **Do not apply the changes immediately.** Write the proposals document first.
-- **One proposals file.** Do not create multiple proposal files.
+- **One proposals file.** Do not create multiple proposal files.

package/agent-skills/savepoint-build-task/SKILL.md

@@ -7,11 +7,11 @@ Act as a disciplined coding agent that strictly follows Savepoint's implementati
 The `build-task` skill is the execution engine. It reads the detailed task plan, writes the code, and proves that the Acceptance Criteria (ACs) have been met. It is strictly constrained to the scope of the single active task. It does not rewrite architecture, and it does not fix unrelated bugs.
 
 ## Trigger
-This skill is activated when the `.savepoint/router.md` state is `in-progress` and points to a specific task file.
+This skill is activated when the `.savepoint/router.md` state is `task-building` and points to a specific task file.
 
 ## Input
 - `.savepoint/router.md` (Current state).
-- The active epic Design: `.savepoint/releases/v1/epics/{E##-epic}/Design.md`.
+- The active epic E##-Detail.md: `.savepoint/releases/v1/epics/{E##-epic}/E##-Detail.md`.
 - The active task file: `.savepoint/releases/v1/epics/{E##-epic}/tasks/{T###}-*.md`.
 - Directly touched source/test files.
 

package/agent-skills/savepoint-create-plan/SKILL.md

@@ -7,18 +7,18 @@ Turn the Product Requirements Document (PRD) and the architectural `Design.md` i
 Savepoint enforces small scopes to prevent AI agents from "wandering." The `create-plan` skill acts as the Technical Project Manager. It takes the grand vision and the architectural blueprint and slices it into a sequence of achievable, testable milestones (Epics).
 
 ## Trigger
-This skill is activated when the `.savepoint/router.md` state is `planning`.
+This skill is activated when the `.savepoint/router.md` state is `pre-implementation`.
 
 ## Input
 - `.savepoint/PRD.md` (Vision and constraints)
 - `.savepoint/Design.md` (Architecture and layout)
-- `.savepoint/releases/v1/PRD.md` (Optional: Release-scoped PRD)
+- `.savepoint/releases/v1/v1-PRD.md` (Optional: Release-scoped PRD)
 
 ## Workflow
 
 1.  **Read the Context:** Consume the PRD and Design documents to understand the scope and technical constraints.
 2.  **Define Epics:** Group the work into high-level features or milestones. Name them clearly (e.g., `E01-scaffolding`, `E02-database`, `E03-auth`). Each Epic must represent a deliverable slice of value.
-3.  **Draft Epic Designs:** For each Epic, create a shell `Design.md` inside `.savepoint/releases/v1/epics/{E##-epic-name}/Design.md`. This file should describe the *delta* (what this specific epic adds to the overall architecture).
+3.  **Draft Epic Designs:** For each Epic, create a shell `E##-Detail.md` inside `.savepoint/releases/v1/epics/{E##-epic-name}/E##-Detail.md`. This file should describe the *delta* (what this specific epic adds to the overall architecture).
 4.  **Breakdown Tasks (High Level):** Inside each Epic folder, list out the high-level tasks required to complete it. Do not write full implementation plans yet—just identify the discrete chunks of work (e.g., `T001-setup-repo.md`, `T002-init-db.md`).
 5.  **Order and Dependency:** Ensure the Epics and tasks are ordered logically. You cannot build the frontend auth UI (E03) before the database models (E02) exist.
 6.  **Handoff:** Update `.savepoint/router.md` to `state: task-breakdown` and point it at the first Epic. Prompt the user to review the Epic list.

package/agent-skills/savepoint-create-task/SKILL.md

@@ -7,10 +7,10 @@ Take high-level tasks identified during the planning phase and build detailed, a
 A task plan is a contract between the planner and the builder. If the task plan is vague, the resulting code will be buggy. The `create-task` skill acts as a Senior Engineer writing tickets for a Junior Developer (the `build-task` agent). It must define exactly *what* constitutes success and *how* to achieve it, without actually writing the code.
 
 ## Trigger
-This skill is activated when the `.savepoint/router.md` state is `task-breakdown` and the router points to a specific task file.
+This skill is activated when the `.savepoint/router.md` state is `epic-task-breakdown` and the router points to a specific epic.
 
 ## Input
-- `.savepoint/releases/v1/epics/{E##-epic}/Design.md` (The active Epic's design).
+- `.savepoint/releases/v1/epics/{E##-epic}/E##-Detail.md` (The active Epic's design).
 - The high-level task markdown file (e.g., `.savepoint/releases/v1/epics/{E##-epic}/tasks/T001-slug.md`).
 
 ## Workflow

package/agent-skills/savepoint-draft-prd/SKILL.md

@@ -7,7 +7,7 @@ Help the user write a structured, sufficiently detailed Product Requirements Doc
 In the Savepoint workflow, the PRD is the absolute source of truth. If the PRD is a vague brain-dump, the resulting architecture and code will be a mess. Your job as the `draft-prd` agent is to act as a strict Product Manager. You do not write code. You interrogate the user's idea until it is crisp enough to build a V1.
 
 ## Trigger
-This skill is activated when the `.savepoint/router.md` state is `draft-prd` or when the user explicitly asks you to help them write or refine their PRD.
+This skill is activated when the `.savepoint/router.md` state is `pre-implementation` or when the user explicitly asks you to help them write or refine their PRD.
 
 ## Input
 - The user's initial idea, brain-dump, or `.txt` file outline.

package/agent-skills/savepoint-system-design/SKILL.md

@@ -7,7 +7,7 @@ Translate the Product Requirements Document (PRD) into the initial architectural
 Before any tasks can be planned, the project needs a high-level technical direction. The `system-design` skill acts as the Staff Engineer. It reads the vision and constraints from the PRD and makes authoritative technical decisions regarding architecture, directory layout, dependency strategies, and workflow rules.
 
 ## Trigger
-This skill is activated when the `.savepoint/router.md` state is `design` or when the user explicitly asks to design the system based on the PRD.
+This skill is activated when the `.savepoint/router.md` state is `epic-design` or when the user explicitly asks to design the system based on the PRD.
 
 ## Input
 - `.savepoint/PRD.md` (The source of truth for "what" and "why").

package/internal/board/board.go

@@ -6,10 +6,14 @@ import (
 	"path/filepath"
 
 	tea "github.com/charmbracelet/bubbletea"
+	"github.com/charmbracelet/lipgloss"
+	"github.com/muesli/termenv"
 	"github.com/opencode/savepoint/internal/data"
 )
 
 func Run() error {
+	lipgloss.SetColorProfile(termenv.ANSI256)
+
 	model, err := newProjectModel(".")
 	if err != nil {
 		return err
@@ -39,26 +43,7 @@ func newProjectModel(start string) (Model, error) {
 		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))
-
-	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)
-		}
-	}
-
-	tasks, err := loadAllTasks(root)
+	tasks, releaseIDs, releaseEpics, epicStatuses, err := loadBoardData(root)
 	if err != nil {
 		return Model{}, err
 	}
@@ -69,40 +54,66 @@ func newProjectModel(start string) (Model, error) {
 	model := NewModel(tasks, release, epic)
 	model.Root = root
 	model.RouterTask = routerState.Task
+	model.RouterState = routerState
 	model.Releases = releaseIDs
 	model.ReleaseEpics = releaseEpics
+	model.EpicStatus = epicStatuses
 	model.refreshEpicsForRelease()
 	model.refreshTasks()
 
 	watcher, err := newWatcher(root)
-	if err == nil {
-		model.Watcher = watcher
+	if err != nil {
+		return Model{}, err
 	}
+	model.Watcher = watcher
 
 	return model, nil
 }
 
-func loadAllTasks(root string) ([]data.Task, error) {
+func loadBoardData(root string) ([]data.Task, []string, map[string][]string, map[string]string, error) {
 	d := data.NewDiscover()
 	releases, err := d.ListReleases(root)
 	if err != nil {
-		return nil, err
+		return nil, nil, nil, nil, err
 	}
+
+	releaseIDs := make([]string, 0, len(releases))
+	releaseEpics := make(map[string][]string, len(releases))
 	var tasks []data.Task
+	epicStatuses := make(map[string]string)
+
 	for _, release := range releases {
+		releaseIDs = append(releaseIDs, release.ID)
 		epics, err := d.ListEpics(root, release.ID)
 		if err != nil {
-			return nil, err
+			return nil, nil, nil, nil, 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 nil, err
+				return nil, nil, nil, nil, err
 			}
 			tasks = append(tasks, epicTasks...)
+
+			detailPath := filepath.Join(epic.Path, shortID(epic.ID)+"-Detail.md")
+			if raw, err := os.ReadFile(detailPath); err == nil {
+				parser := data.NewParser()
+				if fm, err := parser.ParseFrontmatter(string(raw)); err == nil {
+					if status, ok := fm["status"].(string); ok {
+						epicStatuses[epic.ID] = status
+					}
+				}
+			}
 		}
 	}
-	return tasks, nil
+
+	return tasks, releaseIDs, releaseEpics, epicStatuses, nil
+}
+
+func loadAllTasks(root string) ([]data.Task, error) {
+	tasks, _, _, _, err := loadBoardData(root)
+	return tasks, err
 }
 
 func readRouterState(root string) (*data.RouterState, error) {
@@ -150,6 +161,11 @@ func firstKnown(preferred string, values []string) string {
 			return preferred
 		}
 	}
+	for _, value := range values {
+		if shortID(value) == shortID(preferred) {
+			return value
+		}
+	}
 	if len(values) == 0 {
 		return ""
 	}

package/internal/board/board_test.go

@@ -66,6 +66,10 @@ next_action: "test"
 	if len(tasks) != 1 || tasks[0].ID != "E03-live/T001-live" {
 		t.Errorf("visible in-progress tasks = %v, want E03-live/T001-live", tasks)
 	}
+	if model.Watcher == nil {
+		t.Fatal("Watcher is nil, want auto-refresh watcher")
+	}
+	t.Cleanup(func() { model.Watcher.Close() })
 }
 
 func TestNewProjectModelUsesPathReleaseForTaskWithoutReleaseFrontmatter(t *testing.T) {
@@ -100,6 +104,73 @@ next_action: "test"
 	if tasks[0].Release != "v1.1" {
 		t.Errorf("Task.Release = %q, want v1.1", tasks[0].Release)
 	}
+	if model.Watcher != nil {
+		t.Cleanup(func() { model.Watcher.Close() })
+	}
+}
+
+func TestNewProjectModelResolvesShortRouterEpicToFullEpicID(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: v1.1
+epic: E03
+task: T001
+next_action: "Build v1.1 E03/T001"
+`+"```"+`
+`)
+	writeTask(t, savepointRoot, "v1.1", "E01-tui-optimisation", "T007-column-focus-border-stability", data.ColumnInProgress)
+	writeTask(t, savepointRoot, "v1.1", "E03-ui-visual-refinement", "T001-border-resize-fix", data.ColumnInProgress)
+
+	model, err := newProjectModel(projectRoot)
+	if err != nil {
+		t.Fatalf("newProjectModel() error = %v", err)
+	}
+
+	if model.SelectedEpic != "E03-ui-visual-refinement" {
+		t.Errorf("SelectedEpic = %q, want E03-ui-visual-refinement", model.SelectedEpic)
+	}
+	tasks := model.Tasks[data.ColumnInProgress]
+	if len(tasks) != 1 || tasks[0].ID != "E03-ui-visual-refinement/T001-border-resize-fix" {
+		t.Errorf("visible in-progress tasks = %v, want E03-ui-visual-refinement/T001-border-resize-fix", tasks)
+	}
+	if model.Watcher != nil {
+		t.Cleanup(func() { model.Watcher.Close() })
+	}
+}
+
+func TestUpdateReloadMsgRefreshesReleaseEpicIndex(t *testing.T) {
+	m := NewModel(nil, "v1", "E01-old")
+	m.Releases = []string{"v1"}
+	m.ReleaseEpics = map[string][]string{"v1": []string{"E01-old"}}
+
+	task := data.Task{
+		ID:      "E02-new/T001-new",
+		Release: "v1",
+		Epic:    "E02-new",
+		Column:  data.ColumnPlanned,
+	}
+	got, _ := m.Update(reloadMsg{
+		tasks:        []data.Task{task},
+		releases:     []string{"v1"},
+		releaseEpics: map[string][]string{"v1": []string{"E02-new"}},
+	})
+	updated := requireModel(t, got)
+
+	if updated.SelectedEpic != "E02-new" {
+		t.Errorf("SelectedEpic = %q, want E02-new", updated.SelectedEpic)
+	}
+	if len(updated.Epics) != 1 || updated.Epics[0] != "E02-new" {
+		t.Errorf("Epics = %v, want [E02-new]", updated.Epics)
+	}
+	if len(updated.Tasks[data.ColumnPlanned]) != 1 {
+		t.Errorf("planned tasks = %v, want reloaded task visible", updated.Tasks[data.ColumnPlanned])
+	}
 }
 
 func writeTask(t *testing.T, root, release, epic, task string, column data.ColumnType) {

package/internal/board/card.go

@@ -17,15 +17,19 @@ const (
 )
 
 // RenderCard renders a task card with phase glyph, truncated ID+title, and focus styling.
-// When routerTaskID matches t.ID, a green priority glyph replaces the phase glyph.
-func RenderCard(t data.Task, width int, focused bool, routerTaskID string) string {
+// When router state matches t's release/epic/task, a green priority glyph replaces the phase glyph.
+func RenderCard(t data.Task, width int, focused bool, routerState *data.RouterState) string {
 	inner := width - cardOverhead
 	if inner < 2 {
 		inner = 2
 	}
 
 	var glyph string
-	if routerTaskID != "" && t.ID == routerTaskID {
+	if t.Status != "" {
+		glyph = statusGlyph(t.Status)
+	} else if t.Column == data.ColumnDone {
+		glyph = styles.GlyphBuild.Render(glyphBuild)
+	} else if isRouterPriority(t, routerState) {
 		glyph = styles.TagDone.Render(glyphBuild)
 	} else {
 		glyph = phaseGlyphStyled(t.Stage)
@@ -53,6 +57,33 @@ func phaseGlyphStyled(stage data.ProgressStage) string {
 	}
 }
 
+func isRouterPriority(t data.Task, state *data.RouterState) bool {
+	if state == nil || state.Task == "" {
+		return false
+	}
+	if shortID(t.ID) != shortID(state.Task) {
+		return false
+	}
+	if state.Release != "" && t.Release != "" && t.Release != state.Release {
+		return false
+	}
+	routerEpic := state.Epic
+	if routerEpic == "" {
+		routerEpic = taskEpic(state.Task)
+	}
+	if routerEpic != "" && t.Epic != "" && shortID(t.Epic) != shortID(routerEpic) {
+		return false
+	}
+	return true
+}
+
+func taskEpic(taskID string) string {
+	if idx := strings.LastIndex(taskID, "/"); idx >= 0 {
+		return taskID[:idx]
+	}
+	return ""
+}
+
 // shortID strips the epic prefix and slug from a task ID.
 // "E06-atari-noir-layout/T004-component-refinement" → "T004"
 func shortID(id string) string {

package/internal/board/card_test.go

@@ -5,11 +5,12 @@ import (
 	"testing"
 
 	"github.com/opencode/savepoint/internal/data"
+	"github.com/opencode/savepoint/internal/styles"
 )
 
 func TestRenderCard_containsID(t *testing.T) {
 	task := data.Task{ID: "E04/T002", Title: "Build card", Stage: data.StageBuild}
-	got := RenderCard(task, 30, false, "")
+	got := RenderCard(task, 30, false, nil)
 	if !strings.Contains(got, "T002") {
 		t.Error("RenderCard missing short task ID")
 	}
@@ -17,7 +18,7 @@ func TestRenderCard_containsID(t *testing.T) {
 
 func TestRenderCard_containsTitle(t *testing.T) {
 	task := data.Task{ID: "T1", Title: "My title", Stage: data.StageBuild}
-	got := RenderCard(task, 30, false, "")
+	got := RenderCard(task, 30, false, nil)
 	if !strings.Contains(got, "My title") {
 		t.Error("RenderCard missing task title")
 	}
@@ -25,7 +26,7 @@ func TestRenderCard_containsTitle(t *testing.T) {
 
 func TestRenderCard_containsBuildGlyph(t *testing.T) {
 	task := data.Task{ID: "T1", Stage: data.StageBuild}
-	got := RenderCard(task, 30, false, "")
+	got := RenderCard(task, 30, false, nil)
 	if !strings.Contains(got, glyphBuild) {
 		t.Errorf("RenderCard missing build glyph %q", glyphBuild)
 	}
@@ -33,7 +34,7 @@ func TestRenderCard_containsBuildGlyph(t *testing.T) {
 
 func TestRenderCard_containsTestGlyph(t *testing.T) {
 	task := data.Task{ID: "T1", Stage: data.StageTest}
-	got := RenderCard(task, 30, false, "")
+	got := RenderCard(task, 30, false, nil)
 	if !strings.Contains(got, glyphTest) {
 		t.Errorf("RenderCard missing test glyph %q", glyphTest)
 	}
@@ -41,7 +42,7 @@ func TestRenderCard_containsTestGlyph(t *testing.T) {
 
 func TestRenderCard_containsAuditGlyph(t *testing.T) {
 	task := data.Task{ID: "T1", Stage: data.StageAudit}
-	got := RenderCard(task, 30, false, "")
+	got := RenderCard(task, 30, false, nil)
 	if !strings.Contains(got, glyphAudit) {
 		t.Errorf("RenderCard missing audit glyph %q", glyphAudit)
 	}
@@ -49,7 +50,7 @@ func TestRenderCard_containsAuditGlyph(t *testing.T) {
 
 func TestRenderCard_focusedDoesNotPanic(t *testing.T) {
 	task := data.Task{ID: "T1", Title: "hello", Stage: data.StageBuild}
-	got := RenderCard(task, 30, true, "")
+	got := RenderCard(task, 30, true, nil)
 	if got == "" {
 		t.Error("RenderCard focused returned empty string")
 	}
@@ -58,7 +59,7 @@ func TestRenderCard_focusedDoesNotPanic(t *testing.T) {
 func TestRenderCard_titleWraps(t *testing.T) {
 	long := "This is a very long title that should be wrapped for sure"
 	task := data.Task{ID: "T1", Title: long, Stage: data.StageBuild}
-	got := RenderCard(task, 20, false, "")
+	got := RenderCard(task, 20, false, nil)
 	// full title as one line does not fit; it must be broken up
 	if strings.Contains(got, long) {
 		t.Error("RenderCard should wrap long title, not render it as one line")
@@ -72,7 +73,7 @@ func TestRenderCard_titleWraps(t *testing.T) {
 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, "")
+	got := RenderCard(task, 20, false, nil)
 	if strings.Contains(got, long) {
 		t.Error("RenderCard should truncate long ID")
 	}
@@ -106,20 +107,112 @@ func TestTruncate_maxOne(t *testing.T) {
 
 func TestRenderCard_defaultStageUsesBuildGlyph(t *testing.T) {
 	task := data.Task{ID: "T1", Stage: ""}
-	got := RenderCard(task, 30, false, "")
+	got := RenderCard(task, 30, false, nil)
 	if !strings.Contains(got, glyphBuild) {
 		t.Error("RenderCard with empty stage should use build glyph")
 	}
 }
 
 func TestRenderCard_routerPriorityUsesGreenGlyph(t *testing.T) {
-	task := data.Task{ID: "E06/T009", Stage: data.StageTest}
-	got := RenderCard(task, 30, false, "E06/T009")
+	task := data.Task{ID: "E06/T009", Release: "v1", Epic: "E06", Stage: data.StageTest}
+	router := &data.RouterState{Release: "v1", Epic: "E06", Task: "E06/T009"}
+	got := RenderCard(task, 30, false, router)
+	if !isRouterPriority(task, router) {
+		t.Error("router priority should match release, epic, and task")
+	}
 	if !strings.Contains(got, glyphBuild) {
 		t.Error("router priority card should use build glyph")
 	}
-	nonPriority := RenderCard(task, 30, false, "")
+	nonPriority := RenderCard(task, 30, false, nil)
 	if !strings.Contains(nonPriority, glyphTest) {
 		t.Error("non-priority test card should use test glyph")
 	}
 }
+
+func TestRenderCard_noBackgroundFillEscapes(t *testing.T) {
+	task := data.Task{ID: "E06/T009", Title: "Router priority", Release: "v1", Epic: "E06", Stage: data.StageTest}
+	router := &data.RouterState{Release: "v1", Epic: "E06", Task: "E06/T009"}
+	got := RenderCard(task, 30, false, router)
+	if strings.Contains(got, "\x1b[48;") || strings.Contains(got, "\x1b[40m") {
+		t.Fatalf("RenderCard should not emit background fills; got %q", got)
+	}
+}
+
+func TestRenderCard_routerPriorityMatchesShortID(t *testing.T) {
+	// Router stores short IDs ("T009"); task ID is full slug — must still match.
+	task := data.Task{ID: "E06-atari-noir-layout/T009-router-priority", Release: "v1", Epic: "E06-atari-noir-layout", Stage: data.StageTest}
+	router := &data.RouterState{Release: "v1", Epic: "E06", Task: "T009"}
+	got := RenderCard(task, 30, false, router)
+	if !isRouterPriority(task, router) {
+		t.Error("short router task ID should match full task ID slug")
+	}
+	if !strings.Contains(got, glyphBuild) {
+		t.Error("router priority card should use build glyph")
+	}
+}
+
+func TestRenderCard_staleRouterTaskNoMatch(t *testing.T) {
+	// Task moved to a new epic; router still has old epic path — should NOT match a different task number.
+	task := data.Task{ID: "E03-header-activity/T001-border-resize-fix", Release: "v1", Epic: "E03-header-activity", Stage: data.StageBuild}
+	router := &data.RouterState{Release: "v1", Epic: "E03", Task: "T002"}
+	got := RenderCard(task, 30, false, router)
+	if isRouterPriority(task, router) {
+		t.Error("stale router pointing to different task number should not show green glyph")
+	}
+	if !strings.Contains(got, styles.GlyphBuild.Render(glyphBuild)) {
+		t.Error("non-priority build task should use orange build glyph")
+	}
+}
+
+func TestRenderCard_routerSameTaskNumberDifferentEpicNoMatch(t *testing.T) {
+	task := data.Task{ID: "E03-header-activity/T001-border-resize-fix", Release: "v1", Epic: "E03-header-activity", Stage: data.StageTest}
+	router := &data.RouterState{Release: "v1", Epic: "E01", Task: "T001"}
+	got := RenderCard(task, 30, false, router)
+	if isRouterPriority(task, router) {
+		t.Error("router priority should not match same task number in a different epic")
+	}
+	if !strings.Contains(got, styles.GlyphTest.Render(glyphTest)) {
+		t.Error("non-priority test task should keep test glyph")
+	}
+}
+
+func TestRenderCard_doneTaskUsesOrangeBuildGlyph(t *testing.T) {
+	task := data.Task{ID: "E03/T001", Release: "v1", Epic: "E03", Column: data.ColumnDone, Stage: data.StageTest}
+	router := &data.RouterState{Release: "v1", Epic: "E03", Task: "T001"}
+	got := RenderCard(task, 30, false, router)
+	if !isRouterPriority(task, router) {
+		t.Error("router state should still identify the matching done task")
+	}
+	if !strings.Contains(got, styles.GlyphBuild.Render(glyphBuild)) {
+		t.Error("done task should use orange build glyph")
+	}
+	if strings.Contains(got, glyphTest) {
+		t.Error("done task should not use test glyph")
+	}
+}
+
+func TestRenderCard_explicitStatusUsesUnifiedGlyph(t *testing.T) {
+	tests := []struct {
+		name   string
+		status data.TaskStatus
+		glyph  string
+	}{
+		{"planned", data.StatusPlanned, "○"},
+		{"in progress", data.StatusInProgress, "▶"},
+		{"done", data.StatusDone, "◉"},
+		{"audited", data.StatusAudited, "✓"},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			task := data.Task{ID: "T1", Status: string(tt.status), Stage: data.StageAudit}
+			got := RenderCard(task, 30, false, nil)
+			if !strings.Contains(got, tt.glyph) {
+				t.Errorf("RenderCard with status %q missing glyph %q", tt.status, tt.glyph)
+			}
+			if strings.Contains(got, glyphAudit) {
+				t.Errorf("RenderCard with status %q should not fall back to audit glyph", tt.status)
+			}
+		})
+	}
+}

package/internal/board/column.go

@@ -8,12 +8,13 @@ import (
 	"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, routerTaskID string) string {
+// RenderColumn renders a board column: header with label+count, task viewport, bordered container.
+func RenderColumn(tasks []data.Task, col data.ColumnType, width, maxHeight, offset, focusedTask int, focused bool, routerState *data.RouterState) string {
 	inner := width - colOverhead
 	if inner < minColWidth {
 		inner = minColWidth
 	}
+	offset = clampViewportOffset(offset, len(tasks))
 
 	title := columnTitle(col)
 	header := fmt.Sprintf("%s (%d)", title, len(tasks))
@@ -27,19 +28,53 @@ func RenderColumn(tasks []data.Task, col data.ColumnType, width, focusedTask int
 	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, routerTaskID))
+		limit := visibleColumnTaskLimit(maxHeight)
+		end := min(offset+limit, len(tasks))
+		if offset > 0 {
+			lines = append(lines, renderScrollIndicator("↑", offset, "above"))
+		}
+		for i, t := range tasks[offset:end] {
+			taskIndex := offset + i
+			lines = append(lines, RenderCard(t, inner, focused && taskIndex == focusedTask, routerState))
+		}
+		if end < len(tasks) {
+			lines = append(lines, renderScrollIndicator("↓", len(tasks)-end, "more"))
 		}
 	}
 
 	content := strings.Join(lines, "\n")
-	st := styles.Column.Width(width)
+	st := styles.ColumnUnfocused.Width(width)
 	if focused {
 		st = styles.ColumnFocused.Width(width)
 	}
 	return st.Render(content)
 }
 
+func visibleColumnTaskLimit(maxHeight int) int {
+	if maxHeight <= 0 {
+		return 999999
+	}
+	limit := (maxHeight - 2) / 3
+	if limit < 1 {
+		return 1
+	}
+	return limit
+}
+
+func clampViewportOffset(offset, total int) int {
+	if offset < 0 || total <= 0 {
+		return 0
+	}
+	if offset >= total {
+		return total - 1
+	}
+	return offset
+}
+
+func renderScrollIndicator(arrow string, count int, suffix string) string {
+	return styles.ScrollIndicator.Render(fmt.Sprintf("%s %d %s", arrow, count, suffix))
+}
+
 func columnTitle(col data.ColumnType) string {
 	switch col {
 	case data.ColumnPlanned: