mav

Sep 21, 2026

Changes in this version

+ const CriterionObserved

+ func GotoObservedOptions(names []string) []string

+ func GotoObservedQuestion(goal string) string

+ func ObservedNames(menu []ObservedScreen) []string

+ func RenderObservedMenu(names []string) string

+ func ScreenShows(elements []Element) []string

type ArrivalCriterion

+ Screens []string

+ func AcceptObservedCriterion(pick ObservedScreen, initial Route) (ArrivalCriterion, bool)

type GotoResult

+ ObservedScreens []string

+ type ObservedScreen struct

+ IsTitle bool

+ Name string

+ Shows []string

+ func InterpretGotoObservedAnswer(label string, menu []ObservedScreen) (ObservedScreen, bool)

+ func ObservedScreens(recorded []ObservedScreen) []ObservedScreen

+ func RecordObservedScreen(recorded []ObservedScreen, route Route, elements []Element) []ObservedScreen

+ func (o ObservedScreen) Line() string

type Route

+ Screen string

Sep 21, 2026

Changes in this version

+ const CriterionExplicit

+ const CriterionNone

+ const GotoDeadEnd

type ArrivalCriterion

+ func (a ArrivalCriterion) String() string

type GotoResult

+ Criterion string

+ CriterionSource string

Sep 21, 2026

Changes in this version

+ func RenderScreenForVerify(elements []Element) string

+ func TextChoiceQuestion(ask string, keys []string) string

+ func VerifyQuestion(ask string) string

type Flow

+ Inputs map[string]string

type FlowStep

+ Inputs map[string]string

+ Text *FlowTextSource

+ type FlowTextSource struct

+ Ask string

+ From string

type Selector

+ Find string

+ func (s Selector) Structural() Selector

Sep 20, 2026

Changes in this version

type Element

+ func FindDismissButton(elements []Element, declared string) *Element

type GotoResult

+ Dismissed []PermissionDismissal

+ type PermissionDismissal struct

+ Action string

+ Modal string

Sep 20, 2026

Changes in this version

type CLI

+ func (c CLI) ResolveIDBIssue(ctx context.Context) (issue, next string)

type Element

+ func InterpretGotoAnswer(label string, batch []Element) (*Element, string)

Sep 19, 2026

Changes in this version

+ const GotoAmbiguousCriterion

+ const GotoArrived

+ const GotoCIRefused

+ const GotoExhausted

+ const GotoLooping

+ const GotoNoRoute

+ const GotoOutOfApp

+ const GotoRefused

+ const GotoStuck

+ const GotoTimeout

+ func GotoRefusesDestructive(el *Element) bool

+ func GotoStepQuestion(goal string) string

+ func TapPoint(el Element) (x, y int, ok bool)

+ type ArrivalCriterion struct

+ Texts []string

+ Titles []string

+ func ParseArrivalCriterion(spec string) ArrivalCriterion

+ func (a ArrivalCriterion) IsZero() bool

+ func (a ArrivalCriterion) MatchesRoute(route Route, elements []Element) bool

+ type GotoResult struct

+ Arrived string

+ Goal string

+ Next string

+ Outcome string

+ Refused *Element

+ RouteFinal Route

+ RouteInitial Route

+ Steps []GotoStep

+ type GotoStep struct

+ Changed bool

+ Reason string

+ ResolvedBy string

+ RouteAfter Route

+ RouteBefore Route

+ Tapped *Element

type Route

+ Modal string

+ Tab string

+ Title string

+ func ExtractRoute(elements []Element) Route

+ func (r Route) IsZero() bool

+ func (r Route) String() string

+ type SeenRoutes struct

+ func NewSeenRoutes() *SeenRoutes

+ func (s *SeenRoutes) Visit(fingerprint string) bool

Sep 19, 2026

Changes in this version

+ type FindCost struct

+ LocalMS int64

+ ModelMS int64

+ TotalMS int64

+ TreeMS int64

type FindResult

+ Cost FindCost

Sep 19, 2026

Changes in this version

type PersistedTree

+ TreePath string

Sep 19, 2026

Changes in this version

+ const ReasonAbstained

+ const ReasonCIRefused

+ const ReasonDestructiveGuard

+ const ReasonNoCandidates

