Skip to content

Improve CLI UX#122

Merged
orlandohohmeier merged 2 commits intoalphafrom
orlandohohmeier/improve-cli-ux
Nov 13, 2025
Merged

Improve CLI UX#122
orlandohohmeier merged 2 commits intoalphafrom
orlandohohmeier/improve-cli-ux

Conversation

@orlandohohmeier
Copy link
Copy Markdown
Contributor

This PR rewrite the CLI help and config docs and make sure the gateway config is validated before, to generally improve the user experience.

@orlandohohmeier orlandohohmeier requested review from l45k and nfnt and removed request for l45k November 12, 2025 17:38
nfnt
nfnt previously approved these changes Nov 12, 2025
Copy link
Copy Markdown
Contributor

@nfnt nfnt left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! CI is failing though, seems to be caused by a doc test.

@orlandohohmeier
Copy link
Copy Markdown
Contributor Author

Dang, yes forgot to add a don't run as that isn't actually a test.

orlandohohmeier and others added 2 commits November 12, 2025 22:57
Rephrased _every_ command’s `about`/`long_about` text using `indoc!`, so multi-line help renders cleanly and actually explains the scheduler, gateway, worker, and cert utilities. The config modules now describe required fields (like gateway `external_addresses`) and defaults inline, giving users immediate context instead of chasing the handbook.

Co-Authored-By: ChatGPT <openai@users.noreply.github.com>
Gateway now calls `Config::validate()` right after loading settings, so misconfigured nodes (e.g., missing `external_addresses`) fail fast with a targeted error instead of hanging silently. This keeps users from deploying unusable gateways and makes troubleshooting much clearer.
@codecov
Copy link
Copy Markdown

codecov bot commented Nov 12, 2025

Codecov Report

❌ Patch coverage is 0% with 16 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
crates/gateway/src/config.rs 0.00% 12 Missing ⚠️
crates/gateway/src/bin/hypha-gateway.rs 0.00% 4 Missing ⚠️

📢 Thoughts on this report? Let us know!

Comment on lines +91 to +93
/// slice-0000.bin
/// slice-0001.bin
/// slice-0002.bin
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

NIT: we use safetensors 🙈

with code 0 if the peer is healthy, or non-zero otherwise.

Useful for:
* Container health checks (Docker, Kubernetes)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Container health checks?


Useful for:
* Verifying gateway connectivity before starting jobs
* Container health checks (Docker, Kubernetes)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same as above


Useful for:
* Verifying gateway connectivity before starting jobs
* Container health checks (Docker, Kubernetes)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same as above

@orlandohohmeier orlandohohmeier merged commit 41abe8f into alpha Nov 13, 2025
8 of 9 checks passed
@orlandohohmeier orlandohohmeier deleted the orlandohohmeier/improve-cli-ux branch November 13, 2025 09:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants