agent-control-plane 0.1.0

package/tools/bin/kick-scheduler.sh

@@ -0,0 +1,75 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=/dev/null
+source "${SCRIPT_DIR}/flow-config-lib.sh"
+
+DELAY_SECONDS="${1:-5}"
+WORKSPACE_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
+if ! flow_require_explicit_profile_selection "${FLOW_SKILL_DIR}" "kick-scheduler.sh"; then
+  exit 64
+fi
+CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
+REPO_SLUG="$(flow_resolve_repo_slug "${CONFIG_YAML}")"
+STATE_ROOT="$(flow_resolve_state_root "${CONFIG_YAML}")"
+BOOTSTRAP_SCRIPT="${ACP_BOOTSTRAP_SCRIPT:-${F_LOSNING_BOOTSTRAP_SCRIPT:-${AGENT_SCHEDULER_BOOTSTRAP_SCRIPT:-$HOME/.agent-runtime/control-plane/workspace/bin/agent-scheduler-launchd.sh}}}"
+FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
+FLOW_SAFE_AUTO_SCRIPT="${ACP_FLOW_HEARTBEAT_SCRIPT:-${F_LOSNING_FLOW_HEARTBEAT_SCRIPT:-${FLOW_SKILL_DIR}/tools/bin/heartbeat-safe-auto.sh}}"
+STATE_DIR="${ACP_SCHEDULER_KICK_STATE_DIR:-${STATE_ROOT}/kick-scheduler}"
+PID_FILE="${STATE_DIR}/pid"
+
+mkdir -p "${STATE_DIR}"
+
+active_heartbeat_pid() {
+  ps -ax -o pid=,command= \
+    | while read -r pid command; do
+        [[ -n "${pid:-}" ]] || continue
+        case "$command" in
+          *"${BOOTSTRAP_SCRIPT}"*|*"${WORKSPACE_DIR}/bin/heartbeat-safe-auto.sh"*|*"${FLOW_SAFE_AUTO_SCRIPT}"*|*"agent-project-heartbeat-loop --repo-slug ${REPO_SLUG}"*)
+            printf '%s\n' "$pid"
+            return 0
+            ;;
+        esac
+      done
+}
+
+if active_pid="$(active_heartbeat_pid)"; [[ -n "$active_pid" ]]; then
+  printf 'KICK_STATUS=active-heartbeat\n'
+  printf 'PID=%s\n' "$active_pid"
+  exit 0
+fi
+
+if [[ -f "${PID_FILE}" ]]; then
+  existing_pid="$(cat "${PID_FILE}" 2>/dev/null || true)"
+  if [[ -n "${existing_pid}" ]] && kill -0 "${existing_pid}" 2>/dev/null; then
+    printf 'KICK_STATUS=already-pending\n'
+    printf 'PID=%s\n' "${existing_pid}"
+    exit 0
+  fi
+fi
+
+export DELAY_SECONDS BOOTSTRAP_SCRIPT FLOW_SAFE_AUTO_SCRIPT PID_FILE REPO_SLUG
+nohup bash -lc '
+  trap '\''rm -f "$PID_FILE"'\'' EXIT
+  sleep "$DELAY_SECONDS"
+  active_pid="$(ps -ax -o pid=,command= | while read -r pid command; do
+    [[ -n "${pid:-}" ]] || continue
+    case "$command" in
+      *"$BOOTSTRAP_SCRIPT"*|*"$FLOW_SAFE_AUTO_SCRIPT"*|*"agent-project-heartbeat-loop --repo-slug $REPO_SLUG"*)
+        printf "%s\n" "$pid"
+        break
+        ;;
+    esac
+  done)"
+  if [[ -n "$active_pid" ]]; then
+    exit 0
+  fi
+  "$BOOTSTRAP_SCRIPT" >/dev/null 2>&1 || true
+' >/dev/null 2>&1 &
+
+bg_pid="$!"
+printf '%s\n' "${bg_pid}" >"${PID_FILE}"
+printf 'KICK_STATUS=scheduled\n'
+printf 'PID=%s\n' "${bg_pid}"

package/tools/bin/label-follow-up-issues.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=/dev/null
+source "${SCRIPT_DIR}/flow-config-lib.sh"
+
+SESSION="${1:?usage: label-follow-up-issues.sh SESSION}"
+CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
+RUNS_ROOT="$(flow_resolve_runs_root "${CONFIG_YAML}")"
+FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
+ADAPTER_BIN_DIR="${FLOW_SKILL_DIR}/bin"
+
+ACP_RUNS_ROOT="$RUNS_ROOT" F_LOSNING_RUNS_ROOT="$RUNS_ROOT" "${ADAPTER_BIN_DIR}/label-follow-up-issues.sh" "$SESSION"

