@inf-monkeys-tech/monkeys-cli 0.12.29 → 0.12.31

package/oclif.manifest.json

@@ -2776,6 +2776,13 @@
           "summary": "Use only this Data perspective; when omitted, read queries use Studio first and may fall back to Kernel",
           "type": "option"
         },
+        "resource-team": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "resource-team",
+          "summary": "Kernel Ontology data resource location Team; does not represent Team filtering and cannot be used simultaneously with --team",
+          "type": "option"
+        },
         "subscription": {
           "hasDynamicHelp": false,
           "multiple": false,
@@ -3533,6 +3540,13 @@
           "summary": "Use only this Data perspective; when omitted, read queries use Studio first and may fall back to Kernel",
           "type": "option"
         },
+        "resource-team": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "resource-team",
+          "summary": "Kernel Ontology data resource location Team; does not represent Team filtering and cannot be used simultaneously with --team",
+          "type": "option"
+        },
         "source": {
           "default": "auto",
           "hasDynamicHelp": false,
@@ -3544,7 +3558,7 @@
             "media",
             "thumbnail"
           ],
-          "summary": "Media source; auto select primary, media, thumbnail in sequence",
+          "summary": "Media source; auto tries distinct primary, media, thumbnail sources on recoverable failures",
           "type": "option"
         },
         "subscription": {
@@ -5870,6 +5884,301 @@
       ],
       "strict": true
     },
+    "data:filter:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List the filter views recorded against a Thread, newest first.",
+      "enableJsonFlag": false,
+      "flags": {
+        "jq": {
+          "char": "q",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "jq",
+          "summary": "Filter the JSON result with a jq expression",
+          "type": "option"
+        },
+        "limit": {
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "limit",
+          "summary": "Maximum number of views to return",
+          "type": "option"
+        },
+        "output": {
+          "default": "json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "output",
+          "options": [
+            "json",
+            "pretty",
+            "table",
+            "ndjson",
+            "csv",
+            "text"
+          ],
+          "summary": "Output format",
+          "type": "option"
+        },
+        "subscription": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "subscription",
+          "summary": "Subscription name",
+          "type": "option"
+        },
+        "team": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "team",
+          "summary": "Team context",
+          "type": "option"
+        },
+        "thread": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "thread",
+          "required": true,
+          "summary": "Thread ID",
+          "type": "option"
+        },
+        "yes": {
+          "allowNo": false,
+          "char": "y",
+          "name": "yes",
+          "summary": "Confirm destructive or privileged operations",
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "data:filter:list",
+      "isESM": true,
+      "pluginAlias": "@inf-monkeys-tech/monkeys-cli",
+      "pluginName": "@inf-monkeys-tech/monkeys-cli",
+      "pluginType": "core",
+      "relativePath": [
+        "dist",
+        "commands",
+        "data",
+        "filter",
+        "list.js"
+      ],
+      "strict": true
+    },
+    "data:filter:rerun": {
+      "aliases": [],
+      "args": {
+        "viewId": {
+          "description": "Filter view ID",
+          "name": "viewId",
+          "required": true
+        }
+      },
+      "description": "Re-run a stored filter view against current data.",
+      "enableJsonFlag": false,
+      "flags": {
+        "jq": {
+          "char": "q",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "jq",
+          "summary": "Filter the JSON result with a jq expression",
+          "type": "option"
+        },
+        "limit": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "limit",
+          "summary": "Return at most this many rows",
+          "type": "option"
+        },
+        "output": {
+          "default": "json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "output",
+          "options": [
+            "json",
+            "pretty",
+            "table",
+            "ndjson",
+            "csv",
+            "text"
+          ],
+          "summary": "Output format",
+          "type": "option"
+        },
+        "subscription": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "subscription",
+          "summary": "Subscription name",
+          "type": "option"
+        },
+        "team": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "team",
+          "summary": "Team context",
+          "type": "option"
+        },
+        "yes": {
+          "allowNo": false,
+          "char": "y",
+          "name": "yes",
+          "summary": "Confirm destructive or privileged operations",
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "data:filter:rerun",
+      "isESM": true,
+      "pluginAlias": "@inf-monkeys-tech/monkeys-cli",
+      "pluginName": "@inf-monkeys-tech/monkeys-cli",
+      "pluginType": "core",
+      "relativePath": [
+        "dist",
+        "commands",
+        "data",
+        "filter",
+        "rerun.js"
+      ],
+      "strict": true
+    },
+    "data:filter:run": {
+      "aliases": [],
+      "args": {},
+      "description": "Run a filter-view schema against an Ontology, record the view, and return the matching rows.",
+      "enableJsonFlag": false,
+      "flags": {
+        "jq": {
+          "char": "q",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "jq",
+          "summary": "Filter the JSON result with a jq expression",
+          "type": "option"
+        },
+        "limit": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "limit",
+          "summary": "Return at most this many rows (the schema limit still applies)",
+          "type": "option"
+        },
+        "message": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "message",
+          "summary": "Message that produced the view",
+          "type": "option"
+        },
+        "no-persist": {
+          "allowNo": false,
+          "name": "no-persist",
+          "summary": "Execute without recording the view",
+          "type": "boolean"
+        },
+        "output": {
+          "default": "json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "output",
+          "options": [
+            "json",
+            "pretty",
+            "table",
+            "ndjson",
+            "csv",
+            "text"
+          ],
+          "summary": "Output format",
+          "type": "option"
+        },
+        "run": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "run",
+          "summary": "Run ID the view belongs to",
+          "type": "option"
+        },
+        "schema-file": {
+          "exclusive": [
+            "schema-json"
+          ],
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "schema-file",
+          "summary": "Filter-view schema JSON file",
+          "type": "option"
+        },
+        "schema-json": {
+          "exclusive": [
+            "schema-json"
+          ],
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "schema-json",
+          "summary": "Filter-view schema JSON Object",
+          "type": "option"
+        },
+        "subscription": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "subscription",
+          "summary": "Subscription name",
+          "type": "option"
+        },
+        "team": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "team",
+          "summary": "Team context; required when the Subscription has no default Team",
+          "type": "option"
+        },
+        "thread": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "thread",
+          "required": true,
+          "summary": "Thread the view belongs to",
+          "type": "option"
+        },
+        "title": {
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "title",
+          "summary": "View title shown in the drawer",
+          "type": "option"
+        },
+        "yes": {
+          "allowNo": false,
+          "char": "y",
+          "name": "yes",
+          "summary": "Confirm destructive or privileged operations",
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "data:filter:run",
+      "isESM": true,
+      "pluginAlias": "@inf-monkeys-tech/monkeys-cli",
+      "pluginName": "@inf-monkeys-tech/monkeys-cli",
+      "pluginType": "core",
+      "relativePath": [
+        "dist",
+        "commands",
+        "data",
+        "filter",
+        "run.js"
+      ],
+      "strict": true
+    },
     "data:ontology:create": {
       "aliases": [],
       "args": {},
@@ -19583,5 +19892,5 @@
       "strict": true
     }
   },
