feat: add verbosity flag

cmd/root.go

@@ -44,6 +44,7 @@ func NewCmdRoot(version string) *cobra.Command {
 	})
 
 	rootCmd.PersistentFlags().StringVar(&cfgFile, "config", "", "config file (default is $HOME/.sparrow.yaml)")
+	rootCmd.PersistentFlags().BoolP("verbosity", "v", false, "Enable verbose logging for enhanced visibility and troubleshooting")
 
 	return rootCmd
 }

cmd/run.go

@@ -21,6 +21,8 @@ package cmd
 import (
 	"context"
 	"fmt"
+	"log/slog"
+	"os"
 	"time"
 
 	"github.com/spf13/cobra"
@@ -64,7 +66,14 @@ func NewCmdRun() *cobra.Command {
 // run is the entry point to start the sparrow
 func run() func(cmd *cobra.Command, args []string) error {
 	return func(cmd *cobra.Command, args []string) error {
+		v, _ := cmd.Flags().GetBool("verbosity")
 		log := logger.NewLogger()
+		if v {
+			log = logger.NewLogger(slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{
+				AddSource: true,
+				Level:     slog.LevelDebug,
+			}))
+		}
 		ctx := logger.IntoContext(context.Background(), log)
 
 		cfg := config.NewConfig()

docs/sparrow.md

@@ -12,6 +12,7 @@ The check results are exposed via an API.
 ```
       --config string   config file (default is $HOME/.sparrow.yaml)
   -h, --help            help for sparrow
+  -v, --verbosity       Enable verbose logging for enhanced visibility and troubleshooting
 ```
 
 ### SEE ALSO

docs/sparrow_run.md

@@ -30,6 +30,7 @@ sparrow run [flags]
 
 ```
       --config string   config file (default is $HOME/.sparrow.yaml)
+  -v, --verbosity       Enable verbose logging for enhanced visibility and troubleshooting
 ```
 
 ### SEE ALSO

internal/logger/logger.go

@@ -36,7 +36,7 @@ func NewLogger(h ...slog.Handler) *slog.Logger {
 	if len(h) > 0 {
 		handler = h[0]
 	} else {
-		handler = slog.NewJSONHandler(os.Stderr, &slog.HandlerOptions{
+		handler = slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{
 			AddSource: true,
 		})
 	}