From 64766ba9ed49b54b19dc20f7335f12991f1d84aa Mon Sep 17 00:00:00 2001 From: YeonGyu-Kim Date: Mon, 27 Apr 2026 12:31:42 +0900 Subject: [PATCH] roadmap: #307 filed (no shell completion scripts for bash/zsh/fish) --- ROADMAP.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/ROADMAP.md b/ROADMAP.md index 0db08f8..cee9e51 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -17801,3 +17801,28 @@ Required fix shape: (a) classify `empty_stream` / stream-closed-before-first-pay - `claw --version` output: `claw 0.1.0 (abc1234 2026-04-27 aarch64-apple-darwin release)` - `claw --version --verbose`: full build metadata block - Acceptance: `claw --version | grep -E '[0-9a-f]{7}'` passes + +### #307 — No shell completion scripts for bash/zsh/fish/PowerShell + +**Exact pinpoint:** `claw` provides multiple subcommands (`run`, `status`, `branches`, `lanes`, `doctor`, `compact`, `resume`, `new`, `sync`) and many flags (`--output-format`, `--provider`, `--model`, `--max-turns`, `--cwd`, etc.), but ships no shell completion scripts. Users must type full command names and flags from memory or with `--help` reference. No `claw completions bash|zsh|fish|powershell` subcommand, no generated completion files, no install instructions in USAGE.md or CONTRIBUTING.md. + +**Live evidence:** +- Extended dogfood audit (15+ hours) involved hundreds of `claw` invocations across subcommands — all typed manually without autocomplete +- `rust/crates/rusty-claude-cli/src/main.rs`: no `clap::Shell`, `clap_complete`, or `generate_to` usage found +- No `.bash_completion`, `_claw` (zsh), or `claw.fish` files in repo +- Clawhip nudge prompt lists "startup friction" as priority category + +**Why distinct:** +- #294 (first-run onboarding wizard) — covers guided setup, NOT tab completion +- #301 (no pre-built binary distribution) — covers install friction, NOT shell integration +- #306 (`--version` build metadata) — covers binary identification, NOT shell completion + +**Concrete delta landed:** ROADMAP.md appended with #307. + +**Fix shape recorded:** +- Add `clap_complete` dependency to `rusty-claude-cli/Cargo.toml` +- `claw completions ` subcommand: `bash`, `zsh`, `fish`, `powershell`, `elvish` +- `build.rs` generation: auto-generate completion files to `target/completions/` on build +- USAGE.md: add "Shell Completion" section with install instructions per shell +- Homebrew formula: include completion install step +- Acceptance: `claw completions zsh > ~/.zsh/completions/_claw && exec zsh` gives tab completion