@parseme/cli 0.0.2 → 0.0.3

package/dist/analyzers/git-analyzer.d.ts

@@ -3,11 +3,11 @@ import type { GitInfo } from '../types.js';
 export declare class GitAnalyzer {
     private readonly config;
     constructor(config: ParsemeConfig);
-    analyze(rootDir: string): Promise<GitInfo | undefined>;
+    analyze(rootDir: string): Promise<GitInfo | null>;
     private getCurrentBranch;
     private getLastCommit;
     private getStatus;
     private getChangedFiles;
-    getFileLastModified(filePath: string, rootDir: string): Promise<string | undefined>;
-    getFileHistory(filePath: string, rootDir: string, limit?: number): Promise<string[]>;
+    private getOrigin;
+    private getDiffStat;
 }

package/dist/analyzers/git-analyzer.js

@@ -10,22 +10,26 @@ export class GitAnalyzer {
         try {
             // Check if this is a git repository
             await execAsync('git rev-parse --git-dir', { cwd: rootDir });
-            const [branch, lastCommit, status, changedFiles] = await Promise.all([
+            const [branch, lastCommit, status, changedFiles, origin, diffStat] = await Promise.all([
                 this.getCurrentBranch(rootDir),
                 this.getLastCommit(rootDir),
                 this.getStatus(rootDir),
                 this.getChangedFiles(rootDir),
+                this.getOrigin(rootDir),
+                this.getDiffStat(rootDir),
             ]);
             return {
                 branch,
                 lastCommit,
                 status,
                 changedFiles,
+                origin,
+                diffStat,
             };
         }
         catch {
             // Not a git repository or git not available
-            return undefined;
+            return null;
         }
     }
     async getCurrentBranch(rootDir) {
@@ -67,26 +71,22 @@ export class GitAnalyzer {
             return [];
         }
     }
-    async getFileLastModified(filePath, rootDir) {
+    async getOrigin(rootDir) {
         try {
-            const { stdout } = await execAsync(`git log -1 --format="%H %ai" -- "${filePath}"`, {
-                cwd: rootDir,
-            });
+            const { stdout } = await execAsync('git remote get-url origin', { cwd: rootDir });
             return stdout.trim();
         }
         catch {
             return undefined;
         }
     }
-    async getFileHistory(filePath, rootDir, limit = 5) {
+    async getDiffStat(rootDir) {
         try {
-            const { stdout } = await execAsync(`git log --oneline -${limit} -- "${filePath}"`, {
-                cwd: rootDir,
-            });
-            return stdout.split('\n').filter((line) => line.trim());
+            const { stdout } = await execAsync('git diff --stat', { cwd: rootDir });
+            return stdout.trim();
         }
         catch {
-            return [];
+            return undefined;
         }
     }
 }

package/dist/builders/context-builder.d.ts

@@ -3,7 +3,7 @@ import type { ContextOutput, ProjectInfo, FileAnalysis, GitInfo, GeneratorOption
 interface BuildContext {
     projectInfo: ProjectInfo;
     fileAnalyses: FileAnalysis[];
-    gitInfo?: GitInfo;
+    gitInfo?: GitInfo | null;
     options: GeneratorOptions;
     contextDir?: string;
     outputPath?: string;
@@ -26,6 +26,7 @@ export declare class ContextBuilder {
     private buildGitSection;
     private buildFooter;
     private buildSummarySection;
+    private buildFilesList;
     private buildDetailedStructure;
     private buildDetailedRoutes;
     private buildDetailedDependencies;

package/dist/builders/context-builder.js

@@ -76,17 +76,36 @@ export class ContextBuilder {
         return this.buildMultiFile(context);
     }
     buildMultiFile(context) {
-        const { projectInfo, fileAnalyses, gitInfo } = 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;
-        const mainContent = this.buildHeader(projectInfo) +
-            '\n\n' +
+        // 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' +
-            this.buildSummarySection(context);
+            '\n\n\n' +
+            this.buildSummarySection(context, linkPath) +
+            '\n\n\n' +
+            (gitInfo ? this.buildGitSection(gitInfo) : '');
         const contextFiles = {
             structure: '',
             routes: '',
@@ -104,14 +123,16 @@ export class ContextBuilder {
                 });
             }
         };
-        // Detailed structure
+        // 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, 'routes');
+            mergeSplitFiles(routesResult, 'api-endpoints');
         }
         // Dependencies
         const dependenciesResult = this.buildDetailedDependencies(projectInfo);
@@ -124,28 +145,54 @@ export class ContextBuilder {
         }
         // Git information
         if (gitInfo) {
-            const gitResult = this.buildDetailedGit(gitInfo);
-            mergeSplitFiles(gitResult, 'git');
+            contextFiles.gitDiff = this.buildDetailedGit(gitInfo);
         }
         return {
             parseme: mainContent,
             context: contextFiles,
         };
     }
-    buildHeader(projectInfo) {
-        return `# ${projectInfo.name}
-
-*AI-Generated Project Context*
+    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.
 
-${projectInfo.description || 'No description available.'}`;
+**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) {
-        return `## Project Overview
+        let content = `## Basic Project Information
 
-- **Type**: ${projectInfo.type} project
-- **Package Manager**: ${projectInfo.packageManager}
-- **Framework**: ${projectInfo.framework?.name || 'None detected'}
-- **Version**: ${projectInfo.version || 'Not specified'}`;
+**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) {
@@ -212,42 +259,47 @@ ${structure}`;
     buildGitSection(gitInfo) {
         return `## Git Information
 
-- **Branch**: ${gitInfo.branch}
-- **Status**: ${gitInfo.status}
-- **Last Commit**: ${gitInfo.lastCommit}
-${gitInfo.changedFiles.length > 0 ? `- **Changed Files**: ${gitInfo.changedFiles.join(', ')}` : ''}`;
+**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) {
-        const { fileAnalyses, contextDir, outputPath } = context;
-        const totalFiles = fileAnalyses.length;
+    buildSummarySection(context, linkPath) {
+        const { fileAnalyses } = context;
         const routes = fileAnalyses.flatMap((f) => f.routes || []).length;
-        // 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;
-        }
-        return `## Summary
+        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.
 
-This project contains ${totalFiles} analyzed files${routes > 0 ? ` with ${routes} API endpoints` : ''}.
 
-For detailed information, see the files in the \`${linkPath}/\` directory.`;
+## 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) => ({
@@ -317,16 +369,18 @@ For detailed information, see the files in the \`${linkPath}/\` directory.`;
         return content;
     }
     buildDetailedGit(gitInfo) {
-        const jsonContent = JSON.stringify(gitInfo, 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[`git${suffix}`] = part;
-            });
-            return splitFiles;
+        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;
         }
-        return result;
+        else {
+            content += 'No changes detected at time of generation.';
+        }
+        return content;
     }
 }

package/dist/config.js

@@ -191,7 +191,8 @@ export default config;
                     return pattern + '**';
                 }
                 if (!pattern.includes('/') && !pattern.includes('*')) {
-                    return '**/' + pattern;
+                    // Convert simple names to match directory patterns
+                    return pattern + '/**';
                 }
                 return pattern;
             });

