@osfactory/har 0.14.0 → 0.15.0

package/dist/prompts/system-authoring.md

@@ -127,7 +127,7 @@ Document ports in `.har/README.md` and configure them in `.har/harness.env`. Res
 
 CLI and iOS profiles typically have no per-slot app ports; optional backends still use the shared-infra model.
 
-Set slot limits in `.har/stages.json` (`agentSlots`) and `.har/harness.env` (`HARNESS_AGENT_SLOT_MIN` / `HARNESS_AGENT_SLOT_MAX`) based on machine capacity.
+Set slot limits in `.har/stages.json` (`agentSlots`) based on machine capacity. `har env maintain --finalize` syncs legacy `HARNESS_AGENT_SLOT_*` exports in `harness.env`.
 
 ### Do not
 

package/dist/templates/adaptation-prompt-init.md

@@ -153,7 +153,7 @@ Document and configure ports in `.har/harness.env` and `.har/README.md`. Use the
 | Mailpit | `HARNESS_MAILPIT_*_PORT_DEFAULT` | Scan configured ranges |
 | Headless browser | `HARNESS_BROWSER_PORT_DEFAULT` | Scan configured ranges |
 
-Set slot limits in `.har/stages.json` (`agentSlots`) and `.har/harness.env` (`HARNESS_AGENT_SLOT_MIN` / `HARNESS_AGENT_SLOT_MAX`) based on machine capacity.
+Set slot limits in `.har/stages.json` (`agentSlots`) based on machine capacity. `har env maintain --finalize` syncs legacy `HARNESS_AGENT_SLOT_*` exports in `harness.env`.
 
 **Port / infra checklist:**
 

package/dist/templates/cursor-rule.mdc.template

@@ -15,8 +15,8 @@ work around it with ad-hoc commands.
 
 ## Before making changes
 
-1. **Launch your slot FIRST — before editing any file.** Use `har_launch_environment` with `agentId: 1` (MCP), `har env launch 1`, or `./.har/launch.sh 1`. Launch always creates a **fresh session worktree** from the current HEAD and returns its **work dir**.
-2. **Make ALL file edits under the returned work dir — never in the main checkout.** The work dir looks like `~/worktrees/<base-branch>-<sha4>-har-agent-<id>-<rand4>` (recorded in `.har/slots/agent-<id>.json`). Edits there hot-reload in the running slot; use `./.har/agent-cli.sh <id> restart` if a change doesn't take.
+1. **Launch your slot FIRST — before editing any file.** Use `har_launch_environment` with `agentId: 1` (MCP) or `har env launch 1`. Launch always creates a **fresh session worktree** from the current HEAD and returns its **work dir**.
+2. **Make ALL file edits under the returned work dir — never in the main checkout.** The work dir looks like `~/worktrees/<base-branch>-<sha4>-har-agent-<id>-<rand4>` (recorded in `.har/slots/agent-<id>.json`). Edits there hot-reload in the running slot; use `har env restart <id>` or `./.har/agent-cli.sh <id> restart` if a change doesn't take.
 3. Read [AGENT.md](./AGENT.md) at the repo root
 4. Read [.har/README.md](./.har/README.md) and [.har/stages.json](./.har/stages.json)
 5. After launch, read [.har/CLAUDE.agent.md](./.har/CLAUDE.agent.md) for slot URLs and definition of done
@@ -26,7 +26,7 @@ Relaunching a slot **replaces** its previous session (the old branch is kept). R
 ### Slot safety (read before launch)
 
 - **One slot ≈ one task** — do not share slot 1 across unrelated chats; use slot 2+ for parallel work.
-- **Call `har_get_status` / `./.har/agent-cli.sh <id> status`** before launch when a slot may be occupied.
+- **Call `har_get_status` / `har env status`** before launch when a slot may be occupied.
 - **Never** set `force`/`confirmReplace` without the user explicitly approving replacement.
 - **Commit early and often** in the session worktree — teardown keeps the branch, not uncommitted work.
 - **Gitignored paths are ephemeral** (`state/`, `runs/`, local clones) — they are lost when the worktree is removed.

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

@@ -115,7 +115,7 @@ Always use `./.har/agent-cli.sh <id> ...` — never hardcoded ports.
 
 Each agent slot gets isolated app ports. Defaults follow `BASE + (AGENT_ID × HARNESS_PORT_STEP)`; when a default is busy, `launch.sh` scans the slot lane (`STEP` increments) and writes the resolved ports to `.env.agent.<id>` and `.har/slots/agent-<id>.json`.
 
