@nahisaho/yata-local 1.6.6

package/dist/index.js

@@ -0,0 +1,436 @@
+/**
+ * YATA Local - Main Entry Point
+ *
+ * SQLite-based local knowledge graph storage for AI coding assistants.
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-local
+ *
+ * @example
+ * ```typescript
+ * import { createYataLocal } from '@nahisaho/yata-local';
+ *
+ * const yata = createYataLocal({ path: './knowledge.db' });
+ * await yata.open();
+ *
+ * // Add entities
+ * const classId = await yata.addEntity({
+ *   type: 'class',
+ *   name: 'UserService',
+ *   namespace: 'app.services',
+ *   filePath: 'src/services/user.ts',
+ * });
+ *
+ * // Query graph
+ * const result = await yata.query({
+ *   entityFilters: { types: ['class', 'interface'] },
+ *   textSearch: 'User',
+ * });
+ *
+ * await yata.close();
+ * ```
+ */
+import { randomUUID } from 'crypto';
+import { DEFAULT_DB_CONFIG } from './types.js';
+import { YataDatabase } from './database.js';
+import { QueryEngine } from './query-engine.js';
+import { ReasoningEngine } from './reasoning.js';
+import { IoModule } from './io.js';
+/**
+ * YATA Local implementation
+ */
+export class YataLocal {
+    db;
+    queryEngine;
+    reasoningEngine;
+    ioModule;
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_DB_CONFIG, ...config };
+        this.db = new YataDatabase(this.config);
+    }
+    /**
+     * Open database connection
+     */
+    async open(config) {
+        if (config) {
+            this.config = { ...this.config, ...config };
+            this.db = new YataDatabase(this.config);
+        }
+        await this.db.open();
+        // Initialize engines
+        this.queryEngine = new QueryEngine(this.db);
+        this.reasoningEngine = new ReasoningEngine(this.db, this.queryEngine);
+        this.ioModule = new IoModule(this.db);
+    }
+    /**
+     * Close database connection
+     */
+    async close() {
+        await this.db.close();
+    }
+    /**
+     * Check if database is open
+     */
+    isOpen() {
+        return this.db.isOpen();
+    }
+    // Entity Operations
+    /**
+     * Add entity to graph
+     * @see REQ-YL-UPDATE-001
+     */
+    async addEntity(entity) {
+        const id = randomUUID();
+        const now = new Date();
+        const fullEntity = {
+            ...entity,
+            id,
+            metadata: entity.metadata ?? {},
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.db.insertEntity(fullEntity);
+        return id;
+    }
+    /**
+     * Add multiple entities in batch
+     */
+    async addEntities(entities) {
+        const now = new Date();
+        const fullEntities = entities.map(e => ({
+            ...e,
+            id: randomUUID(),
+            metadata: e.metadata ?? {},
+            createdAt: now,
+            updatedAt: now,
+        }));
+        this.db.insertEntities(fullEntities);
+        return fullEntities.map(e => e.id);
+    }
+    /**
+     * Get entity by ID
+     */
+    async getEntity(id) {
+        return this.db.getEntity(id);
+    }
+    /**
+     * Update entity
+     * @see REQ-YL-UPDATE-002
+     */
+    async updateEntity(id, updates) {
+        this.db.updateEntity(id, updates);
+    }
+    /**
+     * Delete entity
+     * @see REQ-YL-UPDATE-003
+     */
+    async deleteEntity(id) {
+        this.db.deleteEntity(id);
+    }
+    /**
+     * Delete entities by file path
+     */
+    async deleteEntitiesByFile(filePath) {
+        return this.db.deleteEntitiesByFile(filePath);
+    }
+    // High-Level Query APIs (P0 Enhancement)
+    /**
+     * Get all entities by type
+     * @see REQ-YL-QUERY-001
+     */
+    async getEntitiesByType(type) {
+        const result = this.db.queryEntities({ type }, 10000, 0);
+        return result.entities;
+    }
+    /**
+     * Get all entities by namespace
+     * @see REQ-YL-QUERY-001
+     */
+    async getEntitiesByNamespace(namespace) {
+        const result = this.db.queryEntities({ namespace }, 10000, 0);
+        return result.entities;
+    }
+    /**
+     * Get entities by metadata.entityKind
+     * @see REQ-YL-QUERY-001
+     */
+    async getEntitiesByKind(kind) {
+        const db = this.db.getDb();
+        const stmt = db.prepare(`
+      SELECT * FROM entities 
+      WHERE json_extract(metadata, '$.entityKind') = ?
+      ORDER BY created_at DESC
+    `);
+        const rows = stmt.all(kind);
+        return rows.map(row => ({
+            id: row.id,
+            type: row.type,
+            name: row.name,
+            namespace: row.namespace,
+            filePath: row.file_path ?? undefined,
+            line: row.line ?? undefined,
+            description: row.description ?? undefined,
+            metadata: JSON.parse(row.metadata),
+            createdAt: new Date(row.created_at),
+            updatedAt: new Date(row.updated_at),
+        }));
+    }
+    /**
+     * Get entity by name (first match)
+     */
+    async getEntityByName(name, namespace) {
+        const filters = { name };
+        if (namespace)
+            filters.namespace = namespace;
+        const result = this.db.queryEntities(filters, 1, 0);
+        return result.entities[0] ?? null;
+    }
+    /**
+     * Upsert entity (add or update)
+     * @see REQ-YL-UPDATE-001
+     */
+    async upsertEntity(entity, matchBy = 'name-namespace') {
+        const existing = await this.getEntityByName(entity.name, matchBy === 'name-namespace' ? entity.namespace : undefined);
+        if (existing) {
+            // Update existing
+            await this.updateEntity(existing.id, {
+                type: entity.type,
+                filePath: entity.filePath,
+                line: entity.line,
+                description: entity.description,
+                metadata: { ...existing.metadata, ...entity.metadata },
+            });
+            return { id: existing.id, created: false };
+        }
+        else {
+            // Create new
+            const id = await this.addEntity(entity);
+            return { id, created: true };
+        }
+    }
+    /**
+     * Upsert multiple entities in transaction
+     */
+    async upsertEntities(entities, matchBy = 'name-namespace') {
+        let created = 0;
+        let updated = 0;
+        for (const entity of entities) {
+            const result = await this.upsertEntity(entity, matchBy);
+            if (result.created)
+                created++;
+            else
+                updated++;
+        }
+        return { created, updated };
+    }
+    /**
+     * Execute raw SQL query (for advanced use cases)
+     */
+    async rawQuery(sql, params = []) {
+        const db = this.db.getDb();
+        const stmt = db.prepare(sql);
+        return stmt.all(...params);
+    }
+    // Relationship Operations
+    /**
+     * Add relationship
+     */
+    async addRelationship(sourceId, targetId, type, metadata) {
+        const id = randomUUID();
+        const rel = {
+            id,
+            sourceId,
+            targetId,
+            type,
+            weight: 1.0,
+            metadata: metadata ?? {},
+            createdAt: new Date(),
+        };
+        this.db.insertRelationship(rel);
+        return id;
+    }
+    /**
+     * Get relationships for entity
+     */
+    async getRelationships(entityId, direction) {
+        return this.db.getRelationships(entityId, direction);
+    }
+    /**
+     * Delete relationship
+     */
+    async deleteRelationship(id) {
+        this.db.deleteRelationship(id);
+    }
+    // Query Operations
+    /**
+     * Execute graph query
+     * @see REQ-YL-QUERY-001
+     */
+    async query(query, options) {
+        return this.queryEngine.query(query, options);
+    }
+    /**
+     * Find path between entities
+     * @see REQ-YL-QUERY-002
+     */
+    async findPath(startId, endId, options) {
+        return this.queryEngine.findPath(startId, endId, options);
+    }
+    /**
+     * Extract subgraph around entity
+     * @see REQ-YL-QUERY-003
+     */
+    async extractSubgraph(rootId, options) {
+        return this.queryEngine.extractSubgraph(rootId, options);
+    }
+    /**
+     * Match pattern in graph
+     * @see REQ-YL-QUERY-004
+     */
+    async matchPattern(pattern) {
+        return this.queryEngine.matchPattern(pattern);
+    }
+    /**
+     * Full-text search
+     * @see REQ-YL-QUERY-005
+     */
+    async search(text, limit) {
+        return this.db.searchEntities(text, limit);
+    }
+    /**
+     * Traverse relationships
+     */
+    async traverse(startId, relationshipTypes, direction, maxHops) {
+        return this.queryEngine.traverse(startId, relationshipTypes, direction, maxHops);
+    }
+    /**
+     * Get entity neighbors
+     */
+    async getNeighbors(entityId, options) {
+        return this.queryEngine.getNeighbors(entityId, options);
+    }
+    // Reasoning Operations
+    /**
+     * Run inference
+     * @see REQ-YL-REASON-001
+     */
+    async infer(options) {
+        return this.reasoningEngine.infer(options);
+    }
+    /**
+     * Validate graph constraints
+     * @see REQ-YL-REASON-003
+     */
+    async validate(options) {
+        return this.reasoningEngine.validate(options);
+    }
+    /**
+     * Compute confidence score
+     * @see REQ-YL-REASON-004
+     */
+    async computeConfidence(sourceId, targetId, relType) {
+        return this.reasoningEngine.computeConfidence(sourceId, targetId, relType);
+    }
+    /**
+     * Suggest relationships
+     * @see REQ-YL-REASON-002
+     */
+    async suggestRelationships(entityId, options) {
+        return this.reasoningEngine.suggestRelationships(entityId, options);
+    }
+    /**
+     * Add custom inference rule
+     */
+    addInferenceRule(rule) {
+        this.reasoningEngine.addRule(rule);
+    }
+    /**
+     * Add custom constraint
+     */
+    addConstraint(constraint) {
+        this.reasoningEngine.addConstraint(constraint);
+    }
+    /**
+     * Get all inference rules
+     */
+    getInferenceRules() {
+        return this.reasoningEngine.getRules();
+    }
+    /**
+     * Get all constraints
+     */
+    getConstraints() {
+        return this.reasoningEngine.getConstraints();
+    }
+    // Import/Export Operations
+    /**
+     * Export to JSON
+     * @see REQ-YL-IO-001
+     */
+    async exportJson(filePath) {
+        return this.ioModule.exportToJson(filePath);
+    }
+    /**
+     * Import from JSON
+     * @see REQ-YL-IO-003
+     */
+    async importJson(input, options) {
+        return this.ioModule.importFromJson(input, options);
+    }
+    /**
+     * Export to RDF
+     * @see REQ-YL-IO-001
+     */
+    async exportRdf(filePath, options) {
+        return this.ioModule.exportToRdf(filePath, options);
+    }
+    /**
+     * Compute delta between states
+     * @see REQ-YL-IO-004
+     */
+    computeDelta(oldState, newState) {
+        return this.ioModule.computeDelta(oldState, newState);
+    }
+    /**
+     * Apply delta
+     * @see REQ-YL-IO-004
+     */
+    async applyDelta(delta, options) {
+        return this.ioModule.applyDelta(delta, options);
+    }
+    /**
+     * Get changes since timestamp
+     * @see REQ-YL-UPDATE-005
+     */
+    async getChangesSince(since) {
+        return this.db.getChangesSince(since);
+    }
+    /**
+     * Get graph statistics
+     */
+    async getStats() {
+        return this.db.getStats();
+    }
+}
+/**
+ * Factory function to create YataLocal instance
+ */
+export function createYataLocal(config) {
+    return new YataLocal(config);
+}
+// Re-export types
+export * from './types.js';
+export { YataDatabase } from './database.js';
+export { QueryEngine } from './query-engine.js';
+export { ReasoningEngine } from './reasoning.js';
+export { IoModule } from './io.js';
+// Auto-updater for MCP integration
+export { KnowledgeGraphUpdater, createKnowledgeGraphUpdater, } from './auto-updater.js';
+// YATA Bridge for MCP integration
+export { YataBridge, createYataBridge, } from './yata-bridge.js';
+// KGPR Module (v1.6.5 NEW!)
+export { LocalKGPRManager, createLocalKGPRManager, LocalPrivacyFilter, createLocalPrivacyFilter, LocalDiffEngine, createLocalDiffEngine, } from './kgpr/index.js';
+// Wake-Sleep Learning Module (v1.6.5 NEW!)
+export { LocalWakeSleepCycle, createLocalWakeSleepCycle, LocalWakePhase, createLocalWakePhase, LocalSleepPhase, createLocalSleepPhase, LocalPatternCompressor, createLocalPatternCompressor, DEFAULT_WAKE_SLEEP_CONFIG, } from './wake-sleep/index.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":"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"}