+ const ReasonNoKey

+ const ReasonNoNetwork

+ const ReasonNotACandidate

+ const ResolvedByLiteral

+ const ResolvedByModel

+ const ResolvedByNone

+ func FindOptions(batch []Element) []string

+ func FindQuestion(goal string) string

+ func IsDestructive(text string) bool

+ func JevKeyConfigPath() string

+ func MissingJevKeyNext() string

+ func RenderFindCandidates(batch []Element) string

+ func StoreJevKey(key string) (string, error)

+ func VetoChoice(chosen *Element, goal string, candidates []Element) string

type Element

+ func FindBatch(candidates []Element) (batch []Element, omitted int)

+ func FindCandidates(elements []Element) []Element

+ func FindLiteral(candidates []Element, goal string) (*Element, bool)

+ func InterpretFindAnswer(verdict, label string, batch []Element) (*Element, string)

+ type FindResult struct

+ Candidates int

+ Element *Element

+ Goal string

+ KeySource string

+ Next string

+ Omitted int

+ Reason string

+ ResolvedBy string

+ Verdict string

+ type JevKeySource string

+ const JevKeyFromEnv

+ const JevKeyFromFile

+ const JevKeyFromKeychain

+ func ResolveJevKey() (string, JevKeySource, bool)

+ func (s JevKeySource) Describe() string

Sep 19, 2026

Changes in this version

+ type ConfigError struct

+ Code string

+ Fields map[string]string

+ func (e *ConfigError) Error() string

Sep 18, 2026

Changes in this version

type Config

+ TargetSource string

Aug 31, 2026

Changes in this version

type Config

+ TargetCommandRequired *bool

+ TargetCommandTimeout string

Aug 26, 2026

Changes in this version

type Capabilities

+ Kind drivers.TargetKind

Aug 25, 2026

Changes in this version

type GlobalOptions

+ Version bool

Aug 25, 2026

Changes in this version

type Config

+ VM bool

Aug 25, 2026

Changes in this version

type Capabilities

+ MacPermissions string

+ MacPermissionsNext string

type Config

+ ActiveProfile string

+ AppPath string

+ DefaultProfile string

+ Fixtures map[string][]string

+ ProfileRunner string

+ Profiles map[string]profileYAML

+ func LoadConfigRaw(root string) (Config, error)

+ func LoadConfigWithProfile(root, profileOverride string) (Config, error)

type GlobalOptions

+ Profile string

type ReportData

+ Fixture string

Aug 1, 2026

Changes in this version

type Config

+ TargetCommand string

Jul 31, 2026

Changes in this version

type CLI

+ func (c CLI) OK(cmd string, fields map[string]string) Output

Jul 3, 2026

Changes in this version

type Capabilities

+ Debug bool

+ WallClock bool

+ type CommandFailed struct

+ func (CommandFailed) Error() string

type Element

+ Selected string

+ Visible string

+ func MatchElements(elements []Element, selector Selector) ([]Element, error)

+ type FailurePolicy struct

+ Backoff float64

+ Delay string

+ MaxAttempts int

+ RetryOn []string

+ Strategy string

type Flow

+ Params map[string]FlowParam

+ type FlowAfter struct

+ Observe string

+ Wait *FlowWait

type FlowCondition

+ All []FlowCondition

+ Any []FlowCondition

+ Bounds string

+ Enabled *bool

+ Focused *bool

+ Index *int

+ Near *NearSelector

+ Not *FlowCondition

+ ParentOf *Selector

+ Role string

+ Selected *bool

+ Stable bool

+ TextContains string

+ TextRegex string

+ TextStartsWith string

+ ValueContains string

+ Visible *bool

+ func (c FlowCondition) Selector() Selector

+ type FlowCoordinate struct

+ X string

+ Y string

+ type FlowParam struct

+ Default string

+ Required bool

+ type FlowPathPoint struct

+ Duration string

+ DurationMs int

+ X int

+ Y int

type FlowStep

+ After *FlowAfter

+ All []FlowCondition

+ Not *FlowCondition

+ OnFailure FailurePolicy

+ Points []FlowPathPoint

+ Where Selector

+ type FlowWait struct

+ All []FlowCondition

+ Any []FlowCondition

