mirror of
https://github.com/garrytan/gstack.git
synced 2026-06-17 15:20:11 +02:00
Garry Tan
4274b1204d
The skill doc has been telling users to run `gstack-ios-qa-daemon` and `gstack-ios-qa-mint` since v1.41.0.0, but neither binary actually existed. Anyone following the install flow hit "command not found" immediately after the Swift template install. Adds the missing pieces: - bin/gstack-ios-qa-daemon — bash shim that execs `bun run ios-qa/daemon/src/index.ts`. Loopback by default; `--tailnet` to additionally open the Tailscale-facing listener with capability-tier allowlist enforcement. - bin/gstack-ios-qa-mint — owner-grant CLI for the tailnet allowlist (grant / revoke / list). Writes ~/.gstack/ios-qa-allowlist.json at mode 0600. Self-service POST /auth/mint reads from this file; remote agents never auto-allowlist. - ios-qa/daemon/src/cli-mint.ts — TS implementation behind the shim. Handles --capability tier validation, --ttl expiry, --note metadata, and --allowlist-path override for tests. - ios-qa/daemon/src/allowlist.ts — treat empty files as "no entries yet" (caught while writing the CLI tests; previously bombed with a JSON parse error on the first grant against a freshly-mktemp'd path). Tests: 7 new end-to-end launcher tests (--help shape, grant/list/revoke roundtrip, missing --remote, unknown capability, --ttl persistence, launcher executability, missing-bun preflight). All 81 daemon tests pass. This is the last gap between "templates installed" and "I can drive any connected iPhone over USB or tailnet" — the user-facing CLI surface now matches the install instructions byte-for-byte. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
40 lines
1.5 KiB
Bash
Executable File
40 lines
1.5 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# gstack-ios-qa-daemon — Mac-side daemon that brokers tailnet/loopback traffic
|
|
# to a connected iPhone running the in-app StateServer over the CoreDevice USB
|
|
# tunnel. Single-instance via flock on ~/.gstack/ios-qa-daemon.pid.
|
|
#
|
|
# Usage:
|
|
# gstack-ios-qa-daemon # loopback-only (local USB)
|
|
# gstack-ios-qa-daemon --tailnet # additionally open tailnet listener
|
|
#
|
|
# Environment:
|
|
# GSTACK_IOS_DAEMON_PORT — loopback listener port (default 9099)
|
|
# GSTACK_IOS_TARGET_UDID — target iOS device UDID (optional; otherwise
|
|
# the first paired connected device is used)
|
|
# GSTACK_IOS_TARGET_BUNDLE_ID — bundle ID of the iOS app hosting StateServer
|
|
# (default com.gstack.iosqa.fixture)
|
|
#
|
|
# Readiness protocol: prints `READY: port=<n> pid=<pid>` to stdout once both
|
|
# listeners are bound. Spawners read stdin with a ~5s timeout to confirm.
|
|
#
|
|
# Exits cleanly when no active loopback clients are connected AND no remote
|
|
# session tokens are outstanding.
|
|
|
|
set -euo pipefail
|
|
|
|
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
|
GSTACK_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
|
|
ENTRY="$GSTACK_DIR/ios-qa/daemon/src/index.ts"
|
|
|
|
if [ ! -f "$ENTRY" ]; then
|
|
echo "gstack-ios-qa-daemon: missing $ENTRY (gstack install incomplete?)" >&2
|
|
exit 1
|
|
fi
|
|
|
|
if ! command -v bun >/dev/null 2>&1; then
|
|
echo "gstack-ios-qa-daemon: bun runtime not on PATH — install from https://bun.sh" >&2
|
|
exit 1
|
|
fi
|
|
|
|
exec bun run "$ENTRY" "$@"
|