refactor: unify verbosity levels and remove quiet flag (#30) (#30)

* refactor: unify verbosity levels and remove quiet flag (#30)

* fix: remove unused verbosity helper for lint

Author: laggu

CLAUDE.md

@@ -28,7 +28,7 @@ go mod download
 ## 아키텍처
 
 ### CLI 구조 (Cobra 기반)
-- `cmd/root.go` - 루트 명령어 및 전역 플래그 (`--config`, `--verbose`, `--quiet`)
+- `cmd/root.go` - 루트 명령어 및 전역 플래그 (`--config`, `--verbose`)
 - `cmd/*.go` - 각 서브커맨드 (init, sync, unsync, list, add, version)
 
 ### 핵심 패키지 (`internal/gitvolume`)

README.md

@@ -144,8 +144,7 @@ volumes:
 | ----------------- | ---------------- | ---------------------------------------------- |
 | `--dry-run`       | `sync`, `unsync` | Show what would be done without making changes |
 | `--relative`      | `sync`           | Create relative symlinks instead of absolute   |
-| `--verbose`, `-v` | All              | Verbose output                                 |
-| `--quiet`, `-q`   | All              | Suppress non-error output                      |
+| `--verbose`, `-v` | All              | Verbosity level: 0=errors only, 1=normal (default), 2=detailed |
 | `--config`, `-c`  | All              | Custom config file path                        |
 
 ## 🛡️ Safety Features

cmd/global.go

@@ -26,7 +26,7 @@ var globalListCmd = &cobra.Command{
 	Long:         `Displays a tree of all files currently stored in the global git-volume directory.`,
 	SilenceUsage: true,
 	RunE: func(cmd *cobra.Command, args []string) error {
-		gv, err := gitvolume.New(gitvolume.Options{Quiet: quiet})
+		gv, err := gitvolume.New(commandOptions(false))
 		if err != nil {
 			return err
 		}

cmd/global_add.go

@@ -34,7 +34,7 @@ Examples:
 	Args:         cobra.MinimumNArgs(1),
 	SilenceUsage: true,
 	RunE: func(cmd *cobra.Command, args []string) error {
-		gv, err := gitvolume.New(gitvolume.Options{Quiet: quiet})
+		gv, err := gitvolume.New(commandOptions(false))
 		if err != nil {
 			return err
 		}

cmd/global_edit.go

@@ -21,7 +21,7 @@ Examples:
 	Args:         cobra.ExactArgs(1),
 	SilenceUsage: true,
 	RunE: func(cmd *cobra.Command, args []string) error {
-		gv, err := gitvolume.New(gitvolume.Options{Quiet: quiet})
+		gv, err := gitvolume.New(commandOptions(false))
 		if err != nil {
 			return err
 		}

cmd/global_remove.go

@@ -21,7 +21,7 @@ Examples:
 	SilenceUsage: true,
 	Aliases:      []string{"rm"},
 	RunE: func(cmd *cobra.Command, args []string) error {
-		gv, err := gitvolume.New(gitvolume.Options{Quiet: quiet})
+		gv, err := gitvolume.New(commandOptions(false))
 		if err != nil {
 			return err
 		}

cmd/init.go

@@ -16,7 +16,7 @@ var initCmd = &cobra.Command{
 git-volume.yaml configuration file in the current directory.`,
 	SilenceUsage: true,
 	RunE: func(cmd *cobra.Command, args []string) error {
-		gv, err := gitvolume.New(gitvolume.Options{Quiet: quiet})
+		gv, err := gitvolume.New(commandOptions(false))
 		if err != nil {
 			return err
 		}

cmd/root.go

@@ -4,14 +4,16 @@ Copyright © 2026 laggu
 package cmd
 
 import (
+	"fmt"
+
+	"github.com/laggu/git-volume/internal/gitvolume"
 	"github.com/spf13/cobra"
 )
 
 // Global flags
 var (
-	cfgFile string
-	verbose bool
-	quiet   bool
+	cfgFile   string
+	verbosity int
 )
 
 // rootCmd represents the base command when called without any subcommands
@@ -22,16 +24,32 @@ var rootCmd = &cobra.Command{
 by dynamically mounting them using a git-volume.yaml manifest.
 
 "Keep code in Git, mount environments as volumes."`,
+	PersistentPreRunE: func(cmd *cobra.Command, args []string) error {
+		if verbosity < gitvolume.VerbosityQuiet || verbosity > gitvolume.VerbosityDetailed {
+			return fmt.Errorf("invalid --verbose level %d (allowed: 0, 1, 2)", verbosity)
+		}
+
+		return nil
+	},
 }
 
 // Execute adds all child commands to the root command and sets flags appropriately.
 func Execute() error {
 	return rootCmd.Execute()
 }
 
+func commandOptions(useConfig bool) gitvolume.Options {
+	opts := gitvolume.Options{Verbosity: verbosity}
+	if useConfig {
+		opts.ConfigPath = cfgFile
+	}
+	return opts
+}
+
 func init() {
 	rootCmd.PersistentFlags().StringVarP(&cfgFile, "config", "c", "", "config file path (default: auto-detected)")
-	rootCmd.PersistentFlags().BoolVarP(&verbose, "verbose", "v", false, "verbose output")
-	rootCmd.PersistentFlags().BoolVarP(&quiet, "quiet", "q", false, "suppress non-error output")
-	rootCmd.MarkFlagsMutuallyExclusive("verbose", "quiet")
+	rootCmd.PersistentFlags().IntVarP(&verbosity, "verbose", "v", gitvolume.VerbosityNormal, "verbosity level (0=errors only, 1=normal, 2=detailed)")
+	if flag := rootCmd.PersistentFlags().Lookup("verbose"); flag != nil {
+		flag.NoOptDefVal = "2"
+	}
 }

cmd/status.go

@@ -14,10 +14,7 @@ var statusCmd = &cobra.Command{
 	Short:        "Show the status of all volumes",
 	SilenceUsage: true,
 	RunE: func(cmd *cobra.Command, args []string) error {
-		gv, err := gitvolume.New(gitvolume.Options{
-			ConfigPath: cfgFile,
-			Quiet:      quiet,
-		})
+		gv, err := gitvolume.New(commandOptions(true))
 		if err != nil {
 			return err
 		}

cmd/sync.go

@@ -24,11 +24,7 @@ It checks the current directory for git-volume.yaml first. If not found,
 it looks for it in the main Git worktree (inheritance).`,
 	SilenceUsage: true,
 	RunE: func(cmd *cobra.Command, args []string) error {
-		gv, err := gitvolume.New(gitvolume.Options{
-			ConfigPath: cfgFile,
-			Verbose:    verbose,
-			Quiet:      quiet,
-		})
+		gv, err := gitvolume.New(commandOptions(true))
 		if err != nil {
 			return err
 		}