dimitar
012fbf8ac5
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).
78 lines
2.1 KiB
Go
78 lines
2.1 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"os"
|
|
"os/signal"
|
|
"syscall"
|
|
|
|
"github.com/spf13/cobra"
|
|
|
|
"gitea.oblak.solutions/dimitar/gitFlow/internal/version"
|
|
)
|
|
|
|
// newRootCmd builds the top-level gitflow command.
|
|
func newRootCmd() *cobra.Command {
|
|
root := &cobra.Command{
|
|
Use: "gitflow",
|
|
Short: "Scan Git repositories and get suggested next steps",
|
|
Long: `gitflow discovers every Git repository under a parent directory,
|
|
scans each one's status, and presents the findings. It can rescan on a
|
|
schedule and, when enabled, uses an AI agent to suggest next actions for
|
|
repositories that need attention.`,
|
|
SilenceUsage: true,
|
|
SilenceErrors: true,
|
|
}
|
|
root.AddCommand(
|
|
newScanCmd(),
|
|
newWatchCmd(),
|
|
newConfigCmd(),
|
|
newVersionCmd(),
|
|
newCompletionCmd(root),
|
|
)
|
|
return root
|
|
}
|
|
|
|
// newCompletionCmd generates shell completion scripts for the root command.
|
|
func newCompletionCmd(root *cobra.Command) *cobra.Command {
|
|
return &cobra.Command{
|
|
Use: "completion [bash|zsh|fish|powershell]",
|
|
Short: "Generate a shell completion script",
|
|
Args: cobra.ExactArgs(1),
|
|
RunE: func(cmd *cobra.Command, args []string) error {
|
|
switch args[0] {
|
|
case "bash":
|
|
return root.GenBashCompletion(os.Stdout)
|
|
case "zsh":
|
|
return root.GenZshCompletion(os.Stdout)
|
|
case "fish":
|
|
return root.GenFishCompletion(os.Stdout, true)
|
|
case "powershell":
|
|
return root.GenPowerShellCompletion(os.Stdout)
|
|
default:
|
|
return fmt.Errorf("unknown shell %q (want bash, zsh, fish, or powershell)", args[0])
|
|
}
|
|
},
|
|
}
|
|
}
|
|
|
|
// signalContext returns a context that is cancelled on SIGINT/SIGTERM so
|
|
// scans and watch loops shut down gracefully.
|
|
func signalContext() (context.Context, context.CancelFunc) {
|
|
return signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
|
|
}
|
|
|
|
// newVersionCmd prints the build version.
|
|
func newVersionCmd() *cobra.Command {
|
|
return &cobra.Command{
|
|
Use: "version",
|
|
Short: "Print version information",
|
|
Args: cobra.NoArgs,
|
|
RunE: func(cmd *cobra.Command, _ []string) error {
|
|
fmt.Printf("gitflow %s\n", version.Version)
|
|
return nil
|
|
},
|
|
}
|
|
}
|