@nahisaho/yata-local 1.6.6

package/dist/kgpr/kgpr-manager.js

@@ -0,0 +1,344 @@
+/**
+ * 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 { randomUUID } from 'crypto';
+import { createLocalDiffEngine } from './diff-engine.js';
+import { createLocalPrivacyFilter } from './privacy-filter.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 class LocalKGPRManager {
+    db;
+    diffEngine;
+    snapshots = new Map();
+    constructor(db) {
+        this.db = db;
+        this.diffEngine = createLocalDiffEngine();
+    }
+    /**
+     * Create a new KGPR
+     *
+     * @param options - Creation options
+     * @returns Created KGPR info
+     */
+    async createKGPR(options) {
+        const id = `KGPR-${Date.now()}-${randomUUID().substring(0, 8)}`;
+        const now = new Date();
+        // Get current entities and relationships
+        const entities = await this.getEntities(options.namespace, options.entityTypes);
+        const relationships = await this.getRelationships();
+        // Generate diff from baseline (if provided) or full diff
+        const baseline = options.baselineId ? this.snapshots.get(options.baselineId) ?? null : null;
+        let diff = this.diffEngine.generateDiff(baseline, entities, relationships, {
+            namespace: options.namespace,
+            entityTypes: options.entityTypes,
+        });
+        // Apply privacy filter
+        const privacyLevel = options.privacyLevel || 'moderate';
+        const privacyFilter = createLocalPrivacyFilter(privacyLevel);
+        diff = privacyFilter.filterDiff(diff);
+        const kgprInfo = {
+            id,
+            title: options.title,
+            description: options.description || '',
+            status: 'draft',
+            namespace: options.namespace || '*',
+            diff,
+            privacyLevel,
+            entityTypes: options.entityTypes || [],
+            reviews: [],
+            createdAt: now,
+            updatedAt: now,
+        };
+        // Save to database
+        this.db.insertKGPR({
+            id: kgprInfo.id,
+            title: kgprInfo.title,
+            description: kgprInfo.description,
+            status: kgprInfo.status,
+            author: options.author || 'local',
+            namespace: kgprInfo.namespace,
+            diffJson: JSON.stringify(kgprInfo.diff),
+            privacyLevel: kgprInfo.privacyLevel,
+            entityTypesJson: JSON.stringify(kgprInfo.entityTypes),
+            createdAt: kgprInfo.createdAt.toISOString(),
+            updatedAt: kgprInfo.updatedAt.toISOString(),
+        });
+        return kgprInfo;
+    }
+    /**
+     * Get a KGPR by ID
+     *
+     * @param id - KGPR ID
+     * @returns KGPR info or null if not found
+     */
+    async getKGPR(id) {
+        const kgpr = this.db.getKGPR(id);
+        if (!kgpr)
+            return null;
+        const reviews = this.db.getKGPRReviews(id);
+        return this.dbKGPRToInfo(kgpr, reviews);
+    }
+    /**
+     * List KGPRs with filtering
+     *
+     * @param options - List options
+     * @returns Array of KGPRs
+     */
+    async listKGPRs(options) {
+        const kgprs = this.db.listKGPRs({
+            status: Array.isArray(options?.status) ? options?.status[0] : options?.status,
+            namespace: options?.namespace,
+            limit: options?.limit,
+            offset: options?.offset,
+        });
+        // Convert to LocalKGPRInfo format
+        const results = [];
+        for (const kgpr of kgprs) {
+            const reviews = this.db.getKGPRReviews(kgpr.id);
+            results.push(this.dbKGPRToInfo(kgpr, reviews));
+        }
+        // Apply search filter if provided
+        let filtered = results;
+        if (options?.search) {
+            const searchLower = options.search.toLowerCase();
+            filtered = results.filter((k) => k.title.toLowerCase().includes(searchLower) ||
+                k.description.toLowerCase().includes(searchLower));
+        }
+        // Sort
+        if (options?.sortBy) {
+            const sortOrder = options.sortOrder === 'desc' ? -1 : 1;
+            filtered.sort((a, b) => {
+                switch (options.sortBy) {
+                    case 'created':
+                        return (a.createdAt.getTime() - b.createdAt.getTime()) * sortOrder;
+                    case 'updated':
+                        return (a.updatedAt.getTime() - b.updatedAt.getTime()) * sortOrder;
+                    case 'title':
+                        return a.title.localeCompare(b.title) * sortOrder;
+                    default:
+                        return 0;
+                }
+            });
+        }
+        return filtered;
+    }
+    /**
+     * Preview diff for a KGPR (recalculate current state)
+     *
+     * @param id - KGPR ID
+     * @returns Current diff
+     */
+    async previewDiff(id) {
+        const kgpr = await this.getKGPR(id);
+        if (!kgpr)
+            return null;
+        // Get current state
+        const entities = await this.getEntities(kgpr.namespace !== '*' ? kgpr.namespace : undefined, kgpr.entityTypes.length > 0 ? kgpr.entityTypes : undefined);
+        const relationships = await this.getRelationships();
+        // Generate fresh diff
+        const diff = this.diffEngine.generateDiff(null, entities, relationships, {
+            namespace: kgpr.namespace !== '*' ? kgpr.namespace : undefined,
+            entityTypes: kgpr.entityTypes.length > 0 ? kgpr.entityTypes : undefined,
+        });
+        // Apply privacy filter
+        const privacyFilter = createLocalPrivacyFilter(kgpr.privacyLevel);
+        return privacyFilter.filterDiff(diff);
+    }
+    /**
+     * Update KGPR status
+     *
+     * @param id - KGPR ID
+     * @param status - New status
+     */
+    async updateStatus(id, status) {
+        this.db.updateKGPRStatus(id, status);
+    }
+    /**
+     * Submit a KGPR for review
+     *
+     * @param id - KGPR ID
+     */
+    async submitKGPR(id) {
+        const kgpr = await this.getKGPR(id);
+        if (!kgpr) {
+            throw new Error(`KGPR not found: ${id}`);
+        }
+        if (kgpr.status !== 'draft') {
+            throw new Error(`Cannot submit KGPR in status: ${kgpr.status}`);
+        }
+        this.db.updateKGPRStatus(id, 'open');
+    }
+    /**
+     * Add a review to a KGPR
+     *
+     * @param kgprId - KGPR ID
+     * @param review - Review data
+     */
+    async addReview(kgprId, review) {
+        const kgpr = await this.getKGPR(kgprId);
+        if (!kgpr) {
+            throw new Error(`KGPR not found: ${kgprId}`);
+        }
+        const reviewEntry = {
+            id: `REV-${Date.now()}-${randomUUID().substring(0, 8)}`,
+            kgprId,
+            reviewerId: review.reviewerId,
+            status: review.status,
+            comment: review.comment,
+            createdAt: new Date(),
+        };
+        this.db.insertKGPRReview({
+            id: reviewEntry.id,
+            kgprId: reviewEntry.kgprId,
+            reviewer: reviewEntry.reviewerId,
+            action: reviewEntry.status,
+            comment: reviewEntry.comment ?? null,
+            createdAt: reviewEntry.createdAt.toISOString(),
+        });
+        // Update KGPR status based on review
+        if (review.status === 'approved') {
+            this.db.updateKGPRStatus(kgprId, 'approved');
+        }
+        else if (review.status === 'changes_requested') {
+            this.db.updateKGPRStatus(kgprId, 'changes_requested');
+        }
+        return reviewEntry;
+    }
+    /**
+     * Close a KGPR
+     *
+     * @param id - KGPR ID
+     */
+    async closeKGPR(id) {
+        const kgpr = await this.getKGPR(id);
+        if (!kgpr) {
+            throw new Error(`KGPR not found: ${id}`);
+        }
+        this.db.updateKGPRStatus(id, 'merged');
+    }
+    /**
+     * Create a snapshot of current KG state
+     *
+     * @param description - Snapshot description
+     * @returns Snapshot ID
+     */
+    async createSnapshot(description) {
+        const entities = await this.getEntities();
+        const relationships = await this.getRelationships();
+        const snapshot = this.diffEngine.createSnapshot(entities, relationships, description);
+        this.snapshots.set(snapshot.id, snapshot);
+        return snapshot.id;
+    }
+    /**
+     * Convert DB KGPR to LocalKGPRInfo
+     */
+    dbKGPRToInfo(kgpr, reviews) {
+        return {
+            id: kgpr.id,
+            title: kgpr.title,
+            description: kgpr.description || '',
+            status: kgpr.status,
+            namespace: kgpr.namespace,
+            diff: JSON.parse(kgpr.diffJson),
+            privacyLevel: kgpr.privacyLevel,
+            entityTypes: kgpr.entityTypesJson ? JSON.parse(kgpr.entityTypesJson) : [],
+            reviews: reviews.map(r => ({
+                id: r.id,
+                kgprId: r.kgprId,
+                reviewerId: r.reviewer,
+                status: r.action === 'approve' ? 'approved' : r.action,
+                comment: r.comment,
+                createdAt: r.createdAt,
+            })),
+            createdAt: kgpr.createdAt,
+            updatedAt: kgpr.updatedAt,
+            submittedAt: kgpr.submittedAt,
+        };
+    }
+    /**
+     * Get entities from the database
+     */
+    async getEntities(namespace, entityTypes) {
+        // Use query engine to get entities
+        const db = this.db.getDb();
+        if (!db)
+            return [];
+        let query = 'SELECT * FROM entities WHERE 1=1';
+        const params = [];
+        if (namespace) {
+            query += ' AND namespace LIKE ?';
+            params.push(`${namespace}%`);
+        }
+        if (entityTypes && entityTypes.length > 0) {
+            query += ` AND type IN (${entityTypes.map(() => '?').join(',')})`;
+            params.push(...entityTypes);
+        }
+        const rows = db.prepare(query).all(...params);
+        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,
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+            createdAt: new Date(row.created_at),
+            updatedAt: new Date(row.updated_at),
+        }));
+    }
+    /**
+     * Get relationships from the database
+     */
+    async getRelationships() {
+        const db = this.db.getDb();
+        if (!db)
+            return [];
+        const rows = db.prepare('SELECT * FROM relationships').all();
+        return rows.map((row) => ({
+            id: row.id,
+            type: row.type,
+            sourceId: row.source_id,
+            targetId: row.target_id,
+            weight: row.weight,
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+            createdAt: new Date(row.created_at),
+        }));
+    }
+}
+/**
+ * Create a new KGPR manager
+ *
+ * @param db - YataDatabase instance
+ * @returns New KGPR manager
+ */
+export function createLocalKGPRManager(db) {
+    return new LocalKGPRManager(db);
+}
+//# sourceMappingURL=kgpr-manager.js.map

