@splicr/mcp-server 0.12.0 → 0.13.0

package/dist/cli.js

@@ -433,6 +433,11 @@ async function runHook() {
             }
         }
         const [{ results }, patternData] = await Promise.all([contextPromise, patternsPromise]);
+        // Build brief section (first message only)
+        let briefSection = '';
+        if (isFirstMessage && patternData.brief) {
+            briefSection = `${patternData.brief}\n\n---\n\n`;
+        }
         // Build patterns section (first message only, deterministic enforcement)
         let patternsSection = '';
         if (isFirstMessage && patternData.patterns && patternData.patterns.length > 0) {
@@ -441,7 +446,7 @@ async function runHook() {
             // Mark patterns as injected for this session
             saveSessionMeta(sessionId, { patterns_injected: true });
         }
-        if ((!results || results.length === 0) && !patternsSection) {
+        if ((!results || results.length === 0) && !patternsSection && !briefSection) {
             process.exit(0);
             return;
         }
@@ -466,7 +471,7 @@ async function runHook() {
             }).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;
+        const context = briefSection + patternsSection + contextSection;
         if (!context.trim()) {
             process.exit(0);
             return;

package/dist/index.js

@@ -16,6 +16,7 @@ import { exploreKnowledgeSchema, handleExploreKnowledge } from './tools/explore-
 import { getDecisionsSchema, handleGetDecisions } from './tools/get-decisions.js';
 import { getTeamStatusSchema, handleGetTeamStatus } from './tools/get-team-status.js';
 import { reviewCodeSchema, handleReviewCode } from './tools/review-code.js';
+import { regenerateBriefSchema, handleRegenerateBrief } from './tools/regenerate-brief.js';
 import { completeSession } from './lib/api-client.js';
 // Prevent unhandled errors from crashing the MCP server
 process.on('uncaughtException', (err) => {
@@ -70,6 +71,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         getDecisionsSchema,
         getTeamStatusSchema,
         reviewCodeSchema,
+        regenerateBriefSchema,
     ],
 }));
 // Handle tool calls with per-tool timeout
@@ -91,6 +93,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             get_decisions: handleGetDecisions,
             get_team_status: handleGetTeamStatus,
             review_code: handleReviewCode,
+            regenerate_brief: handleRegenerateBrief,
         }[name];
         if (!handler) {
             return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };

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

@@ -13,6 +13,7 @@ export declare function getProjectContext(params: {
     results: any[];
     patterns?: any[];
     project_name?: string;
+    brief?: string;
 }>;
 export declare function getRecentInsights(params: {
     days?: number;

package/dist/tools/regenerate-brief.d.ts

@@ -0,0 +1,9 @@
+export declare const regenerateBriefSchema: {
+    name: "regenerate_brief";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+};
+export declare function handleRegenerateBrief(args: Record<string, unknown>): Promise<string>;

package/dist/tools/regenerate-brief.js

@@ -0,0 +1,60 @@
+import { detectProject } from '../lib/project-detector.js';
+import { gatherProjectProfile } from '../lib/profile-gatherer.js';
+import * as session from '../lib/session-state.js';
+import { loadAuth } from '../auth.js';
+import { getSessionId } from '../lib/session-state.js';
+const API_URL = process.env.SPLICR_API_URL || 'https://api-production-d889.up.railway.app';
+export const regenerateBriefSchema = {
+    name: 'regenerate_brief',
+    description: `Regenerate the project onboarding brief. The brief is an auto-generated summary that gives agents instant context about the codebase (architecture, conventions, how-tos, gotchas).
+
+Use when:
+- The brief feels outdated or incomplete
+- After significant project changes (new framework, major refactor)
+- When you want to refresh the project context with latest patterns and learnings
+- On first use if no brief exists yet
+
+The brief is generated from: project patterns, accumulated learnings, local codebase analysis (directory structure, recent commits, tech stack).`,
+    inputSchema: {
+        type: 'object',
+        properties: {},
+    },
+};
+export async function handleRegenerateBrief(args) {
+    const cwd = process.cwd();
+    // Detect project
+    const detected = await detectProject(cwd).catch(() => null);
+    if (!detected) {
+        return 'Could not detect project. Register this project with Splicr first.';
+    }
+    // Gather local profile data for richer brief
+    const profileData = gatherProjectProfile(cwd);
+    // Call API to regenerate
+    const auth = await loadAuth();
+    const res = await fetch(`${API_URL}/mcp/regenerate-brief`, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${auth.accessToken}`,
+            'Content-Type': 'application/json',
+            'X-Splicr-Session-Id': getSessionId(),
+        },
+        body: JSON.stringify({
+            project_name: detected.name,
+            profile_data: {
+                recent_commits: profileData.recent_commits,
+                directory_structure: profileData.directory_structure,
+            },
+        }),
+        signal: AbortSignal.timeout(30000),
+    });
+    session.recordToolCall();
+    if (!res.ok) {
+        const err = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+        return `Brief regeneration failed: ${err.error || res.status}`;
+    }
+    const data = await res.json();
+    if (data.data?.updated) {
+        return `*Brief regenerated for ${detected.name}:*\n\n${data.data.brief}`;
+    }
+    return data.data?.error || 'Brief regeneration produced no result.';
+}

package/package.json

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