vibe-coding-mcp 2.6.0 → 2.12.0

package/README.md

@@ -4,7 +4,7 @@ MCP server that automatically collects, summarizes, documents, and publishes cod
 
 ## Features
 
-This MCP server provides 7 tools for managing vibe coding documentation:
+This MCP server provides 15 tools for managing vibe coding documentation:
 
 | Tool | Description |
 |------|-------------|
@@ -16,6 +16,13 @@ This MCP server provides 7 tools for managing vibe coding documentation:
 | `muse_create_session_log` | Creates daily or session-based vibe coding session logs |
 | `muse_analyze_code` | AST-based code analysis with Mermaid diagram generation |
 | `muse_session_history` | Manages session history - save, retrieve, search past sessions |
+| `muse_export_session` | Exports sessions to Markdown, JSON, or HTML formats |
+| `muse_project_profile` | Manages project-specific settings and configurations |
+| `muse_git` | Git integration - status, log, diff, branch, snapshot, design decision extraction |
+| `muse_session_stats` | Session analytics dashboard with productivity insights and trends |
+| `muse_auto_tag` | AI-powered auto-tagging for sessions based on content analysis |
+| `muse_template` | Custom template management for documents and reports |
+| `muse_batch` | Batch operations to execute multiple tools in sequence or parallel |
 
 ### Additional Features (v2.0)
 - **AST Parsing**: TypeScript, Python, Go code analysis
@@ -41,7 +48,7 @@ This MCP server provides 7 tools for managing vibe coding documentation:
 - **Configuration Validation**: Startup validation for all platform configurations
 - **Platform Expansion**: Full support for 6 platforms (Notion, GitHub Wiki, Obsidian, Confluence, Slack, Discord)
 - **AST Memoization**: Cached code analysis for improved performance
-- **Test Coverage**: 81 tests with 85%+ coverage on core modules
+- **Test Coverage**: 149 tests with 85%+ coverage on core modules
 
 ### AI-Powered Analysis (v2.4)
 - **Claude AI Integration**: Use Claude AI for enhanced design decision analysis
@@ -55,6 +62,60 @@ This MCP server provides 7 tools for managing vibe coding documentation:
 - **Improvement Suggestions**: AI-generated recommendations for better code
 - **Works with AST**: Combines AI insights with AST-based analysis for comprehensive results
 
+### Session History (v2.6)
+- **Persistent Storage**: Save coding sessions to local JSON files
+- **CRUD Operations**: Create, read, update, delete sessions
+- **Search & Filter**: Find past sessions by keyword, tags, or date
+- **Statistics**: Track total sessions, code contexts, and design decisions
+
+### Session Export & Project Profiles (v2.7)
+- **Session Export**: Export sessions to Markdown, JSON, or HTML formats
+- **Multiple Templates**: Default, minimal, detailed, and report templates
+- **Project Profiles**: Manage project-specific settings and configurations
+- **Publishing Config**: Default platforms and settings per project
+- **Code Analysis Config**: Language preferences and diagram types
+- **Documentation Config**: Default document types, language, author info
+- **Team Management**: Store team member information per project
+
+### Git Integration (v2.8)
+- **Repository Status**: View staged, unstaged, and untracked files
+- **Commit History**: Browse commit log with filtering by author, date, grep
+- **Diff Analysis**: View changes with statistics (staged, unstaged, between refs)
+- **Branch Info**: List local and remote branches with tracking info
+- **Git Snapshot**: Capture complete repository state for session context
+- **Design Decision Extraction**: Auto-extract design decisions from commit messages
+- **Session Linking**: Attach Git context to coding sessions
+
+### Session Statistics Dashboard (v2.9)
+- **Overview Analytics**: Total sessions, code contexts, design decisions at a glance
+- **Language Distribution**: Breakdown of programming languages used across sessions
+- **Timeline View**: Session activity over time (daily, weekly, monthly)
+- **Tag Analytics**: Most used tags and tag co-occurrence analysis
+- **Productivity Insights**: Session duration, code output, and efficiency metrics
+- **Trend Analysis**: Compare current period with previous or average
+
+### AI Auto-tagging (v2.10)
+- **Smart Tag Suggestions**: Pattern-based and AI-powered tag recommendations
+- **Confidence Scoring**: Each tag suggestion includes confidence level
+- **Custom Tag Training**: Train the system with custom tag patterns
+- **Configurable Rules**: Define tag rules for file extensions, keywords, patterns
+- **Batch Tagging**: Apply tags to multiple sessions at once
+
+### Custom Templates (v2.11)
+- **Template Management**: Create, edit, delete custom document templates
+- **Variable Substitution**: Support for `{{variable}}`, `${variable}`, `{variable}` formats
+- **Built-in Templates**: README, Session Summary, Weekly Report templates included
+- **Template Preview**: Preview rendered output before applying
+- **Import/Export**: Share templates between projects
+
+### Batch Operations (v2.12)
+- **Sequential Execution**: Run multiple tools in order with dependency management
+- **Parallel Execution**: Execute independent operations concurrently
+- **Dependency Graph**: Topological sort for operation ordering
+- **Job Tracking**: Monitor batch job status, cancel running jobs
+- **Error Handling**: Stop on error or continue with remaining operations
+- **Result Chaining**: Pass output from one operation to next using `$ref` syntax
+
 ## Installation
 
 ### Claude Code (Recommended)
