@nolrm/contextkit 0.7.3

package/lib/integrations/claude-integration.js

@@ -0,0 +1,141 @@
+const chalk = require('chalk');
+const BaseIntegration = require('./base-integration');
+
+class ClaudeIntegration extends BaseIntegration {
+  constructor() {
+    super();
+    this.name = 'claude';
+    this.displayName = 'Claude Code';
+    this.bridgeFiles = ['CLAUDE.md'];
+    this.generatedFiles = [
+      '.claude/rules/contextkit-standards.md',
+      '.claude/rules/contextkit-testing.md',
+      '.claude/rules/contextkit-code-style.md',
+      '.claude/commands/analyze.md',
+    ];
+    this.platformDir = '.claude/rules';
+  }
+
+  async install() {
+    await super.install();
+    const fs = require('fs-extra');
+    await fs.ensureDir('.claude/commands');
+    await this.removeLegacyFiles();
+  }
+
+  async removeLegacyFiles() {
+    const fs = require('fs-extra');
+    const legacyFiles = [
+      '.claude/rules/vibe-kit-standards.md',
+      '.claude/rules/vibe-kit-testing.md',
+      '.claude/rules/vibe-kit-code-style.md',
+    ];
+    for (const file of legacyFiles) {
+      if (await fs.pathExists(file)) {
+        await fs.remove(file);
+      }
+    }
+  }
+
+  async generateFiles() {
+    // Bridge file: CLAUDE.md (auto-loaded every session)
+    const bridgeContent = `# Project Standards (ContextKit)
+
+This project uses [ContextKit](https://github.com/nolrm/contextkit) for AI development standards.
+
+${this.getStandardsBlock()}
+
+## Corrections Log
+
+- \`.contextkit/corrections.md\` — Track AI performance improvements
+
+## Quick Reference
+
+Before writing code, check the relevant standards files above. Always follow the project's established patterns and conventions.`;
+
+    await this.writeBridgeFile('CLAUDE.md', bridgeContent);
+
+    // Rule: always-apply standards pointer
+    const standardsRule = `---
+description: ContextKit project standards - always loaded
+alwaysApply: true
+---
+
+# ContextKit Standards
+
+This project uses ContextKit for structured development standards.
+
+Always reference the following before generating code:
+- \`.contextkit/standards/code-style.md\` for coding conventions
+- \`.contextkit/standards/architecture.md\` for architecture patterns
+- \`.contextkit/standards/ai-guidelines.md\` for AI behavior rules
+- \`.contextkit/standards/glossary.md\` for project terminology
+- \`.contextkit/product/mission-lite.md\` for product context
+`;
+    await this.writeGeneratedFile('.claude/rules/contextkit-standards.md', standardsRule);
+
+    // Rule: testing standards (scoped to test files)
+    const testingRule = `---
+description: ContextKit testing standards for test files
+globs:
+  - "**/*.test.*"
+  - "**/*.spec.*"
+  - "**/__tests__/**"
+---
+
+# Testing Standards
+
+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
+`;
+    await this.writeGeneratedFile('.claude/rules/contextkit-testing.md', testingRule);
+
+    // Rule: code style (scoped to source files)
+    const codeStyleRule = `---
+description: ContextKit code style for source files
+globs:
+  - "src/**"
+  - "lib/**"
+  - "app/**"
+  - "packages/**"
+---
+
+# Code Style
+
+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
+`;
+    await this.writeGeneratedFile('.claude/rules/contextkit-code-style.md', codeStyleRule);
+
+    // Command: analyze
+    const analyzeCommand = `# Analyze Project
+
+Read \`.contextkit/commands/analyze.md\` and execute the analysis workflow for this project.
+
+Scan the codebase structure, detect frameworks and patterns, then generate customized standards files in \`.contextkit/standards/\`.
+`;
+    await this.writeGeneratedFile('.claude/commands/analyze.md', analyzeCommand);
+  }
+
+  showUsage() {
+    console.log('');
+    console.log(chalk.bold('  Claude Code Usage:'));
+    console.log('    CLAUDE.md is auto-loaded every session');
+    console.log('    .claude/rules/ are loaded based on file context');
+    console.log('    Use /analyze slash command for project analysis');
+    console.log('');
+    console.log(chalk.dim('  Files created:'));
+    console.log(chalk.dim('    CLAUDE.md (bridge - auto-loaded)'));
+    console.log(chalk.dim('    .claude/rules/contextkit-standards.md (always apply)'));
+    console.log(chalk.dim('    .claude/rules/contextkit-testing.md (test files)'));
+    console.log(chalk.dim('    .claude/rules/contextkit-code-style.md (source files)'));
+    console.log(chalk.dim('    .claude/commands/analyze.md (slash command)'));
+  }
+}
+
+module.exports = ClaudeIntegration;

