@splicr/mcp-server 0.11.0 → 0.11.2

package/dist/cli.js

@@ -404,30 +404,50 @@ async function runHook() {
         // Gather env signals + fuse with user's prompt
         const { gatherSignals } = await import('./lib/signal-gatherer.js');
         const { fuseSignals } = await import('./lib/signal-fusion.js');
-        const { getRelevantContext } = await import('./lib/api-client.js');
+        const { getRelevantContext, getProjectContext } = await import('./lib/api-client.js');
+        const { detectProject } = await import('./lib/project-detector.js');
         const envSignals = gatherSignals(process.cwd());
         const fused = fuseSignals({ task: userPrompt }, envSignals);
         if (fused.queries.length === 0) {
             process.exit(0);
             return;
         }
-        // Call Splicr API — always global, relevance handles filtering
-        const { results } = await getRelevantContext({
+        // Check if this is the first message of the session (patterns not yet injected)
+        const sessionState = loadSessionState(sessionId);
+        const isFirstMessage = !loadSessionMeta(sessionId).patterns_injected;
+        // Fetch relevant context + patterns in parallel (patterns only on first message)
+        const contextPromise = getRelevantContext({
             queries: fused.queries,
             tech_stack: fused.tech_stack,
-            limit: 5, // fetch extra to allow for dedup filtering
+            limit: 5,
         });
-        if (!results || results.length === 0) {
-            process.exit(0);
-            return;
+        let patternsPromise = Promise.resolve({});
+        if (isFirstMessage) {
+            const detected = await detectProject(process.cwd()).catch(() => null);
+            if (detected?.name) {
+                patternsPromise = getProjectContext({
+                    project_name: detected.name,
+                    project_id: detected.id,
+                    limit: 1, // we only need patterns, not captures
+                }).catch(() => ({}));
+            }
         }
-        // Session-aware dedup: don't inject same captures twice in one session
-        const injectedIds = loadSessionState(sessionId);
-        const freshResults = results.filter((r) => !injectedIds.has(r.id));
-        if (freshResults.length === 0) {
+        const [{ results }, patternData] = await Promise.all([contextPromise, patternsPromise]);
+        // Build patterns section (first message only, deterministic enforcement)
+        let patternsSection = '';
+        if (isFirstMessage && patternData.patterns && patternData.patterns.length > 0) {
+            const patternLines = patternData.patterns.map((p, i) => `${i + 1}. **${p.name}** — ${p.description}`).join('\n');
+            patternsSection = `ACTIVE TEAM PATTERNS for ${patternData.project_name || 'this project'}:\n${patternLines}\n\nThese patterns are established by your team. Follow them unless explicitly asked to deviate.\n\n---\n\n`;
+            // Mark patterns as injected for this session
+            saveSessionMeta(sessionId, { patterns_injected: true });
+        }
+        if ((!results || results.length === 0) && !patternsSection) {
             process.exit(0);
             return;
         }
+        // Session-aware dedup: don't inject same captures twice in one session
+        const injectedIds = sessionState;
+        const freshResults = (results || []).filter((r) => !injectedIds.has(r.id));
         // Take top 3 fresh results
         const topResults = freshResults.slice(0, 3);
         // Track what we injected (IDs + titles for context-aware gate)
@@ -435,14 +455,22 @@ async function runHook() {
         for (const r of topResults)
             injectedIds.add(r.id);
         saveSessionState(sessionId, injectedIds, titles);
-        // Format as actionable decision-support context (12-factor style: own your context window)
-        const contextLines = topResults.map((r, i) => {
-            const why = r.why_relevant || 'Semantically similar to your work context';
-            const tags = r.tags?.length ? r.tags.slice(0, 5).join(', ') : '';
-            const source = r.source_type || 'unknown';
-            return `${i + 1}. "${r.title}" [${source}]${tags ? ` (${tags})` : ''}\n   → ${r.insight}\n   WHY RELEVANT: ${why}\n   DEEP DIVE: get_full_content("${r.id}")`;
-        }).join('\n\n');
-        const context = `SPLICR CONTEXT — The user's saved research matched this task. Use these findings to inform your response:\n\n${contextLines}\n\nACTION: Review above before answering. Call get_full_content(id) for complete articles. Fall back to web search only if these don't cover the question.`;
+        // Format knowledge context
+        let contextSection = '';
+        if (topResults.length > 0) {
+            const contextLines = topResults.map((r, i) => {
+                const why = r.why_relevant || 'Semantically similar to your work context';
+                const tags = r.tags?.length ? r.tags.slice(0, 5).join(', ') : '';
+                const source = r.source_type || 'unknown';
+                return `${i + 1}. "${r.title}" [${source}]${tags ? ` (${tags})` : ''}\n   → ${r.insight}\n   WHY RELEVANT: ${why}\n   DEEP DIVE: get_full_content("${r.id}")`;
+            }).join('\n\n');
+            contextSection = `SPLICR CONTEXT — The user's saved research matched this task. Use these findings to inform your response:\n\n${contextLines}\n\nACTION: Review above before answering. Call get_full_content(id) for complete articles. Fall back to web search only if these don't cover the question.`;
+        }
+        const context = patternsSection + contextSection;
+        if (!context.trim()) {
+            process.exit(0);
+            return;
+        }
         // Output JSON that Claude Code's hook system understands
         const output = JSON.stringify({
             hookSpecificOutput: {
@@ -773,6 +801,37 @@ function saveSessionState(sessionId, injectedIds, titles) {
     }
     catch { /* non-critical */ }
 }
+function loadSessionMeta(sessionId) {
+    if (!sessionId)
+        return {};
+    try {
+        const file = join(SESSION_STATE_DIR, `${sessionId}.json`);
+        if (existsSync(file)) {
+            const data = JSON.parse(readFileSync(file, 'utf-8'));
+            return { patterns_injected: data.patterns_injected || false };
+        }
+    }
+    catch { /* ignore */ }
+    return {};
+}
+function saveSessionMeta(sessionId, meta) {
+    if (!sessionId)
+        return;
+    try {
+        if (!existsSync(SESSION_STATE_DIR))
+            mkdirSync(SESSION_STATE_DIR, { recursive: true });
+        const file = join(SESSION_STATE_DIR, `${sessionId}.json`);
+        let existing = {};
+        if (existsSync(file)) {
+            try {
+                existing = JSON.parse(readFileSync(file, 'utf-8'));
+            }
+            catch { }
+        }
+        writeFileSync(file, JSON.stringify({ ...existing, ...meta, updated: Date.now() }));
+    }
+    catch { /* non-critical */ }
+}
 function readStdin() {
     return new Promise((resolve) => {
         let data = '';
@@ -783,26 +842,26 @@ function readStdin() {
         setTimeout(() => resolve(data), 500);
     });
 }
-const SPLICR_INSTRUCTION = `Call get_relevant_context (Splicr MCP) at the START of any task. Pass your understanding of the task (the user's message), any files you're reading/modifying, and any errors you've encountered. It automatically searches the user's knowledge base using full context awareness — your task, git branch, recent commits, changed files, and more.
-
-For follow-up or narrow searches during the same task, use search_knowledge with a specific query.
-
-When results have high relevance (>50%), call get_full_content(id) to get the complete saved content before responding.
-
-Splicr is the user's personal knowledge base. They save articles, tweets, code snippets, and research. Your job is to use it — not ignore it and rely on training data alone.
-
-## Auto-save learnings
-At the END of significant sessions (not trivial ones), review what you learned and save decisions/discoveries to Splicr using save_from_agent. Include the context field for attribution.
-
-Save ONLY: decisions (chose X over Y because...), discoveries (undocumented behavior), workarounds (non-obvious fixes), synthesis (combined multiple insights into a new approach).
-Do NOT save: file edits, routine commands, anything derivable from git log or reading the current code.
-
-Ask yourself: "Would a developer starting a new session benefit from knowing this?" If yes, save it.
-
-## Failure modes
-- Splicr returns no results → fall back to web search or training data
-- Splicr returns results but they don't answer the question → supplement with web search
-- Splicr API is unreachable → proceed without it, don't block the session
+const SPLICR_INSTRUCTION = `Call get_relevant_context (Splicr MCP) at the START of any task. Pass your understanding of the task (the user's message), any files you're reading/modifying, and any errors you've encountered. It automatically searches the user's knowledge base using full context awareness — your task, git branch, recent commits, changed files, and more.
+
+For follow-up or narrow searches during the same task, use search_knowledge with a specific query.
+
+When results have high relevance (>50%), call get_full_content(id) to get the complete saved content before responding.
+
+Splicr is the user's personal knowledge base. They save articles, tweets, code snippets, and research. Your job is to use it — not ignore it and rely on training data alone.
+
+## Auto-save learnings
+At the END of significant sessions (not trivial ones), review what you learned and save decisions/discoveries to Splicr using save_from_agent. Include the context field for attribution.
+
+Save ONLY: decisions (chose X over Y because...), discoveries (undocumented behavior), workarounds (non-obvious fixes), synthesis (combined multiple insights into a new approach).
+Do NOT save: file edits, routine commands, anything derivable from git log or reading the current code.
+
+Ask yourself: "Would a developer starting a new session benefit from knowing this?" If yes, save it.
+
+## Failure modes
+- Splicr returns no results → fall back to web search or training data
+- Splicr returns results but they don't answer the question → supplement with web search
+- Splicr API is unreachable → proceed without it, don't block the session
 - You forgot to save learnings → the Stop hook will remind you`;
 const SPLICR_MARKER = '# Splicr';
 function getInstructionFiles() {
@@ -1052,17 +1111,17 @@ async function teamCommand() {
             break;
         }
         default:
-            console.error(`
-  Splicr Teams
-
-  Commands:
-    team create "Name"    Create a new team
-    team list             List your teams
-    team invite           Show invite link for your team
-    team join <code>      Join a team by invite code
-
-  Or use setup --join:
-    setup --join <code>   Sign up + join team + configure agents (one command)
+            console.error(`
+  Splicr Teams
+
+  Commands:
+    team create "Name"    Create a new team
+    team list             List your teams
+    team invite           Show invite link for your team
+    team join <code>      Join a team by invite code
+
+  Or use setup --join:
+    setup --join <code>   Sign up + join team + configure agents (one command)
 `);
             break;
     }
@@ -1079,34 +1138,34 @@ function printManualConfig() {
     console.error('  }\n');
 }
 function printHelp() {
-    console.error(`
-  Splicr — route what you read to what you're building
-
-  Getting started:
-    npx @splicr/mcp-server setup                Sign up + configure all agents (one command)
-    npx @splicr/mcp-server setup --join <code>   Sign up + join team + configure agents
-
-  Commands:
-    setup              One-time setup: authenticate + configure agents + hooks
-    login              Re-authenticate
-    team create "Name" Create a new team
-    team list          List your teams
-    team invite        Show invite link for your team
-    team join <code>   Join a team by invite code
-    dashboard          Open knowledge dashboard in browser
-    uninstall          Remove Splicr from all coding agents
-
-  Supported agents (auto-detected):
-    Claude Code, Codex, Cursor, Cline, Antigravity
-
-  Quick start:
-    1. Run: npx @splicr/mcp-server setup
-    2. Save knowledge from anywhere:
-       - Telegram: t.me/SplicrBot (send links from your phone)
-       - Extension: chromewebstore.google.com/detail/dllhofjfmkmbdadilbdgojapfbmlhnla
-       - Agent: save_from_agent tool (agents save learnings)
-    3. Open any coding agent — your saves show up when relevant
-    4. Dashboard: splicr.dev/dashboard
+    console.error(`
+  Splicr — route what you read to what you're building
+
+  Getting started:
+    npx @splicr/mcp-server setup                Sign up + configure all agents (one command)
+    npx @splicr/mcp-server setup --join <code>   Sign up + join team + configure agents
+
+  Commands:
+    setup              One-time setup: authenticate + configure agents + hooks
+    login              Re-authenticate
+    team create "Name" Create a new team
+    team list          List your teams
+    team invite        Show invite link for your team
+    team join <code>   Join a team by invite code
+    dashboard          Open knowledge dashboard in browser
+    uninstall          Remove Splicr from all coding agents
+
+  Supported agents (auto-detected):
+    Claude Code, Codex, Cursor, Cline, Antigravity
+
+  Quick start:
+    1. Run: npx @splicr/mcp-server setup
+    2. Save knowledge from anywhere:
+       - Telegram: t.me/SplicrBot (send links from your phone)
+       - Extension: chromewebstore.google.com/detail/dllhofjfmkmbdadilbdgojapfbmlhnla
+       - Agent: save_from_agent tool (agents save learnings)
+    3. Open any coding agent — your saves show up when relevant
+    4. Dashboard: splicr.dev/dashboard
 `);
 }
 main().catch(err => {

package/dist/index.js

@@ -35,18 +35,18 @@ for (const signal of ['SIGTERM', 'SIGINT']) {
 }
 const server = new Server({ name: 'splicr', version: '0.1.0' }, {
     capabilities: { tools: {} },
-    instructions: `Splicr is the user's personal knowledge base — articles, tweets, code snippets, GitHub repos, and agent learnings saved from across the web. It is your PRIMARY source of context. Using it is not optional.
-
-CONTRACTS (you must follow these):
-1. BEFORE answering any question, BEFORE web searching, BEFORE relying on training data — call get_relevant_context with the user's task. This is not a suggestion. The user saved knowledge specifically for moments like this.
-2. When results have relevance >50%, call get_full_content(id) to get the complete saved content. Use it to ground your response.
-2b. When results include a compiled_page field, prefer get_compiled_page(id) — it's a synthesized wiki page merging multiple related sources into one structured document. More useful than reading individual captures.
-3. Only fall back to web search or training data if Splicr returns no results or results don't cover the question.
-4. At the END of significant sessions, call save_from_agent with decisions, discoveries, or workarounds you made. Include the context field for attribution.
-
-FAILURE MODES:
-- Splicr returns no results → proceed with web search or training data
-- Splicr API is unreachable → proceed without it, don't block the session
+    instructions: `Splicr is the user's personal knowledge base — articles, tweets, code snippets, GitHub repos, and agent learnings saved from across the web. It is your PRIMARY source of context. Using it is not optional.
+
+CONTRACTS (you must follow these):
+1. BEFORE answering any question, BEFORE web searching, BEFORE relying on training data — call get_relevant_context with the user's task. This is not a suggestion. The user saved knowledge specifically for moments like this.
+2. When results have relevance >50%, call get_full_content(id) to get the complete saved content. Use it to ground your response.
+2b. When results include a compiled_page field, prefer get_compiled_page(id) — it's a synthesized wiki page merging multiple related sources into one structured document. More useful than reading individual captures.
+3. Only fall back to web search or training data if Splicr returns no results or results don't cover the question.
+4. At the END of significant sessions, call save_from_agent with decisions, discoveries, or workarounds you made. Include the context field for attribution.
+
+FAILURE MODES:
+- Splicr returns no results → proceed with web search or training data
+- Splicr API is unreachable → proceed without it, don't block the session
 - Results don't match the question → supplement with other sources`,
 });
 // List tools

package/dist/lib/api-client.d.ts

@@ -146,7 +146,4 @@ export declare function getDecisions(params: {
 }): Promise<{
     results: any[];
 }>;
-export declare function getTeamStatus(params: {
-    project?: string;
-}): Promise<any>;
 export { API_URL };

package/dist/lib/api-client.js

@@ -104,8 +104,4 @@ export async function getDecisions(params) {
     const data = await apiRequest('POST', '/mcp/decisions', params);
     return { results: data.results ?? [] };
 }
-export async function getTeamStatus(params) {
-    const query = params.project ? `?project=${encodeURIComponent(params.project)}` : '';
-    return await apiRequest('GET', `/mcp/team-status${query}`);
-}
 export { API_URL };

package/dist/lib/github-local.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Local GitHub Status - uses `gh` CLI instead of stored token.
+ * Zero onboarding friction: if the user has `gh auth login` done, this just works.
+ */
+export interface TeamStatus {
+    repo: string;
+    open_prs: Array<{
+        number: number;
+        title: string;
+        author: string;
+        branch: string;
+        updated: string;
+        draft: boolean;
+    }>;
+    recent_merges: Array<{
+        title: string;
+        author: string;
+        merged_at: string;
+    }>;
+    active_branches: Array<{
+        name: string;
+    }>;
+    error?: string;
+}
+export declare function getLocalGitHubStatus(cwd: string): Promise<TeamStatus>;

package/dist/lib/github-local.js

@@ -0,0 +1,92 @@
+/**
+ * Local GitHub Status - uses `gh` CLI instead of stored token.
+ * Zero onboarding friction: if the user has `gh auth login` done, this just works.
+ */
+import { execSync } from 'child_process';
+import { getGitRemoteUrl, normalizeGitUrl } from './project-detector.js';
+/** Check if `gh` CLI is available and authenticated */
+function isGhAvailable() {
+    try {
+        execSync('gh auth status', { encoding: 'utf-8', stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Extract owner/repo from a git remote URL */
+function extractRepoFullName(cwd) {
+    const remote = getGitRemoteUrl(cwd);
+    if (!remote)
+        return null;
+    const normalized = normalizeGitUrl(remote);
+    // https://github.com/owner/repo -> owner/repo
+    const match = normalized.match(/github\.com\/([^/]+\/[^/]+)/);
+    return match ? match[1] : null;
+}
+/** Run a gh api command and parse JSON result */
+function ghApi(endpoint) {
+    try {
+        const result = execSync(`gh api "${endpoint}" --paginate`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 10000,
+        });
+        return JSON.parse(result);
+    }
+    catch {
+        return null;
+    }
+}
+export async function getLocalGitHubStatus(cwd) {
+    const repoFullName = extractRepoFullName(cwd);
+    if (!repoFullName) {
+        return { repo: 'unknown', open_prs: [], recent_merges: [], active_branches: [], error: 'No GitHub remote found in this directory.' };
+    }
+    if (!isGhAvailable()) {
+        return { repo: repoFullName, open_prs: [], recent_merges: [], active_branches: [], error: 'GitHub CLI (gh) not authenticated. Run `gh auth login` to enable team status.' };
+    }
+    const status = {
+        repo: repoFullName,
+        open_prs: [],
+        recent_merges: [],
+        active_branches: [],
+    };
+    // Fetch open PRs
+    const openPRs = ghApi(`repos/${repoFullName}/pulls?state=open&sort=updated&direction=desc&per_page=10`);
+    if (openPRs) {
+        status.open_prs = openPRs.map(pr => ({
+            number: pr.number,
+            title: pr.title,
+            author: pr.user.login,
+            branch: pr.head?.ref || pr.headRefName || '',
+            updated: pr.updated_at || pr.updatedAt || '',
+            draft: pr.draft ?? pr.isDraft ?? false,
+        }));
+    }
+    // Fetch recently merged PRs
+    const mergedPRs = ghApi(`repos/${repoFullName}/pulls?state=closed&sort=updated&direction=desc&per_page=10`);
+    if (mergedPRs) {
+        const sevenDaysAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
+        status.recent_merges = mergedPRs
+            .filter(pr => {
+            const mergedDate = pr.merged_at || pr.mergedAt || pr.updated_at || pr.updatedAt;
+            return mergedDate && new Date(mergedDate) >= sevenDaysAgo;
+        })
+            .map(pr => ({
+            title: pr.title,
+            author: pr.user.login,
+            merged_at: pr.merged_at || pr.mergedAt || pr.updated_at || pr.updatedAt || '',
+        }));
+    }
+    // Fetch branches
+    const branches = ghApi(`repos/${repoFullName}/branches?per_page=20`);
+    if (branches) {
+        const skipBranches = new Set(['main', 'master', 'develop', 'dev', 'staging', 'production']);
+        status.active_branches = branches
+            .filter(b => !skipBranches.has(b.name))
+            .slice(0, 10)
+            .map(b => ({ name: b.name }));
+    }
+    return status;
+}

package/dist/tools/get-decisions.js

@@ -3,14 +3,14 @@ import { detectProject } from '../lib/project-detector.js';
 import * as session from '../lib/session-state.js';
 export const getDecisionsSchema = {
     name: 'get_decisions',
-    description: `Query the team's decision log - technical decisions, patterns, discoveries, and failures recorded during agent sessions.
-
-Use when:
-- Before making an architecture or technology choice (see what the team decided before)
-- When someone asks "why did we do X this way?"
-- When evaluating alternatives for a new approach
-- To check if something was tried before and failed
-
+    description: `Query the team's decision log - technical decisions, patterns, discoveries, and failures recorded during agent sessions.
+
+Use when:
+- Before making an architecture or technology choice (see what the team decided before)
+- When someone asks "why did we do X this way?"
+- When evaluating alternatives for a new approach
+- To check if something was tried before and failed
+
 Returns structured decisions with rationale, alternatives considered, and anti-pattern warnings.`,
     inputSchema: {
         type: 'object',

package/dist/tools/get-project-context.js

@@ -4,8 +4,8 @@ import { gatherSignals } from '../lib/signal-gatherer.js';
 import { fuseSignals } from '../lib/signal-fusion.js';
 export const getProjectContextSchema = {
     name: 'get_project_context',
-    description: `Show what's new in a project's knowledge feed from Splicr. Only call this when the user explicitly asks to see new saves, recent context, or "what's new." Do NOT call this proactively at session start.
-
+    description: `Show what's new in a project's knowledge feed from Splicr. Only call this when the user explicitly asks to see new saves, recent context, or "what's new." Do NOT call this proactively at session start.
+
 Uses a watermark system — only returns captures saved since the last time context was served for this project. Safe to call repeatedly; it will return empty if nothing is new.`,
     inputSchema: {
         type: 'object',

package/dist/tools/get-team-status.d.ts

@@ -3,12 +3,7 @@ export declare const getTeamStatusSchema: {
     description: string;
     inputSchema: {
         type: "object";
-        properties: {
-            project: {
-                type: "string";
-                description: string;
-            };
-        };
+        properties: {};
     };
 };
 export declare function handleGetTeamStatus(args: Record<string, unknown>): Promise<string>;

package/dist/tools/get-team-status.js

@@ -1,34 +1,22 @@
-import { getTeamStatus } from '../lib/api-client.js';
-import { detectProject } from '../lib/project-detector.js';
+import { getLocalGitHubStatus } from '../lib/github-local.js';
 import * as session from '../lib/session-state.js';
 export const getTeamStatusSchema = {
     name: 'get_team_status',
-    description: `Get a brief on what the team is working on right now. Shows open PRs, active branches, and recent merges from GitHub.
-
-Use when:
-- Starting a session and want to know what's in flight
-- Before starting work on a feature (check if someone else is already on it)
-- To understand recent changes to the codebase
-
-Requires GitHub integration (connected via Splicr dashboard).`,
+    description: `Get a brief on what the team is working on right now. Shows open PRs, active branches, and recent merges from GitHub.
+
+Use when:
+- Starting a session and want to know what's in flight
+- Before starting work on a feature (check if someone else is already on it)
+- To understand recent changes to the codebase
+
+Requires GitHub CLI (gh) to be authenticated. Run \`gh auth login\` if not set up.`,
     inputSchema: {
         type: 'object',
-        properties: {
-            project: { type: 'string', description: 'Project name or "auto" (default: auto)' },
-        },
+        properties: {},
     },
 };
 export async function handleGetTeamStatus(args) {
-    const projectArg = args.project || 'auto';
-    let projectName;
-    if (projectArg === 'auto') {
-        const detected = await detectProject(process.cwd());
-        projectName = detected?.name;
-    }
-    else {
-        projectName = projectArg;
-    }
-    const data = await getTeamStatus({ project: projectName });
+    const data = await getLocalGitHubStatus(process.cwd());
     session.recordToolCall();
     if (data.error) {
         return data.error;

package/dist/tools/save-from-agent.js

@@ -3,20 +3,20 @@ import { detectProject } from '../lib/project-detector.js';
 import * as session from '../lib/session-state.js';
 export const saveFromAgentSchema = {
     name: 'save_from_agent',
-    description: `Save knowledge to Splicr. Call this in two scenarios:
-
-1. When the user explicitly asks to save/remember something
-2. At the end of significant sessions — save decisions, discoveries, and workarounds (NOT routine actions)
-
-For auto-save at session end, include the "context" field with attribution metadata.
-
-**Memory types** (use memory_type to categorize):
-- "fact" — permanent knowledge (API uses X pattern, team decided Y). Default if omitted.
-- "procedural" — reusable how-to (deploy steps, workarounds, setup instructions)
-- "episodic" — session-level context (what happened this session, investigation results)
-- "scratchpad" — short-lived working memory (temp notes, in-progress thinking)
-
-What to save: decisions (chose X over Y because...), discoveries (found undocumented behavior), workarounds (non-obvious fix), synthesis (combined multiple insights).
+    description: `Save knowledge to Splicr. Call this in two scenarios:
+
+1. When the user explicitly asks to save/remember something
+2. At the end of significant sessions — save decisions, discoveries, and workarounds (NOT routine actions)
+
+For auto-save at session end, include the "context" field with attribution metadata.
+
+**Memory types** (use memory_type to categorize):
+- "fact" — permanent knowledge (API uses X pattern, team decided Y). Default if omitted.
+- "procedural" — reusable how-to (deploy steps, workarounds, setup instructions)
+- "episodic" — session-level context (what happened this session, investigation results)
+- "scratchpad" — short-lived working memory (temp notes, in-progress thinking)
+
+What to save: decisions (chose X over Y because...), discoveries (found undocumented behavior), workarounds (non-obvious fix), synthesis (combined multiple insights).
 What NOT to save: file edits (git has those), routine commands, anything derivable from reading the code.`,
     inputSchema: {
         type: 'object',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@splicr/mcp-server",
-  "version": "0.11.0",
+  "version": "0.11.2",
   "description": "Splicr MCP server — route what you read to what you're building",
   "type": "module",
   "bin": "./dist/cli.js",