savepoint 1.0.0 → 1.0.1

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T004-update-instruction-files.md

@@ -0,0 +1,50 @@
+---
+id: E01-tui-optimisation/T004-update-instruction-files
+status: planned
+objective: "Update all instruction files to reference new naming convention"
+depends_on:
+  - E01-tui-optimisation/T002-rename-epic-design-files
+  - E01-tui-optimisation/T003-rename-release-prd
+---
+
+# T004: Update Instruction Files
+
+## Acceptance Criteria
+
+- `.savepoint/router.md` references `E##-Detail.md` and `v1-PRD.md` (not `Design.md` or `PRD.md`)
+- `AGENTS.md` references `E##-Detail.md` pattern
+- `agent-skills/savepoint-create-plan/SKILL.md` updated
+- `agent-skills/savepoint-system-design/SKILL.md` updated
+- `agent-skills/savepoint-build-task/SKILL.md` updated
+- `agent-skills/savepoint-audit/SKILL.md` updated
+- `agent-skills/savepoint-create-task/SKILL.md` updated
+- `templates/project/AGENTS.md` updated
+- `templates/prompts/task-building.prompt.md` updated
+- `templates/prompts/task-planning.prompt.md` updated
+- `templates/prompts/task-breakdown.prompt.md` updated
+- Root `.savepoint/Design.md` references unchanged (per user request)
+
+## Implementation Plan
+
+- [ ] Update `.savepoint/router.md` — all epic `Design.md` → `E##-Detail.md`, `PRD.md` → `v1-PRD.md`
+- [ ] Update `AGENTS.md` — epic design file path pattern
+- [ ] Update `agent-skills/savepoint-create-plan/SKILL.md`
+- [ ] Update `agent-skills/savepoint-system-design/SKILL.md`
+- [ ] Update `agent-skills/savepoint-build-task/SKILL.md`
+- [ ] Update `agent-skills/savepoint-audit/SKILL.md`
+- [ ] Update `agent-skills/savepoint-create-task/SKILL.md`
+- [ ] Update `templates/project/AGENTS.md`
+- [ ] Update `templates/prompts/task-building.prompt.md`
+- [ ] Update `templates/prompts/task-planning.prompt.md`
+- [ ] Update `templates/prompts/task-breakdown.prompt.md`
+
+## Context Log
+
+Files read:
+- All instruction files listed above
+
+Estimated input tokens: 800
+
+Notes:
+- Only change path references, do not alter surrounding content
+- Root Design.md references stay as-is

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T005-update-cross-references.md

@@ -0,0 +1,44 @@
+---
+id: E01-tui-optimisation/T005-update-cross-references
+status: planned
+objective: "Update all cross-references in task files and audit snapshots"
+depends_on:
+  - E01-tui-optimisation/T002-rename-epic-design-files
+  - E01-tui-optimisation/T004-update-instruction-files
+---
+
+# T005: Update Cross-References
+
+## Acceptance Criteria
+
+- All task file "Files read" sections reference `E##-Detail.md` instead of `Design.md`
+- All audit `proposals.md` files reference renamed epic design files
+- All audit `snapshot.md` files reference renamed epic design files
+- No stale `Design.md` references remain in any epic-level file paths
+- 244 grep matches reduced to 0 for epic-level `Design.md` references
+
+## Implementation Plan
+
+- [ ] Find all task files with "Design.md" in content and update epic-level references to `E##-Detail.md`
+- [ ] Update `.savepoint/audit/E02-data-readers/proposals.md`
+- [ ] Update `.savepoint/audit/E03-board-tui-core/proposals.md`
+- [ ] Update `.savepoint/audit/E03-board-tui-core/snapshot.md`
+- [ ] Update `.savepoint/audit/E04-board-components/proposals.md`
+- [ ] Update `.savepoint/audit/E04-board-components/snapshot.md`
+- [ ] Update `.savepoint/audit/E05-phase-transitions/proposals.md`
+- [ ] Update `.savepoint/audit/E05-phase-transitions/snapshot.md`
+- [ ] Update `.savepoint/releases/v1/epics/E03-board-tui-core/tasks/T*.md` files
+- [ ] Update `.savepoint/releases/v1/epics/E04-board-components/tasks/T*.md` files
+- [ ] Update `.savepoint/releases/v1/epics/E06-atari-noir-layout/tasks/T*.md` files
+- [ ] Run grep verification: no `epics/.*Design\.md` references remain
+
+## Context Log
+
+Files read:
+- All task and audit files listed above
+
+Estimated input tokens: 1200
+
+Notes:
+- Only update epic-level Design.md paths (e.g., `E03-board-tui-core/Design.md` → `E03-Detail.md`)
+- Root `.savepoint/Design.md` references must NOT be changed

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T006-column-and-detail-scrolling.md

