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

{
  "product_id": "doc",
  "tools": {
    "doc +comment-create": {
      "agent_summary": "在文档上创建一条评论",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "user_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +comment-create --node DOC_ID --content \"这里需要修改\""
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "在文档上创建一条评论",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "在文档上创建一条评论",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "user_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +comment-create --node DOC_ID --content \"这里需要修改\""
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +comment-create --node DOC_ID --content \"这里需要修改\""
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你想对整篇文档留一条全文评论、给出反馈或 @ 相关同事时使用；输入 node 与评论 content（可带 mention），会实际在文档上发布一条新评论。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你想对整篇文档留一条全文评论、给出反馈或 @ 相关同事时使用；输入 node 与评论 content（可带 mention），会实际在文档上发布一条新评论。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你想对整篇文档留一条全文评论、给出反馈或 @ 相关同事时使用；输入 node 与评论 content（可带 mention），会实际在文档上发布一条新评论。"
      ]
    },
    "doc +comment-list": {
      "agent_summary": "查询文档评论列表",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +comment-list --node DOC_ID",
        "dws doc +comment-list --node DOC_ID --type inline --resolve-status unresolved"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "查询文档评论列表",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "查询文档评论列表",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +comment-list --node DOC_ID",
            "dws doc +comment-list --node DOC_ID --type inline --resolve-status unresolved"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +comment-list --node DOC_ID",
                "dws doc +comment-list --node DOC_ID --type inline --resolve-status unresolved"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你想查看某篇文档上已有的评论、了解有哪些反馈或待处理意见（可按全文/划词、已解决/未解决过滤）时使用；输入 node，返回评论列表及其 commentKey 以便后续回复。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你想查看某篇文档上已有的评论、了解有哪些反馈或待处理意见（可按全文/划词、已解决/未解决过滤）时使用；输入 node，返回评论列表及其 commentKey 以便后续回复。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你想查看某篇文档上已有的评论、了解有哪些反馈或待处理意见（可按全文/划词、已解决/未解决过滤）时使用；输入 node，返回评论列表及其 commentKey 以便后续回复。"
      ]
    },
    "doc +comment-reply": {
      "agent_summary": "回复文档中的一条评论",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "user_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +comment-reply --node DOC_ID --comment-key COMMENT_KEY --content \"同意\""
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "回复文档中的一条评论",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "回复文档中的一条评论",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "user_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +comment-reply --node DOC_ID --comment-key COMMENT_KEY --content \"同意\""
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +comment-reply --node DOC_ID --comment-key COMMENT_KEY --content \"同意\""
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你要针对某条已有评论进行回复、参与讨论或用表情贴图回应时使用；先从评论列表拿到 comment-key，再输入 node、comment-key 与 content（--emoji 则作为表情回复），会实际发布一条回复。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你要针对某条已有评论进行回复、参与讨论或用表情贴图回应时使用；先从评论列表拿到 comment-key，再输入 node、comment-key 与 content（--emoji 则作为表情回复），会实际发布一条回复。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你要针对某条已有评论进行回复、参与讨论或用表情贴图回应时使用；先从评论列表拿到 comment-key，再输入 node、comment-key 与 content（--emoji 则作为表情回复），会实际发布一条回复。"
      ]
    },
    "doc +copy": {
      "agent_summary": "复制文档/文件到指定文件夹或知识库",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "user_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +copy --node DOC_ID --folder TARGET_FOLDER_NODE_ID"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "复制文档/文件到指定文件夹或知识库",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "复制文档/文件到指定文件夹或知识库",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "user_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +copy --node DOC_ID --folder TARGET_FOLDER_NODE_ID"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +copy --node DOC_ID --folder TARGET_FOLDER_NODE_ID"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你想保留原件、在另一个文件夹或知识库里生成一份文档/文件副本（例如以某篇文档为模板另存）时使用；输入源 node 与目标 folder/workspace，会实际创建一个副本。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你想保留原件、在另一个文件夹或知识库里生成一份文档/文件副本（例如以某篇文档为模板另存）时使用；输入源 node 与目标 folder/workspace，会实际创建一个副本。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你想保留原件、在另一个文件夹或知识库里生成一份文档/文件副本（例如以某篇文档为模板另存）时使用；输入源 node 与目标 folder/workspace，会实际创建一个副本。"
      ]
    },
    "doc +doc-append": {
      "agent_summary": "在文档末尾追加一段文本（安全追加，不改动原有内容）",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "user_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +doc-append --doc DOC_ID --text \"补充说明：本方案已评审通过。\"",
        "dws doc +doc-append --doc \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --text \"追加一行备注\""
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "在文档末尾追加一段文本（安全追加，不改动原有内容）",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "在文档末尾追加一段文本（安全追加，不改动原有内容）",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "user_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +doc-append --doc DOC_ID --text \"补充说明：本方案已评审通过。\"",
            "dws doc +doc-append --doc \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --text \"追加一行备注\""
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +doc-append --doc DOC_ID --text \"补充说明：本方案已评审通过。\"",
                "dws doc +doc-append --doc \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --text \"追加一行备注\""
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你只想往一篇钉钉文档的最后面补一段文字、又不想动原有内容时使用；内部用文档更新的“追加(append)”模式，把你给的文本安全地拼到文档末尾，不需要你先去查文档块列表、算末尾位置或手工拼块结构。会真实写入文档内容。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你只想往一篇钉钉文档的最后面补一段文字、又不想动原有内容时使用；内部用文档更新的“追加(append)”模式，把你给的文本安全地拼到文档末尾，不需要你先去查文档块列表、算末尾位置或手工拼块结构。会真实写入文档内容。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你只想往一篇钉钉文档的最后面补一段文字、又不想动原有内容时使用；内部用文档更新的“追加(append)”模式，把你给的文本安全地拼到文档末尾，不需要你先去查文档块列表、算末尾位置或手工拼块结构。会真实写入文档内容。"
      ]
    },
    "doc +export-get": {
      "agent_summary": "根据 jobId 查询文档导出任务结果",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +export-get --job-id JOB_ID"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "根据 jobId 查询文档导出任务结果",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "根据 jobId 查询文档导出任务结果",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +export-get --job-id JOB_ID"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +export-get --job-id JOB_ID"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你已用 +export-submit 提交了导出任务、想查询它是否完成并拿到导出文件的下载链接时使用；输入上一步返回的 job-id，返回任务状态与结果。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你已用 +export-submit 提交了导出任务、想查询它是否完成并拿到导出文件的下载链接时使用；输入上一步返回的 job-id，返回任务状态与结果。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你已用 +export-submit 提交了导出任务、想查询它是否完成并拿到导出文件的下载链接时使用；输入上一步返回的 job-id，返回任务状态与结果。"
      ]
    },
    "doc +export-submit": {
      "agent_summary": "提交在线文档导出任务 (docx/markdown/pdf)，返回 jobId",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +export-submit --node DOC_ID --export-format markdown"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "提交在线文档导出任务 (docx/markdown/pdf)，返回 jobId",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "提交在线文档导出任务 (docx/markdown/pdf)，返回 jobId",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +export-submit --node DOC_ID --export-format markdown"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +export-submit --node DOC_ID --export-format markdown"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你想把在线文档导出成 docx/markdown/pdf 文件（例如离线保存或外发）时使用；这是异步任务的第一步，输入 node 与 export-format 提交导出，返回 jobId，随后用 +export-get 轮询结果。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你想把在线文档导出成 docx/markdown/pdf 文件（例如离线保存或外发）时使用；这是异步任务的第一步，输入 node 与 export-format 提交导出，返回 jobId，随后用 +export-get 轮询结果。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你想把在线文档导出成 docx/markdown/pdf 文件（例如离线保存或外发）时使用；这是异步任务的第一步，输入 node 与 export-format 提交导出，返回 jobId，随后用 +export-get 轮询结果。"
      ]
    },
    "doc +find-doc": {
      "agent_summary": "按关键词搜索云文档并投影关键字段（只读）",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +find-doc --query 季度汇报",
        "dws doc +find-doc --query 合同 --limit 10"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "按关键词搜索云文档并投影关键字段（只读）",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "按关键词搜索云文档并投影关键字段（只读）",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +find-doc --query 季度汇报",
            "dws doc +find-doc --query 合同 --limit 10"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +find-doc --query 季度汇报",
                "dws doc +find-doc --query 合同 --limit 10"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你只记得云文档标题或内容里的某个关键词，想快速按关键词找到匹配的文档、拿到它的标题、URL、类型和 token 以便后续查看或编辑，却不想拿到一大坨原始字段时使用；内部调用云文档的 search_documents 工具，把 --query 作为搜索关键词(keyword)，可选地用 --limit 限制返回条数(pageSize)，再在本地把每条命中结果精简为「标题、URL、类型、token」四个字段后打印。这是纯只读操作，只做搜索与本地投影，不会创建、修改或删除任何文档；未命中时提示「没搜到文档」。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你只记得云文档标题或内容里的某个关键词，想快速按关键词找到匹配的文档、拿到它的标题、URL、类型和 token 以便后续查看或编辑，却不想拿到一大坨原始字段时使用；内部调用云文档的 search_documents 工具，把 --query 作为搜索关键词(keyword)，可选地用 --limit 限制返回条数(pageSize)，再在本地把每条命中结果精简为「标题、URL、类型、token」四个字段后打印。这是纯只读操作，只做搜索与本地投影，不会创建、修改或删除任何文档；未命中时提示「没搜到文档」。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你只记得云文档标题或内容里的某个关键词，想快速按关键词找到匹配的文档、拿到它的标题、URL、类型和 token 以便后续查看或编辑，却不想拿到一大坨原始字段时使用；内部调用云文档的 search_documents 工具，把 --query 作为搜索关键词(keyword)，可选地用 --limit 限制返回条数(pageSize)，再在本地把每条命中结果精简为「标题、URL、类型、token」四个字段后打印。这是纯只读操作，只做搜索与本地投影，不会创建、修改或删除任何文档；未命中时提示「没搜到文档」。"
      ]
    },
    "doc +list": {
      "agent_summary": "列出文件夹或知识库下的直接子节点",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +list --folder DOC_FOLDER_NODE_ID",
        "dws doc +list --workspace WS_ID --limit 20"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "列出文件夹或知识库下的直接子节点",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "列出文件夹或知识库下的直接子节点",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +list --folder DOC_FOLDER_NODE_ID",
            "dws doc +list --workspace WS_ID --limit 20"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +list --folder DOC_FOLDER_NODE_ID",
                "dws doc +list --workspace WS_ID --limit 20"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你已知某个文档文件夹或知识库的 ID、想浏览它下面直接包含的文档与子文件夹（不递归深层）以便逐层导航时使用；输入 folder 或 workspace，返回该层级的子节点列表。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你已知某个文档文件夹或知识库的 ID、想浏览它下面直接包含的文档与子文件夹（不递归深层）以便逐层导航时使用；输入 folder 或 workspace，返回该层级的子节点列表。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你已知某个文档文件夹或知识库的 ID、想浏览它下面直接包含的文档与子文件夹（不递归深层）以便逐层导航时使用；输入 folder 或 workspace，返回该层级的子节点列表。"
      ]
    },
    "doc +move": {
      "agent_summary": "移动文档/文件到指定文件夹或知识库",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "user_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +move --node DOC_ID --folder TARGET_FOLDER_NODE_ID"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "移动文档/文件到指定文件夹或知识库",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "移动文档/文件到指定文件夹或知识库",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "user_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +move --node DOC_ID --folder TARGET_FOLDER_NODE_ID"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +move --node DOC_ID --folder TARGET_FOLDER_NODE_ID"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你要整理文档归属、把某篇文档/文件从当前位置挪到另一个文件夹或知识库（原位置不再保留）时使用；输入 node 与目标 folder/workspace，会实际改变文件的存放位置。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你要整理文档归属、把某篇文档/文件从当前位置挪到另一个文件夹或知识库（原位置不再保留）时使用；输入 node 与目标 folder/workspace，会实际改变文件的存放位置。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你要整理文档归属、把某篇文档/文件从当前位置挪到另一个文件夹或知识库（原位置不再保留）时使用；输入 node 与目标 folder/workspace，会实际改变文件的存放位置。"
      ]
    },
    "doc +search": {
      "agent_summary": "按关键词搜索有权限的文档 (不传则返回最近访问)",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +search --query \"会议纪要\"",
        "dws doc +search --extensions pdf,docx"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "按关键词搜索有权限的文档 (不传则返回最近访问)",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "按关键词搜索有权限的文档 (不传则返回最近访问)",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +search --query \"会议纪要\"",
            "dws doc +search --extensions pdf,docx"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +search --query \"会议纪要\"",
                "dws doc +search --extensions pdf,docx"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你只记得文档的标题或主题词、需要先定位到某篇钉钉文档拿到它的 nodeId/URL 以便后续阅读或编辑时使用；可按关键词、扩展名、创建/访问时间、创建者等条件过滤，不传关键词则返回最近访问的文档，返回匹配的文档列表。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你只记得文档的标题或主题词、需要先定位到某篇钉钉文档拿到它的 nodeId/URL 以便后续阅读或编辑时使用；可按关键词、扩展名、创建/访问时间、创建者等条件过滤，不传关键词则返回最近访问的文档，返回匹配的文档列表。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你只记得文档的标题或主题词、需要先定位到某篇钉钉文档拿到它的 nodeId/URL 以便后续阅读或编辑时使用；可按关键词、扩展名、创建/访问时间、创建者等条件过滤，不传关键词则返回最近访问的文档，返回匹配的文档列表。"
      ]
    },
    "doc +share-doc": {
      "agent_summary": "按姓名把文档链接私信发给某人（自动解析 userId）",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "user_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +share-doc --to 张三 --url https://docs.dingtalk.com/xxx --note \"帮忙过一下\""
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "按姓名把文档链接私信发给某人（自动解析 userId）",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "按姓名把文档链接私信发给某人（自动解析 userId）",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "user_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +share-doc --to 张三 --url https://docs.dingtalk.com/xxx --note \"帮忙过一下\""
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +share-doc --to 张三 --url https://docs.dingtalk.com/xxx --note \"帮忙过一下\""
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你手上已经有一个文档链接、想直接私信发给某个人而不必先查 userId 时使用；内部先按姓名搜通讯录解析出唯一用户，再用 openDingTalkId 把链接拼成一条 Markdown 消息发出去，姓名匹配到多人时会列出候选让你区分。只发链接、不读取或改动文档本身，会真实发出消息。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你手上已经有一个文档链接、想直接私信发给某个人而不必先查 userId 时使用；内部先按姓名搜通讯录解析出唯一用户，再用 openDingTalkId 把链接拼成一条 Markdown 消息发出去，姓名匹配到多人时会列出候选让你区分。只发链接、不读取或改动文档本身，会真实发出消息。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你手上已经有一个文档链接、想直接私信发给某个人而不必先查 userId 时使用；内部先按姓名搜通讯录解析出唯一用户，再用 openDingTalkId 把链接拼成一条 Markdown 消息发出去，姓名匹配到多人时会列出候选让你区分。只发链接、不读取或改动文档本身，会真实发出消息。"
      ]
    },
    "doc +template-list": {
      "agent_summary": "获取文档模板列表",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +template-list --source PUBLIC"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "获取文档模板列表",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "获取文档模板列表",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +template-list --source PUBLIC"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +template-list --source PUBLIC"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你想基于模板新建文档、需要先浏览可用的模板（自己的 MY 或公共 PUBLIC）并拿到 templateId 时使用；返回模板列表，随后可配合 +template-apply 套用。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你想基于模板新建文档、需要先浏览可用的模板（自己的 MY 或公共 PUBLIC）并拿到 templateId 时使用；返回模板列表，随后可配合 +template-apply 套用。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你想基于模板新建文档、需要先浏览可用的模板（自己的 MY 或公共 PUBLIC）并拿到 templateId 时使用；返回模板列表，随后可配合 +template-apply 套用。"
      ]
    },
    "doc +template-search": {
      "agent_summary": "根据关键词搜索文档模板",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +template-search --query \"周报\""
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "根据关键词搜索文档模板",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "根据关键词搜索文档模板",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +template-search --query \"周报\""
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +template-search --query \"周报\""
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当模板较多、你想按关键词（如“周报”“合同”）快速找到合适的模板并拿到 templateId 时使用；输入 query，返回匹配的模板列表，随后可配合 +template-apply 套用。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当模板较多、你想按关键词（如“周报”“合同”）快速找到合适的模板并拿到 templateId 时使用；输入 query，返回匹配的模板列表，随后可配合 +template-apply 套用。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当模板较多、你想按关键词（如“周报”“合同”）快速找到合适的模板并拿到 templateId 时使用；输入 query，返回匹配的模板列表，随后可配合 +template-apply 套用。"
      ]
    },
    "doc +version-list": {
      "agent_summary": "查看文档历史版本列表",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +version-list --node DOC_ID"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "查看文档历史版本列表",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "查看文档历史版本列表",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +version-list --node DOC_ID"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +version-list --node DOC_ID"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你想查看某篇文档有哪些历史版本、以便挑一个版本号用于回滚时使用；输入 node，返回历史版本列表及其版本号。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你想查看某篇文档有哪些历史版本、以便挑一个版本号用于回滚时使用；输入 node，返回历史版本列表及其版本号。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你想查看某篇文档有哪些历史版本、以便挑一个版本号用于回滚时使用；输入 node，返回历史版本列表及其版本号。"
      ]
    },
    "doc +version-revert": {
      "agent_summary": "回滚文档到指定历史版本",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "user_required",
      "effect": "destructive",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +version-revert --node DOC_ID --version 3"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "回滚文档到指定历史版本",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "回滚文档到指定历史版本",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "user_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "destructive",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "destructive",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +version-revert --node DOC_ID --version 3"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +version-revert --node DOC_ID --version 3"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "high",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "high",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当文档被误改、你想把它整体恢复到某个历史版本时使用；先用 +version-list 找到目标版本号，再输入 node 与 version，会实际把文档内容覆盖回该版本，属于高风险写操作，需谨慎确认。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当文档被误改、你想把它整体恢复到某个历史版本时使用；先用 +version-list 找到目标版本号，再输入 node 与 version，会实际把文档内容覆盖回该版本，属于高风险写操作，需谨慎确认。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "high",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当文档被误改、你想把它整体恢复到某个历史版本时使用；先用 +version-list 找到目标版本号，再输入 node 与 version，会实际把文档内容覆盖回该版本，属于高风险写操作，需谨慎确认。"
      ]
    },
    "doc +version-save": {
      "agent_summary": "手动保存文档版本快照",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "confirmation": "user_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc +version-save --node DOC_ID"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "手动保存文档版本快照",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "手动保存文档版本快照",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "user_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc +version-save --node DOC_ID"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc +version-save --node DOC_ID"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "当你在做重大改动前后、想手动打一个可回滚的版本存档点时使用；输入 node，会实际为该文档保存一个当前内容的历史版本快照。"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "当你在做重大改动前后、想手动打一个可回滚的版本存档点时使用；输入 node，会实际为该文档保存一个当前内容的历史版本快照。"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "当你在做重大改动前后、想手动打一个可回滚的版本存档点时使用；输入 node，会实际为该文档保存一个当前内容的历史版本快照。"
      ]
    },
    "doc block delete": {
      "agent_summary": "删除块元素（不可逆）",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "未确认或 blockId 不明时不要删；先 block list",
        "删整篇文档用 doc/drive delete"
      ],
      "confirmation": "user_required",
      "effect": "destructive",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc block delete --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "删除块元素（不可逆）",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "删除块元素（不可逆）",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "未确认或 blockId 不明时不要删；先 block list",
            "删整篇文档用 doc/drive delete"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "未确认或 blockId 不明时不要删；先 block list",
                "删整篇文档用 doc/drive delete"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "user_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "user_required",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "user_required",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "effect": {
          "value": "destructive",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "destructive",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "destructive",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc block delete --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc block delete --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.delete_document_block",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.delete_document_block",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.delete_document_block",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc.delete_document_block",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "high",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "high",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "high",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "high",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "use_when": {
          "value": [
            "用户确认后删除文档中指定块元素时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户确认后删除文档中指定块元素时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "delete_document_block"
      },
      "reviewed": true,
      "risk": "high",
      "source_refs": [
        "corecmd.SchemaDecl",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.delete_document_block",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document_block",
        "skills/mono/SKILL.md",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-block.md"
      ],
      "use_when": [
        "用户确认后删除文档中指定块元素时"
      ]
    },
    "doc block insert": {
      "agent_summary": "向文档插入块元素",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "整篇追加 Markdown 优先 doc update --mode append",
        "插入本地文件附件优先 doc media insert",
        "删块用 block delete；改已有块用 block update"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc block insert --node \u003cDOC_ID\u003e --text \"这是一段文字\" --format json",
        "dws doc block insert --node \u003cDOC_ID\u003e --heading \"二级标题\" --level 2 --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "向文档插入块元素",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "向文档插入块元素",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "整篇追加 Markdown 优先 doc update --mode append",
            "插入本地文件附件优先 doc media insert",
            "删块用 block delete；改已有块用 block update"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "整篇追加 Markdown 优先 doc update --mode append",
                "插入本地文件附件优先 doc media insert",
                "删块用 block delete；改已有块用 block update"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc block insert --node \u003cDOC_ID\u003e --text \"这是一段文字\" --format json",
            "dws doc block insert --node \u003cDOC_ID\u003e --heading \"二级标题\" --level 2 --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc block insert --node \u003cDOC_ID\u003e --text \"这是一段文字\" --format json",
                "dws doc block insert --node \u003cDOC_ID\u003e --heading \"二级标题\" --level 2 --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.insert_document_block",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.insert_document_block",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.insert_document_block",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": false,
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "在文档中插入新块（段落/标题等）；简单场景用 --text/--heading，复杂块用 --element JSON"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "在文档中插入新块（段落/标题等）；简单场景用 --text/--heading，复杂块用 --element JSON"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "insert_document_block"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-block.md",
        "skills/mono/references/products/doc/format/doc-jsonml-cookbook.md",
        "skills/mono/references/products/doc/style/doc-update-workflow.md"
      ],
      "use_when": [
        "在文档中插入新块（段落/标题等）；简单场景用 --text/--heading，复杂块用 --element JSON"
      ]
    },
    "doc block list": {
      "agent_summary": "查询文档一级块元素列表",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "只要全文 Markdown 用 doc read",
        "要改内容分别用 block insert/update/delete"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc block list --node \u003cDOC_ID\u003e --format json",
        "dws doc block list --node \u003cDOC_ID\u003e --start-index 0 --end-index 5 --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "查询文档一级块元素列表",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "查询文档一级块元素列表",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_document_blocks.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "只要全文 Markdown 用 doc read",
            "要改内容分别用 block insert/update/delete"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "只要全文 Markdown 用 doc read",
                "要改内容分别用 block insert/update/delete"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc block list --node \u003cDOC_ID\u003e --format json",
            "dws doc block list --node \u003cDOC_ID\u003e --start-index 0 --end-index 5 --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc block list --node \u003cDOC_ID\u003e --format json",
                "dws doc block list --node \u003cDOC_ID\u003e --start-index 0 --end-index 5 --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_document_blocks.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.list_document_blocks",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.list_document_blocks",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.list_document_blocks",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc.list_document_blocks",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_document_blocks.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "查看文档一级块结构、拿 blockId，供 insert/update/delete 或划词评论定位时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "查看文档一级块结构、拿 blockId，供 insert/update/delete 或划词评论定位时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "list_document_blocks"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.list_document_blocks",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.list_document_blocks",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-block.md",
        "skills/mono/references/products/doc/doc-comment.md",
        "skills/mono/references/products/doc/format/doc-jsonml-cookbook.md",
        "skills/mono/references/products/doc/style/doc-update-workflow.md"
      ],
      "use_when": [
        "查看文档一级块结构、拿 blockId，供 insert/update/delete 或划词评论定位时"
      ]
    },
    "doc block update": {
      "agent_summary": "更新文档中的指定块",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "插入新块用 block insert；删除用 block delete",
        "改文档显示名用 rename；整篇覆盖用 update overwrite"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc block update --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --text \"新内容\" --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "更新文档中的指定块",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "更新文档中的指定块",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "插入新块用 block insert；删除用 block delete",
            "改文档显示名用 rename；整篇覆盖用 update overwrite"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "插入新块用 block insert；删除用 block delete",
                "改文档显示名用 rename；整篇覆盖用 update overwrite"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc block update --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --text \"新内容\" --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc block update --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --text \"新内容\" --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.update_document_block",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.update_document_block",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.update_document_block",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": false,
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "修改已有块的文本/标题/样式（已知 blockId）时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "修改已有块的文本/标题/样式（已知 blockId）时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "update_document_block"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-block.md",
        "skills/mono/references/products/doc/format/doc-jsonml-cookbook.md",
        "skills/mono/references/products/doc/style/doc-update-workflow.md"
      ],
      "use_when": [
        "修改已有块的文本/标题/样式（已知 blockId）时"
      ]
    },
    "doc comment create": {
      "agent_summary": "创建文档评论",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "针对某段选中文本的划词评论改用 create-inline（需 blockId+start/end）",
        "回复已有评论用 reply；删评论用 delete"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc comment create --node \u003cDOC_ID\u003e --content \"这里需要修改\" --format json",
        "dws doc comment create --node \u003cDOC_ID\u003e --content \"请review\" --mention uid1,uid2 --mentioned-open-conversation-id \u003copenConversationId\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "创建文档评论",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "创建文档评论",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "针对某段选中文本的划词评论改用 create-inline（需 blockId+start/end）",
            "回复已有评论用 reply；删评论用 delete"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "针对某段选中文本的划词评论改用 create-inline（需 blockId+start/end）",
                "回复已有评论用 reply；删评论用 delete"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc comment create --node \u003cDOC_ID\u003e --content \"这里需要修改\" --format json",
            "dws doc comment create --node \u003cDOC_ID\u003e --content \"请review\" --mention uid1,uid2 --mentioned-open-conversation-id \u003copenConversationId\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc comment create --node \u003cDOC_ID\u003e --content \"这里需要修改\" --format json",
                "dws doc comment create --node \u003cDOC_ID\u003e --content \"请review\" --mention uid1,uid2 --mentioned-open-conversation-id \u003copenConversationId\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc-comment.create_comment",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc-comment.create_comment",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.create_comment",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc-comment.create_comment",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "在文档上创建不绑定具体划词位置的全文评论，可 @用户或通过 --mentioned-open-conversation-id @群"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "在文档上创建不绑定具体划词位置的全文评论，可 @用户或通过 --mentioned-open-conversation-id @群"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc-comment",
        "rpc_name": "create_comment"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_comment",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.create_comment",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-comment.md"
      ],
      "use_when": [
        "在文档上创建不绑定具体划词位置的全文评论，可 @用户或通过 --mentioned-open-conversation-id @群"
      ]
    },
    "doc comment create-inline": {
      "agent_summary": "在文档选中文本范围创建划词评论",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "不绑定位置的全文评论用 create",
        "先 block list 取 blockId 与纯文本偏移再调用"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc comment create-inline --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --start 0 --end 10 --content \"这里需要修改\" --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "在文档选中文本范围创建划词评论",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "在文档选中文本范围创建划词评论",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "不绑定位置的全文评论用 create",
            "先 block list 取 blockId 与纯文本偏移再调用"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "不绑定位置的全文评论用 create",
                "先 block list 取 blockId 与纯文本偏移再调用"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc comment create-inline --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --start 0 --end 10 --content \"这里需要修改\" --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc comment create-inline --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --start 0 --end 10 --content \"这里需要修改\" --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc-comment.create_inline_comment",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc-comment.create_inline_comment",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc-comment.create_inline_comment",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": false,
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "针对块内某段文本创建划词评论（必填 blockId、start、end）时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "针对块内某段文本创建划词评论（必填 blockId、start、end）时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc-comment",
        "rpc_name": "create_inline_comment"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-comment.md"
      ],
      "use_when": [
        "针对块内某段文本创建划词评论（必填 blockId、start、end）时"
      ]
    },
    "doc comment delete": {
      "agent_summary": "永久删除指定文档中的一条评论",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "只需改文案用 update；回复用 reply；目标评论不明或未确认时不要删"
      ],
      "confirmation": "user_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc comment delete --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "永久删除指定文档中的一条评论",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "永久删除指定文档中的一条评论",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "只需改文案用 update；回复用 reply；目标评论不明或未确认时不要删"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "只需改文案用 update；回复用 reply；目标评论不明或未确认时不要删"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "user_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "user_required",
              "source": "skills/mono/references/products/doc.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill command comment explicitly marks the operation as risky"
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "destructive",
              "source": "skills/mono/references/products/doc.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill command comment explicitly marks the operation as risky"
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc comment delete --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc comment delete --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "high",
              "source": "skills/mono/references/products/doc.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill command comment explicitly marks the operation as risky"
            }
          ]
        },
        "use_when": {
          "value": [
            "用户明确要求永久删除指定文档中的某条评论（已有 commentKey）时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户明确要求永久删除指定文档中的某条评论（已有 commentKey）时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-comment.md"
      ],
      "use_when": [
        "用户明确要求永久删除指定文档中的某条评论（已有 commentKey）时"
      ]
    },
    "doc comment list": {
      "agent_summary": "查询文档评论列表",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "创建全文评论用 comment create；划词用 create-inline；回复用 reply；删除用 delete"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc comment list --node \u003cDOC_ID\u003e --format json",
        "dws doc comment list --node \u003cDOC_ID\u003e --type inline --resolve-status unresolved --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "查询文档评论列表",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "查询文档评论列表",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_comments.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "创建全文评论用 comment create；划词用 create-inline；回复用 reply；删除用 delete"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "创建全文评论用 comment create；划词用 create-inline；回复用 reply；删除用 delete"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc comment list --node \u003cDOC_ID\u003e --format json",
            "dws doc comment list --node \u003cDOC_ID\u003e --type inline --resolve-status unresolved --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc comment list --node \u003cDOC_ID\u003e --format json",
                "dws doc comment list --node \u003cDOC_ID\u003e --type inline --resolve-status unresolved --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_comments.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc-comment.list_comments",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc-comment.list_comments",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.list_comments",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc-comment.list_comments",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_comments.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "查看文档评论列表，可按全文/划词、已解决/未解决过滤时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "查看文档评论列表，可按全文/划词、已解决/未解决过滤时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc-comment",
        "rpc_name": "list_comments"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.list_comments",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.list_comments",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-comment.md"
      ],
      "use_when": [
        "查看文档评论列表，可按全文/划词、已解决/未解决过滤时"
      ]
    },
    "doc comment reply": {
      "agent_summary": "回复文档评论",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "新建评论用 create/create-inline；删评论用 delete"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"同意\" --mentioned-open-conversation-id \u003copenConversationId\u003e --format json",
        "dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"比心\" --emoji --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "回复文档评论",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "回复文档评论",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.reply_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "新建评论用 create/create-inline；删评论用 delete"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "新建评论用 create/create-inline；删评论用 delete"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"同意\" --mentioned-open-conversation-id \u003copenConversationId\u003e --format json",
            "dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"比心\" --emoji --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"同意\" --mentioned-open-conversation-id \u003copenConversationId\u003e --format json",
                "dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"比心\" --emoji --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.reply_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc-comment.reply_comment",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc-comment.reply_comment",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.reply_comment",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc-comment.reply_comment",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.reply_comment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "回复已有评论（文字、可 @用户/@群，或 --emoji 表情）；commentKey 来自 list/create"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "回复已有评论（文字、可 @用户/@群，或 --emoji 表情）；commentKey 来自 list/create"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc-comment",
        "rpc_name": "reply_comment"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.reply_comment",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.reply_comment",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-comment.md"
      ],
      "use_when": [
        "回复已有评论（文字、可 @用户/@群，或 --emoji 表情）；commentKey 来自 list/create"
      ]
    },
    "doc comment update": {
      "agent_summary": "更新指定文档评论的文字内容和可选 @用户/@群。",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "删除评论用 delete；回复用 reply"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc comment update --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"已按最新数据修正\" --format json",
        "dws doc comment update --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"请群内确认\" --mentioned-open-conversation-id \u003copenConversationId\u003e"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "更新指定文档评论的文字内容和可选 @用户/@群。",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "更新指定文档评论的文字内容和可选 @用户/@群。",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "删除评论用 delete；回复用 reply"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "删除评论用 delete；回复用 reply"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc comment update --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"已按最新数据修正\" --format json",
            "dws doc comment update --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"请群内确认\" --mentioned-open-conversation-id \u003copenConversationId\u003e"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc comment update --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"已按最新数据修正\" --format json",
                "dws doc comment update --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"请群内确认\" --mentioned-open-conversation-id \u003copenConversationId\u003e"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "修改已有评论正文；可选更新 --mention 或 --mentioned-open-conversation-id"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "修改已有评论正文；可选更新 --mention 或 --mentioned-open-conversation-id"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-comment.md"
      ],
      "use_when": [
        "修改已有评论正文；可选更新 --mention 或 --mentioned-open-conversation-id"
      ]
    },
    "doc copy": {
      "agent_summary": "兼容入口：复制文档或文件；文件复制能力已迁移到 drive。",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "要搬走不留副本改用 dws doc move 或 dws drive move",
        "跨钉盘整理文件优先 dws drive copy"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc copy --node \u003cDOC_ID\u003e --folder \u003cTARGET_FOLDER_ID\u003e --format json",
        "dws doc copy --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：复制文档或文件；文件复制能力已迁移到 drive。",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "兼容入口：复制文档或文件；文件复制能力已迁移到 drive。",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "要搬走不留副本改用 dws doc move 或 dws drive move",
            "跨钉盘整理文件优先 dws drive copy"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "要搬走不留副本改用 dws doc move 或 dws drive move",
                "跨钉盘整理文件优先 dws drive copy"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc copy --node \u003cDOC_ID\u003e --folder \u003cTARGET_FOLDER_ID\u003e --format json",
            "dws doc copy --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc copy --node \u003cDOC_ID\u003e --folder \u003cTARGET_FOLDER_ID\u003e --format json",
                "dws doc copy --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.copy_document",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.copy_document",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.copy_document",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": false,
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "用户要复制文档/文件并保留原位置时（尤其保形复制模板：copy + rename + block update）",
            "目标文件夹 --folder 或知识库根 --workspace；都不传则默认「我的文档」"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户要复制文档/文件并保留原位置时（尤其保形复制模板：copy + rename + block update）",
                "目标文件夹 --folder 或知识库根 --workspace；都不传则默认「我的文档」"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "copy_document"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-file-ops.md"
      ],
      "use_when": [
        "用户要复制文档/文件并保留原位置时（尤其保形复制模板：copy + rename + block update）",
        "目标文件夹 --folder 或知识库根 --workspace；都不传则默认「我的文档」"
      ]
    },
    "doc create": {
      "agent_summary": "创建一篇新的在线文档",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "创建表格/脑图/白板/多维表/演示改用 dws wiki node create --type \u003ctype\u003e（勿用 doc create）",
        "在知识库建空节点实体也可用 wiki node create；本命令侧重可写初始内容的 adoc",
        "导入本地 Word/Markdown 为在线文档改用 dws doc import（若可用）或 upload --convert"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc create --name \"项目周报\" --format json",
        "dws doc create --name \"Q1 总结\" --content \"# Q1 总结\" --folder \u003cFOLDER_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "创建一篇新的在线文档",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "创建一篇新的在线文档",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "创建表格/脑图/白板/多维表/演示改用 dws wiki node create --type \u003ctype\u003e（勿用 doc create）",
            "在知识库建空节点实体也可用 wiki node create；本命令侧重可写初始内容的 adoc",
            "导入本地 Word/Markdown 为在线文档改用 dws doc import（若可用）或 upload --convert"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "创建表格/脑图/白板/多维表/演示改用 dws wiki node create --type \u003ctype\u003e（勿用 doc create）",
                "在知识库建空节点实体也可用 wiki node create；本命令侧重可写初始内容的 adoc",
                "导入本地 Word/Markdown 为在线文档改用 dws doc import（若可用）或 upload --convert"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc create --name \"项目周报\" --format json",
            "dws doc create --name \"Q1 总结\" --content \"# Q1 总结\" --folder \u003cFOLDER_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc create --name \"项目周报\" --format json",
                "dws doc create --name \"Q1 总结\" --content \"# Q1 总结\" --folder \u003cFOLDER_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.create_document",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.create_document",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.create_document",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc.create_document",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "用户要新建一篇文字在线文档(adoc)，可空文档或带初始 Markdown 时",
            "创建到指定文件夹 --folder、知识库根 --workspace，或默认「我的文档」根目录时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户要新建一篇文字在线文档(adoc)，可空文档或带初始 Markdown 时",
                "创建到指定文件夹 --folder、知识库根 --workspace，或默认「我的文档」根目录时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "create_document"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_document",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.create_document",
        "skills/mono/references/intent-guide.md",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-create.md",
        "skills/mono/references/products/doc/doc-media.md"
      ],
      "use_when": [
        "用户要新建一篇文字在线文档(adoc)，可空文档或带初始 Markdown 时",
        "创建到指定文件夹 --folder、知识库根 --workspace，或默认「我的文档」根目录时"
      ]
    },
    "doc delete": {
      "agent_summary": "兼容入口：将文档或文件移入回收站；文件删除能力已迁移到 drive。",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "常规文件删除优先 dws drive delete；本入口仅为兼容",
        "用户未确认或目标不清时不要删",
        "删块用 doc block delete；删评论用 doc comment delete"
      ],
      "confirmation": "user_required",
      "effect": "destructive",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc delete --node \u003cDOC_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：将文档或文件移入回收站；文件删除能力已迁移到 drive。",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "兼容入口：将文档或文件移入回收站；文件删除能力已迁移到 drive。",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规文件删除优先 dws drive delete；本入口仅为兼容",
            "用户未确认或目标不清时不要删",
            "删块用 doc block delete；删评论用 doc comment delete"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "常规文件删除优先 dws drive delete；本入口仅为兼容",
                "用户未确认或目标不清时不要删",
                "删块用 doc block delete；删评论用 doc comment delete"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "user_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "user_required",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "effect": {
          "value": "destructive",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "destructive",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "destructive",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc delete --node \u003cDOC_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc delete --node \u003cDOC_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.delete_document",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.delete_document",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.delete_document",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": false,
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "high",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "high",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "high",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "use_when": {
          "value": [
            "用户明确要求用 doc delete 兼容入口将文档/文件移入回收站，且已确认目标时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户明确要求用 doc delete 兼容入口将文档/文件移入回收站，且已确认目标时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "delete_document"
      },
      "reviewed": true,
      "risk": "high",
      "source_refs": [
        "corecmd.SchemaDecl",
        "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document",
        "skills/mono/SKILL.md",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-file-ops.md"
      ],
      "use_when": [
        "用户明确要求用 doc delete 兼容入口将文档/文件移入回收站，且已确认目标时"
      ]
    },
    "doc download": {
      "agent_summary": "兼容入口：下载钉盘或文档空间已有文件；文件下载能力已迁移到 drive。",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "常规下载普通文件改用 dws drive download --output ...",
        "在线文档导出 docx 用 doc export"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc download --node \u003cNODE_ID\u003e --output ./report.pdf --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：下载钉盘或文档空间已有文件；文件下载能力已迁移到 drive。",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "兼容入口：下载钉盘或文档空间已有文件；文件下载能力已迁移到 drive。",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_file.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规下载普通文件改用 dws drive download --output ...",
            "在线文档导出 docx 用 doc export"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "常规下载普通文件改用 dws drive download --output ...",
                "在线文档导出 docx 用 doc export"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc download --node \u003cNODE_ID\u003e --output ./report.pdf --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc download --node \u003cNODE_ID\u003e --output ./report.pdf --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_file.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.download_file",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.download_file",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.download_file",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_file.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": false,
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_file",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "兼容入口：获取文件下载凭证（已迁移场景优先 drive download）时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "兼容入口：获取文件下载凭证（已迁移场景优先 drive download）时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "download_file"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl",
        "internal/cli/schema_mcp_metadata.json#tools.doc.download_file",
        "skills/mono/references/products/doc/doc-file-ops.md",
        "skills/mono/references/products/sheet.md"
      ],
      "use_when": [
        "兼容入口：获取文件下载凭证（已迁移场景优先 drive download）时"
      ]
    },
    "doc export get": {
      "agent_summary": "查询文档导出任务结果",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "常规导出请直接 dws doc export（一体化提交+轮询+下载），不要先查 job"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc export get --job-id \u003cJOB_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "查询文档导出任务结果",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "查询文档导出任务结果",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "常规导出请直接 dws doc export（一体化提交+轮询+下载），不要先查 job"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "常规导出请直接 dws doc export（一体化提交+轮询+下载），不要先查 job"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc export get --job-id \u003cJOB_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc export get --job-id \u003cJOB_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.query_export_job",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.query_export_job",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.query_export_job",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": false,
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "doc export 超时/中断后，用 jobId 查询导出任务状态与下载链接时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "doc export 超时/中断后，用 jobId 查询导出任务状态与下载链接时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "query_export_job"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl",
        "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-export.md"
      ],
      "use_when": [
        "doc export 超时/中断后，用 jobId 查询导出任务状态与下载链接时"
      ]
    },
    "doc file create": {
      "agent_summary": "创建文件（文档/表格/脑图/白板/多维表/文件夹等）",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "请改用 dws wiki node create --workspace \u003cid\u003e --type \u003ctype\u003e",
        "纯文字带内容创建用 doc create"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc file create --name \"项目周报\" --type adoc --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "创建文件（文档/表格/脑图/白板/多维表/文件夹等）",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "创建文件（文档/表格/脑图/白板/多维表/文件夹等）",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_file.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "请改用 dws wiki node create --workspace \u003cid\u003e --type \u003ctype\u003e",
            "纯文字带内容创建用 doc create"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "请改用 dws wiki node create --workspace \u003cid\u003e --type \u003ctype\u003e",
                "纯文字带内容创建用 doc create"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc file create --name \"项目周报\" --type adoc --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc file create --name \"项目周报\" --type adoc --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_file.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.create_file",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.create_file",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.create_file",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc.create_file",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_file.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "兼容入口：按类型创建文件节点时（已弃用，改用 wiki node create）"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "兼容入口：按类型创建文件节点时（已弃用，改用 wiki node create）"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "create_file"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_file",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.create_file"
      ],
      "use_when": [
        "兼容入口：按类型创建文件节点时（已弃用，改用 wiki node create）"
      ]
    },
    "doc folder create": {
      "agent_summary": "创建文件夹",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "个人空间/钉盘改用 dws drive mkdir；知识库改用 wiki node create --type folder"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc folder create --name \"项目资料\" --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "创建文件夹",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "创建文件夹",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_folder.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "个人空间/钉盘改用 dws drive mkdir；知识库改用 wiki node create --type folder"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "个人空间/钉盘改用 dws drive mkdir；知识库改用 wiki node create --type folder"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc folder create --name \"项目资料\" --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc folder create --name \"项目资料\" --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_folder.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.create_folder",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.create_folder",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.create_folder",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc.create_folder",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_folder.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "兼容入口：创建文件夹（已弃用）时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "兼容入口：创建文件夹（已弃用）时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "create_folder"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_folder",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.create_folder",
        "skills/mono/references/products/doc/doc-file-ops.md"
      ],
      "use_when": [
        "兼容入口：创建文件夹（已弃用）时"
      ]
    },
    "doc import get": {
      "agent_summary": "根据 taskId 查询文档导入任务的执行结果",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "发起导入用 doc import（若入口可用）；不要用本命令代替导入"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc import get --task-id \u003cTASK_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "根据 taskId 查询文档导入任务的执行结果",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "根据 taskId 查询文档导入任务的执行结果",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "发起导入用 doc import（若入口可用）；不要用本命令代替导入"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "发起导入用 doc import（若入口可用）；不要用本命令代替导入"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc import get --task-id \u003cTASK_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc import get --task-id \u003cTASK_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "查询文档导入任务结果（已有 taskId，导入超时/中断后兜底）时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "查询文档导入任务结果（已有 taskId，导入超时/中断后兜底）时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-import.md"
      ],
      "use_when": [
        "查询文档导入任务结果（已有 taskId，导入超时/中断后兜底）时"
      ]
    },
    "doc info": {
      "agent_summary": "获取文档元信息（标题/类型/创建者/权限等）",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "已确认是 adoc 且只要正文改用 dws doc read",
        "只要目录列表改用 dws drive list / wiki node list",
        "需要可靠文件大小 fileSize 时改用 dws drive info；文档元信息接口可能不返回大小"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc info --node \u003cDOC_ID\u003e --format json",
        "dws doc info --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "获取文档元信息（标题/类型/创建者/权限等）",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "获取文档元信息（标题/类型/创建者/权限等）",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_info.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "已确认是 adoc 且只要正文改用 dws doc read",
            "只要目录列表改用 dws drive list / wiki node list",
            "需要可靠文件大小 fileSize 时改用 dws drive info；文档元信息接口可能不返回大小"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "已确认是 adoc 且只要正文改用 dws doc read",
                "只要目录列表改用 dws drive list / wiki node list",
                "需要可靠文件大小 fileSize 时改用 dws drive info；文档元信息接口可能不返回大小"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc info --node \u003cDOC_ID\u003e --format json",
            "dws doc info --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc info --node \u003cDOC_ID\u003e --format json",
                "dws doc info --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_info.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.get_document_info",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.get_document_info",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.get_document_info",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc.get_document_info",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_info.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "用户要查看文档/节点元信息（标题、类型、创建者、权限）时",
            "准备读内容前必须先看 contentType/extension 以路由到 read/sheet/aitable/download 时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户要查看文档/节点元信息（标题、类型、创建者、权限）时",
                "准备读内容前必须先看 contentType/extension 以路由到 read/sheet/aitable/download 时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "get_document_info"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.get_document_info",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_info",
        "skills/mono/references/intent-guide.md",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-info.md"
      ],
      "use_when": [
        "用户要查看文档/节点元信息（标题、类型、创建者、权限）时",
        "准备读内容前必须先看 contentType/extension 以路由到 read/sheet/aitable/download 时"
      ]
    },
    "doc list": {
      "agent_summary": "兼容入口：遍历文件夹或知识库的直接子节点；目录浏览能力已迁移到 drive/wiki。",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "日常浏览「我的文档」/钉盘用 dws drive list；知识库用 dws wiki node list"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc list --format json",
        "dws doc list --folder \u003cFOLDER_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：遍历文件夹或知识库的直接子节点；目录浏览能力已迁移到 drive/wiki。",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "兼容入口：遍历文件夹或知识库的直接子节点；目录浏览能力已迁移到 drive/wiki。",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_nodes.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "日常浏览「我的文档」/钉盘用 dws drive list；知识库用 dws wiki node list"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "日常浏览「我的文档」/钉盘用 dws drive list；知识库用 dws wiki node list"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc list --format json",
            "dws doc list --folder \u003cFOLDER_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc list --format json",
                "dws doc list --folder \u003cFOLDER_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_nodes.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.list_nodes",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.list_nodes",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.list_nodes",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc.list_nodes",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_nodes.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "兼容入口：遍历文件夹或知识库直接子节点时（已弃用，日常改用 drive list / wiki node list）"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "兼容入口：遍历文件夹或知识库直接子节点时（已弃用，日常改用 drive list / wiki node list）"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "list_nodes"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.list_nodes",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.list_nodes"
      ],
      "use_when": [
        "兼容入口：遍历文件夹或知识库直接子节点时（已弃用，日常改用 drive list / wiki node list）"
      ]
    },
    "doc media download": {
      "agent_summary": "获取文档附件的临时下载链接",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "下载钉盘普通文件用 drive download；导出在线文档用 doc export"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc media download --node \u003cDOC_ID\u003e --resource-id \u003cRESOURCE_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "获取文档附件的临时下载链接",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "获取文档附件的临时下载链接",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "下载钉盘普通文件用 drive download；导出在线文档用 doc export"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "下载钉盘普通文件用 drive download；导出在线文档用 doc export"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc media download --node \u003cDOC_ID\u003e --resource-id \u003cRESOURCE_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc media download --node \u003cDOC_ID\u003e --resource-id \u003cRESOURCE_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.download_doc_attachment",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.download_doc_attachment",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.download_doc_attachment",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": false,
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "获取文档正文中附件的临时下载 URL（resourceId 来自 block list attachment）时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "获取文档正文中附件的临时下载 URL（resourceId 来自 block list attachment）时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "download_doc_attachment"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl",
        "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-media.md"
      ],
      "use_when": [
        "获取文档正文中附件的临时下载 URL（resourceId 来自 block list attachment）时"
      ]
    },
    "doc media insert": {
      "agent_summary": "上传本地文件并作为附件插入文档",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "上传为独立文件用 drive/doc upload，不要与正文附件混淆",
        "下载正文附件用 media download"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc media insert --node \u003cDOC_ID\u003e --file ./report.pdf --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "上传本地文件并作为附件插入文档",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "上传本地文件并作为附件插入文档",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "上传为独立文件用 drive/doc upload，不要与正文附件混淆",
            "下载正文附件用 media download"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "上传为独立文件用 drive/doc upload，不要与正文附件混淆",
                "下载正文附件用 media download"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc media insert --node \u003cDOC_ID\u003e --file ./report.pdf --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc media insert --node \u003cDOC_ID\u003e --file ./report.pdf --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "把本地文件/图片作为附件块插入文档正文（自动 prepare+PUT+insert）时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "把本地文件/图片作为附件块插入文档正文（自动 prepare+PUT+insert）时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-media.md"
      ],
      "use_when": [
        "把本地文件/图片作为附件块插入文档正文（自动 prepare+PUT+insert）时"
      ]
    },
    "doc move": {
      "agent_summary": "兼容入口：移动文档或文件；文件移动能力已迁移到 drive。",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "要保留副本改用 doc/drive copy",
        "目标未确认时不要 move"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc move --node \u003cDOC_ID\u003e --folder \u003cTARGET_FOLDER_ID\u003e --format json",
        "dws doc move --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：移动文档或文件；文件移动能力已迁移到 drive。",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "兼容入口：移动文档或文件；文件移动能力已迁移到 drive。",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.move_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "要保留副本改用 doc/drive copy",
            "目标未确认时不要 move"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "要保留副本改用 doc/drive copy",
                "目标未确认时不要 move"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc move --node \u003cDOC_ID\u003e --folder \u003cTARGET_FOLDER_ID\u003e --format json",
            "dws doc move --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc move --node \u003cDOC_ID\u003e --folder \u003cTARGET_FOLDER_ID\u003e --format json",
                "dws doc move --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.move_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.move_document",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.move_document",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.move_document",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.move_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": false,
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.move_document",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "用户要移动文档/文件且原位置不再保留时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户要移动文档/文件且原位置不再保留时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "move_document"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "internal/cli/schema_mcp_metadata.json#tools.doc.move_document",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-file-ops.md"
      ],
      "use_when": [
        "用户要移动文档/文件且原位置不再保留时"
      ]
    },
    "doc permission add": {
      "agent_summary": "兼容入口：为文档空间节点添加协作成员权限；文件管理权限命令已迁移到 drive。",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "知识库容器授权用 wiki member add",
        "查/改/移除用 permission list/update/remove"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc permission add --node \u003cDOC_ID\u003e --users uid1 --role READER --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：为文档空间节点添加协作成员权限；文件管理权限命令已迁移到 drive。",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "兼容入口：为文档空间节点添加协作成员权限；文件管理权限命令已迁移到 drive。",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "知识库容器授权用 wiki member add",
            "查/改/移除用 permission list/update/remove"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "知识库容器授权用 wiki member add",
                "查/改/移除用 permission list/update/remove"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc permission add --node \u003cDOC_ID\u003e --users uid1 --role READER --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc permission add --node \u003cDOC_ID\u003e --users uid1 --role READER --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.add_permission",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.add_permission",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.add_permission",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": false,
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "给单篇文档做节点级授权（与 drive permission add 同能力的 doc 入口）时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "给单篇文档做节点级授权（与 drive permission add 同能力的 doc 入口）时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "add_permission"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-permission.md"
      ],
      "use_when": [
        "给单篇文档做节点级授权（与 drive permission add 同能力的 doc 入口）时"
      ]
    },
    "doc permission list": {
      "agent_summary": "兼容入口：查询文档空间节点的协作者权限；文件权限命令已迁移到 drive。",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "增删改权限用 add/update/remove；知识库成员用 wiki member list"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc permission list --node \u003cDOC_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：查询文档空间节点的协作者权限；文件权限命令已迁移到 drive。",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "兼容入口：查询文档空间节点的协作者权限；文件权限命令已迁移到 drive。",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "增删改权限用 add/update/remove；知识库成员用 wiki member list"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "增删改权限用 add/update/remove；知识库成员用 wiki member list"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc permission list --node \u003cDOC_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc permission list --node \u003cDOC_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.list_permission",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.list_permission",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.list_permission",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": false,
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "列出文档节点成员权限时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "列出文档节点成员权限时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "list_permission"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl",
        "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-permission.md"
      ],
      "use_when": [
        "列出文档节点成员权限时"
      ]
    },
    "doc permission remove": {
      "agent_summary": "兼容入口：移除文档空间节点的协作成员权限；文件权限命令已迁移到 drive。",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "改角色用 update；知识库撤成员用 wiki member remove"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc permission remove --node \u003cDOC_ID\u003e --users uid1 --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：移除文档空间节点的协作成员权限；文件权限命令已迁移到 drive。",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "兼容入口：移除文档空间节点的协作成员权限；文件权限命令已迁移到 drive。",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "改角色用 update；知识库撤成员用 wiki member remove"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "改角色用 update；知识库撤成员用 wiki member remove"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc permission remove --node \u003cDOC_ID\u003e --users uid1 --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc permission remove --node \u003cDOC_ID\u003e --users uid1 --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.remove_permission",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.remove_permission",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.remove_permission",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": false,
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "移除文档节点上指定用户权限时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "移除文档节点上指定用户权限时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "remove_permission"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission"
      ],
      "use_when": [
        "移除文档节点上指定用户权限时"
      ]
    },
    "doc permission update": {
      "agent_summary": "兼容入口：更新文档空间节点的协作成员角色；文件权限命令已迁移到 drive。",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "新授权用 add；移除用 remove"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc permission update --node \u003cDOC_ID\u003e --users uid1 --role EDITOR --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：更新文档空间节点的协作成员角色；文件权限命令已迁移到 drive。",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "兼容入口：更新文档空间节点的协作成员角色；文件权限命令已迁移到 drive。",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "新授权用 add；移除用 remove"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "新授权用 add；移除用 remove"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "user_required",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc permission update --node \u003cDOC_ID\u003e --users uid1 --role EDITOR --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc permission update --node \u003cDOC_ID\u003e --users uid1 --role EDITOR --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.update_permission",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.update_permission",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.update_permission",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": false,
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "high",
              "source": "skills/mono/SKILL.md",
              "precedence": "skill",
              "selected": false,
              "review_reason": "Skill danger table explicitly reviews this operation"
            }
          ]
        },
        "use_when": {
          "value": [
            "变更文档节点上已有用户角色时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "变更文档节点上已有用户角色时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "update_permission"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission",
        "skills/mono/SKILL.md",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-permission.md"
      ],
      "use_when": [
        "变更文档节点上已有用户角色时"
      ]
    },
    "doc read": {
      "agent_summary": "读取完整文档内容，或按 outline/range/section/tags 获取 JSONML fragment",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "非 adoc（表格/多维表/普通文件）不要用本命令；先 doc info 再路由",
        "要元信息用 doc info；要块结构用 doc block list",
        "Markdown 为有损投影：保形复制模板请用 doc copy，不要 read→create"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc read --node \u003cDOC_ID\u003e --format json",
        "dws doc read --node \u003cDOC_ID\u003e --content-format jsonml --scope outline --max-depth 3"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "读取完整文档内容，或按 outline/range/section/tags 获取 JSONML fragment",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "读取完整文档内容，或按 outline/range/section/tags 获取 JSONML fragment",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_content.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "非 adoc（表格/多维表/普通文件）不要用本命令；先 doc info 再路由",
            "要元信息用 doc info；要块结构用 doc block list",
            "Markdown 为有损投影：保形复制模板请用 doc copy，不要 read→create"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "非 adoc（表格/多维表/普通文件）不要用本命令；先 doc info 再路由",
                "要元信息用 doc info；要块结构用 doc block list",
                "Markdown 为有损投影：保形复制模板请用 doc copy，不要 read→create"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc read --node \u003cDOC_ID\u003e --format json",
            "dws doc read --node \u003cDOC_ID\u003e --content-format jsonml --scope outline --max-depth 3"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc read --node \u003cDOC_ID\u003e --format json",
                "dws doc read --node \u003cDOC_ID\u003e --content-format jsonml --scope outline --max-depth 3"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_content.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.get_document_content",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.get_document_content",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.get_document_content",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc.get_document_content",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_content.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "用户要读取钉钉在线文字文档(adoc)正文（Markdown）时",
            "用户直接粘贴文档 URL 且无其他指令时（默认读内容）",
            "只需标题大纲、指定块区间/单块或特定 JSONML tags 时使用 --content-format jsonml 与 --scope"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户要读取钉钉在线文字文档(adoc)正文（Markdown）时",
                "用户直接粘贴文档 URL 且无其他指令时（默认读内容）",
                "只需标题大纲、指定块区间/单块或特定 JSONML tags 时使用 --content-format jsonml 与 --scope"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "get_document_content"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.get_document_content",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_content",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-read.md",
        "skills/mono/references/products/doc/style/doc-update-workflow.md"
      ],
      "use_when": [
        "用户要读取钉钉在线文字文档(adoc)正文（Markdown）时",
        "用户直接粘贴文档 URL 且无其他指令时（默认读内容）",
        "只需标题大纲、指定块区间/单块或特定 JSONML tags 时使用 --content-format jsonml 与 --scope"
      ]
    },
    "doc rename": {
      "agent_summary": "兼容入口：重命名文档或文件；文件重命名能力已迁移到 drive。",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "改正文标题/章节标题改用 doc block update",
        "不要用 update 或重新 create 来改名",
        "文件或文件夹重命名优先用 dws drive rename，由该命令读取真实节点类型和当前扩展名"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc rename --node \u003cDOC_ID\u003e --name \"新名称\" --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：重命名文档或文件；文件重命名能力已迁移到 drive。",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "兼容入口：重命名文档或文件；文件重命名能力已迁移到 drive。",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "改正文标题/章节标题改用 doc block update",
            "不要用 update 或重新 create 来改名",
            "文件或文件夹重命名优先用 dws drive rename，由该命令读取真实节点类型和当前扩展名"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "改正文标题/章节标题改用 doc block update",
                "不要用 update 或重新 create 来改名",
                "文件或文件夹重命名优先用 dws drive rename，由该命令读取真实节点类型和当前扩展名"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc rename --node \u003cDOC_ID\u003e --name \"新名称\" --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc rename --node \u003cDOC_ID\u003e --name \"新名称\" --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.rename_document",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.rename_document",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.rename_document",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": false,
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "用户要改在线文档在列表与链接中展示的名称时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户要改在线文档在列表与链接中展示的名称时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "rename_document"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-file-ops.md"
      ],
      "use_when": [
        "用户要改在线文档在列表与链接中展示的名称时"
      ]
    },
    "doc search": {
      "agent_summary": "搜索文档（不传关键词返回最近访问）",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "全局搜文件用 dws drive search；指定知识库内搜用 dws wiki node search"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc search --query \"会议纪要\" --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "搜索文档（不传关键词返回最近访问）",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "搜索文档（不传关键词返回最近访问）",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.search_documents.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "全局搜文件用 dws drive search；指定知识库内搜用 dws wiki node search"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "全局搜文件用 dws drive search；指定知识库内搜用 dws wiki node search"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "read",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc search --query \"会议纪要\" --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc search --query \"会议纪要\" --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "idempotent",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.search_documents.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.search_documents",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.search_documents",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.search_documents",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc.search_documents",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.search_documents.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "low",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "兼容入口：按关键词搜文档时（已弃用，日常改用 drive search / wiki node search）"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "兼容入口：按关键词搜文档时（已弃用，日常改用 drive search / wiki node search）"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "search_documents"
      },
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.search_documents",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.search_documents",
        "skills/mono/references/intent-guide.md"
      ],
      "use_when": [
        "兼容入口：按关键词搜文档时（已弃用，日常改用 drive search / wiki node search）"
      ]
    },
    "doc style background clear": {
      "agent_summary": "清除钉钉文档背景",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "设置背景用 background set"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc style background clear --node \u003cDOC_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "清除钉钉文档背景",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "清除钉钉文档背景",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "设置背景用 background set"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "设置背景用 background set"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc style background clear --node \u003cDOC_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc style background clear --node \u003cDOC_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "用户说 去掉文档背景色"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户说 去掉文档背景色"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "用户说 去掉文档背景色"
      ]
    },
    "doc style background set": {
      "agent_summary": "设置钉钉文档背景纯色（#RRGGBB）",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "背景不支持图片；封面用 cover set"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc style background set --node \u003cDOC_ID\u003e --color \"#E8F2FE\" --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "设置钉钉文档背景纯色（#RRGGBB）",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "设置钉钉文档背景纯色（#RRGGBB）",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "背景不支持图片；封面用 cover set"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "背景不支持图片；封面用 cover set"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc style background set --node \u003cDOC_ID\u003e --color \"#E8F2FE\" --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc style background set --node \u003cDOC_ID\u003e --color \"#E8F2FE\" --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "用户说 给文档设置背景色"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户说 给文档设置背景色"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "用户说 给文档设置背景色"
      ]
    },
    "doc style cover clear": {
      "agent_summary": "移除钉钉文档封面",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "设置封面用 cover set"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc style cover clear --node \u003cDOC_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "移除钉钉文档封面",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "移除钉钉文档封面",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "设置封面用 cover set"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "设置封面用 cover set"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc style cover clear --node \u003cDOC_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc style cover clear --node \u003cDOC_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "用户说 去掉文档封面"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户说 去掉文档封面"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "用户说 去掉文档封面"
      ]
    },
    "doc style cover set": {
      "agent_summary": "设置钉钉文档顶部封面图（外链或本地图片上传）",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "读取当前封面用 doc style get；移除封面用 cover clear"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc style cover set --node \u003cDOC_ID\u003e --image https://img.example.com/cover.png --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "设置钉钉文档顶部封面图（外链或本地图片上传）",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "设置钉钉文档顶部封面图（外链或本地图片上传）",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "读取当前封面用 doc style get；移除封面用 cover clear"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "读取当前封面用 doc style get；移除封面用 cover clear"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc style cover set --node \u003cDOC_ID\u003e --image https://img.example.com/cover.png --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc style cover set --node \u003cDOC_ID\u003e --image https://img.example.com/cover.png --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "用户说 给文档设置封面/换个封面图"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户说 给文档设置封面/换个封面图"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "用户说 给文档设置封面/换个封面图"
      ]
    },
    "doc style get": {
      "agent_summary": "读取文档当前封面与背景配置（只读）",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "修改用 cover set / background set"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc style get --node \u003cDOC_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "读取文档当前封面与背景配置（只读）",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "读取文档当前封面与背景配置（只读）",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "修改用 cover set / background set"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "修改用 cover set / background set"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc style get --node \u003cDOC_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc style get --node \u003cDOC_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "用户说 看下文档现在的封面/背景"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户说 看下文档现在的封面/背景"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "用户说 看下文档现在的封面/背景"
      ]
    },
    "doc template apply": {
      "agent_summary": "使用指定模板创建新文档",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "先 list/search 拿到模板再 apply；普通空文档用 doc create"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc template apply --template-id \u003cTPL_ID\u003e --name \"我的周报\" --format json",
        "dws doc template apply --template-id \u003cTPL_ID\u003e --name \"项目方案\" --folder \u003cFOLDER_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "使用指定模板创建新文档",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "使用指定模板创建新文档",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "先 list/search 拿到模板再 apply；普通空文档用 doc create"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "先 list/search 拿到模板再 apply；普通空文档用 doc create"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc template apply --template-id \u003cTPL_ID\u003e --name \"我的周报\" --format json",
            "dws doc template apply --template-id \u003cTPL_ID\u003e --name \"项目方案\" --folder \u003cFOLDER_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc template apply --template-id \u003cTPL_ID\u003e --name \"我的周报\" --format json",
                "dws doc template apply --template-id \u003cTPL_ID\u003e --name \"项目方案\" --folder \u003cFOLDER_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "使用指定模板创建新文档时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "使用指定模板创建新文档时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "使用指定模板创建新文档时"
      ]
    },
    "doc template list": {
      "agent_summary": "获取当前用户可用的文档模板列表",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "按关键词搜模板用 template search；套用模板用 template apply"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc template list --format json",
        "dws doc template list --source MY --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "获取当前用户可用的文档模板列表",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "获取当前用户可用的文档模板列表",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "按关键词搜模板用 template search；套用模板用 template apply"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "按关键词搜模板用 template search；套用模板用 template apply"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc template list --format json",
            "dws doc template list --source MY --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc template list --format json",
                "dws doc template list --source MY --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "列出当前用户可用的文档模板时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "列出当前用户可用的文档模板时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "列出当前用户可用的文档模板时"
      ]
    },
    "doc template search": {
      "agent_summary": "根据关键词搜索文档模板",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "浏览全部模板用 template list；创建文档用 template apply"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc template search --query \"周报\" --format json",
        "dws doc template search --query \"会议纪要\" --source PUBLIC --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "根据关键词搜索文档模板",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "根据关键词搜索文档模板",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "浏览全部模板用 template list；创建文档用 template apply"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "浏览全部模板用 template list；创建文档用 template apply"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc template search --query \"周报\" --format json",
            "dws doc template search --query \"会议纪要\" --source PUBLIC --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc template search --query \"周报\" --format json",
                "dws doc template search --query \"会议纪要\" --source PUBLIC --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "按关键词搜索文档模板时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "按关键词搜索文档模板时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "按关键词搜索文档模板时"
      ]
    },
    "doc update": {
      "agent_summary": "更新文档内容（追加 / 覆盖；覆盖需 --yes）",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "目标不是 adoc 或只要改单个块时改用 doc block update",
        "覆盖模式用户未确认前不要执行；可先 --dry-run 预览",
        "创建新文档用 doc create，不要用 update 冒充创建"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc update --node \u003cDOC_ID\u003e --content \"# 追加内容\" --mode append --format json",
        "dws doc update --node \u003cDOC_ID\u003e --content-file ./body.md --mode overwrite --dry-run"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "更新文档内容（追加 / 覆盖；覆盖需 --yes）",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "更新文档内容（追加 / 覆盖；覆盖需 --yes）",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "available",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "avoid_when": {
          "value": [
            "目标不是 adoc 或只要改单个块时改用 doc block update",
            "覆盖模式用户未确认前不要执行；可先 --dry-run 预览",
            "创建新文档用 doc create，不要用 update 冒充创建"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "目标不是 adoc 或只要改单个块时改用 doc block update",
                "覆盖模式用户未确认前不要执行；可先 --dry-run 预览",
                "创建新文档用 doc create，不要用 update 冒充创建"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc update --node \u003cDOC_ID\u003e --content \"# 追加内容\" --mode append --format json",
            "dws doc update --node \u003cDOC_ID\u003e --content-file ./body.md --mode overwrite --dry-run"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc update --node \u003cDOC_ID\u003e --content \"# 追加内容\" --mode append --format json",
                "dws doc update --node \u003cDOC_ID\u003e --content-file ./body.md --mode overwrite --dry-run"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "mcp",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "mcp",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "mcp",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "interface_ref": {
          "value": "doc.update_document",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "doc.update_document",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "doc.update_document",
              "source": "internal/cli/schema_hints/imported/wukong.json",
              "precedence": "imported",
              "selected": false
            },
            {
              "value": "doc.update_document",
              "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document.interface_ref",
              "precedence": "mcp_fallback",
              "selected": false
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "用户要向已有 adoc 追加内容时用 --mode append（更安全）",
            "用户明确要求整篇覆盖替换时用 --mode overwrite（破坏性）",
            "append 且要插到第 N 个 block 前时加 --index N（先 block list）"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户要向已有 adoc 追加内容时用 --mode append（更安全）",
                "用户明确要求整篇覆盖替换时用 --mode overwrite（破坏性）",
                "append 且要插到第 N 个 block 前时加 --index N（先 block list）"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "mcp",
      "interface_ref": {
        "product_id": "doc",
        "rpc_name": "update_document"
      },
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.update_document",
        "internal/cli/schema_hints/imported/wukong.json",
        "internal/cli/schema_mcp_metadata.json#tools.doc.update_document",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-block.md",
        "skills/mono/references/products/doc/doc-update.md",
        "skills/mono/references/products/doc/style/doc-update-workflow.md"
      ],
      "use_when": [
        "用户要向已有 adoc 追加内容时用 --mode append（更安全）",
        "用户明确要求整篇覆盖替换时用 --mode overwrite（破坏性）",
        "append 且要插到第 N 个 block 前时加 --index N（先 block list）"
      ]
    },
    "doc upload": {
      "agent_summary": "兼容入口：上传本地文件到钉盘或文档空间；文件上传能力已迁移到 drive。",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "钉盘/我的文件上传优先 dws drive upload",
        "插入文档正文附件用 media insert"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc upload --file ./report.pdf --format json",
        "dws doc upload --file ./data.xlsx --workspace \u003cWS_ID\u003e --convert --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "兼容入口：上传本地文件到钉盘或文档空间；文件上传能力已迁移到 drive。",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "兼容入口：上传本地文件到钉盘或文档空间；文件上传能力已迁移到 drive。",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "钉盘/我的文件上传优先 dws drive upload",
            "插入文档正文附件用 media insert"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "钉盘/我的文件上传优先 dws drive upload",
                "插入文档正文附件用 media insert"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "not_required",
              "source": "risk-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "write",
              "source": "command-verb",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc upload --file ./report.pdf --format json",
            "dws doc upload --file ./data.xlsx --workspace \u003cWS_ID\u003e --convert --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc upload --file ./report.pdf --format json",
                "dws doc upload --file ./data.xlsx --workspace \u003cWS_ID\u003e --convert --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "unknown",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            },
            {
              "value": "medium",
              "source": "effect-default",
              "precedence": "inference_or_default",
              "selected": false
            }
          ]
        },
        "use_when": {
          "value": [
            "把本地文件上传到文档空间/知识库（可 --convert 转在线文档）时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "把本地文件上传到文档空间/知识库（可 --convert 转在线文档）时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl",
        "skills/mono/references/products/doc.md",
        "skills/mono/references/products/doc/doc-file-ops.md"
      ],
      "use_when": [
        "把本地文件上传到文档空间/知识库（可 --convert 转在线文档）时"
      ]
    },
    "doc version list": {
      "agent_summary": "查看文档历史版本列表",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "回滚用 version revert（需确认）；保存快照用 version save"
      ],
      "confirmation": "not_required",
      "effect": "read",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc version list --node \u003cDOC_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "查看文档历史版本列表",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "查看文档历史版本列表",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "回滚用 version revert（需确认）；保存快照用 version save"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "回滚用 version revert（需确认）；保存快照用 version save"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "read",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "read",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc version list --node \u003cDOC_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc version list --node \u003cDOC_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "idempotent",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "idempotent",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "low",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "low",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "查看文档历史版本列表以确认版本号时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "查看文档历史版本列表以确认版本号时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "idempotent",
      "interface_mode": "composite",
      "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
      "reviewed": true,
      "risk": "low",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "查看文档历史版本列表以确认版本号时"
      ]
    },
    "doc version revert": {
      "agent_summary": "将文档回滚到指定历史版本",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "只看版本列表用 version list；保存快照用 save",
        "版本号未确认或用户未同意回滚时不要执行"
      ],
      "confirmation": "user_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc version revert --node \u003cDOC_ID\u003e --version 3 --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "将文档回滚到指定历史版本",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "将文档回滚到指定历史版本",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "只看版本列表用 version list；保存快照用 save",
            "版本号未确认或用户未同意回滚时不要执行"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "只看版本列表用 version list；保存快照用 save",
                "版本号未确认或用户未同意回滚时不要执行"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "user_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "user_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc version revert --node \u003cDOC_ID\u003e --version 3 --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc version revert --node \u003cDOC_ID\u003e --version 3 --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "用户明确要求将 adoc 回滚到指定历史版本（已从 version list 确认版本号）时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "用户明确要求将 adoc 回滚到指定历史版本（已从 version list 确认版本号）时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "用户明确要求将 adoc 回滚到指定历史版本（已从 version list 确认版本号）时"
      ]
    },
    "doc version save": {
      "agent_summary": "手动保存文档版本快照",
      "agent_summary_source": "corecmd.SchemaDecl",
      "availability": "available",
      "avoid_when": [
        "回滚用 revert；只看历史用 list"
      ],
      "confirmation": "not_required",
      "effect": "write",
      "effect_source": "corecmd.contract",
      "examples": [
        "dws doc version save --node \u003cDOC_ID\u003e --format json"
      ],
      "field_provenance": {
        "agent_summary": {
          "value": "手动保存文档版本快照",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "手动保存文档版本快照",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "availability": {
          "value": "available",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "available",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "avoid_when": {
          "value": [
            "回滚用 revert；只看历史用 list"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "回滚用 revert；只看历史用 list"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "confirmation": {
          "value": "not_required",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "not_required",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "effect": {
          "value": "write",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "write",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "examples": {
          "value": [
            "dws doc version save --node \u003cDOC_ID\u003e --format json"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "dws doc version save --node \u003cDOC_ID\u003e --format json"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "idempotency": {
          "value": "unknown",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "unknown",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_mode": {
          "value": "composite",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "composite",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_reason": {
          "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "interface_ref": {
          "value": null,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "interface_disposition_matrix",
          "review_reason": "final interface mode composite forbids a direct MCP interface_ref",
          "candidates": [
            {
              "value": null,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true,
              "review_reason": "final interface mode composite forbids a direct MCP interface_ref"
            }
          ]
        },
        "reviewed": {
          "value": true,
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": true,
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "risk": {
          "value": "medium",
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": "medium",
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        },
        "use_when": {
          "value": [
            "手动保存当前文档版本快照时"
          ],
          "source": "corecmd.contract",
          "precedence": "contract_final",
          "resolution": "highest_precedence",
          "candidates": [
            {
              "value": [
                "手动保存当前文档版本快照时"
              ],
              "source": "corecmd.contract",
              "precedence": "contract_final",
              "selected": true
            }
          ]
        }
      },
      "idempotency": "unknown",
      "interface_mode": "composite",
      "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.",
      "reviewed": true,
      "risk": "medium",
      "source_refs": [
        "corecmd.SchemaDecl"
      ],
      "use_when": [
        "手动保存当前文档版本快照时"
      ]
    }
  }
}