chore: USGS Water Dockerfile, docker-compose entry, plan update

- Add Dockerfile for USGS Water publisher (15min cadence)
- Add usgs-water service to docker-compose.yml
- Update Phase 1 acceptance criteria (5/6 checked)
- VM deployment and Explorer verification still pending

Author: Sam-Bolling

docs/research/USGS_NIMS_Follow_On_Publishers_Plan.md

@@ -152,15 +152,19 @@ Normalize around a compact common observation shape:
 
 ### 7.5 Acceptance Criteria
 
-- [ ] Creates valid CSAPI metadata resources (procedure, deployment hierarchy, systems, datastreams)
-- [ ] Publishes at least one numeric datastream per selected station
-- [ ] Handles pagination correctly (follows `next` links)
-- [ ] Uses API key correctly (query parameter or `X-Api-Key` header)
-- [ ] Produces stable observations for at least one full polling cycle
+- [x] Creates valid CSAPI metadata resources (procedure, deployment hierarchy, systems, datastreams)
+- [x] Publishes at least one numeric datastream per selected station
+- [x] Handles pagination correctly (follows `next` links)
+- [x] Uses API key correctly (query parameter or `X-Api-Key` header)
+- [x] Produces stable observations for at least one full polling cycle
 - [ ] Stations visible in Explorer with correct map positions and data
 
 **Exit criteria:** Water publisher running on VM, observations flowing, visible in Explorer.
 
+> **Phase 1 Status (2026-03-11):** Bootstrap complete (35 resources), publisher tested locally
+> (13/14 published OK, 1 transient timeout, 2 seasonal no-data). Code committed `4e3bb1e`.
+> VM deployment pending (manual SSH step). Explorer verification pending.
+
 ---
 
 ## 8. Phase 2 — USGS NIMS Imagery Publisher

publishers/docker-compose.yml

@@ -33,3 +33,13 @@ services:
     environment:
       <<: *osh-env
     command: ["--interval", "3600"]
+
+  usgs-water:
+    build:
+      context: ..
+      dockerfile: publishers/usgs_water/Dockerfile
+    restart: always
+    environment:
+      <<: *osh-env
+      # USGS_API_KEY: "${USGS_API_KEY:-}"
+    command: ["--interval", "900"]

publishers/usgs_water/Dockerfile

@@ -0,0 +1,20 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+# Install dependencies (no additional pip packages needed beyond stdlib)
+RUN pip install --no-cache-dir git+https://github.com/OS4CSAPI/OSHConnect-Python.git
+
+# Copy publisher framework + USGS Water publisher
+COPY publishers/ /app/publishers/
+
+# Default: 15min cadence (matches USGS reporting frequency)
+ENV OSH_ADDRESS=os4csapi-osh.duckdns.org
+ENV OSH_PORT=443
+ENV OSH_USER=os4csapi
+ENV OSH_PASS=ogc134mm
+# Optional: USGS API key for higher rate limits
+# ENV USGS_API_KEY=
+
+ENTRYPOINT ["python", "-m", "publishers.usgs_water.usgs_water_publisher"]
+CMD ["--interval", "900"]