meegle-cli 0.1.0 → 0.1.2

package/README-en.md

@@ -0,0 +1,193 @@
+# meegle-cli
+
+CLI for Feishu Project (Meegle).  
+Current mode is `plugin-only`: it supports `plugin_access_token / virtual_plugin_token`, but not `user_access_token`.
+
+## Install
+
+```bash
+npm install -g meegle-cli
+meegle --help
+```
+
+## What You Need
+
+- `pluginId`
+- `pluginSecret`
+- `userKey`
+- `projectKey`
+
+Optional:
+
+- `baseURL`
+  - default: `https://project.feishu.cn`
+
+## Quick Start
+
+### 1. Initialize a profile
+
+```bash
+meegle auth init \
+  --target-profile default \
+  --plugin-id <PLUGIN_ID> \
+  --plugin-secret <PLUGIN_SECRET> \
+  --default-user-key <USER_KEY>
+```
+
+Or use environment variables:
+
+```bash
+export MEEGLE_PLUGIN_ID=<PLUGIN_ID>
+export MEEGLE_PLUGIN_SECRET=<PLUGIN_SECRET>
+export MEEGLE_USER_KEY=<USER_KEY>
+
+meegle auth init --target-profile default
+```
+
+### 2. Verify credentials
+
+```bash
+meegle --profile default auth status --json
+```
+
+### 3. List spaces
+
+```bash
+meegle --profile default space list --json
+```
+
+### 4. Query yourself
+
+```bash
+meegle --profile default user query --self --json
+```
+
+## Common Tasks
+
+### Get a work item
+
+```bash
+meegle --profile default workitem get \
+  --project-key <PROJECT_KEY> \
+  --type story \
+  --id 6300034462 \
+  --json
+```
+
+### Create a work item
+
+```bash
+meegle --profile default workitem create \
+  --project-key <PROJECT_KEY> \
+  --type story \
+  --name "Login improvement" \
+  --desc "Improve error messages" \
+  --owner <USER_KEY> \
+  --priority P2 \
+  --json
+```
+
+### Add a comment
+
+```bash
+meegle --profile default comment add \
+  --project-key <PROJECT_KEY> \
+  --type story \
+  --id 6300034462 \
+  --content "Received, starting now" \
+  --json
+```
+
+## View Usage
+
+Do not infer view type from the page URL.  
+Always call `view list` first, then choose the correct API.
+
+### Resolve a view
+
+```bash
+meegle --profile default view list \
+  --project-key 69zyer \
+  --body-file ./examples/view-list.json \
+  --json
+```
+
+Check:
+
+- `view_id`
+- `name`
+- `view_type`
+  - `1` = condition view
+  - `2` = fixed view
+
+### Fixed view items
+
+```bash
+meegle --profile default view fix-items \
+  --project-key 69zyer \
+  --view-id sypbi-z60 \
+  --query-file ./examples/view-fix-items.json \
+  --json
+```
+
+## Related Field Filtering
+
+For related fields such as `planning_version`, do not use:
+
+- `workitem search filter` with `field_value_pairs`
+
+Use this flow instead:
+
+1. find the related work item ID
+2. run `workitem search by-params`
+3. pass the related work item **ID list**, not the display name
+
+### Example: find stories by planning version
+
+Step 1: search the `version` work item:
+
+```bash
+meegle --profile default workitem search filter \
+  --project-key 69zyer \
+  --body-file ./examples/version-search-filter.json \
+  --json
+```
+
+Step 2: use the returned version `id` in `planning_version`:
+
+```bash
+meegle --profile default workitem search by-params \
+  --project-key 69zyer \
+  --type story \
+  --body-file ./examples/story-by-planning-version.json \
+  --json
+```
+
+Replace `1234567890` in the example file with the real version work item ID.
+
+## Agent Notes
+
+If you use this CLI from an AI agent or automation:
+
+1. run `meegle --help` or subcommand `--help` first
+2. do not guess request shapes from web URLs
+3. use `workitem search by-params` for custom fields and related fields
+4. `field_value_pairs` is for create/update, not for search
+
+## Examples
+
+- `examples/view-list.json`
+- `examples/view-fix-items.json`
+- `examples/version-search-filter.json`
+- `examples/story-by-planning-version.json`
+
+## Limits
+
+This CLI currently rejects user-token-only commands such as:
+
+- `user search`
+- `user group create`
+- `user group update-members`
+- `user group query-members`
+
+That is expected behavior in `plugin-only` mode.

