@inf-monkeys-tech/monkeys-cli 0.12.33 → 0.12.34

package/oclif.manifest.json

@@ -20020,5 +20020,5 @@
       "strict": true
     }
   },
-  "version": "0.12.33"
+  "version": "0.12.34"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inf-monkeys-tech/monkeys-cli",
-  "version": "0.12.33",
+  "version": "0.12.34",
   "packageManager": "bun@1.3.14",
   "description": "Monkeys command-line client for AI agents, automation, and interactive use",
   "type": "module",
@@ -150,5 +150,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "monkeysReleaseCommit": "a4d2cde9b10c54d9161e8daac0ba2f60479c5ac9"
+  "monkeysReleaseCommit": "ce9a645aed89bc28c3e19462f766d212b070d942"
 }

package/skills/monkeys-data/SKILL.md

@@ -12,7 +12,8 @@ description: 通过 monkeys CLI 理解并操作 Ontology、View、Asset、Field/
 1. 当前运行尚未确认路由规则时读取[Data 视角路由](references/data-perspective.md)；概念不明确时读取[Ontology 领域模型](references/ontology-model.md)。
 2. 用户或当前任务/数据源已限定 Studio/Kernel 时，所有 Data 命令显式传入对应 `--perspective`，不得改为 auto 或切换视角。未限定时省略 `--perspective`，由 CLI Studio-first；以 `perspectiveResolution`、`effectivePerspective`、`teamMode` 与 `resourceLocator` 为真相。
 3. Kernel 全局读取默认不传 `--team`；数据资源定位只传已确认的 `--resource-team`。Team `0` 是共享/系统数据分区，不是所有 Team。
-4. 当前版本命令合同未知或参数不确定时用 `monkeys schema data <domain> <action>` 获取当前参数、风险与 dry-run 合同。
+4. 标签发现优先 `data tag list --keyword <名称>` 缩小范围，再检查全部别名；所有元数据列表和商品查询都须核验 `.data.pageInfo.hasMore`。`--page-all` 仍受页数上限限制，hasMore=true 时必须续页或缩小筛选，不能宣称完整。
+5. 当前版本命令合同未知或参数不确定时用 `monkeys schema data <domain> <action>` 获取当前参数、风险与 dry-run 合同。
 
 ## 按需读取
 

package/skills/monkeys-data/references/data-read.md

@@ -18,7 +18,7 @@
 - 已知数据源的 Ontology/View/Team 时直接验证并使用该入口，不先枚举全部本体。未知 View 用 `data view tree`；字段和标签元数据用 `data field list`、`data tag list`。Studio 不使用 Kernel 专属 `ontology get/export` 探测结构。
 - 查询某个 Studio View 时，`data asset search` 的 `--filter-json` 必须包含 `{"viewId":"实际可读View ID"}`，并用 `--expression-json` 或 `--expression-file` 传筛选。省略 View 不是等价的 View 查询，可能返回空结果；不要将未定位 View 的空结果当成完整业务结论。
 - 标签叶子为 `{"op":"tagGroup","allOf":["标签ID"]}`；可替代选项用 `{"op":"or","filters":[...]}`，同时满足的条件组用 and。标签别名和多个时间段是否取并集由业务问题决定，不把互斥标签错误地全部 AND。`relation` 表达式表示用户/团队权限关系，不表示任意商品业务关联；业务关联从候选 inspect 的 relations 读取。
-- search 的 `--page-size` 最大 100；完整结果使用有界 `--page-all --page-limit`，核验 pageInfo.hasMore，不把截断分页当完整覆盖。列表分页合同见 monkeys-shared。
+- 标签名已知时优先 `data tag list --keyword <名称>`，可用已确认的组名和标签名称进一步筛选；不要为几个标签默认拉全表。所有列表（包括标签/字段元数据）与 search 都必须检查 `.data.pageInfo.hasMore`。`--page-all` 默认最多20页，成功退出不代表读完；hasMore=true 时沿用相同筛选和 page-size 携带 nextPageToken 续页，或缩小关键词后重新查询，直到目标范围完整。search 的 `--page-size` 最大100。
 - 在同一身份、Context、视角、Ontology/View 和筛选下复用已保存的元数据、候选、inspect 与图片；已有候选直接批量补字段/关系，不扫描全库。只读取任务需要的响应摘要，失败时依据结构化错误修正，不重复执行仍在运行的命令。
 
 ## 流程

package/skills/monkeys-shared/references/pagination.md

@@ -4,10 +4,12 @@
 
 - `--page-size <数量>`：单页结果数。
 - `--page-token <令牌>`：继续读取 `pageInfo.nextPageToken` 指向的下一页。
-- `--page-all`：自动连续读取多页。
+- `--page-all`：自动连续读取多页，默认最多20页，不保证已经读完全部结果。
 - `--page-limit <页数>`：限制 `--page-all` 最多读取的页数，防止无界循环。
 - `--page-delay <毫秒>`：自动续页之间的等待时间。
 
 结构化结果统一读取 `.data.items` 和 `.data.pageInfo`。当 `pageInfo.hasMore` 为 `true` 时，`pageInfo.nextPageToken` 才存在。令牌绑定命令、Subscription、Team、查询筛选和 `page-size`，任一条件变化都必须丢弃旧令牌并从第一页开始。
 
+必须在读取结果后检查 `pageInfo.hasMore`，包括标签、字段等元数据。命令成功或指定 `--page-all` 都不等于完整；hasMore=true 时使用 nextPageToken 续页，或缩小关键词筛选，禁止将截断结果作为完整别名集合或业务覆盖依据。
+
 默认只读取一页。只有用户明确要求完整结果时才使用 `--page-all`，并保留有限的 `--page-limit`；不要自行实现 Cursor、Page Number 或循环调用。