iOS Test Runner

Overview

Smoke build and test runner for the main agent. Run after simple bug fixes or minor changes to verify nothing broke — without spawning a full tester subagent.

Announce at start: "Using ios-test-runner skill to verify the build."

Use this skill when:

• Verifying a simple bug fix compiles and passes tests
• Smoke-testing before creating a PR
• Quick build check after dependency update

Escalate to tester subagent when:

• Diagnosing a complex or intermittent test failure
• Investigating code coverage gaps
• Writing new tests for a feature
• Full regression test suite analysis

---

Commands

# Install tool versions (run once per session if needed)
mise install

# Resolve SPM dependencies
mise x -- tuist install

# Build only (fast smoke check)
mise x -- tuist build

# Run full test suite
mise x -- tuist test

ALWAYS prefix tuist commands with mise x --

---

Workflow

1. Build first

mise x -- tuist build

• If build fails → fix compilation errors before running tests
• Build success → proceed to tests

2. Run tests

mise x -- tuist test

3. Interpret results

Output	Meaning
Test Suite ... passed	All good
Test Suite ... failed	Check which tests failed
error: build failed	Compilation error — fix before testing
Timeout / no output	Simulator issue — try mise x -- tuist build first

---

Key Test Areas

Component	What it covers
KGDataTourManager	API requests, response parsing, error handling
TourListViewModel	Pagination, type filtering, radius changes
DeepLinkManager	URL parsing, consume() idempotency
LocationManager	Auth status transitions
WWGDefaults	Read/write correctness

---

Output Format

## Test Run — [date]

### Build: PASS / FAIL
[error message if failed]

### Tests: N passed, N failed (Ns)

### Failures
- [TestClass.testMethod]: [error message]

### Verdict
- PASS — safe to PR / FAIL — escalate to tester subagent