package/lib/integrations/codex-integration.js

@@ -0,0 +1,45 @@
+const chalk = require('chalk');
+const BaseIntegration = require('./base-integration');
+
+class CodexIntegration extends BaseIntegration {
+  constructor() {
+    super();
+    this.name = 'codex';
+    this.displayName = 'OpenAI Codex CLI';
+    this.bridgeFiles = ['AGENTS.md'];
+    this.generatedFiles = [];
+    this.platformDir = '';
+  }
+
+  async generateFiles() {
+    // Bridge file: AGENTS.md (auto-loaded by Codex CLI)
+    const bridgeContent = `# Project Standards (ContextKit)
+
+This project uses [ContextKit](https://github.com/nolrm/contextkit) for AI development standards.
+
+${this.getStandardsBlock()}
+
+## Corrections Log
+
+- \`.contextkit/corrections.md\` — Track AI performance improvements
+
+## Quick Reference
+
+Before writing code, check the relevant standards files above. Always follow the project's established patterns and conventions.`;
+
+    await this.writeBridgeFile('AGENTS.md', bridgeContent);
+  }
+
+  showUsage() {
+    console.log('');
+    console.log(chalk.bold('  Codex CLI Usage:'));
+    console.log('    AGENTS.md is auto-loaded by Codex CLI');
+    console.log('    Just run: codex "create a button component"');
+    console.log('    Standards are automatically included via AGENTS.md');
+    console.log('');
+    console.log(chalk.dim('  Files created:'));
+    console.log(chalk.dim('    AGENTS.md (bridge - auto-loaded)'));
+  }
+}
+
+module.exports = CodexIntegration;

package/lib/integrations/continue-integration.js

@@ -0,0 +1,99 @@
+const chalk = require('chalk');
+const fs = require('fs-extra');
+const BaseIntegration = require('./base-integration');
+
+class ContinueIntegration extends BaseIntegration {
+  constructor() {
+    super();
+    this.name = 'continue';
+    this.displayName = 'Continue';
+    this.generatedFiles = [
+      '.continue/rules/contextkit-standards.md',
+      '.continue/config.yaml',
+    ];
+    this.bridgeFiles = [];
+    this.platformDir = '.continue/rules';
+  }
+
+  async install() {
+    await super.install();
+    // Remove old vibe-kit-named files
+    const legacyFile = '.continue/rules/vibe-kit-standards.md';
+    if (await fs.pathExists(legacyFile)) {
+      await fs.remove(legacyFile);
+    }
+  }
+
+  async generateFiles() {
+    // Rule file with frontmatter
+    const standardsRule = `---
+description: ContextKit project standards
+alwaysApply: true
+---
+
+# ContextKit Standards
+
+This project uses ContextKit for structured development standards.
+
+## References
+
+- \`.contextkit/standards/code-style.md\` — Coding conventions
+- \`.contextkit/standards/testing.md\` — Testing patterns (numbered test cases required)
+- \`.contextkit/standards/architecture.md\` — Architecture patterns
+- \`.contextkit/standards/ai-guidelines.md\` — AI behavior rules
+- \`.contextkit/standards/glossary.md\` — Project terminology
+
+## Commands
+
+- \`.contextkit/commands/analyze.md\` — Analyze and customize standards
+- \`.contextkit/commands/create-component.md\` — Create components
+- \`.contextkit/commands/create-feature.md\` — Create features
+- \`.contextkit/commands/run-tests.md\` — Run tests
+- \`.contextkit/commands/quality-check.md\` — Quality checks
+`;
+    await this.writeGeneratedFile('.continue/rules/contextkit-standards.md', standardsRule);
+
+    // config.yaml (new YAML format)
+    const configYaml = `# Continue Configuration (ContextKit)
+# See: https://docs.continue.dev/reference
+
+name: ContextKit Standards
+
+rules:
+  - rules/contextkit-standards.md
+
+context:
+  - provider: file
+    params:
+      files:
+        - .contextkit/standards/code-style.md
+        - .contextkit/standards/testing.md
+        - .contextkit/standards/architecture.md
+        - .contextkit/standards/ai-guidelines.md
+        - .contextkit/standards/glossary.md
+        - .contextkit/product/mission-lite.md
+`;
+
+    // Only write config.yaml if neither config.yaml nor config.json exists
+    if (!await fs.pathExists('.continue/config.yaml') && !await fs.pathExists('.continue/config.json')) {
+      await this.writeGeneratedFile('.continue/config.yaml', configYaml);
+    } else if (await fs.pathExists('.continue/config.yaml')) {
+      // Update existing yaml
+      await this.writeGeneratedFile('.continue/config.yaml', configYaml);
+    }
+    // If config.json exists, leave it alone (user may have custom config)
+  }
+
+  showUsage() {
+    console.log('');
+    console.log(chalk.bold('  Continue Usage:'));
+    console.log('    Rules auto-load from .continue/rules/');
+    console.log('    Continue will include ContextKit context automatically');
+    console.log('');
+    console.log(chalk.dim('  Files created:'));
+    console.log(chalk.dim('    .continue/rules/contextkit-standards.md (always apply)'));
+    console.log(chalk.dim('    .continue/config.yaml (configuration)'));
+  }
+}
+
+module.exports = ContinueIntegration;

