chore(ai-workflow): tighten agent workflow and worktree tooling (#1107)

* chore(ai-workflow): tighten agent workflow and worktree tooling

* fix(ai-workflow): address review feedback

* fix(ai-workflow): make format hook portable

scripts/agent-init.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+
+set -euo pipefail
+
+run_smoke=0
+wait_timeout="${AGENT_INIT_TIMEOUT_SECONDS:-60}"
+app_url="${AGENT_APP_URL:-http://5chan.localhost:1355}"
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --smoke)
+      run_smoke=1
+      ;;
+    *)
+      echo "Unknown argument: $1" >&2
+      echo "Usage: ./scripts/agent-init.sh [--smoke]" >&2
+      exit 1
+      ;;
+  esac
+  shift
+done
+
+repo_root="$(git rev-parse --show-toplevel)"
+log_dir="$repo_root/.playwright-cli"
+log_path="${AGENT_START_LOG:-$log_dir/agent-start.log}"
+
+mkdir -p "$log_dir"
+cd "$repo_root"
+
+is_server_up() {
+  curl -fsS "$app_url" >/dev/null 2>&1
+}
+
+wait_for_server() {
+  local started_at
+
+  started_at="$(date +%s)"
+  while [ $(( $(date +%s) - started_at )) -lt "$wait_timeout" ]; do
+    if is_server_up; then
+      return 0
+    fi
+    sleep 1
+  done
+  return 1
+}
+
+echo "Repo root: $repo_root"
+echo "App URL: $app_url"
+
+if is_server_up; then
+  echo "Dev server is already reachable."
+else
+  echo "Dev server is not reachable. Starting yarn start..."
+  nohup yarn start >"$log_path" 2>&1 &
+  echo "Startup log: $log_path"
+
+  if ! wait_for_server; then
+    echo "Timed out waiting for $app_url" >&2
+    echo "Last log lines:" >&2
+    tail -n 40 "$log_path" >&2 || true
+    exit 1
+  fi
+fi
+
+echo "Dev server is ready."
+
+if [ "$run_smoke" -eq 1 ]; then
+  echo "Running smoke flow against the live dev server..."
+  SMOKE_BASE_URL="${app_url%/}/#/" node scripts/smoke-web-app.js
+fi