gitnexus 1.6.4-rc.12 → 1.6.4-rc.13

package/dist/core/ingestion/languages/python.js

@@ -58,6 +58,31 @@ const BUILT_INS = new Set([
     'sum',
     'abs',
 ]);
+function pythonDescriptionExtractor(nodeLabel, _nodeName, captureMap) {
+    if (nodeLabel !== 'Function' && nodeLabel !== 'Method')
+        return undefined;
+    const functionNode = captureMap['definition.function'] ?? captureMap['definition.method'];
+    if (functionNode === undefined)
+        return undefined;
+    return extractPythonDocstring(functionNode);
+}
+function extractPythonDocstring(functionNode) {
+    const body = functionNode.childForFieldName('body');
+    const firstStatement = body?.namedChild(0);
+    if (firstStatement?.type !== 'expression_statement')
+        return undefined;
+    const literal = firstStatement.namedChild(0);
+    if (literal?.type !== 'string')
+        return undefined;
+    return normalizePythonStringLiteral(literal.text);
+}
+function normalizePythonStringLiteral(text) {
+    const match = text.match(/^[rRuUbBfF]*("""|'''|"|')([\s\S]*)\1$/);
+    const raw = match?.[2]?.trim();
+    if (!raw)
+        return undefined;
+    return raw.replace(/\s+/g, ' ');
+}
 export const pythonProvider = defineLanguage({
     id: SupportedLanguages.Python,
     extensions: ['.py'],
@@ -74,6 +99,7 @@ export const pythonProvider = defineLanguage({
     variableExtractor: createVariableExtractor(pythonVariableConfig),
     classExtractor: createClassExtractor(pythonClassConfig),
     heritageExtractor: createHeritageExtractor(SupportedLanguages.Python),
+    descriptionExtractor: pythonDescriptionExtractor,
     builtInNames: BUILT_INS,
     labelOverride: pythonFunctionDefinitionLabel,
     // ── RFC #909 Ring 3: scope-based resolution hooks (RFC §5) ──────────

package/dist/core/ingestion/pipeline-phases/processes.js

@@ -84,12 +84,15 @@ export const processesPhase = {
                 }
                 list.push(url);
             }
-            const toolsByFile = new Map();
+            const toolsByHandlerId = new Map();
+            const toolsWithoutHandlerByFile = new Map();
             for (const td of toolDefs) {
-                let list = toolsByFile.get(td.filePath);
+                const key = td.handlerNodeId ?? td.filePath;
+                const targetMap = td.handlerNodeId ? toolsByHandlerId : toolsWithoutHandlerByFile;
+                let list = targetMap.get(key);
                 if (!list) {
                     list = [];
-                    toolsByFile.set(td.filePath, list);
+                    targetMap.set(key, list);
                 }
                 list.push(td.name);
             }
@@ -118,7 +121,9 @@ export const processesPhase = {
                         linked++;
                     }
                 }
-                const toolNames = toolsByFile.get(entryFile);
+                const exactToolNames = toolsByHandlerId.get(proc.entryPointId);
+                const fallbackToolNames = toolsWithoutHandlerByFile.get(entryFile);
+                const toolNames = exactToolNames ?? fallbackToolNames;
                 if (toolNames) {
                     for (const toolName of toolNames) {
                         const toolNodeId = generateId('Tool', toolName);

package/dist/core/ingestion/pipeline-phases/tools.d.ts

@@ -13,6 +13,7 @@ export interface ToolDef {
     name: string;
     filePath: string;
     description: string;
+    handlerNodeId?: string;
 }
 export interface ToolsOutput {
     toolDefs: ToolDef[];

package/dist/core/ingestion/pipeline-phases/tools.js

@@ -23,7 +23,13 @@ export const toolsPhase = {
             if (seenToolNames.has(td.toolName))
                 continue;
             seenToolNames.add(td.toolName);
-            toolDefs.push({ name: td.toolName, filePath: td.filePath, description: td.description });
+            const handlerNodeId = td.handlerNodeId && ctx.graph.getNode(td.handlerNodeId) ? td.handlerNodeId : undefined;
+            toolDefs.push({
+                name: td.toolName,
+                filePath: td.filePath,
+                description: td.description,
+                ...(handlerNodeId !== undefined ? { handlerNodeId } : {}),
+            });
         }
         // TS tool definition arrays — require inputSchema nearby
         const toolCandidatePaths = allPaths.filter((p) => (p.endsWith('.ts') || p.endsWith('.js')) &&
@@ -60,10 +66,10 @@ export const toolsPhase = {
                     label: 'Tool',
                     properties: { name: td.name, filePath: td.filePath, description: td.description },
                 });
-                const handlerFileId = generateId('File', td.filePath);
+                const handlerId = td.handlerNodeId ?? generateId('File', td.filePath);
                 ctx.graph.addRelationship({
-                    id: generateId('HANDLES_TOOL', `${handlerFileId}->${toolNodeId}`),
-                    sourceId: handlerFileId,
+                    id: generateId('HANDLES_TOOL', `${handlerId}->${toolNodeId}`),
+                    sourceId: handlerId,
                     targetId: toolNodeId,
                     type: 'HANDLES_TOOL',
                     confidence: 1.0,

package/dist/core/ingestion/workers/parse-worker.d.ts

@@ -117,6 +117,7 @@ export interface ExtractedToolDef {
     toolName: string;
     description: string;
     lineNumber: number;
+    handlerNodeId?: string;
 }
 export interface ExtractedORMQuery {
     filePath: string;

package/dist/core/ingestion/workers/parse-worker.js

@@ -1668,8 +1668,9 @@ const processFileGroup = (files, language, queryString, result, onFileProcessed)
                             result.toolDefs.push({
                                 filePath: file.path,
                                 toolName: nodeName,
-                                description: dec.arg || '',
+                                description: (dec.arg || description || '').slice(0, 200),
                                 lineNumber: definitionNode.startPosition.row + lineOffset,
+                                handlerNodeId: nodeId,
                             });
                         }
                         fileDecorators.delete(checkLine);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexus",
-  "version": "1.6.4-rc.12",
+  "version": "1.6.4-rc.13",
   "description": "Graph-powered code intelligence for AI agents. Index any codebase, query via MCP or CLI.",
   "author": "Abhigyan Patwari",
   "license": "PolyForm-Noncommercial-1.0.0",