@pcircle/claude-code-buddy-mcp 2.3.1

package/dist/evolution/types.d.ts

@@ -0,0 +1,214 @@
+export interface PerformanceMetrics {
+    executionId: string;
+    agentId: string;
+    taskType: string;
+    success: boolean;
+    durationMs: number;
+    cost: number;
+    qualityScore: number;
+    userSatisfaction?: number;
+    timestamp: Date;
+    metadata?: Record<string, any>;
+}
+export interface LearnedPattern {
+    id: string;
+    type: 'success' | 'failure' | 'optimization' | 'anti-pattern';
+    agentId: string;
+    taskType: string;
+    description: string;
+    conditions: {
+        context?: Record<string, any>;
+        requiredCapabilities?: string[];
+        taskComplexity?: 'low' | 'medium' | 'high';
+    };
+    action: {
+        type: 'adjust_prompt' | 'change_model' | 'add_step' | 'remove_step' | 'modify_timeout';
+        parameters: Record<string, any>;
+    };
+    confidence: number;
+    observationCount: number;
+    successCount: number;
+    successRate: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface AgentFeedback {
+    id: string;
+    executionId: string;
+    agentId: string;
+    type: 'positive' | 'negative' | 'suggestion';
+    rating: number;
+    feedback: string;
+    issues?: string[];
+    suggestions?: string[];
+    timestamp: Date;
+}
+export interface AdaptationConfig {
+    agentId: string;
+    enabledAdaptations: {
+        promptOptimization?: boolean;
+        modelSelection?: boolean;
+        timeoutAdjustment?: boolean;
+        retryStrategy?: boolean;
+    };
+    learningRate: number;
+    minConfidence: number;
+    minObservations: number;
+    maxPatterns: number;
+}
+export interface EvolutionStats {
+    agentId: string;
+    totalExecutions: number;
+    successRateTrend: {
+        historical: number;
+        recent: number;
+        improvement: number;
+    };
+    costEfficiencyTrend: {
+        historical: number;
+        recent: number;
+        improvement: number;
+    };
+    qualityScoreTrend: {
+        historical: number;
+        recent: number;
+        improvement: number;
+    };
+    learnedPatterns: number;
+    appliedAdaptations: number;
+    lastLearningDate: Date;
+}
+export interface PatternContext {
+    agent_type?: string;
+    task_type?: string;
+    project_type?: string;
+    domain?: string;
+    complexity?: 'low' | 'medium' | 'high';
+    config_keys?: string[];
+    actions?: string[];
+    metadata?: Record<string, any>;
+}
+export interface ContextualPattern {
+    id: string;
+    type: 'success' | 'failure' | 'optimization' | 'anti-pattern';
+    description: string;
+    confidence: number;
+    observations: number;
+    success_rate: number;
+    avg_execution_time: number;
+    last_seen: string;
+    context: PatternContext;
+}
+export interface OptimizationObjectives {
+    accuracy?: number;
+    speed?: number;
+    cost?: number;
+    satisfaction?: number;
+    [key: string]: number | undefined;
+}
+export interface OptimizationCandidate {
+    id: string;
+    objectives: OptimizationObjectives;
+    metadata?: Record<string, any>;
+}
+export interface PatternExplanation {
+    summary: string;
+    reasoning: string[];
+    recommendation: string;
+    confidence_explanation: string;
+    context_description: string;
+}
+export interface PatternTransferability {
+    sourceAgentId: string;
+    targetAgentId: string;
+    patternId: string;
+    applicabilityScore: number;
+    contextSimilarity: number;
+    confidence: number;
+    reasoning: string[];
+}
+export interface TransferablePattern {
+    pattern: ContextualPattern;
+    sourceAgentId: string;
+    transferredAt: Date;
+    originalConfidence: number;
+    adaptedForContext?: PatternContext;
+}
+export interface ABTestExperiment {
+    id: string;
+    name: string;
+    description: string;
+    variants: ABTestVariant[];
+    trafficSplit: number[];
+    successMetric: 'quality_score' | 'cost' | 'duration' | 'user_satisfaction';
+    secondaryMetrics?: string[];
+    durationDays: number;
+    minSampleSize: number;
+    significanceLevel: number;
+    status: 'draft' | 'running' | 'completed' | 'stopped';
+    startedAt?: Date;
+    completedAt?: Date;
+    results?: ABTestResults;
+}
+export interface ABTestVariant {
+    name: string;
+    config: Record<string, any>;
+    description?: string;
+}
+export interface ABTestAssignment {
+    id: string;
+    experimentId: string;
+    agentId: string;
+    variantName: string;
+    assignedAt: Date;
+}
+export interface ABTestResults {
+    experimentId: string;
+    winner: string | null;
+    confidence: number;
+    variantStats: Record<string, VariantStatistics>;
+    statisticalTests: {
+        testType: 't-test' | 'chi-square' | 'mann-whitney';
+        pValue: number;
+        effectSize: number;
+        confidenceInterval: [number, number];
+    };
+    recommendation: string;
+}
+export interface VariantStatistics {
+    variantName: string;
+    sampleSize: number;
+    successRate: number;
+    mean: number;
+    stdDev: number;
+    confidenceInterval: [number, number];
+}
+export interface FederatedLearningConfig {
+    minAgents: number;
+    aggregationMethod: 'federated_averaging' | 'weighted_average' | 'median';
+    privacyBudget: number;
+    maxRounds: number;
+}
+export interface LocalModelUpdate {
+    id: string;
+    agentId: string;
+    round: number;
+    patternStats: {
+        patternType: 'success' | 'failure' | 'optimization' | 'anti-pattern';
+        count: number;
+        avgConfidence: number;
+        avgSuccessRate: number;
+        contextDistribution: Record<string, number>;
+    }[];
+    sampleSize: number;
+    timestamp: Date;
+}
+export interface GlobalModel {
+    version: string;
+    round: number;
+    patterns: ContextualPattern[];
+    participatingAgents: number;
+    totalSamples: number;
+    createdAt: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/evolution/types.d.ts.map

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

package/dist/evolution/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/evolution/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/evolution/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './telemetry';
+export { AgentRegistry } from './core/AgentRegistry.js';
+export { MCPToolInterface } from './core/MCPToolInterface.js';
+export { CheckpointDetector } from './core/CheckpointDetector.js';
+export { DevelopmentButler } from './agents/DevelopmentButler.js';
+export { TestWriterAgent } from './agents/TestWriterAgent.js';
+export type { ToolMetadata, ToolInvocationResult, ToolDependencyCheck } from './core/MCPToolInterface.js';
+export type { AgentMetadata } from './core/AgentRegistry.js';
+export type { CheckpointCallback, CheckpointMetadata, CheckpointTriggerResult } from './core/CheckpointDetector.js';
+export { Checkpoint } from './types/Checkpoint.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgDA,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGlE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC1G,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAGpH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+import { Orchestrator } from './orchestrator/index.js';
+import { appConfig } from './config/index.js';
+import { logger } from './utils/logger.js';
+import { AgentRegistry } from './core/AgentRegistry.js';
+async function main() {
+    logger.info('🤖 Claude Code Buddy starting...');
+    logger.info(`Mode: ${appConfig.orchestrator.mode}`);
+    logger.info(`Claude Model: ${appConfig.claude.models.sonnet}`);
+    const orchestrator = new Orchestrator();
+    logger.info('✅ Orchestrator initialized');
+    const status = await orchestrator.getSystemStatus();
+    logger.info(`💻 System Resources: ${status.resources.availableMemoryMB}MB available (${status.resources.memoryUsagePercent}% used)`);
+    logger.info(`💰 Monthly Spend: $${status.costStats.monthlySpend.toFixed(4)} ($${status.costStats.remainingBudget.toFixed(2)} remaining)`);
+    logger.info(`📊 ${status.recommendation}`);
+    const registry = new AgentRegistry();
+    const capabilities = new Set(registry.getAllAgents().flatMap(agent => agent.capabilities || []));
+    logger.info('\n✅ Claude Code Buddy ready!');
+    logger.info(`\n📋 Capabilities loaded: ${capabilities.size}\n`);
+    return orchestrator;
+}
+main().catch((error) => {
+    logger.error('Failed to start Claude Code Buddy:', error);
+    process.exit(1);
+});
+export * from './telemetry';
+export { AgentRegistry } from './core/AgentRegistry.js';
+export { MCPToolInterface } from './core/MCPToolInterface.js';
+export { CheckpointDetector } from './core/CheckpointDetector.js';
+export { DevelopmentButler } from './agents/DevelopmentButler.js';
+export { TestWriterAgent } from './agents/TestWriterAgent.js';
+export { Checkpoint } from './types/Checkpoint.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,CAAC,IAAI,CAAC,iBAAiB,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAG/D,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;IACxC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAG1C,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,eAAe,EAAE,CAAC;IACpD,MAAM,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,SAAS,CAAC,iBAAiB,iBAAiB,MAAM,CAAC,SAAS,CAAC,kBAAkB,SAAS,CAAC,CAAC;IACrI,MAAM,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAC1I,MAAM,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IAG3C,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CACnE,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,6BAA6B,YAAY,CAAC,IAAI,IAAI,CAAC,CAAC;IAMhE,OAAO,YAAY,CAAC;AACtB,CAAC;AAGD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAGH,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGlE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAQ9D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/knowledge-graph/index.d.ts

@@ -0,0 +1,27 @@
+import type { Entity, Relation, SearchQuery, RelationTrace } from './types.js';
+export declare class KnowledgeGraph {
+    private db;
+    private dbPath;
+    private queryCache;
+    private constructor();
+    static create(dbPath?: string): Promise<KnowledgeGraph>;
+    static createSync(dbPath?: string): KnowledgeGraph;
+    private initialize;
+    private escapeLikePattern;
+    createEntity(entity: Entity): number;
+    createRelation(relation: Relation): void;
+    searchEntities(query: SearchQuery): Entity[];
+    getEntity(name: string): Entity | null;
+    traceRelations(entityName: string, depth?: number): RelationTrace | null;
+    getStats(): {
+        totalEntities: number;
+        totalRelations: number;
+        entitiesByType: Record<string, number>;
+    };
+    deleteEntity(name: string): boolean;
+    close(): void;
+    getCacheStats(): import("../db/QueryCache.js").CacheStats;
+    clearCache(): void;
+}
+export type { Entity, Relation, SearchQuery, RelationTrace, EntityType, RelationType } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/knowledge-graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/knowledge-graph/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAA4B,MAAM,YAAY,CAAC;AAMzG,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAA0B;IAK5C,OAAO;WA2BM,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAoC7D,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc;IAuBlD,OAAO,CAAC,UAAU;IA0ElB,OAAO,CAAC,iBAAiB;IAWzB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IA8DpC,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAiDxC,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE;IAkH5C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQtC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,aAAa,GAAG,IAAI;IA8D3E,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC;IA6CD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAyBnC,KAAK;IAaL,aAAa;IAOb,UAAU;CAIX;AAGD,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/knowledge-graph/index.js

@@ -0,0 +1,353 @@
+import { join } from 'path';
+import { promises as fsPromises, existsSync, mkdirSync } from 'fs';
+import { NotFoundError, ValidationError } from '../errors/index.js';
+import { SimpleDatabaseFactory } from '../config/simple-config.js';
+import { logger } from '../utils/logger.js';
+import { QueryCache } from '../db/QueryCache.js';
+import { safeJsonParse } from '../utils/json.js';
+export class KnowledgeGraph {
+    db;
+    dbPath;
+    queryCache;
+    constructor(dbPath, db) {
+        this.dbPath = dbPath;
+        this.db = db;
+        this.queryCache = new QueryCache({
+            maxSize: 1000,
+            defaultTTL: 5 * 60 * 1000,
+            debug: false,
+        });
+    }
+    static async create(dbPath) {
+        const resolvedPath = dbPath || join(process.cwd(), 'data', 'knowledge-graph.db');
+        const dataDir = join(process.cwd(), 'data');
+        try {
+            await fsPromises.access(dataDir);
+        }
+        catch {
+            await fsPromises.mkdir(dataDir, { recursive: true });
+        }
+        const db = SimpleDatabaseFactory.getInstance(resolvedPath);
+        const instance = new KnowledgeGraph(resolvedPath, db);
+        instance.initialize();
+        logger.info(`[KnowledgeGraph] Initialized at: ${resolvedPath}`);
+        return instance;
+    }
+    static createSync(dbPath) {
+        const resolvedPath = dbPath || join(process.cwd(), 'data', 'knowledge-graph.db');
+        const dataDir = join(process.cwd(), 'data');
+        if (!existsSync(dataDir)) {
+            mkdirSync(dataDir, { recursive: true });
+        }
+        const db = SimpleDatabaseFactory.getInstance(resolvedPath);
+        const instance = new KnowledgeGraph(resolvedPath, db);
+        instance.initialize();
+        logger.info(`[KnowledgeGraph] Initialized at: ${resolvedPath}`);
+        return instance;
+    }
+    initialize() {
+        const schema = `
+      -- Entities table
+      CREATE TABLE IF NOT EXISTS entities (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        name TEXT NOT NULL UNIQUE,
+        type TEXT NOT NULL,  -- Maps to TypeScript 'entityType' field
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        metadata JSON
+      );
+
+      -- Observations table
+      CREATE TABLE IF NOT EXISTS observations (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        entity_id INTEGER NOT NULL,
+        content TEXT NOT NULL,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        FOREIGN KEY (entity_id) REFERENCES entities(id) ON DELETE CASCADE
+      );
+
+      -- Relations table
+      CREATE TABLE IF NOT EXISTS relations (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        from_entity_id INTEGER NOT NULL,
+        to_entity_id INTEGER NOT NULL,
+        relation_type TEXT NOT NULL,
+        metadata JSON,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        FOREIGN KEY (from_entity_id) REFERENCES entities(id) ON DELETE CASCADE,
+        FOREIGN KEY (to_entity_id) REFERENCES entities(id) ON DELETE CASCADE,
+        UNIQUE(from_entity_id, to_entity_id, relation_type)
+      );
+
+      -- Tags table
+      CREATE TABLE IF NOT EXISTS tags (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        entity_id INTEGER NOT NULL,
+        tag TEXT NOT NULL,
+        FOREIGN KEY (entity_id) REFERENCES entities(id) ON DELETE CASCADE
+      );
+
+      -- Indexes for performance
+      CREATE INDEX IF NOT EXISTS idx_entities_type ON entities(type);
+      CREATE INDEX IF NOT EXISTS idx_entities_name ON entities(name);
+      CREATE INDEX IF NOT EXISTS idx_entities_type_created ON entities(type, created_at);
+
+      CREATE INDEX IF NOT EXISTS idx_observations_created ON observations(created_at);
+      CREATE INDEX IF NOT EXISTS idx_observations_entity_created ON observations(entity_id, created_at);
+
+      CREATE INDEX IF NOT EXISTS idx_relations_from ON relations(from_entity_id);
+      CREATE INDEX IF NOT EXISTS idx_relations_to ON relations(to_entity_id);
+      CREATE INDEX IF NOT EXISTS idx_relations_type ON relations(relation_type);
+      CREATE INDEX IF NOT EXISTS idx_relations_from_type ON relations(from_entity_id, relation_type);
+      CREATE INDEX IF NOT EXISTS idx_relations_to_type ON relations(to_entity_id, relation_type);
+      CREATE INDEX IF NOT EXISTS idx_relations_created ON relations(created_at);
+
+      CREATE INDEX IF NOT EXISTS idx_tags_tag ON tags(tag);
+      CREATE INDEX IF NOT EXISTS idx_tags_entity ON tags(entity_id);
+      CREATE INDEX IF NOT EXISTS idx_tags_entity_tag ON tags(entity_id, tag);
+    `;
+        this.db.exec(schema);
+    }
+    escapeLikePattern(pattern) {
+        return pattern
+            .replace(/\\/g, '\\\\')
+            .replace(/%/g, '\\%')
+            .replace(/_/g, '\\_')
+            .replace(/\[/g, '\\[');
+    }
+    createEntity(entity) {
+        const stmt = this.db.prepare(`
+      INSERT INTO entities (name, type, metadata)
+      VALUES (?, ?, json(?))
+      ON CONFLICT(name) DO UPDATE SET
+        type = excluded.type,
+        metadata = excluded.metadata
+    `);
+        const result = stmt.run(entity.name, entity.entityType, JSON.stringify(entity.metadata || {}));
+        const entityId = result.lastInsertRowid;
+        const actualEntity = this.db
+            .prepare('SELECT id FROM entities WHERE name = ?')
+            .get(entity.name);
+        const actualId = actualEntity.id;
+        this.db.prepare('DELETE FROM observations WHERE entity_id = ?').run(actualId);
+        this.db.prepare('DELETE FROM tags WHERE entity_id = ?').run(actualId);
+        if (entity.observations && entity.observations.length > 0) {
+            const obsStmt = this.db.prepare(`
+        INSERT INTO observations (entity_id, content)
+        VALUES (?, ?)
+      `);
+            for (const obs of entity.observations) {
+                obsStmt.run(actualId, obs);
+            }
+        }
+        if (entity.tags && entity.tags.length > 0) {
+            const tagStmt = this.db.prepare(`
+        INSERT INTO tags (entity_id, tag)
+        VALUES (?, ?)
+      `);
+            for (const tag of entity.tags) {
+                tagStmt.run(actualId, tag);
+            }
+        }
+        this.queryCache.invalidatePattern(/^entities:/);
+        logger.info(`[KG] Created entity: ${entity.name} (type: ${entity.entityType})`);
+        return actualId;
+    }
+    createRelation(relation) {
+        const getEntityId = this.db.prepare('SELECT id FROM entities WHERE name = ?');
+        const fromEntity = getEntityId.get(relation.from);
+        const toEntity = getEntityId.get(relation.to);
+        if (!fromEntity) {
+            throw new NotFoundError(`Entity not found: ${relation.from}`, 'entity', relation.from, { relationContext: 'from entity in relation creation' });
+        }
+        if (!toEntity) {
+            throw new NotFoundError(`Entity not found: ${relation.to}`, 'entity', relation.to, { relationContext: 'to entity in relation creation' });
+        }
+        const stmt = this.db.prepare(`
+      INSERT INTO relations (from_entity_id, to_entity_id, relation_type, metadata)
+      VALUES (?, ?, ?, json(?))
+      ON CONFLICT(from_entity_id, to_entity_id, relation_type) DO UPDATE SET
+        metadata = excluded.metadata
+    `);
+        stmt.run(fromEntity.id, toEntity.id, relation.relationType, JSON.stringify(relation.metadata || {}));
+        this.queryCache.invalidatePattern(/^relations:/);
+        this.queryCache.invalidatePattern(/^trace:/);
+        logger.info(`[KG] Created relation: ${relation.from} -[${relation.relationType}]-> ${relation.to}`);
+    }
+    searchEntities(query) {
+        const MAX_LIMIT = 1000;
+        if (query.limit !== undefined) {
+            if (query.limit < 0) {
+                throw new ValidationError('Limit must be non-negative', {
+                    component: 'KnowledgeGraph',
+                    method: 'searchEntities',
+                    providedLimit: query.limit,
+                });
+            }
+            if (query.limit > MAX_LIMIT) {
+                logger.warn(`Limit ${query.limit} exceeds maximum, capping to ${MAX_LIMIT}`);
+                query.limit = MAX_LIMIT;
+            }
+        }
+        if (query.offset !== undefined && query.offset < 0) {
+            throw new ValidationError('Offset must be non-negative', {
+                component: 'KnowledgeGraph',
+                method: 'searchEntities',
+                providedOffset: query.offset,
+            });
+        }
+        const cacheKey = `entities:${JSON.stringify(query)}`;
+        const cached = this.queryCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        let sql = `
+      SELECT e.*,
+        (SELECT json_group_array(content) FROM observations o WHERE o.entity_id = e.id) as observations_json,
+        (SELECT json_group_array(tag) FROM tags t WHERE t.entity_id = e.id) as tags_json
+      FROM entities e
+      WHERE 1=1
+    `;
+        const params = [];
+        if (query.entityType) {
+            sql += ' AND e.type = ?';
+            params.push(query.entityType);
+        }
+        if (query.tag) {
+            sql += ' AND e.id IN (SELECT entity_id FROM tags WHERE tag = ?)';
+            params.push(query.tag);
+        }
+        if (query.namePattern) {
+            sql += " AND e.name LIKE ? ESCAPE '\\'";
+            params.push(`%${this.escapeLikePattern(query.namePattern)}%`);
+        }
+        sql += ' ORDER BY e.created_at DESC';
+        if (query.limit) {
+            sql += ' LIMIT ?';
+            params.push(query.limit);
+        }
+        if (query.offset) {
+            sql += ' OFFSET ?';
+            params.push(query.offset);
+        }
+        const stmt = this.db.prepare(sql);
+        const rows = stmt.all(...params);
+        const entities = new Array(rows.length);
+        for (let i = 0; i < rows.length; i++) {
+            const r = rows[i];
+            const observations = safeJsonParse(r.observations_json, [])
+                .filter(value => value);
+            const tags = safeJsonParse(r.tags_json, [])
+                .filter(value => value);
+            entities[i] = {
+                id: r.id,
+                name: r.name,
+                entityType: r.type,
+                observations,
+                tags,
+                metadata: r.metadata ? safeJsonParse(r.metadata, {}) : {},
+                createdAt: new Date(r.created_at)
+            };
+        }
+        this.queryCache.set(cacheKey, entities);
+        return entities;
+    }
+    getEntity(name) {
+        const results = this.searchEntities({ namePattern: name, limit: 1 });
+        return results.length > 0 ? results[0] : null;
+    }
+    traceRelations(entityName, depth = 2) {
+        const cacheKey = `trace:${entityName}:${depth}`;
+        const cached = this.queryCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        const getEntityId = this.db.prepare('SELECT id FROM entities WHERE name = ?');
+        const entity = getEntityId.get(entityName);
+        if (!entity) {
+            return null;
+        }
+        const relationRows = this.db.prepare(`
+      SELECT
+        e1.name as from_name,
+        e2.name as to_name,
+        r.relation_type,
+        r.metadata
+      FROM relations r
+      JOIN entities e1 ON r.from_entity_id = e1.id
+      JOIN entities e2 ON r.to_entity_id = e2.id
+      WHERE r.from_entity_id = ? OR r.to_entity_id = ?
+    `).all(entity.id, entity.id);
+        const relations = new Array(relationRows.length);
+        for (let i = 0; i < relationRows.length; i++) {
+            const r = relationRows[i];
+            relations[i] = {
+                from: r.from_name,
+                to: r.to_name,
+                relationType: r.relation_type,
+                metadata: r.metadata ? JSON.parse(r.metadata) : {}
+            };
+        }
+        const result = {
+            entity: entityName,
+            relations,
+            depth
+        };
+        this.queryCache.set(cacheKey, result);
+        return result;
+    }
+    getStats() {
+        const cacheKey = 'stats:all';
+        const cached = this.queryCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        const totalEntities = this.db
+            .prepare('SELECT COUNT(*) as count FROM entities')
+            .get();
+        const totalRelations = this.db
+            .prepare('SELECT COUNT(*) as count FROM relations')
+            .get();
+        const byType = this.db
+            .prepare('SELECT type, COUNT(*) as count FROM entities GROUP BY type')
+            .all();
+        const entitiesByType = {};
+        byType.forEach(row => {
+            entitiesByType[row.type] = row.count;
+        });
+        const result = {
+            totalEntities: totalEntities.count,
+            totalRelations: totalRelations.count,
+            entitiesByType
+        };
+        this.queryCache.set(cacheKey, result, 60 * 1000);
+        return result;
+    }
+    deleteEntity(name) {
+        const getEntityId = this.db.prepare('SELECT id FROM entities WHERE name = ?');
+        const entity = getEntityId.get(name);
+        if (!entity) {
+            return false;
+        }
+        const stmt = this.db.prepare('DELETE FROM entities WHERE name = ?');
+        const result = stmt.run(name);
+        this.queryCache.invalidatePattern(/^entities:/);
+        this.queryCache.invalidatePattern(/^relations:/);
+        this.queryCache.invalidatePattern(/^trace:/);
+        this.queryCache.invalidatePattern(/^stats:/);
+        logger.info(`[KG] Deleted entity: ${name}`);
+        return result.changes > 0;
+    }
+    close() {
+        this.queryCache.destroy();
+        this.db.close();
+        logger.info('[KG] Database connection and cache closed');
+    }
+    getCacheStats() {
+        return this.queryCache.getStats();
+    }
+    clearCache() {
+        this.queryCache.clear();
+        logger.info('[KG] Cache cleared manually');
+    }
+}
+//# sourceMappingURL=index.js.map