clast-ai 0.1.2 → 0.2.0

package/src/server/tools/clast-comment.ts

@@ -1,76 +0,0 @@
-import { z } from 'zod';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { ClastDatabase } from '../../db/index.js';
-import type { CommentGenerator } from '../../llm/comment-generator.js';
-
-export function registerCommentTool(
-  server: McpServer,
-  db: ClastDatabase,
-  commentGen: CommentGenerator
-): void {
-  server.tool(
-    'clast_comment',
-    'Get or generate documentation comments for a symbol. By default returns existing comments. Set generate=true to create a new comment via LLM if none exists.',
-    {
-      name: z.string().describe('Symbol name to get/generate comment for'),
-      generate: z.boolean().default(false).describe('If true and no comment exists, generate one via LLM'),
-    },
-    async ({ name, generate }) => {
-      const nodes = db.queries.getNodeByName(name);
-      if (nodes.length === 0) {
-        return {
-          content: [{
-            type: 'text' as const,
-            text: JSON.stringify({ error: `No symbol found with name "${name}"` }),
-          }],
-        };
-      }
-
-      const results = [];
-      for (const node of nodes) {
-        const comments = db.queries.getCommentsForNode(node.id);
-        const original = comments.find(c => c.source === 'original');
-        const generated = comments.find(c => c.source === 'generated');
-
-        const entry: Record<string, unknown> = {
-          name: node.name,
-          type: node.type,
-          filePath: node.file_path,
-          startLine: node.start_line,
-        };
-
-        if (original) {
-          entry.comment = original.text;
-          entry.source = 'original';
-        } else if (generated) {
-          entry.comment = generated.text;
-          entry.source = 'generated';
-        } else if (generate) {
-          if (!commentGen.isAvailable) {
-            entry.error = 'LLM not configured. Set llm.model in clast.config.json.';
-          } else {
-            const result = await commentGen.generateForNode(node.id);
-            if (result) {
-              entry.comment = result;
-              entry.source = 'generated';
-            } else {
-              entry.error = 'Failed to generate comment';
-            }
-          }
-        } else {
-          entry.comment = null;
-          entry.source = null;
-        }
-
-        results.push(entry);
-      }
-
-      return {
-        content: [{
-          type: 'text' as const,
-          text: JSON.stringify(results, null, 2),
-        }],
-      };
-    }
-  );
-}

package/src/server/tools/clast-file-summary.ts

@@ -1,59 +0,0 @@
-import { z } from 'zod';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { ClastDatabase } from '../../db/index.js';
-
-export function registerFileSummaryTool(server: McpServer, db: ClastDatabase): void {
-  server.tool(
-    'clast_file_summary',
-    'Get a structured summary of all symbols in a file, grouped by type (imports, classes, functions, exports, etc.). PREFER THIS over reading an entire file when you need to understand its structure — returns all symbols with line numbers without the noise of implementation details.',
-    {
-      filePath: z.string().describe('Relative file path (forward slashes, e.g. "src/parser/index.ts")'),
-    },
-    async ({ filePath }) => {
-      // Normalize path
-      const normalized = filePath.replace(/\\/g, '/');
-      const nodes = db.queries.getNodesByFile(normalized);
-
-      if (nodes.length === 0) {
-        return {
-          content: [{
-            type: 'text' as const,
-            text: JSON.stringify({ error: `No indexed data for file "${normalized}". Try clast_reindex first.` }),
-          }],
-        };
-      }
-
-      // Group by type
-      const grouped: Record<string, Array<{
-        name: string;
-        signature: string;
-        startLine: number;
-        endLine: number;
-      }>> = {};
-
-      for (const node of nodes) {
-        const group = grouped[node.type] ??= [];
-        group.push({
-          name: node.name,
-          signature: node.signature,
-          startLine: node.start_line,
-          endLine: node.end_line,
-        });
-      }
-
-      const summary = {
-        filePath: normalized,
-        language: nodes[0]?.language,
-        totalSymbols: nodes.length,
-        symbols: grouped,
-      };
-
-      return {
-        content: [{
-          type: 'text' as const,
-          text: JSON.stringify(summary, null, 2),
-        }],
-      };
-    }
-  );
-}

package/src/server/tools/clast-get-context.ts

