e2e 0.15.0 → 0.15.1

package/README.md

@@ -1,11 +1,16 @@
+<a href="https://tester.army/e2e?utm_source=e2e&utm_medium=github&utm_campaign=readme_banner"><img src="https://raw.githubusercontent.com/tester-army/e2e/main/.github/assets/readme-banner.png" alt="e2e by TesterArmy" width="100%" /></a>
+
+<p align="center">
+  <a href="https://tester.army?utm_source=e2e&utm_medium=github&utm_campaign=readme_badge"><img alt="Made by TesterArmy" src="https://raw.githubusercontent.com/tester-army/e2e/main/.github/assets/made-by-testerarmy.svg" /></a>
+  <a href="https://www.npmjs.com/package/e2e"><img alt="npm version" src="https://img.shields.io/npm/v/e2e.svg?style=for-the-badge&labelColor=000000" /></a>
+  <a href="https://github.com/tester-army/e2e/blob/main/LICENSE"><img alt="License: Apache-2.0" src="https://img.shields.io/badge/license-Apache--2.0-green.svg?style=for-the-badge&labelColor=000000" /></a>
+  <a href="https://tester.army/discord"><img alt="Join the community on Discord" src="https://img.shields.io/badge/Join%20the%20community-5865F2.svg?style=for-the-badge&logo=discord&logoColor=white&labelColor=000000" /></a>
+</p>
+
 # e2e
 
