@nolrm/contextkit 0.7.3 → 0.8.0

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/check.js

@@ -56,8 +56,8 @@ class CheckCommand {
 
   async checkManifest(config) {
     // Check manifest schema
-    if (!config.vk) {
-      this.warnings.push('Manifest missing "vk" field (should be 1)');
+    if (!config.ck) {
+      this.warnings.push('Manifest missing "ck" field (should be 1)');
     }
 
     if (!config.version) {

package/lib/commands/install.js

@@ -403,6 +403,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)
@@ -487,27 +536,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(
@@ -631,11 +661,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/publish.js

@@ -49,7 +49,7 @@ class PublishCommand {
       '.git'
     ];
 
-    await this.copyVibeKitFiles('.contextkit', packageDir, excludePatterns);
+    await this.copyContextKitFiles('.contextkit', packageDir, excludePatterns);
 
     // Create package.json for the published package
     const config = await this.loadConfig();
@@ -57,8 +57,8 @@ class PublishCommand {
       name: name,
       version: version,
       description: `ContextKit configuration for ${config.project_name || 'project'}`,
-      vibeKit: {
-        vk: config.vk || 1,
+      contextKit: {
+        ck: config.ck || 1,
         profile: config.profile,
         generated_at: new Date().toISOString(),
         published_at: new Date().toISOString()
@@ -140,7 +140,7 @@ ${version} - Published ${new Date().toISOString().split('T')[0]}
     console.log(chalk.dim(`Registry location: ${this.registryPath}`));
   }
 
-  async copyVibeKitFiles(sourceDir, targetDir, excludePatterns) {
+  async copyContextKitFiles(sourceDir, targetDir, excludePatterns) {
     const files = await fs.readdir(sourceDir, { withFileTypes: true });
 
     for (const file of files) {
@@ -158,7 +158,7 @@ ${version} - Published ${new Date().toISOString().split('T')[0]}
 
       if (file.isDirectory()) {
         await fs.ensureDir(targetPath);
-        await this.copyVibeKitFiles(sourcePath, targetPath, excludePatterns);
+        await this.copyContextKitFiles(sourcePath, targetPath, excludePatterns);
       } else {
         await fs.copy(sourcePath, targetPath);
       }

package/lib/commands/update.js

@@ -255,27 +255,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(

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);
 
@@ -51,8 +51,8 @@ ${this.getStandardsBlock()}
     settings['github.copilot.chat.codeGeneration.instructions'] = [
       { file: '.github/copilot-instructions.md' }
     ];
-    settings['vibeKit.standardsPath'] = '.contextkit/standards';
-    settings['vibeKit.templatesPath'] = '.contextkit/templates';
+    settings['contextKit.standardsPath'] = '.contextkit/standards';
+    settings['contextKit.templatesPath'] = '.contextkit/templates';
 
     await fs.writeJson(settingsPath, settings, { spaces: 2 });
   }

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

@@ -154,7 +154,6 @@ fi
 
     // Add new hooks
     const hooks = [
-      { name: 'pre-commit', script: '.contextkit/hooks/pre-commit.sh' },
       { name: 'pre-push', script: '.contextkit/hooks/pre-push.sh' },
       { name: 'commit-msg', script: '.contextkit/hooks/commit-msg.sh' }
     ];
@@ -184,8 +183,8 @@ ${scriptPath}
   }
 
   async backupExistingHooks() {
-    const hooks = ['pre-commit', 'pre-push', 'commit-msg'];
-    
+    const hooks = ['pre-push', 'commit-msg'];
+
     for (const hook of hooks) {
       const hookPath = `${this.hooksDir}/${hook}`;
       if (fs.existsSync(hookPath)) {
@@ -208,8 +207,8 @@ ${scriptPath}
   async uninstallHooks() {
     console.log(chalk.yellow('🪝 Removing Git hooks...'));
     
-    const hooks = ['pre-commit', 'pre-push', 'commit-msg'];
-    
+    const hooks = ['pre-push', 'commit-msg'];
+
     for (const hook of hooks) {
       const hookPath = `${this.hooksDir}/${hook}`;
       const backupPath = `${hookPath}.backup`;

package/package.json

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