@k-msg/cli 0.8.17 → 0.9.1

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @k-msg/cli
 
+## 0.9.1 — 2026-03-01
+
+### Patch changes
+
+- [52275fb](https://github.com/k-otp/k-msg/commit/52275fb36874dc9445637931d524cb46af37d835) Automatically configure shell completion during curl installer runs for detected `zsh`, `bash`, and `fish` shells.
+  
+  - Add installer flags:
+    - `K_MSG_CLI_SETUP_COMPLETIONS` (`true` by default, set `false` to opt out)
+    - `K_MSG_CLI_SHELL` (override shell detection for completion setup)
+  - Resolve shell init targets by shell context:
+    - `zsh`: `${ZDOTDIR:-$HOME}/.zshrc`
+    - `bash`: `~/.bashrc` + login profile (`~/.bash_profile` or `~/.profile`)
+    - `fish`: completion file under `~/.config/fish/completions`
+  - Register completion alias for `kmsg` alongside `k-msg`.
+  - Print shell reload hints after completion setup to reduce post-install confusion.
+  - Keep install success resilient by warning instead of failing when completion setup cannot be applied. — Thanks @imjlk!
+
+## 0.9.0 — 2026-03-01
+
+### Minor changes
+
+- [ee90600](https://github.com/k-otp/k-msg/commit/ee90600cc60e349544edee57101d5ae88002c7e0) Migrate `@k-msg/cli` to Bunli 0.7.1 and adopt the 0.7 command model.
+  
+  - Convert command trees to `defineGroup` for Bunli 0.7.x compatibility.
+  - Add runtime-safe shell completions via `k-msg completions <bash|zsh|fish|powershell>` and `k-msg complete -- ...`.
+  - Replace custom readline/arrow interactive flows with Bunli/Clack prompt APIs.
+  - Standardize interactive cancellation (`Ctrl+C`) to exit with code `2`.
+  - Add completion validation/smoke checks in CI and CLI distribution workflows. — Thanks @imjlk!
+
 ## 0.8.17 — 2026-02-28
 
 ### Patch changes

package/README.md

@@ -14,16 +14,27 @@ Installer environment variables:
 - `K_MSG_CLI_VERSION`: override target version (default: latest Pages script version)
 - `K_MSG_CLI_INSTALL_DIR`: target directory override (default: auto-detect active `k-msg` directory when writable, otherwise `~/.local/bin`)
 - `K_MSG_CLI_BASE_URL`: override release base URL (default: `https://github.com/k-otp/k-msg/releases/download/cli-v<version>`)
+- `K_MSG_CLI_SETUP_COMPLETIONS`: set `false` to skip automatic shell completion setup (default: `true`)
+- `K_MSG_CLI_SHELL`: override shell detection for completion setup (`zsh|bash|fish`)
 
 The project now standardizes user-facing CLI installation on the curl installer path.
 Other install paths are intentionally undocumented here.
 
+By default, the installer also auto-configures shell completion for detected `zsh`, `bash`, or `fish`.
+It resolves shell init files by context:
+- `zsh`: `${ZDOTDIR:-$HOME}/.zshrc`
+- `bash`: `~/.bashrc` plus login profile (`~/.bash_profile` or `~/.profile`)
+- `fish`: `~/.config/fish/completions/k-msg.fish`
+
 ## Run (local/dev)
 
 ```bash
 # Generate command types
 bun run --cwd apps/cli generate
 
+# Validate completion metadata graph (strict)
+bun run --cwd apps/cli doctor:completions
+
 # Build native binary
 bun run --cwd apps/cli build
 ./apps/cli/dist/k-msg --help
@@ -36,6 +47,36 @@ bun --cwd apps/cli dist/k-msg.js --help
 bun --cwd apps/cli src/k-msg.ts --help
 ```
 
+## Shell Completions
+
+If installed via curl installer, completion is configured automatically for your detected shell.
+Use manual setup only when you want custom paths or a non-default shell setup.
+Installer-generated completion also covers the `kmsg` alias.
+
+```bash
+# Print completion script
+k-msg completions bash
+k-msg completions zsh
+k-msg completions fish
+k-msg completions powershell
+
+# Completion protocol callback (used by shell scripts)
+k-msg complete -- ""
+```
+
+Shell init examples:
+
+```bash
+# bash
+k-msg completions bash > ~/.bash_completion.d/k-msg
+source ~/.bash_completion.d/k-msg
+
+# zsh
+k-msg completions zsh > "${HOME}/.zfunc/_k-msg"
+fpath+=("${HOME}/.zfunc")
+autoload -Uz compinit && compinit
+```
+
 ## Config (`k-msg.config.json`)
 
 Default config path:
@@ -129,6 +170,7 @@ Required values by provider/channel:
 - `k-msg providers list|health|doctor`
 - `k-msg sms send`
 - `k-msg alimtalk preflight|send`
+- `k-msg completions <bash|zsh|fish|powershell>`
 - `k-msg send --input <json> | --file <path> | --stdin` (advanced/raw JSON only)
 - `k-msg db schema print|generate`
 - `k-msg db tracking migrate plan|apply|status|retry`
@@ -347,6 +389,7 @@ k-msg kakao template request --template-id TPL_001 --channel main
 - exit code:
   - `0`: success
   - `2`: input/config error
+  - `2`: interactive prompt cancelled (`Ctrl+C`)
   - `3`: provider/network error
   - `4`: unsupported capability (for example, provider does not support `balance`)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k-msg/cli",
-  "version": "0.8.17",
+  "version": "0.9.1",
   "private": false,
   "description": "k-msg CLI (prebuilt binaries via GitHub Releases)",
   "type": "module",
@@ -21,6 +21,7 @@
   ],
   "scripts": {
     "generate": "bunli generate",
+    "doctor:completions": "bun run generate && bunx bunli@0.7.1 doctor completions --strict",
     "build": "bunli build",
     "build:all": "bunli build --targets all",
     "build:native": "bunli build --targets native",
@@ -33,18 +34,19 @@
     "clean": "rm -rf dist"
   },
   "devDependencies": {
-    "@k-msg/channel": "0.22.3",
-    "@k-msg/core": "0.22.3",
-    "@k-msg/messaging": "0.22.3",
-    "@k-msg/provider": "0.22.3",
-    "@k-msg/template": "0.22.3",
-    "@bunli/core": "^0.5.4",
-    "@bunli/plugin-ai-detect": "^0.5.2",
-    "@bunli/test": "^0.3.2",
+    "@bunli/core": "^0.7.0",
+    "@bunli/plugin-ai-detect": "^0.6.2",
+    "@bunli/plugin-completions": "^0.3.3",
+    "@bunli/test": "^0.4.2",
+    "@k-msg/channel": "0.28.0",
+    "@k-msg/core": "0.28.0",
+    "@k-msg/messaging": "0.28.0",
+    "@k-msg/provider": "0.28.0",
+    "@k-msg/template": "0.28.0",
     "@types/bun": "^1.3.9",
     "@types/node": "^22.0.0",
-    "bunli": "^0.5.3",
-    "k-msg": "0.22.3",
+    "bunli": "^0.7.1",
+    "k-msg": "0.28.0",
     "solapi": "^5.5.4",
     "typescript": "^5.7.2",
     "zod": "^4.0.14"