package/README.md

@@ -1,215 +1,546 @@
-# meegle-cli (plugin-only)
+# meegle-cli
 
-基于 `project-oapi-sdk-typescript` 的命令行工具。  
-当前模式：仅支持 `plugin_access_token / virtual_plugin_token`，不支持 `user_access_token`。
+面向飞书项目（Meegle）的命令行工具。  
+当前版本运行在 `plugin-only` 模式：只支持 `plugin_access_token / virtual_plugin_token`，不支持 `user_access_token`。
 
-## 安装
+## 适用对象
+
+- 想在终端里查询空间、工作项、视图、评论、子任务
+- 想把 Meegle 调用接到脚本、Agent、CI 里
+- 已经有插件凭证：`pluginId / pluginSecret`
 
-对外用户安装：
+不适用场景：
+
+- 需要 `user_access_token` 的接口
+- 需要在 CLI 内做浏览器登录换 user token
+
+## 安装
 
 ```bash
 npm install -g meegle-cli
 meegle --help
 ```
 
-仓库内开发安装：
+如果安装后提示 `meegle: command not found`，先确认 npm 全局 bin 在 PATH 里：
 
 ```bash
-cd /Users/linmi/conductor/repos/meego-client/meegle-cli
-npm install
+npm bin -g
 ```
 
-## 构建
+## 你需要准备什么
 
-```bash
-npm run build
-```
+最少准备这几项：
+
+- `pluginId`
+- `pluginSecret`
+- `userKey`
+- `projectKey`
+
+可选：
 
-## 发布
+- `baseURL`
+  - 默认就是 `https://project.feishu.cn`
 
-发布说明见 [RELEASE.md](/Users/linmi/conductor/repos/meego-client/meegle-cli/RELEASE.md)。
+## 3 分钟上手
 
-## 初始化
+### 1. 初始化一个 profile
 
 ```bash
-node dist/index.js auth init \
+meegle auth init \
   --target-profile default \
-  --plugin-id MII_xxx \
-  --plugin-secret xxx \
-  --base-url https://project.feishu.cn \
-  --token-type 0 \
-  --default-user-key 123456
+  --plugin-id <PLUGIN_ID> \
+  --plugin-secret <PLUGIN_SECRET> \
+  --default-user-key <USER_KEY>
 ```
 
-也可以先放环境变量，再直接初始化：
+也可以先放环境变量，再执行初始化：
 
 ```bash
-export MEEGLE_PLUGIN_ID=MII_xxx
-export MEEGLE_PLUGIN_SECRET=xxx
-export MEEGLE_USER_KEY=123456
+export MEEGLE_PLUGIN_ID=<PLUGIN_ID>
+export MEEGLE_PLUGIN_SECRET=<PLUGIN_SECRET>
+export MEEGLE_USER_KEY=<USER_KEY>
 
-node dist/index.js auth init --target-profile default
+meegle auth init --target-profile default
 ```
 
-## 入参约定
+### 2. 校验凭证
 
