Merge pull request #338 from nao1215/chore/release-v1.4.0-prep

chore: prepare v1.4.0 release

Author: nao1215

.goreleaser.yml

@@ -89,7 +89,7 @@ signs:
     output: true
 nfpms:
   - maintainer: 'Naohiro CHIKAMATSU <n.chika156@gmail.com>'
-    description: gup - Fast parallel updater and manager for binaries installed with 'go install'
+    description: 'Fast manager for Go-installed binaries in $GOBIN: update, export/import, and migrate toolsets across machines'
     homepage: https://github.com/nao1215/gup
     license: Apache License 2.0
     formats:
@@ -111,7 +111,7 @@ nfpms:
           mode: 0644
 brews:
   - name: gup
-    description: gup - Fast parallel updater and manager for binaries installed with 'go install'
+    description: 'Fast manager for Go-installed binaries in $GOBIN: update, export/import, and migrate toolsets across machines'
     license: Apache License 2.0
     repository:
       owner: nao1215

CHANGELOG.md

@@ -1,3 +1,35 @@
+## [v1.4.0](https://github.com/nao1215/gup/compare/v1.3.1...v1.4.0) (2026-06-22)
+
+### Features
+
+* Add a top-level `--version`/`-V` flag in addition to the existing `gup version` subcommand. (#326)
+* Add a `--quiet`/`-q` output mode to `check` and `update` that hides the up-to-date lines and prints only changed/updatable binaries, failures, and a one-line summary. Errors still go to STDERR. (#290)
+* Respect the [`NO_COLOR`](https://no-color.org/) environment variable and add a `--no-color` flag to disable colorized output. (#309)
+* Show concise, actionable guidance (the correct usage line) when a required argument is missing, instead of dumping the full help. (#324)
+
+### Bug Fixes
+
+* `gup remove` now fails fast with a clear message in non-interactive execution (when stdin is not a TTY, e.g. CI or a pipe) instead of blocking on stdin or surfacing a raw `EOF`. `--force` still skips confirmation. (#323)
+* Normalize an `unknown`/`(devel)`/empty binary version to `latest` before persisting it to `gup.json`, so later `gup update` runs resolve the package correctly. (#300)
+* Classify binaries by their main module path instead of a dotless-import-path heuristic, fixing the misclassification of tools whose host has no dot (e.g. internal registries). (#299)
+
+### Documentation
+
+* Add practical examples to the root command and the major subcommands' help. (#325)
+* Sync the Benchmark, release-integrity, and Migrate sections into all five translated READMEs, and add a test that fails when a translation is missing one of these sections. (#306)
+* Document the top-level `--version` flag, the non-TTY `remove` behavior, and the `--json`/`--quiet` precedence in the README.
+
+### Tests
+
+* Add a helper-process test seam for `goExe`-based subprocess calls, plus property-based tests for version comparison, name normalization, and config round-trip. (#301, #305)
+* Cover parallel-execution invariants: result count, timeout isolation, and CPU clamping. (#304)
+* Make `config_file` rename injectable and cover the backup-swap restore-failure worst case. (#302)
+* Add a property-based test for the path-traversal guard in `gup remove`. (#303)
+
+### Others
+
+* Tidy help-text consistency (flag-description casing, `Short` punctuation, example indentation) and give the non-interactive `remove` error a labeled STDERR message.
+
 ## [v1.3.1](https://github.com/nao1215/gup/compare/v1.3.0...v1.3.1) (2026-06-21)
 
 ### Bug Fixes

README.md

@@ -83,6 +83,13 @@ gh attestation verify gup_<version>_<os>_<arch>.tar.gz --repo nao1215/gup
 ```
 
 ## How to use
+### Check the gup version
+Print the version with either the `version` subcommand or the top-level `--version`/`-V` flag.
+```shell
+$ gup --version
+$ gup version
+```
+
 ### Update all binaries
 `gup update` updates every binary under `$GOBIN`, in parallel.
 
@@ -138,6 +145,8 @@ $ gup remove --force gal
 removed /home/nao/.go/bin/gal
 ```
 
+In non-interactive execution (when stdin is not a TTY, e.g. CI or a pipe), `gup remove` no longer blocks waiting for confirmation. It fails fast with a clear message; pass `--force` to remove without confirmation.
+
 ### Check if the binary is the latest version
 If you want to know if the binary is the latest version, use the check subcommand. check subcommand checks if the binary is the latest version and displays the name of the binary that needs to be updated.
 ```shell
@@ -164,7 +173,7 @@ If you want to update binaries, the following command.
 ```
 
 ### Quiet output for large tool sets
-`check` and `update` print every binary by default, which is noisy when you have many tools installed. Pass `--quiet` (`-q`) to suppress the up-to-date lines and show only the binaries that were updated (or have an update available) plus failures, followed by a one-line summary. Errors are always written to STDERR, so they stay visible.
+`check` and `update` print every binary by default, which is noisy when you have many tools installed. Pass `--quiet` (`-q`) to suppress the up-to-date lines and show only the binaries that were updated (or have an update available) plus failures, followed by a one-line summary. Errors are always written to STDERR, so they stay visible. When `--json` is also given, `--quiet` is ignored and the full JSON array is printed.
 ```shell
 $ gup update --quiet
 github.com/nao1215/gup (v0.7.0 to v0.7.1)

cmd/bug_report.go

@@ -15,7 +15,7 @@ func newBugReportCmd() *cobra.Command {
 		Use:               "bug-report",
 		Short:             "Submit a bug report at GitHub",
 		Long:              "bug-report opens the default browser to start a bug report which will include useful system information.",
-		Example:           "   gup bug-report",
+		Example:           "  gup bug-report",
 		Args:              cobra.NoArgs,
 		ValidArgsFunction: cobra.NoFileCompletions,
 		Run: func(cmd *cobra.Command, args []string) {

cmd/check.go

@@ -31,11 +31,11 @@ It does not update them.`,
 		},
 	}
 
-	cmd.Flags().IntP("jobs", "j", runtime.NumCPU(), "Specify the number of CPU cores to use")
+	cmd.Flags().IntP("jobs", "j", runtime.NumCPU(), "specify the number of CPU cores to use")
 	if err := cmd.RegisterFlagCompletionFunc("jobs", completeNCPUs); err != nil {
 		panic(err)
 	}
-	cmd.Flags().Bool("ignore-go-update", false, "Ignore updates to the Go toolchain")
+	cmd.Flags().Bool("ignore-go-update", false, "ignore updates to the Go toolchain")
 	cmd.Flags().Bool("json", false, "output result as machine-readable JSON")
 	cmd.Flags().BoolP("quiet", "q", false, "suppress up-to-date lines; show only update-available/failed binaries plus a summary")
 	addTimeoutFlag(cmd)

cmd/export.go

@@ -10,7 +10,7 @@ import (
 func newExportCmd() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "export",
-		Short: "Export installed binaries and their versions under $GOPATH/bin or $GOBIN to gup.json.",
+		Short: "Export installed binaries and their versions under $GOPATH/bin or $GOBIN to gup.json",
 		Long: `Export installed binaries and their versions under $GOPATH/bin or $GOBIN to gup.json.
 
 Use export/import if you want to install the same Go binaries

cmd/import.go

@@ -20,7 +20,7 @@ var installByVersionCtx = goutil.InstallWithContext //nolint:gochecknoglobals //
 func newImportCmd() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "import",
-		Short: "Install commands according to gup.json.",
+		Short: "Install commands according to gup.json",
 		Long: `Install commands according to gup.json.
 
 Use export/import if you want to install the same Go binaries
@@ -43,7 +43,7 @@ versions recorded in that gup.json.`,
 	if err := cmd.MarkFlagFilename("file", "json"); err != nil {
 		panic(err)
 	}
-	cmd.Flags().IntP("jobs", "j", runtime.NumCPU(), "Specify the number of CPU cores to use")
+	cmd.Flags().IntP("jobs", "j", runtime.NumCPU(), "specify the number of CPU cores to use")
 	if err := cmd.RegisterFlagCompletionFunc("jobs", completeNCPUs); err != nil {
 		panic(err)
 	}

cmd/migrate.go

@@ -67,7 +67,7 @@ If BINARY arguments are given, only those binaries are migrated.`,
 
 	cmd.Flags().BoolP("dry-run", "n", false, "perform the trial migration with no changes")
 	cmd.Flags().BoolP("notify", "N", false, "enable desktop notifications")
-	cmd.Flags().IntP("jobs", "j", runtime.NumCPU(), "Specify the number of CPU cores to use")
+	cmd.Flags().IntP("jobs", "j", runtime.NumCPU(), "specify the number of CPU cores to use")
 	if err := cmd.RegisterFlagCompletionFunc("jobs", completeNCPUs); err != nil {
 		panic(err)
 	}

cmd/remove.go

@@ -32,7 +32,7 @@ If you want to specify multiple binaries at once, separate them with space.
 			OsExit(remove(cmd, args))
 		},
 	}
-	cmd.Flags().BoolP("force", "f", false, "Forcibly remove the file")
+	cmd.Flags().BoolP("force", "f", false, "forcibly remove the file")
 
 	return cmd
 }

cmd/testdata/bug_report/bug_report.txt

@@ -4,7 +4,7 @@ Usage:
   gup bug-report [flags]
 
 Examples:
-   gup bug-report
+  gup bug-report
 
 Flags:
   -h, --help   help for bug-report