@osfactory/har 0.1.1

package/dist/templates/har-boilerplate-cli/stages.json

@@ -0,0 +1,61 @@
+{
+  "version": "1",
+  "agentSlots": {
+    "min": 1,
+    "max": 3
+  },
+  "stages": [
+    {
+      "id": "setup-infra",
+      "kind": "setup",
+      "description": "Optional shared Docker infrastructure",
+      "command": "./.har/setup-infra.sh"
+    },
+    {
+      "id": "launch",
+      "kind": "launch",
+      "description": "Prepare agent slot (git worktree, deps, env file)",
+      "command": "./.har/launch.sh {agentId}",
+      "artifacts": [
+        {
+          "path": ".env.agent.{agentId}",
+          "kind": "file",
+          "description": "Generated per-agent environment file"
+        }
+      ]
+    },
+    {
+      "id": "verify",
+      "kind": "verify",
+      "description": "Verification pipeline (quick by default; --full adds lint, build, browser-e2e when installed)",
+      "command": "./.har/verify.sh {agentId}",
+      "acceptsArgs": ["--full"],
+      "artifacts": [
+        {
+          "path": ".har/artifacts",
+          "kind": "directory",
+          "description": "Optional verification outputs"
+        }
+      ]
+    },
+    {
+      "id": "status",
+      "kind": "inspect",
+      "description": "Inspect agent slot status and worktree path",
+      "command": "./.har/agent-cli.sh {agentId} status",
+      "artifacts": [
+        {
+          "path": ".har/logs",
+          "kind": "directory",
+          "description": "Optional harness logs"
+        }
+      ]
+    },
+    {
+      "id": "teardown",
+      "kind": "teardown",
+      "description": "Remove worktree and env file for the slot",
+      "command": "./.har/teardown.sh {agentId}"
+    }
+  ]
+}

package/dist/templates/har-boilerplate-cli/teardown.sh

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+# Tear down an agent slot for CLI/library repos.
+# The session's git branch is KEPT by default so you can push it / open a PR —
+# pass --delete-branch to remove it too.
+#
+# Usage: ./.har/teardown.sh <agent-id> [--delete-branch]
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# shellcheck source=/dev/null
+source "$SCRIPT_DIR/harness.env"
+# shellcheck source=/dev/null
+source "$SCRIPT_DIR/agent-slot.sh"
+
+AGENT_ID="${1:?Usage: teardown.sh <agent-id> [--delete-branch]}"
+DELETE_BRANCH=false
+
+for arg in "${@:2}"; do
+  case "$arg" in
+    --delete-branch) DELETE_BRANCH=true ;;
+  esac
+done
+
+validate_agent_id "$AGENT_ID"
+
+echo "==> Tearing down agent ${AGENT_ID}..."
+
+# Resolve the session from the registry; fall back to the legacy fixed path so
+# pre-registry sessions stay removable.
+REGISTRY_FILE="$(slot_registry_file "$AGENT_ID")"
+WORKTREE_PATH=""
+WORK_DIR=""
+BRANCH=""
+if [ -f "$REGISTRY_FILE" ]; then
+  WORKTREE_PATH="$(read_slot_field "$REGISTRY_FILE" worktreePath || true)"
+  WORK_DIR="$(read_slot_field "$REGISTRY_FILE" workDir || true)"
+  BRANCH="$(read_slot_field "$REGISTRY_FILE" branch || true)"
+fi
+[ -n "$WORKTREE_PATH" ] || WORKTREE_PATH="$HOME/worktrees/${HARNESS_PROJECT_NAME}-agent-${AGENT_ID}"
+
+rm -f "$REPO_ROOT/.env.agent.${AGENT_ID}"
+if [ -n "$WORK_DIR" ] && [ -d "$WORK_DIR" ]; then
+  rm -f "$WORK_DIR/.env.agent.${AGENT_ID}"
+fi
+
+if [ -d "$WORKTREE_PATH" ]; then
+  rm -f "$WORKTREE_PATH/.env.agent.${AGENT_ID}"
+  git -C "$REPO_ROOT" worktree remove "$WORKTREE_PATH" --force 2>/dev/null || rm -rf "$WORKTREE_PATH"
+  echo "✓ Removed worktree: $WORKTREE_PATH"
+fi
+git -C "$REPO_ROOT" worktree prune 2>/dev/null || true
+
+if [ -n "$BRANCH" ]; then
+  if [ "$DELETE_BRANCH" = true ]; then
+    git -C "$REPO_ROOT" branch -D "$BRANCH" 2>/dev/null || true
+    echo "✓ Deleted branch: $BRANCH"
+  else
+    echo "✓ Kept branch: $BRANCH (push it or delete with: git branch -D $BRANCH)"
+  fi
+fi
+
+remove_slot_registry "$AGENT_ID"
+
+echo "✓ Agent ${AGENT_ID} torn down"

