diff options
| author | DanConwayDev <DanConwayDev@protonmail.com> | 2026-01-23 12:15:12 +0000 |
|---|---|---|
| committer | DanConwayDev <DanConwayDev@protonmail.com> | 2026-01-27 20:38:01 +0000 |
| commit | 79d2d01923cf66217fd5aa3a0be5ee9ea2000872 (patch) | |
| tree | f1bec17762c7b84ddb6e73901d714a791b409a90 /docs/how-to/migration-scripts/10-check-git-sync.sh | |
| parent | f84c7d04ff5d3f9c6c56d78bc00c01814e7348e4 (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-x | docs/how-to/migration-scripts/10-check-git-sync.sh | 20 |
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" |