k0ntext 3.0.0

package/dist/cli/sync.js

@@ -0,0 +1,163 @@
+import { Command } from 'commander';
+import { DatabaseClient } from '../db/client.js';
+import ora from 'ora';
+import chalk from 'chalk';
+import crypto from 'crypto';
+import fs from 'fs/promises';
+export const syncCommand = new Command('sync')
+    .description('Synchronize context across all AI tools')
+    .option('--check', 'Only check synchronization status')
+    .option('--from <tool>', 'Sync from specific tool')
+    .option('--to <tool>', 'Sync to specific tool')
+    .option('--force', 'Force sync even if up-to-date')
+    .action(async (options) => {
+    const spinner = ora('Checking sync status...').start();
+    try {
+        const db = new DatabaseClient(process.cwd());
+        const syncManager = new SyncManager(db);
+        if (options.check) {
+            const status = await syncManager.checkStatus();
+            if (status.synced) {
+                spinner.succeed(chalk.green('All tools are synchronized'));
+            }
+            else {
+                spinner.warn(chalk.yellow('Tools are out of sync'));
+                console.log(chalk.dim('Differences:'), status.differences.join(', '));
+            }
+            return;
+        }
+        if (options.from) {
+            spinner.text = `Syncing from ${options.from}...`;
+            await syncManager.syncFrom(options.from);
+            spinner.succeed(chalk.green(`Synced from ${options.from}`));
+            return;
+        }
+        // Default: sync all tools
+        spinner.text = 'Syncing all tools...';
+        const result = await syncManager.syncAll({ force: options.force });
+        spinner.succeed(chalk.green(`Synced ${result.count} tools`));
+        if (result.files.length > 0) {
+            console.log(chalk.dim('Synced:'), result.files.join(', '));
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        spinner.fail(chalk.red('Sync failed'));
+        console.error(chalk.dim(errorMessage));
+        process.exit(1);
+    }
+});
+export class SyncManager {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async checkStatus() {
+        const tools = await this.getToolFiles();
+        const hashes = await this.getFileHashes(tools);
+        const differences = [];
+        for (const [tool, hash] of Object.entries(hashes)) {
+            const stored = this.db.getSyncState(tool);
+            const storedHash = Array.isArray(stored) && stored.length > 0 ? stored[0]?.contentHash : undefined;
+            if (storedHash !== undefined && storedHash !== hash) {
+                differences.push(tool);
+            }
+        }
+        return {
+            synced: differences.length === 0,
+            differences
+        };
+    }
+    async syncFrom(tool) {
+        const configs = this.db.getToolConfigs(tool);
+        if (!configs || configs.length === 0) {
+            throw new Error(`Tool ${tool} not found in database`);
+        }
+        // Sync logic - propagate changes from this tool to others
+        const content = await this.readToolFile(tool);
+        await this.propagateToTools(tool, content);
+    }
+    async syncAll(options) {
+        const tools = ['claude', 'copilot', 'cline', 'antigravity', 'windsurf', 'aider', 'continue', 'cursor', 'gemini'];
+        const synced = [];
+        for (const tool of tools) {
+            try {
+                await this.syncTool(tool, options);
+                synced.push(tool);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                // Continue with other tools even if one fails
+                console.error(chalk.dim(`Failed to sync ${tool}: ${errorMessage}`));
+            }
+        }
+        return { count: synced.length, files: synced };
+    }
+    async getToolFiles() {
+        return ['claude', 'copilot', 'cline', 'antigravity', 'windsurf', 'aider', 'continue', 'cursor', 'gemini'];
+    }
+    async getFileHashes(tools) {
+        const hashes = {};
+        const toolPaths = {
+            claude: 'AI_CONTEXT.md',
+            copilot: '.github/copilot-instructions.md',
+            cline: '.clinerules',
+            antigravity: '.agent/README.md',
+            windsurf: '.windsurf/rules.md',
+            aider: '.aider.conf.yml',
+            continue: '.continue/config.json',
+            cursor: '.cursorrules',
+            gemini: '.gemini/config.md'
+        };
+        for (const tool of tools) {
+            try {
+                const content = await fs.readFile(toolPaths[tool], 'utf-8');
+                hashes[tool] = crypto.createHash('sha256').update(content).digest('hex');
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(chalk.yellow(`Warning: Failed to read tool file for "${tool}" at "${toolPaths[tool]}": ${message}`));
+                hashes[tool] = '';
+            }
+        }
+        return hashes;
+    }
+    async readToolFile(tool) {
+        const toolPaths = {
+            claude: 'AI_CONTEXT.md',
+            copilot: '.github/copilot-instructions.md',
+            cline: '.clinerules',
+            antigravity: '.agent/README.md',
+            windsurf: '.windsurf/rules.md',
+            aider: '.aider.conf.yml',
+            continue: '.continue/config.json',
+            cursor: '.cursorrules',
+            gemini: '.gemini/config.md'
+        };
+        return await fs.readFile(toolPaths[tool], 'utf-8');
+    }
+    async propagateToTools(_fromTool, _content) {
+        // In a full implementation, this would parse the content
+        // and propagate it to all other tools
+        // For now, this is a placeholder
+        console.log(chalk.dim(`Propagating from ${_fromTool} to other tools...`));
+    }
+    async syncTool(tool, options) {
+        // Check if sync is needed
+        if (!options.force) {
+            const content = this.db.getAllItems();
+            if (content.length === 0) {
+                throw new Error(`No content in database for ${tool}`);
+            }
+        }
+        // Update sync state
+        this.db.updateSyncState({
+            id: `sync:${tool}`,
+            tool: tool,
+            contentHash: Date.now().toString(),
+            lastSync: new Date().toISOString(),
+            status: 'synced'
+        });
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/cli/sync.js.map

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

package/dist/config/cleanup-config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Cleanup configuration options
+ */
+export interface CleanupConfig {
+    /** Default dry run mode (safe mode) */
+    dryRun: boolean;
+    /** Default folders to keep */
+    defaultKeep: string[];
+    /** Verbose output by default */
+    verbose: boolean;
+    /** Maximum folder depth to scan */
+    maxDepth: number;
+    /** Timeout for folder operations in milliseconds */
+    timeout: number;
+    /** Default working directory */
+    cwd: string;
+}
+/**
+ * Default cleanup configuration
+ */
+export declare const DEFAULT_CLEANUP_CONFIG: CleanupConfig;
+/**
+ * Get cleanup configuration (can be extended to load from file)
+ */
+export declare function getCleanupConfig(): CleanupConfig;
+//# sourceMappingURL=cleanup-config.d.ts.map

package/dist/config/cleanup-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-config.d.ts","sourceRoot":"","sources":["../../src/config/cleanup-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,MAAM,EAAE,OAAO,CAAC;IAEhB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IAEjB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAOpC,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD"}

package/dist/config/cleanup-config.js

@@ -0,0 +1,21 @@
+/**
+ * Cleanup configuration options
+ */
+/**
+ * Default cleanup configuration
+ */
+export const DEFAULT_CLEANUP_CONFIG = {
+    dryRun: true,
+    defaultKeep: ['.github', '.vscode', '.idea', '.devcontainer'],
+    verbose: false,
+    maxDepth: 3,
+    timeout: 30000,
+    cwd: process.cwd()
+};
+/**
+ * Get cleanup configuration (can be extended to load from file)
+ */
+export function getCleanupConfig() {
+    return { ...DEFAULT_CLEANUP_CONFIG };
+}
+//# sourceMappingURL=cleanup-config.js.map

package/dist/config/cleanup-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-config.js","sourceRoot":"","sources":["../../src/config/cleanup-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsBH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,MAAM,EAAE,IAAI;IACZ,WAAW,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,CAAC;IAC7D,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,KAAK;IACd,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,EAAE,GAAG,sBAAsB,EAAE,CAAC;AACvC,CAAC"}

package/dist/db/client.d.ts

@@ -0,0 +1,284 @@
+/**
+ * Database Client
+ *
+ * SQLite database operations for AI context storage.
+ * Handles CRUD operations, queries, and vector search.
+ */
+import Database from 'better-sqlite3';
+import { type ContextType, type RelationType, type SyncStatus, type AITool } from './schema.js';
+/**
+ * Context item structure
+ */
+export interface ContextItem {
+    id: string;
+    type: ContextType;
+    name: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+    filePath?: string;
+    contentHash?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/**
+ * Knowledge graph edge
+ */
+export interface GraphEdge {
+    id?: number;
+    sourceId: string;
+    targetId: string;
+    relationType: RelationType;
+    weight?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Git commit record
+ */
+export interface GitCommit {
+    sha: string;
+    message: string;
+    authorName?: string;
+    authorEmail?: string;
+    timestamp: string;
+    filesChanged?: string[];
+    stats?: {
+        additions: number;
+        deletions: number;
+    };
+}
+/**
+ * Sync state record
+ */
+export interface SyncState {
+    id: string;
+    tool: string;
+    contentHash?: string;
+    lastSync: string;
+    filePath?: string;
+    status: SyncStatus;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * AI tool configuration record
+ */
+export interface AIToolConfig {
+    id: string;
+    toolName: AITool;
+    configPath: string;
+    content: string;
+    contentHash?: string;
+    lastSync: string;
+    status: SyncStatus;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Search result with similarity score
+ */
+export interface SearchResult {
+    item: ContextItem;
+    similarity: number;
+}
+/**
+ * Database client for AI context storage
+ */
+export declare class DatabaseClient {
+    private db;
+    private dbPath;
+    constructor(projectRoot: string, dbFileName?: string);
+    /**
+     * Migrate legacy database
+     */
+    private migrateLegacyDatabase;
+    /**
+     * Initialize database schema
+     */
+    private initSchema;
+    /**
+     * Execute callback within a transaction (sync)
+     */
+    transaction<T>(callback: () => T): T;
+    /**
+     * Execute callback within a transaction (async)
+     */
+    transaction<T>(callback: () => Promise<T>): Promise<T>;
+    /**
+     * Begin a manual transaction (returns rollback/commit functions)
+     */
+    beginTransaction(): {
+        rollback: () => void;
+        commit: () => void;
+    };
+    /**
+     * Check database connection health
+     */
+    healthCheck(): {
+        healthy: boolean;
+        error?: string;
+    };
+    /**
+     * Generate content hash for deduplication
+     */
+    private hashContent;
+    /**
+     * Generate a unique ID for a context item
+     */
+    private generateId;
+    /**
+     * Insert or update a context item
+     */
+    upsertItem(item: Omit<ContextItem, 'id' | 'contentHash' | 'createdAt' | 'updatedAt'>): ContextItem;
+    /**
+     * Get a context item by ID
+     */
+    getItem(id: string): ContextItem | null;
+    /**
+     * Get items by type
+     */
+    getItemsByType(type: ContextType): ContextItem[];
+    /**
+     * Get all items
+     */
+    getAllItems(): ContextItem[];
+    /**
+     * Delete a context item
+     */
+    deleteItem(id: string): boolean;
+    /**
+     * Delete items older than specified days
+     */
+    deleteStaleItems(daysOld: number, type?: ContextType): number;
+    /**
+     * Search items by text (full-text grep-style)
+     */
+    searchText(query: string, type?: ContextType): ContextItem[];
+    /**
+     * Convert database row to ContextItem
+     */
+    private rowToItem;
+    /**
+     * Calculate relevance score for a search result
+     */
+    private calculateRelevance;
+    /**
+     * Upsert an AI tool configuration
+     */
+    upsertToolConfig(config: Omit<AIToolConfig, 'contentHash' | 'lastSync'>): AIToolConfig;
+    /**
+     * Get tool configs by tool name
+     */
+    getToolConfigs(toolName: AITool): AIToolConfig[];
+    /**
+     * Get all tool configs
+     */
+    getAllToolConfigs(): AIToolConfig[];
+    /**
+     * Add a relationship to the knowledge graph
+     */
+    addRelation(edge: Omit<GraphEdge, 'id'>): GraphEdge;
+    /**
+     * Get relations from a source item
+     */
+    getRelationsFrom(sourceId: string, relationType?: RelationType): GraphEdge[];
+    /**
+     * Get relations to a target item
+     */
+    getRelationsTo(targetId: string, relationType?: RelationType): GraphEdge[];
+    /**
+     * Traverse the graph from a starting point
+     */
+    traverseGraph(startId: string, maxDepth?: number): Map<string, {
+        item: ContextItem;
+        depth: number;
+    }>;
+    /**
+     * Insert or update a git commit
+     */
+    upsertCommit(commit: GitCommit): void;
+    /**
+     * Get recent commits
+     */
+    getRecentCommits(limit?: number): GitCommit[];
+    /**
+     * Update sync state for a tool
+     */
+    updateSyncState(state: SyncState): void;
+    /**
+     * Get sync state for a tool
+     */
+    getSyncState(tool: string): SyncState[];
+    /**
+     * Store an embedding
+     */
+    storeEmbedding(contextId: string, embedding: number[]): void;
+    /**
+     * Search by embedding similarity
+     */
+    searchByEmbedding(queryEmbedding: number[], limit?: number): SearchResult[];
+    /**
+     * Hybrid search combining vector and text search
+     */
+    hybridSearch(query: string, queryEmbedding: number[] | null, options?: {
+        limit?: number;
+        type?: ContextType;
+        vectorWeight?: number;
+    }): SearchResult[];
+    /**
+     * Delete an embedding
+     */
+    deleteEmbedding(contextId: string): boolean;
+    /**
+     * Insert or update an embedding for a file by path
+     */
+    insertEmbedding(filePath: string, embedding: number[]): void;
+    /**
+     * Get item ID by file path
+     */
+    private getItemIdByPath;
+    /**
+     * Log a usage event
+     */
+    logUsage(toolName: string, query?: string, resultCount?: number, latencyMs?: number): void;
+    /**
+     * Get usage statistics
+     */
+    getUsageStats(days?: number): {
+        toolName: string;
+        count: number;
+        avgLatency: number;
+    }[];
+    /**
+     * Get database path
+     */
+    getPath(): string;
+    /**
+     * Get database statistics
+     */
+    getStats(): {
+        items: number;
+        relations: number;
+        commits: number;
+        embeddings: number;
+        toolConfigs: number;
+    };
+    /**
+     * Get raw database instance (for advanced operations)
+     */
+    getRawDb(): Database.Database;
+    /**
+     * Vacuum database to reclaim space
+     */
+    vacuum(): void;
+    /**
+     * Reindex database for optimization
+     */
+    reindex(): void;
+    /**
+     * Backup database to specified path
+     */
+    backup(backupPath: string): void;
+    /**
+     * Close database connection
+     */
+    close(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/db/client.d.ts.map

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