-- 常用查询优先走直接参数，不再强制写 JSON 文件
-- 常用写操作也优先走直接参数，例如 `--name`、`--desc`、`--content`
-- 复杂请求体仍可使用 `--body <json>` 或 `--body-file <path>`
-- 复杂查询参数仍可使用 `--query-file <path>`
-- 大多数命令要求 `userKey`：`--user-key` 或 `auth init --default-user-key`
-- 如果 profile 里没存 `defaultUserKey`，运行时也会读取 `MEEGLE_USER_KEY`
-- 自定义字段统一使用 `--field field_key=value`；对象/数组值直接传 JSON
-- 排期参数统一支持 `--start/--end`，可传毫秒时间戳或可解析日期，如 `2025-01-01`
+```bash
+meegle --profile default auth status --json
+```
 
-## 命令总览
+成功时会返回：
 
-- `auth`: `init`, `status`
-- `space`: `list`, `get`, `types`, `team-members`
-- `workitem`: `get`, `meta`, `create`, `update`, `remove`, `freeze`, `unfreeze`, `abort`, `restore`, `op-records`, `update-compound`
-- `workitem search`: `filter`, `filter-across`, `by-params`, `by-relation`, `compositive`, `universal`
-- `workflow`: `query`, `state-change`, `node-operate`, `node-update`, `required-info`, `wbs`
-- `comment`: `list`, `add`, `update`, `remove`
-- `subtask`: `list`, `search`, `create`, `update`, `remove`, `operate`
-- `attachment`: `upload-file`, `upload`, `download`, `delete`
-- `workhour`: `list`, `create`, `update`, `delete`
-- `view`: `list`, `fix-items`, `panoramic-items`, `create-fix`, `update-fix`, `delete`, `create-condition`, `update-condition`
-- `measure`: `charts`, `chart-data`
-- `tenant`: `info`, `entitlement`, `spaces`
-- `user`: `query`, `search`（会被拒绝）
-- `user group`: `create`, `update-members`, `query-members`（会被拒绝）
+- `profile`
+- `baseURL`
+- `tokenType`
+- `tokenPreview`
+- `ok: true`
+
+### 3. 列出你能看到的空间
 
-## 真实环境 Smoke（可选）
+```bash
+meegle --profile default space list --json
+```
 
-执行：
+### 4. 查询自己
 
 ```bash
-npm run test:smoke:real
+meegle --profile default user query --self --json
 ```
 
-必填环境变量：
+## 核心概念
+
+### profile
 
-- `MEEGLE_SMOKE_PLUGIN_ID`
-- `MEEGLE_SMOKE_PLUGIN_SECRET`
-- `MEEGLE_SMOKE_USER_KEY`
-- `MEEGLE_SMOKE_PROJECT_KEY`
+一套 CLI 配置，通常对应一套环境或一组凭证。
 
-可选环境变量：
+例如：
 
-- `MEEGLE_SMOKE_BASE_URL`（默认 `https://project.feishu.cn`）
-- `MEEGLE_SMOKE_WORK_ITEM_TYPE_KEY`（不填时自动取 `space types` 第一项）
-- `MEEGLE_SMOKE_WORK_ITEM_ID`（填了会额外做 `workitem get`）
+- `default`
+- `test`
+- `prod`
 
-测试链路：
+切换方式：
 
-- `auth init -> auth status -> space list -> space get -> user query --self -> space types -> workitem meta`
-- 若提供 `MEEGLE_SMOKE_WORK_ITEM_ID`，再执行 `workitem get`
-- 最后验证 user-only 接口在 plugin-only 下被拒绝
+```bash
+meegle --profile prod space list
+```
 
-`MEEGLE_SMOKE_USER_KEY` 获取建议：
+### userKey
 
-- 文档建议可在飞书项目空间双击头像获取 `user_key`
-- 如果你在插件前端里调试，JS SDK 文档里有 `window.JSSDK.utils.getAuthCode()`；虽然该方法用于 user token 流程，但同一套文档章节也包含用户身份相关取值指引
+`plugin-only` 模式下，大多数命令都需要 `userKey`。
 
-## plugin-only 拒绝列表（denylist）
+来源优先级：
 
