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

package/skills/monkeys/references/ontology-feature-search.md

@@ -12,14 +12,14 @@
 
 ## Agent 执行流程
 
-1. 按[Data 视角路由](data-perspective.md)确定 `--perspective`。内部开发默认 Kernel；Kernel 全局查询默认不传 `--team`，用户明确要求 Team 筛选时才传。用户明确要求 Studio 时使用 Studio 和明确 Team。
+1. 按[Data 视角路由](data-perspective.md)处理视角。用户明确要求时传 `--perspective studio|kernel`；未指定时省略，由 CLI 执行 Studio-first。Kernel 全局查询默认不传 `--team`，用户明确要求 Team 筛选时才传。
 2. 查询目标 Ontology 的 Feature Column：
 
    ```bash
-   monkeys data field list --profile <Profile> --perspective kernel --ontology <Ontology ID> --resource-team <数据 Team> --output json
+   monkeys data field list --profile <Profile> --ontology <Ontology ID> --resource-team <数据 Team> --output json
    ```
 
-   Kernel 下不要添加 `--team`；传已确认的 `--resource-team`。CLI 不会从 Ontology owner Team 自动推导；该 locator 不代表 Feature 查询被收窄到某个 Team。Studio 应改用明确的 `--team` 并移除 `--resource-team`。
+   自动模式可携带已确认的 `--resource-team` 供 Kernel 升级后定位；Studio 尝试不会使用它作为 Team 上下文。Kernel 下不要添加 `--team`，除非用户明确要求 Team 筛选。CLI 不会从 Ontology owner Team 自动推导。用户明确指定 Studio 时改用明确的 `--team` 并移除 `--resource-team`。
 
 3. 从返回项读取 `config.fieldKey`、`type` 和 `scopeContainerViewId`。只选择 `fieldKey` 非空、Ontology-global 且类型受支持的列；多个同名展示列不能按名称猜测。
 4. 使用 `--expression-json` 或复杂条件优先使用 `--expression-file`，并在 Kernel 命令继续传同一 `--resource-team`。不要手工包装 `filterConfigV2.expression`；CLI 会完成适配。
@@ -74,8 +74,8 @@ CLI 只校验 expression 公共结构和 JSON 标量形状。Feature 的真实
 
 - `DATA_SEARCH_EXPRESSION_INVALID`：请求未发送。修正节点路径、op、fieldKey、cmp、value 或表达式上限。
 - `DATA_SEARCH_EXPRESSION_CONFLICT`：请求未发送。删除重复的 `filterConfigV2.expression` 或 `--expression-*` 之一。
-- `DATA_RESOURCE_TEAM_REQUIRED`：缺少已确认的数据资源 Team。停止并向用户请求 `--resource-team`；不得尝试 owner Team、`0`、Session Team、Raw API 或在空结果后补 Team 重试。
-- `DATA_TEAM_ROLE_CONFLICT` / `DATA_RESOURCE_TEAM_NOT_APPLICABLE`：`--team` 与 `--resource-team` 角色冲突，或当前不是显式 Kernel Ontology 读取。按 recovery 修正参数，不得改走 Raw API。
+- `DATA_RESOURCE_TEAM_REQUIRED`：缺少已确认的数据资源 Team。停止并向用户请求 `--resource-team`；不得猜 owner Team、`0` 或 Session Team，也不得使用 Raw API 或在空结果后补 Team 重试。若用户或权威资源元数据已确认 data resource Team 为 `0`，则应显式传 `--resource-team 0`。
+- `DATA_TEAM_ROLE_CONFLICT` / `DATA_RESOURCE_TEAM_NOT_APPLICABLE`：`--team` 与 `--resource-team` 角色冲突，或 locator 不适用于明确 Studio/旧 Bucket 读取。按 recovery 修正参数，不得改走 Raw API。
 - `HTTP_400`：重新读取 Feature Column，核对 `config.fieldKey`、类型、比较符、全局作用域和不支持边界。不得 Raw API 降级。
 - `HTTP_503`：Feature 搜索依赖的 ES/索引不可用。向用户明确报告服务暂不可用和 `retryable`；不得改为 PG EAV 扫描、Raw API、模糊搜索或其他静默兜底。
 - 空结果：先检查 Perspective、Team、Ontology、权限和真实查询条件；只有紧邻已确认写入时才按最终一致性做一次有界重试。

