k0ntext 3.0.0

package/dist/mcp.js

@@ -0,0 +1,257 @@
+/**
+ * MCP Server
+ *
+ * Model Context Protocol server for AI context.
+ * Provides tools, resources, and prompts for AI coding assistants.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { DatabaseClient } from './db/client.js';
+import { createOpenRouterClient, hasOpenRouterKey } from './embeddings/openrouter.js';
+import { createIntelligentAnalyzer } from './analyzer/intelligent-analyzer.js';
+/**
+ * Create and start the MCP server
+ */
+export async function createServer(config) {
+    const { projectRoot, dbPath = '.ai-context.db', name = 'k0ntext', version = '1.0.0' } = config;
+    // Initialize database
+    const db = new DatabaseClient(projectRoot, dbPath);
+    // Initialize OpenRouter client (optional)
+    let openrouter = null;
+    if (hasOpenRouterKey()) {
+        try {
+            openrouter = createOpenRouterClient();
+        }
+        catch (error) {
+            console.error('Warning: OpenRouter unavailable:', error);
+        }
+    }
+    // Create context for handlers
+    const ctx = { db, openrouter, projectRoot };
+    // Create MCP server
+    const server = new McpServer({ name, version }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+            prompts: {}
+        }
+    });
+    // ==================== Register Tools ====================
+    // search_context - Semantic search across indexed content
+    server.registerTool('search_context', {
+        description: 'Semantic search across all indexed content (workflows, agents, code, commits, docs)',
+        inputSchema: {
+            query: z.string().describe('Natural language search query'),
+            type: z.enum(['workflow', 'agent', 'command', 'code', 'commit', 'knowledge', 'config', 'doc', 'tool_config']).optional().describe('Filter by content type'),
+            limit: z.number().optional().describe('Maximum results (default: 10)')
+        }
+    }, async (args) => {
+        const { query, type, limit = 10 } = args;
+        // Text search (semantic search requires embeddings)
+        const results = ctx.db.searchText(query, type);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(results.slice(0, limit), null, 2)
+                }]
+        };
+    });
+    // get_item - Get a specific context item
+    server.registerTool('get_item', {
+        description: 'Get a specific context item by ID or path',
+        inputSchema: {
+            id: z.string().optional().describe('Context item ID'),
+            path: z.string().optional().describe('File path to look up')
+        }
+    }, async (args) => {
+        const { id, path: filePath } = args;
+        let item = null;
+        if (id) {
+            item = ctx.db.getItem(id);
+        }
+        else if (filePath) {
+            const items = ctx.db.getAllItems().filter(i => i.filePath === filePath);
+            item = items[0] || null;
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: item ? JSON.stringify(item, null, 2) : 'Item not found'
+                }]
+        };
+    });
+    // add_knowledge - Store new knowledge
+    server.registerTool('add_knowledge', {
+        description: 'Store a new insight or fact about the codebase',
+        inputSchema: {
+            name: z.string().describe('Short name for the knowledge item'),
+            content: z.string().describe('The knowledge content'),
+            relatedTo: z.array(z.string()).optional().describe('IDs of related items')
+        }
+    }, async (args) => {
+        const { name, content, relatedTo } = args;
+        const item = ctx.db.upsertItem({
+            type: 'knowledge',
+            name,
+            content,
+            metadata: { relatedTo }
+        });
+        // Add relations if specified
+        if (relatedTo) {
+            for (const targetId of relatedTo) {
+                ctx.db.addRelation({
+                    sourceId: item.id,
+                    targetId,
+                    relationType: 'references'
+                });
+            }
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Knowledge item created: ${item.id}`
+                }]
+        };
+    });
+    // analyze - Run intelligent analysis
+    server.registerTool('analyze', {
+        description: 'Run intelligent analysis on the codebase using OpenRouter',
+        inputSchema: {
+            type: z.enum(['full', 'docs', 'code', 'tools']).optional().describe('Analysis type')
+        }
+    }, async (_args) => {
+        const analyzer = createIntelligentAnalyzer(ctx.projectRoot);
+        const analysis = await analyzer.analyze();
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(analysis, null, 2)
+                }]
+        };
+    });
+    // get_tool_configs - Get AI tool configurations
+    server.registerTool('get_tool_configs', {
+        description: 'Get configurations for AI tools (Claude, Copilot, Cline, etc.)',
+        inputSchema: {
+            tool: z.enum(['claude', 'copilot', 'cline', 'antigravity', 'windsurf', 'aider', 'continue', 'cursor', 'gemini']).optional().describe('Specific tool to get configs for')
+        }
+    }, async (args) => {
+        const { tool } = args;
+        const configs = tool
+            ? ctx.db.getToolConfigs(tool)
+            : ctx.db.getAllToolConfigs();
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(configs, null, 2)
+                }]
+        };
+    });
+    // query_graph - Traverse knowledge graph
+    server.registerTool('query_graph', {
+        description: 'Traverse the knowledge graph from a starting point',
+        inputSchema: {
+            startId: z.string().describe('Starting context item ID'),
+            direction: z.enum(['outgoing', 'incoming', 'both']).optional().describe('Traversal direction'),
+            maxDepth: z.number().optional().describe('Maximum depth (default: 3)')
+        }
+    }, async (args) => {
+        const { startId, maxDepth = 3 } = args;
+        const results = ctx.db.traverseGraph(startId, maxDepth);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(Array.from(results.entries()), null, 2)
+                }]
+        };
+    });
+    // get_stats - Database statistics
+    server.registerTool('get_stats', {
+        description: 'Get database and indexing statistics',
+        inputSchema: {}
+    }, async () => {
+        const stats = ctx.db.getStats();
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(stats, null, 2)
+                }]
+        };
+    });
+    // ==================== Register Prompts ====================
+    // context-engineer prompt
+    server.registerPrompt('context-engineer', {
+        description: 'Initialize and configure the AI context system',
+        argsSchema: {
+            projectType: z.string().optional().describe('Type of project')
+        }
+    }, () => {
+        return {
+            messages: [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `You are a Context Engineer specializing in setting up AI context systems.
+
+Your goal is to analyze the current codebase and set up optimal AI context configuration.
+
+Available tools:
+- search_context: Search indexed content
+- get_item: Get specific items
+- add_knowledge: Store new insights
+- analyze: Run intelligent analysis
+- get_tool_configs: View AI tool configurations
+- get_stats: View database statistics
+
+Start by running 'analyze' to understand the codebase, then use 'add_knowledge' to capture important insights.`
+                    }
+                }]
+        };
+    });
+    // core-architect prompt
+    server.registerPrompt('core-architect', {
+        description: 'Design system architecture',
+        argsSchema: {
+            focus: z.string().optional().describe('Area to focus on')
+        }
+    }, (args) => {
+        const { focus } = args;
+        return {
+            messages: [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `You are a Core Architect designing system architecture.
+${focus ? `Focus area: ${focus}` : ''}
+
+Use the context tools to understand the existing architecture and propose improvements.`
+                    }
+                }]
+        };
+    });
+    return server;
+}
+/**
+ * Start the server with stdio transport
+ */
+export async function startServer(config) {
+    const server = await createServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`K0NTEXT MCP Server started`);
+    console.error(`Project root: ${config.projectRoot}`);
+    console.error(`Database: ${config.dbPath || '.ai-context.db'}`);
+}
+/**
+ * Main entry point
+ */
+export async function main() {
+    const projectRoot = process.env.K0NTEXT_PROJECT_ROOT || process.cwd();
+    const dbPath = process.env.K0NTEXT_DB_PATH;
+    await startServer({
+        projectRoot,
+        dbPath
+    });
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}

package/docs/ARCHIVE/MIGRATE_TO_NEW_REPO.md

@@ -0,0 +1,222 @@
+# Migrating to the New AI Context Repository
+
+This guide helps you migrate from the old `claude-context-engineering-template` repository to the new `ai-context` repository.
+
+## For Users
+
+### Update Your Installation
+
+```bash
+# Uninstall old package
+npm uninstall -g create-universal-ai-context
+
+# Install new package
+npm install -g ai-context
+
+# Verify installation
+ai-context --help
+```
+
+### Update Your Projects
+
+If you have the old package installed in a project:
+
+```bash
+# Remove old package
+npm uninstall create-universal-ai-context
+
+# Install new package
+npm install ai-context
+
+# Re-initialize (your context will be preserved)
+ai-context init
+```
+
+### What Changed?
+
+| Old | New |
+|-----|-----|
+| Repository | `claude-context-engineering-template` | `ai-context` |
+| Package | `create-universal-ai-context` | `ai-context` |
+| Command | `create-ai-context` | `ai-context` |
+| Structure | Monorepo (4 packages) | Single package |
+
+### Features
+
+The new `ai-context` package includes all features from the previous packages:
+
+- ✅ Intelligent codebase analysis (OpenRouter-powered)
+- ✅ Semantic search with vector embeddings
+- ✅ MCP server (10 tools + 6 prompts)
+- ✅ Cross-tool synchronization (9 AI tools)
+- ✅ Complete CLI (7 commands)
+
+## For Contributors
+
+### Update Your Local Repository
+
+If you have a fork or clone of the old repository:
+
+```bash
+# 1. Note your current branch
+git branch --show-current
+
+# 2. Add new remote
+git remote add new-origin https://github.com/SireJeff/ai-context
+
+# 3. Fetch from new repository
+git fetch new-origin
+
+# 4. Switch to tracking new repository
+git branch --set-upstream-to=new-origin/main main
+
+# 5. Remove old remote
+git remote remove origin
+git remote rename new-origin origin
+```
+
+### Update Your Fork
+
+If you have a forked repository:
+
+1. Visit https://github.com/SireJeff/ai-context
+2. Click "Fork" to create a new fork
+3. Update your local remote to point to your new fork
+4. Delete your old fork from GitHub
+
+### Update CI/CD
+
+Update any GitHub Actions or CI/CD pipelines:
+
+```yaml
+# Old
+- uses: actions/checkout@v3
+  with:
+    repository: SireJeff/claude-context-engineering-template
+
+# New
+- uses: actions/checkout@v3
+  with:
+    repository: SireJeff/ai-context
+```
+
+### Update npm Scripts
+
+If you reference the package in npm scripts:
+
+```json
+{
+  "scripts": {
+    "old": "create-ai-context generate",
+    "new": "ai-context generate"
+  }
+}
+```
+
+## For Developers Using the MCP Server
+
+### Update Claude Desktop Config
+
+Edit your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "ai-context": {
+      "command": "npx",
+      "args": ["-y", "ai-context", "mcp"],
+      "cwd": "/path/to/your/project"
+    }
+  }
+}
+```
+
+The MCP server is now built into `ai-context` — no separate package needed.
+
+## Legacy Packages Reference
+
+### create-universal-ai-context → ai-context
+
+All functionality has been preserved:
+
+```bash
+# Old command
+create-ai-context init
+create-ai-context generate
+create-ai-context sync:all
+
+# New command
+ai-context init
+ai-context generate
+ai-context sync
+```
+
+### @ai-context/mcp-server → Built-in
+
+The MCP server is now part of `ai-context`:
+
+```bash
+# Old
+npx @ai-context/mcp-server
+
+# New
+ai-context mcp
+```
+
+### claude-context-plugin → Skills
+
+Plugin functionality is now available as RPI workflow skills in `ai-context`:
+
+- `.claude/skills/` contains skill definitions
+- Use with `/skill-name` commands in Claude Code
+
+## Data Migration
+
+### Database Compatibility
+
+Your existing `.ai-context.db` is **fully compatible** with the new package. No migration needed!
+
+### Context Files
+
+Existing context files (`.ai-context/`, `.clinerules`, etc.) will be updated when you run:
+```bash
+ai-context generate
+```
+
+## Breaking Changes
+
+There are **no breaking changes** to the core functionality. The consolidation was designed to be a drop-in replacement.
+
+### Minor Differences
+
+1. **Command name:** `create-ai-context` → `ai-context`
+2. **Package name:** `create-universal-ai-context` → `ai-context`
+3. **Repository:** Monorepo → Single package
+
+## Rollback
+
+If you need to rollback to the old package:
+
+```bash
+npm uninstall ai-context
+npm install -g create-universal-ai-context@2.5.0
+```
+
+However, we strongly recommend using the new package as the old one is deprecated.
+
+## Support
+
+- **New Repository:** https://github.com/SireJeff/ai-context
+- **Issues:** https://github.com/SireJeff/ai-context/issues
+- **Discussions:** https://github.com/SireJeff/ai-context/discussions
+- **Documentation:** https://github.com/SireJeff/ai-context#readme
+
+## Timeline
+
+- **2026-02-05:** New repository launched
+- **2026-03-01:** Old repository archived
+- **2026-06-01:** Legacy packages deprecated on npm
+
+---
+
+**Questions?** Please open an issue on the new repository: https://github.com/SireJeff/ai-context/issues

package/docs/ARCHIVE/MIGRATE_TO_UNIFIED.md

@@ -0,0 +1,220 @@
+# Migration Guide: Legacy Packages → Unified `ai-context`
+
+**Version:** 3.0.0
+**Date:** February 5, 2026
+
+---
+
+## Overview
+
+The AI Context Engineering project has consolidated three separate packages into one unified `ai-context` package. This guide helps you migrate from the legacy packages.
+
+## What Changed?
+
+| Legacy Package | New Home | Status |
+|---------------|----------|--------|
+| `create-universal-ai-context` | `ai-context` | ⚠️ Deprecated |
+| `@ai-context/mcp-server` | `ai-context` (included) | ⚠️ Deprecated |
+| `claude-context-plugin` | `ai-context` skills | ⚠️ Deprecated |
+
+---
+
+## Migration Paths
+
+### From `create-universal-ai-context`
+
+**Old Commands:**
+```bash
+npx create-universal-ai-context init
+npx create-universal-ai-context generate
+```
+
+**New Commands:**
+```bash
+# Install the unified package
+npm install -g ai-context
+
+# Initialize (same functionality)
+ai-context init
+
+# Generate context (same functionality)
+ai-context generate
+```
+
+### From `@ai-context/mcp-server`
+
+**Old Commands:**
+```bash
+npx create-ai-context mcp:start
+npx create-ai-context mcp:init
+npx create-ai-context mcp:status
+```
+
+**New Commands:**
+```bash
+# The MCP server is now included in ai-context
+ai-context mcp
+
+# All MCP functionality is now built-in
+ai-context stats  # Equivalent to mcp:status
+```
+
+### From `claude-context-plugin`
+
+**Old Commands:**
+```bash
+/context-optimize
+/rpi-research
+/rpi-plan
+/rpi-implement
+```
+
+**New Usage:**
+```bash
+# Commands are now part of ai-context
+# The same commands work - they're now in the unified package
+```
+
+---
+
+## Step-by-Step Migration
+
+### 1. Uninstall Legacy Packages
+
+```bash
+# Remove legacy packages
+npm uninstall -g create-universal-ai-context
+
+# Note: @ai-context/mcp-server and claude-context-plugin
+# were typically not installed globally, but if you did:
+npm uninstall -g @ai-context/mcp-server
+npm uninstall -g claude-context-plugin
+```
+
+### 2. Install Unified Package
+
+```bash
+npm install -g ai-context
+```
+
+### 3. Update Configuration Files
+
+**Claude Desktop Config:**
+```json
+{
+  "mcpServers": {
+    "ai-context": {
+      "command": "node",
+      "args": ["C:\\Users\\YourName\\AppData\\Roaming\\npm\\node_modules\\ai-context\\dist\\mcp.js"],
+      "env": {
+        "OPENROUTER_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### 4. Migrate Existing Context
+
+```bash
+# In your project directory
+ai-context init
+
+# Your existing context will be preserved and migrated
+# to the new database format
+```
+
+### 5. Verify Migration
+
+```bash
+# Check status
+ai-context stats
+
+# Test commands
+ai-context generate
+ai-context sync
+
+# Test MCP server
+ai-context mcp
+```
+
+---
+
+## Feature Mapping
+
+| Legacy Feature | New Location | Notes |
+|----------------|--------------|-------|
+| `create-ai-context init` | `ai-context init` | Same functionality |
+| `create-ai-context generate` | `ai-context generate` | Same functionality |
+| `create-ai-context sync:*` | `ai-context sync` | Same functionality |
+| `create-ai-context status` | `ai-context stats` | Same functionality |
+| `mcp-server start` | `ai-context mcp` | Included in unified package |
+| `mcp-server init` | Included in `ai-context init` | Automatic |
+| Plugin skills | `ai-context` skills | Built-in commands |
+| Plugin commands | `ai-context` commands | Built-in commands |
+
+---
+
+## Breaking Changes
+
+### 1. Package Name
+
+**Old:** `create-universal-ai-context`
+**New:** `ai-context`
+
+### 2. Command Prefix
+
+**Old:** `create-ai-context`
+**New:** `ai-context`
+
+### 3. MCP Server
+
+**Old:** Separate package `@ai-context/mcp-server`
+**New:** Included in `ai-context`
+
+### 4. Plugin
+
+**Old:** Claude Code plugin
+**New:** Built-in commands and skills
+
+---
+
+## Rollback
+
+If you need to rollback:
+
+```bash
+# Uninstall new package
+npm uninstall -g ai-context
+
+# Reinstall legacy packages
+npm install -g create-universal-ai-context@2.5.0
+```
+
+---
+
+## Support
+
+- **Legacy Support:** Security updates until 2026-06-01
+- **Migration Issues:** [GitHub Issues](https://github.com/SireJeff/claude-context-engineering-template/issues)
+- **Documentation:** [README](../README.md)
+
+---
+
+## FAQ
+
+**Q: Do I need to migrate immediately?**
+A: No, legacy packages will receive security updates until 2026-06-01.
+
+**Q: Will my existing configurations work?**
+A: Yes, most configurations are compatible. See the feature mapping table above.
+
+**Q: What happens to my existing context files?**
+A: They will be automatically migrated when you run `ai-context init`.
+
+**Q: Is the unified package backward compatible?**
+A: Yes, it supports all legacy workflows and configurations.
+
+---
+
+**Need Help?** Open an issue or join our community discussions.