test(demo): add compose status inspector

Author: AlisinaDevelo

CHANGELOG.md

@@ -7,6 +7,7 @@ All notable changes to StreamHive are documented here. This project follows [Sem
 ### Added
 
 - **Ops**: `/peers` JSON endpoint for inspecting active peer addresses and connection direction.
+- **Demo**: `make demo-status` prints each Compose node's peers, metrics, and durable keys.
 
 ## [0.5.0] — 2026-07-01
 

Makefile

@@ -1,4 +1,4 @@
-.PHONY: build run test test-race vet cover lint demo-replication demo-compose demo-repair ci help
+.PHONY: build run test test-race vet cover lint demo-replication demo-compose demo-repair demo-status ci help
 
 build:
 	@mkdir -p bin
@@ -32,7 +32,10 @@ demo-compose:
 demo-repair:
 	@./scripts/demo-repair.sh
 
+demo-status:
+	@./scripts/demo-status.sh
+
 ci: vet test-race lint
 
 help:
-	@echo "Targets: build run test test-race vet cover lint demo-replication demo-compose demo-repair ci"
+	@echo "Targets: build run test test-race vet cover lint demo-replication demo-compose demo-repair demo-status ci"

README.md

@@ -64,6 +64,12 @@ For a 3-node Docker Compose demo with durable stores and node restart rehydratio
 make demo-compose
 ```
 
+To inspect a running Compose cluster:
+
+```bash
+make demo-status
+```
+
 For a 3-node corruption repair demo that deletes node3's durable blob and waits for periodic anti-entropy to restore it:
 
 ```bash

docs/DEPLOYMENT.md

@@ -26,6 +26,14 @@ make demo-compose
 
 The demo builds `streamhive:local`, starts node1, seeds one blob, starts node2 and node3, verifies node3 receives the blob, wipes node3's local demo data, restarts node3, and verifies startup anti-entropy rehydrates the blob again.
 
+Inspect a running Compose cluster:
+
+```bash
+make demo-status
+```
+
+The status command prints each node's `/peers`, `/metrics`, and durable store keys.
+
 Run the corruption repair demo:
 
 ```bash

scripts/demo-compose.sh

@@ -80,3 +80,4 @@ echo "3-node compose demo passed: node3 rehydrated the blob after restart"
 echo "rehydrated key: $EXPECTED_KEY"
 curl -fsS http://127.0.0.1:18083/metrics
 echo
+"$ROOT_DIR/scripts/demo-status.sh"

scripts/demo-status.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env sh
+set -eu
+
+ROOT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)"
+DATA_DIR="${STREAMHIVE_DATA_DIR:-$ROOT_DIR/.streamhive-compose}"
+COMPOSE="docker compose"
+export STREAMHIVE_DATA_DIR="$DATA_DIR"
+
+print_node() {
+	name="$1"
+	url="$2"
+
+	echo "== $name =="
+	echo "-- peers --"
+	curl -fsS "$url/peers"
+	echo
+	echo "-- metrics --"
+	curl -fsS "$url/metrics"
+	echo
+	echo "-- durable keys --"
+	keys="$($COMPOSE -f "$ROOT_DIR/docker-compose.yml" --profile tools run --rm --no-deps -v "$DATA_DIR/$name:/data" seed -store-dir /data -list-keys)"
+	if [ -n "$keys" ]; then
+		printf '%s\n' "$keys" | sed 's/^/  /'
+	else
+		echo "  (none)"
+	fi
+	echo
+}
+
+print_node node1 http://127.0.0.1:18081
+print_node node2 http://127.0.0.1:18082
+print_node node3 http://127.0.0.1:18083