package/lib/integrations/copilot-integration.js

@@ -0,0 +1,73 @@
+const chalk = require('chalk');
+const fs = require('fs-extra');
+const BaseIntegration = require('./base-integration');
+
+class CopilotIntegration extends BaseIntegration {
+  constructor() {
+    super();
+    this.name = 'copilot';
+    this.displayName = 'GitHub Copilot';
+    this.bridgeFiles = ['.github/copilot-instructions.md'];
+    this.generatedFiles = [];
+    this.platformDir = '.github';
+  }
+
+  async generateFiles() {
+    // Bridge file: .github/copilot-instructions.md (auto-loaded by Copilot Chat)
+    const bridgeContent = `# Copilot Instructions (ContextKit)
+
+This project uses [ContextKit](https://github.com/nolrm/contextkit) for AI development standards.
+
+${this.getStandardsBlock()}
+
+## Key Rules
+
+- 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`;
+
+    await this.writeBridgeFile('.github/copilot-instructions.md', bridgeContent);
+
+    // Merge VS Code settings for copilot
+    await this.mergeVSCodeSettings();
+  }
+
+  async mergeVSCodeSettings() {
+    const settingsPath = '.vscode/settings.json';
+    let settings = {};
+
+    await fs.ensureDir('.vscode');
+
+    if (await fs.pathExists(settingsPath)) {
+      try {
+        settings = await fs.readJson(settingsPath);
+      } catch {
+        settings = {};
+      }
+    }
+
+    // Add copilot instruction reference
+    settings['github.copilot.chat.codeGeneration.instructions'] = [
+      { file: '.github/copilot-instructions.md' }
+    ];
+    settings['vibeKit.standardsPath'] = '.contextkit/standards';
+    settings['vibeKit.templatesPath'] = '.contextkit/templates';
+
+    await fs.writeJson(settingsPath, settings, { spaces: 2 });
+  }
+
+  showUsage() {
+    console.log('');
+    console.log(chalk.bold('  GitHub Copilot Usage:'));
+    console.log('    .github/copilot-instructions.md is auto-loaded by Copilot Chat');
+    console.log('    In Copilot Chat: @.contextkit Create a button component');
+    console.log('    Or: @.contextkit/standards Create a login form');
+    console.log('');
+    console.log(chalk.dim('  Files created:'));
+    console.log(chalk.dim('    .github/copilot-instructions.md (auto-loaded)'));
+    console.log(chalk.dim('    .vscode/settings.json (updated with copilot config)'));
+  }
+}
+
+module.exports = CopilotIntegration;

package/lib/integrations/cursor-integration.js