package/dist/io.d.ts

@@ -0,0 +1,77 @@
+/**
+ * YATA Local - Import/Export Module
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-local/io
+ *
+ * @see REQ-YL-IO-001 ~ REQ-YL-IO-004
+ */
+import type { Entity, Relationship, Delta, MergeResult } from './types.js';
+import type { YataDatabase } from './database.js';
+/**
+ * JSON export format
+ */
+export interface JsonExport {
+    version: '1.0';
+    exportedAt: string;
+    entities: Entity[];
+    relationships: Relationship[];
+}
+/**
+ * RDF export format (N-Triples)
+ */
+export interface RdfExportOptions {
+    baseUri?: string;
+    includeMetadata?: boolean;
+}
+/**
+ * Import/Export module for YATA Local
+ */
+export declare class IoModule {
+    private db;
+    constructor(db: YataDatabase);
+    /**
+     * Export graph to JSON
+     * @see REQ-YL-IO-001
+     */
+    exportToJson(filePath?: string): Promise<JsonExport>;
+    /**
+     * Import graph from JSON
+     * @see REQ-YL-IO-003
+     */
+    importFromJson(input: string | JsonExport, options?: {
+        merge?: boolean;
+        dryRun?: boolean;
+    }): Promise<MergeResult>;
+    /**
+     * Export to RDF (N-Triples format)
+     * @see REQ-YL-IO-001
+     */
+    exportToRdf(filePath?: string, options?: RdfExportOptions): Promise<string>;
+    /**
+     * Compute delta between two states
+     * @see REQ-YL-IO-004
+     */
+    computeDelta(oldState: JsonExport, newState: JsonExport): Delta;
+    /**
+     * Apply delta to current database state
+     * @see REQ-YL-IO-004
+     */
+    applyDelta(delta: Delta, options?: {
+        dryRun?: boolean;
+    }): Promise<MergeResult>;
+    /**
+     * Sync with another YATA Local instance
+     * @see REQ-YL-IO-004
+     */
+    syncWith(other: YataDatabase, since: Date): Promise<MergeResult>;
+    /**
+     * Check if entity has changed
+     */
+    private entityChanged;
+    /**
+     * Escape string for RDF N-Triples format
+     */
+    private escapeRdfString;
+}
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,KAAK,EACL,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,YAAY;IAEpC;;;OAGG;IACG,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA8B1D;;;OAGG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,GAAG,UAAU,EAC1B,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAClD,OAAO,CAAC,WAAW,CAAC;IA+EvB;;;OAGG;IACG,WAAW,CACf,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC;IAyFlB;;;OAGG;IACH,YAAY,CACV,QAAQ,EAAE,UAAU,EACpB,QAAQ,EAAE,UAAU,GACnB,KAAK;IAwDR;;;OAGG;IACG,UAAU,CACd,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GACjC,OAAO,CAAC,WAAW,CAAC;IAiEvB;;;OAGG;IACG,QAAQ,CACZ,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,IAAI,GACV,OAAO,CAAC,WAAW,CAAC;IAsEvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,eAAe;CAQxB"}