@nahisaho/katashiro-knowledge 0.1.0

package/dist/query/graph-query.js

@@ -0,0 +1,237 @@
+/**
+ * GraphQuery - Query engine for KnowledgeGraph
+ *
+ * Provides query capabilities for searching and filtering graph data
+ *
+ * @module @nahisaho/katashiro-knowledge
+ * @task TSK-042
+ */
+import { ok, err, isOk } from '@nahisaho/katashiro-core';
+/**
+ * GraphQuery
+ *
+ * Query engine for KnowledgeGraph
+ */
+export class GraphQuery {
+    graph;
+    constructor(graph) {
+        this.graph = graph;
+    }
+    /**
+     * Find all nodes of a given type
+     *
+     * @param type - Node type to find
+     * @returns Array of matching nodes
+     */
+    findByType(type) {
+        try {
+            const nodes = this.graph.getNodesByType(type);
+            return ok(nodes);
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Find nodes with a specific property value
+     *
+     * @param property - Property name
+     * @param value - Property value
+     * @returns Array of matching nodes
+     */
+    findByProperty(property, value) {
+        try {
+            const allNodes = this.graph.getAllNodes();
+            const matching = allNodes.filter((node) => node.properties[property] === value);
+            return ok(matching);
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Find edges with a given predicate
+     *
+     * @param predicate - Edge predicate
+     * @returns Array of matching edges
+     */
+    findByPredicate(predicate) {
+        try {
+            const edges = this.graph.getEdgesByPredicate(predicate);
+            return ok(edges);
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Find nodes related to a given node
+     *
+     * @param nodeId - Source node ID
+     * @param predicate - Optional predicate filter
+     * @returns Array of related nodes
+     */
+    findRelated(nodeId, predicate) {
+        try {
+            const neighborsResult = this.graph.getNeighbors(nodeId);
+            if (!isOk(neighborsResult)) {
+                return neighborsResult;
+            }
+            let neighbors = neighborsResult.value;
+            // Filter by predicate if specified
+            if (predicate) {
+                const edges = this.graph.getAllEdges();
+                const validTargets = new Set(edges
+                    .filter((e) => e.source === nodeId && e.predicate === predicate)
+                    .map((e) => e.target));
+                neighbors = neighbors.filter((n) => validTargets.has(n.id));
+            }
+            return ok(neighbors);
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Search nodes by label
+     *
+     * @param query - Search query (case insensitive substring match)
+     * @returns Array of matching nodes
+     */
+    search(query) {
+        try {
+            const nodes = this.graph.searchByLabel(query);
+            return ok(nodes);
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Execute a structured query
+     *
+     * @param queryDef - Query definition
+     * @returns Query result
+     */
+    execute(queryDef) {
+        const startTime = performance.now();
+        try {
+            let nodes;
+            // Start with type filter or all nodes
+            if (queryDef.type) {
+                nodes = this.graph.getNodesByType(queryDef.type);
+            }
+            else {
+                nodes = this.graph.getAllNodes();
+            }
+            // Apply filters
+            if (queryDef.filters) {
+                for (const filter of queryDef.filters) {
+                    nodes = nodes.filter((node) => this.applyFilter(node, filter));
+                }
+            }
+            const totalCount = nodes.length;
+            // Apply sorting
+            if (queryDef.orderBy) {
+                const direction = queryDef.orderDirection === 'desc' ? -1 : 1;
+                nodes.sort((a, b) => {
+                    const aVal = a.properties[queryDef.orderBy];
+                    const bVal = b.properties[queryDef.orderBy];
+                    if (typeof aVal === 'string' && typeof bVal === 'string') {
+                        return aVal.localeCompare(bVal) * direction;
+                    }
+                    if (typeof aVal === 'number' && typeof bVal === 'number') {
+                        return (aVal - bVal) * direction;
+                    }
+                    return 0;
+                });
+            }
+            // Apply pagination
+            if (queryDef.offset !== undefined) {
+                nodes = nodes.slice(queryDef.offset);
+            }
+            if (queryDef.limit !== undefined) {
+                nodes = nodes.slice(0, queryDef.limit);
+            }
+            const executionTime = performance.now() - startTime;
+            return ok({
+                nodes,
+                totalCount,
+                executionTime,
+            });
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Aggregate nodes by a property
+     *
+     * @param operation - Aggregation operation
+     * @param groupBy - Property to group by
+     * @returns Aggregation result
+     */
+    aggregate(operation, groupBy) {
+        try {
+            const nodes = this.graph.getAllNodes();
+            const groups = {};
+            for (const node of nodes) {
+                let key;
+                if (groupBy === 'type') {
+                    key = node.type;
+                }
+                else {
+                    key = String(node.properties[groupBy] ?? 'unknown');
+                }
+                if (!groups[key]) {
+                    groups[key] = [];
+                }
+                groups[key].push(1);
+            }
+            const result = {};
+            for (const [key, values] of Object.entries(groups)) {
+                switch (operation) {
+                    case 'count':
+                        result[key] = values.length;
+                        break;
+                    case 'sum':
+                        result[key] = values.reduce((a, b) => a + b, 0);
+                        break;
+                    case 'avg':
+                        result[key] = values.reduce((a, b) => a + b, 0) / values.length;
+                        break;
+                }
+            }
+            return ok(result);
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Apply a filter to a node
+     */
+    applyFilter(node, filter) {
+        const value = node.properties[filter.property];
+        switch (filter.operator) {
+            case 'eq':
+                return value === filter.value;
+            case 'ne':
+                return value !== filter.value;
+            case 'gt':
+                return typeof value === 'number' && value > filter.value;
+            case 'lt':
+                return typeof value === 'number' && value < filter.value;
+            case 'gte':
+                return typeof value === 'number' && value >= filter.value;
+            case 'lte':
+                return typeof value === 'number' && value <= filter.value;
+            case 'contains':
+                return (typeof value === 'string' &&
+                    value.toLowerCase().includes(String(filter.value).toLowerCase()));
+            default:
+                return false;
+        }
+    }
+}
+//# sourceMappingURL=graph-query.js.map

package/dist/query/graph-query.js.map

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

package/dist/query/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Query module exports
+ *
+ * @module @nahisaho/katashiro-knowledge
+ */
+export { GraphQuery, type QueryFilter, type GraphQueryDef, type QueryResult, } from './graph-query.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/query/index.js

@@ -0,0 +1,7 @@
+/**
+ * Query module exports
+ *
+ * @module @nahisaho/katashiro-knowledge
+ */
+export { GraphQuery, } from './graph-query.js';
+//# sourceMappingURL=index.js.map

package/dist/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,GAIX,MAAM,kBAAkB,CAAC"}

package/dist/sync/graph-sync.d.ts

@@ -0,0 +1,132 @@
+/**
+ * GraphSync - Synchronization between knowledge graphs
+ *
+ * Handles merging and syncing graph data between local and remote
+ *
+ * @module @nahisaho/katashiro-knowledge
+ * @task TSK-044
+ */
+import { type Result } from '@nahisaho/katashiro-core';
+import { KnowledgeGraph, type GraphNode, type GraphEdge } from '../graph/knowledge-graph.js';
+/**
+ * Sync options
+ */
+export interface SyncOptions {
+    /** Whether to update existing nodes/edges */
+    updateExisting?: boolean;
+    /** Conflict resolution strategy */
+    conflictResolution?: 'local' | 'remote' | 'newer';
+    /** Only sync specific node types */
+    nodeTypes?: string[];
+    /** Only sync specific predicates */
+    predicates?: string[];
+}
+/**
+ * Sync result
+ */
+export interface SyncResult {
+    nodesAdded: number;
+    nodesUpdated: number;
+    nodesRemoved: number;
+    edgesAdded: number;
+    edgesUpdated: number;
+    edgesRemoved: number;
+    conflicts: Conflict[];
+    timestamp: string;
+}
+/**
+ * Comparison result
+ */
+export interface ComparisonResult {
+    localOnly: {
+        nodes: GraphNode[];
+        edges: GraphEdge[];
+    };
+    remoteOnly: {
+        nodes: GraphNode[];
+        edges: GraphEdge[];
+    };
+    modified: {
+        nodes: Array<{
+            local: GraphNode;
+            remote: GraphNode;
+        }>;
+        edges: Array<{
+            local: GraphEdge;
+            remote: GraphEdge;
+        }>;
+    };
+    identical: {
+        nodes: GraphNode[];
+        edges: GraphEdge[];
+    };
+}
+/**
+ * Conflict representation
+ */
+export interface Conflict {
+    type: 'node' | 'edge';
+    id: string;
+    local: GraphNode | GraphEdge;
+    remote: GraphNode | GraphEdge;
+    field: string;
+}
+/**
+ * GraphSync
+ *
+ * Synchronizes knowledge graphs between local and remote sources
+ */
+export declare class GraphSync {
+    private localGraph;
+    private remoteGraph;
+    private lastSyncTime;
+    constructor(localGraph: KnowledgeGraph, remoteGraph: KnowledgeGraph);
+    /**
+     * Compare local and remote graphs
+     *
+     * @returns Comparison result
+     */
+    compare(): Result<ComparisonResult, Error>;
+    /**
+     * Pull changes from remote to local
+     *
+     * @param options - Sync options
+     * @returns Sync result
+     */
+    pull(options?: SyncOptions): Result<SyncResult, Error>;
+    /**
+     * Push changes from local to remote
+     *
+     * @param options - Sync options
+     * @returns Sync result
+     */
+    push(options?: SyncOptions): Result<SyncResult, Error>;
+    /**
+     * Bidirectional sync
+     *
+     * @param options - Sync options
+     * @returns Sync result
+     */
+    sync(options?: SyncOptions): Result<SyncResult, Error>;
+    /**
+     * Get conflicts between graphs
+     *
+     * @returns Array of conflicts
+     */
+    getConflicts(): Result<Conflict[], Error>;
+    /**
+     * Get last sync timestamp
+     *
+     * @returns Last sync timestamp or null
+     */
+    getLastSyncTime(): string | null;
+    /**
+     * Check if a node has been modified
+     */
+    private isNodeModified;
+    /**
+     * Check if an edge has been modified
+     */
+    private isEdgeModified;
+}
+//# sourceMappingURL=graph-sync.d.ts.map

package/dist/sync/graph-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-sync.d.ts","sourceRoot":"","sources":["../../src/sync/graph-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mCAAmC;IACnC,kBAAkB,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IAClD,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE;QACT,KAAK,EAAE,SAAS,EAAE,CAAC;QACnB,KAAK,EAAE,SAAS,EAAE,CAAC;KACpB,CAAC;IACF,UAAU,EAAE;QACV,KAAK,EAAE,SAAS,EAAE,CAAC;QACnB,KAAK,EAAE,SAAS,EAAE,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE;QACR,KAAK,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,SAAS,CAAC;YAAC,MAAM,EAAE,SAAS,CAAA;SAAE,CAAC,CAAC;QACtD,KAAK,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,SAAS,CAAC;YAAC,MAAM,EAAE,SAAS,CAAA;SAAE,CAAC,CAAC;KACvD,CAAC;IACF,SAAS,EAAE;QACT,KAAK,EAAE,SAAS,EAAE,CAAC;QACnB,KAAK,EAAE,SAAS,EAAE,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,qBAAa,SAAS;IAIlB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,WAAW;IAJrB,OAAO,CAAC,YAAY,CAAuB;gBAGjC,UAAU,EAAE,cAAc,EAC1B,WAAW,EAAE,cAAc;IAGrC;;;;OAIG;IACH,OAAO,IAAI,MAAM,CAAC,gBAAgB,EAAE,KAAK,CAAC;IAwE1C;;;;;OAKG;IACH,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC;IAuE1D;;;;;OAKG;IACH,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC;IAqE1D;;;;;OAKG;IACH,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC;IAoC1D;;;;OAIG;IACH,YAAY,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC;IAwCzC;;;;OAIG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,cAAc;CAQvB"}