@letoribo/mcp-graphql-enhanced 3.7.0 → 3.8.0

package/LICENSE

@@ -1,7 +1,7 @@
 MIT License
 
-Copyright (c) 2024 Boris Besemer (Original Work)
-Copyright (c) 2025-2026 [letoribo] (Enhanced Architecture, NPM Refactoring & Discord Graph Infrastructure)
+Copyright (c) 2024 Boris Besemer
+Copyright (c) 2025-2026 letoribo
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -19,19 +19,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
----
-PROJECT EVOLUTION & SOVEREIGNTY NOTE:
-As of mid-2025, this project has undergone a fundamental architectural shift. 
-The legacy Bun-based implementation has been decommissioned and replaced with 
-a surgical, production-ready NPM/Node.js core for maximum stability.
-
-This "Enhanced" version was battle-tested as the architectural engine for the 
-"Neo4j Discord-as-a-Database" project (mcp-neo4j-discord.vercel.app), handling 
-large-scale graph datasets. 
-
-While active real-time data ingestion is currently throttled due to persistent 
-infrastructure challenges and blackouts in Odesa, the codebase remains the 
-sovereign standard for high-performance GraphRAG, 3D visualization interface, 
-and resilient AI intent parsing. Developed under pressure in Odesa, Ukraine.
+SOFTWARE.

package/dist/index.js

@@ -74,7 +74,6 @@ let schemaLoadError = null;
 let isUpdating = false;
 let updatePromise = null;
 let lastKnownTypeCount = 0;