-Agentic end-to-end testing framework for any app: the SDK, runner, and CLI.
-Documentation: [e2e.tester.army/docs](https://e2e.tester.army/docs).
+[e2e](https://tester.army/e2e?utm_source=e2e&utm_medium=github&utm_campaign=readme_intro) is an end-to-end testing framework for web and mobile apps. Describe a goal in natural language and an agent interacts with the app to complete it. Use locators and assertions in the same test to check exact results. Customize anything from agent to the engine.
 
-```bash
-npx e2e init
-```
 
 ```ts
 // tests/checkout.e2e.ts
@@ -21,13 +26,37 @@ test('a member upgrades to Pro', async ({ app, agent, screen }) => {
 });
 ```
 
-A target names its engine: [`@e2e-dev/web`](https://www.npmjs.com/package/@e2e-dev/web)
-for the web, [`@e2e-dev/mobile`](https://www.npmjs.com/package/@e2e-dev/mobile)
-for iOS and Android. An agent step that a later assertion verifies records
-its actions, and the next run replays them with no model calls until the app
-changes. Tests without agent steps need no model.
+```bash
+npx e2e init
+```
+
+An agent step that a later assertion verifies records its actions, and the
+next run replays them with no model calls until the app changes. Tests
+without agent steps need no model. Bring your own subscription, API key, or
+local model.
+
+## Documentation
+
+[e2e.tester.army/docs](https://e2e.tester.army/docs): quickstart, writing
+tests, mobile, migrating from Playwright, Cypress, Selenium, Detox, or
+Maestro, and the full reference.
+
+## Packages
+
+- [`e2e`](https://www.npmjs.com/package/e2e): SDK, runner, and CLI.
+- [`@e2e-dev/web`](https://www.npmjs.com/package/@e2e-dev/web): the browser engine.
+- [`@e2e-dev/mobile`](https://www.npmjs.com/package/@e2e-dev/mobile): the iOS and Android engine.
+- [`@e2e-dev/github`](https://www.npmjs.com/package/@e2e-dev/github): the pull request comment reporter.
+- [`@e2e-dev/kernel`](https://www.npmjs.com/package/@e2e-dev/kernel): Kernel hosted browsers for the web
+  engine.
+- [`@e2e-dev/eas`](https://www.npmjs.com/package/@e2e-dev/eas): EAS Simulators hosted iOS simulators and
+  Android emulators for the mobile engine.
+
+## Contributing
 
-Not available yet: an HTML reporter.
+See [CONTRIBUTING.md](https://github.com/tester-army/e2e/blob/main/CONTRIBUTING.md) and [SECURITY.md](https://github.com/tester-army/e2e/blob/main/SECURITY.md).
+Apache-2.0.
 
-Source, issues, and [CONTRIBUTING.md](https://github.com/tester-army/e2e/blob/main/CONTRIBUTING.md):
-[github.com/tester-army/e2e](https://github.com/tester-army/e2e).
+Built by [TesterArmy](https://tester.army/?utm_source=e2e&utm_medium=github&utm_campaign=readme_footer),
+the agentic testing platform that runs plain-English tests on web and mobile
+apps and reports back with screenshots and recordings.

package/dist/.build.json

@@ -1 +1 @@
-{"version":"0.15.0"}
+{"version":"0.15.1"}

package/dist/cli/init/sibling-versions.json

@@ -1 +1 @@
-{"@e2e-dev/web":"0.11.0","@e2e-dev/mobile":"0.8.0","playwright":"1.63.0"}
+{"@e2e-dev/web":"0.11.1","@e2e-dev/mobile":"0.8.1","playwright":"1.63.0"}

package/dist/cli/signals.d.ts

@@ -9,8 +9,8 @@
  * one not yet reached, so the state is the signals themselves: the first
  * signal interrupts, the second forces, the third exits on the spot — the
  * last resort for a teardown that is itself stuck. That exit skips the
- * runner's teardown, so the app and service process groups it spawned are
- * killed first; otherwise they outlive the run in their own groups and the
+ * runner's teardown, so the app process groups it spawned are killed
+ * first; otherwise they outlive the run in their own groups and the
  * next run fails with `APP_ALREADY_RUNNING`.
  */
 export declare class SignalLadder {

package/dist/cli/signals.js

@@ -10,8 +10,8 @@ import { killManagedProcessGroups } from '../run/managed-process.js';
  * one not yet reached, so the state is the signals themselves: the first
  * signal interrupts, the second forces, the third exits on the spot — the
  * last resort for a teardown that is itself stuck. That exit skips the
- * runner's teardown, so the app and service process groups it spawned are
- * killed first; otherwise they outlive the run in their own groups and the
+ * runner's teardown, so the app process groups it spawned are killed
+ * first; otherwise they outlive the run in their own groups and the
  * next run fails with `APP_ALREADY_RUNNING`.
  */
 export class SignalLadder {

package/package.json

@@ -1,16 +1,22 @@
 {
   "name": "e2e",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "description": "SDK, runner, and CLI for agentic end-to-end testing",
   "keywords": [
     "e2e",
+    "end-to-end",
     "testing",
+    "test-runner",
+    "test-automation",
+    "ai",
+    "ai-testing",
+    "ai-agent",
+    "llm",
     "agentic",
-    "end-to-end",
-    "chatgpt",
-    "github-copilot",
-    "grok",
-    "subscription"
+    "natural-language",
+    "web-testing",
+    "mobile-testing",
+    "qa"
   ],
   "license": "Apache-2.0",
   "contributors": [
@@ -29,7 +35,6 @@
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public",
-    "provenance": false,
     "tag": "latest"
   },
   "type": "module",
@@ -103,7 +108,7 @@
     "@ai-sdk/openai": "4.0.71",
     "@ai-sdk/openai-compatible": "3.0.53",
     "@ai-sdk/xai": "5.0.4",
-    "@e2e-dev/web": "0.11.0",
+    "@e2e-dev/web": "0.11.1",
     "@openrouter/ai-sdk-provider": "3.1.0",
     "@types/node": "26.6.2",
     "@types/pngjs": "6.0.5",
@@ -118,7 +123,7 @@
     "node": ">=22.12.0"
   },
   "scripts": {
-    "build": "node -e \"const fs=require('node:fs');for(const dir of ['dist','skills'])fs.rmSync(dir,{recursive:true,force:true});fs.cpSync('../../skills/e2e','skills/e2e',{recursive:true})\" && tsc --project tsconfig.build.json && node -e \"const fs=require('node:fs');const read=(dir)=>JSON.parse(fs.readFileSync('../'+dir+'/package.json','utf8'));const versions=Object.fromEntries(['web','mobile'].map((dir)=>['@e2e-dev/'+dir,read(dir).version]));versions.playwright=read('web').devDependencies.playwright;fs.writeFileSync('dist/cli/init/sibling-versions.json',JSON.stringify(versions)+'\\n')\" && node ../../scripts/stamp-dist.ts",
+    "build": "node scripts/prepare-build.ts && tsc --project tsconfig.build.json && node scripts/write-sibling-versions.ts && node ../../scripts/stamp-dist.ts",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",

package/skills/e2e/SKILL.md

@@ -24,10 +24,11 @@ import { gateway } from 'ai';
 export default {
   targets: [
     {
-      engine: web({
+      engine: web(),
+      app: {
         url: 'http://127.0.0.1:3000',
         command: { executable: 'pnpm', args: ['dev'], log: '.e2e/logs/app.log' },
-      }),
+      },
     },
   ],
   // The model behind every agent.* step: an AI SDK instance; gateway() from 'ai' reads AI_GATEWAY_API_KEY or a Vercel OIDC token.

package/skills/e2e/references/running.md

@@ -143,7 +143,7 @@ deterministic, never retry it; only exit 3 is worth a job-level retry.
 
 The first SIGINT or SIGTERM interrupts and writes the report if any test
 had started; the second forces engine teardown; the third kills the app
-and service process groups and exits 130 at once.
+process groups and exits 130 at once.
 
 ## Continuous integration
 

package/skills/e2e/references/setup.md

@@ -77,10 +77,11 @@ export default {
   tests: 'tests/**/*.e2e.ts',
   targets: [
     {
-      engine: web({
+      engine: web(),
+      app: {
         url: 'http://127.0.0.1:3000',
         command: { executable: 'pnpm', args: ['dev'], log: '.e2e/logs/app.log' },
-      }),
+      },
     },
   ],
   // Model behind every agent.* step.