@chinjinyu/mcp-knowledge-graph-plus 0.1.1

package/dist/infrastructure/repositories/NodeRepository.js

@@ -0,0 +1,143 @@
+/**
+ * Node Repository - handles entity table operations
+ */
+import { NodeAlreadyExistsError, DatabaseError } from '../../core/errors/index.js';
+import { BaseRepository } from './BaseRepository.js';
+export class NodeRepository extends BaseRepository {
+    constructor(db) {
+        super(db);
+    }
+    getTableName() {
+        return 'entities';
+    }
+    rowToEntity(row) {
+        return {
+            id: row.id,
+            name: row.name,
+            type: row.entity_type,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    async findById(id) {
+        const row = await this.get('SELECT * FROM entities WHERE id = ?', [id]);
+        return row ? this.rowToEntity(row) : null;
+    }
+    async findByName(name) {
+        const row = await this.get('SELECT * FROM entities WHERE name = ?', [name]);
+        return row ? this.rowToEntity(row) : null;
+    }
+    async findManyByNames(names) {
+        if (names.length === 0)
+            return [];
+        const placeholders = names.map(() => '?').join(',');
+        const rows = await this.all(`SELECT * FROM entities WHERE name IN (${placeholders}) ORDER BY id`, names);
+        return rows.map(row => this.rowToEntity(row));
+    }
+    async findMany(ids) {
+        if (ids.length === 0)
+            return [];
+        const placeholders = ids.map(() => '?').join(',');
+        const rows = await this.all(`SELECT * FROM entities WHERE id IN (${placeholders}) ORDER BY id`, ids);
+        return rows.map(row => this.rowToEntity(row));
+    }
+    async findAll() {
+        const rows = await this.all('SELECT * FROM entities ORDER BY id');
+        return rows.map(row => this.rowToEntity(row));
+    }
+    async findAllWithPagination(page, pageSize) {
+        const offset = (page - 1) * pageSize;
+        const countRow = await this.get('SELECT COUNT(*) as count FROM entities');
+        const total = countRow?.count ?? 0;
+        const rows = await this.all('SELECT * FROM entities ORDER BY id LIMIT ? OFFSET ?', [pageSize, offset]);
+        return { nodes: rows.map(row => this.rowToEntity(row)), total };
+    }
+    async create(input) {
+        const now = new Date().toISOString();
+        try {
+            const result = await this.run('INSERT INTO entities (name, entity_type, created_at, updated_at) VALUES (?, ?, ?, ?)', [input.name, input.type, now, now]);
+            const node = await this.findById(result.lastID);
+            if (!node)
+                throw new DatabaseError('Failed to create node');
+            return node;
+        }
+        catch (error) {
+            if (this.isUniqueConstraintError(error))
+                throw new NodeAlreadyExistsError(input.name);
+            throw new DatabaseError('Failed to create node', error);
+        }
+    }
+    async createMany(inputs) {
+        if (inputs.length === 0)
+            return [];
+        const nodes = [];
+        await this.transaction(async () => {
+            for (const input of inputs) {
+                try {
+                    const now = new Date().toISOString();
+                    const result = await this.run('INSERT OR IGNORE INTO entities (name, entity_type, created_at, updated_at) VALUES (?, ?, ?, ?)', [input.name, input.type, now, now]);
+                    if (result.changes > 0) {
+                        const node = await this.findById(result.lastID);
+                        if (node)
+                            nodes.push(node);
+                    }
+                }
+                catch (error) {
+                    if (!this.isUniqueConstraintError(error))
+                        throw error;
+                }
+            }
+        });
+        return nodes;
+    }
+    async update(input) {
+        const existingNode = await this.findByName(input.nodeName);
+        if (!existingNode)
+            return null;
+        const updates = [];
+        const params = [];
+        if (input.newName !== undefined) {
+            updates.push('name = ?');
+            params.push(input.newName);
+        }
+        if (input.newType !== undefined) {
+            updates.push('entity_type = ?');
+            params.push(input.newType);
+        }
+        if (updates.length === 0)
+            return existingNode;
+        updates.push('updated_at = ?');
+        params.push(new Date().toISOString());
+        params.push(existingNode.id);
+        const sql = `UPDATE entities SET ${updates.join(', ')} WHERE id = ?`;
+        try {
+            await this.run(sql, params);
+            return await this.findById(existingNode.id);
+        }
+        catch (error) {
+            if (this.isUniqueConstraintError(error) && input.newName !== undefined) {
+                throw new NodeAlreadyExistsError(input.newName);
+            }
+            throw new DatabaseError('Failed to update node', error);
+        }
+    }
+    async delete(id) {
+        await this.run('DELETE FROM entities WHERE id = ?', [id]);
+    }
+    async deleteByNames(names) {
+        if (names.length === 0)
+            return 0;
+        const placeholders = names.map(() => '?').join(',');
+        const result = await this.run(`DELETE FROM entities WHERE name IN (${placeholders})`, names);
+        return result.changes;
+    }
+    async count() {
+        const row = await this.get('SELECT COUNT(*) as count FROM entities');
+        return row?.count ?? 0;
+    }
+    async existsByName(name) {
+        const row = await this.get('SELECT 1 FROM entities WHERE name = ? LIMIT 1', [name]);
+        return row !== undefined;
+    }
+}
+//# sourceMappingURL=NodeRepository.js.map

package/dist/infrastructure/repositories/NodeRepository.js.map

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

package/dist/interfaces/mcp/commands/BaseCommand.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Base Command Interface
+ */
+export interface Command<TInput, TOutput> {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    execute(input: TInput): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+}
+export declare abstract class BaseCommand<TInput, TOutput> implements Command<TInput, TOutput> {
+    abstract readonly name: string;
+    abstract readonly description: string;
+    abstract readonly inputSchema: Record<string, unknown>;
+    abstract execute(input: TInput): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+    /**
+     * Validate that a parameter is an array
+     * @param value - The value to validate
+     * @param paramName - Parameter name for error message
+     * @param options - Optional validation options
+     * @param options.description - Description of what the parameter should contain
+     * @param options.example - Example of correct usage
+     * @throws ValidationError if value is not an array
+     */
+    protected validateArray(value: unknown, paramName: string, options?: {
+        description?: string;
+        example?: string;
+    }): void;
+    /**
+     * Validate that a nested field in each object of an array is itself an array
+     * @param items - Array of objects to validate
+     * @param objectName - Name of the object array parameter
+     * @param fieldName - Name of the nested field to check
+     * @param options - Optional validation options
+     * @param options.description - Description of what the parameter should contain
+     * @param options.example - Example of correct usage
+     * @throws ValidationError if any nested field is not an array
+     */
+    protected validateNestedArray(items: unknown, objectName: string, fieldName: string, options?: {
+        description?: string;
+        example?: string;
+    }): void;
+}
+//# sourceMappingURL=BaseCommand.d.ts.map

package/dist/interfaces/mcp/commands/BaseCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseCommand.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/mcp/commands/BaseCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,OAAO,CAAC,MAAM,EAAE,OAAO;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACxG;AAOD,8BAAsB,WAAW,CAAC,MAAM,EAAE,OAAO,CAAE,YAAW,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;IACpF,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAE/G;;;;;;;;OAQG;IACH,SAAS,CAAC,aAAa,CACrB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,IAAI;IAYP;;;;;;;;;OASG;IACH,SAAS,CAAC,mBAAmB,CAC3B,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,IAAI;CAiBR"}

package/dist/interfaces/mcp/commands/BaseCommand.js

@@ -0,0 +1,42 @@
+/**
+ * Base Command class with common validation utilities
+ */
+import { ValidationError } from '../../../core/errors/index.js';
+export class BaseCommand {
+    /**
+     * Validate that a parameter is an array
+     * @param value - The value to validate
+     * @param paramName - Parameter name for error message
+     * @param options - Optional validation options
+     * @param options.description - Description of what the parameter should contain
+     * @param options.example - Example of correct usage
+     * @throws ValidationError if value is not an array
+     */
+    validateArray(value, paramName, options) {
+        if (!Array.isArray(value)) {
+            throw ValidationError.forField(paramName, value, `must be an array, but received ${typeof value}`, options?.description, options?.example);
+        }
+    }
+    /**
+     * Validate that a nested field in each object of an array is itself an array
+     * @param items - Array of objects to validate
+     * @param objectName - Name of the object array parameter
+     * @param fieldName - Name of the nested field to check
+     * @param options - Optional validation options
+     * @param options.description - Description of what the parameter should contain
+     * @param options.example - Example of correct usage
+     * @throws ValidationError if any nested field is not an array
+     */
+    validateNestedArray(items, objectName, fieldName, options) {
+        if (!Array.isArray(items))
+            return;
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            const fieldValue = item[fieldName];
+            if (fieldValue !== undefined && !Array.isArray(fieldValue)) {
+                throw ValidationError.forField(`${objectName}[${i}].${fieldName}`, fieldValue, `must be an array, but received ${typeof fieldValue}`, options?.description, options?.example);
+            }
+        }
+    }
+}
+//# sourceMappingURL=BaseCommand.js.map

package/dist/interfaces/mcp/commands/BaseCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseCommand.js","sourceRoot":"","sources":["../../../../src/interfaces/mcp/commands/BaseCommand.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,MAAM,OAAgB,WAAW;IAM/B;;;;;;;;OAQG;IACO,aAAa,CACrB,KAAc,EACd,SAAiB,EACjB,OAAoD;QAEpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,eAAe,CAAC,QAAQ,CAC5B,SAAS,EACT,KAAK,EACL,kCAAkC,OAAO,KAAK,EAAE,EAChD,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,OAAO,CACjB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACO,mBAAmB,CAC3B,KAAc,EACd,UAAkB,EAClB,SAAiB,EACjB,OAAoD;QAEpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO;QAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAA4B,CAAC;YACjD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;YACnC,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3D,MAAM,eAAe,CAAC,QAAQ,CAC5B,GAAG,UAAU,IAAI,CAAC,KAAK,SAAS,EAAE,EAClC,UAAU,EACV,kCAAkC,OAAO,UAAU,EAAE,EACrD,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,OAAO,CACjB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/interfaces/mcp/commands/FactAddCommand.d.ts

@@ -0,0 +1,42 @@
+import { BaseCommand } from './BaseCommand.js';
+import type { FactService } from '../../../application/services/FactService.js';
+export declare class FactAddCommand extends BaseCommand<any, any> {
+    private readonly factService;
+    readonly name = "kg_fact_add";
+    readonly description = "Add facts to existing nodes. The node must exist; non-existent nodes are silently skipped. Duplicate facts can be added.\n\nExamples:\n1. Add a single fact to a node:\n   { \"facts\": [{ \"node\": \"Alice\", \"contents\": [\"Expert in Python\"] }] }\n\n2. Add multiple facts to a node:\n   { \"facts\": [{ \"node\": \"TechCorp\", \"contents\": [\"Founded in 2010\", \"500+ employees\", \"Headquarters in Seattle\"] }] }\n\n3. Add facts to multiple nodes:\n   { \"facts\": [{ \"node\": \"Alice\", \"contents\": [\"AWS certified\"] }, { \"node\": \"Bob\", \"contents\": [\"MBA degree\"] }] }";
+    readonly inputSchema: {
+        type: string;
+        properties: {
+            facts: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        node: {
+                            type: string;
+                            description: string;
+                        };
+                        contents: {
+                            type: string;
+                            items: {
+                                type: string;
+                            };
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+        };
+        required: string[];
+    };
+    constructor(factService: FactService);
+    execute(input: any): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=FactAddCommand.d.ts.map

package/dist/interfaces/mcp/commands/FactAddCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactAddCommand.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/mcp/commands/FactAddCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAEhF,qBAAa,cAAe,SAAQ,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC;IAgC3C,OAAO,CAAC,QAAQ,CAAC,WAAW;IA/BxC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,mlBAU+F;IACnH,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;MAiBlB;gBAE2B,WAAW,EAAE,WAAW;IAI/C,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAuCvF"}

package/dist/interfaces/mcp/commands/FactAddCommand.js

@@ -0,0 +1,73 @@
+import { BaseCommand } from './BaseCommand.js';
+export class FactAddCommand extends BaseCommand {
+    factService;
+    name = 'kg_fact_add';
+    description = `Add facts to existing nodes. The node must exist; non-existent nodes are silently skipped. Duplicate facts can be added.
+
+Examples:
+1. Add a single fact to a node:
+   { "facts": [{ "node": "Alice", "contents": ["Expert in Python"] }] }
+
+2. Add multiple facts to a node:
+   { "facts": [{ "node": "TechCorp", "contents": ["Founded in 2010", "500+ employees", "Headquarters in Seattle"] }] }
+
+3. Add facts to multiple nodes:
+   { "facts": [{ "node": "Alice", "contents": ["AWS certified"] }, { "node": "Bob", "contents": ["MBA degree"] }] }`;
+    inputSchema = {
+        type: 'object',
+        properties: {
+            facts: {
+                type: 'array',
+                description: 'Array of facts to add. Each item specifies a node name and an array of fact contents.',
+                items: {
+                    type: 'object',
+                    properties: {
+                        node: { type: 'string', description: 'Name of the node to add facts to' },
+                        contents: { type: 'array', items: { type: 'string' }, description: 'Array of fact strings to add' },
+                    },
+                    required: ['node', 'contents'],
+                },
+            },
+        },
+        required: ['facts'],
+    };
+    constructor(factService) {
+        super();
+        this.factService = factService;
+    }
+    async execute(input) {
+        // Validate array parameters
+        this.validateArray(input.facts, 'facts', {
+            description: 'Provide an array of facts to add',
+            example: '{"facts": [{"node": "Alice", "contents": ["Engineer"]}]}',
+        });
+        this.validateNestedArray(input.facts, 'facts', 'contents', {
+            description: 'The "contents" field must be an array of strings',
+            example: '{"facts": [{"node": "Alice", "contents": ["Fact 1", "Fact 2"]}]}',
+        });
+        // Map 'node' property to 'nodeName' for FactService
+        const factsInput = input.facts.map((f) => ({
+            nodeName: f.node,
+            contents: f.contents,
+        }));
+        const facts = await this.factService.createFacts(factsInput);
+        const entityIds = Array.from(new Set(facts.map(f => f.nodeId)));
+        const nodeMap = await this.factService.getNodeNameMap(entityIds);
+        const factsByNode = new Map();
+        for (const fact of facts) {
+            const nodeName = nodeMap.get(fact.nodeId) || '';
+            if (!factsByNode.has(nodeName))
+                factsByNode.set(nodeName, []);
+            factsByNode.get(nodeName).push(fact.content);
+        }
+        const output = {
+            added: facts.length,
+            facts: Array.from(factsByNode.entries()).map(([nodeName, facts]) => ({
+                node: nodeName,
+                contents: facts,
+            })),
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(output) }] };
+    }
+}
+//# sourceMappingURL=FactAddCommand.js.map

package/dist/interfaces/mcp/commands/FactAddCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactAddCommand.js","sourceRoot":"","sources":["../../../../src/interfaces/mcp/commands/FactAddCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,MAAM,OAAO,cAAe,SAAQ,WAAqB;IAgC1B;IA/BpB,IAAI,GAAG,aAAa,CAAC;IACrB,WAAW,GAAG;;;;;;;;;;oHAU2F,CAAC;IAC1G,WAAW,GAAG;QACrB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,uFAAuF;gBACpG,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;wBACzE,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,8BAA8B,EAAE;qBACpG;oBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;iBAC/B;aACF;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC;IAEF,YAA6B,WAAwB;QACnD,KAAK,EAAE,CAAC;QADmB,gBAAW,GAAX,WAAW,CAAa;IAErD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAU;QACtB,4BAA4B;QAC5B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE;YACvC,WAAW,EAAE,kCAAkC;YAC/C,OAAO,EAAE,0DAA0D;SACpE,CAAC,CAAC;QACH,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE;YACzD,WAAW,EAAE,kDAAkD;YAC/D,OAAO,EAAE,kEAAkE;SAC5E,CAAC,CAAC;QAEH,oDAAoD;QACpD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YAC9C,QAAQ,EAAE,CAAC,CAAC,IAAI;YAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC,CAAC;QAEJ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAE7D,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAEjE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;QAChD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAChD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC9D,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,MAAM,GAAG;YACb,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnE,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;SACJ,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;IACvE,CAAC;CACF"}

package/dist/interfaces/mcp/commands/FactDelCommand.d.ts

@@ -0,0 +1,42 @@
+import { BaseCommand } from './BaseCommand.js';
+import type { FactService } from '../../../application/services/FactService.js';
+export declare class FactDelCommand extends BaseCommand<any, any> {
+    private readonly factService;
+    readonly name = "kg_fact_del";
+    readonly description = "Delete specific facts from nodes. You must specify the node name and the exact content of facts to delete. Non-existent facts are silently ignored.\n\nExamples:\n1. Delete a single fact:\n   { \"facts\": [{ \"node\": \"Alice\", \"contents\": [\"Old information\"] }] }\n\n2. Delete multiple facts from a node:\n   { \"facts\": [{ \"node\": \"TechCorp\", \"contents\": [\"Outdated info 1\", \"Outdated info 2\"] }] }\n\n3. Delete facts from multiple nodes:\n   { \"facts\": [{ \"node\": \"Alice\", \"contents\": [\"Deprecated skill\"] }, { \"node\": \"Bob\", \"contents\": [\"Old role\"] }] }";
+    readonly inputSchema: {
+        type: string;
+        properties: {
+            facts: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        node: {
+                            type: string;
+                            description: string;
+                        };
+                        contents: {
+                            type: string;
+                            items: {
+                                type: string;
+                            };
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+        };
+        required: string[];
+    };
+    constructor(factService: FactService);
+    execute(input: any): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=FactDelCommand.d.ts.map

package/dist/interfaces/mcp/commands/FactDelCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactDelCommand.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/mcp/commands/FactDelCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAEhF,qBAAa,cAAe,SAAQ,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC;IAgC3C,OAAO,CAAC,QAAQ,CAAC,WAAW;IA/BxC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,qlBAUgG;IACpH,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;MAiBlB;gBAE2B,WAAW,EAAE,WAAW;IAI/C,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAgCvF"}

package/dist/interfaces/mcp/commands/FactDelCommand.js

@@ -0,0 +1,68 @@
+import { BaseCommand } from './BaseCommand.js';
+export class FactDelCommand extends BaseCommand {
+    factService;
+    name = 'kg_fact_del';
+    description = `Delete specific facts from nodes. You must specify the node name and the exact content of facts to delete. Non-existent facts are silently ignored.
+
+Examples:
+1. Delete a single fact:
+   { "facts": [{ "node": "Alice", "contents": ["Old information"] }] }
+
+2. Delete multiple facts from a node:
+   { "facts": [{ "node": "TechCorp", "contents": ["Outdated info 1", "Outdated info 2"] }] }
+
+3. Delete facts from multiple nodes:
+   { "facts": [{ "node": "Alice", "contents": ["Deprecated skill"] }, { "node": "Bob", "contents": ["Old role"] }] }`;
+    inputSchema = {
+        type: 'object',
+        properties: {
+            facts: {
+                type: 'array',
+                description: 'Array of facts to delete. Each item specifies a node name and the fact contents to delete.',
+                items: {
+                    type: 'object',
+                    properties: {
+                        node: { type: 'string', description: 'Name of the node to delete facts from' },
+                        contents: { type: 'array', items: { type: 'string' }, description: 'Array of fact strings to delete (must match exactly)' },
+                    },
+                    required: ['node', 'contents'],
+                },
+            },
+        },
+        required: ['facts'],
+    };
+    constructor(factService) {
+        super();
+        this.factService = factService;
+    }
+    async execute(input) {
+        // Validate array parameters
+        this.validateArray(input.facts, 'facts', {
+            description: 'Provide an array of facts to delete',
+            example: '{"facts": [{"node": "Alice", "contents": ["Old fact"]}]}',
+        });
+        this.validateNestedArray(input.facts, 'facts', 'contents', {
+            description: 'The "contents" field must be an array of strings',
+            example: '{"facts": [{"node": "Alice", "contents": ["Fact to delete"]}]}',
+        });
+        let count = 0;
+        const deletedFacts = [];
+        for (const deletion of input.facts) {
+            const deleted = await this.factService.deleteFactsByContent(deletion.node, deletion.contents);
+            count += deleted;
+            for (const content of deletion.contents) {
+                deletedFacts.push({ node: deletion.node, content });
+            }
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        deleted: count,
+                        facts: deletedFacts,
+                    }),
+                }],
+        };
+    }
+}
+//# sourceMappingURL=FactDelCommand.js.map

