From b272c6864c8da00eff89299d1535485324075ff8 Mon Sep 17 00:00:00 2001 From: Shunsuke Hayashi Date: Sun, 22 Mar 2026 13:32:12 +0900 Subject: [PATCH] docs(schema): add Community and Process node properties to cypher tool description (#411) The cypher tool description and schema resource omit Community and Process node properties, causing agents to write failing queries on first attempt. Added property listings sourced from the actual LadybugDB schema definitions: - Community: heuristicLabel, cohesion, symbolCount, keywords, description, enrichedBy - Process: heuristicLabel, processType, stepCount, communities, entryPointId, terminalId Closes #411 --- gitnexus/src/mcp/resources.ts | 2 ++ gitnexus/src/mcp/tools.ts | 4 ++-- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/gitnexus/src/mcp/resources.ts b/gitnexus/src/mcp/resources.ts index 106a2273e..0349c8dc6 100644 --- a/gitnexus/src/mcp/resources.ts +++ b/gitnexus/src/mcp/resources.ts @@ -327,6 +327,8 @@ node_properties: Function: "parameterCount (INT32), returnType (STRING), isVariadic (BOOL)" Property: "declaredType (STRING) — the field's type annotation (e.g., 'Address', 'City'). Used for field-access chain resolution." Constructor: "parameterCount (INT32)" + Community: "heuristicLabel (STRING), cohesion (DOUBLE), symbolCount (INT32), keywords (STRING[]), description (STRING), enrichedBy (STRING)" + Process: "heuristicLabel (STRING), processType (STRING — 'intra_community' or 'cross_community'), stepCount (INT32), communities (STRING[]), entryPointId (STRING), terminalId (STRING)" relationships: - CONTAINS: File/Folder contains child diff --git a/gitnexus/src/mcp/tools.ts b/gitnexus/src/mcp/tools.ts index b19baadbf..cdb6eb79a 100644 --- a/gitnexus/src/mcp/tools.ts +++ b/gitnexus/src/mcp/tools.ts @@ -110,8 +110,8 @@ OUTPUT: Returns { markdown, row_count } — results formatted as a Markdown tabl TIPS: - All relationships use single CodeRelation table — filter with {type: 'CALLS'} etc. -- Community = auto-detected functional area (Leiden algorithm) -- Process = execution flow trace from entry point to terminal +- Community = auto-detected functional area (Leiden algorithm). Properties: heuristicLabel, cohesion, symbolCount, keywords, description, enrichedBy +- Process = execution flow trace from entry point to terminal. Properties: heuristicLabel, processType, stepCount, communities, entryPointId, terminalId - Use heuristicLabel (not label) for human-readable community/process names`, inputSchema: { type: 'object',