package/dist/templates/har-boilerplate-cli/verify.sh

@@ -0,0 +1,113 @@
+#!/usr/bin/env bash
+# Verification pipeline for CLI/library repos — typecheck, test, lint, build.
+# Outputs JSON to stdout, human-readable progress to stderr.
+#
+# Usage: ./.har/verify.sh <agent-id> [--full]
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# shellcheck source=/dev/null
+source "$SCRIPT_DIR/harness.env"
+# shellcheck source=/dev/null
+source "$SCRIPT_DIR/agent-slot.sh"
+
+AGENT_ID="${1:?Usage: verify.sh <agent-id> [--full]}"
+FULL=""
+
+for arg in "${@:2}"; do
+  [ "$arg" = "--full" ] && FULL=1
+done
+
+validate_agent_id "$AGENT_ID"
+
+ENV_FILE="$(resolve_agent_env_file "$AGENT_ID" "$REPO_ROOT")" || {
+  echo "No .env.agent.${AGENT_ID} found. Run: ./.har/launch.sh ${AGENT_ID}" >&2
+  exit 1
+}
+
+set -a
+# shellcheck source=/dev/null
+source "$ENV_FILE"
+set +a
+
+WORK_DIR="$(resolve_agent_work_dir "$ENV_FILE")"
+
+echo "==> Verifying agent ${AGENT_ID} in ${WORK_DIR}..." >&2
+
+OVERALL_PASS=true
+START_TOTAL=$(date +%s%3N 2>/dev/null || echo "0")
+RESULTS_JSON="[]"
+
+run_step() {
+  local name="$1"
+  local cmd="$2"
+  local start end elapsed exit_code output
+
+  printf "  → %-40s" "$name..." >&2
+  start=$(date +%s%3N 2>/dev/null || echo "0")
+
+  set +e
+  output=$(cd "$WORK_DIR" && eval "$cmd" 2>&1)
+  exit_code=$?
+  set -e
+
+  end=$(date +%s%3N 2>/dev/null || echo "0")
+  elapsed=$(( end - start ))
+
+  local pass_bool step_output_escaped
+  if [ "$exit_code" = "0" ]; then
+    echo "✓ (${elapsed}ms)" >&2
+    pass_bool="true"
+  else
+    echo "✗ (${elapsed}ms)" >&2
+    echo "$output" | head -30 | sed 's/^/    /' >&2
+    pass_bool="false"
+    OVERALL_PASS=false
+  fi
+
+  step_output_escaped=$(echo "$output" | head -50 | \
+    node -e "let d=''; process.stdin.on('data',c=>d+=c); process.stdin.on('end',()=>process.stdout.write(JSON.stringify(d.trim())))" \
+    2>/dev/null || echo '""')
+
+  RESULTS_JSON=$(echo "$RESULTS_JSON" | node -e "
+const fs = require('fs');
+let arr = JSON.parse(fs.readFileSync('/dev/stdin','utf8'));
+arr.push({name:'$name',pass:$pass_bool,ms:$elapsed,output:$step_output_escaped});
+process.stdout.write(JSON.stringify(arr));
+" 2>/dev/null || echo "$RESULTS_JSON")
+
+  if [ "$pass_bool" = "false" ] && [ -z "$FULL" ]; then
+    return 1
+  fi
+}
+
+run_step "typecheck" "npm run typecheck" || { [ -z "$FULL" ] && true; }
+# Some unit tests exec dist/index.js (e.g. stage-templates CLI add-stage).
+run_step "build" "npm run build" || { [ -z "$FULL" ] && true; }
+run_step "unit-tests" "npm test" || { [ -z "$FULL" ] && true; }
+
+if [ -n "$FULL" ]; then
+  run_step "lint" "npm run lint" || true
+  run_step "browser-e2e" "run_browser_e2e_if_present \"$SCRIPT_DIR\" \"$AGENT_ID\"" || true
+fi
+
+END_TOTAL=$(date +%s%3N 2>/dev/null || echo "0")
+TOTAL_MS=$(( END_TOTAL - START_TOTAL ))
+
+node -e "
+const results = $RESULTS_JSON;
+const overall = results.length > 0 && results.every(r => r.pass);
+const out = {
+  status: overall ? 'pass' : 'fail',
+  agent_id: $AGENT_ID,
+  total_ms: $TOTAL_MS,
+  stages: results,
+};
+process.stdout.write(JSON.stringify(out, null, 2) + '\n');
+" 2>/dev/null || echo "{\"status\":\"fail\",\"agent_id\":${AGENT_ID},\"stages\":[]}"
+
+if [ "$OVERALL_PASS" = "false" ]; then
+  exit 1
+fi

package/dist/templates/har-boilerplate-ios/ADAPT-PROMPT.md

@@ -0,0 +1,57 @@
+# Adapt this iOS harness to the project
+
+You are adapting a freshly scaffolded iOS mobile app harness. Read the existing repo
+structure, then make the changes listed below. Commit when done.
+
+## 1 — Read before editing
+
+- `AGENT.md` at the repo root (overview and do-nots)
+- `.har/README.md` (harness index)
+- `.har/harness.env` (all config vars)
+- `.har/stages.json` (stage registry)
+- Root of the repo: look for `*.xcworkspace`, `*.xcodeproj`, `Podfile`, `Package.swift`
+
+## 2 — Set Xcode project config in `.har/harness.env`
+
+| Variable | What to set |
+|----------|-------------|
+| `HARNESS_XCODE_WORKSPACE` | Relative path to `.xcworkspace` (e.g. `MyApp.xcworkspace`). Use when CocoaPods or a workspace is present. Leave empty otherwise. |
+| `HARNESS_XCODE_PROJECT` | Relative path to `.xcodeproj` (e.g. `MyApp.xcodeproj`). Only set when no workspace. |
+| `HARNESS_XCODE_SCHEME` | Name of the shared Xcode scheme (must be marked Shared in Xcode → Product → Scheme → Manage Schemes). |
+| `HARNESS_SIMULATOR_NAME` | Display name exactly as shown in `xcrun simctl list devices` (e.g. `iPhone 16`). |
+| `HARNESS_BUNDLE_ID` | App bundle identifier from the Xcode target (e.g. `com.example.myapp`). |
+
+Run `./.har/setup-infra.sh` after editing to confirm the simulator boots.
+
+## 3 — Verify `.har/verify.sh` builds and tests correctly
+
+Run `./.har/launch.sh 1`, then `./.har/verify.sh 1`.
+
+Common adaptations:
+- If the project uses a custom test plan, add `-testPlan MyTests` to the `xcodebuild test` invocation.
+- If SwiftLint is not used, remove or comment out the `lint` step.
+- If there are UI tests that require a running app, move them to a RocketSim flow (`har env add-stage rocketsim`) rather than xcodebuild tests.
+
+## 4 — Add the RocketSim stage template (recommended)
+
+```bash
+har env add-stage rocketsim
+```
+
+Then adapt `flows/example-smoke.sh` to navigate to your app's main screen and verify it loads.
+Read `.har/stages/ROCKETSIM.md` for the full authoring guide.
+
+## 5 — Update `AGENT.md` (repo root)
+
+Replace the TODO section with:
+- Which Xcode scheme and simulator are used
+- How to run unit tests manually
+- How to add a new RocketSim user flow
+
+## 6 — Verify everything passes
+
+```bash
+./.har/verify.sh 1 --full
+```
+
+All steps should return ✓. Commit the adapted harness in the session worktree.

package/dist/templates/har-boilerplate-ios/CLAUDE.agent.md

@@ -0,0 +1,65 @@
+# Agent ${AGENT_ID} — iOS Development Environment
+
+> [`AGENT.md`](../AGENT.md) · [`.har/README.md`](./README.md) · [`stages.json`](./stages.json)
+
+## Environment
+
+| | |
+|--|--|
+| **Agent ID** | ${AGENT_ID} |
+| **Work dir** | Fresh session worktree per launch — see the launch output or `.har/slots/agent-${AGENT_ID}.json` |
+| **Simulator** | Configured in `.har/harness.env` — `HARNESS_SIMULATOR_NAME` |
+| **Scheme** | Configured in `.har/harness.env` — `HARNESS_XCODE_SCHEME` |
+
+**Never edit the main checkout** — launch FIRST, then make ALL file edits under the work dir from the launch output. Relaunching replaces the session (branch kept) and requires explicit confirmation; dirty worktrees also need `--force` after user approval.
+
+```bash
+./.har/agent-cli.sh ${AGENT_ID} status
+```
+
+## Definition of done
+
+- [ ] Full verification returns `"status": "pass"` (`har env verify ${AGENT_ID} --full`, MCP `har_run_verification` with `full: true`, or `./.har/verify.sh ${AGENT_ID} --full`)
+- [ ] When `stages/rocketsim-flows.sh` exists, full verify includes user-flow validation — add or update flow scripts in `flows/` for UI changes
+- [ ] New behavior has automated test coverage (unit tests via XCTest)
+- [ ] Changes committed **in the session worktree** with a clear message
+- [ ] Finish with `har env complete ${AGENT_ID}` (or MCP `har_complete_environment`) — records the validation and tears down while **keeping the session branch** for the user to push / open a PR
+
+Quick loop: MCP `har_run_verification`, `har env verify ${AGENT_ID}`, or `./.har/verify.sh ${AGENT_ID}`
+
+## Project commands
+
+```bash
+# Build
+xcodebuild build -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 16' CODE_SIGNING_ALLOWED=NO
+
+# Run unit tests
+xcodebuild test -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 16' CODE_SIGNING_ALLOWED=NO
+
+# Install app on booted simulator
+xcrun simctl install booted path/to/MyApp.app
+
+# Launch app
+xcrun simctl launch booted com.example.myapp
+```
+
+Adapt for your scheme and simulator — see `.har/harness.env`.
+
+## User-flow validation (RocketSim)
+
+If the RocketSim stage template is installed (`har env add-stage rocketsim`):
+
+```bash
+./.har/stages/rocketsim-flows.sh ${AGENT_ID}
+# included in:
+./.har/verify.sh ${AGENT_ID} --full
+```
+
+Add and edit user flow scripts in `flows/`. Read `.har/stages/ROCKETSIM.md` for the full authoring guide.
+
+## Do not
+
+- Work around a failing harness command with ad-hoc setup — fix the harness or report the failure
+- Edit `.env.agent.${AGENT_ID}` by hand
+- Run verify before launch (the simulator and worktree must be set up first)
+- Edit the main checkout — all edits go under the session work dir

package/dist/templates/har-boilerplate-ios/README.md

@@ -0,0 +1,88 @@
+# .har — Agent Harness (iOS mobile app profile)
+
+This directory is the **agent harness** for this iOS mobile app repository. It lets AI coding agents build, test, and validate the app in isolated git worktrees against a running iOS Simulator.
+
+Generated and maintained by [`har`](https://github.com/antoineFrau/har). Run `har env maintain` when the repo stack changes.
+
+**The harness is how you run this project.** Launch a slot to exercise the code in isolation; don't hand-roll Xcode/simulator setup. If a harness command fails, fix the harness or report it — don't silently fall back to ad-hoc commands.
+
+## What's in here
+
+| File | Purpose |
+|------|---------|
+| `README.md` | This file — index of the harness |
+| `manifest.json` | Generator metadata (version, profile, checksums) — do not edit |
+| `harness.env` | Shared config: Xcode scheme, simulator name, bundle ID, infra flags |
+| `stages.json` | Machine-readable registry of runnable harness stages |
+| `stages/` | Optional custom stage scripts registered from `stages.json` |
+| `runs/` | Run history from `har env` / MCP — gitignored |
+| `artifacts/` | Stage outputs: test results, screenshots, logs |
+| `agent-slot.sh` | Shared agent-id validation and slot registry helpers |
+| `setup-infra.sh` | Boot the iOS Simulator; start optional Docker services |
+| `launch.sh` | Launch one agent slot (git worktree, CocoaPods/SPM deps, env file) |
+| `verify.sh` | Verification pipeline (build + unit-tests; --full adds lint + user-flow validation) |
+| `teardown.sh` | Tear down one agent slot (worktree + env file) |
+| `agent-cli.sh` | Inspect slot status, run xcodebuild commands, install/launch app |
+| `docker-compose.agent.yml` | Optional shared backend services |
+| `CLAUDE.agent.md` | Detailed instructions for coding agents |
+| `justfile` | Optional shortcuts (requires `just`) |
+
+No PM2 or web-port wiring in this profile — agents run xcodebuild commands directly in their worktree.
+
+## Quick start
+
+**Preferred — har CLI or MCP** (persists run history under `.har/runs/`):
+
+```bash
+har env launch 1
+har env verify 1
+har env verify 1 --full
+har env teardown 1
+```
+
+In Cursor with HAR MCP configured: use `har_launch_environment`, `har_run_verification`, and `har_teardown_environment`.
+
+**Shell fallback** (no CLI/MCP installed):
+
+```bash
+./.har/setup-infra.sh          # boots the iOS Simulator
+./.har/launch.sh 1
+./.har/verify.sh 1             # build + unit-tests
+./.har/verify.sh 1 --full      # + lint + rocketsim-flows (if installed)
+./.har/teardown.sh 1
+```
+
+## User-flow validation
+
+Add the RocketSim stage template to get reusable UI flow validation:
+
+```bash
+har env add-stage rocketsim
+```
+
+This installs `.har/stages/rocketsim-flows.sh` and a `flows/` directory. Add flow scripts under `flows/` (see `.har/stages/ROCKETSIM.md`). Full verify automatically runs all flows.
+
+## Verification contract
+
+| Mode | Command | Typical steps |
+|------|---------|---------------|
+| Quick | `har env verify <id>` | build, unit-tests |
+| Full | `har env verify <id> --full` | + lint, **rocketsim-flows** when installed |
+
+## Configuration
+
+Edit **`harness.env`** to set:
+- `HARNESS_XCODE_SCHEME` — your app's shared Xcode scheme
+- `HARNESS_XCODE_WORKSPACE` or `HARNESS_XCODE_PROJECT` — path to the project file
+- `HARNESS_SIMULATOR_NAME` — target simulator (must be listed in `xcrun simctl list devices`)
+- `HARNESS_BUNDLE_ID` — app bundle identifier
+
+## Session lifecycle
+
+Every `launch` starts a **fresh session**: a new git worktree from the current HEAD at
+`~/worktrees/<base-branch>-<sha4>-har-agent-<id>-<rand4>`, on a branch of the same name.
+The session is recorded in `.har/slots/agent-<id>.json`.
+
+- Relaunching a slot **replaces** its previous session; uncommitted changes require `--force`.
+- `teardown` removes the worktree but **keeps the session branch** for push / PR.
+- `har env complete <id>` finishes a session: full verify + teardown, branch kept.

package/dist/templates/har-boilerplate-ios/agent-cli.sh

@@ -0,0 +1,125 @@
+#!/usr/bin/env bash
+# Namespaced CLI for managing an iOS mobile app agent slot.
+#
+# Usage: ./.har/agent-cli.sh <agent-id> <command> [args...]
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# shellcheck source=/dev/null
+source "$SCRIPT_DIR/harness.env"
+# shellcheck source=/dev/null
+source "$SCRIPT_DIR/agent-slot.sh"
+
+AGENT_ID="${1:?Usage: agent-cli.sh <agent-id> <command> [args...]}"
+COMMAND="${2:?Usage: agent-cli.sh <agent-id> <command> [args...]}"
+
+validate_agent_id "$AGENT_ID"
+
+WORKTREE_DIR="$(existing_slot_worktree "$AGENT_ID")"
+
+resolve_work_dir() {
+  local env_file
+  env_file="$(resolve_agent_env_file "$AGENT_ID" "$REPO_ROOT")" || {
+    echo "No active environment for agent ${AGENT_ID}" >&2
+    echo "  Run: ./.har/launch.sh ${AGENT_ID}" >&2
+    exit 1
+  }
+  # shellcheck source=/dev/null
+  source "$env_file"
+  resolve_agent_work_dir "$env_file" "$AGENT_ID"
+}
+
+case "$COMMAND" in
+  status)
+    ENV_FILE="$(resolve_agent_env_file "$AGENT_ID" "$REPO_ROOT" || true)"
+
+    if [ -n "$ENV_FILE" ]; then
+      # shellcheck source=/dev/null
+      source "$ENV_FILE"
+      echo "Agent ${AGENT_ID}: active"
+      echo "  Work dir:  $(resolve_agent_work_dir "$ENV_FILE" "$AGENT_ID")"
+      [ -n "$WORKTREE_DIR" ] && [ -d "$WORKTREE_DIR" ] && echo "  Worktree:  $WORKTREE_DIR"
+      echo "  Scheme:    ${HARNESS_XCODE_SCHEME:-not set}"
+      echo "  Simulator: ${HARNESS_SIMULATOR_NAME:-not set}"
+      echo "  Bundle ID: ${HARNESS_BUNDLE_ID:-not set}"
+    else
+      echo "No active environment for agent ${AGENT_ID}"
+      echo "  Run: ./.har/launch.sh ${AGENT_ID}"
+    fi
+    ;;
+
+  simulator)
+    # Show simulator state and UDID for the configured device.
+    SIM_NAME="${HARNESS_SIMULATOR_NAME:-iPhone 16}"
+    echo "Simulator: ${SIM_NAME}"
+    xcrun simctl list devices available 2>/dev/null \
+      | grep "${SIM_NAME}" \
+      | grep -E '\([A-F0-9-]{36}\)' \
+      | head -5 \
+      || echo "  (no matching simulator found — check HARNESS_SIMULATOR_NAME in harness.env)"
+    ;;
+
+  logs)
+    echo "iOS profile has no managed processes." >&2
+    echo "Use 'exec' to run project commands, or check Console.app for simulator logs." >&2
+    exit 1
+    ;;
+
+  restart)
+    echo "iOS profile has no managed processes to restart." >&2
+    echo "Relaunch the slot or reinstall the app with:" >&2
+    echo "  ./.har/agent-cli.sh ${AGENT_ID} exec xcrun simctl install booted <path-to.app>" >&2
+    exit 1
+    ;;
+
+  install)
+    APP_PATH="${3:-}"
+    if [ -z "$APP_PATH" ]; then
+      echo "Usage: agent-cli.sh ${AGENT_ID} install <path-to.app>" >&2
+      exit 1
+    fi
+    echo "==> Installing ${APP_PATH} on simulator..."
+    xcrun simctl install booted "$APP_PATH"
+    echo "✓ Installed"
+    ;;
+
+  launch-app)
+    BUNDLE="${3:-${HARNESS_BUNDLE_ID:-}}"
+    if [ -z "$BUNDLE" ]; then
+      echo "Usage: agent-cli.sh ${AGENT_ID} launch-app [bundle-id]" >&2
+      echo "       or set HARNESS_BUNDLE_ID in harness.env" >&2
+      exit 1
+    fi
+    echo "==> Launching ${BUNDLE} on simulator..."
+    xcrun simctl launch booted "$BUNDLE"
+    ;;
+
+  url)
+    WORK_DIR="$(resolve_work_dir 2>/dev/null || echo "$REPO_ROOT")"
+    echo "Work dir:  $WORK_DIR"
+    [ -d "$WORKTREE_DIR" ] && echo "Worktree:  $WORKTREE_DIR"
+    echo "Scheme:    ${HARNESS_XCODE_SCHEME:-not set}"
+    echo "Simulator: ${HARNESS_SIMULATOR_NAME:-not set}"
+    echo "Bundle ID: ${HARNESS_BUNDLE_ID:-not set}"
+    har_infra_enabled mock-server && echo "Mock:      check docker-compose.agent.yml for port"
+    ;;
+
+  exec)
+    shift 2
+    if [ $# -eq 0 ]; then
+      echo "Usage: agent-cli.sh ${AGENT_ID} exec <command>" >&2
+      exit 1
+    fi
+    WORK_DIR="$(resolve_work_dir)"
+    bash -c "cd '$WORK_DIR' && $*"
+    ;;
+
+  *)
+    echo "Unknown command: $COMMAND" >&2
+    echo ""
+    echo "Commands: status, simulator, install <app>, launch-app [bundle-id], url, exec <cmd>"
+    exit 1
+    ;;
+esac