cmd/sweep: add the cluster sweep orchestrator and its Typst report

.gitignore

@@ -29,6 +29,7 @@ z-scratch/
 
 # Binary files
 benchkit/cmd/benchmark/benchmark
+benchkit/cmd/sweep/sweep
 examples/storage/storage
 
 # Gorums generated backup files
@@ -37,6 +38,13 @@ cmd/protoc-gen-gorums/gengorums/template_static.go.bak
 go.work.sum
 branch-compare-*
 tmp/*
+out/*
 .claude/settings.local.json
 .claude/agent-memory/
 CLAUDE.md
+scripts/bbchain-echo.sh
+scripts/bbchain-ssh-config
+scripts/bbchain-infocmp.sh
+scripts/__pycache__/plot.cpython-314.pyc
+scripts/install-bbchain-key.sh
+report/dedup-eval*/*

AGENTS.md

@@ -31,6 +31,7 @@ gorums/
 │   ├── proto/                 # .proto sources for the benchkit module
 │   ├── benchmark/             # Gorums workloads built on benchkit
 │   ├── cmd/benchmark/         # Benchmark node binary
+│   └── cmd/sweep/             # Cluster sweep orchestrator
 ├── examples/                  # Separate module: example implementations
 ├── internal/                  # Internal packages
 ├── doc/                       # Documentation
@@ -187,6 +188,9 @@ make -B
 # Install protoc-gen-gorums plugin
 make installgorums
 
+# Build benchmark tool
+make benchmark
+
 # Install required tools
 make tools
 ```
@@ -259,6 +263,7 @@ Before making significant changes, consult:
 
 - Gorums is used in performance-critical distributed systems
 - Benchmarking tools are available in `benchkit/benchmark/` and `benchkit/cmd/benchmark/`
+- See `doc/benchmarking.md` for benchmarking procedures
 - Profile before optimizing - use Go's pprof tools
 
 ## Communication with Project Maintainer

Makefile

@@ -19,7 +19,7 @@ runtime_deps			:= internal/stream/stream.pb.go internal/stream/stream_grpc.pb.go
 benchkit_deps			:= benchkit/benchkit.pb.go benchkit/control.pb.go benchkit/control_gorums.pb.go
 benchmark_deps			:= $(benchkit_deps) benchkit/benchmark/benchmark.pb.go benchkit/benchmark/benchmark_gorums.pb.go
 
-.PHONY: all dev tools bootstrapgorums installgorums benchmark benchkit test compiletests genproto benchtest bench lint deadcode modernize goplscheck
+.PHONY: all dev tools bootstrapgorums installgorums benchmark sweep test compiletests genproto benchtest bench lint deadcode modernize goplscheck
 
 all: dev benchmark compiletests
 
@@ -36,6 +36,9 @@ benchmark: installgorums $(benchmark_deps)
 
 benchkit: installgorums $(benchkit_deps)
 
+sweep: $(benchkit_deps)
+	@go build -C benchkit/cmd/sweep -o sweep .
+
 # The benchkit module's generated code is written back into the module root
 # rather than next to its .proto file, so these cannot use the pattern rules.
 benchkit/benchkit.pb.go: $(bk_path)/benchkit/benchkit.proto
@@ -171,7 +174,7 @@ goplscheck:
 			exit 1; \
 		fi
 
-# Regenerate all Gorums and protobuf generated files across the repo (dev, benchkit, benchmark, internal/tests, examples).
+# Regenerate all Gorums and protobuf generated files across the repo (dev, benchmark, internal/tests, examples).
 # This will force regeneration even though the proto files have not changed.
 genproto: installgorums dev
 	@echo "Regenerating all proto files (dev, benchkit, benchmark, internal/tests, examples)"