llms.txt git:20261022.9058b2cA

Immutable. This exact content never changes and is served at /api/v1/blob/69487b6b9a8325d7.

# GenClass Runtime

> GenClass Runtime (`@genclass/runtime`) is an open-source (Apache-2.0) browser library that reports race conditions in web apps while they happen: stale responses that land over newer data, duplicate requests such as double submits, inconsistent state and failure storms. A small model runs on the user's device, in a Web Worker on WebGPU or WASM, and each report comes with its evidence. By default it only reports (`observe`): it never holds, delays or changes a request, a response or a state write. The opt-in `guard` mode may act on a few of them, and `heal` is experimental.

This file indexes the Markdown sources in the GenClass-lib repository, for `@genclass/runtime` 0.2.2 (npm `latest`) and 0.3.0-beta.0 (`beta`) as of 2026-10-22, both with the model `@genclass/runtime-model@0.2.0`, and the unreleased work on `main`. It holds no numbers on purpose: every measured number, each recall next to its false rate, is in docs/runtime/RESULTS.md, so quote numbers from there. On public hosts it sends anonymous diagnostics about its own decisions to its maintainers by default (with the page's hostname and id-normalised path, and no page text unless the app opts in); TELEMETRY.md lists every field and every opt-out. The website keeps its own index at https://genclass.dev/llms.txt.

## Start here

- [README](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/README.md): what GenClass Runtime is, the quick start, what it finds, how it compares with error trackers and tests, and the measured results
- [FAQ](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/FAQ.md): short answers to common questions (race conditions in React, stale responses, double submits, what it sends, what it costs), each with a link to the details
- [Package README](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/packages/runtime/README.md): the guide published on npm: install, modes, configuration, model quality, costs, privacy and known limitations
- [Docs index and glossary](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/docs/runtime/README.md): which document answers which question, how current each one is, and the terms they use

## Install and use

- [INSTALL.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/docs/runtime/INSTALL.md): every `init` and `remove` flag, the app token, the import, the script tag and the tested project setups
- [DASHBOARD.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/docs/runtime/DASHBOARD.md): app dashboards on genclass.dev and the `login`, `connect`, `whoami` and `logout` commands
- [SINKS.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/docs/runtime/SINKS.md): sending reports to your own logging or endpoint, and the record format
- [API.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/docs/runtime/API.md): every export, option, event, action and type
- [OPTIONS-SPEC.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/docs/runtime/OPTIONS-SPEC.md): why each configuration option exists and how the options combine

## Behaviour, privacy and security

- [INTERCEPTION.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/packages/runtime/INTERCEPTION.md): every browser API it wraps or listens to, what each mode may change, what it never does, and how to turn it off
- [TELEMETRY.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/packages/runtime/TELEMETRY.md): what the default-on anonymous diagnostics contain, where they go, and every opt-out
- [PRIVACY.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/PRIVACY.md): what genclass.dev collects and keeps
- [SECURITY.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/SECURITY.md): how to report a vulnerability, supported versions, and how to check a published tarball
- [THREAT-MODEL.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/docs/runtime/THREAT-MODEL.md): what could go wrong or be made to go wrong, with mitigations and residual risks

## Measurements

- [RESULTS.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/docs/runtime/RESULTS.md): every measured number (detection, false interventions, demos, compatibility, first-load size, browser cost, visual checks), each section naming its model, runtime version and setup
- [compat/RESULTS.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/compat/RESULTS.md): the framework compatibility matrix, generated by a script from a recorded run
- [Model card](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/packages/runtime-model/MODEL_CARD.md): the default model, its training data, gate profiles, accuracy and limits

## Guides

- [How to fix race conditions in React data fetching](https://genclass.dev/guides/race-conditions-react): why `useEffect` fetches show stale data, and four fixes: an ignore flag, `AbortController`, request ids and the runtime
- [Out-of-order responses and stale search results](https://genclass.dev/guides/stale-responses-out-of-order): why debounce is not enough, cancelling or comparing before writing, and the `switchMap` pattern
- [How to prevent duplicate form submissions](https://genclass.dev/guides/prevent-duplicate-submissions): locking the UI, idempotency keys, deduplicating on the server and coalescing repeats at runtime

## Optional

- [ARCHITECTURE.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/docs/runtime/ARCHITECTURE.md): how the parts fit together and why they are built this way
- [VISUAL.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/docs/runtime/VISUAL.md): design of the measured visual and CSS checks, which are deterministic checks, not the model
- [EXPECTATIONS.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/docs/runtime/EXPECTATIONS.md): design of the opt-in flow expectations, whose false-report rate is not measured yet
- [ANALYTICS.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/docs/runtime/ANALYTICS.md): design of the opt-in interaction analytics, not yet in a published version
- [QUERY-CACHE-ADAPTERS.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/docs/runtime/QUERY-CACHE-ADAPTERS.md): a proposal for TanStack Query and SWR adapters, not built
- [CONTRACT.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/docs/runtime/CONTRACT.md): the binding rules for people changing the runtime and its training pipeline
- [CHANGELOG](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/packages/runtime/CHANGELOG.md): what changed in each release of `@genclass/runtime`
- [Playwright reporter](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/packages/playwright/README.md): `@genclass/playwright` 0.1.0, not on npm yet, which turns the race files of a GenClass Playwright fixture (not shipped yet) into one markdown report per pull request
- [EVAL.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/training/EVAL.md): the raw model evaluation reports that RESULTS.md summarises
- [AGENTS.md](https://raw.githubusercontent.com/genclass-dev/GenClass-lib/main/AGENTS.md): the repository map and rules for coding agents working on GenClass itself