…ton)

Now that hint suppression is centralized in the `out` singleton (huggingface#4310),
the `out.mode not in (json, quiet)` guard on the empty-`ps` hint is
redundant: quiet is suppressed centrally, and json gets the hint on
stderr (treated like agent). Remove the guard and the now-unused
OutputFormat import.

Update test_ps_empty_json to parse result.stdout (the hint goes to
stderr and never pollutes the JSON), matching the other json.loads tests.
Regenerate cli.md so the --detach examples are in sync.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* [CLI] Agent-friendly hints + examples for hf jobs

- logs: note that --follow exits when the stream ends regardless of job
  outcome; add a hint pointing at `hf jobs inspect <id>` for the final status
- ps: hint about -a/--all when nothing is running and no filters are set
- run/uv run: detach hint points at `logs -f` / `inspect`; add `-d` examples
  so the detach->poll workflow is discoverable (feeds the auto-generated skill)

Hints go to stderr (out convention) so they don't pollute agent-parsed stdout.
No --format examples on purpose: agent output is already auto-selected via is_agent().

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* Don't show 'no running jobs' hint when only label filters applied

The ps empty-state branch checked `filters` but not `labels_filters`, so
`hf jobs ps --filter label=...` with no matches wrongly suggested `-a/--all`
even when running jobs exist (just excluded by the label). Guard the hint on
`not labels_filters` too.

Reported by Cursor Bugbot on #4308.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* Regenerate CLI reference for hf jobs help/examples changes

Ran utils/generate_cli_reference.py --update after editing logs docstring
and run/uv-run examples. Fixes check_code_quality.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* Only show ps empty-state hint in human/agent modes

Keep `--format json` (-> []) and `-q` (-> empty) output clean for machine
consumers; fixes test_ps_empty_json / test_ps_empty_quiet. Mirrors the
out.mode gating already used in repos.py / buckets.py / _file_listing.py.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* Keep namespace in job hints so inspect/logs target the right job

The logs --follow hint suggested `hf jobs inspect <id>` with only the bare
parsed id, and the run/uv-run detach hints used `<id>` too. For jobs addressed
via `namespace/job_id` or `--namespace` (or run under an org), that defaults to
the current user -> 404 / wrong job. Qualify the reference: logs uses the parsed
namespace when set; detach uses job.owner.name.

Reported by Cursor Bugbot on #4308.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* Update src/huggingface_hub/cli/jobs.py

Co-authored-by: Lucain <lucainp@gmail.com>

* Update src/huggingface_hub/cli/jobs.py

Co-authored-by: Lucain <lucainp@gmail.com>

* [CLI] Drop redundant ps empty-state hint guard (handled by out singleton)

Now that hint suppression is centralized in the `out` singleton (#4310),
the `out.mode not in (json, quiet)` guard on the empty-`ps` hint is
redundant: quiet is suppressed centrally, and json gets the hint on
stderr (treated like agent). Remove the guard and the now-unused
OutputFormat import.

Update test_ps_empty_json to parse result.stdout (the hint goes to
stderr and never pollutes the JSON), matching the other json.loads tests.
Regenerate cli.md so the --detach examples are in sync.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: Lucain <lucainp@gmail.com>