@prih/mcp-graph-memory 1.0.3

package/dist/api/tools/skills/create-skill.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('create_skill', {
+        description: 'Create a new skill (reusable recipe/procedure) in the skill graph. ' +
+            'The skill is automatically embedded for semantic search. ' +
+            'Returns the generated skillId (slug from title). ' +
+            'Use link_skill to connect skills, or create_skill_link to link to docs/code/files/knowledge/tasks.',
+        inputSchema: {
+            title: zod_1.z.string().describe('Short title for the skill, e.g. "Deploy to staging"'),
+            description: zod_1.z.string().describe('Full description of the skill (markdown)'),
+            steps: zod_1.z.array(zod_1.z.string()).optional().describe('Ordered steps to execute this skill (default [])'),
+            triggers: zod_1.z.array(zod_1.z.string()).optional().describe('Conditions or cues that suggest using this skill (default [])'),
+            inputHints: zod_1.z.array(zod_1.z.string()).optional().describe('Expected inputs or prerequisites (default [])'),
+            filePatterns: zod_1.z.array(zod_1.z.string()).optional().describe('Glob patterns for files this skill applies to (default [])'),
+            tags: zod_1.z.array(zod_1.z.string()).optional().describe('Optional tags for filtering, e.g. ["deploy", "ci"]'),
+            source: zod_1.z.enum(['user', 'learned']).optional().describe('How this skill was created (default "user")'),
+            confidence: zod_1.z.number().min(0).max(1).optional().describe('Confidence score 0–1 (default 1)'),
+        },
+    }, async ({ title, description, steps, triggers, inputHints, filePatterns, tags, source, confidence }) => {
+        const skillId = await mgr.createSkill(title, description, steps ?? [], triggers ?? [], inputHints ?? [], filePatterns ?? [], tags ?? [], source ?? 'user', confidence ?? 1);
+        return { content: [{ type: 'text', text: JSON.stringify({ skillId }, null, 2) }] };
+    });
+}

package/dist/api/tools/skills/delete-skill-link.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('delete_skill_link', {
+        description: 'Remove a cross-graph link from a skill to a node in the docs, code, files, knowledge, or tasks graph. ' +
+            'Orphaned proxy nodes are cleaned up automatically.',
+        inputSchema: {
+            skillId: zod_1.z.string().describe('Source skill ID'),
+            targetId: zod_1.z.string().describe('Target node ID in the external graph'),
+            targetGraph: zod_1.z.enum(['docs', 'code', 'files', 'knowledge', 'tasks'])
+                .describe('Which graph the target belongs to'),
+            projectId: zod_1.z.string().optional().describe('Project ID that the target node belongs to. Defaults to the current project.'),
+        },
+    }, async ({ skillId, targetId, targetGraph, projectId }) => {
+        const deleted = mgr.deleteCrossLink(skillId, targetId, targetGraph, projectId);
+        if (!deleted) {
+            return { content: [{ type: 'text', text: 'Cross-graph link not found.' }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({ skillId, targetId, targetGraph, deleted: true }, null, 2) }] };
+    });
+}

package/dist/api/tools/skills/delete-skill.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('delete_skill', {
+        description: 'Delete a skill and all its edges (relations, cross-graph links). ' +
+            'Orphaned proxy nodes are cleaned up automatically. ' +
+            'This action is irreversible.',
+        inputSchema: {
+            skillId: zod_1.z.string().describe('Skill ID to delete'),
+        },
+    }, async ({ skillId }) => {
+        const deleted = mgr.deleteSkill(skillId);
+        if (!deleted) {
+            return { content: [{ type: 'text', text: `Skill "${skillId}" not found.` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({ skillId, deleted: true }, null, 2) }] };
+    });
+}

package/dist/api/tools/skills/find-linked-skills.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('find_linked_skills', {
+        description: 'Find all skills that link to a specific node in the docs, code, files, knowledge, or tasks graph. ' +
+            'This is a reverse lookup — given a target, returns all skills that reference it. ' +
+            'Returns an array of { skillId, title, kind, source, confidence, tags }. ' +
+            'Use get_skill to fetch full content of a returned skill.',
+        inputSchema: {
+            targetGraph: zod_1.z.enum(['docs', 'code', 'files', 'knowledge', 'tasks'])
+                .describe('Which graph the target belongs to'),
+            targetNodeId: zod_1.z.string().describe('Target node ID in the external graph'),
+            kind: zod_1.z.string().optional().describe('Filter by relation kind. If omitted, returns all relations.'),
+            projectId: zod_1.z.string().optional().describe('Project ID that the target node belongs to. Defaults to the current project.'),
+        },
+    }, async ({ targetGraph, targetNodeId, kind, projectId }) => {
+        const results = mgr.findLinkedSkills(targetGraph, targetNodeId, kind, projectId);
+        if (results.length === 0) {
+            return { content: [{ type: 'text', text: `No skills linked to ${targetGraph}::${targetNodeId}` }] };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
+    });
+}

