[Maintainer] i18n: string-extraction codemod + CI literal guard

.github/workflows/ci.yml

@@ -57,7 +57,12 @@ jobs:
     permissions:
       contents: read
     steps:
+      # Depth 2 keeps the pull request merge commit's first parent (the base
+      # tip), which i18n:check compares reviewed translations and the literal
+      # baseline against.
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
 
       # Read from `packageManager` in package.json, so CI runs the same bun as
       # contributors and a bun release cannot change the gate on its own.
@@ -80,7 +85,20 @@ jobs:
       - name: Lint & format check
         run: bun run check
 
+      # A push compares with the commit before it (every commit of a
+      # multi-commit push); the shallow checkout lacks it, so fetch it.
+      - name: Fetch the pre-push commit for localization checks
+        if: github.event_name == 'push' && !startsWith(github.event.before, '0000000')
+        env:
+          BEFORE: ${{ github.event.before }}
+        run: git fetch --no-tags --depth=1 origin "$BEFORE"
+
+      # Includes the review-regression check against the PR base (or the
+      # pre-push commit) and the scan of the compiled packs for drafts; draft
+      # counts go to the job summary.
       - name: Check localization catalogs
+        env:
+          I18N_BASE_REF: ${{ github.event_name == 'push' && github.event.before || '' }}
         run: bun run i18n:check
 
       - name: Validate agent skills and plugin packages

.github/workflows/release.yml

@@ -102,6 +102,14 @@ jobs:
       - name: Install dependencies
         run: bun install --frozen-lockfile
 
+      # Drafts ship as English until reviewed. A release fails only when an
+      # entry reviewed at the latest @pascal-app/editor@* tag (the package
+      # that ships the catalogs; tagged below) became a draft with the same
+      # English, or when a compiled pack contains a draft. The full-history
+      # checkout above makes the tags available.
+      - name: Check translation review regressions and shipped packs
+        run: bun scripts/i18n.ts release-check
+
       - name: Configure git
         run: |
           git config user.name "github-actions[bot]"

.gitignore

@@ -58,3 +58,4 @@ og-test
 .claude/launch.json
 .claude/settings.local.json
 .vscode/launch.json
+.i18n-audit/

CONTRIBUTING.md

@@ -60,6 +60,22 @@ and reports inflated counts. `bun run test` goes through Turborepo, which
 builds workspace dependencies first (several packages import theirs from
 `dist/`) and runs each package's own scoped test script.
 
+### User-visible text
+
+Every string a person reads in the editor (labels, tooltips, `aria-label`,
+`title`, placeholders, menus, dialogs, errors) goes through the i18n catalog:
+
+```tsx
+const i18n = usePascalI18n()
+<button title={i18n._({ id: 'app.editorNavbar.share', message: 'Share' })} />
+```
+
+`bun run i18n:check` (part of `bun run ci`) fails when a file gains a
+hardcoded user-visible literal. Run `bun run i18n:extract` after changing copy.
+Scene data, MCP/agent text and developer errors stay English. See
+[`i18n/README.md`](i18n/README.md) for catalogs, translation review, the
+migration codemod and the pseudo-locale screenshot audit.
+
 ### Project structure
 
 | Package | What it does |

apps/editor/app/client-bootstrap.tsx

@@ -12,8 +12,10 @@ import '../lib/bootstrap'
 import { createI18n, defaultI18n, PascalI18nProvider } from '@pascal-app/core'
 import { registerBundledLocales } from '@pascal-app/editor/locales'
 import { type ReactNode, useEffect, useMemo } from 'react'
+import { registerDevLocales } from '@/lib/dev-locales'
 
 registerBundledLocales()
+registerDevLocales()
 
 export function ClientBootstrap({
   children,

apps/editor/app/layout.tsx

@@ -4,11 +4,13 @@ import { GeistPixelSquare } from 'geist/font/pixel'
 import { Barlow } from 'next/font/google'
 import localFont from 'next/font/local'
 import { headers } from 'next/headers'
+import { registerDevLocales } from '@/lib/dev-locales'
 import { PASCAL_LOCALE_HEADER, resolveUiLocale } from '@/lib/ui-locale'
 import { ClientBootstrap } from './client-bootstrap'
 import './globals.css'
 
 registerBundledLocales()
+registerDevLocales()
 
 const geistSans = localFont({
   src: './fonts/GeistVF.woff',