refactor: rename project uatu -> sanderling (#24)

* refactor: rename Go module path uatu -> sanderling

Module path github.com/priyanshujain/uatu -> github.com/priyanshujain/sanderling,
including all imports and the proto go_package option. Generated .pb.go files
rewritten in-place; safe to regenerate with protoc later.

* chore(proto): regenerate driverpb after module path rename

The previous sed-based module rename corrupted the embedded descriptor
byte lengths. buf generate rewrites them cleanly.

* refactor: rename CLI binary uatu -> sanderling

Updates Makefile target + UATU_BIN var, .goreleaser project/build IDs,
.gitignore comment, and all user-facing strings in the CLI help text,
error messages, and tests. Binary is now bin/sanderling.

* refactor(sdk): rename Kotlin package dev.uatu.sdk -> dev.sanderling.sdk

Moves sdk/android/src/{main,test}/kotlin/dev/uatu -> dev/sanderling and
rewrites package declarations, imports, and the Gradle namespace. Class
names (Uatu, UatuRuntime) are renamed in a follow-up commit.

* refactor(sidecar): rename Kotlin package dev.uatu.sidecar -> dev.sanderling.sidecar

Moves sidecar/src/{main,test}/kotlin/dev/uatu -> dev/sanderling and
rewrites package declarations, imports, and the application mainClass.

* refactor: rename Uatu API surface -> Sanderling

- Kotlin: Uatu -> Sanderling, UatuRuntime -> SanderlingRuntime (+ files).
- JS host binding: globalThis.__uatu__ -> __sanderling__ (Go verifier,
  spec-api, tests).
- TS interface: UatuRuntime -> SanderlingRuntime; internal tags
  __uatuFormula / __uatuActionGenerator -> __sanderling* variants.
- Go trace: UatuVersion field + uatu_version JSON tag renamed.
- Socket naming: uatu-agent / uatu-agent-reader -> sanderling-agent*.
- Sample app, docs, inline-JS test strings updated to match.

* refactor(examples): rename examples/folio/uatu -> examples/folio/sanderling

Renames the example spec directory; updates justfile paths + gitignore
entries accordingly. Package.json name/description and @uatu/spec
dependency are renamed in the npm + docs commits.

* chore(build): rename gradle property + rootProject.name uatu -> sanderling

- Renames the uatu.version gradle property and all its -P references in
  Makefile, build.gradle.kts files, and .github/workflows/release.yml.
- settings.gradle.kts rootProject.name = "sanderling".
- Renames .env.local.example header + release-cli workflow job name.

* refactor(proto): rename proto package uatu.driver.v1 -> sanderling.driver.v1

Updates the proto package and java_package, regenerates driver.pb.go +
driver_grpc.pb.go, rewrites Kotlin imports and the gRPC ServiceName
assertion in driver_test.go.

* refactor: rename npm package @uatu/spec -> @sanderling/spec

Renames package name in pkg/spec-api/package.json + lockfile, all
consumer imports (examples/folio spec, testdata, verifier tests), the
esbuild alias in cmd/sanderling/test_run.go, and related doc references.

* docs: rename uatu -> sanderling in README, docs, and URLs

- README + docs/{manual,development}/*: narrative + GitHub + Pages URLs.
- POM + npm package.json repo/homepage/bugs URLs.
- .gitignore + embed_stub + Makefile-comment references updated to
  'make sanderling'.
- Minor narrative comments in cmd/sanderling/test_run.go and
  internal/inspect/server.go.

* refactor: rename remaining internal uatu strings -> sanderling

- SANDERLING_TEST_PHONE/OTP env vars (cmd + bundler tests).
- sanderling-sidecar runtime tmp dir + extracted JAR filename.
- Inspect web UI: @sanderling/inspect-web package, title, theme
  localStorage key, RunList empty-state copy, uatu_version TS field.
- Sample app storage key sanderling.ledger.v1.
- Test data: sanderling_test AVD name + com.example.sanderling_test.
- Release docs tarball name template.

cmd/sanderling/main.go

@@ -0,0 +1,112 @@
+package main
+
+import (
+	"context"
+	"errors"
+	"flag"
+	"fmt"
+	"io"
+	"os"
+	"time"
+)
+
+// Version is stamped at build time via goreleaser ldflags.
+// Default "dev" marks untagged local builds.
+var Version = "dev"
+
+type testOptions struct {
+	spec             string
+	bundleID         string
+	launcherActivity string
+	platform         string
+	avd              string
+	duration         time.Duration
+	seed             int64
+	output           string
+}
+
+const topUsage = `sanderling is a property-based UI fuzzer for mobile apps.
+
+Usage:
+  sanderling <command> [flags]
+
+Commands:
+  test     Run a spec against an app for a fixed duration.
+  inspect  Serve a local web UI for browsing runs/.
+  doctor   Check that the host environment is ready to run sanderling.
+  version  Print the sanderling version.
+
+Run "sanderling <command> -h" for command-specific flags.
+`
+
+func parseTestArgs(args []string, stderr io.Writer) (testOptions, error) {
+	flagSet := flag.NewFlagSet("test", flag.ContinueOnError)
+	flagSet.SetOutput(stderr)
+	var options testOptions
+	flagSet.StringVar(&options.spec, "spec", "", "path to the TypeScript spec (required)")
+	flagSet.StringVar(&options.bundleID, "bundle-id", "", "target app bundle ID (required)")
+	flagSet.StringVar(&options.launcherActivity, "launcher-activity", "", "optional <pkg>/<activity> to launch (overrides default resolution)")
+	flagSet.StringVar(&options.platform, "platform", "android", "target platform: android (ios deferred)")
+	flagSet.StringVar(&options.avd, "avd", "", "Android AVD name to boot if no device is connected")
+	flagSet.DurationVar(&options.duration, "duration", 5*time.Minute, "total test duration")
+	flagSet.Int64Var(&options.seed, "seed", 0, "RNG seed (0 = random)")
+	flagSet.StringVar(&options.output, "output", "./runs", "output directory for traces")
+	if err := flagSet.Parse(args); err != nil {
+		return testOptions{}, err
+	}
+	if options.spec == "" {
+		return testOptions{}, errors.New("--spec is required")
+	}
+	if options.bundleID == "" {
+		return testOptions{}, errors.New("--bundle-id is required")
+	}
+	if options.platform != "android" {
+		return testOptions{}, fmt.Errorf("unsupported platform: %q (only android in v0.1)", options.platform)
+	}
+	return options, nil
+}
+
+func runTest(options testOptions, stdout io.Writer) error {
+	ctx, cancel := context.WithCancel(context.Background())
+	defer cancel()
+	return runTestPipeline(ctx, options, stdout)
+}
+
+func runDoctor(stdout io.Writer) error {
+	return runDoctorChecks(context.Background(), defaultDoctorChecks(), stdout)
+}
+
+func run(args []string, stdout, stderr io.Writer) error {
+	if len(args) < 2 || args[1] == "-h" || args[1] == "--help" || args[1] == "help" {
+		fmt.Fprint(stdout, topUsage)
+		return nil
+	}
+	switch args[1] {
+	case "test":
+		options, err := parseTestArgs(args[2:], stderr)
+		if err != nil {
+			return err
+		}
+		return runTest(options, stdout)
+	case "inspect":
+		options, err := parseInspectArgs(args[2:], stderr)
+		if err != nil {
+			return err
+		}
+		return runInspect(options, stdout)
+	case "doctor":
+		return runDoctor(stdout)
+	case "version", "-v", "--version":
+		fmt.Fprintln(stdout, Version)
+		return nil
+	default:
+		return fmt.Errorf("unknown command: %q (try 'sanderling help')", args[1])
+	}
+}
+
+func main() {
+	if err := run(os.Args, os.Stdout, os.Stderr); err != nil {
+		fmt.Fprintf(os.Stderr, "error: %v\n", err)
+		os.Exit(1)
+	}
+}