package/tools/bin/new-pr-worktree.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=/dev/null
+source "${SCRIPT_DIR}/flow-config-lib.sh"
+
+FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
+if ! flow_require_explicit_profile_selection "${FLOW_SKILL_DIR}" "new-pr-worktree.sh"; then
+  exit 64
+fi
+FLOW_TOOLS_DIR="${FLOW_SKILL_DIR}/tools/bin"
+flow_export_project_env_aliases
+CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
+AGENT_REPO_ROOT="$(flow_resolve_agent_repo_root "${CONFIG_YAML}")"
+AUTOMATION_REPO_ROOT="$(flow_resolve_repo_root "${CONFIG_YAML}")"
+WORKTREE_ROOT="$(flow_resolve_worktree_root "${CONFIG_YAML}")"
+RETAINED_REPO_ROOT="$(flow_resolve_retained_repo_root "${CONFIG_YAML}")"
+VSCODE_WORKSPACE_FILE="$(flow_resolve_vscode_workspace_file "${CONFIG_YAML}")"
+PR_WORKTREE_BRANCH_PREFIX="$(flow_resolve_pr_worktree_branch_prefix "${CONFIG_YAML}")"
+
+PR_NUMBER="${1:?usage: new-pr-worktree.sh PR_NUMBER HEAD_REF}"
+HEAD_REF="${2:?usage: new-pr-worktree.sh PR_NUMBER HEAD_REF}"
+
+ACP_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
+F_LOSNING_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
+  "${SCRIPT_DIR}/sync-agent-repo.sh" >/dev/null
+
+export ACP_REPO_ROOT="$AUTOMATION_REPO_ROOT"
+export F_LOSNING_REPO_ROOT="$AUTOMATION_REPO_ROOT"
+
+WORKTREE_OUT="$(
+  bash "${FLOW_TOOLS_DIR}/agent-project-open-pr-worktree" \
+    --repo-root "$AGENT_REPO_ROOT" \
+    --worktree-root "$WORKTREE_ROOT" \
+    --pr-number "$PR_NUMBER" \
+    --head-ref "$HEAD_REF" \
+    --local-branch-prefix "$PR_WORKTREE_BRANCH_PREFIX" \
+    --prepare-script "${SCRIPT_DIR}/prepare-worktree.sh"
+)"
+
+ACP_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
+ACP_RETAINED_REPO_ROOT="$RETAINED_REPO_ROOT" \
+ACP_VSCODE_WORKSPACE_FILE="$VSCODE_WORKSPACE_FILE" \
+F_LOSNING_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
+F_LOSNING_RETAINED_REPO_ROOT="$RETAINED_REPO_ROOT" \
+F_LOSNING_VSCODE_WORKSPACE_FILE="$VSCODE_WORKSPACE_FILE" \
+  "${SCRIPT_DIR}/sync-vscode-workspace.sh" >/dev/null 2>&1 || true
+
+printf '%s\n' "$WORKTREE_OUT"

