issue: create 4bc5 - relay.ngit.dev migration v2 (fresh start)

4bc5-relay-ngit-dev-migration-v2.md

@@ -0,0 +1,34 @@
+# Migrate relay.ngit.dev from ngit-relay to ngit-grasp (v2)
+
+**ID:** 4bc5
+
+## Problem
+
+relay.ngit.dev currently runs ngit-relay (reference implementation). We want to consolidate on ngit-grasp as the production implementation.
+
+**Goal:** Replace an ngit-relay instance on a VPS running NixOS with ngit-grasp.
+
+**Context:** This is a fresh start after issue 820a became too complex with extensive investigation history. We're starting from scratch with a focus on creating a small, lightweight, easy-to-implement how-to document.
+
+## Plan
+
+- [ ] Phase 1: Planning - Design migration script and approach
+- [ ] Phase 2: Documentation - Create comprehensive how-to guide
+- [ ] Phase 3: Execution - Run migration on relay.ngit.dev
+- [ ] Phase 4: Validation - Verify migration success
+
+## Progress
+
+### 2026-01-23 [Session 16:00]
+- Created: Fresh v2 issue to replace complex 820a migration
+- Context: Previous issue (820a) paused due to complexity
+- Approach: Start from scratch, potentially reuse scripts from 820a worktree
+- Goal: Create small, lightweight, easy-to-implement how-to document
+- Next: Planning phase for migration script design
+
+## Notes
+
+- **Related issue:** 820a-relay-ngit-dev-migration.md (paused, in paused/ directory)
+- **VPS:** Running NixOS
+- **Old worktree:** Can reference `/persistent/dcdev/clones/ngit-grasp/worktrees/820a-relay-ngit-dev-migration/` for existing scripts and learnings
+- **Target:** Simple, practical migration guide that works