craftdriver 0.0.3 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,104 @@
+# [0.2.0](https://github.com/dtopuzov/craftdriver/compare/v0.1.0...v0.2.0) (2026-05-29)
+
+
+### Features
+
+* accessibility audits ([0b59957](https://github.com/dtopuzov/craftdriver/commit/0b59957ecb014d32962298de8da939cb873c6380))
+* add driver manager ([3f60949](https://github.com/dtopuzov/craftdriver/commit/3f6094918fdaf0e04a8df61d732ea878c215875f))
+* AI productivity tooling ([ffac9f0](https://github.com/dtopuzov/craftdriver/commit/ffac9f02d45bc14126e016bd2b7cfac3cf2fb057))
+* browser-context ([6ddbc8a](https://github.com/dtopuzov/craftdriver/commit/6ddbc8acf619418987dc2be1613271bcd5ada488))
+* browser.emulate ([aefabba](https://github.com/dtopuzov/craftdriver/commit/aefabba9132275d77ad673539c71242affbb47fb))
+* ship the May browser automation feature set ([b89f3a6](https://github.com/dtopuzov/craftdriver/commit/b89f3a65b704178b7d984d65af9c12bddbc2d524))
+* **tracing:** mimeType + fromCache on response events; final.png on failure ([4b1b293](https://github.com/dtopuzov/craftdriver/commit/4b1b293cd46d9641fa1106c7ae9736a47e418e62))
+* **tracing:** streaming NDJSON tracer with on-failure vitest helper ([3c95a4b](https://github.com/dtopuzov/craftdriver/commit/3c95a4b2880ff379668b449a47e422ce74e2cfb3))
+* virtual clock ([1d6b0ec](https://github.com/dtopuzov/craftdriver/commit/1d6b0eca4d8f0eed03dc597a3bf443836a206208))
+
+# [0.1.0](https://github.com/dtopuzov/craftdriver/compare/v0.0.3...v0.1.0) (2026-02-08)
+
+## Unreleased
+
+- fix(security): clamp user-supplied `timeout` and `idleDuration` values passed to `setTimeout` in `waitForNetworkIdle` (network.ts) and `waitForLoadState` (browser.ts) to prevent resource exhaustion from unbounded timer durations (CodeQL high-severity alerts). The `ms()` helper in `dispatcher.ts` (the socket→number boundary for the CLI daemon) now also caps at 300,000 ms so the sanitization happens at the untrusted-input boundary rather than deep in the call chain. Caps: 300,000 ms for timeouts, 60,000 ms for idle durations.
+- fix(tests): `driver-manager.test.ts` integration test was silently short-circuiting on systems where `chromedriver` is already on `PATH` (ubuntu-latest CI runners, nvm-managed Node envs). The resolution chain hit the PATH probe at step 5 before ever reaching the auto-download step, so nothing was written to the cache directory and the cache assertions failed. Fix: `beforeAll` now filters chromedriver-containing directories out of `PATH` to force the download path; `PATH` is restored in `afterAll`.
+
+- fix(browser-context): `page.context()` now returns `browser.defaultContext` for pages opened via `browser.openPage()` / `browser.waitForPage()` / `browser.pages()` / `browser.activePage()` instead of `undefined`. Previously these pages lived in the default user context at the BiDi layer but had no owner wired up, which meant `page.navigateTo('/foo')` silently ignored the default context's `baseURL`, and the model leaked. New regression test in [tests/browser-context-hooks.test.ts](tests/browser-context-hooks.test.ts).
+- fix(browser-context): `browser.contexts()`, `browser.defaultContext`, and `browser.newContext()` now share a single cached `BrowserContext` instance per BiDi user-context id, evicted on context close. Previously `browser.contexts()` minted a fresh wrapper every call, silently losing every `on()` listener, `addInitScript`, and `route()` registration attached to a sibling instance. [src/lib/browser.ts](src/lib/browser.ts).
+- chore(browser-context): internal cleanup pass — dropped dead state (`_routeIds`, `_tracking`), parallelized per-page intercept registration in `ctx.route()`, fixed stale jsdoc on `ctx.route()` and `ctx.on()`, and trimmed `docs/browser-context.md` to remove the obsolete "no `storageState` round-trip" callout and a duplicated multi-user-login example. Added a "Scope and precedence (gotchas)" section documenting the `storageState` coverage (cookies + localStorage only — not sessionStorage / IndexedDB), Browser-vs-Context emulation precedence, the service-worker scope of `ctx.route()`, and the non-transactional shape of `grantPermissions`. [docs/browser-context.md](docs/browser-context.md).
+
+- feat: `BrowserContext` identity & device emulation (Milestone C of the browser-context plan) — tight, capability-gated slice. New `browser.newContext({ locale, timezoneId, geolocation })` options plus live setters `ctx.setLocale(locale | null)`, `ctx.setTimezone(timezoneId | null)`, `ctx.setGeolocation(coords | null)`, `ctx.grantPermissions(names, { origin, state? })`, and `ctx.clearPermissions(names, { origin })`. All five are scoped via BiDi `userContexts: [<id>]` / `userContext` so future pages (and popups) inherit automatically with no per-page plumbing. `locale`, `timezoneId`, and `grantPermissions` work on Chrome **and** Firefox; `setGeolocation` is reliable on Chrome and wraps the BiDi error with the engine name on Firefox where coverage is still uneven. A default `browser.newContext()` (no options) remains cross-browser. Out-of-scope by design: per-context `viewport` / `colorScheme` / `reducedMotion` / `userAgent` — those still need either CDP (Chromium-only) or BiDi primitives that aren't broadly shipped. See [docs/browser-context.md](docs/browser-context.md), tests in [tests/browser-context-emulation.test.ts](tests/browser-context-emulation.test.ts).
+
+- feat: `BrowserContext` page-scoped hooks & routing (Milestone B of the browser-context plan) — `ctx.on('page' | 'close', listener)` / `ctx.off(...)` for tab-and-popup observation across every page in a context, `ctx.addInitScript(script)` returning an `InitScriptHandle` with `.id` + `.remove()` (and matching `ctx.removeInitScript(id)`) for per-context preload scripts that don't leak to sibling contexts, `ctx.route(pattern, handler)` / `ctx.unroute(id?)` for context-scoped request mocking (URL substring, `RegExp`, or `**`-aware glob; the handler receives `{ request, fulfill, continue, abort }`), `ctx.setExtraHTTPHeaders(headers)` to swap the per-context header bag at runtime, plus `browser.newContext({ baseURL, extraHTTPHeaders })` options so `ctx.newPage({ url: '/login' })` resolves against the context's base URL and every outbound request carries the configured headers. Adds `page.context()` so a `Page` can reach back to its owning `BrowserContext`. Routes are registered per BiDi browsing context (and re-registered on every new page), which is what makes Firefox honour them under a non-default `userContext`. Works on Chrome **and** Firefox via BiDi. New exported types `BrowserContextConfig`, `BrowserContextHooks`, `InitScriptHandle`, `RoutePattern`. See [docs/browser-context.md](docs/browser-context.md), tests in [tests/browser-context-hooks.test.ts](tests/browser-context-hooks.test.ts).
+
+- feat: `BrowserContext` cookies + storage state (Milestone A of the browser-context plan) — `ctx.cookies(urls?)`, `ctx.addCookies(cookies)`, `ctx.clearCookies(filter?)`, `ctx.storageState(opts?)`, `ctx.saveStorageState(path, opts?)`, `ctx.loadStorageState(source)`, and `browser.newContext({ storageState })`. All operations are scoped to the user context via the BiDi `storageKey` partition; localStorage is restored on first navigation through an internal preload script bound to the user context. Enables the auth-fixture pattern (log in once, save to JSON, reuse across tests) and proper multi-user isolation. Works on Chrome **and** Firefox. New exported types `ClearCookiesFilter`, `ContextStorageStateOptions`. See [docs/browser-context.md](docs/browser-context.md), tests in [tests/browser-context-storage.test.ts](tests/browser-context-storage.test.ts).
+
+- chore(tests): drop the `bidi-` filename prefix on the four BiDi-specific test files (`bidi-network` → `network`, `bidi-logs` → `logs`, `bidi-load-state` → `load-state`, `bidi-storage` → `storage`). The prefix dates back to when those were the only BiDi tests; today most tests are BiDi-only (BiDi is default-on) and the inconsistent prefix actively misled readers. BiDi-ness is now treated as an implementation detail of the feature, not a test category. Renamed via `git mv` so blame survives. Updated [.github/instructions/tests.instructions.md](.github/instructions/tests.instructions.md) accordingly. Also renamed the non-test helper `tests/auto-trace.ts` → `tests/_auto-trace.ts` so it sorts to the top of the directory and reads as "not a test" at a glance.
+- test: smoke tests for the MCP server in [tests/mcp-smoke.test.ts](tests/mcp-smoke.test.ts) — spawn `node bin/craftdriver.mjs mcp` as a child process, speak JSON-RPC 2.0 over its stdio (no LLM required — MCP is a deterministic protocol), and assert on the protocol surface. Three cases: `tools/list` returns the 14 documented tools by name, `browser_navigate` + `browser_snapshot` against [examples/login.html](examples/login.html) yields refs for the known form controls, and `browser_click` on a missing selector returns `isError: true` with a stable `structuredContent.error.code`.
+- test: smoke tests for the CLI binary in [tests/cli-smoke.test.ts](tests/cli-smoke.test.ts) — spawn `node bin/craftdriver.mjs --ephemeral` as a child process, pipe a script of commands via stdin, and assert on the JSON-per-line output. Three cases: a full login flow against [examples/login.html](examples/login.html), a `snapshot` call that verifies refs + roles for known controls, and an error-code path that confirms `exists`/`text` against a missing selector returns `ok:false` with `code: NO_MATCH` plus a non-zero exit. Requires `npm run build` first (the bin shim loads `dist/cli/index.js`).
+- docs: align README / docs / skill on the three AI-agent surfaces (CLI, skill pack, MCP) and `craftdriver init` rules files. Fixed stale "13 tools" copy in [README.md](README.md), [docs/mcp.md](docs/mcp.md), and [skills/craftdriver/SKILL.md](skills/craftdriver/SKILL.md) — MCP exposes 14 tools. Added a Skill pack subsection to [README.md](README.md) and [docs/cli.md](docs/cli.md) so the tarball-shipped `skills/craftdriver/` files are discoverable from the front door.
+
+- feat: sanitized DOM snapshot with refs — `craftdriver snapshot` (CLI) and `browser_snapshot` (MCP tool) return a flat accessibility-tree summary of the active page where each visible interactive element gets a stable ref (`e1`, `e2`, …). Use `ref=eN` as a selector for the next command and refs auto-resolve to the right DOM node (`[data-craftdriver-ref="eN"]`) with full auto-wait — no selector hallucination, no per-element `find` round-trips, and 5-char selectors instead of 26-char `role=button[name=…]` expressions. Refs invalidate on the next snapshot or navigation; stale refs fail with `NO_MATCH`. The same renderer powers the post-action snapshot diff in MCP, so refs in the diff are usable in the very next call. Inspired by [Playwright CLI](https://playwright.dev/agent-cli/introduction). [src/cli/snapshot.ts](src/cli/snapshot.ts), [src/cli/selector.ts](src/cli/selector.ts).
+
+- feat: MCP server — `craftdriver mcp` runs a stdio JSON-RPC 2.0 server speaking [Model Context Protocol](https://modelcontextprotocol.io) `2024-11-05`, so MCP-aware hosts (Claude Desktop / Code, Cursor, Windsurf, Zed, Goose, Gemini CLI) can drive a real browser without spawning a CLI per turn. 14 schema-typed tools (`browser_navigate`, `browser_click`, `browser_fill`, `browser_press`, `browser_hover`, `browser_find`, `browser_exists`, `browser_wait`, `browser_read`, `browser_pages`, `browser_snapshot`, `browser_screenshot`, `browser_status`, `browser_advanced_eval`) share the dispatcher and selector syntax with the CLI; mutating tools additionally return a **compact a11y snapshot diffed from the previous turn** (≤ 80 nodes, ref + role + accessible name + locator hint, full snapshot on first call / URL change, set-difference thereafter) so the agent sees what the action changed without a follow-up read. Errors come back as MCP `isError: true` content with the stable `code` field in `structuredContent.error.code`; JSON-RPC `error` is reserved for protocol-level failures. **Token-efficient artifact spilling** ([src/cli/mcp/artifacts.ts](src/cli/mcp/artifacts.ts)) writes screenshots, large snapshots, and large tool results to a per-session directory (`<tmpdir>/craftdriver-mcp-<pid>-<stamp>/`) instead of inlining them as content blocks — the agent gets a short preview plus the absolute path, paying no image tokens for screenshots and bounded text tokens for everything else. Configurable via `$CRAFTDRIVER_MCP_ARTIFACTS_DIR` and `$CRAFTDRIVER_MCP_SPILL_BYTES` (default 2 KB). Hand-rolled (no `@modelcontextprotocol/sdk` dep) — [src/cli/mcp/server.ts](src/cli/mcp/server.ts), [src/cli/mcp/tools.ts](src/cli/mcp/tools.ts), [src/cli/snapshot.ts](src/cli/snapshot.ts). See [docs/mcp.md](docs/mcp.md).
+
+- feat: `craftdriver init <flavor>` — writes a short, opinionated agent-guide file into the current project so AI assistants pick up craftdriver conventions (selector preference, auto-waiting, error codes, CLI usage) on every turn. Flavors: `agents` (`AGENTS.md`), `copilot` (`.github/copilot-instructions.md`), `claude` (`CLAUDE.md`), `cursor` (`.cursor/rules/craftdriver.mdc` with frontmatter), `gemini` (`GEMINI.md`), `all`. One shared body, N filenames — [src/cli/init.ts](src/cli/init.ts). `--force` overwrites, `--dry-run` previews. Per-project by design; never writes to a user's home directory.
+- docs: CLI section in [README.md](README.md) plus dedicated [docs/cli.md](docs/cli.md) reference and an agent-facing [skills/craftdriver/cli.md](skills/craftdriver/cli.md). `docs/` and `skills/` are now shipped in the npm tarball alongside `dist/` and `bin/` so installs of `craftdriver` carry their own docs and SKILL pack for in-repo agents. Added `cli`, `agent`, `ai` keywords and wired `--version` to print the package version.
+- feat: agent-first CLI v1 — new `craftdriver` binary (re-exported via `bin/craftdriver.mjs`, wired through `package.json#bin`) wraps the public Browser API for shell agents and humans. Daemon mode keeps a long-lived browser behind a Unix-domain socket at `~/.craftdriver/sock` (override with `$CRAFTDRIVER_SOCKET`) so successive commands share state; `--ephemeral` reads a command-per-line script from stdin in a single short-lived session for sandboxed cloud agents. Default per-call timeout is 5 s on the agent surface (vs. 30 s in the library); override with `--timeout` or `$CRAFTDRIVER_AGENT_TIMEOUT`. Selectors follow `kind=value` syntax (`css=`, `xpath=`, `role=button[name=Submit]`, `text=Sign In`, `label=`, `placeholder=`, `testid=`, …); CSS is the default when no prefix is given. Output is JSON when stdout is piped, pretty when on a TTY (force with `--json` / `--pretty`). Commands: `go`, `find` (with `--all/--limit/--offset` and stable `next_offset`), `click`, `fill`, `press`, `hover`, `text`, `attr`, `value`, `is`, `wait`, `exists` (0-wait probe, exit 1 when missing), `pages`, `screenshot`, `eval`, `back`/`forward`/`reload`/`status`/`quit`, `daemon start|status|stop`. Every error carries the existing stable `code` field plus a one-line `hint:`. Run `npm run build` then `craftdriver --help`.
+- feat: stable, machine-readable error codes — every error thrown from the public API is now a `CraftdriverError` (re-exported from [src/index.ts](src/index.ts)) carrying a stable `code`, JSON-serializable `detail`, and an optional `hint`. Codes distinguish the three common probe failures (`NO_MATCH` vs `TIMEOUT_WAITING_VISIBLE` vs `TIMEOUT_WAITING_STATE`) plus `TIMEOUT_WAITING_LOAD`, `EXPECT_MISMATCH`, `EVAL_THREW`, `EVAL_BAD_ARG`, `INVALID_ARGUMENT`, `UNSUPPORTED`, `STATE_INVALID`, `A11Y_VIOLATIONS`, and more. `instanceof Error` still holds; existing message-based catches keep working. `A11yError` now extends `CraftdriverError`. See [docs/error-codes.md](docs/error-codes.md).
+- feat: generated [docs/api-reference.md](docs/api-reference.md) — one canonical table of every public symbol re-exported from [src/index.ts](src/index.ts), produced by `scripts/gen-api-reference.mjs`. Run `npm run docs:api` to regenerate; `npm run docs:api:check` and the vitest guard `tests/api-reference.test.ts` fail when the file is out of sync.
+- feat: tiered agent-facing SKILL content under `skills/craftdriver/` — `SKILL.md` (always-on, ≤ 500 tokens, decision rules + pointers), `cheatsheet.md` (command-by-command reference for writing tests), `patterns.md` (worked recipes for login / upload / network-wait / a11y / tracing / clock).
+- chore: `Locator` simple-path shortcut removed in favour of a single polling code path. No public behaviour change beyond improved error-code accuracy.
+
+- feat: tracing — `browser.startTrace({ outDir, … })` streams a chronological log of `action` / `console` / `error` / `request` / `response` / `navigation` / `screenshot` events to `outDir/trace.ndjson`, one JSON value per line, written synchronously per event so a thrown `expect` cannot lose data. Response events include `mimeType` and `fromCache` when available. Screenshots land in `outDir/screenshots/NNNN.png` as captures resolve. `browser.stopTrace()` drains pending captures and writes a closing `meta` line — but is purely cosmetic: partial files left behind by a throwing test (or `browser.quit()`) are still valid NDJSON. Pillars toggled independently (`actions`, `network`, `console`, `screenshots`); screenshots are evidence-driven (one before each action, one on each page error) with `screenshots: 'auto'` default. Actions instrumented: `navigateTo` / `goBack` / `goForward` / `reload` / `setContent` / `click` / `fill` / `clear` / `acceptDialog` / `dismissDialog`. BiDi-only. See [docs/tracing.md](docs/tracing.md).
+- feat: `browser.emulate({...})` — override `prefers-color-scheme`, `prefers-reduced-motion`, `forced-colors`, `locale`, `timezoneId`, and `offline` for the current session. `locale` and `timezoneId` use BiDi `emulation.setLocaleOverride` / `setTimezoneOverride` and work cross-browser; media features and `offline` use the BiDi+CDP bridge and are Chromium-only with a clear error on Firefox. See [docs/emulation.md](docs/emulation.md).
+
+- feat: virtual clock — `browser.clock.install()`, `tick()`, `fastForward()`, `setFixedTime()`, `setSystemTime()`, `runFor()`, `uninstall()`. Fakes `Date`, `performance.now`, `setTimeout`, `setInterval`, and `requestAnimationFrame` via an injected shim. Persists across navigations via BiDi preload script. See [docs/clock.md](docs/clock.md).
+
+- feat: accessibility audits — `browser.a11y.audit()` / `check()` plus element-scoped `element.a11y.*` and `locator.a11y.*` wrap axe-core (shipped as a direct dependency — works out of the box). Ergonomic `disableRules: string[]` shorthand, `rules` whitelist, `minImpact` filter, and `axeOptions` escape hatch. `check()` throws an `A11yError` listing every violation with its help URL. See [docs/accessibility.md](docs/accessibility.md).
+- feat: full-page screenshots — `browser.screenshot({ fullPage: true })` captures the entire scrollable document via BiDi `browsingContext.captureScreenshot` with `origin: 'document'`. Viewport remains the default. `fullPage` and `selector` are mutually exclusive. See [docs/screenshots.md](docs/screenshots.md).
+- feat: history navigation — `browser.goBack()` / `goForward()` / `reload()`, mirrored on `Page`. BiDi `browsingContext.traverseHistory` / `reload` with Classic `/back`, `/forward`, `/refresh` fallback.
+- feat: `page.content()` and `browser.content()` return the full document HTML; `page.setContent(html, { waitUntil })` and `browser.setContent(...)` replace the document via a `data:text/html` navigation.
+- feat: `browser.setViewportSize({ width, height })` resizes the layout viewport (BiDi `browsingContext.setViewport`) with a Classic `setWindowRect` fallback.
+- feat: `browser.grantPermissions([...], { origin?, state? })` and `browser.clearPermissions(...)` over BiDi `permissions.setPermission`. BiDi-only.
+- feat: `browser.setGeolocation({ latitude, longitude, accuracy? } | null)` over BiDi `emulation.setGeolocationOverride`. BiDi-only.
+- feat: `browser.on('request' | 'response', cb)` — persistent network listeners returning an `off()` function. Sits next to the existing one-shot `waitForRequest` / `waitForResponse`.
+- **breaking** (pre-1.0): `element.tag()` renamed to `element.tagName()` for symmetry with `By.tagName()` and the DOM `Element.tagName` property.
+- **breaking** (pre-1.0): screenshot APIs converged on a single options-bag form. `browser.screenshot(opts?: { path?, selector?, timeout? })`, `element.screenshot(opts?: { path?, timeout? })`. `browser.saveScreenshot(...)` removed.
+- **breaking** (pre-1.0): `KeyboardController` / `MouseController` renamed to `Keyboard` / `Mouse` for Playwright parity. Re-exported from `src/index.ts`.
+- feat: `By.text(text, { exact: false })` is now sugar for `By.partialText(text)`. `getByText` and `By.text` share one vocabulary.
+- docs: dedicated [docs/dialogs.md](docs/dialogs.md); browser-api dialogs section trimmed to a callout. Attached-vs-visible gloss added to the waiting section. `By.role({ includeHidden })` documented in [docs/selectors.md](docs/selectors.md). `browser.actions()` gets a runnable shift-drag example in [docs/browser-api.md](docs/browser-api.md).
+- docs: BiDi-feature matrix added at the top of [docs/bidi-features.md](docs/bidi-features.md), timeout-defaults table added in [docs/browser-api.md](docs/browser-api.md), mobile-emulation Chrome-only callout promoted to the top of [docs/mobile-emulation.md](docs/mobile-emulation.md), cleanup / failure-recovery guidance added to [docs/browser-api.md](docs/browser-api.md).
+- feat: re-export `Keyboard` and `Mouse` (was `KeyboardController` / `MouseController`) from [src/index.ts](src/index.ts).
+- **breaking** (pre-1.0): remove deprecated aliases `Browser.waitForNewContext()` and `LogMonitor.getConsoleLogs()`. One API per concept; no aliases pre-1.0.
+- **breaking** (pre-1.0): rename `By.nameAttr` → `By.name` and `By.tag` → `By.tagName` for parity with Selenium's canonical `By` API.
+- **breaking** (pre-1.0): drop `BiDiSession` / `BiDiConnection` from the public surface.
+- docs: close coverage gaps — `By.attr` / `dataAttr` / `aria` / `partialText` / `altText` / `title` / `testId` documented in [docs/selectors.md](docs/selectors.md); `getValue` / `getAttribute` get full signature blocks; `actions()` and `isBiDiEnabled()` documented; custom-binary / port configuration via `ChromeService` / `FirefoxService` documented in [docs/getting-started.md](docs/getting-started.md).
+- docs: Browser properties table now lists the correct exported types `NetworkInterceptor` / `LogMonitor`.
+- feat: Firefox support via geckodriver — `Browser.launch({ browserName: 'firefox' })` spawns geckodriver, negotiates BiDi, and runs the full test suite under `BROWSER_NAME=firefox`. `FirefoxService` exported; respects `GECKODRIVER_PATH` / `GECKODRIVER_FILEPATH`; mobile emulation throws a clear error on Firefox.
+- feat: lightweight tracing — `browser.startTrace()` / `stopTrace(path)` write a JSON bundle of console, error, request, response and navigation events plus optional periodic screenshots. BiDi-only. See [docs/tracing.md](docs/tracing.md).
+- feat: `browser.activePage()` returns the focused page in `defaultContext` — explicit handle for the implicit target of `browser.click()` / `find()` / etc.
+- feat: `BrowserContext` API — real BiDi user contexts (isolated profiles). `browser.newContext()`, `browser.contexts()`, `browser.defaultContext`; `BrowserContext.newPage()`, `pages()`, `waitForPage()`, `close()`. BiDi-only.
+- feat: `Page` API — `browser.openPage({ url?, type? })` (BiDi-only), `browser.pages()`, `browser.waitForPage(action)`.
+- feat: iframe support — `browser.frame(selector)` returns a `Frame` scoped to the iframe; `browser.frames()` returns all frames.
+- feat: dialog handling — `browser.waitForDialog()`, `onDialog()`, `acceptDialog()`, `dismissDialog()`; `Dialog` / `DialogType` types exported.
+- feat: configurable default timeouts via `setDefaultTimeout` / `setDefaultNavigationTimeout`.
+- feat: composable `Locator` API — `browser.locator()`, `.nth()`, `.first()`, `.last()`, `.filter()`, `.count()`, `.all()`, `browser.findAll()`.
+- feat: `browser.evaluate()`, `element.evaluate()`, and `browser.addInitScript()`.
+- feat: `browser.waitForResponse()` / `waitForRequest()` for observing network traffic.
+- feat: `element.setInputFiles()` for file uploads; `browser.waitForDownload()` for downloads.
+- feat: BiDi-first navigation — `navigateTo(url, { waitUntil })`, `waitForLoadState()`, `network.waitForNetworkIdle()`; BiDi enabled by default.
+
+### Features
+
+- mobile emulation ([36ab952](https://github.com/dtopuzov/craftdriver/commit/36ab9527eb8c111565ad80c56e82644b52b39511))
+- network and session management ([d23057d](https://github.com/dtopuzov/craftdriver/commit/d23057d94de842e9a670246de0d8190a429a0657))
+
+## [0.0.3](https://github.com/dtopuzov/craftdriver/compare/v0.0.2...v0.0.3) (2026-02-03)
+
+### Bug Fixes
+
+- lint task ([7b83099](https://github.com/dtopuzov/craftdriver/commit/7b8309973f8660f3ec57548c030e6da7cd173748))
+
+## [0.0.2](https://github.com/dtopuzov/craftdriver/compare/v0.0.1...v0.0.2) (2026-02-03)
+
+### Bug Fixes
+
+- improve API consistency and test reliability ([495c49a](https://github.com/dtopuzov/craftdriver/commit/495c49a1fc68451cbdc27298c04d51e5f6c6f016))

package/README.md

@@ -1,32 +1,208 @@
 # Craftdriver 🍺🍺🍺
 
-Crafted Node.js browser automation built directly on the WebDriver protocol.
+[![CI](https://github.com/dtopuzov/craftdriver/actions/workflows/ci.yml/badge.svg)](https://github.com/dtopuzov/craftdriver/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/craftdriver.svg)](https://www.npmjs.com/package/craftdriver)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 
-Think of it as a modern take on Selenium with automatic waits and ergonomic API, while staying true to the W3C standards so your tests stay stable across real browsers.
+Crafted Node.js browser automation built directly on the WebDriver protocols.
 
-## Getting started
+**Playwright's ergonomics. WebDriver's standards-compliance. AI-ready.**
+
+Auto-waiting, semantic locators, network mocking, session management, mobile emulation, and more.
 
-Install from npm (package coming soon):
+Based on W3C specs, so your tests stay stable across real browsers.
+
+Ships AI productivity tooling out of the box: CLI, MCP, assistant bootstrap files, and packaged skill docs — no extra packages required.
+
+## Getting started
 
 ```bash
-npm install craftdriver
+npm install craftdriver --save-dev
 ```
 
+That's it.
+No drivers, no extra steps to install browsers.
+
 Quick example:
 
 ```ts
 import { Browser } from 'craftdriver';
 
 const browser = await Browser.launch({ browserName: 'chrome' });
-await browser.navigateTo('http://127.0.0.1:8080/login.html');
-await browser.fill('#username', 'testuser');
-await browser.fill('#password', 'secret');
+
+await browser.navigateTo('https://example.com');
+await browser.fill('#username', 'alice');
+await browser.fill('#password', 'hunter2');
 await browser.click('#submit');
-await browser.expect('#result').toHaveText('Welcome testuser');
+await browser.expect('#result').toHaveText('Welcome alice');
+
 await browser.quit();
 ```
 
-See [DOCUMENTATION.md](DOCUMENTATION.md) for more details.
+Mobile emulation:
+
+```ts
+const browser = await Browser.launch({
+  browserName: 'chrome',
+  mobileEmulation: 'iPhone 14',
+});
+```
+
+Network mocking (BiDi is on by default):
+
+```ts
+const browser = await Browser.launch({ browserName: 'chrome' });
+
+await browser.network.mock('**/api/users', {
+  status: 200,
+  body: { users: [] },
+});
+```
+
+Session persistence:
+
+```ts
+await browser.saveState('./session.json');
+
+// Later: restore cookies and localStorage in one shot
+const browser2 = await Browser.launch({
+  browserName: 'chrome',
+  storageState: './session.json',
+});
+```
+
+## AI Productivity Tooling
+
+`craftdriver` ships three surfaces for AI agents (Copilot, Claude
+Code, Cursor, Codex, Gemini CLI, …), in addition to the library:
+
+If you want Craftdriver to work well with coding agents on day one, this is the stack: a shell-friendly CLI, an MCP server for tool-calling hosts, packaged skills, and `craftdriver init` to drop the right repo instructions into place.
+
+- **CLI** (this section) — a `craftdriver` binary for shell-capable agents.
+- **Skill pack** — ready-to-load rules at [skills/craftdriver/](./skills/craftdriver/),
+  shipped in the npm tarball.
+- **MCP server** — stdio JSON-RPC for sandboxed hosts. See below.
+- **`craftdriver init`** — drop per-project rules files for the popular
+  assistants (Copilot, Claude, Cursor, Gemini, Codex / AGENTS.md).
+
+All four share the same dispatcher, error codes, and selector syntax.
+
+The `craftdriver` binary is for shell scripts, ad-hoc exploration, and
+shell-capable AI agents. It wraps the same Browser API as the library,
+with fail-fast defaults tuned for probing instead of stable test runs.
+
+```bash
+# terminal 1 — keep a long-lived browser around
+npx craftdriver daemon start
+
+# terminal 2 — drive it
+npx craftdriver go http://127.0.0.1:8080/login.html
+npx craftdriver fill '#username' alice
+npx craftdriver fill '#password' hunter2
+npx craftdriver click 'button[type=submit]'
+npx craftdriver wait '#result' --state visible
+npx craftdriver text '#result'
+
+npx craftdriver daemon stop
+```
+
+State (page, cookies, storage) survives between calls — the CLI feels
+like a REPL for the browser. For sandboxed environments that can't keep
+a daemon, pipe a script through `--ephemeral` instead.
+
+Selectors are CSS by default; switch with a `prefix=value` form
+(`role=button[name=Submit]`, `text=Sign In`, `label=Email`,
+`placeholder=...`, `testid=...`, `xpath=...`). Output is pretty on a
+TTY and JSON when piped. Every error carries the same stable `code` and
+`hint:` as the library. See [docs/cli.md](./docs/cli.md) for the full
+command list and selector reference.
+
+### Teach your AI assistant
+
+`craftdriver init <flavor>` writes a short rules file into your project
+so Copilot, Claude, Cursor, Codex, Gemini, OpenCode, Aider, &hellip;
+pick up the right conventions on every turn (selector preference,
+auto-waiting, error codes, CLI usage). Per-project, checked into git,
+zero runtime cost.
+
+```bash
+npx craftdriver init copilot   # .github/copilot-instructions.md
+npx craftdriver init claude    # CLAUDE.md
+npx craftdriver init cursor    # .cursor/rules/craftdriver.mdc
+npx craftdriver init gemini    # GEMINI.md
+npx craftdriver init agents    # AGENTS.md (Codex, OpenCode, Aider, Amp, Cursor)
+npx craftdriver init all       # every file above
+```
+
+Use `--force` to overwrite existing files, `--dry-run` to preview.
+
+### Skill pack
+
+For agents that load skills explicitly (Claude Code's Skills system,
+Copilot agent customization, custom orchestrators), the npm tarball
+ships a tiered skill pack under [skills/craftdriver/](./skills/craftdriver/):
+
+- [`SKILL.md`](./skills/craftdriver/SKILL.md) — always-on, ≤ 500 tokens.
+  Decision rules: selector preference order, error-code-first error
+  handling, the auto-wait contract, when to reach for CLI/MCP.
+- [`cheatsheet.md`](./skills/craftdriver/cheatsheet.md) — command-by-command
+  reference for writing tests.
+- [`patterns.md`](./skills/craftdriver/patterns.md) — worked recipes
+  (login, upload, network-wait, a11y, tracing, virtual clock).
+- [`cli.md`](./skills/craftdriver/cli.md) — agent-facing CLI reference.
+
+Point your agent at `node_modules/craftdriver/skills/craftdriver/SKILL.md`
+(or copy the file into your project) and the rest is loaded on demand.
+
+### MCP server
+
+For agents that talk [Model Context Protocol](https://modelcontextprotocol.io)
+(Claude Desktop / Code, Cursor, Windsurf, Zed, Goose, Gemini CLI, …),
+`craftdriver mcp` exposes the same dispatcher as a stdio JSON-RPC
+server with 14 schema-typed tools. Mutating tools return a **compact
+a11y snapshot diffed from the previous turn** — the agent sees what
+changed on the page without a follow-up read.
+
+```bash
+# Claude Code
+claude mcp add craftdriver -- npx -y craftdriver mcp
+```
+
+```jsonc
+// Cursor / Windsurf / Zed
+{
+  "mcpServers": {
+    "craftdriver": { "command": "npx", "args": ["-y", "craftdriver", "mcp"] }
+  }
+}
+```
+
+See [docs/mcp.md](./docs/mcp.md) for the full tool list, install
+snippets for every host, and the snapshot format.
+
+## Feature Guide
+
+One table is enough here: what Craftdriver does, and where to learn the exact API.
+
+| Area | What you get | Learn more |
+| --- | --- | --- |
+| Getting started | Install, launch a browser, write the first test | [Getting Started](./docs/getting-started.md) |
+| Driver management | Zero-config driver download, cache behavior, env vars, offline mode | [Driver Configuration](./docs/driver-configuration.md) |
+| Browser control | Navigation, tabs, popups, iframes, content helpers, evaluate, init scripts | [Browser API](./docs/browser-api.md) |
+| Elements and locators | CSS, XPath, text, role, label, test id, and composable `locator()` chains | [Selectors](./docs/selectors.md) |
+| Element actions | Click, fill, upload, inspect, and interact through element handles | [Element API](./docs/element-api.md) |
+| Assertions and auto-waiting | Built-in `expect(...)`, retries, visibility, text, attributes, and timing behavior | [Assertions](./docs/assertions.md) |
+| Keyboard and mouse | Low-level key presses, mouse movement, hover, drag, and pointer input | [Keyboard & Mouse](./docs/keyboard-mouse.md) |
+| Dialogs | `alert`, `confirm`, `prompt`, and `beforeunload` handling | [Dialogs](./docs/dialogs.md) |
+| Sessions and storage | Cookies, localStorage, save/load state, persistent flows | [Session Management](./docs/session-management.md) |
+| Screenshots | Page and element screenshots for tests and debugging | [Screenshots](./docs/screenshots.md) |
+| Mobile and emulation | Device presets, viewport emulation, locale, timezone, offline, reduced motion | [Mobile Emulation](./docs/mobile-emulation.md), [Emulation](./docs/emulation.md) |
+| Browser contexts | Isolated profiles for multi-user and multi-session testing | [Browser Contexts](./docs/browser-context.md) |
+| BiDi features | Network mocking, request/response listeners, console logs, JS errors | [BiDi Features](./docs/bidi-features.md) |
+| Tracing and debugging | Crash-resilient NDJSON traces and evidence screenshots | [Tracing](./docs/tracing.md) |
+| Accessibility | Built-in axe-core audits for page, element, and locator scopes | [Accessibility](./docs/accessibility.md) |
+| Virtual time | Fake `Date`, `setTimeout`, and `setInterval` for time-sensitive flows | [Virtual Clock](./docs/clock.md) |
+| Agent surfaces | Shell CLI, MCP server, assistant bootstrap, and packaged skill files | [CLI](./docs/cli.md), [MCP server](./docs/mcp.md), [Skill pack](./skills/craftdriver/SKILL.md) |
 
 ## Contributing
 

package/bin/craftdriver.mjs

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * craftdriver — CLI entry shim.
+ *
+ * Resolves the compiled CLI in `dist/cli/index.js` and invokes its
+ * `main()`. If the dist tree is missing, fail with a clear message
+ * pointing at `npm run build` rather than a stack trace.
+ */
+import { existsSync } from 'node:fs';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { dirname, resolve } from 'node:path';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const distEntry = resolve(here, '..', 'dist', 'cli', 'index.js');
+
+if (!existsSync(distEntry)) {
+  process.stderr.write(
+    'craftdriver: compiled CLI not found at ' + distEntry + '\n' +
+    'hint:  run `npm run build` first (the bin shim loads `dist/cli/index.js`).\n'
+  );
+  process.exit(2);
+}
+
+const mod = await import(pathToFileURL(distEntry).href);
+const rc = await mod.main(process.argv.slice(2));
+process.exit(typeof rc === 'number' ? rc : 0);

package/dist/cli/client.d.ts

@@ -0,0 +1,17 @@
+import type { Response } from './protocol.js';
+export interface ClientOptions {
+    socketPath?: string;
+    timeoutMs?: number;
+}
+export declare class DaemonClient {
+    private nextId;
+    private readonly socketPath;
+    private readonly timeoutMs;
+    constructor(opts?: ClientOptions);
+    /** Returns true if a daemon socket is reachable. */
+    static isRunning(socketPath?: string): Promise<boolean>;
+    /** Returns the daemon PID, if a PID file exists and the process is alive. */
+    static getPid(pidPath?: string): number | null;
+    send(cmd: string, args?: Record<string, unknown>): Promise<Response>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/cli/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/cli/client.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAW,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,GAAE,aAAkB;IAKpC,oDAAoD;WACvC,SAAS,CAAC,UAAU,GAAE,MAA2B,GAAG,OAAO,CAAC,OAAO,CAAC;IAWjF,6EAA6E;IAC7E,MAAM,CAAC,MAAM,CAAC,OAAO,GAAE,MAAwB,GAAG,MAAM,GAAG,IAAI;IAYzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAsC/E"}

package/dist/cli/client.js

@@ -0,0 +1,88 @@
+/**
+ * Tiny IPC client: speaks the line-delimited JSON protocol over a
+ * Unix socket. Each call opens a fresh connection — daemon-side state
+ * (active page, browser) survives between calls.
+ */
+import net from 'net';
+import fs from 'fs';
+import { DAEMON_SOCKET_PATH, DAEMON_PID_PATH } from './defaults.js';
+export class DaemonClient {
+    nextId = 1;
+    socketPath;
+    timeoutMs;
+    constructor(opts = {}) {
+        this.socketPath = opts.socketPath ?? DAEMON_SOCKET_PATH;
+        this.timeoutMs = opts.timeoutMs ?? 60_000;
+    }
+    /** Returns true if a daemon socket is reachable. */
+    static async isRunning(socketPath = DAEMON_SOCKET_PATH) {
+        if (!fs.existsSync(socketPath))
+            return false;
+        return new Promise((resolve) => {
+            const sock = net.createConnection(socketPath);
+            const done = (v) => { sock.destroy(); resolve(v); };
+            sock.once('connect', () => done(true));
+            sock.once('error', () => done(false));
+            sock.setTimeout(500, () => done(false));
+        });
+    }
+    /** Returns the daemon PID, if a PID file exists and the process is alive. */
+    static getPid(pidPath = DAEMON_PID_PATH) {
+        try {
+            const raw = fs.readFileSync(pidPath, 'utf8').trim();
+            const pid = Number(raw);
+            if (!Number.isFinite(pid) || pid <= 0)
+                return null;
+            try {
+                process.kill(pid, 0);
+            }
+            catch {
+                return null;
+            }
+            return pid;
+        }
+        catch {
+            return null;
+        }
+    }
+    async send(cmd, args = {}) {
+        const req = { id: this.nextId++, cmd, args };
+        return new Promise((resolve, reject) => {
+            const sock = net.createConnection(this.socketPath);
+            let buf = '';
+            const timer = setTimeout(() => {
+                sock.destroy();
+                reject(new Error(`daemon call timed out after ${this.timeoutMs}ms`));
+            }, this.timeoutMs);
+            sock.on('error', (err) => {
+                clearTimeout(timer);
+                reject(err);
+            });
+            sock.on('connect', () => {
+                sock.write(JSON.stringify(req) + '\n');
+            });
+            sock.on('data', (chunk) => {
+                buf += chunk.toString('utf8');
+                const idx = buf.indexOf('\n');
+                if (idx >= 0) {
+                    clearTimeout(timer);
+                    const line = buf.slice(0, idx);
+                    sock.end();
+                    try {
+                        resolve(JSON.parse(line));
+                    }
+                    catch (e) {
+                        reject(new Error('invalid response from daemon: ' + e.message));
+                    }
+                }
+            });
+            sock.on('end', () => {
+                if (!buf.includes('\n')) {
+                    clearTimeout(timer);
+                    reject(new Error('daemon closed connection without sending a response'));
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/cli/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/cli/client.ts"],"names":[],"mappings":"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"}

package/dist/cli/daemon.d.ts

@@ -0,0 +1,15 @@
+import type { LaunchOptions } from '../lib/browser.js';
+interface DaemonOptions {
+    socketPath?: string;
+    pidPath?: string;
+    launch: LaunchOptions;
+}
+export declare function runDaemon(opts: DaemonOptions): Promise<void>;
+export declare function toWireError(err: unknown): {
+    code: string;
+    message: string;
+    hint?: string;
+    detail?: Record<string, unknown>;
+};
+export {};
+//# sourceMappingURL=daemon.d.ts.map

package/dist/cli/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/cli/daemon.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAMvD,UAAU,aAAa;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA4FlE;AAUD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAc5H"}