package/tools/bin/new-worktree.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=/dev/null
+source "${SCRIPT_DIR}/flow-config-lib.sh"
+
+FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
+if ! flow_require_explicit_profile_selection "${FLOW_SKILL_DIR}" "new-worktree.sh"; then
+  exit 64
+fi
+CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
+AGENT_REPO_ROOT="$(flow_resolve_agent_repo_root "${CONFIG_YAML}")"
+AUTOMATION_REPO_ROOT="$(flow_resolve_repo_root "${CONFIG_YAML}")"
+WORKTREE_ROOT="$(flow_resolve_worktree_root "${CONFIG_YAML}")"
+RETAINED_REPO_ROOT="$(flow_resolve_retained_repo_root "${CONFIG_YAML}")"
+VSCODE_WORKSPACE_FILE="$(flow_resolve_vscode_workspace_file "${CONFIG_YAML}")"
+FLOW_TOOLS_DIR="${FLOW_SKILL_DIR}/tools/bin"
+ISSUE_BRANCH_PREFIX="$(flow_resolve_issue_branch_prefix "${CONFIG_YAML}")"
+
+ISSUE_ID="${1:?usage: new-worktree.sh ISSUE_ID [SLUG]}"
+SLUG_INPUT="${2:-task}"
+
+ACP_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
+F_LOSNING_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
+  "${SCRIPT_DIR}/sync-agent-repo.sh" >/dev/null
+
+export ACP_REPO_ROOT="$AUTOMATION_REPO_ROOT"
+export F_LOSNING_REPO_ROOT="$AUTOMATION_REPO_ROOT"
+
+WORKTREE_OUT="$(
+  bash "${FLOW_TOOLS_DIR}/agent-project-open-issue-worktree" \
+    --repo-root "$AGENT_REPO_ROOT" \
+    --worktree-root "$WORKTREE_ROOT" \
+    --issue-id "$ISSUE_ID" \
+    --slug "$SLUG_INPUT" \
+    --branch-prefix "$ISSUE_BRANCH_PREFIX" \
+    --prepare-script "${SCRIPT_DIR}/prepare-worktree.sh"
+)"
+
+ACP_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
+ACP_RETAINED_REPO_ROOT="$RETAINED_REPO_ROOT" \
+ACP_VSCODE_WORKSPACE_FILE="$VSCODE_WORKSPACE_FILE" \
+F_LOSNING_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
+F_LOSNING_RETAINED_REPO_ROOT="$RETAINED_REPO_ROOT" \
+F_LOSNING_VSCODE_WORKSPACE_FILE="$VSCODE_WORKSPACE_FILE" \
+  "${SCRIPT_DIR}/sync-vscode-workspace.sh" >/dev/null 2>&1 || true
+
+printf '%s\n' "$WORKTREE_OUT"

package/tools/bin/pr-risk.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=/dev/null
+source "${SCRIPT_DIR}/flow-shell-lib.sh"
+
+PR_NUMBER="${1:?usage: pr-risk.sh PR_NUMBER}"
+FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
+ADAPTER_BIN_DIR="${FLOW_SKILL_DIR}/bin"
+
+"${ADAPTER_BIN_DIR}/pr-risk.sh" "$PR_NUMBER"

package/tools/bin/prepare-worktree.sh

