savepoint 1.0.0 → 1.0.2

package/internal/buildtool/main.go

@@ -0,0 +1,219 @@
+package main
+
+import (
+	"archive/tar"
+	"compress/gzip"
+	"errors"
+	"flag"
+	"fmt"
+	"io"
+	"os"
+	"os/exec"
+	"path/filepath"
+	"runtime"
+)
+
+type target struct {
+	os   string
+	arch string
+}
+
+var targets = []target{
+	{os: "linux", arch: "amd64"},
+	{os: "linux", arch: "arm64"},
+	{os: "darwin", arch: "amd64"},
+	{os: "darwin", arch: "arm64"},
+}
+
+var versionOverride string
+
+func main() {
+	if err := run(os.Args[1:]); err != nil {
+		fmt.Fprintln(os.Stderr, err)
+		os.Exit(1)
+	}
+}
+
+func run(args []string) error {
+	flags := flag.NewFlagSet("buildtool", flag.ContinueOnError)
+	flags.StringVar(&versionOverride, "version", "", "version to inject into the binary")
+	if err := flags.Parse(args); err != nil {
+		return err
+	}
+	if flags.NArg() != 1 {
+		return errors.New("usage: go run ./internal/buildtool [-version vX.Y.Z] <build|clean|build-linux|build-darwin|build-all|dist|smoke-test>")
+	}
+
+	switch flags.Arg(0) {
+	case "build":
+		return buildLocal()
+	case "clean":
+		return clean()
+	case "build-linux":
+		return buildMatching("linux")
+	case "build-darwin":
+		return buildMatching("darwin")
+	case "build-all":
+		return buildAll()
+	case "dist":
+		return dist()
+	case "smoke-test":
+		return smokeTest()
+	default:
+		return fmt.Errorf("unknown build target %q", flags.Arg(0))
+	}
+}
+
+func buildLocal() error {
+	return runGoBuild(localExecutable(), runtime.GOOS, runtime.GOARCH)
+}
+
+func clean() error {
+	for _, path := range []string{"savepoint", "savepoint.exe", "dist"} {
+		if err := os.RemoveAll(path); err != nil {
+			return fmt.Errorf("clean %s: %w", path, err)
+		}
+	}
+	return nil
+}
+
+func buildMatching(goos string) error {
+	for _, target := range targets {
+		if target.os != goos {
+			continue
+		}
+		if err := buildTarget(target); err != nil {
+			return err
+		}
+	}
+	return nil
+}
+
+func buildAll() error {
+	for _, target := range targets {
+		if err := buildTarget(target); err != nil {
+			return err
+		}
+	}
+	return nil
+}
+
+func buildTarget(target target) error {
+	output := filepath.Join("dist", target.os+"-"+target.arch, "savepoint")
+	return runGoBuild(output, target.os, target.arch)
+}
+
+func runGoBuild(output, goos, goarch string) error {
+	if err := os.MkdirAll(filepath.Dir(output), 0o755); err != nil && filepath.Dir(output) != "." {
+		return fmt.Errorf("create output dir: %w", err)
+	}
+
+	cmd := exec.Command("go", "build", "-ldflags", "-X main.version="+version(), "-o", output, "main.go")
+	cmd.Env = append(os.Environ(), "GOOS="+goos, "GOARCH="+goarch)
+	cmd.Stdout = os.Stdout
+	cmd.Stderr = os.Stderr
+	if err := cmd.Run(); err != nil {
+		return fmt.Errorf("build %s/%s: %w", goos, goarch, err)
+	}
+	return nil
+}
+
+func dist() error {
+	if err := buildAll(); err != nil {
+		return err
+	}
+	for _, target := range targets {
+		name := "savepoint-" + version() + "-" + target.os + "-" + target.arch + ".tar.gz"
+		source := filepath.Join("dist", target.os+"-"+target.arch, "savepoint")
+		archive := filepath.Join("dist", name)
+		if err := writeTarGz(archive, source, "savepoint"); err != nil {
+			return err
+		}
+	}
+	return nil
+}
+
+func writeTarGz(archivePath, sourcePath, archiveName string) error {
+	source, err := os.Open(sourcePath)
+	if err != nil {
+		return fmt.Errorf("open artifact source: %w", err)
+	}
+	defer source.Close()
+
+	info, err := source.Stat()
+	if err != nil {
+		return fmt.Errorf("stat artifact source: %w", err)
+	}
+
+	archive, err := os.Create(archivePath)
+	if err != nil {
+		return fmt.Errorf("create archive: %w", err)
+	}
+	defer archive.Close()
+
+	gzipWriter := gzip.NewWriter(archive)
+	defer gzipWriter.Close()
+
+	tarWriter := tar.NewWriter(gzipWriter)
+	defer tarWriter.Close()
+
+	header, err := tar.FileInfoHeader(info, "")
+	if err != nil {
+		return fmt.Errorf("create archive header: %w", err)
+	}
+	header.Name = archiveName
+	if err := tarWriter.WriteHeader(header); err != nil {
+		return fmt.Errorf("write archive header: %w", err)
+	}
+	if _, err := io.Copy(tarWriter, source); err != nil {
+		return fmt.Errorf("write archive content: %w", err)
+	}
+	return nil
+}
+
+func smokeTest() error {
+	if err := buildLocal(); err != nil {
+		return err
+	}
+	cmd := exec.Command("."+string(os.PathSeparator)+localExecutable(), "--version")
+	cmd.Stdout = os.Stdout
+	cmd.Stderr = os.Stderr
+	if err := cmd.Run(); err != nil {
+		return fmt.Errorf("smoke test: %w", err)
+	}
+	fmt.Println("smoke test passed")
+	return nil
+}
+
+func version() string {
+	if versionOverride != "" {
+		return versionOverride
+	}
+	if value := os.Getenv("VERSION"); value != "" {
+		return value
+	}
+
+	cmd := exec.Command("git", "describe", "--tags", "--abbrev=0")
+	output, err := cmd.Output()
+	if err == nil && len(output) > 0 {
+		return string(trimSpace(output))
+	}
+	return "v0.0.0"
+}
+
+func localExecutable() string {
+	if runtime.GOOS == "windows" {
+		return "savepoint.exe"
+	}
+	return "savepoint"
+}
+
+func trimSpace(value []byte) []byte {
+	for len(value) > 0 && (value[len(value)-1] == '\n' || value[len(value)-1] == '\r' || value[len(value)-1] == '\t' || value[len(value)-1] == ' ') {
+		value = value[:len(value)-1]
+	}
+	for len(value) > 0 && (value[0] == '\n' || value[0] == '\r' || value[0] == '\t' || value[0] == ' ') {
+		value = value[1:]
+	}
+	return value
+}

