[varex83agent]

Closes #634

Summary

• CONTRIBUTING.md: Correct the false claim that `nix develop` provides the Rust toolchain (it doesn't — `rust-toolchain.toml` + rustup does). Document that nightly rustfmt, Go, and a running Docker daemon are required for the full quality gate. Document what the pre-push hook actually runs (deny + machete + nightly fmt + clippy + test). Fix the dhat profiling section: wrong code fence (```rust → ```toml) and invalid version (`"latest"` → `"0.3"`).

• README.md: Rewrite the "Version compatibility" section to describe Pluto's own promise (was verbatim copy from Charon, talking about "two versions of Charon"). Add a minimal Build/Run/Test quickstart covering Docker image, source build, and test-infra. Add 5 missing examples (bootnode, consensus/qbft, dkg/bcast, dkg/sync, parsigex).

• AGENTS.md: Add 8 missing crates to the workspace tree diagram: `consensus`, `eth1wrap`, `featureset`, `frost`, `infosync`, `parsigex`, `priority`, `ssz`. Add `scripts/` and `third_party/` to the tree.

• crates/cli/src/cli.rs: Replace user-visible "Verify that Charon …" and "charon clients" in `long_about` strings with Pluto. Fix "Creates a local charon cluster configuration" to say "local cluster configuration". File/flag names (`charon-enr-private-key`) are compatibility surface and are left untouched.

• crates/cli/src/commands/run.rs: Fix the `help` comment that said "pluto enr private key" while the actual default is `charon-enr-private-key`; comment now explains the Charon-compatible filename is intentional.

• crates/cluster/src/lib.rs, crates/tracing/src/lib.rs: Rename module-doc headings from "# Charon Cluster" / "# Charon Observability" to "# Pluto Cluster" / "# Pluto Observability".

🤖 Generated with Claude Code

[emlautarom1]

I'd leave this PR as pending until we have #597 and #611 merged: there is no point in describing a setup that will change in the near future.

[varex83agent]

Merged main and addressed the outstanding review.

On the blocker — #597 (Go toolchain) and #611 (oas3-gen) are both closed now, so there's no longer a setup in flux being described. Dropped both from CONTRIBUTING entirely rather than carrying them as a future cleanup.

Conflicts resolved:

• AGENTS.md — both sides added a crate to the tree (ssz here, test-compose on main); kept both and added the two still missing, proto and stacktrace. The tree now matches crates/ exactly.
• CONTRIBUTING.md — see below.
• crates/cluster/src/lib.rs — took main's module doc verbatim; it already carries the # Pluto Cluster heading this branch was renaming to, plus a better body. No diff against main here any more.

Further drift found while merging (main moved these after the PR was opened):

• The pre-push hook now runs cargo test --locked --workspace --features pluto-eth2api/integration, not --all-features. CONTRIBUTING's description of the hook and the README quickstart both still said --all-features; fixed both. The Docker caveat now hangs off pluto-eth2api/integration, which is the feature that actually pulls in testcontainers.
• Noted that the opt-in smoke tests (--features smoke) need Docker too, and that Docker is not part of the Nix shell — it's a host daemon.
• Added cargo-llvm-cov to the manual-setup list, since the Nix shell provides it.

Verified all 11 example paths in the README resolve to real files, and that nethermindeth/pluto + ENTRYPOINT ["/app/bin/pluto"] match publish-dockerhub.yml and the Dockerfile.

Gates: cargo +nightly fmt --all --check, cargo clippy --workspace --all-targets --all-features -- -D warnings, cargo test --workspace --features pluto-eth2api/integration (66 targets, 0 failures) and cargo deny check all pass. The two cargo deny duplicate warnings (windows-sys, yamux) are pre-existing on main.

🤖 Generated with Claude Code

[emlautarom1]

Made some follow up fixes:

• More consistent help messages
• Simplified README and CONTRIBUTING docs
• Include nightly rustfmt requirement
• Pin dependencies in instructions