-let expectEmptySchema = false; // Intent flag for intentional purges
 /**
  * Smart Hybrid Schema Fetcher (Zero-Error Version)
  * @param force If true, blocks and waits for the new schema evolution.
@@ -108,15 +107,13 @@ async function getSchema(force = false, requestedTypes) {
     updatePromise = performUpdate(force);
     try {
         if (force || !cachedSDL) {
-            return await updatePromise;
-        }
-        else {
-            updatePromise.catch(err => console.error("[SCHEMA] Background update failed:", err));
-            return cachedSDL;
+            await updatePromise; // Wait for update to complete
+            return cachedSchemaObject;
         }
+        return cachedSchemaObject;
     }
     finally {
-        // Promise reference is cleared inside performUpdate's 'finally' block
+        updatePromise = null;
     }
 }
 /**
@@ -175,11 +172,12 @@ async function performUpdate(force) {
         // Maintain state for "Gap Analysis"
         lastKnownTypeCount = businessTypes.length;
         const currentSDL = printSchema(tempSchema);
-        const duration = ((Date.now() - startTime) / 1000).toFixed(2);
         // --- CACHE & NOTIFICATION ---
+        // Always update the live object if we successfully built it
+        cachedSchemaObject = tempSchema;
         if (currentSDL !== cachedSDL) {
             cachedSDL = currentSDL;
-            cachedSchemaObject = tempSchema; // Store the live Schema object for tool execution
+            const duration = ((Date.now() - startTime) / 1000).toFixed(2);
             return [
                 `✨ SCHEMA EVOLVED (${duration}s)`,
                 `📊 Source: ${env.SCHEMA ? 'Local/Remote SDL' : 'Live Endpoint'}`,
@@ -189,6 +187,7 @@ async function performUpdate(force) {
             ].join('\n');
         }
         else {
+            // Even if SDL string is the same, we've ensured cachedSchemaObject is set above
             return `✅ Status: Schema stable (${lastKnownTypeCount} labels).`;
         }
     }
@@ -270,35 +269,53 @@ toolHandlers.set("query-graphql", queryGraphqlHandler);
     headers: zod_1.default.string().optional(),
 }, queryGraphqlHandler);
 // Tool: introspect-schema
+// --- TOOL: introspect-schema ---
 const introspectHandler = async ({ typeNames }) => {
-    // 1. Always pull the latest schema state
-    // The report from performUpdate is captured to show evolution details
-    const evolutionSummary = await getSchema(true);
-    const schema = cachedSchemaObject;
+    // 1. Fetch the schema directly
+    const result = await getSchema(true);
+    // Explicitly check if the result is an error string or null
+    if (!result || typeof result === 'string') {
+        return {
+            content: [{
+                    type: "text",
+                    text: `❌ SCHEMA_ERROR: ${typeof result === 'string' ? result : 'GraphQL schema is not initialized yet.'}\n` +
+                        `ACTION: Please wait 5-10 seconds for the Neo4j endpoint to respond.`
+                }]
+        };
+    }
+    // TYPE FIX: Cast to GraphQLSchema so TS knows methods like getTypeMap exist
+    const schema = result;
     const typeMap = schema.getTypeMap();
-    // 2. Generate a structural fingerprint
-    const typeKeys = Object.keys(typeMap).filter(t => !t.startsWith('__'));
-    const schemaVersion = `v${typeKeys.length}.${Math.floor(Date.now() / 10000) % 1000}`;
-    // --- GAP ANALYSIS: Check if requested types are actually in the map ---
+    const mutationType = schema.getMutationType();
+    const mutationFields = mutationType ? mutationType.getFields() : {};
+    // --- GAP ANALYSIS ---
     if (typeNames && typeNames.length > 0) {
-        const missing = typeNames.filter(name => !typeMap[name]);
+        const missing = typeNames.filter(name => {
+            const existsAsType = !!typeMap[name];
+            const existsAsMutation = !!mutationFields[name];
+            return !existsAsType && !existsAsMutation;
+        });
         if (missing.length > 0) {
+            const typeKeys = Object.keys(typeMap).filter(t => !t.startsWith('__'));
+            const schemaVersion = `v${typeKeys.length}.${Math.floor(Date.now() / 10000) % 1000}`;
             return {
                 content: [{
                         type: "text",
                         text: `❌ PARTIAL RESULTS [ID: ${schemaVersion}]\n\n` +
-                            `MISSING TYPES: ${missing.join(", ")}\n` +
-                            `REASON: The database has been updated, but the GraphQL Schema is still regenerating these specific types.\n` +
-                            `ACTION: Please wait 3 seconds and retry 'introspect-schema' to see the full graph.\n\n` +
-                            `CURRENTLY AVAILABLE: ${typeKeys.filter(t => !['Query', 'Mutation', 'Report'].includes(t)).join(", ")}`
+                            `MISSING ENTITIES: ${missing.join(", ")}\n` +
+                            `REASON: These specific types or mutations were not found in the current schema map.\n` +
+                            `ACTION: Ensure the names match your Neo4j labels exactly.\n\n` +
+                            `AVAILABLE_ENTITIES: ${typeKeys.filter(t => !['Query', 'Mutation', 'Report'].includes(t)).join(", ")}`
                     }]
             };
         }
     }
+    // 2. Generate General Manifest
     if (!typeNames || typeNames.length === 0) {
         const queryType = schema.getQueryType();
         const discoveredEntities = new Set();
         if (queryType) {
+            // TYPE FIX: Cast fields to Record<string, GraphQLField<any, any>>
             const queryFields = queryType.getFields();
             Object.values(queryFields).forEach((field) => {
                 const namedType = (0, graphql_1.getNamedType)(field.type);
@@ -308,23 +325,19 @@ const introspectHandler = async ({ typeNames }) => {
             });
         }
         const coreEntities = Array.from(discoveredEntities).sort();
-        const communityHeader = [
-            `🌐 Community Channel: #mcp-graphql-enhanced`,
-            `🔗 Join the discussion: https://discord.com/channels/625400653321076807/1480510460339159184`,
-            `---`
-        ].join('\n');
+        const typeKeys = Object.keys(typeMap).filter(t => !t.startsWith('__'));
+        const schemaVersion = `v${typeKeys.length}.${Math.floor(Date.now() / 10000) % 1000}`;
         return {
             content: [{
                     type: "text",
-                    text: `${communityHeader}\n${evolutionSummary}\n\n` + // Include the report from performUpdate
-                        `GraphQL Schema Manifest [ID: ${schemaVersion}]\n\n` +
+                    text: `GraphQL Schema Manifest [ID: ${schemaVersion}]\n\n` +
                         `ENTRY_POINT_ENTITIES: ${coreEntities.join(", ") || "None"}\n` +
                         `TOTAL_SCHEMA_TYPES: ${typeKeys.length}\n\n` +
                         `ALL_AVAILABLE_TYPES: ${typeKeys.join(", ")}`
                 }]
         };
     }
-    // 3. Detailed introspection for specific types
+    // 3. Detailed introspection
     const filtered = (0, introspection_js_1.introspectSpecificTypes)(schema, typeNames);
     return {
         content: [{ type: "text", text: JSON.stringify(filtered, null, 2) }]

package/package.json

@@ -50,5 +50,5 @@
 		"tsx": "^4.21.0",
 		"typescript": "5.8.3"
 	},
-	"version": "3.7.0"
+	"version": "3.8.0"
 }