gitmem-mcp 1.5.1 → 1.6.1

package/dist/services/transcript-chunker.js

@@ -7,6 +7,7 @@
  *
  */
 import { getTableName } from "./tier.js";
+import { getProConfig } from "./license.js";
 // OpenRouter API configuration (same as local-vector-search)
 const OPENROUTER_API_URL = "https://openrouter.ai/api/v1/embeddings";
 const EMBEDDING_MODEL = "openai/text-embedding-3-small";
@@ -32,9 +33,9 @@ function normalize(vec) {
  * Generate embedding using OpenRouter API
  */
 async function generateEmbedding(text) {
-    const apiKey = process.env.OPENROUTER_API_KEY;
+    const apiKey = process.env.OPENROUTER_API_KEY || getProConfig().openrouterKey;
     if (!apiKey) {
-        throw new Error("OPENROUTER_API_KEY not configured");
+        throw new Error("No OpenRouter key configured (set OPENROUTER_API_KEY env var or run: npx gitmem-mcp activate)");
     }
     const response = await fetch(OPENROUTER_API_URL, {
         method: "POST",

package/dist/services/variant-generation.js

@@ -17,6 +17,7 @@
  * Called fire-and-forget from create_learning — zero impact on UX latency.
  */
 import * as supabase from "./supabase-client.js";
+import { getProConfig } from "./license.js";
 // --- Pipeline versioning ---
 // Bump PIPELINE_VERSION when changing the prompt, model, or generation logic.
 // Format: "gen-{major}.{minor}" — major for prompt rewrites, minor for tweaks.
@@ -83,9 +84,9 @@ function buildUserPrompt(scar) {
  * Returns parsed output or null on failure.
  */
 async function generateWithLLM(scar) {
-    const apiKey = process.env.OPENROUTER_API_KEY;
+    const apiKey = process.env.OPENROUTER_API_KEY || getProConfig().openrouterKey;
     if (!apiKey) {
-        console.error("[variant-generation] No OPENROUTER_API_KEY — falling back to deterministic");
+        console.error("[variant-generation] No OpenRouter key (env or config.json) — falling back to deterministic");
         return null;
     }
     try {

package/dist/tools/recall.js

@@ -14,7 +14,7 @@
  */
 import * as supabase from "../services/supabase-client.js";
 import { localScarSearch, isLocalSearchReady } from "../services/local-vector-search.js";
-import { hasSupabase, hasVariants, hasMetrics, getTableName } from "../services/tier.js";
+import { hasSupabase, hasVariants, hasMetrics, hasProInsights, getTableName } from "../services/tier.js";
 import { getProject } from "../services/session-state.js";
 import { getStorage } from "../services/storage.js";
 import { Timer, recordMetrics, buildPerformanceData, buildComponentPerformance, calculateContextBytes, } from "../services/metrics.js";
@@ -82,12 +82,16 @@ No past lessons match this plan closely enough. Scars accumulate as you work —
         const starterTag = scar.is_starter ? ` ${dimText("[starter]")}` : "";
         // Confidence tier: marginal matches (< 0.55) get flagged — 66% N/A rate in this range
         const confidenceTag = scar.similarity < 0.55 ? ` ${dimText("[low confidence]")}` : "";
-        lines.push(`${sev} **${scar.title}** (${scar.severity}, ${scar.similarity.toFixed(2)}) ${dimText(`id:${scar.id.slice(0, 8)}`)}${starterTag}${confidenceTag}`);
+        // Pro: decay tag for scars with reduced behavioral relevance
+        const decayTag = hasProInsights() && scar.decay_multiplier !== undefined && scar.decay_multiplier < 0.8
+            ? ` ${dimText(`[decay: ${Math.round(scar.decay_multiplier * 100)}%]`)}`
+            : "";
+        lines.push(`${sev} **${scar.title}** (${scar.severity}, ${scar.similarity.toFixed(2)}) ${dimText(`id:${scar.id.slice(0, 8)}`)}${starterTag}${confidenceTag}${decayTag}`);
         // Inline archival hint: scars with high dismiss rates get annotated
         if (dismissals) {
             const counts = dismissals.get(scar.id);
-            if (counts && counts.surfaced >= 5 && (counts.dismissed / counts.surfaced) >= 0.7) {
-                lines.push(`  _[${counts.dismissed}x dismissed — consider archiving with gm-archive]_`);
+            if (counts && counts.surfaced >= 3 && (counts.dismissed / counts.surfaced) >= 0.6) {
+                lines.push(`  _[dismissed ${counts.dismissed}/${counts.surfaced} times — re-evaluate whether this still applies]_`);
             }
         }
         // Use variant enforcement text if available (blind to variant name)
@@ -145,6 +149,14 @@ No past lessons match this plan closely enough. Scars accumulate as you work —
         lines.push("");
     }
     lines.push("**Acknowledge these lessons before proceeding.**");
+    // Pro: graph nudge when triples exist on any scar
+    if (hasProInsights() && scars.some(s => s.related_triples && s.related_triples.length > 0)) {
+        const firstScarWithTriples = scars.find(s => s.related_triples && s.related_triples.length > 0);
+        if (firstScarWithTriples) {
+            lines.push("");
+            lines.push(dimText(`Pro: Use graph_traverse(lens: 'connected_to', node: '${firstScarWithTriples.title}') to explore deeper connections.`));
+        }
+    }
     return lines.join("\n");
 }
 /**

package/dist/tools/session-close.js

@@ -10,7 +10,7 @@ import { v4 as uuidv4 } from "uuid";
 import { detectAgent } from "../services/agent-detection.js";
 import * as supabase from "../services/supabase-client.js";
 import { embed, isEmbeddingAvailable } from "../services/embedding.js";
-import { hasSupabase, getTableName } from "../services/tier.js";
+import { hasSupabase, hasProInsights, getTableName } from "../services/tier.js";
 import { getStorage } from "../services/storage.js";
 import { clearCurrentSession, getSurfacedScars, getConfirmations, getReflections, getObservations, getChildren, getThreads, getSessionActivity, isRecallCalled } from "../services/session-state.js";
 import { normalizeThreads, mergeThreadStates, migrateStringThread, saveThreadsFile } from "../services/thread-manager.js"; // 
@@ -20,6 +20,7 @@ import { validateSessionClose, buildCloseCompliance, } from "../services/complia
 import { normalizeReflectionKeys } from "../constants/closing-questions.js";
 import { Timer, recordMetrics, buildPerformanceData, updateRelevanceData, } from "../services/metrics.js";
 import { wrapDisplay, truncate, productLine, dimText, STATUS, ANSI } from "../services/display-protocol.js";
+import { queryScarUsageByDateRange, enrichScarUsageTitles, formatBlindspotSnippet } from "../services/analytics.js";
 import { recordScarUsageBatch } from "./record-scar-usage-batch.js";
 import { getEffectTracker } from "../services/effect-tracker.js";
 import { saveTranscript } from "./save-transcript.js";
@@ -264,7 +265,7 @@ async function sessionCloseFree(params, timer) {
         };
     }
 }
-function formatCloseDisplay(sessionId, compliance, params, learningsCount, success, errors, transcriptStatus) {
+function formatCloseDisplay(sessionId, compliance, params, learningsCount, success, errors, transcriptStatus, blindspotSnippet) {
     const lines = [];
     // Header: branded product line
     const status = success ? STATUS.complete : STATUS.failed;
@@ -320,6 +321,11 @@ function formatCloseDisplay(sessionId, compliance, params, learningsCount, succe
             lines.push(`  ${indicator} ${truncate(s.reference_context || s.scar_identifier || "", 70)}`);
         }
     }
+    // Pro: blindspot section
+    if (blindspotSnippet) {
+        lines.push("");
+        lines.push(blindspotSnippet);
+    }
     // Transcript — only on failure
     if (transcriptStatus && !transcriptStatus.saved) {
         lines.push("");
@@ -1147,11 +1153,31 @@ export async function sessionClose(params) {
             params = { ...params, scars_to_record: bridgedScars };
         }
     }
+    // Pro: fetch blindspot data in parallel with session persistence
+    let blindspotSnippet = null;
+    const blindspotPromise = (async () => {
+        if (!hasProInsights())
+            return;
+        try {
+            const endDate = new Date().toISOString();
+            const startDate = new Date(Date.now() - 30 * 86400000).toISOString();
+            const project = isRetroactive ? "default" : existingSession?.project || "default";
+            const rawUsages = await queryScarUsageByDateRange(startDate, endDate, project);
+            const usages = await enrichScarUsageTitles(rawUsages);
+            blindspotSnippet = formatBlindspotSnippet(usages);
+        }
+        catch (error) {
+            console.error("[session_close] Blindspot fetch failed (non-fatal):", error);
+        }
+    })();
     // 6. Persist to Supabase (direct REST API, bypasses ww-mcp)
     try {
         // Upsert session WITHOUT embedding (fast path)
         // Embedding + thread detection run fire-and-forget after
-        await supabase.directUpsert(getTableName("sessions"), sessionData);
+        await Promise.all([
+            supabase.directUpsert(getTableName("sessions"), sessionData),
+            blindspotPromise,
+        ]);
         // Tracked fire-and-forget embedding generation + session update + thread detection
         if (isEmbeddingAvailable()) {
             getEffectTracker().track("embedding", "session_close", async () => {
@@ -1262,7 +1288,7 @@ export async function sessionClose(params) {
             }
             catch { /* already gone */ }
         }
-        const display = formatCloseDisplay(sessionId, closeCompliance, params, learningsCount, true, validation.warnings.length > 0 ? validation.warnings : undefined, transcriptStatus);
+        const display = formatCloseDisplay(sessionId, closeCompliance, params, learningsCount, true, validation.warnings.length > 0 ? validation.warnings : undefined, transcriptStatus, blindspotSnippet);
         return {
             success: true,
             session_id: sessionId,
@@ -1278,7 +1304,7 @@ export async function sessionClose(params) {
         const perfData = buildPerformanceData("session_close", latencyMs, 0);
         // Clear session state even on error (session is done either way)
         clearCurrentSession();
-        const errorDisplay = formatCloseDisplay(sessionId, closeCompliance, params, learningsCount, false, [`Failed to persist session: ${errorMessage}`], transcriptStatus);
+        const errorDisplay = formatCloseDisplay(sessionId, closeCompliance, params, learningsCount, false, [`Failed to persist session: ${errorMessage}`], transcriptStatus, blindspotSnippet);
         return {
             success: false,
             session_id: sessionId,

package/dist/tools/session-start.js

@@ -17,7 +17,7 @@ import { detectAgent } from "../services/agent-detection.js";
 import * as supabase from "../services/supabase-client.js";
 // Scar search removed from start pipeline (loads on-demand via recall)
 import { ensureInitialized } from "../services/startup.js";
-import { hasSupabase, getTableName } from "../services/tier.js";
+import { hasSupabase, hasProInsights, getTableName } from "../services/tier.js";
 import { getStorage } from "../services/storage.js";
 import { Timer, recordMetrics, calculateContextBytes, buildPerformanceData, buildComponentPerformance, } from "../services/metrics.js";
 import { setCurrentSession, getCurrentSession, addSurfacedScars, getSurfacedScars } from "../services/session-state.js";
@@ -29,6 +29,7 @@ import { registerSession, findSessionByHostPid, pruneStale, migrateFromLegacy }
 import * as os from "os";
 import { formatDate } from "../services/timezone.js";
 import { productLine, dimText, boldText } from "../services/display-protocol.js";
+import { querySessionsByDateRange, queryScarUsageByDateRange, enrichScarUsageTitles, computeLightweightSummary, } from "../services/analytics.js";
 /**
  * Closing payload schema — returned in session_start/refresh so agents
  * know the exact field names for closing-payload.json without guessing.
@@ -252,6 +253,32 @@ async function loadRecentDecisions(project, limit = 5) {
         };
     }
 }
+/**
+ * Load lightweight analytics for Pro insights snippet.
+ * Reuses cached analytics queries — ~200ms on cache miss, near-instant on hit.
+ * Returns null on any error (never blocks session start).
+ */
+async function loadLightweightAnalytics(project) {
+    if (!hasProInsights() || !hasSupabase())
+        return null;
+    try {
+        const endDate = new Date().toISOString();
+        const startDate = new Date(Date.now() - 30 * 86400000).toISOString();
+        const [sessions, rawUsages] = await Promise.all([
+            querySessionsByDateRange(startDate, endDate, project),
+            queryScarUsageByDateRange(startDate, endDate, project),
+        ]);
+        // Skip if not enough data for meaningful insights
+        if (sessions.length < 5)
+            return null;
+        const usages = await enrichScarUsageTitles(rawUsages);
+        return computeLightweightSummary(sessions, usages);
+    }
+    catch (error) {
+        console.error("[session_start] Lightweight analytics failed (non-fatal):", error);
+        return null;
+    }
+}
 // loadRecentWins removed — wins available via search/log on-demand
 /**
  * Create a new session record
@@ -666,7 +693,7 @@ function writeSessionFiles(sessionId, agent, project, surfacedScars, threads, re
 function stripThreadPrefix(text) {
     return text.replace(/^t-[a-f0-9]+:\s*/i, "");
 }
-function formatStartDisplay(result, displayInfoMap, isFirstSession) {
+function formatStartDisplay(result, displayInfoMap, isFirstSession, analytics) {
     const visual = [];
     // Line 1: branded product line + session state
     const stateLabel = result.refreshed ? "refreshed" : (result.resumed ? "resumed" : "active");
@@ -725,6 +752,16 @@ function formatStartDisplay(result, displayInfoMap, isFirstSession) {
         visual.push("");
         visual.push("No threads or decisions.");
     }
+    // Pro insights snippet — 30-day analytics summary
+    if (analytics) {
+        visual.push("");
+        const appPct = Math.round(analytics.application_rate * 100);
+        visual.push(boldText("Pro Insights (30d)"));
+        visual.push(`  ${analytics.total_sessions} sessions · ${analytics.scars_surfaced} scars surfaced · ${appPct}% applied`);
+        if (analytics.top_blindspot) {
+            visual.push(`  Top blindspot: "${analytics.top_blindspot.title}" (ignored ${analytics.top_blindspot.times} times)`);
+        }
+    }
     // First-session nudge — agent sees this once, internalizes to PMEM
     if (isFirstSession) {
         visual.push(FIRST_SESSION_NUDGE);
@@ -784,12 +821,13 @@ export async function sessionStart(params) {
     if (!hasSupabase()) {
         return sessionStartFree(params, env, agent, project, timer, metricsId, existingSession?.sessionId, existingSession?.startedAt || forceCarryStartedAt, priorSession ? { surfacedScars: forceCarrySurfacedScars, observations: forceCarryObservations, children: forceCarryChildren } : undefined);
     }
-    // 2. Load last session + decisions in parallel (was sequential)
+    // 2. Load last session + decisions + analytics in parallel (was sequential)
     // Scars and wins removed from pipeline — load on-demand via recall/search
     // Rapport loading disabled — recording kept in session_close but not injected
-    const [lastSessionResult, decisionsResult] = await Promise.all([
+    const [lastSessionResult, decisionsResult, analyticsResult] = await Promise.all([
         loadLastSession(agent, project),
         loadRecentDecisions(project, 3),
+        loadLightweightAnalytics(project),
     ]);
     const lastSession = lastSessionResult.session;
     const decisions = decisionsResult.decisions;
@@ -924,7 +962,7 @@ export async function sessionStart(params) {
         displayInfoMap.set(info.thread.id, info);
     }
     const isFirstSession = !isResuming && !slimLastSession;
-    result.display = formatStartDisplay(result, displayInfoMap, isFirstSession);
+    result.display = formatStartDisplay(result, displayInfoMap, isFirstSession, analyticsResult);
     // Write display to per-session dir
     try {
         const sessionFilePath = getSessionPath(sessionId, "session.json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitmem-mcp",
-  "version": "1.5.1",
+  "version": "1.6.1",
   "mcpName": "io.github.gitmem-dev/gitmem",
   "description": "Persistent learning memory for AI coding agents. Memory that compounds.",
   "type": "module",