fix: activate and automatically index Media Usage

[khoinguyenpham04]

What does this PR do?

Adds an administrator-controlled Media Usage setup flow and automatically indexes existing content in the background.

This draft:

• adds an Admin-only Settings → Media Usage page and a compact Media Library setup notice;
• enables Media Usage from one button and one confirmation dialog, then continues activation on the server if the browser closes;
• shows truthful setup, indexing, completion, and failure states without changing V1 Media Usage responses;
• processes durable entry work in bulk, with up to 1,000 entries in each entry-work batch;
• skips idle maintenance classes while preserving leases, retries, stale-worker fencing, collection-deletion safety, and truthful coverage;
• uses identity-free Cloudflare Queue messages to wake and continue sequential work, with concurrency set to one and Cron retained for recovery;
• runs the same continuation-capable maintenance engine through the Node scheduler;
• updates Cloudflare templates, deployment guidance, generated binding types, tests, and changesets.

The activation request never indexes the full site. Durable database work rows remain authoritative across interruption, retries, and duplicate Queue delivery.

This PR is stacked directly on #2472 and should be reviewed relative to chore/media-usage-dev-seed-readiness.

No linked issue.

Type of change

• Bug fix
• Feature (requires maintainer-approved Discussion)
• Refactor (no behavior change)
• Translation
• Documentation
• Performance improvement
• Tests
• Chore (dependencies, CI, tooling)

Checklist

• I have read CONTRIBUTING.md
• pnpm typecheck passes
• pnpm lint passes
• pnpm test passes (targeted tests for this change)
• pnpm format has been run
• I have added/updated tests for my changes (if applicable)
• User-visible strings in the admin UI are wrapped for translation (if applicable). The focused English catalog update fixes the production fallback; unrelated generated catalogs are unchanged.
• I have added a changeset (if this PR changes a published package)
• New features link to an approved Discussion: not applicable; this completes and accelerates the existing Media Usage system

AI-generated code disclosure

• This PR includes AI-generated code — model/tool: OpenAI Codex (GPT-5.6), with GPT-5.6 Terra adversarial review

Screenshots / test output

The CI preview can be used to review the responsive setup page, Media Library notice, activation states, and indexing progress.

Verified on the combined tip 3b485c00:

• 526 tracked Node Media Usage tests passed, with 2 skipped;
• 14 workerd/D1 tests, 18 Cloudflare scheduler tests, and 25 admin tests passed;
• relevant typechecks, package builds, the documentation build, lint, formatting, and diff checks passed;
• the retained 10,000-entry benchmark preserved exact correctness at 576 SQL queries without a meaningful throughput regression;
• final adversarial review reported no findings.

---

Try this PR

Open a fresh playground →

A full working EmDash site, deployed from this branch. Each visit gets its own session-scoped sandbox: no login needed and no shared state. Try the admin, edit content, hit the public site.

_{Tracks feature/media-usage-activation-and-indexing. Updated automatically when the playground redeploys.}

[changeset-bot]

🦋 Changeset detected

Latest commit: e66bba6

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 17 packages

Name	Type
emdash	Minor
@emdash-cms/cloudflare	Minor
@emdash-cms/admin	Minor
@emdash-cms/sandbox-workerd	Patch
@emdash-cms/plugin-mcp-smoke	Major
@emdash-cms/fixture-perf-site	Patch
@emdash-cms/perf-demo-site	Patch
@emdash-cms/cache-demo-site	Patch
@emdash-cms/do-demo-site	Patch
@emdash-cms/do-solo-demo-site	Patch
@emdash-cms/auth	Minor
@emdash-cms/blocks	Minor
@emdash-cms/gutenberg-to-portable-text	Minor
@emdash-cms/x402	Minor
create-emdash	Minor
@emdash-cms/auth-atproto	Patch
@emdash-cms/plugin-embeds	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Scope check

This PR changes 3,521 lines across 63 files. Large PRs are harder to review and more likely to be closed without review.
This PR spans 5 different areas (area/core, area/admin, area/docs, area/templates, area/cloudflare). Consider breaking it into smaller, focused PRs.

If this scope is intentional, no action needed. A maintainer will review it. If not, please consider splitting this into smaller PRs.

See CONTRIBUTING.md for contribution guidelines.

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	emdash-demo-do	e66bba6	Aug 20 2026, 10:13 PM

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	emdash-playground	1fcbc86	Aug 18 2026, 10:43 AM

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	docs	ccecc1e	Aug 20 2026, 09:59 PM

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	emdash-demo-cache	e66bba6	Aug 20 2026, 10:15 PM

[github-actions]

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File	Note
packages/admin/src/locales/en/messages.po	Source changed, localizations will be marked as outdated.

Warnings reference

Icon	Description
🔄️	The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

[github-actions]

Overlapping PRs

This PR modifies files that are also changed by other open PRs:

• Speed up automatic Media Usage indexing #2539 (39 shared files)
• feat(admin): add Media Usage setup and indexing progress #2531 (32 shared files)
• fix(core): add controlled media usage activation #2445 (11 shared files)
• feat(core): built-in SMTP email transport for generic SMTP credentials #2156 (3 shared files)
• Add deployment-managed core migration primitives #2437 (3 shared files)
• feat: reference field type (storage-less edges + admin UI) #1928 (3 shared files)
• [codex] Add visual sections and public Pages preview #1206 (4 shared files)
• feat: cache purge API (object cache + native Workers Caching) #2297 (4 shared files)
• feat: gate sandboxed plugins behind Worker Loader so free-tier Cloudflare deploys work #2351 (4 shared files)
• fix(admin): lazy-load Media Library thumbnails #1827 (3 shared files)
• feat(media) Adds media drag uploads and picker metadata editing #1366 (3 shared files)
• feat(admin): core update notice in the admin dashboard (WordPress-style version banner) #1939 (3 shared files)

This may cause merge conflicts or duplicated work. A maintainer will coordinate.