feat: publish durable queue and spool gauges

internal/client/spool/telemetry.go

@@ -0,0 +1,34 @@
+package spool
+
+import (
+	"context"
+	"errors"
+
+	rvboxv1 "github.com/rvbox/rvbox/gen/go/rvbox/v1"
+)
+
+// Telemetry is the bounded durable-spool state exposed as client gauges. It
+// contains no command body, output, UUID, or client identity.
+type Telemetry struct {
+	QueuedCommands uint64
+	ChargedBytes   uint64
+}
+
+func (store *Store) Telemetry(ctx context.Context) (Telemetry, error) {
+	if store == nil {
+		return Telemetry{}, errors.New("client spool is unavailable")
+	}
+	store.mu.Lock()
+	defer store.mu.Unlock()
+	if store.db == nil {
+		return Telemetry{}, errors.New("client spool is closed")
+	}
+	var result Telemetry
+	if err := store.db.QueryRowContext(ctx, `SELECT count(*) FROM commands WHERE terminal = 0 AND phase IN (?, ?)`, uint32(rvboxv1.CommandLifecycle_COMMAND_QUEUED), uint32(rvboxv1.CommandLifecycle_COMMAND_DISPATCHED)).Scan(&result.QueuedCommands); err != nil {
+		return Telemetry{}, err
+	}
+	if err := store.db.QueryRowContext(ctx, `SELECT client_total_charged_bytes FROM spool_counters WHERE singleton = 1`).Scan(&result.ChargedBytes); err != nil {
+		return Telemetry{}, err
+	}
+	return result, nil
+}

internal/client/spool/telemetry_test.go

@@ -0,0 +1,22 @@
+package spool
+
+import (
+	"context"
+	"path/filepath"
+	"testing"
+	"time"
+)
+
+func TestTelemetryReportsQueuedDurableSpool_HP_OPS_07(t *testing.T) {
+	t.Parallel()
+	ctx := context.Background()
+	store := openTestStore(t, ctx, filepath.Join(t.TempDir(), "spool"), DefaultTombstoneLimit)
+	issue := testUUID(t, "019c46f1-1d02-7000-8000-0000000000d2")
+	if _, err := store.AcceptCommand(ctx, testCommand(issue, []byte("telemetry")), time.Now().UTC()); err != nil {
+		t.Fatal(err)
+	}
+	telemetry, err := store.Telemetry(ctx)
+	if err != nil || telemetry.QueuedCommands != 1 || telemetry.ChargedBytes == 0 {
+		t.Fatalf("telemetry = %#v, %v", telemetry, err)
+	}
+}