@@ -0,0 +1,58 @@
+---
+id: E01-tui-optimisation/T006-column-and-detail-scrolling
+status: planned
+objective: "Add virtual viewport scrolling to board columns and detail overlay so content adapts to terminal height"
+depends_on:
+  - E01-tui-optimisation/T001-border-resize-fix
+---
+
+# T006: Column and Detail Scroll Viewport
+
+## Acceptance Criteria
+
+- Each column shows only 4-5 task cards by default (adapts to terminal height) and renders `↑ N above` / `↓ N more` indicators when content extends beyond the viewport
+- The column viewport auto-scrolls to keep the focused task visible when navigating with j/k/up/down
+- PageUp/PageDown keys scroll a full page of cards in the focused column
+- The detail overlay is capped at ~70% of terminal height and shows the same `↑ N above` / `↓ N more` indicators when content exceeds available space
+- j/k/up/down keys scroll the detail overlay content when it is open
+- All scroll indicators use dim/subtle styling matching the Atari Noir aesthetic
+- Existing layout breakpoints (120/80 width) still function correctly with height-aware layout
+- No visual corruption on terminal resize — viewport recalculates available height
+- All existing tests pass; new tests cover viewport offset calculations, indicator rendering, and auto-scroll behavior
+
+## Implementation Plan
+
+- [ ] Add `ColumnOffsets map[data.ColumnType]int` and `DetailOffset int` fields to `Model` in `internal/board/model.go`
+- [ ] Extend `Layout` struct in `internal/board/layout.go` with `ContentHeight int` — computed from terminal height minus header (~3), footer (~3), board border (2), column border (2)
+- [ ] Update `CalculateLayout(width, height)` to accept height and populate `ContentHeight`
+- [ ] Refactor `RenderColumn` in `internal/board/column.go` to accept `maxHeight` param, compute visible task slice from offset, and append scroll indicators (`↑ N above` / `↓ N more`) styled with dim/subtle text
+- [ ] Add `ScrollIndicator` style to `internal/styles/styles.go` (dim, faint)
+- [ ] Refactor `RenderDetail` in `internal/board/detail.go` to accept `maxHeight` param (capped at 70% terminal height), count total lines, and render only the visible slice from `DetailOffset` with scroll indicators at edges
+- [ ] Update `view.go` — pass `layout.ContentHeight` through render chain to `renderColumn` and `RenderDetail`
+- [ ] Update `update.go` — auto-scroll `ColumnOffsets` when focused task moves beyond visible range; handle PageUp/PageDown keybindings in both normal and detail overlay modes; add j/k scroll handling in detail overlay
+- [ ] Add tests in `internal/board/column_test.go` for scroll indicator rendering and viewport slicing
+- [ ] Add tests in `internal/board/layout_test.go` for height-aware `CalculateLayout` including ContentHeight computation and minimum height floors
+- [ ] Run `make build && make test` — all gates pass
+
+## Context Log
+
+Files read:
+- `internal/board/model.go`
+- `internal/board/layout.go`
+- `internal/board/view.go`
+- `internal/board/column.go`
+- `internal/board/detail.go`
+- `internal/board/card.go`
+- `internal/board/update.go`
+- `internal/styles/styles.go`
+- `internal/board/layout_test.go`
+- `.savepoint/router.md`
+- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/Design.md`
+
+Estimated input tokens: 3500
+
+Notes:
+- Pure rendering concern — no data model or card rendering changes needed
+- `card.go` untouched — column decides which cards to show
+- Scroll uses virtual viewport (offset tracking) not literal scrollbar glyphs
+- Auto-scroll-to-focus means explicit scrolling is rarely needed by user

package/.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T007-next-activity-header.md

@@ -0,0 +1,55 @@
+---
+id: E01-tui-optimisation/T007-next-activity-header
+status: planned
+objective: "Show Next Activity indicator in the TUI header bar, right-aligned, displaying the current router state"
+depends_on: []
+---
+
+# T007: Next Activity Header Display
+
+## Acceptance Criteria
+
+- The header bar displays "Next Activity:" followed by a formatted state string on the right side
+- When router state is `task-building`, displays "Build T{NNN} (E{NN}) v{N}" format (e.g., "Build T010 (E06) v1")
+- When router state is `audit-pending`, displays "Audit E{NN}" format (e.g., "Audit E06")
+- For `epic-design` state, displays "Design E{NN}" format
+- For `epic-task-breakdown` state, displays "Plan E{NN}" format
+- For `pre-implementation` state, displays "Planning v{N}" format
+- The Next Activity text (excluding "Next Activity:" label) is capped at 20 characters maximum, with ellipsis truncation if exceeded
+- The display gracefully degrades at narrow terminal widths (header text remains intact, Next Activity truncates but doesn't break layout)
+- All existing tests pass
+
+## Implementation Plan
+
+- [ ] Add `HeaderRight` style to `internal/styles/styles.go` (dim foreground, right-aligned)
+- [ ] Create `FormatNextActivity(state *data.RouterState) string` helper in `internal/board/view.go` that:
+  - Parses router state and formats compact string based on state type
+  - Truncates to max 20 chars using `xansi.Truncate` with ellipsis
+- [ ] Update `view.go` `View()` method — modify header rendering:
+  - Split header into left (icon + "SAVEPOINT") and right sections
+  - Use `lipgloss.PlaceHorizontal` or manual string construction to position Next Activity on right
+  - Maintain existing `HeaderFrame` width and padding
+- [ ] Update `main.go` or board initialization to read router state and populate `Model` with parsed state
+- [ ] Add test in `internal/board/view_test.go` for Next Activity rendering at various widths
+- [ ] Add test for `FormatNextActivity` covering all router states and truncation behavior
+- [ ] Run `make build && make test` — all gates pass
+
+## Context Log
+
+Files read:
+- `internal/board/view.go`
+- `internal/board/model.go`
+- `internal/styles/styles.go`
+- `internal/data/router.go`
+- `internal/board/view_test.go`
+- `.savepoint/router.md`
+- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/Design.md`
+- `.savepoint/releases/v1.1/epics/E01-tui-optimisation/tasks/T006-column-and-detail-scrolling.md`
+
+Estimated input tokens: 2800
+
+Notes:
+- Uses existing `data.RouterState` model — no new data parsing needed
+- Router state already available via `m.RouterTask` in Model — may need to add `*data.RouterState` field or parse separately
+- Truncation uses same `xansi` package already imported in view.go
+- Max 20 char constraint keeps header clean at all terminal widths

