feat(clients): add nim-allographer client with BaraDB driver support

- Pure Nim wire protocol client (async + sync, no C FFI)
- Query Builder: fluent API, SQL generator, execution, transactions
- Schema Builder: create/alter/drop tables, column operations
- Connection pool with aging and timeout handling
- ORM integration via compile-time DB_BARADB switch
- Tests: test_open, test_query
- Documentation: README.md, PLAN_BARADB.md

clients/nim-allographer/tests/surrealdb/test_pool_wait.nim

@@ -0,0 +1,25 @@
+discard """
+  cmd: "nim c -d:reset $file"
+"""
+
+import std/[asyncdispatch, os, strutils, unittest]
+import ../../src/allographer/connection
+import ../../src/allographer/query_builder
+
+proc envIntDefault(key: string, defaultValue: int): int =
+  let value = getEnv(key)
+  if value.len == 0:
+    return defaultValue
+  return value.parseInt
+
+
+suite "SurrealDB pool waiter (notify)":
+  test "pool size 1: two concurrent raw gets both complete":
+    let timeout = envIntDefault("DB_TIMEOUT", 30)
+    let rdb = dbOpen(SurrealDB, "test", "test", "user", "pass", "http://surreal", 8000,
+      maxConnections = 1, timeout).waitFor()
+    proc sel(): Future[void] {.async.} =
+      discard await rdb.raw("RETURN 1;").get()
+    let a = sel()
+    let b = sel()
+    waitFor all(a, b)