Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions docs/release-notes/v0.2.1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
## v0.2.1

Adds date-range filters to `articles` and normalizes stored timestamps to UTC so the comparison is correct regardless of feed timezone.

### New

- `articles --since YYYY-MM-DD` (inclusive) and `--before YYYY-MM-DD` (exclusive) filter the list by publication date. Articles without a publication date are excluded when either flag is set. Available as `BLOGWATCHER_SINCE` / `BLOGWATCHER_BEFORE` (#21)

### Improved

- Stored timestamps (`published_date`, `discovered_date`, `last_scanned`) are normalized to UTC at write time so `--since` / `--before` compare correctly across feeds with non-UTC offsets (#23)
- Reject `--since > --before` with a clear error instead of silently returning an empty list (#23)
- Surface `--since` / `--before` parse errors through the standard error path, matching the rest of the `articles` command (#23)

### Internal

- Migration `000003` rewrites existing rows to UTC RFC3339 (second precision). Unparseable legacy timestamps are preserved via `COALESCE` instead of being silently dropped (#23)

### Contributors

- [@JulienTant](https://github.com/JulienTant)
3 changes: 3 additions & 0 deletions skills/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,7 @@ Track blog and RSS/Atom feed updates with the `blogwatcher-cli` tool. Supports a
- Remove a blog: `blogwatcher-cli remove "My Blog" --yes`
- Import blogs from OPML: `blogwatcher-cli import subscriptions.opml`
- Filter by category: `blogwatcher-cli articles --category "Engineering"`
- Filter by date: `blogwatcher-cli articles --since 2024-01-01 --before 2024-02-01` (`--since` inclusive, `--before` exclusive, both `YYYY-MM-DD`)

## Environment variables

Expand All @@ -51,6 +52,8 @@ All flags can be set via environment variables with the `BLOGWATCHER_` prefix:
- `BLOGWATCHER_SILENT` - Only output "scan done" when scanning
- `BLOGWATCHER_YES` - Skip confirmation prompts
- `BLOGWATCHER_CATEGORY` - Filter articles by category
- `BLOGWATCHER_SINCE` - Filter articles published on or after `YYYY-MM-DD`
- `BLOGWATCHER_BEFORE` - Filter articles published before `YYYY-MM-DD`

## Example output

Expand Down