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.
This commit is contained in:
pj authored and GitHub committed 2026-04-21 11:57:49 +07:00
1 parent 13bb2feb82
commit 8ccf95c1cf
111 files changed
+514 -514

No files matched your search

@@ -1,4 +1,4 @@
package dev.uatu.sdk
package dev.sanderling.sdk
import android.os.Handler
import android.os.Looper
@@ -1,4 +1,4 @@
package dev.uatu.sdk
package dev.sanderling.sdk
import java.io.PrintWriter
import java.io.StringWriter
@@ -1,4 +1,4 @@
package dev.uatu.sdk
package dev.sanderling.sdk
import android.net.LocalSocket
import android.net.LocalSocketAddress
@@ -1,4 +1,4 @@
package dev.uatu.sdk
package dev.sanderling.sdk
import java.util.concurrent.CountDownLatch
import java.util.concurrent.Semaphore
@@ -1,4 +1,4 @@
package dev.uatu.sdk
package dev.sanderling.sdk
import java.io.DataInputStream
import java.io.DataOutputStream
@@ -1,24 +1,24 @@
package dev.uatu.sdk
package dev.sanderling.sdk
import android.app.Application
import android.util.Log
data class Configuration(
val socketName: String = "uatu-agent",
val socketName: String = "sanderling-agent",
val pauseTimeoutMillis: Long = 5_000L,
)
object Uatu {
object Sanderling {
const val VERSION: String = "0.0.1"
private const val LOG_TAG = "Uatu"
private const val LOG_TAG = "Sanderling"
@Volatile private var runtime: UatuRuntime? = null
@Volatile private var runtime: SanderlingRuntime? = null
@JvmOverloads
@Synchronized
fun start(application: Application, configuration: Configuration = Configuration()) {
if (runtime != null) return
val newRuntime = UatuRuntime(
val newRuntime = SanderlingRuntime(
transport = LocalAbstractTransport(configuration.socketName),
pauser = Pauser(ChoreographerPoster(), configuration.pauseTimeoutMillis),
version = VERSION,
@@ -32,7 +32,7 @@ object Uatu {
fun extract(name: String, function: () -> Any?) {
val activeRuntime = runtime
?: throw IllegalStateException("Uatu.start must be called before registering extractors")
?: throw IllegalStateException("Sanderling.start must be called before registering extractors")
activeRuntime.register(name, function)
}
@@ -1,8 +1,8 @@
package dev.uatu.sdk
package dev.sanderling.sdk
import android.util.Log
internal class UatuRuntime(
internal class SanderlingRuntime(
transport: AgentTransport,
private val pauser: Pauser,
private val version: String,
@@ -45,7 +45,7 @@ internal class UatuRuntime(
private inner class AgentHandler : SocketClient.Handler {
override fun onConnected(sender: SocketClient.MessageSender) {
this@UatuRuntime.sender = sender
this@SanderlingRuntime.sender = sender
try {
sender.send(Message.hello(version, platform, appPackage))
} catch (cause: Exception) {
@@ -92,6 +92,6 @@ internal class UatuRuntime(
}
companion object {
private const val LOG_TAG = "Uatu"
private const val LOG_TAG = "Sanderling"
}
}
@@ -1,4 +1,4 @@
package dev.uatu.sdk
package dev.sanderling.sdk
import java.io.IOException
import java.io.InputStream
@@ -30,7 +30,7 @@ class SocketClient(
private val transport: AgentTransport,
private val handler: Handler,
private val backoff: Backoff = Backoff(),
private val threadFactory: (Runnable) -> Thread = { runnable -> Thread(runnable, "uatu-agent-reader") },
private val threadFactory: (Runnable) -> Thread = { runnable -> Thread(runnable, "sanderling-agent-reader") },
private val sleeper: (Long) -> Unit = { millis -> if (millis > 0L) Thread.sleep(millis) },
) {
interface Handler {
@@ -1,4 +1,4 @@
package dev.uatu.sdk
package dev.sanderling.sdk
import org.junit.Assert.assertEquals
import org.junit.Assert.assertTrue
@@ -1,4 +1,4 @@
package dev.uatu.sdk
package dev.sanderling.sdk
import java.util.concurrent.CountDownLatch
import java.util.concurrent.Executors
@@ -1,4 +1,4 @@
package dev.uatu.sdk
package dev.sanderling.sdk
import java.io.ByteArrayInputStream
import java.io.ByteArrayOutputStream
@@ -1,4 +1,4 @@
package dev.uatu.sdk
package dev.sanderling.sdk
import java.util.concurrent.CopyOnWriteArrayList
import java.util.concurrent.CountDownLatch
@@ -12,22 +12,22 @@ import org.junit.Assert.assertNotNull
import org.junit.Assert.assertTrue
import org.junit.Test
class UatuRuntimeTest {
class SanderlingRuntimeTest {
private lateinit var transport: SocketClientTest.FakeTransport
private lateinit var frameThread: PauserTest.FakeFrameThread
private lateinit var runtime: UatuRuntime
private lateinit var runtime: SanderlingRuntime
private fun newRuntime(): UatuRuntime {
private fun newRuntime(): SanderlingRuntime {
transport = SocketClientTest.FakeTransport()
frameThread = PauserTest.FakeFrameThread()
val pauser = Pauser(frameThread, pauseTimeoutMillis = 2_000L)
return UatuRuntime(
return SanderlingRuntime(
transport = transport,
pauser = pauser,
version = "0.0.1",
platform = "android",
appPackage = "com.example.uatu_test",
appPackage = "com.example.sanderling_test",
).also { runtime = it }
}
@@ -43,7 +43,7 @@ class UatuRuntimeTest {
assertEquals(MessageType.HELLO, hello.type)
assertEquals("0.0.1", hello.version)
assertEquals("android", hello.platform)
assertEquals("com.example.uatu_test", hello.appPackage)
assertEquals("com.example.sanderling_test", hello.appPackage)
}
@Test fun pauseTriggersExtractorsAndReturnsState() {
@@ -1,4 +1,4 @@
package dev.uatu.sdk
package dev.sanderling.sdk
import java.io.IOException
import java.io.PipedInputStream