@mcp-graph-workflow/mcp-graph 3.0.0

package/dist/core/integrations/gitnexus-queries.js

@@ -0,0 +1,168 @@
+/**
+ * GitNexus query builders and response parsers.
+ * Converts symbol names into Cypher queries and parses GitNexus responses
+ * into structured CodeGraphData and ImpactResult formats.
+ */
+import { logger } from "../utils/logger.js";
+/**
+ * Build a Cypher query to retrieve a symbol's context (related symbols and relations).
+ */
+export function buildContextQuery(symbol) {
+    // Escape single quotes in symbol name to prevent Cypher injection
+    const escaped = symbol.replace(/'/g, "\\'");
+    return `MATCH (s {name: '${escaped}'})-[r:CodeRelation]-(related) RETURN s.name AS sName, s.filePath AS sFile, r.type AS relType, related.name AS rName, related.filePath AS rFile, related.startLine AS rStartLine, related.endLine AS rEndLine LIMIT 50`;
+}
+/**
+ * Build a Cypher query for upstream impact analysis (who depends on this symbol).
+ */
+export function buildImpactQuery(symbol) {
+    const escaped = symbol.replace(/'/g, "\\'");
+    return `MATCH (dep)-[r:CodeRelation]->(s {name: '${escaped}'}) WHERE r.type = 'CALLS' OR r.type = 'IMPORTS' RETURN DISTINCT dep.name AS name, dep.filePath AS file, 1 AS depth LIMIT 30`;
+}
+/**
+ * Calculate risk level based on number of affected symbols.
+ */
+export function calculateRiskLevel(affectedCount) {
+    if (affectedCount > 15)
+        return "high";
+    if (affectedCount >= 5)
+        return "medium";
+    return "low";
+}
+/**
+ * Parse a GitNexus Cypher response into CodeGraphData.
+ * Handles the { result: [...] } format from GitNexus query endpoint.
+ */
+export function parseContextResponse(raw) {
+    const empty = { symbols: [], relations: [] };
+    if (raw == null || typeof raw !== "object")
+        return empty;
+    const records = extractRecords(raw);
+    if (records.length === 0)
+        return empty;
+    const symbolMap = new Map();
+    const relations = [];
+    for (const record of records) {
+        // Flattened format: sName, sFile, relType, rName, rFile, rStartLine, rEndLine
+        const sName = typeof record.sName === "string" ? record.sName : undefined;
+        const rName = typeof record.rName === "string" ? record.rName : undefined;
+        const relType = typeof record.relType === "string" ? record.relType : undefined;
+        if (sName && !symbolMap.has(sName)) {
+            symbolMap.set(sName, {
+                name: sName,
+                kind: "unknown",
+                file: typeof record.sFile === "string" ? record.sFile : undefined,
+            });
+        }
+        if (rName && !symbolMap.has(rName)) {
+            symbolMap.set(rName, {
+                name: rName,
+                kind: "unknown",
+                file: typeof record.rFile === "string" ? record.rFile : undefined,
+                startLine: typeof record.rStartLine === "number" ? record.rStartLine : undefined,
+                endLine: typeof record.rEndLine === "number" ? record.rEndLine : undefined,
+            });
+        }
+        if (sName && rName && relType) {
+            relations.push({
+                from: sName,
+                to: rName,
+                type: relType.toLowerCase(),
+            });
+        }
+        // Fallback: nested node format (legacy)
+        if (!sName) {
+            const s = extractNodeData(record, "s");
+            if (s)
+                symbolMap.set(s.name, s);
+            const related = extractNodeData(record, "related");
+            if (related)
+                symbolMap.set(related.name, related);
+            const legacyRelType = typeof record.relType === "string" ? record.relType : undefined;
+            if (s && related && legacyRelType) {
+                relations.push({ from: s.name, to: related.name, type: legacyRelType.toLowerCase() });
+            }
+        }
+    }
+    return {
+        symbols: Array.from(symbolMap.values()),
+        relations,
+    };
+}
+/**
+ * Parse a GitNexus Cypher impact response into ImpactResult.
+ */
+export function parseImpactResponse(raw, symbol) {
+    const empty = { symbol, affectedSymbols: [], riskLevel: "low" };
+    if (raw == null || typeof raw !== "object")
+        return empty;
+    const records = extractRecords(raw);
+    if (records.length === 0)
+        return empty;
+    const affectedSymbols = [];
+    for (const record of records) {
+        const name = typeof record.name === "string" ? record.name : undefined;
+        const file = typeof record.file === "string" ? record.file : "";
+        const depth = typeof record.depth === "number" ? record.depth : 3;
+        if (name) {
+            // Confidence decreases with depth: d=1 → 1.0, d=2 → 0.7, d=3 → 0.4
+            const confidence = Math.max(0.1, 1.0 - (depth - 1) * 0.3);
+            affectedSymbols.push({ name, file, confidence });
+        }
+    }
+    const riskLevel = calculateRiskLevel(affectedSymbols.length);
+    logger.debug("Parsed impact response", {
+        symbol,
+        affectedCount: affectedSymbols.length,
+        riskLevel,
+    });
+    return { symbol, affectedSymbols, riskLevel };
+}
+// ── Helpers ──────────────────────────────────────────
+/**
+ * Extract records array from various GitNexus response formats.
+ */
+function extractRecords(raw) {
+    if (Array.isArray(raw))
+        return raw;
+    const obj = raw;
+    // { result: [...] } format
+    if (Array.isArray(obj.result))
+        return obj.result;
+    // { data: [...] } format
+    if (Array.isArray(obj.data))
+        return obj.data;
+    // { records: [...] } format
+    if (Array.isArray(obj.records))
+        return obj.records;
+    return [];
+}
+/**
+ * Extract node data from a Cypher result record.
+ */
+function extractNodeData(record, key) {
+    const node = record[key];
+    if (node == null || typeof node !== "object") {
+        // Check for flattened format (e.g., record itself has name/kind)
+        if (key === "s" && typeof record.name === "string") {
+            return {
+                name: record.name,
+                kind: record.kind ?? "unknown",
+                file: record.file,
+            };
+        }
+        return null;
+    }
+    const n = node;
+    const name = typeof n.name === "string" ? n.name : undefined;
+    if (!name)
+        return null;
+    return {
+        name,
+        kind: typeof n.kind === "string" ? n.kind : "unknown",
+        file: typeof n.file === "string" ? n.file : undefined,
+        startLine: typeof n.startLine === "number" ? n.startLine : undefined,
+        endLine: typeof n.endLine === "number" ? n.endLine : undefined,
+    };
+}
+//# sourceMappingURL=gitnexus-queries.js.map

package/dist/core/integrations/gitnexus-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitnexus-queries.js","sourceRoot":"","sources":["../../../src/core/integrations/gitnexus-queries.ts"],"names":[],"mappings":"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"}

package/dist/core/integrations/integration-orchestrator.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Integration Orchestrator — registers event handlers on GraphEventBus
+ * to create a reactive mesh between integrations.
+ *
+ * Handlers:
+ * - import:completed → full reindex knowledge + embeddings
+ * - knowledge:indexed → invalidate RAG cache
+ * - node:created → detect stack for docs fetch
+ */
+import type { GraphEventBus } from "../events/event-bus.js";
+import type { SqliteStore } from "../store/sqlite-store.js";
+export interface OrchestratorOptions {
+    /** Project base path */
+    basePath?: string;
+    /** Enable auto-reindex on import (default: true) */
+    autoReindex?: boolean;
+}
+export interface IntegrationStatus {
+    source: string;
+    lastSync: string | null;
+    documentCount: number;
+    status: "idle" | "syncing" | "error";
+    error?: string;
+}
+export declare class IntegrationOrchestrator {
+    private store;
+    private eventBus;
+    private basePath;
+    private autoReindex;
+    private statuses;
+    constructor(store: SqliteStore, eventBus: GraphEventBus, options?: OrchestratorOptions);
+    /**
+     * Register all event handlers on the bus.
+     */
+    register(): void;
+    /**
+     * Get status of all integrations.
+     */
+    getStatuses(): IntegrationStatus[];
+    /**
+     * Handle import:completed — reindex all knowledge + rebuild embeddings.
+     */
+    private onImportCompleted;
+    /**
+     * Handle knowledge:indexed — log and track.
+     */
+    private onKnowledgeIndexed;
+    private initStatuses;
+    private updateStatus;
+}
+//# sourceMappingURL=integration-orchestrator.d.ts.map

package/dist/core/integrations/integration-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-orchestrator.d.ts","sourceRoot":"","sources":["../../../src/core/integrations/integration-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAQ5D,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,QAAQ,CAAwC;gBAGtD,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,mBAAmB;IAU/B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAchB;;OAEG;IACH,WAAW,IAAI,iBAAiB,EAAE;IAelC;;OAEG;YACW,iBAAiB;IAoC/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,YAAY;CAQrB"}

package/dist/core/integrations/integration-orchestrator.js

@@ -0,0 +1,118 @@
+/**
+ * Integration Orchestrator — registers event handlers on GraphEventBus
+ * to create a reactive mesh between integrations.
+ *
+ * Handlers:
+ * - import:completed → full reindex knowledge + embeddings
+ * - knowledge:indexed → invalidate RAG cache
+ * - node:created → detect stack for docs fetch
+ */
+import { KnowledgeStore } from "../store/knowledge-store.js";
+import { DocsCacheStore } from "../docs/docs-cache-store.js";
+import { EmbeddingStore } from "../rag/embedding-store.js";
+import { indexCachedDocs } from "../rag/docs-indexer.js";
+import { indexAllEmbeddings } from "../rag/rag-pipeline.js";
+import { logger } from "../utils/logger.js";
+export class IntegrationOrchestrator {
+    store;
+    eventBus;
+    basePath;
+    autoReindex;
+    statuses = new Map();
+    constructor(store, eventBus, options) {
+        this.store = store;
+        this.eventBus = eventBus;
+        this.basePath = options?.basePath ?? process.cwd();
+        this.autoReindex = options?.autoReindex ?? true;
+        this.initStatuses();
+    }
+    /**
+     * Register all event handlers on the bus.
+     */
+    register() {
+        if (this.autoReindex) {
+            this.eventBus.on("import:completed", (event) => {
+                void this.onImportCompleted(event);
+            });
+        }
+        this.eventBus.on("knowledge:indexed", (event) => {
+            this.onKnowledgeIndexed(event);
+        });
+        logger.info("IntegrationOrchestrator registered", { autoReindex: this.autoReindex });
+    }
+    /**
+     * Get status of all integrations.
+     */
+    getStatuses() {
+        // Refresh document counts
+        const knowledgeStore = new KnowledgeStore(this.store.getDb());
+        const sourceTypes = ["upload", "serena", "code_context", "docs", "web_capture"];
+        for (const st of sourceTypes) {
+            const existing = this.statuses.get(st);
+            if (existing) {
+                existing.documentCount = knowledgeStore.count(st);
+            }
+        }
+        return Array.from(this.statuses.values());
+    }
+    /**
+     * Handle import:completed — reindex all knowledge + rebuild embeddings.
+     */
+    async onImportCompleted(event) {
+        logger.info("Orchestrator: import completed, reindexing", event.payload);
+        this.updateStatus("docs", "syncing");
+        try {
+            const knowledgeStore = new KnowledgeStore(this.store.getDb());
+            const docsCacheStore = new DocsCacheStore(this.store.getDb());
+            // Re-index docs cache
+            const docsResult = indexCachedDocs(knowledgeStore, docsCacheStore);
+            // Rebuild embeddings
+            const embeddingStore = new EmbeddingStore(this.store);
+            embeddingStore.clear();
+            const embResult = await indexAllEmbeddings(this.store, embeddingStore);
+            this.updateStatus("docs", "idle");
+            this.eventBus.emitTyped("knowledge:indexed", {
+                source: "import_reindex",
+                documentsIndexed: docsResult.documentsIndexed + embResult.nodes + embResult.knowledge,
+            });
+            logger.info("Orchestrator: reindex complete", {
+                docsIndexed: docsResult.documentsIndexed,
+                embeddingNodes: embResult.nodes,
+                embeddingKnowledge: embResult.knowledge,
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            this.updateStatus("docs", "error", message);
+            logger.error("Orchestrator: reindex failed", { error: message });
+        }
+    }
+    /**
+     * Handle knowledge:indexed — log and track.
+     */
+    onKnowledgeIndexed(event) {
+        const source = String(event.payload.source ?? "unknown");
+        logger.info("Orchestrator: knowledge indexed", { source, count: event.payload.documentsIndexed });
+    }
+    initStatuses() {
+        const sourceTypes = ["upload", "serena", "code_context", "docs", "web_capture"];
+        const knowledgeStore = new KnowledgeStore(this.store.getDb());
+        for (const st of sourceTypes) {
+            this.statuses.set(st, {
+                source: st,
+                lastSync: null,
+                documentCount: knowledgeStore.count(st),
+                status: "idle",
+            });
+        }
+    }
+    updateStatus(source, status, error) {
+        const existing = this.statuses.get(source);
+        if (existing) {
+            existing.status = status;
+            existing.lastSync = status === "idle" ? new Date().toISOString() : existing.lastSync;
+            existing.error = error;
+        }
+    }
+}
+//# sourceMappingURL=integration-orchestrator.js.map

package/dist/core/integrations/integration-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-orchestrator.js","sourceRoot":"","sources":["../../../src/core/integrations/integration-orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/core/integrations/mcp-deps-installer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MCP dependencies installer.
+ * Detects and installs ecosystem tools (GitNexus, Serena, Context7, Playwright).
+ * Never throws — returns InstallResult[] with status for each dependency.
+ */
+export type InstallStatus = "installed" | "already_available" | "skipped" | "failed";
+export interface InstallResult {
+    name: string;
+    status: InstallStatus;
+    message: string;
+}
+/**
+ * Check if a command-line tool is available in PATH.
+ */
+export declare function isCommandAvailable(command: string): Promise<boolean>;
+/**
+ * Install/verify all MCP ecosystem dependencies.
+ * Never throws — returns status for each dependency.
+ */
+export declare function installAllMcpDeps(_basePath: string): Promise<InstallResult[]>;
+//# sourceMappingURL=mcp-deps-installer.d.ts.map

package/dist/core/integrations/mcp-deps-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-deps-installer.d.ts","sourceRoot":"","sources":["../../../src/core/integrations/mcp-deps-installer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,mBAAmB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO1E;AAiGD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAcnF"}

package/dist/core/integrations/mcp-deps-installer.js

@@ -0,0 +1,114 @@
+/**
+ * MCP dependencies installer.
+ * Detects and installs ecosystem tools (GitNexus, Serena, Context7, Playwright).
+ * Never throws — returns InstallResult[] with status for each dependency.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { logger } from "../utils/logger.js";
+import { whichCommand } from "../utils/platform.js";
+const execAsync = promisify(execFile);
+/**
+ * Check if a command-line tool is available in PATH.
+ */
+export async function isCommandAvailable(command) {
+    try {
+        await execAsync(whichCommand(), [command]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run a shell command and return success/failure.
+ */
+async function runCommand(cmd, args, timeoutMs = 60000) {
+    try {
+        const { stdout, stderr } = await execAsync(cmd, args, { timeout: timeoutMs });
+        return { ok: true, output: stdout || stderr };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, output: message };
+    }
+}
+async function checkGitNexus() {
+    const name = "gitnexus";
+    const available = await isCommandAvailable("gitnexus");
+    if (available) {
+        logger.info("GitNexus already available", { name });
+        return { name, status: "already_available", message: "gitnexus command found in PATH" };
+    }
+    // Try to verify via npx
+    const npxCheck = await runCommand("npx", ["-y", "gitnexus", "--version"], 30000);
+    if (npxCheck.ok) {
+        logger.success("GitNexus available via npx", { name });
+        return { name, status: "already_available", message: "gitnexus available via npx" };
+    }
+    logger.warn("GitNexus not available", { name, error: npxCheck.output });
+    return { name, status: "failed", message: `gitnexus not available: ${npxCheck.output}` };
+}
+async function checkSerena() {
+    const name = "serena";
+    // Check if uvx is available
+    const uvxAvailable = await isCommandAvailable("uvx");
+    if (uvxAvailable) {
+        logger.info("uvx already available, Serena can be used", { name });
+        return { name, status: "already_available", message: "uvx available — serena can run via uvx" };
+    }
+    // Check if pip/pip3 is available to install uvx
+    const pipCmd = (await isCommandAvailable("pip3")) ? "pip3" : (await isCommandAvailable("pip")) ? "pip" : null;
+    if (!pipCmd) {
+        logger.warn("Python/pip not available, skipping Serena install", { name });
+        return {
+            name,
+            status: "skipped",
+            message: "Python/pip not available. Install Python 3 and run: pip install uvx",
+        };
+    }
+    // Try to install uvx via pip
+    logger.info("Installing uvx via pip", { name, pip: pipCmd });
+    const uvxInstall = await runCommand(pipCmd, ["install", "uvx"], 120000);
+    if (!uvxInstall.ok) {
+        logger.warn("Failed to install uvx", { name, error: uvxInstall.output });
+        return { name, status: "failed", message: `Failed to install uvx: ${uvxInstall.output}` };
+    }
+    logger.success("uvx installed, Serena ready", { name });
+    return { name, status: "installed", message: "uvx installed via pip — serena ready" };
+}
+async function checkContext7() {
+    const name = "context7";
+    const npxAvailable = await isCommandAvailable("npx");
+    if (npxAvailable) {
+        logger.info("Context7 available via npx", { name });
+        return { name, status: "already_available", message: "npx available — context7 runs via npx -y @upstash/context7-mcp" };
+    }
+    return { name, status: "skipped", message: "npx not available" };
+}
+async function checkPlaywright() {
+    const name = "playwright";
+    const npxAvailable = await isCommandAvailable("npx");
+    if (npxAvailable) {
+        logger.info("Playwright MCP available via npx", { name });
+        return { name, status: "already_available", message: "npx available — playwright runs via npx @playwright/mcp@latest" };
+    }
+    return { name, status: "skipped", message: "npx not available" };
+}
+/**
+ * Install/verify all MCP ecosystem dependencies.
+ * Never throws — returns status for each dependency.
+ */
+export async function installAllMcpDeps(_basePath) {
+    logger.info("Checking MCP ecosystem dependencies");
+    const results = await Promise.all([
+        checkGitNexus(),
+        checkSerena(),
+        checkContext7(),
+        checkPlaywright(),
+    ]);
+    const summary = results.map((r) => `${r.name}: ${r.status}`).join(", ");
+    logger.info("MCP dependencies check complete", { summary });
+    return results;
+}
+//# sourceMappingURL=mcp-deps-installer.js.map

package/dist/core/integrations/mcp-deps-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-deps-installer.js","sourceRoot":"","sources":["../../../src/core/integrations/mcp-deps-installer.ts"],"names":[],"mappings":"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"}

package/dist/core/integrations/mcp-servers-config.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Centralized MCP server configuration for all ecosystem tools.
+ * Generates the complete .mcp.json config with all integrated servers.
+ */
+export declare const MCP_SERVER_NAMES: readonly ["mcp-graph", "gitnexus", "serena", "context7", "playwright"];
+export type McpServerName = (typeof MCP_SERVER_NAMES)[number];
+export interface McpServerEntry {
+    command: string;
+    args: string[];
+    type?: string;
+}
+export interface McpServersConfig {
+    mcpServers: Record<string, McpServerEntry>;
+}
+/**
+ * Build complete MCP servers config, optionally merging with existing config.
+ * Standard servers always override existing entries with the same name.
+ * Custom servers (not in MCP_SERVER_NAMES) are preserved.
+ */
+export declare function buildMcpServersConfig(existing?: Partial<McpServersConfig>): McpServersConfig;
+//# sourceMappingURL=mcp-servers-config.d.ts.map

package/dist/core/integrations/mcp-servers-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-servers-config.d.ts","sourceRoot":"","sources":["../../../src/core/integrations/mcp-servers-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,gBAAgB,wEAMnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC5C;AAkCD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACnC,gBAAgB,CAUlB"}

package/dist/core/integrations/mcp-servers-config.js

@@ -0,0 +1,58 @@
+/**
+ * Centralized MCP server configuration for all ecosystem tools.
+ * Generates the complete .mcp.json config with all integrated servers.
+ */
+export const MCP_SERVER_NAMES = [
+    "mcp-graph",
+    "gitnexus",
+    "serena",
+    "context7",
+    "playwright",
+];
+function getDefaultServers() {
+    return {
+        "mcp-graph": {
+            command: "npx",
+            args: ["-y", "@mcp-graph-workflow/mcp-graph"],
+        },
+        gitnexus: {
+            command: "npx",
+            args: ["-y", "gitnexus", "mcp"],
+        },
+        serena: {
+            command: "uvx",
+            args: [
+                "--from",
+                "git+https://github.com/oraios/serena",
+                "serena",
+                "start-mcp-server",
+                "--project",
+                ".",
+            ],
+        },
+        context7: {
+            command: "npx",
+            args: ["-y", "@upstash/context7-mcp"],
+        },
+        playwright: {
+            command: "npx",
+            args: ["@playwright/mcp@latest"],
+        },
+    };
+}
+/**
+ * Build complete MCP servers config, optionally merging with existing config.
+ * Standard servers always override existing entries with the same name.
+ * Custom servers (not in MCP_SERVER_NAMES) are preserved.
+ */
+export function buildMcpServersConfig(existing) {
+    const existingServers = (existing?.mcpServers ?? {});
+    const defaultServers = getDefaultServers();
+    return {
+        mcpServers: {
+            ...existingServers,
+            ...defaultServers,
+        },
+    };
+}
+//# sourceMappingURL=mcp-servers-config.js.map

package/dist/core/integrations/mcp-servers-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-servers-config.js","sourceRoot":"","sources":["../../../src/core/integrations/mcp-servers-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,WAAW;IACX,UAAU;IACV,QAAQ;IACR,UAAU;IACV,YAAY;CACJ,CAAC;AAcX,SAAS,iBAAiB;IACxB,OAAO;QACL,WAAW,EAAE;YACX,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,CAAC,IAAI,EAAE,+BAA+B,CAAC;SAC9C;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC;SAChC;QACD,MAAM,EAAE;YACN,OAAO,EAAE,KAAK;YACd,IAAI,EAAE;gBACJ,QAAQ;gBACR,sCAAsC;gBACtC,QAAQ;gBACR,kBAAkB;gBAClB,WAAW;gBACX,GAAG;aACJ;SACF;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,CAAC,IAAI,EAAE,uBAAuB,CAAC;SACtC;QACD,UAAU,EAAE;YACV,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,CAAC,wBAAwB,CAAC;SACjC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAoC;IAEpC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAmC,CAAC;IACvF,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,OAAO;QACL,UAAU,EAAE;YACV,GAAG,eAAe;YAClB,GAAG,cAAc;SAClB;KACF,CAAC;AACJ,CAAC"}

package/dist/core/integrations/serena-reader.d.ts

@@ -0,0 +1,18 @@
+export interface SerenaMemory {
+    name: string;
+    content: string;
+    sizeBytes: number;
+}
+/**
+ * List all Serena memory files from the project directory (supports nested dirs).
+ */
+export declare function listSerenaMemories(basePath: string): Promise<string[]>;
+/**
+ * Read a specific Serena memory file.
+ */
+export declare function readSerenaMemory(basePath: string, name: string): Promise<SerenaMemory | null>;
+/**
+ * Read all Serena memories at once.
+ */
+export declare function readAllSerenaMemories(basePath: string): Promise<SerenaMemory[]>;
+//# sourceMappingURL=serena-reader.d.ts.map

package/dist/core/integrations/serena-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serena-reader.d.ts","sourceRoot":"","sources":["../../../src/core/integrations/serena-reader.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAyBD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ5E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAanG;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAUrF"}