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

{memstack_skill_loader-4.3.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.3.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.3.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.3.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.3.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.3.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.3.0 → memstack_skill_loader-4.4.0}/src/memstack_skill_loader/agent_runner.py

@@ -25,6 +25,7 @@ MODEL_PRICING = {
     "claude-sonnet-4-6": {"input": 3.0, "output": 15.0},
     "claude-opus-4-6": {"input": 5.0, "output": 25.0},
     "claude-opus-4-7": {"input": 5.0, "output": 25.0},
+    "claude-opus-4-8": {"input": 5.0, "output": 25.0},
     "claude-haiku-4-5": {"input": 1.0, "output": 5.0},
 }
 # Cache read: 90% discount on input rate
@@ -61,12 +62,12 @@ STATE_FILE = STATE_DIR / "state.json"
 
 AGENT_TIMEOUT = 3600  # seconds per agent invocation (default 60 minutes)
 INACTIVITY_TIMEOUT = 900  # seconds without stdout before killing agent (15 minutes)
-MAX_ITERATIONS = 2
+MAX_ITERATIONS = 9999
 
 ANTHROPIC_BASE_URL = os.environ.get("ANTHROPIC_BASE_URL", "")
 API_KEY_FILE = Path.home() / ".memstack" / "api_key"
 OAUTH_TOKEN_FILE = Path.home() / ".memstack" / "oauth_token"
-API_DEFAULT_MODEL = "claude-sonnet-4-20250514"
+API_DEFAULT_MODEL = "claude-sonnet-4-6"
 API_MAX_TOKENS = 16000
 
 # API key loading moved to _load_api_key() — called on-demand per agent invocation.
@@ -430,6 +431,48 @@ def _summarize_subtask_titles(task_hint: str, _re) -> str:
         )
         titles = [m.group(1).strip() for m in numbered_pat.finditer(task_hint) if m.group(1).strip()]
 
+    # Fallback 3: grab any numbered list items (1. Do X, 2. Do Y)
+    if not titles:
+        list_pat = _re.compile(
+            r'^\s*\d+[.)]\s+(.{10,})',
+            _re.MULTILINE,
+        )
+        raw = [m.group(1).strip() for m in list_pat.finditer(task_hint)]
+        boilerplate = _re.compile(
+            r'^(?:Read\s|Run\s|Branch:|Working directory:|Do NOT\b|Do not\b|Report\s|---)',
+            _re.IGNORECASE,
+        )
+        titles = [t for t in raw if not boilerplate.match(t)][:5]
+
+    # Fallback 4: grab dash/bullet list items (- Do X, * Do Y)
+    if not titles:
+        bullet_pat = _re.compile(
+            r'^\s*[-*]\s+(.{10,})',
+            _re.MULTILINE,
+        )
+        raw = [m.group(1).strip() for m in bullet_pat.finditer(task_hint)]
+        boilerplate = _re.compile(
+            r'^(?:Read\s|Run\s|Branch:|Working directory:|Do NOT\b|Do not\b|Report\s|---|\s*src/|\s*\./)',
+            _re.IGNORECASE,
+        )
+        titles = [t for t in raw if not boilerplate.match(t)][:5]
+
+    # Fallback 5: if still nothing, take the first non-boilerplate line over 15 chars as a single title
+    if not titles:
+        boilerplate = _re.compile(
+            r'^(?:Read\s|Run\s|Branch:|Working directory:|Do NOT\b|Do not\b|Report\s|---|#{1,4}\s|'
+            r'STEP\s|Audit\s|src/|\./',
+            _re.IGNORECASE,
+        )
+        for _line in task_hint.splitlines():
+            _s = _line.strip()
+            if not _s or len(_s) < 15:
+                continue
+            if boilerplate.match(_s):
+                continue
+            titles = [_s]
+            break
+
     if not titles:
         return "multiple fixes"
 
@@ -470,6 +513,55 @@ def _summarize_subtask_titles(task_hint: str, _re) -> str:
     return combined
 
 
