Add branch-neutral CI infrastructure (mirrors PR 820 work, branch-derived)

Bootstrap of the CI pipeline on maintenance/gramps61. The .github/
workflows, Dockerfile, and shared tests/ harness are the same shape as
PR 820 (gramps-project#820) and its follow-ups
(gramps-project#820 commits c6aa10e, 8d2654a,
28febdc, 715e71d, dd0fd38, 205b21c, f5907af, ff215ac),
restructured so the image tag, make.py argument, and Gramps pip pin
are all derived from the branch ref at runtime — same files run
unchanged on maintenance/gramps60, maintenance/gramps61, and any
future maintenance/grampsNN branch.

This commit lands the branch-neutral form directly on maintenance/
gramps61 instead of cherry-picking the gramps60 form and the
branch-neutral patches on top, because gramps61 has no prior CI
infrastructure to preserve.

Verified locally:
- python3 -c "import yaml; yaml.safe_load(...)" on both workflow files
- bash dry-run of ci.yml setup-job derivation: gramps61 → suffix=
  'gramps61', ci_image='ghcr.io/<repo>/gramps-ci:gramps61'
- bash dry-run of docker-build params: gramps61 → series=6.1
- docker build --check --build-arg GRAMPS_SERIES=6.0 → no warnings
- GRAMPS_SERIES guard fails the build loudly when the arg is unset

First-push expectation on this branch: docker-build and ci queue
together; ci's container jobs fail pulling the not-yet-pushed image
on the first run; re-run after docker-build finishes (~5 min cold)
and the image is available.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: eduralph

.github/docker/gramps-ci/Dockerfile

@@ -0,0 +1,66 @@
+# .github/docker/gramps-ci/Dockerfile
+#
+# Gramps CI image. The Gramps minor series (6.0, 6.1, …) is picked at
+# build time via the GRAMPS_SERIES build arg, so the same Dockerfile
+# produces gramps-ci:gramps60, gramps-ci:gramps61, … without per-branch
+# edits. Includes everything jobs need:
+#   - Python + pip-installed Gramps, PyGObject, pycairo
+#   - GTK typelibs (so addon modules that `from gi.repository import Gtk`
+#     at module load time are importable — widgets still need xvfb to render)
+#   - intltool/gettext/git for make.py builds
+#   - ruff, dbf for lint/test tooling (tests use stdlib unittest per AGENTS.md)
+#   - xvfb + xauth for tests that actually render (wrap with `xvfb-run`)
+#
+# No display server runs by default — the image is headless unless a command
+# explicitly invokes `xvfb-run`. When running with docker locally, pass
+# `--init` (or use a container runtime that injects tini) because xvfb-run
+# hangs if it inherits PID 1.
+#
+# Local build:
+#   docker build --build-arg GRAMPS_SERIES=6.0 .github/docker/gramps-ci
+#
+ARG PYTHON_VERSION=3.12
+FROM python:${PYTHON_VERSION}-slim
+
+# Gramps minor series to install (e.g. 6.0, 6.1). No default — must be
+# passed explicitly so a wrong default cannot silently produce an image
+# for the wrong Gramps series. docker-build.yml derives this from the
+# branch ref.
+ARG GRAMPS_SERIES
+RUN [ -n "$GRAMPS_SERIES" ] || { echo "GRAMPS_SERIES is required (e.g. 6.0)"; exit 1; }
+
+LABEL org.opencontainers.image.source="https://github.com/gramps-project/addons-source"
+LABEL org.opencontainers.image.description="Gramps ${GRAMPS_SERIES} CI image (Python, Gramps, GTK typelibs, xvfb)"
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        libgirepository-2.0-dev \
+        gir1.2-glib-2.0 \
+        gir1.2-gtk-3.0 \
+        gir1.2-pango-1.0 \
+        gir1.2-gdkpixbuf-2.0 \
+        gir1.2-atk-1.0 \
+        gcc \
+        pkg-config \
+        python3-dev \
+        libcairo2-dev \
+        intltool \
+        gettext \
+        git \
+        xvfb \
+        xauth \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN pip install --no-cache-dir \
+        PyGObject \
+        pycairo \
+        "gramps==${GRAMPS_SERIES}.*" \
+        orjson \
+        ruff \
+        dbf
+
+RUN apt-get purge -y gcc python3-dev pkg-config && apt-get autoremove -y
+
+RUN python -c "from gramps.gen.const import VERSION; print('Gramps', VERSION)" \
+ && python -c "import gi; gi.require_version('Gtk', '3.0'); from gi.repository import Gtk; print('GTK OK')"
+
+WORKDIR /workspace

.github/environment.yml

@@ -0,0 +1,12 @@
+name: addons-ci
+channels:
+  - conda-forge
+dependencies:
+  - python=3.12
+  - pygobject
+  - gtk3
+  - pip
+  - pip:
+      - "gramps>=6.0,<6.1"
+      - orjson
+      - dbf