@k-msg/cli 0.6.0 → 0.6.2

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @k-msg/cli
 
+## 0.6.2 — 2026-02-19
+
+### Patch changes
+
+- [7797dc8](https://github.com/k-otp/k-msg/commit/7797dc8dacc4024a2b825fe46c6f266e271e822d) - Fix provider balance CLI exit code semantics: return exit code 3 only for provider errors and 4 when capability is unsupported.
+  - Update CLI/README docs to use the correct `providers list --config ...` usage and clarify capability-not-supported exit code.
+  - Add GitHub repository button to docs home pages (KO/EN). — Thanks @imjlk!
+
+## 0.6.1 — 2026-02-18
+
+### Patch changes
+
+- [19e519f](https://github.com/k-otp/k-msg/commit/19e519f0edcb4f3a00d07f090046f30ac5c5e87b) Harden CLI/core reliability by making option parsing deterministic (`--flag`/`--no-flag` with strict boolean validation), aligning provider error payloads to `details`, and migrating the send contract field to `templateId` (without compatibility aliases) with matching docs/tests and canonical CI parity checks. — Thanks @imjlk!
+- [aafac43](https://github.com/k-otp/k-msg/commit/aafac43c09c7b95a0a50af610662c91cbc4e6c76) Remove duplicated CLI provider config metadata by sourcing labels, routing seed types, and recommended defaults from `@k-msg/provider`. Also update template option wording to `Template ID` and fix root breaking-change notes to `templateCode -> templateId`. — Thanks @imjlk!
+- Updated dependencies: core@0.18.2, messaging@0.18.2, provider@0.18.2, k-msg@0.18.2
+
 ## 0.6.0 — 2026-02-18
 
 ### Minor changes

package/README.md

@@ -94,9 +94,11 @@ Default config path:
 Override:
 
 ```bash
-k-msg --config /path/to/k-msg.config.json providers list
+k-msg providers list --config /path/to/k-msg.config.json
 ```
 
+Note: `--config` is a subcommand option in the current CLI (for example: `providers`, `sms`, `alimtalk`).
+
 Example file: `apps/cli/k-msg.config.example.json`
 
 Schema URLs:
@@ -123,6 +125,50 @@ k-msg config provider add iwinv
 Any string value like `"env:NAME"` is replaced with the `NAME` environment variable at runtime.
 If the env var is missing/empty, commands that need runtime providers will fail with exit code `2`.
 
+### Provider send value guide
+
+When you are unsure which values must be prepared before send, use this checklist:
+
+1. Configure provider credentials with `env:` references.
+2. Run `k-msg providers doctor` to verify account/config readiness.
+3. For AlimTalk, run `k-msg alimtalk preflight` with the provider/template/channel you will use.
+4. Send only after preflight passes.
+
+Credential examples:
+
+```bash
+# Aligo
+export ALIGO_API_KEY="..."
+export ALIGO_USER_ID="..."
+export ALIGO_SENDER_KEY="..."   # Kakao senderKey
+export ALIGO_SENDER="029302266" # SMS/LMS sender
+
+# IWINV
+export IWINV_API_KEY="..."          # AlimTalk key
+export IWINV_SMS_API_KEY="..."      # SMS/LMS/MMS key
+export IWINV_SMS_AUTH_KEY="..."     # SMS/LMS/MMS secret
+export IWINV_SMS_COMPANY_ID="..."   # status/balance context
+export IWINV_SENDER_NUMBER="029302266"
+
+# SOLAPI
+export SOLAPI_API_KEY="..."
+export SOLAPI_API_SECRET="..."
+export SOLAPI_DEFAULT_FROM="029302266"
+export SOLAPI_KAKAO_PF_ID="..."     # Kakao profileId(pfId)
+```
+
+Required values by provider/channel:
+
+| Provider | Channel | Required config keys | Required send-time values | Notes |
+| --- | --- | --- | --- | --- |
+| `aligo` | `SMS/LMS/MMS` | `apiKey`, `userId` | `to`, `text`, sender (`--from` or `aligo.config.sender`) | MMS also needs image input |
+| `aligo` | `ALIMTALK` | `apiKey`, `userId` | `to`, `template-id`, `vars`, senderKey (`--sender-key`/`--channel` alias/`aligo.config.senderKey`), sender (`--from` or `aligo.config.sender`) | `preflight` validates channel/template access |
+| `iwinv` | `SMS/LMS/MMS` | `apiKey`, `smsApiKey`, `smsAuthKey` | `to`, `text`, sender (`--from` or `iwinv.config.smsSenderNumber`/`senderNumber`) | MMS requires image binary input |
+| `iwinv` | `ALIMTALK` | `apiKey` | `to`, `template-id`, `vars` | If failover/reSend is enabled, sender callback is required (`--from` or sender number in config) |
+| `solapi` | `SMS/LMS/MMS` | `apiKey`, `apiSecret` | `to`, `text`, sender (`--from` or `solapi.config.defaultFrom`) | MMS also needs image input |
+| `solapi` | `ALIMTALK` | `apiKey`, `apiSecret` | `to`, `template-id`, `vars`, profileId/pfId (`--sender-key`/channel alias or `solapi.config.kakaoPfId`) | For preflight policy checks, set `plusId` via `--plus-id` or channel/default alias |
+| `mock` | all | none | minimal message fields (`to`, `text` or `template-id`/`vars`) | Local test provider |
+
 ## Commands
 
 - `k-msg config init|show|validate`
@@ -142,8 +188,8 @@ If the env var is missing/empty, commands that need runtime providers will fail
 
 ```bash
 k-msg providers doctor
-k-msg alimtalk preflight --provider iwinv --template-code TPL_001 --channel main
-k-msg alimtalk send --provider iwinv --template-code TPL_001 --to 01012345678 --vars '{"name":"Jane"}'
+k-msg alimtalk preflight --provider iwinv --template-id TPL_001 --channel main
+k-msg alimtalk send --provider iwinv --template-id TPL_001 --to 01012345678 --vars '{"name":"Jane"}'
 ```
 
 Notes:
@@ -166,7 +212,7 @@ Terminology: the CLI uses **Kakao Channel** and **senderKey** (never “profile
 ```bash
 k-msg alimtalk send \
   --to 01012345678 \
-  --template-code TPL_001 \
+  --template-id TPL_001 \
   --vars '{"name":"Jane"}' \
   --channel main \
   --plus-id @my_channel
@@ -177,7 +223,7 @@ Failover options:
 ```bash
 k-msg alimtalk send \
   --to 01012345678 \
-  --template-code TPL_001 \
+  --template-id TPL_001 \
   --vars '{"name":"Jane"}' \
   --failover true \
   --fallback-channel sms \
@@ -192,7 +238,7 @@ When providers return send warnings (for example failover partial/unsupported),
 ```bash
 k-msg alimtalk preflight \
   --provider iwinv \
-  --template-code TPL_001 \
+  --template-id TPL_001 \
   --channel main \
   --sender-key your_sender_key \
   --plus-id @my_channel
@@ -226,6 +272,18 @@ k-msg send --input '[{"to":"01011112222","text":"hello 1"},{"to":"01033334444","
 - `k-msg providers doctor`: provider/account/capability readiness checks
 - `k-msg send --dry-run`: request payload preview/validation (no provider send)
 
+Boolean flag semantics (applies to `--json`, `--verbose`, `--dry-run`, `--stdin`, `--failover`, `--force`):
+
+- `--flag` -> `true`
+- `--flag true` -> `true`
+- `--flag false` -> `false`
+- `--no-flag` -> `false`
+- Invalid boolean values (for example `--dry-run maybe`) fail with exit code `2`
+
+Resolution precedence for overlapping values is:
+
+- `CLI flag > environment variable > config file > built-in default`
+
 ## Kakao Channel (Aligo capability)
 
 ```bash
@@ -246,13 +304,13 @@ Channel scope (Aligo): use `--channel <alias>` or `--sender-key <value>`.
 
 ```bash
 k-msg kakao template list
-k-msg kakao template get --template-code TPL_001
+k-msg kakao template get --template-id TPL_001
 k-msg kakao template create --name "Welcome" --content "Hello #{name}" --channel main
-k-msg kakao template update --template-code TPL_001 --name "Updated"
-k-msg kakao template delete --template-code TPL_001
+k-msg kakao template update --template-id TPL_001 --name "Updated"
+k-msg kakao template delete --template-id TPL_001
 
 # inspection request is provider-dependent (supported by Aligo)
-k-msg kakao template request --template-code TPL_001 --channel main
+k-msg kakao template request --template-id TPL_001 --channel main
 ```
 
 ## Output / Exit Codes
@@ -262,11 +320,12 @@ k-msg kakao template request --template-code TPL_001 --channel main
   when an agent is detected (`CLAUDECODE`, `CURSOR_AGENT`, `CODEX_CI` /
   `CODEX_SHELL` / `CODEX_THREAD_ID`, `MCP_SERVER_NAME` / `MCP_SESSION_ID` /
   `MCP_TOOL_NAME`)
+- Force text output in AI environments with `--json false` (or `--no-json`)
 - exit code:
   - `0`: success
   - `2`: input/config error
   - `3`: provider/network error
-  - `4`: capability not supported
+  - `4`: unsupported capability (for example, provider does not support `balance`)
 
 ## Manual Check Config Example
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k-msg/cli",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "private": false,
   "description": "k-msg CLI (prebuilt binaries via GitHub Releases)",
   "type": "module",
@@ -26,21 +26,23 @@
     "build:native": "bunli build --targets native",
     "build:js": "bun run generate && bun build src/k-msg.ts --outdir=dist --format=esm --target=bun",
     "dev": "bun run generate && bun --watch src/k-msg.ts",
+    "typecheck": "bun run generate && tsc --noEmit -p tsconfig.json",
     "test": "bun run generate && bun test",
     "schema:generate": "bun run scripts/generate-config-schema.ts",
     "schema:check": "bun run scripts/generate-config-schema.ts --check",
     "clean": "rm -rf dist"
   },
   "devDependencies": {
-    "@k-msg/core": "0.17.0",
-    "@k-msg/provider": "0.17.0",
+    "@k-msg/core": "0.18.2",
+    "@k-msg/messaging": "0.18.2",
+    "@k-msg/provider": "0.18.2",
     "@bunli/core": "^0.5.4",
     "@bunli/plugin-ai-detect": "^0.5.2",
     "@bunli/test": "^0.3.2",
     "@types/bun": "^1.3.9",
     "@types/node": "^22.0.0",
     "bunli": "^0.5.3",
-    "k-msg": "0.17.0",
+    "k-msg": "0.18.2",
     "solapi": "^5.5.4",
     "typescript": "^5.7.2",
     "zod": "^4.0.14"