From 407b4a06482b3d3053dcbe7ac36d18187179f374 Mon Sep 17 00:00:00 2001
From: PJ <ipriyanshujain@gmail.com>
Date: Mon, 27 Apr 2026 00:51:20 +0700
Subject: [PATCH] test+docs: cover --clear-data flag in CLI parser test and
 reference

---
 cmd/sanderling/main_test.go | 17 +++++++++++++++++
 docs/manual/cli.md          |  1 +
 2 files changed, 18 insertions(+)

diff --git a/cmd/sanderling/main_test.go b/cmd/sanderling/main_test.go
index 470f180..3bcfc82 100644
--- a/cmd/sanderling/main_test.go
+++ b/cmd/sanderling/main_test.go
@@ -32,6 +32,23 @@ func TestParseTestArgs_Defaults(t *testing.T) {
 	if options.seed != 0 {
 		t.Errorf("seed default: got %d, want 0", options.seed)
 	}
+	if options.clearData {
+		t.Errorf("clearData default: got true, want false")
+	}
+}
+
+func TestParseTestArgs_ClearDataFlag(t *testing.T) {
+	options, err := parseTestArgs([]string{
+		"--spec", "s.ts",
+		"--bundle-id", "com.example",
+		"--clear-data",
+	}, io.Discard)
+	if err != nil {
+		t.Fatalf("unexpected error: %v", err)
+	}
+	if !options.clearData {
+		t.Errorf("expected clearData=true, got false")
+	}
 }
 
 func TestParseTestArgs_AllFlags(t *testing.T) {
diff --git a/docs/manual/cli.md b/docs/manual/cli.md
index c9d1bf0..9d375f6 100644
--- a/docs/manual/cli.md
+++ b/docs/manual/cli.md
@@ -22,6 +22,7 @@ Run a spec against an app for a fixed duration.
 | `--duration` | `5m` | Total test duration (`30s`, `5m`, `2h`, `1d`). |
 | `--seed` | `0` | PRNG seed. `0` uses a random seed and records it in `meta.json`. |
 | `--output` | `./runs` | Output directory for traces. |
+| `--clear-data` | `false` | Clear app data before launching so the run starts from a fresh install. |
 
 ## `sanderling inspect [run-or-runs-dir]`