tool-compass 2.5.1__tar.gz → 2.5.2__tar.gz

tool_compass-2.5.2/.gitattributes

@@ -0,0 +1,17 @@
+# Shell scripts and the Dockerfile MUST keep LF, on every platform.
+#
+# Earned on the sibling xrpl-camp repo the same day this landed: an entrypoint
+# script checked out with CRLF on Windows (core.autocrlf) makes the shebang
+# `#!/bin/sh\r`, and Linux then tries to exec an interpreter literally named
+# `/bin/sh\r`. It fails with "no such file or directory" naming the SCRIPT, so
+# it reads like a missing file rather than a line-ending problem.
+#
+# CI never catches it -- a Linux runner checks out LF and builds fine. Only a
+# contributor building the image on Windows hits it, which is the worst place
+# for a defect to live: invisible to the people who could fix it.
+*.sh text eol=lf
+Dockerfile text eol=lf
+docker-entrypoint.sh text eol=lf
+
+# Keep the rest normalised in the repo and native in the working tree.
+* text=auto

{tool_compass-2.5.1 → tool_compass-2.5.2}/CHANGELOG.md

@@ -7,6 +7,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.5.2] - 2026-09-09
+
+### Added
+
+- The container now warns when `/app/tool_compass/db` is not a mounted volume.
+  The semantic index lives there, and building it means embedding every tool in
+  every configured server — without a volume that work is discarded when the
+  container exits and paid again on the next start, which reads as "Tool
+  Compass is slow" rather than as a missing flag. `docker-compose.yml` already
+  mounts the `compass-data` named volume, so this only ever fires on the bare
+  `docker run ghcr.io/...` path, which is what someone trying the published
+  image reaches for first.
+
+  The warning goes to **stderr**, so it cannot corrupt anything piping the
+  container's output. `publish.yml`'s post-publish handshake uses
+  `--entrypoint tool-compass`, which overrides the entrypoint entirely and is
+  unaffected; verified against both stage CMDs.
+
+- README documents running the published image directly with a volume, not
+  only the clone-and-compose path.
+
+### Fixed
+
+- `.gitattributes` pins LF on `*.sh`, the `Dockerfile` and the entrypoint. A
+  shell script checked out with CRLF on Windows makes the shebang
+  `#!/bin/sh
+  the script rather than the line endings — invisible to CI, which checks out
+  LF on Linux, and visible only to a contributor building the image on Windows.
+  Caught on the sibling xrpl-camp repo the same day.
+
 ## [2.5.1] - 2026-09-09
 
 Dogfood swarm `swarm-1788918264-9859` — health Stages A–D, a 23-item

{tool_compass-2.5.1 → tool_compass-2.5.2}/Dockerfile

@@ -84,6 +84,16 @@ ENV PYTHONUNBUFFERED=1 \
 # Expose Gradio UI port
 EXPOSE 7860
 
+# Warn when the index directory is not a volume. The compose file mounts
+# `compass-data` so compose users never see it; this is for the bare
+# `docker run ghcr.io/...` path, which has no volume and silently rebuilds the
+# index on every start. `exec "$@"` so BOTH stage CMDs (ui.py here, gateway.py
+# in mcp-gateway below) pass through unchanged, and so
+# `--entrypoint tool-compass` in publish.yml's post-publish handshake still
+# overrides it cleanly.
+COPY --chmod=0755 docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh
+ENTRYPOINT ["docker-entrypoint.sh"]
+
 # Switch to non-root user
 USER compass
 

{tool_compass-2.5.1 → tool_compass-2.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tool-compass
-Version: 2.5.1
+Version: 2.5.2
 Summary: Semantic MCP tool discovery gateway - find tools by intent, not memory
 Project-URL: Homepage, https://github.com/mcp-tool-shop-org/tool-compass
 Project-URL: Documentation, https://github.com/mcp-tool-shop-org/tool-compass#readme
@@ -152,6 +152,19 @@ docker-compose --profile with-ollama up
 # Access the UI at http://localhost:7860
 ```
 