package/dist/api/tools/skills/get-skill.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('get_skill', {
+        description: 'Get full details of a skill by ID, including steps, triggers, inputHints, filePatterns, ' +
+            'usage stats, and cross-graph links. ' +
+            'Returns: id, title, description, steps, triggers, inputHints, filePatterns, tags, ' +
+            'source, confidence, usageCount, lastUsedAt, createdAt, updatedAt, crossLinks[].',
+        inputSchema: {
+            skillId: zod_1.z.string().describe('Skill ID to retrieve'),
+        },
+    }, async ({ skillId }) => {
+        const skill = mgr.getSkill(skillId);
+        if (!skill) {
+            return { content: [{ type: 'text', text: `Skill "${skillId}" not found.` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(skill, null, 2) }] };
+    });
+}

package/dist/api/tools/skills/link-skill.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('link_skill', {
+        description: 'Create a directed relation between two skills. ' +
+            '"depends_on": fromId depends on toId. ' +
+            '"related_to": free association between skills. ' +
+            '"variant_of": fromId is a variant of toId.',
+        inputSchema: {
+            fromId: zod_1.z.string().describe('Source skill ID'),
+            toId: zod_1.z.string().describe('Target skill ID'),
+            kind: zod_1.z.enum(['depends_on', 'related_to', 'variant_of']).describe('Relation type'),
+        },
+    }, async ({ fromId, toId, kind }) => {
+        const created = mgr.linkSkills(fromId, toId, kind);
+        if (!created) {
+            return { content: [{ type: 'text', text: 'Could not create relation — one or both skills not found, or relation already exists.' }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({ fromId, toId, kind, created: true }, null, 2) }] };
+    });
+}

package/dist/api/tools/skills/list-skills.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('list_skills', {
+        description: 'List skills with optional filters. ' +
+            'Returns an array of { id, title, description, tags, source, confidence, usageCount, lastUsedAt, createdAt, updatedAt }. ' +
+            'Use search_skills for semantic search.',
+        inputSchema: {
+            source: zod_1.z.enum(['user', 'learned']).optional().describe('Filter by source'),
+            tag: zod_1.z.string().optional().describe('Filter by tag (exact match, case-insensitive)'),
+            filter: zod_1.z.string().optional().describe('Substring match on title or ID'),
+            limit: zod_1.z.number().optional().describe('Max results (default 50)'),
+        },
+    }, async ({ source, tag, filter, limit }) => {
+        const results = mgr.listSkills({ source, tag, filter, limit });
+        return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
+    });
+}

package/dist/api/tools/skills/recall-skills.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('recall_skills', {
+        description: 'Recall relevant skills for a given task context. Like search_skills but with lower ' +
+            'minScore default (0.3) for higher recall. Use at the start of a task to find applicable recipes.',
+        inputSchema: {
+            context: zod_1.z.string().describe('Description of the current task or context to match skills against'),
+            topK: zod_1.z.number().optional().describe('How many top similar skills to use as seeds (default 5)'),
+            minScore: zod_1.z.number().min(0).max(1).optional().describe('Minimum relevance score 0–1 (default 0.3)'),
+        },
+    }, async ({ context, topK, minScore }) => {
+        const results = await mgr.searchSkills(context, { topK, minScore: minScore ?? 0.3 });
+        return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
+    });
+}

package/dist/api/tools/skills/remove-attachment.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('remove_skill_attachment', {
+        description: 'Remove an attachment from a skill. The file is deleted from disk.',
+        inputSchema: {
+            skillId: zod_1.z.string().describe('ID of the skill'),
+            filename: zod_1.z.string().describe('Filename of the attachment to remove'),
+        },
+    }, async ({ skillId, filename }) => {
+        const ok = mgr.removeAttachment(skillId, filename);
+        if (!ok) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: 'Attachment not found' }) }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({ deleted: filename }) }] };
+    });
+}

