gitFlow/internal/presenter/compact.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

64 lines
1.5 KiB
Go

package presenter
import (
"fmt"
"io"
"gitea.oblak.solutions/dimitar/gitFlow/pkg/status"
)
// CompactFormatter renders one line per repository with color-coded status
// symbols, aimed at dense terminals and dashboards.
type CompactFormatter struct {
opts Options
}
// Format implements Formatter.
func (c *CompactFormatter) Format(w io.Writer, result status.ScanResult) error {
r := newRendererTheme(c.opts.Color, c.opts.Theme, w)
for _, repo := range result.Repos {
sym := statusSymbol(repo.Status)
line := r.paint(repo.Status, sym) + " " + shortPath(repo.Path)
if repo.Branch != "" && !repo.Detached {
line += " (" + repo.Branch + ")"
}
if repo.AheadBy > 0 || repo.BehindBy > 0 {
line += fmt.Sprintf(" +%d/-%d", repo.AheadBy, repo.BehindBy)
}
if n := repo.FileCount(); n > 0 {
line += fmt.Sprintf(" %d change(s)", n)
}
if repo.Status == status.StatusError {
line += ": " + repo.Error
}
if _, err := fmt.Fprintln(w, line); err != nil {
return err
}
}
return nil
}
// statusSymbol returns a single-character status marker.
func statusSymbol(s status.RepoStatus) string {
switch s {
case status.StatusClean:
return "✓"
case status.StatusModified:
return "✗"
case status.StatusAhead:
return "↑"
case status.StatusBehind:
return "↓"
case status.StatusDiverged:
return "⇄"
case status.StatusDetached:
return "◉"
case status.StatusBare:
return "▢"
case status.StatusError:
return "!"
default:
return "?"
}
}