memorylink 1.0.0

package/examples/README.md

@@ -0,0 +1,199 @@
+# 📂 MemoryLink Examples
+
+This folder contains example scripts showing how to integrate MemoryLink with various AI tools and workflows.
+
+## Quick Start
+
+```bash
+# Make sure MemoryLink is installed
+npm install -g memorylink
+
+# Initialize in your project
+cd your-project
+memorylink init
+
+# Run examples
+node examples/sync-from-cursor.js
+node examples/chatgpt-context.js
+```
+
+---
+
+## 📄 Available Examples
+
+### 1. `sync-from-cursor.js`
+**Sync Cursor AI rules to MemoryLink**
+
+```bash
+node examples/sync-from-cursor.js
+```
+
+What it does:
+- Reads your `.cursorrules` file
+- Parses rules into individual memories
+- Syncs them to MemoryLink's `memory.log`
+- Tags them with `cursor`, `ai-rules`, `synced`
+
+Use case: When you want Cursor's context available to other AIs (Claude, ChatGPT, etc.)
+
+---
+
+### 2. `chatgpt-context.js`
+**Generate context for ChatGPT**
+
+```bash
+# Output to terminal
+node examples/chatgpt-context.js
+
+# Copy to clipboard (macOS)
+node examples/chatgpt-context.js | pbcopy
+
+# Save to file
+node examples/chatgpt-context.js > context.txt
+```
+
+What it does:
+- Reads all MemoryLink files
+- Formats them as Markdown
+- Includes:
+  - Protected files list
+  - Project context/decisions
+  - Past solutions (SUCCESS/FAILED)
+  - Recent changes
+  - Instructions for AI
+
+Use case: Copy-paste project context into ChatGPT, Claude, or any chat AI.
+
+---
+
+### 3. `ci-integration.js`
+**CI/CD pipeline integration**
+
+```bash
+# Validate no protected files were modified
+node examples/ci-integration.js validate
+
+# Generate compliance report
+node examples/ci-integration.js report
+
+# Export all data
+node examples/ci-integration.js export
+```
+
+Use in GitHub Actions:
+
+```yaml
+# .github/workflows/memorylink.yml
+name: MemoryLink Validation
+
+on: [push, pull_request]
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 2  # Need previous commit for diff
+      
+      - uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+      
+      - run: npm install -g memorylink
+      - run: node examples/ci-integration.js validate
+```
+
+Use in GitLab CI:
+
+```yaml
+# .gitlab-ci.yml
+memorylink-validate:
+  stage: test
+  script:
+    - npm install -g memorylink
+    - node examples/ci-integration.js validate
+  only:
+    - merge_requests
+```
+
+---
+
+## 🔧 Creating Your Own Integration
+
+### Basic Pattern
+
+```javascript
+const fs = require('fs');
+const path = require('path');
+
+// Check if MemoryLink is initialized
+const memorylinkDir = path.join(process.cwd(), '.memorylink');
+if (!fs.existsSync(memorylinkDir)) {
+  console.error('MemoryLink not initialized! Run: memorylink init');
+  process.exit(1);
+}
+
+// Read files directly
+const protected = fs.readFileSync(
+  path.join(memorylinkDir, 'protected.txt'), 
+  'utf-8'
+);
+
+const memory = fs.readFileSync(
+  path.join(memorylinkDir, 'memory.log'), 
+  'utf-8'
+);
+
+// Or use CLI commands
+const { execSync } = require('child_process');
+const context = execSync('memorylink get-context', { encoding: 'utf-8' });
+```
+
+### File Formats
+
+**protected.txt** (one path per line):
+```
+.env
+src/config/secrets.ts
+*.key
+```
+
+**memory.log** (pipe-delimited):
+```
+2025-12-12T10:00:00Z|Project uses React 18|react,frontend
+2025-12-12T10:05:00Z|Auth uses JWT tokens|auth,security
+```
+
+**changes.log** (pipe-delimited):
+```
+2025-12-12T10:10:00Z|src/api.ts|Fixed timeout bug|cursor
+2025-12-12T10:15:00Z|src/auth.ts|Added JWT validation|human
+```
+
+**learnings.log** (pipe-delimited):
+```
+2025-12-12T10:20:00Z|API timeout errors|Increased timeout to 30s|SUCCESS|api,timeout
+2025-12-12T10:25:00Z|Memory leak|Wrong approach|FAILED|react,memory
+```
+
+---
+
+## 💡 More Ideas
+
+- **VS Code Extension**: Auto-inject MemoryLink context into AI chats
+- **Slack Bot**: Post daily summaries of AI changes
+- **Dashboard**: Web UI showing memory stats and audit trail
+- **IDE Plugin**: Show protected file warnings in editor
+- **Git Hook**: Remind to log changes before commit
+
+---
+
+## 🤝 Contributing
+
+Have a useful integration? Submit a PR to add it here!
+
+---
+
+*Built with MemoryLink - Universal AI Memory Layer*
+

