blob: 69f84fa43dfd133313557aa4904df7a006b4effa (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
|
# Summary - ngit-relay Testing Documentation
**Date:** November 5, 2025
**Status:** ✅ COMPLETE
---
## What Was Accomplished
### ✅ Updated grasp-audit/README.md
Added comprehensive "Integration Tests Against ngit-relay" section with:
1. **Manual step-by-step instructions** for testing against ngit-relay
2. **All required environment variables** documented and explained
3. **Port mapping details** (WebSocket and HTTP both on 8081)
4. **Clean state strategy** using fresh /tmp directories
5. **Cleanup procedures** for container and test data
### ✅ Created test-ngit-relay.sh Script
Automated test script that:
- Creates fresh test directories
- Starts ngit-relay Docker container with correct configuration
- Waits for relay to start
- Runs integration tests
- Cleans up completely
- Has executable permissions and validated syntax
---
## Key Configuration Details
### Docker Image
```
ghcr.io/danconwaydev/ngit-relay:latest
```
### Environment Variables
All required variables documented in README:
- `NGIT_DOMAIN` - Domain name (localhost for testing)
- `NGIT_RELAY_NAME` - Relay name for NIP-11
- `NGIT_RELAY_DESCRIPTION` - Relay description
- `NGIT_OWNER_NPUB` - Owner's public key
- `NGIT_PROACTIVE_SYNC_*` - Disabled for testing
- `NGIT_LOG_LEVEL` - Set to INFO
### Volume Mounts
Fresh directories in `/tmp/ngit-test/` for:
- repos
- blossom
- relay-db
- logs
### Endpoints
- **WebSocket:** `ws://localhost:8081/`
- **Git HTTP:** `http://localhost:8081/<npub>/<identifier>.git`
---
## Usage
### Quick Start
```bash
cd grasp-audit
./test-ngit-relay.sh
```
### Manual Testing
See detailed step-by-step commands in `grasp-audit/README.md`
---
## Ready for Next Phase
✅ **Infrastructure complete** - Can now test against ngit-relay
✅ **Documentation complete** - README has all details
✅ **Automation complete** - Script handles full lifecycle
🔜 **Next:** Implement GRASP-01 tests one at a time per plan in `work/current_status.md`
---
## Files Modified
1. ✅ `grasp-audit/README.md` - Added ngit-relay testing section
2. ✅ `grasp-audit/test-ngit-relay.sh` - Created automated test script
3. ✅ `work/ngit-relay-testing-setup.md` - Detailed setup documentation
4. ✅ `work/summary.md` - This file
---
**All prerequisites complete. Ready to begin GRASP-01 test implementation!**
|