+ ChangedFrom string

+ ID string

+ Not *FlowCondition

+ Stable bool

+ Text string

+ TextContains string

+ Timeout string

+ Value string

+ type NearSelector struct

+ Direction string

+ MaxDistance float64

+ Where Selector

type ReportData

+ Outputs map[string]string

+ type Selector struct

+ Bounds string

+ Enabled *bool

+ Focused *bool

+ ID string

+ Index *int

+ Near *NearSelector

+ ParentOf *Selector

+ Role string

+ Selected *bool

+ Text string

+ TextContains string

+ TextRegex string

+ TextStartsWith string

+ Value string

+ ValueContains string

+ Visible *bool

+ func (s Selector) IsZero() bool

+ func (s Selector) Validate() error

Jun 17, 2026

Changes in this version

type CommandResult

+ IDBCompanionRefreshed bool

May 21, 2026

Changes in this version

+ type NetworkEvidence struct

+ Active bool

+ HAR string

+ Issue string

+ OK bool

+ Requests int

+ Responses int

+ Status4xx int

+ Status5xx int

+ UniqueDomains int

type Output

+ func FailCode(code codes.Code, fields map[string]string) Output

type ReportData

+ Network NetworkEvidence

May 20, 2026

Changes in this version

type ReportData

+ VideoMP4 string

May 18, 2026

Changes in this version

+ const Version

May 15, 2026

Changes in this version

+ const TreesDir

+ func NewExecutor(r Runner) drivers.Executor

+ func RegisterDefaultDrivers(reg *drivers.Registry, exec drivers.Executor)

+ type AgentElement struct

+ Actionable bool

+ Enabled string

+ Focused string

+ Frame string

+ ID string

+ Label string

+ Role string

+ Subrole string

+ Title string

+ Value string

+ func AgentTree(elements []Element, opts AgentTreeOptions) []AgentElement

+ type AgentTreeOptions struct

+ Max int

+ WithFrame bool

type Capabilities

+ Multitouch bool

+ MultitouchDriver string

+ NetworkCapture bool

+ NetworkCaptureDriver string

+ type CrashSummary struct

+ AppName string

+ AppVersion string

+ BugType string

+ BundleID string

+ CrashedThread string

+ Exception string

+ IncidentID string

+ OSVersion string

+ Process string

+ Reason string

+ Termination string

+ Timestamp string

+ func ParseIPS(raw []byte) (CrashSummary, error)

+ func (s CrashSummary) OneLiner() string

type Element

+ func Compact(elements []Element) []Element

+ func ExtractElementsRaw(rawTree string) []Element

+ func LoadPersistedTree(path string) ([]Element, error)

+ type ElementChange struct

+ Diffs map[string]string

+ ID string

+ Key string

type EvidenceStep

+ DeltaPath string

+ FullPath string

+ MonotonicMs int64

+ TreeHash string

+ TreePath string

+ VideoOffsetMs int64

+ type PersistedTree struct

+ CompactPath string

+ DeltaPath string

+ FullPath string

+ Hash string

+ func PersistTree(runDir string, stepIdx int, name string, raw []Element, previous []Element) (PersistedTree, error)

+ type TreeDelta struct

+ Added []Element

+ Changed []ElementChange

+ Removed []Element

+ func TreeDiff(prev, next []Element) TreeDelta

May 15, 2026

Changes in this version

+ type ImageEvidence struct

+ Height int

+ Issue string

+ OK bool

+ Size int64

+ Width int

+ func ValidateEvidenceImage(path string) ImageEvidence

type ReportData

+ InvalidStepCount int

+ Issues []ReportIssue

+ ScreenshotEvidence ImageEvidence

+ ValidStepCount int

+ Verdict string

+ VideoDuration string

+ VideoFrames string

+ VideoStatus string

+ type ReportEvidenceStep struct

+ DisplayName string

+ Image ImageEvidence

+ Index int

+ type ReportIssue struct

+ Detail string

+ Severity string

+ Title string

May 15, 2026

Changes in this version

type RunState

+ func NewProjectRunState(root string) (RunState, error)

May 13, 2026

Changes in this version

type Config

+ TargetKind string

May 9, 2026

Changes in this version

type Element

+ Depth int

May 8, 2026

