feat: group root help into Setup, Resources, Advanced, and Maintenance - #34
Merged
Merged
Conversation
Twenty-five commands in one flat list hid the twelve resource commands between setup and maintenance commands. The root help now lists them under four headings. Setup follows the first-run flow, Resources stay alphabetical, and the implicit help command joins Maintenance instead of standing alone under a bare Commands heading. Bump Commander from 13 to 14 for native help groups. Commander 14 keeps the Node 20 floor. Trim the five descriptions that wrapped at 80 columns (setup-skill, completion, webhooks, api, doctor). The dropped detail moves into each command's own --help. Mirror the four groups in the README Commands section. Every existing line carries over. The api and doctor commands gain short sections. Grouping is presentation only. The surface snapshot is unchanged.
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.
What changed
kit --helplisted 25 commands in one flat list. The 12 resource commands people use most sat between setup and maintenance commands. The root help now lists them under four headings:Setup follows the first-run flow. Resources stay alphabetical. The implicit
helpcommand joins Maintenance, so no command stands alone under a bare "Commands:" heading.commandsGroup()), so the grouping is a few lines insrc/program.js. Commander 14 keeps the Node 20 floor thatenginesalready requires. Commander 15 requires Node 22.12, so this stops at 14.setup-skill,completion,webhooks,api, anddoctor. The dropped detail moves into each command's own--help. For example,kit api --helpnow shows the escape-hatch note and two examples, andkit completion --helpshows the three shell rc lines.apianddoctorcommands gain short sections, which they did not have before.Why
Grouping helps a new user find the setup commands and a returning user skip past them. Trimming the descriptions keeps each group compact, because a wrapped line takes as much space as two commands.
For the reviewer
spec/cli-surface.jsonrecords names, arguments, and flags, not help text. The snapshot is unchanged, so the release gate sees no breaking change.scripts/program-help-groups.test.jsspawns the real binary and asserts the heading order, each group's members, alphabetical Resources, and no wrapped descriptions. Both suites failed before the change and pass after it.skills/kit/SKILL.mdkeeps its own "Auth & Config" grouping. It serves Claude rather than a terminal, so it is out of scope here.