package/.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/Design.md

@@ -0,0 +1,40 @@
+---
+type: epic-design
+status: planned
+---
+
+# Epic E02: Cross-Platform Compatibility
+
+## Purpose
+
+Ensure the project builds, runs, and distributes cleanly across Windows, Linux, and macOS. The codebase itself is platform-agnostic (pure Go with `filepath`), but the build tooling and release workflow need adjustments for multi-platform support.
+
+## Definition of Done
+
+- Makefile works identically across Windows (Git Bash/WSL), Linux, and macOS
+- Binary builds succeed for linux-amd64, linux-arm64, darwin-amd64, darwin-arm64
+- Smoke tests pass on at least one non-Windows target
+- Release artifacts are produced in `dist/` with platform-specific naming
+
+## Components and files
+
+| Path | Purpose |
+|------|---------|
+| `Makefile` | Build tooling — currently uses `rm -f` (Unix-only) |
+| `dist/` | New directory for release artifacts (platform-organized) |
+| `build.sh` | New cross-platform build helper (optional) |
+
+## Architectural notes
+
+- All Go code uses `path/filepath` — no syscalls are platform-specific
+- Bubble Tea handles terminal differences across platforms
+- No Go build tags or platform-specific files needed
+- This is purely a build-tooling and release-workflow epic
+
+## Definition of Done
+
+- [x] Makefile replaced with Go-native commands (no `rm`, `cp`, `mkdir`)
+- [x] `dist/` directory convention established
+- [x] `make build-all` produces binaries for linux-amd64, linux-arm64, darwin-amd64, darwin-arm64
+- [x] `make dist` creates versioned tar/zip artifacts per platform
+- [x] Smoke test script validates binary runs and exits cleanly

