@andespindola/brainlink 0.1.0-beta.6 → 0.1.0-beta.61

package/dist/mcp/server.js

@@ -2,7 +2,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { addNoteInputSchema, addFileInputSchema, addFileTool, addNoteTool, brokenLinksInputSchema, brokenLinksTool, contextInputSchema, contextTool, graphInputSchema, graphTool, indexInputSchema, indexTool, orphansInputSchema, orphansTool, searchInputSchema, searchTool, statsInputSchema, statsTool, syncInputSchema, syncTool, validateInputSchema, validateTool } from './tools.js';
+import { addNoteInputSchema, addFileInputSchema, addFileTool, addNoteTool, dedupeInputSchema, dedupeResolveInputSchema, dedupeResolveTool, dedupeTool, brokenLinksInputSchema, brokenLinksTool, bootstrapInputSchema, bootstrapTool, contextInputSchema, contextTool, graphInputSchema, graphTool, indexInputSchema, indexTool, orphansInputSchema, orphansTool, policyInputSchema, policyTool, recommendationsInputSchema, recommendationsTool, searchInputSchema, searchTool, statsInputSchema, statsTool, syncInputSchema, syncTool, validateInputSchema, validateTool } from './tools.js';
 const readPackageVersion = () => {
     const packagePath = join(dirname(fileURLToPath(import.meta.url)), '../../package.json');
     const metadata = JSON.parse(readFileSync(packagePath, 'utf8'));
@@ -15,9 +15,24 @@ export const createBrainlinkMcpServer = () => {
         version: readPackageVersion(),
         description: 'Local-first Markdown memory tools for AI agents.'
     });
+    server.registerTool('brainlink_bootstrap', {
+        title: 'Bootstrap Brainlink For A Task (Default Entrypoint)',
+        description: 'Default entrypoint for agents. Run this first to index/check memory state, then optionally retrieve context for the current task query.',
+        inputSchema: bootstrapInputSchema
+    }, bootstrapTool);
+    server.registerTool('brainlink_policy', {
+        title: 'Brainlink Bootstrap Policy',
+        description: 'Read or update bootstrap enforcement policy and inspect bootstrap readiness for the current vault/agent.',
+        inputSchema: policyInputSchema
+    }, policyTool);
+    server.registerTool('brainlink_recommendations', {
+        title: 'Brainlink Recommended MCP Workflow',
+        description: 'Return a plug-and-play action plan for this vault/agent, including policy, bootstrap, context retrieval and durable write guidance.',
+        inputSchema: recommendationsInputSchema
+    }, recommendationsTool);
     server.registerTool('brainlink_context', {
         title: 'Build Brainlink Context',
-        description: 'Read indexed Brainlink memory for a task or question. This is read-only and does not create graph links.',
+        description: 'Read indexed Brainlink memory for a task or question. Usually called after brainlink_bootstrap. This is read-only and does not create graph links.',
         inputSchema: contextInputSchema
     }, contextTool);
     server.registerTool('brainlink_search', {
@@ -25,6 +40,16 @@ export const createBrainlinkMcpServer = () => {
         description: 'Search indexed Brainlink notes with FTS, semantic or hybrid retrieval.',
         inputSchema: searchInputSchema
     }, searchTool);
+    server.registerTool('brainlink_dedupe', {
+        title: 'Detect Duplicate Notes',
+        description: 'Detect possible duplicate notes using exact content hash and semantic similarity scoring.',
+        inputSchema: dedupeInputSchema
+    }, dedupeTool);
+    server.registerTool('brainlink_resolve_duplicate', {
+        title: 'Resolve Duplicate Notes',
+        description: 'Resolve a duplicate pair with merge, link or ignore. Non-merge actions still create low-priority related edges.',
+        inputSchema: dedupeResolveInputSchema
+    }, dedupeResolveTool);
     server.registerTool('brainlink_add_note', {
         title: 'Add Brainlink Note',
         description: 'Write durable Markdown memory, then reindex the vault. Include explicit [[wiki links]] for connected graph memory. Add priority markers near links, such as priority: high, #important or #critical, when a relationship should be weighted higher.',

package/dist/mcp/startup.js

@@ -0,0 +1,35 @@
+import { indexVault } from '../application/index-vault.js';
+import { loadBrainlinkConfig } from '../infrastructure/config.js';
+import { assertVaultAllowed } from '../infrastructure/file-system-vault.js';
+import { getBootstrapPolicy, touchBootstrapSession } from '../infrastructure/session-state.js';
+export const runStartupBootstrap = async () => {
+    try {
+        const policy = await getBootstrapPolicy();
+        if (!policy.autoBootstrapOnStartup) {
+            return {
+                attempted: false,
+                skipped: true,
+                reason: 'autoBootstrapOnStartup=false'
+            };
+        }
+        const config = await loadBrainlinkConfig();
+        const vault = assertVaultAllowed(config.vault, config.allowedVaults);
+        const agent = config.defaultAgent;
+        const index = await indexVault(vault);
+        await touchBootstrapSession(vault, agent);
+        return {
+            attempted: true,
+            skipped: false,
+            vault,
+            agent: agent ?? '*',
+            index
+        };
+    }
+    catch (error) {
+        return {
+            attempted: true,
+            skipped: false,
+            error: error instanceof Error ? error.message : String(error)
+        };
+    }
+};