archsync 1.0.0 → 1.0.1

package/src/parsers/nodeParser.js

@@ -1,429 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-
-/**
- * Node.js / Express / TypeScript parser — production-grade entity extraction.
- * Detects: routes, controllers (exported arrow fns + classes), services (classes),
- *          middleware, database collections, models, config entries, triggers.
- * Also detects: Fastify routes, tRPC procedures, GraphQL resolvers,
- *               Prisma models, Mongoose models.
- * Also extracts mount-point prefixes from app.use() for route path resolution.
- */
-
-// ─── REGEX LIBRARY ───────────────────────────────────────────
-const ROUTE_REGEX = /(?:app|router)\.(get|post|put|patch|delete|all)\s*\(\s*['"`]([^'"`]+)['"`]/gi;
-const CLASS_REGEX = /class\s+(\w+)\s*(?:extends\s+(\w+))?\s*(?:implements\s+[\w,\s]+)?\s*\{/g;
-const FUNC_REGEX = /(?:export\s+)?(?:async\s+)?function\s+(\w+)/g;
-const ARROW_EXPORT_REGEX = /export\s+(?:const|let)\s+(\w+)\s*=\s*(?:async\s+)?\(?/g;
-const MONGOOSE_MODEL_REGEX = /mongoose\.model\s*\(\s*['"`](\w+)['"`]/g;
-const SEQUELIZE_MODEL_REGEX = /sequelize\.define\s*\(\s*['"`](\w+)['"`]/g;
-const FIRESTORE_COLLECTION_REGEX = /\.collection\s*\(\s*['"`](\w+)['"`]\s*\)/g;
-const APP_USE_REGEX = /(?:app|router)\.use\s*\(\s*['"`]([^'"`]+)['"`]\s*,\s*(\w+)/g;
-const MIDDLEWARE_USE_REGEX = /(?:app|router)\.use\s*\(\s*(\w+)\s*\)/g;
-
-// ─── Fastify ─────────────────────────────────────────────────
-// fastify.get('/path', handler) or fastify.route({ method, url })
-const FASTIFY_ROUTE_REGEX = /(?:fastify|server|app)\.(get|post|put|patch|delete|options|head)\s*\(\s*['"`]([^'"`]+)['"`]/gi;
-const FASTIFY_ROUTE_OBJ_REGEX = /(?:fastify|server|app)\.route\s*\(\s*\{[^}]*method\s*:\s*['"`]([^'"`]+)['"`][^}]*url\s*:\s*['"`]([^'"`]+)['"`]/gis;
-const FASTIFY_PLUGIN_REGEX = /(?:fastify|server)\.register\s*\(\s*(\w+)\s*(?:,|\))/g;
-
-// ─── tRPC ─────────────────────────────────────────────────────
-// t.procedure.query / t.procedure.mutation / router({ ... })
-const TRPC_PROC_NAME_REGEX = /(\w+)\s*:\s*(?:publicProcedure|protectedProcedure|procedure|t\.procedure)[^,}]*/g;
-
-// ─── GraphQL ──────────────────────────────────────────────────
-const GQL_TYPE_DEF_REGEX = /typeDefs?\s*=\s*(?:gql|`)/g;
-const GQL_QUERY_MUTATION_REGEX = /(?:Query|Mutation|Subscription)\s*:\s*\{([^}]+)\}/gs;
-
-// ─── Prisma ───────────────────────────────────────────────────
-// prisma.modelName.findMany / create / etc.
-const PRISMA_MODEL_ACCESS_REGEX = /prisma\.(\w+)\.(findMany|findUnique|findFirst|create|update|delete|upsert|count|aggregate)/g;
-const PRISMA_MODEL_DEF_REGEX = /^model\s+(\w+)\s*\{/gm;  // for .prisma schema files
-
-// ─── Mongoose (enhanced) ──────────────────────────────────────
-const MONGOOSE_SCHEMA_VAR_REGEX = /(?:const|let|var)\s+(\w+Schema)\s*=\s*new\s+(?:mongoose\.)?Schema/g;
-
-export function parseNodeFile(filePath) {
-    const source = fs.readFileSync(filePath, 'utf-8');
-    const entities = [];
-    const relations = [];
-    const fileName = path.basename(filePath, path.extname(filePath));
-    const dirName = path.basename(path.dirname(filePath));
-    const ext = path.extname(filePath);
-
-    // Infer system from path
-    let system = 'backend';
-    if (/\/mobile\/|\/app\/(?!routes)/i.test(filePath)) system = 'app';
-    else if (/\/web\/|\/client\/|\/frontend\/|\/pages\//i.test(filePath)) system = 'web';
-    else if (/\/admin\//i.test(filePath) && !/\/routes\/admin/i.test(filePath)) system = 'admin';
-
-    // Infer file role from path
-    const isControllerFile = /controller/i.test(filePath);
-    const isServiceFile = /service/i.test(filePath);
-    const isMiddlewareFile = /middleware/i.test(filePath);
-    const isRouteFile = /route/i.test(filePath);
-    const isModelFile = /model|schema|entity/i.test(filePath);
-    const isTriggerFile = /trigger/i.test(filePath);
-    const isConfigFile = /config/i.test(filePath);
-    const isScheduledFile = /scheduled|cron|job/i.test(filePath);
-    const isPrismaSchema = ext === '.prisma';
-    const isResolverFile = /resolver/i.test(filePath);
-    const isFastifyFile = /fastify|server/i.test(filePath) || source.includes('fastify');
-
-    let match;
-
-    // ═══ 1. ROUTES (Express) ═════════════════════════════════
-    ROUTE_REGEX.lastIndex = 0;
-    while ((match = ROUTE_REGEX.exec(source)) !== null) {
-        const method = match[1].toUpperCase();
-        const routePath = match[2];
-        const line = source.substring(0, match.index).split('\n').length;
-        entities.push({
-            entityType: 'route',
-            name: `${method} ${routePath}`,
-            system: 'backend',
-            data: { method, path: routePath, framework: 'express' },
-            metadata: { sourceFile: filePath, line },
-        });
-    }
-
-    // ═══ 2. FASTIFY ROUTES ═══════════════════════════════════
-    FASTIFY_ROUTE_REGEX.lastIndex = 0;
-    while (isFastifyFile && (match = FASTIFY_ROUTE_REGEX.exec(source)) !== null) {
-        const method = match[1].toUpperCase();
-        const routePath = match[2];
-        const line = source.substring(0, match.index).split('\n').length;
-        // Avoid duplicating if express regex already caught it
-        const key = `${method} ${routePath}`;
-        if (entities.some(e => e.name === key && e.entityType === 'route')) continue;
-        entities.push({
-            entityType: 'route',
-            name: key,
-            system: 'backend',
-            data: { method, path: routePath, framework: 'fastify' },
-            metadata: { sourceFile: filePath, line },
-        });
-    }
-
-    FASTIFY_ROUTE_OBJ_REGEX.lastIndex = 0;
-    while ((match = FASTIFY_ROUTE_OBJ_REGEX.exec(source)) !== null) {
-        const method = match[1].toUpperCase();
-        const routePath = match[2];
-        const key = `${method} ${routePath}`;
-        if (entities.some(e => e.name === key && e.entityType === 'route')) continue;
-        entities.push({
-            entityType: 'route',
-            name: key,
-            system: 'backend',
-            data: { method, path: routePath, framework: 'fastify', style: 'route-object' },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // Fastify plugin registrations
-    FASTIFY_PLUGIN_REGEX.lastIndex = 0;
-    while ((match = FASTIFY_PLUGIN_REGEX.exec(source)) !== null) {
-        const pluginName = match[1];
-        if (['cors', 'helmet', 'multipart', 'formbody', 'cookie', 'jwt', 'auth'].includes(pluginName)) continue;
-        entities.push({
-            entityType: 'module',
-            name: `plugin:${pluginName}`,
-            system: 'backend',
-            data: { kind: 'fastify-plugin', plugin: pluginName },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // ═══ 3. tRPC PROCEDURES ══════════════════════════════════
-    TRPC_PROC_NAME_REGEX.lastIndex = 0;
-    while ((match = TRPC_PROC_NAME_REGEX.exec(source)) !== null) {
-        const procName = match[1];
-        if (['default', 'router', 'middleware', 'use'].includes(procName)) continue;
-        // Determine procedure type from context
-        const contextAfter = source.slice(match.index, match.index + 200);
-        const procType = /\.mutation/.test(contextAfter) ? 'mutation'
-            : /\.subscription/.test(contextAfter) ? 'subscription'
-                : 'query';
-        entities.push({
-            entityType: 'route',
-            name: `tRPC:${procName}`,
-            system: 'backend',
-            data: { kind: 'trpc-procedure', procedureType: procType },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // ═══ 4. GRAPHQL RESOLVERS ════════════════════════════════
-    if (isResolverFile || GQL_TYPE_DEF_REGEX.test(source)) {
-        GQL_QUERY_MUTATION_REGEX.lastIndex = 0;
-        while ((match = GQL_QUERY_MUTATION_REGEX.exec(source)) !== null) {
-            const resolverBlock = match[1];
-            const fieldRegex = /(\w+)\s*(?::|:\s*async\s*)?\s*(?:_|resolve|\()/g;
-            let fieldMatch;
-            while ((fieldMatch = fieldRegex.exec(resolverBlock)) !== null) {
-                const resolverName = fieldMatch[1];
-                if (['async', 'resolve', '__resolveType'].includes(resolverName)) continue;
-                entities.push({
-                    entityType: 'service',
-                    name: `resolver:${resolverName}`,
-                    system: 'backend',
-                    data: { kind: 'graphql-resolver' },
-                    metadata: { sourceFile: filePath },
-                });
-            }
-        }
-
-        // Also detect standalone resolver functions
-        if (isResolverFile) {
-            ARROW_EXPORT_REGEX.lastIndex = 0;
-            while ((match = ARROW_EXPORT_REGEX.exec(source)) !== null) {
-                const name = match[1];
-                if (entities.some(e => e.name === `resolver:${name}` || e.name === name)) continue;
-                entities.push({
-                    entityType: 'service',
-                    name: `resolver:${name}`,
-                    system: 'backend',
-                    data: { kind: 'graphql-resolver' },
-                    metadata: { sourceFile: filePath },
-                });
-            }
-        }
-    }
-
-    // ═══ 5. PRISMA MODELS ════════════════════════════════════
-    // From .prisma schema files
-    if (isPrismaSchema) {
-        PRISMA_MODEL_DEF_REGEX.lastIndex = 0;
-        while ((match = PRISMA_MODEL_DEF_REGEX.exec(source)) !== null) {
-            entities.push({
-                entityType: 'model',
-                name: match[1],
-                system: 'backend',
-                data: { orm: 'prisma', kind: 'schema-definition' },
-                metadata: { sourceFile: filePath },
-            });
-        }
-    }
-
-    // From TS/JS files using prisma client
-    PRISMA_MODEL_ACCESS_REGEX.lastIndex = 0;
-    const seenPrismaModels = new Set();
-    while ((match = PRISMA_MODEL_ACCESS_REGEX.exec(source)) !== null) {
-        const modelName = match[1];
-        // Skip internal Prisma client methods
-        if (['$connect', '$disconnect', '$transaction', '$queryRaw', '$executeRaw'].includes(modelName)) continue;
-        if (seenPrismaModels.has(modelName)) continue;
-        seenPrismaModels.add(modelName);
-        entities.push({
-            entityType: 'model',
-            name: modelName,
-            system: 'backend',
-            data: { orm: 'prisma', kind: 'client-usage' },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // ═══ 6. MOUNT POINTS ═════════════════════════════════════
-    APP_USE_REGEX.lastIndex = 0;
-    while ((match = APP_USE_REGEX.exec(source)) !== null) {
-        const prefix = match[1];
-        const routerVar = match[2];
-        entities.push({
-            entityType: 'mount',
-            name: `MOUNT ${prefix}`,
-            system: 'backend',
-            data: { prefix, routerVariable: routerVar },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // ═══ 7. MIDDLEWARE USAGE ══════════════════════════════════
-    MIDDLEWARE_USE_REGEX.lastIndex = 0;
-    while ((match = MIDDLEWARE_USE_REGEX.exec(source)) !== null) {
-        const mwName = match[1];
-        if (['express', 'cors', 'bodyParser', 'json', 'urlencoded', 'morgan', 'helmet', 'compression', 'cookieParser'].includes(mwName)) continue;
-        entities.push({
-            entityType: 'middleware',
-            name: mwName,
-            system: 'backend',
-            data: { scope: 'global' },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // ═══ 8. CLASSES ══════════════════════════════════════════
-    CLASS_REGEX.lastIndex = 0;
-    while ((match = CLASS_REGEX.exec(source)) !== null) {
-        const className = match[1];
-        const parentClass = match[2];
-
-        let entityType = 'service';
-        if (/controller/i.test(className)) entityType = 'controller';
-        else if (/middleware/i.test(className)) entityType = 'middleware';
-        else if (/model|entity|schema/i.test(className)) entityType = 'model';
-        else if (/worker|job|queue/i.test(className)) entityType = 'worker';
-        else if (isServiceFile) entityType = 'service';
-        else if (isControllerFile) entityType = 'controller';
-
-        entities.push({
-            entityType,
-            name: className,
-            system,
-            data: { parentClass: parentClass || null },
-            metadata: { sourceFile: filePath },
-        });
-
-        if (parentClass) {
-            relations.push({
-                source: className, target: parentClass,
-                sourceType: entityType, targetType: 'unknown',
-                relation: 'extends',
-            });
-        }
-    }
-
-    // ═══ 9. EXPORTED FUNCTIONS (controllers / services / middleware) ═══
-    if (isControllerFile || isServiceFile || isMiddlewareFile || isRouteFile) {
-        ARROW_EXPORT_REGEX.lastIndex = 0;
-        while ((match = ARROW_EXPORT_REGEX.exec(source)) !== null) {
-            const funcName = match[1];
-            if (['default', 'module'].includes(funcName)) continue;
-            if (funcName === 'router' || funcName === 'Router') continue;
-
-            const entityType = isControllerFile ? 'controller'
-                : isServiceFile ? 'service'
-                    : isMiddlewareFile ? 'middleware'
-                        : 'controller';
-
-            if (entities.some(e => e.name === funcName)) continue;
-
-            entities.push({
-                entityType,
-                name: funcName,
-                system,
-                data: { kind: 'arrow-export' },
-                metadata: { sourceFile: filePath },
-            });
-        }
-
-        FUNC_REGEX.lastIndex = 0;
-        while ((match = FUNC_REGEX.exec(source)) !== null) {
-            const funcName = match[1];
-            if (['module', 'exports', 'require', 'constructor', 'default'].includes(funcName)) continue;
-            if (entities.some(e => e.name === funcName)) continue;
-
-            const entityType = isControllerFile ? 'controller'
-                : isServiceFile ? 'service'
-                    : isMiddlewareFile ? 'middleware'
-                        : 'service';
-
-            entities.push({
-                entityType,
-                name: funcName,
-                system,
-                data: { kind: 'function-export' },
-                metadata: { sourceFile: filePath },
-            });
-        }
-    }
-
-    // ═══ 10. MONGOOSE MODELS (enhanced) ═══════════════════════
-    MONGOOSE_MODEL_REGEX.lastIndex = 0;
-    while ((match = MONGOOSE_MODEL_REGEX.exec(source)) !== null) {
-        entities.push({
-            entityType: 'model', name: match[1], system: 'backend',
-            data: { orm: 'mongoose', kind: 'model-registration' },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // Mongoose Schema variable declarations (e.g. const UserSchema = new Schema({...}))
-    MONGOOSE_SCHEMA_VAR_REGEX.lastIndex = 0;
-    while ((match = MONGOOSE_SCHEMA_VAR_REGEX.exec(source)) !== null) {
-        const schemaVarName = match[1];
-        // Derive model name from schema variable (UserSchema → User)
-        const modelName = schemaVarName.replace(/Schema$/i, '');
-        if (entities.some(e => e.name === modelName && e.data?.orm === 'mongoose')) continue;
-        entities.push({
-            entityType: 'model', name: modelName, system: 'backend',
-            data: { orm: 'mongoose', kind: 'schema-definition', schemaVar: schemaVarName },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    SEQUELIZE_MODEL_REGEX.lastIndex = 0;
-    while ((match = SEQUELIZE_MODEL_REGEX.exec(source)) !== null) {
-        entities.push({
-            entityType: 'model', name: match[1], system: 'backend',
-            data: { orm: 'sequelize' }, metadata: { sourceFile: filePath },
-        });
-    }
-
-    // ═══ 11. DATABASE COLLECTIONS (Firestore) ════════════════
-    FIRESTORE_COLLECTION_REGEX.lastIndex = 0;
-    const seenCollections = new Set();
-    while ((match = FIRESTORE_COLLECTION_REGEX.exec(source)) !== null) {
-        const coll = match[1];
-        if (seenCollections.has(coll)) continue;
-        seenCollections.add(coll);
-        entities.push({
-            entityType: 'database',
-            name: `collection:${coll}`,
-            system: 'backend',
-            data: { collection: coll, dbType: 'firestore' },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // ═══ 12. TRIGGERS / SCHEDULED FUNCTIONS ═══════════════════
-    if (isTriggerFile || isScheduledFile) {
-        const TRIGGER = /(?:functions|onCall|onRequest|onSchedule|onDocument)\s*\(\s*['"`]?([^'"`)\s,]+)?/g;
-        TRIGGER.lastIndex = 0;
-        while ((match = TRIGGER.exec(source)) !== null) {
-            const triggerName = match[1] || fileName;
-            if (entities.some(e => e.name === triggerName)) continue;
-            entities.push({
-                entityType: isTriggerFile ? 'trigger' : 'worker',
-                name: triggerName,
-                system: 'backend',
-                data: { kind: 'firebase-trigger' },
-                metadata: { sourceFile: filePath },
-            });
-        }
-    }
-
-    // ═══ 13. CONFIG EXPORTS ═══════════════════════════════════
-    if (isConfigFile) {
-        const CONFIG_EXPORT = /export\s+(?:const|let|function)\s+(\w+)/g;
-        CONFIG_EXPORT.lastIndex = 0;
-        while ((match = CONFIG_EXPORT.exec(source)) !== null) {
-            const name = match[1];
-            if (['default'].includes(name)) continue;
-            entities.push({
-                entityType: 'config',
-                name,
-                system: 'backend',
-                data: {},
-                metadata: { sourceFile: filePath },
-            });
-        }
-    }
-
-    // ═══ 14. MIDDLEWARE DEFINITIONS ═══════════════════════════
-    if (isMiddlewareFile && entities.length === 0) {
-        const MW_EXPORT = /export\s+(?:const|function|default\s+function)\s+(\w+)/g;
-        MW_EXPORT.lastIndex = 0;
-        while ((match = MW_EXPORT.exec(source)) !== null) {
-            const name = match[1];
-            entities.push({
-                entityType: 'middleware',
-                name,
-                system: 'backend',
-                data: {},
-                metadata: { sourceFile: filePath },
-            });
-        }
-    }
-
-    return { filePath, entities, relations };
-}

package/src/parsers/pythonParser.js

@@ -1,109 +0,0 @@
-/**
- * Python parser — extracts backend entities from Python source files.
- * Detects: Django models, FastAPI/Flask routes, FastAPI middleware,
- *          SQLAlchemy models, and service/manager classes.
- */
-
-// Django model: class ModelName(models.Model):
-const DJANGO_MODEL_REGEX = /^class\s+(\w+)\s*\(\s*models\.Model\s*\)\s*:/gm;
-
-// SQLAlchemy model: class User(Base):
-const SQLALCHEMY_MODEL_REGEX = /^class\s+(\w+)\s*\(\s*Base\s*\)\s*:/gm;
-
-// FastAPI / Flask route decorators: @app.get("/path"), @router.post("/path"), etc.
-const ROUTE_REGEX = /^@(?:app|router|blueprint)\.(get|post|put|patch|delete|head|options)\s*\(\s*['"]([^'"]+)['"]/gim;
-
-// FastAPI middleware: @app.middleware("http")
-const MIDDLEWARE_REGEX = /^@app\.middleware\s*\(\s*['"]http['"]\s*\)/gm;
-
-// Service / manager classes: class UserService: or class UserManager:
-const SERVICE_REGEX = /^class\s+(\w+(?:Service|Manager|Repository|Handler))\s*(?:\([^)]*\))?\s*:/gm;
-
-function parse(content, filePath) {
-  const entities = [];
-  const relations = [];
-  let m;
-
-  // ─── Django models ────────────────────────────────────────────
-  DJANGO_MODEL_REGEX.lastIndex = 0;
-  while ((m = DJANGO_MODEL_REGEX.exec(content)) !== null) {
-    const name = m[1];
-    entities.push({
-      id: `${filePath}::${name}`,
-      name,
-      type: 'model',
-      filePath,
-      attributes: { framework: 'django' },
-    });
-  }
-
-  // ─── SQLAlchemy models ────────────────────────────────────────
-  SQLALCHEMY_MODEL_REGEX.lastIndex = 0;
-  while ((m = SQLALCHEMY_MODEL_REGEX.exec(content)) !== null) {
-    const name = m[1];
-    // Avoid duplicating if already captured as a Django model
-    if (!entities.find(e => e.name === name && e.type === 'model')) {
-      entities.push({
-        id: `${filePath}::${name}`,
-        name,
-        type: 'model',
-        filePath,
-        attributes: { framework: 'sqlalchemy' },
-      });
-    }
-  }
-
-  // ─── FastAPI middleware ───────────────────────────────────────
-  MIDDLEWARE_REGEX.lastIndex = 0;
-  let middlewareIndex = 0;
-  while ((m = MIDDLEWARE_REGEX.exec(content)) !== null) {
-    // Try to extract the function name on the next non-empty line
-    const afterDecorator = content.slice(m.index + m[0].length);
-    const funcMatch = afterDecorator.match(/^\s*(?:async\s+)?def\s+(\w+)/);
-    const name = funcMatch ? funcMatch[1] : `middleware_${middlewareIndex++}`;
-    entities.push({
-      id: `${filePath}::${name}`,
-      name,
-      type: 'middleware',
-      filePath,
-      attributes: { protocol: 'http' },
-    });
-  }
-
-  // ─── Routes ───────────────────────────────────────────────────
-  ROUTE_REGEX.lastIndex = 0;
-  while ((m = ROUTE_REGEX.exec(content)) !== null) {
-    const method = m[1].toUpperCase();
-    const routePath = m[2];
-    // Try to extract the function name on the next non-empty line after decorator
-    const afterDecorator = content.slice(m.index + m[0].length);
-    const funcMatch = afterDecorator.match(/^\s*(?:async\s+)?def\s+(\w+)/);
-    const name = funcMatch ? funcMatch[1] : `${method}_${routePath.replace(/\//g, '_').replace(/^_/, '')}`;
-    entities.push({
-      id: `${filePath}::${name}`,
-      name,
-      type: 'api',
-      filePath,
-      attributes: { method, path: routePath },
-    });
-  }
-
-  // ─── Services / Managers ─────────────────────────────────────
-  SERVICE_REGEX.lastIndex = 0;
-  while ((m = SERVICE_REGEX.exec(content)) !== null) {
-    const name = m[1];
-    if (!entities.find(e => e.id === `${filePath}::${name}`)) {
-      entities.push({
-        id: `${filePath}::${name}`,
-        name,
-        type: 'service',
-        filePath,
-        attributes: {},
-      });
-    }
-  }
-
-  return { entities, relations };
-}
-
-export { parse };