tldr-block is a WordPress plugin that adds a short summary block at the top of long posts. A model writes a draft in the background, an editor approves it, and readers see only approved text. When the post changes materially, the approved summary is withdrawn and a fresh draft is queued for review. Licence MIT. Version v0.1.0, released 19 November 2026.
It was written from scratch from an idea, as one of the utilities described on the engineering blog. It has not run on a live site, and its PRD carries no measured-result line.
Long posts lose readers before the point. A short summary at the top helps the reader decide, helps a screen-reader user skim, and gives a quotable answer. Writing one by hand for every long post is a chore editors skip. Generating it with a model fixes the chore and creates three problems.
edit_others_posts approves, edits and approves, writes their own, or rejects.[tldr] shortcode, a server-rendered “Summary” block, a template function or a REST field.On wp_after_insert_post, Queue builds the source text and a fingerprint: a SHA-256 plus a 128-value bottom-k sketch of word three-shingles. The title is not part of it. The fingerprint is compared with the one the current summary was generated from, never with the previous save, so many small edits add up. A change is material when the hash differs and the estimated Jaccard distance is 0.10 or more. Status flips and meta updates cost nothing.
A material change marks the approved summary stale and, by default, hides it at once. One job per post is pushed back by every material save, a five-minute debounce. Generator re-checks eligibility, takes a lease, reserves a unit of the daily cap under a lock, checks the per-post limit, the cost cap and spend-meter when present, then makes one call through llm-json-php or a caller you supply. The article goes in the user message between markers, and the system message says it is data, not instructions.
Validation checks the point count and length, rejects empty or duplicate points, URLs and instruction-like lines, and checks the script. Every number in the summary is checked against the article, and misses are shown to the editor as unverified figures. The result is a pending candidate, held in post meta.
The rendered markup is small and plain:
<aside class="tldr-block" aria-label="Summary">
<p class="tldr-block__heading">Summary</p>
<ul class="tldr-block__points"><li>...</li></ul>
</aside>
Review writes the live summary, and every regeneration lands as pending.TLDR_BLOCK_DISABLED locks the kill switch on.INSERT IGNORE on the options key.An independent review of the build PR fixed these before the merge.
add_option() checks and then upserts, so two runners could both win the lock. The lock is now a single INSERT IGNORE, and the per-post lease is taken under it.The review also corrected the spend-meter and gen-queue integrations to match the released contracts, and recorded a billed answer that fails validation as a billed error rather than a success.
[sic] are dropped from the source text along with real shortcode tags.tldr_block_display_changed so you can.No issues are open on the repo. Test status: this is v0.1.0, tested on stubs and mocks, with model calls stubbed. 102 PHPUnit tests with 907 assertions pass, PHPStan reports no errors and phpcs is clean. CI has not yet run on GitHub, and the plugin has no production mileage.
It needs WordPress 6.4 or later and PHP 8.1 or later. The library is not on Packagist yet, so add both repositories. The release zip bundles llm-json-php.
{
"repositories": [
{"type": "vcs", "url": "https://github.com/IndianOpinion/llm-json-php"},
{"type": "vcs", "url": "https://github.com/IndianOpinion/tldr-block"}
],
"require": {"indianopinion/tldr-block": "^0.1"}
}