Social Relay 0.1.0 — first packaged build

First packaged build of Social Relay.

This is a pre-release. It has never posted to X in production. Everything below is verified against the specification and against real WordPress, which is not the same thing as verified in production.

What it does

Publishes the title, featured image and permalink of each newly published WordPress post to one X account, after a configurable delay — with no duplicate posts and no silent failures.

Before you install: this costs money

X ended its free API tier for new developers in February 2026, and every real post this plugin makes contains a link, which is the expensive case.

What	Price
A post with a link — every real post this plugin makes	$0.200
A post without a link ("Send test post")	$0.015
"Check credentials"	about $0.010

Roughly posts per month × $0.20. Twenty posts a month is about $4; five hundred is about $100. Read INSTALLATION.md before you buy credits.

Install

Download social-relay-0.1.0.zip below, then Plugins → Add New → Upload Plugin.

The master switch is off after activation, so nothing posts until you configure it and turn it on deliberately.

Requires WordPress 6.5+ and PHP 8.2+.

What is verified

Check	Result
PHPCS (WordPress Coding Standards)	clean
PHPStan level 6	clean
Test suite	172 tests, 686 assertions
WordPress 6.5 / PHP 8.2	passing
WordPress 7.1 / PHP 8.4	passing
Installs and activates from this zip	verified on a real site
Uninstall leaves nothing behind	verified on a real site

The plugin was reviewed twice by independent sessions — a specification review (29 findings) and a code review (16 findings, one blocker). All 45 were applied. Both reviews are in reviews/.

What is not verified

Stated plainly, because a release that hides this is worse than one that admits it:

• Never exercised against the live X API beyond a Phase 0 authentication probe. No post from this plugin has ever reached a timeline.
• X Developer Console steps were not walked. INSTALLATION.md steps 1–3 come from official documentation. Every step in that file carries a mark saying whether it was actually performed.
• The cron chain is only partly proven. wp-cron.php responds correctly and sends no-cache headers, and the plugin's heartbeat works — but an external HTTP request causing due jobs to run was not demonstrated end to end in the test environment. Step 8 of INSTALLATION.md is how you confirm it on your own site.
• Image downscaling is not implemented. Images over 5 MB are skipped with a recorded reason rather than resized; the post still goes out without the image.
• No extended live run. A seven-day staging run is planned and has not happened.

Documentation

• INSTALLATION.md — setting it up, for a site administrator
• INSTRUCTIONS.md — using it, for whoever writes the posts
• SPEC.md — what was built, exactly
• DECISIONS.md — why, including the arguments against
• STATE.md — the honest account of what is done and what is not

GPL-2.0-or-later.