用途:当某个库的 reachability-metadata.json 缺少必要条目、导致测试报缺失元数据错误时,按“复现—修复—验证”循环补齐条目,直到目标测试通过且不再出现新的缺失元数据。库坐标需在提示中以 group:artifact:version 提供,不确定时应询问用户。
主要能力与用法:在仓库根目录运行 ./gradlew test -Pcoordinates=<coordinates> 复现失败;从错误信息中找出 Missing*RegistrationError(如 MissingReflectionRegistrationError、MissingResourceRegistrationError 等),把建议的 JSON 条目复制到 reachability-metadata.json 的对应章节。目标文件为 metadata/<library-specific-metadata-directory>/reachability-metadata.json。保持 JSON 有效,避免重复已有等价条目;若类型已存在仅缺方法或字段,则只补该方法或字段。接着补充 condition 字段,依据错误堆栈推断,设为 { "typeReached": "<class>" },其中 <class> 是堆栈中首个与所测库包共享前置命名空间的类;包重叠可部分匹配,无需包完全相等,例如库组为 org.hibernate.orm... 时,堆栈中的 org.hibernate.resource... 类是有效匹配。随后再次运行同一命令验证,若又出现缺失条目,从捕获步骤重复;仅在测试运行成功时结束。
限制与环境:资料给出了错误模式示例(如 MissingReflectionRegistrationError 建议加入 reflection 章节的条目),以及条件推断示例:缺失类型 org.hibernate.id.enhanced.SequenceStyleGenerator 时,有效条件类为 org.hibernate.boot.model.internal.GeneratorBinder,因二者共享 org.hibernate 前置命名空间。若失败看似无关或工具行为不一致,应检查 JAVA_HOME 与 GRAALVM_HOME 是否都指向兼容的 GraalVM JDK 发行版;若不是,请用户提供正确的 GraalVM 路径后重试。其他平台支持、收费与更多限制暂未提供。