Add media usage read query foundation

[khoinguyenpham04]

What does this PR do?

Adds the internal query foundation for coverage-aware media usage reads. It batches active-entry counts, loads collection coverage, pages complete content-entry groups, and replaces the media-only occurrence index with a composite media/source/generation index justified by query-plan tests.

This PR intentionally adds no REST, client, OpenAPI, documentation, or admin UI surface. A follow-up PR will expose the complete read API after this foundation lands.

Related discussion: #1503

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 (or targeted tests for my 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 (not applicable: no admin UI or user-visible strings)
• I have added a changeset (empty changeset: this internal foundation adds no published behavior or API)
• New features link to an approved Discussion

AI-generated code disclosure

• This PR includes AI-generated code — model/tool: OpenAI GPT-5.6 Sol via OpenCode

Screenshots / test output

No visual changes.

• 56 focused migration, repository, runtime-refresh, and query-plan tests pass.
• Core typecheck passes.
• Full type-aware lint passes after building the registry lexicons required by current main.
• Formatting checks pass.
• Changeset validation passes with no package version bump.
• PostgreSQL dialect execution remains opt-in and was not available locally; SQLite and stats-blind query-plan coverage passed.

---

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 media-usage-read-queries. Updated automatically when the playground redeploys.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 1b8dad1

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

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

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

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[github-actions]

Scope check

This PR changes 878 lines across 7 files. Large PRs are harder to review and more likely to be closed without review.

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.

[pkg-pr-new]

Open in StackBlitz

@emdash-cms/admin

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/admin@2075

@emdash-cms/auth

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/auth@2075

@emdash-cms/auth-atproto

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/auth-atproto@2075

@emdash-cms/blocks

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/blocks@2075

@emdash-cms/cloudflare

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/cloudflare@2075

@emdash-cms/contentful-to-portable-text

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/contentful-to-portable-text@2075

emdash

npm i https://pkg.pr.new/emdash-cms/emdash@2075

create-emdash

npm i https://pkg.pr.new/emdash-cms/emdash/create-emdash@2075

@emdash-cms/gutenberg-to-portable-text

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/gutenberg-to-portable-text@2075

@emdash-cms/plugin-cli

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/plugin-cli@2075

@emdash-cms/plugin-types

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/plugin-types@2075

@emdash-cms/registry-client

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/registry-client@2075

@emdash-cms/registry-lexicons

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/registry-lexicons@2075

@emdash-cms/registry-verification

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/registry-verification@2075

@emdash-cms/sandbox-workerd

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/sandbox-workerd@2075

@emdash-cms/x402

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/x402@2075

@emdash-cms/plugin-ai-moderation

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/plugin-ai-moderation@2075

@emdash-cms/plugin-atproto

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/plugin-atproto@2075

@emdash-cms/plugin-audit-log

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/plugin-audit-log@2075

@emdash-cms/plugin-color

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/plugin-color@2075

@emdash-cms/plugin-embeds

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/plugin-embeds@2075

@emdash-cms/plugin-field-kit

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/plugin-field-kit@2075

@emdash-cms/plugin-forms

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/plugin-forms@2075

@emdash-cms/plugin-webhook-notifier

npm i https://pkg.pr.new/emdash-cms/emdash/@emdash-cms/plugin-webhook-notifier@2075

commit: 1b8dad1

[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	1b8dad1	Jul 16 2026, 02:12 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	1b8dad1	Jul 16 2026, 02: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-demo-do	1b8dad1	Jul 16 2026, 02:14 PM

[emdashbot]

This is the right change for the stated goal: it lays down the internal, persistence-only query foundation for coverage-aware media usage reads, keeps all public surface (REST, client, OpenAPI, admin UI) out as promised, and follows the linked discussion. The migration is forward-only and idempotent, the composite index is justified by the query-plan tests, and the eligibility logic for draft-overlay vs. published columns is covered by focused repository tests.

I checked:

• Migration 052 index swap (create-new-then-drop-old) and its idempotency test.
• Runner registration and the expected-indexes list update.
• The new repository queries: batched active-entry counts, collection coverage status, and grouped entry pagination.
• Cursor/limit clamping, batch sizing, and locale handling (these methods query the projection tables, not ec_* content tables, and each translation row is its own content_id, so no missing locale filter bug).
• SQL safety: values are parameterized via Kysely; no interpolated identifiers.
• Tests: dialect-parity repository tests plus a SQLite/D1-plan test.

No blocking correctness or security issues. Two small opportunities to simplify/reduce work in the page query are noted.