-Configure how many slots your machine can run in parallel in `stages.json` (`agentSlots`) and `harness.env` (`HARNESS_AGENT_SLOT_MIN` / `HARNESS_AGENT_SLOT_MAX`). Keep both in sync.
+Configure how many slots your machine can run in parallel in `.har/stages.json` (`agentSlots`). Bash scripts and the CLI read that first; `harness.env` keeps legacy `HARNESS_AGENT_SLOT_*` exports in sync via `har env maintain --finalize`.
 
 | Service | Agent 1 (default) | Agent 2 (default) |
 |---------|-------------------|-------------------|

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

@@ -116,7 +116,7 @@ process.stdin.on('end', () => {
       echo "  API:       http://localhost:${API_PORT}"
     else
       echo "No active environment for agent ${AGENT_ID}"
-      echo "  Run: ./.har/launch.sh ${AGENT_ID}"
+      har_suggest_launch "$AGENT_ID"
     fi
     ;;
 

package/dist/templates/har-boilerplate/agent-slot.sh

@@ -5,13 +5,50 @@
 #   source "$SCRIPT_DIR/agent-slot.sh"
 #   validate_agent_id "$AGENT_ID"
 
+# Canonical slot limits live in stages.json (agentSlots); harness.env is legacy fallback.
+har_load_agent_slot_limits() {
+  local registry="${SCRIPT_DIR}/stages.json"
+  if [[ -f "$registry" ]]; then
+    local parsed
+    parsed="$(node -e '
+try {
+  const slots = JSON.parse(require("fs").readFileSync(process.argv[1], "utf8")).agentSlots;
+  if (slots && Number.isInteger(slots.min) && Number.isInteger(slots.max)) {
+    process.stdout.write(String(slots.min) + " " + String(slots.max));
+  }
+} catch {}
+' "$registry" 2>/dev/null || true)"
+    if [[ -n "$parsed" ]]; then
+      HARNESS_AGENT_SLOT_MIN="${parsed%% *}"
+      HARNESS_AGENT_SLOT_MAX="${parsed#* }"
+      export HARNESS_AGENT_SLOT_MIN HARNESS_AGENT_SLOT_MAX
+      return 0
+    fi
+  fi
+}
+
+har_suggest_launch() {
+  local id="$1"
+  echo "  Launch: har env launch ${id}     # or har_launch_environment (MCP)" >&2
+  echo "  Fallback: ./.har/launch.sh ${id}  # when har CLI/MCP unavailable" >&2
+}
+
+har_suggest_status() {
+  local id="${1:-}"
+  echo "  Status: har env status           # or har_get_status (MCP)" >&2
+  if [[ -n "$id" ]]; then
+    echo "  Fallback: ./.har/agent-cli.sh ${id} status" >&2
+  fi
+}
+
 validate_agent_id() {
   local id="${1:-}"
+  har_load_agent_slot_limits
   local min="${HARNESS_AGENT_SLOT_MIN:-1}"
   local max="${HARNESS_AGENT_SLOT_MAX:-}"
 
   if [[ -z "$max" ]]; then
-    echo "Error: HARNESS_AGENT_SLOT_MAX is not set in harness.env" >&2
+    echo "Error: configure agentSlots in .har/stages.json or HARNESS_AGENT_SLOT_MAX in harness.env" >&2
     exit 1
   fi
 

package/dist/templates/har-boilerplate/gitignore.template

@@ -0,0 +1,15 @@
+# Ephemeral harness output — safe to delete
+logs/
+runs/
+validations/
+artifacts/
+state/
+maintain/
+ADAPT-PROMPT.md
+AGENT.md.proposed
+AGENT.md.proposed.meta.json
+slots/
+
+# Generated by launch.sh (also listed in repo-root .gitignore)
+.env.agent.*
+ecosystem.agent.*.config.cjs

package/dist/templates/har-boilerplate/harness.env

@@ -42,7 +42,8 @@ export HARNESS_MAILPIT_SMTP_PORT_DEFAULT=11025
 export HARNESS_MAILPIT_SMTP_PORT_SCAN_START=11025
 export HARNESS_MAILPIT_SMTP_PORT_SCAN_END=11099
 
-# Agent slot limits — set based on what your machine can run in parallel
+# Agent slot limits — canonical source: .har/stages.json (agentSlots).
+# Legacy fallback below; har env maintain --finalize syncs these from stages.json.
 export HARNESS_AGENT_SLOT_MIN=1
 export HARNESS_AGENT_SLOT_MAX=5
 

package/dist/templates/har-boilerplate/launch.sh

@@ -35,6 +35,7 @@ for arg in "$@"; do
 done
 
 if [[ -z "$AGENT_ID" ]]; then
+  har_load_agent_slot_limits
   echo "Usage: $0 <agent-id> [--no-worktree] [--claude] [--replace] [--force] [--resume] [--purpose=label]" >&2
   echo "  agent-id must be between ${HARNESS_AGENT_SLOT_MIN} and ${HARNESS_AGENT_SLOT_MAX}" >&2
   exit 1
@@ -78,7 +79,7 @@ if [ "$RESUME" = true ]; then
         write_slot_registry
       log "  Work dir:  ${WORK_DIR}"
       log "  Env file:  ${ENV_FILE}"
-      log "  Recovery:  ./.har/launch.sh ${AGENT_ID} --resume"
+      log "  Recovery:  har env launch ${AGENT_ID} --resume  # or ./.har/launch.sh ${AGENT_ID} --resume"
     fi
   }
   trap mark_slot_failed EXIT
@@ -186,7 +187,7 @@ if [ "$RESUME" != true ]; then
         write_slot_registry
       log "  Work dir:  ${WORK_DIR}"
       log "  Env file:  ${ENV_FILE}"
-      log "  Recovery:  ./.har/launch.sh ${AGENT_ID} --resume"
+      log "  Recovery:  har env launch ${AGENT_ID} --resume  # or ./.har/launch.sh ${AGENT_ID} --resume"
     fi
   }
   trap mark_slot_failed EXIT

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

@@ -30,7 +30,8 @@ validate_agent_id "$AGENT_ID"
 API_PORT=$(( HARNESS_API_BASE_PORT + AGENT_ID * 10 ))
 
 ENV_FILE="$(resolve_agent_env_file "$AGENT_ID" "$REPO_ROOT")" || {
-  echo "No .env.agent.${AGENT_ID} found. Run: ./.har/launch.sh ${AGENT_ID}" >&2
+  echo "No .env.agent.${AGENT_ID} found." >&2
+  har_suggest_launch "$AGENT_ID" >&2
   exit 1
 }
 

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

@@ -25,7 +25,7 @@ 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
+    har_suggest_launch "$AGENT_ID"
     exit 1
   }
   # shellcheck source=/dev/null
