archsync 1.0.0 → 1.0.2

package/src/parsers/index.js

@@ -1,211 +0,0 @@
-import path from 'path';
-import fs from 'fs';
-import { parseNodeFile } from './nodeParser.js';
-import { parseReactFile } from './reactParser.js';
-import { parseFlutterFile } from './flutterParser.js';
-import { parseSmartComments } from './smartComment.js';
-import { parseWithAST } from './astParser.js';
-import { parse as parsePython } from './pythonParser.js';
-import { parse as parseGo } from './goParser.js';
-import { parse as parseJava } from './javaParser.js';
-import { parse as parseConfig } from './configParser.js';
-
-// Extensions handled by content-based parsers (receive file content, not just path)
-const CONFIG_BASENAMES = new Set(['package.json', 'docker-compose.yml', 'docker-compose.yaml']);
-
-/**
- * Unified file parser — selects the right parser based on file extension and framework config.
- */
-export function parseFile(filePath, options = {}) {
-    const ext = path.extname(filePath).toLowerCase();
-    const basename = path.basename(filePath);
-    const results = [];
-
-    // Always check for smart comments first
-    const smartResult = parseSmartComments(filePath);
-    if (smartResult.entities.length > 0) {
-        results.push(smartResult);
-    }
-
-    // ── Python (.py) ──────────────────────────────────────────────
-    if (ext === '.py') {
-        const content = fs.readFileSync(filePath, 'utf-8');
-        results.push(parsePython(content, filePath));
-        return mergeResults(results, filePath);
-    }
-
-    // ── Go (.go) ──────────────────────────────────────────────────
-    if (ext === '.go') {
-        const content = fs.readFileSync(filePath, 'utf-8');
-        results.push(parseGo(content, filePath));
-        return mergeResults(results, filePath);
-    }
-
-    // ── Java (.java) ──────────────────────────────────────────────
-    if (ext === '.java') {
-        const content = fs.readFileSync(filePath, 'utf-8');
-        results.push(parseJava(content, filePath));
-        return mergeResults(results, filePath);
-    }
-
-    // ── Config files (package.json, docker-compose, .prisma) ─────
-    if (CONFIG_BASENAMES.has(basename) || ext === '.prisma') {
-        const content = fs.readFileSync(filePath, 'utf-8');
-        results.push(parseConfig(content, filePath));
-        return mergeResults(results, filePath);
-    }
-
-    // If AST mode is enabled, use deep parsing
-    if (options.ast && ['.js', '.ts', '.jsx', '.tsx'].includes(ext)) {
-        try {
-            const astResult = parseWithAST(filePath);
-            results.push(astResult);
-            return mergeResults(results, filePath);
-        } catch (err) {
-            // Fall through to regex parsers
-        }
-    }
-
-    // Select regex parser based on extension and framework
-    const framework = options.framework || detectFramework(filePath);
-
-    switch (framework) {
-        case 'react':
-        case 'nextjs':
-            if (['.jsx', '.tsx'].includes(ext)) {
-                results.push(parseReactFile(filePath));
-            } else {
-                results.push(parseNodeFile(filePath));
-            }
-            break;
-
-        case 'flutter':
-            if (ext === '.dart') {
-                results.push(parseFlutterFile(filePath));
-            }
-            break;
-
-        case 'express':
-        case 'nestjs':
-        case 'node':
-        default:
-            if (['.js', '.ts', '.jsx', '.tsx'].includes(ext)) {
-                results.push(parseNodeFile(filePath));
-            }
-            break;
-    }
-
-    return mergeResults(results, filePath);
-}
-
-// Detect framework from file path heuristics
-function detectFramework(filePath) {
-    if (/\.dart$/.test(filePath)) return 'flutter';
-    if (/\.(jsx|tsx)$/.test(filePath)) return 'react';
-    if (/pages\/api\//.test(filePath)) return 'nextjs';
-    return 'node';
-}
-
-// ── CodeSee-style fallback: every source file deserves a node ────────
-// When no parser extracted an entity from a source file, synthesise a
-// generic `module` entity for the file itself. Without this, plain
-// utility/config/hook modules are invisible on the map and import arrows
-// pointing at them are silently dropped.
-const MODULE_FALLBACK_EXTS = new Set(['.js', '.jsx', '.ts', '.tsx', '.dart', '.py', '.go', '.java']);
-
-export function moduleFallbackEntity(filePath, system) {
-    const ext = path.extname(filePath).toLowerCase();
-    if (!MODULE_FALLBACK_EXTS.has(ext)) return null;
-    const name = path.basename(filePath).replace(/\.[^.]+$/, '');
-    if (!name) return null;
-    // Module nodes represent the whole file — snippet is its opening lines
-    let snippet = '';
-    try {
-        snippet = fs.readFileSync(filePath, 'utf-8')
-            .split('\n').slice(0, SNIPPET_LINES)
-            .map(l => (l.length > 160 ? l.slice(0, 160) + '…' : l))
-            .join('\n');
-    } catch { /* unreadable file — no snippet */ }
-    return {
-        entityType: 'module',
-        name,
-        system: system || undefined,
-        data: { kind: 'module', ext },
-        metadata: { sourceFile: filePath, line: 1, snippet },
-    };
-}
-
-// ── Line-number annotation ───────────────────────────────────────────
-// Entities anchor to the exact source line where they're declared so the
-// canvas can point arrows at code positions and deep-link into editors.
-// Parsers that already record metadata.line are left untouched; everything
-// else is located by searching the source for the entity's identifying text.
-const SNIPPET_LINES = 14;
-
-function annotateLines(filePath, entities) {
-    let source;
-    try { source = fs.readFileSync(filePath, 'utf-8'); } catch { return; }
-    const sourceLines = source.split('\n');
-
-    const lineOf = (idx) => {
-        let line = 1;
-        for (let i = 0; i < idx; i++) if (source.charCodeAt(i) === 10) line++;
-        return line;
-    };
-
-    for (const e of entities) {
-        let line = e.metadata?.line;
-        if (!line) {
-            let needle = e.name || '';
-            // "GET /api/users" → search the path; "useQuery:useFoo" → useFoo
-            const api = needle.match(/^[A-Z]+\s+(\/\S+)/);
-            if (api) needle = api[1];
-            else if (needle.includes(':')) needle = needle.split(':').pop();
-
-            line = 1;
-            if (needle && needle.length >= 2) {
-                const idx = source.indexOf(needle);
-                if (idx >= 0) line = lineOf(idx);
-            }
-        }
-        // The actual code at the entity's declaration — what the canvas
-        // shows when a member row is expanded.
-        const snippet = sourceLines
-            .slice(line - 1, line - 1 + SNIPPET_LINES)
-            .map(l => (l.length > 160 ? l.slice(0, 160) + '…' : l))
-            .join('\n');
-        e.metadata = { ...(e.metadata || {}), line, snippet };
-    }
-}
-
-// Merge multiple parser results, deduplicating entities by name+type
-function mergeResults(results, filePath) {
-    const entityMap = new Map();
-    const allRelations = [];
-
-    for (const result of results) {
-        for (const entity of result.entities || []) {
-            const key = `${entity.entityType}:${entity.name}`;
-            if (!entityMap.has(key)) {
-                entityMap.set(key, entity);
-            } else {
-                // Merge data
-                const existing = entityMap.get(key);
-                existing.data = { ...existing.data, ...entity.data };
-                if (entity.metadata?.tags) {
-                    existing.metadata.tags = [...new Set([...(existing.metadata?.tags || []), ...entity.metadata.tags])];
-                }
-            }
-        }
-        allRelations.push(...(result.relations || []));
-    }
-
-    const entities = Array.from(entityMap.values());
-    annotateLines(filePath, entities);
-
-    return {
-        filePath,
-        entities,
-        relations: allRelations,
-    };
-}

package/src/parsers/javaParser.js

@@ -1,89 +0,0 @@
-/**
- * Java parser — extracts backend entities from Java source files.
- * Detects: @RestController, @Service, @Repository, @Entity annotations,
- *          and Spring MVC route mappings.
- */
-
-// Class-level annotations followed (eventually) by a class declaration
-const CLASS_ANNOTATION_REGEX = /(@(?:RestController|Service|Repository|Entity|Controller)(?:\s*\([^)]*\))?(?:\s*\n\s*@\w+(?:\s*\([^)]*\))?)*)\s*(?:public\s+)?(?:abstract\s+)?class\s+(\w+)/g;
-
-// Route mapping annotations: @RequestMapping, @GetMapping, @PostMapping, @PutMapping, @PatchMapping, @DeleteMapping
-const MAPPING_REGEX = /@(RequestMapping|GetMapping|PostMapping|PutMapping|PatchMapping|DeleteMapping)\s*(?:\(\s*(?:value\s*=\s*)?["']([^"']+)["']\s*\))?/g;
-
-function resolveType(annotations) {
-  if (/@RestController/.test(annotations) || /@Controller/.test(annotations)) return 'controller';
-  if (/@Service/.test(annotations)) return 'service';
-  if (/@Repository/.test(annotations)) return 'database';
-  if (/@Entity/.test(annotations)) return 'model';
-  return 'class';
-}
-
-function resolveHttpMethod(mappingAnnotation) {
-  const map = {
-    RequestMapping: 'REQUEST',
-    GetMapping: 'GET',
-    PostMapping: 'POST',
-    PutMapping: 'PUT',
-    PatchMapping: 'PATCH',
-    DeleteMapping: 'DELETE',
-  };
-  return map[mappingAnnotation] || 'REQUEST';
-}
-
-function parse(content, filePath) {
-  const entities = [];
-  const relations = [];
-  let m;
-
-  // ─── Annotated classes ────────────────────────────────────────
-  CLASS_ANNOTATION_REGEX.lastIndex = 0;
-  while ((m = CLASS_ANNOTATION_REGEX.exec(content)) !== null) {
-    const annotations = m[1];
-    const className = m[2];
-    const type = resolveType(annotations);
-
-    const attributes = {};
-
-    // Collect any route mappings that appear within the annotation block or on the class
-    const classMappingMatch = annotations.match(/@RequestMapping\s*\(\s*(?:value\s*=\s*)?["']([^"']+)["']/);
-    if (classMappingMatch) {
-      attributes.baseRoute = classMappingMatch[1];
-    }
-
-    entities.push({
-      id: `${filePath}::${className}`,
-      name: className,
-      type,
-      filePath,
-      attributes,
-    });
-  }
-
-  // ─── Route mappings (method-level) ───────────────────────────
-  MAPPING_REGEX.lastIndex = 0;
-  while ((m = MAPPING_REGEX.exec(content)) !== null) {
-    const annotationName = m[1];
-    const routePath = m[2] || '/';
-    const httpMethod = resolveHttpMethod(annotationName);
-
-    // Try to find the method name immediately after this annotation
-    const afterAnnotation = content.slice(m.index + m[0].length);
-    const methodMatch = afterAnnotation.match(/^\s*(?:@\w+(?:\s*\([^)]*\))?\s*)*(?:public|protected|private)?\s+\w[\w<>,\s]*\s+(\w+)\s*\(/);
-    const methodName = methodMatch ? methodMatch[1] : `${httpMethod}_${routePath.replace(/\//g, '_').replace(/^_/, '')}`;
-
-    const name = `${methodName}`;
-    if (!entities.find(e => e.id === `${filePath}::${name}`)) {
-      entities.push({
-        id: `${filePath}::${name}`,
-        name,
-        type: 'api',
-        filePath,
-        attributes: { method: httpMethod, path: routePath, annotation: annotationName },
-      });
-    }
-  }
-
-  return { entities, relations };
-}
-
-export { parse };