+Or run the published image directly, without cloning:
+
+```bash
+docker run --rm -p 7860:7860   -v tool-compass-data:/app/tool_compass/db   ghcr.io/mcp-tool-shop-org/tool-compass:latest
+```
+
+> **Mount the volume.** The semantic index lives in `/app/tool_compass/db`, and
+> building it means embedding every tool in every configured server. Without a
+> volume that work is thrown away when the container exits and paid again on the
+> next start — which reads as "Tool Compass is slow" rather than as a missing
+> flag. The image warns you if you forget. `docker compose up` already mounts a
+> named volume, so this only applies to bare `docker run`.
+
 > The GHCR image (`ghcr.io/mcp-tool-shop-org/tool-compass`) supports
 > `linux/amd64` and `linux/arm64`, so the same tag runs on x86_64 servers
 > and Apple Silicon / ARM workstations.

{tool_compass-2.5.1 → tool_compass-2.5.2}/README.md

@@ -107,6 +107,19 @@ docker-compose --profile with-ollama up
 # Access the UI at http://localhost:7860
 ```
 
+Or run the published image directly, without cloning:
+
+```bash
+docker run --rm -p 7860:7860   -v tool-compass-data:/app/tool_compass/db   ghcr.io/mcp-tool-shop-org/tool-compass:latest
+```
+
+> **Mount the volume.** The semantic index lives in `/app/tool_compass/db`, and
+> building it means embedding every tool in every configured server. Without a
+> volume that work is thrown away when the container exits and paid again on the
+> next start — which reads as "Tool Compass is slow" rather than as a missing
+> flag. The image warns you if you forget. `docker compose up` already mounts a
+> named volume, so this only applies to bare `docker run`.
+
 > The GHCR image (`ghcr.io/mcp-tool-shop-org/tool-compass`) supports
 > `linux/amd64` and `linux/arm64`, so the same tag runs on x86_64 servers
 > and Apple Silicon / ARM workstations.

tool_compass-2.5.2/docker-entrypoint.sh

@@ -0,0 +1,59 @@
+#!/bin/sh
+# Say out loud whether the semantic index will survive this container.
+#
+# Tool Compass's value is the index: embedding every tool in every configured
+# MCP server takes real time and real compute, and the result lives in
+# /app/tool_compass/db. Without a volume that directory is ordinary container
+# filesystem, so the index is discarded when the container exits and rebuilt
+# from scratch on the next start -- which looks like "Tool Compass is slow",
+# not like "you forgot a -v".
+#
+# docker-compose.yml already mounts the `compass-data` named volume, so compose
+# users are fine. This exists for the bare `docker run ghcr.io/...` path, which
+# is what someone trying the published image reaches for first and which has no
+# volume at all.
+#
+# A warning rather than a refusal: `--version`, `--help` and a one-off query
+# are all legitimate without persistence, and a container that refuses to start
+# is a worse first experience than one that tells you what it is about to do.
+#
+# stderr, deliberately. This is a warning about the environment, not output of
+# the command being run -- on stdout it corrupts anything piping the container,
+# which is how the sibling xrpl-camp image broke its own release check.
+
+set -eu
+
+DATA_DIR="${TOOL_COMPASS_DB_DIR:-/app/tool_compass/db}"
+
+is_mounted() {
+    # A bind mount or named volume puts DATA_DIR on a different device from /.
+    # Compare the two rather than reading a mount table, which is not reliably
+    # readable inside the container.
+    root_dev=$(stat -c %d / 2>/dev/null || echo 0)
+    data_dev=$(stat -c %d "$DATA_DIR" 2>/dev/null || echo 0)
+    [ "$root_dev" != "$data_dev" ]
+}
+
+if [ -d "$DATA_DIR" ] && ! is_mounted; then
+    printf '\033[33m' >&2
+    cat >&2 <<WARNING
+  ${DATA_DIR} is not mounted.
+
+  Tool Compass keeps its semantic index there. Without a volume the index is
+  discarded when this container exits, and every start pays the full embedding
+  cost again -- which reads as "it is slow" rather than as a missing flag.
+
+  Keep it between runs:
+
+      docker run --rm -p 7860:7860 -v tool-compass-data:${DATA_DIR} \\
+        ghcr.io/mcp-tool-shop-org/tool-compass:latest
+
+  Or use the compose file, which already mounts a named volume:
+
+      docker compose up
+
+WARNING
+    printf '\033[0m' >&2
+fi
+
+exec "$@"

{tool_compass-2.5.1 → tool_compass-2.5.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tool-compass"
-version = "2.5.1"
+version = "2.5.2"
 description = "Semantic MCP tool discovery gateway - find tools by intent, not memory"
 readme = "README.md"
 license = "MIT"