@@ -0,0 +1,162 @@
+const chalk = require('chalk');
+const fs = require('fs-extra');
+const BaseIntegration = require('./base-integration');
+
+class CursorIntegration extends BaseIntegration {
+  constructor() {
+    super();
+    this.name = 'cursor';
+    this.displayName = 'Cursor';
+    this.generatedFiles = [
+      '.cursor/rules/contextkit-standards.mdc',
+      '.cursor/rules/contextkit-testing.mdc',
+      '.cursor/rules/contextkit-components.mdc',
+      '.cursor/rules/contextkit-api.mdc',
+    ];
+    this.bridgeFiles = [];
+    this.platformDir = '.cursor/rules';
+  }
+
+  async install() {
+    await super.install();
+    // Remove old monolithic rule file if present
+    await this.removeLegacyFiles();
+  }
+
+  async removeLegacyFiles() {
+    const legacyFiles = [
+      '.cursor/rules/contextkit.mdc',
+      '.cursor/rules/vibe-kit.mdc',
+      '.cursor/rules/vibe-kit-standards.mdc',
+      '.cursor/rules/vibe-kit-testing.mdc',
+      '.cursor/rules/vibe-kit-components.mdc',
+      '.cursor/rules/vibe-kit-api.mdc',
+    ];
+    for (const file of legacyFiles) {
+      if (await fs.pathExists(file)) {
+        await fs.remove(file);
+        console.log(chalk.yellow(`  Removed legacy ${file}`));
+      }
+    }
+  }
+
+  async generateFiles() {
+    // Standards rule (always apply)
+    const standardsRule = `---
+description: ContextKit project standards
+globs: "**/*.{ts,tsx,js,jsx,py,rs,go}"
+alwaysApply: true
+---
+
+# ContextKit Standards
+
+This project uses ContextKit for structured development standards.
+
+## References
+
+- @.contextkit/standards/code-style.md — Coding conventions
+- @.contextkit/standards/architecture.md — Architecture patterns
+- @.contextkit/standards/ai-guidelines.md — AI behavior rules
+- @.contextkit/standards/glossary.md — Project terminology
+- @.contextkit/product/mission-lite.md — Product context
+
+## Workflow
+
+1. Check standards before generating code
+2. Follow project patterns and conventions
+3. Include proper testing (numbered test cases)
+4. Ensure type safety
+5. Run quality checks
+`;
+    await this.writeGeneratedFile('.cursor/rules/contextkit-standards.mdc', standardsRule);
+
+    // Testing rule (scoped to test files)
+    const testingRule = `---
+description: ContextKit testing standards
+globs: "**/*.test.*, **/*.spec.*, **/__tests__/**"
+alwaysApply: false
+---
+
+# Testing Standards
+
+Reference: @.contextkit/standards/testing.md
+
+## Required Pattern: Numbered Test Cases
+
+All test cases MUST use numbered descriptions:
+
+\`\`\`typescript
+describe("ComponentName", () => {
+  it("1. renders basic component", () => { /* ... */ });
+  it("2. handles user interactions", () => { /* ... */ });
+  it("3. displays correct content", () => { /* ... */ });
+});
+\`\`\`
+
+## Templates
+
+- @.contextkit/templates/test.tsx — Test template
+`;
+    await this.writeGeneratedFile('.cursor/rules/contextkit-testing.mdc', testingRule);
+
+    // Components rule
+    const componentsRule = `---
+description: ContextKit component standards
+globs: "**/components/**"
+alwaysApply: false
+---
+
+# Component Standards
+
+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
+
+## Commands
+
+- @.contextkit/commands/create-component.md — Create component workflow
+`;
+    await this.writeGeneratedFile('.cursor/rules/contextkit-components.mdc', componentsRule);
+
+    // API rule
+    const apiRule = `---
+description: ContextKit API and services standards
+globs: "**/api/**, **/services/**"
+alwaysApply: false
+---
+
+# API & Services Standards
+
+Reference: @.contextkit/standards/architecture.md
+
+## Templates
+
+- @.contextkit/templates/api.ts — API service template
+
+## Commands
+
+- @.contextkit/commands/create-feature.md — Create feature workflow
+`;
+    await this.writeGeneratedFile('.cursor/rules/contextkit-api.mdc', apiRule);
+  }
+
+  showUsage() {
+    console.log('');
+    console.log(chalk.bold('  Cursor Usage:'));
+    console.log('    Rules auto-load based on file context');
+    console.log('    In Cursor Chat: @.contextkit/commands/analyze.md');
+    console.log('    Or: @.contextkit Create a button component');
+    console.log('');
+    console.log(chalk.dim('  Files created:'));
+    console.log(chalk.dim('    .cursor/rules/contextkit-standards.mdc (always apply)'));
+    console.log(chalk.dim('    .cursor/rules/contextkit-testing.mdc (test files)'));
+    console.log(chalk.dim('    .cursor/rules/contextkit-components.mdc (components)'));
+    console.log(chalk.dim('    .cursor/rules/contextkit-api.mdc (API/services)'));
+  }
+}
+
+module.exports = CursorIntegration;

