Skip to content

feat: refine CLI command and help UX#16

Merged
Icemap merged 4 commits into
mainfrom
agent/simplify-fs-deletion-and-docs
Jul 21, 2026
Merged

feat: refine CLI command and help UX#16
Icemap merged 4 commits into
mainfrom
agent/simplify-fs-deletion-and-docs

Conversation

@Icemap

@Icemap Icemap commented Jul 20, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Remove the console-style --confirm-file-system-name requirement from tdc fs delete-file-system.
  • Make bare tdc return an AWS-style two-level usage error while preserving explicit help and version paths.
  • Format help flag types as <type>, mark required flags with (required), and label the configure value as Default region code.
  • Start human-readable error output with a blank line for clearer terminal separation.
  • Update tests, README, AGENTS, completed specs, CI cleanup, and documentation; remove the unused docs-cn submodule.

Why

The CLI should be predictable for both terminal users and agents. Filesystem deletion no longer repeats the resource name as a console confirmation, root invocation has a deterministic usage result, and generated help now distinguishes required inputs from optional inputs without requiring users to infer the command contract.

User impact

  • Filesystem deletion requires only --file-system-name.
  • Bare tdc writes a compact synopsis to stderr and exits with code 2; tdc help remains successful.
  • Flags and Global Flags render typed values such as <string>, and required flags are marked explicitly.
  • Configure help and prompts describe Default region code.
  • Human-readable errors begin on a new line.

Validation

  • make test
  • make e2e
  • direct bin/tdc help, stderr byte, and exit-code verification
  • git diff --check

@Icemap Icemap changed the title feat: simplify filesystem deletion workflow feat: refine filesystem deletion and root command UX Jul 21, 2026
@ti-chi-bot ti-chi-bot Bot added size/XL and removed size/L labels Jul 21, 2026
@Icemap Icemap changed the title feat: refine filesystem deletion and root command UX feat: refine CLI command and help UX Jul 21, 2026
@Icemap
Icemap merged commit 23956cb into main Jul 21, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant