specterqa-ios 5.1.0__tar.gz

specterqa_ios-5.1.0/LICENSE

@@ -0,0 +1,92 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor's trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to the
+software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.
+
+## Definitions
+
+The "licensor" is SyncTek LLC.
+
+The "software" is the software the licensor makes available under these terms.
+
+"You" refers to the individual or entity agreeing to these terms.
+
+"Your company" is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+
+"Control" means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+"Your licenses" are all the licenses granted to you for the software under
+these terms.
+
+"Use" means anything you do with the software requiring one of your licenses.

specterqa_ios-5.1.0/MANIFEST.in

@@ -0,0 +1,5 @@
+recursive-include runner/Sources *.swift
+include runner/SpecterQARunner.xcodeproj/project.pbxproj
+include runner/Package.swift
+include runner/build.sh
+include runner/launch.sh

specterqa_ios-5.1.0/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.4
+Name: specterqa-ios
+Version: 5.1.0
+Summary: SpecterQA iOS Simulator Driver — AI-driven iOS testing via Claude Computer Use
+Author-email: SyncTek LLC <info@synctek.io>
+License-Expression: Elastic-2.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow>=10.0
+Requires-Dist: numpy>=1.24
+Requires-Dist: anthropic>=0.39.0
+Requires-Dist: click>=8.0
+Requires-Dist: rich>=13.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: pyobjc-framework-Quartz>=10.0
+Provides-Extra: native
+Requires-Dist: pyobjc-framework-Quartz>=10.0; extra == "native"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# SpecterQA iOS Simulator Driver
+
+AI-driven iOS app testing via Claude Computer Use.
+
+## Install
+
+```bash
+pip install "git+https://github.com/SyncTek-LLC/specterqa-ios.git"
+```
+
+No other packages required — `specterqa-ios` is fully standalone.
+
+## Quick Start
+
+```bash
+# Verify environment (Xcode, simulators, API key)
+specterqa-ios setup
+
+# List available simulators
+specterqa-ios devices
+
+# Scaffold a project for your app
+specterqa-ios init --slug my-app --name "My App"
+
+# Edit the generated config
+# .specterqa/products/my-app.yaml  — set bundle_id and app_path
+# .specterqa/journeys/smoke-test.yaml  — customize test steps
+
+# Validate your config before running
+specterqa-ios validate --product my-app --journey smoke-test
+
+# Boot a simulator
+specterqa-ios boot
+
+# Run a test journey
+specterqa-ios run --product my-app --journey smoke-test
+
+# Quick smoke test (reduced budget, fewer iterations)
+specterqa-ios smoke --product my-app
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `specterqa-ios setup` | Check Xcode, simulators, and API key |
+| `specterqa-ios devices` | List available iOS simulators |
+| `specterqa-ios boot [--device <name>]` | Boot a simulator |
+| `specterqa-ios install <app.app> [--device <id>]` | Install app on simulator |
+| `specterqa-ios init [--slug <id>]` | Scaffold project config files |
+| `specterqa-ios validate --product <slug>` | Validate product/journey config |
+| `specterqa-ios run --product <slug> --journey <id>` | Run a test journey |
+| `specterqa-ios smoke --product <slug>` | Quick smoke test |
+| `specterqa-ios serve` | Start the MCP server (stdio transport) |
+
+## Claude Code Integration
+
+SpecterQA iOS ships as a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server,
+letting Claude Code drive iOS simulator tests directly from your editor.
+
+### Install with MCP extras
+
+```bash
+pip install 'specterqa-ios[mcp]'
+```
+
+### Add to Claude Code
+
+Add the server to your Claude Code MCP configuration. The `specterqa-ios-mcp` console script
+is registered by `pip install` and starts the stdio server automatically.
+
+**Option A — project-level** (`.claude/mcp.json` in your repo root):
+
+```json
+{
+  "mcpServers": {
+    "specterqa-ios": {
+      "command": "specterqa-ios-mcp",
+      "env": {
+        "SPECTERQA_IOS_LICENSE": "founder"
+      }
+    }
+  }
+}
+```
+
+**Option B — global** (add to `~/.claude/mcp.json` or via `claude mcp add`):
+
+```bash
+claude mcp add specterqa-ios -- specterqa-ios-mcp
+```
+
+Set `ANTHROPIC_API_KEY` in the environment (or in the `env` block above).
+
+### Available MCP Tools
+
+Once connected, Claude Code can call these tools:
+
+| Tool | Description |
+|------|-------------|
+| `ios_setup` | Check environment (Xcode, simulators, API key) |
+| `ios_list_devices` | List available iOS simulators |
+| `ios_boot_device` | Boot a simulator by name or UDID |
+| `ios_install_app` | Install a .app bundle on a simulator |
+| `ios_run_test` | Run a full test journey (primary tool) |
+| `ios_run_smoke` | Quick smoke test (reduced budget) |
+| `ios_run_exploratory` | Persona-driven AI exploration |
+| `ios_get_results` | Retrieve results from a previous run |
+| `ios_screenshot` | Screenshot the current simulator state |
+| `ios_list_products` | List configured products |
+| `ios_list_journeys` | List configured journeys |
+
+### Example Claude Code session
+
+```
+> Run a smoke test on the Palace iOS app
+
+[Claude calls ios_list_products, discovers palace-ios]
+[Claude calls ios_boot_device, boots iPhone 15 Pro]
+[Claude calls ios_run_smoke with product_slug="palace-ios"]
+[Returns: 4/4 steps passed, 0 findings, $0.32 spent]
+```
+
+### Alternative: direct invocation
+
+```bash
+# stdio transport (for custom MCP clients)
+specterqa-ios-mcp
+
+# or via Python module
+python -m specterqa.ios.mcp
+
+# or via CLI
+specterqa-ios serve
+```
+
+## Requirements
+
+- macOS with Xcode 15+
+- Python 3.10+
+- `ANTHROPIC_API_KEY` environment variable
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+```
+
+## Project Structure
+
+After `specterqa-ios init`, your project contains:
+
+```
+.specterqa/
+  products/
+    my-app.yaml         # bundle_id, device, cost limits
+  personas/
+    ios-tester.yaml     # AI persona (goals, frustrations, credentials)
+  journeys/
+    smoke-test.yaml     # test steps with goals and checkpoints
+  evidence/
+    IOS-RUN-*/          # screenshots, step results, run-result.json
+```
+
+## How It Works
+
+1. Each journey step has a `goal` — a natural-language instruction for Claude
+2. The AI takes a screenshot of the simulator, observes the UI context, and decides the next action (tap, type, scroll, wait)
+3. Actions are executed via `xcrun simctl` and Quartz event injection
+4. Crashes, error logs, and performance anomalies are surfaced as Findings
+5. All evidence (screenshots, step summaries, findings) is saved to `.specterqa/evidence/`
+
+## License
+
+Elastic License 2.0 — see [LICENSE](LICENSE).

specterqa_ios-5.1.0/README.md

@@ -0,0 +1,173 @@
+# SpecterQA iOS Simulator Driver
+
+AI-driven iOS app testing via Claude Computer Use.
+
+## Install
+
+```bash
+pip install "git+https://github.com/SyncTek-LLC/specterqa-ios.git"
+```
+
+No other packages required — `specterqa-ios` is fully standalone.
+
+## Quick Start
+
+```bash
+# Verify environment (Xcode, simulators, API key)
+specterqa-ios setup
+
+# List available simulators
+specterqa-ios devices
+
+# Scaffold a project for your app
+specterqa-ios init --slug my-app --name "My App"
+
+# Edit the generated config
+# .specterqa/products/my-app.yaml  — set bundle_id and app_path
+# .specterqa/journeys/smoke-test.yaml  — customize test steps
+
+# Validate your config before running
+specterqa-ios validate --product my-app --journey smoke-test
+
+# Boot a simulator
+specterqa-ios boot
+
+# Run a test journey
+specterqa-ios run --product my-app --journey smoke-test
+
+# Quick smoke test (reduced budget, fewer iterations)
+specterqa-ios smoke --product my-app
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `specterqa-ios setup` | Check Xcode, simulators, and API key |
+| `specterqa-ios devices` | List available iOS simulators |
+| `specterqa-ios boot [--device <name>]` | Boot a simulator |
+| `specterqa-ios install <app.app> [--device <id>]` | Install app on simulator |
+| `specterqa-ios init [--slug <id>]` | Scaffold project config files |
+| `specterqa-ios validate --product <slug>` | Validate product/journey config |
+| `specterqa-ios run --product <slug> --journey <id>` | Run a test journey |
+| `specterqa-ios smoke --product <slug>` | Quick smoke test |
+| `specterqa-ios serve` | Start the MCP server (stdio transport) |
+
+## Claude Code Integration
+
+SpecterQA iOS ships as a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server,
+letting Claude Code drive iOS simulator tests directly from your editor.
+
+### Install with MCP extras
+
+```bash
+pip install 'specterqa-ios[mcp]'
+```
+
+### Add to Claude Code
+
+Add the server to your Claude Code MCP configuration. The `specterqa-ios-mcp` console script
+is registered by `pip install` and starts the stdio server automatically.
+
+**Option A — project-level** (`.claude/mcp.json` in your repo root):
+
+```json
+{
+  "mcpServers": {
+    "specterqa-ios": {
+      "command": "specterqa-ios-mcp",
+      "env": {
+        "SPECTERQA_IOS_LICENSE": "founder"
+      }
+    }
+  }
+}
+```
+
+**Option B — global** (add to `~/.claude/mcp.json` or via `claude mcp add`):
+
+```bash
+claude mcp add specterqa-ios -- specterqa-ios-mcp
+```
+
+Set `ANTHROPIC_API_KEY` in the environment (or in the `env` block above).
+
+### Available MCP Tools
+
+Once connected, Claude Code can call these tools:
+
+| Tool | Description |
+|------|-------------|
+| `ios_setup` | Check environment (Xcode, simulators, API key) |
+| `ios_list_devices` | List available iOS simulators |
+| `ios_boot_device` | Boot a simulator by name or UDID |
+| `ios_install_app` | Install a .app bundle on a simulator |
+| `ios_run_test` | Run a full test journey (primary tool) |
+| `ios_run_smoke` | Quick smoke test (reduced budget) |
+| `ios_run_exploratory` | Persona-driven AI exploration |
+| `ios_get_results` | Retrieve results from a previous run |
+| `ios_screenshot` | Screenshot the current simulator state |
+| `ios_list_products` | List configured products |
+| `ios_list_journeys` | List configured journeys |
+
+### Example Claude Code session
+
+```
+> Run a smoke test on the Palace iOS app
+
+[Claude calls ios_list_products, discovers palace-ios]
+[Claude calls ios_boot_device, boots iPhone 15 Pro]
+[Claude calls ios_run_smoke with product_slug="palace-ios"]
+[Returns: 4/4 steps passed, 0 findings, $0.32 spent]
+```
+
+### Alternative: direct invocation
+
+```bash
+# stdio transport (for custom MCP clients)
+specterqa-ios-mcp
+
+# or via Python module
+python -m specterqa.ios.mcp
+
+# or via CLI
+specterqa-ios serve
+```
+
+## Requirements
+
+- macOS with Xcode 15+
+- Python 3.10+
+- `ANTHROPIC_API_KEY` environment variable
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+```
+
+## Project Structure
+
+After `specterqa-ios init`, your project contains:
+
+```
+.specterqa/
+  products/
+    my-app.yaml         # bundle_id, device, cost limits
+  personas/
+    ios-tester.yaml     # AI persona (goals, frustrations, credentials)
+  journeys/
+    smoke-test.yaml     # test steps with goals and checkpoints
+  evidence/
+    IOS-RUN-*/          # screenshots, step results, run-result.json
+```
+
+## How It Works
+
+1. Each journey step has a `goal` — a natural-language instruction for Claude
+2. The AI takes a screenshot of the simulator, observes the UI context, and decides the next action (tap, type, scroll, wait)
+3. Actions are executed via `xcrun simctl` and Quartz event injection
+4. Crashes, error logs, and performance anomalies are surfaced as Findings
+5. All evidence (screenshots, step summaries, findings) is saved to `.specterqa/evidence/`
+
+## License
+
+Elastic License 2.0 — see [LICENSE](LICENSE).

specterqa_ios-5.1.0/pyproject.toml

@@ -0,0 +1,66 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "specterqa-ios"
+version = "5.1.0"
+description = "SpecterQA iOS Simulator Driver — AI-driven iOS testing via Claude Computer Use"
+readme = "README.md"
+license = "Elastic-2.0"
+requires-python = ">=3.10"
+authors = [
+    {name = "SyncTek LLC", email = "info@synctek.io"},
+]
+
+dependencies = [
+    "Pillow>=10.0",
+    "numpy>=1.24",
+    "anthropic>=0.39.0",
+    "click>=8.0",
+    "rich>=13.0",
+    "pyyaml>=6.0",
+    "pyobjc-framework-Quartz>=10.0",
+]
+
+[project.optional-dependencies]
+native = [
+    "pyobjc-framework-Quartz>=10.0",
+]
+mcp = [
+    "mcp>=1.0",
+]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    "mypy>=1.0",
+    "ruff>=0.1.0",
+]
+
+[project.scripts]
+specterqa-ios = "specterqa.ios.cli.commands:main"
+specterqa-ios-mcp = "specterqa.ios.mcp.server:serve"
+
+[project.entry-points."specterqa.drivers"]
+ios_simulator = "specterqa.ios.sim_driver:SimDriver"
+
+[project.entry-points."specterqa.cli_extensions"]
+ios = "specterqa.ios.cli:ios_command_group"
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["specterqa*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+markers = [
+    "integration: real-device integration tests (require a booted iOS Simulator)",
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"

specterqa_ios-5.1.0/runner/Package.swift

@@ -0,0 +1,13 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "SpecterQARunner",
+    platforms: [.iOS(.v15)],
+    targets: [
+        .target(
+            name: "SpecterQARunner",
+            path: "Sources"
+        )
+    ]
+)