setup agent runtime requirements

scripts/integration/verify-stack

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+# shellcheck disable=SC1091
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../lib/runtime-env.sh"
+
+"$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/wait-stack"
+"$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/verify-webdav"
+
+control_health="$(curl -fsS "http://localhost:${BETTERNAS_CONTROL_PLANE_PORT}/health")"
+echo "$control_health" | jq -e '.service == "control-plane" and .status == "ok"' >/dev/null
+
+register_response="$(
+  curl -fsS \
+    -X POST \
+    -H 'Content-Type: application/json' \
+    -d @- \
+    "http://localhost:${BETTERNAS_CONTROL_PLANE_PORT}/api/v1/nodes/register" <<JSON
+{"machineId":"${BETTERNAS_CLONE_NAME}-machine","displayName":"${BETTERNAS_CLONE_NAME} node","agentVersion":"${BETTERNAS_VERSION}","directAddress":"${BETTERNAS_NODE_DIRECT_ADDRESS}","relayAddress":null,"exports":[{"label":"integration","path":"${BETTERNAS_EXPORT_PATH}","protocols":["webdav"],"capacityBytes":null,"tags":["integration"]}]}
+JSON
+)"
+echo "$register_response" | jq -e '.status == "online"' >/dev/null
+
+mount_profile="$(
+  curl -fsS \
+    -X POST \
+    -H 'Content-Type: application/json' \
+    -d '{"userId":"integration-user","deviceId":"integration-device","exportId":"dev-export"}' \
+    "http://localhost:${BETTERNAS_CONTROL_PLANE_PORT}/api/v1/mount-profiles/issue"
+)"
+echo "$mount_profile" | jq -e --arg expected "$BETTERNAS_EXAMPLE_MOUNT_URL" '.protocol == "webdav" and .mountUrl == $expected' >/dev/null
+
+cloud_profile="$(
+  curl -fsS \
+    -X POST \
+    -H 'Content-Type: application/json' \
+    -d '{"userId":"integration-user","exportId":"dev-export","provider":"nextcloud"}' \
+    "http://localhost:${BETTERNAS_CONTROL_PLANE_PORT}/api/v1/cloud-profiles/issue"
+)"
+echo "$cloud_profile" | jq -e --arg expected "$NEXTCLOUD_BASE_URL" '.provider == "nextcloud" and .baseUrl == $expected' >/dev/null
+
+nextcloud_status="$(curl -fsS "${NEXTCLOUD_BASE_URL}/status.php")"
+echo "$nextcloud_status" | jq -e '.installed == true' >/dev/null
+
+nextcloud_app_status="$(
+  curl -fsS \
+    -u "${NEXTCLOUD_ADMIN_USER}:${NEXTCLOUD_ADMIN_PASSWORD}" \
+    -H 'OCS-APIRequest: true' \
+    "${NEXTCLOUD_BASE_URL}/ocs/v2.php/apps/betternascontrolplane/api/status"
+)"
+echo "$nextcloud_app_status" | jq -e '.ocs.meta.statuscode == 100' >/dev/null
+
+echo "Stack verified for ${BETTERNAS_CLONE_NAME}."

scripts/integration/verify-webdav

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+# shellcheck disable=SC1091
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../lib/runtime-env.sh"
+
+headers="$(mktemp)"
+trap 'rm -f "$headers"' EXIT
+
+curl -fsS -D "$headers" -o /dev/null -X PROPFIND -H 'Depth: 0' "$BETTERNAS_EXAMPLE_MOUNT_URL"
+
+if ! grep -Eq '^HTTP/[0-9.]+ 207' "$headers"; then
+  echo "WebDAV PROPFIND did not return 207 for $BETTERNAS_EXAMPLE_MOUNT_URL" >&2
+  cat "$headers" >&2
+  exit 1
+fi
+
+echo "WebDAV verified: $BETTERNAS_EXAMPLE_MOUNT_URL"

scripts/integration/wait-stack

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+# shellcheck disable=SC1091
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../lib/runtime-env.sh"
+
+wait_for_url() {
+  local url="$1"
+  local label="$2"
+  local max_attempts="${3:-60}"
+
+  for _ in $(seq 1 "$max_attempts"); do
+    if curl -fsS "$url" >/dev/null 2>&1; then
+      echo "$label ready: $url"
+      return 0
+    fi
+    sleep 2
+  done
+
+  echo "$label did not become ready: $url" >&2
+  return 1
+}
+
+wait_for_url "http://localhost:${BETTERNAS_CONTROL_PLANE_PORT}/health" "control plane"
+wait_for_url "http://localhost:${BETTERNAS_NODE_AGENT_PORT}/health" "node agent"
+wait_for_url "${NEXTCLOUD_BASE_URL}/status.php" "nextcloud"