docs(harness): annotate entry orchestration, enums, and exception recovery paths

src/main/java/com/superbiz/agent/harness/contract/EvidenceStatus.java

@@ -1,7 +1,23 @@
 package com.superbiz.agent.harness.contract;
 
+/**
+ * 单次工具调用在「证据语义」上的结果状态（工具契约 / 进度）。
+ *
+ * <p>与 {@link InvocationStatus} 分工：
+ * <ul>
+ *   <li>InvocationStatus：调用生命周期（投影中/就绪/错误）</li>
+ *   <li>EvidenceStatus：这次调用有没有拿到可引用证据</li>
+ * </ul>
+ * NO_EVIDENCE 仍可能是 success 的工具执行（查了但空），常记为信息无增益。
+ */
 public enum EvidenceStatus {
+
+    /** 返回了可被引用的证据块。 */
     EVIDENCE_FOUND,
+
+    /** 执行完成但范围内无证据（空结果，不是必然系统故障）。 */
     NO_EVIDENCE,
+
+    /** 工具侧错误或无法形成合法证据观察。 */
     ERROR
 }