feat: add archive-grasp-services configuration option

Enables relay operators to backup/archive specific GRASP servers by domain.
Includes configuration, validation, documentation, and integration tests.

1 files changed, 13 insertions, 1 deletions

diff --git a/.env.example b/.env.example
index a19a07d..e152b89 100644
--- a/.env.example
+++ b/.env.example
@@ -191,6 +191,18 @@
 #   NGIT_ARCHIVE_WHITELIST=bitcoin-core,linux,rust
 # NGIT_ARCHIVE_WHITELIST=
 
+# Archive GRASP services: comma-separated list of GRASP server domains to archive
+# Archives all repositories from the specified GRASP server domains
+# Must be bare domains only (e.g., git.example.com, NOT wss://git.example.com)
+# Mutually exclusive with NGIT_ARCHIVE_ALL and NGIT_ARCHIVE_WHITELIST
+# Automatically sets NGIT_ARCHIVE_READ_ONLY to true by default
+# CLI: --archive-grasp-services <list>
+# Default: (empty)
+# Examples:
+#   NGIT_ARCHIVE_GRASP_SERVICES=git.example.com
+#   NGIT_ARCHIVE_GRASP_SERVICES=git.example.com,git.nostr.dev,relay.gitnostr.com
+# NGIT_ARCHIVE_GRASP_SERVICES=
+
 # Archive read-only mode (relay is read-only sync of archived repositories)
 # When true:
 #   - NIP-11 includes GRASP-05 in supported_grasps
@@ -200,7 +212,7 @@
 #   - Archive mode disabled (standard GRASP-01 operation)
 #
 # CLI: --archive-read-only
-# Default: true if NGIT_ARCHIVE_ALL or NGIT_ARCHIVE_WHITELIST is set, false otherwise
+# Default: true if NGIT_ARCHIVE_ALL, NGIT_ARCHIVE_WHITELIST, or NGIT_ARCHIVE_GRASP_SERVICES is set, false otherwise
 # Note: Setting to true without archive config causes startup error
 # Note: Cannot be used with NGIT_REPOSITORY_WHITELIST (mutually exclusive)
 # NGIT_ARCHIVE_READ_ONLY=