@osfactory/har 0.64.1 → 1.0.0-rc.1

package/dist/templates/har-boilerplate-cli/setup-infra.sh

@@ -1,178 +0,0 @@
-#!/usr/bin/env bash
-# Sets up shared infrastructure for all agents.
-# Starts the docker compose services listed in HARNESS_INFRA_SERVICES, creates
-# the template database (when "db" is enabled), and starts optional shared app
-# services (ecosystem.shared.config.cjs). One instance serves every agent slot.
-# Idempotent — safe to run multiple times.
-#
-# Usage: ./.har/setup-infra.sh
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-COMPOSE_FILE="$SCRIPT_DIR/docker-compose.agent.yml"
-INFRA_STATE="$SCRIPT_DIR/state/infra.env"
-
-# shellcheck source=/dev/null
-source "$SCRIPT_DIR/harness.env"
-# shellcheck source=/dev/null
-source "$SCRIPT_DIR/agent-slot.sh"
-
-COMPOSE_PROJECT="har-${HARNESS_PROJECT_NAME}"
-PSQL="har_pg psql -d postgres"
-
-log() { echo "==> $*" >&2; }
-
-har_compose_service_running() {
-  local service="$1"
-  docker ps --filter "name=${COMPOSE_PROJECT}-${service}-1" --format '{{.Names}}' 2>/dev/null \
-    | grep -q "^${COMPOSE_PROJECT}-${service}-1\$"
-}
-
-har_resolve_infra_port() {
-  local var_name="$1"
-  local default_port="$2"
-  local scan_start="$3"
-  local scan_end="$4"
-  local service="${5:-}"
-  local current="${!var_name:-}"
-
-  if [ -n "$current" ] && { ! port_in_use "$current" || { [ -n "$service" ] && har_compose_service_running "$service"; }; }; then
-    echo "$current"
-    return 0
-  fi
-  har_allocate_port "$default_port" "$scan_start" "$scan_end"
-}
-
-mkdir -p "$(dirname "$INFRA_STATE")"
-if [ -f "$INFRA_STATE" ]; then
-  # shellcheck source=/dev/null
-  source "$INFRA_STATE"
-fi
-
-DB_PORT="$(har_resolve_infra_port AGENT_DB_PORT \
-  "${HARNESS_DB_PORT_DEFAULT:-15432}" \
-  "${HARNESS_DB_PORT_SCAN_START:-15432}" \
-  "${HARNESS_DB_PORT_SCAN_END:-15499}" \
-  db)"
-MINIO_PORT="$(har_resolve_infra_port AGENT_MINIO_PORT \
-  "${HARNESS_MINIO_PORT_DEFAULT:-19000}" \
-  "${HARNESS_MINIO_PORT_SCAN_START:-19000}" \
-  "${HARNESS_MINIO_PORT_SCAN_END:-19099}" \
-  minio)"
-MINIO_CONSOLE_PORT="$(har_resolve_infra_port AGENT_MINIO_CONSOLE_PORT \
-  "${HARNESS_MINIO_CONSOLE_PORT_DEFAULT:-19001}" \
-  "${HARNESS_MINIO_CONSOLE_PORT_SCAN_START:-19001}" \
-  "${HARNESS_MINIO_CONSOLE_PORT_SCAN_END:-19099}")"
-BROWSER_PORT="$(har_resolve_infra_port AGENT_BROWSER_PORT \
-  "${HARNESS_BROWSER_PORT_DEFAULT:-13001}" \
-  "${HARNESS_BROWSER_PORT_SCAN_START:-13001}" \
-  "${HARNESS_BROWSER_PORT_SCAN_END:-13099}" \
-  headless-browser)"
-MAILPIT_WEB_PORT="$(har_resolve_infra_port AGENT_MAILPIT_WEB_PORT \
-  "${HARNESS_MAILPIT_WEB_PORT_DEFAULT:-18025}" \
-  "${HARNESS_MAILPIT_WEB_PORT_SCAN_START:-18025}" \
-  "${HARNESS_MAILPIT_WEB_PORT_SCAN_END:-18099}" \
-  mailpit)"
-MAILPIT_SMTP_PORT="$(har_resolve_infra_port AGENT_MAILPIT_SMTP_PORT \
-  "${HARNESS_MAILPIT_SMTP_PORT_DEFAULT:-11025}" \
-  "${HARNESS_MAILPIT_SMTP_PORT_SCAN_START:-11025}" \
-  "${HARNESS_MAILPIT_SMTP_PORT_SCAN_END:-11099}")"
-
-export AGENT_DB_PORT="$DB_PORT"
-export AGENT_MINIO_PORT="$MINIO_PORT"
-export AGENT_MINIO_CONSOLE_PORT="$MINIO_CONSOLE_PORT"
-export AGENT_BROWSER_PORT="$BROWSER_PORT"
-export AGENT_MAILPIT_WEB_PORT="$MAILPIT_WEB_PORT"
-export AGENT_MAILPIT_SMTP_PORT="$MAILPIT_SMTP_PORT"
-
-cat > "$INFRA_STATE" <<EOF
-# Persisted by setup-infra.sh — host ports for shared docker compose services.
-export AGENT_DB_PORT=${DB_PORT}
-export AGENT_MINIO_PORT=${MINIO_PORT}
-export AGENT_MINIO_CONSOLE_PORT=${MINIO_CONSOLE_PORT}
-export AGENT_BROWSER_PORT=${BROWSER_PORT}
-export AGENT_MAILPIT_WEB_PORT=${MAILPIT_WEB_PORT}
-export AGENT_MAILPIT_SMTP_PORT=${MAILPIT_SMTP_PORT}
-EOF
-
-SERVICES="${HARNESS_INFRA_SERVICES:-}"
-
-if [ -n "$SERVICES" ]; then
-  log "Starting shared infrastructure (project: $COMPOSE_PROJECT): $SERVICES"
-  AGENT_DB_PORT="$DB_PORT" \
-  AGENT_MINIO_PORT="$MINIO_PORT" \
-  AGENT_MINIO_CONSOLE_PORT="$MINIO_CONSOLE_PORT" \
-  AGENT_BROWSER_PORT="$BROWSER_PORT" \
-  AGENT_MAILPIT_WEB_PORT="$MAILPIT_WEB_PORT" \
-  AGENT_MAILPIT_SMTP_PORT="$MAILPIT_SMTP_PORT" \
-    docker compose -p "$COMPOSE_PROJECT" -f "$COMPOSE_FILE" up -d $SERVICES
-else
-  log "No shared infra services enabled in harness.env (HARNESS_INFRA_SERVICES)"
-fi
-
-# Wait for PostgreSQL and prepare the template database
-if har_infra_enabled db; then
-  log "Waiting for PostgreSQL on port $DB_PORT..."
-  for i in $(seq 1 30); do
-    if har_pg pg_isready -q 2>/dev/null; then
-      log "PostgreSQL is ready."
-      break
-    fi
-    if [ "$i" = "30" ]; then
-      echo "Error: PostgreSQL did not become ready within 30 seconds." >&2
-      exit 1
-    fi
-    sleep 1
-  done
-
-  log "Enabling pg_stat_statements extension..."
-  $PSQL -c "CREATE EXTENSION IF NOT EXISTS pg_stat_statements" 2>/dev/null || true
-
-  if [ -n "${HARNESS_TEMPLATE_DB:-}" ]; then
-    if $PSQL -tAc "SELECT 1 FROM pg_database WHERE datname = '$HARNESS_TEMPLATE_DB'" | grep -q 1; then
-      log "Template database '$HARNESS_TEMPLATE_DB' already exists. Skipping creation."
-    else
-      log "Creating template database '$HARNESS_TEMPLATE_DB'..."
-      $PSQL -c "CREATE DATABASE $HARNESS_TEMPLATE_DB"
-
-      if [ -n "${HARNESS_DB_MIGRATE_CMD:-}" ] && [ "$HARNESS_DB_MIGRATE_CMD" != "echo 'TODO: set migrate command'" ]; then
-        log "Running migrations..."
-        PGPASSWORD=password PGHOST=localhost PGPORT="$DB_PORT" PGUSER=postgres \
-          PGDATABASE="$HARNESS_TEMPLATE_DB" \
-          bash -c "cd '$REPO_ROOT' && $HARNESS_DB_MIGRATE_CMD"
-      fi
-
-      if [ -n "${HARNESS_DB_SEED_CMD:-}" ] && [ "$HARNESS_DB_SEED_CMD" != "echo 'TODO: set seed command'" ]; then
-        log "Running seeds..."
-        PGPASSWORD=password PGHOST=localhost PGPORT="$DB_PORT" PGUSER=postgres \
-          PGDATABASE="$HARNESS_TEMPLATE_DB" \
-          bash -c "cd '$REPO_ROOT' && $HARNESS_DB_SEED_CMD"
-      fi
-
-      log "Marking '$HARNESS_TEMPLATE_DB' as a PostgreSQL template..."
-      $PSQL -c "UPDATE pg_database SET datistemplate = true WHERE datname = '$HARNESS_TEMPLATE_DB'"
-      log "Template database ready: $HARNESS_TEMPLATE_DB"
-    fi
-  fi
-fi
-
-# Shared app services — supporting services of a monolith/monorepo that agents
-# depend on but do not modify. Started ONCE on fixed ports, shared by all slots.
-# Create .har/ecosystem.shared.config.cjs (PM2 format, processes named
-# "har-${HARNESS_PROJECT_NAME}-shared-<name>") only when the primary app needs
-# sibling services running.
-SHARED_ECOSYSTEM="$SCRIPT_DIR/ecosystem.shared.config.cjs"
-if [ -f "$SHARED_ECOSYSTEM" ]; then
-  log "Starting shared app services from ecosystem.shared.config.cjs..."
-  (cd "$REPO_ROOT" && $(har_pkg_exec) pm2 startOrReload "$SHARED_ECOSYSTEM" >/dev/null)
-  log "Shared app services running (pm2 ls | grep har-${HARNESS_PROJECT_NAME}-shared-)."
-fi
-
-echo ""
-log "Infrastructure is ready."
-har_infra_enabled db               && log "  PostgreSQL: localhost:$DB_PORT"
-har_infra_enabled minio            && log "  MinIO:      http://localhost:${MINIO_CONSOLE_PORT}"
-har_infra_enabled headless-browser && log "  Browser:    http://localhost:${BROWSER_PORT}"
-har_infra_enabled mailpit          && log "  Mailpit:    http://localhost:${MAILPIT_WEB_PORT}"
-exit 0

