memstack-skill-loader 4.8.0__tar.gz → 4.9.0__tar.gz

{memstack_skill_loader-4.8.0/src/memstack_skill_loader.egg-info → memstack_skill_loader-4.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memstack-skill-loader
-Version: 4.8.0
+Version: 4.9.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.8.0 → memstack_skill_loader-4.9.0}/pyproject.toml

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

{memstack_skill_loader-4.8.0 → memstack_skill_loader-4.9.0}/src/memstack_skill_loader/__init__.py

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

{memstack_skill_loader-4.8.0 → memstack_skill_loader-4.9.0}/src/memstack_skill_loader/dashboard.html

@@ -1319,6 +1319,10 @@
       <svg viewBox="0 0 24 24"><path d="M21 6h-2v9H6v2c0 .55.45 1 1 1h11l4 4V7c0-.55-.45-1-1-1zm-4 6V3c0-.55-.45-1-1-1H3c-.55 0-1 .45-1 1v14l4-4h10c.55 0 1-.45 1-1z"/></svg>
       Agent Monitor
     </a>
+    <a class="nav-item" data-page="referrals">
+      <svg viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81 1.66 0 3-1.34 3-3s-1.34-3-3-3-3 1.34-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9c-1.66 0-3 1.34-3 3s1.34 3 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.16c-.05.21-.08.43-.08.65 0 1.61 1.31 2.92 2.92 2.92s2.92-1.31 2.92-2.92-1.31-2.92-2.92-2.92z"/></svg>
+      Referrals
+    </a>
     <a class="nav-item" data-page="settings">
       <svg viewBox="0 0 24 24"><path d="M19.14 12.94c.04-.3.06-.61.06-.94 0-.32-.02-.64-.07-.94l2.03-1.58a.49.49 0 00.12-.61l-1.92-3.32a.49.49 0 00-.59-.22l-2.39.96c-.5-.38-1.03-.7-1.62-.94l-.36-2.54a.484.484 0 00-.48-.41h-3.84c-.24 0-.43.17-.47.41l-.36 2.54c-.59.24-1.13.57-1.62.94l-2.39-.96c-.22-.08-.47 0-.59.22L2.74 8.87c-.12.21-.08.47.12.61l2.03 1.58c-.05.3-.07.62-.07.94s.02.64.07.94l-2.03 1.58a.49.49 0 00-.12.61l1.92 3.32c.12.22.37.29.59.22l2.39-.96c.5.38 1.03.7 1.62.94l.36 2.54c.05.24.24.41.48.41h3.84c.24 0 .44-.17.47-.41l.36-2.54c.59-.24 1.13-.56 1.62-.94l2.39.96c.22.08.47 0 .59-.22l1.92-3.32c.12-.22.07-.47-.12-.61l-2.01-1.58zM12 15.6c-1.98 0-3.6-1.62-3.6-3.6s1.62-3.6 3.6-3.6 3.6 1.62 3.6 3.6-1.62 3.6-3.6 3.6z"/></svg>
       Settings
@@ -1894,6 +1898,16 @@
 </div>
 
 <!-- ═══════ Settings (Placeholder) ═══════ -->
+<div id="page-referrals" class="page">
+  <div class="page-header">
+    <h2>Referral Program</h2>
+    <p class="meta">Stats update when this page loads &middot; <a href="#" id="referrals-refresh" onclick="loadReferrals();return false;">Refresh</a></p>
+  </div>
+  <div id="referrals-content">
+    <span class="empty-state">Loading&hellip;</span>
+  </div>
+</div>
+
 <div id="page-settings" class="page">
   <div class="page-header">
     <h2>Settings</h2>
@@ -2222,6 +2236,118 @@ overlay.addEventListener('click', () => {
   overlay.classList.remove('open');
 });
 
