feature: move docs

apps/server/internal/docs/service_test.go

@@ -182,6 +182,127 @@ func TestSaveSourcePageRejectsTraversalForNewDocument(t *testing.T) {
 	}
 }
 
+func TestMoveDocumentPreservesIdentityAndHistory(t *testing.T) {
+	service, sourceDir := setupDocsTestService(t)
+	ctx := context.Background()
+
+	page, err := service.LoadSourcePage(ctx, "hello")
+	if err != nil {
+		t.Fatalf("LoadSourcePage() error = %v", err)
+	}
+	before, err := service.repo.GetDocumentByPath(ctx, "hello.md")
+	if err != nil {
+		t.Fatalf("GetDocumentByPath() error = %v", err)
+	}
+	var versionsBefore int
+	if err := service.repo.db.QueryRowContext(ctx, `SELECT COUNT(*) FROM document_versions WHERE document_id = ?`, before.ID).Scan(&versionsBefore); err != nil {
+		t.Fatalf("count versions before move: %v", err)
+	}
+	if err := service.repo.SaveAttachment(ctx, AttachmentRecord{
+		Hash: "attachment-hash", OriginalName: "diagram.png", ContentType: "image/png",
+		SizeBytes: 10, CreatedAt: time.Now().UTC(), DocumentPath: before.Path,
+	}); err != nil {
+		t.Fatalf("save attachment: %v", err)
+	}
+	if _, err := service.repo.db.ExecContext(ctx, `
+		INSERT INTO users (id, email, display_name, created_at) VALUES ('user-move', 'move@example.com', 'Mover', ?)
+	`, time.Now().UTC().Format(time.RFC3339)); err != nil {
+		t.Fatalf("create permission user: %v", err)
+	}
+	if _, err := service.repo.db.ExecContext(ctx, `
+		INSERT INTO permissions (id, user_id, resource_type, resource_id, permission, created_at)
+		VALUES ('permission-move', 'user-move', 'document', ?, 'write', ?)
+	`, before.Path, time.Now().UTC().Format(time.RFC3339)); err != nil {
+		t.Fatalf("create document permission: %v", err)
+	}
+	var moveChange DocumentChange
+	service.OnChange(func(change DocumentChange) {
+		moveChange = change
+	})
+
+	moved, err := service.MoveDocument(ctx, "hello.md", "guides/welcome.md", page.Hash)
+	if err != nil {
+		t.Fatalf("MoveDocument() error = %v", err)
+	}
+	if moved.ID != before.ID {
+		t.Fatalf("moved ID = %q, want %q", moved.ID, before.ID)
+	}
+	if moved.Path != "guides/welcome.md" {
+		t.Fatalf("moved path = %q, want guides/welcome.md", moved.Path)
+	}
+	if moveChange.Type != "move" || moveChange.DocumentID != moved.ID || moveChange.OldPath != "hello.md" || moveChange.Path != moved.Path {
+		t.Fatalf("move change = %#v", moveChange)
+	}
+	if _, err := os.Stat(filepath.Join(sourceDir, "hello.md")); !errors.Is(err, os.ErrNotExist) {
+		t.Fatalf("old file still exists or stat failed: %v", err)
+	}
+	content, err := os.ReadFile(filepath.Join(sourceDir, "guides", "welcome.md"))
+	if err != nil {
+		t.Fatalf("read moved file: %v", err)
+	}
+	if string(content) != page.Content {
+		t.Fatalf("moved content = %q, want %q", content, page.Content)
+	}
+
+	alias, err := service.repo.GetDocumentByPathOrAlias(ctx, "hello.md")
+	if err != nil {
+		t.Fatalf("resolve old path alias: %v", err)
+	}
+	if alias.ID != before.ID || alias.Path != moved.Path {
+		t.Fatalf("alias resolved to %#v, want ID %q at %q", alias, before.ID, moved.Path)
+	}
+	var versionsAfter int
+	if err := service.repo.db.QueryRowContext(ctx, `SELECT COUNT(*) FROM document_versions WHERE document_id = ?`, before.ID).Scan(&versionsAfter); err != nil {
+		t.Fatalf("count versions after move: %v", err)
+	}
+	if versionsAfter != versionsBefore {
+		t.Fatalf("versions after move = %d, want %d", versionsAfter, versionsBefore)
+	}
+	attachment, err := service.repo.GetAttachment(ctx, "attachment-hash")
+	if err != nil {
+		t.Fatalf("get moved attachment metadata: %v", err)
+	}
+	if attachment.DocumentPath != moved.Path {
+		t.Fatalf("attachment document path = %q, want %q", attachment.DocumentPath, moved.Path)
+	}
+	var permissionPath string
+	if err := service.repo.db.QueryRowContext(ctx, `SELECT resource_id FROM permissions WHERE id = 'permission-move'`).Scan(&permissionPath); err != nil {
+		t.Fatalf("get moved permission: %v", err)
+	}
+	if permissionPath != moved.Path {
+		t.Fatalf("permission resource path = %q, want %q", permissionPath, moved.Path)
+	}
+}
+
+func TestMoveDocumentRejectsStaleHashAndOccupiedDestination(t *testing.T) {
+	service, sourceDir := setupDocsTestService(t)
+	ctx := context.Background()
+	if _, err := service.LoadSourcePage(ctx, "hello"); err != nil {
+		t.Fatalf("LoadSourcePage() error = %v", err)
+	}
+
+	_, err := service.MoveDocument(ctx, "hello.md", "moved.md", "stale")
+	var conflict *DocumentMoveConflictError
+	if !errors.As(err, &conflict) {
+		t.Fatalf("stale MoveDocument() error = %v, want DocumentMoveConflictError", err)
+	}
+	if _, err := os.Stat(filepath.Join(sourceDir, "hello.md")); err != nil {
+		t.Fatalf("source file changed after stale move: %v", err)
+	}
+
+	if err := os.WriteFile(filepath.Join(sourceDir, "occupied.md"), []byte("# Occupied\n"), 0o644); err != nil {
+		t.Fatalf("create occupied destination: %v", err)
+	}
+	page, err := service.LoadSourcePage(ctx, "hello")
+	if err != nil {
+		t.Fatalf("reload source page: %v", err)
+	}
+	_, err = service.MoveDocument(ctx, "hello.md", "occupied.md", page.Hash)
+	if !errors.As(err, &conflict) {
+		t.Fatalf("occupied MoveDocument() error = %v, want DocumentMoveConflictError", err)
+	}
+}
+
 func TestSyncSourceDirDoesNotRebroadcastArchivedDocuments(t *testing.T) {
 	service, _ := setupDocsTestService(t)
 	ctx := context.Background()