@inf-monkeys-tech/monkeys-cli 0.12.1 → 0.12.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inf-monkeys-tech/monkeys-cli",
-  "version": "0.12.1",
+  "version": "0.12.2",
   "packageManager": "bun@1.3.14",
   "description": "Monkeys command-line client for AI agents, automation, and interactive use",
   "type": "module",
@@ -134,5 +134,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "monkeysReleaseCommit": "cf5be74f93f7fa3c869418054d06034071dfd332"
+  "monkeysReleaseCommit": "14a94299817c4a456cafea8d4c0b427bb250c3bb"
 }

package/skills/monkeys-dev-agent-work/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: monkeys-dev-agent-work
-description: 通过 monkeys CLI 管理 Dev Agent Work 的查询、创建、分配、对话、暂停、恢复、重试、Spec 审批、Review 验收与观察。用户提到 Dev Agent Work、工作项、运行时分配、用户输入、审批、验收或协作者时使用。
+description: 通过 monkeys CLI 管理 Dev Agent Work 的查询、创建、分配、完整对话与 Spec Revision、Runtime 文件/日志/终端、Session 事件、Review Evidence、暂停、恢复、重试、审批与验收。用户提到 Dev Agent Work、工作项、运行时、用户输入、事件、证据、审批、验收或协作者时使用。
 ---
 
 # Monkeys Dev Agent Work
@@ -13,6 +13,7 @@ description: 通过 monkeys CLI 管理 Dev Agent Work 的查询、创建、分
 2. 用 `monkeys schema dev-agent work <action>` 获取当前命令合同；创建或变更前精确查询 Work Item ID 与最新 Revision。
 3. 写操作先 `--dry-run`；分配新 Runtime、重试、Spec 审批与 Review 验收等特权操作需要用户确认后再传 `--yes`。
 4. 观察时明确区分服务端状态与本地轮询；Ctrl+C 只停止本地观察。
+5. 查询历史 Runtime/Session 时使用工作单返回的精确 `runId`；不得把 Runtime ID、Session ID 或 Evidence ID 互相替代。
 
 ## 必须升级给用户的状态
 

package/skills/monkeys-dev-agent-work/references/dev-agent-work.md

@@ -21,6 +21,9 @@ monkeys dev-agent work list --subscription <Subscription> --page-token <PageToke
 monkeys dev-agent work get <ID> --subscription <Subscription> --output json
 monkeys dev-agent work collaborators --subscription <Subscription> --output json
 monkeys dev-agent work runtime list [<ID>] --subscription <Subscription> --output json
+monkeys dev-agent work conversation list <ID> --subscription <Subscription> --output json
+monkeys dev-agent work spec list <ID> --subscription <Subscription> --output json
+monkeys dev-agent work review evidence list <ID> --subscription <Subscription> --output json
 ```
 
 - 所有列表命令统一使用 `--page-size`、`--page-token`、`--page-all`、`--page-limit` 和 `--page-delay`；以 `pageInfo.hasMore` 和 `pageInfo.nextPageToken` 判断是否还有下一页。只有用户明确要求继续或完整获取时才继续，不循环无界获取。
@@ -29,6 +32,41 @@ monkeys dev-agent work runtime list [<ID>] --subscription <Subscription> --outpu
 - 临时引用图、Preview 和对象存储 URL 不在稳定输出中。不得要求 Raw API 回显这些 URL。
 - 普通 Kernel 用户可能只能看到自己创建的工作单，超级管理员可能看到全局列表；空结果不能解释为 Team 过滤。
 
+### 完整历史与可验证覆盖
+
+- `conversation list` 默认按时间合并工作单全部可查询 Run 的 Session 消息；指定 `--run-id` 时只读该 Run。必须检查 `complete` 和 `unavailableRuns`：旧 Run 没有 Runtime/Session 标识时 CLI 会显式报告覆盖缺口，不得把部分结果描述为完整历史。
+- `spec list` 返回全部 `specRevisions`，按 Revision 升序排列，同时返回 `currentSpecRevisionId` 与 `approvedSpecRevisionId`。审批仍必须使用当次读取到的精确 Revision ID。
+- `review evidence list` 返回稳定的 opaque `evidenceId`、类型、MIME、大小与是否可下载；不会返回对象存储 URL 或内部 `storageKey`。
+- 原始 Evidence 使用 `review evidence download <ID> <Evidence ID> --out <Path>`。CLI 会重新读取工作单、验证 Evidence 所属 Runtime，再通过认证后的 Server 路由流式下载；外部链接型 Evidence 会明确标记为不可下载。
+
+## Runtime 诊断与文件
+
+```bash
+monkeys dev-agent work runtime filesystem tree <ID> [<Path>] --subscription <Subscription> --output json
+monkeys dev-agent work runtime filesystem read <ID> <Path> --subscription <Subscription> --output json
+monkeys dev-agent work runtime filesystem download <ID> [<Path>] --out runtime.zip --subscription <Subscription> --output json
+monkeys dev-agent work runtime logs <ID> --payload full --page-all --page-limit 20 --subscription <Subscription> --output json
+monkeys dev-agent work runtime terminal <ID> --subscription <Subscription> --yes
+```
+
+- 文件与日志默认读取当前 Run；历史 Run 必须显式传 `--run-id <Run ID>`。路径由 Server 限制在 Runtime workspace 内，CLI 不把本地路径当作 Runtime 路径。
+- `filesystem read` 返回内容、编码、MIME、二进制标记与大小；目录或批量文件用 `filesystem download` 获取 ZIP。下载默认拒绝覆盖，只有显式 `--overwrite --yes` 才覆盖，并采用私有权限的原子落盘。
+- `runtime logs` 直接读取 Kernel 前端同源的持久化 Runtime Event 日志，不额外抓取 Pod stdout/stderr。默认 `--payload full` 返回原始 Event Payload；需要完整历史时显式使用 `--page-all` 和有界 `--page-limit`。
+- `runtime terminal` 是 privileged 交互式 Shell，只接受真实 TTY，并要求明确确认。认证放在 WebSocket Header，不进入 URL、命令行或日志。Runtime 不支持交互 TTY 时必须报告错误，不得降级成未审计的本地 Shell。
+
+## Session 完整事件流
+
+```bash
+monkeys dev-agent work session events list <ID> --payload full --page-all --page-limit 20 --subscription <Subscription> --output json
+monkeys dev-agent work session events get <ID> <Event ID> --subscription <Subscription> --output json
+monkeys dev-agent work session events watch <ID> --payload full --subscription <Subscription> --output ndjson
+```
+
+- 默认使用当前 Run；历史 Session 用 `--run-id`。CLI 从工作单解析 Runtime/Session，并验证每个返回 Event 的 `runtimeId/sessionId`，拒绝跨 Session 数据。
+- `events list` 单页最多 200 条；需要完整历史时显式使用 `--page-all` 和有界 `--page-limit`。输出中的 `truncated` 表示是否因页数上限仍未取完，不能忽略。
+- `--payload full` 返回原始 Event Payload；`summary` 只适合状态概览。`events get` 用于读取单条完整证据，`events watch` 通过 SSE 增量观察且不把完整事件流缓存在内存。
+- Ctrl+C 只断开本地 SSE 观察，不暂停、不取消 Runtime Session。
+
 ## 创建与编辑
 
 ```bash