# Contributor handoff — rolldown/rolldown

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

# Contributor handoff — rolldown/rolldown

Scanned commit 37d60ff510b4b326f4b587c27f28c606d76373e8 (2026-10-02). Generated by codevetter codevetter 1.15.0 on 2026-10-02.

Source inspection; upstream code and tests were not executed.

Future agents should begin with feature-local implementation and lifecycle documentation, then verify it against code. Safe boundaries distinguish public TypeScript sources, NAPI adapters, generated bindings, and Rust core state owners. Tests and CI were inspected, not executed; this brief supplies no passing result and its inventory is bounded. Suggested checks below are for a separately authorized implementation session, not actions performed during this investigation.
- Read the relevant internal-docs feature first, keep it synchronized with implementation changes, and verify proposals against source; lifecycle docs explicitly separate bundler-level from per-build data. — [AGENTS.md#L15-24](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/AGENTS.md#L15-L24) [internal-docs/bundler-data-lifecycle/implementation.md#L3-9](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/internal-docs/bundler-data-lifecycle/implementation.md#L3-L9)
- Do not directly edit binding.cjs, binding.d.cts, debug generated output, or Rollup/test262 submodules; regenerate bindings from Rust through the documented build workflow. — [AGENTS.md#L56-64](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/AGENTS.md#L56-L64) [AGENTS.md#L68-71](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/AGENTS.md#L68-L71)
- For public API changes, follow rolldown/index.ts → RolldownBuild → createBundlerOptions → BindingBundler/ClassicBundler, preserving deferred graph construction and fresh-output-build semantics. — [packages/rolldown/src/api/rolldown/index.ts#L6-12](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/packages/rolldown/src/api/rolldown/index.ts#L6-L12) [packages/rolldown/src/api/rolldown/rolldown-build.ts#L124-142](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/packages/rolldown/src/api/rolldown/rolldown-build.ts#L124-L142) [crates/rolldown_binding/src/classic_bundler.rs#L23-41](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/crates/rolldown_binding/src/classic_bundler.rs#L23-L41)
- For watch/cache changes, read WatchTask before modifying phase order: it clears resolver/tsconfig caches, registers scan-discovered watches before propagating errors, and branches on skipWrite. — [crates/rolldown_watcher/src/watch_task.rs#L87-125](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/crates/rolldown_watcher/src/watch_task.rs#L87-L125) [internal-docs/watch-mode/implementation.md#L102-107](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/internal-docs/watch-mode/implementation.md#L102-L107)
- Follow the path guide's known-UTF-8 convention, consuming rolldown_std_utils helpers for owned paths, absolute explicit cwd arguments, and native separators for module IDs. — [internal-docs/path-manipulation/style-guide.md#L3-23](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/internal-docs/path-manipulation/style-guide.md#L3-L23) [internal-docs/path-manipulation/style-guide.md#L25-36](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/internal-docs/path-manipulation/style-guide.md#L25-L36)
- In an authorized implementation session, prefer just recipes: targeted Node runs can use test-node-rolldown-only, Rust fixtures use t-run, and lint-rust includes formatting, locked all-feature/all-target checking, and Clippy with denied warnings. — [AGENTS.md#L66-78](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/AGENTS.md#L66-L78) [justfile#L82-85](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/justfile#L82-L85) [justfile#L136-143](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/justfile#L136-L143) [justfile#L168-176](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/justfile#L168-L176)
- Tests and CI were inspected, not executed. Future validation must account for Rust snapshot updates, WASI replacing native dist, browser versus WebContainer fallback paths, and conditional platform lanes; listed test files do not establish a passing result. — [AGENTS.md#L76-100](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/AGENTS.md#L76-L100) [justfile#L96-98](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/justfile#L96-L98) [.github/workflows/reusable-browser.yml#L48-62](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/.github/workflows/reusable-browser.yml#L48-L62) [.github/workflows/ci.yml#L326-347](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/.github/workflows/ci.yml#L326-L347)
- Respect repository compatibility and review conventions: rolldown_* Rust crates do not follow semver, PRs remain drafts until requested otherwise, and concurrent fixtures should use mocks rather than global expect.assertions. — [AGENTS.md#L7-9](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/AGENTS.md#L7-L9) [AGENTS.md#L84-86](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/AGENTS.md#L84-L86) [vite.config.ts#L100-109](https://github.com/rolldown/rolldown/blob/37d60ff510b4b326f4b587c27f28c606d76373e8/vite.config.ts#L100-L109)

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)