Files
sanderling/internal/verifier/verifier_test.go
T
pj 7493945251 feat: LTL operators, sampling, and default generators (#17)
* feat(ltl): add Now/Next/Eventually/Implies/Or/And/Not formulas

Replace the fold-with-latch evaluator with a residual-formula reducer.
Each Observe() instantiates a fresh obligation from the root (stripping
an outer Always), reduces each pending obligation against current state,
latches Violated on first failure, and surfaces Pending verdicts for
deferred obligations. Existing Always/Pure/Thunk tests continue to pass.

* feat(ltl): support relative duration for eventually().within()

* feat(proto): add Swipe, PressKey, RecentLogs RPCs

* feat(verifier,runner): formula handles, new action kinds, rich state

- verifier: add formula-spec registry; bindNow/bindNext/bindEventually with
  chainable .implies/.or/.and/.not and .within(n,unit) on eventually; bindFrom
  for uniform sampling. bindAlways keeps accepting plain predicates.
- verifier: store lastTree, lastAction, step time, logs, exceptions on the
  Verifier; SnapshotInput replaces the (snapshots, tree) pair. stateObject now
  produces state.lastAction/time/logs/exceptions matching the TS State type.
- verifier: make taps/swipes/waitOnce/pressKey built-in generators actually
  fire; taps picks a clickable, enabled element from the last hierarchy.
- agent: add exceptions field to Message wire format.
- driver: add Swipe/PressKey/RecentLogs to Driver interface; wire maestro
  client and mock driver. LogEntry exposed for runner consumption.
- runner: apply Swipe/PressKey/Wait actions; collect logcat and exceptions;
  pass lastAction and step time into PushSnapshot.

* feat(spec-api): LTL operators, new actions, richer State

- ltl.ts exports now/next/eventually; always overload accepts a Formula
- types.ts: Formula gains implies/or/and/not; EventuallyFormula adds .within;
  State gains lastAction/time/logs/exceptions; Swipe/PressKey/Wait action types
- actions.ts: Swipe/PressKey/Wait/from constructors; waitOnce + pressKey
  default generators
- tests exercise the chaining, sampling, and new actions through a recorded
  fake runtime

* feat(sidecar): add swipe, pressKey, recentLogs RPC handlers

* feat(sdk-android): capture uncaught exceptions

Install a default uncaught handler on Uatu.start, chained with any
existing handler so Android's crash reporter still runs. Expose
Uatu.reportError for callers to forward caught throwables. A bounded
circular buffer (default 50) drains into each STATE message's new
exceptions field. Protocol.kt serializes/deserializes the field,
matching the Go wire format added to internal/agent/protocol.go.

* feat(spec-api): add @uatu/spec/defaults/properties bundle

* feat(sample-app): exercise new LTL operators + defaults

spec.ts now imports eventually/next/now/from from @uatu/spec and
noUncaughtExceptions from @uatu/spec/defaults/properties. It declares
three properties that exercise the new surface:

- accountCountNonNegative: plain always() safety
- addAccountAdvances: always(now(x).implies(next(y)))
- eventuallyLoggedIn: eventually(p).within(30, "seconds")
- noUncaughtExceptions: imported default

The weighted actions root uses from() for random phone/name sampling
and entries for taps/swipes/waitOnce/pressKey built-ins.

SampleApplication gains a debug hook gated on the system property
uatu.inject_error so the e2e run can synthesize an Uatu.reportError and
verify noUncaughtExceptions violates.

cmd/uatu/test_run.go adds a subpath alias so specs importing
"@uatu/spec/defaults/properties" resolve against the in-tree source
when running from the uatu checkout. The spec-integration tests swap
the old click-counter fixtures for the new login hierarchy.

* feat(trace): record swipe/key/wait details + exceptions

trace.Step gains an Exceptions array so the trace captures the
class/message/stackTrace for each SDK-reported throwable in a step.
trace.Action gains FromX/FromY/ToX/ToY/Key/DurationMillis so the full
payload of Swipe/PressKey/Wait actions is visible in trace.jsonl.

sample-app's debug error hook now gates on ApplicationInfo.DEBUGGABLE
instead of a system property (adb setprop fails on non-rooted
emulators).
2026-04-20 02:19:39 +07:00

234 lines
6.6 KiB
Go

package verifier
import (
"encoding/json"
"errors"
"math/rand/v2"
"strings"
"testing"
"github.com/priyanshujain/uatu/internal/ltl"
)
func newVerifier(t *testing.T, options ...Option) *Verifier {
t.Helper()
verifier, err := New(options...)
if err != nil {
t.Fatal(err)
}
return verifier
}
func mustLoad(t *testing.T, verifier *Verifier, source string) {
t.Helper()
if err := verifier.Load(source); err != nil {
t.Fatalf("Load: %v", err)
}
}
const helloSpec = `
const screen = __uatu__.extract(state => state.snapshots.screen ?? "");
const balance = __uatu__.extract(state => state.snapshots["ledger.balance"] ?? 0);
globalThis.screen = screen;
globalThis.balance = balance;
globalThis.properties = {
balanceNonNegative: __uatu__.always(() => balance.current >= 0),
};
globalThis.actions = __uatu__.actions(() => [
__uatu__.tap({ on: "id:home_button" }),
]);
`
func TestLoad_ExposesRuntimeBindings(t *testing.T) {
verifier := newVerifier(t)
mustLoad(t, verifier, helloSpec)
if len(verifier.extractors) != 2 {
t.Errorf("extractors registered: got %d, want 2", len(verifier.extractors))
}
if len(verifier.formulas) != 1 {
t.Errorf("formulas registered: got %d, want 1", len(verifier.formulas))
}
if _, ok := verifier.properties["balanceNonNegative"]; !ok {
t.Errorf("balanceNonNegative property missing: %+v", verifier.properties)
}
}
func TestPushSnapshot_UpdatesExtractorCurrentAndPrevious(t *testing.T) {
verifier := newVerifier(t)
mustLoad(t, verifier, helloSpec)
if err := verifier.PushSnapshot(SnapshotInput{Snapshots: Snapshots{
"screen": json.RawMessage(`"customer_ledger"`),
"ledger.balance": json.RawMessage(`1500`),
}}); err != nil {
t.Fatal(err)
}
screenValue := verifier.runtime.GlobalObject().Get("screen").ToObject(verifier.runtime)
if screenValue.Get("current").String() != "customer_ledger" {
t.Errorf("screen.current wrong: %v", screenValue.Get("current"))
}
balanceValue := verifier.runtime.GlobalObject().Get("balance").ToObject(verifier.runtime)
if balanceValue.Get("current").ToInteger() != 1500 {
t.Errorf("balance.current wrong: %v", balanceValue.Get("current"))
}
// Push again: previous should mirror the prior current.
if err := verifier.PushSnapshot(SnapshotInput{Snapshots: Snapshots{"ledger.balance": json.RawMessage(`2000`)}}); err != nil {
t.Fatal(err)
}
balanceValue = verifier.runtime.GlobalObject().Get("balance").ToObject(verifier.runtime)
if balanceValue.Get("previous").ToInteger() != 1500 {
t.Errorf("balance.previous wrong: %v", balanceValue.Get("previous"))
}
if balanceValue.Get("current").ToInteger() != 2000 {
t.Errorf("balance.current wrong: %v", balanceValue.Get("current"))
}
}
func TestEvaluateProperties_HoldsThenViolates(t *testing.T) {
verifier := newVerifier(t)
mustLoad(t, verifier, helloSpec)
cases := []struct {
balance int
want ltl.Verdict
}{
{1500, ltl.VerdictHolds},
{0, ltl.VerdictHolds},
{-1, ltl.VerdictViolated},
{500, ltl.VerdictViolated}, // sticky
}
for index, testCase := range cases {
raw, _ := json.Marshal(testCase.balance)
if err := verifier.PushSnapshot(SnapshotInput{Snapshots: Snapshots{"ledger.balance": raw}}); err != nil {
t.Fatal(err)
}
verdicts := verifier.EvaluateProperties()
if got := verdicts["balanceNonNegative"]; got != testCase.want {
t.Errorf("step %d (balance=%d): got %v, want %v", index, testCase.balance, got, testCase.want)
}
}
}
func TestNextAction_FromActionsGenerator(t *testing.T) {
verifier := newVerifier(t)
mustLoad(t, verifier, helloSpec)
_ = verifier.PushSnapshot(SnapshotInput{Snapshots: Snapshots{}})
action, err := verifier.NextAction()
if err != nil {
t.Fatal(err)
}
if action.Kind != ActionKindTap {
t.Errorf("kind: got %v, want Tap", action.Kind)
}
if action.On != "id:home_button" {
t.Errorf("selector: got %q, want id:home_button", action.On)
}
}
func TestNextAction_WeightedSelectsByWeight(t *testing.T) {
verifier := newVerifier(t, WithRand(rand.New(rand.NewPCG(42, 0))))
mustLoad(t, verifier, `
const tapHome = __uatu__.actions(() => [__uatu__.tap({ on: "id:home" })]);
const tapAway = __uatu__.actions(() => [__uatu__.tap({ on: "id:away" })]);
globalThis.actions = __uatu__.weighted(
[1, tapHome],
[99, tapAway],
);
`)
_ = verifier.PushSnapshot(SnapshotInput{Snapshots: Snapshots{}})
awayCount := 0
homeCount := 0
for range 200 {
action, err := verifier.NextAction()
if err != nil {
t.Fatal(err)
}
switch action.On {
case "id:home":
homeCount++
case "id:away":
awayCount++
}
}
if awayCount <= homeCount {
t.Errorf("expected away-skewed distribution, got home=%d away=%d", homeCount, awayCount)
}
}
func TestNextAction_EmptyGeneratorReturnsErrNoAction(t *testing.T) {
verifier := newVerifier(t)
mustLoad(t, verifier, `
globalThis.actions = __uatu__.actions(() => []);
`)
_ = verifier.PushSnapshot(SnapshotInput{Snapshots: Snapshots{}})
_, err := verifier.NextAction()
if !errors.Is(err, ErrNoAction) {
t.Errorf("expected ErrNoAction, got %v", err)
}
}
func TestInputText_RoundTrip(t *testing.T) {
verifier := newVerifier(t)
mustLoad(t, verifier, `
globalThis.actions = __uatu__.actions(() => [
__uatu__.inputText({ into: "id:phone", text: "+919876543210" }),
]);
`)
_ = verifier.PushSnapshot(SnapshotInput{Snapshots: Snapshots{}})
action, err := verifier.NextAction()
if err != nil {
t.Fatal(err)
}
if action.Kind != ActionKindInputText {
t.Errorf("kind: %v", action.Kind)
}
if action.On != "id:phone" || action.Text != "+919876543210" {
t.Errorf("payload wrong: %+v", action)
}
}
func TestPushSnapshot_FeedsSnapshotsToExtractorState(t *testing.T) {
verifier := newVerifier(t)
mustLoad(t, verifier, `
globalThis.captured = __uatu__.extract(state => state.snapshots["k"]);
`)
if err := verifier.PushSnapshot(SnapshotInput{Snapshots: Snapshots{"k": json.RawMessage(`"hello"`)}}); err != nil {
t.Fatal(err)
}
value := verifier.runtime.GlobalObject().Get("captured").ToObject(verifier.runtime).Get("current")
if value.String() != "hello" {
t.Errorf("snapshot value not propagated: %v", value)
}
}
func TestLoad_PropagatesSyntaxError(t *testing.T) {
verifier := newVerifier(t)
err := verifier.Load(`const x = ;`)
if err == nil || !strings.Contains(err.Error(), "run spec") {
t.Errorf("expected run-spec error, got %v", err)
}
}
func TestLoad_AcceptsSpecWithoutPropertiesOrActions(t *testing.T) {
verifier := newVerifier(t)
if err := verifier.Load(`const noop = 1;`); err != nil {
t.Fatal(err)
}
if got := verifier.EvaluateProperties(); len(got) != 0 {
t.Errorf("no properties expected, got %v", got)
}
if _, err := verifier.NextAction(); !errors.Is(err, ErrNoAction) {
t.Errorf("expected ErrNoAction, got %v", err)
}
}