@nolrm/contextkit 0.7.4 → 0.8.1

package/README.md

@@ -47,7 +47,7 @@ This creates `.contextkit/` with skeleton context files (blank templates to be f
   standards/       # Skeleton files: code-style.md, testing.md, architecture.md, ai-guidelines.md, workflows.md
                   # Real files: glossary.md (universal), README.md (overview)
   commands/        # analyze.md (project analysis & customization)
-  templates/       # example component template
+  templates/       # skeleton template files (component, test, story, hook, api)
 ```
 
 **Generate content with AI** (recommended):

package/lib/commands/install.js

@@ -31,6 +31,13 @@ class InstallCommand {
       console.log('');
     }
 
+    // Clean up legacy pre-commit hook (replaced by pre-push only)
+    const legacyPreCommit = '.contextkit/hooks/pre-commit.sh';
+    if (await fs.pathExists(legacyPreCommit)) {
+      await fs.remove(legacyPreCommit);
+      console.log(chalk.yellow('🧹 Removed legacy pre-commit hook (replaced by pre-push)'));
+    }
+
     const requestedPlatform = options.platform;
     const isPlatformSpecific = !!requestedPlatform;
 
@@ -178,8 +185,8 @@ class InstallCommand {
     console.log('──────────────────────────────────────────────');
     console.log(chalk.blue('⚙️  Git Hooks Setup'));
     console.log('──────────────────────────────────────────────');
-    console.log('ContextKit can install **pre-commit** and **pre-push** hooks');
-    console.log('to automatically run tests, linting, and type checks before commits.');
+    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('');
     console.log('');
 
@@ -403,6 +410,55 @@ This file is loaded when HTML-related tasks are detected:
     }
   }
 
+  async createSkeletonTemplates() {
+    const skeletonFiles = {
+      'templates/component.md': `# Component Template
+
+<!-- Content will be generated by running: ck analyze -->
+
+Your canonical component/module pattern will be generated based on your project's framework, language, and conventions.
+
+Run \`ck analyze\` to generate this content, or manually add your component pattern below.
+`,
+      'templates/test.md': `# Test Template
+
+<!-- Content will be generated by running: ck analyze -->
+
+Your canonical test file pattern will be generated based on your project's testing framework and conventions.
+
+Run \`ck analyze\` to generate this content, or manually add your test pattern below.
+`,
+      'templates/story.md': `# Story/Demo Template
+
+<!-- Content will be generated by running: ck analyze -->
+
+Your canonical story/demo pattern will be generated based on your project's documentation and showcase conventions.
+
+Run \`ck analyze\` to generate this content, or manually add your story/demo pattern below.
+`,
+      'templates/hook.md': `# Hook/Composable/Helper Template
+
+<!-- Content will be generated by running: ck analyze -->
+
+Your canonical hook, composable, or helper pattern will be generated based on your project's framework and conventions.
+
+Run \`ck analyze\` to generate this content, or manually add your pattern below.
+`,
+      'templates/api.md': `# API Service/Client Template
+
+<!-- Content will be generated by running: ck analyze -->
+
+Your canonical API service or client pattern will be generated based on your project's architecture and conventions.
+
+Run \`ck analyze\` to generate this content, or manually add your API pattern below.
+`
+    };
+
+    for (const [relativePath, content] of Object.entries(skeletonFiles)) {
+      await fs.writeFile(`.contextkit/${relativePath}`, content);
+    }
+  }
+
   async downloadFiles(projectType, options = {}, detectedTools = {}) {
     try {
       // Create skeleton standards files (will be customized by analyze)
@@ -451,11 +507,7 @@ This file is loaded when HTML-related tasks are detected:
         '.contextkit/commands/analyze.md'
       );
 
-      // Download hooks
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/hooks/pre-commit.sh`,
-        '.contextkit/hooks/pre-commit.sh'
-      );
+      // Download hooks (pre-push and commit-msg only, no pre-commit)
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/hooks/pre-push.sh`,
         '.contextkit/hooks/pre-push.sh'
@@ -487,27 +539,8 @@ This file is loaded when HTML-related tasks are detected:
         '.contextkit/types/typescript-strict.json'
       );
 
