feat: Add config support for UI verbosity level (#175)

* feat: Add config support for UI verbosity level

* docs: Add verbosity info in UI doc

config/config.go

@@ -14,6 +14,11 @@ import (
 )
 
 const (
+	// Verbosity level constants for the config file
+	VerbositySilent  = "silent"
+	VerbosityNormal  = "normal"
+	VerbosityVerbose = "verbose"
+
 	// Environment variable key for the insecure installation flag
 	pmgInsecureInstallationEnvKey = "PMG_INSECURE_INSTALLATION"
 
@@ -64,6 +69,9 @@ type Config struct {
 	// we initially introduced it as an experimental feature.
 	ExperimentalProxyMode bool `mapstructure:"experimental_proxy_mode"`
 
+	// Verbosity controls the UI verbosity level. Valid values: "silent", "normal", "verbose".
+	Verbosity string `mapstructure:"verbosity"`
+
 	// Sandbox enables sandboxing of package manager processes with controlled filesystem,
 	// network, and process execution access. Provides defense-in-depth against supply chain attacks.
 	Sandbox SandboxConfig `mapstructure:"sandbox"`
@@ -211,6 +219,7 @@ func DefaultConfig() RuntimeConfig {
 			ExperimentalProxyMode:  false,
 			TrustedPackages:        []TrustedPackage{},
 			ProxyMode:              true,
+			Verbosity:              VerbosityNormal,
 			Sandbox: SandboxConfig{
 				Enabled:       false,
 				EnforceAlways: false,

config/config.template.yml

@@ -10,6 +10,12 @@ transitive_depth: 5
 # Include dev dependencies in the dependency graph. Default is false.
 include_dev_dependencies: false
 
+# UI verbosity level. Valid values: silent, normal, verbose. Default is normal.
+# silent: PMG is hidden from the user except for errors and malicious package detection
+# normal: Show minimal status updates
+# verbose: Show verbose status updates and detailed information
+verbosity: normal
+
 # Enable paranoid mode. In paranoid mode, PMG will treat suspicious packages
 # as malicious packages
 paranoid: false

config/config_template_test.go

@@ -54,6 +54,7 @@ func TestTemplateMatchesDefaults(t *testing.T) {
 	assert.Equal(t, def.Paranoid, parsed.Paranoid, "paranoid mismatch")
 	assert.Equal(t, def.SkipEventLogging, parsed.SkipEventLogging, "skip_event_logging mismatch")
 	assert.Equal(t, def.EventLogRetentionDays, parsed.EventLogRetentionDays, "event_log_retention_days mismatch")
+	assert.Equal(t, def.Verbosity, parsed.Verbosity, "verbosity mismatch")
 
 	assert.NotEmpty(t, parsed.TrustedPackages, "expected at least one trusted_packages entry")
 

docs/ui.md

@@ -2,6 +2,8 @@
 
 PMG is an interactive tool. We support multiple interactivity modes such as `silent`, `verbose` etc. to meet different developer experience needs. As such, we need to standardize the UI, UX and interactive messaging guidance for developers.
 
+The verbosity level can be set per-invocation using `--silent` or `--verbose` CLI flags, or persisted via the `verbosity` option in the [configuration file](config.md).
+
 ## Messaging
 
 Two types of messages to users are supported:

main.go

@@ -47,6 +47,17 @@ func main() {
 				os.Setenv("APP_LOG_SKIP_STDOUT_LOGGER", "true")
 			}
 
+			// Apply config-based verbosity first
+			switch config.Get().Config.Verbosity {
+			case config.VerbositySilent:
+				ui.SetVerbosityLevel(ui.VerbosityLevelSilent)
+			case config.VerbosityVerbose:
+				ui.SetVerbosityLevel(ui.VerbosityLevelVerbose)
+			default:
+				ui.SetVerbosityLevel(ui.VerbosityLevelNormal)
+			}
+
+			// CLI flags override config
 			if silent && verbose {
 				ui.Fatalf("pmg: --silent and --verbose cannot be used together")
 			}