Changes in this version

type Config

+ ScreenIdentifiers map[string]string

May 8, 2026

Changes in this version

type Edge

+ Confidence string

+ FailureCount int

+ From string

+ LastFailure string

+ func RouteFrom(m AppMap, start, target string) ([]Edge, error)

May 8, 2026

Changes in this version

type Edge

+ Value string

May 8, 2026

Changes in this version

type Element

+ Focused string

May 8, 2026

Changes in this version

+ func ObserveExpectedScreenWithDriver(root string, cfg Config, run RunState, rawTree, screenID, driver string) error

type CLI

+ Stdin io.Reader

type Edge

+ Driver string

type Element

+ Enabled string

+ PID string

+ Subrole string

+ Title string

type FlowStep

+ Do []FlowStep

+ Env map[string]string

type GlobalOptions

+ PreferDriver string

type Screen

+ Driver string

type ScreenObservation

+ func ObserveScreenDetailedWithDriver(root string, cfg Config, run RunState, rawTree, driver string) (ScreenObservation, error)

May 5, 2026

Changes in this version

type Config

+ DeviceIdentifier string

+ DeviceModel string

+ DeviceName string

+ DeviceOS string

+ DeviceUDID string

+ TargetType string

+ type PhysicalDevice struct

+ Identifier string

+ Model string

+ Name string

+ OS string

+ Platform string

+ State string

+ UDID string

+ func ListPhysicalDevices(runner Runner) ([]PhysicalDevice, error)

+ func ParsePhysicalDevices(data []byte) ([]PhysicalDevice, error)

+ func SelectPhysicalDevice(devices []PhysicalDevice, id, name string) (PhysicalDevice, bool)

May 5, 2026

Changes in this version

+ type Capabilities struct

+ Accessibility bool

+ AccessibilityDriver string

+ AppiumInstall bool

+ CoordinateTap bool

+ CoordinateTapDriver string

+ DeviceFallback bool

+ DeviceFallbackDriver string

+ IDBIssue string

+ IDBNext string

+ LaunchRecipe bool

+ SemanticActions bool

+ Tools map[string]bool

type Config

+ Launch LaunchConfig

+ func SetupConfig(root string, runner Runner) (Config, error)

+ type LaunchCandidate struct

+ AppTarget string

+ BundleID string

+ Confidence int

+ Description string

+ Launch LaunchConfig

+ Source string

+ type LaunchCommands struct

+ AppPath string

+ Build string

+ Cleanup string

+ Healthcheck string

+ Install string

+ Launch string

+ type LaunchConfig struct

+ Commands LaunchCommands

+ Mode string

May 3, 2026

Changes in this version

type ReportData

+ VideoInvalid bool

+ VideoIssue string

+ type VideoValidation struct

+ Duration time.Duration

+ Frames int

+ Issue string

+ OK bool

+ func ValidateEvidenceVideo(path string) VideoValidation

May 3, 2026

Changes in this version

type Element

+ Frame string

+ type ScreenObservation struct

+ Elements []Element

+ PreviousScreen string

+ Screen string

+ Source string

+ func ObserveScreenDetailed(root string, cfg Config, run RunState, rawTree string) (ScreenObservation, error)

May 3, 2026

Changes in this version

+ const AppMapFile

+ const ConfigFile

+ const CurrentRunRef

+ const EvidenceStepsFile

+ const MapCurrentFile

+ const MapDirName

+ const MapIndexFile

+ const MapPendingFile

+ const MapScreensDirName

+ const MavDir

+ func AppendEvidenceStep(run RunState, step EvidenceStep) error

+ func ClearPendingMapAction(root string)

+ func CurrentScreen(root string) string

+ func GenerateReport(run RunState) (string, error)

+ func ObserveExpectedScreen(root string, cfg Config, run RunState, rawTree, screenID string) error

+ func ObserveScreen(root string, cfg Config, run RunState, rawTree string) (string, error)

+ func Run(ctx context.Context, args []string, stdout, stderr io.Writer) error

+ func SaveAppMap(root string, m AppMap) error

+ func SaveConfig(root string, cfg Config) error

+ func SaveCurrentRun(root string, run RunState) error

+ func SaveScreen(root string, screen Screen) error

