# We open-sourced 47 small utilities in nine days

Between 11 and 19 November 2026 we published 47 small repositories under [github.com/IndianOpinion](https://github.com/IndianOpinion). Most are WordPress plugins or plain PHP libraries. Two are Workers. Each does one job. All are MIT licensed and all are at v0.1.0.

This post explains why a small news site publishes its plumbing, what we kept back, how the repos were made, the rules every one of them follows, and where they stand today.

## Why publish the plumbing

Indian Opinion runs on WordPress ([How Indian Opinion is built](https://indianopinion.org/blog/how-indian-opinion-is-built/) describes the system). Running a news brief service on it meant fixing the same class of problem over and over: a feed importer that downloads a page it already has, a title in Telugu that hashes to zero, a home page whose card lists rerun the same expensive queries on a host with no object cache, a model that returns half a JSON object. Each fix started as a few lines inside our own code. Each one was hard to find a ready answer for.

Those fixes are not what makes the site the site. They are plumbing. Keeping them private protects nothing, and publishing them makes us write them properly: a README that says what the code does, tests that pin the behaviour, and a list of what it does not do yet. Another operator who hits the same wall can take the fix instead of rediscovering it.

## What goes out and what stays in

The rule is simple. The editorial pipeline stays private, and so does anything that decides what gets published: selection, ranking, the editorial prompts and the checks that gate a brief. What we say about that work is on our [AI use policy](https://indianopinion.org/ai-use-policy/) and [editorial policy](https://indianopinion.org/editorial-policy/) pages. Reusable plumbing goes out: fetching, de-duplicating, caching, signing, mailing, metering spend, validating model output.

Nothing in the 47 repos carries our configuration, our prompts or our data. Where a README reports a measurement from our own site, it says so and gives the number that matters for the bug, not figures about the site.

## Three groups

**Utilities extracted from problems we hit (21 repos).** These began as fixes on our own site and were pulled out, cleaned up and rewritten as standalone packages. Examples: [simhash-unicode](https://github.com/IndianOpinion/simhash-unicode) (titles in Devanagari, Telugu and Tamil no longer hash to zero; [Text is not ASCII](https://indianopinion.org/blog/text-is-not-ascii/) has the detail), [echo-skip-seen](https://github.com/IndianOpinion/echo-skip-seen) (skip a URL before the importer downloads it again), [query-id-cache](https://github.com/IndianOpinion/query-id-cache) and [llm-json-php](https://github.com/IndianOpinion/llm-json-php).

**Shared services for model-calling features (3 repos, plus two libraries).** Any plugin that calls a paid model needs the same things: a ledger, a cap, a queue that does not pay twice, and prompts that can change without a deploy. [spend-meter](https://github.com/IndianOpinion/spend-meter) records every call and decides before each one whether it may spend. [gen-queue](https://github.com/IndianOpinion/gen-queue) runs bulk jobs with a daily cap, a kill switch and retries, and holds no prompts itself. [prompt-library](https://github.com/IndianOpinion/prompt-library) stores templates as immutable numbered versions. [A queue, a meter and a prompt library](https://indianopinion.org/blog/a-queue-a-meter-and-a-prompt-library/) shows how the three fit together. They sit on top of two extracted libraries, llm-json-php and [packed-vectors](https://github.com/IndianOpinion/packed-vectors).

**Plugins written from scratch from an idea (23 repos).** These started as a one-paragraph idea for a feature a news or content site might want: alt text for images that have none, reply drafts for comments, a summary block for long posts, a chat widget over your own content. None of them is a port. Their README, like the three shared services, carries the line "Written from scratch; not derived from any third-party plugin." Several of these have not run on a live site yet, and their READMEs say so.

## How the work was done

The 47 utilities were specified, built, reviewed and released between 11 and 19 November 2026 by language-model coding agents working under the editor's direction. Each repo passed through five separate roles, and the editor made the ruling on every open question.

- **Spec writer.** Writes a product spec (docs/PRD.md) with numbered cases. Each case names an input, an expected result and the test that will prove it.

- **Spec reviewer.** Reads the spec cold, looks for gaps and contradictions, and sends open questions to the editor.

- **Builder.** Sees only the spec, not the conversation that produced it. It writes the code and one test per numbered case.

- **Code reviewer.** Independent of the builder. It reads the code against the spec, runs the tests, and must fix what it finds before the pull request merges. Its summary is posted as a comment on the build PR, so anyone can read what it found. [What an independent code review caught](https://indianopinion.org/blog/what-independent-review-caught/) sorts those findings by class.

- **Releaser.** Scans the tree for secrets, private hostnames and anything that should not be public, checks the README and changelog, then tags v0.1.0.

The split matters more than the tooling. A builder that sees only the spec cannot lean on context the spec does not write down, so gaps show up as failed builds instead of hidden assumptions. A reviewer who did not write the code reads it as a stranger would.

## House rules

Every repo follows the same rules, so you can trust the shape of one after reading another.

- **Zero or near-zero runtime dependencies.** Most have none. Where one of ours needs another (a plugin that calls a model needs llm-json-php), the README says so.

- **PHP 8.1 or later.** WordPress plugins also state their minimum WordPress and MySQL versions.

- **MIT licence.**

- **Drafts only.** Anything that writes content writes a draft or a suggestion for a person to approve. headline-options never replaces a headline. comment-draft-replies never publishes a reply until a person approves it.

- **A daily cap and a kill switch on anything that spends.** gen-queue runs nothing until a daily cap is set. Every plugin that calls a paid API has a cap and an off switch.

- **No prices shipped.** spend-meter ships the price file format and no prices. Provider prices change; a stale price table is worse than none.

- **Nothing deletes operator data on its own.** Removing tables, files or logs is an explicit operator step. crosspost never deletes or edits a remote post.

## Where they stand

Read this before you install anything.

- Every repo is at **v0.1.0**.

- Every repo is tested on stubs, mocks and a throwaway MySQL database. The extracted utilities have a history on our site in their earlier form; the packaged versions are new. Several of the from-scratch plugins have not run on a live site at all.

- The test suites run locally. **CI has not yet run on GitHub** for any of them.

- None is **on Packagist yet**. To install with Composer, add the repo as a vcs repository entry first:

{
"repositories": [
{"type": "vcs", "url": "https://github.com/IndianOpinion/llm-json-php"}
],
"require": {"indianopinion/llm-json-php": "^0.1"}
}

Composer reads repository entries only from the root project, so a plugin that depends on another of ours needs both listed. Each README shows the entries it needs, and most repos also install without Composer by copying the folder.

Bugs go to the issues tab of the repo concerned. Security problems go by email as each repo's SECURITY.md describes, not as a public issue.

## The 47

Grouped by what they touch, one line each. Each repo also has a note under [Open source at Indian Opinion](https://indianopinion.org/blog/open-source/).

### Model calls and shared services

RepoWhat it does

[llm-json-php](https://github.com/IndianOpinion/llm-json-php)Schema-checked JSON from a chat completions endpoint, with a model chain, cooldowns and a truncation guard.

[gen-queue](https://github.com/IndianOpinion/gen-queue)Job queue for bulk generation with a daily cap, kill switch, retries and cost records.

[spend-meter](https://github.com/IndianOpinion/spend-meter)Ledger of every model call, with daily and monthly caps and a pre-spend filter.

[prompt-library](https://github.com/IndianOpinion/prompt-library)Versioned prompt templates with typed variables and a capped test runner.

### Importing and feeds

RepoWhat it does

[feed-rules](https://github.com/IndianOpinion/feed-rules)Keyword, regex, category and author rules for imported items, with a test screen.

[feed-health](https://github.com/IndianOpinion/feed-health)Tracks per-feed yield, failures and last-item age, and alerts when a feed goes quiet.

[import-scheduler](https://github.com/IndianOpinion/import-scheduler)Runs each import rule on its own interval and lock, so one slow pass starves nothing.

[newsapi-pull](https://github.com/IndianOpinion/newsapi-pull)Pulls NewsAPI headlines into drafts with filters, URL-hash de-duplication and a quota meter.

[gnews-unwrap](https://github.com/IndianOpinion/gnews-unwrap)Resolves Google News interstitial links to the publisher URL.

[readable-extract](https://github.com/IndianOpinion/readable-extract)Extracts body, title, authors, dates and lead image from a news page in plain PHP.

[outlet-key](https://github.com/IndianOpinion/outlet-key)Maps a URL to the newsroom that owns it, and AMP or tracked variants to one article key.

[echo-skip-seen](https://github.com/IndianOpinion/echo-skip-seen)Skips already-imported URLs before Echo RSS Post Importer downloads the page.

[echo-robots-guard](https://github.com/IndianOpinion/echo-robots-guard)Honours robots.txt before Echo downloads an article page.

[feed-item-brief](https://github.com/IndianOpinion/feed-item-brief)Turns one feed item into an attributed summary draft, keeping source link, byline and publish time.

### Text, scripts and similarity

RepoWhat it does

[script-share](https://github.com/IndianOpinion/script-share)Reports what share of a string falls in each writing system, to catch wrong-language output.

[simhash-unicode](https://github.com/IndianOpinion/simhash-unicode)64-bit simhash for titles in any script, with Hamming distance.

[ascii-slugs](https://github.com/IndianOpinion/ascii-slugs)ASCII slugs for non-Latin titles, so WordPress never cuts a percent-encoded slug mid-word.

[packed-vectors](https://github.com/IndianOpinion/packed-vectors)Embeddings in a packed float32 file, rebuilt atomically and scanned by cosine.

[post-embeddings](https://github.com/IndianOpinion/post-embeddings)One embedding per post, with related-posts and semantic search blocks.

[translate-sidecar](https://github.com/IndianOpinion/translate-sidecar)Keeps translations in their own table, with hreflang, canonical tags and per-language sitemaps.

### Images and media

RepoWhat it does

[featured-from-source](https://github.com/IndianOpinion/featured-from-source)Picks a featured image from the source page, skips logos and pixels, sideloads it with credit.

[featured-from-prompt](https://github.com/IndianOpinion/featured-from-prompt)Generates a featured image through any image API, with checks and a per-day cap.

[srcset-truth](https://github.com/IndianOpinion/srcset-truth)Corrects the sizes attribute for fixed-width image slots and serves WebP alongside.

[share-cards](https://github.com/IndianOpinion/share-cards)Social share cards built on request with GD or Imagick and a disk cache.

[alt-text-fill](https://github.com/IndianOpinion/alt-text-fill)Alt text for images that have none, with a dry run, a cap, a review list and an undo.

[uploads-on-r2](https://github.com/IndianOpinion/uploads-on-r2)A Worker that serves the uploads path from R2 with origin fallback.

[read-aloud](https://github.com/IndianOpinion/read-aloud)Text-to-speech version of a post, cached as a file, regenerated only when the text changes.

[audio-to-post](https://github.com/IndianOpinion/audio-to-post)An audio file or podcast episode into a transcript, then a draft.

[yt-to-post](https://github.com/IndianOpinion/yt-to-post)A YouTube video's captions or transcript into a credited draft.

### Caching, serving and search engines

RepoWhat it does

[wp-edge-cache-headers](https://github.com/IndianOpinion/wp-edge-cache-headers)Per-template Cache-Control so a CDN and nginx can cache anonymous HTML.

[query-id-cache](https://github.com/IndianOpinion/query-id-cache)Caches ID lists of expensive WP_Query runs for anonymous requests, cleared on publish.

[comments-through-cache](https://github.com/IndianOpinion/comments-through-cache)Held comments stay visible to their writer, approved ones reach readers without waiting for the cache.

[cloudflare-realip-nginx](https://github.com/IndianOpinion/cloudflare-realip-nginx)Rebuilds the nginx real-IP snippet from Cloudflare's published ranges.

[indexnow-batch](https://github.com/IndianOpinion/indexnow-batch)Queues, filters and de-duplicates URLs, then pings IndexNow in batches.

[jetpack-sync-quiet](https://github.com/IndianOpinion/jetpack-sync-quiet)Moves Jetpack sync off its loopback request and onto cron.

[sigv4-php](https://github.com/IndianOpinion/sigv4-php)AWS SigV4 signing and instance-role credentials in plain PHP, with no SDK.

### Mail and accounts

RepoWhat it does

[signed-mail-gateway](https://github.com/IndianOpinion/signed-mail-gateway)A Worker that sends mail only for HMAC-signed requests, refusing replays and clock skew.

[wp-mail-from](https://github.com/IndianOpinion/wp-mail-from)A must-use plugin that forces a real From address and name on every wp_mail() call.

### Editor tools

RepoWhat it does

[editor-ai-sidebar](https://github.com/IndianOpinion/editor-ai-sidebar)Block-editor sidebar whose actions show each result for approval before anything is written.

[headline-options](https://github.com/IndianOpinion/headline-options)Headline candidates scored by plain rules; never replaces a headline itself.

[meta-writer](https://github.com/IndianOpinion/meta-writer)SEO title and meta description within length limits, respecting manual values.

[tldr-block](https://github.com/IndianOpinion/tldr-block)Summary block for long posts, cached and regenerated when the post changes.

[comment-draft-replies](https://github.com/IndianOpinion/comment-draft-replies)Drafts a reply to each new comment and holds it for a person to approve.

[wc-product-copy](https://github.com/IndianOpinion/wc-product-copy)WooCommerce product descriptions as drafts, in bulk with a dry run.

[crosspost](https://github.com/IndianOpinion/crosspost)Posts to X, Threads, Bluesky and Mastodon on publish through their official APIs.

[sse-chat-widget](https://github.com/IndianOpinion/sse-chat-widget)Chat over your own content, streamed by Server-Sent Events, with prompt and model kept on the server.

[finetune-export](https://github.com/IndianOpinion/finetune-export)Exports posts as JSONL with field selection, redaction and a token count.

Canonical: https://indianopinion.org/blog/forty-seven-small-utilities/

AI disclosure: Every summary and comment here is written by AI and published automatically, without a person reviewing each article. We do no original reporting. How this works: https://indianopinion.org/ai-use-policy/
