Dockerfile.dev

# Interactive dev container for satdeploy.
#
# Use case: full Linux dev environment with tmux + editors + build tools where
# the satdeploy source tree is mounted live from the Mac host. Edits on the
# host show up inside the container immediately, builds happen inside the
# container against real Linux libcsp/libdtp/etc. (none of which compile on
# darwin per CLAUDE.md).
#
# Usage:
#   ./scripts/docker-dev.sh                        # build + drop into shell
#   docker exec -it satdeploy-dev tmux             # second pane via exec
#
# Once inside:
#   build-all                              # alias for both meson+ninja runs
#   ./satdeploy-agent/build-native/satdeploy-agent --version
#
# Differs from the verification Dockerfile:
#   - source is volume-mounted, not COPY'd in (live edits)
#   - no smoke-tests baked into `docker build` (you run them yourself)
#   - tmux + vim + nano + gdb + htop + jq + less + man pages

FROM ubuntu:24.04

ENV DEBIAN_FRONTEND=noninteractive
ENV TZ=UTC
ENV LANG=C.UTF-8

# Build deps + dev quality-of-life. zmqproxy is built from the libcsp source
# tree (lib/csp/utils/zmqproxy.c), not an apt package — don't add one.
# CSH-specific deps included: libcurl4-openssl-dev, libelf-dev, libbsd-dev,
# can-utils, fonts-powerline (per spaceinventor/csh README).
RUN apt-get update && apt-get install -y --no-install-recommends \
        build-essential \
        ninja-build \
        pkg-config \
        libssl-dev \
        libsocketcan-dev \
        libzmq3-dev \
        libprotobuf-c-dev \
        protobuf-c-compiler \
        libyaml-dev \
        libsqlite3-dev \
        libcurl4-openssl-dev \
        libelf-dev \
        libbsd-dev \
        can-utils \
        iproute2 \
        fonts-powerline \
        tmux \
        vim \
        nano \
        less \
        man-db \
        manpages \
        manpages-dev \
        htop \
        gdb \
        valgrind \
        strace \
        ltrace \
        file \
        tree \
        jq \
        ripgrep \
        fd-find \
        curl \
        wget \
        git \
        openssh-client \
        ca-certificates \
        sudo \
        bash-completion \
        python3 \
        python3-dev \
        python3-pip \
        pipx \
    && rm -rf /var/lib/apt/lists/*

# CSH's meson.build requires meson_version >= 1.6, but Ubuntu 24.04 ships 1.3.
# Install a recent meson via pip globally (--break-system-packages bypasses
# PEP 668; safe in a container). satdeploy-agent + apm build fine with the
# newer meson.
RUN pip3 install --break-system-packages meson \
    && meson --version

# Build CSH from source. Pinned to HEAD by default; override with
# --build-arg CSH_REF=<commit-or-tag>. The CSP submodule version that CSH
# pulls in must match the APM's libcsp version (per CLAUDE.md): linking the
# static CSP lib in the APM would normally embed uninitialized globals that
# shadow CSH's, but the APM's meson.build uses partial_dependency to take
# headers only, sidestepping the issue. Even so, struct layout has to match
# at runtime — if you bump the APM's lib/csp submodule, rebuild CSH against
# the matching ref by passing --build-arg CSH_REF=<that-ref>.
ARG CSH_REF=HEAD
RUN git clone --recurse-submodules https://github.com/spaceinventor/csh.git /opt/csh \
    && cd /opt/csh \
    && if [ "$CSH_REF" != "HEAD" ]; then \
           git fetch --depth 50 origin "$CSH_REF" \
        && git checkout "$CSH_REF" \
        && git submodule update --init --recursive ; \
       fi \
    && meson setup builddir \
    && ninja -C builddir \
    && ln -s /opt/csh/builddir/csh /usr/local/bin/csh \
    && ln -s /opt/csh/builddir/zmqproxy /usr/local/bin/zmqproxy \
    && mkdir -p /root/.local/lib/csh \
    && test -x /usr/local/bin/csh && test -x /usr/local/bin/zmqproxy

# The dev shell helpers live in scripts/dev-shell.sh in the repo so they can
# be tweaked without a docker rebuild — the volume mount makes host edits
# immediately available inside the container. The /etc/profile.d entry just
# sources that file (with a fallback if the volume isn't mounted).
RUN cat >/etc/profile.d/satdeploy.sh <<'PRF'
if [ -r /satdeploy/scripts/dev-shell.sh ]; then
    . /satdeploy/scripts/dev-shell.sh
fi
PRF

# Make interactive shells also pick up the profile.d script (Ubuntu's
# /etc/bash.bashrc is sourced for interactive non-login shells; without
# this hook those would miss the helpers).
RUN echo 'for f in /etc/profile.d/*.sh; do [ -r "$f" ] && . "$f"; done' \
        >>/etc/bash.bashrc

# Welcome banner runs once per top-level entry. $TMUX is set inside tmux
# panes — skipping the MOTD there avoids printing it in every new pane.
RUN cat >/etc/profile.d/satdeploy-motd.sh <<'MOTD'
[ -n "$TMUX" ] && return 0
cat <<EOF
─────────────────────────────────────────────────────
 satdeploy dev container
   /satdeploy            — your repo (live-mounted from the Mac)
   build-agent           — meson + ninja for the agent
   build-apm             — meson + ninja for the APM (auto-installs the .so)
   build-all             — both
   agent --version       — shorthand for the built agent binary
   csh                   — CSP shell (dlopens APMs from ~/.local/lib/csh/)
   csh-zmq               — csh -i /satdeploy/init/zmq.csh (CSP-on-ZMQ ground)
   zmqproxy              — CSP ZMQ broker (built alongside CSH)
   tmux                  — multi-pane terminal

 Workflow for end-to-end CSP test:
   tmux                                     # split window
   pane 1: zmqproxy                         # CSP localhost transport
   pane 2: agent -i ZMQ -p localhost -a 5425
   pane 3: build-apm && csh-zmq
                csh> apm load
                csh> satdeploy status -n 5425
                csh> satdeploy push controller

 Native build is x86_64 (or arm64 on Apple Silicon Docker) — fine for
 verification, NEVER for flight. Real flight builds go through Yocto.
─────────────────────────────────────────────────────
EOF
MOTD

# Tmux config: scrollback, mouse, and pane-split bindings the user asked for.
#   prefix v  → vertical-line split (panes side-by-side, split-window -h)
#   prefix s  → horizontal-line split (panes stacked,    split-window -v)
# `unbind s` first because it normally maps to choose-tree (session list).
RUN cat >/root/.tmux.conf <<'TCONF'
set -g history-limit 50000
set -g mouse on
set -g default-terminal "screen-256color"
set -g status-bg colour235
set -g status-fg colour250

unbind s
bind v split-window -hc "#{pane_current_path}"
bind s split-window -vc "#{pane_current_path}"
TCONF

WORKDIR /satdeploy

# Auto-launch the entry script on container entry. It pre-builds, starts
# zmqproxy in background, and opens a 2-pane tmux session (csh on left,
# agent on right). The script lives in /satdeploy so edits don't require
# a docker rebuild.
CMD ["/satdeploy/scripts/docker-entry.sh"]