package/dist/api/tools/skills/search-skills.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('search_skills', {
+        description: 'Semantic search over the skill graph. ' +
+            'Finds the most relevant skills using vector similarity, then expands results ' +
+            'by traversing relations between skills (graph walk). ' +
+            'Returns an array sorted by relevance score (0–1), each with: ' +
+            'id, title, description, tags, source, confidence, score.',
+        inputSchema: {
+            query: zod_1.z.string().describe('Natural language search query'),
+            topK: zod_1.z.number().optional().describe('How many top similar skills to use as seeds (default 5)'),
+            bfsDepth: zod_1.z.number().optional().describe('How many hops to follow relations from each seed (default 1; 0 = no expansion)'),
+            maxResults: zod_1.z.number().optional().describe('Maximum number of results to return (default 20)'),
+            minScore: zod_1.z.number().min(0).max(1).optional().describe('Minimum relevance score 0–1 (default 0.5)'),
+            bfsDecay: zod_1.z.number().min(0).max(1).optional().describe('Score multiplier per hop (default 0.8)'),
+            searchMode: zod_1.z.enum(['hybrid', 'vector', 'keyword']).optional().describe('Search mode: hybrid (default, BM25 + vector), vector (embedding only), keyword (BM25 only)'),
+        },
+    }, async ({ query, topK, bfsDepth, maxResults, minScore, bfsDecay, searchMode }) => {
+        const results = await mgr.searchSkills(query, { topK, bfsDepth, maxResults, minScore, bfsDecay, searchMode });
+        return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
+    });
+}

package/dist/api/tools/skills/update-skill.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+const manager_types_1 = require("../../../graphs/manager-types");
+function register(server, mgr) {
+    server.registerTool('update_skill', {
+        description: 'Update an existing skill. Only provided fields are changed. ' +
+            'Re-embeds automatically when title or description changes. ' +
+            'Pass expectedVersion to enable optimistic locking.',
+        inputSchema: {
+            skillId: zod_1.z.string().describe('Skill ID to update'),
+            title: zod_1.z.string().optional().describe('New title'),
+            description: zod_1.z.string().optional().describe('New description'),
+            steps: zod_1.z.array(zod_1.z.string()).optional().describe('Replace steps array'),
+            triggers: zod_1.z.array(zod_1.z.string()).optional().describe('Replace triggers array'),
+            inputHints: zod_1.z.array(zod_1.z.string()).optional().describe('Replace inputHints array'),
+            filePatterns: zod_1.z.array(zod_1.z.string()).optional().describe('Replace filePatterns array'),
+            tags: zod_1.z.array(zod_1.z.string()).optional().describe('Replace tags array'),
+            source: zod_1.z.enum(['user', 'learned']).optional().describe('New source'),
+            confidence: zod_1.z.number().min(0).max(1).optional().describe('New confidence score 0–1'),
+            expectedVersion: zod_1.z.number().int().positive().optional().describe('Current version for optimistic locking — request fails with version_conflict if the skill has been updated since'),
+        },
+    }, async ({ skillId, title, description, steps, triggers, inputHints, filePatterns, tags, source, confidence, expectedVersion }) => {
+        const patch = {};
+        if (title !== undefined)
+            patch.title = title;
+        if (description !== undefined)
+            patch.description = description;
+        if (steps !== undefined)
+            patch.steps = steps;
+        if (triggers !== undefined)
+            patch.triggers = triggers;
+        if (inputHints !== undefined)
+            patch.inputHints = inputHints;
+        if (filePatterns !== undefined)
+            patch.filePatterns = filePatterns;
+        if (tags !== undefined)
+            patch.tags = tags;
+        if (source !== undefined)
+            patch.source = source;
+        if (confidence !== undefined)
+            patch.confidence = confidence;
+        try {
+            const updated = await mgr.updateSkill(skillId, patch, expectedVersion);
+            if (!updated) {
+                return { content: [{ type: 'text', text: `Skill "${skillId}" not found.` }], isError: true };
+            }
+            return { content: [{ type: 'text', text: JSON.stringify({ skillId, updated: true }, null, 2) }] };
+        }
+        catch (err) {
+            if (err instanceof manager_types_1.VersionConflictError) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: 'version_conflict', current: err.current, expected: err.expected }) }], isError: true };
+            }
+            throw err;
+        }
+    });
+}

