# Contributor handoff — elysiajs/elysia

> Canonical page: https://codevetter.com/unpack/elysia/agent-handoff

# Contributor handoff — elysiajs/elysia

Scanned commit e037eca710e7ad193be09cc6615ab0dbe54af914 (2026-08-26). Generated by codevetter codevetter 1.15.0 on 2026-10-02.

Source inspection; upstream code and tests were not executed.

This brief is pinned to e037eca710e7ad193be09cc6615ab0dbe54af914 and comes from bounded public-source inspection of more than twelve source files. Tests and CI were inspected, not executed, and test existence does not establish passing behavior. Future edits should preserve execution parity, adapter boundaries and public inference. Repository contribution policies and script side effects need attention before moving beyond read-only analysis.
- Treat validation and routing conclusions as source-backed behavior, not execution results: tests and CI were inspected, not executed, and only selected tests were read. — [test/core/dynamic.test.ts#L24-44](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/test/core/dynamic.test.ts#L24-L44) [.github/workflows/ci.yml#L24-31](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/.github/workflows/ci.yml#L24-L31)
- For routing changes, read add, its compile/cache closure, composeGeneralHandler and createDynamicHandler together; static tables and dynamic route stores use different representations. — [src/index.ts#L918-1008](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/src/index.ts#L918-L1008) [src/compose.ts#L2351-2424](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/src/compose.ts#L2351-L2424) [src/dynamic-handle.ts#L264-278](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/src/dynamic-handle.ts#L264-L278)
- When checks are authorized, begin with a focused Bun test as CONTRIBUTING documents; relevant starting suites include dynamic-mode, native-static, cookie-signature and range tests. — [CONTRIBUTING.md#L19-24](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/CONTRIBUTING.md#L19-L24) [test/core/dynamic.test.ts#L1-14](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/test/core/dynamic.test.ts#L1-L14) [test/core/native-static.test.ts#L83-124](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/test/core/native-static.test.ts#L83-L124) [test/response/range.test.ts#L6-15](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/test/response/range.test.ts#L6-L15)
- Preserve provider contracts: Standard Schema Check deliberately fails closed for Promise results, while asynchronous callers should use Validate and consume value/issues. — [src/schema.ts#L611-648](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/src/schema.ts#L611-L648) [test/units/get-schema-validator.test.ts#L21-43](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/test/units/get-schema-validator.test.ts#L21-L43)
- Public API edits require inference review as well as runtime review: Elysia generics and MacroToContext feed route/context types, and test:types compiles the dedicated test/types project. — [src/index.ts#L190-226](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/src/index.ts#L190-L226) [src/types.ts#L1044-1075](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/src/types.ts#L1044-L1075) [package.json#L180-183](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/package.json#L180-L183) [tsconfig.test.json#L104-105](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/tsconfig.test.json#L104-L105)
- Keep runtime checks specific: default adapter choice depends on Bun availability, WebStandard listen throws, Cloudflare precompiles routes, and Node fixtures only smoke-test app.handle. — [src/index.ts#L405-407](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/src/index.ts#L405-L407) [src/adapter/web-standard/index.ts#L231-237](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/src/adapter/web-standard/index.ts#L231-L237) [src/adapter/cloudflare-worker/index.ts#L45-55](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/src/adapter/cloudflare-worker/index.ts#L45-L55) [test/node/cjs/index.js#L10-25](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/test/node/cjs/index.js#L10-L25)
- Match tabs, single quotes, no semicolons and no trailing commas; AGENTS requires surgical edits and reading exports/callers, while AI_POLICY requires human-reviewed contributions and rejects fully automated issue/PR creation. — [.prettierrc#L1-7](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/.prettierrc#L1-L7) [AGENTS.md#L18-22](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/AGENTS.md#L18-L22) [AGENTS.md#L50-53](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/AGENTS.md#L50-L53) [AI_POLICY.md#L5-15](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/AI_POLICY.md#L5-L15)
- Do not treat scripts as harmless checks: build removes dist and shells out to tsc, Node/Cloudflare scripts install packages, Cloudflare testing spawns a server, and release publishes the package. — [build.ts#L10-29](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/build.ts#L10-L29) [package.json#L179-189](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/package.json#L179-L189) [test/cloudflare/script/test.ts#L1-24](https://github.com/elysiajs/elysia/blob/e037eca710e7ad193be09cc6615ab0dbe54af914/test/cloudflare/script/test.ts#L1-L24)

Every claim links to its cited files at the pinned commit. Citations identify source evidence; they do not establish runtime correctness. Independent CodeVetter scan — not reviewed by upstream maintainers.

## Public product links

- [CodeVetter](https://codevetter.com/)
- [Download](https://codevetter.com/download)
- [Documentation](https://codevetter.com/docs/)
- [Source](https://github.com/Codevetter/codevetter)