docs(dolt): add comprehensive DOLT.md guide (hq-c5d30a)

Add complete documentation for Dolt backend covering:
- Migration from SQLite to Dolt
- Contributor onboarding (bootstrap on clone)
- Troubleshooting common issues
- Recovery procedures
- Server mode setup and management
- Git hooks integration
- Configuration reference

Also improve server mode error handling to suggest gt dolt start
when connection is refused.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
beads/crew/emma
2026-01-24 20:42:07 -08:00
committed by Steve Yegge
parent f845bb1be3
commit 825e1952c0
2 changed files with 398 additions and 0 deletions

View File

@@ -316,6 +316,11 @@ func openServerConnection(ctx context.Context, cfg *Config) (*sql.DB, string, er
errLower := strings.ToLower(err.Error())
if !strings.Contains(errLower, "database exists") && !strings.Contains(errLower, "1007") {
_ = db.Close()
// Check for connection refused - server likely not running
if strings.Contains(errLower, "connection refused") || strings.Contains(errLower, "connect: connection refused") {
return nil, "", fmt.Errorf("failed to connect to Dolt server at %s:%d: %w\n\nThe Dolt server may not be running. Try:\n gt dolt start # If using Gas Town\n dolt sql-server # Manual start in database directory",
cfg.ServerHost, cfg.ServerPort, err)
}
return nil, "", fmt.Errorf("failed to create database: %w", err)
}
// Database already exists - that's fine, continue