@parseme/cli 0.0.3 → 0.0.5

package/dist/analyzers/framework-detector.js

@@ -1,180 +0,0 @@
-export class FrameworkDetector {
-    config;
-    constructor(config) {
-        this.config = config;
-    }
-    async detect(projectInfo) {
-        const deps = { ...projectInfo.dependencies, ...projectInfo.devDependencies };
-        // Check for frameworks in dependencies
-        if (deps['@nestjs/core'] || deps['@nestjs/common']) {
-            return this.detectNestJS(deps);
-        }
-        if (deps['fastify']) {
-            return this.detectFastify(deps);
-        }
-        if (deps['express']) {
-            return this.detectExpress(deps);
-        }
-        if (deps['koa']) {
-            return this.detectKoa(deps);
-        }
-        if (deps['@hapi/hapi']) {
-            return this.detectHapi(deps);
-        }
-        return {
-            name: 'unknown',
-            features: [],
-        };
-    }
-    detectExpress(deps) {
-        const features = [];
-        // Detect common Express features
-        if (deps['express-session']) {
-            features.push('sessions');
-        }
-        if (deps['passport']) {
-            features.push('authentication');
-        }
-        if (deps['express-rate-limit']) {
-            features.push('rate-limiting');
-        }
-        if (deps['helmet']) {
-            features.push('security');
-        }
-        if (deps['cors']) {
-            features.push('cors');
-        }
-        if (deps['body-parser']) {
-            features.push('body-parsing');
-        }
-        if (deps['express-validator']) {
-            features.push('validation');
-        }
-        if (deps['multer']) {
-            features.push('file-upload');
-        }
-        if (deps['express-static']) {
-            features.push('static-files');
-        }
-        return {
-            name: 'express',
-            version: deps['express'],
-            features,
-        };
-    }
-    detectFastify(deps) {
-        const features = [];
-        if (deps['@fastify/cors']) {
-            features.push('cors');
-        }
-        if (deps['@fastify/helmet']) {
-            features.push('security');
-        }
-        if (deps['@fastify/rate-limit']) {
-            features.push('rate-limiting');
-        }
-        if (deps['@fastify/multipart']) {
-            features.push('file-upload');
-        }
-        if (deps['@fastify/static']) {
-            features.push('static-files');
-        }
-        if (deps['@fastify/jwt']) {
-            features.push('jwt');
-        }
-        if (deps['@fastify/session']) {
-            features.push('sessions');
-        }
-        return {
-            name: 'fastify',
-            version: deps['fastify'],
-            features,
-        };
-    }
-    detectNestJS(deps) {
-        const features = [];
-        if (deps['@nestjs/typeorm'] || deps['@nestjs/mongoose']) {
-            features.push('orm');
-        }
-        if (deps['@nestjs/passport']) {
-            features.push('authentication');
-        }
-        if (deps['@nestjs/jwt']) {
-            features.push('jwt');
-        }
-        if (deps['@nestjs/swagger']) {
-            features.push('swagger');
-        }
-        if (deps['@nestjs/graphql']) {
-            features.push('graphql');
-        }
-        if (deps['@nestjs/websockets']) {
-            features.push('websockets');
-        }
-        if (deps['@nestjs/microservices']) {
-            features.push('microservices');
-        }
-        if (deps['@nestjs/testing']) {
-            features.push('testing');
-        }
-        // NestJS uses decorators by default
-        features.push('decorators', 'dependency-injection', 'modules');
-        return {
-            name: 'nestjs',
-            version: deps['@nestjs/core'],
-            features,
-        };
-    }
-    detectKoa(deps) {
-        const features = [];
-        if (deps['@koa/cors']) {
-            features.push('cors');
-        }
-        if (deps['koa-helmet']) {
-            features.push('security');
-        }
-        if (deps['koa-ratelimit']) {
-            features.push('rate-limiting');
-        }
-        if (deps['koa-multer']) {
-            features.push('file-upload');
-        }
-        if (deps['koa-static']) {
-            features.push('static-files');
-        }
-        if (deps['koa-session']) {
-            features.push('sessions');
-        }
-        if (deps['koa-bodyparser']) {
-            features.push('body-parsing');
-        }
-        return {
-            name: 'koa',
-            version: deps['koa'],
-            features,
-        };
-    }
-    detectHapi(deps) {
-        const features = [];
-        if (deps['@hapi/cookie']) {
-            features.push('sessions');
-        }
-        if (deps['@hapi/jwt']) {
-            features.push('jwt');
-        }
-        if (deps['@hapi/inert']) {
-            features.push('static-files');
-        }
-        if (deps['@hapi/vision']) {
-            features.push('templates');
-        }
-        if (deps['@hapi/boom']) {
-            features.push('error-handling');
-        }
-        return {
-            name: 'hapi',
-            version: deps['@hapi/hapi'],
-            features,
-        };
-    }
-}

