test: lint comfy hint-strings + snapshot the command inventory

comfy_cli/command/jobs.py

@@ -1094,7 +1094,7 @@ def _cloud_cancel(prompt_id: str) -> None:
         renderer.error(
             code="cloud_http_error",
             message=f"cancel failed: {e}",
-            hint="check network / `comfy auth whoami`",
+            hint="check network / `comfy cloud whoami`",
         )
         raise typer.Exit(code=1) from e
 

comfy_cli/command/models/search.py

@@ -173,7 +173,7 @@ def list_folders_cmd(
             renderer=renderer,
             target=target,
             message=f"HTTP {e.code} from {url}",
-            hint="run `comfy auth whoami` to verify auth"
+            hint="run `comfy cloud whoami` to verify auth"
             if target.is_cloud
             else "run `comfy launch` to start a local server",
         )
@@ -483,7 +483,7 @@ def search_cmd(
             renderer=renderer,
             target=target,
             message=f"HTTP {e.code} during models search",
-            hint="check auth (`comfy auth whoami`) or network",
+            hint="check auth (`comfy cloud whoami`) or network",
         )
     except (urllib.error.URLError, OSError, json.JSONDecodeError) as e:
         renderer.error(

comfy_cli/command/run_cli.py

@@ -516,13 +516,13 @@ def _build_steps(state: _DemoState) -> list[Step]:
             custom=_fleet_step,
         ),
         Step(
-            title="auth whoami — Comfy Cloud sign-in state",
+            title="cloud whoami — Comfy Cloud sign-in state",
             desc="Same commands work against Comfy Cloud via --where cloud (after `comfy cloud login`).",
             invocations=[
-                Invocation(argv=[*comfy, "auth", "whoami"], label="comfy auth whoami", optional=True),
+                Invocation(argv=[*comfy, "cloud", "whoami"], label="comfy cloud whoami", optional=True),
                 Invocation(
-                    argv=[*comfy, "--json", "auth", "whoami"],
-                    label="comfy --json auth whoami",
+                    argv=[*comfy, "--json", "cloud", "whoami"],
+                    label="comfy --json cloud whoami",
                     optional=True,
                 ),
             ],

comfy_cli/command/workflow.py

@@ -656,7 +656,7 @@ def _handle_cloud_http_error(renderer, e, *, operation: str, workflow_id: str |
         renderer.error(
             code="cloud_http_error",
             message=f"{operation} failed: {e}",
-            hint="check network / `comfy auth whoami`",
+            hint="check network / `comfy cloud whoami`",
         )
     return typer.Exit(code=1)
 

tests/comfy_cli/command/test_run_cli.py

@@ -41,7 +41,7 @@ def test_build_steps_contains_full_surface(self):
             "jobs status",
             "jobs watch",
             "fleet",
-            "auth",
+            "whoami",
         ]:
             assert needle in titles, f"missing coverage for: {needle}"
 

tests/comfy_cli/fixtures/cli_command_inventory.txt

@@ -0,0 +1,142 @@
+comfy _watch	[hidden]
+comfy _watch _watch-job
+comfy agent-review	[hidden]
+comfy assets
+comfy assets push
+comfy auth
+comfy auth list
+comfy auth remove
+comfy auth set
+comfy cloud
+comfy cloud login
+comfy cloud logout
+comfy cloud set-base-url
+comfy cloud set-key	[hidden]
+comfy cloud whoami
+comfy code-search
+comfy cs	[hidden]
+comfy dependency	[hidden]
+comfy discover
+comfy download
+comfy env
+comfy feedback
+comfy generate
+comfy help
+comfy install
+comfy jobs
+comfy jobs cancel
+comfy jobs ls
+comfy jobs status
+comfy jobs wait
+comfy jobs watch
+comfy launch
+comfy logs
+comfy manager
+comfy manager clear
+comfy manager disable
+comfy manager disable-gui
+comfy manager enable-gui
+comfy manager enable-legacy-gui
+comfy manager migrate-legacy
+comfy manager uv-compile-default
+comfy model
+comfy model download
+comfy model list
+comfy model remove
+comfy models
+comfy models list-folder
+comfy models list-folders
+comfy models search
+comfy models show
+comfy node
+comfy node bisect
+comfy node bisect bad
+comfy node bisect good
+comfy node bisect reset
+comfy node bisect start
+comfy node deps-in-workflow
+comfy node disable
+comfy node enable
+comfy node fix
+comfy node init
+comfy node install
+comfy node install-deps
+comfy node pack
+comfy node publish
+comfy node registry-install	[hidden]
+comfy node registry-list	[hidden]
+comfy node reinstall
+comfy node restore-dependencies
+comfy node restore-snapshot
+comfy node save-snapshot
+comfy node scaffold
+comfy node show
+comfy node simple-show
+comfy node uninstall
+comfy node update
+comfy node update-cache
+comfy node uv-sync
+comfy node validate
+comfy nodes
+comfy nodes categories
+comfy nodes downstream
+comfy nodes ls
+comfy nodes path
+comfy nodes refresh
+comfy nodes search
+comfy nodes show
+comfy nodes types
+comfy nodes upstream
+comfy pr-cache
+comfy pr-cache clean
+comfy pr-cache list
+comfy preview
+comfy project
+comfy project init
+comfy project status
+comfy run
+comfy run-cli
+comfy set-default
+comfy setup
+comfy skill	[hidden]
+comfy skill install
+comfy skill list
+comfy skill show
+comfy skill status
+comfy skill uninstall
+comfy skill validate
+comfy skills
+comfy skills install
+comfy skills list
+comfy skills show
+comfy skills status
+comfy skills uninstall
+comfy skills validate
+comfy standalone
+comfy stop
+comfy templates
+comfy templates fetch
+comfy templates ls
+comfy templates refresh
+comfy templates show
+comfy tracking
+comfy tracking disable
+comfy tracking enable
+comfy update
+comfy upload
+comfy validate
+comfy which
+comfy workflow
+comfy workflow compose
+comfy workflow decompose
+comfy workflow delete
+comfy workflow fragment
+comfy workflow fragment ls
+comfy workflow fragment show
+comfy workflow fragment validate
+comfy workflow get
+comfy workflow list
+comfy workflow save
+comfy workflow set-slot
+comfy workflow slots
+comfy workflow vary