@nolrm/contextkit 0.8.1 → 0.8.4

package/README.md

@@ -138,6 +138,37 @@ ck ai "create checkout flow for customer"
 
 ---
 
+## Git Hooks
+
+ContextKit can optionally install Git hooks during `ck install`:
+
+| Hook | What it does |
+|------|-------------|
+| **pre-push** | Runs tests, linting, and type checks before pushing |
+| **commit-msg** | Enforces [Conventional Commits](https://www.conventionalcommits.org/) format |
+
+### Commit Message Format
+
+When the `commit-msg` hook is enabled, all commits must follow this format:
+
+```
+<type>(<scope>): <description>
+```
+
+**Types:** `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`
+
+**Examples:**
+```bash
+git commit -m "feat(auth): add login page"
+git commit -m "fix: resolve null pointer in checkout"
+git commit -m "docs: update API reference"
+git commit -m "test(cart): add edge case coverage"
+```
+
+Hooks are optional and can be skipped with `ck install --no-hooks`.
+
+---
+
 ## Key Features
 
 - 🧠 **Context Engineering** - Structured MD files your AI reads automatically

package/lib/commands/install.js

@@ -101,24 +101,26 @@ class InstallCommand {
     await this.downloadFiles(projectType, options, detectedTools);
 
     // Ask about Git hooks
-    let installHooks = true;
+    let hookChoices = { prePush: true, commitMsg: true };
     if (!options.nonInteractive && !options.noHooks) {
-      installHooks = await this.promptGitHooks();
+      hookChoices = await this.promptGitHooks();
+    } else if (options.noHooks) {
+      hookChoices = { prePush: false, commitMsg: false };
     }
 
     // Install Git hooks if requested
-    if (installHooks) {
-      await this.gitHooksManager.installHooks(packageManager);
+    if (hookChoices.prePush || hookChoices.commitMsg) {
+      await this.gitHooksManager.installHooks(packageManager, hookChoices);
     }
 
     // Create configuration
-    await this.createConfiguration(projectType, installHooks);
+    await this.createConfiguration(projectType, hookChoices);
 
     // Create status tracking
-    await this.createStatusFile(projectType, packageManager, installHooks);
+    await this.createStatusFile(projectType, packageManager, hookChoices);
 
     // Success message
-    this.showSuccessMessage(installHooks, detectedTools, projectType, packageManager);
+    this.showSuccessMessage(hookChoices, detectedTools, projectType, packageManager);
   }
 
   async installPlatformIntegration(platform) {
@@ -173,41 +175,70 @@ class InstallCommand {
     // Check for non-interactive mode
     if (process.env.CI === 'true' || process.env.NON_INTERACTIVE === 'true') {
       console.log(chalk.yellow('🤖 Non-interactive mode detected, skipping Git hooks'));
-      return false;
+      return { prePush: false, commitMsg: false };
     }
 
     if (!await fs.pathExists('package.json')) {
       console.log(chalk.yellow('⚠️  Skipping Git hooks setup (no package.json found)'));
-      return false;
+      return { prePush: false, commitMsg: false };
     }
 
     console.log('');
     console.log('──────────────────────────────────────────────');
     console.log(chalk.blue('⚙️  Git Hooks Setup'));
     console.log('──────────────────────────────────────────────');
-    console.log('ContextKit can install **pre-push** and **commit-msg** hooks');
-    console.log('to automatically run tests, linting, and type checks before pushing.');
     console.log('');
+
+    // Ask about pre-push hook
+    console.log(chalk.bold('Pre-push hook'));
+    console.log(chalk.dim('Runs tests, linting, and type checks before pushing.'));
+    console.log('');
+    const { prePush } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'prePush',
+        message: 'Enable pre-push hook? (runs quality checks before push)',
+        default: false
+      }
+    ]);
+
+    if (prePush) {
+      console.log(chalk.green('  ✅ Pre-push hook enabled'));
+    } else {
+      console.log(chalk.yellow('  ⏭️  Skipping pre-push hook'));
+    }
     console.log('');
 
-    const { installHooks } = await inquirer.prompt([
+    // Ask about commit-msg hook
+    console.log(chalk.bold('Commit message hook'));
+    console.log(chalk.dim('Enforces conventional commit format:'));
+    console.log(chalk.dim('  <type>(<scope>): <description>'));
+    console.log(chalk.dim('  types: feat, fix, docs, style, refactor, test, chore'));
+    console.log(chalk.dim('  example: feat(auth): add login page'));
+    console.log('');
+    const { commitMsg } = await inquirer.prompt([
       {
         type: 'confirm',
-        name: 'installHooks',
-        message: 'Do you want to enable Git hooks?',
+        name: 'commitMsg',
+        message: 'Enable commit-msg hook? (enforces conventional commit format)',
         default: false
       }
     ]);
 
-    if (installHooks) {
-      console.log(chalk.green('✅ Git hooks enabled'));
+    if (commitMsg) {
+      console.log(chalk.green('  ✅ Commit message hook enabled'));
+      console.log(chalk.blue('  💡 Commits must use: <type>(scope): description'));
     } else {
-      console.log(chalk.yellow('⏭️  Skipping Git hooks for now'));
-      console.log(chalk.blue('💡 You can enable them anytime with: `ck update --hooks`'));
+      console.log(chalk.yellow('  ⏭️  Skipping commit message hook'));
     }
     console.log('');
 
-    return installHooks;
+    if (!prePush && !commitMsg) {
+      console.log(chalk.blue('💡 You can enable hooks anytime with: `ck update --hooks`'));
+      console.log('');
+    }
+
+    return { prePush, commitMsg };
   }
 
   async createDirectoryStructure() {
@@ -751,9 +782,9 @@ esac
     console.log(chalk.green('✅ CLI helpers installed'));
   }
 
-  async createConfiguration(projectType, gitHooksEnabled) {
+  async createConfiguration(projectType, hookChoices) {
     const projectName = path.basename(process.cwd());
-    
+
     const config = {
       version: '1.0.0',
       project_name: projectName,
@@ -764,7 +795,8 @@ esac
         code_review: true,
         linting: true,
         type_safety: true,
-        git_hooks: gitHooksEnabled
+        pre_push_hook: hookChoices.prePush,
+        commit_msg_hook: hookChoices.commitMsg
       },
       paths: {
         components: 'src/components',
@@ -830,7 +862,8 @@ features:
   code_review: ${config.features.code_review}
   linting: ${config.features.linting}
   type_safety: ${config.features.type_safety}
-  git_hooks: ${config.features.git_hooks}
+  pre_push_hook: ${config.features.pre_push_hook}
+  commit_msg_hook: ${config.features.commit_msg_hook}
 
 # Paths (customize for your project)
 paths:
@@ -857,12 +890,13 @@ metadata:
     );
   }
 
-  async createStatusFile(projectType, packageManager, gitHooksEnabled) {
+  async createStatusFile(projectType, packageManager, hookChoices) {
     try {
       const status = this.statusManager.getDefaultStatus();
       status.project_type = projectType;
       status.package_manager = packageManager;
-      status.features.git_hooks = gitHooksEnabled;
+      status.features.pre_push_hook = hookChoices.prePush;
+      status.features.commit_msg_hook = hookChoices.commitMsg;
       
       await this.statusManager.saveStatus(status);
       console.log(chalk.green('✅ Status tracking initialized'));
@@ -1378,7 +1412,7 @@ enforcement:
     console.log(chalk.green('✅ Policy file created'));
   }
 
-  showSuccessMessage(gitHooksEnabled, detectedTools = {}, projectType = '', packageManager = '') {
+  showSuccessMessage(hookChoices, detectedTools = {}, projectType = '', packageManager = '') {
     console.log('');
     console.log(chalk.green('🎉 ContextKit v1.0.0 successfully installed!'));
     console.log('');

package/lib/commands/status.js

@@ -48,7 +48,8 @@ class StatusCommand {
       console.log('');
       
       console.log(chalk.blue('✅ Features:'));
-      console.log(`   Git Hooks: ${status.features.git_hooks ? '✅' : '❌'}`);
+      console.log(`   Pre-push hook: ${status.features.pre_push_hook ? '✅' : '❌'}`);
+      console.log(`   Commit-msg hook: ${status.features.commit_msg_hook ? '✅' : '❌'}`);
       console.log(`   Standards: ${status.features.standards ? '✅' : '❌'}`);
       console.log(`   Templates: ${status.features.templates ? '✅' : '❌'}`);
       console.log('');
@@ -121,8 +122,15 @@ class StatusCommand {
         config.features = config.features || {};
         config.features.type_safety = trimmed.split('type_safety:')[1].trim() === 'true';
       } else if (trimmed.startsWith('git_hooks:')) {
+        // Legacy single-flag compat
         config.features = config.features || {};
         config.features.git_hooks = trimmed.split('git_hooks:')[1].trim() === 'true';
+      } else if (trimmed.startsWith('pre_push_hook:')) {
+        config.features = config.features || {};
+        config.features.pre_push_hook = trimmed.split('pre_push_hook:')[1].trim() === 'true';
+      } else if (trimmed.startsWith('commit_msg_hook:')) {
+        config.features = config.features || {};
+        config.features.commit_msg_hook = trimmed.split('commit_msg_hook:')[1].trim() === 'true';
       }
     }
 

package/lib/commands/update.js

@@ -59,8 +59,12 @@ class UpdateCommand {
       await this.restoreUserConfig(config);
 
       // Update Git hooks if they were enabled
-      if (config.features?.git_hooks) {
-        await this.gitHooksManager.installHooks(packageManager);
+      const hookChoices = {
+        prePush: config.features?.pre_push_hook || config.features?.git_hooks || false,
+        commitMsg: config.features?.commit_msg_hook || config.features?.git_hooks || false
+      };
+      if (hookChoices.prePush || hookChoices.commitMsg) {
+        await this.gitHooksManager.installHooks(packageManager, hookChoices);
       }
 
       // Refresh installed platform integrations
@@ -176,8 +180,15 @@ class UpdateCommand {
         config.features = config.features || {};
         config.features.type_safety = trimmed.split('type_safety:')[1].trim() === 'true';
       } else if (trimmed.startsWith('git_hooks:')) {
+        // Legacy single-flag compat
         config.features = config.features || {};
         config.features.git_hooks = trimmed.split('git_hooks:')[1].trim() === 'true';
+      } else if (trimmed.startsWith('pre_push_hook:')) {
+        config.features = config.features || {};
+        config.features.pre_push_hook = trimmed.split('pre_push_hook:')[1].trim() === 'true';
+      } else if (trimmed.startsWith('commit_msg_hook:')) {
+        config.features = config.features || {};
+        config.features.commit_msg_hook = trimmed.split('commit_msg_hook:')[1].trim() === 'true';
       }
     }
 
@@ -294,7 +305,8 @@ features:
   code_review: ${config.features?.code_review || true}
   linting: ${config.features?.linting || true}
   type_safety: ${config.features?.type_safety || true}
-  git_hooks: ${config.features?.git_hooks || false}
+  pre_push_hook: ${config.features?.pre_push_hook || config.features?.git_hooks || false}
+  commit_msg_hook: ${config.features?.commit_msg_hook || config.features?.git_hooks || false}
 
 # Paths (customize for your project)
 paths:

package/lib/utils/git-hooks.js

@@ -7,7 +7,7 @@ class GitHooksManager {
     this.hooksDir = '.husky';
   }
 
-  async installHooks(packageManager) {
+  async installHooks(packageManager, hookChoices = { prePush: true, commitMsg: true }) {
     console.log(chalk.yellow('🪝 Setting up Git hooks...'));
 
     // Check if Node.js is available
@@ -24,7 +24,7 @@ class GitHooksManager {
       await this.initializeHusky(packageManager);
 
       // Add hooks
-      await this.addHooks(packageManager);
+      await this.addHooks(packageManager, hookChoices);
 
       console.log(chalk.green('✅ Git hooks setup complete'));
 
@@ -148,7 +148,7 @@ fi
     console.log(chalk.green('✅ Husky initialized'));
   }
 
-  async addHooks(packageManager) {
+  async addHooks(packageManager, hookChoices = { prePush: true, commitMsg: true }) {
     // Backup existing hooks
     await this.backupExistingHooks();
 
@@ -162,14 +162,12 @@ fi
       }
     }
 
-    // Add new hooks
-    const hooks = [
-      { name: 'pre-push', script: '.contextkit/hooks/pre-push.sh' },
-      { name: 'commit-msg', script: '.contextkit/hooks/commit-msg.sh' }
-    ];
-
-    for (const hook of hooks) {
-      await this.addHook(packageManager, hook.name, hook.script);
+    // Add selected hooks
+    if (hookChoices.prePush) {
+      await this.addHook(packageManager, 'pre-push', '.contextkit/hooks/pre-push.sh');
+    }
+    if (hookChoices.commitMsg) {
+      await this.addHook(packageManager, 'commit-msg', '.contextkit/hooks/commit-msg.sh');
     }
   }
 
@@ -183,7 +181,7 @@ fi
     const hookContent = `#!/usr/bin/env sh
 . "$(dirname -- "$0")/_/husky.sh"
 
-${scriptPath}
+${scriptPath} "$@"
 `;
     
     await fs.writeFile(hookPath, hookContent);

package/lib/utils/status-manager.js

@@ -31,7 +31,8 @@ class StatusManager {
         package_manager: null
       },
       features: {
-        git_hooks: false,
+        pre_push_hook: false,
+        commit_msg_hook: false,
         standards: true,
         templates: true
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nolrm/contextkit",
-  "version": "0.8.1",
+  "version": "0.8.4",
   "description": "ContextKit - Context Engineering for AI Development. Provide rich context to AI through structured MD files with standards, code guides, and documentation. Works with Cursor, Claude, Aider, VS Code Copilot, and more.",
   "main": "lib/index.js",
   "bin": {