@osfactory/har 0.54.1 → 0.55.0

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

@@ -326,6 +326,49 @@ har_regenerate_agent_env_file() {
   fi
 }
 
+# Untracked (not ignored) paths stay in the main checkout when a session
+# worktree is created from HEAD. Advisory — never fails the launch.
+har_warn_untracked_worktree() {
+  case "${USE_WORKTREE:-${HARNESS_USE_WORKTREE:-true}}" in
+    true|TRUE|yes|YES|1) ;;
+    *) return 0 ;;
+  esac
+  local root="${REPO_ROOT:-}"
+  if [ -z "$root" ] && [ -n "${SCRIPT_DIR:-}" ]; then
+    root="$(cd "$SCRIPT_DIR/.." && pwd)"
+  fi
+  [ -n "$root" ] || return 0
+  git -C "$root" rev-parse --is-inside-work-tree >/dev/null 2>&1 || return 0
+
+  local paths=()
+  local entry
+  while IFS= read -r -d '' entry; do
+    paths+=("$entry")
+  done < <(git -C "$root" --literal-pathspecs ls-files --others --exclude-standard --directory -z 2>/dev/null || true)
+
+  local count="${#paths[@]}"
+  [ "$count" -gt 0 ] || return 0
+
+  local max=8
+  local listed=""
+  local i
+  for ((i = 0; i < count && i < max; i++)); do
+    [ -n "$listed" ] && listed+=", "
+    listed+="${paths[$i]}"
+  done
+  if [ "$count" -gt "$max" ]; then
+    listed+=" (+$((count - max)) more)"
+  fi
+
+  local noun="paths"
+  local them="They are"
+  if [ "$count" -eq 1 ]; then
+    noun="path"
+    them="It is"
+  fi
+  echo "WARN: ${count} untracked ${noun} will not appear in the session worktree: ${listed}. ${them} only in the main checkout — track them, or launch with --no-worktree." >&2
+}
+
 # har_launch_preflight <agent_id> [resume]
 # Exit 0 when ready; 2 when occupied (free the slot first) or not resumable; 1 on machine blockers.
 # Sets FE_PORT/API_PORT/DEBUG_PORT when this harness uses PM2.
@@ -364,6 +407,7 @@ har_launch_preflight() {
       fi
     done
   fi
+  har_warn_untracked_worktree
   return 0
 }
 

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

@@ -310,6 +310,49 @@ EOF
   fi
 }
 
+# Untracked (not ignored) paths stay in the main checkout when a session
+# worktree is created from HEAD. Advisory — never fails the launch.
+har_warn_untracked_worktree() {
+  case "${USE_WORKTREE:-${HARNESS_USE_WORKTREE:-true}}" in
+    true|TRUE|yes|YES|1) ;;
+    *) return 0 ;;
+  esac
+  local root="${REPO_ROOT:-}"
+  if [ -z "$root" ] && [ -n "${SCRIPT_DIR:-}" ]; then
+    root="$(cd "$SCRIPT_DIR/.." && pwd)"
+  fi
+  [ -n "$root" ] || return 0
+  git -C "$root" rev-parse --is-inside-work-tree >/dev/null 2>&1 || return 0
+
+  local paths=()
+  local entry
+  while IFS= read -r -d '' entry; do
+    paths+=("$entry")
+  done < <(git -C "$root" --literal-pathspecs ls-files --others --exclude-standard --directory -z 2>/dev/null || true)
+
+  local count="${#paths[@]}"
+  [ "$count" -gt 0 ] || return 0
+
+  local max=8
+  local listed=""
+  local i
+  for ((i = 0; i < count && i < max; i++)); do
+    [ -n "$listed" ] && listed+=", "
+    listed+="${paths[$i]}"
+  done
+  if [ "$count" -gt "$max" ]; then
+    listed+=" (+$((count - max)) more)"
+  fi
+
+  local noun="paths"
+  local them="They are"
+  if [ "$count" -eq 1 ]; then
+    noun="path"
+    them="It is"
+  fi
+  echo "WARN: ${count} untracked ${noun} will not appear in the session worktree: ${listed}. ${them} only in the main checkout — track them, or launch with --no-worktree." >&2
+}
+
 # har_launch_preflight <agent_id> [resume]
 # Exit 0 when ready; 2 when occupied (free the slot first) or not resumable; 1 on machine blockers.
 har_launch_preflight() {
@@ -346,6 +389,7 @@ har_launch_preflight() {
       fi
     done
   fi
+  har_warn_untracked_worktree
   return 0
 }
 

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

@@ -239,6 +239,49 @@ print_slot_occupied_warning() {
   echo "" >&2
 }
 
+# Untracked (not ignored) paths stay in the main checkout when a session
+# worktree is created from HEAD. Advisory — never fails the launch.
+har_warn_untracked_worktree() {
+  case "${USE_WORKTREE:-${HARNESS_USE_WORKTREE:-true}}" in
+    true|TRUE|yes|YES|1) ;;
+    *) return 0 ;;
+  esac
+  local root="${REPO_ROOT:-}"
+  if [ -z "$root" ] && [ -n "${SCRIPT_DIR:-}" ]; then
+    root="$(cd "$SCRIPT_DIR/.." && pwd)"
+  fi
+  [ -n "$root" ] || return 0
+  git -C "$root" rev-parse --is-inside-work-tree >/dev/null 2>&1 || return 0
+
+  local paths=()
+  local entry
+  while IFS= read -r -d '' entry; do
+    paths+=("$entry")
+  done < <(git -C "$root" --literal-pathspecs ls-files --others --exclude-standard --directory -z 2>/dev/null || true)
+
+  local count="${#paths[@]}"
+  [ "$count" -gt 0 ] || return 0
+
+  local max=8
+  local listed=""
+  local i
+  for ((i = 0; i < count && i < max; i++)); do
+    [ -n "$listed" ] && listed+=", "
+    listed+="${paths[$i]}"
+  done
+  if [ "$count" -gt "$max" ]; then
+    listed+=" (+$((count - max)) more)"
+  fi
+
+  local noun="paths"
+  local them="They are"
+  if [ "$count" -eq 1 ]; then
+    noun="path"
+    them="It is"
+  fi
+  echo "WARN: ${count} untracked ${noun} will not appear in the session worktree: ${listed}. ${them} only in the main checkout — track them, or launch with --no-worktree." >&2
+}
+
 git_common_dir() {
   local cwd="$1"
   local out

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

@@ -56,6 +56,8 @@ if slot_is_occupied "$AGENT_ID"; then
   exit 2
 fi
 
+har_warn_untracked_worktree
+
 "$SCRIPT_DIR/setup-infra.sh"
 
 # Session worktree (default — use --no-worktree to work in repo root).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osfactory/har",
-  "version": "0.54.1",
+  "version": "0.55.0",
   "description": "Open harness for reproducible multi-agent coding workflows",
   "keywords": [
     "har",