@@ -1,97 +0,0 @@
-import { z } from 'zod';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { ClastDatabase } from '../../db/index.js';
-
-export function registerGetContextTool(server: McpServer, db: ClastDatabase): void {
-  server.tool(
-    'clast_get_context',
-    'Get full context for a symbol: definition, comments/documentation, callers, callees, and parent class. PREFER THIS over reading entire files when you need to understand a specific function or class before editing. Returns everything needed to make informed code changes.',
-    {
-      name: z.string().describe('Symbol name to look up'),
-      includeBody: z.boolean().default(false).describe('Include the full function/class body text'),
-    },
-    async ({ name, includeBody }) => {
-      const ctx = db.queries.getNodeWithContext(name);
-
-      if (ctx.nodes.length === 0) {
-        return {
-          content: [{
-            type: 'text' as const,
-            text: JSON.stringify({ error: `No symbol found with name "${name}"` }),
-          }],
-        };
-      }
-
-      const result = ctx.nodes.map(node => {
-        const nodeComments = ctx.comments.filter(c => c.node_id === node.id);
-        const entry: Record<string, unknown> = {
-          name: node.name,
-          type: node.type,
-          filePath: node.file_path,
-          location: `${node.file_path}:${node.start_line}-${node.end_line}`,
-          signature: node.signature,
-          language: node.language,
-        };
-
-        if (includeBody) {
-          entry.body = node.body_text;
-        }
-
-        // Comments: prioritize original, also show generated
-        const originalComment = nodeComments.find(c => c.source === 'original');
-        const generatedComment = nodeComments.find(c => c.source === 'generated');
-
-        if (originalComment) {
-          entry.comment = originalComment.text;
-          entry.commentSource = 'original';
-        }
-        if (generatedComment) {
-          entry.generatedDescription = generatedComment.text;
-        }
-
-        // Parent (for methods inside classes)
-        if (node.parent_id) {
-          const parent = db.queries.getNodeById(node.parent_id);
-          if (parent) {
-            entry.parentClass = {
-              name: parent.name,
-              type: parent.type,
-              filePath: parent.file_path,
-              startLine: parent.start_line,
-            };
-          }
-        }
-
-        return entry;
-      });
-
-      // Callers and callees (deduplicated across all matching nodes)
-      const callers = ctx.callers.map(n => ({
-        name: n.name,
-        type: n.type,
-        filePath: n.file_path,
-        startLine: n.start_line,
-        signature: n.signature,
-      }));
-
-      const callees = ctx.callees.map(n => ({
-        name: n.name,
-        type: n.type,
-        filePath: n.file_path,
-        startLine: n.start_line,
-        signature: n.signature,
-      }));
-
-      return {
-        content: [{
-          type: 'text' as const,
-          text: JSON.stringify({
-            definitions: result,
-            callers,
-            callees,
-          }, null, 2),
-        }],
-      };
-    }
-  );
-}

package/src/server/tools/clast-reindex.ts

@@ -1,52 +0,0 @@
-import { z } from 'zod';
-import { join } from 'node:path';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { ClastDatabase } from '../../db/index.js';
-import type { ParserManager } from '../../parser/index.js';
-
-export function registerReindexTool(
-  server: McpServer,
-  db: ClastDatabase,
-  parser: ParserManager,
-  projectRoot: string
-): void {
-  server.tool(
-    'clast_reindex',
-    'Force re-index a specific file or the entire repository. Use when the index seems stale or after large changes.',
-    {
-      filePath: z.string().optional().describe('Specific file to reindex (relative path). Omit to reindex the entire repo.'),
-    },
-    async ({ filePath }) => {
-      if (filePath) {
-        const absPath = join(projectRoot, filePath);
-        const parsed = await parser.incrementalUpdate(absPath, projectRoot, db);
-
-        return {
-          content: [{
-            type: 'text' as const,
-            text: JSON.stringify({
-              file: filePath,
-              reindexed: parsed,
-              message: parsed ? 'File reindexed successfully' : 'File unchanged or unsupported',
-            }),
-          }],
-        };
-      }
-
-      const result = await parser.fullIndex(projectRoot, db);
-
-      return {
-        content: [{
-          type: 'text' as const,
-          text: JSON.stringify({
-            filesProcessed: result.filesProcessed,
-            nodesFound: result.nodesFound,
-            edgesResolved: result.edgesResolved,
-            durationMs: result.durationMs,
-            message: `Full reindex completed in ${result.durationMs}ms`,
-          }),
-        }],
-      };
-    }
-  );
-}

