From 80fa4c8edae0864b320706d8cae0c0a488b8a60e Mon Sep 17 00:00:00 2001 From: Matteo Cherubini Date: Sun, 21 Jun 2026 00:04:34 +0200 Subject: [PATCH] chore: Improve script documentation and initial comments --- deploy/nexus/genome-raw-commit.sh | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) 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 # -# Commits raw files synchronized by Syncthing into the vault and pushes them to origin/. -# - 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/. +# - 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 }"