feat(map): include signatures in export display

- Add signature field to ExportInfo type
- Extract signatures from indexed document metadata
- Display signatures in formatted output (truncated to 60 chars)
- Fall back to name if no signature available

Provides richer context for AI assistants to understand APIs.

Author: prosdev

packages/core/src/map/__tests__/map.test.ts

@@ -69,6 +69,7 @@ describe('Codebase Map', () => {
         path: 'packages/cli/src/cli.ts',
         type: 'function',
         name: 'main',
+        signature: 'function main(args: string[]): Promise<void>',
         startLine: 5,
         endLine: 50,
         language: 'typescript',
@@ -167,6 +168,30 @@ describe('Codebase Map', () => {
       expect(nodeWithExports?.exports?.[0].name).toBeDefined();
     });
 
+    it('should include signatures in exports when available', async () => {
+      const indexer = createMockIndexer();
+      const map = await generateCodebaseMap(indexer, { depth: 5, includeExports: true });
+
+      // Find any node with an export that has a signature
+      const findExportWithSignature = (
+        node: typeof map.root
+      ): { name: string; signature?: string } | null => {
+        if (node.exports) {
+          const withSig = node.exports.find((e) => e.signature);
+          if (withSig) return withSig;
+        }
+        for (const child of node.children) {
+          const found = findExportWithSignature(child);
+          if (found) return found;
+        }
+        return null;
+      };
+
+      const exportWithSig = findExportWithSignature(map.root);
+      expect(exportWithSig).not.toBeNull();
+      expect(exportWithSig?.signature).toBe('function main(args: string[]): Promise<void>');
+    });
+
     it('should not include exports when includeExports is false', async () => {
       const indexer = createMockIndexer();
       const map = await generateCodebaseMap(indexer, { depth: 5, includeExports: false });
@@ -259,6 +284,41 @@ describe('Codebase Map', () => {
       expect(output).toContain('exports:');
     });
 
+    it('should show signatures in exports when available', async () => {
+      const indexer = createMockIndexer();
+      const map = await generateCodebaseMap(indexer, { depth: 5, includeExports: true });
+      const output = formatCodebaseMap(map, { includeExports: true });
+
+      // The main function has a signature, should appear in output
+      expect(output).toContain('function main(args: string[]): Promise<void>');
+    });
+
+    it('should truncate long signatures', async () => {
+      const longSigResults: SearchResult[] = [
+        {
+          id: 'src/index.ts:longFunction:1',
+          score: 0.9,
+          metadata: {
+            path: 'src/index.ts',
+            type: 'function',
+            name: 'longFunction',
+            signature:
+              'function longFunction(param1: string, param2: number, param3: boolean, param4: object): Promise<ComplexReturnType>',
+            exported: true,
+          },
+        },
+      ];
+
+      const indexer = createMockIndexer(longSigResults);
+      const map = await generateCodebaseMap(indexer, { depth: 5, includeExports: true });
+      const output = formatCodebaseMap(map, { includeExports: true });
+
+      // Should be truncated with ...
+      expect(output).toContain('...');
+      // Should not contain the full signature
+      expect(output).not.toContain('ComplexReturnType');
+    });
+
     it('should show component counts', async () => {
       const indexer = createMockIndexer();
       const map = await generateCodebaseMap(indexer);

packages/core/src/map/index.ts

@@ -161,6 +161,7 @@ function extractExports(docs: SearchResult[], maxExports: number): ExportInfo[]
         name: doc.metadata.name as string,
         type: (doc.metadata.type as string) || 'unknown',
         file: (doc.metadata.path as string) || (doc.metadata.file as string) || '',
+        signature: doc.metadata.signature as string | undefined,
       });
 
       if (exports.length >= maxExports) break;
@@ -266,8 +267,16 @@ function formatNode(
   // Add exports if present
   if (opts.includeExports && node.exports && node.exports.length > 0) {
     const exportPrefix = prefix + (isLast ? '    ' : '│   ');
-    const exportNames = node.exports.map((e) => e.name).join(', ');
-    lines.push(`${exportPrefix}└── exports: ${exportNames}`);
+    const exportItems = node.exports.map((e) => {
+      // Use signature if available, otherwise just name
+      if (e.signature) {
+        // Truncate long signatures
+        const sig = e.signature.length > 60 ? `${e.signature.slice(0, 57)}...` : e.signature;
+        return sig;
+      }
+      return e.name;
+    });
+    lines.push(`${exportPrefix}└── exports: ${exportItems.join(', ')}`);
   }
 
   // Format children

packages/core/src/map/types.ts

@@ -31,6 +31,8 @@ export interface ExportInfo {
   type: string;
   /** File where it's defined */
   file: string;
+  /** Function/method signature (if available) */
+  signature?: string;
 }
 
 /**