server/Dockerfile

# Copyright (c) Meta Platforms, Inc. and affiliates.
# All rights reserved.
#
# This source code is licensed under the BSD-style license found in the
# LICENSE file in the root directory of this source tree.

# DUPLICATION CONTRACT (server/Dockerfile <-> root Dockerfile):
# These two Dockerfiles produce equivalent images and must stay in sync on:
#   - BASE_IMAGE (ghcr.io/meta-pytorch/openenv-base:latest)
#   - Python dependency install (two-stage `uv sync`, --frozen if uv.lock present)
#   - CMD (`cd /app/env && uvicorn server.app:app --host 0.0.0.0 --port 8000`)
#   - HEALTHCHECK on /health
#   - PYTHONPATH=/app/env:$PYTHONPATH (so the dual-import fallback resolves)
#   - git installed in both builder and runtime stages for HF Spaces dev-mode
# Drift will cause the hackathon validator (which builds the root file) and
# `openenv build` (which builds this file) to produce different images.
# Update both together. Run `diff Dockerfile server/Dockerfile` after any
# change to confirm only documented differences exist.
#
# Allowed to differ (purely cosmetic / non-binding):
#   - Comments and ordering of `ARG` declarations
#   - Header text describing the file's role
#   - This contract block itself

# Multi-stage build using openenv-base
# This Dockerfile is flexible and works for both:
# - In-repo environments (with local OpenEnv sources)
# - Standalone environments (with openenv from PyPI/Git)
# The build script (openenv build) handles context detection and sets appropriate build args.

ARG BASE_IMAGE=ghcr.io/meta-pytorch/openenv-base:latest
FROM ${BASE_IMAGE:-ghcr.io/meta-pytorch/openenv-base:latest} AS builder

WORKDIR /app

# Ensure git is available (required for installing dependencies from VCS)
RUN apt-get update && \
    apt-get install -y --no-install-recommends git && \
    rm -rf /var/lib/apt/lists/*

# Build argument to control whether we're building standalone or in-repo
ARG BUILD_MODE=in-repo
ARG ENV_NAME=CrisisWorldCortex

# Copy environment code (always at root of build context)
COPY . /app/env

# For in-repo builds, openenv is already vendored in the build context
# For standalone builds, openenv will be installed via pyproject.toml
WORKDIR /app/env

# Ensure uv is available (for local builds where base image lacks it)
RUN if ! command -v uv >/dev/null 2>&1; then \
        curl -LsSf https://astral.sh/uv/install.sh | sh && \
        mv /root/.local/bin/uv /usr/local/bin/uv && \
        mv /root/.local/bin/uvx /usr/local/bin/uvx; \
    fi
    
# Install dependencies using uv sync
# If uv.lock exists, use it; otherwise resolve on the fly
RUN --mount=type=cache,target=/root/.cache/uv \
    if [ -f uv.lock ]; then \
        uv sync --frozen --no-install-project --no-editable; \
    else \
        uv sync --no-install-project --no-editable; \
    fi

RUN --mount=type=cache,target=/root/.cache/uv \
    if [ -f uv.lock ]; then \
        uv sync --frozen --no-editable; \
    else \
        uv sync --no-editable; \
    fi

# Final runtime stage
FROM ${BASE_IMAGE:-ghcr.io/meta-pytorch/openenv-base:latest}

WORKDIR /app

# HF Spaces dev-mode runs git config in the final stage after this image is
# assembled; keep git available outside the builder stage.
RUN apt-get update && \
    apt-get install -y --no-install-recommends git && \
    rm -rf /var/lib/apt/lists/*

# Copy the virtual environment from builder
COPY --from=builder /app/env/.venv /app/.venv

# Copy the environment code
COPY --from=builder /app/env /app/env

# Set PATH to use the virtual environment
ENV PATH="/app/.venv/bin:$PATH"

# Set PYTHONPATH so imports work correctly
ENV PYTHONPATH="/app/env:$PYTHONPATH"

# Health check
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
    CMD curl -f http://localhost:8000/health || exit 1

# Run the FastAPI server
# The module path is constructed to work with the /app/env structure
CMD ["sh", "-c", "cd /app/env && uvicorn server.app:app --host 0.0.0.0 --port 8000"]