feat: --short for jh package dependency and dependents

Prints a single line with the counts, e.g.

    JuMP  v1.32.1 · General: 9 direct · 40 indirect · 49 total dependencies

`--short` cannot be combined with `--json`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: pankgeorg

CLAUDE.md

@@ -535,7 +535,7 @@ jh run setup
 - Package search (`jh package search`) and info (`jh package info`) both try REST API (`/api/v1/ui/packages/info`) first, then fall back to GraphQL (`FilteredPackages` / `FilteredPackagesCount` via `/v1/graphql`) on failure; `searchPackages` prints `warning: REST package search failed (...); falling back to GraphQL` to stderr when it falls back (`getPackageInfo` falls back silently)
 - `--registries` resolution for `jh package search` / `jh package info` / `jh search packages` goes through `resolveRegistries(server, csv)` in `registries.go` (empty = all registries; unknown name → `Registry not found: '<name>'`)
 - `jh package info` adds `details` (`packageDetails`) to each match: the listing's `downloads_timeseries` plus the stable `pkg.json` (`fetchPackageDocs`, one request per match): homepage, release date, contributors, `doctype`/`documenter_errored`, and dependency/dependent counts (unique UUIDs, direct wins). A failed `pkg.json` fetch prints a warning on stderr and leaves those fields empty. `restToInfo` also carries `owner`, `is_app`, `is_dyad` and `downloads_30d` (sum of the 30 daily counts), so `jh package search --json` gains them too; the GraphQL fallback has no download data and omits `downloads_30d`
