@splicr/mcp-server 0.12.0 → 0.13.1

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/lib/profile-gatherer.d.ts

@@ -12,6 +12,9 @@ export interface ProjectProfileData {
     recent_commits: string[];
     tech_stack: string[];
     git_remote_url: string | null;
+    entry_points: string | null;
+    recent_prs: string | null;
+    claude_md_rules: string[];
 }
 /**
  * Gather rich project data from the local filesystem for AI profile generation.

package/dist/lib/profile-gatherer.js

@@ -10,14 +10,18 @@ const GIT_TIMEOUT = 2000;
  * Every operation is individually try/caught — one failure never blocks the rest.
  */
 export function gatherProjectProfile(cwd) {
+    const claudeMd = readFileSafe(join(cwd, 'CLAUDE.md'), MAX_FILE_CHARS);
     return {
-        claude_md: readFileSafe(join(cwd, 'CLAUDE.md'), MAX_FILE_CHARS),
+        claude_md: claudeMd,
         readme: readFileSafe(join(cwd, 'README.md'), MAX_FILE_CHARS),
         package_json_subset: readPackageJson(cwd),
         directory_structure: buildDirectoryTree(cwd),
         recent_commits: getRecentCommits(cwd),
         tech_stack: detectTechStack(cwd),
         git_remote_url: getGitRemoteUrl(cwd),
+        entry_points: scanEntryPoints(cwd),
+        recent_prs: getRecentPRs(cwd),
+        claude_md_rules: extractClaudeMdRules(claudeMd),
     };
 }
 function readFileSafe(path, maxChars) {
@@ -114,6 +118,107 @@ function buildDirectoryTree(cwd) {
     }
     return lines.join('\n') || '(empty)';
 }
+/**
+ * Scan entry point files for architecture context.
+ * Reads the first 80 lines of key files (index.ts, app.ts, routes/, etc.)
+ */
+function scanEntryPoints(cwd) {
+    const candidates = [
+        'src/index.ts', 'src/index.js', 'src/app.ts', 'src/app.js',
+        'src/main.ts', 'src/main.js', 'app.ts', 'index.ts',
+        'src/server.ts', 'src/server.js',
+        'pages/_app.tsx', 'app/layout.tsx', 'app/page.tsx',
+        'src/App.tsx', 'src/App.jsx',
+    ];
+    const found = [];
+    for (const candidate of candidates) {
+        const fullPath = join(cwd, candidate);
+        if (existsSync(fullPath)) {
+            try {
+                const content = readFileSync(fullPath, 'utf-8');
+                const lines = content.split('\n').slice(0, 80);
+                // Extract imports and exports for architecture understanding
+                const importExportLines = lines.filter(l => l.trim().startsWith('import ') || l.trim().startsWith('export ') ||
+                    l.trim().startsWith('app.') || l.trim().startsWith('router.') ||
+                    l.trim().startsWith('const app') || l.trim().startsWith('const server'));
+                if (importExportLines.length > 0) {
+                    found.push(`--- ${candidate} ---\n${importExportLines.join('\n')}`);
+                }
+            }
+            catch { /* skip */ }
+        }
+        if (found.length >= 3)
+            break; // Cap at 3 entry points
+    }
+    // Also scan for route definitions
+    const routeDirs = ['src/routes', 'src/pages', 'src/api', 'app/api', 'routes'];
+    for (const routeDir of routeDirs) {
+        const fullDir = join(cwd, routeDir);
+        if (existsSync(fullDir)) {
+            try {
+                const files = readdirSync(fullDir).filter(f => !f.startsWith('.')).slice(0, 15);
+                found.push(`--- ${routeDir}/ ---\n${files.join(', ')}`);
+            }
+            catch { /* skip */ }
+            break;
+        }
+    }
+    return found.length > 0 ? found.join('\n\n').substring(0, 2000) : null;
+}
+/**
+ * Get recent merged PR titles + descriptions via gh CLI.
+ * Rich "why" context that commit messages lack.
+ */
+function getRecentPRs(cwd) {
+    try {
+        // Check if gh is available
+        execSync('gh auth status', { encoding: 'utf-8', stdio: 'pipe', timeout: 3000 });
+        const result = execSync('gh pr list --state merged --limit 10 --json title,body,mergedAt --jq ".[] | \\"- \\(.title)\\" + if .body != \\"\\" then \\"\\n  \\(.body | split(\\"\\\\n\\") | first)\\" else \\"\\" end"', { cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 5000 }).trim();
+        return result || null;
+    }
+    catch {
+        // gh not available or not in a GitHub repo - try simpler approach
+        try {
+            const result = execSync('gh pr list --state merged --limit 10 --json title --jq ".[].title"', { cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 5000 }).trim();
+            return result ? result.split('\n').map(t => `- ${t}`).join('\n') : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * Extract actionable rules from CLAUDE.md content.
+ * Looks for bullet points, numbered lists, and imperative statements.
+ */
+function extractClaudeMdRules(claudeMd) {
+    if (!claudeMd)
+        return [];
+    const rules = [];
+    const lines = claudeMd.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip headers, empty lines, code blocks, tables
+        if (!trimmed || trimmed.startsWith('#') || trimmed.startsWith('```') ||
+            trimmed.startsWith('|') || trimmed.startsWith('---'))
+            continue;
+        // Look for rule-like patterns
+        const isRule = 
+        // Bullet/numbered items with imperative verbs
+        (/^[-*]\s+(Always|Never|Don't|Do not|Must|Prefer|Avoid|Use|Keep|Follow|Ensure)/i.test(trimmed)) ||
+            (/^\d+\.\s+(Always|Never|Don't|Do not|Must|Prefer|Avoid|Use|Keep|Follow|Ensure)/i.test(trimmed)) ||
+            // Lines containing strong conventions
+            (/\b(must|always|never|required|forbidden|mandatory)\b/i.test(trimmed) && trimmed.length < 200);
+        if (isRule) {
+            // Clean up the rule text
+            const cleaned = trimmed.replace(/^[-*\d.]+\s*/, '').trim();
+            if (cleaned.length > 15 && cleaned.length < 300) {
+                rules.push(cleaned);
+            }
+        }
+    }
+    return rules.slice(0, 20); // Cap at 20 rules
+}
 // Duplicated from signal-gatherer.ts to avoid circular imports
 const KNOWN_TECH = [
     'react', 'next', 'express', 'fastify', 'vue', 'angular', 'svelte',

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.1",
   "description": "Splicr MCP server — route what you read to what you're building",
   "type": "module",
   "bin": "./dist/cli.js",