package/dist/interfaces/mcp/commands/FactDelCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactDelCommand.js","sourceRoot":"","sources":["../../../../src/interfaces/mcp/commands/FactDelCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,MAAM,OAAO,cAAe,SAAQ,WAAqB;IAgC1B;IA/BpB,IAAI,GAAG,aAAa,CAAC;IACrB,WAAW,GAAG;;;;;;;;;;qHAU4F,CAAC;IAC3G,WAAW,GAAG;QACrB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,4FAA4F;gBACzG,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;wBAC9E,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,sDAAsD,EAAE;qBAC5H;oBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;iBAC/B;aACF;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC;IAEF,YAA6B,WAAwB;QACnD,KAAK,EAAE,CAAC;QADmB,gBAAW,GAAX,WAAW,CAAa;IAErD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAU;QACtB,4BAA4B;QAC5B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE;YACvC,WAAW,EAAE,qCAAqC;YAClD,OAAO,EAAE,0DAA0D;SACpE,CAAC,CAAC;QACH,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE;YACzD,WAAW,EAAE,kDAAkD;YAC/D,OAAO,EAAE,gEAAgE;SAC1E,CAAC,CAAC;QAEH,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,YAAY,GAAU,EAAE,CAAC;QAE/B,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC9F,KAAK,IAAI,OAAO,CAAC;YACjB,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACxC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,YAAY;qBACpB,CAAC;iBACH,CAAC;SACH,CAAC;IACJ,CAAC;CACF"}

