@lark-project/meegle 1.0.6 → 1.0.8

package/CHANGELOG.md

@@ -8,6 +8,18 @@ versioned section on each npm release.
 
 ## [Unreleased]
 
+## [v1.0.8] - 2026-06-09
+
+### Added
+
+- `--envelope` now surfaces the backend `logid` under `meta.logid` when present. Previously the MCP server emitted the trace id as a `logid:` content entry, which the CLI stripped into `Response.LogID` but only forwarded to `slog.Debug` — and since no default slog handler is configured, the id was silently dropped. Oncall now has a way to ask end users for an argos-lookupable trace id: re-run with `--envelope` and read `meta.logid`. The id is still suppressed without `--envelope` so default output stays clean for piping. Only covers the single-call path for now; batch (`+batch-get`) per-row logid remains a follow-up
+
+## [v1.0.7] - 2026-06-09
+
+### Fixed
+
+- `meegle` now keeps local commands (`auth`, `config`, `inspect`, `completion`, `url`) bootable when server-side tool discovery fails and no command cache exists. Dynamic business commands now return a clear `TOOL_DISCOVERY_FAILED` server error instead of causing CLI bootstrap to fail before local command handlers can run.
+
 ## [v1.0.6] - 2026-05-28
 
 ### Changed

package/README.md

@@ -658,6 +658,7 @@ meegle workflow get-node --work-item-id 12345 --need-sub-task
 | `--set` | | Set nested parameters (repeatable) |
 | `--params` | `-P` | Full JSON parameter body; prefix with `@` to read from a file (e.g. `--params @body.json`) |
 | `--dry-run` | | Render request without executing |
+| `--envelope` | | Wrap success output as `{data, meta, error}` — `meta.logid` carries the backend trace id when present |
 | `--verbose` | `-v` | Verbose output |
 | `--profile` | | Use a specific configuration profile |
 | `--refresh` | | Refresh cached commands from server (bypass the local 24 h cache) |
@@ -715,6 +716,21 @@ and `--format ndjson`, a single-key wrapper like `{"list":[...]}`
 (no sibling metadata) is still peeled into rows — the peel is
 loss-less.
 
+### Tracing with `--envelope`
+
+When something looks wrong (silent success, unexpected payload) and you
+want to ask oncall to trace the exact call, add `--envelope`:
+
+```bash
+meegle workflow update-node --work-item-id 12345 \
+  --set node_schedule.points=10 --envelope
+```
+
+The success output is wrapped as `{data, meta, error}`, and `meta.logid`
+carries the backend trace id (when the server returns one). Hand that id
+to oncall to look up the request in argos. Without `--envelope` the id is
+suppressed so the default output stays clean for piping.
+
 ### Dry Run
 
 For commands with side effects, preview the rendered request with `--dry-run` before executing:
@@ -893,6 +909,7 @@ meegle auth login
 ```
 
 The command list is cached automatically and refreshed silently in the background when expired.
+When server-side command discovery fails with no usable cache, local commands such as `auth`, `config`, `inspect`, `completion`, and `url` still start normally; dynamic business commands report a `TOOL_DISCOVERY_FAILED` server error until connectivity recovers.
 
 ## Security & Risk Warnings
 

package/README.zh-CN.md

@@ -644,6 +644,7 @@ meegle workflow get-node --work-item-id 12345 --need-sub-task
 | `--set` | | 设置嵌套参数（可重复） |
 | `--params` | `-P` | 完整 JSON 参数体；以 `@` 开头改为从文件读取（如 `--params @body.json`） |
 | `--dry-run` | | 只渲染请求，不实际执行 |
+| `--envelope` | | 将成功输出包装为 `{data, meta, error}` —— 后端返回 logid 时挂在 `meta.logid` |
 | `--verbose` | `-v` | 详细输出 |
 | `--profile` | | 指定配置 profile |
 | `--refresh` | | 从服务端刷新本地命令缓存（旁路 24 小时缓存） |
@@ -692,6 +693,20 @@ meegle mywork todo --action done --page-num 1 \
 
 默认渲染下，响应的完整结构在所有 `--format` 中都会保留：列表接口返回的 `{"list":[...], "total":N, "pagination":{...}}` 原样呈现 —— 即使你没有在 `--select` 中点名，`total` / `pagination` 这些元数据字段依然可见。要钻到具体记录就显式用 `--select`（配合上面的广播语法）。`--format table` 和 `--format ndjson` 下，形如 `{"list":[...]}` 的单键包装（没有兄弟元数据）仍然会被无损展开成行展示。
 
+### 通过 `--envelope` 拿到 logid
+
+遇到"返回 success 但实际没生效"、"输出不符合预期"等情况，需要让 oncall
+按 logid 反查具体调用时，加上 `--envelope`：
+
+```bash
+meegle workflow update-node --work-item-id 12345 \
+  --set node_schedule.points=10 --envelope
+```
+
+成功输出会被包装为 `{data, meta, error}`，后端返回 logid 时挂在
+`meta.logid` 里——把这个 id 交给 oncall 就能在 argos 定位到这次请求。
+不加 `--envelope` 时 logid 会被抑制，保持默认输出干净便于管道处理。
+
 ### Dry Run
 
 有副作用的命令先用 `--dry-run` 预览请求再执行：
@@ -870,6 +885,7 @@ meegle auth login
 ```
 
 命令列表会自动缓存，过期后在后台静默刷新，不影响使用。
+当服务端命令发现失败且没有可用缓存时，`auth`、`config`、`inspect`、`completion`、`url` 等本地命令仍会正常启动；动态业务命令会返回 `TOOL_DISCOVERY_FAILED` 服务端错误，直到网络恢复。
 
 ## 安全与风险提示
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-project/meegle",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "Agent-First CLI for Meegle (Lark Project)",
   "license": "MIT",
   "homepage": "https://github.com/larksuite/meegle-cli#readme",