cerber-core 1.0.4 → 1.1.0

package/package.json

@@ -1,104 +1,106 @@
-{
-  "name": "cerber-core",
-  "version": "1.0.4",
-  "description": "Your architecture roadmap becomes executable law. Guardian blocks commits that violate your plan. Pay architect once, Cerber enforces forever. Save $6k/month/dev.",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "type": "module",
-  "bin": {
-    "cerber": "./bin/cerber",
-    "cerber-guardian": "./bin/cerber-guardian",
-    "cerber-health": "./bin/cerber-health",
-    "cerber-focus": "./bin/cerber-focus",
-    "cerber-morning": "./bin/cerber-morning",
-    "cerber-repair": "./bin/cerber-repair"
-  },
-  "exports": {
-    ".": "./dist/index.js",
-    "./guardian": "./dist/guardian/index.js",
-    "./cerber": "./dist/cerber/index.js",
-    "./types": "./dist/types.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "jest",
-    "lint": "eslint src/**/*.ts",
-    "format": "prettier --write \"src/**/*.ts\"",
-    "prepublishOnly": "npm run build",
-    "validate": "node bin/cerber-guardian",
-    "health-check": "node bin/cerber-health",
-    "morning": "node solo/scripts/cerber-daily-check.js",
-    "repair": "node solo/scripts/cerber-auto-repair.js",
-    "repair:dry": "node solo/scripts/cerber-auto-repair.js --dry-run",
-    "dashboard": "node solo/scripts/cerber-dashboard.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Agaslez/cerber-core.git"
-  },
-  "keywords": [
-    "pre-commit",
-    "code-quality",
-    "architecture",
-    "validation",
-    "health-check",
-    "monitoring",
-    "cerber",
-    "guardian",
-    "typescript",
-    "ci-cd",
-    "automation",
-    "team-collaboration",
-    "solo-developer",
-    "focus-mode",
-    "module-system"
-  ],
-  "author": {
-    "name": "Agata Sleziak",
-    "email": "agata@example.com",
-    "url": "https://github.com/Agaslez"
-  },
-  "contributors": [
-    {
-      "name": "Stefan Pitek",
-      "role": "Collaborator"
-    }
-  ],
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/Agaslez/cerber-core/issues"
-  },
-  "homepage": "https://github.com/Agaslez/cerber-core#readme",
-  "peerDependencies": {
-    "typescript": ">=5.0.0"
-  },
-  "dependencies": {
-    "chalk": "^5.3.0",
-    "commander": "^12.0.0"
-  },
-  "devDependencies": {
-    "@types/jest": "^29.5.0",
-    "@types/node": "^20.0.0",
-    "@typescript-eslint/eslint-plugin": "^6.0.0",
-    "@typescript-eslint/parser": "^6.0.0",
-    "eslint": "^8.50.0",
-    "jest": "^29.7.0",
-    "prettier": "^3.0.0",
-    "ts-jest": "^29.1.0",
-    "typescript": "^5.3.0"
-  },
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "files": [
-    "dist",
-    "bin",
-    "solo",
-    "team",
-    "examples",
-    ".cerber-example",
-    "LICENSE",
-    "README.md",
-    "CHANGELOG.md"
-  ]
-}
+{
+  "name": "cerber-core",
+  "version": "1.1.0",
+  "description": "Your architecture roadmap becomes executable law. Guardian blocks commits that violate your plan. Pay architect once, Cerber enforces forever. Save $6k/month/dev.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "cerber": "./bin/cerber",
+    "cerber-guardian": "./bin/cerber-guardian",
+    "cerber-health": "./bin/cerber-health",
+    "cerber-focus": "./bin/cerber-focus",
+    "cerber-morning": "./bin/cerber-morning",
+    "cerber-repair": "./bin/cerber-repair"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./guardian": "./dist/guardian/index.js",
+    "./cerber": "./dist/cerber/index.js",
+    "./types": "./dist/types.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "prepublishOnly": "npm run build",
+    "validate": "node bin/cerber-guardian",
+    "health-check": "node bin/cerber-health",
+    "morning": "node solo/scripts/cerber-daily-check.js",
+    "repair": "node solo/scripts/cerber-auto-repair.js",
+    "repair:dry": "node solo/scripts/cerber-auto-repair.js --dry-run",
+    "dashboard": "node solo/scripts/cerber-dashboard.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Agaslez/cerber-core.git"
+  },
+  "keywords": [
+    "pre-commit",
+    "code-quality",
+    "architecture",
+    "validation",
+    "health-check",
+    "monitoring",
+    "cerber",
+    "guardian",
+    "typescript",
+    "ci-cd",
+    "automation",
+    "team-collaboration",
+    "solo-developer",
+    "focus-mode",
+    "module-system"
+  ],
+  "author": {
+    "name": "Agata Sleziak",
+    "email": "agata@example.com",
+    "url": "https://github.com/Agaslez"
+  },
+  "contributors": [
+    {
+      "name": "Stefan Pitek",
+      "role": "Collaborator"
+    }
+  ],
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Agaslez/cerber-core/issues"
+  },
+  "homepage": "https://github.com/Agaslez/cerber-core#readme",
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.50.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.0.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "examples",
+    ".cerber-example",
+    "solo",
+    "dev",
+    "team",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md",
+    "USAGE_GUIDE.md"
+  ]
+}