@@ -54,7 +54,7 @@ case "$COMMAND" in
       [ -n "$WT" ] && echo "  Git:       $(slot_dirty_summary "$WT")"
     else
       echo "No active environment for agent ${AGENT_ID}"
-      echo "  Run: ./.har/launch.sh ${AGENT_ID}"
+      har_suggest_launch "$AGENT_ID"
     fi
     ;;
 

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

@@ -5,13 +5,50 @@
 #   source "$SCRIPT_DIR/agent-slot.sh"
 #   validate_agent_id "$AGENT_ID"
 
+# Canonical slot limits live in stages.json (agentSlots); harness.env is legacy fallback.
+har_load_agent_slot_limits() {
+  local registry="${SCRIPT_DIR}/stages.json"
+  if [[ -f "$registry" ]]; then
+    local parsed
+    parsed="$(node -e '
+try {
+  const slots = JSON.parse(require("fs").readFileSync(process.argv[1], "utf8")).agentSlots;
+  if (slots && Number.isInteger(slots.min) && Number.isInteger(slots.max)) {
+    process.stdout.write(String(slots.min) + " " + String(slots.max));
+  }
+} catch {}
+' "$registry" 2>/dev/null || true)"
+    if [[ -n "$parsed" ]]; then
+      HARNESS_AGENT_SLOT_MIN="${parsed%% *}"
+      HARNESS_AGENT_SLOT_MAX="${parsed#* }"
+      export HARNESS_AGENT_SLOT_MIN HARNESS_AGENT_SLOT_MAX
+      return 0
+    fi
+  fi
+}
+
+har_suggest_launch() {
+  local id="$1"
+  echo "  Launch: har env launch ${id}     # or har_launch_environment (MCP)" >&2
+  echo "  Fallback: ./.har/launch.sh ${id}  # when har CLI/MCP unavailable" >&2
+}
+
+har_suggest_status() {
+  local id="${1:-}"
+  echo "  Status: har env status           # or har_get_status (MCP)" >&2
+  if [[ -n "$id" ]]; then
+    echo "  Fallback: ./.har/agent-cli.sh ${id} status" >&2
+  fi
+}
+
 validate_agent_id() {
   local id="${1:-}"
+  har_load_agent_slot_limits
   local min="${HARNESS_AGENT_SLOT_MIN:-1}"
   local max="${HARNESS_AGENT_SLOT_MAX:-}"
 
   if [[ -z "$max" ]]; then
-    echo "Error: HARNESS_AGENT_SLOT_MAX is not set in harness.env" >&2
+    echo "Error: configure agentSlots in .har/stages.json or HARNESS_AGENT_SLOT_MAX in harness.env" >&2
     exit 1
   fi
 

package/dist/templates/har-boilerplate-cli/gitignore.template

@@ -0,0 +1,15 @@
+# Ephemeral harness output — safe to delete
+logs/
+runs/
+validations/
+artifacts/
+state/
+maintain/
+ADAPT-PROMPT.md
+AGENT.md.proposed
+AGENT.md.proposed.meta.json
+slots/
+
+# Generated by launch.sh (also listed in repo-root .gitignore)
+.env.agent.*
+ecosystem.agent.*.config.cjs

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

@@ -33,6 +33,7 @@ for arg in "$@"; do
 done
 
 if [[ -z "$AGENT_ID" ]]; then
+  har_load_agent_slot_limits
   echo "Usage: $0 <agent-id> [--no-worktree] [--replace] [--force] [--resume] [--purpose=label]" >&2
   echo "  agent-id must be between ${HARNESS_AGENT_SLOT_MIN} and ${HARNESS_AGENT_SLOT_MAX}" >&2
   exit 1
@@ -74,7 +75,7 @@ if [ "$RESUME" = true ]; then
         write_slot_registry
       log "  Work dir:  ${WORK_DIR}"
       log "  Env file:  ${ENV_FILE}"
-      log "  Recovery:  ./.har/launch.sh ${AGENT_ID} --resume"
+      log "  Recovery:  har env launch ${AGENT_ID} --resume  # or ./.har/launch.sh ${AGENT_ID} --resume"
     fi
   }
   trap mark_slot_failed EXIT
