memstack-skill-loader 4.2.0__tar.gz → 4.4.0__tar.gz

{memstack_skill_loader-4.2.0/src/memstack_skill_loader.egg-info → memstack_skill_loader-4.4.0}/PKG-INFO

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

{memstack_skill_loader-4.2.0 → memstack_skill_loader-4.4.0}/README.md

@@ -1,22 +1,26 @@
 # MemStack™ Skill Loader
 
-**127 skills for Claude Code** — 85 free + 42 Pro exclusive. Vector-indexed so CC loads only the skill it needs, saving your context window.
+**127 skills for Claude Code:** 84 free + 43 Pro exclusive. Vector-indexed so CC loads only the skill it needs, saving your context window.
 
 ## Quick Start (5 minutes)
 
-1. **Install from PyPI:**
+1. **Get the free skills (in Claude Code):** Installs the plugin that provides the 84 free skills.
+   ```
+   /plugin marketplace add cwinvestments/memstack
+   /plugin install memstack@cwinvestments-memstack
+   ```
+
+2. **Install the engine (in your terminal):** Vector-indexes the skills so Claude Code loads only what it needs.
    ```bash
    pip install memstack-skill-loader
    ```
 
-2. **Register with Claude Code:**
+3. **Register the engine with Claude Code (in your terminal):**
    ```bash
    claude mcp add --scope user memstack-skills -- python -m memstack_skill_loader
    ```
 