package/solo/templates/cerber-guardian.mjs.tpl

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+// Generated by Cerber init - DO NOT EDIT MANUALLY
+// To regenerate: npx cerber init --force
+
+import { execSync } from 'child_process';
+import fs from 'fs';
+
+const SCHEMA_FILE = '{{SCHEMA_FILE}}';
+const APPROVALS_TAG = '{{APPROVALS_TAG}}';
+
+async function main() {
+  console.log('🛡️  Cerber Guardian: Validating staged files...');
+
+  if (!fs.existsSync(SCHEMA_FILE)) {
+    console.error(`❌ Schema file not found: ${SCHEMA_FILE}`);
+    console.error('Guardian MVP: schema missing. Add your rules to proceed.');
+    process.exit(1);
+  }
+
+  let stagedFiles;
+  try {
+    stagedFiles = execSync('git diff --cached --name-only', { encoding: 'utf-8' })
+      .trim()
+      .split('\n')
+      .filter(Boolean);
+  } catch (err) {
+    console.error('❌ Failed to get staged files');
+    process.exit(1);
+  }
+
+  if (stagedFiles.length === 0) {
+    console.log('✅ No files staged for commit');
+    return;
+  }
+
+  console.log(`Checking ${stagedFiles.length} file(s)...`);
+  console.log('Guardian MVP: schema detected. Add validation rules to enforce imports/forbidden patterns.');
+  console.log('✅ All checks passed');
+}
+
+main().catch(err => {
+  console.error('❌ Guardian check failed:', err?.message || err);
+  process.exit(1);
+});

package/solo/templates/cerber.yml.tpl

@@ -0,0 +1,53 @@
+# Generated by Cerber init
+name: Cerber CI
+
+on:
+  push:
+    branches: {{CI_BRANCHES}}
+  pull_request:
+    branches: {{CI_BRANCHES}}
+  workflow_dispatch:
+
+jobs:
+  cerber-ci:
+    name: Cerber CI
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build (if script exists)
+        run: |
+          if npm run | grep -q "build"; then
+            npm run build
+          else
+            echo "No build script defined; skipping"
+          fi
+
+      - name: Test (if script exists)
+        run: |
+          if npm run | grep -q "test"; then
+            npm test
+          else
+            echo "No test script defined; skipping"
+          fi
+
+      - name: Run Guardian
+        run: |
+          if npm run | grep -q "cerber:guardian"; then
+            npm run cerber:guardian
+          else
+            node scripts/cerber-guardian.mjs
+          fi
+
+{{POST_DEPLOY_BLOCK}}

package/solo/templates/health-checks.ts.tpl

