Adds French as a translation language beside ja and zh, with the style guide, glossary, navigation labels, and the minimum set: Get started and Platforms.
Co-authored-by: Kacper Kapuściak <kapusciak.k@gmail.com>
A docs PR was sized by its English lines plus every translation of them, so a 10-line edit mirrored into two languages got size:M. docs/<language>/** no longer counts.
The language list moves to scripts/docs-languages.ts, shared by the size label and both docs checks. An existing label's description is now updated to match what is counted.
* docs: add a Next.js guide page
One page takes a Next.js developer from `e2e init` to CI: `next dev`
locally and `next start` on the build in CI from one config, the port,
`reuseExisting`, and the Next.js problems (`allowedDevOrigins` on
127.0.0.1, the route announcer that `getByRole('alert')` also matches, a
webpack watcher that reads `.e2e/`), plus the `create-next-app` starter
and the Vercel template. The hydration accordion moves here from web.mdx;
web, cache, and example-projects link to the page, with ja and zh
translations, and the e2e skill's setup reference carries the same
guidance.
Refs ENG-1378
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs: move the Next.js page into a Frameworks group
Next.js is not a platform like web, mobile, or desktop, so the page moves
to docs/frameworks/nextjs.mdx under a new Frameworks navigation group. The
web page no longer points at it from the app URL paragraph.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
A coverage check in the pnpm check chain and its own step in spec.yml's check job: every web slug keeps its tests/<slug>.e2e.ts twin, and every mobile scenario its tests-agent entry outside the documented Control Inventory exclusion. Both catalogs parse in either quote style; a catalog that parses to no scenarios fails the check, a `slug:` or `name:` property the parser cannot read (a template literal, a bare identifier) fails it too, and a commented-out `name:` no longer counts as an entry, so a format change or a disabled entry cannot pass the check by hiding a scenario. The web agentic side stays unchecked on purpose: Refs #1777 leaves that part to the issue. file-round-trip gains the twin test the check was missing, opening the page in beforeEach, asserting the input resets after a rejected upload, and covering the voucher that then verifies.
Co-authored-by: Donny/강동윤 <kdy.1997.dev@gmail.com>
* docs: add Hindi as a translation language
Adds hi beside ja and zh in the translation and anchor checks, and keeps
docs/hi out of the npm package, Context7, and the skill wording test.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(hi): add the style guide, glossary, and navigation labels
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(hi): translate the getting-started and platform pages
Translates the minimum set from #1890: index, quickstart, core-concepts,
agentic-vs-deterministic, coding-agents, mcp-server, ci, web, and mobile.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(hi): fix wording and term consistency from review
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(hi): apply the back-translation and Apple terminology review
Fixes the meaning errors a blind back-translation found, such as "similar"
for "matching" and "equal to" for "up to" on the mobile page. Writes the
remaining English words in Devanagari, and follows Apple's Hindi spelling
for accessibility, account, and keyboard keys. Uses इजाज़त for permission
and एक्शन for action, and records both in the glossary.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(hi): fix agreement and ambiguous clauses from the Sol re-check
Splits sentences where a clause could attach to the wrong noun, such as
the location in the assertion inputs and the checked state of a hidden
checkbox. Restores the Cursor update line to the Cursor commands only.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(hi): use तालमेल बिठाना for the agent adapting on the landing page
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(hi): follow main's removal of the run_tests MCP tool
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(hi): unify reference, action, and state, and rewrap long lines
Uses रेफ़रेंस for "reference" everywhere, as most links already did, and
records स्थिति (app state in prose) beside स्टेट (stored or device state).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Kacper Kapuściak <kapusciak.k@gmail.com>
* docs(pt-BR): translate the minimum set
Add the Brazilian Portuguese locale with the Get started and Platforms
pages (index, quickstart, core-concepts, agentic-vs-deterministic,
coding-agents, mcp-server, ci, web, mobile), navigation labels, and a
README with the style guide and glossary.
Register `pt-BR` in the translation and anchor checks, the build and
skill-test exclusions, and context7.json, next to ja, zh, cs, and es.
List it in AGENTS.md and the authoring-docs skill, whose checklist now
says "every docs/<language>/ folder" so the next language needs no edit
there.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(pt-BR): state the timing order and what docs:check covers
The ci page now says untimed files run first, then the rest longest
first. The README says docs:check compares page outline and code, and
only checks that each tab and group has a label.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Claude Code loads .mcp.json from a plugin's root even when the manifest names none, so the file goes and Codex and Cursor read the server from mcp.json, the Agent Plugins file Copilot already uses. plugins:check fails if .mcp.json comes back.
* docs(es): translate the getting-started and platform pages
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
* docs(es): follow the worker fixture change in mobile and accept feminine bloqueada
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
* docs(es): fix agreement and meaning slips, restore main's translation policy
The earlier patch to scripts/check-docs-translations.ts and the
authoring-docs skill was made against an older main and reverted the
best-effort policy; both now carry only the es registration.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
* docs(es): follow the best-effort translation policy in the README
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
* docs(es): say what docs:check detects
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
* docs: list the Spanish translation in AGENTS.md
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-authored-by: Kacper Kapuściak <kapusciak.k@gmail.com>
* docs(cz): translate the minimum set
Add the Czech locale with the Get started and Platforms pages,
navigation labels, and a README with the style guide and glossary.
Register `cz` in the translation checks and exclusions like `zh`.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(cz): fix three translations flagged in review
- web: the run fails with APP_ALREADY_RUNNING, not the server
- coding-agents: `init` registers the server, not the other way round
- quickstart: rephrase the config options intro
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(cz): address review: no en dash, current README rules, mobile install
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(cs): use the language code cs instead of the country code cz
Czech is `cs` in ISO 639-1 and BCP 47, which browsers send and `lang` and
`hreflang` expect. The code is also the URL, so rename before launch.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
English stays current in every change; the Japanese and Chinese
translations may lag behind, since no contributor can be expected to
update a language they don't speak. check-docs-translations.ts now warns
on outline, code, and navigation label drift instead of failing, and
fails only on what needs no language to fix.
Refs ENG-1385
* docs: add Simplified Chinese as a translation language
Adds zh beside ja in the translation and anchor checks, and keeps docs/zh
out of the npm package, Context7, and the skill wording test.
* docs(zh): add the style guide, glossary, navigation labels, quickstart and overview
* docs(zh): translate all documentation pages
* docs(zh): keep error categories in English, align setup test, blocked, and schema terms
* ci(docs): check the japanese docs against deepl
Each changed section of a docs/ja page is translated back into English and compared with the English page's section, and compared with DeepL's own Japanese for the English, both with chrF. A section far from DeepL in both directions, left in English, or missing a glossary term DeepL used gets a warning on its heading and a row in the job summary. Sections pair by position, which check-docs-translations.ts guarantees. The glossary in docs/ja/README.md is uploaded as a DeepL glossary.
* ci(docs): review every section when the deepl check itself changes
* ci(docs): check only changed sections, report deepl usage and every score
* ci(docs): flag below 0.25 and skip the review when deepl's quota is used up
* ci(docs): fall back to gpt-6-luna on the ai gateway when deepl's quota runs out
* ci(docs): keep the fallback model private to deepl-review
* ci(docs): ask the model again after an answer that is not json
* docs(scripts): say the reference, not deepl, now that a model can translate
* docs: add the Japanese translation
Adds docs/ja/, a Japanese page for every English docs page at the same
path, with the tab and group labels in docs/ja/navigation.json. The site
serves them at /docs/ja and gives each translated anchor its English id by
position, so check-docs-translations.ts keeps every translation's outline
equal to its English page's. The npm package keeps shipping only the
English pages.
* docs: check translated code blocks, keep docs/ja out of Context7 and the skill wording test
* docs(ja): sync with the English pages' latest changes (test.skipIf, tool schemas, star link)
* docs(ja): start with the quickstart page only
* docs(ja): translate getting-started and platform guides
* docs(ja): translate all documentation pages
Manage local Moli CDP browsers through the web engine's BrowserProvider API.
Each worker gets an available loopback port, layout and resource loading,
startup cancellation, and process cleanup when its lease ends.
Wire the testbed, documentation, consumer skill, build and test commands,
and a patch changeset for @e2e-dev/moli.
Keep process-group shutdown active after an executable wrapper exits,
and surface process-inspection failures in the provider tests.
Verified locally:
- pnpm check
- 16 Moli provider unit tests
- Testbed on two workers: 16 passed, 1 expected skip; both browsers released
- Empty and whitespace CDP URLs use managed browsers; padded URLs attach
without stopping the existing server
- MCP login, secret fill, assertions, and screenshot
- Packed packages installed, typechecked, and run in an isolated project
Adds a generated plugin.json and mcp.json at the plugin root, strips
metadata.openclaw from the plugin's skill copies, and drops the
out-of-directory link in create-verification-skill, so the plugin passes
awesome-copilot's external plugin intake.
* docs(ci): rename the Vercel page to Vercel previews
* docs(ci): move the Vercel previews page to /ci/vercel-previews
* docs(ci): capitalize Vercel Previews
* docs(ci): drop the redirect, the page is not shipped
`@e2e-dev/web` and `@e2e-dev/mobile` declare `e2e` an optional peer, but
their main entry imported it statically to build `test`. A program on
`@e2e-dev/core` alone that wrote `import { web } from '@e2e-dev/web'`
failed with ERR_MODULE_NOT_FOUND before any of its code ran.
The main entry now requires `e2e` only when it resolves. Without it, the
engine factory works and `test`, `describe`, and the hooks throw
RUNNER_NOT_INSTALLED when called. It uses createRequire, not a top-level
await, so a CommonJS file can still require() the entry.
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* refactor: move e2e's core into @e2e-dev/core, and engines peer on it
The engine contract, locators, agent, replay cache, secrets, and the
session half of a worker move from packages/e2e to packages/core, the new
@e2e-dev/core package, at the same paths. e2e depends on it at its exact
version (a changesets fixed group) and reaches its modules through
@e2e-dev/core/lib/*, which is not public API; e2e/engine and e2e/agent
re-export it. @e2e-dev/web and @e2e-dev/mobile peer on @e2e-dev/core and
import the contract from @e2e-dev/core/engine. Install smoke checks that one
copy of @e2e-dev/core is installed.
Most of this diff is git mv and import specifiers rewritten to
@e2e-dev/core/lib/<path>; no behavior changes.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* ci: build and pack @e2e-dev/core where e2e is built or packed alone
The Bun job built e2e before the @e2e-dev/core it compiles against, and the
examples nightly installs e2e from a tarball whose exact @e2e-dev/core is
not on npm; it now packs @e2e-dev/core and overrides it in each example.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(engines): name @e2e-dev/core/engine as the contract's source
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* fix(e2e): list @e2e-dev/core beside an engine in init and upgrade
Engines peer on @e2e-dev/core. Yarn installs no peer the project does
not list, and under Plug'n'Play the engine then fails to load.
- init adds @e2e-dev/core with any engine
- upgrade adds a required @e2e-dev peer the project lacks, and keeps a
package e2e depends on at the version e2e names
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Oskar Kwaśniewski <oskar@okwasniewski.com>
* feat(mobile): export agent-device from @e2e-dev/mobile/agent-device
Custom tools that extend the mobile engine with agent-device calls have
to import `agent-device` directly. pnpm does not resolve that import
from a transitive dependency, so the project installs agent-device
itself and has to keep it at the exact version @e2e-dev/mobile pins,
because two versions do not share one daemon.
The new subpath re-exports what a tool commonly needs from the engine's
copy: `createAgentDeviceClient`, the error helpers (`AppError`,
`isAgentDeviceError`, `normalizeAgentDeviceError`), `centerOfRect`, and
the types for the client, snapshots, screenshots, targets, gestures,
text entry, alerts, and waits. `ensureDaemon` and `startAgentDevice`
stay out because the engine owns the daemon.
The install smoke imports the subpath from a fresh pnpm project with no
agent-device dependency and checks there is one agent-device install.
The e2e skill tells agents to use this import instead of adding
agent-device.
* docs(mobile): mark @e2e-dev/mobile/agent-device unstable, point tests to unstable_raw
A client built with `createAgentDeviceClient` does not get the engine's
daemon, lease, or per-worker session name, so the docs no longer say it
drives the engine's session. Tests use `device.unstable_raw.client`.
The subpath is agent-device's API at the pinned version, so it is
labeled unstable like `unstable_raw`.
* chore(mobile): shorten the agent-device subpath comments
* feat(mobile): give custom tools the running device session
A custom tool had no way to reach the engine's agent-device client, and
a client built from `createAgentDeviceClient` misses the engine's
daemon, lease, and per-worker session. `deviceSession(...engines)` on
`@e2e-dev/mobile/tools` returns the running attempt's `DeviceSession`,
the object a test reads from `device.unstable_raw`, using the lookup
`mobileTools` already had.
From review: `@e2e-dev/mobile/agent-device` drops the client factory and
keeps the types and error helpers. The skill line is scoped to these
imports, and the stale Limrun peer line is fixed. The export-map test
checks every entry's paths, the install smoke stops reading the `.pnpm`
layout, and the docs keep one full description in the reference.
* fix(mobile): spread the device selection in the deviceSession example
The docs example called `settings.update` without the session's
`selection`, unlike every engine call, so it could miss the worker's
device before an app is open. Also restores `createDeviceFixture`'s
JSDoc and tests the several-attempts refusal of `deviceSession`.
* refactor(mobile): keep raw sessions behind a neutral unstable API
* fix(mobile): type the unstable raw session client
---------
Co-authored-by: Oskar Kwaśniewski <oskar@okwasniewski.com>
* docs(examples): add the GitLab CI/CD example
Let the registry list examples on gitlab.com: the schema accepts GitLab
projects and folders, official examples may live in the e2e_inc group, and
the checks pin, compare, and fetch GitLab URLs. A partner example stays on
GitHub, under its author.github.
* docs(examples): say partner examples live on GitHub in the contributing guide
* docs: retire sidebar page icons
The docs sidebar no longer shows icons. Drop icon: from every page's frontmatter, delete the grey silhouettes in docs/images/icons/, and make check-docs-logos fail on any frontmatter icon instead of requiring one on vendor pages. Card logos stay required. The authoring-docs skill trades its Page icons section for a short Vendor logos one.
* docs: require a migrate overview card for each migration guide
* docs: match only top-level icon keys in check-docs-logos
* docs(migrate): show the TesterArmy logo in the sidebar and add its card
The sidebar icon was the dithered black mark, which the site's grey
silhouette filter smeared into a blob at 16 px. Use TesterArmy's favicon
instead: grey shades in the sidebar, brand colors on the new card in the
migrate overview.
* docs(skills): exempt the TesterArmy icon in the authoring-docs checklist
* feat(examples): add 26 community examples, pinned to a commit, with an optional readme
* docs(examples): allow an example without a README in what we look for