upleb.uk

Public git repos — served from a NIP-34 GRASP relay at git.upleb.uk

summaryrefslogtreecommitdiff
path: root/docs/how-to/migration-scripts/10-check-git-sync.sh
diff options
context:
space:
mode:
authorDanConwayDev <DanConwayDev@protonmail.com>2026-01-23 12:15:12 +0000
committerDanConwayDev <DanConwayDev@protonmail.com>2026-01-27 20:38:01 +0000
commit79d2d01923cf66217fd5aa3a0be5ee9ea2000872 (patch)
treef1bec17762c7b84ddb6e73901d714a791b409a90 /docs/how-to/migration-scripts/10-check-git-sync.sh
parentf84c7d04ff5d3f9c6c56d78bc00c01814e7348e4 (diff)
Generalize migration guide for any GRASP implementation
- Rename guide: migrate-ngit-relay-to-ngit-grasp.md → migrate-to-ngit-grasp.md - Remove ngit-relay and relay.ngit.dev specific references - Use generic terminology: source/target relay, current implementation - Add Compatibility section explaining requirements - Update examples to be implementation-agnostic - Update script comments to reference GRASP relay (not ngit-relay) - Update README.md to link to the new guide Scripts already work with any GRASP implementation via parameters.
Diffstat (limited to 'docs/how-to/migration-scripts/10-check-git-sync.sh')
-rwxr-xr-xdocs/how-to/migration-scripts/10-check-git-sync.sh20
1 files changed, 10 insertions, 10 deletions
diff --git a/docs/how-to/migration-scripts/10-check-git-sync.sh b/docs/how-to/migration-scripts/10-check-git-sync.sh
index 493d50a..1f2ce04 100755
--- a/docs/how-to/migration-scripts/10-check-git-sync.sh
+++ b/docs/how-to/migration-scripts/10-check-git-sync.sh
@@ -2,21 +2,21 @@
2# 2#
3# 10-check-git-sync.sh - Compare state events to actual git data on disk 3# 10-check-git-sync.sh - Compare state events to actual git data on disk
4# 4#
5# PHASE 2 of the ngit-relay to ngit-grasp migration analysis pipeline. 5# PHASE 2 of the GRASP relay to ngit-grasp migration analysis pipeline.
6# Compares kind 30618 state events against actual git refs on disk. 6# Compares kind 30618 state events against actual git refs on disk.
7# 7#
8# USAGE: 8# USAGE:
9# ./10-check-git-sync.sh <state-events.json> <git-base-dir> <output-dir> [--categorize] 9# ./10-check-git-sync.sh <state-events.json> <git-base-dir> <output-dir> [--categorize]
10# 10#
11# EXAMPLES: 11# EXAMPLES:
12# # Check prod relay against prod git data 12# # Check source relay against source git data
13# ./10-check-git-sync.sh output/prod/raw/state-events.json /var/lib/ngit-relay/git output/prod 13# ./10-check-git-sync.sh output/prod/raw/state-events.json /var/lib/grasp-relay/git output/prod
14# 14#
15# # Check archive relay against archive git data 15# # Check target relay against target git data
16# ./10-check-git-sync.sh output/archive/raw/state-events.json /var/lib/ngit-relay-archive/git output/archive 16# ./10-check-git-sync.sh output/archive/raw/state-events.json /var/lib/ngit-grasp/git output/archive
17# 17#
18# # Check and categorize in one step (convenience mode) 18# # Check and categorize in one step (convenience mode)
19# ./10-check-git-sync.sh output/prod/raw/state-events.json /var/lib/ngit-relay/git output/prod --categorize 19# ./10-check-git-sync.sh output/prod/raw/state-events.json /var/lib/grasp-relay/git output/prod --categorize
20# 20#
21# INPUT: 21# INPUT:
22# state-events.json - JSONL file from Phase 1 (01-fetch-events.sh) 22# state-events.json - JSONL file from Phase 1 (01-fetch-events.sh)
@@ -53,7 +53,7 @@
53# - Handles packed refs (git show-ref) and loose refs 53# - Handles packed refs (git show-ref) and loose refs
54# 54#
55# SEE ALSO: 55# SEE ALSO:
56# docs/how-to/migrate-ngit-relay-to-ngit-grasp.md - Full migration guide 56# docs/how-to/migrate-to-ngit-grasp.md - Full migration guide
57# 01-fetch-events.sh - Phase 1 script that produces input for this script 57# 01-fetch-events.sh - Phase 1 script that produces input for this script
58# 20-categorize.sh - Phase 3a script that consumes output from this script 58# 20-categorize.sh - Phase 3a script that consumes output from this script
59# 59#
@@ -101,13 +101,13 @@ usage() {
101 echo "" 101 echo ""
102 echo "Arguments:" 102 echo "Arguments:"
103 echo " state-events.json JSONL file from Phase 1 (kind 30618 events)" 103 echo " state-events.json JSONL file from Phase 1 (kind 30618 events)"
104 echo " git-base-dir Base directory for git repos (e.g., /var/lib/ngit-relay/git)" 104 echo " git-base-dir Base directory for git repos (e.g., /var/lib/grasp-relay/git)"
105 echo " output-dir Directory to store output files" 105 echo " output-dir Directory to store output files"
106 echo " --categorize Optional: also output category files (like Phase 3)" 106 echo " --categorize Optional: also output category files (like Phase 3)"
107 echo "" 107 echo ""
108 echo "Examples:" 108 echo "Examples:"
109 echo " $0 output/prod/raw/state-events.json /var/lib/ngit-relay/git output/prod" 109 echo " $0 output/prod/raw/state-events.json /var/lib/grasp-relay/git output/prod"
110 echo " $0 output/archive/raw/state-events.json /var/lib/ngit-relay-archive/git output/archive" 110 echo " $0 output/archive/raw/state-events.json /var/lib/ngit-grasp/git output/archive"
111 echo "" 111 echo ""
112 echo "Output:" 112 echo "Output:"
113 echo " git-sync-status.tsv - TSV with: repo, npub, state_refs, git_refs, matches, reason" 113 echo " git-sync-status.tsv - TSV with: repo, npub, state_refs, git_refs, matches, reason"