@@ -0,0 +1,29 @@
+// Generated by Cerber init - CUSTOMIZE THIS FILE
+// To regenerate template: npx cerber init --force
+
+import { CerberCheck, makeIssue } from 'cerber-core';
+
+export const checks: Record<string, CerberCheck> = {
+  database: async () => {
+    // TODO: Implement your database health check
+    // Example:
+    // try {
+    //   await db.query('SELECT 1');
+    //   return [];
+    // } catch (err) {
+    //   return [
+    //     makeIssue({
+    //       code: 'DB_CONNECTION_FAILED',
+    //       component: 'database',
+    //       diagnosis: 'Cannot connect to database',
+    //       rootCause: 'Database server is down or unreachable',
+    //       fix: 'Check DATABASE_URL and verify DB is running',
+    //       severity: 'critical',
+    //       durationMs: 0
+    //     })
+    //   ];
+    // }
+
+    return []; // Placeholder - implement your check
+  },
+};

package/solo/templates/health-route.ts.tpl

@@ -0,0 +1,50 @@
+// Generated by Cerber init - CUSTOMIZE THIS FILE
+
+import { checks } from './health-checks.js';
+
+export async function healthHandler(req: any, res: any) {
+  const startTime = Date.now();
+
+  try {
+    const results = await Promise.all(
+      Object.entries(checks).map(async ([name, check]) => ({
+        name,
+        issues: await check()
+      }))
+    );
+
+    const allIssues = results.flatMap(r => r.issues);
+    const critical = allIssues.filter(i => i.severity === 'critical').length;
+    const errors = allIssues.filter(i => i.severity === 'error').length;
+    const warnings = allIssues.filter(i => i.severity === 'warning').length;
+
+    const status = critical > 0 ? 'unhealthy' :
+                   errors > 0 ? 'degraded' : 'healthy';
+
+    const statusCode = status === 'healthy' ? 200 : 503;
+
+    res.status(statusCode).json({
+      status,
+      timestamp: new Date().toISOString(),
+      durationMs: Date.now() - startTime,
+      summary: {
+        totalChecks: results.length,
+        failedChecks: results.filter(r => r.issues.length > 0).length,
+        criticalIssues: critical,
+        errorIssues: errors,
+        warningIssues: warnings
+      },
+      components: allIssues
+    });
+  } catch (err: any) {
+    res.status(503).json({
+      status: 'error',
+      message: 'Health check failed',
+      error: err.message
+    });
+  }
+}
+
+// Usage in your server:
+// import { healthHandler } from './cerber/health-route.js';
+// app.get('{{HEALTH_ENDPOINT}}', healthHandler);

package/solo/templates/pre-commit.tpl

@@ -0,0 +1,4 @@
+#!/bin/sh
+# Generated by Cerber init
+
+npm run cerber:guardian

package/team/templates/CODEOWNERS.tpl

@@ -0,0 +1,6 @@
+# Generated by Cerber init
+
+/CERBER.md {{OWNERS}}
+/{{SCHEMA_FILE}} {{OWNERS}}
+/.github/workflows/cerber.yml {{OWNERS}}
+/scripts/cerber-guardian.mjs {{OWNERS}}

package/team/templates/cerber-guardian.mjs.tpl

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+// Generated by Cerber init - DO NOT EDIT MANUALLY
+// To regenerate: npx cerber init --force
+
+import { execSync } from 'child_process';
+import fs from 'fs';
+
+const SCHEMA_FILE = '{{SCHEMA_FILE}}';
+const APPROVALS_TAG = '{{APPROVALS_TAG}}';
+
+async function main() {
+  console.log('🛡️  Cerber Guardian: Validating staged files...');
+
+  if (!fs.existsSync(SCHEMA_FILE)) {
+    console.error(`❌ Schema file not found: ${SCHEMA_FILE}`);
+    console.error('Guardian MVP: schema missing. Add your rules to proceed.');
+    process.exit(1);
+  }
+
+  let stagedFiles;
+  try {
+    stagedFiles = execSync('git diff --cached --name-only', { encoding: 'utf-8' })
+      .trim()
+      .split('\n')
+      .filter(Boolean);
+  } catch (err) {
+    console.error('❌ Failed to get staged files');
+    process.exit(1);
+  }
+
+  if (stagedFiles.length === 0) {
+    console.log('✅ No files staged for commit');
+    return;
+  }
+
+  console.log(`Checking ${stagedFiles.length} file(s)...`);
+  console.log('Guardian MVP: schema detected. Add validation rules to enforce imports/forbidden patterns.');
+  console.log('✅ All checks passed');
+}
+
+main().catch(err => {
+  console.error('❌ Guardian check failed:', err?.message || err);
+  process.exit(1);
+});

