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

pulse/service/history.go

@@ -27,6 +27,7 @@ type AttemptSummary struct {
 	LeaseUntil   time.Time          `json:"lease_until"`             // LeaseUntil 数据库记录的租约期限；查询不能授权业务执行。
 	AuthorizedAt *time.Time         `json:"authorized_at,omitempty"` // AuthorizedAt 开始批准时间；空表示未批准，不证明副作用已经发生。
 	EndedAt      *time.Time         `json:"ended_at,omitempty"`      // EndedAt 尝试结束时间；仍在执行时为空。
+	Retryable    bool               `json:"retryable,omitempty"`     // Retryable 该明确失败报告是否声明可安全重试；不代表平台必定安排重试。
 	ErrorCode    string             `json:"error_code,omitempty"`    // ErrorCode 稳定错误分类；无错误时为空。
 	CreatedAt    time.Time          `json:"created_at"`              // CreatedAt 创建时间，UTC 微秒精度。
 	UpdatedAt    time.Time          `json:"updated_at"`              // UpdatedAt 最新变更时间，不能代替版本校验。
@@ -53,6 +54,7 @@ type EvidenceSummary struct {
 	AttemptID   core.ID   `json:"attempt_id"`           // AttemptID 所属执行尝试。
 	Outcome     string    `json:"outcome"`              // Outcome Worker 声明的 SUCCEEDED、FAILED 或 UNKNOWN，不代表平台认可。
 	ErrorCode   string    `json:"error_code,omitempty"` // ErrorCode 原报告的稳定分类，可为空。
+	Retryable   bool      `json:"retryable,omitempty"`  // Retryable 原报告的重试声明；证据不触发重试。
 	Reason      string    `json:"reason"`               // Reason LEASE_LOST、NOT_STARTED 或 RESULT_CONFLICT。
 	Disposition string    `json:"disposition"`          // Disposition 固定为 EVIDENCE_ONLY，表示采集时仅保存证据。
 	CreatedAt   time.Time `json:"created_at"`           // CreatedAt 首次收到时间，重复报告不改变它。

pulse/service/types.go

@@ -59,6 +59,8 @@ type TaskView struct {
 	Payload json.RawMessage `json:"payload"`
 	// Result 业务 JSON 结果；未取得结果时为空并省略。
 	Result json.RawMessage `json:"result,omitempty"`
+	// EffectUncertain 曾有执行效果尚未核实；重试与预算耗尽不会把未知伪装成明确失败。
+	EffectUncertain bool `json:"effect_uncertain,omitempty"`
 	// BusinessKey 可选业务关联键，不自动提供业务效果幂等。
 	BusinessKey string `json:"business_key,omitempty"`
 	// AvailableAt 最早可执行时间，UTC。
@@ -125,6 +127,8 @@ type TaskSummary struct {
 	Handler string `json:"handler"`
 	// HandlerVersion 受理时固定的处理器版本。
 	HandlerVersion string `json:"handler_version"`
+	// EffectUncertain 曾有执行效果尚未核实；重试与预算耗尽不会把未知伪装成明确失败。
+	EffectUncertain bool `json:"effect_uncertain,omitempty"`
 	// BusinessKey 可选业务关联键，不自动提供业务效果幂等。
 	BusinessKey string `json:"business_key,omitempty"`
 	// AvailableAt 最早可执行时间，UTC。