cerber-core 1.0.4 → 1.1.1

package/dev/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/dev/templates/pre-commit.tpl

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

package/dist/cli/contract-parser.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CERBER_CONTRACT parser
+ *
+ * Extracts and validates YAML contract from CERBER.md
+ *
+ * @author Stefan Pitek
+ * @license MIT
+ */
+import { CerberContract, ContractParseResult } from './types.js';
+export declare function parseCerberContract(projectRoot: string): Promise<ContractParseResult>;
+export declare function extractContract(content: string): ContractParseResult;
+export declare function getDefaultContract(mode?: 'solo' | 'dev' | 'team'): CerberContract;
+//# sourceMappingURL=contract-parser.d.ts.map

package/dist/cli/contract-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-parser.d.ts","sourceRoot":"","sources":["../../src/cli/contract-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAMjE,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAU3F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CA8EpE;AAyID,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAM,GAAG,KAAK,GAAG,MAAc,GAAG,cAAc,CAqCxF"}

package/dist/cli/contract-parser.js

@@ -0,0 +1,265 @@
+/**
+ * CERBER_CONTRACT parser
+ *
+ * Extracts and validates YAML contract from CERBER.md
+ *
+ * @author Stefan Pitek
+ * @license MIT
+ */
+import fs from 'fs/promises';
+import path from 'path';
+const YAML_START_MARKER = '## CERBER_CONTRACT';
+const YAML_CODE_BLOCK_START = '```yaml';
+const YAML_CODE_BLOCK_END = '```';
+export async function parseCerberContract(projectRoot) {
+    const cerberPath = path.join(projectRoot, 'CERBER.md');
+    try {
+        const content = await fs.readFile(cerberPath, 'utf-8');
+        return extractContract(content);
+    }
+    catch (err) {
+        // CERBER.md doesn't exist
+        return { success: false, error: { message: 'CERBER.md not found' } };
+    }
+}
+export function extractContract(content) {
+    const lines = content.split('\n');
+    // Find CERBER_CONTRACT section
+    const contractStartIndex = lines.findIndex(line => line.trim() === YAML_START_MARKER);
+    if (contractStartIndex === -1) {
+        return {
+            success: false,
+            error: {
+                message: `Missing "${YAML_START_MARKER}" section header`,
+                context: 'Expected format:\n\n## CERBER_CONTRACT\n\`\`\`yaml\n...\n\`\`\`'
+            }
+        };
+    }
+    // Find yaml code block
+    let yamlStartIndex = -1;
+    let yamlEndIndex = -1;
+    for (let i = contractStartIndex; i < lines.length; i++) {
+        if (lines[i].trim().startsWith(YAML_CODE_BLOCK_START)) {
+            yamlStartIndex = i + 1;
+        }
+        else if (yamlStartIndex !== -1 && lines[i].trim() === YAML_CODE_BLOCK_END) {
+            yamlEndIndex = i;
+            break;
+        }
+    }
+    if (yamlStartIndex === -1) {
+        return {
+            success: false,
+            error: {
+                message: 'Missing YAML code block after CERBER_CONTRACT header',
+                line: contractStartIndex + 1,
+                context: `Expected \`\`\`yaml after line ${contractStartIndex + 1}`
+            }
+        };
+    }
+    if (yamlEndIndex === -1) {
+        return {
+            success: false,
+            error: {
+                message: 'Unclosed YAML code block',
+                line: yamlStartIndex,
+                context: 'Missing closing \`\`\` for YAML block'
+            }
+        };
+    }
+    const yamlContent = lines.slice(yamlStartIndex, yamlEndIndex).join('\n');
+    // Simple YAML parser (for our specific structure)
+    try {
+        const contract = parseSimpleYaml(yamlContent);
+        // Validate required fields
+        const validation = validateContract(contract);
+        if (!validation.valid) {
+            return {
+                success: false,
+                error: {
+                    message: 'Invalid contract structure',
+                    context: validation.errors.join('\n')
+                }
+            };
+        }
+        return { success: true, contract };
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: {
+                message: 'Failed to parse YAML contract',
+                context: err.message || 'Invalid YAML structure'
+            }
+        };
+    }
+}
+function parseSimpleYaml(yamlContent) {
+    const lines = yamlContent.split('\n').filter(line => line.trim() && !line.trim().startsWith('#'));
+    const contract = {
+        version: 1,
+        mode: 'dev',
+        guardian: {},
+        health: {},
+        ci: {},
+        schema: {},
+        team: {}
+    };
+    let currentSection = null;
+    let currentSubsection = null;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        const indent = line.length - line.trimStart().length;
+        if (indent === 0 && trimmed.endsWith(':')) {
+            // Top-level key
+            const key = trimmed.slice(0, -1);
+            currentSection = key;
+            currentSubsection = null;
+        }
+        else if (indent === 2 && trimmed.endsWith(':')) {
+            // Second-level key
+            const key = trimmed.slice(0, -1);
+            currentSubsection = key;
+            if (currentSection && !contract[currentSection][key]) {
+                contract[currentSection][key] = {};
+            }
+        }
+        else if (trimmed.includes(':')) {
+            // Key-value pair
+            const [key, ...valueParts] = trimmed.split(':');
+            let value = valueParts.join(':').trim();
+            // Strip inline comments (# after value)
+            const commentIndex = value.indexOf('#');
+            if (commentIndex !== -1) {
+                value = value.substring(0, commentIndex).trim();
+            }
+            // Parse value type
+            if (value === 'true')
+                value = true;
+            else if (value === 'false')
+                value = false;
+            else if (!isNaN(Number(value)))
+                value = Number(value);
+            else if (value.startsWith('[') && value.endsWith(']')) {
+                value = value.slice(1, -1).split(',').map((v) => {
+                    const trimmed = v.trim();
+                    // Strip quotes from array values
+                    if ((trimmed.startsWith("'") && trimmed.endsWith("'")) ||
+                        (trimmed.startsWith('"') && trimmed.endsWith('"'))) {
+                        return trimmed.slice(1, -1);
+                    }
+                    return trimmed;
+                });
+            }
+            if (currentSubsection && currentSection) {
+                contract[currentSection][currentSubsection][key.trim()] = value;
+            }
+            else if (currentSection) {
+                contract[currentSection][key.trim()] = value;
+            }
+            else {
+                contract[key.trim()] = value;
+            }
+        }
+    }
+    return contract;
+}
+function validateContract(contract) {
+    const errors = [];
+    // Check guardian section
+    if (!contract.guardian) {
+        errors.push('Missing "guardian" section');
+    }
+    else {
+        if (typeof contract.guardian.enabled !== 'boolean') {
+            errors.push('guardian.enabled must be true or false');
+        }
+        if (contract.guardian.enabled && !contract.guardian.schemaFile) {
+            errors.push('guardian.schemaFile is required when guardian is enabled');
+        }
+    }
+    // Check health section
+    if (!contract.health) {
+        errors.push('Missing "health" section');
+    }
+    else {
+        if (typeof contract.health.enabled !== 'boolean') {
+            errors.push('health.enabled must be true or false');
+        }
+        if (contract.health.enabled && !contract.health.endpoint) {
+            errors.push('health.endpoint is required when health is enabled');
+        }
+    }
+    // Check ci section
+    if (!contract.ci) {
+        errors.push('Missing "ci" section');
+    }
+    else {
+        if (!contract.ci.provider) {
+            errors.push('ci.provider is required (e.g., "github")');
+        }
+        if (!contract.ci.postDeploy) {
+            contract.ci.postDeploy = { enabled: false };
+        }
+    }
+    // Check schema section (optional but if present, validate)
+    if (contract.schema) {
+        if (typeof contract.schema.enabled !== 'boolean') {
+            errors.push('schema.enabled must be true or false');
+        }
+        if (contract.schema.enabled) {
+            if (!contract.schema.file) {
+                errors.push('schema.file is required when schema is enabled');
+            }
+            if (!contract.schema.mode) {
+                errors.push('schema.mode is required (strict or template_only)');
+            }
+            if (contract.schema.mode && !['strict', 'template_only'].includes(contract.schema.mode)) {
+                errors.push('schema.mode must be "strict" or "template_only"');
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors
+    };
+}
+export function getDefaultContract(mode = 'dev') {
+    return {
+        version: 1,
+        mode,
+        guardian: {
+            enabled: true,
+            schemaFile: 'BACKEND_SCHEMA.ts',
+            hook: 'husky',
+            approvalsTag: 'ARCHITECT_APPROVED'
+        },
+        health: {
+            enabled: mode !== 'solo',
+            endpoint: '/api/health',
+            failOn: {
+                critical: true,
+                error: true,
+                warning: false
+            }
+        },
+        ci: {
+            provider: 'github',
+            branches: ['main'],
+            requiredOnPR: true,
+            postDeploy: {
+                enabled: mode === 'team',
+                waitSeconds: 90,
+                healthUrlVar: 'CERBER_HEALTH_URL',
+                authHeaderSecret: 'CERBER_HEALTH_AUTH_HEADER'
+            }
+        },
+        schema: {
+            enabled: true,
+            file: 'BACKEND_SCHEMA.ts',
+            mode: 'template_only',
+            description: 'Project architecture contract (user-owned)'
+        }
+    };
+}
+//# sourceMappingURL=contract-parser.js.map

package/dist/cli/contract-parser.js.map

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

package/dist/cli/init.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Cerber init command
+ *
+ * Initializes Cerber in client project with instant setup
+ *
+ * @author Stefan Pitek
+ * @license MIT
+ */
+import { InitOptions } from './types.js';
+export declare function initCommand(options?: InitOptions): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAiC,WAAW,EAAE,MAAM,YAAY,CAAC;AAqFxE,wBAAsB,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsG1E"}

package/dist/cli/init.js

@@ -0,0 +1,292 @@
+/**
+ * Cerber init command
+ *
+ * Initializes Cerber in client project with instant setup
+ *
+ * @author Stefan Pitek
+ * @license MIT
+ */
+import chalk from 'chalk';
+import fs from 'fs/promises';
+import path from 'path';
+import { getDefaultContract, parseCerberContract } from './contract-parser.js';
+import { TemplateGenerator } from './template-generator.js';
+const CERBER_MD_TEMPLATE = `# CERBER.md - Architecture Roadmap
+
+> **This is your single source of truth. AI agents and developers enforce this contract.**
+
+## CERBER_CONTRACT
+\`\`\`yaml
+version: 1
+mode: dev  # solo | dev | team
+
+guardian:
+  enabled: true
+  schemaFile: BACKEND_SCHEMA.ts
+  hook: husky
+  approvalsTag: ARCHITECT_APPROVED
+
+health:
+  enabled: true
+  endpoint: /api/health
+  failOn:
+    critical: true
+    error: true
+    warning: false
+
+ci:
+  provider: github
+  branches: [main]
+  requiredOnPR: true
+  postDeploy:
+    enabled: false
+    waitSeconds: 90
+    healthUrlVar: CERBER_HEALTH_URL
+    authHeaderSecret: CERBER_HEALTH_AUTH_HEADER
+
+schema:
+  enabled: true
+  file: BACKEND_SCHEMA.ts
+  mode: template_only  # strict | template_only
+  description: "Project architecture contract (user-owned)"
+  # strict = Cerber never creates schema, you must create it
+  # template_only = Cerber creates minimal template if missing
+\`\`\`
+
+---
+
+## 🎯 Architecture Roadmap
+
+**Status:** Initial Setup
+
+### Phase 1: Foundation (Current)
+- [ ] Setup Guardian pre-commit validation
+- [ ] Configure health checks
+- [ ] Integrate CI/CD pipeline
+
+### Phase 2: Production Readiness
+- [ ] Add monitoring
+- [ ] Configure alerting
+- [ ] Load testing
+
+---
+
+## 📋 Guidelines
+
+### Code Organization
+- Routes in \`src/routes/\`
+- Business logic in \`src/services/\`
+- Database schema in \`src/shared/schema.ts\`
+
+### Standards
+- TypeScript strict mode
+- ESLint configuration
+- Test coverage > 80%
+
+---
+
+## 🛡️ Guardian Rules
+
+See \`${getDefaultContract().guardian.schemaFile}\` for complete architecture rules.
+
+---
+
+*This file is protected by CODEOWNERS. Changes require architect approval.*
+`;
+export async function initCommand(options = {}) {
+    const projectRoot = process.cwd();
+    // Handle --print-template flag
+    if (options.printTemplate) {
+        console.log(CERBER_MD_TEMPLATE);
+        return;
+    }
+    console.log(chalk.bold.cyan('🛡️  Cerber Core - Project Initialization'));
+    console.log('');
+    if (options.dryRun) {
+        console.log(chalk.yellow('⚠️  DRY RUN MODE - No files will be created'));
+        console.log('');
+    }
+    // Step 1: Check for CERBER.md
+    const cerberPath = path.join(projectRoot, 'CERBER.md');
+    const parseResult = await parseCerberContract(projectRoot);
+    if (!parseResult.success) {
+        const error = parseResult.error;
+        // File not found - create template
+        if (error.message === 'CERBER.md not found') {
+            console.log(chalk.yellow('📄 CERBER.md not found'));
+            console.log('Creating template...');
+            console.log('');
+            if (!options.dryRun) {
+                await fs.writeFile(cerberPath, CERBER_MD_TEMPLATE, 'utf-8');
+                console.log(chalk.green('✅ Created CERBER.md'));
+            }
+            else {
+                console.log(chalk.gray('[DRY RUN] Would create CERBER.md'));
+            }
+            console.log('');
+            console.log(chalk.bold('📝 Next Steps:'));
+            console.log('1. Edit CERBER.md and customize the contract for your project');
+            console.log('2. Set your desired mode: solo | dev | team');
+            console.log('3. Run npx cerber init again to generate files');
+            console.log('');
+            return;
+        }
+        // Invalid contract - show detailed error
+        console.error(chalk.red('❌ Failed to parse CERBER.md'));
+        console.error('');
+        console.error(chalk.yellow('Error:'), error.message);
+        if (error.line) {
+            console.error(chalk.gray(`Line ${error.line}`));
+        }
+        if (error.context) {
+            console.error('');
+            console.error(chalk.gray('Expected format:'));
+            console.error(chalk.gray(error.context));
+        }
+        console.error('');
+        console.error(chalk.blue('💡 Tip: Run'), chalk.cyan('npx cerber init'), chalk.blue('in an empty repo to see a valid template'));
+        console.error('');
+        process.exit(1);
+    }
+    let contract = parseResult.contract;
+    // Step 2: Override mode if specified
+    if (options.mode) {
+        console.log(chalk.blue(`📋 Overriding mode: ${contract.mode} → ${options.mode}`));
+        contract.mode = options.mode;
+    }
+    console.log(chalk.bold(`📋 Contract found:`));
+    console.log(`   Mode: ${chalk.cyan(contract.mode)}`);
+    console.log(`   Guardian: ${contract.guardian.enabled ? chalk.green('enabled') : chalk.gray('disabled')}`);
+    console.log(`   Health: ${contract.health.enabled ? chalk.green('enabled') : chalk.gray('disabled')}`);
+    console.log(`   CI: ${contract.ci.provider}`);
+    if (contract.ci.postDeploy.enabled) {
+        console.log(`   Post-deploy gate: ${chalk.green('enabled')} → ${contract.ci.postDeploy.healthUrlVar}`);
+    }
+    console.log('');
+    // Step 3: Generate files
+    console.log(chalk.bold('🔧 Generating files...'));
+    console.log('');
+    const generator = new TemplateGenerator(projectRoot, contract, options);
+    const files = await generator.generateAll();
+    await generator.writeFiles(files);
+    // Step 4: Update package.json
+    if (!options.dryRun && contract.guardian.enabled) {
+        await updatePackageJson(projectRoot);
+    }
+    console.log('');
+    console.log(chalk.bold.green('✅ Cerber initialization complete!'));
+    console.log('');
+    // Step 5: Show next steps
+    await showNextSteps(contract, options, files, projectRoot);
+}
+async function updatePackageJson(projectRoot) {
+    const packagePath = path.join(projectRoot, 'package.json');
+    try {
+        const content = await fs.readFile(packagePath, 'utf-8');
+        const pkg = JSON.parse(content);
+        if (!pkg.scripts) {
+            pkg.scripts = {};
+        }
+        if (!pkg.scripts['cerber:guardian']) {
+            pkg.scripts['cerber:guardian'] = 'node scripts/cerber-guardian.mjs';
+            await fs.writeFile(packagePath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
+            console.log(chalk.green('✅ Updated package.json scripts'));
+        }
+    }
+    catch (err) {
+        console.log(chalk.yellow('⚠️  Could not update package.json (file may not exist)'));
+    }
+}
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function showNextSteps(contract, options, generatedFiles, projectRoot) {
+    console.log(chalk.bold('📝 Next Steps:'));
+    console.log('');
+    if (contract.guardian.enabled && !options.noHusky) {
+        console.log(chalk.cyan('1. Install Husky (if not already installed):'));
+        console.log('   npm install husky --save-dev');
+        console.log('   npx husky install');
+        console.log('');
+    }
+    // Schema section (based on schema config in CERBER.md)
+    if (contract.schema && contract.schema.enabled) {
+        const schemaFile = contract.schema.file;
+        const schemaGenerated = generatedFiles.some(f => f.path.endsWith(schemaFile));
+        const schemaExists = await fileExists(path.join(projectRoot, schemaFile));
+        if (schemaGenerated) {
+            // Template was generated
+            console.log(chalk.cyan(`2. Customize your architecture schema:`));
+            console.log(chalk.yellow(`   ⚠️  ${schemaFile} is a TEMPLATE (not source of truth)`));
+            console.log(`   Edit it to match your architecture defined in CERBER.md`);
+            console.log('   See: https://github.com/Agaslez/cerber-core#guardian-configuration');
+        }
+        else if (!schemaExists && contract.schema.mode === 'strict') {
+            // Strict mode: schema required but not generated
+            console.log(chalk.cyan(`2. Create your schema file:`));
+            console.log(chalk.yellow(`   Schema mode: strict (you must create ${schemaFile})`));
+            console.log(`   Template: npx cerber init --print-schema-template > ${schemaFile}`);
+            console.log('   See: https://github.com/Agaslez/cerber-core#guardian-configuration');
+        }
+        else if (schemaExists) {
+            // Schema exists, don't mention creating it
+            console.log(chalk.green(`✅ Schema file exists: ${schemaFile}`));
+        }
+        console.log('');
+    }
+    else if (contract.guardian.enabled) {
+        // Legacy: guardian enabled but no schema config (backward compat)
+        const schemaGenerated = generatedFiles.some(f => f.path.endsWith(contract.guardian.schemaFile));
+        if (schemaGenerated) {
+            console.log(chalk.cyan(`2. Customize your architecture schema:`));
+            console.log(`   Edit: ${contract.guardian.schemaFile}`);
+            console.log('   Add your project-specific rules and patterns');
+        }
+        else {
+            console.log(chalk.cyan(`2. Create your schema file: ${contract.guardian.schemaFile}`));
+        }
+        console.log('   See: https://github.com/Agaslez/cerber-core#guardian-configuration');
+        console.log('');
+    }
+    if (contract.health.enabled && !options.noHealth) {
+        console.log(chalk.cyan('3. Customize health checks:'));
+        console.log('   Edit: src/cerber/health-checks.ts');
+        console.log('   Add route to your server: src/cerber/health-route.ts');
+        console.log(`   Endpoint: ${contract.health.endpoint}`);
+        console.log('');
+    }
+    if (contract.ci.provider === 'github' && !options.noWorkflow) {
+        console.log(chalk.cyan('4. GitHub Actions workflow created:'));
+        console.log('   .github/workflows/cerber.yml');
+        if (contract.ci.postDeploy.enabled) {
+            console.log('');
+            console.log(chalk.yellow('   ⚠️  Post-deploy health check requires:'));
+            console.log(`      - GitHub Variable: ${contract.ci.postDeploy.healthUrlVar}`);
+            console.log('      - Optional Secret: CERBER_HEALTH_AUTH_HEADER');
+            console.log('      - Set in: Settings > Secrets and variables > Actions > Variables');
+            console.log(`      - Example: https://your-api.com${contract.health.endpoint}`);
+        }
+        console.log('   Required check name: Cerber CI / job: cerber-ci');
+        console.log('');
+    }
+    if (contract.mode === 'team') {
+        console.log(chalk.cyan('5. Team mode setup:'));
+        console.log('   - Edit .github/CODEOWNERS (replace @OWNER_USERNAME)');
+        console.log('   - Enable branch protection: Settings > Branches');
+        console.log('   - Require review from Code Owners');
+        console.log('   - Set required checks to: Cerber CI');
+        console.log('');
+    }
+    console.log(chalk.bold.green('🚀 Ready to commit!'));
+    console.log('   git add .');
+    console.log('   git commit -m "feat: add Cerber protection"');
+    console.log('');
+    console.log(chalk.gray('Need help? https://github.com/Agaslez/cerber-core/discussions'));
+}
+//# sourceMappingURL=init.js.map