@@ -145,7 +146,7 @@ if [ "$RESUME" != true ]; then
         write_slot_registry
       log "  Work dir:  ${WORK_DIR}"
       log "  Env file:  ${ENV_FILE}"
-      log "  Recovery:  ./.har/launch.sh ${AGENT_ID} --resume"
+      log "  Recovery:  har env launch ${AGENT_ID} --resume  # or ./.har/launch.sh ${AGENT_ID} --resume"
     fi
   }
   trap mark_slot_failed EXIT

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

@@ -28,7 +28,8 @@ 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
+  echo "No .env.agent.${AGENT_ID} found." >&2
+  har_suggest_launch "$AGENT_ID" >&2
   exit 1
 }
 

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/agent-cli.sh

@@ -23,7 +23,7 @@ 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
+    har_suggest_launch "$AGENT_ID"
     exit 1
   }
   # shellcheck source=/dev/null
@@ -46,7 +46,7 @@ case "$COMMAND" in
       echo "  Bundle ID: ${HARNESS_BUNDLE_ID:-not set}"
     else
       echo "No active environment for agent ${AGENT_ID}"
-      echo "  Run: ./.har/launch.sh ${AGENT_ID}"
+      har_suggest_launch "$AGENT_ID"
     fi
     ;;
 

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

@@ -5,13 +5,50 @@
 #   source "$SCRIPT_DIR/agent-slot.sh"
 #   validate_agent_id "$AGENT_ID"
 
