cerber-core 1.0.0

package/dist/guardian/index.js

@@ -0,0 +1,271 @@
+/**
+ * Guardian - Pre-Commit Architecture Validator
+ * Blocks commits that violate architecture rules
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export class Guardian {
+    schema;
+    errors = [];
+    warnings = [];
+    approvals = [];
+    constructor(schema) {
+        this.schema = schema;
+    }
+    /**
+     * Main validation entry point
+     */
+    async validate() {
+        console.log('═══════════════════════════════════════════════════');
+        console.log('🛡️  GUARDIAN VALIDATOR');
+        console.log('═══════════════════════════════════════════════════');
+        this.checkRequiredFiles();
+        await this.checkForbiddenPatterns();
+        this.checkRequiredImports();
+        this.checkPackageLockSync();
+        return this.getResult();
+    }
+    /**
+     * Check if required files exist
+     */
+    checkRequiredFiles() {
+        console.log('\n📁 Checking required files...');
+        for (const file of this.schema.requiredFiles || []) {
+            const filePath = path.join(process.cwd(), file);
+            if (!fs.existsSync(filePath)) {
+                this.addError(`MISSING REQUIRED FILE: ${file}`);
+            }
+        }
+        if (this.errors.length === 0) {
+            console.log('   ✅ All required files present');
+        }
+    }
+    /**
+     * Check for forbidden patterns with architect approval support
+     */
+    async checkForbiddenPatterns() {
+        console.log('\n🔍 Checking for forbidden patterns...');
+        const srcPath = path.join(process.cwd(), 'src');
+        if (!fs.existsSync(srcPath)) {
+            console.log('   ⚠️  No src/ directory found');
+            return;
+        }
+        await this.scanDirectory(srcPath);
+        if (this.errors.length === 0) {
+            console.log('   ✅ No forbidden patterns found');
+        }
+    }
+    /**
+     * Recursively scan directory for violations
+     */
+    async scanDirectory(dir) {
+        const files = fs.readdirSync(dir, { withFileTypes: true });
+        for (const file of files) {
+            const fullPath = path.join(dir, file.name);
+            if (file.isDirectory()) {
+                if (!file.name.startsWith('.') && file.name !== 'node_modules') {
+                    await this.scanDirectory(fullPath);
+                }
+            }
+            else if (file.isFile()) {
+                const ext = path.extname(file.name);
+                if (['.ts', '.tsx', '.js', '.jsx'].includes(ext)) {
+                    await this.scanFile(fullPath);
+                }
+            }
+        }
+    }
+    /**
+     * Scan single file for violations
+     */
+    async scanFile(filePath) {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n');
+        const relativePath = path.relative(process.cwd(), filePath);
+        for (const forbidden of this.schema.forbiddenPatterns || []) {
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                const matches = line.match(forbidden.pattern);
+                if (matches) {
+                    // Check exceptions
+                    const isException = this.isException(relativePath, forbidden.exceptions);
+                    if (!isException) {
+                        // Check for architect approval
+                        const approval = this.checkArchitectApproval(lines, i);
+                        if (approval) {
+                            this.approvals.push({
+                                file: relativePath,
+                                line: i + 1,
+                                ...approval,
+                            });
+                            console.log(`   ✅ Approved deviation: ${relativePath}:${i + 1} (${approval.reason})`);
+                        }
+                        else {
+                            this.addError(`FORBIDDEN PATTERN '${forbidden.name}' found in ${relativePath}:${i + 1}\n` +
+                                `   Line: "${line.trim()}"`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Check if file is in exception list
+     */
+    isException(filePath, exceptions) {
+        if (!exceptions)
+            return false;
+        return exceptions.some(exc => filePath.includes(exc));
+    }
+    /**
+     * Check for architect approval comment
+     * Format: // ARCHITECT_APPROVED: [reason] - [date] - [architect]
+     */
+    checkArchitectApproval(lines, lineIndex) {
+        const approvalPattern = /\/\/\s*ARCHITECT_APPROVED:\s*(.+?)\s*-\s*(\d{4}-\d{2}-\d{2})\s*-\s*([A-Za-z\s]+)/;
+        // Check same line
+        const sameLine = lines[lineIndex];
+        if (sameLine) {
+            const match = sameLine.match(approvalPattern);
+            if (match) {
+                return {
+                    reason: match[1].trim(),
+                    date: match[2],
+                    architect: match[3].trim(),
+                };
+            }
+        }
+        // Check line above
+        if (lineIndex > 0) {
+            const lineAbove = lines[lineIndex - 1];
+            if (lineAbove) {
+                const match = lineAbove.match(approvalPattern);
+                if (match) {
+                    return {
+                        reason: match[1].trim(),
+                        date: match[2],
+                        architect: match[3].trim(),
+                    };
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Check required imports
+     */
+    checkRequiredImports() {
+        console.log('\n📦 Checking required imports...');
+        for (const [filePath, imports] of Object.entries(this.schema.requiredImports || {})) {
+            const fullPath = path.join(process.cwd(), filePath);
+            if (!fs.existsSync(fullPath)) {
+                this.addWarning(`File ${filePath} not found (skipping import check)`);
+                continue;
+            }
+            const content = fs.readFileSync(fullPath, 'utf-8');
+            for (const requiredImport of imports) {
+                if (!content.includes(requiredImport)) {
+                    this.addError(`MISSING IMPORT in ${filePath}: ${requiredImport}`);
+                }
+            }
+        }
+        if (this.errors.length === 0) {
+            console.log('   ✅ All required imports present');
+        }
+    }
+    /**
+     * Check package.json and package-lock.json sync
+     */
+    checkPackageLockSync() {
+        console.log('\n🔒 Checking package-lock.json sync...');
+        const packageJson = path.join(process.cwd(), 'package.json');
+        const packageLock = path.join(process.cwd(), 'package-lock.json');
+        if (!fs.existsSync(packageJson) || !fs.existsSync(packageLock)) {
+            this.addError('package.json or package-lock.json missing');
+            return;
+        }
+        try {
+            const pkgData = JSON.parse(fs.readFileSync(packageJson, 'utf-8'));
+            const lockData = JSON.parse(fs.readFileSync(packageLock, 'utf-8'));
+            if (pkgData.name !== lockData.name) {
+                this.addError('package.json and package-lock.json name mismatch');
+                return;
+            }
+            console.log('   ✅ package-lock.json in sync');
+        }
+        catch (err) {
+            const error = err;
+            this.addError(`Error checking package files: ${error.message}`);
+        }
+    }
+    /**
+     * Add error message
+     */
+    addError(message) {
+        this.errors.push(message);
+    }
+    /**
+     * Add warning message
+     */
+    addWarning(message) {
+        this.warnings.push(message);
+    }
+    /**
+     * Get validation result
+     */
+    getResult() {
+        console.log('\n═══════════════════════════════════════════════════');
+        console.log('📊 VALIDATION RESULTS');
+        console.log('═══════════════════════════════════════════════════');
+        // Show approvals
+        if (this.approvals.length > 0) {
+            console.log('\n✅ ARCHITECT APPROVALS:');
+            this.approvals.forEach(a => {
+                console.log(`   📄 ${a.file}:${a.line}`);
+                console.log(`      Reason: ${a.reason}`);
+                console.log(`      Approved by: ${a.architect} on ${a.date}`);
+            });
+        }
+        // Show warnings
+        if (this.warnings.length > 0) {
+            console.log('\n⚠️  WARNINGS:');
+            this.warnings.forEach(w => console.log(`   ${w}`));
+        }
+        // Show errors
+        if (this.errors.length > 0) {
+            console.log('\n❌ ERRORS:');
+            this.errors.forEach(e => console.log(`   ${e}`));
+            console.log('\n❌ COMMIT BLOCKED - Fix errors above!');
+            console.log('\n💡 TIP: Add architect approval to allow:');
+            console.log('   // ARCHITECT_APPROVED: [reason] - YYYY-MM-DD - [name]');
+            console.log('═══════════════════════════════════════════════════\n');
+            return {
+                success: false,
+                errors: this.errors,
+                warnings: this.warnings,
+                approvals: this.approvals,
+            };
+        }
+        console.log('\n✅ ALL CHECKS PASSED');
+        console.log('✅ Commit allowed');
+        console.log('═══════════════════════════════════════════════════\n');
+        return {
+            success: true,
+            errors: [],
+            warnings: this.warnings,
+            approvals: this.approvals,
+        };
+    }
+}
+/**
+ * Main validation function for CLI
+ */
+export async function validateGuardian(options) {
+    // Load schema
+    const schemaPath = path.resolve(process.cwd(), options.schema);
+    const schema = await import(schemaPath).then(m => m.default || m.SCHEMA);
+    // Run validation
+    const guardian = new Guardian(schema);
+    return guardian.validate();
+}
+//# sourceMappingURL=index.js.map

package/dist/guardian/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Guardian + Cerber - Main Entry Point
+ * @package cerber-core
+ * @version 1.0.0
+ */
+export { Cerber, makeIssue, runHealthChecks } from './cerber';
+export { Guardian } from './guardian';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * Guardian + Cerber - Main Entry Point
+ * @package cerber-core
+ * @version 1.0.0
+ */
+export { Cerber, makeIssue, runHealthChecks } from './cerber';
+export { Guardian } from './guardian';
+export * from './types';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,cAAc,SAAS,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Type Definitions for Guardian + Cerber
+ */
+export interface GuardianSchema {
+    requiredFiles?: string[];
+    forbiddenPatterns?: ForbiddenPattern[];
+    requiredImports?: Record<string, string[]>;
+    packageJsonRules?: PackageJsonRules;
+}
+export interface ForbiddenPattern {
+    pattern: RegExp;
+    name: string;
+    exceptions?: string[];
+    severity?: 'error' | 'warning';
+}
+export interface PackageJsonRules {
+    requiredScripts?: string[];
+    requiredDevDependencies?: string[];
+    requiredDependencies?: string[];
+}
+export interface ArchitectApproval {
+    file?: string;
+    line?: number;
+    reason: string;
+    date: string;
+    architect: string;
+}
+export interface ValidationResult {
+    success: boolean;
+    errors: string[];
+    warnings: string[];
+    approvals: ArchitectApproval[];
+}
+export interface CerberCheckContext {
+    rootDir: string;
+    [key: string]: any;
+}
+export type CerberCheck = (ctx: CerberCheckContext) => Promise<CerberIssue[]>;
+export interface CerberIssue {
+    code: string;
+    component?: string;
+    severity: 'critical' | 'error' | 'warning' | 'info';
+    message: string;
+    rootCause?: string;
+    fix?: string;
+    durationMs?: number;
+    details?: Record<string, any>;
+}
+export interface CerberResult {
+    timestamp: string;
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    app: {
+        version: string;
+        env: string;
+        uptime: number;
+        nodeVersion: string;
+    };
+    components: Array<{
+        id: string;
+        name: string;
+        severity: string;
+        message: string;
+        details?: Record<string, any>;
+        fix?: string;
+    }>;
+    summary: {
+        totalChecks: number;
+        failedChecks: number;
+        criticalIssues: number;
+        errorIssues: number;
+        warningIssues: number;
+    };
+    durationMs: number;
+}
+export type CerberIssueInstance = CerberIssue;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAMD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,GAAG,EAAE;QACH,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,UAAU,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type Definitions for Guardian + Cerber
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/examples/backend-schema.ts

@@ -0,0 +1,72 @@
+/**
+ * Example Backend Schema for Guardian
+ * Shows typical architecture rules for Node.js/Express backends
+ */
+
+import type { GuardianSchema } from '../src/types';
+
+export const backendSchema: GuardianSchema = {
+  requiredFiles: [
+    'package.json',
+    'package-lock.json',
+    'tsconfig.json',
+    '.env.example',
+    '.gitignore',
+    'README.md',
+  ],
+
+  forbiddenPatterns: [
+    {
+      pattern: /password\s*=\s*['"][^'"]+['"]/i,
+      name: 'Hardcoded passwords',
+      severity: 'error',
+    },
+    {
+      pattern: /api[_-]?key\s*=\s*['"][^'"]+['"]/i,
+      name: 'Hardcoded API keys',
+      severity: 'error',
+    },
+    {
+      pattern: /mongodb:\/\/[^'"]+:[^'"]+@/,
+      name: 'MongoDB connection string with credentials',
+      exceptions: ['.env.example'],
+      severity: 'error',
+    },
+    {
+      pattern: /console\.(log|debug|info)/,
+      name: 'Console statements - use logger instead',
+      exceptions: ['src/utils/logger.ts', 'scripts/**'],
+      severity: 'warning',
+    },
+    {
+      pattern: /eval\(|new Function\(/,
+      name: 'Dangerous eval() or Function() constructor',
+      severity: 'error',
+    },
+    {
+      pattern: /app\.use\(cors\(\)\)/,
+      name: 'CORS enabled for all origins - specify allowed origins',
+      exceptions: ['src/middleware/cors.ts'],
+      severity: 'error',
+    },
+    {
+      pattern: /\.findOne\(|\.find\(|\.updateOne\(/,
+      name: 'Direct Mongoose calls - use repository pattern',
+      exceptions: ['src/repositories/**', 'src/models/**'],
+      severity: 'warning',
+    },
+  ],
+
+  requiredImports: {
+    'src/routes/**/*.ts': ['import express', 'import { Router'],
+    'src/controllers/**/*.ts': ['import { Request, Response'],
+  },
+
+  packageJsonRules: {
+    requiredScripts: ['start', 'dev', 'build', 'test', 'lint'],
+    requiredDependencies: ['express', 'dotenv'],
+    requiredDevDependencies: ['typescript', '@types/node', '@types/express'],
+  },
+};
+
+export default backendSchema;

package/examples/frontend-schema.ts

@@ -0,0 +1,67 @@
+/**
+ * Example Frontend Schema for Guardian
+ * Shows typical architecture rules for React/Vue frontends
+ */
+
+import type { GuardianSchema } from '../src/types';
+
+export const frontendSchema: GuardianSchema = {
+  requiredFiles: [
+    'package.json',
+    'package-lock.json',
+    'tsconfig.json',
+    'vite.config.ts', // or webpack.config.js
+    '.gitignore',
+    'README.md',
+  ],
+
+  forbiddenPatterns: [
+    {
+      pattern: /console\.(log|debug|info)/,
+      name: 'Console statements in production code',
+      exceptions: ['src/utils/logger.ts', 'src/dev/**'],
+      severity: 'warning',
+    },
+    {
+      pattern: /any\s+as\s+any|:\s*any/,
+      name: 'TypeScript any type',
+      exceptions: ['src/legacy/**'],
+      severity: 'error',
+    },
+    {
+      pattern: /fetch\(/,
+      name: 'Direct fetch() calls - use apiClient instead',
+      exceptions: ['src/api/apiClient.ts'],
+      severity: 'error',
+    },
+    {
+      pattern: /localStorage\.|sessionStorage\./,
+      name: 'Direct storage access - use storageService',
+      exceptions: ['src/services/storageService.ts'],
+      severity: 'warning',
+    },
+    {
+      pattern: /process\.env/,
+      name: 'Direct environment variable access - use config',
+      exceptions: ['src/config/env.ts', 'vite.config.ts'],
+      severity: 'error',
+    },
+    {
+      pattern: /\.test\.skip\(|\.describe\.skip\(/,
+      name: 'Skipped tests',
+      severity: 'warning',
+    },
+  ],
+
+  requiredImports: {
+    'src/components/**/*.tsx': ['import React', "import { FC, ReactNode"],
+    'src/pages/**/*.tsx': ['import React'],
+  },
+
+  packageJsonRules: {
+    requiredScripts: ['dev', 'build', 'test', 'lint'],
+    requiredDevDependencies: ['typescript', 'vite', '@types/node'],
+  },
+};
+
+export default frontendSchema;