package/.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/tasks/T001-fix-makefile.md

@@ -0,0 +1,34 @@
+---
+id: E02-cross-platform-compatibility/T001-fix-makefile
+status: planned
+objective: "Replace Unix-only Makefile commands with Go-native cross-platform equivalents"
+depends_on: []
+---
+
+# T001: Fix Makefile for Cross-Platform Use
+
+## Acceptance Criteria
+
+- `make build` produces a working binary on Windows (via Git Bash), Linux, and macOS
+- `make test` runs all tests on all three platforms
+- `make clean` removes the binary without using `rm -f` or other Unix-only commands
+- No shell commands in Makefile are platform-dependent
+
+## Implementation Plan
+
+- [ ] Read current `Makefile` and identify all Unix-specific commands
+- [ ] Replace `rm -f savepoint` with `go clean` or a Go-native removal approach
+- [ ] Use `go build -o savepoint main.go` directly (already portable)
+- [ ] Test `make build && make test && make clean` works on current platform
+- [ ] Update `AGENTS.md` Build/Test/Run section if commands changed
+
+## Context Log
+
+Files read:
+- `Makefile`
+
+Estimated input tokens: 400
+
+Notes:
+- Go's `go build` and `go test` are inherently cross-platform
+- Only `rm -f` needs replacement

package/.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/tasks/T002-linux-build-target.md

@@ -0,0 +1,33 @@
+---
+id: E02-cross-platform-compatibility/T002-linux-build-target
+status: planned
+objective: "Add Linux build targets for amd64 and arm64 architectures"
+depends_on:
+  - E02-cross-platform-compatibility/T001-fix-makefile
+---
+
+# T002: Add Linux Build Target
+
+## Acceptance Criteria
+
+- `make build-linux` produces linux-amd64 and linux-arm64 binaries in `dist/`
+- Binaries have correct ELF format (can be verified via `file` command on Linux)
+- `dist/` directory is created automatically if it doesn't exist
+- Binaries are named `dist/linux-amd64/savepoint` and `dist/linux-arm64/savepoint`
+
+## Implementation Plan
+
+- [ ] Add `build-linux` Makefile target with `GOOS=linux GOARCH=amd64` and `GOOS=linux GOARCH=arm64`
+- [ ] Ensure `dist/` directory creation is part of the build target
+- [ ] Use `go build` with output flags to place binaries in `dist/` subdirectories
+- [ ] Verify binaries build correctly with `make build-linux`
+
+## Context Log
+
+Files read:
+- `Makefile`
+
+Estimated input tokens: 350
+
+Notes:
+- Go cross-compilation is built-in — no external tooling required

package/.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/tasks/T003-macos-build-target.md

