about summary refs log tree commit diff
diff options
context:
space:
mode:
authorPjotr <wrk@bosa.lan>2026-10-04 08:17:08 +0000
committerPjotr <wrk@bosa.lan>2026-10-04 08:17:08 +0000
commitc01411e98a0d3a5671ee6914c844215ce578efe5 (patch)
treeb62138329aeb702ab573c827c1b80d9cc5584c6b
parent205d331011d0b64e534499baac65b3fd9d593825 (diff)
downloadgenecup-c01411e98a0d3a5671ee6914c844215ce578efe5.tar.gz
doc: RELEASE_NOTES 1.9.2 (container deployment); bump VERSION
Documents the Guix system container deployment (services and
container definition in gn-machines, pointing at the new documents),
the genecup-gemini package in guix-bioinformatics now fetched from
this repository at build time, the four packaging fixes found by the
container smoke test (curl/wget/xargs on the wrapper PATH, CA bundle
environment, EDIRECT_LOCAL_ARCHIVE export with the pubmed symlink
archive layout, and the tolerant archive-existence check), the
11-check smoke test and the operational notes (datadir, optional
Gemini credentials, optional shared PubMed archive).

VERSION bumped to 1.9.2 (the version the /about page reports).
-rw-r--r--RELEASE_NOTES.md69
-rw-r--r--VERSION2
2 files changed, 70 insertions, 1 deletions
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 0d73f75..26c8737 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -39,3 +39,72 @@
 - Moved dead code to old/server.py
 - Removed unused TensorFlow/Keras dependencies
 - Removed stress_prompt.txt dependency (batch classifier builds its own prompt)
+
+## Version 1.9.2 (2026-10-04)
+
+### Guix system container (new)
+
+- **Deployable as a Guix system container** through the
+  gn-machines repository:
+  `genenetwork/services/genecup.scm` (services) and
+  `genenetwork/containers/genecup-container.scm` (the container).
+  nginx runs in the foreground as a reverse proxy on port 4201 in
+  front of the Flask app on 127.0.0.1:4202; the Anubis AI-bot
+  firewall can challenge browser traffic (anubis? #t, bundled into
+  the nginx shepherd service).  Container SSH on port 2223 with the
+  pinned hello-container-key, same as the BNW and cgit containers.
+  Build with:
+
+      guix system container --network \
+        -L $base/guix-bioinformatics \
+        -L $base/gn-machines \
+        -L $base/contrib/guix-forge/guix \
+        $base/gn-machines/genenetwork/containers/genecup-container.scm
+
+- **genecup-gemini 1.9 in guix-bioinformatics**
+  (`gn/packages/genecup.scm`): this repository is now fetched from
+  https://git.genenetwork.org/genecup at build time (git-fetch,
+  commit-pinned) instead of the local-source guix.scm.  guix.scm
+  stays for interactive development (`guix shell -L . -C -N -F ...`).
+
+### Packaging fixes found by the container smoke test
+
+All four surfaced as silent environment failures during a live
+end-to-end run in the minimal container:
+
+- edirect's `nquire` shells out to curl/wget and
+  `join-into-groups-of` shells out to xargs; the genecup wrapper now
+  puts curl, wget and findutils (xargs) on its PATH
+- curl exited 60/77 (CA verification) in the minimal container: the
+  wrapper exports SSL_CERT_FILE and CURL_CA_BUNDLE pointing at the
+  profile-generated /etc/ssl/certs/ca-certificates.crt
+- xfetch/rchive require EDIRECT_LOCAL_ARCHIVE in the environment;
+  the wrapper exports it pointing at
+  `<out>/share/genecup-archive`, whose `pubmed` symlink exposes the
+  bundled minipubmed archive in the `<archive>/pubmed/Archive/<NN>`
+  layout xfetch expects (minipubmed itself is laid out flat).  The
+  startup check in more_functions.py now accepts both the full
+  edirect layout and the flat minipubmed layout, so the server
+  boots without a full local archive (abstract fetches fall back to
+  NCBI efetch over the network)
+
+### Testing
+
+- `genenetwork/services/test/genecup_smoke.py` (in gn-machines)
+  drives the full anonymous flow against a running container: front
+  page, about (version), search kickoff, the /search SSE stream,
+  cytoscape graph, table view, a /sentences page and the static
+  assets -- 11/11 green.  Note: the SSE stream must be read to EOF
+  (the generator writes nodes.json/edges.json only after the final
+  yield).
+
+### Operational notes
+
+- Writable state (userspub.sqlite, per-user folders) lives under
+  GENECUP_DATADIR=/var/lib/genecup in the container
+- Gemini features are optional: share a 0400 credentials file into
+  the container at /var/lib/genecup/.config/gemini/credentials
+- A full local PubMed archive can be shared into the container and
+  selected with the pubmed-archive field (exports
+  EDIRECT_LOCAL_ARCHIVE); without it edirect queries NCBI over the
+  network, subject to eutils rate limits
diff --git a/VERSION b/VERSION
index 9ab8337..8fdcf38 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-1.9.1
+1.9.2