Script for monitoring/summarizing uptsream updates with hermes

2026-05-15 21:03:58 -04:00
parent e4382b98e8
commit 1f235064e2
6 changed files with 775 additions and 0 deletions
@@ -0,0 +1,52 @@
+# Install and Setup
+
+This folder stores the shippable copy for the Hermes upstream watcher job.
+
+## 1) Copy script into Hermes scripts directory
+
+```bash
+mkdir -p /home/iadnah/.hermes/scripts
+cp /home/iadnah/projects/cronScripts/hermes-repo-watcher/hermes-upstream-watch.sh /home/iadnah/.hermes/scripts/hermes-upstream-watch.sh
+chmod +x /home/iadnah/.hermes/scripts/hermes-upstream-watch.sh
+```
+
+## 2) Run once to bootstrap and verify
+
+```bash
+/home/iadnah/.hermes/scripts/hermes-upstream-watch.sh
+```
+
+Expected behavior:
+
+- Creates `/home/iadnah/lilaBuild/vaults/obsidian-private/hermes/reports/` if missing.
+- Creates `/home/iadnah/lilaBuild/vaults/obsidian-private/hermes/hermes-pain-points.md` if missing.
+- Writes a report file named `hermes-upstream-YYYY-MM-DD.md`.
+
+## 3) Optional quiet mode test
+
+```bash
+/home/iadnah/.hermes/scripts/hermes-upstream-watch.sh --quiet
+```
+
+In quiet mode, a report is only produced when either:
+
+- relevant commits are detected, or
+- local branch is at least 3 commits behind `origin/main`.
+
+## 4) Schedule daily at 8:00 with Hermes cron
+
+CLI:
+
+```bash
+hermes cron create "0 8 * * *" \
+  --no-agent \
+  --script hermes-upstream-watch.sh \
+  --deliver origin \
+  --name "hermes-upstream-watch"
+```
+
+Tool form:
+
+```text
+cronjob(action="create", schedule="0 8 * * *", script="hermes-upstream-watch.sh", no_agent=true, deliver="origin", name="hermes-upstream-watch")
+```