package/dist/interfaces/mcp/commands/FactEditCommand.d.ts

@@ -0,0 +1,43 @@
+import { BaseCommand } from './BaseCommand.js';
+import type { FactService } from '../../../application/services/FactService.js';
+export declare class FactEditCommand extends BaseCommand<any, any> {
+    private readonly factService;
+    readonly name = "kg_fact_edit";
+    readonly description = "Edit an existing fact's content. You must specify the node name, the old content to match, and the new content. The match must be exact.\n\nExamples:\n1. Update a fact:\n   { \"facts\": [{ \"node\": \"Alice\", \"old\": \"5 years experience\", \"new\": \"6 years experience\" }] }\n\n2. Update multiple facts:\n   { \"facts\": [{ \"node\": \"Alice\", \"old\": \"Junior Developer\", \"new\": \"Senior Developer\" }, { \"node\": \"TechCorp\", \"old\": \"500 employees\", \"new\": \"1000 employees\" }] }\n\n3. Correct a typo:\n   { \"facts\": [{ \"node\": \"ProjectX\", \"old\": \"Due Q2 2024\", \"new\": \"Completed on time!\" }] }";
+    readonly inputSchema: {
+        type: string;
+        properties: {
+            facts: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        node: {
+                            type: string;
+                            description: string;
+                        };
+                        old: {
+                            type: string;
+                            description: string;
+                        };
+                        new: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+        };
+        required: string[];
+    };
+    constructor(factService: FactService);
+    execute(input: any): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=FactEditCommand.d.ts.map

package/dist/interfaces/mcp/commands/FactEditCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactEditCommand.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/mcp/commands/FactEditCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAEhF,qBAAa,eAAgB,SAAQ,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC;IAiC5C,OAAO,CAAC,QAAQ,CAAC,WAAW;IAhCxC,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,2nBAUuE;IAC3F,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;MAkBlB;gBAE2B,WAAW,EAAE,WAAW;IAI/C,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAgCvF"}

package/dist/interfaces/mcp/commands/FactEditCommand.js

@@ -0,0 +1,68 @@
+import { BaseCommand } from './BaseCommand.js';
+export class FactEditCommand extends BaseCommand {
+    factService;
+    name = 'kg_fact_edit';
+    description = `Edit an existing fact's content. You must specify the node name, the old content to match, and the new content. The match must be exact.
+
+Examples:
+1. Update a fact:
+   { "facts": [{ "node": "Alice", "old": "5 years experience", "new": "6 years experience" }] }
+
+2. Update multiple facts:
+   { "facts": [{ "node": "Alice", "old": "Junior Developer", "new": "Senior Developer" }, { "node": "TechCorp", "old": "500 employees", "new": "1000 employees" }] }
+
+3. Correct a typo:
+   { "facts": [{ "node": "ProjectX", "old": "Due Q2 2024", "new": "Completed on time!" }] }`;
+    inputSchema = {
+        type: 'object',
+        properties: {
+            facts: {
+                type: 'array',
+                description: 'Array of facts to edit. Each item identifies a fact by node and old content, then provides new content.',
+                items: {
+                    type: 'object',
+                    properties: {
+                        node: { type: 'string', description: 'Name of the node containing the fact' },
+                        old: { type: 'string', description: 'Current content to match exactly' },
+                        new: { type: 'string', description: 'New content to replace with' },
+                    },
+                    required: ['node', 'old', 'new'],
+                },
+            },
+        },
+        required: ['facts'],
+    };
+    constructor(factService) {
+        super();
+        this.factService = factService;
+    }
+    async execute(input) {
+        // Validate array parameters
+        this.validateArray(input.facts, 'facts', {
+            description: 'Provide an array of facts to edit',
+            example: '{"facts": [{"node": "Alice", "old": "old content", "new": "new content"}]}',
+        });
+        // Map 'node'/'old'/'new' to 'nodeName'/'oldContent'/'newContent'
+        const edits = input.facts.map((fact) => ({
+            nodeName: fact.node,
+            oldContent: fact.old,
+            newContent: fact.new,
+        }));
+        const facts = await this.factService.updateFactsByContent(edits);
+        const entityIds = Array.from(new Set(facts.map(f => f.nodeId)));
+        const nodeMap = await this.factService.getNodeNameMap(entityIds);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        updated: facts.length,
+                        facts: facts.map(f => ({
+                            node: nodeMap.get(f.nodeId) || '',
+                            content: f.content,
+                        })),
+                    }),
+                }],
+        };
+    }
+}
+//# sourceMappingURL=FactEditCommand.js.map