@@ -0,0 +1,140 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+# shellcheck source=/dev/null
+source "${SCRIPT_DIR}/flow-config-lib.sh"
+
+CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
+AGENT_REPO_ROOT="$(flow_resolve_agent_repo_root "${CONFIG_YAML}")"
+CANONICAL_REPO_ROOT="$(flow_resolve_repo_root "${CONFIG_YAML}")"
+DEFAULT_DEPENDENCY_SOURCE_ROOT="$CANONICAL_REPO_ROOT"
+DEPENDENCY_SOURCE_ROOT="${ACP_DEPENDENCY_SOURCE_ROOT:-${F_LOSNING_DEPENDENCY_SOURCE_ROOT:-$DEFAULT_DEPENDENCY_SOURCE_ROOT}}"
+SYNC_DEPENDENCY_BASELINE_SCRIPT="${ACP_SYNC_DEPENDENCY_BASELINE_SCRIPT:-${F_LOSNING_SYNC_DEPENDENCY_BASELINE_SCRIPT:-${SCRIPT_DIR}/sync-dependency-baseline.sh}}"
+PACKAGE_MANAGER_BIN="${ACP_PACKAGE_MANAGER_BIN:-${F_LOSNING_PACKAGE_MANAGER_BIN:-pnpm}}"
+LOCAL_WORKSPACE_INSTALL="${ACP_WORKTREE_LOCAL_INSTALL:-${F_LOSNING_WORKTREE_LOCAL_INSTALL:-false}}"
+WORKTREE="${1:?usage: prepare-worktree.sh WORKTREE}"
+
+realpath_safe() {
+  local path="${1:-}"
+  [[ -n "$path" ]] || return 1
+  if command -v python3 >/dev/null 2>&1; then
+    python3 - "$path" <<'PY'
+import os
+import sys
+print(os.path.realpath(sys.argv[1]))
+PY
+    return
+  fi
+  cd "$path" 2>/dev/null && pwd -P
+}
+
+link_shared_path() {
+  local source_path="${1:?source path required}"
+  local target_path="${2:?target path required}"
+
+  [[ -e "$source_path" ]] || return 0
+  if [[ -L "$target_path" ]]; then
+    return 0
+  fi
+  if [[ -e "$target_path" ]]; then
+    return 0
+  fi
+
+  mkdir -p "$(dirname "$target_path")"
+  ln -s "$source_path" "$target_path"
+}
+
+dependency_source_ready() {
+  local repo_root="${1:?repo root required}"
+  local workspace_dir=""
+
+  [[ -e "$repo_root/node_modules" ]] || return 1
+
+  while IFS= read -r workspace_dir; do
+    [[ -n "$workspace_dir" ]] || continue
+    [[ -d "$workspace_dir" ]] || continue
+    [[ -e "$workspace_dir/node_modules" ]] || return 1
+  done < <(
+    find "$repo_root/apps" -mindepth 1 -maxdepth 1 -type d 2>/dev/null || true
+    find "$repo_root/packages" -mindepth 1 -maxdepth 1 -type d 2>/dev/null || true
+  )
+}
+
+link_workspace_node_modules() {
+  local dependency_root="${1:?dependency root required}"
+  local worktree_root="${2:?worktree root required}"
+  local workspace_dir=""
+  local relative_path=""
+
+  while IFS= read -r workspace_dir; do
+    [[ -n "$workspace_dir" ]] || continue
+    [[ -d "$workspace_dir/node_modules" ]] || continue
+    relative_path="${workspace_dir#${dependency_root}/}"
+    link_shared_path "$workspace_dir/node_modules" "$worktree_root/$relative_path/node_modules"
+  done < <(
+    find "$dependency_root/apps" -mindepth 1 -maxdepth 1 -type d 2>/dev/null || true
+    find "$dependency_root/packages" -mindepth 1 -maxdepth 1 -type d 2>/dev/null || true
+  )
+}
+
+configure_worktree_excludes() {
+  local worktree="${1:?worktree required}"
+  local exclude_file="${worktree}/.openclaw-artifacts/git-exclude"
+
+  cat >"$exclude_file" <<'EOF'
+node_modules
+apps/*/node_modules
+packages/*/node_modules
+.openclaw-artifacts
+.openclaw
+SOUL.md
+TOOLS.md
+IDENTITY.md
+USER.md
+HEARTBEAT.md
+BOOTSTRAP.md
+.agent-session.env
+EOF
+
+  git -C "$worktree" config extensions.worktreeConfig true >/dev/null 2>&1 || true
+  git -C "$worktree" config --worktree core.excludesFile "$exclude_file"
+}
+
+WORKTREE_REAL="$(realpath_safe "$WORKTREE")"
+CANONICAL_REAL="$(realpath_safe "$CANONICAL_REPO_ROOT")"
+DEPENDENCY_REAL="$(realpath_safe "$DEPENDENCY_SOURCE_ROOT")"
+
+if [[ -n "$CANONICAL_REAL" && "$WORKTREE_REAL" == "$CANONICAL_REAL" ]]; then
+  echo "refusing to prepare canonical checkout as worker worktree: $WORKTREE" >&2
+  exit 1
+fi
+
+if [[ -n "$DEPENDENCY_REAL" && "$WORKTREE_REAL" == "$DEPENDENCY_REAL" ]]; then
+  echo "refusing to prepare retained checkout as worker worktree: $WORKTREE" >&2
+  exit 1
+fi
+
+mkdir -p "$WORKTREE/.openclaw-artifacts"
+configure_worktree_excludes "$WORKTREE"
+
+if [[ -x "$SYNC_DEPENDENCY_BASELINE_SCRIPT" && "$DEPENDENCY_REAL" == "$CANONICAL_REAL" ]]; then
+  "$SYNC_DEPENDENCY_BASELINE_SCRIPT" >/dev/null
+fi
+
+if [[ "$LOCAL_WORKSPACE_INSTALL" == "true" ]]; then
+  (
+    cd "$WORKTREE"
+    CI=1 "$PACKAGE_MANAGER_BIN" install --frozen-lockfile --prefer-offline
+  )
+else
+  if ! dependency_source_ready "$DEPENDENCY_SOURCE_ROOT"; then
+    echo "dependency source is missing required node_modules or built workspace artifacts: $DEPENDENCY_SOURCE_ROOT" >&2
+    exit 1
+  fi
+  link_shared_path "$DEPENDENCY_SOURCE_ROOT/node_modules" "$WORKTREE/node_modules"
+  link_workspace_node_modules "$DEPENDENCY_SOURCE_ROOT" "$WORKTREE"
+fi
+
+printf 'WORKTREE=%s\n' "$WORKTREE"
+printf 'SANDBOX_ARTIFACT_DIR=%s\n' "$WORKTREE/.openclaw-artifacts"