+# Canonical slot limits live in stages.json (agentSlots); harness.env is legacy fallback.
+har_load_agent_slot_limits() {
+  local registry="${SCRIPT_DIR}/stages.json"
+  if [[ -f "$registry" ]]; then
+    local parsed
+    parsed="$(node -e '
+try {
+  const slots = JSON.parse(require("fs").readFileSync(process.argv[1], "utf8")).agentSlots;
+  if (slots && Number.isInteger(slots.min) && Number.isInteger(slots.max)) {
+    process.stdout.write(String(slots.min) + " " + String(slots.max));
+  }
+} catch {}
+' "$registry" 2>/dev/null || true)"
+    if [[ -n "$parsed" ]]; then
+      HARNESS_AGENT_SLOT_MIN="${parsed%% *}"
+      HARNESS_AGENT_SLOT_MAX="${parsed#* }"
+      export HARNESS_AGENT_SLOT_MIN HARNESS_AGENT_SLOT_MAX
+      return 0
+    fi
+  fi
+}
+
+har_suggest_launch() {
+  local id="$1"
+  echo "  Launch: har env launch ${id}     # or har_launch_environment (MCP)" >&2
+  echo "  Fallback: ./.har/launch.sh ${id}  # when har CLI/MCP unavailable" >&2
+}
+
+har_suggest_status() {
+  local id="${1:-}"
+  echo "  Status: har env status           # or har_get_status (MCP)" >&2
+  if [[ -n "$id" ]]; then
+    echo "  Fallback: ./.har/agent-cli.sh ${id} status" >&2
+  fi
+}
+
 validate_agent_id() {
   local id="${1:-}"
+  har_load_agent_slot_limits
   local min="${HARNESS_AGENT_SLOT_MIN:-1}"
   local max="${HARNESS_AGENT_SLOT_MAX:-}"
 
   if [[ -z "$max" ]]; then
-    echo "Error: HARNESS_AGENT_SLOT_MAX is not set in harness.env" >&2
+    echo "Error: configure agentSlots in .har/stages.json or HARNESS_AGENT_SLOT_MAX in harness.env" >&2
     exit 1
   fi
 

package/dist/templates/har-boilerplate-ios/gitignore.template

@@ -0,0 +1,16 @@
+# Ephemeral harness output — safe to delete
+logs/
+runs/
+validations/
+artifacts/
+AGENT.md.proposed
+AGENT.md.proposed.meta.json
+maintain/
+ADAPT-PROMPT.md
+slots/
+
+# Generated by launch.sh
+.env.agent.*
+
+# Xcode build artifacts (harness-specific DerivedData)
+build/DerivedData

package/dist/templates/har-boilerplate-ios/launch.sh

@@ -31,6 +31,7 @@ for arg in "$@"; do
 done
 
 if [[ -z "$AGENT_ID" ]]; then
+  har_load_agent_slot_limits
   echo "Usage: $0 <agent-id> [--no-worktree] [--replace] [--force] [--purpose=label]" >&2
   echo "  agent-id must be between ${HARNESS_AGENT_SLOT_MIN} and ${HARNESS_AGENT_SLOT_MAX}" >&2
   exit 1

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

@@ -28,7 +28,8 @@ 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
+  echo "No .env.agent.${AGENT_ID} found." >&2
+  har_suggest_launch "$AGENT_ID" >&2
   exit 1
 }
 

package/dist/templates/stage-templates/custom-stage-skeleton.sh

@@ -25,7 +25,8 @@ AGENT_ID="${1:?Usage: __STAGE_ID__.sh <agent-id> [extra args...]}"
 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
+  echo "No .env.agent.${AGENT_ID} found." >&2
+  har_suggest_launch "$AGENT_ID" >&2
   exit 1
 }
 set -a

package/dist/templates/stage-templates/playwright/.har/stages/browser-e2e.sh

@@ -21,7 +21,8 @@ validate_agent_id "$AGENT_ID"
 log() { echo "==> [browser-e2e agent-$AGENT_ID] $*" >&2; }
 
 ENV_FILE="$(resolve_agent_env_file "$AGENT_ID" "$REPO_ROOT")" || {
-  echo "No .env.agent.${AGENT_ID} found. Run: ./.har/launch.sh ${AGENT_ID}" >&2
+  echo "No .env.agent.${AGENT_ID} found." >&2
+  har_suggest_launch "$AGENT_ID" >&2
   exit 1
 }
 

package/dist/templates/stage-templates/rocketsim/.har/stages/rocketsim-flows.sh

@@ -42,7 +42,8 @@ fi
 
 # ── Resolve agent env ─────────────────────────────────────────────────────────
 ENV_FILE="$(resolve_agent_env_file "$AGENT_ID" "$REPO_ROOT")" || {
-  echo "No .env.agent.${AGENT_ID} found. Run: ./.har/launch.sh ${AGENT_ID}" >&2
+  echo "No .env.agent.${AGENT_ID} found." >&2
+  har_suggest_launch "$AGENT_ID" >&2
   exit 1
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osfactory/har",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "LLM-powered CLI for reproducible agent development environments",
   "keywords": [
     "har",