cerber-core 1.0.0

package/solo/scripts/cerber-snapshot.js

@@ -0,0 +1,319 @@
+#!/usr/bin/env node
+
+/**
+ * Cerber SOLO - Snapshot Tool
+ * 
+ * Extends Cerber Core with automation for solo developers
+ * 
+ * Captures:
+ * - Git statistics
+ * - File counts
+ * - LOC metrics
+ * - Guardian status
+ * - Saves to .cerber/snapshots/ (30-day retention)
+ * 
+ * @author Stefan Pitek
+ * @copyright 2026 Stefan Pitek
+ * @license MIT
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+console.log('📸 Cerber SOLO - Daily Snapshot\n');
+
+const snapshotDir = path.join(process.cwd(), '.cerber', 'snapshots');
+const date = new Date();
+const dateStr = date.toISOString().split('T')[0];
+const timestamp = date.toISOString();
+
+// Create snapshot directory
+if (!fs.existsSync(snapshotDir)) {
+  fs.mkdirSync(snapshotDir, { recursive: true });
+  console.log(`✅ Created snapshot directory: ${snapshotDir}\n`);
+}
+
+const snapshot = {
+  date: dateStr,
+  timestamp: timestamp,
+  version: '2.0-solo'
+};
+
+/**
+ * Capture Git statistics
+ */
+function captureGitStats() {
+  console.log('📊 Capturing Git statistics...');
+  
+  try {
+    // Total commits
+    const totalCommits = execSync('git rev-list --all --count', { 
+      encoding: 'utf8',
+      stdio: 'pipe'
+    }).trim();
+    
+    snapshot.git = {
+      totalCommits: parseInt(totalCommits)
+    };
+    
+    // Today's commits
+    const todayCommits = execSync(`git log --since="00:00:00" --oneline | wc -l`, { 
+      encoding: 'utf8',
+      stdio: 'pipe'
+    }).trim();
+    
+    snapshot.git.commitsToday = parseInt(todayCommits);
+    
+    // Current branch
+    const branch = execSync('git rev-parse --abbrev-ref HEAD', { 
+      encoding: 'utf8',
+      stdio: 'pipe'
+    }).trim();
+    
+    snapshot.git.branch = branch;
+    
+    // Get today's stats
+    try {
+      const stats = execSync(`git diff --shortstat HEAD~1..HEAD 2>/dev/null || echo "0 files changed"`, { 
+        encoding: 'utf8',
+        stdio: 'pipe'
+      }).trim();
+      
+      const filesMatch = stats.match(/(\d+) file[s]? changed/);
+      const insertionsMatch = stats.match(/(\d+) insertion[s]?\(\+\)/);
+      const deletionsMatch = stats.match(/(\d+) deletion[s]?\(-\)/);
+      
+      snapshot.git.filesChanged = filesMatch ? parseInt(filesMatch[1]) : 0;
+      snapshot.git.linesAdded = insertionsMatch ? parseInt(insertionsMatch[1]) : 0;
+      snapshot.git.linesRemoved = deletionsMatch ? parseInt(deletionsMatch[1]) : 0;
+    } catch (error) {
+      // First commit or no changes
+      snapshot.git.filesChanged = 0;
+      snapshot.git.linesAdded = 0;
+      snapshot.git.linesRemoved = 0;
+    }
+    
+    console.log(`   ✅ Total commits: ${snapshot.git.totalCommits}`);
+    console.log(`   ✅ Today's commits: ${snapshot.git.commitsToday}`);
+    console.log(`   ✅ Branch: ${snapshot.git.branch}`);
+    console.log(`   ✅ Files changed: ${snapshot.git.filesChanged}`);
+    console.log(`   ✅ Lines: +${snapshot.git.linesAdded} -${snapshot.git.linesRemoved}`);
+  } catch (error) {
+    console.log('   ⚠️  Not a git repository');
+    snapshot.git = { error: 'Not a git repository' };
+  }
+  
+  console.log();
+}
+
+/**
+ * Count files by type
+ */
+function captureFileCounts() {
+  console.log('📁 Counting files...');
+  
+  const extensions = {
+    '.ts': 0,
+    '.tsx': 0,
+    '.js': 0,
+    '.jsx': 0,
+    '.json': 0,
+    '.md': 0
+  };
+  
+  function countFiles(dir) {
+    if (!fs.existsSync(dir)) return;
+    
+    // Skip node_modules, dist, build, etc.
+    const skipDirs = ['node_modules', 'dist', 'build', '.git', '.next', 'out', 'coverage'];
+    const dirName = path.basename(dir);
+    if (skipDirs.includes(dirName)) return;
+    
+    const files = fs.readdirSync(dir);
+    
+    files.forEach(file => {
+      const filePath = path.join(dir, file);
+      const stat = fs.statSync(filePath);
+      
+      if (stat.isDirectory()) {
+        countFiles(filePath);
+      } else {
+        const ext = path.extname(file);
+        if (extensions.hasOwnProperty(ext)) {
+          extensions[ext]++;
+        }
+      }
+    });
+  }
+  
+  countFiles(process.cwd());
+  
+  snapshot.files = extensions;
+  
+  const total = Object.values(extensions).reduce((a, b) => a + b, 0);
+  console.log(`   ✅ Total files: ${total}`);
+  Object.entries(extensions).forEach(([ext, count]) => {
+    if (count > 0) {
+      console.log(`      ${ext}: ${count}`);
+    }
+  });
+  
+  console.log();
+}
+
+/**
+ * Count lines of code
+ */
+function captureLOC() {
+  console.log('📏 Counting lines of code...');
+  
+  try {
+    // Use cloc if available, otherwise use simple wc
+    try {
+      const clocOutput = execSync('cloc . --json 2>/dev/null', { 
+        encoding: 'utf8',
+        maxBuffer: 10 * 1024 * 1024
+      });
+      
+      const clocData = JSON.parse(clocOutput);
+      
+      if (clocData.SUM) {
+        snapshot.loc = {
+          total: clocData.SUM.code || 0,
+          comments: clocData.SUM.comment || 0,
+          blank: clocData.SUM.blank || 0
+        };
+        
+        console.log(`   ✅ Code lines: ${snapshot.loc.total}`);
+        console.log(`   ✅ Comments: ${snapshot.loc.comments}`);
+        console.log(`   ✅ Blank lines: ${snapshot.loc.blank}`);
+      }
+    } catch (error) {
+      // cloc not available, use simple line count
+      const tsLines = execSync(`find . -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" | grep -v node_modules | xargs wc -l 2>/dev/null | tail -1 | awk '{print $1}' || echo 0`, { 
+        encoding: 'utf8'
+      }).trim();
+      
+      snapshot.loc = {
+        total: parseInt(tsLines) || 0,
+        method: 'simple'
+      };
+      
+      console.log(`   ✅ Estimated lines: ${snapshot.loc.total}`);
+      console.log('   ℹ️  Install cloc for detailed stats');
+    }
+  } catch (error) {
+    console.log('   ⚠️  Could not count LOC');
+    snapshot.loc = { error: error.message };
+  }
+  
+  console.log();
+}
+
+/**
+ * Check Guardian status
+ */
+function captureGuardianStatus() {
+  console.log('🛡️  Checking Guardian status...');
+  
+  const guardianPaths = [
+    'scripts/validate-schema.mjs',
+    'scripts/validate-schema.js',
+    '.husky/pre-commit'
+  ];
+  
+  const guardianExists = guardianPaths.some(p => 
+    fs.existsSync(path.join(process.cwd(), p))
+  );
+  
+  snapshot.guardian = {
+    installed: guardianExists
+  };
+  
+  console.log(`   ${guardianExists ? '✅' : '⚠️'}  Guardian: ${guardianExists ? 'installed' : 'not detected'}`);
+  console.log();
+}
+
+/**
+ * Check package.json info
+ */
+function capturePackageInfo() {
+  console.log('📦 Checking package info...');
+  
+  const packagePath = path.join(process.cwd(), 'package.json');
+  
+  if (fs.existsSync(packagePath)) {
+    try {
+      const packageData = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
+      
+      snapshot.package = {
+        name: packageData.name || 'unknown',
+        version: packageData.version || '0.0.0',
+        dependencies: Object.keys(packageData.dependencies || {}).length,
+        devDependencies: Object.keys(packageData.devDependencies || {}).length
+      };
+      
+      console.log(`   ✅ Project: ${snapshot.package.name}@${snapshot.package.version}`);
+      console.log(`   ✅ Dependencies: ${snapshot.package.dependencies}`);
+      console.log(`   ✅ Dev dependencies: ${snapshot.package.devDependencies}`);
+    } catch (error) {
+      console.log('   ⚠️  Could not parse package.json');
+    }
+  } else {
+    console.log('   ℹ️  No package.json found');
+  }
+  
+  console.log();
+}
+
+// Capture all data
+captureGitStats();
+captureFileCounts();
+captureLOC();
+captureGuardianStatus();
+capturePackageInfo();
+
+// Save snapshot
+const snapshotPath = path.join(snapshotDir, `${dateStr}.json`);
+fs.writeFileSync(snapshotPath, JSON.stringify(snapshot, null, 2), 'utf8');
+
+console.log('💾 Snapshot saved!');
+console.log(`   Location: ${snapshotPath}\n`);
+
+// Cleanup old snapshots (keep 30 days)
+console.log('🧹 Cleaning up old snapshots...');
+
+try {
+  const files = fs.readdirSync(snapshotDir);
+  const now = Date.now();
+  const thirtyDaysAgo = now - (30 * 24 * 60 * 60 * 1000);
+  
+  let deleted = 0;
+  
+  files.forEach(file => {
+    const filePath = path.join(snapshotDir, file);
+    const stat = fs.statSync(filePath);
+    
+    if (stat.mtime.getTime() < thirtyDaysAgo) {
+      fs.unlinkSync(filePath);
+      deleted++;
+    }
+  });
+  
+  if (deleted > 0) {
+    console.log(`   ✅ Deleted ${deleted} old snapshot(s)`);
+  } else {
+    console.log(`   ✅ No old snapshots to delete`);
+  }
+} catch (error) {
+  console.log('   ⚠️  Could not cleanup old snapshots');
+}
+
+console.log();
+console.log('='.repeat(60));
+console.log('\n✅ Snapshot complete!\n');
+console.log('📊 View your snapshots in: .cerber/snapshots/\n');
+console.log('='.repeat(60));
+
+process.exit(0);

