@inf-monkeys-tech/monkeys-cli 0.11.0 → 0.11.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (202) hide show
  1. package/README.md +38 -21
  2. package/README.zh.md +27 -19
  3. package/bin/install-wizard.js +12 -2
  4. package/bin/run.js +4 -4
  5. package/dist/command/metadata.d.ts +11 -0
  6. package/dist/command/metadata.d.ts.map +1 -0
  7. package/dist/command/metadata.js +150 -0
  8. package/dist/command/metadata.js.map +1 -0
  9. package/dist/command-support/asset-feature-backfill.d.ts +20 -4
  10. package/dist/command-support/asset-feature-backfill.d.ts.map +1 -1
  11. package/dist/commands/agent/work/watch.d.ts +3 -2
  12. package/dist/commands/agent/work/watch.d.ts.map +1 -1
  13. package/dist/commands/agent/work/watch.js +10 -5
  14. package/dist/commands/agent/work/watch.js.map +1 -1
  15. package/dist/commands/context/show.d.ts +11 -0
  16. package/dist/commands/context/show.d.ts.map +1 -0
  17. package/dist/commands/context/show.js +32 -0
  18. package/dist/commands/context/show.js.map +1 -0
  19. package/dist/commands/data/asset/list.d.ts.map +1 -1
  20. package/dist/commands/data/asset/list.js +9 -5
  21. package/dist/commands/data/asset/list.js.map +1 -1
  22. package/dist/commands/data/asset/search.d.ts.map +1 -1
  23. package/dist/commands/data/asset/search.js +9 -5
  24. package/dist/commands/data/asset/search.js.map +1 -1
  25. package/dist/commands/data/view/rows.d.ts.map +1 -1
  26. package/dist/commands/data/view/rows.js +9 -5
  27. package/dist/commands/data/view/rows.js.map +1 -1
  28. package/dist/commands/execution/watch.d.ts +3 -2
  29. package/dist/commands/execution/watch.d.ts.map +1 -1
  30. package/dist/commands/execution/watch.js +10 -5
  31. package/dist/commands/execution/watch.js.map +1 -1
  32. package/dist/commands/identity/get.d.ts +13 -0
  33. package/dist/commands/identity/get.d.ts.map +1 -0
  34. package/dist/commands/identity/get.js +18 -0
  35. package/dist/commands/identity/get.js.map +1 -0
  36. package/dist/commands/identity/list.d.ts +17 -0
  37. package/dist/commands/identity/list.d.ts.map +1 -0
  38. package/dist/commands/identity/list.js +33 -0
  39. package/dist/commands/identity/list.js.map +1 -0
  40. package/dist/commands/schema.d.ts +17 -0
  41. package/dist/commands/schema.d.ts.map +1 -0
  42. package/dist/commands/schema.js +56 -0
  43. package/dist/commands/schema.js.map +1 -0
  44. package/dist/commands/skills/list.d.ts +9 -0
  45. package/dist/commands/skills/list.d.ts.map +1 -0
  46. package/dist/commands/skills/list.js +11 -0
  47. package/dist/commands/skills/list.js.map +1 -0
  48. package/dist/commands/skills/read.d.ts +14 -0
  49. package/dist/commands/skills/read.d.ts.map +1 -0
  50. package/dist/commands/skills/read.js +20 -0
  51. package/dist/commands/skills/read.js.map +1 -0
  52. package/dist/commands/skills/status.d.ts +9 -0
  53. package/dist/commands/skills/status.d.ts.map +1 -0
  54. package/dist/commands/skills/status.js +12 -0
  55. package/dist/commands/skills/status.js.map +1 -0
  56. package/dist/commands/skills/sync.d.ts +10 -0
  57. package/dist/commands/skills/sync.d.ts.map +1 -0
  58. package/dist/commands/skills/sync.js +36 -0
  59. package/dist/commands/skills/sync.js.map +1 -0
  60. package/dist/commands/team/get.d.ts +13 -0
  61. package/dist/commands/team/get.d.ts.map +1 -0
  62. package/dist/commands/team/get.js +18 -0
  63. package/dist/commands/team/get.js.map +1 -0
  64. package/dist/commands/team/list.d.ts +16 -0
  65. package/dist/commands/team/list.d.ts.map +1 -0
  66. package/dist/commands/team/list.js +31 -0
  67. package/dist/commands/team/list.js.map +1 -0
  68. package/dist/commands/update.d.ts +2 -4
  69. package/dist/commands/update.d.ts.map +1 -1
  70. package/dist/commands/update.js +37 -76
  71. package/dist/commands/update.js.map +1 -1
  72. package/dist/commands/version/check.d.ts.map +1 -1
  73. package/dist/commands/version/check.js +8 -4
  74. package/dist/commands/version/check.js.map +1 -1
  75. package/dist/commands/version/show.d.ts +2 -2
  76. package/dist/commands/version/show.d.ts.map +1 -1
  77. package/dist/commands/version/show.js +7 -12
  78. package/dist/commands/version/show.js.map +1 -1
  79. package/dist/config/local-command.d.ts +9 -1
  80. package/dist/config/local-command.d.ts.map +1 -1
  81. package/dist/config/local-command.js +44 -5
  82. package/dist/config/local-command.js.map +1 -1
  83. package/dist/contracts/version.d.ts +1 -1
  84. package/dist/contracts/version.d.ts.map +1 -1
  85. package/dist/contracts/version.js +9 -1
  86. package/dist/contracts/version.js.map +1 -1
  87. package/dist/data/asset-jsonl-import.d.ts +50 -10
  88. package/dist/data/asset-jsonl-import.d.ts.map +1 -1
  89. package/dist/data/asset-jsonl-import.js +13 -2
  90. package/dist/data/asset-jsonl-import.js.map +1 -1
  91. package/dist/data/client.d.ts +21 -3
  92. package/dist/data/client.d.ts.map +1 -1
  93. package/dist/data/client.js +132 -21
  94. package/dist/data/client.js.map +1 -1
  95. package/dist/data/command.d.ts +36 -6
  96. package/dist/data/command.d.ts.map +1 -1
  97. package/dist/data/command.js +81 -15
  98. package/dist/data/command.js.map +1 -1
  99. package/dist/data/contracts.d.ts +1 -0
  100. package/dist/data/contracts.d.ts.map +1 -1
  101. package/dist/data/contracts.js +6 -0
  102. package/dist/data/contracts.js.map +1 -1
  103. package/dist/data/cursor.d.ts +5 -1
  104. package/dist/data/cursor.d.ts.map +1 -1
  105. package/dist/data/cursor.js +12 -6
  106. package/dist/data/cursor.js.map +1 -1
  107. package/dist/data/kernel-bindings.d.ts.map +1 -1
  108. package/dist/data/kernel-bindings.js +1 -0
  109. package/dist/data/kernel-bindings.js.map +1 -1
  110. package/dist/data/ontology-command.d.ts +80 -16
  111. package/dist/data/ontology-command.d.ts.map +1 -1
  112. package/dist/data/perspective.d.ts +10 -5
  113. package/dist/data/perspective.d.ts.map +1 -1
  114. package/dist/data/perspective.js +50 -57
  115. package/dist/data/perspective.js.map +1 -1
  116. package/dist/data/resource-locator.d.ts.map +1 -1
  117. package/dist/data/resource-locator.js +9 -7
  118. package/dist/data/resource-locator.js.map +1 -1
  119. package/dist/data/view-rows.d.ts +1 -1
  120. package/dist/data/view-rows.d.ts.map +1 -1
  121. package/dist/data/view-rows.js +26 -3
  122. package/dist/data/view-rows.js.map +1 -1
  123. package/dist/data-transfer/asset-export.d.ts +10 -2
  124. package/dist/data-transfer/asset-export.d.ts.map +1 -1
  125. package/dist/data-transfer/asset-import.d.ts +10 -2
  126. package/dist/data-transfer/asset-import.d.ts.map +1 -1
  127. package/dist/data-transfer/ontology-export.d.ts +10 -2
  128. package/dist/data-transfer/ontology-export.d.ts.map +1 -1
  129. package/dist/data-transfer/ontology-import.d.ts +10 -2
  130. package/dist/data-transfer/ontology-import.d.ts.map +1 -1
  131. package/dist/discovery/client.d.ts +31 -0
  132. package/dist/discovery/client.d.ts.map +1 -0
  133. package/dist/discovery/client.js +117 -0
  134. package/dist/discovery/client.js.map +1 -0
  135. package/dist/discovery/pagination.d.ts +20 -0
  136. package/dist/discovery/pagination.d.ts.map +1 -0
  137. package/dist/discovery/pagination.js +32 -0
  138. package/dist/discovery/pagination.js.map +1 -0
  139. package/dist/output/render.d.ts +7 -1
  140. package/dist/output/render.d.ts.map +1 -1
  141. package/dist/output/render.js +73 -0
  142. package/dist/output/render.js.map +1 -1
  143. package/dist/schema/command-schema.d.ts +26 -0
  144. package/dist/schema/command-schema.d.ts.map +1 -0
  145. package/dist/schema/command-schema.js +27 -0
  146. package/dist/schema/command-schema.js.map +1 -0
  147. package/dist/skills/content.d.ts +13 -0
  148. package/dist/skills/content.d.ts.map +1 -0
  149. package/dist/skills/content.js +103 -0
  150. package/dist/skills/content.js.map +1 -0
  151. package/dist/skills/state.d.ts +43 -0
  152. package/dist/skills/state.d.ts.map +1 -0
  153. package/dist/skills/state.js +56 -0
  154. package/dist/skills/state.js.map +1 -0
  155. package/dist/skills/sync.d.ts +28 -0
  156. package/dist/skills/sync.d.ts.map +1 -0
  157. package/dist/skills/sync.js +17 -0
  158. package/dist/skills/sync.js.map +1 -0
  159. package/dist/transport/http-client.d.ts.map +1 -1
  160. package/dist/transport/http-client.js +1 -0
  161. package/dist/transport/http-client.js.map +1 -1
  162. package/dist/transport/types.d.ts +1 -0
  163. package/dist/transport/types.d.ts.map +1 -1
  164. package/dist/update/updater.d.ts +1 -0
  165. package/dist/update/updater.d.ts.map +1 -1
  166. package/dist/update/updater.js +21 -5
  167. package/dist/update/updater.js.map +1 -1
  168. package/oclif.manifest.json +6013 -370
  169. package/package.json +57 -3
  170. package/skills/monkeys-agent-work/SKILL.md +21 -0
  171. package/skills/monkeys-agent-work/agents/openai.yaml +4 -0
  172. package/skills/monkeys-auth/SKILL.md +21 -0
  173. package/skills/monkeys-auth/agents/openai.yaml +4 -0
  174. package/skills/monkeys-data/SKILL.md +31 -0
  175. package/skills/monkeys-data/agents/openai.yaml +4 -0
  176. package/skills/monkeys-data/references/data-perspective.md +50 -0
  177. package/skills/monkeys-data/references/data-read.md +46 -0
  178. package/skills/{monkeys → monkeys-data}/references/ontology-feature-search.md +5 -5
  179. package/skills/{monkeys → monkeys-data}/references/ontology-model.md +2 -1
  180. package/skills/monkeys-openapi/SKILL.md +19 -0
  181. package/skills/monkeys-openapi/agents/openai.yaml +4 -0
  182. package/skills/monkeys-shared/SKILL.md +31 -0
  183. package/skills/monkeys-shared/agents/openai.yaml +4 -0
  184. package/skills/{monkeys → monkeys-shared}/references/compatibility.md +2 -2
  185. package/skills/{monkeys → monkeys-shared}/references/safety-errors.md +1 -1
  186. package/skills/monkeys-system-config/SKILL.md +20 -0
  187. package/skills/monkeys-system-config/agents/openai.yaml +4 -0
  188. package/skills/monkeys-workflow/SKILL.md +21 -0
  189. package/skills/monkeys-workflow/agents/openai.yaml +4 -0
  190. package/skills/monkeys/SKILL.md +0 -60
  191. package/skills/monkeys/agents/openai.yaml +0 -4
  192. package/skills/monkeys/references/data-perspective.md +0 -45
  193. package/skills/monkeys/references/data-read.md +0 -34
  194. /package/skills/{monkeys → monkeys-agent-work}/references/agent-work.md +0 -0
  195. /package/skills/{monkeys → monkeys-auth}/references/authentication.md +0 -0
  196. /package/skills/{monkeys → monkeys-data}/references/data-governance.md +0 -0
  197. /package/skills/{monkeys → monkeys-data}/references/data-transfer.md +0 -0
  198. /package/skills/{monkeys → monkeys-data}/references/data-write.md +0 -0
  199. /package/skills/{monkeys → monkeys-openapi}/references/fallback.md +0 -0
  200. /package/skills/{monkeys → monkeys-shared}/references/platform-overview.md +0 -0
  201. /package/skills/{monkeys → monkeys-system-config}/references/system-config.md +0 -0
  202. /package/skills/{monkeys → monkeys-workflow}/references/workflow-execution-files.md +0 -0
