feat: add durable safe retries with uncertainty tracking and SDK examples

docs/api/execution-history.md

@@ -6,7 +6,7 @@
 
 任务代表一次受理的工作，尝试代表其中一次执行代次。领取后未获开始授权就过期的尝试也会保留，并消耗尝试预算。重连恢复同一次尝试，不创建新的尝试记录。
 
-证据保存 Worker 的迟到、未开始或冲突报告。`outcome=SUCCEEDED` 只是原报告的声明；`disposition=EVIDENCE_ONLY` 表示采集时仅作为证据保存，不能解释为任务成功。权威任务状态与结果使用 [GetTask](tasks.md) 查询。当前接口不执行人工裁定、恢复或重试。
+证据保存 Worker 的迟到、未开始或冲突报告。`outcome=SUCCEEDED` 只是原报告的声明；`disposition=EVIDENCE_ONLY` 表示采集时仅作为证据保存，不能解释为任务成功。权威任务状态与结果使用 [GetTask](tasks.md) 查询。当前只读接口不执行人工裁定、恢复或重试。平台自动重试保留每次失败结果；其规则及任务 effect_uncertain 见 [安全重试](retries.md)。
 
 四个接口均要求 `Authorization: Bearer <token>`、`tasks:read` 动作及任务所属队列范围。凭据确定命名空间，每次调用都重新校验有效性。ID 是 32 位小写十六进制字符串，全部父子关系都校验；知道尝试 ID 或证据 ID 不代表有权读取。
 
@@ -60,6 +60,7 @@ curl "$ORBIT_URL/v1/tasks/$TASK_ID/attempts/$ATTEMPT_ID/evidence/$EVIDENCE_ID" \
 | authorized_at | UTC RFC 3339 / 否 | 获批开始时间；省略表示尚未获批，不证明外部效果是否发生 |
 | ended_at | UTC RFC 3339 / 否 | 尝试结束时间；尚未结束时省略 |
 | error_code | string / 否 | 稳定错误分类，无错误时省略 |
+| retryable | bool / 否 | Worker 对明确失败的可安全重试声明，false 时省略；不证明平台实际安排了重试 |
 | created_at、updated_at | UTC RFC 3339 / 是 | 创建和最近更新时间，最多微秒精度 |
 | session_id、worker_instance_id | string / 仅详情 | 当前或最后归属会话及进程身份；会话可能因恢复改变，不是完整归属变更日志 |
 | result | JSON / 仅详情，可省略 | 此尝试已保存的结果；无结果时省略，与追加证据分开 |
@@ -108,6 +109,7 @@ curl "$ORBIT_URL/v1/tasks/$TASK_ID/attempts/$ATTEMPT_ID/evidence/$EVIDENCE_ID" \
 | id、task_id、attempt_id | string / 是 | 证据及已校验的父资源标识 |
 | outcome | string / 是 | 原报告的 SUCCEEDED、FAILED 或 UNKNOWN |
 | error_code | string / 否 | 原报告的错误分类，空时省略 |
+| retryable | bool / 否 | 原失败报告的重试声明，false 时省略；证据不触发执行 |
 | reason | string / 是 | LEASE_LOST（授权失效）、NOT_STARTED（未获批开始）、RESULT_CONFLICT（与已保存结果冲突） |
 | disposition | string / 是 | 固定 EVIDENCE_ONLY，描述采集处理方式 |
 | created_at | UTC RFC 3339 / 是 | 首次保存时间，相同身份的重复报告不刷新 |