@@ -0,0 +1,32 @@
+---
+id: E02-cross-platform-compatibility/T003-macos-build-target
+status: planned
+objective: "Add macOS build targets for amd64 and arm64 architectures"
+depends_on:
+  - E02-cross-platform-compatibility/T001-fix-makefile
+---
+
+# T003: Add macOS Build Target
+
+## Acceptance Criteria
+
+- `make build-darwin` produces darwin-amd64 and darwin-arm64 binaries in `dist/`
+- Binaries have correct Mach-O format
+- `dist/` directory is created automatically if it doesn't exist
+- Binaries are named `dist/darwin-amd64/savepoint` and `dist/darwin-arm64/savepoint`
+
+## Implementation Plan
+
+- [ ] Add `build-darwin` Makefile target with `GOOS=darwin GOARCH=amd64` and `GOOS=darwin GOARCH=arm64`
+- [ ] Ensure output goes to `dist/darwin-amd64/` and `dist/darwin-arm64/`
+- [ ] Verify binaries build correctly with `make build-darwin`
+
+## Context Log
+
+Files read:
+- `Makefile`
+
+Estimated input tokens: 350
+
+Notes:
+- Mirrors T002 pattern for darwin

package/.savepoint/releases/v1.1/epics/E02-cross-platform-compatibility/tasks/T004-smoke-tests-and-artifacts.md

@@ -0,0 +1,38 @@
+---
+id: E02-cross-platform-compatibility/T004-smoke-tests-and-artifacts
+status: planned
+objective: "Add smoke test script and create versioned release artifacts for all platforms"
+depends_on:
+  - E02-cross-platform-compatibility/T002-linux-build-target
+  - E02-cross-platform-compatibility/T003-macos-build-target
+---
+
+# T004: Smoke Tests and Release Artifacts
+
+## Acceptance Criteria
+
+- `make dist` builds all platforms and creates versioned tar/zip archives in `dist/`
+- Archive naming follows pattern: `savepoint-{version}-{platform}-{arch}.tar.gz` (or `.zip` for Windows)
+- Smoke test validates each binary starts and exits with code 0
+- Smoke test does not require interactive TUI (headless validation)
+- `dist/` contains both raw binaries and packaged archives
+
+## Implementation Plan
+
+- [ ] Add `dist` Makefile target that invokes all `build-*` targets
+- [ ] Create platform-appropriate archives (tar.gz for Unix, zip for Windows)
+- [ ] Add `smoke-test` target that runs each binary with `--help` or similar non-interactive flag
+- [ ] Add `.gitignore` entry for `dist/`
+- [ ] Document `make dist` in AGENTS.md
+
+## Context Log
+
+Files read:
+- `Makefile`
+- `AGENTS.md`
+
+Estimated input tokens: 500
+
+Notes:
+- Bubble Tea TUI may require special handling for headless smoke test
+- May need a CLI flag or environment variable to do a non-interactive run

package/.savepoint/router.md

@@ -20,7 +20,7 @@ state: task-building
 release: v1.1
 epic: E01-tui-optimisation
 task: E01-tui-optimisation/T001-border-resize-fix
-next_action: Execute T001 — Fix right-border clipping and resize robustness.
+next_action: Build v1.1 E01 T001 border resize fix.
 ```
 
 ## State → next action

package/.savepoint/visual-identity.md

@@ -20,9 +20,9 @@ A serious digital system that loves old arcade hardware. Dark, cinematic, playfu
 
 | Element       | Hex       | Role                          |
 | ------------- | --------- | ----------------------------- |
-| Background    | `#121212` | Main screen background        |
-| Surface       | `#0D0D0D` | Cards and panels              |
-| Surface 2     | `#0F0F0F` | Secondary panels / title bars |
+| Background    | `#000000` | Uniform terminal background   |
+| Surface       | `#000000` | Cards and panels; same black as background |
+| Surface 2     | `#000000` | Secondary panels / title bars; same black as background |
 | Border        | `#1A1A1A` | Quiet structural edges        |
 | Border Subtle | `#222222` | Slightly stronger separators  |
 | Primary Text  | `#F0E6DA` | Warm off-white terminal text  |