@@ -140,6 +201,58 @@ User: Create a session log for today's work.
 Claude: [Uses collect_code_context → create_session_log]
 ```
 
+### 4. Git-Aware Session Documentation
+
+```
+User: Capture my current Git state and create a session with design decisions from commits.
+
+Claude: [Uses muse_git(action='snapshot') → muse_git(action='extractDecisions') → muse_session_history(action='save')]
+```
+
+### 5. Complete Session Export with Git Context
+
+```
+User: Export all my sessions from this week with Git information.
+
+Claude: [Uses muse_git(action='linkToSession') → muse_export_session(format='markdown')]
+```
+
+### 6. Session Analytics Dashboard
+
+```
+User: Show me my coding productivity statistics for this month.
+
+Claude: [Uses muse_session_stats(action='overview') → muse_session_stats(action='productivity') → muse_session_stats(action='trends')]
+```
+
+### 7. Auto-tag and Organize Sessions
+
+```
+User: Analyze my sessions and suggest relevant tags.
+
+Claude: [Uses muse_auto_tag(action='suggest') → muse_auto_tag(action='apply')]
+```
+
+### 8. Generate Custom Report with Template
+
+```
+User: Create a weekly report using the team report template.
+
+Claude: [Uses muse_template(action='apply', templateId='weekly-report') → muse_publish_document]
+```
+
+### 9. Batch Documentation Workflow
+
+```
+User: Analyze this code, generate docs, and publish to Notion in one go.
+
+Claude: [Uses muse_batch(action='execute', operations=[
+  {tool: 'muse_analyze_code', params: {...}},
+  {tool: 'muse_generate_dev_document', params: {...}, dependsOn: ['op_0']},
+  {tool: 'muse_publish_document', params: {...}, dependsOn: ['op_1']}
+])]
+```
+
 ## Supported Platforms
 
 - **Notion**: Full API integration with page creation
@@ -162,10 +275,15 @@ src/
 │   ├── security.ts       # Path traversal, SSRF, timeout utilities
 │   ├── logger.ts         # Structured JSON logging
 │   └── config.ts         # Platform configuration validation
-├── tools/                # 7 MCP tools
+├── tools/                # 15 MCP tools
 ├── platforms/            # Notion, GitHub Wiki, Obsidian, Confluence, Slack, Discord
 ├── types/                # TypeScript interfaces
-└── utils/                # Markdown, AST, diagram utilities
+└── utils/
+    ├── markdown.ts       # Markdown processing
+    ├── astParser.ts      # AST parsing for TypeScript, Python, Go
+    ├── diagramGenerator.ts # Mermaid diagram generation
+    ├── gitExecutor.ts    # Safe Git command execution
+    └── gitParsers.ts     # Git output parsing utilities
 ```
 
 ## Development

package/dist/__tests__/exportSession.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=exportSession.test.d.ts.map

package/dist/__tests__/exportSession.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportSession.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/exportSession.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/exportSession.test.js

