dingtalk-workspace-cli/internal/cli/schema_agent_metadata/whiteboard.json

{
  "product_id": "whiteboard",
  "tools": {
    "whiteboard query": {
      "agent_summary": "读取钉钉文档内已有白板的 OpenNodes 内容",
      "agent_summary_source": "dws-agent-selection/whiteboard",
      "availability": "available",
      "avoid_when": [
        "创建新白板卡片用 doc whiteboard insert；缺少 partId 时先从文档 card metadata.id 定位"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "agent-hint",
      "examples": [
        "dws whiteboard query --node \u003cDOC_ID\u003e --part-id \u003cWHITEBOARD_PART_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "读取钉钉文档内已有白板的 OpenNodes 内容",
          "source": "internal/cli/schema_hints/selection/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "依据 Wukong feat/support-whiteboard-2 最终分支 tip 的真实 Cobra 路由与 OpenNodes 协议人工迁移。",
          "candidates": [
            {
              "value": "读取钉钉文档内已有白板的 OpenNodes 内容",
              "source": "internal/cli/schema_hints/selection/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "依据 Wukong feat/support-whiteboard-2 最终分支 tip 的真实 Cobra 路由与 OpenNodes 协议人工迁移。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding.",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding."
            }
          ]
        },
        "avoid_when": {
          "value": [
            "创建新白板卡片用 doc whiteboard insert；缺少 partId 时先从文档 card metadata.id 定位"
          ],
          "source": "internal/cli/schema_hints/selection/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "依据 Wukong feat/support-whiteboard-2 最终分支 tip 的真实 Cobra 路由与 OpenNodes 协议人工迁移。",
          "candidates": [
            {
              "value": [
                "创建新白板卡片用 doc whiteboard insert；缺少 partId 时先从文档 card metadata.id 定位"
              ],
              "source": "internal/cli/schema_hints/selection/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "依据 Wukong feat/support-whiteboard-2 最终分支 tip 的真实 Cobra 路由与 OpenNodes 协议人工迁移。"
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding.",
          "candidates": [
            {
              "value": "not_required",
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding."
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding.",
          "candidates": [
            {
              "value": "read",
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding."
            },
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws whiteboard query --node \u003cDOC_ID\u003e --part-id \u003cWHITEBOARD_PART_ID\u003e --format json"
          ],
          "source": "internal/cli/schema_hints/selection/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "依据 Wukong feat/support-whiteboard-2 最终分支 tip 的真实 Cobra 路由与 OpenNodes 协议人工迁移。",
          "candidates": [
            {
              "value": [
                "dws whiteboard query --node \u003cDOC_ID\u003e --part-id \u003cWHITEBOARD_PART_ID\u003e --format json"
              ],
              "source": "internal/cli/schema_hints/selection/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "依据 Wukong feat/support-whiteboard-2 最终分支 tip 的真实 Cobra 路由与 OpenNodes 协议人工迁移。"
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding.",
          "candidates": [
            {
              "value": "idempotent",
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding."
            },
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding.",
          "candidates": [
            {
              "value": "composite",
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding."
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed explicit whiteboard server adapter; the endpoint is helper-only and intentionally absent from the pinned public discovery snapshot.",
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding.",
          "candidates": [
            {
              "value": "Reviewed explicit whiteboard server adapter; the endpoint is helper-only and intentionally absent from the pinned public discovery snapshot.",
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding."
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding.",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding."
            },
            {
              "value": true,
              "source": "internal/cli/schema_hints/selection/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": false,
              "review_reason": "依据 Wukong feat/support-whiteboard-2 最终分支 tip 的真实 Cobra 路由与 OpenNodes 协议人工迁移。"
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding.",
          "candidates": [
            {
              "value": "low",
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 with exact nodeId and partId routing and structured resultJson decoding."
            },
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "已知承载文档 nodeId 和白板 partId，需要检查当前白板节点、布局或写入支持时"
          ],
          "source": "internal/cli/schema_hints/selection/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "依据 Wukong feat/support-whiteboard-2 最终分支 tip 的真实 Cobra 路由与 OpenNodes 协议人工迁移。",
          "candidates": [
            {
              "value": [
                "已知承载文档 nodeId 和白板 partId，需要检查当前白板节点、布局或写入支持时"
              ],
              "source": "internal/cli/schema_hints/selection/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "依据 Wukong feat/support-whiteboard-2 最终分支 tip 的真实 Cobra 路由与 OpenNodes 协议人工迁移。"
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed explicit whiteboard server adapter; the endpoint is helper-only and intentionally absent from the pinned public discovery snapshot.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "CommandRegistry:canonical_path=whiteboard.query",
        "cobra-help:dws whiteboard query",
        "dws-wukong@e2da8ab947c6:wukong/products/whiteboard.go",
        "internal/cli/schema_hints/metadata/whiteboard.json",
        "internal/cli/schema_hints/selection/whiteboard.json",
        "skills/mono/references/products/whiteboard/open-nodes-v1/02-query.md",
        "skills/mono/references/products/whiteboard/recipes.md"
      ],
      "use_when": [
        "已知承载文档 nodeId 和白板 partId，需要检查当前白板节点、布局或写入支持时"
      ]
    },
    "whiteboard update": {
      "agent_summary": "经用户确认后向已有白板追加 OpenNodes 或整页重建",
      "agent_summary_source": "dws-agent-selection/whiteboard",
      "availability": "available",
      "avoid_when": [
        "只读取内容用 whiteboard query；创建白板卡片用 doc whiteboard insert；不要用真实节点 ID 做局部修改"
      ],
      "confirmation": "user_required",
      "effect": "write",
      "effect_source": "agent-hint",
      "examples": [
        "dws whiteboard update --node \u003cDOC_ID\u003e --part-id \u003cWHITEBOARD_PART_ID\u003e --source ./whiteboard.json --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "经用户确认后向已有白板追加 OpenNodes 或整页重建",
          "source": "internal/cli/schema_hints/selection/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "依据 Wukong feat/support-whiteboard-2 的 OpenNodes 校验迁移，并按公网命令级安全模型收紧为每次更新均需确认。",
          "candidates": [
            {
              "value": "经用户确认后向已有白板追加 OpenNodes 或整页重建",
              "source": "internal/cli/schema_hints/selection/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "依据 Wukong feat/support-whiteboard-2 的 OpenNodes 校验迁移，并按公网命令级安全模型收紧为每次更新均需确认。"
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes.",
          "candidates": [
            {
              "value": "available",
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes."
            }
          ]
        },
        "avoid_when": {
          "value": [
            "只读取内容用 whiteboard query；创建白板卡片用 doc whiteboard insert；不要用真实节点 ID 做局部修改"
          ],
          "source": "internal/cli/schema_hints/selection/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "依据 Wukong feat/support-whiteboard-2 的 OpenNodes 校验迁移，并按公网命令级安全模型收紧为每次更新均需确认。",
          "candidates": [
            {
              "value": [
                "只读取内容用 whiteboard query；创建白板卡片用 doc whiteboard insert；不要用真实节点 ID 做局部修改"
              ],
              "source": "internal/cli/schema_hints/selection/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "依据 Wukong feat/support-whiteboard-2 的 OpenNodes 校验迁移，并按公网命令级安全模型收紧为每次更新均需确认。"
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes.",
          "candidates": [
            {
              "value": "user_required",
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes."
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes.",
          "candidates": [
            {
              "value": "write",
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes."
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws whiteboard update --node \u003cDOC_ID\u003e --part-id \u003cWHITEBOARD_PART_ID\u003e --source ./whiteboard.json --format json"
          ],
          "source": "internal/cli/schema_hints/selection/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "依据 Wukong feat/support-whiteboard-2 的 OpenNodes 校验迁移，并按公网命令级安全模型收紧为每次更新均需确认。",
          "candidates": [
            {
              "value": [
                "dws whiteboard update --node \u003cDOC_ID\u003e --part-id \u003cWHITEBOARD_PART_ID\u003e --source ./whiteboard.json --format json"
              ],
              "source": "internal/cli/schema_hints/selection/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "依据 Wukong feat/support-whiteboard-2 的 OpenNodes 校验迁移，并按公网命令级安全模型收紧为每次更新均需确认。"
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes.",
          "candidates": [
            {
              "value": "unknown",
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes."
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes.",
          "candidates": [
            {
              "value": "composite",
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes."
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed explicit whiteboard server adapter with local OpenNodes validation and an unconditional public runtime confirmation gate; no single pinned public interface entry represents the full wrapper contract.",
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes.",
          "candidates": [
            {
              "value": "Reviewed explicit whiteboard server adapter with local OpenNodes validation and an unconditional public runtime confirmation gate; no single pinned public interface entry represents the full wrapper contract.",
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes."
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes.",
          "candidates": [
            {
              "value": true,
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes."
            },
            {
              "value": true,
              "source": "internal/cli/schema_hints/selection/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": false,
              "review_reason": "依据 Wukong feat/support-whiteboard-2 的 OpenNodes 校验迁移，并按公网命令级安全模型收紧为每次更新均需确认。"
            }
          ]
        },
        "risk": {
          "value": "high",
          "source": "internal/cli/schema_hints/metadata/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes.",
          "candidates": [
            {
              "value": "high",
              "source": "internal/cli/schema_hints/metadata/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "Migrated from dws-wukong e2da8ab947c6 and tightened for the public command-level safety model: every remote whiteboard update requires --yes."
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "已有 nodeId、partId 和合规 OpenNodes V1 文件，用户确认后要追加图形、文本、连接线或整页替换时"
          ],
          "source": "internal/cli/schema_hints/selection/whiteboard.json",
          "precedence": "reviewed_explicit",
          "resolution": "highest_precedence",
          "review_reason": "依据 Wukong feat/support-whiteboard-2 的 OpenNodes 校验迁移，并按公网命令级安全模型收紧为每次更新均需确认。",
          "candidates": [
            {
              "value": [
                "已有 nodeId、partId 和合规 OpenNodes V1 文件，用户确认后要追加图形、文本、连接线或整页替换时"
              ],
              "source": "internal/cli/schema_hints/selection/whiteboard.json",
              "precedence": "reviewed_explicit",
              "selected": true,
              "review_reason": "依据 Wukong feat/support-whiteboard-2 的 OpenNodes 校验迁移，并按公网命令级安全模型收紧为每次更新均需确认。"
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed explicit whiteboard server adapter with local OpenNodes validation and an unconditional public runtime confirmation gate; no single pinned public interface entry represents the full wrapper contract.",
      "reviewed": true,
      "risk": "high",
      "source_refs": [
        "CommandRegistry:canonical_path=whiteboard.update",
        "cobra-help:dws whiteboard update",
        "dws-wukong@e2da8ab947c6:wukong/products/whiteboard.go",
        "internal/cli/schema_hints/metadata/whiteboard.json",
        "internal/cli/schema_hints/selection/whiteboard.json",
        "skills/mono/references/products/whiteboard/recipes.md"
      ],
      "use_when": [
        "已有 nodeId、partId 和合规 OpenNodes V1 文件，用户确认后要追加图形、文本、连接线或整页替换时"
      ]
    }
  }
}