Context
> **For humans:** This file provides context for AI coding assistants (Kiro, Cursor, Claude Code, GitHub Copilot). For the human-readable documentation, see [docs/](./docs/README.md), [README.md](./README.md), or [docs/tutorial.md](./docs/tutorial.md
should do so.
- If the user asks for a "review", default to a codereview mindset: prioritise
identifying bugs, risks, behavioural regressions, and missing tests. Findings
must be the primary
symbols defined in `__all__` within modules or
subpackages that are not prefixed with `_`.
In codereviews, any violations of this section should be considered
suggestions, not hard rules. Consistency with
preferred; browser and full-binary tests are for behavior that needs
those environments. Test code is a major part of Rust compile time, so avoid
duplicating cases across test functions
substitute (diligence is empirically insufficient: #12420 missed 4/4; #14499 shipped ≥2 violations past 2 reviews). The ADR §3 catalog is the forbidden-pattern list (pass-along/thread, re-derive/env-read
AGENTS.md
This file is for agentic coding tools. It's a map — read linked docs for depth.
## Repo overview
Nexu is a desktop-first OpenClaw platform. Users create AI bots
await`s use `ConfigureAwait(false)`; the driver does not assume a synchronization context. Application code calling the driver may use whatever it likes.
- **Cancellation / CSOT propagation.** `CancellationToken` and `OperationContext
long-lived code.
- `ClientSessionHandle` wraps `ICoreSessionHandle` (declared in `Core/Bindings/ICoreSession.cs`; the implementation is `CoreSessionHandle` in `Core/Bindings/CoreSessionHandle.cs`, which wraps the underlying `CoreSession` from `Core/Bindings/CoreSession.cs`).
**Ownership boundary.** The `client-api-reviewer` owns *only
Core/Authentication/` and `Core/Bindings/` also live under `Core/` but are out of scope for this reviewer — see the auth-area and operations-area AGENTS.md.)
**Ownership boundary:** the Operations layer (`Core/Operations/`, `Core/Bindings
area: Diagnostics — Logging
scope: ["src/MongoDB.Driver/Core/Logging/**/*.cs"]
reviewer-agent: diagnostics-reviewer
adjacent-areas: [Core/Events, Driver root (LoggingSettings on MongoClientSettings)]
---
# Core/Logging — AGENTS.md
Bridges the event subsystem (`Core/Events/`) to `Microsoft.Extensions.Logging`. When the user
TestHelpers.
- **vs each `src/` area.** A spec runner pulls in code from many functional areas; spec-conformance reviewer cross-cuts them all. When a spec test fails, the relevant area