memstack-skill-loader 4.4.0rc1__tar.gz → 4.5.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memstack-skill-loader
-Version: 4.4.0rc1
+Version: 4.5.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.4.0rc1 → memstack_skill_loader-4.5.0}/README.md

@@ -1,22 +1,26 @@
 # MemStack™ Skill Loader
 
-**127 skills for Claude Code** — 84 free + 43 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
 
@@ -141,8 +145,8 @@ The `pattern` field controls how skills are discovered:
 - Token usage tracking with estimated costs
 - 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.4.0rc1 → memstack_skill_loader-4.5.0}/pyproject.toml

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

{memstack_skill_loader-4.4.0rc1 → memstack_skill_loader-4.5.0}/src/memstack_skill_loader/__init__.py

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

{memstack_skill_loader-4.4.0rc1 → memstack_skill_loader-4.5.0}/src/memstack_skill_loader/agent_runner.py

@@ -67,7 +67,7 @@ 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.

{memstack_skill_loader-4.4.0rc1 → memstack_skill_loader-4.5.0}/src/memstack_skill_loader/dashboard.html

@@ -546,6 +546,39 @@
   .diary-pagination .diary-pg-btn { font-size: 0.78rem; color: #58a6ff; cursor: pointer; background: none; border: 1px solid #30363d; border-radius: 4px; padding: 0.25rem 0.7rem; }
   .diary-pagination .diary-pg-btn:hover { border-color: #58a6ff; }
 
+  /* ── Memory Browser ── */
+  .mb-controls { display: flex; gap: 0.6rem; align-items: center; margin-bottom: 0.9rem; flex-wrap: wrap; }
+  .mb-select, .mb-search {
+    background: #0d1117; border: 1px solid #30363d; color: #c9d1d9;
+    padding: 0.4rem 0.6rem; border-radius: 6px; font-size: 0.82rem;
+  }
+  .mb-search { flex: 1; min-width: 200px; }
+  .mb-search:focus, .mb-select:focus { outline: none; border-color: #58a6ff; }
+  .mb-count { font-size: 0.75rem; color: #484f58; white-space: nowrap; }
+  .mb-entry { cursor: pointer; transition: border-color 0.15s; }
+  .mb-entry:hover { border-color: #58a6ff; }
+  .mb-badges { display: flex; gap: 0.4rem; align-items: center; flex-wrap: wrap; }
+  .mb-badge {
+    font-size: 0.66rem; padding: 0.1rem 0.45rem; border-radius: 10px;
+    border: 1px solid #30363d; color: #8b949e; white-space: nowrap;
+  }
+  .mb-badge.project { color: #58a6ff; border-color: #1f4068; }
+  .mb-badge.agent { color: #d29922; border-color: #5a4413; }
+  .mb-badge.direct { color: #3fb950; border-color: #1b4721; }
+  .mb-detail-head { display: flex; justify-content: space-between; align-items: center; gap: 0.6rem; margin-bottom: 0.5rem; flex-wrap: wrap; }
+  .mb-back {
+    background: #21262d; border: 1px solid #30363d; color: #c9d1d9;
+    padding: 0.3rem 0.7rem; border-radius: 6px; cursor: pointer; font-size: 0.78rem;
+  }
+  .mb-back:hover { border-color: #58a6ff; }
+  .mb-detail-actions { display: flex; gap: 0.5rem; align-items: center; }
+  .mb-detail-title { color: #e6edf3; font-size: 1rem; margin-bottom: 0.6rem; }
+  .mb-detail-content {
+    background: #0d1117; border: 1px solid #21262d; border-radius: 6px;
+    padding: 1rem; font-size: 0.8rem; color: #c9d1d9; line-height: 1.5;
+    white-space: pre-wrap; word-break: break-word; max-height: 65vh; overflow-y: auto;
+  }
+
   /* ── Projects ── */
   .projects-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 1rem; }
   .project-card {
@@ -1310,6 +1343,7 @@
       <span id="proxy-indicator" class="health-indicator" title="TokenStack Proxy">
         <span class="health-dot" id="proxy-dot"></span>
         <span class="health-text" id="proxy-text">Proxy: Checking...</span>
+        <span id="proxy-tier-badge" style="display:none;font-size:0.62rem;padding:1px 7px;border-radius:8px;margin-left:0.4rem;vertical-align:middle;font-weight:600;letter-spacing:0.03em;"></span>
       </span>
     </h2>
     <p class="meta">Auto-refreshes every 30s &middot; <a href="#" id="refresh-btn">Refresh Now</a></p>
@@ -1655,13 +1689,18 @@
 
 <!-- ═══════ Memory Browser ═══════ -->
 <div id="page-memory-browser" class="page">
-  <div class="placeholder-page">
-    <div class="placeholder-card">
-      <div class="icon">&#128218;</div>
-      <h3>Memory Browser</h3>
-      <div class="version-badge">Coming in v4.1</div>
-      <p>Search across sessions, lessons, and facts from your development history. Memory capture pipelines are being refined for the next release.</p>
+  <div class="page-header">
+    <h2>Memory Browser</h2>
+    <p class="meta">Search session diaries across all projects (agent runs and direct sessions).</p>
+  </div>
+  <div class="panel">
+    <div class="mb-controls">
+      <select id="mb-project" class="mb-select" aria-label="Project filter"></select>
+      <input id="mb-search" class="mb-search" type="text" placeholder="Search title and content..." autocomplete="off">
+      <span id="mb-count" class="mb-count"></span>
     </div>
+    <div id="mb-list" class="diary-list"></div>
+    <div id="mb-detail" class="mb-detail" style="display:none;"></div>
   </div>
 </div>
 
@@ -1917,8 +1956,8 @@
       <div class="settings-model-col">
         <label class="settings-model-label">Manager Model</label>
         <select id="settings-model-manager" class="settings-model-select" onchange="saveModelPrefs()">
-          <option value="claude-opus-4-8">claude-opus-4-8</option>
-          <option value="claude-opus-4-6" selected>claude-opus-4-6</option>
+          <option value="claude-opus-4-8" selected>claude-opus-4-8</option>
+          <option value="claude-opus-4-6">claude-opus-4-6</option>
           <option value="claude-sonnet-4-6">claude-sonnet-4-6</option>
           <option value="claude-haiku-4-5">claude-haiku-4-5</option>
         </select>
@@ -2193,6 +2232,7 @@ document.querySelectorAll('.nav-item').forEach(item => {
     if (page === 'overview' && !projectsLoaded) loadProjects();
     if (page === 'overview') { updateWelcomeGreeting(); loadDiary(); }
     if (page === 'agent-monitor') loadAgentMonitor();
+    if (page === 'memory-browser') loadMemoryBrowser();
     if (page === 'burn-report') loadBurnReport();
     if (page === 'settings') loadSettings();
     if (page !== 'agent-monitor') stopAgentRefresh();
@@ -2921,7 +2961,166 @@ async function loadProjects() {
   }
 }
 
-/* Memory Browser — placeholder, full implementation coming in v4.1 */
+/* ════════════════════════════════════════════
+   Memory Browser
+   ════════════════════════════════════════════ */
+let _mbEntries = [];
+let _mbLoaded = false;
+
+// Mask secrets/PII so they are never rendered in plain sight.
+function maskSecrets(text) {
+  if (!text) return '';
+  return text
+    .replace(/MSPRO-[A-Z0-9-]{4,}/gi, 'MSPRO-****')
+    .replace(/sk-[A-Za-z0-9-]{8,}/g, 'sk-****')
+    .replace(/[\w.+-]+@[\w-]+\.[\w.-]+/g, function (m) {
+      const at = m.indexOf('@');
+      return m[0] + '****' + m.slice(at);
+    });
+}
+
+// Clean seam: a future semantic search can replace this body without touching the UI.
+function searchEntries(entries, query) {
+  const q = (query || '').trim().toLowerCase();
+  if (!q) return entries;
+  const terms = q.split(/\s+/);
+  return entries.filter(function (e) {
+    const hay = ((e.title || '') + '\n' + (e.content || '')).toLowerCase();
+    return terms.every(function (t) { return hay.includes(t); });
+  });
+}
+
+function _mbCleanBody(raw, title) {
+  const titleLower = (title || '').toLowerCase().trim();
+  return (raw || '').split('\n')
+    .map(function (l) { return l.replace(/^#{1,6}\s+/, ''); })
+    .filter(function (l, i) {
+      const t = l.trim();
+      if (!t) return true;
+      if (t.startsWith('Working directory:')) return false;
+      if (i === 0 && (t.toLowerCase() === titleLower || /^\d{4}-/.test(t))) return false;
+      return true;
+    })
+    .join('\n').replace(/\n{3,}/g, '\n\n').trim();
+}
+
+function _mbCleanTitle(e) {
+  return (e.title || e.filename || '').replace(/^\d{4}-\d{2}-\d{2}[\s\-_]*/, '').trim() || e.filename || 'Untitled';
+}
+
+function _mbFormatDate(raw) {
+  if (!raw) return '';
+  const d = new Date(raw + 'T00:00:00');
+  return isNaN(d.getTime()) ? raw : d.toLocaleDateString('en-US', { year: 'numeric', month: 'short', day: 'numeric' });
+}
+
+function _mbSourceClass(e) { return e.source_type === 'agent' ? 'agent' : 'direct'; }
+
+function renderMemoryList() {
+  const listEl = document.getElementById('mb-list');
+  const detailEl = document.getElementById('mb-detail');
+  const countEl = document.getElementById('mb-count');
+  detailEl.style.display = 'none';
+  listEl.style.display = 'flex';
+  const query = document.getElementById('mb-search').value;
+  const filtered = searchEntries(_mbEntries, query);
+  countEl.textContent = filtered.length + ' of ' + _mbEntries.length + ' entries';
+  if (!_mbEntries.length) {
+    listEl.innerHTML = '<span class="empty-state">No diary entries found.</span>';
+    return;
+  }
+  if (!filtered.length) {
+    listEl.innerHTML = '<span class="empty-state">No entries match your search.</span>';
+    return;
+  }
+  listEl.innerHTML = filtered.map(function (e, i) {
+    const body = _mbCleanBody(e.content, e.title);
+    const snippet = escapeHtml(maskSecrets(body.substring(0, 220)));
+    const more = body.length > 220 ? '...' : '';
+    return '<div class="diary-entry mb-entry" data-idx="' + i + '">'
+      + '<div class="diary-header">'
+      + '<span class="diary-title">' + escapeHtml(_mbCleanTitle(e)) + '</span>'
+      + '<span class="diary-date">' + _mbFormatDate(e.date) + '</span>'
+      + '</div>'
+      + '<div class="mb-badges">'
+      + '<span class="mb-badge project">' + escapeHtml(e.project || 'Unknown') + '</span>'
+      + '<span class="mb-badge ' + _mbSourceClass(e) + '">' + _mbSourceClass(e) + '</span>'
+      + '</div>'
+      + '<div class="diary-body" style="margin-top:0.4rem">' + snippet + more + '</div>'
+      + '</div>';
+  }).join('');
+  listEl.querySelectorAll('.mb-entry').forEach(function (el) {
+    el.addEventListener('click', function () {
+      showMemoryDetail(filtered[parseInt(el.dataset.idx, 10)]);
+    });
+  });
+}
+
+function showMemoryDetail(e) {
+  if (!e) return;
+  const listEl = document.getElementById('mb-list');
+  const detailEl = document.getElementById('mb-detail');
+  listEl.style.display = 'none';
+  detailEl.style.display = 'block';
+  const body = maskSecrets(_mbCleanBody(e.content, e.title));
+  detailEl.innerHTML = ''
+    + '<div class="mb-detail-head">'
+    + '<div class="mb-detail-actions">'
+    + '<button class="mb-back" id="mb-back-btn">&larr; Back to list</button>'
+    + '<button class="mb-back" id="mb-copy-btn" title="Copy to clipboard">Copy</button>'
+    + '</div>'
+    + '<div class="mb-badges">'
+    + '<span class="mb-badge project">' + escapeHtml(e.project || 'Unknown') + '</span>'
+    + '<span class="mb-badge ' + _mbSourceClass(e) + '">' + _mbSourceClass(e) + '</span>'
+    + '<span class="diary-date">' + _mbFormatDate(e.date) + '</span>'
+    + '</div></div>'
+    + '<h3 class="mb-detail-title">' + escapeHtml(_mbCleanTitle(e)) + '</h3>'
+    + '<div class="mb-detail-content">' + escapeHtml(body) + '</div>';
+  document.getElementById('mb-back-btn').addEventListener('click', renderMemoryList);
+  document.getElementById('mb-copy-btn').addEventListener('click', function() {
+    const btn = this;
+    // Copy the masked body (what is displayed), never the raw e.content
+    navigator.clipboard.writeText(body).then(function() {
+      btn.textContent = 'Copied!';
+      btn.style.color = '#3fb950';
+      btn.style.borderColor = '#3fb950';
+      setTimeout(function() { btn.textContent = 'Copy'; btn.style.color = ''; btn.style.borderColor = ''; }, 2000);
+    }).catch(function() { /* fallback: ignore */ });
+  });
+}
+
+async function fetchMemoryEntries(project) {
+  const listEl = document.getElementById('mb-list');
+  listEl.innerHTML = '<span class="empty-state">Loading...</span>';
+  try {
+    const res = await fetch('/api/memory-browser/entries?project=' + encodeURIComponent(project), {headers: AUTH_GET});
+    _mbEntries = await res.json();
+  } catch (err) {
+    _mbEntries = [];
+  }
+  renderMemoryList();
+}
+
+async function loadMemoryBrowser() {
+  if (_mbLoaded) return;
+  _mbLoaded = true;
+  const sel = document.getElementById('mb-project');
+  const searchEl = document.getElementById('mb-search');
+  searchEl.addEventListener('input', renderMemoryList);
+  sel.addEventListener('change', function () { fetchMemoryEntries(sel.value); });
+  try {
+    const res = await fetch('/api/memory-browser/projects', {headers: AUTH_GET});
+    const projects = await res.json();
+    const total = projects.reduce(function (s, p) { return s + p.count; }, 0);
+    sel.innerHTML = '<option value="__all__">All projects (' + total + ')</option>'
+      + projects.map(function (p) {
+          return '<option value="' + escapeHtml(p.project) + '">' + escapeHtml(p.project) + ' (' + p.count + ')</option>';
+        }).join('');
+  } catch (err) {
+    sel.innerHTML = '<option value="__all__">All projects</option>';
+  }
+  await fetchMemoryEntries('__all__');
+}
 
 
 /* ════════════════════════════════════════════
@@ -3206,7 +3405,7 @@ let busyPhraseIntervals = {};
 let busyPhraseIndices = {manager: 0, builder: 0, reviewer: 0};
 let elapsedIntervals = {};
 
-const MODEL_DEFAULTS = {manager: 'claude-opus-4-6', builder: 'claude-sonnet-4-6', reviewer: 'claude-sonnet-4-6'};
+const MODEL_DEFAULTS = {manager: 'claude-opus-4-8', builder: 'claude-sonnet-4-6', reviewer: 'claude-sonnet-4-6'};
 
 function saveModelPrefs() {
   ['manager', 'builder', 'reviewer'].forEach(role => {
@@ -3284,6 +3483,28 @@ async function startAgentTask() {
   const btn = document.getElementById('agent-start-btn');
   btn.disabled = true; btn.textContent = 'Starting...';
   try {
+    if (workDir) {
+      let pf = null;
+      try {
+        const pfRes = await fetch('/api/git-branches?workdir=' + encodeURIComponent(workDir), {headers: AUTH_GET});
+        pf = await pfRes.json();
+      } catch(e) { pf = null; }
+      if (pf && pf.is_repo === false) {
+        const doInit = confirm("This folder isn't a git repository. The agents use git to track changes.\n\nInitialize a new git repository in this exact folder?\n\n" + workDir);
+        if (!doInit) { return; }
+        btn.textContent = 'Initializing git...';
+        let initData = null;
+        try {
+          const initRes = await fetch('/api/git-init', {method:'POST', headers: AUTH_HEADERS, body: JSON.stringify({workdir: workDir})});
+          initData = await initRes.json();
+        } catch(e) { initData = {success: false, error: e.message}; }
+        if (!initData || !initData.success) {
+          alert("Could not initialize a git repository in:\n" + workDir + (initData && initData.error ? "\n\nDetails: " + initData.error : ""));
+          return;
+        }
+        await fetchBranches(workDir);
+      }
+    }
     const branchSel = document.getElementById('agent-branch-select');
     const branchRow = document.getElementById('agent-branch-row');
     const selectedBranch = (branchRow && branchRow.style.display !== 'none' && branchSel && branchSel.value) ? branchSel.value : '';
@@ -3294,7 +3515,19 @@ async function startAgentTask() {
         btn.textContent = 'Checking out branch...';
         const coRes = await fetch('/api/git-checkout', {method:'POST', headers: AUTH_HEADERS, body: JSON.stringify({workdir: workDir, branch: selectedBranch})});
         const coData = await coRes.json();
-        if (!coData.success) { alert('Branch checkout failed: ' + (coData.error || 'Unknown error')); return; }
+        if (!coData.success) {
+          const raw = (coData.error || '').trim();
+          let msg = "Could not switch to branch '" + selectedBranch + "'.";
+          if (/not a git repository/i.test(raw)) {
+            msg = "This folder isn't a git repository, so the branch could not be checked out.\n\nFolder: " + workDir;
+          } else if (/local changes|would be overwritten|uncommitted/i.test(raw)) {
+            msg = "Cannot switch to '" + selectedBranch + "' because there are uncommitted changes. Commit or stash them first.";
+          } else if (raw) {
+            msg += "\n\nDetails: " + raw;
+          }
+          alert(msg);
+          return;
+        }
       }
     }
     let finalTask = task;
@@ -3911,12 +4144,28 @@ async function checkProxyHealth() {
     dot.className = 'health-dot connected';
     text.className = 'health-text connected';
     const session = data.session_avg_savings_pct || data.total_savings_pct || 0;
-    const lifetime = data.lifetime_avg || 0;
-    text.textContent = 'Proxy: Connected (' + session.toFixed(0) + '% session | ' + lifetime.toFixed(0) + '% lifetime)';
+    const last30d = data.lifetime_avg || 0;
+    text.textContent = 'Proxy: Connected (' + session.toFixed(0) + '% session | ' + last30d.toFixed(0) + '% 30d)';
+    const badge = document.getElementById('proxy-tier-badge');
+    if (badge) {
+      if (data.tier === 'pro') {
+        badge.textContent = 'PRO';
+        badge.style.cssText = badge.style.cssText.replace(/display:[^;]*;?/, '') +
+          ';background:rgba(210,153,34,0.15);color:#d29922;border:1px solid rgba(210,153,34,0.3);display:inline-block;';
+      } else if (data.tier === 'free') {
+        badge.textContent = 'FREE';
+        badge.style.cssText = badge.style.cssText.replace(/display:[^;]*;?/, '') +
+          ';background:rgba(139,148,158,0.15);color:#8b949e;border:1px solid rgba(139,148,158,0.2);display:inline-block;';
+      } else {
+        badge.style.display = 'none';
+      }
+    }
   } catch(e) {
     dot.className = 'health-dot disconnected';
     text.className = 'health-text disconnected';
     text.textContent = 'Proxy: Disconnected';
+    const badge = document.getElementById('proxy-tier-badge');
+    if (badge) badge.style.display = 'none';
   }
 }