feed-health is a WordPress plugin for the operator of a site that imports from feeds. It records each fetch attempt and what it yielded, shows every feed on one admin screen, and emails or logs when a feed goes quiet, starts failing, stops being fetched or recovers. The code is at https://github.com/IndianOpinion/feed-health, licensed MIT. Version v0.1.0 was released on 15 November 2026.
We wrote it from scratch from an idea, not from any third-party plugin. It has not run on a live site. The 47 utilities in this series were specified, built, reviewed and released between 11 and 19 November 2026 by language-model coding agents under the editor’s direction, in five roles: a spec writer, a spec reviewer, a builder that saw only the spec, an independent code reviewer and a releaser. The editor made the rulings on every open question.
A site that imports from many feeds has no view of the feeds themselves. One feed can stop returning items, start answering with an error page, move address, or keep returning articles that other feeds already supplied. The site looks fine. The loss shows up weeks later as a thin section or a missing source.
The PRD names three things that make this worse:
ok, not_modified, http_error, transport_error, parse_error, empty, cached or failure_other. A parse_error is a 200 that is not a feed, such as a bot challenge, a login wall or a parked domain.paused, failing, unchecked, quiet, redundant, degraded, new or healthy.wp feed-health command set (status, check, test-alert, events, mute, snooze, prune).Feeds are identified by an adapter key and a feed key, never by position or URL. An importer reports in one of three ways: by swapping fetch_feed() for a wrapper, through plain-array WordPress actions, or by implementing an Adapter class. A passive mode observes every core fetch_feed() call through the wp_feed_options and http_api_debug hooks, with no code change.
do_action( 'feed_health_fetch', [
'adapter' => 'my-importer', 'feed_key' => 'world', 'feed_url' => $url,
'outcome' => 'ok', 'http_status' => 200, 'items' => 20, 'run_id' => $run_id,
] );
A Recorder buffers fetches and items, then flushes at the end of a run, at 500 rows, and on shutdown. An item key is a hash of the canonical URL: no scheme, no www., m., mobile. or amp. label, no fragment, no trailing slash, no tracking parameters, sorted query. Item bodies are never stored.
A Checker runs hourly, after each import run and daily. It reads only the plugin’s own tables and never fetches. Its status rules are pure functions, so each is tested with plain numbers. The quiet threshold is twice the 90th percentile gap between new-item arrivals over 14 days, clamped between 6 hours and 7 days. Below five recorded gaps a default of 48 hours applies.
The notifier follows changes, not states. It applies a cooldown per feed and status, reminders, flapping detection (more than four status changes in 24 hours), a daily email cap, and one systemic alert when most feeds fail together, which usually points at the site’s own network.
=, +, - or @ get a leading quote, so a hostile feed label cannot become a spreadsheet formula.The independent code review found and fixed these before the merge:
feed_health_capability.The review also raised static analysis from level 6 to level 8.
cached and are not attempts.DELETE per table.fh_notice URL parameter after escaping it, so a crafted link can show misleading text that looks like a plugin message. The proposed fix is a keyed message table that ignores unknown values.Test status: this is v0.1.0. There are 155 PHPUnit tests, mostly on stubs and mocks with a frozen clock, plus 3 integration tests against a throwaway MySQL 8.0. Static analysis and code style checks passed. The GitHub CI workflow has not run: the commit adding it stayed local because the token lacked the workflow scope.
It needs WordPress 6.4 or later, PHP 8.1 or later, and MySQL 5.7+ or MariaDB 10.4+. It has no runtime dependencies.
composer require indianopinion/feed-health
The package is not on Packagist yet, so add a Composer vcs repository entry for https://github.com/IndianOpinion/feed-health first.
Or copy the folder to wp-content/plugins/ and activate it. A must-use loader is in examples/.