From 90cf757b5e97827fa330d9c174ea910704077c60 Mon Sep 17 00:00:00 2001
From: jade <jade.kimhs@gmail.com>
Date: Tue, 18 Aug 2026 21:58:34 +0900
Subject: [PATCH] refactor(was-sys): migrate iam_access_policy tool metadata
 from YAML to @GrowToolHint annotation

---
 .../biz/iam/usecase/SystemStatusUseCase.java  | 21 +++++++++++++++++-
 .../iam/iam_access_policy.yml                 | 22 -------------------
 2 files changed, 20 insertions(+), 23 deletions(-)
 delete mode 100644 dap-was-sys/src/main/resources/tool-definitions/iam/iam_access_policy.yml

diff --git a/dap-was-sys/src/main/java/io/shinhanlife/dap/mcc/biz/iam/usecase/SystemStatusUseCase.java b/dap-was-sys/src/main/java/io/shinhanlife/dap/mcc/biz/iam/usecase/SystemStatusUseCase.java
index 5fe47f8ad..4615f2ea6 100644
--- a/dap-was-sys/src/main/java/io/shinhanlife/dap/mcc/biz/iam/usecase/SystemStatusUseCase.java
+++ b/dap-was-sys/src/main/java/io/shinhanlife/dap/mcc/biz/iam/usecase/SystemStatusUseCase.java
@@ -13,14 +13,33 @@ public interface SystemStatusUseCase {
     SystemStatusResponse getSystemStatus(SystemStatusRequest request);
 
     @McpTool(name = "iam_service_health", title = "서비스 상태 조회", description = "모의 서비스 상태를 조회합니다.")
+    @GrowToolHint(requiresApproval = false, categoryKey = "iam", mappingId = "DIRECT_IAM_SERVICE_HEALTH")
     SystemStatusResponse getServiceHealth(SystemStatusRequest request);
+
     @McpTool(name = "iam_environment_info", title = "환경 정보 조회", description = "모의 환경 정보를 조회합니다.")
+    @GrowToolHint(requiresApproval = false, categoryKey = "iam", mappingId = "DIRECT_IAM_ENVIRONMENT_INFO")
     SystemStatusResponse getEnvironmentInfo(SystemStatusRequest request);
+
     @McpTool(name = "iam_deployment_version", title = "배포 버전 조회", description = "모의 배포 버전을 조회합니다.")
+    @GrowToolHint(requiresApproval = false, categoryKey = "iam", mappingId = "DIRECT_IAM_DEPLOYMENT_VERSION")
     SystemStatusResponse getDeploymentVersion(SystemStatusRequest request);
 
     @McpTool(name = "iam_access_policy", title = "접근 정책 조회", description = "모의 접근 정책을 조회합니다.")
-    @GrowToolHint(requiresApproval = false, categoryKey = "iam", mappingId = "DIRECT_IAM_ACCESS_POLICY")
+    @GrowToolHint(
+        requiresApproval = false, 
+        categoryKey = "iam", 
+        mappingId = "DIRECT_IAM_ACCESS_POLICY",
+        functionDescription = "모의 접근 정책 조회 정보를 조회합니다.",
+        whenToUse = "접근 정책 조회 확인이 필요할 때 사용합니다.",
+        whenNotToUse = "정보 변경이나 실행 작업에는 사용하지 않습니다.",
+        ioLimits = "모의 조회 데이터만 반환하며 외부 시스템을 변경하지 않습니다.",
+        displayDescription = "접근 정책 조회 정보를 조회합니다.",
+        exampleQueries = {"접근 정책 조회 정보를 보여줘", "접근 정책 조회을 확인해줘", "현재 접근 정책 조회을 알려줘"},
+        destructive = false,
+        idempotent = true,
+        tags = {"iam", "조회", "mock"},
+        ownerOrg = "MCP_TOOL"
+    )
     SystemStatusResponse getAccessPolicy(SystemStatusRequest request);
 
     @McpTool(name = "iam_session_status", title = "세션 상태 조회", description = "모의 세션 상태를 조회합니다.")
diff --git a/dap-was-sys/src/main/resources/tool-definitions/iam/iam_access_policy.yml b/dap-was-sys/src/main/resources/tool-definitions/iam/iam_access_policy.yml
deleted file mode 100644
index 5d37ca1f5..000000000
--- a/dap-was-sys/src/main/resources/tool-definitions/iam/iam_access_policy.yml
+++ /dev/null
@@ -1,22 +0,0 @@
-name: iam_access_policy
-display_name: 접근 정책 조회
-version: 1.0.0
-category_key: iam
-description:
-  function: 모의 접근 정책 조회 정보를 조회합니다.
-  when_to_use: 접근 정책 조회 확인이 필요할 때 사용합니다.
-  when_not_to_use: 정보 변경이나 실행 작업에는 사용하지 않습니다.
-  io_limits: 모의 조회 데이터만 반환하며 외부 시스템을 변경하지 않습니다.
-display_description: 접근 정책 조회 정보를 조회합니다.
-example_queries: ["접근 정책 조회 정보를 보여줘", "접근 정책 조회을 확인해줘", "현재 접근 정책 조회을 알려줘"]
-read_only: true
-destructive: false
-idempotent: true
-parameters_schema:
-  type: object
-  properties:
-    environment: {type: string, description: 조회할 환경명, pattern: "^[a-zA-Z0-9_-]{2,20}$"}
-  additionalProperties: false
-tags: [iam, 조회, mock]
-required_env_keys: []
-owner_org: MCP_TOOL