+/* ════════════════════════════════════════════
+   Referrals
+   ════════════════════════════════════════════ */
+async function loadReferrals() {
+  const el = document.getElementById('referrals-content');
+  if (!el) return;
+  el.innerHTML = '<span class="empty-state">Loading&hellip;</span>';
+  let data;
+  try {
+    const res = await fetch('/api/referrals', { headers: AUTH_GET });
+    data = await res.json();
+  } catch (e) {
+    data = { state: 'error' };
+  }
+  el.innerHTML = renderReferrals(data);
+}
+
+function referralNotice(msg, linkText, linkHref) {
+  let h = '<div class="panel" style="text-align:center;padding:2rem 1rem">';
+  h += '<p style="color:#c9d1d9;margin-bottom:' + (linkText ? '1rem' : '0') + '">' + escapeHtml(msg) + '</p>';
+  if (linkText && linkHref) {
+    h += '<a href="' + linkHref + '" target="_blank" rel="noopener" class="copy-git-output-btn" style="text-decoration:none;display:inline-block">' + escapeHtml(linkText) + '</a>';
+  }
+  h += '</div>';
+  return h;
+}
+
+function referralBadge(status) {
+  const map = {
+    pending:   ['#8b949e', '#161b22'],
+    signed_up: ['#58a6ff', 'rgba(88,166,255,0.1)'],
+    converted: ['#3fb950', 'rgba(63,185,80,0.1)'],
+    paid_out:  ['#bc8cff', 'rgba(188,140,255,0.1)'],
+  };
+  const c = map[status] || map.pending;
+  const label = (status || '').replace('_', ' ');
+  return '<span style="display:inline-block;padding:0.1rem 0.5rem;border-radius:10px;font-size:0.75rem;color:' + c[0] + ';background:' + c[1] + ';border:1px solid ' + c[0] + '33">' + escapeHtml(label) + '</span>';
+}
+
+function renderReferrals(d) {
+  const state = d && d.state;
+  if (state === 'pro_required') {
+    return referralNotice('Referral stats are available for MemStack Pro users.', 'Get MemStack Pro', 'https://memstack.pro');
+  }
+  if (state === 'not_linked') {
+    return referralNotice('Link your license key to your account at memstack.pro/dashboard to see your referral stats here.', 'Link my license', 'https://memstack.pro/dashboard');
+  }
+  if (state !== 'ok') {
+    return referralNotice("Couldn't reach memstack.pro right now. Stats will load when you're back online.", '', '');
+  }
+  const link = d.referral_link || '';
+  const tier = d.tier || {};
+  const cards = [
+    ['Clicks', fmt(d.clicks)],
+    ['Referrals', fmt(d.total_referrals)],
+    ['Signups', fmt(d.signups)],
+    ['Conversions', fmt(d.conversions)],
+    ['Total Earnings', '$' + Number(d.total_earnings || 0).toFixed(2)],
+    ['Tier', tier.name ? (escapeHtml(tier.name) + ' (' + tier.percent + '%)') : '&mdash;'],
+  ];
+  const colors = ['#58a6ff', '#3fb950', '#d29922', '#bc8cff', '#39d353', '#ff7b72'];
+  let html = '';
+  html += '<div class="panel" style="margin-bottom:1rem">';
+  html += '<h3>Your referral link</h3>';
+  html += '<div style="display:flex;gap:0.5rem;align-items:center;flex-wrap:wrap">';
+  html += '<input id="referral-link-input" readonly value="' + escapeHtml(link) + '" style="flex:1;min-width:240px;background:#0d1117;border:1px solid #30363d;border-radius:6px;padding:0.5rem 0.75rem;color:#c9d1d9;font-family:monospace;font-size:0.85rem">';
+  html += '<button class="copy-git-output-btn" onclick="copyReferralLink()" title="Copy to clipboard">Copy</button>';
+  html += '</div></div>';
+  html += '<div class="stats-grid">';
+  cards.forEach((c, i) => {
+    html += '<div class="card"><div class="value" style="color:' + colors[i] + '">' + c[1] + '</div><div class="label">' + c[0] + '</div></div>';
+  });
+  html += '</div>';
+  const recent = d.recent || [];
+  html += '<div class="panel" style="margin-top:1rem"><h3>Recent Referrals</h3>';
+  if (!recent.length) {
+    html += '<span class="empty-state">No referrals yet. Share your link to get started!</span>';
+  } else {
+    html += '<table style="width:100%;border-collapse:collapse;font-size:0.85rem">';
+    html += '<thead><tr style="text-align:left;color:#8b949e"><th style="padding:0.4rem 0.5rem">Email</th><th style="padding:0.4rem 0.5rem">Status</th><th style="padding:0.4rem 0.5rem">Amount</th><th style="padding:0.4rem 0.5rem">Date</th></tr></thead><tbody>';
+    recent.forEach((r) => {
+      const amt = r.commission_amount != null ? ('$' + Number(r.commission_amount).toFixed(2)) : '&mdash;';
+      const dt = r.created_at ? new Date(r.created_at).toLocaleDateString() : '&mdash;';
+      html += '<tr style="border-top:1px solid #21262d">';
+      html += '<td style="padding:0.4rem 0.5rem;color:#c9d1d9">' + escapeHtml(r.referred_email_masked || '') + '</td>';
+      html += '<td style="padding:0.4rem 0.5rem">' + referralBadge(r.status) + '</td>';
+      html += '<td style="padding:0.4rem 0.5rem;color:#8b949e">' + amt + '</td>';
+      html += '<td style="padding:0.4rem 0.5rem;color:#8b949e">' + dt + '</td>';
+      html += '</tr>';
+    });
+    html += '</tbody></table>';
+  }
+  html += '</div>';
+  return html;
+}
+
+async function copyReferralLink() {
+  const el = document.getElementById('referral-link-input');
+  if (!el) return;
+  try {
+    await navigator.clipboard.writeText(el.value);
+    const btn = document.querySelector('#page-referrals .copy-git-output-btn');
+    if (btn) {
+      const orig = btn.textContent;
+      btn.textContent = 'Copied!';
+      btn.style.color = '#3fb950';
+      btn.style.borderColor = '#3fb950';
+      setTimeout(() => { btn.textContent = orig; btn.style.color = ''; btn.style.borderColor = ''; }, 2000);
+    }
+  } catch (e) { /* ignore */ }
+}
+
 document.querySelectorAll('.nav-item').forEach(item => {
   item.addEventListener('click', () => {
     const page = item.dataset.page;
@@ -2238,6 +2364,7 @@ document.querySelectorAll('.nav-item').forEach(item => {
     if (page === 'agent-monitor') loadAgentMonitor();
     if (page === 'memory-browser') loadMemoryBrowser();
     if (page === 'burn-report') loadBurnReport();
+    if (page === 'referrals') loadReferrals();
     if (page === 'settings') loadSettings();
     if (page !== 'agent-monitor') stopAgentRefresh();
   });

{memstack_skill_loader-4.8.0 → memstack_skill_loader-4.9.0}/src/memstack_skill_loader/dashboard.py

@@ -9,6 +9,7 @@ import shutil
 import sys
 import threading
 import time
+import urllib.error
 import urllib.request
 import webbrowser
 from datetime import datetime, timezone
@@ -543,6 +544,53 @@ def _collect_browser_entries(project: str | None = None) -> list[dict]:
     return entries
 
 
+# Live referral-stats endpoint on the pro-site. Overridable for testing.
+REFERRALS_URL = os.environ.get(
+    "MEMSTACK_REFERRALS_URL", "https://memstack.pro/api/referrals/me"
+)
+
+
+def _get_referral_stats() -> bytes:
+    """Proxy the local license key to the pro-site referral-stats endpoint.
+
+    The license key is read server-side (never exposed to browser JS) and POSTed
+    to REFERRALS_URL. Returns a JSON body with a top-level "state" so the page can
+    render each outcome distinctly:
+
+      - "pro_required": no local license key (free user) — NO network call made
+      - "ok":           stats present (endpoint payload merged in)
+      - "not_linked":   key isn't linked to a Pro account on the site (404)
+      - "error":        timeout / network / unexpected — never breaks the dashboard
+
+    Fail-soft everywhere: any failure resolves to "error", 5s timeout.
+    """
+    from .license import get_license_key
+
+    key = get_license_key()
+    if not key:
+        return json.dumps({"state": "pro_required"}).encode()
+
+    try:
+        payload = json.dumps({"license_key": key}).encode()
+        req = urllib.request.Request(
+            REFERRALS_URL,
+            data=payload,
+            headers={"Content-Type": "application/json"},
+            method="POST",
+        )
+        with urllib.request.urlopen(req, timeout=5) as resp:
+            data = json.loads(resp.read().decode("utf-8"))
+        data["state"] = "ok"
+        return json.dumps(data).encode()
+    except urllib.error.HTTPError as exc:
+        if exc.code == 404:
+            return json.dumps({"state": "not_linked"}).encode()
+        return json.dumps({"state": "error"}).encode()
+    except Exception:
+        # Timeout, connection refused, DNS failure, bad JSON — all fail soft.
+        return json.dumps({"state": "error"}).encode()
+
+
 class _DashboardServer(HTTPServer):
     allow_reuse_address = False
 
@@ -868,6 +916,8 @@ class _Handler(BaseHTTPRequestHandler):
             }
             body = json.dumps(data).encode()
             self._respond(200, "application/json", body)
+        elif self.path == "/api/referrals":
+            self._respond(200, "application/json", _get_referral_stats())
         elif self.path == "/api/license-status":
             from .license import LICENSE_FILE, DISK_CACHE_FILE
             result = {"has_license": False, "key_masked": None, "valid": False, "plan": None, "checked_at": None, "cache_age_days": None}

{memstack_skill_loader-4.8.0 → memstack_skill_loader-4.9.0/src/memstack_skill_loader.egg-info}/PKG-INFO

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