@andespindola/brainlink 0.1.0-beta.1 → 0.1.0-beta.11

package/dist/infrastructure/sqlite-index.js

@@ -1,23 +1,36 @@
-import Database from 'better-sqlite3';
 import { chmodSync } from 'node:fs';
 import { join } from 'node:path';
 import { createIndexWriter } from './sqlite/document-writer.js';
 import { createGraphReader } from './sqlite/graph-reader.js';
+import { createRecoverySnapshot, openDatabaseWithRecovery } from './sqlite/recovery.js';
 import { createSchema } from './sqlite/schema.js';
 import { createSearchReader } from './sqlite/search-reader.js';
 export const openSqliteIndex = (vaultPath) => {
     const databasePath = join(vaultPath, '.brainlink', 'brainlink.db');
-    const database = new Database(databasePath);
+    const backupPath = join(vaultPath, '.brainlink', 'brainlink.db.backup');
+    const database = openDatabaseWithRecovery(databasePath, backupPath);
+    const indexWriter = createIndexWriter(database);
     chmodSync(databasePath, 0o600);
     database.exec(`
     PRAGMA foreign_keys = ON;
     PRAGMA journal_mode = WAL;
     PRAGMA synchronous = NORMAL;
     PRAGMA temp_store = MEMORY;
+    PRAGMA busy_timeout = 5000;
+    PRAGMA cache_size = -20000;
   `);
     createSchema(database);
     return {
-        ...createIndexWriter(database),
+        reset: () => indexWriter.reset(),
+        saveDocuments: (documents) => {
+            indexWriter.saveDocuments(documents);
+            try {
+                createRecoverySnapshot(database, backupPath);
+            }
+            catch {
+                // Snapshot creation is best-effort. Indexing success should not fail because of backup I/O.
+            }
+        },
         ...createSearchReader(database),
         ...createGraphReader(database),
         close: () => database.close()

package/dist/mcp/main.js

@@ -1,9 +1,17 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { createBrainlinkMcpServer } from './server.js';
-const server = createBrainlinkMcpServer();
-const transport = new StdioServerTransport();
-server.connect(transport).catch((error) => {
+import { runStartupBootstrap } from './startup.js';
+const start = async () => {
+    const startup = await runStartupBootstrap();
+    if (startup.error) {
+        console.error(`Brainlink MCP startup bootstrap warning: ${startup.error}`);
+    }
+    const server = createBrainlinkMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+};
+start().catch((error) => {
     const message = error instanceof Error ? error.message : String(error);
     console.error(message);
     process.exitCode = 1;

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, 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', {

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)
+        };
+    }
+};