package/dist/api/tools/tasks/add-attachment.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('add_task_attachment', {
+        description: 'Attach a file to a task. Provide the absolute path to a local file. ' +
+            'The file is copied into the task directory (.tasks/{taskId}/). ' +
+            'Returns attachment metadata (filename, mimeType, size).',
+        inputSchema: {
+            taskId: zod_1.z.string().describe('ID of the task to attach the file to'),
+            filePath: zod_1.z.string().describe('Absolute path to the file on disk'),
+        },
+    }, async ({ taskId, filePath }) => {
+        if (!fs_1.default.existsSync(filePath)) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: 'File not found' }) }], isError: true };
+        }
+        const data = fs_1.default.readFileSync(filePath);
+        const filename = path_1.default.basename(filePath);
+        const meta = mgr.addAttachment(taskId, filename, data);
+        if (!meta) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: 'Task not found or no project dir' }) }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(meta, null, 2) }] };
+    });
+}

package/dist/api/tools/tasks/create-task-link.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('create_task_link', {
+        description: 'Link a task to a node in the docs, code, files, or knowledge graph. ' +
+            'Creates a cross-graph relation from the task to the target node. ' +
+            'The kind is a free-form string, e.g. "references", "fixes", "implements", "documents".',
+        inputSchema: {
+            taskId: zod_1.z.string().describe('Source task ID'),
+            targetId: zod_1.z.string().describe('Target node ID in the external graph (e.g. "src/auth.ts::login", "api.md::Setup", "my-note")'),
+            targetGraph: zod_1.z.enum(['docs', 'code', 'files', 'knowledge'])
+                .describe('Which graph the target belongs to'),
+            kind: zod_1.z.string().describe('Relation type, e.g. "references", "fixes", "implements"'),
+            projectId: zod_1.z.string().optional().describe('Project ID that the target node belongs to. Defaults to the current project.'),
+        },
+    }, async ({ taskId, targetId, targetGraph, kind, projectId }) => {
+        const created = mgr.createCrossLink(taskId, targetId, targetGraph, kind, projectId);
+        if (!created) {
+            return { content: [{ type: 'text', text: `Could not create cross-graph link — task not found, target not found in ${targetGraph} graph, or link already exists.` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({ taskId, targetId, targetGraph, kind, created: true }, null, 2) }] };
+    });
+}

package/dist/api/tools/tasks/create-task.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('create_task', {
+        description: 'Create a new task in the task graph. ' +
+            'The task is automatically embedded for semantic search. ' +
+            'Returns the generated taskId (slug from title). ' +
+            'Use link_task to connect tasks, or create_task_link to link to docs/code/files/knowledge.',
+        inputSchema: {
+            title: zod_1.z.string().describe('Short title for the task, e.g. "Fix auth redirect loop"'),
+            description: zod_1.z.string().describe('Full description of the task (markdown)'),
+            priority: zod_1.z.enum(['critical', 'high', 'medium', 'low']).describe('Task priority'),
+            status: zod_1.z.enum(['backlog', 'todo', 'in_progress', 'review', 'done', 'cancelled']).optional()
+                .describe('Initial status (default "backlog")'),
+            tags: zod_1.z.array(zod_1.z.string()).optional().describe('Optional tags for filtering, e.g. ["bug", "auth"]'),
+            dueDate: zod_1.z.number().optional().describe('Due date as Unix timestamp in milliseconds'),
+            estimate: zod_1.z.number().optional().describe('Estimated effort in hours'),
+        },
+    }, async ({ title, description, priority, status, tags, dueDate, estimate }) => {
+        const taskId = await mgr.createTask(title, description, status ?? 'backlog', priority, tags ?? [], dueDate ?? null, estimate ?? null);
+        return { content: [{ type: 'text', text: JSON.stringify({ taskId }, null, 2) }] };
+    });
+}

package/dist/api/tools/tasks/delete-task-link.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('delete_task_link', {
+        description: 'Remove a cross-graph link from a task to a node in the docs, code, files, or knowledge graph. ' +
+            'Orphaned proxy nodes are cleaned up automatically.',
+        inputSchema: {
+            taskId: zod_1.z.string().describe('Source task ID'),
+            targetId: zod_1.z.string().describe('Target node ID in the external graph'),
+            targetGraph: zod_1.z.enum(['docs', 'code', 'files', 'knowledge'])
+                .describe('Which graph the target belongs to'),
+            projectId: zod_1.z.string().optional().describe('Project ID that the target node belongs to. Defaults to the current project.'),
+        },
+    }, async ({ taskId, targetId, targetGraph, projectId }) => {
+        const deleted = mgr.deleteCrossLink(taskId, targetId, targetGraph, projectId);
+        if (!deleted) {
+            return { content: [{ type: 'text', text: 'Cross-graph link not found.' }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({ taskId, targetId, targetGraph, deleted: true }, null, 2) }] };
+    });
+}

