Task Todo

Review the current project instructions and check for task-relevant lessons.
Check repository status before starting retry-queue work.
Re-verify that main includes webhook case management before layering retries on top.
Inspect the current webhook delivery path, config surface, runtime integration point, and manage API hooks.
Write the detailed retry-queue implementation plan to docs/superpowers/plans/2026-06-09-webhook-retry-queue.md.
Execute webhook retry queue backend TDD cycle.
Execute runtime/manage API retry integration TDD cycle.
Update documentation/config formatting for retry queue settings and sinks.
Run targeted verification and final full verification.

Notes

tasks/lessons.md is absent in this repository/worktree, so there were no prior session lessons to review.
Main branch merge result is available locally at 81f1709; retry-queue work continues from branch feat/webhook-retry-queue.

Plan saved to docs/superpowers/plans/2026-06-09-webhook-retry-queue.md.
Chosen scope keeps the first outbound webhook attempt synchronous, then persists failures into a JSONL-backed retry queue with bounded backoff and dead-letter cutoff.
Retry queue observability and manual compensation will be exposed through the management API rather than the frontend in this phase.
Implemented queue-aware webhook delivery in src/cold_display_guard/webhooks.py, runtime retry draining in src/cold_display_guard/main.py, manage API retry list/drain endpoints in src/cold_display_guard/manage_api.py, and config/doc updates in src/cold_display_guard/config.py, config/example.toml, and README_zh.md.
Targeted verification passed:
- eval "$(/opt/homebrew/bin/pyenv init -)" && PYTHONPATH=src python -m unittest tests/test_webhooks.py -v
- eval "$(/opt/homebrew/bin/pyenv init -)" && PYTHONPATH=src python -m unittest tests/test_main.py -v
- eval "$(/opt/homebrew/bin/pyenv init -)" && PYTHONPATH=src python -m unittest tests/test_manage_api.py -v
- eval "$(/opt/homebrew/bin/pyenv init -)" && PYTHONPATH=src python -m unittest tests/test_config.py -v
Final verification passed:
- eval "$(/opt/homebrew/bin/pyenv init -)" && PYTHONPATH=src python -m unittest discover -s tests -v
- cd web && pnpm install --frozen-lockfile && pnpm build