package/dist/builders/context-builder.js

@@ -1,386 +0,0 @@
-import { relative, dirname } from 'path';
-export class ContextBuilder {
-    config;
-    constructor(config) {
-        this.config = config;
-    }
-    truncateContent(content, type = 'chars') {
-        const limits = this.config.get().limits;
-        if (!limits) {
-            return content;
-        }
-        const strategy = limits.truncateStrategy || 'truncate';
-        if (type === 'lines') {
-            const lines = content.split('\n');
-            const maxLines = limits.maxLinesPerFile || 1000;
-            if (lines.length > maxLines) {
-                if (strategy === 'split') {
-                    return this.splitContentByLines(lines, maxLines);
-                }
-                else {
-                    const truncated = lines.slice(0, maxLines).join('\n');
-                    return truncated + '\n\n[... truncated for AI compatibility ...]';
-                }
-            }
-        }
-        else {
-            const maxChars = limits.maxCharsPerFile || 50000;
-            if (content.length > maxChars) {
-                if (strategy === 'split') {
-                    return this.splitContentByChars(content, maxChars);
-                }
-                else {
-                    const truncated = content.substring(0, maxChars - 100);
-                    return truncated + '\n\n[... truncated for AI compatibility ...]';
-                }
-            }
-        }
-        return content;
-    }
-    splitContentByLines(lines, maxLines) {
-        const parts = [];
-        const safeMaxLines = maxLines - 5; // Reserve space for split indicators
-        for (let i = 0; i < lines.length; i += safeMaxLines) {
-            const chunk = lines.slice(i, i + safeMaxLines);
-            const partNumber = Math.floor(i / safeMaxLines) + 1;
-            const totalParts = Math.ceil(lines.length / safeMaxLines);
-            let partContent = chunk.join('\n');
-            partContent += `\n\n[... part ${partNumber} of ${totalParts} ...]`;
-            parts.push(partContent);
-        }
-        return parts;
-    }
-    splitContentByChars(content, maxChars) {
-        const parts = [];
-        const safeMaxChars = maxChars - 200; // Reserve space for split indicators
-        for (let i = 0; i < content.length; i += safeMaxChars) {
-            let chunk = content.substring(i, i + safeMaxChars);
-            const partNumber = Math.floor(i / safeMaxChars) + 1;
-            const totalParts = Math.ceil(content.length / safeMaxChars);
-            // Try to break at a reasonable place (newline or word boundary)
-            if (i + safeMaxChars < content.length) {
-                const lastNewline = chunk.lastIndexOf('\n');
-                const lastSpace = chunk.lastIndexOf(' ');
-                const breakPoint = lastNewline > -1 ? lastNewline : lastSpace > -1 ? lastSpace : chunk.length;
-                if (breakPoint > safeMaxChars * 0.8) {
-                    // Only break if we're not losing too much content
-                    chunk = chunk.substring(0, breakPoint);
-                }
-            }
-            chunk += `\n\n[... part ${partNumber} of ${totalParts} ...]`;
-            parts.push(chunk);
-        }
-        return parts;
-    }
-    build(context) {
-        return this.buildMultiFile(context);
-    }
-    buildMultiFile(context) {
-        const { projectInfo, fileAnalyses, gitInfo, contextDir, outputPath } = context;
-        const limits = this.config.get().limits;
-        // Limit number of files analyzed if specified
-        const limitedFileAnalyses = limits?.maxFilesPerContext
-            ? fileAnalyses.slice(0, limits.maxFilesPerContext)
-            : fileAnalyses;
-        // Calculate the relative path for the link in markdown
-        let linkPath = 'parseme-context';
-        if (contextDir && outputPath) {
-            const outputDir = dirname(outputPath);
-            if (contextDir.startsWith('/')) {
-                // Absolute path: calculate relative path from output file to context dir
-                linkPath = relative(outputDir, contextDir);
-            }
-            else {
-                // Relative path: use as-is since it's relative to the output file's directory
-                linkPath = contextDir;
-            }
-        }
-        else if (contextDir) {
-            // Fallback: use contextDir as-is if no outputPath provided
-            linkPath = contextDir;
-        }
-        const mainContent = this.buildHeader(linkPath) +
-            '\n\n\n' +
-            this.buildProjectOverview(projectInfo) +
-            '\n\n\n' +
-            this.buildSummarySection(context, linkPath) +
-            '\n\n\n' +
-            (gitInfo ? this.buildGitSection(gitInfo) : '');
-        const contextFiles = {
-            structure: '',
-            routes: '',
-            dependencies: '',
-        };
-        // Helper function to merge split files into contextFiles
-        const mergeSplitFiles = (result, baseName) => {
-            if (typeof result === 'string') {
-                contextFiles[baseName] = result;
-            }
-            else {
-                // Merge split files into contextFiles
-                Object.entries(result).forEach(([key, value]) => {
-                    contextFiles[key] = value;
-                });
-            }
-        };
-        // Files list (markdown)
-        contextFiles.files = this.buildFilesList(limitedFileAnalyses);
-        // Detailed structure (JSON with AST)
-        const structureResult = this.buildDetailedStructure(limitedFileAnalyses);
-        mergeSplitFiles(structureResult, 'structure');
-        // Routes documentation
-        const routes = limitedFileAnalyses.flatMap((f) => f.routes || []);
-        if (routes.length > 0) {
-            const routesResult = this.buildDetailedRoutes(routes, limitedFileAnalyses);
-            mergeSplitFiles(routesResult, 'api-endpoints');
-        }
-        // Dependencies
-        const dependenciesResult = this.buildDetailedDependencies(projectInfo);
-        mergeSplitFiles(dependenciesResult, 'dependencies');
-        // Framework details
-        if (projectInfo.framework &&
-            projectInfo.framework.name &&
-            projectInfo.framework.name !== 'unknown') {
-            contextFiles.framework = this.buildDetailedFramework(projectInfo.framework);
-        }
-        // Git information
-        if (gitInfo) {
-            contextFiles.gitDiff = this.buildDetailedGit(gitInfo);
-        }
-        return {
-            parseme: mainContent,
-            context: contextFiles,
-        };
-    }
-    buildHeader(linkPath) {
-        return `## PARSEME - AI Agent Context 
-Auto-generated project summary optimized for AI coding agents. This file provides complete project context without requiring full codebase traversal, designed for token efficiency.
-
-**Usage Instructions for AI Agents:**
-1. Read this PARSEME.md file completely first before accessing individual project files
-2. Basic project information, script availability and dependency information provides basic understanding of code base and tech stack without checking package.json
-3. Use the provided file list (${linkPath}/files.md) to see all tracked files in the project
-4. Utilize the structure and AST data (${linkPath}/structure.json) for code analysis without manual parsing
-5. Follow the instruction in the "Git Information" section of this file to validate the actuality of the provided information.
-6. Only dive deeper into specific files after reviewing this summary, that replaces the need for initial project exploration and significantly reduces token usage for project comprehension.`;
-    }
-    buildProjectOverview(projectInfo) {
-        let content = `## Basic Project Information
-
-**Project:** ${projectInfo.name}${projectInfo.version ? ` v${projectInfo.version}` : ''}
-**Description:** ${projectInfo.description || 'No description available.'}
-**Type:** ${projectInfo.type} project
-**Package Manager:** ${projectInfo.packageManager}
-**Framework:** ${projectInfo.framework?.name || 'None detected'}`;
-        // Add main entry point if available
-        if (projectInfo.entryPoints && projectInfo.entryPoints.length > 0) {
-            content += `\n**Main Entry Point:** ${projectInfo.entryPoints[0]}`;
-        }
-        content += '\n';
-        // Add dependencies
-        const deps = Object.keys(projectInfo.dependencies);
-        if (deps.length > 0) {
-            content += '\n\n### Dependencies\n';
-            deps.forEach((dep) => {
-                content += `- ${dep}\n`;
-            });
-        }
-        // Add available scripts
-        if (projectInfo.scripts && Object.keys(projectInfo.scripts).length > 0) {
-            content += '\n### Available Scripts\n';
-            Object.entries(projectInfo.scripts).forEach(([name, script]) => {
-                content += `- **${name}**: \`${script}\`\n`;
-            });
-        }
-        return content;
-    }
-    buildFrameworkSection(framework) {
-        if (!framework) {
-            return '';
-        }
-        const features = framework.features.length > 0 ? `\n- **Features**: ${framework.features.join(', ')}` : '';
-        return `## Framework: ${framework.name}
-
-- **Version**: ${framework.version || 'Unknown'}${features}`;
-    }
-    buildArchitectureSection(fileAnalyses) {
-        const typeGroups = fileAnalyses.reduce((acc, file) => {
-            if (!acc[file.type]) {
-                acc[file.type] = [];
-            }
-            acc[file.type].push(file);
-            return acc;
-        }, {});
-        const archLines = Object.entries(typeGroups)
-            .map(([type, files]) => `- **${type}**: ${files.length} files`)
-            .join('\n');
-        return `## Architecture Overview
-
-${archLines}`;
-    }
-    buildRoutesSection(routes, _fileAnalyses) {
-        const routesByMethod = routes.reduce((acc, route) => {
-            if (!acc[route.method]) {
-                acc[route.method] = [];
-            }
-            acc[route.method].push(route);
-            return acc;
-        }, {});
-        const routeLines = Object.entries(routesByMethod)
-            .map(([method, methodRoutes]) => {
-            const routeList = methodRoutes
-                .map((route) => `  - \`${route.path}\` → ${route.handler}`)
-                .join('\n');
-            return `- **${method}**:\n${routeList}`;
-        })
-            .join('\n');
-        return `## API Endpoints
-
-${routeLines}`;
-    }
-    buildFileStructureSection(fileAnalyses) {
-        const structure = fileAnalyses.map((file) => `- \`${file.path}\` (${file.type})`).join('\n');
-        return `## File Structure
-
-${structure}`;
-    }
-    buildDependenciesSection(projectInfo) {
-        const deps = Object.keys(projectInfo.dependencies);
-        const devDeps = Object.keys(projectInfo.devDependencies);
-        let content = '## Dependencies\n\n';
-        if (deps.length > 0) {
-            content += `**Production**: ${deps.join(', ')}\n\n`;
-        }
-        if (devDeps.length > 0) {
-            content += `**Development**: ${devDeps.join(', ')}`;
-        }
-        return content;
-    }
-    buildGitSection(gitInfo) {
-        return `## Git Information
-
-**State when PARSEME.md and all linked files were automatically generated:**
-
-- **Branch:** ${gitInfo.branch}
-- **Commit:** ${gitInfo.lastCommit}${gitInfo.origin ? `\n- **Origin:** ${gitInfo.origin}` : ''}
-
-### Git Diff Statistics
-Git diff statistics from the time of generation are available at \`parseme-context/gitDiff.md\`.
-
-**AI Agent Command:** To check for changes since generation, run:
-\`\`\`bash
-git diff --stat
-\`\`\`
-Compare the output with the baseline in \`parseme-context/gitDiff.json\` to detect any modifications.`;
-    }
-    buildFooter() {
-        return `---
-
-*Generated by PARSEME v1.0.0 on ${new Date().toISOString().split('T')[0]}*`;
-    }
-    buildSummarySection(context, linkPath) {
-        const { fileAnalyses } = context;
-        const routes = fileAnalyses.flatMap((f) => f.routes || []).length;
-        let content = `## Project Files
-A complete list of all tracked files in the project is available at \`${linkPath}/files.md\`. This list excludes files ignored by git and provides a quick overview of the project structure.
-
-
-## Project Structure & AST
-Detailed structure and Abstract Syntax Tree data for all tracked files is available at \`${linkPath}/structure.json\`. This includes file paths, types, imports, exports, functions, classes, interfaces, and routes for comprehensive code analysis without manual parsing.`;
-        if (routes > 0) {
-            content += `\n\n\n## API Endpoints
-A comprehensive list of all discovered API endpoints is available at \`${linkPath}/api-endpoints.json\`. This includes HTTP methods, paths, handler names, and source file locations for backend routes (Express, NestJS, and decorator-based routing).`;
-        }
-        return content;
-    }
-    buildFilesList(fileAnalyses) {
-        let content = `# Project Files\n\n`;
-        content += `This is a complete list of all analyzed files in the project.\n\n`;
-        fileAnalyses.forEach((file) => {
-            content += `- ${file.path}\n`;
-        });
-        return content;
-    }
-    buildDetailedStructure(fileAnalyses) {
-        const structureData = fileAnalyses.map((file) => ({
-            path: file.path,
-            type: file.type,
-            exports: file.exports,
-            imports: file.imports,
-            functions: file.functions,
-            classes: file.classes,
-            routes: file.routes || [],
-        }));
-        const jsonContent = JSON.stringify(structureData, null, 2);
-        const result = this.truncateContent(jsonContent);
-        if (Array.isArray(result)) {
-            // Return split files as a record with numbered keys
-            const splitFiles = {};
-            result.forEach((part, index) => {
-                const suffix = index === 0 ? '' : `_part${index + 1}`;
-                splitFiles[`structure${suffix}`] = part;
-            });
-            return splitFiles;
-        }
-        return result;
-    }
-    buildDetailedRoutes(routes, _fileAnalyses) {
-        const jsonContent = JSON.stringify(routes, null, 2);
-        const result = this.truncateContent(jsonContent);
-        if (Array.isArray(result)) {
-            const splitFiles = {};
-            result.forEach((part, index) => {
-                const suffix = index === 0 ? '' : `_part${index + 1}`;
-                splitFiles[`routes${suffix}`] = part;
-            });
-            return splitFiles;
-        }
-        return result;
-    }
-    buildDetailedDependencies(projectInfo) {
-        const jsonContent = JSON.stringify({
-            dependencies: projectInfo.dependencies,
-            packageManager: projectInfo.packageManager,
-            version: projectInfo.version,
-        }, null, 2);
-        const result = this.truncateContent(jsonContent);
-        if (Array.isArray(result)) {
-            const splitFiles = {};
-            result.forEach((part, index) => {
-                const suffix = index === 0 ? '' : `_part${index + 1}`;
-                splitFiles[`dependencies${suffix}`] = part;
-            });
-            return splitFiles;
-        }
-        return result;
-    }
-    buildDetailedFramework(framework) {
-        if (!framework) {
-            return '';
-        }
-        let content = `# Framework: ${framework.name}\n\n`;
-        content += `**Version**: ${framework.version || 'Unknown'}\n\n`;
-        if (framework.features.length > 0) {
-            content += '## Features Detected\n\n';
-            framework.features.forEach((feature) => {
-                content += `- ${feature}\n`;
-            });
-        }
-        return content;
-    }
-    buildDetailedGit(gitInfo) {
-        let content = `# Git Diff Statistics
-# Generated at time of PARSEME.md creation
-# To check for changes since then, run: git diff --stat
-# Compare the output with the content below
-
-`;
-        if (gitInfo.diffStat && gitInfo.diffStat.length > 0) {
-            content += gitInfo.diffStat;
-        }
-        else {
-            content += 'No changes detected at time of generation.';
-        }
-        return content;
-    }
-}