github/dingtalk-workspace-cli
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(schema): finish declaration-framework migration and remove metadata hints

Browse Source 
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
玉澜andCursor committed 2026-08-01 13:46:54 +08:00
1 parent 066094a68c
commit bd45de95ab
101 files changed
+1276 -2410
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

AGENTS.md
+57 -42
View File
@@ -45,24 +45,26 @@ The Schema data flow is one way:
```text ```text
1. app.NewRootCommand() 1. app.NewRootCommand()
└─ builds the real Cobra command tree and flags └─ builds the real Cobra command tree and flags
└─ leaf Safety / Schema / ParamDecl declare ContractFinal (declare-or-annotate)
2. schema_command_registry.json 2. schema_command_registry.json
+ schema_hints/metadata/<product>.json tool parameters (+ cli_path)
└─ forms EffectiveCommandRegistry └─ forms EffectiveCommandRegistry
└─ binds exactly to real Cobra leaves and aliases └─ binds exactly to real Cobra leaves and aliases
3. Parameter resolution 3. Parameter resolution
Cobra flags Cobra flags
+ schema_parameter_bindings.json + schema_parameter_bindings.json
+ metadata tool parameters + ParamDecl / native annotations from leaf declarations
└─ produces ParameterSpec and constraints └─ produces ParameterSpec and constraints
4. Agent and interface semantics 4. Agent and interface semantics
schema_hints/selection/<product>.json (selection prose) schema_hints/selection/<product>.json (selection prose)
+ schema_hints/metadata/<product>.json (safety/interface/runtime_gate) + ContractFinal Safety / Interface on each leaf
+ pinned MCP metadata + pinned MCP metadata
└─ resolves Agent metadata by source precedence └─ resolves Agent metadata by source precedence
Markdown is evidence only; it is not concatenated into final prose Markdown is evidence only; it is not concatenated into final prose
└─ schema_hints/metadata/ is retired (directory may be absent;
index.metadata may be {}/omitted); not a parallel leaf-fact source
5. One typed hub 5. One typed hub
BoundCommandRegistry BoundCommandRegistry
@@ -86,13 +88,11 @@ The Schema data flow is one way:
└─ backed by embedded catalog (sync.Once lazy map, O(1) lookup) └─ backed by embedded catalog (sync.Once lazy map, O(1) lookup)
``` ```
Parameter overlays from metadata are merged into `EffectiveCommandRegistry` After binding there is no second identity source and no identity precedence
*before* Cobra binding; after that point there is no second identity source and winner. The binder must reject a missing/non-runnable Cobra path, an alias
no identity precedence winner. The binder must reject a missing/non-runnable collision, and any native identity annotation that disagrees with the effective
Cobra path, an alias collision, and any native identity annotation that registry. A missing native identity annotation is allowed because annotations
disagrees with the effective registry. A missing native identity annotation is are implementation-side assertions, not identity fallbacks.
allowed because annotations are implementation-side assertions, not identity
fallbacks.
The assembler resolves every bound command exactly once into one `ToolSpec`. The assembler resolves every bound command exactly once into one `ToolSpec`.
Build-time gates and the snapshot serializer consume that source-resolved typed Build-time gates and the snapshot serializer consume that source-resolved typed
@@ -114,8 +114,9 @@ The Schema system has two physically separated processes:
not in business code). not in business code).
- Tools: `internal/generator/cmd_schema_agent_metadata` + `cmd_schema_catalog` + - Tools: `internal/generator/cmd_schema_agent_metadata` + `cmd_schema_catalog` +
`cmd_param_aliases` (standalone Go mains). `cmd_param_aliases` (standalone Go mains).
- Inputs: 7 authored source groups (registry + hints metadata + hints selection + - Inputs: authored source groups (registry + required hints selection + MCP
MCP metadata + parameter bindings + reviewed parameter concepts + cobra tree). metadata + parameter bindings + reviewed parameter concepts + cobra tree).
`schema_hints/metadata/` is retired and may be absent.
- Output: `schema_catalog/` (per-product shards) + `schema_agent_metadata/` + - Output: `schema_catalog/` (per-product shards) + `schema_agent_metadata/` +
`param_aliases_generated.go`. `param_aliases_generated.go`.
- Refresh MCP metadata: `make fetch-mcp-metadata` (iterates 26 MCP server - Refresh MCP metadata: `make fetch-mcp-metadata` (iterates 26 MCP server
@@ -160,11 +161,16 @@ When adding or changing an Agent-visible command, review all relevant inputs:
machine-readable editing contract. Preserve the local `$schema` reference; machine-readable editing contract. Preserve the local `$schema` reference;
unknown fields, invalid visibility values, stale paths, and collisions fail unknown fields, invalid visibility values, stale paths, and collisions fail
Go validation and policy. Go validation and policy.
- `internal/cli/schema_hints/metadata/<product>.json` for safety, interface, - Leaf `Safety` / `Schema` / `ParamDecl` (helpers `LeafSpec` or shortcut
`runtime_gate`, and optional parameter overlays (`parameters` / `cli_path`). `Schema`) for parameter facts, interface disposition, and safety. Delivered
provenance is `contract_final` from `corecmd.contract`.
- `internal/cli/schema_hints/selection/<product>.json` for reviewed Agent - `internal/cli/schema_hints/selection/<product>.json` for reviewed Agent
selection prose (`agent_summary`, `use_when`, `avoid_when`, `examples`). selection prose (`agent_summary`, `use_when`, `avoid_when`, `examples`).
- `internal/cli/schema_hints/index.json` only maps product IDs to those files. - `internal/cli/schema_hints/metadata/` is retired (directory may be absent).
Do not reintroduce reviewed tool rows or parameter overlays; declare on the
leaf instead.
- `internal/cli/schema_hints/index.json` maps product IDs to selection files;
`metadata` may be omitted or `{}`.
- Native Runtime Schema identity annotations, when present, as consistency - Native Runtime Schema identity annotations, when present, as consistency
assertions against `EffectiveCommandRegistry`. They must agree exactly and assertions against `EffectiveCommandRegistry`. They must agree exactly and
must never materialize, infer, or override registry identity. must never materialize, infer, or override registry identity.
@@ -178,20 +184,18 @@ that works through `dws <path>` but cannot be found through the matching
`dws schema` lookup is a contract failure unless it has a reviewed exact `dws schema` lookup is a contract failure unless it has a reviewed exact
exclusion. exclusion.
Metadata parameter overlays must reference an exact public runnable Cobra leaf Production `RegisterSchemaHints` maps must stay empty after ParamDecl
and real flags. They may override Schema description, interface-property/type migration. Temporary hint injection is allowed only inside unit-test fixtures
mapping, `required`, and `required_when`; they must not create commands or that exercise precedence edges.
flags, define an interface, or advertise an unknown RPC. Every authored entry
requires `reviewed: true` and a non-empty review reason.
For Agent-authored metadata or selection edits: For Agent-authored selection edits:
1. Confirm the exact command and flag names in the current Cobra tree. 1. Confirm the exact command and flag names in the current Cobra tree.
2. Edit only the owning block (`metadata/` or `selection/`); do not mix fields. 2. Edit `selection/<product>.json` for selection prose; declare safety /
parameters / interface on the owning leaf (`LeafSpec` / `Shortcut.Schema`).
3. Add the smallest possible entry; do not copy generated Catalog fields into 3. Add the smallest possible entry; do not copy generated Catalog fields into
the input. the input.
4. Describe user-visible semantics in `review_reason` and parameter 4. Describe user-visible semantics in `review_reason`.
descriptions.
5. Run generation, drift, Schema policy, and the focused CLI tests before 5. Run generation, drift, Schema policy, and the focused CLI tests before
proposing the change. proposing the change.
@@ -201,15 +205,16 @@ Use this workflow when refreshing Agent selection prose and confirmation
alignment. Prefer **agent-authored review** over bulk merge scripts that dump alignment. Prefer **agent-authored review** over bulk merge scripts that dump
`selection-review.json` or Skill Markdown into Catalog fields. `selection-review.json` or Skill Markdown into Catalog fields.
Human-authored inputs are split into two blocks: Human-authored inputs are split as follows:
| Block | Path | Owns | | Block | Path | Owns |
|---|---|---| |---|---|---|
| **metadata** | `internal/cli/schema_hints/metadata/<product>.json` | `effect` / `risk` / `confirmation` / `idempotency` / `interface_*` / `runtime_gate` / optional `parameters` | | **declaration** | helpers / shortcut `Safety` + `Schema` / ParamDecl | `effect` / `risk` / `confirmation` / `idempotency` / `interface_*` / parameter facts (`contract_final`) |
| **selection** | `internal/cli/schema_hints/selection/<product>.json` | `agent_summary` / `use_when` / `avoid_when` / `examples` (+ product routing) | | **selection** | `internal/cli/schema_hints/selection/<product>.json` | `agent_summary` / `use_when` / `avoid_when` / `examples` (+ product routing) |
| **metadata** (retired) | `internal/cli/schema_hints/metadata/` may be absent | not a leaf-fact source; do not reintroduce tool rows |
`index.json` only maps product IDs to those files. Do not mix selection fields `index.json` maps product IDs to selection files; `metadata` is optional
into metadata files or metadata fields into selection files. (`{}` / omitted). Do not reintroduce metadata tool rows.
### Goals ### Goals
@@ -217,17 +222,19 @@ into metadata files or metadata fields into selection files.
sibling-command routing, and outcome shape — not a restatement of the sibling-command routing, and outcome shape — not a restatement of the
summary. Delivered Catalog provenance is `reviewed_explicit` from summary. Delivered Catalog provenance is `reviewed_explicit` from
`selection/`. `selection/`.
2. **Safety** follows Runtime: `confirmation=user_required` iff the tool's 2. **Safety** follows Runtime: `confirmation=user_required` when the leaf
metadata `runtime_gate != none` (for example `confirm_delete`, `typed_yes`, Contract/Safety (or remaining `runtime_gate` annotate) requires a user gate
`confirm_dangerous`). (for example `confirm_delete`, `typed_yes`, `confirm_dangerous`).
3. **Parameter overrides** (former Manual `commands`) live on metadata tools as 3. **Parameter facts** are declared on the leaf (`ParamDecl` /
`parameters` (+ `cli_path`) and are applied into EffectiveCommandRegistry. `Schema.Parameters` / FlagSpec). Do not add production
`RegisterSchemaHints` overlays or metadata tool parameter rows.
### Authoring ### Authoring
For every curated tool: For every curated tool:
1. Edit `metadata/<product>.json` for safety/interface/gates/parameters. 1. Declare safety/interface/parameters on the owning leaf
(`DeclareLeafMetadata` / `Shortcut.Schema` / ParamDecl).
2. Edit `selection/<product>.json` for selection prose (`reviewed: true`, 2. Edit `selection/<product>.json` for selection prose (`reviewed: true`,
`review_reason`, `source_refs`). `review_reason`, `source_refs`).
3. Run `make generate-schema`. Do not hand-edit generated 3. Run `make generate-schema`. Do not hand-edit generated
@@ -259,9 +266,9 @@ Split work by product groups. Each agent must:
- Read Skill, Cobra/`--help`, Runtime confirmation sites, and live `dws schema` - Read Skill, Cobra/`--help`, Runtime confirmation sites, and live `dws schema`
for its tools. for its tools.
- Hand-write selection + metadata; forbid wholesale JSON merges from review - Hand-write selection prose and leaf Contract declarations; forbid wholesale
dumps. JSON merges from review dumps.
- Edit only its `metadata/<product>.json` and `selection/<product>.json`. - Edit only its product’s leaf declarations and `selection/<product>.json`.
- **Never** `git checkout` unrelated product files to “clean scope”. - **Never** `git checkout` unrelated product files to “clean scope”.
### Regenerate and gates ### Regenerate and gates
@@ -272,6 +279,12 @@ make generate-schema
go test ./internal/app -run '^TestSheetFinalSchemaConfirmationMatchesRuntimeGuards$' -count=1 go test ./internal/app -run '^TestSheetFinalSchemaConfirmationMatchesRuntimeGuards$' -count=1
``` ```
`check-runtime-confirmation-truth.sh` compares Catalog
`confirmation=user_required` to Contract SafetySpec (plus any residual
metadata `runtime_gate != none`). It does **not** require a
`schema_hints/metadata` directory: absent, empty shells (`tools: {}`), or
missing `tools` all pass.
Example rules (fail generation otherwise): Example rules (fail generation otherwise):
- At most two examples per tool; no `--yes` in stored examples. - At most two examples per tool; no `--yes` in stored examples.
@@ -279,16 +292,18 @@ Example rules (fail generation otherwise):
- No shell comments in examples. - No shell comments in examples.
After generation, spot-check Catalog: selection provenance is After generation, spot-check Catalog: selection provenance is
`reviewed_explicit` from `selection/`, and `user_required` count equals `reviewed_explicit` from `selection/`, and safety/interface provenance is
metadata `runtime_gate != none`. `contract_final` from leaf declarations (`user_required` must match Runtime
confirmation gates).
`make generate-schema` is a full deterministic snapshot rebuild, not an `make generate-schema` is a full deterministic snapshot rebuild, not an
incremental patch over the previous Catalog. It rereads every reviewed input, incremental patch over the previous Catalog. It rereads every reviewed input,
removes stale generated product metadata, and rewrites the exact metadata and removes stale generated product metadata, and rewrites the exact metadata and
Catalog projections. Incremental work happens only when an Agent or human Catalog projections. Incremental work happens only when an Agent or human
edits selected `metadata/` or `selection/` entries; the next publication still edits selected leaf declarations or `selection/` entries; the next publication
recomputes all outputs. Generated files must never be read back as merge input, still recomputes all outputs. Generated files must never be read back as merge
and byte guards fail generation if it changes the hint inputs or CommandRegistry. input, and byte guards fail generation if it changes the hint inputs or
CommandRegistry.
Selection prose may choose a more or less restrictive recommendation. It cannot Selection prose may choose a more or less restrictive recommendation. It cannot
create a Cobra command or flag, change parameter facts, invent an create a Cobra command or flag, change parameter facts, invent an
Makefile
+18 -13
View File
@@ -140,13 +140,17 @@ generate-schema:
registry_guard=$$(mktemp -d); \ registry_guard=$$(mktemp -d); \
concepts_guard=$$(mktemp); \ concepts_guard=$$(mktemp); \
concepts_schema_guard=$$(mktemp); \ concepts_schema_guard=$$(mktemp); \
metadata_guard=$$(mktemp -d); \
selection_guard=$$(mktemp -d); \ selection_guard=$$(mktemp -d); \
metadata_dir=internal/cli/schema_hints/metadata; \
metadata_guard=""; \
if [ -d "$$metadata_dir" ]; then \
metadata_guard=$$(mktemp -d); \
cp -R "$$metadata_dir"/. "$$metadata_guard"/; \
fi; \
trap 'rm -rf "$$registry_guard" "$$concepts_guard" "$$concepts_schema_guard" "$$metadata_guard" "$$selection_guard"' EXIT HUP INT TERM; \ trap 'rm -rf "$$registry_guard" "$$concepts_guard" "$$concepts_schema_guard" "$$metadata_guard" "$$selection_guard"' EXIT HUP INT TERM; \
cp -R internal/cli/schema_command_registry/ "$$registry_guard/"; \ cp -R internal/cli/schema_command_registry/ "$$registry_guard/"; \
cp internal/cli/param_concepts.json "$$concepts_guard"; \ cp internal/cli/param_concepts.json "$$concepts_guard"; \
cp internal/cli/param_concepts.schema.json "$$concepts_schema_guard"; \ cp internal/cli/param_concepts.schema.json "$$concepts_schema_guard"; \
cp -R internal/cli/schema_hints/metadata/. "$$metadata_guard/"; \
cp -R internal/cli/schema_hints/selection/. "$$selection_guard/"; \ cp -R internal/cli/schema_hints/selection/. "$$selection_guard/"; \
$(GO) generate ./internal/cli; \ $(GO) generate ./internal/cli; \
diff -qr internal/cli/schema_command_registry "$$registry_guard" >/dev/null || { \ diff -qr internal/cli/schema_command_registry "$$registry_guard" >/dev/null || { \
@@ -161,18 +165,19 @@ generate-schema:
printf '%s\n' 'generation modified reviewed input internal/cli/param_concepts.schema.json' >&2; \ printf '%s\n' 'generation modified reviewed input internal/cli/param_concepts.schema.json' >&2; \
exit 1; \ exit 1; \
}; \ }; \
cmp -s internal/cli/param_concepts.json "$$concepts_guard" || { \ if [ -n "$$metadata_guard" ]; then \
printf '%s\n' 'generation modified reviewed input internal/cli/param_concepts.json' >&2; \ if [ ! -d "$$metadata_dir" ]; then \
printf '%s\n' 'generation removed reviewed input internal/cli/schema_hints/metadata' >&2; \
exit 1; \
fi; \
diff -qr "$$metadata_dir" "$$metadata_guard" >/dev/null || { \
printf '%s\n' 'generation modified reviewed input internal/cli/schema_hints/metadata' >&2; \
exit 1; \
}; \
elif [ -d "$$metadata_dir" ]; then \
printf '%s\n' 'generation created reviewed input internal/cli/schema_hints/metadata' >&2; \
exit 1; \ exit 1; \
}; \ fi; \
cmp -s internal/cli/param_concepts.schema.json "$$concepts_schema_guard" || { \
printf '%s\n' 'generation modified reviewed input internal/cli/param_concepts.schema.json' >&2; \
exit 1; \
}; \
diff -qr internal/cli/schema_hints/metadata "$$metadata_guard" >/dev/null || { \
printf '%s\n' 'generation modified reviewed input internal/cli/schema_hints/metadata' >&2; \
exit 1; \
}; \
diff -qr internal/cli/schema_hints/selection "$$selection_guard" >/dev/null || { \ diff -qr internal/cli/schema_hints/selection "$$selection_guard" >/dev/null || { \
printf '%s\n' 'generation modified reviewed input internal/cli/schema_hints/selection' >&2; \ printf '%s\n' 'generation modified reviewed input internal/cli/schema_hints/selection' >&2; \
exit 1; \ exit 1; \
README.md
+1 -1
View File
@@ -396,7 +396,7 @@ The repo ships a complete Agent Skill system under `skills/`, organized into two
- `skills/mono/` — single-skill layout (one `SKILL.md` + `references/products/`), recommended default. - `skills/mono/` — single-skill layout (one `SKILL.md` + `references/products/`), recommended default.
- `skills/multi/` — per-product skills (`dingtalk-aitable/`, `dingtalk-calendar/`, `dingtalk-chat/`, ...), each with its own `SKILL.md`. 🧪 **EXPERIMENTAL / preview — see banner in each multi `SKILL.md` for caveats.** - `skills/multi/` — per-product skills (`dingtalk-aitable/`, `dingtalk-calendar/`, `dingtalk-chat/`, ...), each with its own `SKILL.md`. 🧪 **EXPERIMENTAL / preview — see banner in each multi `SKILL.md` for caveats.**
Shared reviewed inputs for Schema generation live separately under `internal/cli/schema_hints/`. They are not Agent Skills and are excluded from binaries and release skill bundles. Shared Schema generation inputs live under `internal/cli/schema_hints/` (required reviewed `selection/` prose; `metadata/` is retired and may be absent; leaf safety/parameters come from Contract). They are not Agent Skills and are excluded from release skill bundles.
After installing, AI tools like Claude Code / Cursor can operate DingTalk directly through natural language: After installing, AI tools like Claude Code / Cursor can operate DingTalk directly through natural language:
README_zh.md
+1 -1
View File
@@ -390,7 +390,7 @@ dws aitable record query --base-id BASE_ID --table-id TABLE_ID --limit 10
- `skills/mono/` — 单 skill 布局（一个 `SKILL.md` + `references/products/`），默认推荐。 - `skills/mono/` — 单 skill 布局（一个 `SKILL.md` + `references/products/`），默认推荐。
- `skills/multi/` — 每个产品一个独立 skill（`dingtalk-aitable/` / `dingtalk-calendar/` / `dingtalk-chat/` ...），每个 skill 自带 `SKILL.md`。🧪 **试验版 / Preview — 各 multi `SKILL.md` 头部有详细注意事项。** - `skills/multi/` — 每个产品一个独立 skill（`dingtalk-aitable/` / `dingtalk-calendar/` / `dingtalk-chat/` ...），每个 skill 自带 `SKILL.md`。🧪 **试验版 / Preview — 各 multi `SKILL.md` 头部有详细注意事项。**
Schema 生成共享的 reviewed 输入单独位于 `internal/cli/schema_hints/`。它们不是 Agent Skill，也不会进入二进制或发布 skill 包。 Schema 生成共享输入单独位于 `internal/cli/schema_hints/`（必需的 reviewed `selection/`；`metadata/` 已退役且可缺席；叶子 safety/参数由 Contract 声明）。它们不是 Agent Skill，也不会进入发布 skill 包。
安装之后，Claude Code / Cursor 等 AI 工具就能通过自然语言直接操作钉钉： 安装之后，Claude Code / Cursor 等 AI 工具就能通过自然语言直接操作钉钉：
docs/flag-help-schema-homology.md
+3 -3
View File
@@ -140,7 +140,7 @@ NewLeafCommand(LeafSpec{
| `cli.AnnotateRuntimeGate` / `devAppMetaWrite` | `dws.schema.runtime_gate=devAppRequireWriteGuard` | 尚未迁移到 SafetySpec 的旧写命令（`HOM-S2`） | | `cli.AnnotateRuntimeGate` / `devAppMetaWrite` | `dws.schema.runtime_gate=devAppRequireWriteGuard` | 尚未迁移到 SafetySpec 的旧写命令（`HOM-S2`） |
| `cli.AnnotateRuntimeRisk` | `dws.schema.risk=…` | Shortcut 暂存的旧兼容路径；command/Leaf 禁止新增 | | `cli.AnnotateRuntimeRisk` | `dws.schema.risk=…` | Shortcut 暂存的旧兼容路径；command/Leaf 禁止新增 |
| `cli.AnnotateRuntimeFlag` / Constraints | 与 embed 同形 | 手写 cobra 叶补齐表面（长期应迁入 Contract） | | `cli.AnnotateRuntimeFlag` / Constraints | 与 embed 同形 | 手写 cobra 叶补齐表面（长期应迁入 Contract） |
| reviewed `schema_hints/metadata` Safety | effect/risk/confirmation | 迁移期遗留；受管命令收敛后让位于 Safety/gate | | reviewed `schema_hints/metadata` Safety | effect/risk/confirmation | 已迁出：metadata 壳为 `tools: {}`；受管命令以 Contract.Safety / gate 为准 |
标注与声明冲突时：**Contract 声明胜**（路径 A）。标注不得发明未注册的 CLI flag。 标注与声明冲突时：**Contract 声明胜**（路径 A）。标注不得发明未注册的 CLI flag。
@@ -174,8 +174,8 @@ NewLeafCommand(LeafSpec{
| canonical path / aliases / navigation / exposure | `schema_command_registry`（+ reviewed manual additions） | Schema identity | | canonical path / aliases / navigation / exposure | `schema_command_registry`（+ reviewed manual additions） | Schema identity |
| use_when / avoid_when / examples / agent_summary 文案 | `schema_hints/selection` | Schema selection | | use_when / avoid_when / examples / agent_summary 文案 | `schema_hints/selection` | Schema selection |
| RPC tool 形状、`interface_ref`、interface 描述 | `schema_mcp_metadata` + `schema_parameter_bindings` | Schema `interface_*` 字段；**不得创建 flag** | | RPC tool 形状、`interface_ref`、interface 描述 | `schema_mcp_metadata` + `schema_parameter_bindings` | Schema `interface_*` 字段；**不得创建 flag** |
| 参数描述 overlay（可选） | `schema_hints/metadata` 仅补充 usage 文案 | 与 Contract/cobra 冲突时 **Contract/cobra 胜** | | 参数描述 overlay（可选） | 生产 metadata 壳为空；参数事实走 ParamDecl / FlagSpec | **Contract/cobra 胜** |
| 遗留 Safety 文案（迁移期） | 今日仍可读 `schema_hints/metadata` safety | 受管命令收敛后以 Contract.Safety / runtime_gate 为准（见 §4） | | 遗留 Safety 文案（迁移期） | 生产 metadata 壳为空；Safety 走 Contract | 以 Contract.Safety / runtime_gate 为准（见 §4） |
| dry-run 正能力 | reviewed dry-run registry | Schema `dry_run` | | dry-run 正能力 | reviewed dry-run registry | Schema `dry_run` |
| positionals | Contract Args / 显式 annotate | Schema `positionals` | | positionals | Contract Args / 显式 annotate | Schema `positionals` |
| FieldProvenance | 组装派生 | Schema provenance（与值一致） | | FieldProvenance | 组装派生 | Schema provenance（与值一致） |
docs/rfc-command-framework-convergence.md
+2 -2
View File
@@ -345,13 +345,13 @@ Definition（仅声明；不可编译）
| **Identity** | `product_id`, `name`, `cli_name`, `canonical_path` / `cli_path` / `primary_cli_path`, `group`, `aliases`, `source`, `source_product_id` | 绑定树 entry（registry 绑定结果） | `schema_command_registry`（+ reviewed manual additions）；`SchemaDecl.Identity` 可声明但**必须与绑定一致**，不一致组装报错 | 可声明（钉扎/自描述），**不得改绑** | | **Identity** | `product_id`, `name`, `cli_name`, `canonical_path` / `cli_path` / `primary_cli_path`, `group`, `aliases`, `source`, `source_product_id` | 绑定树 entry（registry 绑定结果） | `schema_command_registry`（+ reviewed manual additions）；`SchemaDecl.Identity` 可声明但**必须与绑定一致**，不一致组装报错 | 可声明（钉扎/自描述），**不得改绑** |
| **Display / Title / Description** | 产品展示名；工具 title/description | 评审源为主；cobra Short/Long 可作候选 | registry 产品名；hints/metadata / cobra help 解析 | Short/Long 可声明，但 **canonical 文案不以 Contract 胜 identity** | | **Display / Title / Description** | 产品展示名；工具 title/description | 评审源为主；cobra Short/Long 可作候选 | registry 产品名；hints/metadata / cobra help 解析 | Short/Long 可声明，但 **canonical 文案不以 Contract 胜 identity** |
| **Parameters** | `name`, `type`, `required` / `cli_required`, `default` | **声明**（或手写 annotate 同形） | `Flags` → `embedContractIntoSchema` / cobra | **是** | | **Parameters** | `name`, `type`, `required` / `cli_required`, `default` | **声明**（或手写 annotate 同形） | `Flags` → `embedContractIntoSchema` / cobra | **是** |
| | `description`（usage 文案） | 声明 usage；hints 可 overlay 文案 | `FlagSpec.Usage`；`schema_hints/metadata` 仅补 description | usage **是**；overlay 不得改 type/required/default | | | `description`（usage 文案） | 声明 usage；生产 metadata 壳为空 | `FlagSpec.Usage` / ParamDecl；勿再往 `schema_hints/metadata` 填 overlay | usage **是**；不得用 hint overlay 改 type/required/default |
| | `property`（载荷键） | 声明 | `FlagSpec.Bind`（空则 Name） | **是**（载荷映射） | | | `property`（载荷键） | 声明 | `FlagSpec.Bind`（空则 Name） | **是**（载荷映射） |
| | `enum`, `format`, `example`, `required_when` | 声明或评审 annotate | 今日部分仍 hints/手工；目标进 Contract / reviewed 约束 | 有则须 declare 或 reviewed annotate | | | `enum`, `format`, `example`, `required_when` | 声明或评审 annotate | 今日部分仍 hints/手工；目标进 Contract / reviewed 约束 | 有则须 declare 或 reviewed annotate |
| | `interface_description`, `interface_type`, `interface_default` | 评审源（interface） | `schema_mcp_metadata` + bindings | 否；**不得创建 CLI flag**（`HOM-I1`） | | | `interface_description`, `interface_type`, `interface_default` | 评审源（interface） | `schema_mcp_metadata` + bindings | 否；**不得创建 CLI flag**（`HOM-I1`） |
| **Constraints** | `require_one_of`, `mutually_exclusive`, `require_together` | **声明** | `Constraints` → `AnnotateConstraints` | **是** | | **Constraints** | `require_one_of`, `mutually_exclusive`, `require_together` | **声明** | `Constraints` → `AnnotateConstraints` | **是** |
| **Positionals** | 位置参数名/必填/说明 | **声明** 或显式 annotate | 目标 `Args`/`PositionalSpec`；今日少量 cobra Args + 注解 | 受管命令应声明，禁止推断 | | **Positionals** | 位置参数名/必填/说明 | **声明** 或显式 annotate | 目标 `Args`/`PositionalSpec`；今日少量 cobra Args + 注解 | 受管命令应声明，禁止推断 |
| **Safety** | `effect`, `risk`, `confirmation`, `idempotency` | **声明**（完整 `cli.SafetySpec`）**或标注**（`runtime_gate`）或迁移期 reviewed Safety | `Safety` / `AnnotateRuntimeGate` / `schema_hints/metadata` safety | 四字段独立；confirmation 单独驱动运行时 | | **Safety** | `effect`, `risk`, `confirmation`, `idempotency` | **声明**（完整 `cli.SafetySpec`）**或标注**（`runtime_gate`） | `Safety` / `AnnotateRuntimeGate`（metadata 壳 `tools: {}`，不再承载 reviewed Safety） | 四字段独立；confirmation 单独驱动运行时 |
| | `idempotency` | 评审源（或未来 Contract） | reviewed metadata | 今日非框架声明；不得推断 | | | `idempotency` | 评审源（或未来 Contract） | reviewed metadata | 今日非框架声明；不得推断 |
| | `effect_source` / provenance | 组装派生物 | resolver 写入 `FieldProvenance` | 派生，不手写 | | | `effect_source` / provenance | 组装派生物 | resolver 写入 `FieldProvenance` | 派生，不手写 |
| **DryRun** | `preview_kind`, `remote_reads` | 评审源 | `schema_dry_run_capabilities`（正能力声明） | 否；无条目 ≠ 推断「不支持」之外的假能力 | | **DryRun** | `preview_kind`, `remote_reads` | 评审源 | `schema_dry_run_capabilities`（正能力声明） | 否；无条目 ≠ 推断「不支持」之外的假能力 |
docs/schema-dynamic-endpoint-design.md
+4 -3
View File
@@ -45,7 +45,8 @@ skills/mono Markdown + internal/cli/schema_hints/*.json |
+-----------------------+ +-----------------------+
| |
live Cobra flag facts / typed parameter metadata live Cobra flag facts / typed parameter metadata
+ schema_hints/metadata/*.json (reviewed parameter overlay + safety) + leaf Contract (Safety / Schema / ParamDecl → contract_final)
+ schema_hints/metadata/*.json (reserved product shells; tools: {})
+ schema_hints/selection/*.json (reviewed Agent selection prose) + schema_hints/selection/*.json (reviewed Agent selection prose)
+ schema_parameter_bindings.json (reviewed flag -> RPC property) + schema_parameter_bindings.json (reviewed flag -> RPC property)
+ schema_mcp_metadata.json (pinned, sanitized interface facts) + schema_mcp_metadata.json (pinned, sanitized interface facts)
@@ -130,7 +131,7 @@ DWS 当前对外仍保留兼容 wire：leaf 使用 flat `parameters`，安全和
| reviewed manual command additions | 将一个精确存在的 runnable Cobra leaf 合并进 `EffectiveCommandRegistry`；必须 reviewed 且带 reason | 运行时 fallback、覆盖冲突 identity、创建命令 | | reviewed manual command additions | 将一个精确存在的 runnable Cobra leaf 合并进 `EffectiveCommandRegistry`；必须 reviewed 且带 reason | 运行时 fallback、覆盖冲突 identity、创建命令 |
| Go/Cobra | Contract 编译后的可执行投影：路径是否真实可执行、Cobra 接受的 flag、DefValue、help 文本 | 稳定 canonical identity、Agent 场景选择、虚构 RPC；**不得**成为与 Contract 平行的第二套 flag 权威 | | Go/Cobra | Contract 编译后的可执行投影：路径是否真实可执行、Cobra 接受的 flag、DefValue、help 文本 | 稳定 canonical identity、Agent 场景选择、虚构 RPC；**不得**成为与 Contract 平行的第二套 flag 权威 |
| native Schema identity annotations | implementation-side consistency evidence；存在时必须与 `EffectiveCommandRegistry` 精确一致 | 提供、补全、推断或覆盖 identity | | native Schema identity annotations | implementation-side consistency evidence；存在时必须与 `EffectiveCommandRegistry` 精确一致 | 提供、补全、推断或覆盖 identity |
| `schema_hints/metadata/*.json` parameter overlays | 补充 flag **description** 等文案；迁移期可读 safety | 创建命令/flag；**不得**静默改写 type/required/default（与 Contract 冲突时 Contract/cobra 胜）；不得绕过 completeness、虚构 RPC | | `schema_hints/metadata/*.json` product shells | 保留产品壳（`tools: {}`）；叶子事实已迁入 Contract/ParamDecl | 重新填入 reviewed 工具行或 parameter overlay；创建命令/flag；绕过 completeness、虚构 RPC |
| typed parameter metadata / constraints | 由 Contract 约束投影而来的 `require_one_of` / 互斥等；以及仍需 reviewed 的 `required_when` 等 | 命令 identity | | typed parameter metadata / constraints | 由 Contract 约束投影而来的 `require_one_of` / 互斥等；以及仍需 reviewed 的 `required_when` 等 | 命令 identity |
| `schema_parameter_bindings.json` | 稳定 CLI flag 到 RPC property 的映射 | 命令发现、risk 推断、创建 CLI flag | | `schema_parameter_bindings.json` | 稳定 CLI flag 到 RPC property 的映射 | 命令发现、risk 推断、创建 CLI flag |
| `schema_mcp_metadata.json` | pinned RPC identity、接口描述和脱敏参数事实（interface 同源） | CLI identity、运行时路由、**创建 CLI flag**、risk 推断 | | `schema_mcp_metadata.json` | pinned RPC identity、接口描述和脱敏参数事实（interface 同源） | CLI identity、运行时路由、**创建 CLI flag**、risk 推断 |
@@ -329,6 +330,6 @@ go test ./internal/cli ./internal/app ./internal/generator/... -count=1
- renderer、query 或 gate 在 `SchemaRegistry` 之后重新读取 source 并做第二次 merge。 - renderer、query 或 gate 在 `SchemaRegistry` 之后重新读取 source 并做第二次 merge。
- 用 prefix/wildcard exclusion 隐藏未来命令。 - 用 prefix/wildcard exclusion 隐藏未来命令。
- 让 manual hint、CommandRegistry 或 interface metadata 宣称一个不存在的命令、flag 或 RPC 可用。 - 让 manual hint、CommandRegistry 或 interface metadata 宣称一个不存在的命令、flag 或 RPC 可用。
- 让 `schema_hints/metadata` overlay 在与 Contract/cobra 冲突时赢得 type/required/default。 - 让 `schema_hints/metadata` 重新承载 reviewed 工具行 / parameter overlay，或让任何残留 overlay 在与 Contract/cobra 冲突时赢得 type/required/default。
- 把 `schema --all` 当作普通业务数据查询，或把其完整结果无条件注入 Agent 上下文。 - 把 `schema --all` 当作普通业务数据查询，或把其完整结果无条件注入 Agent 上下文。
- 将 LeafSpec、`+shortcut` 或 write-guard/cursor/多步命令注册为 `mcp_passthrough` 表面。 - 将 LeafSpec、`+shortcut` 或 write-guard/cursor/多步命令注册为 `mcp_passthrough` 表面。
internal/app/schema_interface_disposition_contract_test.go
+33 -44
View File
@@ -13,65 +13,55 @@ import (
func TestReviewedRoutedInterfacesReachFinalSchema(t *testing.T) { func TestReviewedRoutedInterfacesReachFinalSchema(t *testing.T) {
type interfaceCase struct { type interfaceCase struct {
canonical string canonical string
mode string mode string
reason string reason string
sourceSuffix string
} }
tests := []interfaceCase{ tests := []interfaceCase{
{ {
canonical: "attendance.get_attendance_summary", canonical: "attendance.get_attendance_summary",
mode: "composite", mode: "composite",
reason: "Reviewed unpinned remote adapter: the CLI calls attendance-wukong/get_user_attendance_summary, which is absent from the pinned MCP metadata snapshot; the incompatible attendance/get_attendance_summary contract must not be advertised.", reason: "Reviewed unpinned remote adapter: the CLI calls attendance-wukong/get_user_attendance_summary, which is absent from the pinned MCP metadata snapshot; the incompatible attendance/get_attendance_summary contract must not be advertised.",
sourceSuffix: "internal/cli/schema_hints/metadata/attendance.json",
}, },
{ {
canonical: "drive.list_files", canonical: "drive.list_files",
mode: "composite", mode: "composite",
reason: "The CLI command routes by --workspace between drive/list_files and doc/list_nodes, so the reviewed executable wrapper has no single direct MCP interface.", reason: "The CLI command routes by --workspace between drive/list_files and doc/list_nodes, so the reviewed executable wrapper has no single direct MCP interface.",
sourceSuffix: "internal/cli/schema_hints/metadata/drive.json",
}, },
{ {
canonical: "chat.search_groups", canonical: "chat.search_groups",
mode: "composite", mode: "composite",
reason: "Reviewed unpinned remote adapter: the CLI calls im/search_groups with a flat payload, while the pinned snapshot only contains the incompatible chat/search_groups_by_keyword contract.", reason: "Reviewed unpinned remote adapter: the CLI calls im/search_groups with a flat payload, while the pinned snapshot only contains the incompatible chat/search_groups_by_keyword contract.",
sourceSuffix: "internal/cli/schema_hints/metadata/chat.json",
}, },
{ {
canonical: "sheet.range_batch_set_style", canonical: "sheet.range_batch_set_style",
mode: "composite", mode: "composite",
reason: "The CLI reads a local batch file and performs multiple sheet/update_range calls with local continue-on-error control; the workflow has no single direct MCP interface.", reason: "The CLI reads a local batch file and performs multiple sheet/update_range calls with local continue-on-error control; the workflow has no single direct MCP interface.",
sourceSuffix: "internal/cli/schema_hints/metadata/sheet.json",
}, },
{ {
canonical: "sheet.range_read", canonical: "sheet.range_read",
mode: "composite", mode: "composite",
reason: "Reviewed unpinned remote adapter: the CLI calls sheet/get_cell_infos, which is absent from the pinned MCP metadata snapshot; the incompatible sheet/get_range contract must not be advertised.", reason: "Reviewed unpinned remote adapter: the CLI calls sheet/get_cell_infos, which is absent from the pinned MCP metadata snapshot; the incompatible sheet/get_range contract must not be advertised.",
sourceSuffix: "internal/cli/schema_hints/metadata/sheet.json",
}, },
{ {
canonical: "wiki.list_wikiSpaces", canonical: "wiki.list_wikiSpaces",
mode: "composite", mode: "composite",
reason: "The CLI command routes by --type between wiki/list_wikiSpaces and drive/list_spaces, so the reviewed executable wrapper has no single direct MCP interface.", reason: "The CLI command routes by --type between wiki/list_wikiSpaces and drive/list_spaces, so the reviewed executable wrapper has no single direct MCP interface.",
sourceSuffix: "internal/cli/schema_hints/metadata/wiki.json",
}, },
{ {
canonical: "event.consume", canonical: "event.consume",
mode: "composite", mode: "composite",
reason: "Reviewed composite workflow: the command creates or reuses a remote personal-event subscription and coordinates the local event bus and Stream consumer; no single pinned RPC represents the workflow.", reason: "Reviewed composite workflow: the command creates or reuses a remote personal-event subscription and coordinates the local event bus and Stream consumer; no single pinned RPC represents the workflow.",
sourceSuffix: "internal/cli/schema_hints/metadata/event.json",
}, },
{ {
canonical: "event.status", canonical: "event.status",
mode: "composite", mode: "composite",
reason: "Reviewed composite workflow: the command reads the remote personal-event subscription control plane and combines it with local bus and consumer state; no single pinned RPC represents the result.", reason: "Reviewed composite workflow: the command reads the remote personal-event subscription control plane and combines it with local bus and consumer state; no single pinned RPC represents the result.",
sourceSuffix: "internal/cli/schema_hints/metadata/event.json",
}, },
{ {
canonical: "event.stop", canonical: "event.stop",
mode: "composite", mode: "composite",
reason: "Reviewed composite workflow: the command deletes remote personal-event subscriptions, interrupts local consumers, updates local state, and may stop the local bus; no single pinned RPC represents the workflow.", reason: "Reviewed composite workflow: the command deletes remote personal-event subscriptions, interrupts local consumers, updates local state, and may stop the local bus; no single pinned RPC represents the workflow.",
sourceSuffix: "internal/cli/schema_hints/metadata/event.json",
}, },
} }
for _, canonical := range []string{ for _, canonical := range []string{
@@ -81,10 +71,9 @@ func TestReviewedRoutedInterfacesReachFinalSchema(t *testing.T) {
"aitable.view_update_timebar", "aitable.view_update_timebar",
} { } {
tests = append(tests, interfaceCase{ tests = append(tests, interfaceCase{
canonical: canonical, canonical: canonical,
mode: "composite", mode: "composite",
reason: "The CLI performs an aitable/get_views preflight, locally transforms the requested configuration, and then calls aitable/update_view; the two-call workflow has no single direct MCP interface.", reason: "The CLI performs an aitable/get_views preflight, locally transforms the requested configuration, and then calls aitable/update_view; the two-call workflow has no single direct MCP interface.",
sourceSuffix: "internal/cli/schema_hints/metadata/aitable.json",
}) })
} }
internal/app/schema_safety_contract_test.go
+3 -3
View File
@@ -16,8 +16,8 @@ type finalSchemaSafetyWant struct {
confirmation string confirmation string
idempotency string idempotency string
// provenance is the expected field_provenance precedence; empty defaults // provenance is the expected field_provenance precedence; empty defaults
// to "reviewed_explicit" (hints path). Contract-declared tools (devapp) // to "contract_final" (DeclareLeafMetadata / corecmd.Contract). Production
// deliver "contract_final". // metadata shells no longer carry reviewed tool rows.
provenance string provenance string
} }
@@ -88,7 +88,7 @@ func assertFinalSchemaSafety(t *testing.T, wants []finalSchemaSafetyWant) {
} }
wantProvenance := want.provenance wantProvenance := want.provenance
if wantProvenance == "" { if wantProvenance == "" {
wantProvenance = "reviewed_explicit" wantProvenance = "contract_final"
} }
provenance := schemaContractMap(tool["field_provenance"]) provenance := schemaContractMap(tool["field_provenance"])
for field, expected := range values { for field, expected := range values {
internal/cli/gen.go
+8 -6
View File
@@ -19,12 +19,14 @@
// //
// Generation inputs (authored, reviewed): // Generation inputs (authored, reviewed):
// 1. schema_command_registry/ identity (canonical/aliases/navigation) // 1. schema_command_registry/ identity (canonical/aliases/navigation)
// 2. schema_hints/metadata/*.json safety (effect/risk/confirmation) // 2. schema_hints/selection/*.json selection (use_when/avoid_when) — required
// 3. schema_hints/selection/*.json selection (use_when/avoid_when) // 3. schema_mcp_metadata.json MCP server tool definitions
// 4. schema_mcp_metadata.json MCP server tool definitions // 4. schema_parameter_bindings.json parameter type/property mappings
// 5. schema_parameter_bindings.json parameter type/property mappings // 5. param_concepts.json + schema reviewed parameter synonym policy
// 6. param_concepts.json + schema reviewed parameter synonym policy // 6. cobra command tree (Go runtime) flags/usage/required (reflected)
// 7. cobra command tree (Go runtime) flags/usage/required (reflected) //
// schema_hints/metadata/ is retired (directory may be absent).
// index.metadata may be omitted or {}; leaf safety/params come from Contract.
// //
// Generation outputs (embedded at build): // Generation outputs (embedded at build):
// - schema_agent_metadata/*.json per-product agent metadata // - schema_agent_metadata/*.json per-product agent metadata
internal/cli/runtime_schema_coverage_more_test.go
+1
View File
@@ -90,6 +90,7 @@ func TestCrossPlatformCoverageCollectRuntimeSchemaEntriesErrorsAndOrdering(t *te
} }
func TestCrossPlatformCoverageRuntimeSchemaMetadataLookupEdges(t *testing.T) { func TestCrossPlatformCoverageRuntimeSchemaMetadataLookupEdges(t *testing.T) {
// Fixture-only hint injection: production RegisterSchemaHints stays empty.
originalHints := defaultSchemaHintRegistry originalHints := defaultSchemaHintRegistry
t.Cleanup(func() { defaultSchemaHintRegistry = originalHints }) t.Cleanup(func() { defaultSchemaHintRegistry = originalHints })
defaultSchemaHintRegistry = newSchemaHintRegistry() defaultSchemaHintRegistry = newSchemaHintRegistry()
internal/cli/schema_agent_metadata/aisearch.json
+4 -6
View File
@@ -474,11 +474,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/aisearch.json", "source": "internal/cli/schema_mcp_metadata.json#tools.aisearch.search_enterprise",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed CLI supports an all-content search with default --types all, while --queries and --time-range are optional filters; imported MCP required markers must not turn them into mandatory CLI input."
} }
] ]
}, },
@@ -533,7 +532,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/aisearch.json",
"internal/cli/schema_mcp_metadata.json#tools.aisearch.search_enterprise", "internal/cli/schema_mcp_metadata.json#tools.aisearch.search_enterprise",
"skills/mono/references/intent-guide.md", "skills/mono/references/intent-guide.md",
"skills/mono/references/products/aisearch.md" "skills/mono/references/products/aisearch.md"
internal/cli/schema_agent_metadata/aitable.json
+16 -48
View File
@@ -22231,13 +22231,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/aitable.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed query command supports both an optional ID lookup mode and a table scan/filter mode, so --record-ids is not unconditionally required."
} }
] ]
}, },
@@ -22292,7 +22285,6 @@
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.query_records", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.aitable.prod.json#aitable.query_records",
"internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/imported/wukong.json",
"internal/cli/schema_hints/metadata/aitable.json",
"internal/cli/schema_mcp_metadata.json#tools.aitable.query_records", "internal/cli/schema_mcp_metadata.json#tools.aitable.query_records",
"skills/mono/references/products/aitable-record-ops.md", "skills/mono/references/products/aitable-record-ops.md",
"skills/mono/references/products/aitable.md", "skills/mono/references/products/aitable.md",
@@ -31570,11 +31562,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/aitable.json", "source": "internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_aggregate",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed CLI accepts --json, a --field-id/--action pair, or --clear-field-id; the registered typed constraints describe those alternatives."
} }
] ]
}, },
@@ -31624,7 +31615,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/aitable.json",
"internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_aggregate", "internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_aggregate",
"skills/mono/references/products/aitable/aitable-view-config.md" "skills/mono/references/products/aitable/aitable-view-config.md"
], ],
@@ -31850,11 +31840,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/aitable.json", "source": "internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_card",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed CLI merges optional typed card flags over an optional --json block; the registered typed constraints require at least one real update field."
} }
] ]
}, },
@@ -31904,7 +31893,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/aitable.json",
"internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_card", "internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_card",
"skills/mono/references/products/aitable/aitable-view-config.md" "skills/mono/references/products/aitable/aitable-view-config.md"
], ],
@@ -32127,11 +32115,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/aitable.json", "source": "internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_field_widths",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed CLI accepts either --json or the paired --field-id/--width form, which is represented by typed require-one-of and require-together constraints."
} }
] ]
}, },
@@ -32181,7 +32168,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/aitable.json",
"internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_field_widths", "internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_field_widths",
"skills/mono/references/products/aitable/aitable-view-config.md" "skills/mono/references/products/aitable/aitable-view-config.md"
], ],
@@ -34227,11 +34213,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/aitable.json", "source": "internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_timebar",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed CLI accepts either a complete --json block or one or more typed Gantt timebar fields; --json is therefore not unconditionally required."
} }
] ]
}, },
@@ -34281,7 +34266,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/aitable.json",
"internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_timebar", "internal/cli/schema_mcp_metadata.json#tools.aitable.view_update_timebar",
"skills/mono/references/products/aitable/aitable-view-config.md" "skills/mono/references/products/aitable/aitable-view-config.md"
], ],
@@ -34742,13 +34726,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/aitable.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The command maps --base-id and a decoded workflow-dsl/v1 --dsl object to aitable/create_workflow. The call intentionally bypasses retries because creation is non-idempotent; locale remains optional."
} }
] ]
}, },
@@ -34798,7 +34775,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/aitable.json",
"skills/mono/references/products/aitable/aitable-workflow.md" "skills/mono/references/products/aitable/aitable-workflow.md"
], ],
"use_when": [ "use_when": [
@@ -36038,13 +36014,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/aitable.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The command maps --base-id, --workflow-id and a decoded complete workflow-dsl/v1 --dsl object to aitable/update_workflow. This is full replacement rather than a partial patch; locale remains optional."
} }
] ]
}, },
@@ -36094,7 +36063,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/aitable.json",
"skills/mono/references/products/aitable/aitable-workflow.md" "skills/mono/references/products/aitable/aitable-workflow.md"
], ],
"use_when": [ "use_when": [
internal/cli/schema_agent_metadata/attendance.json
-24
View File
@@ -4697,13 +4697,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/attendance.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Cobra supplies reviewed page=1 and limit=20 defaults and RunE sends those defaults when omitted, so callers need not pass either pagination flag."
} }
] ]
}, },
@@ -4753,7 +4746,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/attendance.json",
"skills/mono/references/products/attendance.md" "skills/mono/references/products/attendance.md"
], ],
"use_when": [ "use_when": [
@@ -8781,13 +8773,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/attendance.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Cobra supplies reviewed page=1 and limit=20 defaults and RunE materializes both PageQuery fields when omitted, so callers need not pass either flag."
} }
] ]
}, },
@@ -8837,7 +8822,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/attendance.json",
"skills/mono/references/products/attendance-schedule.md", "skills/mono/references/products/attendance-schedule.md",
"skills/mono/references/products/attendance.md" "skills/mono/references/products/attendance.md"
], ],
@@ -9818,13 +9802,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/attendance.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Cobra supplies reviewed page=1 and limit=20 defaults and RunE sends those defaults when omitted, so callers need not pass either pagination flag."
} }
] ]
}, },
@@ -9874,7 +9851,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/attendance.json",
"skills/mono/references/products/attendance.md" "skills/mono/references/products/attendance.md"
], ],
"use_when": [ "use_when": [
internal/cli/schema_agent_metadata/chat.json
+41 -133
View File
@@ -9138,13 +9138,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/chat.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Reviewed against authenticated contact-search resolution, create-only, two-action dry-run, create/update success, missing bizId, and partial-failure behavior that preserves the created bizId; the explicit openDingTalkId flag is bound to the lower interface's exact receiverOpenDingTalkId property."
} }
] ]
}, },
@@ -9187,8 +9180,7 @@
"reviewed": true, "reviewed": true,
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl"
"internal/cli/schema_hints/metadata/chat.json"
], ],
"use_when": [ "use_when": [
"当你要发送一张流式卡片消息时使用；群 openConversationId、单聊 userId、单聊 openDingTalkId 严格三选一，分别使用 --group、--receiver、--receiver-open-dingtalk-id。--receiver 始终按 userId 通过通讯录关键词搜索做精确匹配，即使值以 D/d 开头也不会猜成 openDingTalkId；已有 openDingTalkId 时必须用显式参数直传。userId 包括在 --dry-run 时也会先解析。只传目标时创建卡片并返回 bizId，供后续 messages-update-card 流式更新；同时传 --content 时会自动串联创建和更新，默认以 flowStatus=3 完成，避免卡片停留在加载中。" "当你要发送一张流式卡片消息时使用；群 openConversationId、单聊 userId、单聊 openDingTalkId 严格三选一，分别使用 --group、--receiver、--receiver-open-dingtalk-id。--receiver 始终按 userId 通过通讯录关键词搜索做精确匹配，即使值以 D/d 开头也不会猜成 openDingTalkId；已有 openDingTalkId 时必须用显式参数直传。userId 包括在 --dry-run 时也会先解析。只传目标时创建卡片并返回 bizId，供后续 messages-update-card 流式更新；同时传 --content 时会自动串联创建和更新，默认以 flowStatus=3 完成，避免卡片停留在加载中。"
@@ -11266,13 +11258,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/chat.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler requires a comma-separated category-ID list, parses it to integers, and invokes get_conv_categories_info without a mutation or confirmation gate."
} }
] ]
}, },
@@ -11322,7 +11307,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
], ],
"use_when": [ "use_when": [
@@ -11522,13 +11506,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/chat.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Expose the existing smart-category helper through the reviewed Agent Schema and preserve its CLI-to-interface parameter contract."
} }
] ]
}, },
@@ -11578,7 +11555,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
], ],
"use_when": [ "use_when": [
@@ -12039,13 +12015,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/chat.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler accepts one of three conversation locator aliases and invokes list_conv_categories_by_conv without a mutation or confirmation gate."
} }
] ]
}, },
@@ -12095,7 +12064,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
], ],
"use_when": [ "use_when": [
@@ -14362,11 +14330,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/chat.json", "source": "internal/cli/schema_mcp_metadata.json#tools.chat.list_owned_or_admin_groups",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed CLI lists all owned or administered groups when --role and --limit are omitted; both flags are optional filters despite stricter imported interface metadata."
} }
] ]
}, },
@@ -14419,7 +14386,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"internal/cli/schema_mcp_metadata.json#tools.chat.list_owned_or_admin_groups", "internal/cli/schema_mcp_metadata.json#tools.chat.list_owned_or_admin_groups",
"skills/mono/references/intent-guide.md", "skills/mono/references/intent-guide.md",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
@@ -16212,11 +16178,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/chat.json", "source": "internal/cli/schema_mcp_metadata.json#tools.chat.update_conv_member_roles",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed optional --off switch selects administrator removal; omission deliberately selects administrator assignment."
} }
] ]
}, },
@@ -16269,7 +16234,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"internal/cli/schema_mcp_metadata.json#tools.chat.update_conv_member_roles", "internal/cli/schema_mcp_metadata.json#tools.chat.update_conv_member_roles",
"skills/mono/references/intent-guide.md", "skills/mono/references/intent-guide.md",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
@@ -17256,13 +17220,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/chat.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler requires the target conversation while intentionally allowing omitted --nick to send an empty nickname and clear the current user's group nickname."
} }
] ]
}, },
@@ -17312,7 +17269,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"skills/mono/references/intent-guide.md", "skills/mono/references/intent-guide.md",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
], ],
@@ -17756,13 +17712,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/chat.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler validates the target group and optional string-valued extension object, permits caller-authoritative dry-run, and requires explicit --yes before the irreversible upgrade."
} }
] ]
}, },
@@ -17806,7 +17755,6 @@
"risk": "high", "risk": "high",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
], ],
"use_when": [ "use_when": [
@@ -18456,11 +18404,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/chat.json", "source": "internal/cli/schema_mcp_metadata.json#tools.chat.set_group_mute",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed optional --off switch selects unmute; omission deliberately selects mute, so false is a valid default rather than missing required input."
} }
] ]
}, },
@@ -18513,7 +18460,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"internal/cli/schema_mcp_metadata.json#tools.chat.set_group_mute", "internal/cli/schema_mcp_metadata.json#tools.chat.set_group_mute",
"skills/mono/references/intent-guide.md", "skills/mono/references/intent-guide.md",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
@@ -18719,11 +18665,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/chat.json", "source": "internal/cli/schema_mcp_metadata.json#tools.chat.set_group_member_mute_list",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed Cobra contract makes --off an optional mode switch: omission adds members to the mute list, while --off removes them. The shared MCP schema incorrectly marks the boolean as unconditionally required."
} }
] ]
}, },
@@ -18776,7 +18721,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"internal/cli/schema_mcp_metadata.json#tools.chat.set_group_member_mute_list", "internal/cli/schema_mcp_metadata.json#tools.chat.set_group_member_mute_list",
"skills/mono/references/intent-guide.md", "skills/mono/references/intent-guide.md",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
@@ -21063,11 +21007,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/chat.json", "source": "internal/cli/schema_mcp_metadata.json#tools.chat.add_emoji_reaction",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The four reviewed conversation locator flags are aliases for one openConversationId property; the typed require-one-of constraint owns their conditional requirement."
} }
] ]
}, },
@@ -21120,7 +21063,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"internal/cli/schema_mcp_metadata.json#tools.chat.add_emoji_reaction", "internal/cli/schema_mcp_metadata.json#tools.chat.add_emoji_reaction",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
], ],
@@ -21573,11 +21515,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/chat.json", "source": "internal/cli/schema_mcp_metadata.json#tools.chat.add_text_emotion",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The four reviewed conversation locator flags are aliases for one openConversationId property; the typed require-one-of constraint owns their conditional requirement."
} }
] ]
}, },
@@ -21630,7 +21571,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"internal/cli/schema_mcp_metadata.json#tools.chat.add_text_emotion", "internal/cli/schema_mcp_metadata.json#tools.chat.add_text_emotion",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
], ],
@@ -22582,13 +22522,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/chat.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler requires one conversation locator, a message ID, and exactly one of text or raw content; it optionally derives a title and maps mention controls before invoking edit_message."
} }
] ]
}, },
@@ -22632,7 +22565,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
], ],
"use_when": [ "use_when": [
@@ -24636,13 +24568,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/chat.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Preserve the reviewed CLI-to-interface conversion: Cobra validates --size as an integer from 1 to 100, then the helper serializes it to the string-valued list_message_favorites size property."
} }
] ]
}, },
@@ -24692,7 +24617,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
], ],
"use_when": [ "use_when": [
@@ -27247,11 +27171,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/chat.json", "source": "internal/cli/schema_mcp_metadata.json#tools.chat.remove_emoji_reaction",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The four reviewed conversation locator flags are aliases for one openConversationId property; the typed require-one-of constraint owns their conditional requirement."
} }
] ]
}, },
@@ -27304,7 +27227,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"internal/cli/schema_mcp_metadata.json#tools.chat.remove_emoji_reaction", "internal/cli/schema_mcp_metadata.json#tools.chat.remove_emoji_reaction",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
], ],
@@ -27757,11 +27679,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/chat.json", "source": "internal/cli/schema_mcp_metadata.json#tools.chat.remove_text_emotion",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The four reviewed conversation locator flags are aliases for one openConversationId property; the typed require-one-of constraint owns their conditional requirement."
} }
] ]
}, },
@@ -27814,7 +27735,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"internal/cli/schema_mcp_metadata.json#tools.chat.remove_text_emotion", "internal/cli/schema_mcp_metadata.json#tools.chat.remove_text_emotion",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
], ],
@@ -30604,13 +30524,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/chat.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Ported from dws-wukong commits d6831318 and bcf56ccf, merged at 30f13f02. The four conversation locators alias one property; the other six business parameters are required by Cobra before the single im/update_text_emotion call."
} }
] ]
}, },
@@ -30660,7 +30573,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
], ],
"use_when": [ "use_when": [
@@ -30864,11 +30776,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/chat.json", "source": "internal/cli/schema_mcp_metadata.json#tools.chat.update_notification_off",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed locator aliases feed one openConversationId property, while optional --off selects unmute; typed constraints require one locator without making the mode switch mandatory."
} }
] ]
}, },
@@ -30921,7 +30832,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"internal/cli/schema_mcp_metadata.json#tools.chat.update_notification_off", "internal/cli/schema_mcp_metadata.json#tools.chat.update_notification_off",
"skills/mono/references/intent-guide.md", "skills/mono/references/intent-guide.md",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
@@ -31677,11 +31587,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/chat.json", "source": "internal/cli/schema_mcp_metadata.json#tools.chat.set_top_conversation",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed optional --off switch selects unpin; omission deliberately selects pin, so false is a valid default rather than missing required input."
} }
] ]
}, },
@@ -31734,7 +31643,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/chat.json",
"internal/cli/schema_mcp_metadata.json#tools.chat.set_top_conversation", "internal/cli/schema_mcp_metadata.json#tools.chat.set_top_conversation",
"skills/mono/references/intent-guide.md", "skills/mono/references/intent-guide.md",
"skills/mono/references/products/chat.md" "skills/mono/references/products/chat.md"
internal/cli/schema_agent_metadata/contact.json
+4 -70
View File
@@ -3316,13 +3316,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/contact.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed Wukong-compatible handler requires enterprise display name and login ID, maps optional contact fields and department IDs, and calls exclusive_account_create without a runtime confirmation gate."
} }
] ]
}, },
@@ -3372,7 +3365,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/contact.json",
"skills/mono/references/products/contact.md" "skills/mono/references/products/contact.md"
], ],
"use_when": [ "use_when": [
@@ -3572,13 +3564,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/contact.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler requires one enterprise-account user ID plus at least one profile or organization update field, confirms, then invokes exclusive_account_user_update."
} }
] ]
}, },
@@ -3628,7 +3613,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/contact.json",
"skills/mono/references/products/contact.md" "skills/mono/references/products/contact.md"
], ],
"use_when": [ "use_when": [
@@ -3828,13 +3812,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/contact.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler requires one department-name spelling and an explicit boolean group choice, optionally parses a parent department ID, confirms, then invokes department_create."
} }
] ]
}, },
@@ -3884,7 +3861,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/contact.json",
"skills/mono/references/products/contact.md" "skills/mono/references/products/contact.md"
], ],
"use_when": [ "use_when": [
@@ -5130,13 +5106,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/contact.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler requires one department-ID spelling and one department-name spelling, optionally parses a parent ID, confirms, then invokes department_update."
} }
] ]
}, },
@@ -5186,7 +5155,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/contact.json",
"skills/mono/references/products/contact.md" "skills/mono/references/products/contact.md"
], ],
"use_when": [ "use_when": [
@@ -5386,13 +5354,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/contact.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed Wukong-compatible handler requires an organization name and creator display name and calls org_create without a runtime confirmation gate."
} }
] ]
}, },
@@ -5442,7 +5403,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/contact.json",
"skills/mono/references/products/contact.md" "skills/mono/references/products/contact.md"
], ],
"use_when": [ "use_when": [
@@ -6674,13 +6634,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/contact.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed Wukong-compatible handler requires employee name and mobile, decodes optional --depts JSON to an array, and calls add_employee without a runtime confirmation gate."
} }
] ]
}, },
@@ -6724,7 +6677,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/contact.json",
"skills/mono/references/products/contact.md" "skills/mono/references/products/contact.md"
], ],
"use_when": [ "use_when": [
@@ -7191,11 +7143,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/contact.json", "source": "internal/cli/schema_mcp_metadata.json#tools.contact.get_authorized_emp_rosterInfo",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed helper deliberately permits either or both optional filters and passes an empty request to query the caller's authorized roster scope."
} }
] ]
}, },
@@ -7248,7 +7199,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/contact.json",
"internal/cli/schema_mcp_metadata.json#tools.contact.get_authorized_emp_rosterInfo", "internal/cli/schema_mcp_metadata.json#tools.contact.get_authorized_emp_rosterInfo",
"skills/mono/references/products/contact.md" "skills/mono/references/products/contact.md"
], ],
@@ -7980,13 +7930,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/contact.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler requires one employee-ID spelling plus at least one update field, decodes optional department JSON, confirms, then invokes employee_update."
} }
] ]
}, },
@@ -8036,7 +7979,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/contact.json",
"skills/mono/references/products/contact.md" "skills/mono/references/products/contact.md"
], ],
"use_when": [ "use_when": [
@@ -8236,13 +8178,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/contact.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler requires at least one of nickname or avatar file ID, confirms, then invokes self_user_profile_update for the current user."
} }
] ]
}, },
@@ -8292,7 +8227,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/contact.json",
"skills/mono/references/products/contact.md" "skills/mono/references/products/contact.md"
], ],
"use_when": [ "use_when": [
internal/cli/schema_agent_metadata/devdoc.json
-8
View File
@@ -208,13 +208,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/devdoc.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Search text may be supplied as positional keyword or public --query; hidden --keyword remains a runtime compatibility alias and is intentionally not published as a parameter. The versioned binding owns query -\u003e keyword."
} }
] ]
}, },
@@ -269,7 +262,6 @@
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.devdoc.prod.json#devdoc.search_open_platform_docs", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.devdoc.prod.json#devdoc.search_open_platform_docs",
"internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/imported/wukong.json",
"internal/cli/schema_hints/metadata/devdoc.json",
"internal/cli/schema_mcp_metadata.json#tools.devdoc.search_open_platform_docs_rag", "internal/cli/schema_mcp_metadata.json#tools.devdoc.search_open_platform_docs_rag",
"skills/mono/references/products/devdoc.md", "skills/mono/references/products/devdoc.md",
"skills/mono/references/products/simple.md" "skills/mono/references/products/simple.md"
internal/cli/schema_agent_metadata/doc.json
-32
View File
@@ -5106,13 +5106,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/doc.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler normalizes repeated or comma-separated group conversation IDs into a stable de-duplicated array while preserving existing user mentions."
} }
] ]
}, },
@@ -5167,7 +5160,6 @@
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_comment", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_comment",
"internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/imported/wukong.json",
"internal/cli/schema_hints/metadata/doc.json",
"internal/cli/schema_mcp_metadata.json#tools.doc.create_comment", "internal/cli/schema_mcp_metadata.json#tools.doc.create_comment",
"skills/mono/references/products/doc.md", "skills/mono/references/products/doc.md",
"skills/mono/references/products/doc/doc-comment.md" "skills/mono/references/products/doc/doc-comment.md"
@@ -6168,13 +6160,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/doc.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler normalizes group conversation IDs into a stable de-duplicated array and rejects group mentions for emoji replies, which the remote operation does not support."
} }
] ]
}, },
@@ -6229,7 +6214,6 @@
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.reply_comment", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.reply_comment",
"internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/imported/wukong.json",
"internal/cli/schema_hints/metadata/doc.json",
"internal/cli/schema_mcp_metadata.json#tools.doc.reply_comment", "internal/cli/schema_mcp_metadata.json#tools.doc.reply_comment",
"skills/mono/references/products/doc.md", "skills/mono/references/products/doc.md",
"skills/mono/references/products/doc/doc-comment.md" "skills/mono/references/products/doc/doc-comment.md"
@@ -6434,13 +6418,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/doc.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Preserve the reviewed user-mention conversion and normalize repeated or comma-separated group conversation IDs into mentionedOpenConversationIds."
} }
] ]
}, },
@@ -6490,7 +6467,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/doc.json",
"skills/mono/references/products/doc.md", "skills/mono/references/products/doc.md",
"skills/mono/references/products/doc/doc-comment.md" "skills/mono/references/products/doc/doc-comment.md"
], ],
@@ -11123,13 +11099,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/doc.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler preserves full Markdown/JSONML reads and adds validated outline, range, section, and tag-scoped JSONML fragment reads with optional file output."
} }
] ]
}, },
@@ -11188,7 +11157,6 @@
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.get_document_content", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.get_document_content",
"internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/imported/wukong.json",
"internal/cli/schema_hints/metadata/doc.json",
"internal/cli/schema_mcp_metadata.json#tools.doc.get_document_content", "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_content",
"skills/mono/references/products/doc.md", "skills/mono/references/products/doc.md",
"skills/mono/references/products/doc/doc-read.md", "skills/mono/references/products/doc/doc-read.md",
internal/cli/schema_agent_metadata/drive.json
+4 -14
View File
@@ -7899,11 +7899,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/drive.json", "source": "internal/cli/schema_mcp_metadata.json#tools.drive.rename_document",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed CLI reads node metadata before mutation and strips only the exact current extension for non-folder nodes, avoiding both duplicate extensions and dotted-folder corruption without a suffix whitelist."
} }
] ]
}, },
@@ -7956,7 +7955,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/drive.json",
"internal/cli/schema_mcp_metadata.json#tools.drive.rename_document", "internal/cli/schema_mcp_metadata.json#tools.drive.rename_document",
"skills/mono/references/products/drive.md" "skills/mono/references/products/drive.md"
], ],
@@ -9823,13 +9821,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/drive.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied."
} }
] ]
}, },
@@ -9883,7 +9874,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/drive.json",
"skills/mono/references/intent-guide.md", "skills/mono/references/intent-guide.md",
"skills/mono/references/products/drive.md" "skills/mono/references/products/drive.md"
], ],
internal/cli/schema_agent_metadata/hrbrain.json
-80
View File
@@ -176,13 +176,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/hrbrain.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Reviewed unpinned remote adapter: --work-no maps 1:1 to the workNo MCP call argument observed in internal/helpers/hrbrain.go."
} }
] ]
}, },
@@ -226,7 +219,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/hrbrain.json",
"skills/mono/references/products/hrbrain.md" "skills/mono/references/products/hrbrain.md"
], ],
"use_when": [ "use_when": [
@@ -408,13 +400,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/hrbrain.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Reviewed unpinned remote adapter: flags map 1:1 to the get_profile_label MCP call arguments observed in internal/helpers/hrbrain.go."
} }
] ]
}, },
@@ -458,7 +443,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/hrbrain.json",
"skills/mono/references/products/hrbrain.md" "skills/mono/references/products/hrbrain.md"
], ],
"use_when": [ "use_when": [
@@ -640,13 +624,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/hrbrain.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Reviewed unpinned remote adapter: --work-no maps 1:1 to the workNo MCP call argument observed in internal/helpers/hrbrain.go."
} }
] ]
}, },
@@ -690,7 +667,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/hrbrain.json",
"skills/mono/references/products/hrbrain.md" "skills/mono/references/products/hrbrain.md"
], ],
"use_when": [ "use_when": [
@@ -872,13 +848,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/hrbrain.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Reviewed unpinned remote adapter: --work-no maps 1:1 to the workNo MCP call argument observed in internal/helpers/hrbrain.go."
} }
] ]
}, },
@@ -922,7 +891,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/hrbrain.json",
"skills/mono/references/products/hrbrain.md" "skills/mono/references/products/hrbrain.md"
], ],
"use_when": [ "use_when": [
@@ -1125,13 +1093,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/hrbrain.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Reviewed unpinned remote adapter: flags map 1:1 to the query_profile_data MCP call arguments observed in internal/helpers/hrbrain.go."
} }
] ]
}, },
@@ -1181,7 +1142,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/hrbrain.json",
"skills/mono/references/products/hrbrain.md" "skills/mono/references/products/hrbrain.md"
], ],
"use_when": [ "use_when": [
@@ -1387,13 +1347,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/hrbrain.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Reviewed unpinned remote adapter: flags map 1:1 to the search_employees MCP call arguments observed in internal/helpers/hrbrain.go."
} }
] ]
}, },
@@ -1443,7 +1396,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/hrbrain.json",
"skills/mono/references/products/hrbrain.md" "skills/mono/references/products/hrbrain.md"
], ],
"use_when": [ "use_when": [
@@ -1646,13 +1598,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/hrbrain.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Reviewed unpinned remote adapter: flags map 1:1 to the search_employees_structured MCP call arguments observed in internal/helpers/hrbrain.go."
} }
] ]
}, },
@@ -1702,7 +1647,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/hrbrain.json",
"skills/mono/references/products/hrbrain.md" "skills/mono/references/products/hrbrain.md"
], ],
"use_when": [ "use_when": [
@@ -2150,13 +2094,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/hrbrain.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Reviewed unpinned remote adapter: --pool-code maps 1:1 to the poolCode MCP call argument observed in internal/helpers/hrbrain.go."
} }
] ]
}, },
@@ -2206,7 +2143,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/hrbrain.json",
"skills/mono/references/products/hrbrain.md" "skills/mono/references/products/hrbrain.md"
], ],
"use_when": [ "use_when": [
@@ -2391,13 +2327,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/hrbrain.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Reviewed unpinned remote adapter: flags map 1:1 to the list_pool_employees MCP call arguments observed in internal/helpers/hrbrain.go."
} }
] ]
}, },
@@ -2441,7 +2370,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/hrbrain.json",
"skills/mono/references/products/hrbrain.md" "skills/mono/references/products/hrbrain.md"
], ],
"use_when": [ "use_when": [
@@ -2647,13 +2575,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/hrbrain.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Reviewed unpinned remote adapter: flags map 1:1 to the list_talent_pools MCP call arguments observed in internal/helpers/hrbrain.go."
} }
] ]
}, },
@@ -2703,7 +2624,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/hrbrain.json",
"skills/mono/references/products/hrbrain.md" "skills/mono/references/products/hrbrain.md"
], ],
"use_when": [ "use_when": [
internal/cli/schema_agent_metadata/index.json
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"version": 1, "version": 1,
"source_hash": "sha256:a4622e8ac2ad1f65bae1a9e2487001dfae751f8c70ce45630dcb9a1b12e167ed", "source_hash": "sha256:5397ea46c3681d39d4532dc18145e6b73d6900472cf6a88faa703d477b078ecb",
"surface_hash": "sha256:60eee8e2f37d6d9d60689efce85082798eb9ad38b7ba7c0b471c3de676a85a16", "surface_hash": "sha256:60eee8e2f37d6d9d60689efce85082798eb9ad38b7ba7c0b471c3de676a85a16",
"coverage": { "coverage": {
"surface_products": 26, "surface_products": 26,
internal/cli/schema_agent_metadata/mail.json
+8 -20
View File
@@ -7140,13 +7140,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/mail.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query."
} }
] ]
}, },
@@ -7196,7 +7189,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/mail.json",
"skills/mono/references/products/mail.md" "skills/mono/references/products/mail.md"
], ],
"use_when": [ "use_when": [
@@ -9752,11 +9744,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/mail.json", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_message_template",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement."
} }
] ]
}, },
@@ -9809,7 +9800,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/mail.json",
"internal/cli/schema_mcp_metadata.json#tools.mail.update_user_message_template", "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_message_template",
"skills/mono/references/products/mail.md" "skills/mono/references/products/mail.md"
], ],
@@ -10276,11 +10266,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/mail.json", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.search_mail_users",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements."
} }
] ]
}, },
@@ -10333,7 +10322,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/mail.json",
"internal/cli/schema_mcp_metadata.json#tools.mail.search_mail_users", "internal/cli/schema_mcp_metadata.json#tools.mail.search_mail_users",
"skills/mono/references/products/mail.md" "skills/mono/references/products/mail.md"
], ],
internal/cli/schema_agent_metadata/markdown.json
-32
View File
@@ -194,13 +194,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/markdown.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed workflow requires exactly one content source, requires an .md name for literal content, keeps workspace and Drive space mutually exclusive, and routes the upload without a confirmation gate."
} }
] ]
}, },
@@ -250,7 +243,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/markdown.json",
"skills/mono/references/products/markdown.md" "skills/mono/references/products/markdown.md"
], ],
"use_when": [ "use_when": [
@@ -432,13 +424,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/markdown.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed workflow requires one node locator, keeps explicit Drive and Doc routes mutually exclusive, treats remote content as untrusted data, and protects local output paths."
} }
] ]
}, },
@@ -482,7 +467,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/markdown.json",
"skills/mono/references/products/markdown.md" "skills/mono/references/products/markdown.md"
], ],
"use_when": [ "use_when": [
@@ -664,13 +648,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/markdown.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed workflow requires a target and exactly one content source, supports a command-owned diff preview, and confirms before replacing the remote file."
} }
] ]
}, },
@@ -714,7 +691,6 @@
"risk": "high", "risk": "high",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/markdown.json",
"skills/mono/references/products/markdown.md" "skills/mono/references/products/markdown.md"
], ],
"use_when": [ "use_when": [
@@ -896,13 +872,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/markdown.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed workflow requires a target, pattern, and replacement; it blocks zero-hit and empty-result writes, supports a command-owned diff preview, and confirms before reupload."
} }
] ]
}, },
@@ -946,7 +915,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/markdown.json",
"skills/mono/references/products/markdown.md" "skills/mono/references/products/markdown.md"
], ],
"use_when": [ "use_when": [
internal/cli/schema_agent_metadata/minutes.json
+1 -9
View File
@@ -1297,13 +1297,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/minutes.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate, composite interface, and the custom --pair format/uniqueness validation without inventing a direct MCP identity."
} }
] ]
}, },
@@ -1346,8 +1339,7 @@
"reviewed": true, "reviewed": true,
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl"
"internal/cli/schema_hints/metadata/minutes.json"
], ],
"use_when": [ "use_when": [
"当你要在同一条听记里一次性纠正多个词（如把多个错识别的人名/术语统一替换），而底层工具一次只能替换一组时使用；内部按多个 --pair \"原文=\u003e替换\" 逐组调用替换工具，先在本地校验去重（同一个「原文」不能出现两次，避免两条规则互相打架），再逐组应用并聚合每组的成功/失败结果，某一组失败不会中断其余组。这是写操作，会实际修改听记文字内容，请确认 taskUuid 与替换规则无误。" "当你要在同一条听记里一次性纠正多个词（如把多个错识别的人名/术语统一替换），而底层工具一次只能替换一组时使用；内部按多个 --pair \"原文=\u003e替换\" 逐组调用替换工具，先在本地校验去重（同一个「原文」不能出现两次，避免两条规则互相打架），再逐组应用并聚合每组的成功/失败结果，某一组失败不会中断其余组。这是写操作，会实际修改听记文字内容，请确认 taskUuid 与替换规则无误。"
internal/cli/schema_agent_metadata/report.json
-8
View File
@@ -1193,13 +1193,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/report.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed optional --to-chat switch defaults to false and only controls post-submit delivery; it is not required to create a report."
} }
] ]
}, },
@@ -1254,7 +1247,6 @@
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.report.prod.json#report.create_report", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.report.prod.json#report.create_report",
"internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/imported/wukong.json",
"internal/cli/schema_hints/metadata/report.json",
"internal/cli/schema_mcp_metadata.json#tools.report.create_report", "internal/cli/schema_mcp_metadata.json#tools.report.create_report",
"skills/mono/references/products/report.md" "skills/mono/references/products/report.md"
], ],
internal/cli/schema_agent_metadata/sheet.json
-24
View File
@@ -15055,13 +15055,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/sheet.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Preserve the reviewed CLI-to-interface conversion: --properties accepts inline JSON or @file text and is validated and decoded to the create_pivot_table properties object."
} }
] ]
}, },
@@ -15111,7 +15104,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/sheet.json",
"skills/mono/references/products/sheet/sheet-pivot-table.md" "skills/mono/references/products/sheet/sheet-pivot-table.md"
], ],
"use_when": [ "use_when": [
@@ -15807,13 +15799,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/sheet.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Preserve the reviewed CLI-to-interface conversion: --properties accepts inline JSON or @file text and is validated and decoded to the update_pivot_table properties object."
} }
] ]
}, },
@@ -15863,7 +15848,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/sheet.json",
"skills/mono/references/products/sheet/sheet-pivot-table.md" "skills/mono/references/products/sheet/sheet-pivot-table.md"
], ],
"use_when": [ "use_when": [
@@ -19692,13 +19676,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/sheet.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "Preserve the reviewed CLI-to-interface conversion: --sheets accepts inline JSON, @file, or stdin and is normalized to the table_put sheets array."
} }
] ]
}, },
@@ -19748,7 +19725,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/sheet.json",
"skills/mono/references/products/sheet/sheet-write-data.md" "skills/mono/references/products/sheet/sheet-write-data.md"
], ],
"use_when": [ "use_when": [
internal/cli/schema_agent_metadata/todo.json
+8 -44
View File
@@ -3445,13 +3445,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/todo.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler requires a task ID and at least one non-empty tag code before invoking tag_todo."
} }
] ]
}, },
@@ -3501,7 +3494,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/todo.json",
"skills/mono/references/products/todo.md" "skills/mono/references/products/todo.md"
], ],
"use_when": [ "use_when": [
@@ -3701,13 +3693,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/todo.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler requires a non-blank tag name, builds a one-element userTags request, and invokes create_todo_tag without a runtime confirmation gate."
} }
] ]
}, },
@@ -3757,7 +3742,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/todo.json",
"skills/mono/references/products/todo.md" "skills/mono/references/products/todo.md"
], ],
"use_when": [ "use_when": [
@@ -3957,13 +3941,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/todo.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler requires at least one non-empty tag code, permits caller-authoritative dry-run, and requires explicit --yes before invoking delete_todo_tag."
} }
] ]
}, },
@@ -4013,7 +3990,6 @@
"risk": "high", "risk": "high",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/todo.json",
"skills/mono/references/products/todo.md" "skills/mono/references/products/todo.md"
], ],
"use_when": [ "use_when": [
@@ -4461,13 +4437,6 @@
"source": "corecmd.contract", "source": "corecmd.contract",
"precedence": "contract_final", "precedence": "contract_final",
"selected": true "selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/todo.json",
"precedence": "reviewed_explicit",
"selected": false,
"review_reason": "The reviewed handler requires a non-null JSON array of tag update records and invokes update_todo_tag without a runtime confirmation gate."
} }
] ]
}, },
@@ -4517,7 +4486,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/todo.json",
"skills/mono/references/products/todo.md" "skills/mono/references/products/todo.md"
], ],
"use_when": [ "use_when": [
@@ -7153,11 +7121,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/todo.json", "source": "internal/cli/schema_mcp_metadata.json#tools.todo.get_user_todos_in_current_org",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed handler defaults omitted role-types to executor, preserves current-organization behavior by default, and switches both single-page and auto-page calls to get_user_todos only when --query-all is explicitly true."
} }
] ]
}, },
@@ -7210,7 +7177,6 @@
"risk": "low", "risk": "low",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/todo.json",
"internal/cli/schema_mcp_metadata.json#tools.todo.get_user_todos_in_current_org", "internal/cli/schema_mcp_metadata.json#tools.todo.get_user_todos_in_current_org",
"skills/mono/references/products/todo.md" "skills/mono/references/products/todo.md"
], ],
@@ -8210,11 +8176,10 @@
"selected": true "selected": true
}, },
{ {
"value": true, "value": false,
"source": "internal/cli/schema_hints/metadata/todo.json", "source": "internal/cli/schema_mcp_metadata.json#tools.todo.reset_todo_reminder",
"precedence": "reviewed_explicit", "precedence": "mcp_fallback",
"selected": false, "selected": false
"review_reason": "The reviewed CLI rejects malformed or structurally invalid non-empty reminder rules before the reset mutation, while preserving omission and [] as explicit clear forms."
} }
] ]
}, },
@@ -8267,7 +8232,6 @@
"risk": "medium", "risk": "medium",
"source_refs": [ "source_refs": [
"corecmd.SchemaDecl", "corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/todo.json",
"internal/cli/schema_mcp_metadata.json#tools.todo.reset_todo_reminder", "internal/cli/schema_mcp_metadata.json#tools.todo.reset_todo_reminder",
"skills/mono/references/products/todo.md" "skills/mono/references/products/todo.md"
], ],
internal/cli/schema_agent_metadata_audit.json
+4 -4
View File
@@ -1,11 +1,11 @@
{ {
"version": 1, "version": 1,
"source_hash": "sha256:a4622e8ac2ad1f65bae1a9e2487001dfae751f8c70ce45630dcb9a1b12e167ed", "source_hash": "sha256:5397ea46c3681d39d4532dc18145e6b73d6900472cf6a88faa703d477b078ecb",
"surface_hash": "sha256:60eee8e2f37d6d9d60689efce85082798eb9ad38b7ba7c0b471c3de676a85a16", "surface_hash": "sha256:60eee8e2f37d6d9d60689efce85082798eb9ad38b7ba7c0b471c3de676a85a16",
"source_files": 160, "source_files": 134,
"hint_files": 54, "hint_files": 28,
"hint_products": 43, "hint_products": 43,
"hint_tools": 221, "hint_tools": 147,
"interface_metadata": { "interface_metadata": {
"source": "mcp-tools-list+cli-registry", "source": "mcp-tools-list+cli-registry",
"revision": "4574f7022c32cf4c033e9b7b4156e2fec815fed8", "revision": "4574f7022c32cf4c033e9b7b4156e2fec815fed8",
internal/cli/schema_catalog/catalog.json
+2 -2
View File
@@ -1,12 +1,12 @@
{ {
"version": 1, "version": 1,
"surface_hash": "sha256:60eee8e2f37d6d9d60689efce85082798eb9ad38b7ba7c0b471c3de676a85a16", "surface_hash": "sha256:60eee8e2f37d6d9d60689efce85082798eb9ad38b7ba7c0b471c3de676a85a16",
"source_hash": "sha256:26f44334e2182ab20b691e9e6b6221288d4ff9a3c9e13e436b4b52a98eae70b8", "source_hash": "sha256:391e859404a4ff80a0d05bc35f4aa0ba8d90ffcf82b0ec5648356e7c33be0ef0",
"catalog": { "catalog": {
"agent_metadata": { "agent_metadata": {
"products_with_metadata": 26, "products_with_metadata": 26,
"source": "embedded-skill-metadata", "source": "embedded-skill-metadata",
"source_hash": "sha256:a4622e8ac2ad1f65bae1a9e2487001dfae751f8c70ce45630dcb9a1b12e167ed", "source_hash": "sha256:5397ea46c3681d39d4532dc18145e6b73d6900472cf6a88faa703d477b078ecb",
"surface_hash": "sha256:60eee8e2f37d6d9d60689efce85082798eb9ad38b7ba7c0b471c3de676a85a16", "surface_hash": "sha256:60eee8e2f37d6d9d60689efce85082798eb9ad38b7ba7c0b471c3de676a85a16",
"surface_products": 26, "surface_products": 26,
"surface_tools": 845, "surface_tools": 845,
internal/cli/schema_catalog/tools/aitable.json
+58 -133
View File
@@ -5015,12 +5015,6 @@
"source": "native_annotation", "source": "native_annotation",
"value": true "value": true
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": true
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -14336,12 +14330,6 @@
"source": "native_annotation", "source": "native_annotation",
"value": true "value": true
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": true
},
{ {
"precedence": "inference", "precedence": "inference",
"selected": false, "selected": false,
@@ -17119,9 +17107,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -17131,9 +17119,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -20529,9 +20517,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -20541,9 +20529,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -22425,8 +22413,14 @@
"interface_type": { "interface_type": {
"candidates": [ "candidates": [
{ {
"precedence": "mcp_metadata", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "native_annotation",
"value": "array"
},
{
"precedence": "mcp_metadata",
"selected": false,
"source": "mcp_metadata", "source": "mcp_metadata",
"value": "array" "value": "array"
}, },
@@ -22437,9 +22431,9 @@
"value": "string" "value": "string"
} }
], ],
"precedence": "mcp_metadata", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "mcp_metadata", "source": "native_annotation",
"value": "array" "value": "array"
}, },
"property": { "property": {
@@ -22459,9 +22453,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -22477,9 +22471,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -26548,12 +26542,6 @@
"source": "require_one_of_constraint", "source": "require_one_of_constraint",
"value": false "value": false
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": true
},
{ {
"precedence": "default", "precedence": "default",
"selected": false, "selected": false,
@@ -32371,6 +32359,26 @@
"source": "cobra_usage", "source": "cobra_usage",
"value": "待新增字段列表 JSON 数组，至少包含 1 个字段，单次最多 15 个。系统会按数组顺序依次创建，返回结果顺序与入参保持一致，并逐项标明成功/失败状态。若是单个字段可直接使用 --name/--type/--config" "value": "待新增字段列表 JSON 数组，至少包含 1 个字段，单次最多 15 个。系统会按数组顺序依次创建，返回结果顺序与入参保持一致，并逐项标明成功/失败状态。若是单个字段可直接使用 --name/--type/--config"
}, },
"interface_type": {
"candidates": [
{
"precedence": "native_annotation",
"selected": true,
"source": "native_annotation",
"value": "array"
},
{
"precedence": "fallback",
"selected": false,
"source": "cobra_flag_type",
"value": "string"
}
],
"precedence": "native_annotation",
"resolution": "highest_precedence",
"source": "native_annotation",
"value": "array"
},
"property": { "property": {
"candidates": [ "candidates": [
{ {
@@ -32388,16 +32396,22 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "default", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "native_annotation",
"value": true
},
{
"precedence": "default",
"selected": false,
"source": "default", "source": "default",
"value": false "value": false
} }
], ],
"precedence": "default", "precedence": "native_annotation",
"resolution": "fallback", "resolution": "highest_precedence",
"source": "default", "source": "native_annotation",
"value": false "value": true
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
@@ -32428,8 +32442,9 @@
"value": "string" "value": "string"
} }
}, },
"interface_type": "array",
"property": "fields", "property": "fields",
"required": false, "required": true,
"type": "string" "type": "string"
}, },
"name": { "name": {
@@ -38807,12 +38822,6 @@
"source": "cobra_usage", "source": "cobra_usage",
"value": "Base ID（通过 base list / base search 获取）(必填)" "value": "Base ID（通过 base list / base search 获取）(必填)"
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "Base ID。"
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -39007,12 +39016,6 @@
"source": "cobra_usage", "source": "cobra_usage",
"value": "指定要返回的字段 ID 列表，逗号分隔。省略则返回所有字段。建议在字段较多时按需传入，可显著减少响应体积；单次最多 100 个" "value": "指定要返回的字段 ID 列表，逗号分隔。省略则返回所有字段。建议在字段较多时按需传入，可显著减少响应体积；单次最多 100 个"
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "Field ID 列表，CLI 使用逗号分隔。"
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -39039,12 +39042,6 @@
"source": "native_annotation", "source": "native_annotation",
"value": "array" "value": "array"
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "array"
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -39143,12 +39140,6 @@
"source": "cobra_usage", "source": "cobra_usage",
"value": "结构化过滤条件 JSON，不传则返回全部记录（受 limit 限制）" "value": "结构化过滤条件 JSON，不传则返回全部记录（受 limit 限制）"
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "过滤条件 JSON。"
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -39175,12 +39166,6 @@
"source": "native_annotation", "source": "native_annotation",
"value": "object" "value": "object"
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "object"
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -39598,12 +39583,6 @@
"source": "cobra_usage", "source": "cobra_usage",
"value": "指定要获取的记录 ID 列表，逗号分隔，单次最多 100 个。传入时按 ID 返回，忽略 filters 和 sort。适用于已知 recordId（如关联字段中的 linkedRecordIds）时的精准取数" "value": "指定要获取的记录 ID 列表，逗号分隔，单次最多 100 个。传入时按 ID 返回，忽略 filters 和 sort。适用于已知 recordId（如关联字段中的 linkedRecordIds）时的精准取数"
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "Record ID 列表，CLI 使用逗号分隔。"
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -39630,12 +39609,6 @@
"source": "native_annotation", "source": "native_annotation",
"value": "array" "value": "array"
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "array"
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -39740,12 +39713,6 @@
"source": "cobra_usage", "source": "cobra_usage",
"value": "排序条件 JSON 数组，按数组顺序依次生效" "value": "排序条件 JSON 数组，按数组顺序依次生效"
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "排序 JSON 数组。"
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -39772,12 +39739,6 @@
"source": "native_annotation", "source": "native_annotation",
"value": "array" "value": "array"
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "array"
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -39876,12 +39837,6 @@
"source": "cobra_usage", "source": "cobra_usage",
"value": "Table ID（通过 base get 获取）(必填)" "value": "Table ID（通过 base get 获取）(必填)"
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "Table ID。"
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -48167,12 +48122,6 @@
"source": "native_annotation", "source": "native_annotation",
"value": true "value": true
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": true
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -87728,12 +87677,6 @@
"source": "native_annotation", "source": "native_annotation",
"value": false "value": false
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": true
},
{ {
"precedence": "default", "precedence": "default",
"selected": false, "selected": false,
@@ -89017,12 +88960,6 @@
"source": "native_annotation", "source": "native_annotation",
"value": false "value": false
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": true
},
{ {
"precedence": "default", "precedence": "default",
"selected": false, "selected": false,
@@ -89989,12 +89926,6 @@
"source": "native_annotation", "source": "native_annotation",
"value": false "value": false
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": true
},
{ {
"precedence": "default", "precedence": "default",
"selected": false, "selected": false,
@@ -96707,12 +96638,6 @@
"source": "native_annotation", "source": "native_annotation",
"value": false "value": false
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": true
},
{ {
"precedence": "default", "precedence": "default",
"selected": false, "selected": false,
@@ -97756,9 +97681,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -97768,9 +97693,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
internal/cli/schema_catalog/tools/attendance.json
+44 -44
View File
@@ -2878,9 +2878,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -2902,9 +2902,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -3035,9 +3035,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -3059,9 +3059,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -3132,9 +3132,9 @@
"interface_type": { "interface_type": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "array" "value": "array"
}, },
{ {
@@ -3150,9 +3150,9 @@
"value": "string" "value": "string"
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "array" "value": "array"
}, },
"property": { "property": {
@@ -3178,9 +3178,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -3202,9 +3202,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -3753,9 +3753,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -3765,9 +3765,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -9850,9 +9850,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -9868,9 +9868,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -9953,9 +9953,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -9971,9 +9971,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -10056,9 +10056,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -10074,9 +10074,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -10544,9 +10544,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -10568,9 +10568,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -10660,9 +10660,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -10684,9 +10684,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -19976,9 +19976,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -20000,9 +20000,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
internal/cli/schema_catalog/tools/calendar.json
+140 -146
View File
@@ -2973,9 +2973,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -2997,9 +2997,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -3389,9 +3389,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -3401,17 +3401,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-range-type is numbered" "value": "recurrence-range-type is numbered"
}, },
{ {
@@ -3421,9 +3421,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-range-type is numbered" "value": "recurrence-range-type is numbered"
}, },
"type": { "type": {
@@ -3492,9 +3492,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -3504,17 +3504,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-type is absoluteMonthly or absoluteYearly" "value": "recurrence-type is absoluteMonthly or absoluteYearly"
}, },
{ {
@@ -3524,9 +3524,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-type is absoluteMonthly or absoluteYearly" "value": "recurrence-type is absoluteMonthly or absoluteYearly"
}, },
"type": { "type": {
@@ -3595,9 +3595,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -3607,17 +3607,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-type is weekly or relativeMonthly" "value": "recurrence-type is weekly or relativeMonthly"
}, },
{ {
@@ -3627,9 +3627,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-type is weekly or relativeMonthly" "value": "recurrence-type is weekly or relativeMonthly"
}, },
"type": { "type": {
@@ -3718,9 +3718,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -3730,17 +3730,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-range-type is endDate" "value": "recurrence-range-type is endDate"
}, },
{ {
@@ -3750,9 +3750,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-range-type is endDate" "value": "recurrence-range-type is endDate"
}, },
"type": { "type": {
@@ -3918,9 +3918,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -3930,17 +3930,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-type is relativeMonthly" "value": "recurrence-type is relativeMonthly"
}, },
{ {
@@ -3950,9 +3950,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-type is relativeMonthly" "value": "recurrence-type is relativeMonthly"
}, },
"type": { "type": {
@@ -4021,9 +4021,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -4039,17 +4039,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "any recurrence-* flag is provided" "value": "any recurrence-* flag is provided"
}, },
{ {
@@ -4059,9 +4059,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "any recurrence-* flag is provided" "value": "any recurrence-* flag is provided"
}, },
"type": { "type": {
@@ -4130,9 +4130,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -4148,17 +4148,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "any recurrence-* flag is provided" "value": "any recurrence-* flag is provided"
}, },
{ {
@@ -4168,9 +4168,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "any recurrence-* flag is provided" "value": "any recurrence-* flag is provided"
}, },
"type": { "type": {
@@ -4239,9 +4239,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -4257,17 +4257,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "any recurrence-* flag is provided" "value": "any recurrence-* flag is provided"
}, },
{ {
@@ -4277,9 +4277,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "any recurrence-* flag is provided" "value": "any recurrence-* flag is provided"
}, },
"type": { "type": {
@@ -4713,9 +4713,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -4737,9 +4737,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -4932,9 +4932,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -4956,9 +4956,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -12876,12 +12876,6 @@
"source": "require_one_of_constraint", "source": "require_one_of_constraint",
"value": false "value": false
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": true
},
{ {
"precedence": "default", "precedence": "default",
"selected": false, "selected": false,
@@ -26708,9 +26702,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -26720,17 +26714,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-range-type is numbered" "value": "recurrence-range-type is numbered"
}, },
{ {
@@ -26740,9 +26734,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-range-type is numbered" "value": "recurrence-range-type is numbered"
}, },
"type": { "type": {
@@ -26811,9 +26805,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -26823,17 +26817,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-type is absoluteMonthly or absoluteYearly" "value": "recurrence-type is absoluteMonthly or absoluteYearly"
}, },
{ {
@@ -26843,9 +26837,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-type is absoluteMonthly or absoluteYearly" "value": "recurrence-type is absoluteMonthly or absoluteYearly"
}, },
"type": { "type": {
@@ -26914,9 +26908,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -26926,17 +26920,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-type is weekly or relativeMonthly" "value": "recurrence-type is weekly or relativeMonthly"
}, },
{ {
@@ -26946,9 +26940,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-type is weekly or relativeMonthly" "value": "recurrence-type is weekly or relativeMonthly"
}, },
"type": { "type": {
@@ -27037,9 +27031,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -27049,17 +27043,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-range-type is endDate" "value": "recurrence-range-type is endDate"
}, },
{ {
@@ -27069,9 +27063,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-range-type is endDate" "value": "recurrence-range-type is endDate"
}, },
"type": { "type": {
@@ -27237,9 +27231,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -27249,17 +27243,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-type is relativeMonthly" "value": "recurrence-type is relativeMonthly"
}, },
{ {
@@ -27269,9 +27263,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "recurrence-type is relativeMonthly" "value": "recurrence-type is relativeMonthly"
}, },
"type": { "type": {
@@ -27340,9 +27334,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -27358,17 +27352,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "any recurrence-* flag is provided" "value": "any recurrence-* flag is provided"
}, },
{ {
@@ -27378,9 +27372,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "any recurrence-* flag is provided" "value": "any recurrence-* flag is provided"
}, },
"type": { "type": {
@@ -27449,9 +27443,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -27467,17 +27461,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "any recurrence-* flag is provided" "value": "any recurrence-* flag is provided"
}, },
{ {
@@ -27487,9 +27481,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "any recurrence-* flag is provided" "value": "any recurrence-* flag is provided"
}, },
"type": { "type": {
@@ -27558,9 +27552,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -27576,17 +27570,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "any recurrence-* flag is provided" "value": "any recurrence-* flag is provided"
}, },
{ {
@@ -27596,9 +27590,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "any recurrence-* flag is provided" "value": "any recurrence-* flag is provided"
}, },
"type": { "type": {
internal/cli/schema_catalog/tools/dev.json
-12
View File
@@ -19744,12 +19744,6 @@
"source": "native_annotation", "source": "native_annotation",
"value": false "value": false
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": true
},
{ {
"precedence": "default", "precedence": "default",
"selected": false, "selected": false,
@@ -24044,12 +24038,6 @@
"source": "native_annotation", "source": "native_annotation",
"value": false "value": false
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": true
},
{ {
"precedence": "default", "precedence": "default",
"selected": false, "selected": false,
internal/cli/schema_catalog/tools/ding.json
+16 -40
View File
@@ -931,12 +931,6 @@
"source": "cobra_usage", "source": "cobra_usage",
"value": "消息内容 (必填)" "value": "消息内容 (必填)"
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "DING 消息内容。"
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -972,9 +966,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -996,9 +990,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -1046,12 +1040,6 @@
"source": "cobra_usage", "source": "cobra_usage",
"value": "机器人 ID，发 DING 的机器人编码 (必填，可从 应用管理→机器人 获取，或设 DINGTALK_DING_ROBOT_CODE)" "value": "机器人 ID，发 DING 的机器人编码 (必填，可从 应用管理→机器人 获取，或设 DINGTALK_DING_ROBOT_CODE)"
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "DING 机器人编码。通常来自开放平台或应用机器人配置。"
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -1087,9 +1075,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -1111,9 +1099,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -1162,12 +1150,6 @@
"source": "cobra_usage", "source": "cobra_usage",
"value": "提醒类型: app/sms/call (默认 app)" "value": "提醒类型: app/sms/call (默认 app)"
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "提醒类型。CLI 默认使用 app，对应应用内提醒。"
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -1298,12 +1280,6 @@
"source": "cobra_usage", "source": "cobra_usage",
"value": "接收人 userId 列表 (必填)" "value": "接收人 userId 列表 (必填)"
}, },
{
"precedence": "tool_schema_hint",
"selected": false,
"source": "tool_schema_hint",
"value": "接收人的 userId 列表。CLI 使用逗号分隔，例如 user1,user2。"
},
{ {
"precedence": "mcp_metadata", "precedence": "mcp_metadata",
"selected": false, "selected": false,
@@ -1325,9 +1301,9 @@
"interface_type": { "interface_type": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "array" "value": "array"
}, },
{ {
@@ -1343,9 +1319,9 @@
"value": "string" "value": "string"
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "array" "value": "array"
}, },
"property": { "property": {
@@ -1371,9 +1347,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -1395,9 +1371,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
internal/cli/schema_catalog/tools/doc.json
+16 -16
View File
@@ -3124,9 +3124,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -3148,9 +3148,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -6794,9 +6794,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -6818,9 +6818,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -9346,9 +9346,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -9370,9 +9370,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -40170,9 +40170,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -40194,9 +40194,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
internal/cli/schema_catalog/tools/drive.json
+21
View File
@@ -12459,6 +12459,26 @@
"source": "cobra_usage", "source": "cobra_usage",
"value": "每页返回数量 (默认 20，最大 50)，仅 spaceType 为 orgSpace 时有效" "value": "每页返回数量 (默认 20，最大 50)，仅 spaceType 为 orgSpace 时有效"
}, },
"interface_type": {
"candidates": [
{
"precedence": "mcp_metadata",
"selected": true,
"source": "mcp_metadata",
"value": "number"
},
{
"precedence": "fallback",
"selected": false,
"source": "cobra_flag_type",
"value": "integer"
}
],
"precedence": "mcp_metadata",
"resolution": "highest_precedence",
"source": "mcp_metadata",
"value": "number"
},
"property": { "property": {
"candidates": [ "candidates": [
{ {
@@ -12529,6 +12549,7 @@
} }
}, },
"interface_description": "每页返回数量，默认 20，最大 50。建议根据实际需求调整，较大的值可以减少请求次数，但会增加单次响应的数据量。仅 spaceType 为 orgSpace 时有效", "interface_description": "每页返回数量，默认 20，最大 50。建议根据实际需求调整，较大的值可以减少请求次数，但会增加单次响应的数据量。仅 spaceType 为 orgSpace 时有效",
"interface_type": "number",
"property": "maxResults", "property": "maxResults",
"required": false, "required": false,
"type": "integer" "type": "integer"
internal/cli/schema_catalog/tools/minutes.json
+4 -4
View File
@@ -5181,9 +5181,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -5205,9 +5205,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
internal/cli/schema_catalog/tools/pat.json
+8 -8
View File
@@ -1112,9 +1112,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
{ {
@@ -1124,17 +1124,17 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": false "value": false
}, },
"required_when": { "required_when": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": "grant-type is session" "value": "grant-type is session"
}, },
{ {
@@ -1144,9 +1144,9 @@
"value": "" "value": ""
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": "grant-type is session" "value": "grant-type is session"
}, },
"type": { "type": {
internal/cli/schema_catalog/tools/sheet.json
+16 -16
View File
@@ -12139,9 +12139,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -12163,9 +12163,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -12254,9 +12254,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -12278,9 +12278,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -13681,9 +13681,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -13705,9 +13705,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -28090,9 +28090,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -28114,9 +28114,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
internal/cli/schema_catalog/tools/wiki.json
+13 -7
View File
@@ -2061,9 +2061,9 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
{ {
@@ -2085,9 +2085,9 @@
"value": false "value": false
} }
], ],
"precedence": "tool_schema_hint", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "tool_schema_hint", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
@@ -3562,8 +3562,14 @@
"required": { "required": {
"candidates": [ "candidates": [
{ {
"precedence": "mcp_metadata", "precedence": "native_annotation",
"selected": true, "selected": true,
"source": "native_annotation",
"value": true
},
{
"precedence": "mcp_metadata",
"selected": false,
"source": "mcp_metadata", "source": "mcp_metadata",
"value": true "value": true
}, },
@@ -3580,9 +3586,9 @@
"value": false "value": false
} }
], ],
"precedence": "mcp_metadata", "precedence": "native_annotation",
"resolution": "highest_precedence", "resolution": "highest_precedence",
"source": "mcp_metadata", "source": "native_annotation",
"value": true "value": true
}, },
"required_when": { "required_when": {
internal/cli/schema_catalog_test.go
+51 -5
View File
@@ -742,7 +742,7 @@ func TestEmbeddedCatalogMinutesReplaceBatchPairDescriptionIsNative(t *testing.T)
} }
func TestEmbeddedCatalogTodoParamDeclsFrom87910880Hints(t *testing.T) { func TestEmbeddedCatalogTodoParamDeclsFrom87910880Hints(t *testing.T) {
// Spot-check former schema_hints/metadata/todo.json overlays (87910880). // Spot-check former metadata/todo.json overlays now declared as ParamDecl (87910880).
// --query-all is a Cobra Bool: merge-base catalog publishes type=boolean from // --query-all is a Cobra Bool: merge-base catalog publishes type=boolean from
// cobra_flag_type (no separate interface_type field), while required/description // cobra_flag_type (no separate interface_type field), while required/description
// stay native_annotation after ParamDecl migration. // stay native_annotation after ParamDecl migration.
@@ -858,7 +858,7 @@ func TestEmbeddedCatalogTodoParamDeclsFrom87910880Hints(t *testing.T) {
} }
func TestEmbeddedCatalogSheetParamDeclsFrom87910880Hints(t *testing.T) { func TestEmbeddedCatalogSheetParamDeclsFrom87910880Hints(t *testing.T) {
// Former schema_hints/metadata/sheet.json overlays (87910880). // Former metadata/sheet.json overlays now declared as ParamDecl (87910880).
for _, tc := range []struct { for _, tc := range []struct {
path string path string
flag string flag string
@@ -883,6 +883,48 @@ func TestEmbeddedCatalogSheetParamDeclsFrom87910880Hints(t *testing.T) {
} }
} }
func TestEmbeddedCatalogPatSheetWikiRegisterSchemaHintParamDecls(t *testing.T) {
// Former RegisterSchemaHints required / required_when pins for pat, sheet,
// and wiki must publish via ParamDecl (native_annotation).
for _, tc := range []struct {
path string
flag string
wantRequired bool
requiredWhen string
}{
{"pat chmod", "session-id", false, "grant-type is session"},
{"sheet create", "name", true, ""},
{"sheet list", "node", true, ""},
{"sheet new", "node", true, ""},
{"sheet new", "name", true, ""},
{"wiki space create", "name", true, ""},
{"wiki space get", "workspace", true, ""},
} {
leaf, err := embeddedSchemaPayload([]string{tc.path})
if err != nil {
t.Fatalf("%s: %v", tc.path, err)
}
param := schemaMap(leaf["parameters"])[tc.flag]
if param["required"] != tc.wantRequired {
t.Fatalf("%s --%s required = %#v, want %v", tc.path, tc.flag, param["required"], tc.wantRequired)
}
reqProv := schemaMap(param["field_provenance"])["required"]
if got, _ := reqProv["source"].(string); got != "native_annotation" {
t.Fatalf("%s --%s required source = %#v, want native_annotation", tc.path, tc.flag, reqProv)
}
if tc.requiredWhen == "" {
continue
}
if param["required_when"] != tc.requiredWhen {
t.Fatalf("%s --%s required_when = %#v, want %q", tc.path, tc.flag, param["required_when"], tc.requiredWhen)
}
whenProv := schemaMap(param["field_provenance"])["required_when"]
if got, _ := whenProv["source"].(string); got != "native_annotation" {
t.Fatalf("%s --%s required_when source = %#v, want native_annotation", tc.path, tc.flag, whenProv)
}
}
}
func TestEmbeddedCatalogReportCreateToChatRequiredAndAliasView(t *testing.T) { func TestEmbeddedCatalogReportCreateToChatRequiredAndAliasView(t *testing.T) {
// Former report.create_report overlay: --to-chat required=false (MCP marks // Former report.create_report overlay: --to-chat required=false (MCP marks
// it required). Alias "report create" must keep the same contract. // it required). Alias "report create" must keep the same contract.
@@ -1083,6 +1125,10 @@ func TestEmbeddedCatalogAitableQueryKeywordAndHintParamDecls(t *testing.T) {
{"aitable attachment upload", "size"}, {"aitable attachment upload", "size"},
{"aitable chart update", "config"}, {"aitable chart update", "config"},
{"aitable record upsert", "records"}, {"aitable record upsert", "records"},
{"aitable field create", "fields"},
{"aitable dashboard create", "name"},
{"aitable dashboard update", "name"},
{"aitable view update visible-fields", "field-ids"},
} { } {
leaf, err := embeddedSchemaPayload([]string{tc.path}) leaf, err := embeddedSchemaPayload([]string{tc.path})
if err != nil { if err != nil {
@@ -1158,8 +1204,8 @@ func TestEmbeddedCatalogShortcutQueryMapsToKeyword(t *testing.T) {
} }
func TestEmbeddedCatalogContactParamDeclsMatchMergeBaseContract(t *testing.T) { func TestEmbeddedCatalogContactParamDeclsMatchMergeBaseContract(t *testing.T) {
// Former schema_hints/metadata/contact.json overlays at 87910880 must stay // Former metadata/contact.json overlays at 87910880 must stay on the
// on the published primary flags after ParamDecl migration. Hidden Cobra // published primary flags after ParamDecl migration. Hidden Cobra
// aliases (--id/--userid/--dept-name/--super-dept*) must not appear. // aliases (--id/--userid/--dept-name/--super-dept*) must not appear.
type wantParam struct { type wantParam struct {
property string property string
@@ -1318,7 +1364,7 @@ func TestEmbeddedCatalogChatParamDeclsFrom87910880Hints(t *testing.T) {
} }
} }
// Former schema_hints/metadata/chat.json overlays (87910880) must stay on // Former metadata/chat.json overlays (87910880) must stay on
// helpers/shortcut leaves via ParamDecl after hint clearance. // helpers/shortcut leaves via ParamDecl after hint clearance.
for _, tc := range []struct { for _, tc := range []struct {
path string path string
internal/cli/schema_hint_dirs.go
+14 -3
View File
@@ -59,9 +59,15 @@ type hintDirTool struct {
} }
func loadManualSchemaHintsFromHintDirs(metadataFS fs.FS, metadataGlob string, selectionFS fs.FS, selectionGlob string) (ManualSchemaHintSnapshot, error) { func loadManualSchemaHintsFromHintDirs(metadataFS fs.FS, metadataGlob string, selectionFS fs.FS, selectionGlob string) (ManualSchemaHintSnapshot, error) {
commands, err := loadParameterCommandsFromMetadata(metadataFS, metadataGlob) // Metadata is optional and normally nil/empty after phase 5 deleted
if err != nil { // schema_hints/metadata/. Nil FS or empty glob = no parameter overlays.
return ManualSchemaHintSnapshot{}, err var commands []ManualSchemaCommandHint
if metadataFS != nil && strings.TrimSpace(metadataGlob) != "" {
var err error
commands, err = loadParameterCommandsFromMetadata(metadataFS, metadataGlob)
if err != nil {
return ManualSchemaHintSnapshot{}, err
}
} }
agentHints, err := loadAgentHintsFromSelection(selectionFS, selectionGlob) agentHints, err := loadAgentHintsFromSelection(selectionFS, selectionGlob)
if err != nil { if err != nil {
@@ -80,6 +86,11 @@ func loadManualSchemaHintsFromHintDirs(metadataFS fs.FS, metadataGlob string, se
} }
func loadParameterCommandsFromMetadata(metadataFS fs.FS, globPattern string) ([]ManualSchemaCommandHint, error) { func loadParameterCommandsFromMetadata(metadataFS fs.FS, globPattern string) ([]ManualSchemaCommandHint, error) {
// Nil FS, empty glob, or zero matches are all OK (no overlays). The
// on-disk schema_hints/metadata/ directory may be absent.
if metadataFS == nil || strings.TrimSpace(globPattern) == "" {
return nil, nil
}
files, err := fs.Glob(metadataFS, globPattern) files, err := fs.Glob(metadataFS, globPattern)
if err != nil { if err != nil {
return nil, fmt.Errorf("list metadata hints: %w", err) return nil, fmt.Errorf("list metadata hints: %w", err)
internal/cli/schema_hint_emptiness_contract_test.go
+167
View File
@@ -0,0 +1,167 @@
// Copyright 2026 Alibaba Group
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package cli
import (
"encoding/json"
"io/fs"
"os"
"path/filepath"
"sort"
"strconv"
"strings"
"testing"
)
// TestDeletedProductionSchemaHintFilesStayGone locks stage-3 cleanup: the
// former production RegisterSchemaHints init files must not return. Their
// pins live on leaf ParamDecl / ContractFinal; RegisterSchemaHints remains
// only for test-fixture injection.
func TestDeletedProductionSchemaHintFilesStayGone(t *testing.T) {
deleted := []string{
"schema_hints_aitable.go",
"schema_hints_attendance.go",
"schema_hints_ding.go",
"schema_hints_helper_roots.go",
"schema_hints_runtime.go",
}
for _, name := range deleted {
path := filepath.Join(".", name)
if _, err := os.Stat(path); err == nil {
t.Fatalf("%s must stay deleted after RegisterSchemaHints→ParamDecl migration", name)
} else if !os.IsNotExist(err) {
t.Fatalf("stat %s: %v", name, err)
}
}
}
// TestEmbeddedMetadataHintShellsHaveEmptyTools locks the phase-5 end-state:
// schema_hints/metadata may be absent. When present, shells must keep
// tools:{} so they emit no parameter overlays. Production embed loading
// always passes nil/empty for metadata.
func TestEmbeddedMetadataHintShellsHaveEmptyTools(t *testing.T) {
commands, err := loadParameterCommandsFromMetadata(nil, "")
if err != nil {
t.Fatalf("loadParameterCommandsFromMetadata(nil, \"\"): %v", err)
}
if got := len(commands); got != 0 {
t.Fatalf("nil metadata parameter overlays = %d, want 0", got)
}
const metadataDir = "schema_hints/metadata"
entries, err := os.ReadDir(metadataDir)
if err != nil {
if os.IsNotExist(err) {
return
}
t.Fatalf("read %s: %v", metadataDir, err)
}
if len(entries) == 0 {
return
}
metadataFS := os.DirFS(metadataDir)
files, err := fs.Glob(metadataFS, "*.json")
if err != nil {
t.Fatalf("list metadata shells: %v", err)
}
sort.Strings(files)
nonEmpty := make([]string, 0)
for _, name := range files {
data, err := fs.ReadFile(metadataFS, name)
if err != nil {
t.Fatalf("read %s: %v", name, err)
}
var file hintDirFile
if err := json.Unmarshal(data, &file); err != nil {
t.Fatalf("decode %s: %v", name, err)
}
if len(file.Tools) != 0 {
paths := make([]string, 0, len(file.Tools))
for canonical := range file.Tools {
paths = append(paths, canonical)
}
sort.Strings(paths)
nonEmpty = append(nonEmpty, filepath.Base(name)+"="+strings.Join(paths, ","))
}
}
if len(nonEmpty) != 0 {
t.Fatalf("metadata shells must keep tools:{} (want 0 tool rows); nonempty=%v", nonEmpty)
}
commands, err = loadParameterCommandsFromMetadata(metadataFS, "*.json")
if err != nil {
t.Fatalf("loadParameterCommandsFromMetadata: %v", err)
}
if got := len(commands); got != 0 {
t.Fatalf("on-disk metadata parameter overlays = %d, want 0", got)
}
}
// TestEmbeddedCatalogHasNoToolSchemaHintProvenance asserts the published
// Catalog no longer selects tool_schema_hint as a provenance winner or
// retained candidate after RegisterSchemaHints → ParamDecl migration.
func TestEmbeddedCatalogHasNoToolSchemaHintProvenance(t *testing.T) {
if !embeddedSchemaCatalogAvailable() {
t.Fatal("embedded schema catalog unavailable")
}
loaded := embeddedSchemaCatalog()
hits := make([]string, 0)
for _, product := range loaded.Registry.Products {
for _, tool := range product.Tools {
hits = append(hits, toolSchemaHintProvenanceHits(tool.Identity.CanonicalPath, tool.FieldProvenance)...)
for _, param := range tool.Parameters {
prefix := tool.Identity.CanonicalPath + "." + param.Name
hits = append(hits, toolSchemaHintProvenanceHits(prefix, param.FieldProvenance)...)
}
}
}
if total := len(hits); total != 0 {
sample := hits
if total > 20 {
sample = hits[:20]
}
t.Fatalf("catalog field_provenance still references tool_schema_hint (count=%d); sample=%v", total, sample)
}
}
func toolSchemaHintProvenanceHits(prefix string, provenance map[string]FieldProvenance) []string {
if len(provenance) == 0 {
return nil
}
hits := make([]string, 0)
fields := make([]string, 0, len(provenance))
for field := range provenance {
fields = append(fields, field)
}
sort.Strings(fields)
for _, field := range fields {
prov := provenance[field]
if prov.Source == runtimeSchemaPrecedenceToolHint {
hits = append(hits, prefix+"."+field+"#winner")
}
for i, candidate := range prov.Candidates {
if candidate.Source == runtimeSchemaPrecedenceToolHint {
hits = append(hits, prefix+"."+field+"#candidate["+strconv.Itoa(i)+"]")
}
}
for i, candidate := range prov.OverriddenCandidates {
if candidate.Source == runtimeSchemaPrecedenceToolHint {
hits = append(hits, prefix+"."+field+"#overridden["+strconv.Itoa(i)+"]")
}
}
}
return hits
}
internal/cli/schema_hints.go
+6 -6
View File
@@ -50,8 +50,6 @@ type SchemaHintRegistry struct {
tools map[string]ToolSchemaHint tools map[string]ToolSchemaHint
} }
func boolPtr(v bool) *bool { return &v }
var defaultSchemaHintRegistry = newSchemaHintRegistry() var defaultSchemaHintRegistry = newSchemaHintRegistry()
func newSchemaHintRegistry() *SchemaHintRegistry { func newSchemaHintRegistry() *SchemaHintRegistry {
@@ -60,10 +58,12 @@ func newSchemaHintRegistry() *SchemaHintRegistry {
} }
} }
// RegisterSchemaHints registers curated hints for one product. Keys in tools may // RegisterSchemaHints registers curated tool_schema_hint overlays for one
// be either RPC names ("send_ding_message") or canonical paths // product. Production init no longer registers any product; ParamDecl /
// ("ding.send_ding_message"). Duplicate canonical paths panic during init so // LeafSchema owns those pins. The registry and this helper remain so runtime
// conflicting product hint files are caught early. // lookup and test fixtures can still inject temporary hints for precedence
// coverage. Keys may be RPC names ("send_ding_message") or canonical paths
// ("ding.send_ding_message"). Duplicate canonical paths panic.
func RegisterSchemaHints(productID string, tools map[string]ToolSchemaHint) { func RegisterSchemaHints(productID string, tools map[string]ToolSchemaHint) {
defaultSchemaHintRegistry.RegisterProduct(productID, tools) defaultSchemaHintRegistry.RegisterProduct(productID, tools)
} }
internal/cli/schema_hints/README.md
+54 -52
View File
@@ -1,25 +1,26 @@
# DWS Agent Schema Hints # DWS Agent Schema Hints
This directory contains versioned, structured Agent metadata. Hints belong to This directory contains versioned, structured Agent inputs for Schema
the CLI Schema subsystem rather than either installable Skill layout. They are generation. Hints belong to the CLI Schema subsystem rather than either
excluded from embedded binaries and release Skill bundles. Files generate installable Skill layout. They are excluded from embedded binaries and release
`internal/cli/schema_agent_metadata/`; generated runtime metadata must not be Skill bundles. Files generate `internal/cli/schema_agent_metadata/`; generated
edited directly. runtime metadata must not be edited directly.
## Layout ## Layout
Human-authored inputs live in two blocks: Human-authored inputs:
- `index.json` (`format: dws-agent-hint-index`) — maps product IDs to metadata - `index.json` (`format: dws-agent-hint-index`) — maps product IDs to required
and selection files, plus reference review selection files and optional metadata map, plus reference review.
- `metadata/<product>.json` — command metadata: safety, interface, Strategy: `metadata` is optional (omitted or `{}`); the on-disk
`runtime_gate`, and optional parameter overrides `metadata/` directory is retired and may be absent.
- `selection/<product>.json` — Agent selection prose - `selection/<product>.json` — Agent selection prose (required)
- `imported/` — sanitized baseline from a fixed external revision - `imported/` — sanitized baseline from a fixed external revision
When `index.json` is present, the generator loads `imported/` plus the When `index.json` is present, the generator loads `imported/` plus any
metadata and selection files listed in the index. Sibling review JSON files in metadata files listed in `index.metadata` (optional) and the selection files
this directory remain CI/audit inputs and are not applied as Agent metadata listed in `index.selection` (required). Sibling review JSON files in this
directory remain CI/audit inputs and are not applied as Agent metadata
sources. sources.
For the end-to-end Agent curation workflow, see `AGENTS.md` § “Agent curation For the end-to-end Agent curation workflow, see `AGENTS.md` § “Agent curation
@@ -27,9 +28,12 @@ workflow (Schema hints)”.
## Source kinds ## Source kinds
- `reviewed_explicit`: reviewed metadata or selection HintFiles under - `contract_final`: leaf-declared Safety / Schema / ParamDecl
`metadata/` / `selection/` (`reviewed: true`). Selection prose is delivered (`DeclareLeafMetadata`, `Shortcut.Schema`). This is the production authority
only from `selection/`. for safety, interface disposition, and parameter facts.
- `reviewed_explicit`: reviewed selection HintFiles under `selection/`
(`reviewed: true`) for Agent selection prose. Residual metadata tool rows are
not used in production shells.
- `explicit`: explicit but not per-tool-reviewed DWS hints. - `explicit`: explicit but not per-tool-reviewed DWS hints.
- `imported`: sanitized metadata from a fixed external revision. It fills missing Agent semantics but cannot redefine command paths or parameter contracts. - `imported`: sanitized metadata from a fixed external revision. It fills missing Agent semantics but cannot redefine command paths or parameter contracts.
@@ -54,7 +58,7 @@ current public leaf. `alias` entries bind an old or cross-product path to an
explicit current target. `group`, `stale`, and `out_of_surface` entries remain explicit current target. `group`, `stale`, and `out_of_surface` entries remain
visible in the audit but are never fuzzy-matched to a leaf. visible in the audit but are never fuzzy-matched to a leaf.
`interface_ref` is a separate interface binding. Use it when a public helper/canonical tool calls a differently named MCP RPC or another source product: `interface_ref` is a separate interface binding. Use it when a public helper/canonical tool calls a differently named MCP RPC or another source product. Prefer declaring it on the leaf Contract (`Schema.Interface`) rather than adding a metadata tool row:
```json ```json
{ {
@@ -94,20 +98,24 @@ current CLI/Catalog tool count. Its `coverage.surface_scope` must remain
`source_revision`, and policy verifies the snapshot's internal matched and `source_revision`, and policy verifies the snapshot's internal matched and
unmatched arithmetic. Current Catalog interface coverage is instead proved for unmatched arithmetic. Current Catalog interface coverage is instead proved for
every generated tool: each tool must have one valid `interface_mode` / every generated tool: each tool must have one valid `interface_mode` /
availability disposition and retain reviewed provenance to availability disposition and retain reviewed provenance to a leaf Contract
`selection-review.json`, `zz-interface-disposition-review.json`, or another declaration (`contract_final`) or another reviewed interface source. This makes
reviewed interface source. This makes newly added CLI tools explicit without newly added CLI tools explicit without rewriting historical MCP evidence or
rewriting historical MCP evidence or promoting an unreviewed selection hint. promoting an unreviewed selection hint.
Interface metadata contributes lower-priority typed candidates, including Interface metadata contributes lower-priority typed candidates, including
`required`; source precedence is value-neutral for most fields, so a candidate `required`; source precedence is value-neutral for most fields, so a candidate
may raise or lower the Agent-facing value when no higher-priority source wins. may raise or lower the Agent-facing value when no higher-priority source wins.
It cannot override reviewed manual hints, versioned bindings, typed/native It cannot override leaf Contract declarations, versioned bindings, typed/native
metadata, or current Cobra/constraint facts for those fields. `required` is metadata, or current Cobra/constraint facts for those fields. `required` is
special: Cobra `MarkFlagRequired` is a hard floor that cannot be projected away special: Cobra `MarkFlagRequired` is a hard floor that cannot be projected away
as optional. `cli_required` remains the executable Cobra marker with its own as optional. `cli_required` remains the executable Cobra marker with its own
provenance. provenance.
Production `RegisterSchemaHints` maps are empty after ParamDecl migration.
Temporary `tool_schema_hint` injection is allowed only inside unit-test
fixtures that exercise precedence edges.
```json ```json
{ {
"version": 1, "version": 1,
@@ -120,39 +128,30 @@ provenance.
"agent_summary": "管理日程、参与人、会议室和闲忙信息" "agent_summary": "管理日程、参与人、会议室和闲忙信息"
} }
}, },
"tools": { "tools": {}
"calendar.get_calendar_detail": {
"agent_summary": "读取一个日程的完整详情",
"use_when": ["已经取得 eventId，需要查看详情"],
"effect": "read",
"reviewed": true
}
}
} }
``` ```
Run `make generate-schema` after changing Hint or Skill sources. External Wukong metadata must be refreshed by the controlled offline import pipeline with an immutable revision, then committed together with its audit before regenerating the Catalog; runtime refresh is forbidden. Run `make generate-schema` after changing selection Hint or Skill sources, or
after changing leaf Contract declarations that feed Schema generation. External
Wukong metadata must be refreshed by the controlled offline import pipeline
with an immutable revision, then committed together with its audit before
regenerating the Catalog; runtime refresh is forbidden.
## Metadata parameters and selection prose ## Selection prose
Agent semantic hints in this directory do not change the executable CLI Leaf facts live on Contract declarations; `index.metadata` may be `{}` or
contract beyond reviewed parameter overlays on metadata tools. omitted. The on-disk `metadata/` directory is retired and must not be
reintroduced as a leaf-fact source.
| Block | Owns | | Block | Owns |
|---|---| |---|---|
| `metadata/<product>.json` | safety, interface, `runtime_gate`, optional `parameters` / `cli_path` | | leaf Contract (`Safety` / `Schema` / ParamDecl) | safety, interface, parameter facts (`contract_final`) |
| `selection/<product>.json` | `agent_summary`, `use_when`, `avoid_when`, `examples` | | `selection/<product>.json` | `agent_summary`, `use_when`, `avoid_when`, `examples` |
Parameter overlays may override Schema description, interface-property/type
mapping, `required`, and `required_when` for flags that already exist on that
command. They cannot create a command or flag, target a hidden/group command,
define an interface, or mark an unknown RPC available. Missing commands and
flags, wildcards, canonical conflicts, duplicate paths, and unreviewed entries
fail generation.
Selection prose is committed as a reviewed source. `go generate` only reads, Selection prose is committed as a reviewed source. `go generate` only reads,
validates, and projects this data. It must never call a model, copy a previous validates, and projects this data. It must never call a model, copy a previous
Catalog, or overwrite metadata/selection files. Selection cannot change command Catalog, or overwrite selection files. Selection cannot change command
identity, flags, parameters, safety, or interface facts. identity, flags, parameters, safety, or interface facts.
Commands intentionally kept outside Schema remain in the separate exact Commands intentionally kept outside Schema remain in the separate exact
@@ -163,13 +162,11 @@ that exclusion as stale.
### Agent editing workflow ### Agent editing workflow
1. Locate the real Cobra leaf and verify its exact path and current flags. 1. Locate the real Cobra leaf and verify its exact path and current flags.
2. Edit only the owning block (`metadata/` or `selection/`); do not mix fields. 2. Declare safety/interface/parameters on the owning leaf; edit
`selection/<product>.json` for selection prose only.
3. Add only fields that need review. Do not copy generated Catalog fields into 3. Add only fields that need review. Do not copy generated Catalog fields into
the input. the input.
4. Use `property` and `interface_type` only for a real CLI-to-interface 4. Run:
conversion. `required` and `required_when` describe the Schema projection;
they do not modify Cobra execution validation.
5. Run:
```bash ```bash
make generate-schema make generate-schema
@@ -179,6 +176,11 @@ that exclusion as stale.
go test ./internal/cli ./internal/app go test ./internal/cli ./internal/app
``` ```
6. Review the generated Catalog diff. A parameter overlay should affect only `check-runtime-confirmation-truth.sh` accepts optional/empty metadata
the intended contract. A selection edit updates prose provenance to shells (`tools: {}` or absent directory); gated confirmation truth comes
`reviewed_explicit` from `selection/`. from leaf Contract SafetySpec, not from metadata tool rows.
6. Review the generated Catalog diff. A leaf declaration change should affect
only the intended contract. A selection edit updates prose provenance to
`reviewed_explicit` from `selection/`; safety/interface provenance stays
`contract_final`.
internal/cli/schema_hints/index.json
+1 -28
View File
@@ -7,34 +7,7 @@
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli", "repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source" "channel": "open-source"
}, },
"metadata": { "metadata": {},
"aisearch": "metadata/aisearch.json",
"aitable": "metadata/aitable.json",
"attendance": "metadata/attendance.json",
"audit": "metadata/audit.json",
"calendar": "metadata/calendar.json",
"chat": "metadata/chat.json",
"contact": "metadata/contact.json",
"dev": "metadata/dev.json",
"devapp": "metadata/devapp.json",
"devdoc": "metadata/devdoc.json",
"ding": "metadata/ding.json",
"doc": "metadata/doc.json",
"drive": "metadata/drive.json",
"event": "metadata/event.json",
"hrbrain": "metadata/hrbrain.json",
"live": "metadata/live.json",
"mail": "metadata/mail.json",
"markdown": "metadata/markdown.json",
"mcp": "metadata/mcp.json",
"minutes": "metadata/minutes.json",
"oa": "metadata/oa.json",
"pat": "metadata/pat.json",
"report": "metadata/report.json",
"sheet": "metadata/sheet.json",
"todo": "metadata/todo.json",
"wiki": "metadata/wiki.json"
},
"selection": { "selection": {
"aisearch": "selection/aisearch.json", "aisearch": "selection/aisearch.json",
"aitable": "selection/aitable.json", "aitable": "selection/aitable.json",
internal/cli/schema_hints/metadata/aisearch.json
-17
View File
@@ -1,17 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/aisearch",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"aisearch.search_enterprise": {
"reviewed": true,
"cli_path": "aisearch enterprise",
"review_reason": "The reviewed CLI supports an all-content search with default --types all, while --queries and --time-range are optional filters; imported MCP required markers must not turn them into mandatory CLI input."
}
}
}
internal/cli/schema_hints/metadata/aitable.json
-47
View File
@@ -1,47 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/aitable",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"aitable.query_records": {
"reviewed": true,
"cli_path": "aitable record query",
"review_reason": "The reviewed query command supports both an optional ID lookup mode and a table scan/filter mode, so --record-ids is not unconditionally required."
},
"aitable.view_update_aggregate": {
"reviewed": true,
"cli_path": "aitable view update aggregate",
"review_reason": "The reviewed CLI accepts --json, a --field-id/--action pair, or --clear-field-id; the registered typed constraints describe those alternatives."
},
"aitable.view_update_card": {
"reviewed": true,
"cli_path": "aitable view update card",
"review_reason": "The reviewed CLI merges optional typed card flags over an optional --json block; the registered typed constraints require at least one real update field."
},
"aitable.view_update_field_widths": {
"reviewed": true,
"cli_path": "aitable view update field-widths",
"review_reason": "The reviewed CLI accepts either --json or the paired --field-id/--width form, which is represented by typed require-one-of and require-together constraints."
},
"aitable.view_update_timebar": {
"reviewed": true,
"cli_path": "aitable view update timebar",
"review_reason": "The reviewed CLI accepts either a complete --json block or one or more typed Gantt timebar fields; --json is therefore not unconditionally required."
},
"aitable.workflow_create": {
"reviewed": true,
"cli_path": "aitable workflow create",
"review_reason": "The command maps --base-id and a decoded workflow-dsl/v1 --dsl object to aitable/create_workflow. The call intentionally bypasses retries because creation is non-idempotent; locale remains optional."
},
"aitable.workflow_update": {
"reviewed": true,
"cli_path": "aitable workflow update",
"review_reason": "The command maps --base-id, --workflow-id and a decoded complete workflow-dsl/v1 --dsl object to aitable/update_workflow. This is full replacement rather than a partial patch; locale remains optional."
}
}
}
internal/cli/schema_hints/metadata/attendance.json
-27
View File
@@ -1,27 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/attendance",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"attendance.adjustment_search": {
"reviewed": true,
"cli_path": "attendance adjustment search",
"review_reason": "Cobra supplies reviewed page=1 and limit=20 defaults and RunE sends those defaults when omitted, so callers need not pass either pagination flag."
},
"attendance.group_search": {
"reviewed": true,
"cli_path": "attendance group search",
"review_reason": "Cobra supplies reviewed page=1 and limit=20 defaults and RunE materializes both PageQuery fields when omitted, so callers need not pass either flag."
},
"attendance.overtime_search": {
"reviewed": true,
"cli_path": "attendance overtime search",
"review_reason": "Cobra supplies reviewed page=1 and limit=20 defaults and RunE sends those defaults when omitted, so callers need not pass either pagination flag."
}
}
}
internal/cli/schema_hints/metadata/audit.json
-11
View File
@@ -1,11 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/audit",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {}
}
internal/cli/schema_hints/metadata/calendar.json
-11
View File
@@ -1,11 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/calendar",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {}
}
internal/cli/schema_hints/metadata/chat.json
-107
View File
@@ -1,107 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/chat",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"chat.add_emoji_reaction": {
"reviewed": true,
"cli_path": "chat message add-emoji",
"review_reason": "The four reviewed conversation locator flags are aliases for one openConversationId property; the typed require-one-of constraint owns their conditional requirement."
},
"chat.add_text_emotion": {
"reviewed": true,
"cli_path": "chat message add-text-emotion",
"review_reason": "The four reviewed conversation locator flags are aliases for one openConversationId property; the typed require-one-of constraint owns their conditional requirement."
},
"chat.create_smart_conv_category": {
"reviewed": true,
"cli_path": "chat category create-smart",
"review_reason": "Expose the existing smart-category helper through the reviewed Agent Schema and preserve its CLI-to-interface parameter contract."
},
"chat.list_message_favorites": {
"reviewed": true,
"cli_path": "chat message list-favorites",
"review_reason": "Preserve the reviewed CLI-to-interface conversion: Cobra validates --size as an integer from 1 to 100, then the helper serializes it to the string-valued list_message_favorites size property."
},
"chat.list_owned_or_admin_groups": {
"reviewed": true,
"cli_path": "chat group list-my-groups",
"review_reason": "The reviewed CLI lists all owned or administered groups when --role and --limit are omitted; both flags are optional filters despite stricter imported interface metadata."
},
"chat.remove_emoji_reaction": {
"reviewed": true,
"cli_path": "chat message remove-emoji",
"review_reason": "The four reviewed conversation locator flags are aliases for one openConversationId property; the typed require-one-of constraint owns their conditional requirement."
},
"chat.remove_text_emotion": {
"reviewed": true,
"cli_path": "chat message remove-text-emotion",
"review_reason": "The four reviewed conversation locator flags are aliases for one openConversationId property; the typed require-one-of constraint owns their conditional requirement."
},
"chat.set_group_member_mute_list": {
"reviewed": true,
"cli_path": "chat group-mute-member",
"review_reason": "The reviewed Cobra contract makes --off an optional mode switch: omission adds members to the mute list, while --off removes them. The shared MCP schema incorrectly marks the boolean as unconditionally required."
},
"chat.set_group_mute": {
"reviewed": true,
"cli_path": "chat group-mute",
"review_reason": "The reviewed optional --off switch selects unmute; omission deliberately selects mute, so false is a valid default rather than missing required input."
},
"chat.set_top_conversation": {
"reviewed": true,
"cli_path": "chat set-top",
"review_reason": "The reviewed optional --off switch selects unpin; omission deliberately selects pin, so false is a valid default rather than missing required input."
},
"chat.update_conv_member_roles": {
"reviewed": true,
"cli_path": "chat group set-admin",
"review_reason": "The reviewed optional --off switch selects administrator removal; omission deliberately selects administrator assignment."
},
"chat.update_notification_off": {
"reviewed": true,
"cli_path": "chat mute",
"review_reason": "The reviewed locator aliases feed one openConversationId property, while optional --off selects unmute; typed constraints require one locator without making the mode switch mandatory."
},
"chat.edit_message": {
"reviewed": true,
"cli_path": "chat message edit",
"review_reason": "The reviewed handler requires one conversation locator, a message ID, and exactly one of text or raw content; it optionally derives a title and maps mention controls before invoking edit_message."
},
"chat.get_conv_categories_info": {
"reviewed": true,
"cli_path": "chat category batch-info",
"review_reason": "The reviewed handler requires a comma-separated category-ID list, parses it to integers, and invokes get_conv_categories_info without a mutation or confirmation gate."
},
"chat.list_conv_categories_by_conv": {
"reviewed": true,
"cli_path": "chat category list-by-conv",
"review_reason": "The reviewed handler accepts one of three conversation locator aliases and invokes list_conv_categories_by_conv without a mutation or confirmation gate."
},
"chat.update_group_nick": {
"reviewed": true,
"cli_path": "chat group update-nick",
"review_reason": "The reviewed handler requires the target conversation while intentionally allowing omitted --nick to send an empty nickname and clear the current user's group nickname."
},
"chat.upgrade_group_to_external": {
"reviewed": true,
"cli_path": "chat group upgrade-to-external",
"review_reason": "The reviewed handler validates the target group and optional string-valued extension object, permits caller-authoritative dry-run, and requires explicit --yes before the irreversible upgrade."
},
"chat.shortcut_messages_send_card": {
"reviewed": true,
"cli_path": "chat +messages-send-card",
"review_reason": "Reviewed against authenticated contact-search resolution, create-only, two-action dry-run, create/update success, missing bizId, and partial-failure behavior that preserves the created bizId; the explicit openDingTalkId flag is bound to the lower interface's exact receiverOpenDingTalkId property."
},
"chat.update_text_emotion": {
"reviewed": true,
"cli_path": "chat message update-text-emotion",
"review_reason": "Ported from dws-wukong commits d6831318 and bcf56ccf, merged at 30f13f02. The four conversation locators alias one property; the other six business parameters are required by Cobra before the single im/update_text_emotion call."
}
}
}
internal/cli/schema_hints/metadata/contact.json
-57
View File
@@ -1,57 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/contact",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"contact.add_employee": {
"reviewed": true,
"cli_path": "contact user invite",
"review_reason": "The reviewed Wukong-compatible handler requires employee name and mobile, decodes optional --depts JSON to an array, and calls add_employee without a runtime confirmation gate."
},
"contact.exclusive_account_create": {
"reviewed": true,
"cli_path": "contact account create",
"review_reason": "The reviewed Wukong-compatible handler requires enterprise display name and login ID, maps optional contact fields and department IDs, and calls exclusive_account_create without a runtime confirmation gate."
},
"contact.get_authorized_emp_rosterInfo": {
"reviewed": true,
"cli_path": "contact user profile get",
"review_reason": "The reviewed helper deliberately permits either or both optional filters and passes an empty request to query the caller's authorized roster scope."
},
"contact.org_create": {
"reviewed": true,
"cli_path": "contact org create",
"review_reason": "The reviewed Wukong-compatible handler requires an organization name and creator display name and calls org_create without a runtime confirmation gate."
},
"contact.department_create": {
"reviewed": true,
"cli_path": "contact dept create",
"review_reason": "The reviewed handler requires one department-name spelling and an explicit boolean group choice, optionally parses a parent department ID, confirms, then invokes department_create."
},
"contact.department_update": {
"reviewed": true,
"cli_path": "contact dept update",
"review_reason": "The reviewed handler requires one department-ID spelling and one department-name spelling, optionally parses a parent ID, confirms, then invokes department_update."
},
"contact.employee_update": {
"reviewed": true,
"cli_path": "contact user update",
"review_reason": "The reviewed handler requires one employee-ID spelling plus at least one update field, decodes optional department JSON, confirms, then invokes employee_update."
},
"contact.exclusive_account_user_update": {
"reviewed": true,
"cli_path": "contact account update",
"review_reason": "The reviewed handler requires one enterprise-account user ID plus at least one profile or organization update field, confirms, then invokes exclusive_account_user_update."
},
"contact.self_user_profile_update": {
"reviewed": true,
"cli_path": "contact user update-self",
"review_reason": "The reviewed handler requires at least one of nickname or avatar file ID, confirms, then invokes self_user_profile_update for the current user."
}
}
}
internal/cli/schema_hints/metadata/dev.json
-11
View File
@@ -1,11 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/dev",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {}
}
internal/cli/schema_hints/metadata/devapp.json
-11
View File
@@ -1,11 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/devapp",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {}
}
internal/cli/schema_hints/metadata/devdoc.json
-17
View File
@@ -1,17 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/devdoc",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"devdoc.search_open_platform_docs_rag": {
"reviewed": true,
"cli_path": "devdoc article search",
"review_reason": "Search text may be supplied as positional keyword or public --query; hidden --keyword remains a runtime compatibility alias and is intentionally not published as a parameter. The versioned binding owns query -> keyword."
}
}
}
internal/cli/schema_hints/metadata/ding.json
-11
View File
@@ -1,11 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/ding",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {}
}
internal/cli/schema_hints/metadata/doc.json
-32
View File
@@ -1,32 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/doc",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"doc.create_comment": {
"reviewed": true,
"cli_path": "doc comment create",
"review_reason": "The reviewed handler normalizes repeated or comma-separated group conversation IDs into a stable de-duplicated array while preserving existing user mentions."
},
"doc.get_document_content": {
"reviewed": true,
"cli_path": "doc read",
"review_reason": "The reviewed handler preserves full Markdown/JSONML reads and adds validated outline, range, section, and tag-scoped JSONML fragment reads with optional file output."
},
"doc.reply_comment": {
"reviewed": true,
"cli_path": "doc comment reply",
"review_reason": "The reviewed handler normalizes group conversation IDs into a stable de-duplicated array and rejects group mentions for emoji replies, which the remote operation does not support."
},
"doc.update_comment": {
"reviewed": true,
"cli_path": "doc comment update",
"review_reason": "Preserve the reviewed user-mention conversion and normalize repeated or comma-separated group conversation IDs into mentionedOpenConversationIds."
}
}
}
internal/cli/schema_hints/metadata/drive.json
-22
View File
@@ -1,22 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/drive",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"drive.rename_document": {
"reviewed": true,
"cli_path": "drive rename",
"review_reason": "The reviewed CLI reads node metadata before mutation and strips only the exact current extension for non-folder nodes, avoiding both duplicate extensions and dotted-folder corruption without a suffix whitelist."
},
"drive.upload": {
"reviewed": true,
"cli_path": "drive upload",
"review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied."
}
}
}
internal/cli/schema_hints/metadata/event.json
-11
View File
@@ -1,11 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/event",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {}
}
internal/cli/schema_hints/metadata/hrbrain.json
-62
View File
@@ -1,62 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/hrbrain",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"hrbrain.list_talent_pools": {
"reviewed": true,
"cli_path": "hrbrain talent-pool list",
"review_reason": "Reviewed unpinned remote adapter: flags map 1:1 to the list_talent_pools MCP call arguments observed in internal/helpers/hrbrain.go."
},
"hrbrain.get_talent_pool_detail": {
"reviewed": true,
"cli_path": "hrbrain talent-pool detail",
"review_reason": "Reviewed unpinned remote adapter: --pool-code maps 1:1 to the poolCode MCP call argument observed in internal/helpers/hrbrain.go."
},
"hrbrain.list_pool_employees": {
"reviewed": true,
"cli_path": "hrbrain talent-pool employees",
"review_reason": "Reviewed unpinned remote adapter: flags map 1:1 to the list_pool_employees MCP call arguments observed in internal/helpers/hrbrain.go."
},
"hrbrain.get_profile_metadata": {
"reviewed": true,
"cli_path": "hrbrain profile metadata",
"review_reason": "Reviewed unpinned remote adapter: --work-no maps 1:1 to the workNo MCP call argument observed in internal/helpers/hrbrain.go."
},
"hrbrain.query_profile_data": {
"reviewed": true,
"cli_path": "hrbrain profile query",
"review_reason": "Reviewed unpinned remote adapter: flags map 1:1 to the query_profile_data MCP call arguments observed in internal/helpers/hrbrain.go."
},
"hrbrain.get_profile_label": {
"reviewed": true,
"cli_path": "hrbrain profile labels",
"review_reason": "Reviewed unpinned remote adapter: flags map 1:1 to the get_profile_label MCP call arguments observed in internal/helpers/hrbrain.go."
},
"hrbrain.get_employee_career": {
"reviewed": true,
"cli_path": "hrbrain profile career",
"review_reason": "Reviewed unpinned remote adapter: --work-no maps 1:1 to the workNo MCP call argument observed in internal/helpers/hrbrain.go."
},
"hrbrain.get_employee_performance": {
"reviewed": true,
"cli_path": "hrbrain profile performance",
"review_reason": "Reviewed unpinned remote adapter: --work-no maps 1:1 to the workNo MCP call argument observed in internal/helpers/hrbrain.go."
},
"hrbrain.search_employees": {
"reviewed": true,
"cli_path": "hrbrain search employees",
"review_reason": "Reviewed unpinned remote adapter: flags map 1:1 to the search_employees MCP call arguments observed in internal/helpers/hrbrain.go."
},
"hrbrain.search_employees_structured": {
"reviewed": true,
"cli_path": "hrbrain search employees-structured",
"review_reason": "Reviewed unpinned remote adapter: flags map 1:1 to the search_employees_structured MCP call arguments observed in internal/helpers/hrbrain.go."
}
}
}
internal/cli/schema_hints/metadata/live.json
-11
View File
@@ -1,11 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/live",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {}
}
internal/cli/schema_hints/metadata/mail.json
-27
View File
@@ -1,27 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/mail",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"mail.list_emails": {
"reviewed": true,
"cli_path": "mail message list",
"review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query."
},
"mail.search_mail_users": {
"reviewed": true,
"cli_path": "mail user search",
"review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements."
},
"mail.update_user_message_template": {
"reviewed": true,
"cli_path": "mail template update",
"review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement."
}
}
}
internal/cli/schema_hints/metadata/markdown.json
-32
View File
@@ -1,32 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/markdown",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"markdown.create": {
"reviewed": true,
"cli_path": "markdown create",
"review_reason": "The reviewed workflow requires exactly one content source, requires an .md name for literal content, keeps workspace and Drive space mutually exclusive, and routes the upload without a confirmation gate."
},
"markdown.fetch": {
"reviewed": true,
"cli_path": "markdown fetch",
"review_reason": "The reviewed workflow requires one node locator, keeps explicit Drive and Doc routes mutually exclusive, treats remote content as untrusted data, and protects local output paths."
},
"markdown.overwrite": {
"reviewed": true,
"cli_path": "markdown overwrite",
"review_reason": "The reviewed workflow requires a target and exactly one content source, supports a command-owned diff preview, and confirms before replacing the remote file."
},
"markdown.patch": {
"reviewed": true,
"cli_path": "markdown patch",
"review_reason": "The reviewed workflow requires a target, pattern, and replacement; it blocks zero-hit and empty-result writes, supports a command-owned diff preview, and confirms before reupload."
}
}
}
internal/cli/schema_hints/metadata/mcp.json
-11
View File
@@ -1,11 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/mcp",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {}
}
internal/cli/schema_hints/metadata/minutes.json
-17
View File
@@ -1,17 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/minutes",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"minutes.shortcut_replace_batch": {
"reviewed": true,
"cli_path": "minutes +replace-batch",
"review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate, composite interface, and the custom --pair format/uniqueness validation without inventing a direct MCP identity."
}
}
}
internal/cli/schema_hints/metadata/oa.json
-11
View File
@@ -1,11 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/oa",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {}
}
internal/cli/schema_hints/metadata/pat.json
-11
View File
@@ -1,11 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/pat",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {}
}
internal/cli/schema_hints/metadata/report.json
-17
View File
@@ -1,17 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/report",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"report.create_report": {
"reviewed": true,
"cli_path": "report entry submit",
"review_reason": "The reviewed optional --to-chat switch defaults to false and only controls post-submit delivery; it is not required to create a report."
}
}
}
internal/cli/schema_hints/metadata/sheet.json
-27
View File
@@ -1,27 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/sheet",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"sheet.create_pivot_table": {
"reviewed": true,
"cli_path": "sheet pivot-table create",
"review_reason": "Preserve the reviewed CLI-to-interface conversion: --properties accepts inline JSON or @file text and is validated and decoded to the create_pivot_table properties object."
},
"sheet.table_put": {
"reviewed": true,
"cli_path": "sheet table-put",
"review_reason": "Preserve the reviewed CLI-to-interface conversion: --sheets accepts inline JSON, @file, or stdin and is normalized to the table_put sheets array."
},
"sheet.update_pivot_table": {
"reviewed": true,
"cli_path": "sheet pivot-table update",
"review_reason": "Preserve the reviewed CLI-to-interface conversion: --properties accepts inline JSON or @file text and is validated and decoded to the update_pivot_table properties object."
}
}
}
internal/cli/schema_hints/metadata/todo.json
-42
View File
@@ -1,42 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/todo",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"todo.get_user_todos_in_current_org": {
"reviewed": true,
"cli_path": "todo task list",
"review_reason": "The reviewed handler defaults omitted role-types to executor, preserves current-organization behavior by default, and switches both single-page and auto-page calls to get_user_todos only when --query-all is explicitly true."
},
"todo.reset_todo_reminder": {
"reviewed": true,
"cli_path": "todo task reset-reminder",
"review_reason": "The reviewed CLI rejects malformed or structurally invalid non-empty reminder rules before the reset mutation, while preserving omission and [] as explicit clear forms."
},
"todo.create_todo_tag": {
"reviewed": true,
"cli_path": "todo tag create",
"review_reason": "The reviewed handler requires a non-blank tag name, builds a one-element userTags request, and invokes create_todo_tag without a runtime confirmation gate."
},
"todo.delete_todo_tag": {
"reviewed": true,
"cli_path": "todo tag delete",
"review_reason": "The reviewed handler requires at least one non-empty tag code, permits caller-authoritative dry-run, and requires explicit --yes before invoking delete_todo_tag."
},
"todo.tag_todo": {
"reviewed": true,
"cli_path": "todo tag add",
"review_reason": "The reviewed handler requires a task ID and at least one non-empty tag code before invoking tag_todo."
},
"todo.update_todo_tag": {
"reviewed": true,
"cli_path": "todo tag update",
"review_reason": "The reviewed handler requires a non-null JSON array of tag update records and invokes update_todo_tag without a runtime confirmation gate."
}
}
}
internal/cli/schema_hints/metadata/wiki.json
-11
View File
@@ -1,11 +0,0 @@
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-tool-metadata/wiki",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {}
}
internal/cli/schema_hints_aitable.go
-110
View File
@@ -1,110 +0,0 @@
// Copyright 2026 Alibaba Group
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package cli
func init() {
RegisterSchemaHints("aitable", map[string]ToolSchemaHint{
"attachment_upload": {
Parameters: map[string]ParameterSchemaHint{
"size": {Required: boolPtr(true)},
},
},
"chart_update": {
Parameters: map[string]ParameterSchemaHint{
"config": {Required: boolPtr(true)},
},
},
"dashboard_create": {
Parameters: map[string]ParameterSchemaHint{
"name": {Required: boolPtr(true)},
},
},
"dashboard_update": {
Parameters: map[string]ParameterSchemaHint{
"name": {Required: boolPtr(true)},
},
},
"field_create": {
Parameters: map[string]ParameterSchemaHint{
"fields": {Required: boolPtr(true)},
},
},
"field_update": {
Parameters: map[string]ParameterSchemaHint{
"name": {Required: boolPtr(true)},
},
},
"query_records": {
Description: "查询 AI 表格记录。默认返回单页；传 --all 时自动翻页累计全部记录。",
Parameters: map[string]ParameterSchemaHint{
"baseId": {
FlagName: "base-id",
Description: "Base ID。",
},
"tableId": {
FlagName: "table-id",
Description: "Table ID。",
},
"fieldIds": {
FlagName: "field-ids",
Type: "array",
Description: "Field ID 列表，CLI 使用逗号分隔。",
},
"recordIds": {
FlagName: "record-ids",
Type: "array",
Description: "Record ID 列表，CLI 使用逗号分隔。",
},
"filters": {
Type: "object",
Description: "过滤条件 JSON。",
},
"sort": {
Type: "array",
Description: "排序 JSON 数组。",
},
},
},
"record_upsert": {
Parameters: map[string]ParameterSchemaHint{
"records": {Required: boolPtr(true)},
},
},
"view_update_aggregate": {
Parameters: map[string]ParameterSchemaHint{
"json": {Required: boolPtr(true)},
},
},
"view_update_card": {
Parameters: map[string]ParameterSchemaHint{
"json": {Required: boolPtr(true)},
},
},
"view_update_field_widths": {
Parameters: map[string]ParameterSchemaHint{
"json": {Required: boolPtr(true)},
},
},
"view_update_timebar": {
Parameters: map[string]ParameterSchemaHint{
"json": {Required: boolPtr(true)},
},
},
"view_update_visible_fields": {
Parameters: map[string]ParameterSchemaHint{
"field-ids": {Required: boolPtr(true)},
},
},
})
}
internal/cli/schema_hints_attendance.go
-67
View File
@@ -1,67 +0,0 @@
// Copyright 2026 Alibaba Group
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package cli
func init() {
RegisterSchemaHints("attendance", map[string]ToolSchemaHint{
"get_user_attendance_record": {
Parameters: map[string]ParameterSchemaHint{
"user": {Required: boolPtr(true)},
"date": {Required: boolPtr(true)},
"users": {Type: "array", Required: boolPtr(true)},
"start": {Required: boolPtr(true)},
"end": {Required: boolPtr(true)},
},
},
"batch_get_employee_shifts": {
Parameters: map[string]ParameterSchemaHint{
"users": {Type: "array", Required: boolPtr(true)},
"start": {Required: boolPtr(true)},
"end": {Required: boolPtr(true)},
},
},
"get_attendance_summary": {
Parameters: map[string]ParameterSchemaHint{
"user": {Required: boolPtr(true)},
"date": {Required: boolPtr(true)},
"stats-type": {Required: boolPtr(true)},
},
},
"query_attendance_group_or_rules": {
Parameters: map[string]ParameterSchemaHint{
"date": {Required: boolPtr(true)},
},
},
"boss_check": {
Parameters: map[string]ParameterSchemaHint{
"plan-id": {Required: boolPtr(true)},
},
},
"save_self_setting": {
Parameters: map[string]ParameterSchemaHint{
"check-result-msg": {Required: boolPtr(true)},
},
},
"update_group_member": {
Parameters: map[string]ParameterSchemaHint{
"add-users": {Required: boolPtr(true)},
},
},
"update_group_setting": {
Parameters: map[string]ParameterSchemaHint{
"name": {Required: boolPtr(true)},
},
},
})
}
internal/cli/schema_hints_ding.go
-43
View File
@@ -1,43 +0,0 @@
// Copyright 2026 Alibaba Group
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package cli
func init() {
RegisterSchemaHints("ding", map[string]ToolSchemaHint{
"send_ding_message": {
Description: "发送 DING 消息给指定用户，支持配置机器人编码、接收人、提醒类型和消息内容。",
Parameters: map[string]ParameterSchemaHint{
"content": {
Description: "DING 消息内容。",
Required: boolPtr(true),
},
"robotCode": {
FlagName: "robot-code",
Description: "DING 机器人编码。通常来自开放平台或应用机器人配置。",
Required: boolPtr(true),
},
"receiverUserIdList": {
FlagName: "users",
Type: "array",
Description: "接收人的 userId 列表。CLI 使用逗号分隔，例如 user1,user2。",
Required: boolPtr(true),
},
"remindType": {
FlagName: "type",
Description: "提醒类型。CLI 默认使用 app，对应应用内提醒。",
},
},
},
})
}
internal/cli/schema_hints_helper_roots.go
-95
View File
@@ -1,95 +0,0 @@
// Copyright 2026 Alibaba Group
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package cli
func init() {
RegisterSchemaHints("pat", map[string]ToolSchemaHint{
"batch_grant": {
Parameters: map[string]ParameterSchemaHint{
"sessionId": {
Required: boolPtr(false),
RequiredWhen: "grant-type is session",
},
},
},
})
RegisterSchemaHints("doc", map[string]ToolSchemaHint{
"create_document": {
Parameters: map[string]ParameterSchemaHint{
"name": {Required: boolPtr(true)},
},
},
"get_document_content": {
Parameters: map[string]ParameterSchemaHint{
"node": {Required: boolPtr(true)},
},
},
"update_document": {
Parameters: map[string]ParameterSchemaHint{
"node": {Required: boolPtr(true)},
},
},
"delete_document": {
Parameters: map[string]ParameterSchemaHint{
"node": {Required: boolPtr(true)},
},
},
})
RegisterSchemaHints("drive", map[string]ToolSchemaHint{
"list_files": {
Parameters: map[string]ParameterSchemaHint{
"limit": {Type: "integer"},
},
},
"list_spaces": {
Parameters: map[string]ParameterSchemaHint{
"limit": {Type: "integer"},
},
},
})
RegisterSchemaHints("sheet", map[string]ToolSchemaHint{
"create_workspace_sheet": {
Parameters: map[string]ParameterSchemaHint{
"name": {Required: boolPtr(true)},
},
},
"get_all_sheets": {
Parameters: map[string]ParameterSchemaHint{
"node": {Required: boolPtr(true)},
},
},
"create_sheet": {
Parameters: map[string]ParameterSchemaHint{
"node": {Required: boolPtr(true)},
"name": {Required: boolPtr(true)},
},
},
})
RegisterSchemaHints("wiki", map[string]ToolSchemaHint{
"create_wikiSpace": {
Parameters: map[string]ParameterSchemaHint{
"name": {Required: boolPtr(true)},
},
},
"get_wikiSpace": {
Parameters: map[string]ParameterSchemaHint{
"space": {Required: boolPtr(true)},
},
},
})
}
internal/cli/schema_hints_runtime.go
-117
View File
@@ -1,117 +0,0 @@
// Copyright 2026 Alibaba Group
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package cli
func init() {
RegisterSchemaHints("calendar", map[string]ToolSchemaHint{
"create_calendar_event": {
Parameters: calendarRecurrenceSchemaParameters(true),
},
"query_busy_status": {
Parameters: map[string]ParameterSchemaHint{
"users": {Required: boolPtr(true)},
},
},
"update_calendar_event": {
Parameters: calendarRecurrenceSchemaParameters(false),
},
})
RegisterSchemaHints("minutes", map[string]ToolSchemaHint{
"get_minutes_ai_summary": {
Parameters: map[string]ParameterSchemaHint{
"taskUuid": {Required: boolPtr(true)},
},
},
})
RegisterSchemaHints("group-chat", map[string]ToolSchemaHint{
"search_messages_by_sender": {
Parameters: map[string]ParameterSchemaHint{
"sender-user-id": {Required: boolPtr(true)},
},
},
})
RegisterSchemaHints("dev", map[string]ToolSchemaHint{
"get_extension_webapp_config": {
Parameters: map[string]ParameterSchemaHint{
"unifiedAppId": {Required: boolPtr(true)},
},
},
"set_extension_robot_config": {
Parameters: map[string]ParameterSchemaHint{
"name": {Required: boolPtr(true)},
},
},
"set_extension_webapp_config": {
Parameters: map[string]ParameterSchemaHint{
"homepageUrl": {Required: boolPtr(true)},
},
},
"update_dev_app": {
Parameters: map[string]ParameterSchemaHint{
"name": {Required: boolPtr(true)},
},
},
"update_dev_app_security_config": {
Parameters: map[string]ParameterSchemaHint{
"redirectUrls": {Required: boolPtr(true)},
},
},
})
}
func calendarRecurrenceSchemaParameters(includeCreateRequired bool) map[string]ParameterSchemaHint {
parameters := map[string]ParameterSchemaHint{
"recurrence.pattern.dayOfMonth": {
Required: boolPtr(false),
RequiredWhen: "recurrence-type is absoluteMonthly or absoluteYearly",
},
"recurrence.pattern.daysOfWeek": {
Required: boolPtr(false),
RequiredWhen: "recurrence-type is weekly or relativeMonthly",
},
"recurrence.pattern.index": {
Required: boolPtr(false),
RequiredWhen: "recurrence-type is relativeMonthly",
},
"recurrence.pattern.interval": {
Required: boolPtr(false),
RequiredWhen: "any recurrence-* flag is provided",
},
"recurrence.pattern.type": {
Required: boolPtr(false),
RequiredWhen: "any recurrence-* flag is provided",
},
"recurrence.range.endDate": {
Required: boolPtr(false),
RequiredWhen: "recurrence-range-type is endDate",
},
"recurrence.range.numberOfOccurrences": {
Required: boolPtr(false),
RequiredWhen: "recurrence-range-type is numbered",
},
"recurrence.range.type": {
Required: boolPtr(false),
RequiredWhen: "any recurrence-* flag is provided",
},
}
if includeCreateRequired {
parameters["summary"] = ParameterSchemaHint{Required: boolPtr(true)}
parameters["startDateTime"] = ParameterSchemaHint{Required: boolPtr(true)}
parameters["endDateTime"] = ParameterSchemaHint{Required: boolPtr(true)}
}
return parameters
}
internal/cli/schema_manual_hints.go
+11 -11
View File
@@ -37,16 +37,10 @@ const (
runtimeSchemaManualReasonAnnotation = "dws.schema.manual.reason" runtimeSchemaManualReasonAnnotation = "dws.schema.manual.reason"
) )
//go:embed schema_hints/metadata/*.json
var embeddedMetadataFS embed.FS
//go:embed schema_hints/selection/*.json //go:embed schema_hints/selection/*.json
var embeddedSelectionFS embed.FS var embeddedSelectionFS embed.FS
const ( const embeddedSelectionGlob = "schema_hints/selection/*.json"
embeddedMetadataGlob = "schema_hints/metadata/*.json"
embeddedSelectionGlob = "schema_hints/selection/*.json"
)
// ManualSchemaHintSnapshot is the human-owned bridge from an existing // ManualSchemaHintSnapshot is the human-owned bridge from an existing
// public Cobra leaf to Schema. It cannot create commands, flags, exclusions, or // public Cobra leaf to Schema. It cannot create commands, flags, exclusions, or
@@ -218,9 +212,12 @@ var (
applyManualParameter = annotateManualSchemaParameter applyManualParameter = annotateManualSchemaParameter
) )
// ApplyEmbeddedManualSchemaHints applies the committed human review // ApplyEmbeddedManualSchemaHints loads committed hint dirs and applies any
// file to an already-built Cobra tree. The operation is deterministic and // residual metadata parameter overlays to an already-built Cobra tree.
// idempotent. // Selection prose is loaded (and validated) as part of the same snapshot for
// generators/tests; this function only annotates Commands. Metadata overlays
// are optional: empty tools shells produce an empty Commands list. The
// operation is deterministic and idempotent.
func ApplyEmbeddedManualSchemaHints(root *cobra.Command) (ManualSchemaHintReport, error) { func ApplyEmbeddedManualSchemaHints(root *cobra.Command) (ManualSchemaHintReport, error) {
snapshot, err := loadManualSchemaHints() snapshot, err := loadManualSchemaHints()
if err != nil { if err != nil {
@@ -231,8 +228,11 @@ func ApplyEmbeddedManualSchemaHints(root *cobra.Command) (ManualSchemaHintReport
func embeddedManualSchemaHints() (ManualSchemaHintSnapshot, error) { func embeddedManualSchemaHints() (ManualSchemaHintSnapshot, error) {
manualSchemaHintsOnce.Do(func() { manualSchemaHintsOnce.Do(func() {
// Selection FS/glob are required. Metadata overlays are retired:
// pass nil/empty so loadManualSchemaHintsFromHintDirs yields no
// parameter Commands (schema_hints/metadata/ may be absent).
manualSchemaHintsSnapshot, manualSchemaHintsErr = loadManualSchemaHintsFromHintDirs( manualSchemaHintsSnapshot, manualSchemaHintsErr = loadManualSchemaHintsFromHintDirs(
embeddedMetadataFS, embeddedMetadataGlob, nil, "",
embeddedSelectionFS, embeddedSelectionGlob, embeddedSelectionFS, embeddedSelectionGlob,
) )
}) })
internal/cli/schema_parameter_mapping_completeness_test.go
+15 -17
View File
@@ -103,14 +103,13 @@ func TestEmbeddedCatalogLocalInterfacesAreExactAndReviewed(t *testing.T) {
for _, field := range []string{"interface_mode", "availability", "interface_ref", "interface_reason"} { for _, field := range []string{"interface_mode", "availability", "interface_ref", "interface_reason"} {
entry := provenance[field] entry := provenance[field]
prec := schemaString(entry["precedence"]) prec := schemaString(entry["precedence"])
if prec != "reviewed_explicit" && prec != "contract_final" { // Production leaf interface facts come from ContractFinal
t.Errorf("%s local %s precedence = %q, want reviewed_explicit or contract_final", canonical, field, prec) // (DeclareLeafMetadata / Schema). metadata/*.json shells keep
// tools:{} and must not win reviewed_explicit for these fields.
if prec != "contract_final" {
t.Errorf("%s local %s precedence = %q, want contract_final", canonical, field, prec)
} }
source := schemaString(entry["source"]) if source := schemaString(entry["source"]); source != "corecmd.contract" {
if prec == "reviewed_explicit" && !strings.Contains(source, "internal/cli/schema_hints/metadata/") {
t.Errorf("%s local %s source = %q, want metadata/", canonical, field, source)
}
if prec == "contract_final" && source != "corecmd.contract" {
t.Errorf("%s local %s source = %q, want corecmd.contract", canonical, field, source) t.Errorf("%s local %s source = %q, want corecmd.contract", canonical, field, source)
} }
} }
@@ -212,10 +211,10 @@ func TestSchemaParameterMappingAuditExclusionRules(t *testing.T) {
tools["sample.read"]["interface_ref"] = nil tools["sample.read"]["interface_ref"] = nil
tools["sample.read"]["interface_reason"] = "Reviewed composite fixture" tools["sample.read"]["interface_reason"] = "Reviewed composite fixture"
tools["sample.read"]["field_provenance"] = map[string]any{ tools["sample.read"]["field_provenance"] = map[string]any{
"interface_mode": map[string]any{"precedence": "reviewed_explicit"}, "interface_mode": map[string]any{"precedence": "contract_final"},
"availability": map[string]any{"precedence": "reviewed_explicit"}, "availability": map[string]any{"precedence": "contract_final"},
"interface_ref": map[string]any{"precedence": "reviewed_explicit"}, "interface_ref": map[string]any{"precedence": "contract_final"},
"interface_reason": map[string]any{"precedence": "reviewed_explicit"}, "interface_reason": map[string]any{"precedence": "contract_final"},
} }
} }
return tools return tools
@@ -626,13 +625,12 @@ func auditCompositeSchemaDisposition(canonical string, tool map[string]any) []st
provenance := schemaMap(tool["field_provenance"]) provenance := schemaMap(tool["field_provenance"])
for _, field := range []string{"interface_mode", "availability", "interface_ref", "interface_reason"} { for _, field := range []string{"interface_mode", "availability", "interface_ref", "interface_reason"} {
entry := provenance[field] entry := provenance[field]
// A composite disposition must be backed by an explicit authoritative // Composite dispositions must pass through ContractFinal
// source: legacy reviewed hints ("reviewed_explicit") or a Contract // (declare-or-annotate). Production metadata shells are empty and
// SchemaDecl pass-through ("contract_final"); declaration is the // must not supply reviewed_explicit for these fields.
// stronger backing per the declare-or-annotate rule.
precedence := strings.TrimSpace(schemaString(entry["precedence"])) precedence := strings.TrimSpace(schemaString(entry["precedence"]))
if precedence != "reviewed_explicit" && precedence != "contract_final" { if precedence != "contract_final" {
problems = append(problems, fmt.Sprintf("%s composite %s is not backed by reviewed_explicit/contract_final provenance", canonical, field)) problems = append(problems, fmt.Sprintf("%s composite %s is not backed by contract_final provenance", canonical, field))
} }
} }
return problems return problems
internal/cli/schema_parameter_precedence_test.go
+2
View File
@@ -811,6 +811,8 @@ func TestRuntimeSchemaParameterPrecedenceNativeAndCobraBeatHints(t *testing.T) {
} }
func TestRuntimeSchemaParameterPrecedenceToolHintBeatsMCPWithoutChangingFlagIdentity(t *testing.T) { func TestRuntimeSchemaParameterPrecedenceToolHintBeatsMCPWithoutChangingFlagIdentity(t *testing.T) {
// Fixture-only ParameterSchemaHint injection: production RegisterSchemaHints
// stays empty after ParamDecl migration.
_, leaf := manualSchemaHintTestTree() _, leaf := manualSchemaHintTestTree()
parameters, err := runtimeCommandParameters(leaf, "sample.search_items", map[string]ParameterSchemaHint{ parameters, err := runtimeCommandParameters(leaf, "sample.search_items", map[string]ParameterSchemaHint{
"query": { "query": {
internal/cli/schema_small_coverage_test.go
+29
View File
@@ -245,6 +245,10 @@ func TestCrossPlatformCoverageHintDirectoryLoaderRemainingEdges(t *testing.T) {
if _, err := loadParameterCommandsFromMetadata(fstest.MapFS{}, "["); err == nil { if _, err := loadParameterCommandsFromMetadata(fstest.MapFS{}, "["); err == nil {
t.Fatal("invalid metadata glob succeeded") t.Fatal("invalid metadata glob succeeded")
} }
emptyCommands, err := loadParameterCommandsFromMetadata(fstest.MapFS{}, "*.json")
if err != nil || len(emptyCommands) != 0 {
t.Fatalf("empty metadata directory = %#v, %v", emptyCommands, err)
}
if _, err := loadParameterCommandsFromMetadata(directoryJSON, "*.json"); err == nil { if _, err := loadParameterCommandsFromMetadata(directoryJSON, "*.json"); err == nil {
t.Fatal("metadata directory read succeeded") t.Fatal("metadata directory read succeeded")
} }
@@ -290,6 +294,31 @@ func TestCrossPlatformCoverageHintDirectoryLoaderRemainingEdges(t *testing.T) {
if _, err := loadManualSchemaHintsFromHintDirs(validMetadata, "*.json", invalidSelection, "*.json"); err == nil { if _, err := loadManualSchemaHintsFromHintDirs(validMetadata, "*.json", invalidSelection, "*.json"); err == nil {
t.Fatal("wrapper selection validation failure succeeded") t.Fatal("wrapper selection validation failure succeeded")
} }
// Optional metadata: nil FS or empty glob must still load selection.
for _, tc := range []struct {
name string
fs fs.FS
glob string
}{
{name: "nil FS", fs: nil, glob: "*.json"},
{name: "empty glob", fs: validMetadata, glob: ""},
{name: "empty match", fs: fstest.MapFS{}, glob: "*.json"},
} {
snap, err := loadManualSchemaHintsFromHintDirs(tc.fs, tc.glob, validSelection, "*.json")
if err != nil {
t.Fatalf("optional metadata %s: %v", tc.name, err)
}
if len(snap.Commands) != 0 {
t.Fatalf("optional metadata %s: unexpected commands %#v", tc.name, snap.Commands)
}
if _, ok := snap.AgentHints.Tools["sample.get"]; !ok {
t.Fatalf("optional metadata %s: selection tools missing", tc.name)
}
}
if commands, err := loadParameterCommandsFromMetadata(nil, "*.json"); err != nil || len(commands) != 0 {
t.Fatalf("nil metadata FS = %#v, %v", commands, err)
}
} }
func TestCrossPlatformCoverageInterfaceRegistryRemainingEdges(t *testing.T) { func TestCrossPlatformCoverageInterfaceRegistryRemainingEdges(t *testing.T) {
internal/cli/schema_text_precedence_test.go
+28 -2
View File
@@ -3,7 +3,10 @@
package cli package cli
import "testing" import (
"sort"
"testing"
)
func TestRuntimeToolTextPrefersCobraHelpOverGenericMCPMetadata(t *testing.T) { func TestRuntimeToolTextPrefersCobraHelpOverGenericMCPMetadata(t *testing.T) {
entry := runtimeSchemaEntry{ entry := runtimeSchemaEntry{
@@ -37,7 +40,31 @@ func TestRuntimeToolTextPrefersCobraHelpOverGenericMCPMetadata(t *testing.T) {
} }
} }
func TestProductionRegisterSchemaHintsHasNoSubstantiveOverlays(t *testing.T) {
// Framework expectation after ParamDecl / ContractFinal migration: production
// RegisterSchemaHints must not publish tool_schema_hint overlays. Temporary
// registry injection is allowed only inside unit-test fixtures.
if got := len(defaultSchemaHintRegistry.tools); got != 0 {
paths := make([]string, 0, got)
for path := range defaultSchemaHintRegistry.tools {
paths = append(paths, path)
}
sort.Strings(paths)
t.Fatalf("production schema hint registry has %d tool overlay(s), want 0; paths=%v", got, paths)
}
}
func TestRuntimeToolTextKeepsReviewedHintAboveCobraHelp(t *testing.T) { func TestRuntimeToolTextKeepsReviewedHintAboveCobraHelp(t *testing.T) {
// Production RegisterSchemaHints maps are empty; inject a temporary
// reviewed tool_schema_hint so this precedence unit test stays self-contained.
originalHints := defaultSchemaHintRegistry
t.Cleanup(func() { defaultSchemaHintRegistry = originalHints })
defaultSchemaHintRegistry = newSchemaHintRegistry()
const wantDescription = "查询 AI 表格记录。默认返回单页；传 --all 时自动翻页累计全部记录。"
RegisterSchemaHints("aitable", map[string]ToolSchemaHint{
"query_records": {Description: wantDescription},
})
entry := runtimeSchemaEntry{ entry := runtimeSchemaEntry{
ProductID: "aitable", ProductID: "aitable",
ToolName: "query_records", ToolName: "query_records",
@@ -59,7 +86,6 @@ func TestRuntimeToolTextKeepsReviewedHintAboveCobraHelp(t *testing.T) {
if title != entry.Title { if title != entry.Title {
t.Fatalf("title = %q, want Cobra Help title %q", title, entry.Title) t.Fatalf("title = %q, want Cobra Help title %q", title, entry.Title)
} }
wantDescription := schemaHintForCanonicalPath("aitable.query_records").Description
if description != wantDescription { if description != wantDescription {
t.Fatalf("description = %q, want reviewed hint %q", description, wantDescription) t.Fatalf("description = %q, want reviewed hint %q", description, wantDescription)
} }
internal/generator/agentmetadata/hints.go
+13 -10
View File
@@ -36,16 +36,17 @@ type HintFile struct {
ReferenceReview map[string]ReferenceReview `json:"reference_review,omitempty"` ReferenceReview map[string]ReferenceReview `json:"reference_review,omitempty"`
} }
// HintIndex is the human-authored entrypoint. It maps product IDs to metadata // HintIndex is the human-authored entrypoint. It maps product IDs to optional
// (safety/interface/parameters/runtime_gate) and selection (Agent routing prose) // metadata HintFile paths (legacy safety/interface/parameters/runtime_gate
// HintFile paths. Index-level runtime_gates were removed; gates live on each // overlays; may be omitted once leaf facts live on Contract) and required
// metadata tool as runtime_gate. // selection (Agent routing prose) HintFile paths. Index-level runtime_gates
// were removed; residual gates live on each metadata tool as runtime_gate.
type HintIndex struct { type HintIndex struct {
Version int `json:"version"` Version int `json:"version"`
Format string `json:"format"` Format string `json:"format"`
Source HintSource `json:"source"` Source HintSource `json:"source"`
Coverage HintCoverage `json:"coverage,omitempty"` Coverage HintCoverage `json:"coverage,omitempty"`
Metadata map[string]string `json:"metadata"` Metadata map[string]string `json:"metadata,omitempty"`
Selection map[string]string `json:"selection"` Selection map[string]string `json:"selection"`
ReferenceReview map[string]ReferenceReview `json:"reference_review,omitempty"` ReferenceReview map[string]ReferenceReview `json:"reference_review,omitempty"`
} }
@@ -221,14 +222,16 @@ func parseHintSources(out *File, files []sourceFile, opts Options, stats *Stats,
} }
return nil return nil
} }
if len(index.Metadata) == 0 { // Metadata is optional: Contract/Safety owns leaf safety and params.
return false, fmt.Errorf("decode Agent hint index %s: metadata map is required", indexFile.display) // An omitted or empty map is a valid migration end-state for phase 5
} // (directory deletion). Selection remains required.
if len(index.Selection) == 0 { if len(index.Selection) == 0 {
return false, fmt.Errorf("decode Agent hint index %s: selection map is required", indexFile.display) return false, fmt.Errorf("decode Agent hint index %s: selection map is required", indexFile.display)
} }
if err := appendMapped("metadata", index.Metadata, hintRoleMetadata); err != nil { if len(index.Metadata) > 0 {
return false, err if err := appendMapped("metadata", index.Metadata, hintRoleMetadata); err != nil {
return false, err
}
} }
if err := appendMapped("selection", index.Selection, hintRoleSelection); err != nil { if err := appendMapped("selection", index.Selection, hintRoleSelection); err != nil {
return false, err return false, err
internal/generator/agentmetadata/hints_coverage_test.go
+26 -1
View File
@@ -51,7 +51,6 @@ func TestCrossPlatformCoverageHintUnmarshalAndIndexValidationEdges(t *testing.T)
{"version", `{"version":2}`, nil, "unsupported version"}, {"version", `{"version":2}`, nil, "unsupported version"},
{"format", `{"version":1,"format":"other"}`, nil, "unsupported format"}, {"format", `{"version":1,"format":"other"}`, nil, "unsupported format"},
{"source kind", `{"version":1,"format":"dws-agent-hint-index","source":{"kind":"imported"}}`, nil, "unsupported source kind"}, {"source kind", `{"version":1,"format":"dws-agent-hint-index","source":{"kind":"imported"}}`, nil, "unsupported source kind"},
{"metadata required", `{"version":1,"format":"dws-agent-hint-index","selection":{"sample":"selection.json"}}`, nil, "metadata map is required"},
{"selection required", `{"version":1,"format":"dws-agent-hint-index","metadata":{"sample":"metadata.json"}}`, nil, "selection map is required"}, {"selection required", `{"version":1,"format":"dws-agent-hint-index","metadata":{"sample":"metadata.json"}}`, nil, "selection map is required"},
{"empty metadata path", validCoverageIndex("", "selection.json"), map[string]string{"selection.json": validHint}, "missing path"}, {"empty metadata path", validCoverageIndex("", "selection.json"), map[string]string{"selection.json": validHint}, "missing path"},
{"escaping metadata path", validCoverageIndex("../outside.json", "selection.json"), map[string]string{"selection.json": validHint}, "escapes hints root"}, {"escaping metadata path", validCoverageIndex("../outside.json", "selection.json"), map[string]string{"selection.json": validHint}, "escapes hints root"},
@@ -70,6 +69,32 @@ func TestCrossPlatformCoverageHintUnmarshalAndIndexValidationEdges(t *testing.T)
}) })
} }
// Metadata map may be omitted or empty; selection alone is enough.
for _, tc := range []struct {
name string
index string
}{
{"metadata omitted", `{"version":1,"format":"dws-agent-hint-index","source":{"kind":"explicit"},"selection":{"sample":"selection.json"}}`},
{"metadata empty", `{"version":1,"format":"dws-agent-hint-index","source":{"kind":"explicit"},"metadata":{},"selection":{"sample":"selection.json"}}`},
} {
t.Run(tc.name, func(t *testing.T) {
if used, err := parseCoverageHints(root, map[string]string{"index.json": tc.index, "selection.json": validHint}); err != nil || !used {
t.Fatalf("optional metadata = %v, %v", used, err)
}
})
}
// Empty-shell metadata files (tools: {}) remain valid when still mapped.
emptyShell := `{"version":1,"source":{"kind":"explicit"},"tools":{}}`
indexWithShell := validCoverageIndex("metadata.json", "selection.json")
if used, err := parseCoverageHints(root, map[string]string{
"index.json": indexWithShell,
"metadata.json": emptyShell,
"selection.json": validHint,
}); err != nil || !used {
t.Fatalf("empty-shell metadata = %v, %v", used, err)
}
indexWithProjection := `{"version":1,"format":"dws-agent-hint-index","source":{"kind":"explicit"},"coverage":{"source_tools":1},"metadata":{"sample":"metadata.json"},"selection":{"sample":"selection.json"},"reference_review":{"old path":{"status":"stale","reason":"removed"}}}` indexWithProjection := `{"version":1,"format":"dws-agent-hint-index","source":{"kind":"explicit"},"coverage":{"source_tools":1},"metadata":{"sample":"metadata.json"},"selection":{"sample":"selection.json"},"reference_review":{"old path":{"status":"stale","reason":"removed"}}}`
if used, err := parseCoverageHints(root, map[string]string{"index.json": indexWithProjection, "metadata.json": validHint, "selection.json": validHint}); err != nil || !used { if used, err := parseCoverageHints(root, map[string]string{"index.json": indexWithProjection, "metadata.json": validHint, "selection.json": validHint}); err != nil || !used {
t.Fatalf("index projection = %v, %v", used, err) t.Fatalf("index projection = %v, %v", used, err)
internal/generator/agentmetadata/metadata.go
+2 -1
View File
@@ -382,7 +382,8 @@ func Generate(opts Options) (File, Stats, error) {
// generateFromSources retains the lower-precedence evidence parsers as a // generateFromSources retains the lower-precedence evidence parsers as a
// package-internal seam for focused tests. Production callers must use Generate, // package-internal seam for focused tests. Production callers must use Generate,
// which requires the reviewed selection + metadata hint sources under HintsDir. // which requires the reviewed selection hint sources under HintsDir
// (metadata map/files are optional; empty metadata is a valid end-state).
func generateFromSources(opts Options) (File, Stats, error) { func generateFromSources(opts Options) (File, Stats, error) {
if opts.Root == "" { if opts.Root == "" {
opts.Root = "." opts.Root = "."
internal/generator/cmd_schema_agent_metadata/coverage_more_test.go
+6 -9
View File
@@ -277,15 +277,14 @@ func TestCrossPlatformCoverageMetadataRegistryAndSelectionFailureEdges(t *testin
} }
root := t.TempDir() root := t.TempDir()
registry := commandRegistryProjection{CanonicalToolPaths: map[string]string{"sample.run": "sample run"}}
if err := validateSelectionHintInput(root, "hints", registry); err == nil || !strings.Contains(err.Error(), "required Agent hint directory missing") {
t.Fatalf("missing selection/ error = %v", err)
}
selection := filepath.Join(root, "hints", "selection") selection := filepath.Join(root, "hints", "selection")
metadata := filepath.Join(root, "hints", "metadata")
if err := os.MkdirAll(selection, 0o755); err != nil { if err := os.MkdirAll(selection, 0o755); err != nil {
t.Fatal(err) t.Fatal(err)
} }
if err := os.MkdirAll(metadata, 0o755); err != nil {
t.Fatal(err)
}
registry := commandRegistryProjection{CanonicalToolPaths: map[string]string{"sample.run": "sample run"}}
loadSelectionMetadataHints = func(fs.FS) (cli.ManualAgentHintSet, error) { loadSelectionMetadataHints = func(fs.FS) (cli.ManualAgentHintSet, error) {
return cli.ManualAgentHintSet{}, errors.New("load") return cli.ManualAgentHintSet{}, errors.New("load")
} }
@@ -329,10 +328,8 @@ func TestCrossPlatformCoverageSelectionHintInputExemptsDeclaredTools(t *testing.
}) })
root := t.TempDir() root := t.TempDir()
for _, dir := range []string{"selection", "metadata"} { if err := os.MkdirAll(filepath.Join(root, "hints", "selection"), 0o755); err != nil {
if err := os.MkdirAll(filepath.Join(root, "hints", dir), 0o755); err != nil { t.Fatal(err)
t.Fatal(err)
}
} }
declared := &cobra.Command{Use: "run"} declared := &cobra.Command{Use: "run"}
internal/generator/cmd_schema_agent_metadata/main.go
+5 -6
View File
@@ -75,7 +75,7 @@ func main() {
flag.StringVar(&skillPath, "skill", "skills/mono/SKILL.md", "Main DWS SKILL.md path") flag.StringVar(&skillPath, "skill", "skills/mono/SKILL.md", "Main DWS SKILL.md path")
flag.StringVar(&productsDir, "products", "skills/mono/references/products", "Product skill reference directory") flag.StringVar(&productsDir, "products", "skills/mono/references/products", "Product skill reference directory")
flag.StringVar(&intentGuidePath, "intent-guide", "skills/mono/references/intent-guide.md", "Cross-product intent guide path") flag.StringVar(&intentGuidePath, "intent-guide", "skills/mono/references/intent-guide.md", "Cross-product intent guide path")
flag.StringVar(&hintsDir, "hints", "internal/cli/schema_hints", "Versioned Agent hint JSON directory (metadata/ + selection/)") flag.StringVar(&hintsDir, "hints", "internal/cli/schema_hints", "Versioned Agent hint JSON directory (required selection/; optional metadata/ shells)")
flag.StringVar(&interfaceMetadataPath, "interface-metadata", "internal/cli/schema_mcp_metadata.json", "Sanitized versioned MCP metadata used only for fallback Agent summaries") flag.StringVar(&interfaceMetadataPath, "interface-metadata", "internal/cli/schema_mcp_metadata.json", "Sanitized versioned MCP metadata used only for fallback Agent summaries")
flag.StringVar(&outputPath, "output", "", "Output embedded Agent metadata JSON file (legacy single-file mode)") flag.StringVar(&outputPath, "output", "", "Output embedded Agent metadata JSON file (legacy single-file mode)")
flag.StringVar(&outputDir, "output-dir", "", "Output directory for split embedded Agent metadata JSON") flag.StringVar(&outputDir, "output-dir", "", "Output directory for split embedded Agent metadata JSON")
@@ -441,11 +441,10 @@ func mergeRegistryShards(dir string) ([]byte, error) {
func validateSelectionHintInput(rootPath, hintsDir string, registry commandRegistryProjection) error { func validateSelectionHintInput(rootPath, hintsDir string, registry commandRegistryProjection) error {
hintsRoot := resolveRootPath(rootPath, hintsDir) hintsRoot := resolveRootPath(rootPath, hintsDir)
selectionRoot := filepath.Join(hintsRoot, "selection") selectionRoot := filepath.Join(hintsRoot, "selection")
metadataRoot := filepath.Join(hintsRoot, "metadata") // selection/ is required. metadata/ is optional: empty tools shells or a
for _, dir := range []string{selectionRoot, metadataRoot} { // missing directory are valid once leaf facts live on Contract (phase 5).
if info, err := os.Stat(dir); err != nil || !info.IsDir() { if info, err := os.Stat(selectionRoot); err != nil || !info.IsDir() {
return fmt.Errorf("required Agent hint directory missing: %s", dir) return fmt.Errorf("required Agent hint directory missing: %s", selectionRoot)
}
} }
selectionFS := os.DirFS(selectionRoot) selectionFS := os.DirFS(selectionRoot)
agentHints, err := loadSelectionMetadataHints(selectionFS) agentHints, err := loadSelectionMetadataHints(selectionFS)
internal/generator/cmd_schema_agent_metadata/main_test.go
+30
View File
@@ -16,6 +16,7 @@ package main
import ( import (
"encoding/json" "encoding/json"
"flag" "flag"
"io/fs"
"os" "os"
"path/filepath" "path/filepath"
"strings" "strings"
@@ -239,6 +240,35 @@ func TestValidateSelectionHintInputRequiresHintDirs(t *testing.T) {
} }
} }
func TestValidateSelectionHintInputAllowsMissingMetadataDir(t *testing.T) {
originalLoadHints := loadSelectionMetadataHints
originalValidateSet := validateSelectionMetadataSet
originalExamples := validateSelectionExamples
originalContract := validateSelectionContract
t.Cleanup(func() {
loadSelectionMetadataHints = originalLoadHints
validateSelectionMetadataSet = originalValidateSet
validateSelectionExamples = originalExamples
validateSelectionContract = originalContract
})
root := t.TempDir()
if err := os.MkdirAll(filepath.Join(root, "hints", "selection"), 0o755); err != nil {
t.Fatal(err)
}
loadSelectionMetadataHints = func(fs.FS) (cli.ManualAgentHintSet, error) {
return cli.ManualAgentHintSet{}, nil
}
validateSelectionMetadataSet = func(cli.ManualAgentHintSet, map[string]bool, map[string]bool) error { return nil }
validateSelectionExamples = func(cli.BoundCommandRegistry, cli.ManualAgentHintSet) error { return nil }
validateSelectionContract = func(cli.BoundCommandRegistry, cli.ManualAgentHintSet) (cli.ManualAgentSelectionReport, error) {
return cli.ManualAgentSelectionReport{}, nil
}
if err := validateSelectionHintInput(root, "hints", commandRegistryProjection{}); err != nil {
t.Fatalf("missing metadata/ must be optional: %v", err)
}
}
func TestValidateAgentMetadataOutputAllowlist(t *testing.T) { func TestValidateAgentMetadataOutputAllowlist(t *testing.T) {
root := t.TempDir() root := t.TempDir()
canonicalDir := filepath.Join(root, "internal/cli/schema_agent_metadata") canonicalDir := filepath.Join(root, "internal/cli/schema_agent_metadata")
internal/helpers/aitable.go
+19
View File
@@ -1642,6 +1642,11 @@ config 结构参考：
AvoidWhen: []string{"改字段名/配置用 field update（不可改类型）；删字段用 field delete；调列顺序用 view update"}, AvoidWhen: []string{"改字段名/配置用 field update（不可改类型）；删字段用 field delete；调列顺序用 view update"},
Examples: []string{"dws aitable field create --base-id <BASE_ID> --table-id <TABLE_ID> --name \"状态\" --type singleSelect"}, Examples: []string{"dws aitable field create --base-id <BASE_ID> --table-id <TABLE_ID> --name \"状态\" --type singleSelect"},
}, },
// fields required was RegisterSchemaHints tool_schema_hint; publish via
// ParamDecl (Agent may still use --name/--type as a single-field path).
Parameters: []corecmd.ParamDecl{
{Name: "fields", Required: boolPtr(true), InterfaceType: "array"},
},
}, },
}) })
@@ -3227,6 +3232,10 @@ colorConfigs (JSON 数组) / officialHoliday (bool)。`,
AvoidWhen: []string{"没有独立 field reorder；只读用 get visible-fields；首列字段须保留第一位"}, AvoidWhen: []string{"没有独立 field reorder；只读用 get visible-fields；首列字段须保留第一位"},
Examples: []string{"dws aitable view update visible-fields --base-id BASE_ID --table-id TABLE_ID --view-id VIEW_ID --field-ids fld1,fld2,fld3"}, Examples: []string{"dws aitable view update visible-fields --base-id BASE_ID --table-id TABLE_ID --view-id VIEW_ID --field-ids fld1,fld2,fld3"},
}, },
// field-ids required was RegisterSchemaHints tool_schema_hint.
Parameters: []corecmd.ParamDecl{
{Name: "field-ids", Required: boolPtr(true)},
},
}, },
}) })
@@ -4587,6 +4596,11 @@ valid=false 仍表示 DSL 校验或发布未通过，必须读取 issues 修正
AvoidWhen: []string{"配置模板先看 config-example；删仪表盘用 delete"}, AvoidWhen: []string{"配置模板先看 config-example；删仪表盘用 delete"},
Examples: []string{"dws aitable dashboard create --base-id <BASE_ID> --name \"运营看板\""}, Examples: []string{"dws aitable dashboard create --base-id <BASE_ID> --name \"运营看板\""},
}, },
// name required was RegisterSchemaHints tool_schema_hint (Agent prefers
// --name; runtime still accepts --config alone).
Parameters: []corecmd.ParamDecl{
{Name: "name", Required: boolPtr(true)},
},
}, },
}) })
@@ -4641,6 +4655,11 @@ valid=false 仍表示 DSL 校验或发布未通过，必须读取 issues 修正
AvoidWhen: []string{"排版布局用 dashboard arrange；删用 delete"}, AvoidWhen: []string{"排版布局用 dashboard arrange；删用 delete"},
Examples: []string{"dws aitable dashboard update --base-id <BASE_ID> --dashboard-id <DASHBOARD_ID> --name \"新看板\""}, Examples: []string{"dws aitable dashboard update --base-id <BASE_ID> --dashboard-id <DASHBOARD_ID> --name \"新看板\""},
}, },
// name required was RegisterSchemaHints tool_schema_hint (Agent prefers
// --name; runtime still accepts --config alone).
Parameters: []corecmd.ParamDecl{
{Name: "name", Required: boolPtr(true)},
},
}, },
}) })
internal/helpers/attendance.go
+20
View File
@@ -583,6 +583,10 @@ func newAttendanceCommand() *cobra.Command {
"dws attendance record get --user USER_ID --date 2026-03-08", "dws attendance record get --user USER_ID --date 2026-03-08",
}, },
}, },
Parameters: []corecmd.ParamDecl{
{Name: "user", Required: boolPtr(true)},
{Name: "date", Required: boolPtr(true)},
},
}, },
}) })
@@ -994,6 +998,11 @@ func newAttendanceCommand() *cobra.Command {
}, },
Examples: []string{"dws attendance shift list --users userId1,userId2 --start 2026-03-03 --end 2026-03-07"}, Examples: []string{"dws attendance shift list --users userId1,userId2 --start 2026-03-03 --end 2026-03-07"},
}, },
Parameters: []corecmd.ParamDecl{
{Name: "users", Required: boolPtr(true), InterfaceType: "array"},
{Name: "start", Required: boolPtr(true)},
{Name: "end", Required: boolPtr(true)},
},
}, },
}) })
@@ -2310,6 +2319,11 @@ statsType 统计类型支持：week（周统计）、month（月统计）。`,
"dws attendance summary --user USER_ID --date \"2026-03-12 15:00:00\" --stats-type month", "dws attendance summary --user USER_ID --date \"2026-03-12 15:00:00\" --stats-type month",
}, },
}, },
Parameters: []corecmd.ParamDecl{
{Name: "user", Required: boolPtr(true)},
{Name: "date", Required: boolPtr(true)},
{Name: "stats-type", Required: boolPtr(true)},
},
}, },
}) })
@@ -2365,6 +2379,9 @@ statsType 统计类型支持：week（周统计）、month（月统计）。`,
"dws attendance rules --date 2026-03-14", "dws attendance rules --date 2026-03-14",
}, },
}, },
Parameters: []corecmd.ParamDecl{
{Name: "date", Required: boolPtr(true)},
},
}, },
}) })
@@ -4107,6 +4124,9 @@ statsType 统计类型支持：week（周统计）、month（月统计）。`,
"dws attendance boss-check --result-id 789012 --result Normal", "dws attendance boss-check --result-id 789012 --result Normal",
}, },
}, },
Parameters: []corecmd.ParamDecl{
{Name: "plan-id", Required: boolPtr(true)},
},
}, },
}) })
internal/helpers/calendar.go
+25
View File
@@ -10,6 +10,7 @@ import (
"time" "time"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/cli" "github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/cli"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/corecmd"
"github.com/spf13/cobra" "github.com/spf13/cobra"
) )
@@ -468,6 +469,13 @@ func newCalendarCommand() *cobra.Command {
"dws calendar event create --title \"周会\" --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T15:00:00+08:00\" --attendees userId1,userId2", "dws calendar event create --title \"周会\" --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T15:00:00+08:00\" --attendees userId1,userId2",
}, },
}, },
// Former RegisterSchemaHints pins (create required + recurrence
// required_when) — native_annotation outranks tool_schema_hint.
Parameters: append([]corecmd.ParamDecl{
{Name: "title", Required: boolPtr(true)},
{Name: "start", Required: boolPtr(true)},
{Name: "end", Required: boolPtr(true)},
}, calendarRecurrenceParamDecls()...),
}, },
}) })
@@ -548,6 +556,7 @@ func newCalendarCommand() *cobra.Command {
"dws calendar event update --id <EVENT_ID> --desc \"新描述\" --timezone Asia/Tokyo", "dws calendar event update --id <EVENT_ID> --desc \"新描述\" --timezone Asia/Tokyo",
}, },
}, },
Parameters: calendarRecurrenceParamDecls(),
}, },
}) })
@@ -2504,6 +2513,22 @@ var recurrenceFlagNames = []string{
"recurrence-range-type", "recurrence-end-date", "recurrence-count", "recurrence-range-type", "recurrence-end-date", "recurrence-count",
} }
// calendarRecurrenceParamDecls migrates former RegisterSchemaHints recurrence
// required/required_when pins onto create/update event leaves so Schema
// assembly resolves them as native_annotation (outranking tool_schema_hint).
func calendarRecurrenceParamDecls() []corecmd.ParamDecl {
return []corecmd.ParamDecl{
{Name: "recurrence-day-of-month", Required: boolPtr(false), RequiredWhen: "recurrence-type is absoluteMonthly or absoluteYearly"},
{Name: "recurrence-days-of-week", Required: boolPtr(false), RequiredWhen: "recurrence-type is weekly or relativeMonthly"},
{Name: "recurrence-index", Required: boolPtr(false), RequiredWhen: "recurrence-type is relativeMonthly"},
{Name: "recurrence-interval", Required: boolPtr(false), RequiredWhen: "any recurrence-* flag is provided"},
{Name: "recurrence-type", Required: boolPtr(false), RequiredWhen: "any recurrence-* flag is provided"},
{Name: "recurrence-end-date", Required: boolPtr(false), RequiredWhen: "recurrence-range-type is endDate"},
{Name: "recurrence-count", Required: boolPtr(false), RequiredWhen: "recurrence-range-type is numbered"},
{Name: "recurrence-range-type", Required: boolPtr(false), RequiredWhen: "any recurrence-* flag is provided"},
}
}
// recurrenceIncompleteSuggestion is the canonical reminder appended to any // recurrenceIncompleteSuggestion is the canonical reminder appended to any
// recurrence validation error. It explains that the CLI flattens a nested // recurrence validation error. It explains that the CLI flattens a nested
// MCP object and that partial updates are NOT supported by the backend. // MCP object and that partial updates are NOT supported by the backend.
internal/helpers/calendar_recurrence_paramdecl_test.go
+40
View File
@@ -0,0 +1,40 @@
package helpers
import (
"testing"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/corecmd"
)
func TestCalendarRecurrenceParamDeclsCoverHintPins(t *testing.T) {
decls := calendarRecurrenceParamDecls()
byName := map[string]corecmd.ParamDecl{}
for _, d := range decls {
byName[d.Name] = d
}
want := map[string]string{
"recurrence-day-of-month": "recurrence-type is absoluteMonthly or absoluteYearly",
"recurrence-days-of-week": "recurrence-type is weekly or relativeMonthly",
"recurrence-index": "recurrence-type is relativeMonthly",
"recurrence-interval": "any recurrence-* flag is provided",
"recurrence-type": "any recurrence-* flag is provided",
"recurrence-end-date": "recurrence-range-type is endDate",
"recurrence-count": "recurrence-range-type is numbered",
"recurrence-range-type": "any recurrence-* flag is provided",
}
if len(decls) != len(want) {
t.Fatalf("calendarRecurrenceParamDecls len = %d, want %d: %#v", len(decls), len(want), decls)
}
for name, when := range want {
d, ok := byName[name]
if !ok {
t.Fatalf("missing ParamDecl %q", name)
}
if d.Required == nil || *d.Required {
t.Fatalf("%s Required = %#v, want explicit false", name, d.Required)
}
if d.RequiredWhen != when {
t.Fatalf("%s RequiredWhen = %q, want %q", name, d.RequiredWhen, when)
}
}
}
internal/helpers/ding.go
+8 -1
View File
@@ -2,11 +2,13 @@ package helpers
import ( import (
"fmt" "fmt"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/cli"
"os" "os"
"strings" "strings"
"github.com/spf13/cobra" "github.com/spf13/cobra"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/cli"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/corecmd"
) )
// ────────────────────────────────────────────────────────── // ──────────────────────────────────────────────────────────
@@ -91,6 +93,11 @@ func newDingCommand() *cobra.Command {
"dws ding message send --robot-code <ROBOT_CODE> --type call --users userId1 --content \"紧急告警\" --format json", "dws ding message send --robot-code <ROBOT_CODE> --type call --users userId1 --content \"紧急告警\" --format json",
}, },
}, },
Parameters: []corecmd.ParamDecl{
{Name: "content", Required: boolPtr(true)},
{Name: "robot-code", Required: boolPtr(true)},
{Name: "users", Required: boolPtr(true), InterfaceType: "array"},
},
}, },
}) })
internal/helpers/doc.go
+10
View File
@@ -1097,6 +1097,7 @@ func newDocCommand() *cobra.Command {
}, },
}, },
Parameters: []corecmd.ParamDecl{ Parameters: []corecmd.ParamDecl{
{Name: "node", Required: boolPtr(true)},
{Name: "content-format", Property: "format", Required: boolPtr(false)}, {Name: "content-format", Property: "format", Required: boolPtr(false)},
{Name: "end-block-id", Required: boolPtr(false)}, {Name: "end-block-id", Required: boolPtr(false)},
{Name: "max-depth", Required: boolPtr(false), InterfaceType: "integer"}, {Name: "max-depth", Required: boolPtr(false), InterfaceType: "integer"},
@@ -1219,6 +1220,9 @@ func newDocCommand() *cobra.Command {
"dws doc create --name \"Q1 总结\" --content \"# Q1 总结\" --folder <FOLDER_ID> --format json", "dws doc create --name \"Q1 总结\" --content \"# Q1 总结\" --folder <FOLDER_ID> --format json",
}, },
}, },
Parameters: []corecmd.ParamDecl{
{Name: "name", Required: boolPtr(true)},
},
}, },
}) })
@@ -1344,6 +1348,9 @@ WARNING: --mode overwrite 为破坏性写入，会清空原文档全部内容。
"dws doc update --node <DOC_ID> --content-file ./body.md --mode overwrite --dry-run", "dws doc update --node <DOC_ID> --content-file ./body.md --mode overwrite --dry-run",
}, },
}, },
Parameters: []corecmd.ParamDecl{
{Name: "node", Required: boolPtr(true)},
},
}, },
}) })
@@ -2026,6 +2033,9 @@ WARNING: --mode overwrite 为破坏性写入，会清空原文档全部内容。
}, },
Examples: []string{"dws doc delete --node <DOC_ID> --format json"}, Examples: []string{"dws doc delete --node <DOC_ID> --format json"},
}, },
Parameters: []corecmd.ParamDecl{
{Name: "node", Required: boolPtr(true)},
},
}, },
}) })
internal/helpers/minutes.go
+5 -1
View File
@@ -2,9 +2,10 @@ package helpers
import ( import (
"fmt" "fmt"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/cli"
"strconv" "strconv"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/cli"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/corecmd"
"github.com/spf13/cobra" "github.com/spf13/cobra"
) )
@@ -188,6 +189,9 @@ func newMinutesCommand() *cobra.Command {
"dws minutes get summary --id <taskUuid> --format json", "dws minutes get summary --id <taskUuid> --format json",
}, },
}, },
Parameters: []corecmd.ParamDecl{
{Name: "id", Required: boolPtr(true)},
},
}, },
}) })
internal/helpers/sheet_workbook.go
+18 -1
View File
@@ -2,8 +2,9 @@ package helpers
import ( import (
"fmt" "fmt"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/cli"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/cli"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/corecmd"
"github.com/spf13/cobra" "github.com/spf13/cobra"
) )
@@ -50,6 +51,11 @@ func newWorkbookCmds() []*cobra.Command {
"dws sheet create --name \"Q1 数据\" --folder <FOLDER_ID>", "dws sheet create --name \"Q1 数据\" --folder <FOLDER_ID>",
}, },
}, },
// name is validated via mustGetFlag; publish required via ParamDecl
// instead of relying on RegisterSchemaHints tool_schema_hint.
Parameters: []corecmd.ParamDecl{
{Name: "name", Required: boolPtr(true)},
},
}, },
}) })
createCmd.Flags().String("name", "", "表格名称 (必填)") createCmd.Flags().String("name", "", "表格名称 (必填)")
@@ -89,6 +95,11 @@ nodeId 支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动
AvoidWhen: []string{"要看单个工作表行列边界与合并区用 sheet info；读单元格内容用 sheet range read"}, AvoidWhen: []string{"要看单个工作表行列边界与合并区用 sheet info；读单元格内容用 sheet range read"},
Examples: []string{"dws sheet list --node <NODE_ID>"}, Examples: []string{"dws sheet list --node <NODE_ID>"},
}, },
// node is validated via mustGetFlag; publish required via ParamDecl
// instead of relying on RegisterSchemaHints tool_schema_hint.
Parameters: []corecmd.ParamDecl{
{Name: "node", Required: boolPtr(true)},
},
}, },
}) })
listCmd.Flags().String("node", "", "表格文档 ID 或 URL (必填)") listCmd.Flags().String("node", "", "表格文档 ID 或 URL (必填)")
@@ -180,6 +191,12 @@ sheetId 支持传入工作表 ID 或工作表名称，可通过 sheet list 获
AvoidWhen: []string{"要新建整份表格文档用 sheet create；复制已有工作表用 sheet copy；删除工作表用 sheet delete-sheet"}, AvoidWhen: []string{"要新建整份表格文档用 sheet create；复制已有工作表用 sheet copy；删除工作表用 sheet delete-sheet"},
Examples: []string{"dws sheet new --node <NODE_ID> --name \"Sheet2\""}, Examples: []string{"dws sheet new --node <NODE_ID> --name \"Sheet2\""},
}, },
// node/name validated via mustGetFlag; publish required via ParamDecl
// instead of relying on RegisterSchemaHints tool_schema_hint.
Parameters: []corecmd.ParamDecl{
{Name: "node", Required: boolPtr(true)},
{Name: "name", Required: boolPtr(true)},
},
}, },
}) })
newCmd.Flags().String("node", "", "表格文档 ID (必填)") newCmd.Flags().String("node", "", "表格文档 ID (必填)")
internal/helpers/wiki.go
+12 -1
View File
@@ -2,11 +2,12 @@ package helpers
import ( import (
"fmt" "fmt"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/cli"
"os" "os"
"strconv" "strconv"
"strings" "strings"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/cli"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/corecmd"
"github.com/spf13/cobra" "github.com/spf13/cobra"
) )
@@ -196,6 +197,11 @@ func newWikiCommand() *cobra.Command {
"dws wiki space create --name \"技术方案\" --desc \"团队技术方案归档\" --format json", "dws wiki space create --name \"技术方案\" --desc \"团队技术方案归档\" --format json",
}, },
}, },
// name is validated in RunE; publish required via ParamDecl
// instead of relying on RegisterSchemaHints tool_schema_hint.
Parameters: []corecmd.ParamDecl{
{Name: "name", Required: boolPtr(true)},
},
}, },
}) })
@@ -235,6 +241,11 @@ func newWikiCommand() *cobra.Command {
AvoidWhen: []string{"列知识库用 list；删库用 space delete（需确认）"}, AvoidWhen: []string{"列知识库用 list；删库用 space delete（需确认）"},
Examples: []string{"dws wiki space get --workspace <workspaceId> --format json"}, Examples: []string{"dws wiki space get --workspace <workspaceId> --format json"},
}, },
// workspace is validated in RunE; publish required via ParamDecl
// (former RegisterSchemaHints keyed stale "space").
Parameters: []corecmd.ParamDecl{
{Name: "workspace", Required: boolPtr(true)},
},
}, },
}) })
internal/pat/chmod.go
+12
View File
@@ -29,11 +29,14 @@ import (
authpkg "github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/auth" authpkg "github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/auth"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/cli" "github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/cli"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/corecmd"
apperrors "github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/errors" apperrors "github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/errors"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/helpers" "github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/helpers"
"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/pkg/edition" "github.com/DingTalk-Real-AI/dingtalk-workspace-cli/pkg/edition"
) )
func boolPtr(v bool) *bool { return &v }
type LoginRecommendOptions struct { type LoginRecommendOptions struct {
// ProductCodes limits the recommend plan to service-owned product domains. // ProductCodes limits the recommend plan to service-owned product domains.
ProductCodes []string ProductCodes []string
@@ -461,6 +464,15 @@ agentCode 配置:
}, },
Examples: []string{"dws pat chmod --products calendar,aitable --grant-type session --session-id <SESSION_ID> --dry-run --format json"}, Examples: []string{"dws pat chmod --products calendar,aitable --grant-type session --session-id <SESSION_ID> --dry-run --format json"},
}, },
// session-id is conditionally required in Validate; publish via
// ParamDecl instead of relying on RegisterSchemaHints tool_schema_hint.
Parameters: []corecmd.ParamDecl{
{
Name: "session-id",
Required: boolPtr(false),
RequiredWhen: "grant-type is session",
},
},
}, },
}) })
return chmodCmd return chmodCmd
scripts/policy/check-generated-drift.sh
+25 -5
View File
@@ -30,10 +30,19 @@ concepts_guard="$tmp/param_concepts.json"
concepts_schema_guard="$tmp/param_concepts.schema.json" concepts_schema_guard="$tmp/param_concepts.schema.json"
cp internal/cli/param_concepts.json "$concepts_guard" cp internal/cli/param_concepts.json "$concepts_guard"
cp internal/cli/param_concepts.schema.json "$concepts_schema_guard" cp internal/cli/param_concepts.schema.json "$concepts_schema_guard"
# Also guard human-authored metadata + selection hint trees. # Guard human-authored selection (required) and metadata (optional).
metadata_guard="$tmp/metadata-hints" # schema_hints/metadata may be absent, an empty directory, or hold only
# reserved product shells with tools: {} / missing tools — none of those
# alone is drift. When the directory is present, keep a byte guard so
# generation cannot rewrite those shells; never fail solely because the
# directory is missing or every product shell has empty tools.
metadata_dir="internal/cli/schema_hints/metadata"
metadata_guard=""
if [ -d "$metadata_dir" ]; then
metadata_guard="$tmp/metadata-hints"
cp -R "$metadata_dir" "$metadata_guard"
fi
selection_guard="$tmp/selection-hints" selection_guard="$tmp/selection-hints"
cp -R internal/cli/schema_hints/metadata "$metadata_guard"
cp -R internal/cli/schema_hints/selection "$selection_guard" cp -R internal/cli/schema_hints/selection "$selection_guard"
metadata_tmp="$tmp/metadata" metadata_tmp="$tmp/metadata"
@@ -94,8 +103,19 @@ if ! cmp -s internal/cli/param_concepts.schema.json "$concepts_schema_guard"; th
exit 1 exit 1
fi fi
if ! diff -qr internal/cli/schema_hints/metadata "$metadata_guard" >/dev/null; then # Optional metadata: presence/absence and empty tools:{} shells are all OK.
printf '%s\n' 'generation modified reviewed input internal/cli/schema_hints/metadata' >&2 # Fail only if generation mutates, removes, or invents the directory tree.
if [ -n "$metadata_guard" ]; then
if [ ! -d "$metadata_dir" ]; then
printf '%s\n' 'generation removed reviewed input internal/cli/schema_hints/metadata' >&2
exit 1
fi
if ! diff -qr "$metadata_dir" "$metadata_guard" >/dev/null; then
printf '%s\n' 'generation modified reviewed input internal/cli/schema_hints/metadata' >&2
exit 1
fi
elif [ -d "$metadata_dir" ]; then
printf '%s\n' 'generation created reviewed input internal/cli/schema_hints/metadata' >&2
exit 1 exit 1
fi fi
scripts/policy/check-runtime-confirmation-truth.sh
+60 -44
View File
@@ -2,19 +2,19 @@
set -eu set -eu
# Ensure catalog confirmation=user_required exactly matches executable truth: # Ensure catalog confirmation=user_required exactly matches executable truth:
# typed corecmd Contract SafetySpec declarations plus migration-only metadata # typed corecmd Contract SafetySpec declarations plus any residual migration-only
# runtime_gate != none entries. # metadata runtime_gate != none entries.
#
# schema_hints/metadata is optional: the directory may be absent, contain no
# JSON files, or hold only empty product shells (tools: {} / missing tools).
# Empty shells contribute zero gated keys; Contract SafetySpec remains the
# production truth source.
ROOT="$(CDPATH= cd -- "$(dirname -- "$0")/../.." && pwd)" ROOT="$(CDPATH= cd -- "$(dirname -- "$0")/../.." && pwd)"
cd "$ROOT" cd "$ROOT"
metadata_dir="internal/cli/schema_hints/metadata" metadata_dir="internal/cli/schema_hints/metadata"
if [ ! -d "$metadata_dir" ]; then
printf '%s\n' "missing agent metadata directory: $metadata_dir" >&2
exit 1
fi
tmp="$(mktemp -d)" tmp="$(mktemp -d)"
trap 'rm -rf "$tmp"' EXIT HUP INT TERM trap 'rm -rf "$tmp"' EXIT HUP INT TERM
@@ -23,12 +23,24 @@ trap 'rm -rf "$tmp"' EXIT HUP INT TERM
catalog="$tmp/catalog-combined.json" catalog="$tmp/catalog-combined.json"
scripts/policy/with-catalog.sh >"$catalog" scripts/policy/with-catalog.sh >"$catalog"
jq -r ' : >"$tmp/metadata_files"
.tools : >"$tmp/metadata_gated"
| to_entries[] if [ -d "$metadata_dir" ]; then
| select((.value.runtime_gate // "none") != "none") # Collect JSON paths without relying on nullglob (POSIX sh).
| .key find "$metadata_dir" -maxdepth 1 -type f -name '*.json' | sort >"$tmp/metadata_files"
' "$metadata_dir"/*.json >"$tmp/metadata_gated" fi
if [ -s "$tmp/metadata_files" ]; then
# shellcheck disable=SC2046
# (.tools // {}) treats missing/null tools as an empty object so reserved
# product shells without tool rows do not fail the gate.
jq -r '
(.tools // {})
| to_entries[]
| select((.value.runtime_gate // "none") != "none")
| .key
' $(cat "$tmp/metadata_files") >"$tmp/metadata_gated"
fi
jq -r ' jq -r '
.tools .tools
@@ -48,42 +60,46 @@ jq -r '
' "$catalog" | sort >"$tmp/catalog_required" ' "$catalog" | sort >"$tmp/catalog_required"
if ! cmp -s "$tmp/truth_gated" "$tmp/catalog_required"; then if ! cmp -s "$tmp/truth_gated" "$tmp/catalog_required"; then
printf '%s\n' 'catalog confirmation=user_required differs from Contract SafetySpec + metadata runtime_gate truth' >&2 printf '%s\n' 'catalog confirmation=user_required differs from Contract SafetySpec + residual metadata runtime_gate truth' >&2
printf '%s\n' 'declare corecmd Safety.Confirmation or update migration-only metadata runtime_gate, then regenerate schema' >&2 printf '%s\n' 'declare corecmd Safety.Confirmation (or residual migration-only metadata runtime_gate), then regenerate schema' >&2
diff -u "$tmp/truth_gated" "$tmp/catalog_required" || true diff -u "$tmp/truth_gated" "$tmp/catalog_required" || true
exit 1 exit 1
fi fi
jq -s ' : >"$tmp/gate_problems"
reduce .[] as $file ({}; if [ -s "$tmp/metadata_files" ]; then
. * ( # shellcheck disable=SC2046
$file.tools jq -s '
| to_entries reduce .[] as $file ({};
| map({key: .key, value: (.value.runtime_gate // "none")}) . * (
| from_entries ($file.tools // {})
) | to_entries
) | map({key: .key, value: (.value.runtime_gate // "none")})
' "$metadata_dir"/*.json >"$tmp/gates.json" | from_entries
)
)
' $(cat "$tmp/metadata_files") >"$tmp/gates.json"
jq -r --slurpfile catalog "$catalog" ' jq -r --slurpfile catalog "$catalog" '
. as $gate_map | . as $gate_map |
($catalog[0].tools) as $tools | ($catalog[0].tools) as $tools |
$gate_map $gate_map
| to_entries[] | to_entries[]
| .key as $canonical | .key as $canonical
| .value as $gate | .value as $gate
| $tools[$canonical] as $tool | $tools[$canonical] as $tool
| select($tool != null) | select($tool != null)
| select($tool.field_provenance.confirmation.source != "corecmd.contract") | select($tool.field_provenance.confirmation.source != "corecmd.contract")
| select( | select(
if $gate == "none" then if $gate == "none" then
$tool.confirmation != "not_required" or $tool.risk == "high" or $tool.effect == "destructive" $tool.confirmation != "not_required" or $tool.risk == "high" or $tool.effect == "destructive"
else else
$tool.confirmation != "user_required" $tool.confirmation != "user_required"
end end
) )
| "\(.key)\tgate=\(.value)\teffect=\($tool.effect // "MISSING")\trisk=\($tool.risk // "MISSING")\tconfirmation=\($tool.confirmation // "MISSING")" | "\(.key)\tgate=\(.value)\teffect=\($tool.effect // "MISSING")\trisk=\($tool.risk // "MISSING")\tconfirmation=\($tool.confirmation // "MISSING")"
' "$tmp/gates.json" >"$tmp/gate_problems" || true ' "$tmp/gates.json" >"$tmp/gate_problems" || true
fi
if [ -s "$tmp/gate_problems" ]; then if [ -s "$tmp/gate_problems" ]; then
printf '%s\n' 'schema_hints/metadata runtime_gate disagree with catalog effect/risk/confirmation' >&2 printf '%s\n' 'schema_hints/metadata runtime_gate disagree with catalog effect/risk/confirmation' >&2
Loaded 100 of 101 files, more files were not shown because too many files have changed in this diff. Show more