hyperdb-mcp 1.0.0-rc.2 → 1.0.0-rc.4

package/README.md

@@ -1,6 +1,13 @@
 # hyperdb-mcp
 
-> **Note:** This crate is AI-assisted but human-directed — much of the code was written by AI coding assistants under close review, with the design and engineering trade-offs decided by an experienced developer. As of 1.0.0 the public API is stable and follows [semantic versioning](https://semver.org/), so breaking changes require a major release.
+> **Note:** This crate is AI-assisted but human-directed — much of the code was written by
+> AI coding assistants under close review, with the design and engineering trade-offs decided
+> by an experienced developer. As of 1.0.0 the **MCP tool surface** — tool names, their
+> parameters, and their behavior as reached over the MCP protocol — is stable and follows
+> [semantic versioning](https://semver.org/), so breaking changes to it require a major
+> release. The Rust library target is **not** a supported API surface: it exists only to
+> support the `hyperdb-mcp` binary, its tests, and its examples, its modules are
+> `#[doc(hidden)]`, and items within it may change in any release.
 
 An MCP (Model Context Protocol) server that turns the Hyper columnar database into an instant SQL analytics engine. Data flows in from other MCP plugins or files, lands in Hyper automatically, and becomes queryable with SQL — no setup, no schema files, no database management.
 
@@ -286,6 +293,15 @@ hyperdb-mcp daemon          # Run as a daemon explicitly (rarely needed)
 `status` and `stop` locate the running daemon automatically (reading `daemon.json`, then scanning the port range), so they work even if the daemon scanned onto a non-default port. Pass `--port <PORT>` to target a specific port explicitly.
 
 State files live at `~/.hyperdb/` by default (override with `HYPERDB_STATE_DIR`).
+They record the `hyperd` endpoint, so the daemon restricts them to your own
+account: `0700` on the directories and `0600` on `daemon.json` on Unix, and on
+Windows the ACL a `%USERPROFILE%` subdirectory inherits. If you override the
+location, keep it somewhere that can carry those permissions — under your user
+profile on Windows, and on a filesystem that supports Unix modes on Unix (a
+network share or a FAT/exFAT volume takes its modes from mount options
+instead). The daemon warns rather than refusing to start when it cannot tighten
+the directory, but it will not publish `daemon.json` into a file it cannot keep
+readable by you alone.
 
 For installation and configuration diagnostics that also work before MCP can start, use the native doctor command:
 
@@ -970,7 +986,9 @@ Environment:
   HYPERD_PATH                  Hyperd executable or containing directory; when absent or
                                non-UTF-8, walk upward for .hyperd/current/hyperd (no PATH lookup)
   HYPERDB_PERSISTENT_DB        Override the default persistent-db path
-  HYPERDB_STATE_DIR            Override daemon state directory (default ~/.hyperdb/)
+  HYPERDB_STATE_DIR            Override daemon state directory (default ~/.hyperdb/); keep it
+                               under your user profile on Windows and on a filesystem with Unix
+                               modes on Unix, or it cannot be restricted to your account
   HYPERDB_DAEMON_PORT          Pin auto-spawn discovery to one health/lock candidate;
                                foreground startup binds this configured/base port exactly
   HYPERDB_DAEMON_IDLE_TIMEOUT  Opt into idle shutdown (seconds); default: stay resident

package/package.json

@@ -29,10 +29,10 @@
   "engines": {
     "node": ">= 21"
   },
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.4",
   "optionalDependencies": {
-    "hyperdb-mcp-darwin-arm64": "1.0.0-rc.2",
-    "hyperdb-mcp-linux-x64-gnu": "1.0.0-rc.2",
-    "hyperdb-mcp-win32-x64-msvc": "1.0.0-rc.2"
+    "hyperdb-mcp-darwin-arm64": "1.0.0-rc.4",
+    "hyperdb-mcp-linux-x64-gnu": "1.0.0-rc.4",
+    "hyperdb-mcp-win32-x64-msvc": "1.0.0-rc.4"
   }
 }