package/dist/api/tools/tasks/delete-task.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('delete_task', {
+        description: 'Delete a task and all its edges (relations, cross-graph links). ' +
+            'Orphaned proxy nodes are cleaned up automatically. ' +
+            'This action is irreversible.',
+        inputSchema: {
+            taskId: zod_1.z.string().describe('Task ID to delete'),
+        },
+    }, async ({ taskId }) => {
+        const deleted = mgr.deleteTask(taskId);
+        if (!deleted) {
+            return { content: [{ type: 'text', text: `Task "${taskId}" not found.` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({ taskId, deleted: true }, null, 2) }] };
+    });
+}

package/dist/api/tools/tasks/find-linked-tasks.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('find_linked_tasks', {
+        description: 'Find all tasks that link to a specific node in the docs, code, files, or knowledge graph. ' +
+            'This is a reverse lookup — given a target, returns all tasks that reference it. ' +
+            'Returns an array of { taskId, title, kind, status, priority, tags }. ' +
+            'Use get_task to fetch full content of a returned task.',
+        inputSchema: {
+            targetId: zod_1.z.string().describe('Target node ID in the external graph'),
+            targetGraph: zod_1.z.enum(['docs', 'code', 'files', 'knowledge'])
+                .describe('Which graph the target belongs to'),
+            kind: zod_1.z.string().optional().describe('Filter by relation kind. If omitted, returns all relations.'),
+            projectId: zod_1.z.string().optional().describe('Project ID that the target node belongs to. Defaults to the current project.'),
+        },
+    }, async ({ targetId, targetGraph, kind, projectId }) => {
+        const results = mgr.findLinkedTasks(targetGraph, targetId, kind, projectId);
+        if (results.length === 0) {
+            return { content: [{ type: 'text', text: `No tasks linked to ${targetGraph}::${targetId}` }] };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
+    });
+}

package/dist/api/tools/tasks/get-task.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('get_task', {
+        description: 'Get full details of a task by ID, including subtasks, blockers, related tasks, and cross-graph links. ' +
+            'Returns: id, title, description, status, priority, tags, dueDate, estimate, ' +
+            'completedAt, createdAt, updatedAt, subtasks[], blockedBy[], blocks[], related[], crossLinks[].',
+        inputSchema: {
+            taskId: zod_1.z.string().describe('Task ID to retrieve'),
+        },
+    }, async ({ taskId }) => {
+        const task = mgr.getTask(taskId);
+        if (!task) {
+            return { content: [{ type: 'text', text: `Task "${taskId}" not found.` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(task, null, 2) }] };
+    });
+}

package/dist/api/tools/tasks/link-task.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('link_task', {
+        description: 'Create a directed relation between two tasks. ' +
+            '"subtask_of": fromId is a subtask of toId. ' +
+            '"blocks": fromId blocks toId. ' +
+            '"related_to": free association between tasks.',
+        inputSchema: {
+            fromId: zod_1.z.string().describe('Source task ID'),
+            toId: zod_1.z.string().describe('Target task ID'),
+            kind: zod_1.z.enum(['subtask_of', 'blocks', 'related_to']).describe('Relation type'),
+        },
+    }, async ({ fromId, toId, kind }) => {
+        const created = mgr.linkTasks(fromId, toId, kind);
+        if (!created) {
+            return { content: [{ type: 'text', text: 'Could not create relation — one or both tasks not found, or relation already exists.' }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({ fromId, toId, kind, created: true }, null, 2) }] };
+    });
+}