package/dist/interfaces/mcp/commands/FactEditCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactEditCommand.js","sourceRoot":"","sources":["../../../../src/interfaces/mcp/commands/FactEditCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,MAAM,OAAO,eAAgB,SAAQ,WAAqB;IAiC3B;IAhCpB,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAAG;;;;;;;;;;4FAUmE,CAAC;IAClF,WAAW,GAAG;QACrB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,yGAAyG;gBACtH,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;wBAC7E,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;wBACxE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;qBACpE;oBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;iBACjC;aACF;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC;IAEF,YAA6B,WAAwB;QACnD,KAAK,EAAE,CAAC;QADmB,gBAAW,GAAX,WAAW,CAAa;IAErD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAU;QACtB,4BAA4B;QAC5B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE;YACvC,WAAW,EAAE,mCAAmC;YAChD,OAAO,EAAE,4EAA4E;SACtF,CAAC,CAAC;QAEH,iEAAiE;QACjE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC;YAC5C,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,UAAU,EAAE,IAAI,CAAC,GAAG;YACpB,UAAU,EAAE,IAAI,CAAC,GAAG;SACrB,CAAC,CAAC,CAAC;QAEJ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAEjE,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAEjE,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK,CAAC,MAAM;wBACrB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;4BACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;4BACjC,OAAO,EAAE,CAAC,CAAC,OAAO;yBACnB,CAAC,CAAC;qBACJ,CAAC;iBACH,CAAC;SACH,CAAC;IACJ,CAAC;CACF"}