bulk commit changes!

This commit is contained in:
2026-02-13 02:32:06 -05:00
parent c8f98c54c9
commit bf4a40f533
152 changed files with 2210 additions and 19 deletions

View File

@@ -0,0 +1,37 @@
## Purpose
Canonical specification for queued-image-refetch-with-backoff requirements synced from OpenSpec change deltas.
## Requirements
### Requirement: Latest-30 queue construction
The refetch-images command SHALL enqueue up to the latest 30 news items for processing.
#### Scenario: Queue population
- **WHEN** refetch-images is started
- **THEN** the command loads recent news items
- **AND** enqueues at most 30 items ordered from newest to oldest
### Requirement: Sequential processing
The image refetch queue SHALL be processed one item at a time.
#### Scenario: Single-item worker behavior
- **WHEN** queue processing runs
- **THEN** only one queued item is processed concurrently
- **AND** next item starts only after current item completes/fails
### Requirement: Exponential backoff on transient failures
The queue processor SHALL retry transient image-provider failures using exponential backoff.
#### Scenario: Rate-limited provider response
- **WHEN** provider call returns rate-limit or transient error
- **THEN** command retries with exponential delay between attempts
- **AND** stops retrying after configured max attempts
### Requirement: Progress and completion reporting
The command SHALL emit operator-readable progress and final summary output.
#### Scenario: Queue progress output
- **WHEN** queue processing is in progress
- **THEN** the command prints per-item progress (processed/succeeded/failed)
- **AND** prints final totals on completion