Context
As a desktop user, I need Katra's local SurrealDB runtime to stay private to the app process when possible so the desktop experience does not depend on exposing a localhost database port on the host machine.
Acceptance Criteria
Notes
Current SurrealDB docs indicate this is possible in server-side JavaScript:
Important caveat from the current docs: embedded databases are intended for single-process access. Multi-process or distributed access should still use a remote SurrealDB server.
This issue is specifically about the desktop runtime path. It should not change the broader Katra direction where server deployments use external SurrealDB infrastructure.
Out of Scope
- Replacing the server deployment model with embedded storage.
- General SurrealDB schema design or application-level graph modeling work unrelated to the desktop runtime boundary.
Context
As a desktop user, I need Katra's local SurrealDB runtime to stay private to the app process when possible so the desktop experience does not depend on exposing a localhost database port on the host machine.
Acceptance Criteria
Notes
Current SurrealDB docs indicate this is possible in server-side JavaScript:
surrealkv://: https://surrealdb.com/docs/sdk/javascript/embeddingImportant caveat from the current docs: embedded databases are intended for single-process access. Multi-process or distributed access should still use a remote SurrealDB server.
This issue is specifically about the desktop runtime path. It should not change the broader Katra direction where server deployments use external SurrealDB infrastructure.
Out of Scope