package/dist/templates/har-boilerplate-cli/stages/README.sh

@@ -1,11 +0,0 @@
-#!/usr/bin/env bash
-# Per-stage scripts live here (e.g. ./.har/stages/browser-e2e.sh <agent-id>).
-#
-# Read .har/STAGES.md for the authoring guide: the stage script contract,
-# command vs script stages, and how verificationStages controls verify --full.
-#
-# Scaffold a new one with:
-#   har env add-stage <id> --custom --script
-
-echo "Add stage scripts under .har/stages/ and register them in stages.json — see .har/STAGES.md." >&2
-exit 1

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

@@ -1,66 +0,0 @@
-#!/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

@@ -1,210 +0,0 @@
-#!/usr/bin/env bash
-# Verification pipeline for CLI/library repos.
-# Outputs JSON to stdout (machine contract), human-readable progress to stderr.
-# Passing steps omit `output`. `har env verify` streams progress only.
-#
-# Usage: ./.har/verify.sh <agent-id> [--full]
-#
-# Quick (default): ecosystem smoke — compile/import/build only
-# Full (--full):   + conventional tests, lint, readiness, and every registered
-#                  stage in stages.json verificationStages (see .har/STAGES.md)
-# Stock steps are examples. Replace them during adaptation to match this repo.
-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." >&2
-  har_suggest_launch "$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
-REG_FILE="$(slot_registry_file "$AGENT_ID")"
-echo "    Work dir: ${WORK_DIR}" >&2
-echo "    Env file: ${ENV_FILE}" >&2
-if [ -f "$REG_FILE" ]; then
-  echo "    Registry: ${REG_FILE}" >&2
-else
-  echo "    Registry: missing (${REG_FILE})" >&2
-fi
-
-OVERALL_PASS=true
-START_TOTAL=$(now_ms)
-RESULTS_JSON="[]"
-
-run_step() {
-  local name="$1"
-  local cmd="$2"
-  local start end elapsed exit_code output
-
-  printf "  → %-40s" "$name..." >&2
-  start=$(now_ms)
-
-  set +e
-  output=$(cd "$WORK_DIR" && set -a && . "$ENV_FILE" && set +a && eval "$cmd" 2>&1)
-  exit_code=$?
-  set -e
-
-  end=$(now_ms)
-  elapsed=$(( end - start ))
-
-  local pass_bool
-  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
-
-  record_step_result "$name" "$pass_bool" "$elapsed" "$output"
-
-  if [ "$pass_bool" = "false" ] && [ -z "$FULL" ]; then
-    return 1
-  fi
-}
-
-node_package_script_exists() {
-  local script="$1"
-  "${NODE_BIN:-node}" -e "
-const fs = require('fs');
-const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
-const script = process.argv[1];
-process.exit(pkg.scripts && pkg.scripts[script] ? 0 : 1);
-" "$script"
-}
-
-run_node_script_or_skip() {
-  local name="$1"
-  local script="$2"
-  if node_package_script_exists "$script"; then
-    run_step "$name" "${NPM_BIN:-npm} run ${script}"
-  else
-    run_step "$name" "echo 'No ${script} script configured; skipping.'"
-  fi
-}
-
-run_node_quick_smoke() {
-  if node_package_script_exists typecheck; then
-    run_step "node-typecheck" '${NPM_BIN:-npm} run typecheck'
-  elif node_package_script_exists build; then
-    run_step "node-build" '${NPM_BIN:-npm} run build'
-  else
-    run_step "node-package-load" '${NODE_BIN:-node} -e "require(\"./package.json\")"'
-  fi
-}
-
-run_quick_smoke() {
-  case "${HARNESS_ECOSYSTEM:-none}" in
-    node)
-      run_node_quick_smoke
-      ;;
-    python)
-      run_step "python-compile" '${PYTHON_BIN:-python3} -m compileall -q .'
-      ;;
-    go)
-      run_step "go-build" '${GO_BIN:-go} build ./...'
-      ;;
-    rust)
-      run_step "rust-check" '${CARGO_BIN:-cargo} check'
-      ;;
-    java)
-      run_step "java-compile" 'if [ -x ./mvnw ]; then ./mvnw -q -DskipTests compile; elif command -v mvn >/dev/null 2>&1; then mvn -q -DskipTests compile; elif [ -x ./gradlew ]; then ./gradlew classes; elif command -v gradle >/dev/null 2>&1; then gradle classes; else echo "No Maven/Gradle command found; adapt verify.sh for this Java repo."; fi'
-      ;;
-    ruby)
-      run_step "ruby-smoke" '${RUBY_BIN:-ruby} -e "puts RUBY_VERSION"'
-      ;;
-    custom|none|*)
-      run_step "smoke-not-configured" 'echo "No stock smoke for HARNESS_ECOSYSTEM=${HARNESS_ECOSYSTEM:-none}; adapt .har/verify.sh for this repo."'
-      ;;
-  esac
-}
-
-run_full_checks() {
-  case "${HARNESS_ECOSYSTEM:-none}" in
-    node)
-      run_node_script_or_skip "unit-tests" test || true
-      run_node_script_or_skip "lint" lint || true
-      ;;
-    python)
-      run_step "unit-tests" 'if ${PYTHON_BIN:-python3} -c "import pytest" >/dev/null 2>&1; then ${PYTHON_BIN:-python3} -m pytest -q; else echo "pytest not installed; adapt verify.sh for this Python repo."; fi' || true
-      ;;
-    go)
-      run_step "unit-tests" '${GO_BIN:-go} test ./...' || true
-      ;;
-    rust)
-      run_step "unit-tests" '${CARGO_BIN:-cargo} test' || true
-      ;;
-    java)
-      run_step "unit-tests" 'if [ -x ./mvnw ]; then ./mvnw -q test; elif command -v mvn >/dev/null 2>&1; then mvn -q test; elif [ -x ./gradlew ]; then ./gradlew test; elif command -v gradle >/dev/null 2>&1; then gradle test; else echo "No Maven/Gradle command found; adapt verify.sh for this Java repo."; fi' || true
-      ;;
-    ruby)
-      run_step "unit-tests" 'if command -v "${BUNDLE_BIN:-bundle}" >/dev/null 2>&1 && [ -f Gemfile ]; then "${BUNDLE_BIN:-bundle}" exec rake test 2>/dev/null || "${BUNDLE_BIN:-bundle}" exec rspec; else echo "No Ruby test command detected; adapt verify.sh for this Ruby repo."; fi' || true
-      ;;
-    custom|none|*)
-      run_step "unit-tests" 'echo "No stock full checks for HARNESS_ECOSYSTEM=${HARNESS_ECOSYSTEM:-none}; adapt .har/verify.sh for this repo."' || true
-      ;;
-  esac
-}
-
-# ── Verification stages ─────────────────────────────────────────────────────
-# These stock steps are intentionally generic conventions. Adapt this section
-# to the repository's real commands from package.json, Makefile, CI, pyproject,
-# Cargo.toml, go.mod, pom.xml, etc.
-run_quick_smoke || { [ -z "$FULL" ] && true; }
-
-if [ -n "$FULL" ]; then
-  run_full_checks
-  run_step "readiness" "run_readiness_if_configured \"$AGENT_ID\"" || true
-  # Registered verification stages from .har/stages.json (see .har/STAGES.md).
-  # Every stage listed in verificationStages with a registered script/command
-  # runs here -- plugins and custom stages alike.
-  while IFS=$'\t' read -r STAGE_ID STAGE_CMD; do
-    [ -n "$STAGE_ID" ] || continue
-    run_step "$STAGE_ID" "$STAGE_CMD" || true
-  done < <(list_registered_verification_stage_commands "$SCRIPT_DIR" "$AGENT_ID")
-fi
-
-END_TOTAL=$(now_ms)
-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

