Perf test moka pr2243

.cargo/config.toml

@@ -0,0 +1,9 @@
+[build]
+rustflags = ["-C", "target-cpu=native", "-C", "force-frame-pointers=yes", "--cfg", "tokio_unstable"]
+
+[target.x86_64-unknown-linux-gnu]
+rustflags = ["-C", "target-cpu=native", "-C", "link-arg=-fuse-ld=mold", "-C", "force-frame-pointers=yes", "--cfg", "tokio_unstable"]
+
+[profile.release]
+lto = "thin"
+codegen-units = 8

.gitignore

@@ -25,3 +25,5 @@ nativelink.bazelrc
 *.log
 buck-out/
 nativelink_config.schema.json
+.cargo/config.toml
+.cargo/config.toml

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "tokio-epoll-uring"]
+	path = tokio-epoll-uring
+	url = forgejo@optimus.m0n0.space:rejuvenile/tokio-epoll-uring.git

CLAUDE.md

@@ -0,0 +1,96 @@
+# NativeLink Rust Style & Conventions
+
+## Imports
+- Order: `core::` → `std::` → external crates (alphabetical) → internal `nativelink-*` crates
+- Group proto imports by module, not alphabetically
+- Use `use crate::...` for same-crate modules
+
+## Error Handling
+- `make_err!(Code::..., "message")` for internal errors; `make_input_err!("message")` for bad input
+- `error_if!(condition, "message")` for early validation returns
+- `.err_tip(|| "context")` to chain diagnostic context onto Results
+- Never panic or unwrap in library code; always return `Result<T, Error>`
+- Use `{:?}` for debug formatting of upstream errors in messages
+
+## Logging (tracing)
+- `use tracing::{debug, error, info, trace, warn};`
+- Structured fields: `%` for Display, `?` for Debug — `info!(%key, ?value, "message")`
+- `info!` for state transitions, transfer completions with throughput/duration
+- `warn!` for performance anomalies (slow ops, contention, early evictions)
+- `trace!` for hot-path / repetitive loops; avoid logging inside tight loops
+- Messages: lowercase, no trailing period, describe **why** not what
+
+## Async & Concurrency
+- `#[async_trait]` on trait definitions and impls
+- `Pin<&Self>` for `StoreDriver` trait methods
+- `spawn_blocking()` for CPU-bound or sync filesystem work; avoid async recursion
+- `tokio::join!` for fixed concurrent work; `FuturesUnordered` for variable-count
+- `parking_lot::Mutex` for sync contexts; never hold locks across `.await`
+
+## Config (serde)
+- `#[serde(deny_unknown_fields)]` on config structs
+- `#[serde(default)]` or `#[serde(default = "fn_name")]` for optional fields
+- `#[serde(deserialize_with = "convert_string_with_shellexpand")]` for paths
+- `#[serde(rename_all = "snake_case")]` on enums
+
+## Metrics
+- `#[derive(MetricsComponent)]` on public structs
+- `#[metric(help = "...")]` on fields; `#[metric(group = "...")]` for nesting
+
+## Naming & Formatting
+- Functions: `snake_case`; types: `PascalCase`; constants: `UPPER_SNAKE_CASE`
+- ~100 char soft line limit; readability over rigid length
+- Blank line between logical sections; single blank line between items
+- `Cow<'_, T>` in hot paths to avoid allocation
+
+## Comments
+- `///` doc comments on public items explain **why** and show examples
+- `//` inline comments only for non-obvious logic or workarounds
+- `TODO(...)` with issue number when possible for known issues
+
+## Feature Gates
+- `#[cfg(feature = "...")]` at definition site
+- `#[cfg(target_os = "...")]` for OS-specific code (Linux vs macOS)
+
+## Tests
+- **Test-first development**: when implementing any new feature, write tests first
+  (unit, integration, and cross-component interaction tests). Verify they fail before
+  implementing the feature, then make them pass. Include fakes/mocks for
+  hardware-interaction tests where needed.
+- **Bug fixes require a failing test first**: when fixing a bug, write a test that
+  reproduces the failure, verify it fails, then implement the fix and show the test
+  passes. Never fix a bug without a regression test.
+- Integration tests in `tests/` directory; minimal inline `#[cfg(test)]` modules
+- Use `nativelink-macro` test harness (`#[nativelink_test]`)
+
+## Change Process
+- **Chesterton's Fence**: before modifying or removing any behavior, always check
+  `git log`, `git blame`, and `git log -S` to understand *why* the code exists.
+  If a commit message or comment explains the reason, evaluate whether that reason
+  still applies before making the change.
+
+## Code Review
+- **Before committing any change**, send the changes to a code review agent and a
+  performance review agent. Work to obtain their sign-off before committing. Fix
+  any issues they identify. Only commit after both reviews pass with no blocking
+  issues.
+
+## Git Journal
+- **Journal all git operations**: append every `git commit`, `git push`, `git revert`,
+  `git stash`, and any other state-changing git command to `.claude/git-journal.md`
+  in the working directory. Each entry should include the timestamp, command, and a
+  one-line description. This prevents losing track of what was done across context
+  compressions.
+
+## Working Directory Discipline
+- **Always verify `pwd` before git operations.** Agent worktrees (`.claude/worktrees/`)
+  have separate git branches. Commits in a worktree do NOT go to `main`. The Bash tool
+  may silently `cd` into a worktree after an agent runs. Always `cd /path/to/nativelink`
+  before any `git commit`, `git push`, or `git status`.
+- **Never use `git stash pop`** — it can cause merge conflicts that `git checkout --` resolves
+  by reverting uncommitted edits. Use `git stash apply` + `git stash drop` separately.
+- **Commit early, commit often.** After each logical change compiles, commit immediately.
+  Don't accumulate multiple uncommitted changes across a session — context compression
+  or worktree confusion can lose them.
+- **After editing files, verify with `git diff --stat HEAD`** that the expected changes
+  appear before moving on to the next task.