package/skills/monkeys/references/data-read.md DELETED
@@ -1,34 +0,0 @@
1
- # Data 读取
2
-
3
- ## 选择命令
4
-
5
- - Ontology：`data ontology list`
6
- - Container/View：`data view tree`
7
- - View 完整行表：`data view rows`
8
- - Asset：`data asset list/search/get/sample`
9
- - Asset 媒体：`data asset media download`
10
- - View Feature 附件：`data asset attachment download`
11
- - Field：`data field list/get`
12
- - Feature Value：`data value get`
13
- - Tag/Tag Group：对应的 `list/get`
14
-
15
- ## 流程
16
-
17
- 1. 先按 Data 视角路由选择 `data ontology list --scope all --perspective kernel` 或 `data ontology list --scope visible --perspective studio --team <Team ID>`，解析明确的 Ontology。
18
- 2. Kernel 全局读取默认不传 `--team`；只有用户明确要求某 Team 且命令支持筛选时才传。Field、View、Feature Value、Feature 附件和 Advanced Asset Search 需要后端资源 Team 时传已确认的 `--resource-team <数据 Team>`；不得从 Ontology owner `teamId`、Session 或空结果猜测。Studio 后续命令同时传明确的 `--team`、`--ontology <Ontology ID>` 和同一 `--perspective`，不传 `--resource-team`。
19
- 3. 检查输出中的 `effectivePerspective`、`teamMode`、可选的 `effectiveTeamId` 和 `resourceLocator`；`teamMode=none` 表示 CLI 未施加 Team 上下文/筛选。`resourceLocator.source=explicit-flag` 和 `resourceLocator.teamId` 只说明后端分区定位，不得补造用户筛选。CLI 返回 `DATA_RESOURCE_TEAM_REQUIRED` 时在聊天中请求已确认的数据资源 Team，不得尝试 `0`。
20
- 4. 用户要求“列出/查看某个 View 的数据”时，Kernel 默认使用 `monkeys data view rows --ontology <Ontology ID> --view <View ID> --resource-team <数据 Team> --limit 20 --perspective kernel --profile <Profile> --output json`；Studio 改用 `--team` 且不传 `--resource-team`。不要要求用户额外指定“完整列”，也不要先用紧凑 `data asset list` 代替。
21
- 5. View 类型为 `filter` 且已经配置 Tag/Field 规则时，继续使用 `data view rows`，由 CLI 按当前部署合同解析 `allOf`、`anyOf`、`noneOf` 与启用的字段规则。临时按 Ontology 全局 Feature 的结构化值筛选时，读取[Ontology Feature 结构化检索](ontology-feature-search.md)，使用 `data asset search --expression-json/--expression-file`；其他临时条件仍以命令 Help 为准。筛选失败或结果为空时先核对上下文、View 类型和规则，禁止通过 `data view convert-to-container` 兜底。
22
- 6. 依据返回的有序 `columns` 和 `rows` 在聊天中展示完整 Markdown 表格。列较多时按列分成多个表格，每个表都保留 Asset ID 和名称用于关联；不得静默省略列。附件单元格只显示“可下载”和数量，不显示 URL。
23
- 7. 只有用户明确要求简略列表、资源元数据或低上下文投影时，才使用 `data asset list --view <View ID>`。默认单页有界；只有用户确实需要时扩大范围。
24
- 8. 抽样使用 `data asset sample` 的有界样本，不自行无限翻页后随机。
25
- 9. 只复用同一 Context、Data Perspective、Team 模式、Data 合同、Ontology、View 和查询生成的 Cursor；游标不匹配时重新查询。
26
- 10. 用户需要读取、查看或保存 Asset 封面图片/媒体时，使用 `monkeys data asset media download <Asset ID> --ontology <Ontology ID> --out <本地路径> --perspective <kernel|studio> --profile <Profile> --output json`。`--source auto` 默认依次选择 `primaryContent.value`、`media`、`thumbnail`；需要特定来源时显式传 `--source`。
27
- 11. 用户需要 View Feature 中的 PDF/文件时，使用 `monkeys data asset attachment download <Asset ID> --ontology <Ontology ID> --view <View ID> --field <Field ID 或唯一精确名称> --out <本地路径> --perspective <kernel|studio> --profile <Profile> --output json`。历史 Field 类型可能是 `img`，仍应按实际 Content-Type/文件内容称为 PDF 或附件，不要误称为图片。
28
- 12. 下载成功后依据 CLI 返回的本地 `path` 展示或处理文件，并向用户报告来源 Field、大小和 SHA-256；不要把二进制正文塞入 JSON 或聊天文本。
29
- 13. 两种下载都由 CLI 内部处理对象地址：公开 HTTPS 对象使用匿名、无身份 Header、无重定向、有界原子下载；对象明确返回 401/403/404 时，CLI 才请求 Server 生成短期签名并重试。CLI 不自行签名，任何规范或签名 URL 都不得进入结构化输出或聊天。网络错误、重定向、异常 Content-Type、超限或签名失败必须直接报告，不得使用普通 HTTP、Raw API 或手工 URL 兜底。
30
- 14. 覆盖本地已有文件前必须得到用户对该精确路径的授权，并同时传 `--overwrite --yes`。默认最大 50 MiB；只有任务确有需要时才提高 `--max-bytes`，不得超过 1 GiB。
31
-
32
- 参数和筛选条件始终以相应命令的 `--help` 为准。
33
-
34
- `visible` 只表示当前身份可以读取，不代表可以创建、更新或治理。`data bucket` 和 `--bucket` 只用于旧脚本/旧部署兼容；新任务不得优先使用。