@@ -1,63 +0,0 @@
-# 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
-
-- `AGENTS.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`). |
-
-If the project is generated (`Project.swift`, `project.yml`, or a `Podfile` with no
-tracked `.xcworkspace`), still set the path the generator produces — launch runs
-`tuist generate` / `xcodegen generate` / `pod install` when the file is absent from
-a fresh worktree. Use `HARNESS_INSTALL_CMD` only when that default is wrong; it then
-owns provisioning outright.
-
-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-plugin rocketsim`) rather than xcodebuild tests.
-
-## 4 — Add the RocketSim plugin (recommended)
-
-```bash
-har env add-plugin 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 `AGENTS.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

@@ -1,90 +0,0 @@
-# Agent ${AGENT_ID} — iOS Development Environment
-
-> [`AGENTS.md`](../AGENTS.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** | Created for this slot at launch — `HARNESS_SIMULATOR_UDID` in `.env.agent.${AGENT_ID}` |
-| **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. An occupied slot always blocks a new launch — run `har env teardown <id>` (or `complete <id>`) first, then launch again.
-
-```bash
-./.har/agent-cli.sh ${AGENT_ID} status
-```
-
-## Readiness
-
-Adapt this section for the repository. A successful build/test run does not
-always mean an agent can use the app. If the app needs a backend, credentials,
-seeded data, or a simulator flow, document it here and wire the smoke into
-`HARNESS_READINESS_CMD`, RocketSim flows, or full verify.
-
-## 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`)
-- [ ] The slot is agent-usable for this repo's documented smoke workflow when runtime services are involved
-- [ ] 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
-- [ ] Present session handoff (summary, branch, preview URLs) and **wait for user** before `complete`, push, or PR
-- [ ] On user approval of the default: push + open PR (when `gh`/GitHub MCP available), then `har env complete ${AGENT_ID}` (or MCP `har_complete_environment`) — full verify + validation + teardown, branch kept
-
-### Session handoff
-
-After full verify and commit, stop and propose next steps. Never autonomously run
-`complete`, `teardown`, `git push`, or open a PR. **Default recommendation:** when
-`gh` or GitHub MCP is available, complete the slot **and** open a PR (push → PR →
-`har env complete` / `har_complete_environment`). Offer complete-only or something
-else as alternatives. If PR tooling is unavailable, recommend complete and report
-the session branch for a manual push. Prefer `complete` over bare `teardown` when
-the work succeeded. See `.cursor/rules/har-workflow.mdc` for the handoff shape.
-
-Quick loop: MCP `har_run_verification`, `har env verify ${AGENT_ID}`, or `./.har/verify.sh ${AGENT_ID}`
-
-Stages are the harness's single vocabulary for checks: templates and custom stages compile to generic kinds in `.har/stages.json`, and you interact with them only through the registry (`har_run_stage`, `verify`), never stack-specific tooling. Authoring guide: `.har/STAGES.md`.
-
-## Project commands
-
-Target **this slot's** simulator, never `booted` — another agent's device may also
-be booted. `HARNESS_IOS_DESTINATION` and `HARNESS_SIMULATOR_UDID` come from
-`.env.agent.${AGENT_ID}`.
-
-```bash
-source .env.agent.${AGENT_ID}
-
-# Build
-xcodebuild build -scheme MyApp -destination "$HARNESS_IOS_DESTINATION" CODE_SIGNING_ALLOWED=NO
-
-# Run unit tests — signed, or an app with entitlements traps at launch
-xcodebuild test -scheme MyApp -destination "$HARNESS_IOS_DESTINATION"
-
-# Install and launch on this slot's device
-./.har/agent-cli.sh ${AGENT_ID} install path/to/MyApp.app
-./.har/agent-cli.sh ${AGENT_ID} launch-app
-```
-
-Adapt for your scheme — see `.har/harness.env`.
-
-## User-flow validation (RocketSim)
-
-If the RocketSim plugin is installed (`har env add-plugin 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