Changelog Watcher

Maintains a watchlist of GitHub repos and npm packages, detects new releases, and produces markdown reports with breaking changes highlighted.

Files

• - watchlist.json — user config (create from assets/watchlist.example.json)
• INLINECODE2 — auto-managed last-seen versions (do not edit)
• INLINECODE3 — main entry point; calls the others
• INLINECODE4 — GitHub releases API
• INLINECODE5 — npm registry
• INLINECODE6 — markdown report generator

For setup, watchlist format, cron scheduling, and rate limit guidance → read references/setup-guide.md.

Skill Directory

CODEBLOCK0

All script paths below are relative to this directory.

Usage

Check for new releases and print report

CODEBLOCK1

Dry-run (check without advancing state)

CODEBLOCK2

First-time setup (set baseline, no output)

CODEBLOCK3

Workflow

1. 1. Confirm watchlist.json exists. If not, guide user to copy from assets/watchlist.example.json and fill it in.
2. Run compare_versions.py (with --update-state unless doing a dry-run).
3. Pipe output to format_report.py.
4. Present the markdown report to the user.
5. If the user wants to schedule this: provide the cron line from references/setup-guide.md.

Adding Entries

To add a GitHub repo:
CODEBLOCK4

To add an npm package:
CODEBLOCK5

Append to the watch array in watchlist.json, then run the full pipeline.

Error Handling

• - Rate limited (exit 2): Wait for the retry window; check how many GitHub entries are in the watchlist vs the 60/hr limit.
• Not found (exit 3): Verify the owner/repo or package name in the watchlist.
• Network error: Check connectivity; retry.
• First-run shows zero releases: Expected — first run sets the baseline only.