-      // Download templates
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/templates/component.tsx`,
-        '.contextkit/templates/component.tsx'
-      );
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/templates/test.tsx`,
-        '.contextkit/templates/test.tsx'
-      );
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/templates/story.tsx`,
-        '.contextkit/templates/story.tsx'
-      );
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/templates/hook.ts`,
-        '.contextkit/templates/hook.ts'
-      );
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/templates/api.ts`,
-        '.contextkit/templates/api.ts'
-      );
+      // Create skeleton template files (will be customized by analyze)
+      await this.createSkeletonTemplates();
 
       // Download scripts
       await this.downloadManager.downloadFile(
@@ -516,7 +549,6 @@ This file is loaded when HTML-related tasks are detected:
       );
 
       // Make scripts executable
-      await fs.chmod('.contextkit/hooks/pre-commit.sh', '755');
       await fs.chmod('.contextkit/hooks/pre-push.sh', '755');
       await fs.chmod('.contextkit/hooks/commit-msg.sh', '755');
       await fs.chmod('.contextkit/hooks/setup-hooks.sh', '755');
@@ -631,11 +663,11 @@ claude "read .contextkit/context.md to see available standards, then create a bu
 - \`.contextkit/instructions/core/auto-corrections-log.md\` - Auto-logging instructions
 
 ### Templates
-- \`.contextkit/templates/component.tsx\`
-- \`.contextkit/templates/test.tsx\`
-- \`.contextkit/templates/story.tsx\`
-- \`.contextkit/templates/hook.ts\`
-- \`.contextkit/templates/api.ts\`
+- \`.contextkit/templates/component.md\`
+- \`.contextkit/templates/test.md\`
+- \`.contextkit/templates/story.md\`
+- \`.contextkit/templates/hook.md\`
+- \`.contextkit/templates/api.md\`
 
 ### Tracking
 - \`.contextkit/corrections.md\` - AI performance corrections log

package/lib/commands/update.js

@@ -45,6 +45,13 @@ class UpdateCommand {
       const projectType = this.projectDetector.detectProjectType();
       const packageManager = this.projectDetector.detectPackageManager();
 
+      // Clean up legacy pre-commit hook (replaced by pre-push only)
+      const legacyPreCommit = '.contextkit/hooks/pre-commit.sh';
+      if (await fs.pathExists(legacyPreCommit)) {
+        await fs.remove(legacyPreCommit);
+        console.log(chalk.yellow('🧹 Removed legacy pre-commit hook (replaced by pre-push)'));
+      }
+
       // Download latest files
       await this.downloadFiles(projectType);
 
@@ -219,11 +226,7 @@ class UpdateCommand {
         '.contextkit/commands/analyze.md'
       );
 
-      // Download hooks
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/hooks/pre-commit.sh`,
-        '.contextkit/hooks/pre-commit.sh'
-      );
+      // Download hooks (pre-push and commit-msg only, no pre-commit)
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/hooks/pre-push.sh`,
         '.contextkit/hooks/pre-push.sh'
@@ -255,27 +258,7 @@ class UpdateCommand {
         '.contextkit/types/typescript-strict.json'
       );
 
-      // Download templates
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/templates/component.tsx`,
-        '.contextkit/templates/component.tsx'
-      );
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/templates/test.tsx`,
-        '.contextkit/templates/test.tsx'
-      );
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/templates/story.tsx`,
-        '.contextkit/templates/story.tsx'
-      );
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/templates/hook.ts`,
-        '.contextkit/templates/hook.ts'
-      );
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/templates/api.ts`,
-        '.contextkit/templates/api.ts'
-      );
+      // Templates are user-owned skeleton files — not overwritten during update
 
       // Download scripts
       await this.downloadManager.downloadFile(
@@ -284,7 +267,6 @@ class UpdateCommand {
       );
 
       // Make scripts executable
-      await fs.chmod('.contextkit/hooks/pre-commit.sh', '755');
       await fs.chmod('.contextkit/hooks/pre-push.sh', '755');
       await fs.chmod('.contextkit/hooks/commit-msg.sh', '755');
       await fs.chmod('.contextkit/hooks/setup-hooks.sh', '755');

package/lib/integrations/aider-integration.js

@@ -47,10 +47,10 @@ ${this.getStandardsBlock()}
 
 ## Templates
 
-- @.contextkit/templates/component.tsx — Component template
-- @.contextkit/templates/test.tsx — Test template
-- @.contextkit/templates/hook.ts — Custom hook template
-- @.contextkit/templates/api.ts — API service template
+- @.contextkit/templates/component.md — Component template
+- @.contextkit/templates/test.md — Test template
+- @.contextkit/templates/hook.md — Custom hook template
+- @.contextkit/templates/api.md — API service template
 
 ## Always Include
 

package/lib/integrations/claude-integration.js

@@ -88,7 +88,7 @@ globs:
 When writing or modifying tests, follow:
 - \`.contextkit/standards/testing.md\` for test patterns and requirements
 - All test cases MUST use numbered descriptions (e.g., \`it("1. renders correctly")\`)
-- Reference \`.contextkit/templates/test.tsx\` for test template patterns
+- Reference \`.contextkit/templates/test.md\` for test template patterns
 `;
     await this.writeGeneratedFile('.claude/rules/contextkit-testing.md', testingRule);
 
@@ -106,9 +106,9 @@ globs:
 
 When writing or modifying source code, follow:
 - \`.contextkit/standards/code-style.md\` for coding conventions
-- \`.contextkit/templates/component.tsx\` for component patterns
-- \`.contextkit/templates/hook.ts\` for custom hook patterns
-- \`.contextkit/templates/api.ts\` for API service patterns
+- \`.contextkit/templates/component.md\` for component patterns
+- \`.contextkit/templates/hook.md\` for custom hook patterns
+- \`.contextkit/templates/api.md\` for API service patterns
 `;
     await this.writeGeneratedFile('.claude/rules/contextkit-code-style.md', codeStyleRule);
 

package/lib/integrations/copilot-integration.js

@@ -25,7 +25,7 @@ ${this.getStandardsBlock()}
 - Follow coding conventions in \`.contextkit/standards/code-style.md\`
 - Use numbered test cases as defined in \`.contextkit/standards/testing.md\`
 - Check \`.contextkit/standards/glossary.md\` for project-specific terminology
-- Reference \`.contextkit/templates/\` for code generation patterns`;
+- Reference \`.contextkit/templates/\` for code generation patterns (skeleton .md files)`;
 
     await this.writeBridgeFile('.github/copilot-instructions.md', bridgeContent);
 

package/lib/integrations/cursor-integration.js

@@ -95,7 +95,7 @@ describe("ComponentName", () => {
 
 ## Templates
 
-- @.contextkit/templates/test.tsx — Test template
+- @.contextkit/templates/test.md — Test template
 `;
     await this.writeGeneratedFile('.cursor/rules/contextkit-testing.mdc', testingRule);
 
@@ -112,9 +112,9 @@ Reference: @.contextkit/standards/code-style.md
 
 ## Templates
 
-- @.contextkit/templates/component.tsx — Component template
-- @.contextkit/templates/story.tsx — Storybook template
-- @.contextkit/templates/hook.ts — Custom hook template
+- @.contextkit/templates/component.md — Component template
+- @.contextkit/templates/story.md — Story/demo template
+- @.contextkit/templates/hook.md — Custom hook template
 
 ## Commands
 
@@ -135,7 +135,7 @@ Reference: @.contextkit/standards/architecture.md
 
 ## Templates
 
-- @.contextkit/templates/api.ts — API service template
+- @.contextkit/templates/api.md — API service template
 
 ## Commands
 

package/lib/integrations/windsurf-integration.js

@@ -59,10 +59,10 @@ This project uses ContextKit for structured development standards.
 
 ## Templates
 
-- \`.contextkit/templates/component.tsx\` — Component template
-- \`.contextkit/templates/test.tsx\` — Test template
-- \`.contextkit/templates/hook.ts\` — Custom hook template
-- \`.contextkit/templates/api.ts\` — API service template
+- \`.contextkit/templates/component.md\` — Component template
+- \`.contextkit/templates/test.md\` — Test template
+- \`.contextkit/templates/hook.md\` — Custom hook template
+- \`.contextkit/templates/api.md\` — API service template
 
 ## Commands
 

package/lib/utils/git-hooks.js

@@ -152,6 +152,16 @@ fi
     // Backup existing hooks
     await this.backupExistingHooks();
 
+    // Remove legacy pre-commit hook if it exists (replaced by pre-push)
+    const legacyPreCommitHook = `${this.hooksDir}/pre-commit`;
+    if (fs.existsSync(legacyPreCommitHook)) {
+      const content = await fs.readFile(legacyPreCommitHook, 'utf8');
+      if (content.includes('.contextkit/') || content.includes('.vibe-kit/')) {
+        await fs.remove(legacyPreCommitHook);
+        console.log(chalk.yellow('🧹 Removed legacy pre-commit hook (replaced by pre-push)'));
+      }
+    }
+
     // Add new hooks
     const hooks = [
       { name: 'pre-push', script: '.contextkit/hooks/pre-push.sh' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nolrm/contextkit",
-  "version": "0.7.4",
+  "version": "0.8.1",
   "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": {