chore: Update SurrealDB default connection to ws://localhost:8000

Changed default connection from file-based to WebSocket on standard SurrealDB port (8000):
- Updated SurrealDbConfig defaults in core config and storage
- Updated example configuration files
- Updated documentation to reflect WebSocket as primary connection method
- Added note about requiring SurrealDB server for WebSocket connections
- Maintained file:// examples for embedded mode as alternative

Author: claude

config/default.toml

@@ -15,11 +15,12 @@ read_only = false
 
 [database.surrealdb]
 # Example SurrealDB configuration (uncomment to use)
-# connection = "file://data/surrealdb/graph.db"
+# connection = "ws://localhost:8000"  # Standard SurrealDB WebSocket connection
 # namespace = "codegraph"
 # database = "graph"
 # auto_migrate = true
 # strict_mode = false
+# Alternative: file://data/surrealdb/graph.db for embedded mode
 
 # Deprecated: Legacy rocksdb configuration (use database.rocksdb instead)
 # This is kept for backward compatibility

config/surrealdb_example.toml

@@ -12,12 +12,12 @@ read_only = false
 # SurrealDB configuration
 [database.surrealdb]
 # Connection string options:
-# - Local file: "file://data/graph.db"
+# - WebSocket (default): "ws://localhost:8000"
+# - Local file: "file://data/surrealdb/graph.db"
 # - Memory (testing): "mem://"
 # - Remote HTTP: "http://localhost:8000"
 # - Remote HTTPS: "https://example.com:8000"
-# - WebSocket: "ws://localhost:8000"
-connection = "file://data/surrealdb/graph.db"
+connection = "ws://localhost:8000"
 
 # Namespace for multi-tenancy (default: "codegraph")
 namespace = "codegraph"

crates/codegraph-core/src/config.rs

@@ -96,7 +96,7 @@ impl SurrealDbConfig {
 impl Default for SurrealDbConfig {
     fn default() -> Self {
         Self {
-            connection: "file://data/graph.db".into(),
+            connection: "ws://localhost:8000".into(),
             namespace: Self::default_namespace(),
             database: Self::default_database(),
             username: None,

crates/codegraph-graph/src/surrealdb_storage.rs

@@ -37,7 +37,7 @@ pub struct SurrealDbConfig {
 impl Default for SurrealDbConfig {
     fn default() -> Self {
         Self {
-            connection: "file://data/graph.db".to_string(),
+            connection: "ws://localhost:8000".to_string(),
             namespace: "codegraph".to_string(),
             database: "graph".to_string(),
             username: None,

docs/SURREALDB_GUIDE.md

@@ -47,14 +47,31 @@ cargo install surrealdb --locked
 
 ## Configuration
 
-### Basic Configuration (File-Based)
+### Basic Configuration (WebSocket - Default)
 
 Create a configuration file (e.g., `config/surrealdb.toml`):
 
 ```toml
 [database]
 backend = "surrealdb"
 
+[database.surrealdb]
+connection = "ws://localhost:8000"  # Standard SurrealDB connection
+namespace = "codegraph"
+database = "graph"
+auto_migrate = true
+```
+
+**Note:** This requires SurrealDB server running on port 8000 (see "Running SurrealDB Server" below).
+
+### File-Based Configuration (Embedded)
+
+For embedded/local-only usage without a server:
+
+```toml
+[database]
+backend = "surrealdb"
+
 [database.surrealdb]
 connection = "file://data/surrealdb/graph.db"
 namespace = "codegraph"
@@ -242,9 +259,13 @@ runner.migrate().await?;
 use codegraph_graph::surrealdb_storage::*;
 use codegraph_core::*;
 
-// Initialize storage
+// Initialize storage (default: ws://localhost:8000)
+let config = SurrealDbConfig::default();
+let mut storage = SurrealDbStorage::new(config).await?;
+
+// Or specify custom connection
 let config = SurrealDbConfig {
-    connection: "file://data/graph.db".to_string(),
+    connection: "ws://localhost:8000".to_string(),
     namespace: "codegraph".to_string(),
     database: "graph".to_string(),
     ..Default::default()