@osfactory/har 0.17.0 → 0.18.0

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

@@ -233,7 +233,7 @@ slot_is_resumable() {
 # Echo shell assignments for launch.sh — eval after validating resumability.
 har_resume_session_assignments() {
   local agent_id="$1"
-  local reg work_dir worktree branch suffix base_branch base_commit purpose mode env_file
+  local reg work_dir worktree branch suffix base_branch base_commit mode env_file
 
   if ! slot_is_resumable "$agent_id"; then
     local status
@@ -251,7 +251,6 @@ har_resume_session_assignments() {
   suffix="$(read_slot_field "$reg" suffix || true)"
   base_branch="$(read_slot_field "$reg" baseBranch || true)"
   base_commit="$(read_slot_field "$reg" baseCommit || true)"
-  purpose="$(read_slot_field "$reg" purpose || true)"
   mode="$(read_slot_field "$reg" mode || true)"
 
   if [ -z "$work_dir" ] || [ ! -d "$work_dir" ]; then
@@ -274,7 +273,6 @@ har_resume_session_assignments() {
     "SUFFIX='${suffix}'" \
     "BASE_BRANCH='${base_branch}'" \
     "BASE_COMMIT='${base_commit}'" \
-    "PURPOSE='${purpose}'" \
     "USE_WORKTREE=$([ "$mode" = worktree ] && echo true || echo false)" \
     "ENV_FILE='${env_file}'"
 }
@@ -318,7 +316,6 @@ har_regenerate_agent_env_file() {
       --work-dir "$work_dir" \
       ${SLOT_BRANCH:+--branch "$SLOT_BRANCH"} \
       ${SLOT_SUFFIX:+--suffix "$SLOT_SUFFIX"} \
-      ${SLOT_PURPOSE:+--purpose "$SLOT_PURPOSE"} \
       >/dev/null 2>&1 || true
   fi
 }
@@ -450,7 +447,7 @@ try {
 #   required: SLOT_AGENT_ID, SLOT_MODE (worktree|root), SLOT_WORK_DIR
 #   optional: SLOT_SUFFIX, SLOT_WORKTREE_PATH, SLOT_BRANCH, SLOT_BASE_BRANCH,
 #             SLOT_BASE_COMMIT, SLOT_PORTS_JSON, SLOT_PREVIEW_URLS_JSON,
-#             SLOT_PURPOSE, SLOT_STATUS, SLOT_LAST_ERROR
+#             SLOT_STATUS, SLOT_LAST_ERROR
 write_slot_registry() {
   local file
   file="$(slot_registry_file "$SLOT_AGENT_ID")"
@@ -472,7 +469,6 @@ if (e.SLOT_WORKTREE_PATH) entry.worktreePath = e.SLOT_WORKTREE_PATH;
 if (e.SLOT_BRANCH) entry.branch = e.SLOT_BRANCH;
 if (e.SLOT_BASE_BRANCH) entry.baseBranch = e.SLOT_BASE_BRANCH;
 if (e.SLOT_BASE_COMMIT) entry.baseCommit = e.SLOT_BASE_COMMIT;
-if (e.SLOT_PURPOSE) entry.purpose = e.SLOT_PURPOSE;
 if (e.SLOT_LAST_ERROR) entry.lastError = e.SLOT_LAST_ERROR;
 for (const [key, env] of [["ports", "SLOT_PORTS_JSON"], ["previewUrls", "SLOT_PREVIEW_URLS_JSON"]]) {
   if (e[env]) try { entry[key] = JSON.parse(e[env]); } catch {}
@@ -516,12 +512,11 @@ slot_dirty_summary() {
 # Print a warning before replacing an occupied slot (stdout — visible to agents).
 print_slot_replace_warning() {
   local agent_id="$1"
-  local reg wt branch work_dir purpose created status last_error dirty_summary head
+  local reg wt branch work_dir created status last_error dirty_summary head
   reg="$(slot_registry_file "$agent_id")"
   wt="$(existing_slot_worktree "$agent_id")"
   branch="$(read_slot_field "$reg" branch || true)"
   work_dir="$(read_slot_field "$reg" workDir || true)"
-  purpose="$(read_slot_field "$reg" purpose || true)"
   created="$(read_slot_field "$reg" createdAt || true)"
   status="$(read_slot_field "$reg" status || true)"
   last_error="$(read_slot_field "$reg" lastError || true)"
@@ -532,7 +527,6 @@ print_slot_replace_warning() {
 
   echo "" >&2
   echo "⚠ Slot ${agent_id} is already in use — replacing will REMOVE the worktree." >&2
-  [ -n "$purpose" ] && echo "  Purpose:   ${purpose}" >&2
   [ -n "$wt" ] && echo "  Worktree:  ${wt}" >&2
   [ -n "$work_dir" ] && echo "  Work dir:  ${work_dir}" >&2
   [ -n "$branch" ] && echo "  Branch:    ${branch}${head:+ @ ${head}}" >&2

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

@@ -20,7 +20,6 @@ USE_CLAUDE=false
 FORCE=false
 REPLACE=false
 RESUME=false
-PURPOSE="${HAR_SESSION_PURPOSE:-}"
 
 for arg in "$@"; do
   case "$arg" in
@@ -30,13 +29,12 @@ for arg in "$@"; do
     --replace)  REPLACE=true ;;
     --force)    FORCE=true ;;
     --resume)   RESUME=true ;;
-    --purpose=*) PURPOSE="${arg#--purpose=}" ;;
   esac
 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 "Usage: $0 <agent-id> [--no-worktree] [--claude] [--replace] [--force] [--resume] " >&2
   echo "  agent-id must be between ${HARNESS_AGENT_SLOT_MIN} and ${HARNESS_AGENT_SLOT_MAX}" >&2
   exit 1
 fi
@@ -71,7 +69,6 @@ if [ "$RESUME" = true ]; then
       SLOT_BRANCH="${BRANCH:-}" \
       SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
       SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-      SLOT_PURPOSE="${PURPOSE}" \
       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" \
@@ -179,7 +176,6 @@ if [ "$RESUME" != true ]; then
       SLOT_BRANCH="${BRANCH:-}" \
       SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
       SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-      SLOT_PURPOSE="${PURPOSE}" \
       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" \
@@ -200,7 +196,6 @@ if [ "$RESUME" != true ]; then
   SLOT_BRANCH="${BRANCH:-}" \
   SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
   SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-  SLOT_PURPOSE="${PURPOSE}" \
   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" \
@@ -218,7 +213,6 @@ else
   SLOT_BRANCH="${BRANCH:-}" \
   SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
   SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-  SLOT_PURPOSE="${PURPOSE}" \
   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" \
@@ -293,7 +287,6 @@ SLOT_WORKTREE_PATH="${WORKTREE_DIR:-}" \
 SLOT_BRANCH="${BRANCH:-}" \
 SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
 SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-SLOT_PURPOSE="${PURPOSE}" \
 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" \

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

@@ -46,9 +46,7 @@ case "$COMMAND" in
       echo "  Work dir:  $(resolve_agent_work_dir "$ENV_FILE" "$AGENT_ID")"
       [ -n "$WT" ] && [ -d "$WT" ] && echo "  Worktree:  $WT"
       BRANCH="$(read_slot_field "$REGISTRY_FILE" branch || true)"
-      PURPOSE="$(read_slot_field "$REGISTRY_FILE" purpose || true)"
       CREATED="$(read_slot_field "$REGISTRY_FILE" createdAt || true)"
-      [ -n "$PURPOSE" ] && echo "  Purpose:   $PURPOSE"
       [ -n "$BRANCH" ] && echo "  Branch:    $BRANCH"
       [ -n "$CREATED" ] && echo "  Since:     $CREATED"
       [ -n "$WT" ] && echo "  Git:       $(slot_dirty_summary "$WT")"

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

@@ -211,7 +211,7 @@ slot_is_resumable() {
 
 har_resume_session_assignments() {
   local agent_id="$1"
-  local reg work_dir worktree branch suffix base_branch base_commit purpose mode env_file
+  local reg work_dir worktree branch suffix base_branch base_commit mode env_file
 
   if ! slot_is_resumable "$agent_id"; then
     local status
@@ -229,7 +229,6 @@ har_resume_session_assignments() {
   suffix="$(read_slot_field "$reg" suffix || true)"
   base_branch="$(read_slot_field "$reg" baseBranch || true)"
   base_commit="$(read_slot_field "$reg" baseCommit || true)"
-  purpose="$(read_slot_field "$reg" purpose || true)"
   mode="$(read_slot_field "$reg" mode || true)"
 
   if [ -z "$work_dir" ] || [ ! -d "$work_dir" ]; then
@@ -252,7 +251,6 @@ har_resume_session_assignments() {
     "SUFFIX='${suffix}'" \
     "BASE_BRANCH='${base_branch}'" \
     "BASE_COMMIT='${base_commit}'" \
-    "PURPOSE='${purpose}'" \
     "USE_WORKTREE=$([ "$mode" = worktree ] && echo true || echo false)" \
     "ENV_FILE='${env_file}'"
 }
@@ -302,7 +300,6 @@ EOF
       --work-dir "$work_dir" \
       ${SLOT_BRANCH:+--branch "$SLOT_BRANCH"} \
       ${SLOT_SUFFIX:+--suffix "$SLOT_SUFFIX"} \
-      ${SLOT_PURPOSE:+--purpose "$SLOT_PURPOSE"} \
       >/dev/null 2>&1 || true
   fi
 }
@@ -430,7 +427,7 @@ try {
 #   required: SLOT_AGENT_ID, SLOT_MODE (worktree|root), SLOT_WORK_DIR
 #   optional: SLOT_SUFFIX, SLOT_WORKTREE_PATH, SLOT_BRANCH, SLOT_BASE_BRANCH,
 #             SLOT_BASE_COMMIT, SLOT_PORTS_JSON, SLOT_PREVIEW_URLS_JSON,
-#             SLOT_PURPOSE, SLOT_STATUS, SLOT_LAST_ERROR
+#             SLOT_STATUS, SLOT_LAST_ERROR
 write_slot_registry() {
   local file
   file="$(slot_registry_file "$SLOT_AGENT_ID")"
@@ -452,7 +449,6 @@ if (e.SLOT_WORKTREE_PATH) entry.worktreePath = e.SLOT_WORKTREE_PATH;
 if (e.SLOT_BRANCH) entry.branch = e.SLOT_BRANCH;
 if (e.SLOT_BASE_BRANCH) entry.baseBranch = e.SLOT_BASE_BRANCH;
 if (e.SLOT_BASE_COMMIT) entry.baseCommit = e.SLOT_BASE_COMMIT;
-if (e.SLOT_PURPOSE) entry.purpose = e.SLOT_PURPOSE;
 if (e.SLOT_LAST_ERROR) entry.lastError = e.SLOT_LAST_ERROR;
 for (const [key, env] of [["ports", "SLOT_PORTS_JSON"], ["previewUrls", "SLOT_PREVIEW_URLS_JSON"]]) {
   if (e[env]) try { entry[key] = JSON.parse(e[env]); } catch {}
@@ -496,12 +492,11 @@ slot_dirty_summary() {
 # Print a warning before replacing an occupied slot (stdout — visible to agents).
 print_slot_replace_warning() {
   local agent_id="$1"
-  local reg wt branch work_dir purpose created status last_error dirty_summary head
+  local reg wt branch work_dir created status last_error dirty_summary head
   reg="$(slot_registry_file "$agent_id")"
   wt="$(existing_slot_worktree "$agent_id")"
   branch="$(read_slot_field "$reg" branch || true)"
   work_dir="$(read_slot_field "$reg" workDir || true)"
-  purpose="$(read_slot_field "$reg" purpose || true)"
   created="$(read_slot_field "$reg" createdAt || true)"
   status="$(read_slot_field "$reg" status || true)"
   last_error="$(read_slot_field "$reg" lastError || true)"
@@ -512,7 +507,6 @@ print_slot_replace_warning() {
 
   echo "" >&2
   echo "⚠ Slot ${agent_id} is already in use — replacing will REMOVE the worktree." >&2
-  [ -n "$purpose" ] && echo "  Purpose:   ${purpose}" >&2
   [ -n "$wt" ] && echo "  Worktree:  ${wt}" >&2
   [ -n "$work_dir" ] && echo "  Work dir:  ${work_dir}" >&2
   [ -n "$branch" ] && echo "  Branch:    ${branch}${head:+ @ ${head}}" >&2

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

@@ -19,7 +19,6 @@ USE_WORKTREE="${HARNESS_USE_WORKTREE:-true}"
 FORCE=false
 REPLACE=false
 RESUME=false
-PURPOSE="${HAR_SESSION_PURPOSE:-}"
 
 for arg in "$@"; do
   case "$arg" in
@@ -28,13 +27,12 @@ for arg in "$@"; do
     --replace)  REPLACE=true ;;
     --force)    FORCE=true ;;
     --resume)   RESUME=true ;;
-    --purpose=*) PURPOSE="${arg#--purpose=}" ;;
   esac
 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 "Usage: $0 <agent-id> [--no-worktree] [--replace] [--force] [--resume] " >&2
   echo "  agent-id must be between ${HARNESS_AGENT_SLOT_MIN} and ${HARNESS_AGENT_SLOT_MAX}" >&2
   exit 1
 fi
@@ -69,7 +67,6 @@ if [ "$RESUME" = true ]; then
       SLOT_BRANCH="${BRANCH:-}" \
       SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
       SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-      SLOT_PURPOSE="${PURPOSE}" \
       SLOT_STATUS="failed" \
       SLOT_LAST_ERROR="launch.sh --resume exited with code ${exit_code}" \
         write_slot_registry
@@ -140,7 +137,6 @@ if [ "$RESUME" != true ]; then
       SLOT_BRANCH="${BRANCH:-}" \
       SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
       SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-      SLOT_PURPOSE="${PURPOSE}" \
       SLOT_STATUS="failed" \
       SLOT_LAST_ERROR="launch.sh exited with code ${exit_code}" \
         write_slot_registry
@@ -159,7 +155,6 @@ if [ "$RESUME" != true ]; then
   SLOT_BRANCH="${BRANCH:-}" \
   SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
   SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-  SLOT_PURPOSE="${PURPOSE}" \
   SLOT_STATUS="starting" \
     write_slot_registry
   REGISTRY_WRITTEN=true
@@ -175,7 +170,6 @@ else
   SLOT_BRANCH="${BRANCH:-}" \
   SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
   SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-  SLOT_PURPOSE="${PURPOSE}" \
   SLOT_STATUS="starting" \
     write_slot_registry
 fi
@@ -203,7 +197,6 @@ SLOT_WORKTREE_PATH="${WORKTREE_DIR:-}" \
 SLOT_BRANCH="${BRANCH:-}" \
 SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
 SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-SLOT_PURPOSE="${PURPOSE}" \
 SLOT_STATUS="active" \
   write_slot_registry
 

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

@@ -88,7 +88,7 @@ try {
 #   required: SLOT_AGENT_ID, SLOT_MODE (worktree|root), SLOT_WORK_DIR
 #   optional: SLOT_SUFFIX, SLOT_WORKTREE_PATH, SLOT_BRANCH, SLOT_BASE_BRANCH,
 #             SLOT_BASE_COMMIT, SLOT_PORTS_JSON, SLOT_PREVIEW_URLS_JSON,
-#             SLOT_PURPOSE, SLOT_STATUS, SLOT_LAST_ERROR
+#             SLOT_STATUS, SLOT_LAST_ERROR
 write_slot_registry() {
   local file
   file="$(slot_registry_file "$SLOT_AGENT_ID")"
@@ -110,7 +110,6 @@ if (e.SLOT_WORKTREE_PATH) entry.worktreePath = e.SLOT_WORKTREE_PATH;
 if (e.SLOT_BRANCH) entry.branch = e.SLOT_BRANCH;
 if (e.SLOT_BASE_BRANCH) entry.baseBranch = e.SLOT_BASE_BRANCH;
 if (e.SLOT_BASE_COMMIT) entry.baseCommit = e.SLOT_BASE_COMMIT;
-if (e.SLOT_PURPOSE) entry.purpose = e.SLOT_PURPOSE;
 if (e.SLOT_LAST_ERROR) entry.lastError = e.SLOT_LAST_ERROR;
 for (const [key, env] of [["ports", "SLOT_PORTS_JSON"], ["previewUrls", "SLOT_PREVIEW_URLS_JSON"]]) {
   if (e[env]) try { entry[key] = JSON.parse(e[env]); } catch {}
@@ -154,12 +153,11 @@ slot_dirty_summary() {
 # Print a warning before replacing an occupied slot (stdout — visible to agents).
 print_slot_replace_warning() {
   local agent_id="$1"
-  local reg wt branch work_dir purpose created status last_error dirty_summary head
+  local reg wt branch work_dir created status last_error dirty_summary head
   reg="$(slot_registry_file "$agent_id")"
   wt="$(existing_slot_worktree "$agent_id")"
   branch="$(read_slot_field "$reg" branch || true)"
   work_dir="$(read_slot_field "$reg" workDir || true)"
-  purpose="$(read_slot_field "$reg" purpose || true)"
   created="$(read_slot_field "$reg" createdAt || true)"
   status="$(read_slot_field "$reg" status || true)"
   last_error="$(read_slot_field "$reg" lastError || true)"
@@ -170,7 +168,6 @@ print_slot_replace_warning() {
 
   echo "" >&2
   echo "⚠ Slot ${agent_id} is already in use — replacing will REMOVE the worktree." >&2
-  [ -n "$purpose" ] && echo "  Purpose:   ${purpose}" >&2
   [ -n "$wt" ] && echo "  Worktree:  ${wt}" >&2
   [ -n "$work_dir" ] && echo "  Work dir:  ${work_dir}" >&2
   [ -n "$branch" ] && echo "  Branch:    ${branch}${head:+ @ ${head}}" >&2

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

@@ -18,7 +18,6 @@ AGENT_ID="${1:-}"
 USE_WORKTREE="${HARNESS_USE_WORKTREE:-true}"
 FORCE=false
 REPLACE=false
-PURPOSE="${HAR_SESSION_PURPOSE:-}"
 
 for arg in "$@"; do
   case "$arg" in
@@ -26,13 +25,12 @@ for arg in "$@"; do
     --worktree) USE_WORKTREE=true ;;
     --replace)  REPLACE=true ;;
     --force)    FORCE=true ;;
-    --purpose=*) PURPOSE="${arg#--purpose=}" ;;
   esac
 done
 
 if [[ -z "$AGENT_ID" ]]; then
   har_load_agent_slot_limits
-  echo "Usage: $0 <agent-id> [--no-worktree] [--replace] [--force] [--purpose=label]" >&2
+  echo "Usage: $0 <agent-id> [--no-worktree] [--replace] [--force] " >&2
   echo "  agent-id must be between ${HARNESS_AGENT_SLOT_MIN} and ${HARNESS_AGENT_SLOT_MAX}" >&2
   exit 1
 fi
@@ -109,7 +107,6 @@ mark_slot_failed() {
     SLOT_BRANCH="${BRANCH:-}" \
     SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
     SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-    SLOT_PURPOSE="${PURPOSE}" \
     SLOT_STATUS="failed" \
     SLOT_LAST_ERROR="launch.sh exited with code ${exit_code}" \
       write_slot_registry
@@ -130,7 +127,6 @@ SLOT_WORKTREE_PATH="${WORKTREE_DIR:-}" \
 SLOT_BRANCH="${BRANCH:-}" \
 SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
 SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-SLOT_PURPOSE="${PURPOSE}" \
 SLOT_STATUS="starting" \
   write_slot_registry
 REGISTRY_WRITTEN=true
@@ -153,7 +149,6 @@ SLOT_WORKTREE_PATH="${WORKTREE_DIR:-}" \
 SLOT_BRANCH="${BRANCH:-}" \
 SLOT_BASE_BRANCH="${BASE_BRANCH:-}" \
 SLOT_BASE_COMMIT="${BASE_COMMIT:-}" \
-SLOT_PURPOSE="${PURPOSE}" \
 SLOT_STATUS="active" \
   write_slot_registry
 

package/package.json

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