@@ -0,0 +1,180 @@
+import { exportSessionTool } from '../tools/exportSession.js';
+import { sessionHistoryTool } from '../tools/sessionHistory.js';
+import * as sessionStorage from '../core/sessionStorage.js';
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+let testDir;
+beforeAll(async () => {
+    testDir = path.join(os.tmpdir(), `vibe-coding-export-test-${Date.now()}`);
+    await sessionStorage.initializeStorage(testDir);
+    // 테스트용 세션 생성
+    await sessionHistoryTool({
+        action: 'save',
+        title: 'Test Session 1',
+        summary: 'First test session for export',
+        tags: ['test', 'export'],
+        codeContexts: [
+            {
+                sessionId: 'ctx-1',
+                timestamp: new Date().toISOString(),
+                codeBlocks: [
+                    { language: 'typescript', code: 'const x = 1;' }
+                ],
+                conversationSummary: 'Test code'
+            }
+        ],
+        designDecisions: [
+            {
+                id: 'dd-1',
+                title: 'Test Decision',
+                description: 'A test decision',
+                rationale: 'For testing',
+                category: 'implementation',
+                timestamp: new Date().toISOString()
+            }
+        ]
+    });
+    await sessionHistoryTool({
+        action: 'save',
+        title: 'Test Session 2',
+        summary: 'Second test session',
+        tags: ['test']
+    });
+});
+afterAll(async () => {
+    try {
+        const files = await fs.readdir(testDir);
+        for (const file of files) {
+            await fs.unlink(path.join(testDir, file));
+        }
+        await fs.rmdir(testDir);
+    }
+    catch {
+        // Ignore cleanup errors
+    }
+});
+describe('exportSessionTool', () => {
+    describe('markdown export', () => {
+        it('should export all sessions as markdown', async () => {
+            const result = await exportSessionTool({
+                format: 'markdown'
+            });
+            expect(result.success).toBe(true);
+            expect(result.format).toBe('markdown');
+            expect(result.sessionCount).toBe(2);
+            expect(result.content).toContain('Test Session 1');
+            expect(result.content).toContain('Test Session 2');
+        });
+        it('should include code blocks in markdown', async () => {
+            const result = await exportSessionTool({
+                format: 'markdown',
+                includeCodeBlocks: true
+            });
+            expect(result.success).toBe(true);
+            expect(result.content).toContain('```typescript');
+            expect(result.content).toContain('const x = 1;');
+        });
+        it('should include design decisions', async () => {
+            const result = await exportSessionTool({
+                format: 'markdown',
+                includeDesignDecisions: true
+            });
+            expect(result.success).toBe(true);
+            expect(result.content).toContain('Test Decision');
+            expect(result.content).toContain('Design Decisions');
+        });
+        it('should use minimal template', async () => {
+            const result = await exportSessionTool({
+                format: 'markdown',
+                template: 'minimal'
+            });
+            expect(result.success).toBe(true);
+            expect(result.content).not.toContain('Table of Contents');
+        });
+    });
+    describe('json export', () => {
+        it('should export as valid JSON', async () => {
+            const result = await exportSessionTool({
+                format: 'json'
+            });
+            expect(result.success).toBe(true);
+            expect(result.format).toBe('json');
+            const parsed = JSON.parse(result.content);
+            expect(parsed.exportInfo).toBeDefined();
+            expect(parsed.sessions).toHaveLength(2);
+        });
+        it('should include metadata in JSON', async () => {
+            const result = await exportSessionTool({
+                format: 'json',
+                includeMetadata: true
+            });
+            const parsed = JSON.parse(result.content);
+            expect(parsed.sessions[0].createdAt).toBeDefined();
+            expect(parsed.sessions[0].tags).toBeDefined();
+        });
+    });
+    describe('html export', () => {
+        it('should export as valid HTML', async () => {
+            const result = await exportSessionTool({
+                format: 'html'
+            });
+            expect(result.success).toBe(true);
+            expect(result.format).toBe('html');
+            expect(result.content).toContain('<!DOCTYPE html>');
+            expect(result.content).toContain('Test Session 1');
+        });
+        it('should include styles in HTML', async () => {
+            const result = await exportSessionTool({
+                format: 'html'
+            });
+            expect(result.content).toContain('<style>');
+            expect(result.content).toContain('font-family');
+        });
+    });
+    describe('file output', () => {
+        it('should save to file when outputPath is provided', async () => {
+            const outputPath = path.join(testDir, 'export-test.md');
+            const result = await exportSessionTool({
+                format: 'markdown',
+                outputPath
+            });
+            expect(result.success).toBe(true);
+            expect(result.filePath).toBe(outputPath);
+            const fileContent = await fs.readFile(outputPath, 'utf-8');
+            expect(fileContent).toContain('Test Session');
+        });
+    });
+    describe('custom options', () => {
+        it('should use custom title', async () => {
+            const result = await exportSessionTool({
+                format: 'markdown',
+                title: 'My Custom Export'
+            });
+            expect(result.content).toContain('# My Custom Export');
+        });
+        it('should exclude code blocks when disabled', async () => {
+            const result = await exportSessionTool({
+                format: 'markdown',
+                includeCodeBlocks: false
+            });
+            expect(result.content).not.toContain('```typescript');
+        });
+    });
+    describe('error handling', () => {
+        it('should handle no sessions gracefully', async () => {
+            // 다른 저장소로 테스트
+            const emptyDir = path.join(os.tmpdir(), `empty-${Date.now()}`);
+            await sessionStorage.initializeStorage(emptyDir);
+            const result = await exportSessionTool({
+                format: 'markdown',
+                sessionIds: ['non-existent-id']
+            });
+            expect(result.success).toBe(false);
+            expect(result.error).toContain('No sessions found');
+            // 원래 저장소로 복원
+            await sessionStorage.initializeStorage(testDir);
+        });
+    });
+});
+//# sourceMappingURL=exportSession.test.js.map