package/team/README.md

@@ -0,0 +1,327 @@
+# 🛡️ Cerber TEAM - Quick Start
+
+**Team collaboration layer for large codebases**
+
+Author: Stefan Pitek  
+Version: 2.0-team
+
+---
+
+## What is Cerber TEAM?
+
+Cerber TEAM adds module system and focus mode to help teams work on large codebases more efficiently.
+
+**Key Features:**
+- **📦 Module System** - Clear boundaries between components
+- **🎯 Focus Mode** - AI gets 500 LOC instead of 10,000 LOC (10x faster)
+- **🔗 Connection Contracts** - Explicit interfaces between modules
+- **📖 BIBLE.md** - Master project map
+- **✅ Validation** - Enforce module boundaries automatically
+
+---
+
+## Quick Start (5 minutes)
+
+### 1. Setup
+
+```bash
+# Create .cerber directory
+mkdir -p .cerber/modules
+mkdir -p .cerber/connections/contracts
+
+# Create project BIBLE
+cp team/templates/BIBLE_TEMPLATE.md .cerber/BIBLE.md
+
+# Edit BIBLE.md to describe your project
+nano .cerber/BIBLE.md
+```
+
+### 2. Create Your First Module
+
+```bash
+# Create module
+bash team/scripts/cerber-add-module.sh my-first-module
+
+# Output:
+# ✅ Created .cerber/modules/my-first-module/
+# ✅ MODULE.md created from template
+# ✅ contract.json initialized
+# ✅ dependencies.json created
+# ✅ BIBLE.md updated
+
+# Edit module documentation
+nano .cerber/modules/my-first-module/MODULE.md
+```
+
+### 3. Use Focus Mode
+
+```bash
+# Generate focus context (10x faster AI)
+bash team/scripts/cerber-focus.sh my-first-module
+
+# Output:
+# ✅ Focus context created: .cerber/FOCUS_CONTEXT.md
+# 📖 Context contains 500 LOC (vs 10,000 LOC for whole project)
+# 🤖 AI can now work 10x faster
+
+# View the context
+cat .cerber/FOCUS_CONTEXT.md
+
+# Share this with AI instead of entire codebase!
+```
+
+### 4. Validate
+
+```bash
+# Validate module
+bash team/scripts/cerber-module-check.sh my-first-module
+
+# Output:
+# ✅ MODULE.md exists
+# ✅ contract.json valid
+# ✅ All dependencies declared
+# ✅ MODULE CHECK PASSED
+
+# Validate connections
+bash team/scripts/cerber-connections-check.sh
+```
+
+### 5. Daily Workflow
+
+```bash
+# Morning dashboard
+bash team/scripts/cerber-team-morning.sh
+
+# Shows:
+# - All modules and their health
+# - Connection contracts status
+# - Recent activity
+# - Today's focus
+
+# Work on a module
+bash team/scripts/cerber-focus.sh my-module
+# [Share FOCUS_CONTEXT.md with AI]
+# [Make changes]
+
+# Validate before commit
+bash team/scripts/cerber-module-check.sh my-module
+git commit
+```
+
+---
+
+## Scripts Reference
+
+### cerber-add-module.sh
+Creates new module from template
+
+```bash
+bash team/scripts/cerber-add-module.sh <module-name>
+```
+
+### cerber-focus.sh ⭐ MOST IMPORTANT
+Generates FOCUS_CONTEXT.md for a module (10x faster AI)
+
+```bash
+bash team/scripts/cerber-focus.sh <module-name>
+```
+
+### cerber-module-check.sh
+Validates single module
+
+```bash
+bash team/scripts/cerber-module-check.sh <module-name>
+```
+
+### cerber-connections-check.sh
+Validates all connection contracts
+
+```bash
+bash team/scripts/cerber-connections-check.sh
+```
+
+### cerber-team-morning.sh
+Team morning dashboard
+
+```bash
+bash team/scripts/cerber-team-morning.sh
+```
+
+---
+
+## Module Structure
+
+Every module has:
+
+```
+.cerber/modules/my-module/
+├── MODULE.md          # Complete documentation
+├── contract.json      # Public interface (versioned)
+└── dependencies.json  # List of dependencies
+```
+
+**MODULE.md** - Human-readable documentation:
+- Purpose and responsibilities
+- Public interface (functions, parameters, returns)
+- Dependencies and why
+- File structure
+- Testing instructions
+
+**contract.json** - Machine-readable interface:
+- Version (semver)
+- Public functions with types
+- Dependencies list
+
+**dependencies.json** - Explicit dependencies:
+- List of modules this module uses
+- Reason for each dependency
+
+---
+
+## Connection Contracts
+
+Document how modules communicate:
+
+```json
+{
+  "id": "module-a-to-module-b",
+  "from": "module-a",
+  "to": "module-b",
+  "type": "function-call",
+  "interface": {
+    "function": "processData",
+    "input": { "type": "ProcessParams", "fields": [...] },
+    "output": { "type": "ProcessResult", "fields": [...] }
+  },
+  "version": "1.0.0",
+  "breaking_changes": []
+}
+```
+
+**Create contract:**
+```bash
+cp team/templates/CONNECTION_TEMPLATE.json \
+   .cerber/connections/contracts/module-a-to-module-b.json
+
+# Edit the contract
+nano .cerber/connections/contracts/module-a-to-module-b.json
+
+# Validate
+bash team/scripts/cerber-connections-check.sh
+```
+
+---
+
+## BIBLE.md
+
+Master project map showing:
+- Architecture overview
+- All modules and owners
+- Connections between modules
+- Team responsibilities
+- Tech stack
+
+**Create BIBLE:**
+```bash
+cp team/templates/BIBLE_TEMPLATE.md .cerber/BIBLE.md
+nano .cerber/BIBLE.md
+```
+
+---
+
+## Integration with Guardian + Cerber + SOLO
+
+Cerber TEAM works alongside existing tools:
+
+```
+Morning:
+  bash team/scripts/cerber-team-morning.sh  (TEAM dashboard)
+  
+Development:
+  bash team/scripts/cerber-focus.sh <module>  (TEAM focus mode)
+  git commit                                  (Guardian validates)
+  
+Pre-push:
+  npm run cerber:pre-push                     (SOLO checks)
+  
+Deploy:
+  curl /api/health                           (Cerber 2.1 validates)
+```
+
+---
+
+## Add to package.json
+
+```json
+{
+  "scripts": {
+    "cerber:morning": "bash team/scripts/cerber-team-morning.sh",
+    "cerber:focus": "bash team/scripts/cerber-focus.sh",
+    "cerber:add-module": "bash team/scripts/cerber-add-module.sh",
+    "cerber:check-module": "bash team/scripts/cerber-module-check.sh",
+    "cerber:check-connections": "bash team/scripts/cerber-connections-check.sh"
+  }
+}
+```
+
+---
+
+## Example Project
+
+See `.cerber-example/` for complete working example:
+- BIBLE.md
+- CERBER_LAW.md
+- Two complete modules (pricing-engine, booking-calendar)
+- Connection contracts
+
+Study these files to understand best practices!
+
+---
+
+## Documentation
+
+**Full documentation:** [docs/TEAM.md](../docs/TEAM.md) (20+ KB)
+
+Topics covered:
+- Complete installation guide
+- Module system deep dive
+- Focus mode workflow
+- Connection contracts guide
+- Team collaboration workflows
+- Best practices
+- Troubleshooting
+- FAQ
+
+---
+
+## Benefits
+
+**Before TEAM:**
+- AI processes 10,000 LOC → 60 seconds
+- Unclear module boundaries
+- Hidden dependencies
+- Documentation drift
+
+**After TEAM:**
+- AI processes 500 LOC → 6 seconds (10x faster ⚡)
+- Clear module boundaries
+- Explicit dependencies
+- Living documentation
+
+---
+
+## License
+
+MIT © 2026 Stefan Pitek
+
+---
+
+## Support
+
+- **Documentation:** [docs/TEAM.md](../docs/TEAM.md)
+- **Examples:** `.cerber-example/`
+- **Issues:** https://github.com/Agaslez/cerber-core/issues
+
+---
+
+**Built with ❤️ by Stefan Pitek**

package/team/config/team-contract.json

@@ -0,0 +1,27 @@
+{
+  "version": "2.0-team",
+  "extends": "cerber-core",
+  "team": {
+    "enabled": true,
+    "modulesPath": ".cerber/modules",
+    "connectionsPath": ".cerber/connections/contracts",
+    "biblePath": ".cerber/BIBLE.md"
+  },
+  "moduleValidation": {
+    "requireModuleMd": true,
+    "requireContract": true,
+    "requireDependencies": true,
+    "forbiddenCrossModuleImports": true
+  },
+  "focusMode": {
+    "enabled": true,
+    "outputPath": ".cerber/FOCUS_CONTEXT.md",
+    "includeContracts": true,
+    "includeDependencies": true
+  },
+  "connectionValidation": {
+    "requireBidirectional": true,
+    "checkBreakingChanges": true,
+    "detectCircular": true
+  }
+}