@nahisaho/yata-local 1.6.6

package/dist/kgpr/diff-engine.js

@@ -0,0 +1,335 @@
+/**
+ * YATA Local KGPR - Diff Engine
+ *
+ * Generates diffs between knowledge graph states
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-local/kgpr
+ *
+ * @see REQ-YL-EXT-KGPR-003
+ */
+import { createHash } from 'crypto';
+/**
+ * Diff engine for generating knowledge graph diffs
+ *
+ * @example
+ * ```typescript
+ * const engine = createLocalDiffEngine();
+ *
+ * // Create baseline snapshot
+ * const baseline = engine.createSnapshot(entities, relationships, 'Initial state');
+ *
+ * // ... make changes to KG ...
+ *
+ * // Generate diff from baseline
+ * const diff = engine.generateDiff(baseline, currentEntities, currentRelationships);
+ * ```
+ */
+export class LocalDiffEngine {
+    lastSnapshotId = 0;
+    /**
+     * Create a snapshot of the current knowledge graph state
+     *
+     * @param entities - Current entities
+     * @param relationships - Current relationships
+     * @param description - Optional description
+     * @returns Snapshot object
+     */
+    createSnapshot(entities, relationships, description) {
+        const entityHashes = new Map();
+        const relationshipHashes = new Map();
+        // Hash all entities
+        for (const entity of entities) {
+            entityHashes.set(entity.id, this.hashEntity(entity));
+        }
+        // Hash all relationships
+        for (const rel of relationships) {
+            relationshipHashes.set(rel.id, this.hashRelationship(rel));
+        }
+        return {
+            id: `snapshot-${++this.lastSnapshotId}-${Date.now()}`,
+            timestamp: new Date(),
+            entityHashes,
+            relationshipHashes,
+            description,
+        };
+    }
+    /**
+     * Generate a diff between baseline snapshot and current state
+     *
+     * @param baseline - Baseline snapshot (or null for full diff)
+     * @param currentEntities - Current entities
+     * @param currentRelationships - Current relationships
+     * @param options - Diff options
+     * @returns The diff
+     */
+    generateDiff(baseline, currentEntities, currentRelationships, options) {
+        // Apply filters
+        const filteredEntities = this.filterEntities(currentEntities, options);
+        const filteredRelationships = this.filterRelationships(currentRelationships, options);
+        if (!baseline) {
+            // No baseline - everything is added
+            return this.createFullDiff(filteredEntities, filteredRelationships);
+        }
+        // Calculate entity changes
+        const entityChanges = this.calculateEntityChanges(baseline.entityHashes, filteredEntities);
+        // Calculate relationship changes
+        const relationshipChanges = this.calculateRelationshipChanges(baseline.relationshipHashes, filteredRelationships);
+        // Calculate stats
+        const stats = this.calculateStats(entityChanges, relationshipChanges);
+        return {
+            entities: entityChanges,
+            relationships: relationshipChanges,
+            stats,
+        };
+    }
+    /**
+     * Generate diff between two snapshots (without current state)
+     *
+     * @param oldSnapshot - Old snapshot
+     * @param newSnapshot - New snapshot
+     * @returns Summary diff (IDs only)
+     */
+    compareSnapshots(oldSnapshot, newSnapshot) {
+        const added = [];
+        const updated = [];
+        const deleted = [];
+        // Check entities
+        for (const [id, hash] of newSnapshot.entityHashes) {
+            const oldHash = oldSnapshot.entityHashes.get(id);
+            if (!oldHash) {
+                added.push(id);
+            }
+            else if (oldHash !== hash) {
+                updated.push(id);
+            }
+        }
+        for (const id of oldSnapshot.entityHashes.keys()) {
+            if (!newSnapshot.entityHashes.has(id)) {
+                deleted.push(id);
+            }
+        }
+        return { added, updated, deleted };
+    }
+    /**
+     * Hash an entity for comparison
+     */
+    hashEntity(entity) {
+        const data = JSON.stringify({
+            type: entity.type,
+            name: entity.name,
+            namespace: entity.namespace,
+            filePath: entity.filePath,
+            line: entity.line,
+            metadata: entity.metadata,
+        });
+        return createHash('sha256').update(data).digest('hex').substring(0, 16);
+    }
+    /**
+     * Hash a relationship for comparison
+     */
+    hashRelationship(rel) {
+        const data = JSON.stringify({
+            type: rel.type,
+            sourceId: rel.sourceId,
+            targetId: rel.targetId,
+            metadata: rel.metadata,
+        });
+        return createHash('sha256').update(data).digest('hex').substring(0, 16);
+    }
+    /**
+     * Filter entities based on options
+     */
+    filterEntities(entities, options) {
+        if (!options)
+            return entities;
+        return entities.filter((entity) => {
+            // Filter by namespace
+            if (options.namespace && !entity.namespace.startsWith(options.namespace)) {
+                return false;
+            }
+            // Filter by entity type
+            if (options.entityTypes && !options.entityTypes.includes(entity.type)) {
+                return false;
+            }
+            return true;
+        });
+    }
+    /**
+     * Filter relationships based on options
+     */
+    filterRelationships(relationships, options) {
+        if (!options)
+            return relationships;
+        // For relationships, we can't easily filter by namespace without entity info
+        // This would require the caller to provide filtered entity IDs
+        return relationships;
+    }
+    /**
+     * Create a full diff (all entities/relationships as added)
+     */
+    createFullDiff(entities, relationships) {
+        const entityChanges = entities.map((e) => this.entityToChange(e, 'add'));
+        const relationshipChanges = relationships.map((r) => this.relationshipToChange(r, 'add'));
+        return {
+            entities: {
+                added: entityChanges,
+                updated: [],
+                deleted: [],
+            },
+            relationships: {
+                added: relationshipChanges,
+                updated: [],
+                deleted: [],
+            },
+            stats: {
+                entitiesAdded: entityChanges.length,
+                entitiesUpdated: 0,
+                entitiesDeleted: 0,
+                relationshipsAdded: relationshipChanges.length,
+                relationshipsUpdated: 0,
+                relationshipsDeleted: 0,
+                totalChanges: entityChanges.length + relationshipChanges.length,
+            },
+        };
+    }
+    /**
+     * Calculate entity changes between baseline and current
+     */
+    calculateEntityChanges(baselineHashes, currentEntities) {
+        const added = [];
+        const updated = [];
+        const deleted = [];
+        const currentMap = new Map();
+        for (const entity of currentEntities) {
+            currentMap.set(entity.id, entity);
+        }
+        // Find added and updated
+        for (const entity of currentEntities) {
+            const baselineHash = baselineHashes.get(entity.id);
+            const currentHash = this.hashEntity(entity);
+            if (!baselineHash) {
+                // New entity
+                added.push(this.entityToChange(entity, 'add'));
+            }
+            else if (baselineHash !== currentHash) {
+                // Updated entity
+                updated.push(this.entityToChange(entity, 'update'));
+            }
+        }
+        // Find deleted (in baseline but not in current)
+        for (const id of baselineHashes.keys()) {
+            if (!currentMap.has(id)) {
+                // Deleted - we don't have the entity data, just the ID
+                deleted.push({
+                    changeType: 'delete',
+                    localId: id,
+                    name: `[deleted:${id}]`,
+                    entityType: 'unknown',
+                    namespace: 'unknown',
+                });
+            }
+        }
+        return { added, updated, deleted };
+    }
+    /**
+     * Calculate relationship changes between baseline and current
+     */
+    calculateRelationshipChanges(baselineHashes, currentRelationships) {
+        const added = [];
+        const updated = [];
+        const deleted = [];
+        const currentMap = new Map();
+        for (const rel of currentRelationships) {
+            currentMap.set(rel.id, rel);
+        }
+        // Find added and updated
+        for (const rel of currentRelationships) {
+            const baselineHash = baselineHashes.get(rel.id);
+            const currentHash = this.hashRelationship(rel);
+            if (!baselineHash) {
+                // New relationship
+                added.push(this.relationshipToChange(rel, 'add'));
+            }
+            else if (baselineHash !== currentHash) {
+                // Updated relationship
+                updated.push(this.relationshipToChange(rel, 'update'));
+            }
+        }
+        // Find deleted
+        for (const id of baselineHashes.keys()) {
+            if (!currentMap.has(id)) {
+                deleted.push({
+                    changeType: 'delete',
+                    localId: id,
+                    sourceName: `[deleted:${id}]`,
+                    sourceNamespace: 'unknown',
+                    targetName: 'unknown',
+                    targetNamespace: 'unknown',
+                    relationshipType: 'unknown',
+                });
+            }
+        }
+        return { added, updated, deleted };
+    }
+    /**
+     * Convert entity to change format
+     */
+    entityToChange(entity, changeType) {
+        return {
+            changeType,
+            localId: entity.id,
+            name: entity.name,
+            entityType: entity.type,
+            namespace: entity.namespace,
+            filePath: entity.filePath,
+            line: entity.line,
+            metadata: entity.metadata,
+        };
+    }
+    /**
+     * Convert relationship to change format
+     * Note: This requires entity lookup for names - simplified version uses IDs
+     */
+    relationshipToChange(rel, changeType) {
+        return {
+            changeType,
+            localId: rel.id,
+            // Note: In a full implementation, we'd look up entity names
+            sourceName: rel.sourceId,
+            sourceNamespace: 'unknown', // Would need entity lookup
+            targetName: rel.targetId,
+            targetNamespace: 'unknown', // Would need entity lookup
+            relationshipType: rel.type,
+            metadata: rel.metadata,
+        };
+    }
+    /**
+     * Calculate diff statistics
+     */
+    calculateStats(entityChanges, relationshipChanges) {
+        return {
+            entitiesAdded: entityChanges.added.length,
+            entitiesUpdated: entityChanges.updated.length,
+            entitiesDeleted: entityChanges.deleted.length,
+            relationshipsAdded: relationshipChanges.added.length,
+            relationshipsUpdated: relationshipChanges.updated.length,
+            relationshipsDeleted: relationshipChanges.deleted.length,
+            totalChanges: entityChanges.added.length +
+                entityChanges.updated.length +
+                entityChanges.deleted.length +
+                relationshipChanges.added.length +
+                relationshipChanges.updated.length +
+                relationshipChanges.deleted.length,
+        };
+    }
+}
+/**
+ * Create a new diff engine instance
+ *
+ * @returns New diff engine
+ */
+export function createLocalDiffEngine() {
+    return new LocalDiffEngine();
+}
+//# sourceMappingURL=diff-engine.js.map