package/dist/api/tools/tasks/list-tasks.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('list_tasks', {
+        description: 'List tasks with optional filters. ' +
+            'Sorted by priority (critical first) then due date (earliest first, nulls last). ' +
+            'Returns an array of { id, title, description, status, priority, tags, dueDate, estimate, completedAt, createdAt, updatedAt }. ' +
+            'Use search_tasks for semantic search.',
+        inputSchema: {
+            status: zod_1.z.enum(['backlog', 'todo', 'in_progress', 'review', 'done', 'cancelled']).optional()
+                .describe('Filter by status'),
+            priority: zod_1.z.enum(['critical', 'high', 'medium', 'low']).optional()
+                .describe('Filter by priority'),
+            tag: zod_1.z.string().optional().describe('Filter by tag (exact match, case-insensitive)'),
+            filter: zod_1.z.string().optional().describe('Substring match on title or ID'),
+            limit: zod_1.z.number().optional().describe('Max results (default 50)'),
+        },
+    }, async ({ status, priority, tag, filter, limit }) => {
+        const results = mgr.listTasks({ status, priority, tag, filter, limit });
+        return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
+    });
+}

package/dist/api/tools/tasks/move-task.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+const manager_types_1 = require("../../../graphs/manager-types");
+function register(server, mgr) {
+    server.registerTool('move_task', {
+        description: 'Change a task status. Automatically manages completedAt: ' +
+            'sets it when moving to "done" or "cancelled", clears it when reopening. ' +
+            'Returns the updated task summary. ' +
+            'Pass expectedVersion to enable optimistic locking.',
+        inputSchema: {
+            taskId: zod_1.z.string().describe('Task ID to move'),
+            status: zod_1.z.enum(['backlog', 'todo', 'in_progress', 'review', 'done', 'cancelled'])
+                .describe('New status'),
+            expectedVersion: zod_1.z.number().int().positive().optional().describe('Current version for optimistic locking — request fails with version_conflict if the task has been updated since'),
+        },
+    }, async ({ taskId, status, expectedVersion }) => {
+        try {
+            const moved = mgr.moveTask(taskId, status, expectedVersion);
+            if (!moved) {
+                return { content: [{ type: 'text', text: `Task "${taskId}" not found.` }], isError: true };
+            }
+            const task = mgr.getTask(taskId);
+            return { content: [{ type: 'text', text: JSON.stringify({
+                            taskId: task.id,
+                            status: task.status,
+                            completedAt: task.completedAt,
+                        }, null, 2) }] };
+        }
+        catch (err) {
+            if (err instanceof manager_types_1.VersionConflictError) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: 'version_conflict', current: err.current, expected: err.expected }) }], isError: true };
+            }
+            throw err;
+        }
+    });
+}

package/dist/api/tools/tasks/remove-attachment.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('remove_task_attachment', {
+        description: 'Remove an attachment from a task. The file is deleted from disk.',
+        inputSchema: {
+            taskId: zod_1.z.string().describe('ID of the task'),
+            filename: zod_1.z.string().describe('Filename of the attachment to remove'),
+        },
+    }, async ({ taskId, filename }) => {
+        const ok = mgr.removeAttachment(taskId, filename);
+        if (!ok) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: 'Attachment not found' }) }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({ deleted: filename }) }] };
+    });
+}

package/dist/api/tools/tasks/search-tasks.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const zod_1 = require("zod");
+function register(server, mgr) {
+    server.registerTool('search_tasks', {
+        description: 'Semantic search over the task graph. ' +
+            'Finds the most relevant tasks using vector similarity, then expands results ' +
+            'by traversing relations between tasks (graph walk). ' +
+            'Returns an array sorted by relevance score (0–1), each with: ' +
+            'id, title, description, status, priority, tags, score.',
+        inputSchema: {
+            query: zod_1.z.string().describe('Natural language search query'),
+            topK: zod_1.z.number().optional().describe('How many top similar tasks to use as seeds (default 5)'),
+            bfsDepth: zod_1.z.number().optional().describe('How many hops to follow relations from each seed (default 1; 0 = no expansion)'),
+            maxResults: zod_1.z.number().optional().describe('Maximum number of results to return (default 20)'),
+            minScore: zod_1.z.number().min(0).max(1).optional().describe('Minimum relevance score 0–1 (default 0.5)'),
+            bfsDecay: zod_1.z.number().min(0).max(1).optional().describe('Score multiplier per hop (default 0.8)'),
+            searchMode: zod_1.z.enum(['hybrid', 'vector', 'keyword']).optional().describe('Search mode: hybrid (default, BM25 + vector), vector (embedding only), keyword (BM25 only)'),
+        },
+    }, async ({ query, topK, bfsDepth, maxResults, minScore, bfsDecay, searchMode }) => {
+        const results = await mgr.searchTasks(query, { topK, bfsDepth, maxResults, minScore, bfsDecay, searchMode });
+        return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
+    });
+}