package/team/templates/cerber.yml.tpl

@@ -0,0 +1,53 @@
+# Generated by Cerber init
+name: Cerber CI
+
+on:
+  push:
+    branches: {{CI_BRANCHES}}
+  pull_request:
+    branches: {{CI_BRANCHES}}
+  workflow_dispatch:
+
+jobs:
+  cerber-ci:
+    name: Cerber CI
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build (if script exists)
+        run: |
+          if npm run | grep -q "build"; then
+            npm run build
+          else
+            echo "No build script defined; skipping"
+          fi
+
+      - name: Test (if script exists)
+        run: |
+          if npm run | grep -q "test"; then
+            npm test
+          else
+            echo "No test script defined; skipping"
+          fi
+
+      - name: Run Guardian
+        run: |
+          if npm run | grep -q "cerber:guardian"; then
+            npm run cerber:guardian
+          else
+            node scripts/cerber-guardian.mjs
+          fi
+
+{{POST_DEPLOY_BLOCK}}

package/team/templates/health-checks.ts.tpl

@@ -0,0 +1,10 @@
+// Generated by Cerber init - CUSTOMIZE THIS FILE
+// To regenerate template: npx cerber init --force
+
+import { CerberCheck, makeIssue } from 'cerber-core';
+
+export const checks: Record<string, CerberCheck> = {
+  database: async () => {
+    return [];
+  },
+};

package/team/templates/health-route.ts.tpl

@@ -0,0 +1,50 @@
+// Generated by Cerber init - CUSTOMIZE THIS FILE
+
+import { checks } from './health-checks.js';
+
+export async function healthHandler(req: any, res: any) {
+  const startTime = Date.now();
+
+  try {
+    const results = await Promise.all(
+      Object.entries(checks).map(async ([name, check]) => ({
+        name,
+        issues: await check()
+      }))
+    );
+
+    const allIssues = results.flatMap(r => r.issues);
+    const critical = allIssues.filter(i => i.severity === 'critical').length;
+    const errors = allIssues.filter(i => i.severity === 'error').length;
+    const warnings = allIssues.filter(i => i.severity === 'warning').length;
+
+    const status = critical > 0 ? 'unhealthy' :
+                   errors > 0 ? 'degraded' : 'healthy';
+
+    const statusCode = status === 'healthy' ? 200 : 503;
+
+    res.status(statusCode).json({
+      status,
+      timestamp: new Date().toISOString(),
+      durationMs: Date.now() - startTime,
+      summary: {
+        totalChecks: results.length,
+        failedChecks: results.filter(r => r.issues.length > 0).length,
+        criticalIssues: critical,
+        errorIssues: errors,
+        warningIssues: warnings
+      },
+      components: allIssues
+    });
+  } catch (err: any) {
+    res.status(503).json({
+      status: 'error',
+      message: 'Health check failed',
+      error: err.message
+    });
+  }
+}
+
+// Usage in your server:
+// import { healthHandler } from './cerber/health-route.js';
+// app.get('{{HEALTH_ENDPOINT}}', healthHandler);

package/team/templates/pre-commit.tpl

@@ -0,0 +1,4 @@
+#!/bin/sh
+# Generated by Cerber init
+
+npm run cerber:guardian