package/dist/kgpr/kgpr-manager.js.map

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

package/dist/kgpr/privacy-filter.d.ts

@@ -0,0 +1,109 @@
+/**
+ * YATA Local KGPR - Privacy Filter
+ *
+ * Removes sensitive information before sharing local knowledge graphs
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-local/kgpr
+ *
+ * @see REQ-YL-EXT-KGPR-002
+ */
+import type { LocalEntityChange, LocalRelationshipChange, LocalKGPRDiff, LocalPrivacyFilterConfig, PrivacyLevel } from './types.js';
+/**
+ * Privacy filter for local KGPR
+ *
+ * @example
+ * ```typescript
+ * const filter = createLocalPrivacyFilter('strict');
+ * const sanitizedDiff = filter.filterDiff(diff);
+ * ```
+ */
+export declare class LocalPrivacyFilter {
+    private config;
+    private excludeRegexes;
+    constructor(config: LocalPrivacyFilterConfig);
+    /**
+     * Get the current configuration
+     */
+    getConfig(): LocalPrivacyFilterConfig;
+    /**
+     * Filter a complete diff
+     *
+     * @param diff - The diff to filter
+     * @returns Filtered diff with sensitive data removed
+     */
+    filterDiff(diff: LocalKGPRDiff): LocalKGPRDiff;
+    /**
+     * Filter entity changes
+     */
+    filterEntityChanges(changes: LocalEntityChange[]): LocalEntityChange[];
+    /**
+     * Filter relationship changes
+     */
+    filterRelationshipChanges(changes: LocalRelationshipChange[]): LocalRelationshipChange[];
+    /**
+     * Check if an entity should be included
+     */
+    shouldIncludeEntity(entity: LocalEntityChange): boolean;
+    /**
+     * Check if a relationship should be included
+     */
+    shouldIncludeRelationship(rel: LocalRelationshipChange): boolean;
+    /**
+     * Sanitize an entity change
+     */
+    private sanitizeEntity;
+    /**
+     * Sanitize a relationship change
+     */
+    private sanitizeRelationship;
+    /**
+     * Check if a namespace should be excluded
+     */
+    private isNamespaceExcluded;
+    /**
+     * Check if a name should be excluded
+     */
+    private isNameExcluded;
+    /**
+     * Check if a file path should be excluded
+     */
+    private isPathExcluded;
+    /**
+     * Sanitize a file path
+     */
+    private sanitizePath;
+    /**
+     * Sanitize metadata object
+     */
+    private sanitizeMetadata;
+    /**
+     * Apply configured string replacements
+     */
+    private applyReplacements;
+    /**
+     * Calculate stats from filtered changes
+     */
+    private calculateStats;
+}
+/**
+ * Create a privacy filter with a preset level
+ *
+ * @param level - Privacy level preset
+ * @param customConfig - Custom configuration to merge with preset
+ * @returns Configured privacy filter
+ *
+ * @example
+ * ```typescript
+ * // Use strict preset
+ * const strictFilter = createLocalPrivacyFilter('strict');
+ *
+ * // Use moderate with custom exclusions
+ * const customFilter = createLocalPrivacyFilter('moderate', {
+ *   excludePatterns: [...DEFAULT_LOCAL_PRIVACY_MODERATE.excludePatterns, 'my_secret'],
+ * });
+ * ```
+ */
+export declare function createLocalPrivacyFilter(level: PrivacyLevel, customConfig?: Partial<LocalPrivacyFilterConfig>): LocalPrivacyFilter;
+export { DEFAULT_LOCAL_PRIVACY_STRICT, DEFAULT_LOCAL_PRIVACY_MODERATE, DEFAULT_LOCAL_PRIVACY_NONE, } from './types.js';
+//# sourceMappingURL=privacy-filter.d.ts.map

package/dist/kgpr/privacy-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-filter.d.ts","sourceRoot":"","sources":["../../src/kgpr/privacy-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,wBAAwB,EAExB,YAAY,EACb,MAAM,YAAY,CAAC;AAOpB;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,cAAc,CAAW;gBAErB,MAAM,EAAE,wBAAwB;IAO5C;;OAEG;IACH,SAAS,IAAI,wBAAwB;IAIrC;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,aAAa;IAoB9C;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE;IAMtE;;OAEG;IACH,yBAAyB,CAAC,OAAO,EAAE,uBAAuB,EAAE,GAAG,uBAAuB,EAAE;IAMxF;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO;IAmBvD;;OAEG;IACH,yBAAyB,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO;IAchE;;OAEG;IACH,OAAO,CAAC,cAAc;IA2BtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsB5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,cAAc;CA2BvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,YAAY,EACnB,YAAY,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAC/C,kBAAkB,CAuCpB;AAGD,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,YAAY,CAAC"}