package/skills/monkeys/references/ontology-model.md

@@ -37,7 +37,8 @@
 
 ## Kernel 与 Studio 可见性
 
-- 内部开发任务默认由 Skill 显式选择 Kernel；Kernel 全局读取没有用户 Team 作用域，显式 `--team` 只用于用户明确筛选。Ontology 子资源需要后端数据资源 Team 时传已确认的 `--resource-team`；owner Team 与 data resource Team 可以不同，Agent 和 CLI 都不得猜测。
+- 用户未指定视角时由 CLI 先查 Studio，确定性为空且当前账号有 Kernel 权限时再升级；Skill 不默认选择 Kernel。Kernel 全局读取没有用户 Team 作用域，显式 `--team` 只用于用户明确筛选。Ontology 子资源需要后端数据资源 Team 时传已确认的 `--resource-team`；owner Team 与 data resource Team 可以不同，Agent 和 CLI 都不得猜测。
+- Team `0` 是共享/系统数据分区，不是“所有 Team”。Team `0` 的 Ontology 可作为共享 Schema 被普通 Team 复用，所以 `Ontology.teamId=0` 不代表其中所有 Asset 或子资源都位于 Team `0`；直接查询已确认的 Team `0` 分区用 `--team 0`，定位已确认位于该分区的 Kernel 子资源用 `--resource-team 0`。
 - Studio 结果受当前账户和 Team 可见性限制；用户明确要求 Studio 时必须遵守。
 - Kernel 权限不足且用户未指定视角时，Skill 只有在存在等价 Studio 操作并先在聊天中告知范围收窄后，才可显式降级。
 - 后台能找到 Asset、前台某个 View 找不到，常见原因是 Studio 权限或 Membership/Filter 条件不同，不代表 Asset 不存在。

package/skills/monkeys/references/safety-errors.md

@@ -8,7 +8,7 @@
 
 只有 `retryable=true` 且操作本身安全或带稳定幂等键时才有限重试。退出码 3/4/7 不得通过 Raw API 绕过。
 
-`DATA_RESOURCE_TEAM_REQUIRED` 表示 Kernel Ontology 读取缺少已确认的 data resource Team；`DATA_TEAM_ROLE_CONFLICT` 表示同时传了用户筛选/上下文 `--team` 和资源定位 `--resource-team`；`DATA_RESOURCE_TEAM_NOT_APPLICABLE` 表示把 locator 用在 Studio、legacy perspective 或旧 Bucket。三类错误都发生在请求前。不得硬编码 `0`、使用 owner Team 或 Session Team 猜测、切换 Studio、调用 Raw API或等业务空结果后重试；应向用户报告 Ontology ID、错误和 recovery。
+`DATA_RESOURCE_TEAM_REQUIRED` 表示 Kernel Ontology 读取缺少已确认的 data resource Team；`DATA_TEAM_ROLE_CONFLICT` 表示同时传了用户筛选/上下文 `--team` 和资源定位 `--resource-team`；`DATA_RESOURCE_TEAM_NOT_APPLICABLE` 表示把 locator 用在明确 Studio 或旧 Bucket 读取。三类错误都发生在请求前。不得把 `0` 硬编码为默认值，也不得使用 owner Team 或 Session Team 猜测、调用 Raw API 或继续盲试；用户或权威资源元数据已确认共享/系统数据分区时，`--resource-team 0` 是有效的显式定位。应向用户报告 Ontology ID、错误和 recovery。
 
 ## Secret 与输出