Skip to content

Commit b78ff23

Browse files
committed
docs(ios): keep smoke authoring guidance beside its harness
1 parent 0a0e7c7 commit b78ff23

4 files changed

Lines changed: 5 additions & 8 deletions

File tree

‎docs/agents/device-verification.md‎

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,6 @@
22

33
Use this for Apple runner changes or manual device runs. For foldables, also read [foldable verification](device-foldable.md).
44

5-
For iOS fixture smoke or native input regressions, read [iOS smoke authoring](ios-smoke.md).
6-
75
## Prepare
86

97
1. Build runtime changes with `pnpm build`.
@@ -58,7 +56,6 @@ First runs need XCUITest automation permission.
5856
Keep Apple target changes synchronized across the kernel model, runtime-fact admission, dispatch,
5957
discovery, and xctestrun preparation. Simulator-set scoping must not hide the host macOS target.
6058
HarmonyOS has no provisioned CI device or HDC. Mocked tests do not replace local hardware evidence.
61-
Read live smoke harnesses before running them; their environment contracts live in their entry files under `test/integration/`.
6259

6360
If a sandbox rejects localhost with `listen EPERM`, use host access when permitted.
6461
Inspect the underlying error first. A generic startup or cleanup failure does not prove a sandbox cause.

‎docs/agents/test-authoring.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Use this when adding or changing tests. Read [validation](testing.md) for checks and [test audits](test-audit.md) for deletions.
44

5-
For iOS fixture smoke or native input regressions, read [iOS smoke authoring](ios-smoke.md).
5+
For iOS fixture smoke or native input regressions, read [iOS smoke authoring](../../test/integration/ios-simulator-e2e/README.md).
66

77
## Choose the boundary
88

‎docs/evidence/ios-smoke-contracts-2026-10-17.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# iOS smoke contracts
22

3-
Authoring rules live in [iOS smoke authoring](../agents/ios-smoke.md). This file records the failures and verification behind PR #3786.
3+
Authoring rules live in [iOS smoke authoring](../../test/integration/ios-simulator-e2e/README.md). This file records the failures and verification behind PR #3786.
44

55
## Failure evidence
66

docs/agents/ios-smoke.md renamed to test/integration/ios-simulator-e2e/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Author iOS smoke scenarios
22

33
Use this for `test/integration/ios-simulator-e2e/` and its native input regressions.
4-
Use [test authoring](test-authoring.md) for test boundaries and [device verification](device-verification.md) for builds and cleanup.
4+
Use [test authoring](../../../docs/agents/test-authoring.md) for test boundaries and [device verification](../../../docs/agents/device-verification.md) for builds and cleanup.
55

66
## Declare the starting state
77

@@ -75,6 +75,6 @@ xcrun simctl spawn <udid> defaults write com.apple.keyboard.preferences Automati
7575
The iOS workflow sets this before fixture smoke.
7676
For local verification, record the prior value and restore it afterward.
7777
Run the changed scenario through the checked-in smoke entry point and preserve its coverage and failure artifacts.
78-
Record the source SHA, device, command, and semantic result under [device verification](device-verification.md).
79-
For regressions, prove the test fails without the fix using [isolated experiments](test-experiments.md).
78+
Record the source SHA, device, command, and semantic result under [device verification](../../../docs/agents/device-verification.md).
79+
For regressions, prove the test fails without the fix using [isolated experiments](../../../docs/agents/test-experiments.md).
8080
Do not count skipped device tests as passed.

0 commit comments

Comments
 (0)