package/dist/__tests__/exportSession.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportSession.test.js","sourceRoot":"","sources":["../../src/__tests__/exportSession.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/git.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git.test.d.ts.map

package/dist/__tests__/git.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/git.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/git.test.js

@@ -0,0 +1,282 @@
+import { gitTool } from '../tools/git.js';
+import { parseStatusPorcelainV2, parseLogOutput, parseDiffStat, } from '../utils/gitParsers.js';
+import * as path from 'path';
+import * as os from 'os';
+// Test with the actual vibe-coding-mcp repo
+const TEST_REPO_PATH = path.resolve(process.cwd());
+describe('gitTool', () => {
+    describe('status action', () => {
+        it('should return repository status', async () => {
+            const result = await gitTool({
+                action: 'status',
+                repoPath: TEST_REPO_PATH,
+            });
+            expect(result.success).toBe(true);
+            expect(result.action).toBe('status');
+            expect(result.status).toBeDefined();
+            expect(result.status?.branch).toBeDefined();
+            expect(typeof result.status?.isClean).toBe('boolean');
+            expect(Array.isArray(result.status?.staged)).toBe(true);
+            expect(Array.isArray(result.status?.unstaged)).toBe(true);
+        });
+        it('should include untracked files by default', async () => {
+            const result = await gitTool({
+                action: 'status',
+                repoPath: TEST_REPO_PATH,
+                includeUntracked: true,
+            });
+            expect(result.success).toBe(true);
+            expect(Array.isArray(result.status?.untracked)).toBe(true);
+        });
+    });
+    describe('log action', () => {
+        it('should return commit history', async () => {
+            const result = await gitTool({
+                action: 'log',
+                repoPath: TEST_REPO_PATH,
+                limit: 5,
+            });
+            expect(result.success).toBe(true);
+            expect(result.action).toBe('log');
+            expect(result.commits).toBeDefined();
+            expect(Array.isArray(result.commits)).toBe(true);
+            expect(result.commits.length).toBeLessThanOrEqual(5);
+            if (result.commits.length > 0) {
+                const commit = result.commits[0];
+                expect(commit.hash).toBeDefined();
+                expect(commit.shortHash).toBeDefined();
+                expect(commit.author).toBeDefined();
+                expect(commit.date).toBeDefined();
+                expect(commit.message).toBeDefined();
+            }
+        });
+        it('should support oneline format', async () => {
+            const result = await gitTool({
+                action: 'log',
+                repoPath: TEST_REPO_PATH,
+                limit: 3,
+                oneline: true,
+            });
+            expect(result.success).toBe(true);
+            expect(result.commits).toBeDefined();
+        });
+        it('should filter by grep', async () => {
+            const result = await gitTool({
+                action: 'log',
+                repoPath: TEST_REPO_PATH,
+                limit: 10,
+                grep: 'feat',
+            });
+            expect(result.success).toBe(true);
+            // All returned commits should contain 'feat' in message
+            if (result.commits && result.commits.length > 0) {
+                result.commits.forEach((commit) => {
+                    expect(commit.message.toLowerCase()).toContain('feat');
+                });
+            }
+        });
+    });
+    describe('diff action', () => {
+        it('should return diff information', async () => {
+            const result = await gitTool({
+                action: 'diff',
+                repoPath: TEST_REPO_PATH,
+                diffType: 'all',
+                stat: true,
+            });
+            expect(result.success).toBe(true);
+            expect(result.action).toBe('diff');
+            expect(result.diff).toBeDefined();
+            expect(typeof result.diff?.totalAdditions).toBe('number');
+            expect(typeof result.diff?.totalDeletions).toBe('number');
+            expect(Array.isArray(result.diff?.files)).toBe(true);
+        });
+        it('should support staged diff', async () => {
+            const result = await gitTool({
+                action: 'diff',
+                repoPath: TEST_REPO_PATH,
+                diffType: 'staged',
+            });
+            expect(result.success).toBe(true);
+            expect(result.diff).toBeDefined();
+        });
+    });
+    describe('branch action', () => {
+        it('should return branch information', async () => {
+            const result = await gitTool({
+                action: 'branch',
+                repoPath: TEST_REPO_PATH,
+                includeRemote: true,
+            });
+            expect(result.success).toBe(true);
+            expect(result.action).toBe('branch');
+            expect(result.branch).toBeDefined();
+            expect(result.branch?.current).toBeDefined();
+            expect(Array.isArray(result.branch?.local)).toBe(true);
+        });
+        it('should include remote branches', async () => {
+            const result = await gitTool({
+                action: 'branch',
+                repoPath: TEST_REPO_PATH,
+                includeRemote: true,
+            });
+            expect(result.success).toBe(true);
+            expect(Array.isArray(result.branch?.remote)).toBe(true);
+        });
+    });
+    describe('snapshot action', () => {
+        it('should capture complete git snapshot', async () => {
+            const result = await gitTool({
+                action: 'snapshot',
+                repoPath: TEST_REPO_PATH,
+                includeDiff: true,
+                includeLog: true,
+                logLimit: 5,
+            });
+            expect(result.success).toBe(true);
+            expect(result.action).toBe('snapshot');
+            expect(result.snapshot).toBeDefined();
+            expect(result.snapshot?.timestamp).toBeDefined();
+            expect(result.snapshot?.repository).toBeDefined();
+            expect(result.snapshot?.status).toBeDefined();
+            expect(result.snapshot?.branch).toBeDefined();
+            expect(Array.isArray(result.snapshot?.recentCommits)).toBe(true);
+        });
+        it('should include stash when requested', async () => {
+            const result = await gitTool({
+                action: 'snapshot',
+                repoPath: TEST_REPO_PATH,
+                includeStash: true,
+            });
+            expect(result.success).toBe(true);
+            // Stashes may or may not exist
+            if (result.snapshot?.stashes) {
+                expect(Array.isArray(result.snapshot.stashes)).toBe(true);
+            }
+        });
+    });
+    describe('extractDecisions action', () => {
+        it('should extract design decisions from commits', async () => {
+            const result = await gitTool({
+                action: 'extractDecisions',
+                repoPath: TEST_REPO_PATH,
+                limit: 50,
+            });
+            expect(result.success).toBe(true);
+            expect(result.action).toBe('extractDecisions');
+            expect(result.decisions).toBeDefined();
+            expect(Array.isArray(result.decisions)).toBe(true);
+            if (result.decisions && result.decisions.length > 0) {
+                const decision = result.decisions[0];
+                expect(decision.commitHash).toBeDefined();
+                expect(decision.title).toBeDefined();
+                expect(decision.category).toBeDefined();
+                expect(['high', 'medium', 'low']).toContain(decision.importance);
+            }
+        });
+        it('should filter by since date', async () => {
+            const result = await gitTool({
+                action: 'extractDecisions',
+                repoPath: TEST_REPO_PATH,
+                since: '1 month ago',
+                limit: 20,
+            });
+            expect(result.success).toBe(true);
+            expect(result.decisions).toBeDefined();
+        });
+    });
+    describe('error handling', () => {
+        it('should handle non-git directory gracefully', async () => {
+            const nonGitPath = os.tmpdir();
+            const result = await gitTool({
+                action: 'status',
+                repoPath: nonGitPath,
+            });
+            expect(result.success).toBe(false);
+            expect(result.error).toContain('Not a git repository');
+        });
+        it('should handle non-existent path', async () => {
+            const result = await gitTool({
+                action: 'status',
+                repoPath: '/non/existent/path',
+            });
+            expect(result.success).toBe(false);
+            expect(result.error).toBeDefined();
+        });
+        it('should require sessionId for linkToSession', async () => {
+            const result = await gitTool({
+                action: 'linkToSession',
+                repoPath: TEST_REPO_PATH,
+            });
+            expect(result.success).toBe(false);
+            expect(result.error).toContain('sessionId is required');
+        });
+    });
+});
+describe('gitParsers', () => {
+    describe('parseStatusPorcelainV2', () => {
+        it('should parse branch info', () => {
+            const output = `# branch.oid abc123
+# branch.head main
+# branch.upstream origin/main
+# branch.ab +1 -0`;
+            const result = parseStatusPorcelainV2(output);
+            expect(result.branch).toBe('main');
+            expect(result.upstream).toBe('origin/main');
+            expect(result.ahead).toBe(1);
+            expect(result.behind).toBe(0);
+        });
+        it('should parse untracked files', () => {
+            const output = `# branch.head main
+? new-file.ts
+? another-file.js`;
+            const result = parseStatusPorcelainV2(output);
+            expect(result.untracked.length).toBe(2);
+            expect(result.untracked[0].path).toBe('new-file.ts');
+            expect(result.untracked[0].status).toBe('untracked');
+        });
+        it('should parse modified files', () => {
+            const output = `# branch.head main
+1 .M N... 100644 100644 100644 abc123 def456 src/index.ts`;
+            const result = parseStatusPorcelainV2(output);
+            expect(result.unstaged.length).toBe(1);
+            expect(result.unstaged[0].status).toBe('modified');
+        });
+    });
+    describe('parseLogOutput', () => {
+        it('should parse log with body', () => {
+            const output = `abc123|abc1|John|john@example.com|2024-01-01T00:00:00Z|feat: Add feature
+This is the body
+END_COMMIT
+def456|def4|Jane|jane@example.com|2024-01-02T00:00:00Z|fix: Fix bug
+Another body
+END_COMMIT`;
+            const result = parseLogOutput(output, true);
+            expect(result.length).toBe(2);
+            expect(result[0].hash).toBe('abc123');
+            expect(result[0].author).toBe('John');
+            expect(result[0].message).toBe('feat: Add feature');
+            expect(result[0].body).toBe('This is the body');
+        });
+        it('should parse oneline format', () => {
+            const output = `abc123|abc1|John|john@example.com|2024-01-01T00:00:00Z|feat: Add feature
+def456|def4|Jane|jane@example.com|2024-01-02T00:00:00Z|fix: Fix bug`;
+            const result = parseLogOutput(output, false);
+            expect(result.length).toBe(2);
+            expect(result[0].hash).toBe('abc123');
+            expect(result[1].hash).toBe('def456');
+        });
+    });
+    describe('parseDiffStat', () => {
+        it('should parse diff stat output', () => {
+            const output = ` src/index.ts | 10 ++++------
+ src/utils.ts |  5 ++---
+ 2 files changed, 6 insertions(+), 9 deletions(-)`;
+            const result = parseDiffStat(output);
+            expect(result.files.length).toBe(2);
+            expect(result.totalAdditions).toBe(6);
+            expect(result.totalDeletions).toBe(9);
+        });
+    });
+});
+//# sourceMappingURL=git.test.js.map