package/dist/generator.js

@@ -40,7 +40,7 @@ export class ParsemeGenerator {
         // Step 4: Get git information if enabled
         const gitInfo = configData.includeGitInfo
             ? await this.gitAnalyzer.analyze(configData.rootDir)
-            : undefined;
+            : null;
         // Calculate final output path for link generation
         const finalOutputPath = outputPath || configData.outputPath || join(configData.rootDir, 'PARSEME.md');
         // Step 5: Build the context output
@@ -81,7 +81,9 @@ export class ParsemeGenerator {
         await writeFile(finalOutputPath, context.parseme);
         if (context.context) {
             for (const [filename, content] of Object.entries(context.context)) {
-                await writeFile(join(parsemeDir, `${filename}.json`), content);
+                // Use .md extension for markdown files, .json for others
+                const extension = filename === 'gitDiff' || filename === 'files' ? '.md' : '.json';
+                await writeFile(join(parsemeDir, `${filename}${extension}`), content);
             }
         }
     }

package/dist/types.d.ts

@@ -79,4 +79,6 @@ export interface GitInfo {
     lastCommit: string;
     changedFiles: string[];
     status: 'clean' | 'dirty';
+    origin?: string;
+    diffStat?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parseme/cli",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Adds a PARSEME.md file—a README.md for AI agents—to your project, providing context and structure for automated tools.",
   "type": "module",
   "main": "./dist/index.js",