@flowrelay/mcp-server 1.0.10 → 1.0.12

package/README.md

@@ -9,7 +9,7 @@ It connects to Flow Relay API v1 using an API key and supports:
 ## Package
 
 - Name: @flowrelay/mcp-server
-- Version: 1.0.10
+- Version: 1.0.12
 
 ## What Is Included
 
@@ -20,12 +20,13 @@ The server currently exposes these tools:
 - set_active_project
 - list_filter_options (lists the selectable resources, branches, event types and priorities per source for a project – call this before generating so handoff/insight filters use real values instead of guesses; also reports whether Figma is selectable, since Figma requires the project's processing region to be Global)
 - list_handoffs (returns project-specific handoffs, or an aggregated view of all accessible project handoffs if no project is active; filter by status: active, archived, or all)
+- ask_project (ask a question about a project and get an answer grounded in codebase, baselines and 14 days of activity; 2 credits per question)
 - generate_handoff (processed asynchronously, and the server automatically polls until the job finishes. Requires active project or project_id. Accepts per-source filters: projects, eventTypes, branches, priorities.)
 - generate_correlation_insight (accepts per-source filters)
 - generate_onboarding_brief (accepts per-source filters)
 - generate_architecture_insight (accepts per-source filters)
-
-Selecting Figma in `sources` or `filters` attaches visual context to the generation (rendered frame previews plus the indexed design scene: layout, texts, prototype flows). It works on projects whose processing region is Global and adds a flat 1-credit surcharge per generation.
+- generate_release_notes (generates release notes or PR descriptions from code activity; accepts per-source filters)
+- list_digests (lists past scheduled activity digests for a project)
 - list_insights
 - list_integrations
 - list_events

package/dist/api.d.ts

@@ -162,7 +162,23 @@ export declare class FlowRelayAPI {
     listInsights(projectId: string, kind?: string, status?: string, limit?: number): Promise<{
         insights: InsightResult[];
     }>;
-    generateInsight(projectId: string, kind: 'correlation' | 'onboarding' | 'architecture', body?: Record<string, unknown>): Promise<GenerateInsightResponse>;
+    askProject(projectId: string, question: string, filters?: Record<string, unknown>): Promise<{
+        answer: string;
+        citations: string[];
+    }>;
+    generateInsight(projectId: string, kind: 'correlation' | 'onboarding' | 'architecture' | 'release_notes', body?: Record<string, unknown>): Promise<GenerateInsightResponse>;
+    listDigests(projectId: string, limit?: number): Promise<{
+        digests: Array<{
+            id: string;
+            projectId: string;
+            generatedBy: string;
+            periodStart: string;
+            periodEnd: string;
+            content: Record<string, unknown>;
+            markdown: string;
+            createdAt: string;
+        }>;
+    }>;
     listIntegrations(projectId?: string | null): Promise<{
         integrations: Array<{
             source: string;

package/dist/api.js

@@ -84,12 +84,23 @@ export class FlowRelayAPI {
         params.set('limit', String(limit));
         return this.request(`/projects/${projectId}/insights?${params.toString()}`);
     }
+    async askProject(projectId, question, filters) {
+        return this.request(`/projects/${projectId}/qa`, {
+            method: 'POST',
+            body: JSON.stringify(filters ? { question, filters } : { question }),
+        });
+    }
     async generateInsight(projectId, kind, body) {
         return this.request(`/projects/${projectId}/insights/${kind}`, {
             method: 'POST',
             body: JSON.stringify(body ?? {}),
         });
     }
+    async listDigests(projectId, limit = 10) {
+        const params = new URLSearchParams();
+        params.set('limit', String(limit));
+        return this.request(`/projects/${projectId}/digests?${params.toString()}`);
+    }
     async listIntegrations(projectId) {
         const params = new URLSearchParams();
         if (projectId)

package/dist/index.js

@@ -460,9 +460,45 @@ server.tool('generate_architecture_insight', 'Generate an architecture insight:
     }
 });
 // ── Tool: list insights ─────────────────────────────────────────────
+server.tool('generate_release_notes', 'Generate release notes or a PR description from recent code activity (commits, PRs, builds). Runs synchronously and returns Markdown. Consumes 3 credits on success.', {
+    project_id: z.string().describe('Project id from list_projects.'),
+    source: SourceEnum.default('github').describe('Code source id (github, gitlab, bitbucket, azure_devops).'),
+    repo: z.string().optional().describe('Repository name to scope changes to.'),
+    style: z.enum(['release_notes', 'pr_description']).default('release_notes').describe('Output style.'),
+}, async ({ project_id, source, repo, style }) => {
+    try {
+        const res = await api.generateInsight(project_id, 'release_notes', { source, repo, style });
+        const { job, result } = await api.waitForJob(res.jobId);
+        if (job.status === 'failed' || !result) {
+            const reason = job.error ?? 'unknown error';
+            return { content: [{ type: 'text', text: `Could not generate release notes: ${reason}` }] };
+        }
+        const insight = result;
+        return { content: [{ type: 'text', text: insight.markdown ?? `# ${insight.title}\n\n${insight.summary}` }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Failed: ${err.message}` }] };
+    }
+});
+server.tool('list_digests', 'List past scheduled activity digests for a project.', {
+    project_id: z.string().describe('Project id from list_projects.'),
+    limit: z.number().int().min(1).max(50).default(10).describe('Max digests to return (1-50, default 10).'),
+}, async ({ project_id, limit }) => {
+    try {
+        const { digests } = await api.listDigests(project_id, limit);
+        if (digests.length === 0) {
+            return { content: [{ type: 'text', text: 'No digests found for this project.' }] };
+        }
+        const text = digests.map((d) => d.markdown).join('\n\n---\n\n');
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Failed to list digests: ${err.message}` }] };
+    }
+});
 server.tool('list_insights', 'List existing insights for a project (newest first) with their content. Use this to read what has already been generated before spending credits on a new generate_*_insight. Each row\'s id can be sent to Discord via discord_send_message.', {
     project_id: z.string().describe('Project id from list_projects to list insights for.'),
-    kind: z.enum(['onboarding_brief', 'cross_source_correlation', 'architecture_insight']).optional().describe('Restrict to one kind (matches the three generate_*_insight tools). Omit for all kinds.'),
+    kind: z.enum(['onboarding_brief', 'cross_source_correlation', 'architecture_insight', 'release_notes']).optional().describe('Restrict to one kind. Omit for all kinds.'),
     status: z.enum(['active', 'archived', 'all']).default('active').describe('active = current, archived = superseded, all = both.'),
     limit: z.number().int().min(1).max(50).default(20).describe('Max insights to return (1-50, default 20).'),
 }, async ({ project_id, kind, status, limit }) => {
@@ -480,6 +516,21 @@ server.tool('list_insights', 'List existing insights for a project (newest first
         return { content: [{ type: 'text', text: `Failed to list insights: ${err.message}` }] };
     }
 });
+// ── Tool: ask project ───────────────────────────────────────────────
+server.tool('ask_project', 'Ask one question about a project and get an answer grounded in its indexed codebase, connected baselines and last 14 days of activity. Answers synchronously – there is no job to poll. Costs 2 credits per question, so prefer list_handoffs / list_insights when an existing artifact already answers it.', {
+    question: z.string().min(1).max(2000).describe('The question, 1-2000 characters.'),
+    project_id: z.string().optional().describe('Project scope. Omit to use the active project.'),
+}, async ({ question, project_id }) => {
+    try {
+        const resolved = await requireProject(project_id);
+        const { answer, citations } = await api.askProject(resolved.projectId, question);
+        const refs = citations.length > 0 ? `\n\n_Evidence: ${citations.join(' ')}_` : '';
+        return { content: [{ type: 'text', text: `${answer}${refs}` }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Could not answer: ${err.message}` }] };
+    }
+});
 // ── Tool: list filter options ───────────────────────────────────────
 server.tool('list_filter_options', 'List the real per-source filter values (resources, branches, event types, priorities) available for a project. Call this BEFORE generate_handoff or any generate_*_insight so the "filters" argument uses real values instead of guesses. Pass a resource id into filters[source].projects, a branch name into .branches, an event type into .eventTypes, a priority into .priorities.', {
     project_id: z.string().optional().describe('Project scope. Omit to use the active project.'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowrelay/mcp-server",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "Flow Relay MCP Server for Claude Desktop and Claude Code – handoffs, integrations and context events via natural conversation.",
   "type": "module",
   "license": "MIT",