tool-compass 2.0.2__tar.gz → 2.0.4__tar.gz

tool_compass-2.0.4/.github/workflows/docker.yml

@@ -0,0 +1,46 @@
+name: Publish to GHCR
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=sha
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

{tool_compass-2.0.2 → tool_compass-2.0.4}/.github/workflows/test.yml

@@ -1,15 +1,46 @@
 # Tool Compass CI Pipeline
-# Runs tests on every push and PR
+# Runs tests on pushes and PRs that touch code or config
 
 name: Tests
 
 on:
   push:
     branches: [main, develop]
+    paths:
+      - '*.py'
+      - 'tests/**'
+      - 'scripts/**'
+      - 'requirements*.txt'
+      - 'pyproject.toml'
+      - 'Dockerfile'
+      - '.github/workflows/**'
   pull_request:
     branches: [main]
+    paths:
+      - '*.py'
+      - 'tests/**'
+      - 'scripts/**'
+      - 'requirements*.txt'
+      - 'pyproject.toml'
+      - 'Dockerfile'
+      - '.github/workflows/**'
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
 
 jobs:
+  lint:
+    name: Org URL sanity check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Check for stale org/user URLs
+        run: bash scripts/check-org-urls.sh
+
   test:
     name: Python ${{ matrix.python-version }} on ${{ matrix.os }}
     runs-on: ${{ matrix.os }}
@@ -18,7 +49,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: ['3.10', '3.11', '3.12']
+        python-version: ['3.10', '3.11', '3.12', '3.13']
 
     steps:
       - name: Checkout repository
@@ -53,6 +84,12 @@ jobs:
           file: coverage.xml
           fail_ci_if_error: false
 
+      - name: Audit dependencies for vulnerabilities
+        if: matrix.python-version == '3.11' && matrix.os == 'ubuntu-latest'
+        run: |
+          pip-audit -r requirements.txt
+        continue-on-error: true  # Warn-only until clean baseline established
+
   # Integration tests (requires Ollama)
   integration:
     name: Integration Tests

{tool_compass-2.0.2 → tool_compass-2.0.4}/CHANGELOG.md

