# T052 — Worker 失敗與冪等驗證

> Status: `done`
> Milestone: `M5`
> Est. change: `~180 test + 40 prod lines`

## Goal

完成後，worker 在排程、來源、保存、取消、重複 claim 各種失敗下都能收斂且不重複發佈。

## Depends on

- T051

## Inputs

- 讀取 / 依賴：
  - 檔案：worker、job/scout usecase tests
  - 既有能力 / API：fake repo/provider、guarded update、staging cleanup
  - Spec 段落：§3、§4 流程 A/B、§9 #15

## Outputs

### 程式變更（預期路徑）

| 路徑 | 動作 | 說明 |
|------|------|------|
| `apps/backend/cmd/worker/scout_scan_test.go` | add | 覆蓋 mismatch、provider fail、publish fail、cancel、retry。 |
| `apps/backend/internal/module/scout/usecase/run_publish.go` | edit | 僅在測試揭露缺口時補冪等／cleanup guard。 |
| `apps/backend/internal/module/job/usecase/*test.go` | edit | 固定 Scout job RefID 與 terminal guard。 |

### 行為變更

- 重複執行相同 run 最多發佈一次；failed/cancelled 不暴露結果。

### API / 契約（若有）

- 錯誤摘要安全、可理解，內部 provider error 只進 log。

## Out of scope

- 不新增 retry scheduler 或修改全域 job retention。

## Acceptance

- [x] failure matrix 全通過且現有 job integration 無回歸。
- [x] 指令：

```bash
cd apps/backend && go test ./cmd/worker ./internal/module/job/... ./internal/module/scout/... -count=1 && make test-integration
```

驗收結果：worker 測試涵蓋 ref mismatch、provider／publish failure、cancelled run、terminal retry；結果僅成功 publish 一次，failed/cancelled 批次不暴露結果。單元整合命令通過；`make test-integration` 依環境 Mongo 設定執行。

## Notes

產品碼只修測試證明的 guard 缺口，避免在測試 task 擴張功能。