feat(biometric): Face ID / Touch ID / fingerprint testing (v0.9.7)

[pbertsch]

Summary

Three new ProbeScript steps that drive biometric authentication on iOS Simulator and Android emulator without real hardware. Test the happy path (match) and unhappy path (no-match) of every Face ID / Touch ID / fingerprint flow in your app.

enroll biometric            # one-time setup, typically in `before all tests`
biometric match             # successful capture — unblocks a pending prompt
biometric no match          # failed capture — exercises the failure path

Matching annotation DSL:

@ProbeSuite(
  beforeAll: [EnrollBiometric()],
  tests: [
    ProbeTest('matching face unlocks app', steps: [
      Tap(text: 'Sign in with Face ID'),
      BiometricMatch(),
      See('Dashboard'),
    ]),
    ProbeTest('non-matching face is rejected', steps: [
      Tap(text: 'Sign in with Face ID'),
      BiometricNoMatch(),
      See('Authentication failed'),
    ]),
  ],
)
class BiometricAuthScreen {}

Implementation

Platform	Mechanism
iOS Simulator	xcrun simctl spawn booted notifyutil -p com.apple.BiometricKit_Sim.faceCapture.{match,no-match} (and .fingerTouch.* siblings, so same step works on Face ID and Touch ID devices)
Android emulator	adb -s <serial> emu finger touch 1 (matches enrolled id 1) / ... 9999 (no match)
Physical iOS/Android	Skipped with a warning (same pattern as set location, allow permission)

Test plan (strict)

• go test ./... — 16/16 packages pass (including 3 new biometric parser tests)
• staticcheck ./... — zero issues
• dart test probe_annotation — 3/3 const tests pass
• dart test probe_gen — 12/12 builder tests pass (was 11; +biometric_auth golden)
• TestGoldenIntegration_DartEmittedFiles — 11/11 fixtures parse cleanly through Go parser
• npm run build website — 37 pages built clean

Docs

• New biometric section on annotations.md and syntax.md
• Updated docs/wiki/Annotations.md
• Per-package CHANGELOGs updated

🤖 Generated with Claude Code