fix(dispatch): 孤儿任务恢复重投与 Edge hubTaskId 去重

[DeliciousBuding]

Summary

Closes #2066

Hub 在「任务入队」与「outbox 记录」之间存在崩溃窗口与信号量回退两条静默丢失通道。本 PR 实现孤儿任务恢复重投机制，确保每个入队任务都必然收敛——被投递或被显式处理，不再静默滞留。

Changes

Task 1: Edge hubTaskId 去重

• Run struct 新增 HubTaskID 字段，store 层支持 GetRunByHubTaskID/SetRunHubTaskID
• runcontrol.Create 在 runCreationMu 锁内检查已有同 hubTaskID 的 run 并幂等返回
• SQLite migration v5 添加 edge_runs.hub_task_id 列与部分索引
• 验收: go test ./internal/runcontrol/ -run TestCreateHubTaskIDDedup -v → PASS

Task 2: pending_agent_tasks 持久化 model_params

• Migration 0069 添加 model_params JSONB 列（up→down→up 已在临时 PG 验证）
• TriggerAgentTask 创建任务时写入 modelParams
• 验收: go test -short ./... → ALL PASS

Task 3: 孤儿恢复 sweeper

• Repository: ClaimOrphanedTasks（CAS UPDATE + NOT EXISTS delivery_outbox）
• dispatchsvc: StartOrphanRecoveryLoop 定期扫描，redeliverOrphanedTask 重建上下文
• 上下文重建：prompt←trigger_message, AI←agent_instance, customAgent preload, targetType re-derive
• 接入 app/wiring.go background group
• 验收: go test ./internal/service/dispatchsvc/ -run TestClaimOrphanedTasks -v → 5/5 PASS

Task 4: Metrics + Logging

• 新文件 metrics/dispatch_orphan.go（DispatchOrphanDiscovered/Redelivered）
• sweeper 结构化 slog 日志
• 验收: go vet clean

Task 5: L1 集成测试（真 PG）

• TestOrphanRecovery_ClaimAndRedeliver: queued+无 outbox+超 grace → claimed ✅
• TestOrphanRecovery_GraceWindowNotClaimed: grace 内不被触碰 ✅
• TestOrphanRecovery_TaskWithOutboxNotClaimed: 有 outbox 行不捞 ✅
• 验收: AGENTHUB_DB_PASSWORD=dev_password go test -tags integration ./tests/integration/ -run TestOrphanRecovery -v → 3/3 PASS

Design Decisions

• Grace 窗口默认 120s（远大于 dispatch goroutine 启动延迟）
• 恢复重投复用现有 DispatchService.DispatchTask 入口
• model_params 落库类型 jsonb，参照 custom_agents.model_params
• targetType 不落库，由 target_id 重新推导
• Edge 去重在 store 层实现（持久化）， survives Edge restart

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 48db4d00-6371-4beb-8e02-f5a20139018e

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}