@@ -34,6 +34,7 @@ A serious digital system that loves old arcade hardware. Dark, cinematic, playfu
 
 - **Intentional accents.** One accent color per major section/type. Use for labels, hover, glows, active text — never giant background fills.
 - **Dark backgrounds.** Keep them dark so accents pop.
+- **Uniform terminal black.** In the TUI, Background, Surface, and Surface 2 intentionally remain the same black value. Do not reintroduce subtly different panel background fills; hierarchy comes from spacing, dividers, glyphs, and accent borders.
 - **Visual encoding.** Color semantically encodes categories or states; reinforce with minimal text.
 
 ## Typography

package/AGENTS.md

@@ -122,9 +122,9 @@ make clean # rm -f savepoint
 | Module                               | Purpose                                                                                              |
 | ------------------------------------ | ---------------------------------------------------------------------------------------------------- |
 | `main.go`                            | CLI Entrypoint and root command wiring                                                               |
-| `internal/board/`                    | TUI board components, models, layouts, transitions, and rendering logic                              |
-| `internal/data/`                     | Task data models, frontmatter parsing, project configuration, routing, and generic file readers      |
-| `internal/styles/`                   | Shared visual design system, TUI styling, and palettes                                               |
+| `internal/board/`                    | TUI board models, layout, rendering, overlays, task transitions, router priority markers, and fsnotify refresh |
+| `internal/data/`                     | Task/router/config models, frontmatter parsing, checklist state parsing, mtime-guarded writes, discovery, and generic file readers |
+| `internal/styles/`                   | Atari-Noir palette constants, terminal color fallbacks, shared TUI styles, semantic glyph/tag styles, and footer/header styling |
 | `cmd/`                               | Additional CLI subcommands (if any)                                                                  |
 | `templates/`                         | Default project scaffold markdown, YAML assets, and agent prompt templates                           |
 | `agent-skills/`                      | Custom skill guides for different agent phases (`draft-prd`, `audit`, etc.)                          |

package/README.md

@@ -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.

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

@@ -46,7 +46,6 @@ func newProjectModel(start string) (Model, error) {
 
 	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)
@@ -56,27 +55,56 @@ func newProjectModel(start string) (Model, error) {
 		}
 		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...)
 		}
 	}
 
+	tasks, err := loadAllTasks(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.Releases = releaseIDs
 	model.ReleaseEpics = releaseEpics
 	model.refreshEpicsForRelease()
 	model.refreshTasks()
 
+	watcher, err := newWatcher(root)
+	if err == nil {
+		model.Watcher = watcher
+	}
+
 	return model, nil
 }
 
+func loadAllTasks(root string) ([]data.Task, error) {
+	d := data.NewDiscover()
+	releases, err := d.ListReleases(root)
+	if err != nil {
+		return nil, err
+	}
+	var tasks []data.Task
+	for _, release := range releases {
+		epics, err := d.ListEpics(root, release.ID)
+		if err != nil {
+			return nil, err
+		}
+		for _, epic := range epics {
+			epicTasks, err := loadEpicTasks(d, root, release.ID, epic.ID)
+			if err != nil {
+				return nil, err
+			}
+			tasks = append(tasks, epicTasks...)
+		}
+	}
+	return tasks, nil
+}
+
 func readRouterState(root string) (*data.RouterState, error) {
 	content, err := os.ReadFile(filepath.Join(root, "router.md"))
 	if err != nil {
@@ -103,6 +131,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

package/internal/board/board_test.go

@@ -68,6 +68,40 @@ next_action: "test"
 	}
 }
 
+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)
+	}
+}
+
 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")
@@ -88,6 +122,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,22 @@ 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 routerTaskID matches t.ID, a green priority glyph replaces the phase glyph.
+func RenderCard(t data.Task, width int, focused bool, routerTaskID string) string {
 	inner := width - cardOverhead
 	if inner < 2 {
 		inner = 2
 	}
 
-	glyph := phaseGlyphStyled(t.Stage)
+	var glyph string
+	if routerTaskID != "" && t.ID == routerTaskID {
+		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