-- Package text output: `jh package info` and `search --verbose` print a card per package (`printPackageCard`: header `name  vX · registry · owner`, description, aligned fields, links including the JuliaHub page `https://<server>/ui/Packages/<registry>/<name>` from `packagePageURL`, install hint); `search` prints a table with STARS and DL/30 DAYS columns; `dependency` and `dependents` print `printPackageHeading`, the direct/indirect/total counts and tables, with standard libraries (no registry in pkg.json) shown as `stdlib`. `splitDependencies` collapses `deps` to one entry per UUID like `splitDependents`, for both text and `--json`
+- Package text output: `jh package info` and `search --verbose` print a card per package (`printPackageCard`: header `name  vX · registry · owner`, description, aligned fields, links including the JuliaHub page `https://<server>/ui/Packages/<registry>/<name>` from `packagePageURL`, install hint); `search` prints a table with STARS and DL/30 DAYS columns; `dependency` and `dependents` print `printPackageHeading`, the direct/indirect/total counts and tables, with standard libraries (no registry in pkg.json) shown as `stdlib`. `splitDependencies` collapses `deps` to one entry per UUID like `splitDependents`, for both text and `--json`. `--short` on `dependency`/`dependents` prints only `printPackageSummary` (`name  vX · registry: <countsSummary>`); it is mutually exclusive with `--json`
 - `jh package info --json` prints the exact matches in the same `{"results": [...], "total": N}` document (`writePackagesJSON`; no match → empty `results`). `jh package dependency --json` prints `dependenciesDoc` and `jh package dependents --json` prints `dependentsDoc` (counts always cover every dependent; `dependents` lists indirect ones only with `--indirect`). All go through `writeJSON`; errors from these three commands go to stderr
 - `jh package search` / `jh search packages --json` sets `PackageSearchParams.JSON`; both the REST and GraphQL paths then call `writePackagesJSON`, which prints `{"results": [...], "total": N}` (snake_case keys from `packageInfo`'s json tags, `tags` always an array) 2-space indented with a trailing newline — nothing else on stdout
 - **JSON output convention** (`jh search *`): `--json` prints only the document on stdout, 2-space indented, trailing newline — `{"results": <server array, untouched>, "truncated": bool}` for code/symbols/docs; warnings, the human-mode `note: results truncated (search stopped early)` line, and errors always go to stderr; exit code is 0/1 only

README.md

@@ -171,11 +171,13 @@ go build -o jh .
   - Default: Shows up to 10 direct dependencies (NAME, REGISTRY, UUID, VERSIONS)
   - `jh package dependency --indirect` - Include both direct and indirect dependencies
   - `jh package dependency --registry General` - Specify registry to use
+  - `jh package dependency --short` - Print one line: `JuMP  v1.32.1 · General: 9 direct · 40 indirect · 49 total dependencies`
   - `jh package dependency --json` - Print only `{"name", "version", "registry", "dependencies": [...]}` on stdout (`--indirect` adds the indirect ones)
 - `jh package dependents <package-name>` - List packages that depend on a package (reverse dependencies)
   - Default: Prints direct/indirect/total counts and lists the direct dependents (NAME, REGISTRY, UUID)
   - `jh package dependents --indirect` - Also list indirect dependents
   - `jh package dependents --registry General` - Specify registry to use
+  - `jh package dependents --short` - Print one line: `JuMP  v1.32.1 · General: 335 direct · 94 indirect · 429 total dependents`
   - `jh package dependents --json` - Print only `{"name", "version", "registry", "direct", "indirect", "total", "dependents": [...]}` on stdout; the counts always cover every dependent, `dependents` lists the indirect ones only with `--indirect`
 
 ### Registry Management (`jh registry`)

main.go

@@ -1039,7 +1039,7 @@ The command fetches dependency information from the package documentation
 JSON endpoint. If a package exists in multiple registries, it uses the
 first registry by default. You can specify a different registry using
 the --registry flag.`,
-	Example: "  jh package dependency DataFrames\n  jh package dependency --indirect Plots\n  jh package dependency --registry General CSV\n  jh package dependency --json JuMP",
+	Example: "  jh package dependency DataFrames\n  jh package dependency --indirect Plots\n  jh package dependency --registry General CSV\n  jh package dependency --short JuMP\n  jh package dependency --json JuMP",
 	Args:    cobra.ExactArgs(1),
 	Run: func(cmd *cobra.Command, args []string) {
 		server, err := getServerFromFlagOrConfig(cmd)
@@ -1050,10 +1050,11 @@ the --registry flag.`,
 
 		packageName := args[0]
 		asJSON, _ := cmd.Flags().GetBool("json")
+		short, _ := cmd.Flags().GetBool("short")
 		registryName, _ := cmd.Flags().GetString("registry")
 		showIndirect, _ := cmd.Flags().GetBool("indirect")
 
-		if err := getPackageDependencies(server, packageName, registryName, showIndirect, asJSON); err != nil {
+		if err := getPackageDependencies(server, packageName, registryName, showIndirect, asJSON, short); err != nil {
 			fmt.Fprintf(os.Stderr, "Failed to get package dependencies: %v\n", err)
 			os.Exit(1)
 		}
@@ -1073,7 +1074,7 @@ The data comes from the same package documentation JSON endpoint as
 jh package dependency, for the package's stable version. If a package
 exists in multiple registries, it uses the first registry by default.
 You can specify a different registry using the --registry flag.`,
-	Example: "  jh package dependents JuMP\n  jh package dependents --indirect DataFrames\n  jh package dependents --registry General CSV\n  jh package dependents --json JuMP",
+	Example: "  jh package dependents JuMP\n  jh package dependents --indirect DataFrames\n  jh package dependents --registry General CSV\n  jh package dependents --short JuMP\n  jh package dependents --json JuMP",
 	Args:    cobra.ExactArgs(1),
 	Run: func(cmd *cobra.Command, args []string) {
 		server, err := getServerFromFlagOrConfig(cmd)
@@ -1084,10 +1085,11 @@ You can specify a different registry using the --registry flag.`,
 
 		packageName := args[0]
 		asJSON, _ := cmd.Flags().GetBool("json")
+		short, _ := cmd.Flags().GetBool("short")
 		registryName, _ := cmd.Flags().GetString("registry")
 		showIndirect, _ := cmd.Flags().GetBool("indirect")
 
-		if err := getPackageDependents(server, packageName, registryName, showIndirect, asJSON); err != nil {
+		if err := getPackageDependents(server, packageName, registryName, showIndirect, asJSON, short); err != nil {
 			fmt.Fprintf(os.Stderr, "Failed to get package dependents: %v\n", err)
 			os.Exit(1)
 		}
@@ -2657,10 +2659,14 @@ func init() {
 	packageDependencyCmd.Flags().String("registry", "", "Specify registry name (uses first registry if not specified)")
 	packageDependencyCmd.Flags().Bool("indirect", false, "Include indirect dependencies")
 	packageDependencyCmd.Flags().Bool("json", false, "Print only a JSON document ({\"name\", \"version\", \"registry\", \"dependencies\": [...]}) on stdout")
+	packageDependencyCmd.Flags().Bool("short", false, "Print only one line: the direct, indirect and total dependencies counts")
+	packageDependencyCmd.MarkFlagsMutuallyExclusive("short", "json")
 	packageDependentsCmd.Flags().StringP("server", "s", "juliahub.com", "JuliaHub server")
 	packageDependentsCmd.Flags().String("registry", "", "Specify registry name (uses first registry if not specified)")
 	packageDependentsCmd.Flags().Bool("indirect", false, "Also list indirect dependents")
 	packageDependentsCmd.Flags().Bool("json", false, "Print only a JSON document ({\"name\", \"version\", \"registry\", \"direct\", \"indirect\", \"total\", \"dependents\": [...]}) on stdout")
+	packageDependentsCmd.Flags().Bool("short", false, "Print only one line: the direct, indirect and total dependents counts")
+	packageDependentsCmd.MarkFlagsMutuallyExclusive("short", "json")
 	registryListCmd.Flags().StringP("server", "s", "juliahub.com", "JuliaHub server")
 	registryListCmd.Flags().Bool("verbose", false, "Show detailed registry information")
 	projectListCmd.Flags().StringP("server", "s", "juliahub.com", "JuliaHub server")

packages.go

@@ -1029,7 +1029,7 @@ type dependenciesDoc struct {
 	Dependencies []PackageDependency `json:"dependencies"`
 }
 
-func getPackageDependencies(server string, packageName string, registryName string, showIndirect, asJSON bool) error {
+func getPackageDependencies(server string, packageName string, registryName string, showIndirect, asJSON, short bool) error {
 	docsResp, targetRegistry, err := fetchPackageDocs(server, packageName, registryName)
 	if err != nil {
 		return err
@@ -1045,13 +1045,17 @@ func getPackageDependencies(server string, packageName string, registryName stri
 		return writeJSON(os.Stdout, dependenciesDoc{docsResp.Name, docsResp.Version, targetRegistry, deps})
 	}
 
+	summary := countsSummary(len(direct), len(indirect), "dependencies")
+	if short {
+		printPackageSummary(docsResp, targetRegistry, summary)
+		return nil
+	}
 	printPackageHeading(docsResp, targetRegistry)
 	if len(direct)+len(indirect) == 0 {
 		fmt.Println("No dependencies")
 		return nil
 	}
-	fmt.Printf("%s direct · %s indirect · %s total dependencies\n",
-		formatCount(len(direct)), formatCount(len(indirect)), formatCount(len(direct)+len(indirect)))
+	fmt.Println(summary)
 	if len(direct) > 0 {
 		fmt.Println()
 		printDependencyTable("Direct dependencies", direct)
@@ -1065,6 +1069,18 @@ func getPackageDependencies(server string, packageName string, registryName stri
 	return nil
 }
 
+// countsSummary renders "9 direct · 40 indirect · 49 total <noun>".
+func countsSummary(direct, indirect int, noun string) string {
+	return fmt.Sprintf("%s direct · %s indirect · %s total %s",
+		formatCount(direct), formatCount(indirect), formatCount(direct+indirect), noun)
+}
+
+// printPackageSummary prints the one-line --short form:
+// "<name>  v<version> · <registry>: <summary>".
+func printPackageSummary(docsResp *PackageDocsResponse, registry, summary string) {
+	fmt.Printf("%s  %s %s\n", bold(docsResp.Name), dim("v"+docsResp.Version+" · "+registry+":"), summary)
+}
+
 // printPackageHeading prints "<name>  v<version> · <registry>" and a blank line.
 func printPackageHeading(docsResp *PackageDocsResponse, registry string) {
 	fmt.Printf("%s  %s\n\n", bold(docsResp.Name), dim("v"+docsResp.Version+" · "+registry))
@@ -1188,7 +1204,7 @@ func newDependentsDoc(docsResp *PackageDocsResponse, registry string, direct, in
 	}
 }
 
-func getPackageDependents(server, packageName, registryName string, showIndirect, asJSON bool) error {
+func getPackageDependents(server, packageName, registryName string, showIndirect, asJSON, short bool) error {
 	docsResp, targetRegistry, err := fetchPackageDocs(server, packageName, registryName)
 	if err != nil {
 		return err
@@ -1198,13 +1214,17 @@ func getPackageDependents(server, packageName, registryName string, showIndirect
 	if asJSON {
 		return writeJSON(os.Stdout, newDependentsDoc(docsResp, targetRegistry, direct, indirect, showIndirect))
 	}
+	summary := countsSummary(len(direct), len(indirect), "dependents")
+	if short {
+		printPackageSummary(docsResp, targetRegistry, summary)
+		return nil
+	}
 	printPackageHeading(docsResp, targetRegistry)
 	if len(direct)+len(indirect) == 0 {
 		fmt.Println("No dependents")
 		return nil
 	}
-	fmt.Printf("%s direct · %s indirect · %s total dependents\n",
-		formatCount(len(direct)), formatCount(len(indirect)), formatCount(len(direct)+len(indirect)))
+	fmt.Println(summary)
 	if len(direct) > 0 {
 		fmt.Println()
 		printDependentsTable("Direct dependents", direct)

packages_test.go

@@ -384,3 +384,12 @@ func TestListTags(t *testing.T) {
 		t.Errorf("listTags keeps at least one tag: %q", got)
 	}
 }
+
+func TestCountsSummary(t *testing.T) {
+	if got := countsSummary(9, 40, "dependencies"); got != "9 direct · 40 indirect · 49 total dependencies" {
+		t.Errorf("countsSummary = %q", got)
+	}
+	if got := countsSummary(1335, 0, "dependents"); got != "1,335 direct · 0 indirect · 1,335 total dependents" {
+		t.Errorf("countsSummary = %q", got)
+	}
+}