-- `POST /open_api/user/search`
-- `POST /open_api/:project_key/user_group`
-- `PATCH /open_api/:project_key/user_group/members`
-- `POST /open_api/:project_key/user_groups/members/page`
+1. 命令行 `--user-key`
+2. profile 里的 `defaultUserKey`
+3. 环境变量 `MEEGLE_USER_KEY`
 
-## 示例
+### projectKey
 
-```bash
-# 1) 校验凭证
-node dist/index.js --profile default auth status --json
+空间 ID，通常就是接口里的 `project_key`。  
+很多命令也支持空间域名 `simple_name`，例如 `69zyer`。
 
-# 2) 列出空间
-node dist/index.js --profile default space list --json
+## 常见任务
 
-# 3) 获取空间详情
-node dist/index.js --profile default space get \
-  --project-key your_project \
+### 查空间详情
+
+```bash
+meegle --profile default space get \
+  --project-key <PROJECT_KEY> \
   --json
+```
 
-# 4) 查询当前 userKey 对应的用户
-node dist/index.js --profile default user query \
-  --self \
+### 查工作项
+
+查单个工作项：
+
+```bash
+meegle --profile default workitem get \
+  --project-key <PROJECT_KEY> \
+  --type story \
+  --id 6300034462 \
   --json
+```
 
-# 5) 查询工作项，常见场景直接传 ID
-node dist/index.js --profile default workitem get \
-  --project-key your_project \
+只取部分字段：
+
+```bash
+meegle --profile default workitem get \
+  --project-key <PROJECT_KEY> \
   --type story \
   --id 6300034462 \
+  --fields name,priority,owner,description \
   --json
+```
 
-# 6) 创建工作项，常见字段直接写
-node dist/index.js --profile default workitem create \
-  --project-key your_project \
+### 创建工作项
+
+```bash
+meegle --profile default workitem create \
+  --project-key <PROJECT_KEY> \
   --type story \
   --name "登录优化" \
   --desc "补齐错误提示" \
-  --owner your_user_key \
+  --owner <USER_KEY> \
   --priority P2 \
   --json
+```
 
-# 7) 更新工作项，改单个字段不需要写 update_fields
-node dist/index.js --profile default workitem update \
-  --project-key your_project \
+### 更新工作项
+
+```bash
+meegle --profile default workitem update \
+  --project-key <PROJECT_KEY> \
   --type story \
   --id 6300034462 \
   --name "登录优化（已排期）" \
   --json
+```
 
-# 8) 添加评论，支持直接写文本或从文件读
-node dist/index.js --profile default comment add \
-  --project-key your_project \
+### 添加评论
+
+```bash
+meegle --profile default comment add \
+  --project-key <PROJECT_KEY> \
   --type story \
   --id 6300034462 \
   --content "收到，开始处理" \
   --json
+```
+
+如果评论内容很长，改用文件：
+
+```bash
+meegle --profile default comment add \
+  --project-key <PROJECT_KEY> \
+  --type story \
+  --id 6300034462 \
+  --content-file ./comment.txt \
+  --json
+```
+
+### 创建子任务
 
-# 9) 创建子任务
-node dist/index.js --profile default subtask create \
-  --project-key your_project \
+```bash
+meegle --profile default subtask create \
+  --project-key <PROJECT_KEY> \
   --type story \
   --id 6300034462 \
   --node-id doing \
   --name "需求分析" \
   --note "补齐边界条件" \
-  --assignee your_user_key \
+  --assignee <USER_KEY> \
   --points 3 \
   --start 2025-01-01 \
   --end 2025-01-02 \
   --json
+```
+
+### 状态流转
 
-# 10) 状态流转
-node dist/index.js --profile default workflow state-change \
-  --project-key your_project \
+```bash
+meegle --profile default workflow state-change \
+  --project-key <PROJECT_KEY> \
   --type story \
   --id 6300034462 \
   --transition-id 12345 \
   --field description="流转补充说明" \
   --json
