@hatem427/code-guard-ci 1.0.0

package/dist/scripts/view-bypass-log.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env ts-node
+"use strict";
+/**
+ * ============================================================================
+ * view-bypass-log.ts — View bypass audit log
+ * ============================================================================
+ *
+ * Usage:
+ *   npm run view-bypass-log
+ *   npm run view-bypass-log -- --author="john@example.com"
+ *   npm run view-bypass-log -- --days=7
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const bypass_manager_1 = require("./utils/bypass-manager");
+const logger = __importStar(require("./utils/logger"));
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const opts = {};
+    for (const arg of args) {
+        const [key, ...valueParts] = arg.replace(/^--/, '').split('=');
+        const value = valueParts.join('=').replace(/^["']|["']$/g, '');
+        switch (key) {
+            case 'author':
+                opts.author = value;
+                break;
+            case 'days':
+                opts.days = parseInt(value, 10);
+                break;
+        }
+    }
+    return opts;
+}
+function main() {
+    logger.header('📊 Code Guardian — Bypass Audit Log');
+    const opts = parseArgs();
+    if (opts.author) {
+        logger.info(`Filtering by author: ${opts.author}`);
+        const entries = (0, bypass_manager_1.getBypassesByAuthor)(opts.author);
+        if (entries.length === 0) {
+            logger.info(`No bypass entries found for ${opts.author}`);
+            return;
+        }
+        console.log(`\nFound ${entries.length} bypass(es) by ${opts.author}:\n`);
+        for (const entry of entries) {
+            const date = new Date(entry.timestamp).toLocaleString();
+            console.log(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+            console.log(`📅 ${date}`);
+            console.log(`📝 Reason: ${entry.reason}`);
+            console.log(`🌿 Branch: ${entry.branch}`);
+            console.log(`📁 Files: ${entry.files.length} file(s)`);
+            console.log(`🔑 Method: ${entry.method}`);
+            if (entry.commitHash) {
+                console.log(`🔗 Commit: ${entry.commitHash}`);
+            }
+            console.log('');
+        }
+    }
+    else if (opts.days) {
+        logger.info(`Showing bypasses from last ${opts.days} day(s)`);
+        const entries = (0, bypass_manager_1.getRecentBypasses)(opts.days);
+        if (entries.length === 0) {
+            logger.info(`No bypass entries found in the last ${opts.days} day(s)`);
+            return;
+        }
+        console.log(`\nFound ${entries.length} bypass(es) in the last ${opts.days} day(s):\n`);
+        for (const entry of entries) {
+            const date = new Date(entry.timestamp).toLocaleString();
+            console.log(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+            console.log(`👤 ${entry.author} <${entry.email}>`);
+            console.log(`📅 ${date}`);
+            console.log(`📝 Reason: ${entry.reason}`);
+            console.log(`🌿 Branch: ${entry.branch}`);
+            console.log(`🔑 Method: ${entry.method}`);
+            console.log('');
+        }
+    }
+    else {
+        // Show full report
+        const report = (0, bypass_manager_1.generateBypassReport)();
+        console.log(report);
+    }
+}
+main();
+//# sourceMappingURL=view-bypass-log.js.map

package/dist/scripts/view-bypass-log.js.map

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

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@hatem427/code-guard-ci",
+  "version": "1.0.0",
+  "description": "Production-ready TypeScript tooling to enforce PR & coding guidelines for Angular, React, and NextJS projects.",
+  "private": false,
+  "main": "dist/scripts/cli.js",
+  "types": "dist/scripts/cli.d.ts",
+  "bin": {
+    "code-guard": "dist/scripts/cli.js"
+  },
+  "files": [
+    "dist",
+    "config",
+    "scripts",
+    "templates",
+    ".husky",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/scripts/cli.js",
+    "precommit-check": "ts-node scripts/precommit-check.ts",
+    "auto-fix": "ts-node scripts/auto-fix.ts",
+    "generate-doc": "ts-node scripts/generate-doc.ts",
+    "generate-pr-checklist": "ts-node scripts/generate-pr-checklist.ts",
+    "set-bypass-password": "ts-node scripts/set-bypass-password.ts",
+    "set-admin-password": "ts-node scripts/set-admin-password.ts",
+    "view-bypass-log": "ts-node scripts/view-bypass-log.ts",
+    "delete-bypass-logs": "ts-node scripts/delete-bypass-logs.ts",
+    "prepare": "husky install",
+    "lint": "eslint . --ext .ts,.tsx,.js,.jsx",
+    "format": "prettier --write .",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "code-quality",
+    "pre-commit",
+    "git-hooks",
+    "angular",
+    "react",
+    "nextjs",
+    "typescript",
+    "eslint",
+    "prettier",
+    "coding-standards",
+    "pr-checklist",
+    "documentation"
+  ],
+  "author": "Hatem Bassem",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Elsaadany427/code-guard.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Elsaadany427/code-guard/issues"
+  },
+  "homepage": "https://github.com/Elsaadany427/code-guard#readme",
+  "devDependencies": {
+    "@types/glob": "^8.1.0",
+    "@types/node": "^20.11.0",
+    "chalk": "^4.1.2",
+    "eslint": "^8.56.0",
+    "glob": "^10.3.10",
+    "husky": "^9.0.0",
+    "prettier": "^3.2.0",
+    "ts-morph": "^21.0.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/scripts/auto-fix.ts

@@ -0,0 +1,115 @@
+#!/usr/bin/env ts-node
+/**
+ * ============================================================================
+ * auto-fix.ts — Automatically fix code violations
+ * ============================================================================
+ *
+ * Attempts to automatically fix common code violations.
+ *
+ * Usage:
+ *   npm run auto-fix
+ *   npm run auto-fix -- --dry-run
+ */
+
+import { detectProject } from './utils/project-detector';
+import { getStagedFiles, readStagedFiles } from './utils/file-checker';
+import { getRulesForProject } from '../config/guidelines.config';
+import { executeRules, printReport } from './utils/rule-engine';
+import { autoFixAll } from './utils/auto-fixer';
+import * as logger from './utils/logger';
+
+// Load configs
+import '../config/angular.config';
+import '../config/react.config';
+import '../config/nextjs.config';
+
+const CHECKABLE_EXTENSIONS = ['ts', 'tsx', 'js', 'jsx', 'html', 'css', 'scss', 'sass', 'less'];
+
+function parseArgs(): { dryRun: boolean } {
+  const args = process.argv.slice(2);
+  return {
+    dryRun: args.includes('--dry-run'),
+  };
+}
+
+async function main(): Promise<void> {
+  logger.header('🔧 Code Guardian — Auto-Fix');
+
+  const opts = parseArgs();
+
+  if (opts.dryRun) {
+    logger.info('Dry-run mode: will show what would be fixed without making changes');
+  }
+
+  // Detect project
+  const project = detectProject();
+  logger.info(`Detected project: ${project.label}`);
+
+  // Get staged files
+  const stagedPaths = getStagedFiles();
+  if (stagedPaths.length === 0) {
+    logger.info('No staged files found.');
+    process.exit(0);
+  }
+
+  logger.info(`Found ${stagedPaths.length} staged file(s).`);
+
+  // Read files
+  const files = readStagedFiles(CHECKABLE_EXTENSIONS);
+  if (files.length === 0) {
+    logger.info('No checkable files in staging.');
+    process.exit(0);
+  }
+
+  // Load rules and execute
+  const rules = getRulesForProject(project.type);
+  logger.info(`Loaded ${rules.length} rule(s) for ${project.label}.`);
+
+  const report = executeRules(files, rules, false);
+
+  if (report.violations.length === 0) {
+    logger.success('✅ No violations found!');
+    process.exit(0);
+  }
+
+  logger.info(`Found ${report.violations.length} violation(s).\n`);
+
+  // Attempt auto-fix
+  if (opts.dryRun) {
+    logger.info('Would attempt to fix:');
+    for (const v of report.violations) {
+      console.log(`  • ${v.file}:${v.line} [${v.ruleId}]`);
+    }
+    logger.info('\nRun without --dry-run to apply fixes.');
+  } else {
+    logger.info('Attempting to auto-fix violations...\n');
+    
+    const fixResults = autoFixAll(report.violations, process.cwd());
+    
+    console.log(`\n📊 Results:`);
+    console.log(`  ✅ Fixed: ${fixResults.fixed}`);
+    console.log(`  ⚠️  Manual fix required: ${fixResults.failed}\n`);
+
+    // Show what couldn't be fixed
+    const manualFixes = fixResults.results.filter((r) => !r.result.fixed);
+    if (manualFixes.length > 0) {
+      logger.warn('The following require manual fixes:');
+      for (const { violation, result } of manualFixes) {
+        console.log(`  • ${violation.file}:${violation.line} [${violation.ruleId}] - ${result.message}`);
+      }
+    }
+
+    if (fixResults.fixed > 0) {
+      logger.success(`\n✅ Auto-fixed ${fixResults.fixed} violation(s)!`);
+      logger.info('Remember to review changes and re-stage files:');
+      logger.dim('   git add .');
+    }
+  }
+
+  process.exit(0);
+}
+
+main().catch((err) => {
+  logger.error(`Unexpected error: ${err.message || err}`);
+  process.exit(1);
+});