package/lib/integrations/gemini-integration.js

@@ -0,0 +1,62 @@
+const chalk = require('chalk');
+const fs = require('fs-extra');
+const BaseIntegration = require('./base-integration');
+
+class GeminiIntegration extends BaseIntegration {
+  constructor() {
+    super();
+    this.name = 'gemini';
+    this.displayName = 'Google Gemini CLI';
+    this.bridgeFiles = ['GEMINI.md'];
+    this.generatedFiles = ['.gemini/settings.json'];
+    this.platformDir = '.gemini';
+  }
+
+  async generateFiles() {
+    // Bridge file: GEMINI.md (auto-loaded by Gemini CLI)
+    const bridgeContent = `# Project Standards (ContextKit)
+
+This project uses [ContextKit](https://github.com/nolrm/contextkit) for AI development standards.
+
+${this.getStandardsBlock()}
+
+## Corrections Log
+
+- \`.contextkit/corrections.md\` — Track AI performance improvements
+
+## Quick Reference
+
+Before writing code, check the relevant standards files above. Always follow the project's established patterns and conventions.`;
+
+    await this.writeBridgeFile('GEMINI.md', bridgeContent);
+
+    // Gemini settings
+    const settings = {
+      "description": "ContextKit - Context Engineering",
+      "contextFiles": [
+        ".contextkit/standards/code-style.md",
+        ".contextkit/standards/testing.md",
+        ".contextkit/standards/architecture.md",
+        ".contextkit/standards/ai-guidelines.md",
+        ".contextkit/standards/glossary.md",
+        ".contextkit/product/mission-lite.md"
+      ]
+    };
+
+    await this.writeGeneratedFile('.gemini/settings.json', JSON.stringify(settings, null, 2) + '\n');
+  }
+
+  showUsage() {
+    console.log('');
+    console.log(chalk.bold('  Gemini CLI Usage:'));
+    console.log('    GEMINI.md is auto-loaded by Gemini CLI');
+    console.log('    Just run: gemini "create a button component"');
+    console.log('    Standards are automatically included via GEMINI.md');
+    console.log('');
+    console.log(chalk.dim('  Files created:'));
+    console.log(chalk.dim('    GEMINI.md (bridge - auto-loaded)'));
+    console.log(chalk.dim('    .gemini/settings.json (configuration)'));
+  }
+}
+
+module.exports = GeminiIntegration;

package/lib/integrations/index.js

@@ -0,0 +1,33 @@
+const ClaudeIntegration = require('./claude-integration');
+const CursorIntegration = require('./cursor-integration');
+const CopilotIntegration = require('./copilot-integration');
+const CodexIntegration = require('./codex-integration');
+const GeminiIntegration = require('./gemini-integration');
+const AiderIntegration = require('./aider-integration');
+const ContinueIntegration = require('./continue-integration');
+const WindsurfIntegration = require('./windsurf-integration');
+
+const INTEGRATIONS = {
+  claude: ClaudeIntegration,
+  cursor: CursorIntegration,
+  copilot: CopilotIntegration,
+  vscode: CopilotIntegration, // backward compat alias
+  codex: CodexIntegration,
+  gemini: GeminiIntegration,
+  aider: AiderIntegration,
+  continue: ContinueIntegration,
+  windsurf: WindsurfIntegration,
+};
+
+function getIntegration(name) {
+  const IntegrationClass = INTEGRATIONS[name];
+  if (!IntegrationClass) return null;
+  return new IntegrationClass();
+}
+
+function getAllIntegrationNames() {
+  // Return unique names (exclude aliases like vscode)
+  return ['claude', 'cursor', 'copilot', 'codex', 'gemini', 'aider', 'continue', 'windsurf'];
+}
+
+module.exports = { getIntegration, getAllIntegrationNames, INTEGRATIONS };