package/internal/data/parser.go

@@ -51,7 +51,7 @@ func (p *Parser) ParseTaskFile(path string, content string) (*Task, error) {
 		Points:      fields.Points,
 		Tags:        fields.Tags,
 		Acceptance:  firstList(fields.Acceptance, extractChecklistSection(content, "## Acceptance Criteria")),
-		Checklist:   extractChecklistSection(content, "## Implementation Plan"),
+		Checklist:   extractChecklistItems(content, "## Implementation Plan"),
 		Notes:       fields.Notes,
 		DependsOn:   fields.DependsOn,
 		Progress:    fields.Progress,
@@ -162,6 +162,44 @@ func firstList(values ...[]string) []string {
 	return nil
 }
 
+func extractChecklistItems(content, heading string) []CheckItem {
+	normalized := strings.ReplaceAll(content, "\r\n", "\n")
+	start := strings.Index(normalized, heading)
+	if start == -1 {
+		return nil
+	}
+
+	section := normalized[start+len(heading):]
+	if next := strings.Index(section, "\n## "); next != -1 {
+		section = section[:next]
+	}
+
+	items := []CheckItem{}
+	var current *CheckItem
+	for _, line := range strings.Split(section, "\n") {
+		trimmed := strings.TrimSpace(line)
+		if strings.HasPrefix(trimmed, "- [x] ") {
+			items = append(items, CheckItem{Text: strings.TrimSpace(trimmed[6:]), Done: true})
+			current = &items[len(items)-1]
+			continue
+		}
+		if strings.HasPrefix(trimmed, "- [ ] ") {
+			items = append(items, CheckItem{Text: strings.TrimSpace(trimmed[6:]), Done: false})
+			current = &items[len(items)-1]
+			continue
+		}
+		if strings.HasPrefix(trimmed, "- ") {
+			items = append(items, CheckItem{Text: strings.TrimSpace(trimmed[2:]), Done: false})
+			current = &items[len(items)-1]
+			continue
+		}
+		if trimmed != "" && current != nil {
+			current.Text = strings.TrimSpace(current.Text + " " + trimmed)
+		}
+	}
+	return items
+}
+
 func extractChecklistSection(content, heading string) []string {
 	normalized := strings.ReplaceAll(content, "\r\n", "\n")
 	start := strings.Index(normalized, heading)

package/internal/data/parser_test.go

@@ -210,7 +210,48 @@ Notes here.`
 	if len(task.Acceptance) != 2 || task.Acceptance[0] != "First criterion." || task.Acceptance[1] != "Second criterion." {
 		t.Errorf("Task.Acceptance = %v, want markdown criteria", task.Acceptance)
 	}
-	if len(task.Checklist) != 2 || task.Checklist[0] != "First checklist item." || task.Checklist[1] != "Second checklist item." {
-		t.Errorf("Task.Checklist = %v, want markdown checklist", task.Checklist)
+	if len(task.Checklist) != 2 {
+		t.Fatalf("Task.Checklist len = %d, want 2", len(task.Checklist))
+	}
+	if task.Checklist[0].Text != "First checklist item." || task.Checklist[0].Done {
+		t.Errorf("Task.Checklist[0] = %+v, want {Text:\"First checklist item.\", Done:false}", task.Checklist[0])
+	}
+	if task.Checklist[1].Text != "Second checklist item." || !task.Checklist[1].Done {
+		t.Errorf("Task.Checklist[1] = %+v, want {Text:\"Second checklist item.\", Done:true}", task.Checklist[1])
+	}
+}
+
+func TestParseTaskFile_joinsHardWrappedChecklistItems(t *testing.T) {
+	p := NewParser()
+	content := `---
+id: E06/T001
+status: planned
+objective: "Style the board"
+---
+
+# Task
+
+## Implementation Plan
+
+- [ ] First sentence spans across a hard markdown line break
+  before it ends. Second sentence stays in the same checklist item.
+- [x] Already checked sentence wraps
+  without becoming another checklist item.
+`
+
+	task, err := p.ParseTaskFile("test.md", content)
+	if err != nil {
+		t.Fatalf("ParseTaskFile() error = %v", err)
+	}
+	if len(task.Checklist) != 2 {
+		t.Fatalf("Task.Checklist len = %d, want 2", len(task.Checklist))
+	}
+	wantFirst := "First sentence spans across a hard markdown line break before it ends. Second sentence stays in the same checklist item."
+	if task.Checklist[0].Text != wantFirst || task.Checklist[0].Done {
+		t.Errorf("Task.Checklist[0] = %+v, want text %q and Done=false", task.Checklist[0], wantFirst)
+	}
+	wantSecond := "Already checked sentence wraps without becoming another checklist item."
+	if task.Checklist[1].Text != wantSecond || !task.Checklist[1].Done {
+		t.Errorf("Task.Checklist[1] = %+v, want text %q and Done=true", task.Checklist[1], wantSecond)
 	}
 }

package/internal/data/task.go

@@ -1,6 +1,14 @@
 package data
 
-import "fmt"
+import (
+	"fmt"
+	"time"
+)
+
+type CheckItem struct {
+	Text string
+	Done bool
+}
 
 type ColumnType string
 
@@ -18,6 +26,15 @@ const (
 	StageAudit ProgressStage = "audit"
 )
 
+type TaskStatus string
+
+const (
+	StatusPlanned    TaskStatus = "planned"
+	StatusInProgress TaskStatus = "in_progress"
+	StatusDone       TaskStatus = "done"
+	StatusAudited    TaskStatus = "audited"
+)
+
 type Progress struct {
 	Stage   ProgressStage `yaml:"stage"`
 	Started bool          `yaml:"started"`
@@ -27,6 +44,7 @@ type Task struct {
 	ID          string        `yaml:"id"`
 	Title       string        `yaml:"title"`
 	Description string        `yaml:"description,omitempty"`
+	Status      string        `yaml:"status,omitempty"`
 	Epic        string        `yaml:"epic"`
 	Release     string        `yaml:"release"`
 	Column      ColumnType    `yaml:"column"`
@@ -35,10 +53,12 @@ type Task struct {
 	Points      int           `yaml:"points,omitempty"`
 	Tags        []string      `yaml:"tags,omitempty"`
 	Acceptance  []string      `yaml:"acceptance,omitempty"`
-	Checklist   []string      `yaml:"checklist,omitempty"`
+	Checklist   []CheckItem   `yaml:"checklist,omitempty"`
 	Notes       string        `yaml:"notes,omitempty"`
 	DependsOn   []string      `yaml:"depends_on,omitempty"`
 	Progress    Progress      `yaml:"progress,omitempty"`
+	Path        string        `yaml:"-"`
+	Mtime       time.Time     `yaml:"-"`
 }
 
 func (t Task) String() string {

package/internal/styles/palette.go

@@ -1,10 +1,12 @@
 package styles
 
-// Truecolor hex constants (Atari-Noir palette)
+// Truecolor hex constants (Atari-Noir palette).
+// Background, Surface, and Surface2 intentionally share one black value so the
+// terminal stays visually flat; hierarchy comes from spacing, dividers, and accents.
 const (
-	Background   = "#121212"
-	Surface      = "#0D0D0D"
-	Surface2     = "#0F0F0F"
+	Background   = "#000000"
+	Surface      = "#000000"
+	Surface2     = "#000000"
 	Border       = "#1A1A1A"
 	BorderSubtle = "#222222"
 	PrimaryText  = "#F0E6DA"
@@ -15,9 +17,9 @@ const (
 
 // 256-color (ANSI256) fallbacks — nearest terminal approximations
 const (
-	Background256   = "233"
-	Surface256      = "232"
-	Surface2256     = "232"
+	Background256   = "16"
+	Surface256      = "16"
+	Surface2256     = "16"
 	Border256       = "234"
 	BorderSubtle256 = "235"
 	PrimaryText256  = "230"

package/internal/styles/styles.go

@@ -10,13 +10,15 @@ var (
 	clrOrange      = color(AtariOrange, AtariOrange256, AtariOrange16)
 	clrText        = color(PrimaryText, PrimaryText256, PrimaryText16)
 	clrBorder      = color(BorderSubtle, BorderSubtle256, BorderSubtle16)
-	clrSurface     = color(Surface2, Surface2256, Surface216) // #0F0F0F
-	clrSurfaceDark = color(Surface, Surface256, Surface16)    // #0D0D0D
+	clrSurface     = color(Surface2, Surface2256, Surface216) // intentionally black
+	clrSurfaceDark = color(Surface, Surface256, Surface16)    // intentionally black
 	clrGreen       = color(NPPGreen, NPPGreen256, NPPGreen16)
 	clrPurple      = color(VibePurple, VibePurple256, VibePurple16)
 	clrDim         = color(Dim, Dim256, Dim16)
 )
 
+var boxBorder = lipgloss.NormalBorder()
+
 var (
 	HeaderIcon = lipgloss.NewStyle().
 			Foreground(clrOrange).
@@ -29,25 +31,21 @@ var (
 		Foreground(clrBorder)
 
 	HeaderFrame = lipgloss.NewStyle().
-			BorderStyle(lipgloss.RoundedBorder()).
-			BorderForeground(clrBorder).
 			Padding(1, 1)
 
-	BoardFrame = lipgloss.NewStyle().
-			BorderStyle(lipgloss.RoundedBorder()).
-			BorderForeground(clrBorder).
-			Padding(0, 1)
+	BoardFrame = lipgloss.NewStyle()
 
 	Column = lipgloss.NewStyle().
-		BorderStyle(lipgloss.RoundedBorder()).
-		BorderForeground(clrBorder).
-		Background(clrSurfaceDark).
 		Padding(0, 1)
 
+	ColumnUnfocused = lipgloss.NewStyle().
+			BorderStyle(boxBorder).
+			BorderForeground(clrBorder).
+			Padding(0, 1)
+
 	ColumnFocused = lipgloss.NewStyle().
-			BorderStyle(lipgloss.RoundedBorder()).
+			BorderStyle(boxBorder).
 			BorderForeground(clrOrange).
-			Background(clrSurfaceDark).
 			Padding(0, 1)
 
 	ColumnTitle = lipgloss.NewStyle().
@@ -65,38 +63,52 @@ var (
 			Foreground(clrOrange)
 
 	StatusBar = lipgloss.NewStyle().
-			Foreground(clrText).
-			Background(clrSurface)
+			Foreground(clrText)
 
 	EpicPanel = lipgloss.NewStyle().
-			BorderStyle(lipgloss.RoundedBorder()).
-			BorderForeground(clrPurple).
-			Background(clrSurface).
+			BorderStyle(boxBorder).
+			BorderForeground(clrBorder).
 			Padding(0, 1)
 
+	EpicItemFocused = lipgloss.NewStyle().
+			Foreground(clrPurple)
+
+	EpicTitleFocused = lipgloss.NewStyle().
+				Foreground(clrPurple).
+				Bold(true)
+
+	EpicPanelFocused = lipgloss.NewStyle().
+				BorderStyle(boxBorder).
+				BorderForeground(clrPurple).
+				Padding(0, 1)
+
 	Card = lipgloss.NewStyle().
-		BorderStyle(lipgloss.RoundedBorder()).
-		BorderForeground(clrBorder).
-		Background(clrSurface).
 		Padding(0, 1)
 
 	CardFocused = lipgloss.NewStyle().
-			BorderStyle(lipgloss.RoundedBorder()).
+			BorderStyle(boxBorder).
 			BorderForeground(clrOrange).
-			Background(clrSurface).
 			Padding(0, 1)
 
-	CardMeta = lipgloss.NewStyle().Foreground(clrDim)
+	CardMeta        = lipgloss.NewStyle().Foreground(clrDim)
+	ScrollIndicator = lipgloss.NewStyle().
+			Foreground(clrDim).
+			Faint(true)
 
 	GlyphBuild = lipgloss.NewStyle().Foreground(clrOrange)
 	GlyphTest  = lipgloss.NewStyle().Foreground(clrGreen)
 	GlyphAudit = lipgloss.NewStyle().Foreground(clrPurple)
 
 	DetailOverlay = lipgloss.NewStyle().
-			BorderStyle(lipgloss.RoundedBorder()).
+			BorderStyle(boxBorder).
 			BorderForeground(clrOrange).
 			Padding(0, 1)
 
+	EpicDetailOverlay = lipgloss.NewStyle().
+				BorderStyle(boxBorder).
+				BorderForeground(clrPurple).
+				Padding(0, 1)
+
 	// Footer phase styles
 	FooterPhasePlan = lipgloss.NewStyle().
 			Foreground(clrPurple).
@@ -116,6 +128,11 @@ var (
 	FooterHints = lipgloss.NewStyle().
 			Foreground(clrDim)
 
+	HeaderRight = lipgloss.NewStyle().
+			Foreground(clrDim)
+
+	RootLine = lipgloss.NewStyle()
+
 	// Tag styles for semantic encoding
 	TagDone = lipgloss.NewStyle().Foreground(clrGreen)
 	TagAI   = lipgloss.NewStyle().Foreground(clrPurple)

package/main.go

@@ -1,10 +1,19 @@
 package main
 
 import (
+	"fmt"
+	"os"
+
 	"github.com/opencode/savepoint/internal/board"
 )
 
+var version = "dev"
+
 func main() {
+	if len(os.Args) > 1 && os.Args[1] == "--version" {
+		fmt.Println(version)
+		os.Exit(0)
+	}
 	if err := board.Run(); err != nil {
 		panic(err)
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "savepoint",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "It’s a simple, file-based state machine and cinematic Terminal UI (TUI) designed to force you—and your agent (Claude, Cursor, Aider, Gemini)—to slow down, write down what you're actually building, and check your work before moving on.",
   "keywords": [
     "board",
@@ -17,9 +17,10 @@
   },
   "license": "MIT",
   "author": "anipatke",
-  "type": "Go",
-  "main": "main.go",
+  "bin": {
+    "savepoint": "./savepoint"
+  },
   "scripts": {
     "test": "savepoint init"
   }
-}
+}

package/templates/project/.savepoint/router.md

@@ -9,7 +9,7 @@ This file routes the agent based on the project's current state. Read this whene
 3. The active epic Design
 4. The active task file, when a task is selected
 
-Read `.savepoint/PRD.md` only for project vision changes. Read `.savepoint/Design.md` only for architecture changes or audit closeout. Read `.savepoint/releases/v{{RELEASE_NUMBER}}/PRD.md` only for release planning or epic-order questions.
+Read `.savepoint/PRD.md` only for project vision changes. Read `.savepoint/Design.md` only for architecture changes or audit closeout. Read `.savepoint/releases/{release}/{release}-PRD.md` only for release planning or epic-order questions.
 
 **Conditional read (token discipline):** if your active task touches **Ink/TUI implementation**, also read `agent-skills/ink-tui-design/SKILL.md` after Design.md as the execution guide. If it touches **TUI rendering, theme, or visual design**, also read `.savepoint/visual-identity.md` as the visual guardrails. Otherwise skip the extra files — they are tokens you do not need.
 
@@ -30,7 +30,7 @@ If the user explicitly asks you to audit an epic, perform the audit for that epi
 Persist the audit artifacts before replying:
 
 - Ensure `.savepoint/audit/{E##-epic}/snapshot.md` exists. Create a manual snapshot once if needed.
-- Write the proposal bundle to `.savepoint/audit/{E##-epic}/proposals.md`.
+- Write the proposal bundle to `.savepoint/audit/{release}/{E##-epic}/proposals.md`.
 - Do not stop at chat-only findings. The filesystem artifact is part of the task output.
 
 ## State → next action
@@ -43,9 +43,9 @@ The project has its PRD and Design locked but no epics defined yet.
 
 **Next action:**
 
-1. Read `.savepoint/releases/v{{RELEASE_NUMBER}}/PRD.md` — the v{{RELEASE_NUMBER}} release scope (epic list lives there).
+1. Read `.savepoint/releases/{release}/{release}-PRD.md` — the release scope (epic list lives there).
 2. Help the user define the epics list and confirm priority.
-3. For each epic in order, create the directory `.savepoint/releases/v{{RELEASE_NUMBER}}/epics/E##-{epic-name}/` with a `Design.md` stub.
+3. For each epic in order, create the directory `.savepoint/releases/{release}/epics/E##-{epic-name}/` with a `Design.md` stub.
 4. When epic E01 (scaffolding) is created, transition to `state: epic-design` for that epic.
 
 **Do not** start writing code. We are still in planning.
@@ -70,7 +70,7 @@ Epic Design exists but tasks are missing or not fully planned.
 
 1. Re-read the epic Design.
 2. Create or update the full epic task list — each task **independently buildable**, **objective-led**, with declared `depends_on`.
-3. Each task file lives at `.savepoint/releases/v{{RELEASE_NUMBER}}/epics/{E##-epic}/tasks/TNNN-slug.md` with frontmatter:
+3. Each task file lives at `.savepoint/releases/{release}/epics/{E##-epic}/tasks/TNNN-slug.md` with frontmatter:
    ```yaml
    ---
    id: {E##-epic}/TNNN-slug
@@ -150,3 +150,4 @@ If you are not Claude Opus / Gemini 2.5 Pro / GPT-5.5 / equivalent, surface a wa
 > _"Heads up — I'm running on a lighter model. Savepoint's planning steps work best with top-tier models because the embedded prompts are detailed. I'll do my best, but consider switching the model for PRD/Design/Task-breakdown steps."_
 
 Then proceed.
+ proceed.