-3. **Restart Claude Code**, then type `list skills` to verify.
-
-4. **Activate Pro** (if purchased at [memstack.pro](https://memstack.pro)):
+4. **Restart Claude Code, then activate (in Claude Code):** Use `key="free"` for the free tier, or your Pro key from [memstack.pro](https://memstack.pro). Then type `list skills` to verify.
    ```
    activate_license(key="your-key-here", email="you@example.com")
    ```
@@ -27,11 +31,11 @@
 
 ## How It Works
 
-MCP server that vector-indexes all 127 MemStack™ skills so Claude Code can call `find_skill("deploy to Railway")` and load **only** the relevant skill on demand — instead of all skills consuming context window.
+MCP server that vector-indexes all 127 MemStack™ skills so Claude Code can call `find_skill("deploy to Railway")` and load **only** the relevant skill on demand, instead of all skills consuming context window.
 
-- **No API keys required** — everything runs locally
-- **Pro skills auto-detected** — set your license key and they appear automatically
-- **Auto-reindex on start** — skills stay current without manual rebuilds
+- **No API keys required:** everything runs locally
+- **Pro skills auto-detected:** set your license key and they appear automatically
+- **Auto-reindex on start:** skills stay current without manual rebuilds
 
 ### Environment Variable Override
 
@@ -99,7 +103,7 @@ The `config.json` file controls where skills are loaded from:
 }
 ```
 
-Pro skills are **auto-detected** when `MEMSTACK_PRO_LICENSE_KEY` is set — no need to add them to `config.json`.
+Pro skills are **auto-detected** when `MEMSTACK_PRO_LICENSE_KEY` is set, no need to add them to `config.json`.
 
 Add entries to `skill_sources` to index skills from multiple directories:
 
@@ -123,8 +127,8 @@ Add entries to `skill_sources` to index skills from multiple directories:
 ```
 
 The `pattern` field controls how skills are discovered:
-- `**/SKILL.md` — Subdirectory structure (e.g., `category/skill-name/SKILL.md`)
-- `*.md` — Flat directory (each `.md` file is a skill)
+- `**/SKILL.md`: Subdirectory structure (e.g., `category/skill-name/SKILL.md`)
+- `*.md`: Flat directory (each `.md` file is a skill)
 
 ## Release Notes
 
@@ -133,16 +137,16 @@ The `pattern` field controls how skills are discovered:
 - Dashboard: 6-page localhost dashboard (Overview, Skills Manager, Burn Report, Memory Browser, Agent Monitor, Settings)
 - Agent Runner: 3-agent orchestration (Manager/Builder/Reviewer) with per-agent model selection
 - 17 MCP tools
-- 127 skills (85 free + 42 Pro)
+- 127 skills (84 free + 43 Pro)
 - Real-time context window monitoring per agent
 - Session diary with AI-authored markdown narratives
 - Safe git staging (prevents accidental commits of secrets/runtime data)
 - Task completion notifications (browser, tab flash, audio)
 - Token usage tracking with estimated costs
-- Headroom proxy integration (~35-40% token savings)
+- TokenStack™ proxy integration (~35-40% token savings)
 
-**[v3.4.0](https://github.com/cwinvestments/memstack-skill-loader/releases/tag/v3.4.0)** — 100 Skills Milestone (18 new Pro skills, auto-detection, display name fixes)
+**[v3.4.0](https://github.com/cwinvestments/memstack-skill-loader/releases/tag/v3.4.0)**: 100 Skills Milestone (18 new Pro skills, auto-detection, display name fixes)
 
 ## License
 
-Proprietary — Part of MemStack™ Pro by CW Affiliate Investments LLC.
+Proprietary. Part of MemStack™ Pro by CW Affiliate Investments LLC.

{memstack_skill_loader-4.2.0 → memstack_skill_loader-4.4.0}/pyproject.toml

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

{memstack_skill_loader-4.2.0 → memstack_skill_loader-4.4.0}/src/memstack_skill_loader/__init__.py

@@ -1,3 +1,3 @@
 """MemStack Skill Loader — MCP server for semantic skill search."""
 
-__version__ = "4.2.0"
+__version__ = "4.4.0"

{memstack_skill_loader-4.2.0 → memstack_skill_loader-4.4.0}/src/memstack_skill_loader/__main__.py

@@ -1,8 +1,11 @@
 """Entry point for python -m memstack_skill_loader."""
 
 import asyncio
+import os
+import signal
 import sys
 import time
+from pathlib import Path
 
 from .server import run
 
@@ -71,10 +74,90 @@ def _run_agents(task: str) -> None:
         print("  All agents stopped.")
 
 
+def _stop() -> None:
+    """Stop the MemStack dashboard and any agent runner claude.exe processes."""
+    pid_file = Path.home() / ".memstack" / "dashboard.pid"
+    if not pid_file.exists():
+        print("No MemStack dashboard running.")
+        return
+
+    try:
+        pid = int(pid_file.read_text().strip())
+    except (ValueError, OSError):
+        print("No MemStack dashboard running (corrupt PID file).")
+        pid_file.unlink(missing_ok=True)
+        return
+
+    # Check if the process is alive
+    try:
+        os.kill(pid, 0)
+    except OSError:
+        print("No MemStack dashboard running (process not found).")
+        pid_file.unlink(missing_ok=True)
+        return
+
+    # Kill any claude.exe processes spawned by agent runner
+    killed_agents = 0
+    try:
+        import subprocess
+        if sys.platform == "win32":
+            result = subprocess.run(
+                ["wmic", "process", "where",
+                 f"ParentProcessId={pid} and Name='claude.exe'",
+                 "get", "ProcessId"],
+                capture_output=True, text=True, timeout=10,
+            )
+            for line in result.stdout.splitlines():
+                line = line.strip()
+                if line.isdigit():
+                    try:
+                        os.kill(int(line), signal.SIGTERM)
+                        killed_agents += 1
+                    except OSError:
+                        pass
+        else:
+            result = subprocess.run(
+                ["pgrep", "-P", str(pid), "-x", "claude"],
+                capture_output=True, text=True, timeout=10,
+            )
+            for line in result.stdout.splitlines():
+                line = line.strip()
+                if line.isdigit():
+                    try:
+                        os.kill(int(line), signal.SIGTERM)
+                        killed_agents += 1
+                    except OSError:
+                        pass
+    except Exception:
+        pass
+
+    # Kill the dashboard process
+    try:
+        if sys.platform == "win32":
+            os.kill(pid, signal.SIGTERM)
+        else:
+            os.kill(pid, signal.SIGTERM)
+        print(f"MemStack dashboard stopped (PID {pid}).")
+        if killed_agents:
+            print(f"Stopped {killed_agents} agent process(es).")
+    except OSError as exc:
+        print(f"Failed to stop dashboard (PID {pid}): {exc}")
+
+    pid_file.unlink(missing_ok=True)
+
+
 def main():
+    if len(sys.argv) > 1 and sys.argv[1] == "stop":
+        _stop()
+        return
     if len(sys.argv) > 1 and sys.argv[1] == "dashboard":
+        import argparse
+        parser = argparse.ArgumentParser(prog="memstack dashboard")
+        parser.add_argument("--with-proxy", action="store_true", help="Start TokenStack proxy on background thread")
+        parser.add_argument("--proxy-port", type=int, default=8787, help="Proxy port (default 8787)")
+        args = parser.parse_args(sys.argv[2:])
         from .dashboard import start_dashboard
-        start_dashboard()
+        start_dashboard(with_proxy=args.with_proxy, proxy_port=args.proxy_port)
     elif len(sys.argv) > 2 and sys.argv[1] == "run":
         task = " ".join(sys.argv[2:])
         _run_agents(task)
@@ -84,9 +167,10 @@ def main():
         parser.add_argument("--port", type=int, default=8787)
         parser.add_argument("--host", default="127.0.0.1")
         parser.add_argument("--verbose", action="store_true", help="Show parser diagnostics")
+        parser.add_argument("--pro", action="store_true", help="Force pro tier transforms (testing without license file)")
         args = parser.parse_args(sys.argv[2:])
         from .proxy.server import start_proxy
-        start_proxy(host=args.host, port=args.port, verbose=args.verbose)
+        start_proxy(host=args.host, port=args.port, verbose=args.verbose, force_pro=args.pro)
     elif len(sys.argv) > 1 and sys.argv[1] == "run":
         print("Usage: python -m memstack_skill_loader run \"Your task description\"",
               file=sys.stderr)