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

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

@@ -1,7 +1,19 @@
 package com.superbiz.agent.harness.contract;
 
+/**
+ * 工具调用在 canonical store 中的生命周期状态。
+ *
+ * <p>READY 的记录才可作为 Evidence Guard 引用目标；
+ * PROJECTING 表示尚未完成投影落库；ERROR 表示本调用失败收尾。
+ */
 public enum InvocationStatus {
+
+    /** 已 begin，正在执行/投影，尚不可作为最终引用。 */
     PROJECTING,
+
+    /** 投影完成且可引用（agentResult + evidenceStatus 已固化）。 */
     READY,
+
+    /** 本调用以错误结束。 */
     ERROR
 }