package/src/server/tools/clast-search.ts

@@ -1,38 +0,0 @@
-import { z } from 'zod';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { ClastDatabase } from '../../db/index.js';
-
-export function registerSearchTool(server: McpServer, db: ClastDatabase): void {
-  server.tool(
-    'clast_search',
-    'Search the pre-built AST index for functions, classes, methods, and other symbols by name pattern. PREFER THIS over grep/file search when looking for symbol definitions — it is faster and returns structured results with exact file paths, line numbers, and signatures.',
-    {
-      query: z.string().describe('Search pattern (matches against symbol names, supports partial matches)'),
-      type: z.enum([
-        'function', 'method', 'class', 'interface', 'enum',
-        'import', 'export', 'variable', 'type_alias', 'struct', 'trait', 'module',
-      ]).optional().describe('Filter by symbol type'),
-      limit: z.number().int().min(1).max(100).default(20).describe('Maximum results to return'),
-    },
-    async ({ query, type, limit }) => {
-      const results = db.queries.searchNodes(query, type, limit);
-
-      const formatted = results.map(n => ({
-        name: n.name,
-        type: n.type,
-        filePath: n.file_path,
-        startLine: n.start_line,
-        endLine: n.end_line,
-        signature: n.signature,
-        language: n.language,
-      }));
-
-      return {
-        content: [{
-          type: 'text' as const,
-          text: JSON.stringify(formatted, null, 2),
-        }],
-      };
-    }
-  );
-}

package/src/server/tools/clast-status.ts

@@ -1,37 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { ClastDatabase } from '../../db/index.js';
-import type { FileWatcher } from '../../watcher/index.js';
-
-export function registerStatusTool(
-  server: McpServer,
-  db: ClastDatabase,
-  watcher: FileWatcher
-): void {
-  server.tool(
-    'clast_status',
-    'Show the current indexing status: files indexed, total symbols, total call edges, watcher state, and pending updates.',
-    {},
-    async () => {
-      const status = db.queries.getStatus();
-
-      const result = {
-        filesIndexed: status.files_indexed,
-        totalNodes: status.total_nodes,
-        totalEdges: status.total_edges,
-        totalComments: status.total_comments,
-        lastIndexed: status.last_indexed
-          ? new Date(status.last_indexed).toISOString()
-          : null,
-        watcherActive: watcher.isActive,
-        pendingFiles: watcher.pendingCount,
-      };
-
-      return {
-        content: [{
-          type: 'text' as const,
-          text: JSON.stringify(result, null, 2),
-        }],
-      };
-    }
-  );
-}

package/src/watcher/gitignore.ts

@@ -1,42 +0,0 @@
-import { readFileSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
-
-/**
- * Parse .gitignore files into glob patterns suitable for chokidar's `ignored` option.
- */
-export function loadGitignorePatterns(projectRoot: string): string[] {
-  const patterns: string[] = [];
-  const gitignorePath = join(projectRoot, '.gitignore');
-
-  if (!existsSync(gitignorePath)) return patterns;
-
-  try {
-    const content = readFileSync(gitignorePath, 'utf-8');
-    for (const line of content.split('\n')) {
-      const trimmed = line.trim();
-      // Skip comments and empty lines
-      if (!trimmed || trimmed.startsWith('#')) continue;
-      // Negation patterns are not supported by chokidar's simple ignored
-      if (trimmed.startsWith('!')) continue;
-
-      patterns.push(trimmed);
-    }
-  } catch {
-    // Silently ignore read errors
-  }
-
-  return patterns;
-}
-
-/**
- * Build the full ignored patterns list combining .gitignore and config.
- */
-export function buildIgnorePatterns(
-  projectRoot: string,
-  configIgnored: string[]
-): string[] {
-  const gitignorePatterns = loadGitignorePatterns(projectRoot);
-  // Deduplicate
-  const all = new Set([...configIgnored, ...gitignorePatterns]);
-  return Array.from(all);
-}