package/scripts/cli.ts

@@ -0,0 +1,246 @@
+#!/usr/bin/env node
+/**
+ * ============================================================================
+ * cli.ts — Code Guardian CLI entrypoint
+ * ============================================================================
+ *
+ * Main CLI interface when installed as an npm package.
+ * Provides commands: init, check, doc, checklist
+ *
+ * Usage:
+ *   npx code-guardian init
+ *   npx code-guardian check
+ *   npx code-guardian doc --name="feature" --type=ui
+ *   npx code-guardian checklist
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { execSync } from 'child_process';
+
+const VERSION = '1.0.0';
+
+// ── CLI argument parsing ────────────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+// ── Commands ────────────────────────────────────────────────────────────────
+
+function showHelp(): void {
+  console.log(`
+🛡️  Code Guardian v${VERSION}
+
+Usage:
+  code-guardian <command> [options]
+
+Commands:
+  init              Setup Code Guardian in current project
+  check             Run pre-commit checks manually
+  doc               Generate feature documentation
+  checklist         Generate PR checklist
+  help              Show this help message
+  version           Show version
+
+Examples:
+  code-guardian init
+  code-guardian check
+  code-guardian doc --name="user-card" --type=ui
+  code-guardian checklist --project=angular
+
+For more info: https://github.com/team/code-guardian
+  `);
+}
+
+function showVersion(): void {
+  console.log(`Code Guardian v${VERSION}`);
+}
+
+/**
+ * Initialize Code Guardian in the current project.
+ * Copies config files, templates, and sets up Husky.
+ */
+function initProject(): void {
+  console.log('🛡️  Initializing Code Guardian...\n');
+
+  const cwd = process.cwd();
+  const packageJsonPath = path.join(cwd, 'package.json');
+
+  // Check if package.json exists
+  if (!fs.existsSync(packageJsonPath)) {
+    console.error('❌ Error: No package.json found in current directory.');
+    console.error('   Run this command from your project root.');
+    process.exit(1);
+  }
+
+  // Determine the source directory (where code-guardian is installed)
+  const sourceDir = path.join(__dirname, '..');
+
+  // Copy config files
+  console.log('📁 Copying configuration files...');
+  const configDir = path.join(cwd, 'config');
+  if (!fs.existsSync(configDir)) {
+    fs.mkdirSync(configDir, { recursive: true });
+  }
+
+  const configFiles = ['guidelines.config.ts', 'angular.config.ts', 'react.config.ts', 'nextjs.config.ts'];
+  for (const file of configFiles) {
+    const src = path.join(sourceDir, 'config', file);
+    const dest = path.join(configDir, file);
+    if (fs.existsSync(src)) {
+      fs.copyFileSync(src, dest);
+      console.log(`  ✓ ${file}`);
+    }
+  }
+
+  // Copy templates
+  console.log('\n📄 Copying documentation templates...');
+  const templatesDir = path.join(cwd, 'templates');
+  if (!fs.existsSync(templatesDir)) {
+    fs.mkdirSync(templatesDir, { recursive: true });
+  }
+
+  const templateFiles = ['feature-doc-ui.md', 'feature-doc-api.md', 'feature-doc-service.md'];
+  for (const file of templateFiles) {
+    const src = path.join(sourceDir, 'templates', file);
+    const dest = path.join(templatesDir, file);
+    if (fs.existsSync(src)) {
+      fs.copyFileSync(src, dest);
+      console.log(`  ✓ ${file}`);
+    }
+  }
+
+  // Create docs/features directory
+  const docsDir = path.join(cwd, 'docs', 'features');
+  if (!fs.existsSync(docsDir)) {
+    fs.mkdirSync(docsDir, { recursive: true });
+    fs.writeFileSync(path.join(docsDir, '.gitkeep'), '');
+    console.log('\n📂 Created docs/features directory');
+  }
+
+  // Update package.json scripts
+  console.log('\n📝 Updating package.json scripts...');
+  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+
+  packageJson.scripts = packageJson.scripts || {};
+  packageJson.scripts['precommit-check'] = 'code-guardian check';
+  packageJson.scripts['generate-doc'] = 'code-guardian doc';
+  packageJson.scripts['generate-pr-checklist'] = 'code-guardian checklist';
+
+  fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+  console.log('  ✓ Added npm scripts');
+
+  // Setup Husky
+  console.log('\n🐶 Setting up Husky...');
+  try {
+    execSync('npx husky install', { stdio: 'inherit', cwd });
+    execSync('npx husky add .husky/pre-commit "npm run precommit-check"', { stdio: 'inherit', cwd });
+    console.log('  ✓ Husky configured');
+  } catch (error) {
+    console.warn('  ⚠️  Husky setup failed. You may need to run "npx husky install" manually.');
+  }
+
+  console.log('\n✅ Code Guardian initialized successfully!\n');
+  console.log('Next steps:');
+  console.log('  1. Review config files in ./config/');
+  console.log('  2. Customize rules for your team');
+  console.log('  3. Make a commit to test the pre-commit hook');
+  console.log('  4. Run "npm run generate-doc -- --name=test --type=ui" to test doc generation\n');
+}
+
+/**
+ * Run pre-commit checks manually.
+ */
+function runCheck(): void {
+  const scriptPath = path.join(__dirname, 'precommit-check.js');
+  if (fs.existsSync(scriptPath)) {
+    require(scriptPath);
+  } else {
+    // Fallback: try to run from source
+    const tsScriptPath = path.join(__dirname, '..', 'scripts', 'precommit-check.ts');
+    if (fs.existsSync(tsScriptPath)) {
+      execSync(`npx ts-node ${tsScriptPath}`, { stdio: 'inherit' });
+    } else {
+      console.error('❌ Error: Could not find precommit-check script.');
+      process.exit(1);
+    }
+  }
+}
+
+/**
+ * Generate feature documentation.
+ */
+function generateDoc(): void {
+  const scriptPath = path.join(__dirname, 'generate-doc.js');
+  const scriptArgs = args.slice(1).join(' ');
+
+  if (fs.existsSync(scriptPath)) {
+    execSync(`node ${scriptPath} ${scriptArgs}`, { stdio: 'inherit' });
+  } else {
+    const tsScriptPath = path.join(__dirname, '..', 'scripts', 'generate-doc.ts');
+    if (fs.existsSync(tsScriptPath)) {
+      execSync(`npx ts-node ${tsScriptPath} ${scriptArgs}`, { stdio: 'inherit' });
+    } else {
+      console.error('❌ Error: Could not find generate-doc script.');
+      process.exit(1);
+    }
+  }
+}
+
+/**
+ * Generate PR checklist.
+ */
+function generateChecklist(): void {
+  const scriptPath = path.join(__dirname, 'generate-pr-checklist.js');
+  const scriptArgs = args.slice(1).join(' ');
+
+  if (fs.existsSync(scriptPath)) {
+    execSync(`node ${scriptPath} ${scriptArgs}`, { stdio: 'inherit' });
+  } else {
+    const tsScriptPath = path.join(__dirname, '..', 'scripts', 'generate-pr-checklist.ts');
+    if (fs.existsSync(tsScriptPath)) {
+      execSync(`npx ts-node ${tsScriptPath} ${scriptArgs}`, { stdio: 'inherit' });
+    } else {
+      console.error('❌ Error: Could not find generate-pr-checklist script.');
+      process.exit(1);
+    }
+  }
+}
+
+// ── Main ────────────────────────────────────────────────────────────────────
+
+switch (command) {
+  case 'init':
+    initProject();
+    break;
+
+  case 'check':
+    runCheck();
+    break;
+
+  case 'doc':
+    generateDoc();
+    break;
+
+  case 'checklist':
+    generateChecklist();
+    break;
+
+  case 'version':
+  case '--version':
+  case '-v':
+    showVersion();
+    break;
+
+  case 'help':
+  case '--help':
+  case '-h':
+  case undefined:
+    showHelp();
+    break;
+
+  default:
+    console.error(`❌ Unknown command: ${command}`);
+    console.error('Run "code-guardian help" for usage information.');
+    process.exit(1);
+}