package/dist/kgpr/diff-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-engine.js","sourceRoot":"","sources":["../../src/kgpr/diff-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAYpC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,eAAe;IAClB,cAAc,GAAG,CAAC,CAAC;IAE3B;;;;;;;OAOG;IACH,cAAc,CACZ,QAAkB,EAClB,aAA6B,EAC7B,WAAoB;QAEpB,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC/C,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAkB,CAAC;QAErD,oBAAoB;QACpB,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC9B,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,yBAAyB;QACzB,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO;YACL,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;YACrD,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,YAAY;YACZ,kBAAkB;YAClB,WAAW;SACZ,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CACV,QAA2B,EAC3B,eAAyB,EACzB,oBAAoC,EACpC,OAAqB;QAErB,gBAAgB;QAChB,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACvE,MAAM,qBAAqB,GAAG,IAAI,CAAC,mBAAmB,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;QAEtF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,oCAAoC;YACpC,OAAO,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,CAAC;QACtE,CAAC;QAED,2BAA2B;QAC3B,MAAM,aAAa,GAAG,IAAI,CAAC,sBAAsB,CAC/C,QAAQ,CAAC,YAAY,EACrB,gBAAgB,CACjB,CAAC;QAEF,iCAAiC;QACjC,MAAM,mBAAmB,GAAG,IAAI,CAAC,4BAA4B,CAC3D,QAAQ,CAAC,kBAAkB,EAC3B,qBAAqB,CACtB,CAAC;QAEF,kBAAkB;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;QAEtE,OAAO;YACL,QAAQ,EAAE,aAAa;YACvB,aAAa,EAAE,mBAAmB;YAClC,KAAK;SACN,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,gBAAgB,CACd,WAAuB,EACvB,WAAuB;QAEvB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,iBAAiB;QACjB,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,WAAW,CAAC,YAAY,EAAE,CAAC;YAClD,MAAM,OAAO,GAAG,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;iBAAM,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAED,KAAK,MAAM,EAAE,IAAI,WAAW,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;YACjD,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACtC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,MAAc;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,GAAiB;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,QAAkB,EAAE,OAAqB;QAC9D,IAAI,CAAC,OAAO;YAAE,OAAO,QAAQ,CAAC;QAE9B,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;YAChC,sBAAsB;YACtB,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzE,OAAO,KAAK,CAAC;YACf,CAAC;YAED,wBAAwB;YACxB,IAAI,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtE,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,mBAAmB,CACzB,aAA6B,EAC7B,OAAqB;QAErB,IAAI,CAAC,OAAO;YAAE,OAAO,aAAa,CAAC;QAEnC,6EAA6E;QAC7E,+DAA+D;QAC/D,OAAO,aAAa,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,cAAc,CACpB,QAAkB,EAClB,aAA6B;QAE7B,MAAM,aAAa,GAAwB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5D,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,CAC9B,CAAC;QACF,MAAM,mBAAmB,GAA8B,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC7E,IAAI,CAAC,oBAAoB,CAAC,CAAC,EAAE,KAAK,CAAC,CACpC,CAAC;QAEF,OAAO;YACL,QAAQ,EAAE;gBACR,KAAK,EAAE,aAAa;gBACpB,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,EAAE;aACZ;YACD,aAAa,EAAE;gBACb,KAAK,EAAE,mBAAmB;gBAC1B,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,EAAE;aACZ;YACD,KAAK,EAAE;gBACL,aAAa,EAAE,aAAa,CAAC,MAAM;gBACnC,eAAe,EAAE,CAAC;gBAClB,eAAe,EAAE,CAAC;gBAClB,kBAAkB,EAAE,mBAAmB,CAAC,MAAM;gBAC9C,oBAAoB,EAAE,CAAC;gBACvB,oBAAoB,EAAE,CAAC;gBACvB,YAAY,EAAE,aAAa,CAAC,MAAM,GAAG,mBAAmB,CAAC,MAAM;aAChE;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,sBAAsB,CAC5B,cAAmC,EACnC,eAAyB;QAEzB,MAAM,KAAK,GAAwB,EAAE,CAAC;QACtC,MAAM,OAAO,GAAwB,EAAE,CAAC;QACxC,MAAM,OAAO,GAAwB,EAAE,CAAC;QAExC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC7C,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;YACrC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,yBAAyB;QACzB,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;YACrC,MAAM,YAAY,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAE5C,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,aAAa;gBACb,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;YACjD,CAAC;iBAAM,IAAI,YAAY,KAAK,WAAW,EAAE,CAAC;gBACxC,iBAAiB;gBACjB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,gDAAgD;QAChD,KAAK,MAAM,EAAE,IAAI,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACxB,uDAAuD;gBACvD,OAAO,CAAC,IAAI,CAAC;oBACX,UAAU,EAAE,QAAQ;oBACpB,OAAO,EAAE,EAAE;oBACX,IAAI,EAAE,YAAY,EAAE,GAAG;oBACvB,UAAU,EAAE,SAAuB;oBACnC,SAAS,EAAE,SAAS;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACK,4BAA4B,CAClC,cAAmC,EACnC,oBAAoC;QAEpC,MAAM,KAAK,GAA8B,EAAE,CAAC;QAC5C,MAAM,OAAO,GAA8B,EAAE,CAAC;QAC9C,MAAM,OAAO,GAA8B,EAAE,CAAC;QAE9C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAwB,CAAC;QACnD,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;YACvC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC9B,CAAC;QAED,yBAAyB;QACzB,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;YACvC,MAAM,YAAY,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChD,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAE/C,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,mBAAmB;gBACnB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;YACpD,CAAC;iBAAM,IAAI,YAAY,KAAK,WAAW,EAAE,CAAC;gBACxC,uBAAuB;gBACvB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,eAAe;QACf,KAAK,MAAM,EAAE,IAAI,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC;oBACX,UAAU,EAAE,QAAQ;oBACpB,OAAO,EAAE,EAAE;oBACX,UAAU,EAAE,YAAY,EAAE,GAAG;oBAC7B,eAAe,EAAE,SAAS;oBAC1B,UAAU,EAAE,SAAS;oBACrB,eAAe,EAAE,SAAS;oBAC1B,gBAAgB,EAAE,SAAyB;iBAC5C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,MAAc,EAAE,UAAsB;QAC3D,OAAO;YACL,UAAU;YACV,OAAO,EAAE,MAAM,CAAC,EAAE;YAClB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,MAAM,CAAC,IAAI;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAA+C;SACjE,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,oBAAoB,CAC1B,GAAiB,EACjB,UAAsB;QAEtB,OAAO;YACL,UAAU;YACV,OAAO,EAAE,GAAG,CAAC,EAAE;YACf,4DAA4D;YAC5D,UAAU,EAAE,GAAG,CAAC,QAAQ;YACxB,eAAe,EAAE,SAAS,EAAE,2BAA2B;YACvD,UAAU,EAAE,GAAG,CAAC,QAAQ;YACxB,eAAe,EAAE,SAAS,EAAE,2BAA2B;YACvD,gBAAgB,EAAE,GAAG,CAAC,IAAI;YAC1B,QAAQ,EAAE,GAAG,CAAC,QAA+C;SAC9D,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,cAAc,CACpB,aAAwC,EACxC,mBAAmD;QAEnD,OAAO;YACL,aAAa,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM;YACzC,eAAe,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM;YAC7C,eAAe,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM;YAC7C,kBAAkB,EAAE,mBAAmB,CAAC,KAAK,CAAC,MAAM;YACpD,oBAAoB,EAAE,mBAAmB,CAAC,OAAO,CAAC,MAAM;YACxD,oBAAoB,EAAE,mBAAmB,CAAC,OAAO,CAAC,MAAM;YACxD,YAAY,EACV,aAAa,CAAC,KAAK,CAAC,MAAM;gBAC1B,aAAa,CAAC,OAAO,CAAC,MAAM;gBAC5B,aAAa,CAAC,OAAO,CAAC,MAAM;gBAC5B,mBAAmB,CAAC,KAAK,CAAC,MAAM;gBAChC,mBAAmB,CAAC,OAAO,CAAC,MAAM;gBAClC,mBAAmB,CAAC,OAAO,CAAC,MAAM;SACrC,CAAC;IACJ,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC"}