package/tools/bin/profile-activate.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SCRIPT_PATH="${SCRIPT_DIR}/profile-activate.sh"
+# shellcheck source=/dev/null
+source "${SCRIPT_DIR}/flow-config-lib.sh"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  profile-activate.sh --profile-id <id> [--exports]
+
+Print the selected profile context or shell export statements for quickly
+switching operator commands to a specific installed profile.
+EOF
+}
+
+profile_id=""
+exports_only="0"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --profile-id) profile_id="${2:-}"; shift 2 ;;
+    --exports) exports_only="1"; shift ;;
+    --help|-h) usage; exit 0 ;;
+    *) echo "Unknown argument: $1" >&2; usage >&2; exit 1 ;;
+  esac
+done
+
+if [[ -z "${profile_id}" ]]; then
+  usage >&2
+  exit 1
+fi
+
+FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
+PROFILE_REGISTRY_ROOT="$(resolve_flow_profile_registry_root)"
+CONFIG_YAML="$(flow_find_profile_dir_by_id "${FLOW_SKILL_DIR}" "${profile_id}")/control-plane.yaml"
+PROFILE_NOTES="$(flow_resolve_profile_notes_file "${CONFIG_YAML}")"
+AVAILABLE_PROFILES="$(flow_list_profile_ids "${FLOW_SKILL_DIR}" | paste -sd, -)"
+
+if [[ ! -f "${CONFIG_YAML}" ]]; then
+  echo "unknown profile id: ${profile_id}" >&2
+  echo "AVAILABLE_PROFILES=${AVAILABLE_PROFILES}" >&2
+  exit 1
+fi
+
+export ACP_PROJECT_ID="${profile_id}"
+export AGENT_PROJECT_ID="${profile_id}"
+flow_export_execution_env "${CONFIG_YAML}"
+
+REPO_SLUG="$(flow_resolve_repo_slug "${CONFIG_YAML}")"
+REPO_ROOT="$(flow_resolve_repo_root "${CONFIG_YAML}")"
+AGENT_ROOT="$(flow_resolve_agent_root "${CONFIG_YAML}")"
+AGENT_REPO_ROOT="$(flow_resolve_agent_repo_root "${CONFIG_YAML}")"
+WORKTREE_ROOT="$(flow_resolve_worktree_root "${CONFIG_YAML}")"
+RUNS_ROOT="$(flow_resolve_runs_root "${CONFIG_YAML}")"
+STATE_ROOT="$(flow_resolve_state_root "${CONFIG_YAML}")"
+CODING_WORKER="${ACP_CODING_WORKER:-${F_LOSNING_CODING_WORKER:-codex}}"
+ACTIVE_PROVIDER_POOL_NAME="${ACP_ACTIVE_PROVIDER_POOL_NAME:-${F_LOSNING_ACTIVE_PROVIDER_POOL_NAME:-}}"
+
+if [[ "${exports_only}" == "1" ]]; then
+  printf 'export ACP_PROJECT_ID=%q
+' "${profile_id}"
+  printf 'export AGENT_PROJECT_ID=%q
+' "${profile_id}"
+  printf 'export ACP_PROFILE_REGISTRY_ROOT=%q
+' "${PROFILE_REGISTRY_ROOT}"
+  printf 'export ACP_CONFIG=%q
+' "${CONFIG_YAML}"
+  printf 'export ACP_PROFILE_NOTES=%q
+' "${PROFILE_NOTES}"
+  printf 'export ACP_PROFILE_REPO_ROOT=%q
+' "${REPO_ROOT}"
+  printf 'export ACP_PROFILE_AGENT_ROOT=%q
+' "${AGENT_ROOT}"
+  exit 0
+fi
+
+printf 'PROFILE_ID=%s
+' "${profile_id}"
+printf 'PROFILE_REGISTRY_ROOT=%s
+' "${PROFILE_REGISTRY_ROOT}"
+printf 'CONFIG_YAML=%s
+' "${CONFIG_YAML}"
+printf 'PROFILE_NOTES=%s
+' "${PROFILE_NOTES}"
+printf 'AVAILABLE_PROFILES=%s
+' "${AVAILABLE_PROFILES}"
+printf 'REPO_SLUG=%s
+' "${REPO_SLUG}"
+printf 'REPO_ROOT=%s
+' "${REPO_ROOT}"
+printf 'AGENT_ROOT=%s
+' "${AGENT_ROOT}"
+printf 'AGENT_REPO_ROOT=%s
+' "${AGENT_REPO_ROOT}"
+printf 'WORKTREE_ROOT=%s
+' "${WORKTREE_ROOT}"
+printf 'RUNS_ROOT=%s
+' "${RUNS_ROOT}"
+printf 'STATE_ROOT=%s
+' "${STATE_ROOT}"
+printf 'CODING_WORKER=%s
+' "${CODING_WORKER}"
+printf 'ACTIVE_PROVIDER_POOL_NAME=%s
+' "${ACTIVE_PROVIDER_POOL_NAME}"
+printf 'NEXT_STEP=eval "$(%s --profile-id %s --exports)"
+' "${SCRIPT_PATH}" "${profile_id}"