-  "version": "0.12.29"
+  "version": "0.12.31"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inf-monkeys-tech/monkeys-cli",
-  "version": "0.12.29",
+  "version": "0.12.31",
   "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": "c3ff80eef1076afb5c1d2f343102ae00684cbf9b"
+  "monkeysReleaseCommit": "1615f316f5d04a72145cbac300af7c9330c88ae8"
 }

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

@@ -24,8 +24,8 @@
 7. 只有用户明确要求简略列表、资源元数据或低上下文投影时，才使用 `data asset list --view <View ID>`。默认单页有界；只有用户确实需要时扩大范围。
 8. 抽样使用 `data asset sample` 的有界样本，不自行无限翻页后随机。
 9. 只复用同一 Context、Team 模式、Data 合同、Ontology、View 和查询生成的 Cursor；CLI Cursor 会保留自动路由后的实际 Data Perspective，游标不匹配时重新查询。
-10. 用户需要读取、查看或保存 Asset 封面图片/媒体时，使用 `monkeys data asset media download <Asset ID> --ontology <Ontology ID> --out <本地路径> --subscription <Subscription> --output json`；用户明确指定视角时再补 `--perspective studio|kernel`。`--source auto` 默认依次选择 `primaryContent.value`、`media`、`thumbnail`；需要特定来源时显式传 `--source`。
-11. 用户需要 View Feature 中的 PDF/文件时，使用 `monkeys data asset attachment download <Asset ID> --ontology <Ontology ID> --view <View ID> --field <Field ID 或唯一精确名称> --out <本地路径> --subscription <Subscription> --output json`；用户明确指定视角时再补 `--perspective studio|kernel`。历史 Field 类型可能是 `img`，仍应按实际 Content-Type/文件内容称为 PDF 或附件，不要误称为图片。
+10. 用户需要读取、查看或保存 Asset 封面图片/媒体时，使用 `monkeys data asset media download <Asset ID> --ontology <Ontology ID> --out <本地路径> --subscription <Subscription> --output json`；明确 Kernel 时补 `--perspective kernel --resource-team <已确认的数据 Team>`，明确 Studio 时补 `--perspective studio --team <Team ID>`，不要混传两种 Team 参数。`--source auto` 按 `primaryContent.value`、`media`、`thumbnail` 顺序尝试不同地址；网络、5xx 或非媒体响应等可恢复错误会继续下一来源，同一地址只下载一次。显式指定来源时不自动换源；权限、签名校验、重定向、文件大小和本地写入错误仍直接报告。
+11. 用户需要 View Feature 中的 PDF/文件时，使用 `monkeys data asset attachment download <Asset ID> --ontology <Ontology ID> --view <View ID> --field <Field ID 或唯一精确名称> --out <本地路径> --subscription <Subscription> --output json`；明确 Kernel 时补 `--perspective kernel --resource-team <已确认的数据 Team>`，明确 Studio 时补 `--perspective studio --team <Team ID>`，不要混传两种 Team 参数。历史 Field 类型可能是 `img`，仍应按实际 Content-Type/文件内容称为 PDF 或附件，不要误称为图片。
 12. 下载成功后依据 CLI 返回的本地 `path` 展示或处理文件，并向用户报告来源 Field、大小和 SHA-256；不要把二进制正文塞入 JSON 或聊天文本。
 13. 两种下载都由 CLI 内部处理对象地址：公开 HTTPS 对象使用匿名、无身份 Header、无重定向、有界原子下载；对象明确返回 401/403/404 时，CLI 才请求 Server 生成短期签名并重试。CLI 不自行签名，任何规范或签名 URL 都不得进入结构化输出或聊天。网络错误、重定向、异常 Content-Type、超限或签名失败必须直接报告，不得使用普通 HTTP、Raw API 或手工 URL 兜底。
 14. 覆盖本地已有文件前必须得到用户对该精确路径的授权，并同时传 `--overwrite --yes`。默认最大 50 MiB；只有任务确有需要时才提高 `--max-bytes`，不得超过 1 GiB。