feat(bonfire): global flags, Artisan list and exit codes

- Global options -v/-vv/-vvv, -q, --ansi/--no-ansi, -n and --env on every
  command; PeekGlobals reads them before config loads, OnGlobals hooks
  re-apply them after parsing (diary.ApplyGlobals in the generated main)
- Bare binary, --help and list print the Artisan list with the version
  header from BuildVersion and namespace blocks
- Execute runs the root through fang (no version, man page or completions)
  and returns 0, 1 or 2; Fail renders errors before the root exists
- NewRoot rejects duplicate command names (ErrDuplicateCommand) and flags
  that reuse a global option (ErrReservedFlag)
- Generated main and summer use PeekGlobals, compass.Open with --env,
  diary.FromGlobals and bonfire.Execute; docs checker knows the globals

modules/diary/diary.go

@@ -70,6 +70,8 @@ type state struct {
 	verbosity  int
 	quiet      bool
 	channels   *channels
+	conf       Config
+	opts       Options
 }
 
 // floor is the minimum level for records of component name: its
@@ -165,6 +167,8 @@ func install(conf Config, ch *channels, opts Options) {
 		verbosity:  opts.Verbosity,
 		quiet:      opts.Quiet,
 		channels:   ch,
+		conf:       conf,
+		opts:       opts,
 	}
 	old := current.Swap(st)
 	slog.SetDefault(slog.New(newComponentHandler("")))
@@ -188,6 +192,7 @@ func SetVerbosity(v int, quiet bool) {
 	}
 	next := *st
 	next.verbosity, next.quiet = v, quiet
+	next.opts.Verbosity, next.opts.Quiet = v, quiet
 	for _, c := range st.channels.consoles {
 		c.apply(quiet)
 	}
@@ -195,6 +200,31 @@ func SetVerbosity(v int, quiet bool) {
 	current.Store(&next)
 }
 
+// FromGlobals returns the Options for the console global options: their
+// verbosity, quiet switch and color mode. The generated main passes it to
+// Bootstrap and Setup.
+func FromGlobals(g bonfire.Globals) Options {
+	return Options{Verbosity: g.Verbosity, Quiet: g.Quiet, Color: g.Color}
+}
+
+// ApplyGlobals applies the parsed global options to the installed setup:
+// the verbosity and quiet switch (SetVerbosity) and, when it differs from
+// the one the channels were built with, the console color mode, which
+// rebuilds the channels from the same configuration. The generated main
+// registers it with bonfire.OnGlobals.
+func ApplyGlobals(g bonfire.Globals) {
+	st := current.Load()
+	if st != nil && st.opts.Color != g.Color {
+		opts := st.opts
+		opts.Color, opts.Verbosity, opts.Quiet = g.Color, g.Verbosity, g.Quiet
+		if ch, err := buildChannels(st.conf, opts); err == nil {
+			install(st.conf, ch, opts)
+			return
+		}
+	}
+	SetVerbosity(g.Verbosity, g.Quiet)
+}
+
 // Verbosity returns the current verbosity (0 by default).
 func Verbosity() int {
 	return int(verbosity.Load())