preflight

type FileChange ¶

type FileChange struct {
	Status string // e.g. "M", "A", "D", "R"
	Path   string
}

FileChange represents a single file changed in the snapshot.

func (f FileChange) StatusSymbol() string

type Region ¶

type Region struct {
	// contains filtered or unexported fields
}

Region is a named section of a Screen that can be independently updated. All methods are safe for concurrent use.

func (r *Region) AppendLine(line string)

func (r *Region) SetLines(lines []string)

type Screen ¶

type Screen struct {
	// contains filtered or unexported fields
}

Screen manages multiple named regions on a terminal, each independently rewritable. Regions are rendered top-to-bottom in insertion order.

Usage:

s := NewScreen(os.Stdout)
completed := s.AddRegion("completed")
jobs := s.AddRegion("jobs")
status := s.AddRegion("status")

jobs.SetLines([]string{"  ● lint  running", "  ● test  running"})
status.SetLines([]string{"  ⠋ Watching…"})

// Promote a completed job:
completed.AppendLine("  ✓ lint  passed")

// Update active jobs:
jobs.SetLines([]string{"  ● test  running"})

func NewScreen(w *os.File) *Screen

func (s *Screen) AddRegion(id string) *Region

func (s *Screen) Flush()

type SnapshotOption ¶

type SnapshotOption func(*snapshotConfig)

SnapshotOption configures Snapshot behavior.

func WithDebug() SnapshotOption

type SnapshotResult ¶

type SnapshotResult struct {
	Commit string
	Ref    string
	Branch string
	Files  []FileChange
}

SnapshotResult holds the output of a successful snapshot operation.

func Snapshot(dir string, preflightID uuid.UUID, opts ...SnapshotOption) (*SnapshotResult, error)