zeropoint-node 1.0.1 → 1.0.3

package/docs/GIT_INTEGRATION.md

@@ -1,412 +0,0 @@
-# ZeroPoint Live Git Integration
-
-## Overview
-
-ZeroPoint now includes comprehensive live Git integration that enables the system to learn from code evolution in real-time. This integration provides:
-
-- **Live Git Event Monitoring**: Real-time tracking of commits, changes, and development patterns
-- **Git-Aware Q&A System**: Ask questions about code changes, development history, and learning progress
-- **Learning Analytics**: Automatic analysis of development patterns and learning indicators
-- **Code Evolution Insights**: Understanding of how the codebase evolves over time
-
-## Core Components
-
-### 1. GitIntegration Module (`src/utils/GitIntegration.ts`)
-
-The core Git integration module that provides live monitoring and Git operations.
-
-```typescript
-import { gitIntegration, GitEvent, GitStatus, GitCommit } from '../utils/GitIntegration';
-
-// Get live Git status
-const status = await gitIntegration.getLiveGitStatus();
-
-// Get recent commits
-const commits = await gitIntegration.getRecentCommits(10);
-
-// Subscribe to live Git events
-gitIntegration.onGitChange((event) => {
-  console.log('Git event:', event.type, event.data);
-});
-```
-
-**Key Features:**
-- Real-time Git status monitoring
-- Live commit tracking
-- Event-driven architecture
-- Automatic file watching
-
-### 2. ZeroPoint Core Integration
-
-ZeroPoint core now includes Git awareness:
-
-```typescript
-import { ZeroPoint } from './core/ZeroPoint';
-
-const zeropoint = new ZeroPoint();
-await zeropoint.initialize();
-
-// Git-aware methods
-const status = await zeropoint.getLiveGitStatus();
-const commits = await zeropoint.getRecentCommits(10);
-zeropoint.onGitChange((event) => {
-  // Handle Git events
-});
-```
-
-### 3. KnowledgeSystem Git Integration
-
-The KnowledgeSystem now captures Git events as knowledge patterns:
-
-```typescript
-import { KnowledgeSystem } from './knowledge/KnowledgeSystem';
-
-const knowledge = new KnowledgeSystem(zeropoint); // Pass ZeroPoint instance
-
-// Git patterns are automatically captured
-const gitPatterns = knowledge.getRecentGitPatterns(10);
-```
-
-## Learning Analytics System
-
-### Live Git Event Monitoring
-
-The learning analytics system (`scripts/learning-analytics.js`) now includes live Git monitoring:
-
-```javascript
-const analytics = new LearningAnalytics();
-
-// Start live monitoring
-await analytics.startLiveMonitoring();
-
-// Get live Git status
-const status = await analytics.getLiveGitStatus();
-
-// Get recent commits
-const commits = await analytics.getRecentCommits(10);
-```
-
-**Features:**
-- Real-time event capture
-- Learning pattern extraction
-- Velocity metrics updates
-- Live event logging
-
-### Learning Pattern Detection
-
-The system automatically detects learning patterns from Git commits:
-
-- **Explicit Learning**: Commits with "learning" or "learn" keywords
-- **Test-Driven Fixes**: Commits combining test and fix activities
-- **Iterative Improvement**: Refactoring and improvement patterns
-- **Documentation**: Documentation-related commits
-
-## Git-Aware Q&A System
-
-### Asking Git Questions
-
-The KnowledgeSystem now supports Git-related questions:
-
-```typescript
-const knowledge = new KnowledgeSystem(zeropoint);
-
-// Ask Git questions
-const result = await knowledge.askGitQuestion("What changed in the last commit?");
-const result2 = await knowledge.askGitQuestion("Show me recent development patterns");
-const result3 = await knowledge.askGitQuestion("What's my learning progress?");
-
-console.log(result.answer);
-console.log(result.insights);
-console.log(result.recommendations);
-```
-
-### Supported Question Types
-
-1. **Recent Commits**: "What are the recent commits?"
-2. **Changes**: "What changed in the last commit?"
-3. **Development Patterns**: "Show me development patterns"
-4. **File Evolution**: "How have files evolved?"
-5. **Learning Progress**: "What's my learning progress?"
-
-### Comprehensive Insights
-
-Get comprehensive Git development insights:
-
-```typescript
-const insights = await knowledge.getGitDevelopmentInsights();
-
-console.log(insights.activity);      // Live Git activity
-console.log(insights.patterns);      // Git patterns
-console.log(insights.insights);      // Extracted insights
-console.log(insights.recommendations); // Recommendations
-console.log(insights.evolution);     // Code evolution analysis
-```
-
-## API Endpoints
-
-### Git Q&A Endpoints
-
-#### POST `/api/git/ask`
-Ask Git-related questions:
-
-```bash
-curl -X POST http://localhost:3000/api/git/ask \
-  -H "Content-Type: application/json" \
-  -d '{"question": "What changed in the last commit?"}'
-```
-
-**Response:**
-```json
-{
-  "question": "What changed in the last commit?",
-  "answer": "Recent commits (3):\n1. Add Git integration (author, date)\n2. Update documentation (author, date)\n3. Fix tests (author, date)",
-  "insights": ["Active development with 3 recent commits"],
-  "recommendations": ["Consider staging changes for better version control"],
-  "patterns": 5,
-  "timestamp": "2024-01-01T12:00:00.000Z"
-}
-```
-
-#### GET `/api/git/insights`
-Get comprehensive Git development insights:
-
-```bash
-curl http://localhost:3000/api/git/insights
-```
-
-**Response:**
-```json
-{
-  "activity": {
-    "status": {...},
-    "recentCommits": [...],
-    "timestamp": "2024-01-01T12:00:00.000Z",
-    "totalCommits": 20
-  },
-  "patterns": 15,
-  "insights": [
-    "Active development with 20 recent commits",
-    "Code evolution patterns detected: 15 patterns"
-  ],
-  "recommendations": [
-    "Consider staging changes for better version control"
-  ],
-  "evolution": {
-    "totalPatterns": 15,
-    "patternTypes": {...},
-    "learningIndicators": 3,
-    "developmentVelocity": "steady"
-  },
-  "timestamp": "2024-01-01T12:00:00.000Z"
-}
-```
-
-#### GET `/api/git/status`
-Get live Git status:
-
-```bash
-curl http://localhost:3000/api/git/status
-```
-
-#### GET `/api/git/patterns`
-Get recent Git patterns:
-
-```bash
-curl http://localhost:3000/api/git/patterns
-```
-
-#### POST `/api/git/analyze`
-Analyze specific aspects of Git data:
-
-```bash
-curl -X POST http://localhost:3000/api/git/analyze \
-  -H "Content-Type: application/json" \
-  -d '{"analysisType": "development_patterns"}'
-```
-
-**Analysis Types:**
-- `development_patterns`: Analyze development patterns
-- `learning_progress`: Analyze learning progress
-- `code_evolution`: Analyze code evolution
-
-## Usage Examples
-
-### 1. Basic Git Integration
-
-```typescript
-import { ZeroPoint } from './core/ZeroPoint';
-import { KnowledgeSystem } from './knowledge/KnowledgeSystem';
-
-// Initialize ZeroPoint with Git integration
-const zeropoint = new ZeroPoint();
-await zeropoint.initialize();
-
-// Create KnowledgeSystem with Git awareness
-const knowledge = new KnowledgeSystem(zeropoint);
-
-// Subscribe to Git events
-zeropoint.onGitChange((event) => {
-  console.log('Git event detected:', event.type, event.data);
-});
-```
-
-### 2. Learning Analytics
-
-```javascript
-const { LearningAnalytics } = require('./scripts/learning-analytics');
-
-const analytics = new LearningAnalytics();
-
-// Run traditional analysis
-analytics.run();
-
-// Start live monitoring
-await analytics.startLiveMonitoring();
-
-// Get live data
-const status = await analytics.getLiveGitStatus();
-const commits = await analytics.getRecentCommits(10);
-```
-
-### 3. Git Q&A
-
-```typescript
-// Ask various Git questions
-const questions = [
-  "What are the recent commits?",
-  "What changed in the last commit?",
-  "Show me development patterns",
-  "What's my learning progress?",
-  "How have files evolved?"
-];
-
-for (const question of questions) {
-  const result = await knowledge.askGitQuestion(question);
-  console.log(`Q: ${question}`);
-  console.log(`A: ${result.answer}`);
-  console.log(`Insights: ${result.insights.join(', ')}`);
-  console.log('---');
-}
-```
-
-### 4. API Usage
-
-```javascript
-// Get Git insights via API
-const response = await fetch('/api/git/insights');
-const insights = await response.json();
-console.log('Git insights:', insights);
-
-// Ask Git question via API
-const questionResponse = await fetch('/api/git/ask', {
-  method: 'POST',
-  headers: { 'Content-Type': 'application/json' },
-  body: JSON.stringify({ question: "What changed recently?" })
-});
-const answer = await questionResponse.json();
-console.log('Answer:', answer.answer);
-```
-
-## Configuration
-
-### Git Integration Settings
-
-The Git integration can be configured through environment variables:
-
-```bash
-# Git monitoring settings
-GIT_WATCH_INTERVAL=1000        # Watch interval in ms
-GIT_MAX_EVENTS=100            # Maximum events to store
-GIT_LOG_LEVEL=info            # Logging level
-
-# Learning analytics settings
-LEARNING_ANALYTICS_ENABLED=true
-LEARNING_PATTERN_DETECTION=true
-```
-
-### File Watching
-
-The system automatically watches the `.git` directory for changes:
-
-- **Commit events**: Detected when new commits are made
-- **Status changes**: Detected when working directory changes
-- **Branch changes**: Detected when switching branches
-
-## Benefits
-
-### 1. Real-Time Learning
-- Immediate capture of development activities
-- Live pattern recognition
-- Instant feedback on learning progress
-
-### 2. Code Evolution Understanding
-- Track how code changes over time
-- Identify development patterns
-- Understand learning trajectories
-
-### 3. Enhanced Q&A
-- Context-aware answers about code changes
-- Historical development insights
-- Learning progress tracking
-
-### 4. Automated Analytics
-- Continuous learning pattern detection
-- Development velocity tracking
-- Code evolution analysis
-
-## Future Enhancements
-
-### Planned Features
-
-1. **Advanced Pattern Recognition**
-   - Machine learning-based pattern detection
-   - Predictive development insights
-   - Automated code quality assessment
-
-2. **Enhanced Q&A**
-   - Natural language processing for Git questions
-   - Contextual code explanations
-   - Learning recommendations
-
-3. **Visualization**
-   - Git activity dashboards
-   - Learning progress charts
-   - Code evolution timelines
-
-4. **Integration**
-   - IDE plugins for real-time feedback
-   - CI/CD pipeline integration
-   - Team collaboration insights
-
-## Troubleshooting
-
-### Common Issues
-
-1. **Git Integration Not Working**
-   - Ensure `.git` directory exists
-   - Check file permissions
-   - Verify Git is installed
-
-2. **No Events Detected**
-   - Check if Git repository is initialized
-   - Verify file watching is enabled
-   - Check console for error messages
-
-3. **Q&A Not Responding**
-   - Ensure ZeroPoint is initialized
-   - Check KnowledgeSystem integration
-   - Verify API endpoints are accessible
-
-### Debug Mode
-
-Enable debug mode for detailed logging:
-
-```bash
-DEBUG=zeropoint:git npm start
-```
-
-## Conclusion
-
-The live Git integration in ZeroPoint provides unprecedented insight into code evolution and learning patterns. By combining real-time monitoring, intelligent Q&A, and comprehensive analytics, developers can now understand their codebase's evolution and their own learning journey in ways never before possible.
-
-This integration embodies ZeroPoint's core principle of "Empty = Void = Full" - where each Git event contains the whole of the development process, and the system learns from every interaction to become more conscious of its own evolution.