@nahisaho/yata-global 1.6.6

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

@@ -0,0 +1,61 @@
+/**
+ * Knowledge Graph Pull Request (KGPR) - Privacy Filter
+ *
+ * Removes sensitive information before sharing
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-global/kgpr
+ *
+ * @see REQ-KGPR-002
+ */
+import type { KGPRDiff, PrivacyFilterConfig } from './types.js';
+export { DEFAULT_PRIVACY_FILTER_STRICT, DEFAULT_PRIVACY_FILTER_MODERATE, } from './types.js';
+/**
+ * Privacy filter for KGPR
+ */
+export declare class PrivacyFilter {
+    private config;
+    private excludeRegexes;
+    constructor(config: PrivacyFilterConfig);
+    /**
+     * Filter a complete diff
+     */
+    filterDiff(diff: KGPRDiff): KGPRDiff;
+    /**
+     * Filter entity changes
+     */
+    private filterEntityChanges;
+    /**
+     * Filter relationship changes
+     */
+    private filterRelationshipChanges;
+    /**
+     * Check if entity should be included
+     */
+    private shouldIncludeEntity;
+    /**
+     * Check if relationship should be included
+     */
+    private shouldIncludeRelationship;
+    /**
+     * Sanitize entity data
+     */
+    private sanitizeEntity;
+    /**
+     * Sanitize relationship data
+     */
+    private sanitizeRelationship;
+    /**
+     * Apply configured string replacements
+     */
+    private applyReplacements;
+    /**
+     * Recalculate stats after filtering
+     */
+    private recalculateStats;
+}
+/**
+ * Create privacy filter with preset level
+ */
+export declare function createPrivacyFilter(level: 'strict' | 'moderate' | 'none', customConfig?: Partial<PrivacyFilterConfig>): PrivacyFilter;
+//# 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,EAGV,QAAQ,EACR,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,cAAc,CAAW;gBAErB,MAAM,EAAE,mBAAmB;IAOvC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ;IAgBpC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAQjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAyBjC;;OAEG;IACH,OAAO,CAAC,cAAc;IA4BtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAwBzB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,EACrC,YAAY,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAC1C,aAAa,CAuBf"}

package/dist/kgpr/privacy-filter.js

