Record wallpaper project architecture findings + periodic-commit preference

project_cyberpunk_wallpaper.md

@@ -19,3 +19,26 @@ the desktop day-to-day.
 CLAUDE.md). Pull/expose metrics via Prometheus HTTP API (or a small bridge script)
 for the Rainmeter skin to consume. See [[project-claude-memory-sync]] for the shared
 memory setup that motivated adding this command to the homelab quick reference.
+
+## Architecture findings (2026-06-12)
+- Prometheus on monk (`100.85.209.116:9090`) is reachable directly from samurai over
+  Tailscale - confirmed via `curl http://100.85.209.116:9090/api/v1/targets`.
+- Current scrape jobs: `t14-node` (monk's own node-exporter container) and
+  `kscloud1-node` (kscloud1 node-exporter, public IP - do not commit this IP anywhere).
+  Config lives at `~/kitestacks-live/docker/prometheus/prometheus.yml` on monk.
+- samurai has NO exporter yet - needs windows_exporter installed (port 9182) and a
+  new `samurai-node` scrape job targeting `100.74.0.109:9182` added to prometheus.yml.
+- Neither Rainmeter nor a windows_exporter is installed on samurai yet.
+- Wallpaper Engine IS installed, but at a non-default Steam location:
+  `C:\Program Files (x86)\steam2\steamapps\common\wallpaper_engine` (note "steam2" dir name).
+- monk also runs `kitestacks-metrics-api` (FastAPI/psutil, source at
+  `/home/kenpatmonk/kitestacks-live/docker/.../main.py` inside container `/app/main.py`)
+  exposing `/api/metrics`, `/api/weather`, `/api/activity` as JSON - a reference
+  pattern, but the wallpaper plan uses Prometheus directly as the unified data source
+  for all 3 hosts instead.
+
+## SSH access notes
+- `ssh monk` now works for general shell (port 22, user kenpatmonk, key id_devman) -
+  added as a Host alias in samurai's ~/.ssh/config. Separate from the
+  `100.85.209.116` config block used for Forgejo git (port 2222, user git,
+  id_ed25519_forgejo) - both entries must coexist, do not collapse them.