AGENTS.md
Read the canonical human documentation before changing this workspace:
- [Writing Browser E2E Tests](../docs/contributing/e2e-testing.md) covers test
structure, Page Objects, locator priority, waiting, and validation.
- The [E2E workspace README](./README.md
No other project uses it yet
56k3mo agoReviewMountCreate a free account to mount
Running and verifying
- To validate skills: `uv run tools/validate_skills.py --strict`.
- To run the Python tests: `uv run --frozen python -B -m pytest`.
## Conventions that differ from defaults
- Skills, workflows, tasks
Coolinginterest down 27% this month
No other project uses it yet
55k53d agoReviewMountCreate a free account to mount
from `package.json` to run commands.
- Use `npm run build` to compile the project and tests with GN and Ninja.
- Update `src/BUILD.gn` or `tests/BUILD.gn` whenever adding, renaming, or removing `.ts` files
Steady13 mentions in 2 weeks
No other project uses it yet
55k6mo agoReviewMountCreate a free account to mount
bash
npx gulp server
```
Then open http://localhost:8888/web/viewer.html to view the PDF viewer. Test PDFs are available at http://localhost:8888/test/pdfs/?frame
### Building
Build for modern browsers:
```bash
No other project uses it yet
54k22mo agoReviewMountCreate a free account to mount
ownership with `withValidityAssertion`
- Mark experimental APIs with `@KaExperimentalApi`, implementation details with `@KaImplementationDetail`
## Working with Test Data
When modifying test data files or running generated tests (`*Generated`) that compare output against
No other project uses it yet
54k7d agoReviewMountCreate a free account to mount
mostly related to FIR (`compiler/fir/`), use `FIR: ` prefix in the commit subject line.
- **Test-before-fix**: When fixing an issue and adding a test, commit the test data
No other project uses it yet
54k7d agoReviewMountCreate a free account to mount
Read first
1. Read [CONTRIBUTING.md](./CONTRIBUTING.md). It is the source for setup, package scripts, tests, documentation, and changesets. Do not copy those steps into a new guide
Steady2 mentions in 2 weeks
No other project uses it yet
53k16d agoReviewMountCreate a free account to mount
these from the `docs/` directory. Run them locally on every docs change:
```sh
pnpm test # docs unit tests
pnpm test:worker # Cloudflare worker and route tests
NODE_ENV=production pnpm
No other project uses it yet
53k16d agoReviewMountCreate a free account to mount
entry point — it exists, exits 0, and runs nothing, which makes a smoke test
look green while doing nothing.
## `et verify`
Dispatch, dashboard, and `ls` delegate to the `@expo/verify` engine
No other project uses it yet
53k16d agoReviewMountCreate a free account to mount
body: copy [the template](.github/pull_request_template.md), keep every line, tick every box, and fill `What`, `Tested`, `Depends on` (#N or none), `Fixes` (Fixes #N or none), `Unblocks` (title ID and discussion
Steady17 mentions in 2 weeks
No other project uses it yet
52k19d agoReviewMountCreate a free account to mount
appropriate when it represents reusable behavior, a required interface/framework callback, an exported API, a test fixture, or complex business logic that deserves direct tests.
- If a single-use helper
No other project uses it yet
52k55d agoReviewMountCreate a free account to mount
This builds all executables under `cmd/`, including `keeper` which has special build requirements.
### 3. Tests
While iterating during development, use `-short` for faster feedback:
```sh
go run ./build/ci.go test -short
1 project uses a version of this
51k4y agoReviewMountCreate a free account to mount