@nolrm/contextkit 0.7.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Vibe Kit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,216 @@
+# ContextKit
+
+> Context Engineering for AI Development
+
+Give your AI assistants (Cursor, Claude, Copilot, Codex, Gemini, Aider, Continue, Windsurf) structured context through markdown files. ContextKit creates a knowledge base that ensures AI generates code matching your exact patterns, style, and architecture—no more hallucinated code or mismatched conventions.
+
+ContextKit is a CLI tool that provides **context-engineering** capabilities by creating `.contextkit/` directories with project standards, guidelines, and patterns that AI assistants read automatically.
+
+**[Read the full documentation](https://contextkit-docs.vercel.app/)**
+
+## Why ContextKit?
+
+**The problem:** LLMs are great at syntax, not at *your* conventions. Generic AI output requires manual fixes for style, structure, and architecture.
+
+**The solution:** ContextKit provides your AI with:
+- **Glossary** of project terminology and business terms (e.g., `checkout`, `customer`, `order`)
+- **Standards** for code style, testing patterns, and architecture
+- **Templates** with canonical component shapes
+
+Update `.md` files as your project evolves; the AI follows.
+
+## Multi-Platform Support
+
+Works with: **Cursor** • **Claude Code** • **GitHub Copilot** • **Codex CLI** • **Gemini CLI** • **Aider** • **Continue** • **Windsurf**
+
+Each platform gets auto-loaded bridge files (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.windsurfrules`, etc.) so your AI tools read project standards automatically.
+
+---
+
+## Quick Start (60s)
+
+**Requirements:** Node.js 14.x+ (16.x+ recommended) and npm/yarn. Optional: Git for hooks, AI tools for usage.
+
+```bash
+# Step 1: Install globally (recommended)
+npm i -g @nolrm/contextkit
+
+# Step 2: Navigate to your project and install
+cd your-project
+contextkit install
+```
+
+This creates `.contextkit/` with skeleton context files (blank templates to be filled by AI):
+
+```
+.contextkit/
+  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
+```
+
+**Generate content with AI** (recommended):
+
+```bash
+ck analyze
+# AI scans your codebase and generates content for the skeleton files
+# or in Cursor chat:  @.contextkit/commands/analyze.md
+```
+
+⚠️ **Important:** After running `ck analyze`, manually review and edit the generated content to match your exact needs. The AI provides a starting point, but you must customize it.
+
+---
+
+## Multi-Team Workflow
+
+Perfect for teams where members use different AI tools:
+
+```bash
+# First team member (any tool) - sets up the project
+contextkit install
+
+# Each team member adds their platform
+ck claude      # creates CLAUDE.md + .claude/rules/
+ck cursor      # creates .cursor/rules/ (scoped .mdc files)
+ck copilot     # creates .github/copilot-instructions.md
+ck codex       # creates AGENTS.md
+ck gemini      # creates GEMINI.md + .gemini/settings.json
+ck aider       # creates CONVENTIONS.md + .aider/rules.md
+ck continue    # creates .continue/rules/ + config.yaml
+ck windsurf    # creates .windsurfrules + .windsurf/rules/
+ck vscode      # alias for copilot
+```
+
+Each platform generates bridge files that the AI tool auto-reads. If a bridge file already exists (e.g., you have a custom `CLAUDE.md`), ContextKit appends its section below your content instead of overwriting. Share your `.contextkit/standards/*.md` files with the team and everyone gets the same context.
+
+---
+
+## See the difference (before → after)
+
+**Prompt**
+```
+"Add checkout flow for customer"
+```
+
+**What the AI does with ContextKit**
+- Reads `glossary.md` → `checkout` = checkout process; `customer` = customer account
+- Applies `code-style.md` → strict TS, functional components
+- Follows `testing.md` → numbered test cases
+
+**Result (diff)**
+```diff
+- const Checkout = () => <button>Buy</button>
++ export function CheckoutFlow({ customer }: { customer: string }) {
++   // Uses customer from glossary context
++   return <div>Checkout for {customer}</div>
++ }
+```
+
+---
+
+## Use it in your tool
+
+**Cursor** — rules auto-load from `.cursor/rules/`
+```
+@.contextkit/commands/analyze.md
+```
+
+**Claude Code** — reads `CLAUDE.md` + `.claude/rules/` automatically
+```bash
+claude "create checkout flow for customer"
+```
+
+**GitHub Copilot** — reads `.github/copilot-instructions.md` automatically
+```
+@.contextkit Create checkout flow for customer
+```
+
+**Codex CLI** — reads `AGENTS.md` automatically
+```bash
+codex "create checkout flow for customer"
+```
+
+**CLI** (Chat with AI)
+```bash
+ck ai "create checkout flow for customer"
+```
+
+---
+
+## Key Features
+
+- 🧠 **Context Engineering** - Structured MD files your AI reads automatically
+- 🔍 **Smart Analysis** - AI generates standards content based on your codebase
+- 🌍 **Project Agnostic** - Works with React, Vue, Node.js, PHP, Python, Rust, monorepos—any project type
+- 🤖 **Multi-Platform** - Works with Cursor, Claude Code, Copilot, Codex, Gemini, Aider, Continue, Windsurf
+- 🛡️ **Safe Install** - Backs up existing files with rollback support
+- ⚡ **Zero Config** - Auto-detects package managers and AI tools
+- ✅ **Policy Enforcement** - Configurable validation with `ck check`
+- 📝 **Corrections Tracking** - Track AI performance issues with corrections log
+- 🔄 **Workflow Orchestration** - Structured workflows with `ck run`
+- 📦 **Registry System** - Share standards across teams with `ck publish/pull`
+- 📊 **Observability Dashboard** - Visual metrics and compliance tracking
+
+## Commands
+
+```bash
+# Installation & Setup
+ck install     # set up .contextkit in this repo
+ck claude      # add Claude Code integration (CLAUDE.md + rules)
+ck cursor      # add Cursor integration (scoped .mdc rules)
+ck copilot     # add GitHub Copilot integration
+ck codex       # add Codex CLI integration (AGENTS.md)
+ck gemini      # add Gemini CLI integration (GEMINI.md)
+ck aider       # add Aider integration (CONVENTIONS.md)
+ck continue    # add Continue integration
+ck windsurf    # add Windsurf integration (.windsurfrules)
+ck vscode      # alias for copilot
+
+# Analysis & Updates
+ck analyze     # customize standards to your project
+ck update      # pull latest updates
+ck status      # check install & integrations
+
+# Validation & Compliance
+ck check       # validate installation & policy compliance
+ck check --strict  # treat warnings as errors
+
+# Corrections Logging
+ck note "message"  # add note to corrections log
+ck note "AI issue" --category "AI Behavior" --priority HIGH
+
+# Workflow Orchestration
+ck run <workflow>  # run structured workflow
+ck run create-component  # example workflow
+ck run create-component --interactive  # interactive mode
+
+# Registry & Versioning
+ck publish --name @company/react-standards --version 1.0.0
+ck pull @company/react-standards@1.0.0
+ck pull @company/react-standards@latest --backup
+
+# Observability
+ck dashboard   # start web dashboard
+ck dashboard --no-server  # CLI metrics only
+
+# AI Usage (loads .contextkit context automatically)
+ck "create a button"  # quick AI chat with context
+ck ai "create a button"  # explicit AI command
+```
+
+## Links
+
+• 🐛 [Issues](https://github.com/nolrm/contextkit/issues)
+• 💬 [Discussions](https://github.com/nolrm/contextkit/discussions)
+
+---
+
+## License
+
+MIT
+
+## Author
+
+**Marlon Maniti**  
+GitHub: [@nolrm](https://github.com/nolrm)

package/bin/contextkit.js

@@ -0,0 +1,324 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const { install, update, status } = require('../lib');
+const analyze = require('../lib/commands/analyze');
+const ai = require('../lib/commands/ai');
+const check = require('../lib/commands/check');
+const note = require('../lib/commands/note');
+const run = require('../lib/commands/run');
+const publish = require('../lib/commands/publish');
+const pull = require('../lib/commands/pull');
+const dashboard = require('../lib/commands/dashboard');
+const packageJson = require('../package.json');
+
+// Set up the CLI
+program
+  .name('contextkit')
+  .description('ContextKit - Context Engineering for AI Development')
+  .version(packageJson.version, '-v, --version', 'Show version number');
+
+// Install command
+program
+  .command('install')
+  .description('Install ContextKit in current project')
+  .option('--no-hooks', 'Skip Git hooks installation')
+  .option('--non-interactive', 'Skip interactive prompts')
+  .action(async (options) => {
+    try {
+      await install(options);
+    } catch (error) {
+      console.error(chalk.red('Installation failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Status command
+program
+  .command('status')
+  .description('Check installation status')
+  .action(async () => {
+    try {
+      await status();
+    } catch (error) {
+      console.error(chalk.red('Status check failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Update command
+program
+  .command('update')
+  .description('Update to latest version')
+  .option('--force', 'Force update even if no changes')
+  .action(async (options) => {
+    try {
+      await update(options);
+    } catch (error) {
+      console.error(chalk.red('Update failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Analyze command
+program
+  .command('analyze')
+  .description('Analyze project and customize ContextKit standards')
+  .option('--ai <tool>', 'AI tool to use (aider, claude, gemini)')
+  .option('--scope <scope>', 'Analysis scope: frontend, backend, both, or current (for monorepos)')
+  .option('--package <package>', 'Analyze specific package path (e.g., apps/admin)')
+  .option('--non-interactive', 'Skip interactive prompts (use defaults)')
+  .action(async (options) => {
+    try {
+      await analyze(options);
+    } catch (error) {
+      console.error(chalk.red('Analysis failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// AI command with "ai" keyword
+program
+  .command('ai <prompt>')
+  .description('Chat with AI using ContextKit context')
+  .option('--ai <tool>', 'AI tool to use (aider, claude, gemini)')
+  .action(async (prompt, options) => {
+    try {
+      await ai(prompt, options);
+    } catch (error) {
+      console.error(chalk.red('AI chat failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Check command
+program
+  .command('check')
+  .description('Validate ContextKit installation and check policy compliance')
+  .option('--strict', 'Treat warnings as errors')
+  .option('--verbose', 'Show detailed information')
+  .action(async (options) => {
+    try {
+      await check(options);
+    } catch (error) {
+      console.error(chalk.red('Check failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Note command
+program
+  .command('note <message>')
+  .description('Add a note to the corrections log')
+  .option('--category <category>', 'Category (Rule Updates, AI Behavior, Preferences)')
+  .option('--priority <priority>', 'Priority (HIGH, MEDIUM, LOW)', 'MEDIUM')
+  .option('--task <task>', 'Task/feature name')
+  .option('--changes <changes>', 'Changes description')
+  .action(async (message, options) => {
+    try {
+      await note(message, options);
+    } catch (error) {
+      console.error(chalk.red('Note failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Run command
+program
+  .command('run <workflow>')
+  .description('Run a workflow defined in instructions')
+  .option('--interactive', 'Interactive mode (pause between steps)')
+  .action(async (workflow, options) => {
+    try {
+      await run(workflow, options);
+    } catch (error) {
+      console.error(chalk.red('Workflow failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Publish command
+program
+  .command('publish')
+  .description('Publish current ContextKit configuration to registry')
+  .option('--name <name>', 'Package name (e.g., @company/react-standards)')
+  .option('--version <version>', 'Version (e.g., 1.0.0)')
+  .action(async (options) => {
+    try {
+      await publish(options);
+    } catch (error) {
+      console.error(chalk.red('Publish failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Pull command
+program
+  .command('pull <package>')
+  .description('Pull ContextKit configuration from registry')
+  .option('--force', 'Force overwrite existing .contextkit')
+  .option('--backup', 'Backup existing .contextkit before pulling')
+  .action(async (packageSpec, options) => {
+    try {
+      await pull(packageSpec, options);
+    } catch (error) {
+      console.error(chalk.red('Pull failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Dashboard command
+program
+  .command('dashboard')
+  .description('Start observability dashboard')
+  .option('--port <port>', 'Port number', '3001')
+  .option('--no-server', 'Display metrics only (no web server)')
+  .action(async (options) => {
+    try {
+      await dashboard(options);
+    } catch (error) {
+      console.error(chalk.red('Dashboard failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Platform-specific install commands
+program
+  .command('cursor')
+  .description('Install Cursor integration only')
+  .option('--non-interactive', 'Skip interactive prompts')
+  .action(async (options) => {
+    try {
+      await install({ platform: 'cursor', ...options });
+    } catch (error) {
+      console.error(chalk.red('Installation failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('continue')
+  .description('Install Continue integration only')
+  .option('--non-interactive', 'Skip interactive prompts')
+  .action(async (options) => {
+    try {
+      await install({ platform: 'continue', ...options });
+    } catch (error) {
+      console.error(chalk.red('Installation failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('aider')
+  .description('Install Aider integration only')
+  .option('--non-interactive', 'Skip interactive prompts')
+  .action(async (options) => {
+    try {
+      await install({ platform: 'aider', ...options });
+    } catch (error) {
+      console.error(chalk.red('Installation failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('vscode')
+  .description('Install VS Code integration only')
+  .option('--non-interactive', 'Skip interactive prompts')
+  .action(async (options) => {
+    try {
+      await install({ platform: 'vscode', ...options });
+    } catch (error) {
+      console.error(chalk.red('Installation failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('claude')
+  .description('Install Claude CLI integration only')
+  .option('--non-interactive', 'Skip interactive prompts')
+  .action(async (options) => {
+    try {
+      await install({ platform: 'claude', ...options });
+    } catch (error) {
+      console.error(chalk.red('Installation failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('gemini')
+  .description('Install Gemini CLI integration only')
+  .option('--non-interactive', 'Skip interactive prompts')
+  .action(async (options) => {
+    try {
+      await install({ platform: 'gemini', ...options });
+    } catch (error) {
+      console.error(chalk.red('Installation failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('codex')
+  .description('Install Codex CLI integration only')
+  .option('--non-interactive', 'Skip interactive prompts')
+  .action(async (options) => {
+    try {
+      await install({ platform: 'codex', ...options });
+    } catch (error) {
+      console.error(chalk.red('Installation failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('copilot')
+  .description('Install GitHub Copilot integration only')
+  .option('--non-interactive', 'Skip interactive prompts')
+  .action(async (options) => {
+    try {
+      await install({ platform: 'copilot', ...options });
+    } catch (error) {
+      console.error(chalk.red('Installation failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('windsurf')
+  .description('Install Windsurf integration only')
+  .option('--non-interactive', 'Skip interactive prompts')
+  .action(async (options) => {
+    try {
+      await install({ platform: 'windsurf', ...options });
+    } catch (error) {
+      console.error(chalk.red('Installation failed:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Catch-all for unknown commands (treats them as prompts)
+// This MUST be registered AFTER all commands but BEFORE parse()
+program.on('command:*', function(args) {
+  // The command wasn't found, treat it as a prompt
+  const prompt = args.join(' ');
+
+  if (prompt) {
+    try {
+      ai(prompt, {}).catch(error => {
+        console.error(chalk.red('AI chat failed:'), error.message);
+        process.exit(1);
+      });
+    } catch (error) {
+      console.error(chalk.red('AI chat failed:'), error.message);
+      process.exit(1);
+    }
+  }
+});
+
+// Parse command line arguments
+program.parse();

package/bin/vibe-kit.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+console.warn('\x1b[33m"vibe-kit" is deprecated. Use "contextkit" or "ck" instead.\x1b[0m');
+require('./contextkit.js');

package/install-fallback.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+# install-fallback.sh - Fallback installation for users without Node.js
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+PURPLE='\033[0;35m'
+NC='\033[0m' # No Color
+
+echo -e "${PURPLE}🎵 ContextKit Installation${NC}"
+echo ""
+
+# Check if Node.js is available
+if command -v node >/dev/null 2>&1; then
+    echo -e "${GREEN}✅ Node.js detected. Installing via npm...${NC}"
+    echo ""
+    
+    # Install via npm
+    npm install -g @nolrm/contextkit
+    
+    echo ""
+    echo -e "${GREEN}🎉 ContextKit installed successfully!${NC}"
+    echo ""
+    echo -e "${BLUE}📖 Usage:${NC}"
+    echo "  contextkit install    # Install in current project"
+    echo "  contextkit status     # Check installation status"
+    echo "  contextkit update     # Update to latest version"
+    echo ""
+    echo -e "${YELLOW}💡 Try: 'contextkit install' in your project directory${NC}"
+    
+else
+    echo -e "${YELLOW}⚠️  Node.js not found. Installing via shell script...${NC}"
+    echo ""
+    
+    # Fallback to direct installation
+    echo -e "${BLUE}📥 Downloading installation script...${NC}"
+    
+    # Download and run the legacy install.sh
+    curl -sSL https://raw.githubusercontent.com/nolrm/contextkit/main/legacy/install.sh | bash
+    
+    echo ""
+    echo -e "${GREEN}🎉 ContextKit installed successfully!${NC}"
+    echo ""
+    echo -e "${BLUE}📖 Usage:${NC}"
+    echo "  Use AI commands with @.contextkit/ references"
+    echo "  Read .contextkit/standards/README.md for guidelines"
+    echo ""
+    echo -e "${YELLOW}💡 Try: 'Create a Button component following contextkit standards'${NC}"
+    echo ""
+    echo -e "${BLUE}💡 For CLI commands, install Node.js and run:${NC}"
+    echo "  npm install -g @nolrm/contextkit"
+fi
+
+echo ""
+echo -e "${PURPLE}🎵 Get the right vibe for your code!${NC}"