feat(run): explain roar register after the next-steps hint#110
Merged
Conversation
5 tasks
6ebecf4 to
289f189
Compare
TrevorBasinger
approved these changes
May 19, 2026
289f189 to
15f66bc
Compare
After `roar run` completes, the hint block already prints:
hint: next: roar show --job abc12345 · roar dag · roar register @3
But for a user (or coding agent) reading the run output for the first
time, "roar register @3" is opaque — they don't yet know it publishes
to GLaaS, or why they'd want to. Add a one-line explainer right after:
hint: next: roar show --job abc12345 · roar dag · roar register @3
'roar register @3' uploads lineage to glaas.ai so you can reproduce it later.
The explainer uses the same `register_arg` as the action line (so the
two stay in sync between the `@N` form and the UID fallback), inherits
the existing stream + gate (quiet / pipe-mode / `hints.enabled = false`
all still suppress it), and reuses the warn_amber styling so the two
lines read as one block.
Tests:
- `test_next_steps_hint_explains_what_register_does` — asserts the
explainer follows the action line and references the same `@N` form.
- `test_next_steps_hint_explainer_uses_uid_form_when_no_step_number`
— UID-form fallback parity: action line and explainer agree.
938 unit tests passing, 1 pre-existing skipped.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
15f66bc to
1bd7d54
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The post-`roar run` hint block already nudges:
```
hint: next: roar show --job abc12345 · roar dag · roar register @3
```
…but `roar register @3` is opaque to first-time users (and to coding agents reading the output programmatically). Adds a one-line explainer right after:
```
hint: next: roar show --job abc12345 · roar dag · roar register @3
'roar register @3' uploads lineage to glaas.ai so you can reproduce it later.
```
Details
Independence
Not stacked on #109 (the hints-to-stderr change). The new line goes through the same `_print` + `style` calls as the existing hint, so it inherits whatever gating + stream choice is in effect — works with the old TTY-suppressed semantics today, and will compose cleanly with #109 if both merge.
Test plan
🤖 Generated with Claude Code