archsync 1.0.0 → 1.0.1

package/src/parsers/reactParser.js

@@ -1,368 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-
-/**
- * React/Next.js parser — extracts frontend component entities from JSX/TSX files.
- * Detects: components, hooks, API calls, RSC, Next.js App Router patterns,
- *          React Query hooks, Zustand store slices.
- */
-
-const COMPONENT_REGEX = /(?:export\s+)?(?:default\s+)?(?:function|const)\s+(\w+)\s*(?:=\s*(?:React\.memo\s*\()?\s*(?:\(|(?:async\s+)?\()|\()/g;
-const USE_STATE_REGEX = /useState\s*(?:<[^>]+>)?\s*\(\s*([^)]*)\)/g;
-const USE_EFFECT_REGEX = /useEffect\s*\(/g;
-const USE_CONTEXT_REGEX = /useContext\s*\(\s*(\w+)/g;
-const CUSTOM_HOOK_REGEX = /(?:export\s+)?(?:function|const)\s+(use\w+)/g;
-const FETCH_REGEX = /fetch\s*\(\s*['"`]([^'"`]+)['"`]/g;
-const AXIOS_REGEX = /axios\.(get|post|put|patch|delete)\s*\(\s*['"`]([^'"`]+)['"`]/g;
-const NEXT_API_REGEX = /\/api\/([^\s'"`]+)/g;
-const IMPORT_COMPONENT_REGEX = /import\s+(\w+)\s+from\s+['"`]([^'"`]+)['"`]/g;
-const ROUTER_REGEX = /(?:path|route)\s*[:=]\s*['"`]([^'"`]+)['"`]/gi;
-
-// ─── Next.js App Router ───────────────────────────────────────
-// Detects generateMetadata, generateStaticParams, revalidate exports
-const NEXT_METADATA_REGEX = /export\s+(?:async\s+)?function\s+generateMetadata/g;
-const NEXT_STATIC_PARAMS_REGEX = /export\s+(?:async\s+)?function\s+generateStaticParams/g;
-const NEXT_REVALIDATE_REGEX = /export\s+const\s+revalidate\s*=\s*(\d+|false)/g;
-const NEXT_DYNAMIC_REGEX = /export\s+const\s+dynamic\s*=\s*['"`](force-dynamic|force-static|auto|error)['"`]/g;
-
-// ─── React Server Components ──────────────────────────────────
-const USE_CLIENT_DIRECTIVE = /^['"]use client['"]/m;
-const USE_SERVER_DIRECTIVE = /^['"]use server['"]/m;
-const SERVER_ACTION_REGEX = /export\s+(?:async\s+)?function\s+(\w+Action|\w+Handler)\s*\(/g;
-
-// ─── React Query ─────────────────────────────────────────────
-const USE_QUERY_REGEX = /\buseQuery\s*(?:<[^>]+>)?\s*\(\s*(?:\[([^\]]+)\]|{)/g;
-const USE_MUTATION_REGEX = /\buseMutation\s*(?:<[^>]+>)?\s*\(/g;
-const USE_INFINITE_QUERY_REGEX = /\buseInfiniteQuery\s*(?:<[^>]+>)?\s*\(/g;
-const USE_SUSPENSE_QUERY_REGEX = /\buseSuspenseQuery\s*(?:<[^>]+>)?\s*\(/g;
-
-// ─── Zustand ─────────────────────────────────────────────────
-const ZUSTAND_USE_STORE_REGEX = /const\s+(\w+)\s*=\s*(?:create|createStore)\s*(?:<[^>]+>)?\s*\(/g;
-const ZUSTAND_SLICE_EXPORT = /export\s+(?:const|function)\s+(?:use\w+Store|use\w+Slice|\w+Store|\w+Slice)\s*[=(]/g;
-
-export function parseReactFile(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));
-
-    // Determine system from directory structure
-    let system = 'web';
-    if (/admin/i.test(filePath)) system = 'admin';
-    else if (/app|mobile|native/i.test(filePath)) system = 'app';
-
-    let match;
-
-    // ─── Detect RSC / Client boundary ─────────────────────────
-    const isClientComponent = USE_CLIENT_DIRECTIVE.test(source);
-    const isServerComponent = USE_SERVER_DIRECTIVE.test(source) || !isClientComponent;
-
-    // ─── Next.js App Router file patterns ─────────────────────
-    const isAppRouterPage = /[/\\]page\.(tsx?|jsx?)$/.test(filePath);
-    const isAppRouterLayout = /[/\\]layout\.(tsx?|jsx?)$/.test(filePath);
-    const isAppRouterRoute = /[/\\]route\.(tsx?|jsx?)$/.test(filePath);
-    const isAppRouterLoading = /[/\\]loading\.(tsx?|jsx?)$/.test(filePath);
-    const isAppRouterError = /[/\\]error\.(tsx?|jsx?)$/.test(filePath);
-    const isAppRouterNotFound = /[/\\]not-found\.(tsx?|jsx?)$/.test(filePath);
-    const isAppRouterTemplate = /[/\\]template\.(tsx?|jsx?)$/.test(filePath);
-
-    // ─── API Route handlers (Next.js App Router) ──────────────
-    if (isAppRouterRoute) {
-        const HTTP_HANDLER_REGEX = /export\s+(?:async\s+)?function\s+(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\s*\(/g;
-        HTTP_HANDLER_REGEX.lastIndex = 0;
-        while ((match = HTTP_HANDLER_REGEX.exec(source)) !== null) {
-            const method = match[1];
-            // Derive URL path from file path — strip src/app prefix and route.tsx suffix
-            const routePath = filePath
-                .replace(/.*[/\\]app[/\\]/, '/')
-                .replace(/[/\\]route\.(tsx?|jsx?)$/, '')
-                .replace(/\\/g, '/') || '/';
-            entities.push({
-                entityType: 'route',
-                name: `${method} ${routePath}`,
-                system: 'backend',
-                data: {
-                    method,
-                    path: routePath,
-                    kind: 'next-app-router-handler',
-                    serverComponent: true,
-                },
-                metadata: { sourceFile: filePath },
-            });
-        }
-    }
-
-    // ─── Layout / Loading / Error special components ──────────
-    if (isAppRouterLayout || isAppRouterLoading || isAppRouterError || isAppRouterNotFound || isAppRouterTemplate) {
-        const specialType = isAppRouterLayout ? 'layout'
-            : isAppRouterLoading ? 'loading'
-                : isAppRouterError ? 'error'
-                    : isAppRouterNotFound ? 'not-found'
-                        : 'template';
-        const routePath = filePath
-            .replace(/.*[/\\]app[/\\]/, '/')
-            .replace(/[/\\](layout|loading|error|not-found|template)\.(tsx?|jsx?)$/, '')
-            .replace(/\\/g, '/') || '/';
-        entities.push({
-            entityType: 'screen',
-            name: `${specialType}:${routePath || '/'}`,
-            system,
-            data: {
-                componentType: specialType,
-                isServerComponent,
-                appRouter: true,
-            },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // ─── Components ───────────────────────────────────────────
-    COMPONENT_REGEX.lastIndex = 0;
-    while ((match = COMPONENT_REGEX.exec(source)) !== null) {
-        const name = match[1];
-        // Skip hooks and utilities
-        if (name.startsWith('use') || /^[a-z]/.test(name)) continue;
-
-        const isPage = isAppRouterPage || /page|screen|view|layout/i.test(filePath) || /page|screen|view|layout/i.test(name);
-        const isWidget = /widget|card|item|button|input|modal/i.test(name);
-
-        // Avoid duplication with already added special components
-        if (entities.some(e => e.name === name)) continue;
-
-        entities.push({
-            entityType: isPage ? 'screen' : isWidget ? 'widget' : 'screen',
-            name,
-            system,
-            data: {
-                componentType: isPage ? 'page' : 'component',
-                hasState: USE_STATE_REGEX.test(source),
-                hasEffects: USE_EFFECT_REGEX.test(source),
-                isServerComponent: isServerComponent && !isClientComponent,
-                isClientComponent,
-                appRouter: isAppRouterPage || isAppRouterLayout,
-            },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // ─── Server Actions ───────────────────────────────────────
-    if (isServerComponent) {
-        SERVER_ACTION_REGEX.lastIndex = 0;
-        while ((match = SERVER_ACTION_REGEX.exec(source)) !== null) {
-            const actionName = match[1];
-            if (entities.some(e => e.name === actionName)) continue;
-            entities.push({
-                entityType: 'service',
-                name: actionName,
-                system,
-                data: { type: 'server-action', isServerComponent: true },
-                metadata: { sourceFile: filePath },
-            });
-        }
-    }
-
-    // ─── generateMetadata / generateStaticParams ──────────────
-    if (NEXT_METADATA_REGEX.test(source)) {
-        entities.push({
-            entityType: 'service',
-            name: `generateMetadata:${fileName}`,
-            system,
-            data: { type: 'next-metadata', appRouter: true },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    if (NEXT_STATIC_PARAMS_REGEX.test(source)) {
-        entities.push({
-            entityType: 'service',
-            name: `generateStaticParams:${fileName}`,
-            system,
-            data: { type: 'next-static-params', appRouter: true },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // ─── Next.js route segment config (revalidate / dynamic) ──
-    NEXT_REVALIDATE_REGEX.lastIndex = 0;
-    const revalidateMatch = NEXT_REVALIDATE_REGEX.exec(source);
-    NEXT_DYNAMIC_REGEX.lastIndex = 0;
-    const dynamicMatch = NEXT_DYNAMIC_REGEX.exec(source);
-    if (revalidateMatch || dynamicMatch) {
-        entities.push({
-            entityType: 'config',
-            name: `routeConfig:${fileName}`,
-            system,
-            data: {
-                type: 'next-route-config',
-                revalidate: revalidateMatch ? revalidateMatch[1] : undefined,
-                dynamic: dynamicMatch ? dynamicMatch[1] : undefined,
-            },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // ─── Custom Hooks ─────────────────────────────────────────
-    CUSTOM_HOOK_REGEX.lastIndex = 0;
-    while ((match = CUSTOM_HOOK_REGEX.exec(source)) !== null) {
-        const hookName = match[1];
-        if (hookName === 'useState' || hookName === 'useEffect' || hookName === 'useContext') continue;
-        // Skip React Query hooks — handled separately below
-        if (/^use(Query|Mutation|InfiniteQuery|SuspenseQuery)$/.test(hookName)) continue;
-        if (entities.some(e => e.name === hookName)) continue;
-
-        entities.push({
-            entityType: 'service',
-            name: hookName,
-            system,
-            data: { type: 'hook' },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // ─── React Query hooks ────────────────────────────────────
-    // useQuery
-    USE_QUERY_REGEX.lastIndex = 0;
-    let queryCount = 0;
-    while ((match = USE_QUERY_REGEX.exec(source)) !== null) {
-        queryCount++;
-    }
-    if (queryCount > 0) {
-        // Try to find the containing hook/component for naming
-        const enclosingHook = source.match(/(?:function|const)\s+(use\w+)\s*[=(]/)?.[1] || fileName;
-        entities.push({
-            entityType: 'service',
-            name: `useQuery:${enclosingHook}`,
-            system,
-            data: { type: 'react-query', kind: 'useQuery', count: queryCount },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // useMutation
-    USE_MUTATION_REGEX.lastIndex = 0;
-    let mutationCount = 0;
-    while ((match = USE_MUTATION_REGEX.exec(source)) !== null) {
-        mutationCount++;
-    }
-    if (mutationCount > 0) {
-        const enclosingHook = source.match(/(?:function|const)\s+(use\w+)\s*[=(]/)?.[1] || fileName;
-        entities.push({
-            entityType: 'service',
-            name: `useMutation:${enclosingHook}`,
-            system,
-            data: { type: 'react-query', kind: 'useMutation', count: mutationCount },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // useInfiniteQuery
-    USE_INFINITE_QUERY_REGEX.lastIndex = 0;
-    if (USE_INFINITE_QUERY_REGEX.test(source)) {
-        const enclosingHook = source.match(/(?:function|const)\s+(use\w+)\s*[=(]/)?.[1] || fileName;
-        entities.push({
-            entityType: 'service',
-            name: `useInfiniteQuery:${enclosingHook}`,
-            system,
-            data: { type: 'react-query', kind: 'useInfiniteQuery' },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // useSuspenseQuery
-    USE_SUSPENSE_QUERY_REGEX.lastIndex = 0;
-    if (USE_SUSPENSE_QUERY_REGEX.test(source)) {
-        const enclosingHook = source.match(/(?:function|const)\s+(use\w+)\s*[=(]/)?.[1] || fileName;
-        entities.push({
-            entityType: 'service',
-            name: `useSuspenseQuery:${enclosingHook}`,
-            system,
-            data: { type: 'react-query', kind: 'useSuspenseQuery' },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // ─── Zustand store slices ─────────────────────────────────
-    ZUSTAND_USE_STORE_REGEX.lastIndex = 0;
-    while ((match = ZUSTAND_USE_STORE_REGEX.exec(source)) !== null) {
-        const storeName = match[1];
-        if (entities.some(e => e.name === storeName)) continue;
-        entities.push({
-            entityType: 'service',
-            name: storeName,
-            system,
-            data: { type: 'zustand-store' },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    ZUSTAND_SLICE_EXPORT.lastIndex = 0;
-    while ((match = ZUSTAND_SLICE_EXPORT.exec(source)) !== null) {
-        // Extract name from the matched export
-        const sliceMatch = match[0].match(/export\s+(?:const|function)\s+(\w+)/);
-        if (sliceMatch) {
-            const sliceName = sliceMatch[1];
-            if (entities.some(e => e.name === sliceName)) continue;
-            entities.push({
-                entityType: 'service',
-                name: sliceName,
-                system,
-                data: { type: 'zustand-store-slice' },
-                metadata: { sourceFile: filePath },
-            });
-        }
-    }
-
-    // ─── API Calls (generate API reference entities) ──────────
-    // Only the pathname is comparable to backend routes — drop any origin.
-    const toApiPath = (url) => url.replace(/^[a-z][a-z0-9+.-]*:\/\/[^/]+/i, '') || '/';
-
-    FETCH_REGEX.lastIndex = 0;
-    while ((match = FETCH_REGEX.exec(source)) !== null) {
-        const apiUrl = match[1];
-        if (apiUrl.startsWith('http') || apiUrl.startsWith('/api')) {
-            const apiPath = toApiPath(apiUrl);
-            entities.push({
-                entityType: 'api',
-                name: `GET ${apiPath}`,
-                system,
-                data: { method: 'GET', path: apiPath, scope: 'frontend-ref' },
-                metadata: { sourceFile: filePath },
-            });
-        }
-    }
-
-    AXIOS_REGEX.lastIndex = 0;
-    while ((match = AXIOS_REGEX.exec(source)) !== null) {
-        const apiPath = toApiPath(match[2]);
-        entities.push({
-            entityType: 'api',
-            name: `${match[1].toUpperCase()} ${apiPath}`,
-            system,
-            data: { method: match[1].toUpperCase(), path: apiPath, scope: 'frontend-ref' },
-            metadata: { sourceFile: filePath },
-        });
-    }
-
-    // ─── Component Import Relations ───────────────────────────
-    IMPORT_COMPONENT_REGEX.lastIndex = 0;
-    while ((match = IMPORT_COMPONENT_REGEX.exec(source)) !== null) {
-        const importedName = match[1];
-        const importPath = match[2];
-        if (importPath.startsWith('.') && /^[A-Z]/.test(importedName)) {
-            if (entities.length > 0) {
-                relations.push({
-                    source: entities[0].name,
-                    target: importedName,
-                    sourceType: entities[0].entityType,
-                    targetType: 'screen',
-                    sourceSystem: system,
-                    targetSystem: system,
-                    relation: 'navigates',
-                });
-            }
-        }
-    }
-
-    return { filePath, entities, relations };
-}

package/src/parsers/smartComment.js

@@ -1,144 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-
-// Smart comment pattern: // @archsync:<directive> <params>
-const COMMENT_REGEX = /\/\/\s*@archsync:(\w+)\s*(.*)/g;
-const BLOCK_COMMENT_REGEX = /\/\*\*?\s*@archsync:(\w+)\s*([\s\S]*?)\*\//g;
-
-/**
- * Parse ArchSync smart comments from source code.
- * Supports:
- *   // @archsync:entity <type> <name>
- *   // @archsync:relation <source> -> <target> <relation>
- *   // @archsync:system <system>
- *   // @archsync:api <method> <path>
- *   // @archsync:model <name> { field: type, ... }
- *   // @archsync:tag <tag1> <tag2>
- *   // @archsync:description <text>
- *   // @archsync:ignore
- */
-export function parseSmartComments(filePath) {
-    const source = fs.readFileSync(filePath, 'utf-8');
-    const entities = [];
-    const relations = [];
-    let currentSystem = null;
-    let ignoreFile = false;
-
-    const lines = source.split('\n');
-    let currentEntity = null;
-
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const match = line.match(/\/\/\s*@archsync:(\w+)\s*(.*)/);
-        if (!match) continue;
-
-        const [, directive, params] = match;
-        const trimmedParams = params.trim();
-
-        switch (directive) {
-            case 'ignore':
-                ignoreFile = true;
-                break;
-
-            case 'system':
-                currentSystem = trimmedParams;
-                break;
-
-            case 'entity': {
-                const parts = trimmedParams.split(/\s+/);
-                const entityType = parts[0];
-                const name = parts.slice(1).join(' ') || `Unnamed ${entityType}`;
-                currentEntity = {
-                    entityType,
-                    name,
-                    system: currentSystem || 'backend',
-                    data: {},
-                    metadata: { tags: [], sourceLine: i + 1 },
-                };
-                entities.push(currentEntity);
-                break;
-            }
-
-            case 'api': {
-                const parts = trimmedParams.split(/\s+/);
-                const method = parts[0] || 'GET';
-                const apiPath = parts[1] || '/';
-                const name = `${method} ${apiPath}`;
-                currentEntity = {
-                    entityType: 'api',
-                    name,
-                    system: currentSystem || 'backend',
-                    data: { method, path: apiPath, scope: 'public' },
-                    metadata: { tags: [], sourceLine: i + 1 },
-                };
-                entities.push(currentEntity);
-                break;
-            }
-
-            case 'model': {
-                const nameMatch = trimmedParams.match(/^(\w+)\s*(\{.*\})?/);
-                if (nameMatch) {
-                    const name = nameMatch[1];
-                    let fields = {};
-                    if (nameMatch[2]) {
-                        try {
-                            fields = JSON.parse(nameMatch[2].replace(/(\w+):/g, '"$1":'));
-                        } catch { /* skip malformed */ }
-                    }
-                    currentEntity = {
-                        entityType: 'model',
-                        name,
-                        system: currentSystem || 'backend',
-                        data: { attributes: Object.entries(fields).map(([k, v]) => ({ name: k, type: v })) },
-                        metadata: { tags: [], sourceLine: i + 1 },
-                    };
-                    entities.push(currentEntity);
-                }
-                break;
-            }
-
-            case 'relation': {
-                const relMatch = trimmedParams.match(/(\S+)\s*->\s*(\S+)\s*(.*)/);
-                if (relMatch) {
-                    relations.push({
-                        source: relMatch[1],
-                        target: relMatch[2],
-                        relation: relMatch[3].trim() || 'uses',
-                        sourceType: 'unknown',
-                        targetType: 'unknown',
-                    });
-                }
-                break;
-            }
-
-            case 'tag':
-                if (currentEntity) {
-                    currentEntity.metadata.tags.push(...trimmedParams.split(/\s+/));
-                }
-                break;
-
-            case 'description':
-                if (currentEntity) {
-                    currentEntity.description = trimmedParams;
-                }
-                break;
-
-            case 'scope':
-                if (currentEntity && currentEntity.data) {
-                    currentEntity.data.scope = trimmedParams;
-                }
-                break;
-
-            default:
-                // Unknown directive, add as metadata
-                if (currentEntity) {
-                    currentEntity.data[directive] = trimmedParams;
-                }
-                break;
-        }
-    }
-
-    if (ignoreFile) return { filePath, entities: [], relations: [] };
-
-    return { filePath, entities, relations };
-}