gitFlow/internal/presenter/table.go
dimitar 012fbf8ac5 feat: phase 6 — polish: completions, notifications, themes, rules, docs
Close out the plan with the remaining polish items and a full README.

Shell completions (cmd/gitflow):
- New `completion [bash|zsh|fish|powershell]` command backed by cobra's
  generators, wired into the root command

Desktop notifications (internal/notify):
- Send() dispatches to notify-send (Linux) with an osascript fallback
  (macOS); Windows is a documented no-op for now; missing notifiers are
  silent, never errors
- watch --notify sends a notification listing repositories whose state
  changed since the previous frame

Color themes (internal/presenter):
- ThemeMode (dark/light) with ParseTheme; light uses bright ANSI variants
  (90-97) that stay legible on light backgrounds; threaded through the
  table, compact, and suggestions renderers; new --theme flag validated
  and dumped by config

Custom rules (internal/rules):
- Rule{name, field (ahead|behind|stash|changes), op (==,!=,<,<=,>,>=),
  value, label} with upfront validation in both Validate and Eval
- Config gains a `rules:` section (yaml/env only, no flag), validated at
  load; matches render as a "FLAGS (custom rules)" section via a new
  presenter.Flags renderer, shown in scan and watch frames

Docs:
- readme.md fully rewritten: features, install, usage, examples, flag
  table, status classes, configuration reference, AI agent behavior and
  --ai-execute guardrails, development layout, CI, and future work
- implementation.md gains an Implementation Progress section recording
  every phase branch and the deviations from the original plan

Multi-platform:
- Verified cross-compilation for windows/amd64 and darwin/arm64; the
  notify package is split behind build tags

Testing:
- rules: validation, operator semantics, Eval ordering, invalid-rule
  errors
- presenter: ParseTheme, light-theme bright codes (and absence of
  dark-theme codes), Flags rendering (empty = silent, matches render)
- config: rules loading from file, invalid-rule rejection, bad theme and
  bad provider rejection
- notify: no-op behaviour when no notifier is installed (skipped when one
  is, to avoid firing real notifications)

Verified: go build, go vet, go test -race (10 packages), gofmt clean,
windows/darwin cross-compile, completion generation, rules + light theme
smoke test, watch --notify graceful shutdown (exit 0, no orphans).
2026-08-02 08:52:50 +02:00

76 lines
2.0 KiB
Go

package presenter
import (
"fmt"
"io"
"strconv"
"strings"
"text/tabwriter"
"gitea.oblak.solutions/dimitar/gitFlow/pkg/status"
)
// TableFormatter renders repositories as an aligned terminal table followed
// by a summary line.
type TableFormatter struct {
opts Options
}
// Format implements Formatter.
func (t *TableFormatter) Format(w io.Writer, result status.ScanResult) error {
r := newRendererTheme(t.opts.Color, t.opts.Theme, w)
tw := tabwriter.NewWriter(w, 2, 4, 2, ' ', 0)
fmt.Fprintln(tw, "REPOSITORY\tBRANCH\tSTATUS\tAHEAD/BEHIND\tCHANGES\tSTASH")
for _, repo := range result.Repos {
branch := repo.Branch
if branch == "" {
branch = "-"
}
ab := "-"
if repo.Status != status.StatusError && (repo.RemoteURL != "" || repo.AheadBy > 0 || repo.BehindBy > 0) {
ab = fmt.Sprintf("%d/%d", repo.AheadBy, repo.BehindBy)
}
changes := "-"
switch {
case repo.Status == status.StatusError:
changes = repo.Error
case repo.FileCount() > 0:
changes = summarizeChanges(repo)
}
stash := "-"
if repo.StashCount > 0 {
stash = strconv.Itoa(repo.StashCount)
}
fmt.Fprintf(tw, "%s\t%s\t%s\t%s\t%s\t%s\n",
shortPath(repo.Path), branch, r.paint(repo.Status, repo.Status.String()), ab, changes, stash)
}
if err := tw.Flush(); err != nil {
return err
}
s := result.Summary()
label := "repos"
if s.Total == 1 {
label = "repo"
}
fmt.Fprintf(w, "\n%d %s | %s clean | %d need attention | %d errors\n",
s.Total, label, r.paint(status.StatusClean, strconv.Itoa(s.Clean)), s.Attention, s.Errored)
return nil
}
// summarizeChanges renders staged/modified/untracked counts, e.g. "2M 1U".
func summarizeChanges(repo status.RepoInfo) string {
parts := make([]string, 0, 3)
if n := len(repo.StagedFiles); n > 0 {
parts = append(parts, fmt.Sprintf("%dS", n))
}
if n := len(repo.ModifiedFiles); n > 0 {
parts = append(parts, fmt.Sprintf("%dM", n))
}
if n := len(repo.UntrackedFiles); n > 0 {
parts = append(parts, fmt.Sprintf("%dU", n))
}
return strings.Join(parts, " ")
}