@@ -0,0 +1,191 @@
+/**
+ * Knowledge Graph Pull Request (KGPR) - Privacy Filter
+ *
+ * Removes sensitive information before sharing
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-global/kgpr
+ *
+ * @see REQ-KGPR-002
+ */
+import { DEFAULT_PRIVACY_FILTER_STRICT, DEFAULT_PRIVACY_FILTER_MODERATE, } from './types.js';
+export { DEFAULT_PRIVACY_FILTER_STRICT, DEFAULT_PRIVACY_FILTER_MODERATE, } from './types.js';
+/**
+ * Privacy filter for KGPR
+ */
+export class PrivacyFilter {
+    config;
+    excludeRegexes;
+    constructor(config) {
+        this.config = config;
+        this.excludeRegexes = config.excludePatterns.map((p) => new RegExp(p, 'i'));
+    }
+    /**
+     * Filter a complete diff
+     */
+    filterDiff(diff) {
+        return {
+            entities: {
+                added: this.filterEntityChanges(diff.entities.added),
+                updated: this.filterEntityChanges(diff.entities.updated),
+                deleted: this.filterEntityChanges(diff.entities.deleted),
+            },
+            relationships: {
+                added: this.filterRelationshipChanges(diff.relationships.added),
+                updated: this.filterRelationshipChanges(diff.relationships.updated),
+                deleted: this.filterRelationshipChanges(diff.relationships.deleted),
+            },
+            stats: this.recalculateStats(diff),
+        };
+    }
+    /**
+     * 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 entity should be included
+     */
+    shouldIncludeEntity(entity) {
+        // Check namespace exclusion
+        if (this.config.excludeNamespaces.some((ns) => entity.namespace.toLowerCase().includes(ns.toLowerCase()))) {
+            return false;
+        }
+        // Check name pattern exclusion
+        if (this.excludeRegexes.some((regex) => regex.test(entity.name))) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Check if relationship should be included
+     */
+    shouldIncludeRelationship(rel) {
+        // Exclude if either endpoint is in excluded namespace
+        const excludedNs = this.config.excludeNamespaces;
+        if (excludedNs.some((ns) => rel.sourceNamespace.toLowerCase().includes(ns.toLowerCase()) ||
+            rel.targetNamespace.toLowerCase().includes(ns.toLowerCase()))) {
+            return false;
+        }
+        // Check name pattern exclusion
+        if (this.excludeRegexes.some((regex) => regex.test(rel.sourceName) || regex.test(rel.targetName))) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Sanitize entity data
+     */
+    sanitizeEntity(entity) {
+        const sanitized = {
+            ...entity,
+        };
+        // Remove file path if configured
+        if (this.config.removeFilePaths) {
+            delete sanitized.filePath;
+        }
+        // Remove line numbers if configured
+        if (this.config.removeLineNumbers) {
+            delete sanitized.line;
+        }
+        // Remove metadata if configured
+        if (this.config.removeMetadata) {
+            delete sanitized.metadata;
+            delete sanitized.previousValue;
+        }
+        // Apply string replacements
+        sanitized.name = this.applyReplacements(sanitized.name);
+        sanitized.namespace = this.applyReplacements(sanitized.namespace);
+        return sanitized;
+    }
+    /**
+     * Sanitize relationship data
+     */
+    sanitizeRelationship(rel) {
+        const sanitized = {
+            ...rel,
+        };
+        // Remove metadata if configured
+        if (this.config.removeMetadata) {
+            delete sanitized.metadata;
+        }
+        // Apply string replacements
+        sanitized.sourceName = this.applyReplacements(sanitized.sourceName);
+        sanitized.sourceNamespace = this.applyReplacements(sanitized.sourceNamespace);
+        sanitized.targetName = this.applyReplacements(sanitized.targetName);
+        sanitized.targetNamespace = this.applyReplacements(sanitized.targetNamespace);
+        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;
+    }
+    /**
+     * Recalculate stats after filtering
+     */
+    recalculateStats(diff) {
+        const filteredEntitiesAdded = this.filterEntityChanges(diff.entities.added).length;
+        const filteredEntitiesUpdated = this.filterEntityChanges(diff.entities.updated).length;
+        const filteredEntitiesDeleted = this.filterEntityChanges(diff.entities.deleted).length;
+        const filteredRelsAdded = this.filterRelationshipChanges(diff.relationships.added).length;
+        const filteredRelsUpdated = this.filterRelationshipChanges(diff.relationships.updated).length;
+        const filteredRelsDeleted = this.filterRelationshipChanges(diff.relationships.deleted).length;
+        return {
+            entitiesAdded: filteredEntitiesAdded,
+            entitiesUpdated: filteredEntitiesUpdated,
+            entitiesDeleted: filteredEntitiesDeleted,
+            relationshipsAdded: filteredRelsAdded,
+            relationshipsUpdated: filteredRelsUpdated,
+            relationshipsDeleted: filteredRelsDeleted,
+            totalChanges: filteredEntitiesAdded +
+                filteredEntitiesUpdated +
+                filteredEntitiesDeleted +
+                filteredRelsAdded +
+                filteredRelsUpdated +
+                filteredRelsDeleted,
+        };
+    }
+}
+/**
+ * Create privacy filter with preset level
+ */
+export function createPrivacyFilter(level, customConfig) {
+    let baseConfig;
+    switch (level) {
+        case 'strict':
+            baseConfig = { ...DEFAULT_PRIVACY_FILTER_STRICT };
+            break;
+        case 'moderate':
+            baseConfig = { ...DEFAULT_PRIVACY_FILTER_MODERATE };
+            break;
+        case 'none':
+            baseConfig = {
+                removeFilePaths: false,
+                removeLineNumbers: false,
+                removeMetadata: false,
+                excludeNamespaces: [],
+                excludePatterns: [],
+                replacements: [],
+            };
+            break;
+    }
+    return new PrivacyFilter({ ...baseConfig, ...customConfig });
+}
+//# 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,303 @@
+/**
+ * Knowledge Graph Pull Request (KGPR) - Type Definitions
+ *
+ * GitHub PR-like workflow for sharing knowledge graphs
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-global/kgpr
+ *
+ * @see REQ-KGPR-001
+ */
+/**
+ * KGPR status
+ */
+export type KGPRStatus = 'draft' | 'open' | 'reviewing' | 'approved' | 'changes_requested' | 'merged' | 'closed';
+/**
+ * Entity change type
+ */
+export type ChangeType = 'add' | 'update' | 'delete';
+/**
+ * Single entity change in a KGPR
+ */
+export interface EntityChange {
+    /** Change type */
+    changeType: ChangeType;
+    /** Entity ID (local) */
+    localId: string;
+    /** Entity name */
+    name: string;
+    /** Entity type (class, function, interface, etc.) */
+    entityType: string;
+    /** Namespace */
+    namespace: string;
+    /** File path (sanitized) */
+    filePath?: string;
+    /** Line number */
+    line?: number;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+    /** Previous value (for updates) */
+    previousValue?: Record<string, unknown>;
+}
+/**
+ * Single relationship change in a KGPR
+ */
+export interface RelationshipChange {
+    /** Change type */
+    changeType: ChangeType;
+    /** Relationship ID (local) */
+    localId?: string;
+    /** Source entity name */
+    sourceName: string;
+    /** Source namespace */
+    sourceNamespace: string;
+    /** Target entity name */
+    targetName: string;
+    /** Target namespace */
+    targetNamespace: string;
+    /** Relationship type (extends, implements, imports, etc.) */
+    relationshipType: string;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * KGPR diff - all changes in a PR
+ */
+export interface KGPRDiff {
+    /** Entity changes */
+    entities: {
+        added: EntityChange[];
+        updated: EntityChange[];
+        deleted: EntityChange[];
+    };
+    /** Relationship changes */
+    relationships: {
+        added: RelationshipChange[];
+        updated: RelationshipChange[];
+        deleted: RelationshipChange[];
+    };
+    /** Statistics */
+    stats: {
+        entitiesAdded: number;
+        entitiesUpdated: number;
+        entitiesDeleted: number;
+        relationshipsAdded: number;
+        relationshipsUpdated: number;
+        relationshipsDeleted: number;
+        totalChanges: number;
+    };
+}
+/**
+ * KGPR review comment
+ */
+export interface KGPRComment {
+    /** Comment ID */
+    id: string;
+    /** Author ID */
+    authorId: string;
+    /** Author name */
+    authorName: string;
+    /** Comment body */
+    body: string;
+    /** Target (null = general, or specific entity/relationship ID) */
+    targetId?: string;
+    /** Target type */
+    targetType?: 'entity' | 'relationship';
+    /** Created timestamp */
+    createdAt: Date;
+    /** Updated timestamp */
+    updatedAt?: Date;
+}
+/**
+ * KGPR review
+ */
+export interface KGPRReview {
+    /** Review ID */
+    id: string;
+    /** Reviewer ID */
+    reviewerId: string;
+    /** Reviewer name */
+    reviewerName: string;
+    /** Review status */
+    status: 'approved' | 'changes_requested' | 'commented';
+    /** Review body */
+    body?: string;
+    /** Comments */
+    comments: KGPRComment[];
+    /** Created timestamp */
+    createdAt: Date;
+}
+/**
+ * Knowledge Graph Pull Request
+ */
+export interface KGPR {
+    /** KGPR ID */
+    id: string;
+    /** Title */
+    title: string;
+    /** Description */
+    description: string;
+    /** Author ID */
+    authorId: string;
+    /** Author name */
+    authorName: string;
+    /** Status */
+    status: KGPRStatus;
+    /** Source namespace (from local KG) */
+    sourceNamespace: string;
+    /** Target namespace (in global KG, optional) */
+    targetNamespace?: string;
+    /** Diff */
+    diff: KGPRDiff;
+    /** Labels/tags */
+    labels: string[];
+    /** Reviews */
+    reviews: KGPRReview[];
+    /** General comments */
+    comments: KGPRComment[];
+    /** Quality score (AI-generated) */
+    qualityScore?: number;
+    /** Duplicate warnings */
+    duplicateWarnings?: DuplicateWarning[];
+    /** Created timestamp */
+    createdAt: Date;
+    /** Updated timestamp */
+    updatedAt: Date;
+    /** Merged timestamp */
+    mergedAt?: Date;
+    /** Merged by */
+    mergedBy?: string;
+    /** Closed timestamp */
+    closedAt?: Date;
+    /** Closed by */
+    closedBy?: string;
+}
+/**
+ * Duplicate warning from auto-detection
+ */
+export interface DuplicateWarning {
+    /** Local entity name */
+    localEntityName: string;
+    /** Similar global entity ID */
+    globalEntityId: string;
+    /** Similar global entity name */
+    globalEntityName: string;
+    /** Similarity score (0-1) */
+    similarity: number;
+    /** Suggestion */
+    suggestion: 'merge' | 'rename' | 'skip' | 'keep_both';
+}
+/**
+ * KGPR creation options
+ */
+export interface CreateKGPROptions {
+    /** Title */
+    title: string;
+    /** Description */
+    description?: string;
+    /** Source namespace to include */
+    sourceNamespace?: string;
+    /** Labels */
+    labels?: string[];
+    /** Include only specific entity types */
+    entityTypes?: string[];
+    /** Privacy filter level */
+    privacyLevel?: 'strict' | 'moderate' | 'none';
+    /** Auto-submit after creation */
+    autoSubmit?: boolean;
+}
+/**
+ * KGPR submission result
+ */
+export interface KGPRSubmitResult {
+    /** Success flag */
+    success: boolean;
+    /** KGPR ID (if successful) */
+    kgprId?: string;
+    /** KGPR URL (if successful) */
+    kgprUrl?: string;
+    /** Quality score */
+    qualityScore?: number;
+    /** Duplicate warnings */
+    duplicateWarnings?: DuplicateWarning[];
+    /** Error message (if failed) */
+    error?: string;
+}
+/**
+ * KGPR list query options
+ */
+export interface ListKGPROptions {
+    /** Filter by status */
+    status?: KGPRStatus | KGPRStatus[];
+    /** Filter by author */
+    authorId?: string;
+    /** Filter by labels */
+    labels?: string[];
+    /** Search query */
+    search?: string;
+    /** Sort by */
+    sortBy?: 'created' | 'updated' | 'quality' | 'changes';
+    /** Sort order */
+    sortOrder?: 'asc' | 'desc';
+    /** Limit */
+    limit?: number;
+    /** Offset */
+    offset?: number;
+}
+/**
+ * KGPR merge options
+ */
+export interface MergeKGPROptions {
+    /** Conflict resolution strategy */
+    conflictResolution?: 'keep_local' | 'keep_global' | 'keep_both' | 'manual';
+    /** Squash similar entities */
+    squashSimilar?: boolean;
+    /** Delete source after merge */
+    deleteSourceAfterMerge?: boolean;
+}
+/**
+ * KGPR merge result
+ */
+export interface MergeKGPRResult {
+    /** Success flag */
+    success: boolean;
+    /** Entities merged */
+    entitiesMerged: number;
+    /** Relationships merged */
+    relationshipsMerged: number;
+    /** Conflicts resolved */
+    conflictsResolved: number;
+    /** Skipped (duplicates) */
+    skipped: number;
+    /** Error message (if failed) */
+    error?: string;
+}
+/**
+ * Privacy filter configuration
+ */
+export interface PrivacyFilterConfig {
+    /** Remove file paths */
+    removeFilePaths: boolean;
+    /** Remove line numbers */
+    removeLineNumbers: boolean;
+    /** Remove metadata */
+    removeMetadata: boolean;
+    /** Namespace patterns to exclude */
+    excludeNamespaces: string[];
+    /** Entity name patterns to exclude (regex) */
+    excludePatterns: string[];
+    /** Replace sensitive strings */
+    replacements: {
+        pattern: string;
+        replacement: string;
+    }[];
+}
+/**
+ * Default privacy filter (strict)
+ */
+export declare const DEFAULT_PRIVACY_FILTER_STRICT: PrivacyFilterConfig;
+/**
+ * Default privacy filter (moderate)
+ */
+export declare const DEFAULT_PRIVACY_FILTER_MODERATE: PrivacyFilterConfig;
+//# 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,40 @@
+/**
+ * Knowledge Graph Pull Request (KGPR) - Type Definitions
+ *
+ * GitHub PR-like workflow for sharing knowledge graphs
+ *
+ * @packageDocumentation
+ * @module @nahisaho/yata-global/kgpr
+ *
+ * @see REQ-KGPR-001
+ */
+/**
+ * Default privacy filter (strict)
+ */
+export const DEFAULT_PRIVACY_FILTER_STRICT = {
+    removeFilePaths: true,
+    removeLineNumbers: true,
+    removeMetadata: true,
+    excludeNamespaces: ['internal', 'private', 'secret', 'config'],
+    excludePatterns: [
+        'password',
+        'secret',
+        'token',
+        'api[_-]?key',
+        'credential',
+        'auth',
+    ],
+    replacements: [],
+};
+/**
+ * Default privacy filter (moderate)
+ */
+export const DEFAULT_PRIVACY_FILTER_MODERATE = {
+    removeFilePaths: false,
+    removeLineNumbers: false,
+    removeMetadata: false,
+    excludeNamespaces: ['secret', 'config'],
+    excludePatterns: ['password', 'secret', 'token', 'api[_-]?key'],
+    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;AAiTH;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwB;IAChE,eAAe,EAAE,IAAI;IACrB,iBAAiB,EAAE,IAAI;IACvB,cAAc,EAAE,IAAI;IACpB,iBAAiB,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAC9D,eAAe,EAAE;QACf,UAAU;QACV,QAAQ;QACR,OAAO;QACP,aAAa;QACb,YAAY;QACZ,MAAM;KACP;IACD,YAAY,EAAE,EAAE;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAwB;IAClE,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"}