package/dist/kgpr/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * YATA Local KGPR Module - Knowledge Graph Pull Request for Local KG
+ *
+ * Provides Privacy-aware KGPR creation from local knowledge graphs
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-local/kgpr
+ *
+ * @see REQ-YL-EXT-KGPR-001
+ */
+export { LocalKGPRManager, createLocalKGPRManager } from './kgpr-manager.js';
+export { LocalPrivacyFilter, createLocalPrivacyFilter } from './privacy-filter.js';
+export { LocalDiffEngine, createLocalDiffEngine } from './diff-engine.js';
+export type { LocalKGPRInfo, LocalKGPRDiff, LocalKGPRReviewEntry, LocalEntityChange, LocalRelationshipChange, LocalDiffStats, CreateLocalKGPROptions, ListLocalKGPROptions, LocalPrivacyFilterConfig, KGSnapshot, DiffOptions, ChangeType, } from './types.js';
+export type { KGPRStatusLocal, PrivacyLevel } from '../types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/kgpr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kgpr/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,YAAY,EACV,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,UAAU,EACV,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/kgpr/index.js

@@ -0,0 +1,14 @@
+/**
+ * YATA Local KGPR Module - Knowledge Graph Pull Request for Local KG
+ *
+ * Provides Privacy-aware KGPR creation from local knowledge graphs
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-local/kgpr
+ *
+ * @see REQ-YL-EXT-KGPR-001
+ */
+export { LocalKGPRManager, createLocalKGPRManager } from './kgpr-manager.js';
+export { LocalPrivacyFilter, createLocalPrivacyFilter } from './privacy-filter.js';
+export { LocalDiffEngine, createLocalDiffEngine } from './diff-engine.js';
+//# sourceMappingURL=index.js.map