+def _describe_from_diff(changed_files: list, stat_output: str, working_dir: str, _re) -> str:
+    """Generate a short commit description by analyzing the actual git diff content."""
+    try:
+        git_kw = dict(capture_output=True, text=True, cwd=working_dir, timeout=30)
+        diff_r = subprocess.run(["git", "diff", "--cached", "-U0"], **git_kw)
+        diff_text = diff_r.stdout if diff_r.returncode == 0 else ""
+        if not diff_text:
+            diff_r = subprocess.run(["git", "diff", "-U0"], **git_kw)
+            diff_text = diff_r.stdout if diff_r.returncode == 0 else ""
+    except Exception:
+        diff_text = ""
+
+    added_funcs = []
+    removed_funcs = []
+    if diff_text:
+        for line in diff_text.splitlines():
+            m = _re.match(r'^\+(?!\+\+)\s*(?:def|async def|class)\s+(\w+)', line)
+            if m:
+                added_funcs.append(m.group(1))
+            m = _re.match(r'^-(?!--)\s*(?:def|async def|class)\s+(\w+)', line)
+            if m:
+                removed_funcs.append(m.group(1))
+
+    if len(changed_files) == 1:
+        fname = changed_files[0].replace("\\", "/").split("/")[-1]
+        if added_funcs and not removed_funcs:
+            names = ", ".join(added_funcs[:2])
+            desc = f"add {names} to {fname}"
+        elif removed_funcs and not added_funcs:
+            names = ", ".join(removed_funcs[:2])
+            desc = f"remove {names} from {fname}"
+        elif added_funcs or removed_funcs:
+            desc = f"update {fname} functions"
+        else:
+            desc = f"update {fname}"
+        return desc[:60]
+
+    if added_funcs and not removed_funcs:
+        names = ", ".join(added_funcs[:2])
+        desc = f"add {names}"
+        return desc[:60]
+    if removed_funcs and not added_funcs:
+        names = ", ".join(removed_funcs[:2])
+        desc = f"remove {names}"
+        return desc[:60]
+
+    return ""
+
+
 def _build_commit_message_from_diff(working_dir: str, task_hint: str = "") -> str:
     """Build a commit message from actual staged/unstaged git changes.
 
@@ -540,23 +632,8 @@ def _build_commit_message_from_diff(working_dir: str, task_hint: str = "") -> st
     task_desc = ""
     if has_subtasks:
         task_desc = _summarize_subtask_titles(task_hint, _re)
-    elif task_hint:
-        for _line in task_hint.splitlines():
-            _stripped = _line.strip()
-            if not _stripped:
-                continue
-            if _BOILERPLATE.match(_stripped):
-                continue
-            if _FILE_PATH_LINE.match(_stripped):
-                continue
-            if _SECTION_HEADER.match(_stripped):
-                continue
-            if _NUMBERED_FIX.match(_stripped):
-                continue
-            cleaned = _PREFIX_STRIP.sub('', _stripped).strip()
-            if len(cleaned) >= 10:
-                task_desc = cleaned.lower()[:60]
-                break
+    else:
+        task_desc = _describe_from_diff(changed_files, stat_output, working_dir, _re)
 
     def _short_name(fpath: str) -> str:
         parts = fpath.replace("\\", "/").split("/")
@@ -1589,7 +1666,8 @@ def _orchestrate(session: Session) -> None:
                     if "APPROVED" in reviewer_output.upper():
                         subtask_passed = True
                         subtasks_completed += 1
-                        subtask_results.append(f"Subtask {idx}: PASSED - {title}")
+                        builder_snippet = builder_output or ""
+                        subtask_results.append(f"Subtask {idx}: PASSED - {title}\n{builder_snippet}")
                         session.add_message("system", "all", f"Subtask {idx} of {len(subtasks)} approved: {title}")
                         break
 
@@ -1601,7 +1679,11 @@ def _orchestrate(session: Session) -> None:
                 else:
                     if not subtask_passed:
                         subtasks_failed += 1
-                        subtask_results.append(f"Subtask {idx}: FAILED (max iterations) - {title}")
+                        reviewer_snippet = (reviewer_output or "") if reviewer_output else ""
+                        fail_entry = f"Subtask {idx}: FAILED (max iterations) - {title}"
+                        if reviewer_snippet:
+                            fail_entry += f"\n{reviewer_snippet}"
+                        subtask_results.append(fail_entry)
                         session.add_message("system", "all", f"Subtask {idx} of {len(subtasks)} failed: {title} - max iterations reached")
 
             summary = f"Completed {subtasks_completed}/{len(subtasks)} subtasks"
@@ -1668,6 +1750,7 @@ def _orchestrate(session: Session) -> None:
 
             session.status = "completed"
             session.result = summary
+            session.add_message("system", "all", f"Task completed: {summary[:5000]}")
             session._save_state()
             return
 
@@ -1846,7 +1929,7 @@ def _orchestrate(session: Session) -> None:
             session.add_message("reviewer", "builder", reviewer_output)
 
             if "APPROVED" in reviewer_output.upper():
-                result_text = f"Approved after {iteration} iteration(s): {reviewer_output[:500]}"
+                result_text = f"Approved after {iteration} iteration(s).\n\nWhat was done:\n{builder_output or ''}"
                 if session.auto_commit:
                     try:
                         import re as _re
@@ -1908,6 +1991,7 @@ def _orchestrate(session: Session) -> None:
                         result_text += f"\n\n--- Auto-commit skipped: {exc} ---"
                 session.status = "completed"
                 session.result = result_text
+                session.add_message("system", "all", f"Task completed: {result_text[:5000]}")
                 session._save_state()
                 return
 
@@ -1918,9 +2002,8 @@ def _orchestrate(session: Session) -> None:
                 "Please address the reviewer's feedback."
             )
 
-        # Max iterations reached
         session.status = "completed"
-        session.result = f"Completed after {MAX_ITERATIONS} iterations (max reached)"
+        session.result = f"Completed after {session.iteration} iteration(s)"
         session._save_state()
 
     except subprocess.TimeoutExpired: