savepoint 1.0.0 → 1.0.2

package/Makefile

@@ -1,7 +1,9 @@
-.PHONY: build test run clean
+.PHONY: build test run clean build-linux build-darwin build-all dist smoke-test
+
+VERSION ?=
 
 build:
-	go build -o savepoint main.go
+	go run ./internal/buildtool -version "$(VERSION)" build
 
 test:
 	go test ./...
@@ -10,4 +12,18 @@ run:
 	go run main.go
 
 clean:
-	rm -f savepoint
+	go run ./internal/buildtool -version "$(VERSION)" clean
+
+build-linux:
+	go run ./internal/buildtool -version "$(VERSION)" build-linux
+
+build-darwin:
+	go run ./internal/buildtool -version "$(VERSION)" build-darwin
+
+build-all: build-linux build-darwin
+
+dist:
+	go run ./internal/buildtool -version "$(VERSION)" dist
+
+smoke-test:
+	go run ./internal/buildtool -version "$(VERSION)" smoke-test

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.**
 
@@ -48,7 +48,7 @@ Small scopes. Small context windows. No wandering.
 
 Built for a cinematic, technical feel without the bloat.
 
-- **Cinematic TUI:** Built with Ink. It feels like a proper terminal tool, not a web app ported to a CLI.
+- **Cinematic TUI:** Built with Go and Bubble Tea. It feels like a proper terminal tool, lightning-fast and dependency-free.
 - **File-First:** Your project's state lives in markdown and JSON files right next to your code.
 - **Agent-Agnostic:** Claude, Cursor, Aider, Gemini — if it reads markdown and edits files, it works. No MCP server. No per-agent adapters.
 - **Token-Efficient by Design:** Tasks read <2KB of context. Audits stay under ~15KB. No more burning your AI budget on bloated backlogs.
@@ -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/go.mod

@@ -2,7 +2,10 @@ module github.com/opencode/savepoint
 
 go 1.26.2
 
-require github.com/charmbracelet/bubbletea v1.3.10
+require (
+	github.com/charmbracelet/bubbletea v1.3.10
+	github.com/fsnotify/fsnotify v1.10.0
+)
 
 require (
 	github.com/atotto/clipboard v0.1.4 // indirect

package/go.sum

@@ -32,6 +32,8 @@ github.com/clipperhouse/uax29/v2 v2.5.0 h1:x7T0T4eTHDONxFJsL94uKNKPHrclyFI0lm7+w
 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/fsnotify/fsnotify v1.10.0 h1:Xx/5Ydg9CeBDX/wi4VJqStNtohYjitZhhlHt4h3St1M=
+github.com/fsnotify/fsnotify v1.10.0/go.mod h1:TLheqan6HD6GBK6PrDWyDPBaEV8LspOxvPSjC+bVfgo=
 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=

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,42 +43,77 @@ func newProjectModel(start string) (Model, error) {
 		return Model{}, err
 	}
 
-	releases, err := d.ListReleases(root)
+	tasks, releaseIDs, releaseEpics, epicStatuses, err := loadBoardData(root)
+	if err != nil {
+		return Model{}, err
+	}
+
+	release := firstKnown(routerState.Release, releaseIDs)
+	epic := firstKnown(routerState.Epic, releaseEpics[release])
+
+	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 {
 		return Model{}, err
 	}
+	model.Watcher = watcher
+
+	return model, nil
+}
+
+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, nil, nil, nil, err
+	}
 
 	releaseIDs := make([]string, 0, len(releases))
 	releaseEpics := make(map[string][]string, len(releases))
-	tasks := []data.Task{}
+	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 Model{}, 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 Model{}, 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
+					}
+				}
+			}
 		}
 	}
 
-	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 tasks, releaseIDs, releaseEpics, epicStatuses, nil
+}
 
-	return model, nil
+func loadAllTasks(root string) ([]data.Task, error) {
+	tasks, _, _, _, err := loadBoardData(root)
+	return tasks, err
 }
 
 func readRouterState(root string) (*data.RouterState, error) {
@@ -103,6 +142,14 @@ func loadEpicTasks(d *data.Discover, root, release, epic string) ([]data.Task, e
 		if err != nil {
 			return nil, err
 		}
+		fi, err := os.Stat(taskInfo.Path)
+		if err != nil {
+			return nil, err
+		}
+		task.Path = taskInfo.Path
+		task.Mtime = fi.ModTime()
+		task.Release = release
+		task.Epic = epic
 		tasks = append(tasks, *task)
 	}
 	return tasks, nil
@@ -114,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,111 @@ 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) {
+	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: E01-tui-optimisation
+task: E01-tui-optimisation/T001-border-resize-fix
+next_action: "test"
+`+"```"+`
+`)
+	writeTaskWithoutRelease(t, savepointRoot, "v1.1", "E01-tui-optimisation", "T001-border-resize-fix", data.ColumnInProgress)
+
+	model, err := newProjectModel(projectRoot)
+	if err != nil {
+		t.Fatalf("newProjectModel() error = %v", err)
+	}
+
+	if model.SelectedRelease != "v1.1" {
+		t.Errorf("SelectedRelease = %q, want v1.1", model.SelectedRelease)
+	}
+	tasks := model.Tasks[data.ColumnInProgress]
+	if len(tasks) != 1 {
+		t.Fatalf("visible in-progress tasks = %v, want one v1.1 task", tasks)
+	}
+	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) {
@@ -88,6 +193,25 @@ depends_on: []
 	writeFile(t, path, content)
 }
 
+func writeTaskWithoutRelease(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 + `
+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 {

package/internal/board/card.go

@@ -17,16 +17,26 @@ const (
 )
 
 // RenderCard renders a task card with phase glyph, truncated ID+title, and focus styling.
-func RenderCard(t data.Task, width int, focused bool) 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
 	}
 
-	glyph := phaseGlyphStyled(t.Stage)
+	var glyph string
+	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)
+	}
 	// 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))
+	titleLine := styles.CardMeta.Render(strings.Join(WrapText(t.Title, inner), "\n"))
 
 	content := idLine + "\n" + titleLine
 
@@ -47,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 {