diff --git a/deploy/nexus/genome-raw-commit.sh b/deploy/nexus/genome-raw-commit.sh
index 3989346..f1f66b8 100644
--- a/deploy/nexus/genome-raw-commit.sh
+++ b/deploy/nexus/genome-raw-commit.sh
@@ -1,12 +1,11 @@
 #!/bin/bash
 # genome-raw-commit <genome>
 #
-# Commits raw files synchronized by Syncthing into the vault and pushes them to origin/<base>.
-#   - Committer = n8n-bot (robotic identity responsible for pushing)
-#   - Author    = deduced from the Syncthing device ID (modifiedBy field), resolved via .authors.json.
-#                 Falls back to default values if unknown.
-#   - One commit per author/device to ensure clear attribution.
-#   - No-op if no changes are present. Excludes infrastructure files and private folders.
+# Commit the raw files that Syncthing has placed in the vault and push them to origin/<base>.
+#   - Committer = n8n-bot (sole pusher); Author = the person who wrote it (Syncthing modifiedBy -> .authors.json)
+#   - One commit per author (single-device => one commit). No-op if there is nothing.
+#   - JSON output built with jq (safe escaping), with a `files` array:
+#     for each raw -> file, author, local_path, local_url (file://), remote_url (Forgejo web).
 
 set -euo pipefail
 genome="${1:?usage: genome-raw-commit <genome>}"