git:20260921.7061756 to git:20261022.18f3235

# AGENTS.md

## Project

- This is a pnpm/Turbo TypeScript monorepo.

- Workspaces live in `packages/*`, `docs`, and `examples/*`.

- Core packages are `@edgestore/server`, `@edgestore/react`, and

`@edgestore/shared`.

## Setup

- Install dependencies with `pnpm install`.

- Prefer existing workspace scripts over ad hoc commands.

## Common Commands

- Build packages: `pnpm build`

- Build everything: `pnpm build:all`

- Typecheck packages: `pnpm typecheck`

- Test packages: `pnpm test`

- Type tests: `pnpm test:types`

- Lint: `pnpm lint`

- Format check: `pnpm format --check`

- Docs dev server: `pnpm docs:dev`

For focused work, prefer Turbo or pnpm filters, for example:

`pnpm turbo run test --filter=@edgestore/server`.

## Changesets

- Any PR that changes published `@edgestore/*` behavior or public APIs must

include a changeset.

- Use `patch` for fixes, `minor` for backward-compatible features, and `major`

for breaking changes.

- Changes limited to tests, docs, examples, or internal tooling do not need one.

- For unreleased work, update the existing changeset to describe the final

feature rather than adding entries for intermediate fixes or wording changes.

Do not bump a plugin's version before its first release.

- When changing package APIs, update the relevant authored documentation in

`docs/content/docs/`. Package `agent-docs/` references are generated from it;

do not edit generated files. Run `pnpm agent-docs:test` and, after building,

`pnpm agent-docs:pack-check` to verify the published references.

## Review guidelines

- Prioritize structural issues over style nits.

- Look for simpler designs that delete branching, indirection, or special cases.

- Flag ad-hoc conditionals, leaky boundaries, unnecessary wrappers, and

cast-heavy types when they make code harder to reason about.

- Keep feedback direct, actionable, and focused on maintainability.

## Git

- Avoid commands that rewrite history, such as `git rebase`, `git commit --amend`, and force-pushes, unless explicitly asked.