@@ -7,6 +7,47 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.0.3] - 2026-02-14
+
+### Fixed
+- `categorize_tool()` now falls back to description matching when name has no category keywords
+- `analytics.last_success_at` stores real timestamps instead of the literal string "CURRENT_TIMESTAMP"
+- `SyncEmbedder` no longer crashes when called from inside a running event loop (Gradio, FastMCP)
+- UI `run_async` helper replaced with deterministic loop detection (no more `RuntimeError` roulette)
+- Removed discarded `sequence_hash` read in chain detection
+
+### Changed
+- Private `_backends` dict access replaced with public `is_backend_connected()` API
+- `backend_client.py` renamed to `backend_client_mcp.py` (experimental; not used at runtime)
+- Version reporting unified via `_version.py` module (reads from `importlib.metadata` or `pyproject.toml`)
+- UI singletons protected with `threading.Lock` (Gradio is multi-threaded)
+- Runtime assumptions documented in `gateway.py`
+
+### Infrastructure
+- Python 3.13 added to CI test matrix (3.10–3.13, 12 matrix jobs)
+- `actions/checkout` normalized to v6 across all workflows
+- `pip-audit` dependency vulnerability scan added (warn-only)
+- `scripts/**` added to CI path triggers
+
+### Tests
+- 23 new tests: `backend_client_simple.py` API, `run_async` loop safety, `SyncEmbedder` loop safety, `_version.py` (387 → 410 tests)
+
+## [2.0.2] - 2026-02-14
+
+### Fixed
+- Windows subprocess stability with `SimpleBackendManager` (#11)
+- Auto-fix lint issues with ruff (#13)
+
+### Changed
+- Migrated all repository URLs to `mcp-tool-shop-org` GitHub organization
+- Updated CI actions to latest major versions (checkout v6, setup-python v6, codecov v5)
+
+### Infrastructure
+- Added GHCR Docker publish workflow
+- Added `llms.txt` for LLM discoverability
+- Added social preview assets
+- Updated dependency version ranges (black, pytest, pytest-cov, isort, gradio)
+
 ## [2.0.1] - 2026-01-18
 
 ### Added
@@ -115,12 +156,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 | Version | Date | Highlights |
 |---------|------|------------|
+| 2.0.3 | 2026-02-14 | Bug fixes, async safety, CI hygiene, 410 tests |
+| 2.0.2 | 2026-02-14 | Org migration, CI updates, Windows fix |
 | 2.0.0 | 2026-01-17 | Gradio UI, error handling, polish |
 | 1.1.0 | 2026-01-16 | Workflows, analytics, sync |
 | 1.0.0 | 2026-01-15 | Initial release |
 
-[Unreleased]: https://github.com/mcp-tool-shop/tool-compass/compare/v2.0.1...HEAD
-[2.0.1]: https://github.com/mcp-tool-shop/tool-compass/compare/v2.0.0...v2.0.1
-[2.0.0]: https://github.com/mcp-tool-shop/tool-compass/compare/v1.1.0...v2.0.0
-[1.1.0]: https://github.com/mcp-tool-shop/tool-compass/compare/v1.0.0...v1.1.0
-[1.0.0]: https://github.com/mcp-tool-shop/tool-compass/releases/tag/v1.0.0
+[Unreleased]: https://github.com/mcp-tool-shop-org/tool-compass/compare/v2.0.3...HEAD
+[2.0.3]: https://github.com/mcp-tool-shop-org/tool-compass/compare/v2.0.2...v2.0.3
+[2.0.2]: https://github.com/mcp-tool-shop-org/tool-compass/compare/v2.0.1...v2.0.2
+[2.0.1]: https://github.com/mcp-tool-shop-org/tool-compass/compare/v2.0.0...v2.0.1
+[2.0.0]: https://github.com/mcp-tool-shop-org/tool-compass/compare/v1.1.0...v2.0.0
+[1.1.0]: https://github.com/mcp-tool-shop-org/tool-compass/compare/v1.0.0...v1.1.0
+[1.0.0]: https://github.com/mcp-tool-shop-org/tool-compass/releases/tag/v1.0.0

{tool_compass-2.0.2 → tool_compass-2.0.4}/CONTRIBUTING.md

@@ -29,7 +29,7 @@ This project follows the [Contributor Covenant](https://www.contributor-covenant
 
 ```bash
 # Clone the repository
-git clone https://github.com/mikeyfrilot/tool-compass.git
+git clone https://github.com/mcp-tool-shop-org/tool-compass.git
 cd tool-compass/tool_compass
 
 # Create virtual environment
@@ -302,9 +302,9 @@ async def get_instance() -> MyClass:
 
 ## Need Help?
 
-- **Questions**: Open a [Discussion](https://github.com/mikeyfrilot/tool-compass/discussions)
-- **Bugs**: Open an [Issue](https://github.com/mikeyfrilot/tool-compass/issues)
-- **Security**: Use [GitHub Security Advisories](https://github.com/mikeyfrilot/tool-compass/security/advisories/new) (do not open public issues)
+- **Questions**: Open a [Discussion](https://github.com/mcp-tool-shop-org/tool-compass/discussions)
+- **Bugs**: Open an [Issue](https://github.com/mcp-tool-shop-org/tool-compass/issues)
+- **Security**: Use [GitHub Security Advisories](https://github.com/mcp-tool-shop-org/tool-compass/security/advisories/new) (do not open public issues)
 
 ---
 

{tool_compass-2.0.2 → tool_compass-2.0.4}/Dockerfile

@@ -27,9 +27,10 @@ RUN pip install --no-cache-dir --upgrade pip && \
 # =============================================================================
 FROM python:3.11-slim as production
 
-LABEL maintainer="Tool Compass <github.com/your-org/tool-compass>"
+LABEL maintainer="Tool Compass <github.com/mcp-tool-shop-org/tool-compass>"
 LABEL description="Semantic search gateway for MCP tools"
-LABEL version="2.0"
+# Keep in sync with pyproject.toml [project] version
+LABEL version="2.0.3"
 
 # Security: Run as non-root user
 RUN groupadd -r compass && useradd -r -g compass compass

{tool_compass-2.0.2 → tool_compass-2.0.4}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: tool-compass
-Version: 2.0.2
+Version: 2.0.4
 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
 Project-URL: Repository, https://github.com/mcp-tool-shop-org/tool-compass.git
 Project-URL: Issues, https://github.com/mcp-tool-shop-org/tool-compass/issues
 Project-URL: Changelog, https://github.com/mcp-tool-shop-org/tool-compass/blob/main/CHANGELOG.md
-Author: Mikey Frilot
+Author-email: mcp-tool-shop <64996768+mcp-tool-shop@users.noreply.github.com>
 License-Expression: MIT
 License-File: LICENSE
 Keywords: ai,anthropic,claude,hnsw,llm,mcp,model-context-protocol,semantic-search,tool-discovery,vector-search
@@ -44,16 +44,17 @@ Description-Content-Type: text/markdown
 
 <div align="center">
 
+<img src="logo.png" alt="Tool Compass Logo" width="200">
+
 # Tool Compass
 
 **Semantic navigator for MCP tools - Find the right tool by intent, not memory**
 
-[![Tests](https://github.com/mcp-tool-shop-org/tool-compass/actions/workflows/test.yml/badge.svg)](https://github.com/mcp-tool-shop-org/tool-compass/actions/workflows/test.yml)
-[![codecov](https://codecov.io/gh/mcp-tool-shop-org/tool-compass/graph/badge.svg)](https://codecov.io/gh/mcp-tool-shop-org/tool-compass)
-[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg?logo=python&logoColor=white)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Docker](https://img.shields.io/badge/docker-ready-blue.svg?logo=docker&logoColor=white)](https://www.docker.com/)
-[![GitHub stars](https://img.shields.io/github/stars/mcp-tool-shop-org/tool-compass?style=social)](https://github.com/mcp-tool-shop-org/tool-compass)
+<a href="https://github.com/mcp-tool-shop-org/tool-compass/actions/workflows/test.yml"><img src="https://img.shields.io/github/actions/workflow/status/mcp-tool-shop-org/tool-compass/test.yml?branch=main&style=flat-square&label=CI" alt="CI"></a>
+<a href="https://codecov.io/gh/mcp-tool-shop-org/tool-compass"><img src="https://img.shields.io/codecov/c/github/mcp-tool-shop-org/tool-compass?style=flat-square" alt="Codecov"></a>
+<img src="https://img.shields.io/badge/python-3.10%2B-blue?style=flat-square&logo=python&logoColor=white" alt="Python 3.10+">
+<a href="LICENSE"><img src="https://img.shields.io/github/license/mcp-tool-shop-org/tool-compass?style=flat-square" alt="License"></a>
+<img src="https://img.shields.io/badge/docker-ready-blue?style=flat-square&logo=docker&logoColor=white" alt="Docker">
 
 *95% fewer tokens. Find tools by describing what you want to do.*
 
@@ -95,7 +96,7 @@ Tool Compass uses **semantic search** to find relevant tools from a natural lang
 ollama pull nomic-embed-text
 
 # Clone and setup
-git clone https://github.com/mikeyfrilot/tool-compass.git
+git clone https://github.com/mcp-tool-shop-org/tool-compass.git
 cd tool-compass/tool_compass
 
 # Create virtual environment
@@ -119,7 +120,7 @@ python ui.py
 
 ```bash
 # Clone the repo
-git clone https://github.com/mikeyfrilot/tool-compass.git
+git clone https://github.com/mcp-tool-shop-org/tool-compass.git
 cd tool-compass/tool_compass
 
 # Start with Docker Compose (requires Ollama running locally)
@@ -277,10 +278,10 @@ python gateway.py --sync
 
 Part of the **Compass Suite** for AI-powered development:
 
-- [File Compass](https://github.com/mikeyfrilot/file-compass) - Semantic file search
-- [Integradio](https://github.com/mikeyfrilot/integradio) - Vector-embedded Gradio components
-- [Backpropagate](https://github.com/mikeyfrilot/backpropagate) - Headless LLM fine-tuning
-- [Comfy Headless](https://github.com/mikeyfrilot/comfy-headless) - ComfyUI without the complexity
+- [File Compass](https://github.com/mcp-tool-shop-org/file-compass) - Semantic file search
+- [Integradio](https://github.com/mcp-tool-shop-org/integradio) - Vector-embedded Gradio components
+- [Backpropagate](https://github.com/mcp-tool-shop-org/backpropagate) - Headless LLM fine-tuning
+- [Comfy Headless](https://github.com/mcp-tool-shop-org/comfy-headless) - ComfyUI without the complexity
 
 ## Contributing
 
@@ -290,6 +291,12 @@ We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 For security vulnerabilities, please see [SECURITY.md](SECURITY.md). **Do not open public issues for security bugs.**
 
+## Support
+
+- **Questions / help:** [Discussions](https://github.com/mcp-tool-shop-org/tool-compass/discussions)
+- **Bug reports:** [Issues](https://github.com/mcp-tool-shop-org/tool-compass/issues)
+- **Security:** [SECURITY.md](SECURITY.md)
+
 ## License
 
 [MIT](LICENSE) - see LICENSE file for details.
@@ -309,6 +316,6 @@ For security vulnerabilities, please see [SECURITY.md](SECURITY.md). **Do not op
 
 Tool Compass reduces entropy in the MCP ecosystem by organizing tools by semantic meaning.
 
-**[Documentation](https://github.com/mikeyfrilot/tool-compass#readme)** • **[Issues](https://github.com/mikeyfrilot/tool-compass/issues)** • **[Discussions](https://github.com/mikeyfrilot/tool-compass/discussions)**
+**[Documentation](https://github.com/mcp-tool-shop-org/tool-compass#readme)** • **[Issues](https://github.com/mcp-tool-shop-org/tool-compass/issues)** • **[Discussions](https://github.com/mcp-tool-shop-org/tool-compass/discussions)**
 
 </div>