sumulige-claude 1.1.0 → 1.1.1

package/.claude/hooks/pre-commit.cjs

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+/**
+ * Pre-commit Quality Gate
+ *
+ * Runs quality checks before committing.
+ * Fails the commit if critical or error issues are found.
+ *
+ * Install: ln -s ../../.claude/hooks/pre-commit.cjs .git/hooks/pre-commit
+ * Or use: smc hooks install
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+async function main() {
+  // Check if quality gate is enabled
+  const configPath = path.join(projectDir, '.claude', 'quality-gate.json');
+  let config = { enabled: true, gates: { preCommit: true } };
+
+  if (fs.existsSync(configPath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    } catch {}
+  }
+
+  if (!config.enabled || !config.gates?.preCommit) {
+    process.exit(0);
+  }
+
+  // Get staged files
+  let stagedFiles = [];
+  try {
+    const output = execSync('git diff --cached --name-only --diff-filter=ACM', {
+      encoding: 'utf-8',
+      stdio: 'pipe'
+    });
+    stagedFiles = output.trim().split('\n').filter(Boolean);
+  } catch {
+    // Not in git repo or no staged files
+    process.exit(0);
+  }
+
+  if (stagedFiles.length === 0) {
+    process.exit(0);
+  }
+
+  // Filter to checkable files
+  const checkable = stagedFiles.filter(f => {
+    const ext = path.extname(f);
+    return ['.js', '.ts', '.jsx', '.tsx', '.cjs', '.mjs', '.json', '.md'].includes(ext);
+  });
+
+  if (checkable.length === 0) {
+    process.exit(0);
+  }
+
+  console.log(`Running pre-commit quality checks on ${checkable.length} file(s)...`);
+
+  // Run quality gate
+  const { QualityGate } = require(path.join(__dirname, '..', '..', 'lib', 'quality-gate.js'));
+  const gate = new QualityGate({
+    projectDir,
+    config
+  });
+
+  const result = await gate.check({
+    files: checkable.map(f => path.join(projectDir, f)),
+    severity: 'error' // Block on errors and critical only
+  });
+
+  if (!result.passed) {
+    console.error('\nPre-commit quality gate failed.');
+    console.error('Fix issues or use --no-verify to bypass (not recommended).\n');
+    process.exit(1);
+  }
+
+  console.log('Pre-commit quality checks passed.\n');
+}
+
+main().catch(err => {
+  console.error('Pre-commit hook error:', err.message);
+  process.exit(1);
+});

package/.claude/hooks/pre-push.cjs

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+/**
+ * Pre-push Quality Gate
+ *
+ * Runs full quality checks before pushing.
+ * More comprehensive than pre-commit.
+ *
+ * Install: ln -s ../../.claude/hooks/pre-push.cjs .git/hooks/pre-push
+ * Or use: smc hooks install
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+async function main() {
+  // Check if quality gate is enabled
+  const configPath = path.join(projectDir, '.claude', 'quality-gate.json');
+  let config = { enabled: true, gates: { prePush: true } };
+
+  if (fs.existsSync(configPath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    } catch {}
+  }
+
+  if (!config.enabled || !config.gates?.prePush) {
+    process.exit(0);
+  }
+
+  console.log('Running pre-push quality checks...\n');
+
+  // Get all files that will be pushed
+  let filesToCheck = [];
+  try {
+    // Get files changed since last push
+    const upstream = execSync('git rev-parse --abbrev-ref --symbolic-full-name @{u}', {
+      encoding: 'utf-8',
+      stdio: 'pipe'
+    }).trim() || 'origin/main';
+
+    const output = execSync(`git diff --name-only ${upstream}...HEAD`, {
+      encoding: 'utf-8',
+      stdio: 'pipe'
+    });
+    filesToCheck = output.trim().split('\n').filter(Boolean);
+  } catch {
+    // No upstream or other git error - check staged files only
+    try {
+      const output = execSync('git diff --cached --name-only --diff-filter=ACM', {
+        encoding: 'utf-8',
+        stdio: 'pipe'
+      });
+      filesToCheck = output.trim().split('\n').filter(Boolean);
+    } catch {
+      // Not in git repo
+      process.exit(0);
+    }
+  }
+
+  if (filesToCheck.length === 0) {
+    process.exit(0);
+  }
+
+  // Filter to checkable files
+  const checkable = filesToCheck.filter(f => {
+    const ext = path.extname(f);
+    return ['.js', '.ts', '.jsx', '.tsx', '.cjs', '.mjs', '.json', '.md'].includes(ext);
+  });
+
+  if (checkable.length === 0) {
+    process.exit(0);
+  }
+
+  console.log(`Checking ${checkable.length} changed file(s)...\n`);
+
+  // Run quality gate
+  const { QualityGate } = require(path.join(__dirname, '..', '..', 'lib', 'quality-gate.js'));
+  const gate = new QualityGate({
+    projectDir,
+    config
+  });
+
+  const result = await gate.check({
+    files: checkable.map(f => path.join(projectDir, f)),
+    severity: 'warn' // Block on warnings too for push
+  });
+
+  if (!result.passed) {
+    console.error('\nPush blocked by quality gate.');
+    console.error('Fix issues or use --no-verify to bypass (not recommended).\n');
+    process.exit(1);
+  }
+
+  console.log('All quality checks passed. Proceeding with push.\n');
+}
+
+main().catch(err => {
+  console.error('Pre-push hook error:', err.message);
+  process.exit(1);
+});

package/.claude/quality-gate.json

@@ -0,0 +1,61 @@
+{
+  "enabled": true,
+  "severity": "warn",
+  "rules": [
+    {
+      "id": "line-count-limit",
+      "enabled": true,
+      "severity": "error",
+      "config": {
+        "maxLines": 800
+      }
+    },
+    {
+      "id": "file-size-limit",
+      "enabled": true,
+      "severity": "warn",
+      "config": {
+        "maxSize": 819200
+      }
+    },
+    {
+      "id": "no-empty-files",
+      "enabled": true,
+      "severity": "warn"
+    },
+    {
+      "id": "no-trailing-whitespace",
+      "enabled": true,
+      "severity": "warn"
+    },
+    {
+      "id": "todo-comments",
+      "enabled": true,
+      "severity": "info"
+    },
+    {
+      "id": "directory-depth",
+      "enabled": false,
+      "severity": "warn"
+    },
+    {
+      "id": "no-console-logs",
+      "enabled": false,
+      "severity": "warn"
+    },
+    {
+      "id": "function-length",
+      "enabled": false,
+      "severity": "warn"
+    }
+  ],
+  "gates": {
+    "preCommit": true,
+    "prePush": true,
+    "onToolUse": false
+  },
+  "reporting": {
+    "format": "console",
+    "outputFile": null
+  }
+}

package/.claude/settings.local.json

@@ -87,7 +87,8 @@
       "Bash(git init:*)",
       "Bash(git branch:*)",
       "Bash(gh repo create:*)",
-      "Bash(npm view:*)"
+      "Bash(npm view:*)",
+      "Bash(npm update:*)"
     ]
   },
   "hooks": {

package/cli.js

@@ -132,6 +132,34 @@ const COMMANDS = {
     help: 'Manage configuration',
     args: '[get|set] [key] [value]'
   },
+  'config:validate': {
+    help: 'Validate configuration files',
+    args: ''
+  },
+  'config:backup': {
+    help: 'Create configuration backup',
+    args: ''
+  },
+  'config:rollback': {
+    help: 'Rollback to previous config',
+    args: '[version]'
+  },
+  'config:diff': {
+    help: 'Show config diff',
+    args: '[file1] [file2]'
+  },
+  'qg:check': {
+    help: 'Run quality gate check',
+    args: '[severity]'
+  },
+  'qg:rules': {
+    help: 'List available quality rules',
+    args: ''
+  },
+  'qg:init': {
+    help: 'Initialize quality gate config',
+    args: ''
+  },
   changelog: {
     help: 'Generate changelog from git commits',
     args: '[--from <tag>] [--to <tag>] [--json]'

package/config/quality-gate.json

@@ -0,0 +1,61 @@
+{
+  "enabled": true,
+  "severity": "warn",
+  "rules": [
+    {
+      "id": "line-count-limit",
+      "enabled": true,
+      "severity": "error",
+      "config": {
+        "maxLines": 800
+      }
+    },
+    {
+      "id": "file-size-limit",
+      "enabled": true,
+      "severity": "warn",
+      "config": {
+        "maxSize": 819200
+      }
+    },
+    {
+      "id": "no-empty-files",
+      "enabled": true,
+      "severity": "warn"
+    },
+    {
+      "id": "no-trailing-whitespace",
+      "enabled": true,
+      "severity": "warn"
+    },
+    {
+      "id": "todo-comments",
+      "enabled": true,
+      "severity": "info"
+    },
+    {
+      "id": "directory-depth",
+      "enabled": false,
+      "severity": "warn"
+    },
+    {
+      "id": "no-console-logs",
+      "enabled": false,
+      "severity": "warn"
+    },
+    {
+      "id": "function-length",
+      "enabled": false,
+      "severity": "warn"
+    }
+  ],
+  "gates": {
+    "preCommit": true,
+    "prePush": true,
+    "onToolUse": false
+  },
+  "reporting": {
+    "format": "console",
+    "outputFile": null
+  }
+}

package/lib/commands.js

@@ -2321,6 +2321,214 @@ All notable changes to this project will be documented in this file.
 
     log('=====================================', 'gray');
     log('', 'gray');
+  },
+
+  // ==========================================================================
+  // Quality Gate Commands
+  // ==========================================================================
+
+  'qg:check': async (severity = 'warn') => {
+    const { QualityGate } = require('./quality-gate');
+    const gate = new QualityGate({ projectDir: process.cwd() });
+    const result = await gate.check({ severity });
+    process.exit(result.passed ? 0 : 1);
+  },
+
+  'qg:rules': () => {
+    const registry = require('./quality-rules').registry;
+    const rules = registry.getAll();
+
+    console.log('📋 Available Quality Rules');
+    console.log('');
+    console.log('Rules are checked when running quality gate:');
+    console.log('');
+
+    const byCategory = {};
+    for (const rule of rules) {
+      if (!byCategory[rule.category]) byCategory[rule.category] = [];
+      byCategory[rule.category].push(rule);
+    }
+
+    for (const [category, rules] of Object.entries(byCategory)) {
+      console.log(`${category.toUpperCase()}:`);
+      for (const rule of rules) {
+        const status = rule.enabled ? '✅' : '⊝';
+        const sev = { info: 'I', warn: 'W', error: 'E', critical: 'X' }[rule.severity];
+        console.log(`  ${status} ${rule.id} [${sev}] - ${rule.name}`);
+      }
+      console.log('');
+    }
+  },
+
+  'qg:init': () => {
+    const projectDir = process.cwd();
+    const configDir = path.join(projectDir, '.claude');
+    const targetPath = path.join(configDir, 'quality-gate.json');
+    const sourcePath = path.join(__dirname, '../config/quality-gate.json');
+
+    if (fs.existsSync(targetPath)) {
+      console.log('⚠️  quality-gate.json already exists');
+      return;
+    }
+
+    ensureDir(configDir);
+    fs.copyFileSync(sourcePath, targetPath);
+    console.log('✅ Created .claude/quality-gate.json');
+    console.log('');
+    console.log('To enable Git hooks:');
+    console.log('  ln -s .claude/hooks/pre-commit.cjs .git/hooks/pre-commit');
+    console.log('  ln -s .claude/hooks/pre-push.cjs .git/hooks/pre-push');
+  },
+
+  // ==========================================================================
+  // Config Commands
+  // ==========================================================================
+
+  'config:validate': () => {
+    const { ConfigValidator } = require('./config-validator');
+    const validator = new ConfigValidator();
+
+    console.log('🔍 Validating configuration...');
+    console.log('');
+
+    let hasErrors = false;
+    let hasWarnings = false;
+
+    // Check global config
+    const globalConfigPath = path.join(process.env.HOME, '.claude', 'config.json');
+    console.log(`Global: ${globalConfigPath}`);
+    const globalResult = validator.validateFile(globalConfigPath);
+
+    if (globalResult.valid) {
+      console.log('  ✅ Valid');
+    } else {
+      if (globalResult.errors.length > 0) {
+        hasErrors = true;
+        console.log(`  ❌ ${globalResult.errors.length} error(s)`);
+        globalResult.errors.forEach(e => {
+          console.log(`     [${e.severity}] ${e.path}: ${e.message}`);
+        });
+      }
+      if (globalResult.warnings.length > 0) {
+        hasWarnings = true;
+        console.log(`  ⚠️  ${globalResult.warnings.length} warning(s)`);
+        globalResult.warnings.forEach(e => {
+          console.log(`     [${e.severity}] ${e.path}: ${e.message}`);
+        });
+      }
+      if (globalResult.errors.length === 0 && globalResult.warnings.length === 0) {
+        console.log('  ❌ Validation failed');
+      }
+    }
+    console.log('');
+
+    // Check project config if in project
+    const projectDir = process.cwd();
+    const projectConfigPath = path.join(projectDir, '.claude', 'settings.json');
+    if (fs.existsSync(projectConfigPath)) {
+      console.log(`Project: ${projectConfigPath}`);
+      const projectResult = validator.validateFile(projectConfigPath, 'settings');
+      if (projectResult.valid) {
+        console.log('  ✅ Valid');
+      } else {
+        if (projectResult.errors.length > 0) {
+          hasErrors = true;
+          console.log(`  ❌ ${projectResult.errors.length} error(s)`);
+          projectResult.errors.forEach(e => {
+            console.log(`     [${e.severity}] ${e.path}: ${e.message}`);
+          });
+        }
+        if (projectResult.warnings.length > 0) {
+          hasWarnings = true;
+          console.log(`  ⚠️  ${projectResult.warnings.length} warning(s)`);
+          projectResult.warnings.forEach(e => {
+            console.log(`     [${e.severity}] ${e.path}: ${e.message}`);
+          });
+        }
+        if (projectResult.errors.length === 0 && projectResult.warnings.length === 0) {
+          console.log('  ❌ Validation failed');
+        }
+      }
+    }
+    console.log('');
+
+    if (hasErrors) {
+      console.log('❌ Configuration validation failed');
+      process.exit(1);
+    } else if (hasWarnings) {
+      console.log('⚠️  Configuration has warnings (but is valid)');
+    } else {
+      console.log('✅ All configurations are valid');
+    }
+  },
+
+  'config:backup': () => {
+    const { ConfigManager } = require('./config-manager');
+    const manager = new ConfigManager();
+    const backupPath = manager._createBackup();
+    console.log('✅ Config backed up to:', backupPath);
+  },
+
+  'config:rollback': (version) => {
+    const { ConfigManager } = require('./config-manager');
+    const manager = new ConfigManager();
+
+    const backups = manager.listBackups();
+    if (backups.length === 0) {
+      console.log('❌ No backups available');
+      return;
+    }
+
+    if (!version) {
+      console.log('Available backups:');
+      backups.forEach((b, i) => {
+        console.log(`  ${i + 1}. ${b.version} (${new Date(b.timestamp).toLocaleString()})`);
+      });
+      console.log('');
+      console.log('Usage: smc config:rollback <version>');
+      return;
+    }
+
+    try {
+      const result = manager.rollback(version);
+      console.log('✅ Rolled back to:', result.restoredFrom);
+    } catch (e) {
+      console.log('❌', e.message);
+    }
+  },
+
+  'config:diff': (file1, file2) => {
+    const { ConfigManager } = require('./config-manager');
+    const manager = new ConfigManager();
+
+    if (!file1) {
+      const backups = manager.listBackups();
+      if (backups.length === 0) {
+        console.log('❌ No backups available');
+        return;
+      }
+      file1 = path.join(manager.backupDir, backups[0].file);
+      file2 = null; // Current config
+    }
+
+    const changes = manager.diff(file1, file2);
+    if (changes.length === 0) {
+      console.log('✅ No differences found');
+      return;
+    }
+
+    console.log('📊 Config Diff:');
+    console.log('');
+    for (const change of changes) {
+      const icon = { added: '+', removed: '-', changed: '~' }[change.type];
+      console.log(`  ${icon} ${change.path}`);
+      if (change.type !== 'removed') {
+        console.log(`     from: ${JSON.stringify(change.from)}`);
+      }
+      if (change.type !== 'added') {
+        console.log(`     to:   ${JSON.stringify(change.to)}`);
+      }
+    }
   }
 };