package/tools/bin/profile-adopt.sh

@@ -0,0 +1,219 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=/dev/null
+source "${SCRIPT_DIR}/flow-config-lib.sh"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  profile-adopt.sh [--profile-id <id>] [options]
+
+Prepare an available profile for real scheduler use by creating runtime roots,
+seeding the agent anchor repo when possible, syncing the VS Code workspace file,
+and copying the selected installed profile into the runtime root for quick
+operator access.
+
+Options:
+  --profile-id <id>                  Profile id to adopt
+  --source-repo-root <path>          Optional source repo used when seeding the agent repo
+  --skip-anchor-sync                 Do not run sync-agent-repo.sh
+  --skip-workspace-sync              Do not run sync-vscode-workspace.sh
+  --allow-missing-repo               Continue when canonical/source repos are missing
+  --help                             Show this help
+EOF
+}
+
+profile_id_override=""
+source_repo_root_override=""
+skip_anchor_sync="0"
+skip_workspace_sync="0"
+allow_missing_repo="0"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --profile-id) profile_id_override="${2:-}"; shift 2 ;;
+    --source-repo-root) source_repo_root_override="${2:-}"; shift 2 ;;
+    --skip-anchor-sync) skip_anchor_sync="1"; shift ;;
+    --skip-workspace-sync) skip_workspace_sync="1"; shift ;;
+    --allow-missing-repo) allow_missing_repo="1"; shift ;;
+    --help|-h) usage; exit 0 ;;
+    *) echo "Unknown argument: $1" >&2; usage >&2; exit 1 ;;
+  esac
+done
+
+if [[ -n "$profile_id_override" ]]; then
+  export ACP_PROJECT_ID="$profile_id_override"
+  export AGENT_PROJECT_ID="$profile_id_override"
+fi
+
+FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
+CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
+PROFILE_ID="$(flow_resolve_adapter_id "${CONFIG_YAML}")"
+PROFILE_REGISTRY_ROOT="$(resolve_flow_profile_registry_root)"
+if [[ ! -f "${CONFIG_YAML}" ]]; then
+  echo "[profile-adopt] missing installed profile config: ${CONFIG_YAML}" >&2
+  exit 1
+fi
+
+REPO_SLUG="$(flow_resolve_repo_slug "${CONFIG_YAML}")"
+DEFAULT_BRANCH="$(flow_resolve_default_branch "${CONFIG_YAML}")"
+PROJECT_LABEL="$(flow_resolve_project_label "${CONFIG_YAML}")"
+REPO_ROOT="$(flow_resolve_repo_root "${CONFIG_YAML}")"
+AGENT_REPO_ROOT="$(flow_resolve_agent_repo_root "${CONFIG_YAML}")"
+AGENT_ROOT="$(flow_resolve_agent_root "${CONFIG_YAML}")"
+RUNS_ROOT="$(flow_resolve_runs_root "${CONFIG_YAML}")"
+STATE_ROOT="$(flow_resolve_state_root "${CONFIG_YAML}")"
+HISTORY_ROOT="$(flow_resolve_history_root "${CONFIG_YAML}")"
+WORKTREE_ROOT="$(flow_resolve_worktree_root "${CONFIG_YAML}")"
+RETAINED_REPO_ROOT="$(flow_resolve_retained_repo_root "${CONFIG_YAML}")"
+VSCODE_WORKSPACE_FILE="$(flow_resolve_vscode_workspace_file "${CONFIG_YAML}")"
+REMOTE_NAME="${ACP_REMOTE_NAME:-${F_LOSNING_REMOTE_NAME:-origin}}"
+SOURCE_REPO_ROOT="${source_repo_root_override:-${ACP_SOURCE_REPO_ROOT:-${F_LOSNING_SOURCE_REPO_ROOT:-${RETAINED_REPO_ROOT}}}}"
+PROFILE_LINK="${AGENT_ROOT}/control-plane.yaml"
+WORKSPACE_LINK="${AGENT_ROOT}/workspace.code-workspace"
+INSTALLED_PROFILE_DIR="$(dirname "${CONFIG_YAML}")"
+FLOW_TOOLS_DIR="${FLOW_SKILL_DIR}/tools/bin"
+PROFILE_SMOKE_SCRIPT="${FLOW_TOOLS_DIR}/profile-smoke.sh"
+SYNC_AGENT_REPO_SCRIPT="${FLOW_TOOLS_DIR}/sync-agent-repo.sh"
+SYNC_VSCODE_WORKSPACE_SCRIPT="${FLOW_TOOLS_DIR}/sync-vscode-workspace.sh"
+
+canonical_copy_source() {
+  local target_path="${1:-}"
+  local target_dir=""
+  local target_name=""
+
+  [[ -n "$target_path" ]] || return 1
+  target_dir="$(dirname "$target_path")"
+  target_name="$(basename "$target_path")"
+  target_dir="$(cd "$target_dir" && pwd -P)"
+  printf '%s/%s\n' "$target_dir" "$target_name"
+}
+
+path_status() {
+  local path="${1:-}"
+  if [[ -z "$path" ]]; then
+    printf 'missing\n'
+  elif [[ -d "$path/.git" || -f "$path/.git" ]]; then
+    printf 'git\n'
+  elif [[ -e "$path" ]]; then
+    printf 'exists\n'
+  else
+    printf 'missing\n'
+  fi
+}
+
+repo_has_remote() {
+  local repo_root="${1:-}"
+  local remote_name="${2:-origin}"
+  [[ -n "$repo_root" ]] || return 1
+  [[ -d "$repo_root/.git" || -f "$repo_root/.git" ]] || return 1
+  git -C "$repo_root" remote get-url "$remote_name" >/dev/null 2>&1
+}
+
+if ! smoke_output="$(ACP_PROJECT_ID="$PROFILE_ID" bash "$PROFILE_SMOKE_SCRIPT" --profile-id "$PROFILE_ID" 2>&1)"; then
+  printf '%s\n' "$smoke_output" >&2
+  exit 1
+fi
+
+mkdir -p "$AGENT_ROOT" "$RUNS_ROOT" "$STATE_ROOT" "$HISTORY_ROOT" "$WORKTREE_ROOT" "$(dirname "$VSCODE_WORKSPACE_FILE")"
+copy_file_into_runtime() {
+  local source_file="${1:?source file required}"
+  local target_file="${2:?target file required}"
+  mkdir -p "$(dirname "$target_file")"
+  if [[ -L "$target_file" || -f "$target_file" ]]; then
+    rm -f "$target_file"
+  elif [[ -d "$target_file" ]]; then
+    rm -rf "$target_file"
+  fi
+  cp "$source_file" "$target_file"
+}
+
+copy_file_into_runtime "$(canonical_copy_source "$CONFIG_YAML")" "$PROFILE_LINK"
+
+warnings=0
+anchor_sync_status="skipped"
+workspace_sync_status="skipped"
+
+canonical_repo_status="$(path_status "$REPO_ROOT")"
+source_repo_status="$(path_status "$SOURCE_REPO_ROOT")"
+agent_repo_status_before="$(path_status "$AGENT_REPO_ROOT")"
+
+if [[ "$skip_anchor_sync" == "1" ]]; then
+  anchor_sync_status="skipped"
+else
+  if repo_has_remote "$REPO_ROOT" "$REMOTE_NAME" || repo_has_remote "$SOURCE_REPO_ROOT" "$REMOTE_NAME"; then
+    ACP_PROJECT_ID="$PROFILE_ID" \
+    ACP_REPO_ROOT="$REPO_ROOT" \
+    ACP_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
+    ACP_RETAINED_REPO_ROOT="$RETAINED_REPO_ROOT" \
+    ACP_SOURCE_REPO_ROOT="$SOURCE_REPO_ROOT" \
+    ACP_DEFAULT_BRANCH="$DEFAULT_BRANCH" \
+    ACP_REMOTE_NAME="$REMOTE_NAME" \
+      bash "$SYNC_AGENT_REPO_SCRIPT" >/dev/null
+    anchor_sync_status="ok"
+  elif [[ "$allow_missing_repo" == "1" ]]; then
+    anchor_sync_status="skipped-missing-repo"
+    warnings=$((warnings + 1))
+  else
+    echo "[profile-adopt] no Git source with remote '${REMOTE_NAME}' for profile ${PROFILE_ID}" >&2
+    exit 1
+  fi
+fi
+
+if [[ "$skip_workspace_sync" == "1" ]]; then
+  workspace_sync_status="skipped"
+else
+  ACP_PROJECT_ID="$PROFILE_ID" \
+  ACP_REPO_ROOT="$REPO_ROOT" \
+  ACP_AGENT_REPO_ROOT="$AGENT_REPO_ROOT" \
+  ACP_RETAINED_REPO_ROOT="$RETAINED_REPO_ROOT" \
+  ACP_VSCODE_WORKSPACE_FILE="$VSCODE_WORKSPACE_FILE" \
+  ACP_DEFAULT_BRANCH="$DEFAULT_BRANCH" \
+    bash "$SYNC_VSCODE_WORKSPACE_SCRIPT" >/dev/null
+  workspace_sync_status="ok"
+fi
+
+if [[ -f "$VSCODE_WORKSPACE_FILE" ]]; then
+  copy_file_into_runtime "$(canonical_copy_source "$VSCODE_WORKSPACE_FILE")" "$WORKSPACE_LINK"
+else
+  rm -f "$WORKSPACE_LINK"
+fi
+
+agent_repo_status_after="$(path_status "$AGENT_REPO_ROOT")"
+workspace_file_status="$(path_status "$VSCODE_WORKSPACE_FILE")"
+adopt_status="ok"
+if (( warnings > 0 )); then
+  adopt_status="ok-with-warnings"
+fi
+
+printf 'PROFILE_ID=%s\n' "$PROFILE_ID"
+printf 'PROJECT_LABEL=%s\n' "$PROJECT_LABEL"
+printf 'PROFILE_REGISTRY_ROOT=%s\n' "$PROFILE_REGISTRY_ROOT"
+printf 'INSTALLED_PROFILE_DIR=%s\n' "$INSTALLED_PROFILE_DIR"
+printf 'CONFIG_YAML=%s\n' "$CONFIG_YAML"
+printf 'REPO_SLUG=%s\n' "$REPO_SLUG"
+printf 'DEFAULT_BRANCH=%s\n' "$DEFAULT_BRANCH"
+printf 'REMOTE_NAME=%s\n' "$REMOTE_NAME"
+printf 'REPO_ROOT=%s\n' "$REPO_ROOT"
+printf 'SOURCE_REPO_ROOT=%s\n' "$SOURCE_REPO_ROOT"
+printf 'AGENT_REPO_ROOT=%s\n' "$AGENT_REPO_ROOT"
+printf 'AGENT_ROOT=%s\n' "$AGENT_ROOT"
+printf 'RUNS_ROOT=%s\n' "$RUNS_ROOT"
+printf 'STATE_ROOT=%s\n' "$STATE_ROOT"
+printf 'HISTORY_ROOT=%s\n' "$HISTORY_ROOT"
+printf 'WORKTREE_ROOT=%s\n' "$WORKTREE_ROOT"
+printf 'VSCODE_WORKSPACE_FILE=%s\n' "$VSCODE_WORKSPACE_FILE"
+printf 'PROFILE_LINK=%s\n' "$PROFILE_LINK"
+printf 'WORKSPACE_LINK=%s\n' "$WORKSPACE_LINK"
+printf 'CANONICAL_REPO_STATUS=%s\n' "$canonical_repo_status"
+printf 'SOURCE_REPO_STATUS=%s\n' "$source_repo_status"
+printf 'AGENT_REPO_STATUS_BEFORE=%s\n' "$agent_repo_status_before"
+printf 'AGENT_REPO_STATUS_AFTER=%s\n' "$agent_repo_status_after"
+printf 'WORKSPACE_FILE_STATUS=%s\n' "$workspace_file_status"
+printf 'PROFILE_SMOKE_STATUS=ok\n'
+printf 'ANCHOR_SYNC_STATUS=%s\n' "$anchor_sync_status"
+printf 'WORKSPACE_SYNC_STATUS=%s\n' "$workspace_sync_status"
+printf 'WARNING_COUNT=%s\n' "$warnings"
+printf 'ADOPT_STATUS=%s\n' "$adopt_status"