refactor: unify CLI flags into shared CommonFlags struct

docs/md/melange.md

@@ -14,8 +14,9 @@ toc: true
 ### Options
 
 ```
-  -h, --help               help for melange
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+  -h, --help                 help for melange
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_build.md

@@ -35,13 +35,13 @@ melange build [flags]
       --cache-dir string                                        directory used for cached inputs (default "./melange-cache/")
       --cache-source string                                     directory or bucket used for preloading the cache
       --cleanup                                                 when enabled, the temp dir used for the guest will be cleaned up after completion (default true)
-      --cpu string                                              default CPU resources to use for builds
-      --cpumodel string                                         default memory resources to use for builds
+      --cpu string                                              default CPU resources to use
+      --cpumodel string                                         default CPU model to use
       --create-build-log                                        creates a package.log file containing a list of packages that were built by the command
-      --debug                                                   enables debug logging of build pipelines
-      --debug-runner                                            when enabled, the builder pod will persist after the build succeeds or fails
+      --debug                                                   enables debug logging of pipelines
+      --debug-runner                                            when enabled, the runner pod will persist after the build succeeds or fails
       --dependency-log string                                   log dependencies to a specified file
-      --disk string                                             disk size to use for builds
+      --disk string                                             default disk size to use
       --empty-workspace                                         whether the build workspace should be empty
       --env-file strings                                        files to use for preloaded environment variables
       --generate-index                                          whether to generate APKINDEX.tar.gz (default true)
@@ -55,7 +55,7 @@ melange build [flags]
       --license string                                          license to use for the build config file itself (default "NOASSERTION")
       --lint-require strings                                    linters that must pass (default [dev,infodir,libtool/la-files,setuidgid,tempdir,usrmerge,varempty,worldwrite])
       --lint-warn strings                                       linters that will generate warnings (default [binaryarch,cudaruntimelib,dll,duplicate,dylib,lddcheck,maninfo,nonlinux,object,opt,pkgconf,python/docs,python/multiple,python/test,sbom,srv,staticarchive,strip,unsupportedarch,usrlocal])
-      --memory string                                           default memory resources to use for builds
+      --memory string                                           default memory resources to use
       --namespace string                                        namespace to use in package URLs in SBOM (eg wolfi, alpine) (default "unknown")
       --out-dir string                                          directory where packages will be output (default "./packages/")
       --override-host-triplet-libc-substitution-flavor string   override the flavor of libc for ${{host.triplet.*}} substitutions (e.g. gnu,musl) -- default is gnu (default "gnu")
@@ -69,7 +69,7 @@ melange build [flags]
       --signing-key string                                      key to use for signing
       --source-dir string                                       directory used for included sources
       --strip-origin-name                                       whether origin names should be stripped (for bootstrap)
-      --timeout duration                                        default timeout for builds
+      --timeout duration                                        default timeout
       --trace string                                            where to write trace output
       --vars-file string                                        file to use for preloaded build configuration variables
       --workspace-dir string                                    directory used for the workspace at /home/build
@@ -78,7 +78,8 @@ melange build [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_bump.md

@@ -35,7 +35,8 @@ melange bump [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_compile.md

@@ -34,11 +34,13 @@ melange compile [flags]
       --build-option strings        build options to enable
       --cache-dir string            directory used for cached inputs (default "./melange-cache/")
       --cache-source string         directory or bucket used for preloading the cache
-      --cpu string                  default CPU resources to use for builds
+      --cpu string                  default CPU resources to use
+      --cpumodel string             default CPU model to use
       --create-build-log            creates a package.log file containing a list of packages that were built by the command
-      --debug                       enables debug logging of build pipelines
-      --debug-runner                when enabled, the builder pod will persist after the build succeeds or fails
+      --debug                       enables debug logging of pipelines
+      --debug-runner                when enabled, the runner pod will persist after the build succeeds or fails
       --dependency-log string       log dependencies to a specified file
+      --disk string                 default disk size to use
       --empty-workspace             whether the build workspace should be empty
       --env-file strings            files to use for preloaded environment variables
       --fail-on-lint-warning        turns linter warnings into failures
@@ -47,30 +49,33 @@ melange compile [flags]
       --git-commit string           commit hash of the git repository containing the build config file (defaults to detecting HEAD)
       --git-repo-url string         URL of the git repository containing the build config file (defaults to detecting from configured git remotes)
   -h, --help                        help for compile
+      --ignore-signatures           ignore repository signature verification
   -i, --interactive                 when enabled, attaches stdin with a tty to the pod on failure
   -k, --keyring-append strings      path to extra keys to include in the build environment keyring
       --license string              license to use for the build config file itself (default "NOASSERTION")
       --log-policy strings          logging policy to use (default [builtin:stderr])
-      --memory string               default memory resources to use for builds
+      --memory string               default memory resources to use
       --namespace string            namespace to use in package URLs in SBOM (eg wolfi, alpine) (default "unknown")
       --out-dir string              directory where packages will be output (default "./packages/")
       --package-append strings      extra packages to install for each of the build environments
       --pipeline-dir string         directory used to extend defined built-in pipelines
+      --pipeline-dirs strings       directories used to extend defined built-in pipelines
   -r, --repository-append strings   path to extra repositories to include in the build environment
-      --rm                          clean up intermediate artifacts (e.g. container images)
+      --rm                          clean up intermediate artifacts (e.g. container images, temp dirs)
       --runner string               which runner to use to enable running commands, default is based on your platform. Options are ["bubblewrap" "docker" "qemu"]
       --signing-key string          key to use for signing
       --source-dir string           directory used for included sources
       --strip-origin-name           whether origin names should be stripped (for bootstrap)
-      --timeout duration            default timeout for builds
+      --timeout duration            default timeout
       --vars-file string            file to use for preloaded build configuration variables
       --workspace-dir string        directory used for the workspace at /home/build
 ```
 
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_completion.md

