chore: establish local platform baseline

cmd/mock-provider/main.go

@@ -0,0 +1,76 @@
+package main
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"log/slog"
+	"net/http"
+	"os"
+	"os/signal"
+	"strconv"
+	"syscall"
+	"time"
+
+	"data-terminal-cloud/internal/mockprovider"
+)
+
+func main() {
+	ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
+	defer stop()
+	logger := slog.New(slog.NewJSONHandler(os.Stdout, nil)).With("service", "mock-provider")
+	if err := run(ctx, logger); err != nil {
+		logger.Error("mock provider stopped", "error", err)
+		os.Exit(1)
+	}
+}
+
+func run(ctx context.Context, logger *slog.Logger) error {
+	duplicates, err := strconv.Atoi(env("MOCK_PROVIDER_DUPLICATE_CALLBACKS", "2"))
+	if err != nil {
+		return fmt.Errorf("invalid duplicate callback count: %w", err)
+	}
+	delay, err := time.ParseDuration(env("MOCK_PROVIDER_START_DELAY", "100ms"))
+	if err != nil {
+		return fmt.Errorf("invalid start delay: %w", err)
+	}
+	provider, err := mockprovider.New(mockprovider.Options{
+		APIKey:         env("MOCK_PROVIDER_API_KEY", "local-mock-provider-key"),
+		CallbackURL:    env("MOCK_PROVIDER_CALLBACK_URL", "http://localhost:58081/callbacks/v1/vertc/voice-chat"),
+		CallbackSecret: env("PROVIDER_CALLBACK_SECRET", "local-provider-callback-secret-32-bytes-minimum"),
+		StartDelay:     delay, DuplicateCallbacks: duplicates,
+	}, logger)
+	if err != nil {
+		return fmt.Errorf("create mock provider: %w", err)
+	}
+	server := &http.Server{
+		Addr: env("HTTP_ADDR", "0.0.0.0:59200"), Handler: provider.Handler(),
+		ReadHeaderTimeout: 5 * time.Second, ReadTimeout: 10 * time.Second,
+		WriteTimeout: 10 * time.Second, IdleTimeout: 30 * time.Second,
+	}
+	serverError := make(chan error, 1)
+	go func() {
+		logger.Info("mock provider listening", "address", server.Addr)
+		serverError <- server.ListenAndServe()
+	}()
+	select {
+	case <-ctx.Done():
+		shutdownContext, cancel := context.WithTimeout(context.Background(), 5*time.Second)
+		defer cancel()
+		if err := server.Shutdown(shutdownContext); err != nil {
+			return fmt.Errorf("shutdown mock provider: %w", err)
+		}
+	case err := <-serverError:
+		if err != nil && !errors.Is(err, http.ErrServerClosed) {
+			return err
+		}
+	}
+	return nil
+}
+
+func env(key, fallback string) string {
+	if value := os.Getenv(key); value != "" {
+		return value
+	}
+	return fallback
+}

cmd/mock-provider/main_test.go

@@ -0,0 +1,45 @@
+package main
+
+import (
+	"context"
+	"io"
+	"log/slog"
+	"strings"
+	"testing"
+	"time"
+)
+
+func TestRunValidatesConfiguration(t *testing.T) {
+	logger := slog.New(slog.NewJSONHandler(io.Discard, nil))
+	t.Setenv("MOCK_PROVIDER_DUPLICATE_CALLBACKS", "invalid")
+	if err := run(context.Background(), logger); err == nil || !strings.Contains(err.Error(), "duplicate callback") {
+		t.Fatalf("duplicate validation error=%v", err)
+	}
+	t.Setenv("MOCK_PROVIDER_DUPLICATE_CALLBACKS", "2")
+	t.Setenv("MOCK_PROVIDER_START_DELAY", "invalid")
+	if err := run(context.Background(), logger); err == nil || !strings.Contains(err.Error(), "start delay") {
+		t.Fatalf("delay validation error=%v", err)
+	}
+}
+
+func TestRunStartsAndShutsDown(t *testing.T) {
+	logger := slog.New(slog.NewJSONHandler(io.Discard, nil))
+	t.Setenv("HTTP_ADDR", "127.0.0.1:0")
+	t.Setenv("MOCK_PROVIDER_START_DELAY", "1ms")
+	t.Setenv("MOCK_PROVIDER_DUPLICATE_CALLBACKS", "1")
+	ctx, cancel := context.WithTimeout(context.Background(), 100*time.Millisecond)
+	defer cancel()
+	if err := run(ctx, logger); err != nil {
+		t.Fatalf("provider lifecycle: %v", err)
+	}
+}
+
+func TestEnvUsesValueAndFallback(t *testing.T) {
+	t.Setenv("MOCK_PROVIDER_TEST_VALUE", "configured")
+	if got := env("MOCK_PROVIDER_TEST_VALUE", "fallback"); got != "configured" {
+		t.Fatalf("value=%q", got)
+	}
+	if got := env("MOCK_PROVIDER_MISSING_VALUE", "fallback"); got != "fallback" {
+		t.Fatalf("fallback=%q", got)
+	}
+}