+ func SetCurrentScreen(root, screenID, runID string)

+ func SetPendingMapAction(root string, pending pendingMapAction)

+ func ValidateAppMap(m AppMap) error

+ type AppMap struct

+ AppID string

+ Screens map[string]Screen

+ Start string

+ func DefaultAppMap(bundleID string) AppMap

+ func EnsureAppMap(root string, cfg Config) (AppMap, error)

+ func LoadAppMap(root string) (AppMap, error)

+ type CLI struct

+ Root string

+ Runner Runner

+ Stderr io.Writer

+ Stdout io.Writer

+ func (c CLI) Run(ctx context.Context, args []string) error

+ type CommandResult struct

+ Code int

+ Err error

+ Stderr string

+ Stdout string

+ type Config struct

+ AllowShell bool

+ AppTarget string

+ BundleID string

+ DeviceTarget string

+ Language string

+ Locale string

+ LogCategory string

+ LogSubsystem string

+ PreferredUIDriver string

+ PreviewBundleID string

+ PreviewTarget string

+ ProcessName string

+ ProjectName string

+ Root string

+ SimulatorName string

+ SimulatorRuntime string

+ SimulatorUDID string

+ Tools map[string]bool

+ func DefaultConfig(root string) Config

+ func DiscoverConfig(root string, runner Runner) (Config, error)

+ func LoadConfig(root string) (Config, error)

+ type Edge struct

+ ID string

+ Source string

+ Text string

+ To string

+ Wait string

+ X string

+ Y string

+ func Route(m AppMap, target string) ([]Edge, error)

+ type Element struct

+ ID string

+ Label string

+ Role string

+ Value string

+ func ExtractElements(rawTree string) []Element

+ type EvidenceStep struct

+ CreatedAt string

+ File string

+ Kind string

+ Name string

+ Note string

+ func LoadEvidenceSteps(run RunState) []EvidenceStep

+ type ExecRunner struct

+ func (ExecRunner) LookPath(file string) (string, error)

+ func (ExecRunner) Run(ctx context.Context, name string, args ...string) CommandResult

+ func (ExecRunner) Start(ctx context.Context, logPath string, name string, args ...string) (int, error)

+ type Flow struct

+ Name string

+ Steps []FlowStep

+ Version int

+ func LoadFlow(path string) (Flow, error)

+ func ParseFlow(data []byte) (Flow, error)

+ type FlowCondition struct

+ ChangedFrom string

+ ID string

+ Text string

+ Value string

+ type FlowStep struct

+ Action string

+ Any []FlowCondition

+ Params map[string]string

+ type GlobalOptions struct

+ Help bool

+ JSON bool

+ Raw bool

+ Verbose bool

+ type Output struct

+ Cmd string

+ Code string

+ Fields map[string]string

+ OK bool

+ func Fail(code string, fields map[string]string) Output

+ func OK(cmd string, fields map[string]string) Output

+ func (o Output) Write(w io.Writer, jsonMode bool) error

+ type Recognizer struct

+ Kind string

+ Value string

+ type ReportData struct

+ Commands []string

+ Crashes []string

+ CreatedAt string

+ Dir string

+ Logs string

+ RunID string

+ Screenshot string

+ Steps []EvidenceStep

+ Video string

+ type RunState struct

+ Commands string

+ Dir string

+ ID string

+ LogsPath string

+ Processes string

+ Started time.Time

+ func LoadRun(root, id string) (RunState, error)

+ func NewRunState() (RunState, error)

+ type Runner interface

+ LookPath func(file string) (string, error)

+ Run func(ctx context.Context, name string, args ...string) CommandResult

+ Start func(ctx context.Context, logPath string, name string, args ...string) (int, error)

+ type Screen struct

+ AssertID string

+ AssertText string

+ Edges []Edge

+ Elements []Element

+ ID string

+ Recognizers []Recognizer

+ Title string

+ TreeFile string

+ UpdatedAt string

+ func LoadScreen(root, id string) (Screen, error)

+ type Simulator struct

+ Name string

+ Runtime string

+ State string

+ UDID string

+ func ListSimulators(runner Runner) ([]Simulator, error)

+ func SelectSimulator(sims []Simulator, name, runtime, udid string) (Simulator, bool)