feat: apply tool schema v17 metadata

README.md

@@ -269,3 +269,38 @@ Tool 관련 공통 기능은 `dap-was-*` 모듈명만 기준으로 동작합니
 - Tool Scaffold는 Pod 이름을 Tool 함수명에 포함하지 않습니다. 함수명은 `도메인_비즈니스_행위` 형식입니다. 예: `cmm_notification_send`
 - Pod Scaffold와 Gateway Scaffold 화면/API의 모듈 목록도 `dap-was-*` 명칭으로 통일되어 있습니다.
 - Tool Source Update 기능은 `dap-was-*` 아래의 `*UseCase.java`를 검색합니다.
+
+## 14. BC-DAB-STD-003 Tool Schema V17 적용
+
+각 Tool의 표준 명세는 Tool Pod별 다음 경로에서 관리합니다.
+
+```text
+dap-was-{pod}/src/main/resources/tool-definitions/{categoryKey}/{toolName}.yml
+```
+
+Tool 이름은 Pod 정보를 포함하지 않는 `도메인_서비스_행위` 형태의 영문 소문자 snake_case를 사용하며,
+정규식 `^[a-z][a-z0-9_]{2,63}$`을 만족해야 합니다. 예: `cmm_claim_search`.
+
+필수 항목은 `name`, `display_name`, `version`, `category_key`, 설명 4개 요소(function, when_to_use,
+when_not_to_use, io_limits), `display_description`, 예시 질의 3~10건, 동작 힌트 3개(read_only,
+destructive, idempotent), `parameters_schema`입니다. 입력 Schema는 루트 `type: object`, 각 property의
+`description`, `additionalProperties: false`를 갖춰야 합니다. 선택 운영 항목은 `tags`,
+`legacy_interface_id`, `required_env_keys`, `owner_org`입니다.
+
+기동 시 `tool-definitions/**/*.yml`을 한 번 읽어 이름 기준으로 캐시하고, `@McpTool` 실행 정보와 결합한
+동일한 `ToolMetadata`를 `/tool-manifest`, Tool Pod MCP, Gateway MCP에 사용합니다.
+
+입력 Schema 우선순위는 `inputSchemaResource` → V17 `parameters_schema` → DTO 자동 생성이고, 출력은
+`outputSchemaResource` → 명시 Output Schema → `@McpOutputSchema` 기반 생성입니다. Output Schema를
+명시한 Tool만 최종 응답 검증을 수행합니다.
+
+Scaffold 화면의 `Tool Schema V17 Metadata` 영역에서는 기능 설명, 사용/비사용 조건, 입출력 제한,
+표시 설명, 예시 질의, 태그와 소유 조직을 입력합니다. Java 소스와 함께 V17 YAML이 생성되며, 기본값은
+배포 전에 업무 담당자가 실제 의미에 맞게 검토해야 합니다.
+
+```powershell
+.\gradlew.bat validateMcpToolNames validateToolSchemaV17
+```
+
+`bootJar`는 두 검증에 의존하므로 이름 중복, 필수 항목 누락, Java Tool과 YAML 명세 불일치가 있으면
+Docker 이미지 생성 전에 빌드가 실패합니다.