@nahisaho/yata-local 1.6.6

package/dist/kgpr/privacy-filter.js

@@ -0,0 +1,295 @@
+/**
+ * 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 { DEFAULT_LOCAL_PRIVACY_STRICT, DEFAULT_LOCAL_PRIVACY_MODERATE, DEFAULT_LOCAL_PRIVACY_NONE, } from './types.js';
+/**
+ * Privacy filter for local KGPR
+ *
+ * @example
+ * ```typescript
+ * const filter = createLocalPrivacyFilter('strict');
+ * const sanitizedDiff = filter.filterDiff(diff);
+ * ```
+ */
+export class LocalPrivacyFilter {
+    config;
+    excludeRegexes;
+    constructor(config) {
+        this.config = config;
+        this.excludeRegexes = config.excludePatterns.map((pattern) => new RegExp(pattern, 'i'));
+    }
+    /**
+     * Get the current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Filter a complete diff
+     *
+     * @param diff - The diff to filter
+     * @returns Filtered diff with sensitive data removed
+     */
+    filterDiff(diff) {
+        const filteredEntities = {
+            added: this.filterEntityChanges(diff.entities.added),
+            updated: this.filterEntityChanges(diff.entities.updated),
+            deleted: this.filterEntityChanges(diff.entities.deleted),
+        };
+        const filteredRelationships = {
+            added: this.filterRelationshipChanges(diff.relationships.added),
+            updated: this.filterRelationshipChanges(diff.relationships.updated),
+            deleted: this.filterRelationshipChanges(diff.relationships.deleted),
+        };
+        return {
+            entities: filteredEntities,
+            relationships: filteredRelationships,
+            stats: this.calculateStats(filteredEntities, filteredRelationships),
+        };
+    }
+    /**
+     * Filter entity changes
+     */
+    filterEntityChanges(changes) {
+        return changes
+            .filter((change) => this.shouldIncludeEntity(change))
+            .map((change) => this.sanitizeEntity(change));
+    }
+    /**
+     * Filter relationship changes
+     */
+    filterRelationshipChanges(changes) {
+        return changes
+            .filter((change) => this.shouldIncludeRelationship(change))
+            .map((change) => this.sanitizeRelationship(change));
+    }
+    /**
+     * Check if an entity should be included
+     */
+    shouldIncludeEntity(entity) {
+        // Check namespace exclusion
+        if (this.isNamespaceExcluded(entity.namespace)) {
+            return false;
+        }
+        // Check name pattern exclusion
+        if (this.isNameExcluded(entity.name)) {
+            return false;
+        }
+        // Check file path exclusion
+        if (entity.filePath && this.isPathExcluded(entity.filePath)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Check if a relationship should be included
+     */
+    shouldIncludeRelationship(rel) {
+        // Exclude if either endpoint is in excluded namespace
+        if (this.isNamespaceExcluded(rel.sourceNamespace) || this.isNamespaceExcluded(rel.targetNamespace)) {
+            return false;
+        }
+        // Check name pattern exclusion for both endpoints
+        if (this.isNameExcluded(rel.sourceName) || this.isNameExcluded(rel.targetName)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Sanitize an entity change
+     */
+    sanitizeEntity(entity) {
+        const sanitized = {
+            changeType: entity.changeType,
+            localId: entity.localId,
+            name: this.applyReplacements(entity.name),
+            entityType: entity.entityType,
+            namespace: this.applyReplacements(entity.namespace),
+        };
+        // Conditionally include file path
+        if (!this.config.removeFilePaths && entity.filePath) {
+            sanitized.filePath = this.sanitizePath(entity.filePath);
+        }
+        // Conditionally include line number
+        if (!this.config.removeLineNumbers && entity.line !== undefined) {
+            sanitized.line = entity.line;
+        }
+        // Conditionally include metadata
+        if (!this.config.removeMetadata && entity.metadata) {
+            sanitized.metadata = this.sanitizeMetadata(entity.metadata);
+        }
+        return sanitized;
+    }
+    /**
+     * Sanitize a relationship change
+     */
+    sanitizeRelationship(rel) {
+        const sanitized = {
+            changeType: rel.changeType,
+            sourceName: this.applyReplacements(rel.sourceName),
+            sourceNamespace: this.applyReplacements(rel.sourceNamespace),
+            targetName: this.applyReplacements(rel.targetName),
+            targetNamespace: this.applyReplacements(rel.targetNamespace),
+            relationshipType: rel.relationshipType,
+        };
+        if (rel.localId) {
+            sanitized.localId = rel.localId;
+        }
+        // Conditionally include metadata
+        if (!this.config.removeMetadata && rel.metadata) {
+            sanitized.metadata = this.sanitizeMetadata(rel.metadata);
+        }
+        return sanitized;
+    }
+    /**
+     * Check if a namespace should be excluded
+     */
+    isNamespaceExcluded(namespace) {
+        const lowerNs = namespace.toLowerCase();
+        return this.config.excludeNamespaces.some((excluded) => lowerNs.includes(excluded.toLowerCase()));
+    }
+    /**
+     * Check if a name should be excluded
+     */
+    isNameExcluded(name) {
+        return this.excludeRegexes.some((regex) => regex.test(name));
+    }
+    /**
+     * Check if a file path should be excluded
+     */
+    isPathExcluded(filePath) {
+        const lowerPath = filePath.toLowerCase();
+        return this.config.excludeNamespaces.some((excluded) => lowerPath.includes(excluded.toLowerCase()));
+    }
+    /**
+     * Sanitize a file path
+     */
+    sanitizePath(filePath) {
+        // Apply replacements to path
+        return this.applyReplacements(filePath);
+    }
+    /**
+     * Sanitize metadata object
+     */
+    sanitizeMetadata(metadata) {
+        const sanitized = {};
+        for (const [key, value] of Object.entries(metadata)) {
+            // Skip keys that match exclude patterns
+            if (this.isNameExcluded(key)) {
+                continue;
+            }
+            // Sanitize string values
+            if (typeof value === 'string') {
+                sanitized[key] = this.applyReplacements(value);
+            }
+            else if (typeof value === 'object' && value !== null) {
+                // Recursively sanitize nested objects
+                sanitized[key] = this.sanitizeMetadata(value);
+            }
+            else {
+                sanitized[key] = value;
+            }
+        }
+        return sanitized;
+    }
+    /**
+     * Apply configured string replacements
+     */
+    applyReplacements(str) {
+        let result = str;
+        for (const { pattern, replacement } of this.config.replacements) {
+            result = result.replace(new RegExp(pattern, 'gi'), replacement);
+        }
+        return result;
+    }
+    /**
+     * Calculate stats from filtered changes
+     */
+    calculateStats(entities, relationships) {
+        const entitiesAdded = entities.added.length;
+        const entitiesUpdated = entities.updated.length;
+        const entitiesDeleted = entities.deleted.length;
+        const relationshipsAdded = relationships.added.length;
+        const relationshipsUpdated = relationships.updated.length;
+        const relationshipsDeleted = relationships.deleted.length;
+        return {
+            entitiesAdded,
+            entitiesUpdated,
+            entitiesDeleted,
+            relationshipsAdded,
+            relationshipsUpdated,
+            relationshipsDeleted,
+            totalChanges: entitiesAdded +
+                entitiesUpdated +
+                entitiesDeleted +
+                relationshipsAdded +
+                relationshipsUpdated +
+                relationshipsDeleted,
+        };
+    }
+}
+/**
+ * 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 function createLocalPrivacyFilter(level, customConfig) {
+    let baseConfig;
+    switch (level) {
+        case 'strict':
+            baseConfig = { ...DEFAULT_LOCAL_PRIVACY_STRICT };
+            break;
+        case 'moderate':
+            baseConfig = { ...DEFAULT_LOCAL_PRIVACY_MODERATE };
+            break;
+        case 'none':
+            baseConfig = { ...DEFAULT_LOCAL_PRIVACY_NONE };
+            break;
+        default:
+            baseConfig = { ...DEFAULT_LOCAL_PRIVACY_MODERATE };
+    }
+    // Merge custom config if provided
+    if (customConfig) {
+        return new LocalPrivacyFilter({
+            ...baseConfig,
+            ...customConfig,
+            // Merge arrays instead of replacing
+            excludeNamespaces: [
+                ...baseConfig.excludeNamespaces,
+                ...(customConfig.excludeNamespaces || []),
+            ],
+            excludePatterns: [
+                ...baseConfig.excludePatterns,
+                ...(customConfig.excludePatterns || []),
+            ],
+            replacements: [
+                ...baseConfig.replacements,
+                ...(customConfig.replacements || []),
+            ],
+        });
+    }
+    return new LocalPrivacyFilter(baseConfig);
+}
+// Re-export default configs
+export { DEFAULT_LOCAL_PRIVACY_STRICT, DEFAULT_LOCAL_PRIVACY_MODERATE, DEFAULT_LOCAL_PRIVACY_NONE, } from './types.js';
+//# sourceMappingURL=privacy-filter.js.map

package/dist/kgpr/privacy-filter.js.map

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

package/dist/kgpr/types.d.ts

@@ -0,0 +1,234 @@
+/**
+ * YATA Local KGPR Types
+ *
+ * Type definitions for local Knowledge Graph Pull Requests
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-local/kgpr
+ *
+ * @see REQ-YL-EXT-KGPR-001
+ */
+import type { Entity, EntityType, RelationType, KGPRStatusLocal, PrivacyLevel as BasePrivacyLevel } from '../types.js';
+export type { KGPRStatusLocal, PrivacyLevel } from '../types.js';
+/**
+ * Change type
+ */
+export type ChangeType = 'add' | 'update' | 'delete';
+/**
+ * Entity change in a KGPR diff
+ */
+export interface LocalEntityChange {
+    /** Change type */
+    changeType: ChangeType;
+    /** Local entity ID */
+    localId: string;
+    /** Entity name */
+    name: string;
+    /** Entity type */
+    entityType: EntityType;
+    /** Namespace */
+    namespace: string;
+    /** File path (may be sanitized) */
+    filePath?: string;
+    /** Line number */
+    line?: number;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+    /** Previous value (for updates) */
+    previousValue?: Partial<Entity>;
+}
+/**
+ * Relationship change in a KGPR diff
+ */
+export interface LocalRelationshipChange {
+    /** Change type */
+    changeType: ChangeType;
+    /** Local relationship ID */
+    localId?: string;
+    /** Source entity name */
+    sourceName: string;
+    /** Source namespace */
+    sourceNamespace: string;
+    /** Target entity name */
+    targetName: string;
+    /** Target namespace */
+    targetNamespace: string;
+    /** Relationship type */
+    relationshipType: RelationType;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * KGPR diff - all changes
+ */
+export interface LocalKGPRDiff {
+    /** Entity changes */
+    entities: {
+        added: LocalEntityChange[];
+        updated: LocalEntityChange[];
+        deleted: LocalEntityChange[];
+    };
+    /** Relationship changes */
+    relationships: {
+        added: LocalRelationshipChange[];
+        updated: LocalRelationshipChange[];
+        deleted: LocalRelationshipChange[];
+    };
+    /** Statistics */
+    stats: LocalDiffStats;
+}
+/**
+ * Diff statistics
+ */
+export interface LocalDiffStats {
+    entitiesAdded: number;
+    entitiesUpdated: number;
+    entitiesDeleted: number;
+    relationshipsAdded: number;
+    relationshipsUpdated: number;
+    relationshipsDeleted: number;
+    totalChanges: number;
+}
+/**
+ * KGPR review from local storage
+ */
+export interface LocalKGPRReviewEntry {
+    /** Review ID */
+    id: string;
+    /** KGPR ID */
+    kgprId: string;
+    /** Reviewer ID */
+    reviewerId: string;
+    /** Review status */
+    status: 'approved' | 'changes_requested' | 'commented';
+    /** Review comment */
+    comment?: string;
+    /** Created timestamp */
+    createdAt: Date;
+}
+/**
+ * Local KGPR info (full object with parsed diff)
+ */
+export interface LocalKGPRInfo {
+    /** KGPR ID */
+    id: string;
+    /** Title */
+    title: string;
+    /** Description */
+    description: string;
+    /** Status */
+    status: KGPRStatusLocal;
+    /** Source namespace */
+    namespace: string;
+    /** Diff (parsed) */
+    diff: LocalKGPRDiff;
+    /** Privacy level used */
+    privacyLevel: BasePrivacyLevel;
+    /** Entity types included */
+    entityTypes: EntityType[];
+    /** Reviews */
+    reviews: LocalKGPRReviewEntry[];
+    /** Created timestamp */
+    createdAt: Date;
+    /** Updated timestamp */
+    updatedAt: Date;
+    /** Submitted timestamp */
+    submittedAt?: Date;
+}
+/**
+ * Options for creating a KGPR
+ */
+export interface CreateLocalKGPROptions {
+    /** Title */
+    title: string;
+    /** Description */
+    description?: string;
+    /** Author ID */
+    author?: string;
+    /** Source namespace to include (optional filter) */
+    namespace?: string;
+    /** Entity types to include (optional filter) */
+    entityTypes?: EntityType[];
+    /** Privacy level */
+    privacyLevel?: BasePrivacyLevel;
+    /** Baseline snapshot ID (for diff) */
+    baselineId?: string;
+}
+/**
+ * Options for listing KGPRs
+ */
+export interface ListLocalKGPROptions {
+    /** Filter by status */
+    status?: KGPRStatusLocal | KGPRStatusLocal[];
+    /** Filter by namespace */
+    namespace?: string;
+    /** Search in title/description */
+    search?: string;
+    /** Sort by field */
+    sortBy?: 'created' | 'updated' | 'title';
+    /** Sort order */
+    sortOrder?: 'asc' | 'desc';
+    /** Limit results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/**
+ * Privacy filter configuration
+ */
+export interface LocalPrivacyFilterConfig {
+    /** Remove file paths from output */
+    removeFilePaths: boolean;
+    /** Remove line numbers from output */
+    removeLineNumbers: boolean;
+    /** Remove metadata from output */
+    removeMetadata: boolean;
+    /** Namespace patterns to exclude */
+    excludeNamespaces: string[];
+    /** Entity name patterns to exclude (regex) */
+    excludePatterns: string[];
+    /** String replacements */
+    replacements: {
+        pattern: string;
+        replacement: string;
+    }[];
+}
+/**
+ * Default strict privacy filter
+ */
+export declare const DEFAULT_LOCAL_PRIVACY_STRICT: LocalPrivacyFilterConfig;
+/**
+ * Default moderate privacy filter
+ */
+export declare const DEFAULT_LOCAL_PRIVACY_MODERATE: LocalPrivacyFilterConfig;
+/**
+ * Default no privacy filter
+ */
+export declare const DEFAULT_LOCAL_PRIVACY_NONE: LocalPrivacyFilterConfig;
+/**
+ * Snapshot of the knowledge graph at a point in time
+ */
+export interface KGSnapshot {
+    /** Snapshot ID */
+    id: string;
+    /** Snapshot timestamp */
+    timestamp: Date;
+    /** Entity hashes (id -> hash) */
+    entityHashes: Map<string, string>;
+    /** Relationship hashes (id -> hash) */
+    relationshipHashes: Map<string, string>;
+    /** Description */
+    description?: string;
+}
+/**
+ * Diff generation options
+ */
+export interface DiffOptions {
+    /** Namespace filter */
+    namespace?: string;
+    /** Entity types filter */
+    entityTypes?: EntityType[];
+    /** Include deleted entities */
+    includeDeleted?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/kgpr/types.js

@@ -0,0 +1,54 @@
+/**
+ * YATA Local KGPR Types
+ *
+ * Type definitions for local Knowledge Graph Pull Requests
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-local/kgpr
+ *
+ * @see REQ-YL-EXT-KGPR-001
+ */
+/**
+ * Default strict privacy filter
+ */
+export const DEFAULT_LOCAL_PRIVACY_STRICT = {
+    removeFilePaths: true,
+    removeLineNumbers: true,
+    removeMetadata: true,
+    excludeNamespaces: ['internal', 'private', 'secret', 'config', 'test', '__tests__'],
+    excludePatterns: [
+        'password',
+        'secret',
+        'token',
+        'api[_-]?key',
+        'credential',
+        'auth',
+        'private',
+        '\\$_',
+        '_internal',
+    ],
+    replacements: [],
+};
+/**
+ * Default moderate privacy filter
+ */
+export const DEFAULT_LOCAL_PRIVACY_MODERATE = {
+    removeFilePaths: false,
+    removeLineNumbers: false,
+    removeMetadata: false,
+    excludeNamespaces: ['secret', 'config'],
+    excludePatterns: ['password', 'secret', 'token', 'api[_-]?key'],
+    replacements: [],
+};
+/**
+ * Default no privacy filter
+ */
+export const DEFAULT_LOCAL_PRIVACY_NONE = {
+    removeFilePaths: false,
+    removeLineNumbers: false,
+    removeMetadata: false,
+    excludeNamespaces: [],
+    excludePatterns: [],
+    replacements: [],
+};
+//# sourceMappingURL=types.js.map

package/dist/kgpr/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/kgpr/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqMH;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA6B;IACpE,eAAe,EAAE,IAAI;IACrB,iBAAiB,EAAE,IAAI;IACvB,cAAc,EAAE,IAAI;IACpB,iBAAiB,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC;IACnF,eAAe,EAAE;QACf,UAAU;QACV,QAAQ;QACR,OAAO;QACP,aAAa;QACb,YAAY;QACZ,MAAM;QACN,SAAS;QACT,MAAM;QACN,WAAW;KACZ;IACD,YAAY,EAAE,EAAE;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAA6B;IACtE,eAAe,EAAE,KAAK;IACtB,iBAAiB,EAAE,KAAK;IACxB,cAAc,EAAE,KAAK;IACrB,iBAAiB,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACvC,eAAe,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC;IAC/D,YAAY,EAAE,EAAE;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAA6B;IAClE,eAAe,EAAE,KAAK;IACtB,iBAAiB,EAAE,KAAK;IACxB,cAAc,EAAE,KAAK;IACrB,iBAAiB,EAAE,EAAE;IACrB,eAAe,EAAE,EAAE;IACnB,YAAY,EAAE,EAAE;CACjB,CAAC"}

package/dist/query-engine.d.ts

@@ -0,0 +1,78 @@
+/**
+ * YATA Local - Query Engine
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-local/query-engine
+ *
+ * @see REQ-YL-QUERY-001 ~ REQ-YL-QUERY-005
+ */
+import type { Entity, EntityType, Relationship, RelationType, GraphQuery, QueryResult, Path, Subgraph, GraphPattern, PatternMatch, QueryOptions } from './types.js';
+import type { YataDatabase } from './database.js';
+/**
+ * Query engine for traversing and querying the knowledge graph
+ */
+export declare class QueryEngine {
+    private db;
+    constructor(db: YataDatabase);
+    /**
+     * Execute graph query
+     * @see REQ-YL-QUERY-001
+     */
+    query(query: GraphQuery, options?: Partial<QueryOptions>): QueryResult;
+    /**
+     * Find shortest path between two entities
+     * @see REQ-YL-QUERY-002
+     */
+    findPath(startId: string, endId: string, options?: {
+        maxDepth?: number;
+        relationshipTypes?: RelationType[];
+        direction?: 'forward' | 'backward' | 'both';
+    }): Path | null;
+    /**
+     * Extract subgraph around entity
+     * @see REQ-YL-QUERY-003
+     */
+    extractSubgraph(rootId: string, options?: {
+        depth?: number;
+        entityTypes?: EntityType[];
+        relationshipTypes?: RelationType[];
+        direction?: 'in' | 'out' | 'both';
+    }): Subgraph;
+    /**
+     * Pattern matching on graph
+     * @see REQ-YL-QUERY-004
+     */
+    matchPattern(pattern: GraphPattern): PatternMatch[];
+    /**
+     * Recursive pattern matching helper
+     */
+    private tryMatchPattern;
+    /**
+     * Check if name matches pattern
+     */
+    private matchNamePattern;
+    /**
+     * Find entities by traversing relationships
+     */
+    traverse(startId: string, relationshipTypes: RelationType[], direction: 'forward' | 'backward', maxHops?: number): Entity[];
+    /**
+     * Get entity neighbors
+     */
+    getNeighbors(entityId: string, options?: {
+        direction?: 'in' | 'out' | 'both';
+        relationshipTypes?: RelationType[];
+        entityTypes?: EntityType[];
+    }): Array<{
+        entity: Entity;
+        relationship: Relationship;
+    }>;
+    /**
+     * Find all paths between two entities (up to limit)
+     */
+    findAllPaths(startId: string, endId: string, options?: {
+        maxDepth?: number;
+        maxPaths?: number;
+        relationshipTypes?: RelationType[];
+    }): Path[];
+}
+//# sourceMappingURL=query-engine.d.ts.map