cmvr_edge_ai/scripts/bootstrap.sh

#!/usr/bin/env bash
set -euo pipefail

SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
PROJECT_ROOT="$(cd -- "${SCRIPT_DIR}/.." && pwd)"

profile="detection-cpu"
cmvr_es_root="${PROJECT_ROOT}/../cmvr-es"
skip_codegen=false
skip_check=false

verify_model_artifact() {
  local model_id="$1"
  local relative_path="$2"
  local expected_size="$3"
  local expected_sha256="$4"
  local artifact_path="${PROJECT_ROOT}/${relative_path}"

  if [[ ! -f "${artifact_path}" ]]; then
    echo "error: model artifact is missing for ${model_id}: ${relative_path}" >&2
    echo "restore the model file before using the ${profile} profile" >&2
    exit 1
  fi

  if LC_ALL=C grep -q -F "version https://git-lfs.github.com/spec/v1" "${artifact_path}"; then
    echo "error: model artifact is only a Git LFS pointer: ${relative_path}" >&2
    echo "run 'git lfs pull' to fetch the real model weights" >&2
    exit 1
  fi

  local actual_size
  actual_size="$(wc -c < "${artifact_path}")"
  actual_size="${actual_size//[[:space:]]/}"
  if [[ "${actual_size}" != "${expected_size}" ]]; then
    echo "error: model artifact size mismatch for ${model_id}: ${relative_path}" >&2
    echo "expected ${expected_size} bytes, got ${actual_size} bytes" >&2
    exit 1
  fi

  local actual_sha256
  actual_sha256="$(sha256sum "${artifact_path}" | awk '{print $1}')"
  if [[ "${actual_sha256}" != "${expected_sha256}" ]]; then
    echo "error: model artifact checksum mismatch for ${model_id}: ${relative_path}" >&2
    echo "expected SHA256 ${expected_sha256}, got ${actual_sha256}" >&2
    exit 1
  fi
}

usage() {
  cat <<'EOF'
Usage: bash scripts/bootstrap.sh [options]

Create the locked uv environment, optionally generate cmvr-es Python bindings,
and run basic health checks.

Options:
  --profile PROFILE     core, detection-cpu (default), or dev
  --cmvr-es-root PATH   cmvr-es checkout (default: sibling ../cmvr-es)
  --skip-codegen        do not generate cmvr-es protobuf/gRPC bindings
  --skip-check          install only; skip validation and tests
  -h, --help            show this help

Profiles:
  core            framework, minimal fixture, and simulated talk pipeline only
  detection-cpu   gRPC + HTTP + PyAV + locked CPU YOLO runtime
  dev             detection-cpu plus tests and portable protobuf codegen tools
EOF
}

while (($#)); do
  case "$1" in
    --profile)
      if (($# < 2)); then
        echo "error: --profile requires a value" >&2
        exit 2
      fi
      profile="$2"
      shift 2
      ;;
    --cmvr-es-root)
      if (($# < 2)); then
        echo "error: --cmvr-es-root requires a path" >&2
        exit 2
      fi
      cmvr_es_root="$2"
      shift 2
      ;;
    --skip-codegen)
      skip_codegen=true
      shift
      ;;
    --skip-check)
      skip_check=true
      shift
      ;;
    -h|--help)
      usage
      exit 0
      ;;
    *)
      echo "error: unknown argument: $1" >&2
      usage >&2
      exit 2
      ;;
  esac
done

case "${profile}" in
  core)
    sync_args=(--locked --no-default-groups)
    needs_cmvr_bindings=false
    ;;
  detection-cpu)
    sync_args=(
      --locked
      --no-default-groups
      --extra grpc
      --extra http
      --extra video
      --extra image
      --extra yolo-cpu
    )
    needs_cmvr_bindings=true
    ;;
  dev)
    sync_args=(
      --locked
      --no-default-groups
      --group dev
      --extra grpc
      --extra http
      --extra video
      --extra image
      --extra yolo-cpu
    )
    needs_cmvr_bindings=true
    ;;
  *)
    echo "error: unsupported profile '${profile}'" >&2
    echo "expected one of: core, detection-cpu, dev" >&2
    exit 2
    ;;
esac

if ! command -v uv >/dev/null 2>&1; then
  echo "error: uv is not installed or not available on PATH" >&2
  echo "see https://docs.astral.sh/uv/getting-started/installation/" >&2
  exit 1
fi

cd "${PROJECT_ROOT}"
echo "==> project: ${PROJECT_ROOT}"
echo "==> profile: ${profile}"

if [[ "${needs_cmvr_bindings}" == true && "${skip_codegen}" == false ]]; then
  if [[ ! -d "${cmvr_es_root}/protos/cmvr" ]]; then
    echo "error: cmvr-es protos were not found under: ${cmvr_es_root}" >&2
    echo "pass --cmvr-es-root PATH or use --skip-codegen with existing bindings" >&2
    exit 1
  fi

  echo "==> installing the locked protobuf codegen environment"
  uv sync --locked --only-group codegen
  echo "==> generating cmvr-es Python bindings from ${cmvr_es_root}"
  .venv/bin/python scripts/generate_cmvr_stubs.py \
    --cmvr-es-root "${cmvr_es_root}" \
    --portable
fi

echo "==> installing the locked ${profile} environment"
uv sync "${sync_args[@]}"

if [[ "${skip_check}" == true ]]; then
  echo "==> installation complete (checks skipped)"
  exit 0
fi

echo "==> validating the minimal framework fixture"
.venv/bin/cmvr-edge-ai validate \
  --config tests/fixtures/minimal_pipeline.yaml \
  --pipeline minimal

echo "==> validating the merged talk pipeline"
.venv/bin/cmvr-edge-ai validate \
  --config configs/edge_ai.yaml \
  --pipeline talk

if [[ "${needs_cmvr_bindings}" == true ]]; then
  echo "==> verifying detection model artifacts"
  verify_model_artifact \
    "construction-ppe-yolov8@1" \
    "models/detection/construction-ppe-yolov8/v1/best.pt" \
    "22537898" \
    "31ef3ca04a17cf545f3fcfc64c4af8993a41d52ccc460e82aff01d5354603533"
  verify_model_artifact \
    "ppe-6classes-yolov8n@1" \
    "models/detection/ppe-6classes-yolov8n/v1/best.pt" \
    "5625014" \
    "07172ef3ae9e256c40a1fb0ce3eefe5547d90170645aa73dded0fffc382cdb31"

  echo "==> checking detection runtime imports"
  .venv/bin/python -c \
    "import av, grpc, httpx, PIL, torch, ultralytics; import cmvr.api.camera_service_pb2_grpc; print(f'torch={torch.__version__} cuda={torch.cuda.is_available()} ultralytics={ultralytics.__version__} pillow={PIL.__version__}')"
  echo "==> validating the PPE detection pipeline"
  .venv/bin/cmvr-edge-ai validate \
    --config configs/edge_ai.yaml \
    --pipeline detection
  .venv/bin/cmvr-edge-ai models
fi

if [[ "${profile}" == dev ]]; then
  echo "==> running tests"
  .venv/bin/pytest
fi

echo "==> bootstrap complete"
echo "run commands with: uv run --no-sync cmvr-edge-ai ..."