Go runtime¶

Module github.com/writerslogic/holographic-memory/bindings/go, package hms (cgo, Go 1.24+). Links the static C ABI library, so binaries need no runtime library path.

store, _ := hms.Open("/data/store", 2048, hms.WithEncryptionKey(key))
defer store.Close()
store.Ingest(ctx, hms.Document{ID: "a", Text: "...", TitleWeight: 3})
k1, b := 1.2, 0.75
hits, _ := store.Search(ctx, "query", &hms.SearchOptions{K: 5, BM25K1: &k1, BM25B: &b})

Ingest, Search, Delete, Stats, SecurityStatus, Flush, Compact, Maintain, Snapshot, ChunkDocument; errors are *hms.Error (errors.Is(err, hms.ErrLocked) etc.). Store is goroutine safe; Close waits for calls in flight and is idempotent; unclosed stores are closed by a GC cleanup.

Context: checked before the call; with a cancellable context the call runs on its own goroutine and returns ctx.Err() at once. The native call cannot be interrupted, so it completes in the background (inputs stay pinned); after a cancelled mutation the outcome is unknown.

Getting the native library¶

From a clean clone of the repository (needs Rust 1.89+ and a C compiler):

bindings/go/scripts/build-native.sh     # installs bindings/go/lib/<GOOS>_<GOARCH>/
cd bindings/go && go test ./...

As a module dependency (no Rust needed), fetch the checksummed prebuilt static library from the release assets:

go run github.com/writerslogic/holographic-memory/bindings/go/cmd/hms-fetch@<version>
export CGO_LDFLAGS="-L<printed lib dir>"

Platforms: darwin arm64/amd64, linux arm64/amd64, windows amd64 (MinGW). Verified here: darwin/arm64 (build from source, hms-fetch via file://, go test -race). hms-fetch HTTP path and checksum rejection are unit tested; no release assets exist yet, so the default URL is unexercised.