hive-datascript.swarm.connection — io.github.hive-agi/hive-datascript 0.1.1

DataScript connection management for swarm state.

Provides:

• Global connection atom (thread-safe via DataScript internals)
• Connection lifecycle (create, get, reset)
• Shared helper functions (now, gen-id)

*test-conn* clj

Per-thread override for the global swarm connection. When non-nil, get-conn returns this instead of the global atom. Set through with-test-conn (the :swarm-ds isolation in hive-mcp.isolation-methods) so tests run against a fresh in-memory conn without polluting prod state. Honors axiom 20260122235103-7151cc29.

create-conn clj

(create-conn)

Create a new DataScript connection with swarm schema. Returns the connection (atom wrapper around db).

current-test-conn clj

(current-test-conn)

This thread's test connection override, or nil.

DSConn clj

DataScript connection: atom wrapping a DB, satisfies d/conn?.

ensure-conn clj

(ensure-conn)

Ensure connection exists, return it.

gen-id clj

(gen-id)

(gen-id prefix)

Generate a unique ID with optional prefix.

get-conn clj

(get-conn)

Get the global swarm connection, creating if needed. Returns test-conn when bound (test isolation override).

now clj

(now)

Current timestamp as java.util.Date.

reset-conn! clj

(reset-conn!)

Reset the global connection to empty state.

with-test-conn clj

(with-test-conn test-conn f)

Run (F) with TEST-CONN as this thread's swarm connection.