@osfactory/har 0.64.1 → 1.0.0-rc.1

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

@@ -1,22 +0,0 @@
-#!/usr/bin/env bash
-# Attach to the tmux session for an agent.
-#
-# Usage: ./.har/attach.sh <agent-id>
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck source=/dev/null
-source "$SCRIPT_DIR/harness.env"
-# shellcheck source=/dev/null
-source "$SCRIPT_DIR/agent-slot.sh"
-
-AGENT_ID="${1:?Usage: attach.sh <agent-id>}"
-SESSION="$(har_tmux_session "$AGENT_ID")"
-
-if ! tmux has-session -t "$SESSION" 2>/dev/null; then
-  echo "No tmux session found: $SESSION" >&2
-  echo "Launch with: ./.har/launch.sh ${AGENT_ID} --claude" >&2
-  exit 1
-fi
-
-exec tmux attach -t "$SESSION"

package/dist/templates/har-boilerplate/ecosystem.agent.template.cjs

@@ -1,52 +0,0 @@
-/**
- * PM2 Ecosystem Configuration for Agent ${AGENT_ID}
- *
- * Auto-generated by launch.sh — do not edit manually.
- * Customize ecosystem.agent.template.cjs in .har/ to change processes.
- */
-
-// launch.sh writes this file (and .env.agent.N) to the work dir root,
-// so __dirname IS the work dir — repo root or the agent's git worktree.
-const fs = require('fs');
-const path = require('path');
-
-const agentEnvPath = path.resolve(__dirname, '.env.agent.${AGENT_ID}');
-const env = {};
-try {
-  for (const line of fs.readFileSync(agentEnvPath, 'utf8').split('\n')) {
-    const m = line.match(/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*?)\s*$/);
-    if (m && !line.trimStart().startsWith('#')) env[m[1]] = m[2].replace(/^["']|["']$/g, '');
-  }
-} catch {}
-
-module.exports = {
-  apps: [
-    // TODO: Replace with the PRIMARY application's dev processes — the ONE app
-    // agents modify (HARNESS_PRIMARY_APP in harness.env). In a monolith or
-    // monorepo with several services, do NOT start them all here: supporting
-    // services the agent depends on but does not change run ONCE for all slots,
-    // either as compose services in docker-compose.agent.yml or via an optional
-    // .har/ecosystem.shared.config.cjs (started by setup-infra.sh, processes
-    // named "har-shared-<name>", fixed ports). A primary app may still need two
-    // processes (e.g. api + frontend) — add one entry per process.
-    // Example Node dev process. Replace with this repo's actual primary app
-    // command (Rails, Django, Go, Java, etc. should not keep this npm entry).
-    {
-      name: 'har-${HARNESS_PROJECT_NAME}-agent-${AGENT_ID}-api',
-      script: 'npm',
-      args: 'run dev',
-      interpreter: 'none',
-      cwd: __dirname,
-      env: {
-        ...env,
-        NODE_ENV: 'development',
-        PORT: env.API_PORT || env.PORT,
-      },
-      watch: false,
-      autorestart: true,
-      kill_timeout: 5000,
-      merge_logs: true,
-      time: true,
-    },
-  ],
-};

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

@@ -1,40 +0,0 @@
-# Agent environment — generated by launch.sh from env.template
-# DO NOT EDIT — regenerated on every launch
-AGENT_ID=${AGENT_ID}
-
-# Ports (allocated at launch — may differ from BASE + AGENT_ID × STEP when busy)
-PORT=${API_PORT}
-FE_PORT=${FE_PORT}
-API_PORT=${API_PORT}
-DEBUG_PORT=${DEBUG_PORT}
-
-# PostgreSQL
-PGHOST=localhost
-PGPORT=${DB_PORT}
-PGDATABASE=agent_${AGENT_ID}
-PGUSER=postgres
-PGPASSWORD=password
-DATABASE_URL=postgresql://postgres:password@localhost:${DB_PORT}/agent_${AGENT_ID}
-
-# Application
-NODE_ENV=development
-SITE_URL=http://localhost:${API_PORT}
-CORS_ORIGIN=http://localhost:${FE_PORT}
-
-# MinIO / S3 (if enabled)
-S3_ENDPOINT=http://localhost:${MINIO_PORT}
-S3_ACCESS_KEY=minioadmin
-S3_SECRET_KEY=minioadmin
-S3_BUCKET=agent-${AGENT_ID}
-S3_REGION=us-east-1
-S3_FORCE_PATH_STYLE=true
-
-# Headless browser (if enabled)
-HEADLESS_BROWSER_URL=http://localhost:${BROWSER_PORT}
-
-# Toolchain paths — appended by provision-toolchain.sh during launch
-# NODE_BIN=  NPM_BIN=  PYTHON_BIN=  VIRTUAL_ENV=  GO_BIN=  CARGO_BIN=  JAVA_HOME=
-
-# Mail (if enabled)
-SMTP_HOST=localhost
-SMTP_PORT=11025

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

@@ -1,323 +0,0 @@
-#!/usr/bin/env bash
-# Launches a single agent instance with isolated ports, database, and PM2 processes.
-# Every launch starts a FRESH session: any previous session for the slot is torn
-# down (its branch is kept) and a new suffixed worktree is created from HEAD.
-# Occupied slots always block: run ./.har/teardown.sh (or complete it) first, then relaunch.
-#
-# Usage: ./.har/launch.sh <agent-id> [--no-worktree] [--claude] [--resume]
-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:-}"
-USE_WORKTREE="${HARNESS_USE_WORKTREE:-true}"
-USE_CLAUDE=false
-RESUME=false
-WORK_UNIT_ID="${HAR_WORK_UNIT_ID:-}"
-ATTEMPT_ID="${HAR_ATTEMPT_ID:-}"
-
-for arg in "$@"; do
-  case "$arg" in
-    --no-worktree) USE_WORKTREE=false ;;
-    --worktree) USE_WORKTREE=true ;;
-    --claude)   USE_CLAUDE=true ;;
-    --resume)   RESUME=true ;;
-    --work-id=*) WORK_UNIT_ID="${arg#*=}" ;;
-    --attempt-id=*) ATTEMPT_ID="${arg#*=}" ;;
-  esac
-done
-
-if [[ -n "$WORK_UNIT_ID" && -z "$ATTEMPT_ID" ]]; then
-  ATTEMPT_ID="$(node -e 'process.stdout.write(require("crypto").randomUUID())')"
-fi
-export SLOT_WORK_UNIT_ID="$WORK_UNIT_ID"
-export SLOT_ATTEMPT_ID="$ATTEMPT_ID"
-
-if [[ -z "$AGENT_ID" ]]; then
-  har_load_agent_slot_limits
-  echo "Usage: $0 <agent-id> [--no-worktree] [--claude] [--resume]" >&2
-  echo "  agent-id must be between ${HARNESS_AGENT_SLOT_MIN} and ${HARNESS_AGENT_SLOT_MAX}" >&2
-  exit 1
-fi
-
-validate_agent_id "$AGENT_ID"
-
-log() { echo "==> [agent-$AGENT_ID] $*" >&2; }
-
-WORK_DIR="$REPO_ROOT"
-WORKTREE_DIR=""
-BRANCH=""
-SUFFIX=""
-BASE_BRANCH=""
-BASE_COMMIT=""
-ENV_FILE=""
-REGISTRY_WRITTEN=false
-
-if [ "$RESUME" = true ]; then
-  har_launch_preflight "$AGENT_ID" true || exit $?
-  eval "$(har_resume_session_assignments "$AGENT_ID")"
-  REGISTRY_WRITTEN=true
-  mark_slot_failed() {
-    local exit_code="$?"
-    if [ "$exit_code" != "0" ] && [ "$REGISTRY_WRITTEN" = true ]; then
-      log "Resume failed. Recording failed slot state..."
-      set +e
-      SLOT_AGENT_ID="$AGENT_ID" \
-      SLOT_MODE="$([ "$USE_WORKTREE" = true ] && echo worktree || echo root)" \
-      SLOT_WORK_DIR="$WORK_DIR" \
-      SLOT_SUFFIX="${SUFFIX:-}" \
-      SLOT_WORKTREE_PATH="${WORKTREE_DIR:-}" \
-      SLOT_BRANCH="${BRANCH:-}" \
-      SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
-      SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-      SLOT_PORTS_JSON="{\"frontend\":${FE_PORT},\"api\":${API_PORT},\"debug\":${DEBUG_PORT},\"db\":${DB_PORT}}" \
-      SLOT_PREVIEW_URLS_JSON="{\"frontend\":\"http://localhost:${FE_PORT}\",\"api\":\"http://localhost:${API_PORT}\"}" \
-      SLOT_STATUS="failed" \
-      SLOT_LAST_ERROR="launch.sh --resume exited with code ${exit_code}" \
-        write_slot_registry
-      log "  Work dir:  ${WORK_DIR}"
-      log "  Env file:  ${ENV_FILE}"
-      log "  Recovery:  har env launch ${AGENT_ID} --resume  # or ./.har/launch.sh ${AGENT_ID} --resume"
-    fi
-  }
-  trap mark_slot_failed EXIT
-else
-  # Preflight before worktree/install — ports, foreign PM2, Docker, occupied slot.
-  # Occupied slots always block here: teardown/complete first, then relaunch.
-  har_launch_preflight "$AGENT_ID" || exit $?
-fi
-
-if har_harness_uses_pm2; then
-  log "Ports: frontend=$FE_PORT api=$API_PORT debug=$DEBUG_PORT"
-fi
-
-# Ensure shared infra is running (persists host ports in .har/state/infra.env).
-"$SCRIPT_DIR/setup-infra.sh"
-har_load_infra_state
-DB_PORT="${AGENT_DB_PORT:-${HARNESS_DB_PORT_DEFAULT:-15432}}"
-MINIO_PORT="${AGENT_MINIO_PORT:-${HARNESS_MINIO_PORT_DEFAULT:-19000}}"
-BROWSER_PORT="${AGENT_BROWSER_PORT:-${HARNESS_BROWSER_PORT_DEFAULT:-13001}}"
-
-# Clone agent database from template
-if har_infra_enabled db && [ -n "${HARNESS_TEMPLATE_DB:-}" ]; then
-  AGENT_DB="agent_${AGENT_ID}"
-  PSQL="har_pg psql -d postgres"
-  if $PSQL -tAc "SELECT 1 FROM pg_database WHERE datname = '$AGENT_DB'" | grep -q 1; then
-    log "Database '$AGENT_DB' already exists."
-  else
-    log "Creating database '$AGENT_DB' from template..."
-    $PSQL -c "SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE datname = '$HARNESS_TEMPLATE_DB' AND pid <> pg_backend_pid()" >/dev/null 2>&1 || true
-    har_pg createdb -T "$HARNESS_TEMPLATE_DB" "$AGENT_DB"
-    log "Database '$AGENT_DB' created."
-  fi
-fi
-
-# Create MinIO bucket
-if har_infra_enabled minio; then
-  MINIO_BUCKET="agent-${AGENT_ID}"
-  HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" -X PUT \
-    -u "minioadmin:minioadmin" \
-    "http://localhost:${MINIO_PORT}/${MINIO_BUCKET}/" 2>/dev/null) || true
-  log "MinIO bucket '$MINIO_BUCKET' ready (HTTP $HTTP_STATUS)."
-fi
-
-# Session worktree (default — use --no-worktree to work in repo root).
-if [ "$RESUME" != true ]; then
-  # Name encodes what the session is based on: <base-branch>-<sha4>-har-agent-<id>-<rand4>.
-  WORK_DIR="$REPO_ROOT"
-  WORKTREE_DIR=""
-  BRANCH=""
-  SUFFIX=""
-  BASE_BRANCH="$(git -C "$REPO_ROOT" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "detached")"
-  BASE_COMMIT="$(git -C "$REPO_ROOT" rev-parse HEAD 2>/dev/null || true)"
-  if [ "$USE_WORKTREE" = true ]; then
-    SHORT_SHA="$(git -C "$REPO_ROOT" rev-parse --short=4 HEAD)"
-    SUFFIX="$(LC_ALL=C tr -dc 'a-z0-9' </dev/urandom 2>/dev/null | head -c 4 || true)"
-    [ -n "$SUFFIX" ] || SUFFIX="$(printf '%04d' $(( RANDOM % 10000 )))"
-    SESSION_NAME="${BASE_BRANCH//\//-}-${SHORT_SHA}-har-agent-${AGENT_ID}-${SUFFIX}"
-    BRANCH="$SESSION_NAME"
-    WORKTREE_DIR="$HOME/worktrees/${SESSION_NAME}"
-    log "Creating session worktree at $WORKTREE_DIR (branch $BRANCH)..."
-    git -C "$REPO_ROOT" worktree add "$WORKTREE_DIR" -b "$BRANCH"
-    REL_PREFIX="$(git -C "$REPO_ROOT" rev-parse --show-prefix 2>/dev/null || true)"
-    WORK_DIR="${WORKTREE_DIR%/}/${REL_PREFIX}"
-    WORK_DIR="${WORK_DIR%/}"
-  else
-    log "Using repo root (worktree disabled)"
-    REL_PREFIX="$(git -C "$REPO_ROOT" rev-parse --show-prefix 2>/dev/null || true)"
-  fi
-
-  GIT_EXCLUDE="$(git -C "$REPO_ROOT" rev-parse --git-common-dir 2>/dev/null)/info/exclude"
-  if [ -n "$GIT_EXCLUDE" ] && [ -d "$(dirname "$GIT_EXCLUDE")" ]; then
-    for pattern in '.env.agent.*' 'ecosystem.agent.*.config.cjs' '.har/venv'; do
-      grep -qxF "$pattern" "$GIT_EXCLUDE" 2>/dev/null || echo "$pattern" >> "$GIT_EXCLUDE"
-    done
-  fi
-
-  ENV_FILE="$WORK_DIR/.env.agent.${AGENT_ID}"
-  log "Generating $ENV_FILE..."
-  har_regenerate_agent_env_file "$AGENT_ID" "$WORK_DIR" "$ENV_FILE"
-
-  REGISTRY_WRITTEN=false
-  mark_slot_failed() {
-    local exit_code="$?"
-    if [ "$exit_code" != "0" ] && [ "$REGISTRY_WRITTEN" = true ]; then
-      log "Launch failed after creating the session. Recording failed slot state..."
-      set +e
-      SLOT_AGENT_ID="$AGENT_ID" \
-      SLOT_MODE="$([ "$USE_WORKTREE" = true ] && echo worktree || echo root)" \
-      SLOT_WORK_DIR="$WORK_DIR" \
-      SLOT_SUFFIX="${SUFFIX:-}" \
-      SLOT_WORKTREE_PATH="${WORKTREE_DIR:-}" \
-      SLOT_BRANCH="${BRANCH:-}" \
-      SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
-      SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-      SLOT_PORTS_JSON="{\"frontend\":${FE_PORT},\"api\":${API_PORT},\"debug\":${DEBUG_PORT},\"db\":${DB_PORT}}" \
-      SLOT_PREVIEW_URLS_JSON="{\"frontend\":\"http://localhost:${FE_PORT}\",\"api\":\"http://localhost:${API_PORT}\"}" \
-      SLOT_STATUS="failed" \
-      SLOT_LAST_ERROR="launch.sh exited with code ${exit_code}" \
-        write_slot_registry
-      log "  Work dir:  ${WORK_DIR}"
-      log "  Env file:  ${ENV_FILE}"
-      log "  Recovery:  har env launch ${AGENT_ID} --resume  # or ./.har/launch.sh ${AGENT_ID} --resume"
-    fi
-  }
-  trap mark_slot_failed EXIT
-
-  SLOT_AGENT_ID="$AGENT_ID" \
-  SLOT_MODE="$([ "$USE_WORKTREE" = true ] && echo worktree || echo root)" \
-  SLOT_WORK_DIR="$WORK_DIR" \
-  SLOT_SUFFIX="${SUFFIX:-}" \
-  SLOT_WORKTREE_PATH="${WORKTREE_DIR:-}" \
-  SLOT_BRANCH="${BRANCH:-}" \
-  SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
-  SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-  SLOT_PORTS_JSON="{\"frontend\":${FE_PORT},\"api\":${API_PORT},\"debug\":${DEBUG_PORT},\"db\":${DB_PORT}}" \
-  SLOT_PREVIEW_URLS_JSON="{\"frontend\":\"http://localhost:${FE_PORT}\",\"api\":\"http://localhost:${API_PORT}\"}" \
-  SLOT_STATUS="starting" \
-    write_slot_registry
-  REGISTRY_WRITTEN=true
-else
-  REL_PREFIX="$(git -C "$REPO_ROOT" rev-parse --show-prefix 2>/dev/null || true)"
-  log "Resuming session at ${WORK_DIR}"
-  har_regenerate_agent_env_file "$AGENT_ID" "$WORK_DIR" "$ENV_FILE"
-  SLOT_AGENT_ID="$AGENT_ID" \
-  SLOT_MODE="$([ "$USE_WORKTREE" = true ] && echo worktree || echo root)" \
-  SLOT_WORK_DIR="$WORK_DIR" \
-  SLOT_SUFFIX="${SUFFIX:-}" \
-  SLOT_WORKTREE_PATH="${WORKTREE_DIR:-}" \
-  SLOT_BRANCH="${BRANCH:-}" \
-  SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
-  SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-  SLOT_PORTS_JSON="{\"frontend\":${FE_PORT},\"api\":${API_PORT},\"debug\":${DEBUG_PORT},\"db\":${DB_PORT}}" \
-  SLOT_PREVIEW_URLS_JSON="{\"frontend\":\"http://localhost:${FE_PORT}\",\"api\":\"http://localhost:${API_PORT}\"}" \
-  SLOT_STATUS="starting" \
-    write_slot_registry
-fi
-
-if [ "$RESUME" = true ] && har_toolchain_ready "$WORK_DIR"; then
-  log "Toolchain already provisioned — skipping install."
-else
-  log "Provisioning toolchain (see harness.env: HARNESS_ECOSYSTEM, HARNESS_INSTALL_CMD)..."
-  HAR_WORK_DIR="$WORK_DIR" \
-  HAR_ENV_FILE="$ENV_FILE" \
-  HAR_WORKTREE_DIR="${WORKTREE_DIR:-}" \
-  HAR_REL_PREFIX="${REL_PREFIX:-}" \
-  HAR_AGENT_ID="$AGENT_ID" \
-    "$SCRIPT_DIR/provision-toolchain.sh"
-fi
-
-if [ -n "${HARNESS_DB_MINIMAL_BOOTSTRAP_CMD:-}" ]; then
-  log "Running minimal data bootstrap..."
-  (cd "$WORK_DIR" && set -a && . "$ENV_FILE" && set +a && eval "$HARNESS_DB_MINIMAL_BOOTSTRAP_CMD")
-fi
-
-# Generate PM2 ecosystem config
-ECOSYSTEM_FILE="$WORK_DIR/ecosystem.agent.${AGENT_ID}.config.cjs"
-log "Generating $ECOSYSTEM_FILE..."
-AGENT_ID="$AGENT_ID" \
-HARNESS_PROJECT_NAME="$HARNESS_PROJECT_NAME" \
-FE_PORT="$FE_PORT" \
-DEBUG_PORT="$DEBUG_PORT" \
-  envsubst '${AGENT_ID} ${HARNESS_PROJECT_NAME} ${FE_PORT} ${DEBUG_PORT}' \
-  < "$SCRIPT_DIR/ecosystem.agent.template.cjs" > "$ECOSYSTEM_FILE"
-
-PM2_REGEX="$(har_pm2_delete_regex "$AGENT_ID")"
-# Stop existing processes for this agent (project-scoped — never touch other harnesses).
-$(har_pkg_exec) pm2 delete "$PM2_REGEX" 2>/dev/null || true
-
-# Start PM2 processes
-log "Starting PM2 processes..."
-cd "$WORK_DIR"
-$(har_pkg_exec) pm2 start "$ECOSYSTEM_FILE"
-$(har_pkg_exec) pm2 save --force >/dev/null 2>&1 || true
-
-# Health check
-if [ -n "${HARNESS_HEALTH_CHECK_PATH:-}" ]; then
-  HEALTH_URL="http://localhost:${API_PORT}${HARNESS_HEALTH_CHECK_PATH}"
-  log "Waiting for health check at $HEALTH_URL..."
-  TIMEOUT=60
-  ELAPSED=0
-  while [ "$ELAPSED" -lt "$TIMEOUT" ]; do
-    HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" "$HEALTH_URL" 2>/dev/null) || true
-    if [ "$HTTP_CODE" = "200" ]; then
-      log "Health check passed!"
-      break
-    fi
-    sleep 2
-    ELAPSED=$((ELAPSED + 2))
-  done
-  if [ "$ELAPSED" -ge "$TIMEOUT" ]; then
-    log "Warning: Health check did not pass within ${TIMEOUT}s."
-    log "Check logs: ./.har/agent-cli.sh $AGENT_ID logs"
-  fi
-fi
-
-# Record the session in the slot registry — the source of truth for where
-# this slot's code lives (status/verify/teardown resolve through it).
-SLOT_AGENT_ID="$AGENT_ID" \
-SLOT_MODE="$([ "$USE_WORKTREE" = true ] && echo worktree || echo root)" \
-SLOT_WORK_DIR="$WORK_DIR" \
-SLOT_SUFFIX="${SUFFIX:-}" \
-SLOT_WORKTREE_PATH="${WORKTREE_DIR:-}" \
-SLOT_BRANCH="${BRANCH:-}" \
-SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
-SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-SLOT_PORTS_JSON="{\"frontend\":${FE_PORT},\"api\":${API_PORT},\"debug\":${DEBUG_PORT},\"db\":${DB_PORT}}" \
-SLOT_PREVIEW_URLS_JSON="{\"frontend\":\"http://localhost:${FE_PORT}\",\"api\":\"http://localhost:${API_PORT}\"}" \
-SLOT_STATUS="active" \
-  write_slot_registry
-
-# Launch Claude Code in tmux (optional)
-if [ "$USE_CLAUDE" = true ]; then
-  TMUX_SESSION="$(har_tmux_session "$AGENT_ID")"
-  if tmux has-session -t "$TMUX_SESSION" 2>/dev/null; then
-    tmux kill-session -t "$TMUX_SESSION"
-  fi
-  tmux new-session -d -s "$TMUX_SESSION" -c "$WORK_DIR" \
-    "set -a; [ -f '$ENV_FILE' ] && . '$ENV_FILE'; set +a; exec claude"
-  log "Claude session: tmux attach -t $TMUX_SESSION"
-fi
-
-echo ""
-log "Agent $AGENT_ID is ready!"
-log ""
-log "  WORK DIR (make ALL file edits under this path — never the main checkout):"
-log "    ${WORK_DIR}"
-if [ "$USE_WORKTREE" = true ]; then
-  log "  Branch:    ${BRANCH} (based on ${BASE_BRANCH} @ ${BASE_COMMIT})"
-fi
-log "  Frontend:  http://localhost:${FE_PORT}"
-log "  API:       http://localhost:${API_PORT}"
-har_infra_enabled db && log "  Database:  agent_${AGENT_ID} @ localhost:${DB_PORT}"
-log ""
-log "  Edits under the work dir hot-reload in the running slot;"
-log "  use ./.har/agent-cli.sh $AGENT_ID restart if a change doesn't take."
-log "  Verify:    ./.har/verify.sh $AGENT_ID"
-log "  Teardown:  ./.har/teardown.sh $AGENT_ID   (keeps the branch)"

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

@@ -1,32 +0,0 @@
-#!/usr/bin/env bash
-# Launch readiness gate — run before launch.sh or standalone.
-# Usage: ./.har/preflight.sh <agent-id>
-# JSON:  har env preflight <id> --json
-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:-}"
-
-if [[ -z "$AGENT_ID" ]]; then
-  echo "Usage: $0 <agent-id>" >&2
-  exit 1
-fi
-
-validate_agent_id "$AGENT_ID"
-
-if har_launch_preflight "$AGENT_ID"; then
-  echo "Slot ${AGENT_ID}: ready to launch."
-  if har_harness_uses_pm2; then
-    echo "  Ports: frontend=${FE_PORT} api=${API_PORT} debug=${DEBUG_PORT}"
-  fi
-  exit 0
-fi
-
-exit $?