Commit `fd270da6d7`

fd270da6d7c75451881384de97db687ebe22a8fc

Verified · cmc

cmc <hello@cleberg.net> · 2026-09-28 08:30 UTC

help: no auth <verb> usage or footer over stock ssh

The server has no auth command; each row already names its full path.

Ref #267

Layout: unified · split

internal/control/help.go +13 −5

 func (c *Ctx) helpNoun(w io.Writer, prefix string, cmds []Command, override map[string]string) {
 	head := nounSummaries[strings.Fields(prefix)[0]]
 	fmt.Fprintln(w, head)
-	fmt.Fprintln(w)
+	// An aliased noun is a CLI grouping: over stock ssh there is no
-	c.heading(w, "USAGE")
+	// "auth <verb>" to type, and each row already names its full command.
+	_, aliased := nounAliases[prefix]
+	bare := aliased && c.CLIPath == ""
 	display := c.shownAs(prefix, prefix)
-	fmt.Fprintf(w, "  %s %s <verb> ...\n", c.program(), display)
+	if !bare {
+		fmt.Fprintln(w)
+		c.heading(w, "USAGE")
+		fmt.Fprintf(w, "  %s %s <verb> ...\n", c.program(), display)
+	}
 	rowText := func(cmd Command) string {
 		full := joinPath(cmd.Path)
 		if ov, ok := override[full]; ok {
 			fmt.Fprintf(w, "  %s  %s\n", pad(rowText(cmd), wide), cmd.Summary)
 		}
 	}
-	fmt.Fprintln(w)
+	if !bare {
-	fmt.Fprintf(w, "%s %s <verb> --help for flags.\n", c.program(), display)
+		fmt.Fprintln(w)
+		fmt.Fprintf(w, "%s %s <verb> --help for flags.\n", c.program(), display)
+	}
 }

internal/control/help_test.go +3

	@@ -270,4 +270,7 @@ func TestHelpRendersAnAliasedNounInRegisteredFormOverSSH(t *testing.T) {
270	if strings.Contains(got, "auth keys list") {	270	if strings.Contains(got, "auth keys list") {
271	t.Errorf("stock ssh should not see the CLI-only auth prefix: %s", got)	271	t.Errorf("stock ssh should not see the CLI-only auth prefix: %s", got)
272	}	272	}
		273	if strings.Contains(got, " auth <verb>") {
		274	t.Errorf("stock ssh should not be told to type auth <verb>, which the server has no command for: %s", got)
		275	}
273	}	276	}

Commit fd270da6d7