# meegle-cli Release

## 当前结论

- 包名：`meegle-cli`
- 可执行命令：`meegle`
- 当前已发布版本：`0.2.1`
- 当前待发布版本：`0.3.0`
- 当前依赖 SDK：`meeglesdk@0.1.8`

## 0.3.0 发布重点

- Agent 教程文档：`AGENT-OPS.zh-CN.md`
- `workitem history --json --view agent` 稳定摘要视图
- 默认终端输出操作者人名化
- 操作记录首个空页自动重试

## 发布前检查

```bash
cd /Users/linmi/conductor/repos/meego-client/meegle-cli
npm install
npm run release:check
```

`release:check` 会执行：

1. `npm test`
2. `npm run build`
3. `npm pack --dry-run`

目标是确保：

- 测试通过
- 发布包只包含 `dist/README.md/RELEASE.md`
- 不再携带 `src/` 和测试产物

## 首次发布

```bash
cd /Users/linmi/conductor/repos/meego-client/meegle-cli
npm login
npm publish
```

发布成功后，外部用户安装方式：

```bash
npm install -g meegle-cli
meegle --help
```

## 后续版本发布

```bash
cd /Users/linmi/conductor/repos/meego-client/meegle-cli
npm version patch --no-git-tag-version
npm publish
```

也可以把 `patch` 改成 `minor` 或 `major`。

如果像本次一样是较大的 Agent 能力升级，也可以直接：

```bash
cd /Users/linmi/conductor/repos/meego-client/meegle-cli
npm version 0.3.0 --no-git-tag-version
npm publish
```

## 本地联调 SDK

对外发布时，CLI 依赖的是 npm 上的 `meeglesdk@0.1.8`。  
如果你在本仓库内同时修改 SDK 和 CLI，建议显式切回本地安装：

```bash
cd /Users/linmi/conductor/repos/meego-client/meegle-cli
npm install ../project-oapi-sdk-typescript
```

联调结束后，发布前再恢复：

```bash
cd /Users/linmi/conductor/repos/meego-client/meegle-cli
npm install meeglesdk@0.1.8
```

## 风险提醒

- `pluginId/pluginSecret` 不能写进 README 示例或测试默认环境变量
- `test:smoke:real` 依赖真实凭证，不能挂到 `prepublishOnly`
- 如果后续需要私有 scope，再补 `publishConfig.access=public`