memstack-skill-loader 3.5.0__tar.gz → 3.5.2__tar.gz

{memstack_skill_loader-3.5.0/src/memstack_skill_loader.egg-info → memstack_skill_loader-3.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memstack-skill-loader
-Version: 3.5.0
+Version: 3.5.2
 Summary: MCP server that vector-indexes MemStack Pro skills for on-demand loading
 Requires-Python: >=3.12
 Requires-Dist: mcp>=1.0.0

{memstack_skill_loader-3.5.0 → memstack_skill_loader-3.5.2}/README.md

@@ -4,27 +4,24 @@
 
 ## Quick Start (5 minutes)
 
-1. **Clone both repos side-by-side:**
+1. **Install from PyPI:**
    ```bash
-   git clone https://github.com/cwinvestments/memstack.git
-   git clone https://github.com/cwinvestments/memstack-skill-loader.git
+   pip install memstack-skill-loader
    ```
 
-2. **Install the skill loader:**
-   ```bash
-   cd memstack-skill-loader
-   pip install -e . --break-system-packages
-   ```
-
-3. **Register with Claude Code:**
+2. **Register with Claude Code:**
    ```bash
    claude mcp add --scope user memstack-skills -- python -m memstack_skill_loader
    ```
 
-4. **Restart Claude Code**, then type `list skills` to verify.
+3. **Restart Claude Code**, then type `list skills` to verify.
+
+4. **Activate Pro** (if purchased at [memstack.pro](https://memstack.pro)):
+   ```
+   activate_license(key="your-key-here", email="you@example.com")
+   ```
 
-> The skill loader auto-detects the `memstack` repo if cloned as a sibling directory.
-> To use a different location, set `MEMSTACK_SKILLS_DIR=/path/to/memstack/skills`.
+> To override the skills path, set `MEMSTACK_SKILLS_DIR=/path/to/your/memstack/skills`.
 
 > See [QUICKSTART.md](QUICKSTART.md) for detailed setup, [QUICK-REFERENCE.md](QUICK-REFERENCE.md) for the full skill catalog, and [TROUBLESHOOTING.md](TROUBLESHOOTING.md) if you hit issues.
 

{memstack_skill_loader-3.5.0 → memstack_skill_loader-3.5.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "memstack-skill-loader"
-version = "3.5.0"
+version = "3.5.2"
 description = "MCP server that vector-indexes MemStack Pro skills for on-demand loading"
 requires-python = ">=3.12"
 dependencies = [

{memstack_skill_loader-3.5.0 → memstack_skill_loader-3.5.2}/src/memstack_skill_loader/config.py

@@ -60,14 +60,62 @@ class Config:
         )
 
 
+def _auto_discover_skills() -> SkillSource | None:
+    """Scan common locations for MemStack skills when no config.json exists (PyPI installs)."""
+    env_dir = os.environ.get("MEMSTACK_SKILLS_DIR")
+    if env_dir:
+        p = Path(env_dir).expanduser()
+        if p.exists():
+            skill_files = list(p.glob("**/SKILL.md"))
+            if skill_files:
+                print(f"Using MEMSTACK_SKILLS_DIR: {p} ({len(skill_files)} skills found)", file=sys.stderr)
+                return SkillSource(type="local", path=str(p), pattern="**/SKILL.md", label="MemStack")
+
+    home = Path.home()
+    candidates = [
+        home / ".claude" / "plugins" / "cache" / "cwinvestments-memstack" / "memstack",
+        home / ".claude" / "plugins" / "marketplaces" / "cwinvestments-memstack" / "skills",
+        home / "memstack" / "skills",
+        Path.cwd().parent / "memstack" / "skills",
+    ]
+
+    for candidate in candidates:
+        if candidate.name == "memstack":
+            version_dirs = sorted(candidate.glob("*/skills"), reverse=True)
+            for vdir in version_dirs:
+                skill_files = list(vdir.glob("**/SKILL.md"))
+                if skill_files:
+                    print(f"Auto-detected skills at: {vdir} ({len(skill_files)} skills found)", file=sys.stderr)
+                    return SkillSource(type="local", path=str(vdir), pattern="**/SKILL.md", label="MemStack")
+        else:
+            if candidate.exists():
+                skill_files = list(candidate.glob("**/SKILL.md"))
+                if skill_files:
+                    print(f"Auto-detected skills at: {candidate} ({len(skill_files)} skills found)", file=sys.stderr)
+                    return SkillSource(type="local", path=str(candidate), pattern="**/SKILL.md", label="MemStack")
+
+    print(
+        "No skills found. Install the MemStack plugin first: "
+        "/plugin marketplace add cwinvestments/memstack",
+        file=sys.stderr,
+    )
+    return None
+
+
 def load_config(config_path: Path | None = None) -> Config:
-    """Load config from JSON file. Falls back to defaults if not found."""
+    """Load config from JSON file. Falls back to auto-discovery if not found."""
     if config_path is None:
         config_path = Path(__file__).resolve().parent.parent.parent / "config.json"
 
     if not config_path.exists():
-        print(f"Config not found at {config_path}, using defaults", file=sys.stderr)
-        return Config()
+        source = _auto_discover_skills()
+        config = Config(
+            skill_sources=[source] if source else [],
+            auto_reindex_on_start=True,
+        )
+        if os.environ.get("MEMSTACK_PRO_LICENSE_KEY"):
+            config = config.with_pro_skills()
+        return config
 
     try:
         with open(config_path, encoding="utf-8") as f:

{memstack_skill_loader-3.5.0 → memstack_skill_loader-3.5.2}/src/memstack_skill_loader/server.py

@@ -874,6 +874,15 @@ async def run():
     from .stats import backfill_categories
     backfill_categories(_CATEGORY_MAP)
 
+    # Auto-build index on first run (PyPI installs have no pre-built index).
+    if config.auto_reindex_on_start:
+        from .tfidf_search import _get_index as _peek_index
+        if _peek_index(config) is None:
+            from .indexer import build_index
+            print("[memstack] Building skill index for first time...", file=sys.stderr)
+            count = build_index(config)
+            print(f"[memstack] Indexed {count} skills.", file=sys.stderr)
+
     # Pre-load TF-IDF index before stdio_server starts its stdin reader thread.
     # On Windows, a blocking readline() in the stdin thread causes GIL contention
     # that slows down CPU-intensive operations (like sklearn import) by ~20x.

{memstack_skill_loader-3.5.0 → memstack_skill_loader-3.5.2}/src/memstack_skill_loader/version_check.py

@@ -1,28 +1,22 @@
-"""Check for MemStack updates via GitHub releases API."""
+"""Check for MemStack updates via the PyPI JSON API."""
 
 import json
-import os
 import sys
 import time
 from pathlib import Path
 
-GITHUB_API_URL = "https://api.github.com/repos/cwinvestments/memstack/releases/latest"
+PYPI_URL = "https://pypi.org/pypi/memstack-skill-loader/json"
 CACHE_FILE = Path.home() / ".memstack" / "version-check.json"
-CACHE_TTL = 86400  # 24 hours in seconds
+CACHE_TTL = 86400  # 24 hours
 
 
-def _read_local_version() -> str | None:
-    """Read the VERSION file from the parent memstack repo directory."""
-    # The skill loader lives inside memstack, so walk up to find VERSION
-    loader_dir = Path(__file__).resolve().parent
-    for parent in [loader_dir] + list(loader_dir.parents):
-        version_file = parent / "VERSION"
-        if version_file.exists():
-            try:
-                return version_file.read_text(encoding="utf-8").strip()
-            except OSError:
-                return None
-    return None
+def _get_local_version() -> str | None:
+    """Get the installed package version via importlib.metadata."""
+    try:
+        from importlib.metadata import version
+        return version("memstack-skill-loader")
+    except Exception:
+        return None
 
 
 def _read_cache() -> dict | None:
@@ -51,32 +45,30 @@ def _write_cache(remote_version: str) -> None:
 
 
 def check_for_updates() -> None:
-    """Check GitHub for a newer MemStack version. Prints to stderr if update available."""
+    """Check PyPI for a newer MemStack version. Prints to stderr if update available."""
     try:
-        local_version = _read_local_version()
+        local_version = _get_local_version()
         if not local_version:
             return
 
-        # Check cache first
         cached = _read_cache()
         if cached:
             remote_version = cached.get("remote_version", "")
             if remote_version and remote_version != local_version:
                 print(
                     f"[memstack] Update available: {remote_version} (you have {local_version}). "
-                    f"Run 'git pull' in your MemStack\u2122 directory to update.",
+                    f"Run: pip install memstack-skill-loader --upgrade",
                     file=sys.stderr,
                 )
             return
 
-        # Fetch from GitHub API
         import httpx
-        response = httpx.get(GITHUB_API_URL, timeout=5.0, follow_redirects=True)
+        response = httpx.get(PYPI_URL, timeout=5.0, follow_redirects=True)
         if response.status_code != 200:
             return
 
         data = response.json()
-        remote_version = data.get("tag_name", "")
+        remote_version = data.get("info", {}).get("version", "")
         if not remote_version:
             return
 
@@ -85,9 +77,8 @@ def check_for_updates() -> None:
         if remote_version != local_version:
             print(
                 f"[memstack] Update available: {remote_version} (you have {local_version}). "
-                f"Run 'git pull' in your MemStack\u2122 directory to update.",
+                f"Run: pip install memstack-skill-loader --upgrade",
                 file=sys.stderr,
             )
     except Exception:
-        # Silently skip on any error — never block skill loading
         pass

{memstack_skill_loader-3.5.0 → memstack_skill_loader-3.5.2/src/memstack_skill_loader.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memstack-skill-loader
-Version: 3.5.0
+Version: 3.5.2
 Summary: MCP server that vector-indexes MemStack Pro skills for on-demand loading
 Requires-Python: >=3.12
 Requires-Dist: mcp>=1.0.0