docs(cli): richer Long help for get/list service-account

get and list previously set Long to their ShortDesc. Give them a one-line
Long that explains what fields are returned, notes that API key secrets are
never included, and points at --output json for scripting — matching the
richer Long text of the create/update/delete siblings.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SWQ362qtJBoP3ncxRck9qu

Author: claude

cmd/kosli/getServiceAccount.go

@@ -12,6 +12,12 @@ import (
 
 const getServiceAccountShortDesc = `Get a service account's metadata.`
 
+const getServiceAccountLongDesc = getServiceAccountShortDesc + `
+
+The metadata includes the name, description, privilege, and creation time. The
+secret values of the account's API keys are never returned. Use ^--output json^
+to get the raw response for scripting.`
+
 const getServiceAccountExample = `
 # get the metadata of a service account:
 kosli get service-account yourServiceAccountName \
@@ -29,7 +35,7 @@ func newGetServiceAccountCmd(out io.Writer) *cobra.Command {
 		Use:     "service-account SERVICE-ACCOUNT-NAME",
 		Aliases: []string{"sa"},
 		Short:   getServiceAccountShortDesc,
-		Long:    getServiceAccountShortDesc,
+		Long:    getServiceAccountLongDesc,
 		Example: getServiceAccountExample,
 		Args:    cobra.ExactArgs(1),
 		PreRunE: func(cmd *cobra.Command, args []string) error {

cmd/kosli/listServiceAccounts.go

@@ -12,6 +12,12 @@ import (
 
 const listServiceAccountsShortDesc = `List service accounts in an organization.`
 
+const listServiceAccountsLongDesc = listServiceAccountsShortDesc + `
+
+Each entry shows the name, description, privilege, and creation time. The secret
+values of any API keys are never listed. Use ^--output json^ to get the raw
+response for scripting.`
+
 const listServiceAccountsExample = `
 # list the service accounts in an organization:
 kosli list service-accounts \
@@ -29,7 +35,7 @@ func newListServiceAccountsCmd(out io.Writer) *cobra.Command {
 		Use:     "service-accounts",
 		Aliases: []string{"sa", "sas", "service-account"},
 		Short:   listServiceAccountsShortDesc,
-		Long:    listServiceAccountsShortDesc,
+		Long:    listServiceAccountsLongDesc,
 		Example: listServiceAccountsExample,
 		Args:    cobra.NoArgs,
 		PreRunE: func(cmd *cobra.Command, args []string) error {