@@ -57,7 +57,8 @@ melange completion [bash|zsh|fish|powershell]
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_index.md

@@ -39,7 +39,8 @@ melange index [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_initramfs.md

@@ -57,7 +57,8 @@ melange initramfs [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_keygen.md

@@ -35,7 +35,8 @@ melange keygen [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_license-check.md

@@ -38,7 +38,8 @@ melange license-check file [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_lint.md

@@ -38,7 +38,8 @@ melange lint [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_package-version.md

@@ -39,7 +39,8 @@ melange package-version [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_query.md

@@ -35,7 +35,8 @@ melange query [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_scan.md

@@ -37,7 +37,8 @@ melange scan bash.yaml
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_sign-index.md

@@ -42,7 +42,8 @@ melange sign-index [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_sign.md

@@ -39,7 +39,8 @@ melange sign [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_source.md

@@ -26,7 +26,8 @@ Commands for managing source code from melange configurations.
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_source_get.md

@@ -38,9 +38,10 @@ melange source get [config.yaml] [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string    log level (e.g. debug, info, warn, error) (default "INFO")
-  -o, --output string       output directory for extracted source (default "./source")
-      --source-dir string   directory where patches and other sources are located (defaults to ./package-name/)
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
+  -o, --output string        output directory for extracted source (default "./source")
+      --source-dir string    directory where patches and other sources are located (defaults to ./package-name/)
 ```
 
 ### SEE ALSO

docs/md/melange_source_pop.md

@@ -42,9 +42,10 @@ melange source pop [config.yaml] [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string    log level (e.g. debug, info, warn, error) (default "INFO")
-  -o, --output string       output directory for extracted source (default "./source")
-      --source-dir string   directory where patches and other sources are located (defaults to ./package-name/)
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
+  -o, --output string        output directory for extracted source (default "./source")
+      --source-dir string    directory where patches and other sources are located (defaults to ./package-name/)
 ```
 
 ### SEE ALSO

docs/md/melange_test.md

@@ -32,32 +32,34 @@ melange test [flags]
       --arch strings                  architectures to build for (e.g., x86_64,ppc64le,arm64) -- default is all, unless specified in config
       --cache-dir string              directory used for cached inputs
       --cache-source string           directory or bucket used for preloading the cache
-      --cpu string                    default CPU resources to use for tests
-      --cpumodel string               default CPU model to use for tests
-      --debug                         enables debug logging of test pipelines (sets -x for steps)
-      --debug-runner                  when enabled, the builder pod will persist after the build succeeds or fails
-      --disk string                   disk size to use for tests
+      --cpu string                    default CPU resources to use
+      --cpumodel string               default CPU model to use
+      --debug                         enables debug logging of pipelines
+      --debug-runner                  when enabled, the runner pod will persist after the build succeeds or fails
+      --disk string                   default disk size to use
       --env-file strings              files to use for preloaded environment variables
   -h, --help                          help for test
       --ignore-signatures             ignore repository signature verification
   -i, --interactive                   when enabled, attaches stdin with a tty to the pod on failure
   -k, --keyring-append strings        path to extra keys to include in the build environment keyring
-      --memory string                 default memory resources to use for tests
+      --memory string                 default memory resources to use
+      --package-append strings        extra packages to install for each of the build environments
       --pipeline-dirs strings         directories used to extend defined built-in pipelines
   -r, --repository-append strings     path to extra repositories to include in the build environment
       --rm                            clean up intermediate artifacts (e.g. container images, temp dirs) (default true)
       --runner string                 which runner to use to enable running commands, default is based on your platform. Options are ["bubblewrap" "docker" "qemu"]
       --source-dir string             directory used for included sources
       --test-option strings           build options to enable
       --test-package-append strings   extra packages to install for each of the test environments
-      --timeout duration              default timeout for tests
+      --timeout duration              default timeout
       --workspace-dir string          directory used for the workspace at /home/build
 ```
 
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_update-cache.md

@@ -35,7 +35,8 @@ melange update-cache [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO

docs/md/melange_version.md

@@ -25,7 +25,8 @@ melange version [flags]
 ### Options inherited from parent commands
 
 ```
-      --log-level string   log level (e.g. debug, info, warn, error) (default "INFO")
+      --config-file string   path to project config file (default: .melange.yaml in current directory)
+      --log-level string     log level (e.g. debug, info, warn, error) (default "INFO")
 ```
 
 ### SEE ALSO