Skip to content

docs(spec): jackin help command cargo-style design#202

Merged
donbeave merged 1 commit intomainfrom
jackin/scratch/jackin-the-architect
May 1, 2026
Merged

docs(spec): jackin help command cargo-style design#202
donbeave merged 1 commit intomainfrom
jackin/scratch/jackin-the-architect

Conversation

@donbeave
Copy link
Copy Markdown
Member

@donbeave donbeave commented May 1, 2026

Summary

Design spec for the jackin help [COMMAND]... feature, mirroring cargo's help subcommand exactly.

Key decisions:

  • jackin help config auth → long-form man page output (distinct from jackin config auth --help which stays as clap's short summary)
  • Display chain: manless/more → raw stdout
  • Man pages generated at build time via clap_mangen, bundled as embedded gzip tar archive
  • Fallback to next option only when binary not found in PATH (not on exit code — user quitting man with q counts as success)

Review focus

Please check the spec at docs/superpowers/specs/2026-05-01-jackin-help-command-design.md and comment with any changes before implementation begins.

Test plan

  • Spec reviewed and approved on this PR

🤖 Generated with Claude Code

Co-authored-by: Claude <noreply@anthropic.com>
Signed-off-by: Alexey Zhokhov <alexey@zhokhov.com>
@donbeave donbeave merged commit 0ed9ff6 into main May 1, 2026
6 checks passed
@donbeave donbeave deleted the jackin/scratch/jackin-the-architect branch May 1, 2026 16:00
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.

1 participant