+```
+
+### 节点完成 / 回滚
 
-# 11) 节点完成/回滚
-node dist/index.js --profile default workflow node-operate \
-  --project-key your_project \
+```bash
+meegle --profile default workflow node-operate \
+  --project-key <PROJECT_KEY> \
   --type story \
   --id 6300034462 \
   --node-id dev \
   --action rollback \
   --rollback-reason "需要返工" \
   --json
+```
+
+## 视图使用
+
+### 先查视图配置，再决定调哪个接口
+
+固定视图和全景视图不是一个接口。  
+先查 `view_type`，再调后续命令，别从 URL 结构直接猜。
+
+查指定视图：
+
+```bash
+cat > /tmp/view-list.json <<'JSON'
+{
+  "work_item_type_key": "story",
+  "view_ids": ["sypbi-z60"],
+  "is_query_quick_filter": true,
+  "page_size": 10,
+  "page_num": 1
+}
+JSON
+
+meegle --profile default view list \
+  --project-key 69zyer \
+  --body-file /tmp/view-list.json \
+  --json
+```
+
+返回中重点看：
+
+- `view_id`
+- `name`
+- `view_type`
+  - `1` = 条件视图
+  - `2` = 固定视图
+
+### 固定视图
+
+固定视图用：
+
+```bash
+cat > /tmp/fix.json <<'JSON'
+{
+  "page_size": 50,
+  "page_num": 1
+}
+JSON
+
+meegle --profile default view fix-items \
+  --project-key 69zyer \
+  --view-id sypbi-z60 \
+  --query-file /tmp/fix.json \
+  --json
+```
+
+### 全景视图
+
+全景视图用：
+
+```bash
+cat > /tmp/panoramic.json <<'JSON'
+{
+  "page_size": 50,
+  "page_num": 1
+}
+JSON
+
+meegle --profile default view panoramic-items \
+  --project-key 69zyer \
+  --view-id <VIEW_ID> \
+  --body-file /tmp/panoramic.json \
+  --json
+```
+
+### PMO 视角的正确用法
+
+如果你要做 PMO 基线分析，推荐链路是：
+
+1. `view list` 确认视图类型
+2. `view fix-items` 或 `view panoramic-items` 拉视图内工作项 ID
+3. `workitem get --ids ... --fields ...` 拉详情字段
+4. 再在脚本里统计：
+   - 状态分布
+   - 负责人分布
+   - 优先级分布
+   - 到期时间完整度
+   - 超期 / 逾期 / 老化
+
+不要直接拿整个空间总池代替“这个视图”的口径。
+
+## 关联字段筛选
+
+### 结论先说
+
+像 `planning_version` 这类字段，不要用：
+
+- `workitem search filter` + `field_value_pairs`
+
+正确做法是：
+
+1. 先找到被关联工作项的实例 ID
+2. 再用 `workitem search by-params`
+3. 对关联字段传 **ID 列表**，不要传名称
+
+### 为什么
+
+`planning_version` 的字段类型是：
+
+- `work_item_related_multi_select`
+
+这类字段的筛选值格式是：
+
+- `list<int64>`，也就是关联工作项 ID 列表
+
+不是：
+
+- 版本名称字符串
+- `field_value_pairs`
+
+### 典型例子：按“规划版本”筛需求
+
+目标：找出 `planning_version` 关联到某个版本实例的全部 story。
+
+#### 第一步：先找版本实例
+
+先在 `version` 类型里按名称查候选：
+
+```bash
+meegle --profile default workitem search filter \
+  --project-key 69zyer \
+  --body-file ./examples/version-search-filter.json \
+  --json
+```
+
+示例文件：
+
+- [examples/version-search-filter.json](/Users/linmi/conductor/repos/meego-client/meegle-cli/examples/version-search-filter.json)
+
+你要从返回结果里拿到真正的版本实例 `id`。
+
+#### 第二步：再按 `planning_version` 查 story
 
-# 12) 复杂场景再回退到原始请求体
-node dist/index.js --profile default workitem get \
-  --project-key your_project \
+```bash
+meegle --profile default workitem search by-params \
+  --project-key 69zyer \
   --type story \