package/examples/chatgpt-context.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+/**
+ * chatgpt-context.js
+ * 
+ * Example: Generate context for ChatGPT
+ * 
+ * This script shows how to prepare MemoryLink context
+ * for pasting into ChatGPT or any chat-based AI.
+ * 
+ * Usage:
+ *   node examples/chatgpt-context.js > context.txt
+ *   # Then paste context.txt into ChatGPT
+ * 
+ * Or copy directly to clipboard (macOS):
+ *   node examples/chatgpt-context.js | pbcopy
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+// ===========================================
+// CONFIGURATION
+// ===========================================
+const CONFIG = {
+  // How many entries to include
+  maxMemories: 10,
+  maxLearnings: 5,
+  maxChanges: 5,
+  
+  // Include protected files list
+  includeProtected: true,
+};
+
+// ===========================================
+// HELPER FUNCTIONS
+// ===========================================
+
+function readFile(filePath) {
+  try {
+    return fs.readFileSync(filePath, 'utf-8');
+  } catch {
+    return '';
+  }
+}
+
+function runCommand(cmd) {
+  try {
+    return execSync(cmd, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+  } catch {
+    return '';
+  }
+}
+
+// ===========================================
+// MAIN
+// ===========================================
+
+function main() {
+  const memorylinkDir = path.join(process.cwd(), '.memorylink');
+  
+  // Check if initialized
+  if (!fs.existsSync(memorylinkDir)) {
+    console.error('Error: MemoryLink not initialized. Run: memorylink init');
+    process.exit(1);
+  }
+  
+  // Build context output
+  const output = [];
+  
+  output.push('# Project Context for AI Assistant');
+  output.push('');
+  output.push('This context was generated by MemoryLink. Please follow these rules:');
+  output.push('');
+  
+  // Protected Files
+  if (CONFIG.includeProtected) {
+    const protected = readFile(path.join(memorylinkDir, 'protected.txt'));
+    if (protected.trim()) {
+      output.push('## ⛔ Protected Files (DO NOT MODIFY)');
+      output.push('');
+      output.push('```');
+      output.push(protected.trim());
+      output.push('```');
+      output.push('');
+    }
+  }
+  
+  // Memory/Context
+  const memoryContent = readFile(path.join(memorylinkDir, 'memory.log'));
+  if (memoryContent.trim()) {
+    output.push('## 📝 Project Context & Decisions');
+    output.push('');
+    const lines = memoryContent.trim().split('\n').slice(-CONFIG.maxMemories);
+    for (const line of lines) {
+      // Parse: timestamp|message|tags
+      const parts = line.split('|');
+      if (parts.length >= 2) {
+        const message = parts[1];
+        const tags = parts[2] || '';
+        output.push(`- ${message}${tags ? ` [${tags}]` : ''}`);
+      }
+    }
+    output.push('');
+  }
+  
+  // Learnings
+  const learningsContent = readFile(path.join(memorylinkDir, 'learnings.log'));
+  if (learningsContent.trim()) {
+    output.push('## 🎓 Past Solutions (Learn from these)');
+    output.push('');
+    const lines = learningsContent.trim().split('\n').slice(-CONFIG.maxLearnings);
+    for (const line of lines) {
+      // Parse: timestamp|problem|solution|status|tags
+      const parts = line.split('|');
+      if (parts.length >= 4) {
+        const problem = parts[1];
+        const solution = parts[2];
+        const status = parts[3];
+        const icon = status === 'SUCCESS' ? '✅' : '❌';
+        output.push(`- ${icon} **${problem}**: ${solution} (${status})`);
+      }
+    }
+    output.push('');
+  }
+  
+  // Recent Changes
+  const changesContent = readFile(path.join(memorylinkDir, 'changes.log'));
+  if (changesContent.trim()) {
+    output.push('## 📋 Recent Changes');
+    output.push('');
+    const lines = changesContent.trim().split('\n').slice(-CONFIG.maxChanges);
+    for (const line of lines) {
+      // Parse: timestamp|file|reason|agent
+      const parts = line.split('|');
+      if (parts.length >= 3) {
+        const file = parts[1];
+        const reason = parts[2];
+        output.push(`- \`${file}\`: ${reason}`);
+      }
+    }
+    output.push('');
+  }
+  
+  // Instructions
+  output.push('## Instructions for AI');
+  output.push('');
+  output.push('1. **DO NOT** modify files listed in Protected Files');
+  output.push('2. Consider the Project Context when making decisions');
+  output.push('3. Check Past Solutions before solving problems - avoid FAILED approaches');
+  output.push('4. Explain your changes so they can be logged');
+  output.push('');
+  output.push('---');
+  output.push('*Generated by MemoryLink - Universal AI Memory Layer*');
+  
+  // Output
+  console.log(output.join('\n'));
+}
+
+main();
+

package/examples/ci-integration.js

@@ -0,0 +1,288 @@
+#!/usr/bin/env node
+/**
+ * ci-integration.js
+ * 
+ * Example: CI/CD Integration for MemoryLink
+ * 
+ * This script shows how to use MemoryLink in CI pipelines:
+ * - Validate protected files weren't modified
+ * - Generate audit reports
+ * - Export memory for compliance
+ * 
+ * Usage in CI (GitHub Actions, GitLab CI, etc.):
+ *   node examples/ci-integration.js validate
+ *   node examples/ci-integration.js report
+ *   node examples/ci-integration.js export
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+// ===========================================
+// CONFIGURATION
+// ===========================================
+const CONFIG = {
+  // Exit code for violations
+  violationExitCode: 1,
+  
+  // Report output file
+  reportFile: 'memorylink-report.json',
+  
+  // Export output file
+  exportFile: 'memorylink-export.json',
+};
+
+// ===========================================
+// HELPER FUNCTIONS
+// ===========================================
+
+function checkMemoryLink() {
+  const memorylinkDir = path.join(process.cwd(), '.memorylink');
+  if (!fs.existsSync(memorylinkDir)) {
+    console.log('⚠️  MemoryLink not initialized in this project');
+    return false;
+  }
+  return true;
+}
+
+function getChangedFiles() {
+  try {
+    // Get files changed in the current commit/PR
+    const gitDiff = execSync('git diff --name-only HEAD~1', { 
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+    return gitDiff.trim().split('\n').filter(f => f);
+  } catch {
+    // Fallback: staged files
+    try {
+      const staged = execSync('git diff --cached --name-only', {
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe']
+      });
+      return staged.trim().split('\n').filter(f => f);
+    } catch {
+      return [];
+    }
+  }
+}
+
+function getProtectedFiles() {
+  const protectedPath = path.join(process.cwd(), '.memorylink', 'protected.txt');
+  if (!fs.existsSync(protectedPath)) return [];
+  
+  return fs.readFileSync(protectedPath, 'utf-8')
+    .split('\n')
+    .map(line => line.trim())
+    .filter(line => line && !line.startsWith('#'));
+}
+
+function matchesPattern(file, pattern) {
+  // Simple glob matching
+  if (pattern.includes('*')) {
+    const regex = new RegExp(
+      '^' + pattern.replace(/\./g, '\\.').replace(/\*/g, '.*') + '$'
+    );
+    return regex.test(file);
+  }
+  return file === pattern || file.startsWith(pattern + '/');
+}
+
+// ===========================================
+// COMMANDS
+// ===========================================
+
+/**
+ * Validate: Check if protected files were modified
+ */
+function validate() {
+  console.log('\n🔍 MemoryLink CI Validation\n');
+  console.log('='.repeat(40));
+  
+  if (!checkMemoryLink()) {
+    console.log('✅ Skipping validation (no MemoryLink)\n');
+    process.exit(0);
+  }
+  
+  const changedFiles = getChangedFiles();
+  const protectedFiles = getProtectedFiles();
+  
+  console.log(`📄 Changed files: ${changedFiles.length}`);
+  console.log(`🔒 Protected patterns: ${protectedFiles.length}`);
+  console.log('');
+  
+  const violations = [];
+  
+  for (const file of changedFiles) {
+    for (const pattern of protectedFiles) {
+      if (matchesPattern(file, pattern)) {
+        violations.push({ file, pattern });
+      }
+    }
+  }
+  
+  if (violations.length > 0) {
+    console.log('❌ PROTECTED FILE VIOLATIONS:\n');
+    for (const v of violations) {
+      console.log(`   ⛔ ${v.file}`);
+      console.log(`      Pattern: ${v.pattern}`);
+    }
+    console.log('\n');
+    console.log('These files are protected and should not be modified.');
+    console.log('Remove them from the commit or get explicit approval.\n');
+    process.exit(CONFIG.violationExitCode);
+  }
+  
+  console.log('✅ All changes validated - no protected files modified\n');
+  process.exit(0);
+}
+
+/**
+ * Report: Generate compliance report
+ */
+function report() {
+  console.log('\n📊 MemoryLink Compliance Report\n');
+  console.log('='.repeat(40));
+  
+  if (!checkMemoryLink()) {
+    console.log('⚠️  No MemoryLink data to report\n');
+    process.exit(0);
+  }
+  
+  const memorylinkDir = path.join(process.cwd(), '.memorylink');
+  
+  const reportData = {
+    timestamp: new Date().toISOString(),
+    project: path.basename(process.cwd()),
+    stats: {
+      protectedFiles: 0,
+      memories: 0,
+      changes: 0,
+      learnings: 0,
+      successfulLearnings: 0,
+      failedLearnings: 0,
+    },
+    protectedFiles: [],
+    recentChanges: [],
+  };
+  
+  // Count protected files
+  const protected = getProtectedFiles();
+  reportData.stats.protectedFiles = protected.length;
+  reportData.protectedFiles = protected;
+  
+  // Count memories
+  const memoryPath = path.join(memorylinkDir, 'memory.log');
+  if (fs.existsSync(memoryPath)) {
+    const lines = fs.readFileSync(memoryPath, 'utf-8').trim().split('\n').filter(l => l);
+    reportData.stats.memories = lines.length;
+  }
+  
+  // Count changes
+  const changesPath = path.join(memorylinkDir, 'changes.log');
+  if (fs.existsSync(changesPath)) {
+    const lines = fs.readFileSync(changesPath, 'utf-8').trim().split('\n').filter(l => l);
+    reportData.stats.changes = lines.length;
+    
+    // Get recent changes
+    const recentLines = lines.slice(-5);
+    for (const line of recentLines) {
+      const parts = line.split('|');
+      if (parts.length >= 3) {
+        reportData.recentChanges.push({
+          timestamp: parts[0],
+          file: parts[1],
+          reason: parts[2],
+          agent: parts[3] || 'unknown',
+        });
+      }
+    }
+  }
+  
+  // Count learnings
+  const learningsPath = path.join(memorylinkDir, 'learnings.log');
+  if (fs.existsSync(learningsPath)) {
+    const lines = fs.readFileSync(learningsPath, 'utf-8').trim().split('\n').filter(l => l);
+    reportData.stats.learnings = lines.length;
+    
+    for (const line of lines) {
+      const parts = line.split('|');
+      if (parts.length >= 4) {
+        if (parts[3] === 'SUCCESS') {
+          reportData.stats.successfulLearnings++;
+        } else if (parts[3] === 'FAILED') {
+          reportData.stats.failedLearnings++;
+        }
+      }
+    }
+  }
+  
+  // Output report
+  console.log(`\n📄 Project: ${reportData.project}`);
+  console.log(`📅 Generated: ${reportData.timestamp}\n`);
+  
+  console.log('📊 Statistics:');
+  console.log(`   Protected Files: ${reportData.stats.protectedFiles}`);
+  console.log(`   Memory Entries:  ${reportData.stats.memories}`);
+  console.log(`   Change Records:  ${reportData.stats.changes}`);
+  console.log(`   Learnings:       ${reportData.stats.learnings}`);
+  console.log(`     ✅ Successful: ${reportData.stats.successfulLearnings}`);
+  console.log(`     ❌ Failed:     ${reportData.stats.failedLearnings}`);
+  console.log('');
+  
+  // Save report
+  fs.writeFileSync(CONFIG.reportFile, JSON.stringify(reportData, null, 2));
+  console.log(`✅ Report saved to: ${CONFIG.reportFile}\n`);
+}
+
+/**
+ * Export: Export all data for compliance
+ */
+function exportData() {
+  console.log('\n📦 MemoryLink Data Export\n');
+  console.log('='.repeat(40));
+  
+  if (!checkMemoryLink()) {
+    console.log('⚠️  No MemoryLink data to export\n');
+    process.exit(0);
+  }
+  
+  try {
+    execSync(`memorylink export ${CONFIG.exportFile}`, { stdio: 'inherit' });
+    console.log(`\n✅ Data exported to: ${CONFIG.exportFile}\n`);
+  } catch (err) {
+    console.error('❌ Export failed\n');
+    process.exit(1);
+  }
+}
+
+// ===========================================
+// MAIN
+// ===========================================
+
+function main() {
+  const command = process.argv[2];
+  
+  switch (command) {
+    case 'validate':
+      validate();
+      break;
+    case 'report':
+      report();
+      break;
+    case 'export':
+      exportData();
+      break;
+    default:
+      console.log('\n🔧 MemoryLink CI Integration\n');
+      console.log('Usage:');
+      console.log('  node examples/ci-integration.js validate  # Check protected files');
+      console.log('  node examples/ci-integration.js report    # Generate report');
+      console.log('  node examples/ci-integration.js export    # Export all data');
+      console.log('');
+  }
+}
+
+main();
+