cluster: make example presets build-from-local, add gravity_cli Makefile target

Two ergonomics fixes discovered while following the cluster deployment
docs end-to-end on a fresh machine:

1. Every cluster.toml under cluster/example/ ships with
     source = { github = "Galxe/gravity-sdk", rev = "main" }
   This instructs deploy.sh to re-clone gravity-sdk and cargo-build it a
   second time inside the runtime dir, even when the user has already
   built the binaries in target/quick-release from the top-level Makefile.
   The result is a long re-build, extra disk usage, and ENOSPC on
   machines with modest free space.

   Change all five examples to source = { project_path = "../" }, matching
   cluster/cluster.toml.example and what the presets were clearly intended
   to be used for (the 1_node preset is literally named gravity-devnet-one).
   Anyone wanting github-source deploys can still flip the line back.

2. The top-level Makefile had targets for gravity_node / bench / kvstore
   but none for gravity_cli — yet init.sh, genesis.sh, and deploy.sh all
   require gravity_cli and fail with "gravity_cli not found! Please build
   it first." So the cluster docs instruction of "make BINARY=gravity_node
   MODE=quick-release" does not actually produce a working setup.

   Add a gravity_cli target, and a cluster convenience target that builds
   both gravity_node and gravity_cli in one invocation. The cluster docs
   can now say `make cluster MODE=quick-release` and work out of the box.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: 2 people

Makefile

@@ -2,7 +2,7 @@ BINARY ?= gravity_node
 FEATURE ?=
 MODE ?= release
 
-BIN_DIRS := gravity_node bench kvstore
+BIN_DIRS := gravity_node gravity_cli bench kvstore
 BIN_PATHS := $(addprefix bin/, $(BIN_DIRS))
 
 ifeq ($(MODE),release)
@@ -15,13 +15,22 @@ endif
 
 CARGO_FEATURES := $(if $(FEATURE),--features $(FEATURE),)
 
-.PHONY: all $(BIN_DIRS) clean
+.PHONY: all cluster $(BIN_DIRS) clean
 
 all: $(BINARY)
 
+# Convenience target: build everything the cluster/ scripts need.
+# `make init`, `make genesis`, and `make deploy` all require gravity_cli in
+# addition to gravity_node, so this target is the one-shot build for anyone
+# following the cluster deployment or local-devnet docs.
+cluster: gravity_node gravity_cli
+
 gravity_node:
 	RUSTFLAGS="--cfg tokio_unstable" cargo build -p gravity_node $(CARGO_FLAGS) $(CARGO_FEATURES)
 
+gravity_cli:
+	cargo build -p gravity_cli $(CARGO_FLAGS) $(CARGO_FEATURES)
+
 bench:
 	cargo build -p bench $(CARGO_FLAGS) $(CARGO_FEATURES)
 

cluster/example/1_node/cluster.toml

@@ -13,7 +13,7 @@ waypoint_path = "./output/waypoint.txt"
 [[nodes]]
 id = "node1"
 role = "genesis"
-source = { github = "Galxe/gravity-sdk", rev = "main" }
+source = { project_path = "../" }
 host = "127.0.0.1"
 validator_port = 6180
 vfn_port = 6190

cluster/example/1_node_distinct_roles/cluster.toml

@@ -12,7 +12,7 @@ waypoint_path = "./output/waypoint.txt"
 [[nodes]]
 id = "node1"
 role = "genesis"
-source = { github = "Galxe/gravity-sdk", rev = "main" }
+source = { project_path = "../" }
 host = "127.0.0.1"
 validator_port = 6180
 vfn_port = 6190

cluster/example/3_node/cluster.toml

@@ -13,7 +13,7 @@ waypoint_path = "./output/waypoint.txt"
 [[nodes]]
 id = "node1"
 role = "genesis"
-source = { github = "Galxe/gravity-sdk", rev = "main" }
+source = { project_path = "../" }
 host = "127.0.0.1"
 validator_port = 6180
 vfn_port = 6190
@@ -27,7 +27,7 @@ reth_p2p_port = 12024
 [[nodes]]
 id = "node2"
 role = "genesis"
-source = { github = "Galxe/gravity-sdk", rev = "main" }
+source = { project_path = "../" }
 host = "127.0.0.1"
 validator_port = 6181
 vfn_port = 6191
@@ -41,7 +41,7 @@ reth_p2p_port = 12025
 [[nodes]]
 id = "node3"
 role = "genesis"
-source = { github = "Galxe/gravity-sdk", rev = "main" }
+source = { project_path = "../" }
 host = "127.0.0.1"
 validator_port = 6182
 vfn_port = 6192

cluster/example/3_node_1_vfn/cluster.toml

@@ -13,7 +13,7 @@ waypoint_path = "./output/waypoint.txt"
 [[nodes]]
 id = "node1"
 role = "genesis"
-source = { github = "Galxe/gravity-sdk", rev = "main" }
+source = { project_path = "../" }
 host = "127.0.0.1"
 validator_port = 6180
 vfn_port = 6190
@@ -27,7 +27,7 @@ reth_p2p_port = 12024
 [[nodes]]
 id = "node2"
 role = "genesis"
-source = { github = "Galxe/gravity-sdk", rev = "main" }
+source = { project_path = "../" }
 host = "127.0.0.1"
 validator_port = 6181
 vfn_port = 6191
@@ -41,7 +41,7 @@ reth_p2p_port = 12025
 [[nodes]]
 id = "node3"
 role = "genesis"
-source = { github = "Galxe/gravity-sdk", rev = "main" }
+source = { project_path = "../" }
 host = "127.0.0.1"
 validator_port = 6182
 vfn_port = 6192
@@ -55,7 +55,7 @@ reth_p2p_port = 12026
 [[nodes]]
 id = "vfn1"
 role = "vfn"
-source = { github = "Galxe/gravity-sdk", rev = "main" }
+source = { project_path = "../" }
 host = "127.0.0.1"
 vfn_port = 6193
 rpc_port = 8548

cluster/example/3_node_distinct_roles/cluster.toml

@@ -12,7 +12,7 @@ waypoint_path = "./output/waypoint.txt"
 [[nodes]]
 id = "node1"
 role = "genesis"
-source = { github = "Galxe/gravity-sdk", rev = "main" }
+source = { project_path = "../" }
 host = "127.0.0.1"
 validator_port = 6180
 vfn_port = 6190
@@ -26,7 +26,7 @@ reth_p2p_port = 12024
 [[nodes]]
 id = "node2"
 role = "genesis"
-source = { github = "Galxe/gravity-sdk", rev = "main" }
+source = { project_path = "../" }
 host = "127.0.0.1"
 validator_port = 6181
 vfn_port = 6191
@@ -40,7 +40,7 @@ reth_p2p_port = 12025
 [[nodes]]
 id = "node3"
 role = "genesis"
-source = { github = "Galxe/gravity-sdk", rev = "main" }
+source = { project_path = "../" }
 host = "127.0.0.1"
 validator_port = 6182
 vfn_port = 6192