-  --body '{"work_item_ids":[6300034462],"fields":["name","priority"]}' \
+  --body-file ./examples/story-by-planning-version.json \
   --json
+```
+
+示例文件：
+
+- [examples/story-by-planning-version.json](/Users/linmi/conductor/repos/meego-client/meegle-cli/examples/story-by-planning-version.json)
+
+重点：
+
+- 把 `1234567890` 替换成真实版本实例 ID
+- 不要直接写版本名称
+
+### 常见误用
+
+错误方向：
+
+1. 用 `workitem search filter` 查自定义关联字段
+2. 在筛选请求体里传 `field_value_pairs`
+3. 直接把版本名称塞给 `planning_version`
+
+这些场景下，接口常见表现是：
+
+- 条件被忽略
+- 返回全部需求
+- 让人误以为 CLI 不支持
+
+根因通常不是 CLI 丢参，而是请求体结构不符合接口契约。
 
-# 13) user-only 接口会被直接拒绝
-node dist/index.js user search --query test
+## 参数约定
+
+- 常用查询优先走直接参数，不强制写 JSON 文件
+- 常用写操作优先走直接参数，例如 `--name`、`--desc`、`--content`
+- 复杂请求体可使用 `--body <json>` 或 `--body-file <path>`
+- 复杂查询参数可使用 `--query-file <path>`
+- 自定义字段统一使用 `--field field_key=value`
+- 对象 / 数组值直接传 JSON
+- 排期参数统一支持 `--start/--end`
+  - 可传毫秒时间戳
+  - 也可传可解析日期，例如 `2025-01-01`
+
+## 当前限制
+
+### plugin-only
+
+当前 CLI 不支持 `user_access_token`。  
+所以这类命令会被直接拒绝：
+
+- `user search`
+- `user group create`
+- `user group update-members`
+- `user group query-members`
+
+这是设计行为，不是故障。
+
+## 排错
+
+### 1. `meegle: command not found`
+
+先看 npm 全局 bin：
+
+```bash
+npm bin -g
 ```
+
+### 2. 缺少 `userKey`
+
+报错通常类似：
+
+- `缺少 userKey`
+- `命令 ... 需要 userKey`
+
+处理方式：
+
+```bash
+meegle --profile default space list --user-key <USER_KEY>
+```
+
+或者重新初始化：
+
+```bash
+meegle auth init \
+  --target-profile default \
+  --plugin-id <PLUGIN_ID> \
+  --plugin-secret <PLUGIN_SECRET> \
+  --default-user-key <USER_KEY>
+```
+
+### 3. `user search` 被拒绝
+
+这是正常行为。  
+当前版本是 `plugin-only`，该命令依赖 `user_access_token`。
+
+### 4. 固定视图 / 全景视图调用报错
+
+先回到 `view list` 看 `view_type`。  
+不要只凭页面 URL 去猜视图类型。
+
+### 5. 明明传了条件，结果返回全部数据
+
+优先检查三件事：
+
+1. 用的命令是不是对
+   - 内置字段简单筛选：`workitem search filter`
+   - 自定义字段 / 关联字段：`workitem search by-params`
+2. 值格式是不是对
+   - 关联工作项字段通常要传实例 ID，不是名称
+3. 请求体键是不是对
+   - `field_value_pairs` 用于创建 / 更新，不是搜索条件
+
+## 命令总览
+
+- `auth`: `init`, `status`
+- `space`: `list`, `get`, `types`, `team-members`
+- `workitem`: `get`, `meta`, `create`, `update`, `remove`, `freeze`, `unfreeze`, `abort`, `restore`, `op-records`, `update-compound`
+- `workitem search`: `filter`, `filter-across`, `by-params`, `by-relation`, `compositive`, `universal`
+- `workflow`: `query`, `state-change`, `node-operate`, `node-update`, `required-info`, `wbs`
+- `comment`: `list`, `add`, `update`, `remove`
+- `subtask`: `list`, `search`, `create`, `update`, `remove`, `operate`
+- `attachment`: `upload-file`, `upload`, `download`, `delete`
+- `workhour`: `list`, `create`, `update`, `delete`
+- `view`: `list`, `fix-items`, `panoramic-items`, `create-fix`, `update-fix`, `delete`, `create-condition`, `update-condition`
+- `measure`: `charts`, `chart-data`
+- `tenant`: `info`, `entitlement`, `spaces`
+- `user`: `query`, `search`（会被拒绝）
+- `user group`: `create`, `update-members`, `query-members`（会被拒绝）
+
+## 开发与发布
+
+仓库内开发：
+
+```bash
+cd meegle-cli
+npm install
+npm test
+```
+
+发布说明见 [RELEASE.md](./RELEASE.md)。
+
+## Examples
+
+可直接复制修改的模板在：
+
+- [examples/view-list.json](/Users/linmi/conductor/repos/meego-client/meegle-cli/examples/view-list.json)
+- [examples/view-fix-items.json](/Users/linmi/conductor/repos/meego-client/meegle-cli/examples/view-fix-items.json)
+- [examples/version-search-filter.json](/Users/linmi/conductor/repos/meego-client/meegle-cli/examples/version-search-filter.json)
+- [examples/story-by-planning-version.json](/Users/linmi/conductor/repos/meego-client/meegle-cli/examples/story-by-planning-version.json)
+
+## AI / Agent 提示
+
+如果你在 Agent、Openclaw、脚本平台里调用 `meegle-cli`，建议遵守这几条：
+
+1. 先跑 `meegle --help` 或子命令 `--help`，不要凭印象猜参数名
+2. 不要从页面 URL 直接猜视图类型；先调用 `view list`
+3. 自定义字段和关联字段优先走 `workitem search by-params`
+4. `planning_version` 这类关联字段，先查出被关联工作项的 `id`，再筛主工作项
+5. `field_value_pairs` 是写操作格式，不是搜索格式

package/examples/story-by-planning-version.json

@@ -0,0 +1,23 @@
+{
+  "search_group": {
+    "conjunction": "AND",
+    "search_params": [
+      {
+        "param_key": "planning_version",
+        "operator": "CONTAINS",
+        "value": [
+          1234567890
+        ]
+      }
+    ]
+  },
+  "page_size": 200,
+  "page_num": 1,
+  "fields": [
+    "name",
+    "owner",
+    "priority",
+    "planning_version",
+    "work_item_status"
+  ]
+}

package/examples/version-search-filter.json

@@ -0,0 +1,8 @@
+{
+  "work_item_type_keys": [
+    "version"
+  ],
+  "work_item_name": "260312",
+  "page_size": 50,
+  "page_num": 1
+}

package/examples/view-fix-items.json

@@ -0,0 +1,4 @@
+{
+  "page_size": 50,
+  "page_num": 1
+}

package/examples/view-list.json

@@ -0,0 +1,9 @@
+{
+  "work_item_type_key": "story",
+  "view_ids": [
+    "sypbi-z60"
+  ],
+  "is_query_quick_filter": true,
+  "page_size": 10,
+  "page_num": 1
+}

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "meegle-cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Plugin-only CLI for Feishu Project (Meegle) based on meeglesdk",
   "type": "module",
   "bin": {
-    "meegle": "./dist/index.js"
+    "meegle": "dist/index.js"
   },
   "files": [
     "dist",
     "README.md",
-    "RELEASE.md"
+    "README-en.md",
+    "RELEASE.md",
+    "examples"
   ],
   "scripts": {
     "clean": "rm -rf dist",