Skip to content

CLI help and flag-parsing consistency fixes - #136

Merged
androidand merged 1 commit into
mainfrom
fix/135-cli-help-consistency-fixes
Aug 19, 2026
Merged

CLI help and flag-parsing consistency fixes#136
androidand merged 1 commit into
mainfrom
fix/135-cli-help-consistency-fixes

Conversation

@androidand

Copy link
Copy Markdown
Owner

What

  • Remove dead relate/work-graph dispatch: specsync relate was silently
    falling through to a live sync instead of erroring, contradicting
    README's own documented (dry-run-free) example.
  • Fix agent-help/doctor ignoring --json/-json when it comes after the
    subcommand name — the exact order the tool's own help text told people to
    use.
  • Add agent-help entries for doctor, epic, idea, ideas, archive,
    set-priority, note — all 25 real subcommands are now documented.
  • Standardize on single-dash (-flag) style across README.md,
    WORKFLOW.md, CLAUDE.md, and agent_help.go's own examples/tips.

-flag vs --flag itself is not a bug — Go's flag package treats them
identically for every option — but the docs and help text mixed styles
inconsistently, and one real safety bug was hiding under the same question.

Closes #135

🤖 Generated with Claude Code

- Remove dead relate/work-graph dispatch so specsync relate errors
  instead of silently running a live sync
- Fix agent-help/doctor ignoring -json when placed after the
  subcommand name
- Add agent-help entries for doctor, epic, idea, ideas, archive,
  set-priority, note
- Standardize docs and CLI help text on single-dash flag style
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying specsync with  Cloudflare Pages  Cloudflare Pages

Latest commit: ea3ffb4
Status: ✅  Deploy successful!
Preview URL: https://2dad0d08.specsync.pages.dev
Branch Preview URL: https://fix-135-cli-help-consistency.specsync.pages.dev

View logs

@androidand
androidand merged commit c0df166 into main Aug 19, 2026
2 checks passed
@androidand
androidand deleted the fix/135-cli-help-consistency-fixes branch August 19, 2026 18:31
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.

CLI help and flag-parsing consistency fixes

1 participant