package/dist/kgpr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/kgpr/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/kgpr/kgpr-manager.d.ts

@@ -0,0 +1,122 @@
+/**
+ * YATA Local KGPR Manager
+ *
+ * Manages Knowledge Graph Pull Requests in local storage
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-local/kgpr
+ *
+ * @see REQ-YL-EXT-KGPR-001
+ */
+import type { KGPRStatusLocal } from '../types.js';
+import type { YataDatabase } from '../database.js';
+import type { LocalKGPRInfo, LocalKGPRDiff, LocalKGPRReviewEntry, CreateLocalKGPROptions, ListLocalKGPROptions } from './types.js';
+/**
+ * KGPR Manager for local knowledge graphs
+ *
+ * @example
+ * ```typescript
+ * const manager = createLocalKGPRManager(db);
+ *
+ * // Create a KGPR
+ * const kgpr = await manager.createKGPR({
+ *   title: 'Add UserService patterns',
+ *   description: 'Learned patterns from user authentication flow',
+ *   namespace: 'app.services',
+ *   privacyLevel: 'strict',
+ * });
+ *
+ * // Preview diff
+ * const diff = await manager.previewDiff(kgpr.id);
+ *
+ * // Submit for review
+ * await manager.submitKGPR(kgpr.id);
+ * ```
+ */
+export declare class LocalKGPRManager {
+    private db;
+    private diffEngine;
+    private snapshots;
+    constructor(db: YataDatabase);
+    /**
+     * Create a new KGPR
+     *
+     * @param options - Creation options
+     * @returns Created KGPR info
+     */
+    createKGPR(options: CreateLocalKGPROptions): Promise<LocalKGPRInfo>;
+    /**
+     * Get a KGPR by ID
+     *
+     * @param id - KGPR ID
+     * @returns KGPR info or null if not found
+     */
+    getKGPR(id: string): Promise<LocalKGPRInfo | null>;
+    /**
+     * List KGPRs with filtering
+     *
+     * @param options - List options
+     * @returns Array of KGPRs
+     */
+    listKGPRs(options?: ListLocalKGPROptions): Promise<LocalKGPRInfo[]>;
+    /**
+     * Preview diff for a KGPR (recalculate current state)
+     *
+     * @param id - KGPR ID
+     * @returns Current diff
+     */
+    previewDiff(id: string): Promise<LocalKGPRDiff | null>;
+    /**
+     * Update KGPR status
+     *
+     * @param id - KGPR ID
+     * @param status - New status
+     */
+    updateStatus(id: string, status: KGPRStatusLocal): Promise<void>;
+    /**
+     * Submit a KGPR for review
+     *
+     * @param id - KGPR ID
+     */
+    submitKGPR(id: string): Promise<void>;
+    /**
+     * Add a review to a KGPR
+     *
+     * @param kgprId - KGPR ID
+     * @param review - Review data
+     */
+    addReview(kgprId: string, review: Omit<LocalKGPRReviewEntry, 'id' | 'kgprId' | 'createdAt'>): Promise<LocalKGPRReviewEntry>;
+    /**
+     * Close a KGPR
+     *
+     * @param id - KGPR ID
+     */
+    closeKGPR(id: string): Promise<void>;
+    /**
+     * Create a snapshot of current KG state
+     *
+     * @param description - Snapshot description
+     * @returns Snapshot ID
+     */
+    createSnapshot(description?: string): Promise<string>;
+    /**
+     * Convert DB KGPR to LocalKGPRInfo
+     */
+    private dbKGPRToInfo;
+    /**
+     * Get entities from the database
+     */
+    private getEntities;
+    /**
+     * Get relationships from the database
+     */
+    private getRelationships;
+}
+/**
+ * Create a new KGPR manager
+ *
+ * @param db - YataDatabase instance
+ * @returns New KGPR manager
+ */
+export declare function createLocalKGPRManager(db: YataDatabase): LocalKGPRManager;
+//# sourceMappingURL=kgpr-manager.d.ts.map

package/dist/kgpr/kgpr-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kgpr-manager.d.ts","sourceRoot":"","sources":["../../src/kgpr/kgpr-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAoC,eAAe,EAA2B,MAAM,aAAa,CAAC;AAC9G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAAe;IACzB,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,SAAS,CAAsC;gBAE3C,EAAE,EAAE,YAAY;IAK5B;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC;IAoDzE;;;;;OAKG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IASxD;;;;;OAKG;IACG,SAAS,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA8CzE;;;;;OAKG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAsB5D;;;;;OAKG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;;;;OAIG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3C;;;;;OAKG;IACG,SAAS,CACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,QAAQ,GAAG,WAAW,CAAC,GAChE,OAAO,CAAC,oBAAoB,CAAC;IAkChC;;;;OAIG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1C;;;;;OAKG;IACG,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc3D;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;YACW,WAAW;IA8CzB;;OAEG;YACW,gBAAgB;CAwB/B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,YAAY,GAAG,gBAAgB,CAEzE"}