@borntorecycle/mcp-the-brain 0.1.0

package/dist/src/store/markdownStore.js

@@ -0,0 +1,176 @@
+// ─── Markdown Store: Read/Write memory entry .md files ───
+import { readFileSync, writeFileSync, readdirSync, existsSync, mkdirSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import matter from 'gray-matter';
+/** Subdirectory names for each memory type */
+const TYPE_DIRS = {
+    'outcome': 'outcomes',
+    'pattern': 'patterns',
+    'module-knowledge': 'module-knowledge',
+};
+/**
+ * Parse the structured body sections from the markdown content.
+ */
+function parseBody(content) {
+    const titleMatch = content.match(/^## (.+)$/m);
+    const title = titleMatch ? titleMatch[1].trim() : '';
+    const extract = (label) => {
+        const re = new RegExp(`\\*\\*${label}:\\*\\*\\s*(.+?)(?=\\n\\*\\*[A-Z]|$)`, 's');
+        const m = content.match(re);
+        return m ? m[1].trim() : '';
+    };
+    return {
+        title,
+        context: extract('Context'),
+        result: extract('Result'),
+        reason: extract('Reason'),
+        lesson: extract('Lesson'),
+        action: extract('Action'),
+    };
+}
+/**
+ * Read a single memory entry from a .md file.
+ */
+export function readEntry(filePath, source) {
+    const raw = readFileSync(filePath, 'utf-8');
+    const { data, content } = matter(raw);
+    const frontmatter = data;
+    const body = parseBody(content);
+    return {
+        frontmatter,
+        body,
+        rawContent: content,
+        filePath,
+        source,
+    };
+}
+/**
+ * Read all memory entries from a memory root directory.
+ */
+export function readAllEntries(memoryRoot, source) {
+    const entries = [];
+    for (const typeDir of Object.values(TYPE_DIRS)) {
+        const dirPath = join(memoryRoot, typeDir);
+        if (!existsSync(dirPath))
+            continue;
+        const files = readdirSync(dirPath).filter(f => f.endsWith('.md'));
+        for (const file of files) {
+            try {
+                entries.push(readEntry(join(dirPath, file), source));
+            }
+            catch (err) {
+                // Skip malformed files with a warning to stderr (safe for stdio MCP)
+                process.stderr.write(`⚠ Skipping malformed entry ${file}: ${err.message}\n`);
+            }
+        }
+    }
+    return entries;
+}
+/**
+ * Write a new memory entry as a .md file.
+ * Returns the relative file path within the memory root.
+ */
+export function writeEntry(memoryRoot, frontmatter, body) {
+    const typeDir = TYPE_DIRS[frontmatter.type];
+    const dirPath = join(memoryRoot, typeDir);
+    // Auto-create directory if needed
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+    const fileName = `${frontmatter.id}.md`;
+    const filePath = join(dirPath, fileName);
+    // Check for duplicate ID
+    if (existsSync(filePath)) {
+        throw new Error(`Entry ID ${frontmatter.id} already exists at ${filePath}`);
+    }
+    const mdContent = buildMarkdown(frontmatter, body);
+    writeFileSync(filePath, mdContent, 'utf-8');
+    return join(typeDir, fileName);
+}
+/**
+ * Update an existing memory entry's frontmatter and/or body.
+ */
+export function updateEntryFile(memoryRoot, id, updates) {
+    // Find the entry file
+    const entry = findEntryById(memoryRoot, id, 'project');
+    if (!entry) {
+        throw new Error(`Entry ${id} not found in ${memoryRoot}`);
+    }
+    const newFrontmatter = { ...entry.frontmatter, ...pickFrontmatterFields(updates) };
+    const newBody = { ...entry.body, ...pickBodyFields(updates) };
+    // Validate superseded-by constraint
+    if (newFrontmatter.status === 'superseded' && !newFrontmatter['superseded-by']) {
+        throw new Error(`Cannot set status to "superseded" without providing "superseded-by" ID.`);
+    }
+    const mdContent = buildMarkdown(newFrontmatter, newBody);
+    writeFileSync(entry.filePath, mdContent, 'utf-8');
+}
+/**
+ * Find an entry by ID across the type directories.
+ */
+export function findEntryById(memoryRoot, id, source) {
+    for (const typeDir of Object.values(TYPE_DIRS)) {
+        const filePath = join(memoryRoot, typeDir, `${id}.md`);
+        if (existsSync(filePath)) {
+            return readEntry(filePath, source);
+        }
+    }
+    return null;
+}
+/**
+ * Get the relative file path for an entry within the memory root.
+ */
+export function getEntryRelativePath(memoryRoot, entry) {
+    return relative(memoryRoot, entry.filePath).replace(/\\/g, '/');
+}
+// ─── Internal helpers ───
+function buildMarkdown(fm, body) {
+    const yamlObj = {
+        id: fm.id,
+        type: fm.type,
+        date: fm.date,
+        subsystems: fm.subsystems,
+        tags: fm.tags,
+        'related-adrs': fm['related-adrs'],
+        status: fm.status,
+        confidence: fm.confidence,
+        'superseded-by': fm['superseded-by'],
+    };
+    if (fm.project) {
+        yamlObj.project = fm.project;
+    }
+    const frontStr = matter.stringify('', yamlObj).trim();
+    const bodyStr = [
+        `## ${body.title}`,
+        '',
+        `**Context:** ${body.context}`,
+        `**Result:** ${body.result}`,
+        `**Reason:** ${body.reason}`,
+        `**Lesson:** ${body.lesson}`,
+        `**Action:** ${body.action}`,
+        '',
+    ].join('\n');
+    return `${frontStr}\n${bodyStr}`;
+}
+function pickFrontmatterFields(obj) {
+    const keys = [
+        'id', 'type', 'date', 'subsystems', 'tags', 'related-adrs',
+        'status', 'confidence', 'superseded-by', 'project',
+    ];
+    const result = {};
+    for (const k of keys) {
+        if (k in obj)
+            result[k] = obj[k];
+    }
+    return result;
+}
+function pickBodyFields(obj) {
+    const keys = ['title', 'context', 'result', 'reason', 'lesson', 'action'];
+    const result = {};
+    for (const k of keys) {
+        if (k in obj)
+            result[k] = obj[k];
+    }
+    return result;
+}
+//# sourceMappingURL=markdownStore.js.map

package/dist/src/store/markdownStore.js.map

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

package/dist/src/store/vectorStore.d.ts

@@ -0,0 +1,26 @@
+import type { BrainConfig, VectorSearchResult, DegradationInfo } from '../types.js';
+/**
+ * Check if Ollama is reachable.
+ */
+export declare function isOllamaAvailable(): Promise<boolean>;
+/**
+ * Generate an embedding vector using Ollama.
+ */
+export declare function embed(text: string, model: string): Promise<number[] | null>;
+/**
+ * Build the embedding text for a memory entry.
+ */
+export declare function buildEmbeddingText(title: string, context: string, result: string, lesson: string): string;
+/**
+ * Upsert a vector into the LanceDB table.
+ */
+export declare function upsertVector(memoryRoot: string, id: string, vector: number[]): Promise<boolean>;
+/**
+ * Search for similar vectors.
+ */
+export declare function vectorSearch(memoryRoot: string, queryVector: number[], limit?: number): Promise<VectorSearchResult[]>;
+/**
+ * Check degradation status.
+ */
+export declare function checkDegradation(config: BrainConfig): Promise<DegradationInfo>;
+//# sourceMappingURL=vectorStore.d.ts.map

package/dist/src/store/vectorStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectorStore.d.ts","sourceRoot":"","sources":["../../../src/store/vectorStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAsBpF;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAS1D;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAoBjF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzG;AA2BD;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,OAAO,CAAC,CA8BlB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,GAAE,MAAU,GAChB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAsB/B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAcpF"}

package/dist/src/store/vectorStore.js

@@ -0,0 +1,164 @@
+// ─── Vector Store: LanceDB + Ollama embeddings ───
+// Optional — degrades gracefully if dependencies or Ollama are unavailable.
+/** Embedding vector dimension for nomic-embed-text */
+const EMBEDDING_DIM = 768;
+/** Ollama local API endpoint */
+const OLLAMA_URL = 'http://localhost:11434';
+// LanceDB is an optional dependency — loaded dynamically
+let lancedb = null;
+async function loadLanceDB() {
+    if (lancedb)
+        return lancedb;
+    try {
+        lancedb = await import('@lancedb/lancedb');
+        return lancedb;
+    }
+    catch {
+        process.stderr.write('⚠ @lancedb/lancedb not installed — vector search unavailable\n');
+        return null;
+    }
+}
+/**
+ * Check if Ollama is reachable.
+ */
+export async function isOllamaAvailable() {
+    try {
+        const res = await fetch(`${OLLAMA_URL}/api/tags`, {
+            signal: AbortSignal.timeout(2000),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Generate an embedding vector using Ollama.
+ */
+export async function embed(text, model) {
+    try {
+        const res = await fetch(`${OLLAMA_URL}/api/embeddings`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ model, prompt: text }),
+            signal: AbortSignal.timeout(10000),
+        });
+        if (!res.ok) {
+            process.stderr.write(`⚠ Ollama embedding failed: HTTP ${res.status}\n`);
+            return null;
+        }
+        const data = await res.json();
+        return data.embedding ?? null;
+    }
+    catch (err) {
+        process.stderr.write(`⚠ Ollama embedding error: ${err.message}\n`);
+        return null;
+    }
+}
+/**
+ * Build the embedding text for a memory entry.
+ */
+export function buildEmbeddingText(title, context, result, lesson) {
+    return [title, context, result, lesson].filter(Boolean).join(' | ');
+}
+/**
+ * Open or create a LanceDB table for a memory root.
+ * Returns null if LanceDB is not available.
+ */
+async function openTable(memoryRoot, tableName = 'memories') {
+    const lance = await loadLanceDB();
+    if (!lance)
+        return null;
+    const dbPath = `${memoryRoot}/.lance`;
+    try {
+        const db = await lance.connect(dbPath);
+        try {
+            return await db.openTable(tableName);
+        }
+        catch {
+            // Table doesn't exist yet — will be created on first upsert
+            return null;
+        }
+    }
+    catch (err) {
+        process.stderr.write(`⚠ LanceDB error: ${err.message}\n`);
+        return null;
+    }
+}
+/**
+ * Upsert a vector into the LanceDB table.
+ */
+export async function upsertVector(memoryRoot, id, vector) {
+    const lance = await loadLanceDB();
+    if (!lance)
+        return false;
+    const dbPath = `${memoryRoot}/.lance`;
+    try {
+        const db = await lance.connect(dbPath);
+        let table;
+        try {
+            table = await db.openTable('memories');
+        }
+        catch {
+            // Create table with first entry
+            await db.createTable('memories', [{ id, vector }]);
+            return true;
+        }
+        // Delete existing entry if present, then add
+        try {
+            await table.delete(`id = '${id}'`);
+        }
+        catch {
+            // Entry didn't exist — fine
+        }
+        await table.add([{ id, vector }]);
+        return true;
+    }
+    catch (err) {
+        process.stderr.write(`⚠ Vector upsert failed: ${err.message}\n`);
+        return false;
+    }
+}
+/**
+ * Search for similar vectors.
+ */
+export async function vectorSearch(memoryRoot, queryVector, limit = 5) {
+    const lance = await loadLanceDB();
+    if (!lance)
+        return [];
+    const dbPath = `${memoryRoot}/.lance`;
+    try {
+        const db = await lance.connect(dbPath);
+        const table = await db.openTable('memories');
+        const results = await table
+            .search(queryVector)
+            .limit(limit)
+            .toArray();
+        return results.map(r => ({
+            id: r.id,
+            score: r._distance != null ? 1 / (1 + r._distance) : 0,
+        }));
+    }
+    catch (err) {
+        process.stderr.write(`⚠ Vector search failed: ${err.message}\n`);
+        return [];
+    }
+}
+/**
+ * Check degradation status.
+ */
+export async function checkDegradation(config) {
+    const ollamaOk = await isOllamaAvailable();
+    const lance = await loadLanceDB();
+    if (!ollamaOk && !lance) {
+        return { degraded: true, reason: 'ollama_unavailable_and_lancedb_missing' };
+    }
+    if (!ollamaOk) {
+        return { degraded: true, reason: 'ollama_unavailable' };
+    }
+    if (!lance) {
+        return { degraded: true, reason: 'lancedb_missing' };
+    }
+    return { degraded: false };
+}
+//# sourceMappingURL=vectorStore.js.map

package/dist/src/store/vectorStore.js.map

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

package/dist/src/tools/listBySubsystem.d.ts

@@ -0,0 +1,15 @@
+import type { BrainConfig, IndexEntry } from '../types.js';
+export interface ListBySubsystemParams {
+    subsystem: string;
+    scope?: 'project' | 'shared' | 'all';
+}
+export interface ListBySubsystemResult {
+    entries: Array<IndexEntry & {
+        source: 'project' | 'shared';
+    }>;
+}
+/**
+ * Main list_by_subsystem implementation.
+ */
+export declare function listBySubsystem(cwd: string, config: BrainConfig, params: ListBySubsystemParams): ListBySubsystemResult;
+//# sourceMappingURL=listBySubsystem.d.ts.map

package/dist/src/tools/listBySubsystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listBySubsystem.d.ts","sourceRoot":"","sources":["../../../src/tools/listBySubsystem.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI3D,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,KAAK,CAAC,UAAU,GAAG;QAAE,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,qBAAqB,GAC5B,qBAAqB,CA4BvB"}

package/dist/src/tools/listBySubsystem.js

@@ -0,0 +1,28 @@
+// ─── Tool: list_by_subsystem — List all entries for a given module ───
+import { readIndex } from '../store/indexStore.js';
+import { resolveMemoryRoot, resolveSharedRoot } from '../config.js';
+/**
+ * Main list_by_subsystem implementation.
+ */
+export function listBySubsystem(cwd, config, params) {
+    const { subsystem, scope = 'all' } = params;
+    const results = [];
+    if (scope === 'project' || scope === 'all') {
+        const projectRoot = resolveMemoryRoot(cwd, config);
+        const projectIdx = readIndex(projectRoot);
+        results.push(...projectIdx
+            .filter(e => e.subsystems.includes(subsystem))
+            .map(e => ({ ...e, source: 'project' })));
+    }
+    if (scope === 'shared' || scope === 'all') {
+        const sharedRoot = resolveSharedRoot(config);
+        const sharedIdx = readIndex(sharedRoot);
+        results.push(...sharedIdx
+            .filter(e => e.subsystems.includes(subsystem))
+            .map(e => ({ ...e, source: 'shared' })));
+    }
+    // Sort by date descending
+    results.sort((a, b) => b.date.localeCompare(a.date));
+    return { entries: results };
+}
+//# sourceMappingURL=listBySubsystem.js.map

package/dist/src/tools/listBySubsystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listBySubsystem.js","sourceRoot":"","sources":["../../../src/tools/listBySubsystem.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAGxE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAWpE;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAW,EACX,MAAmB,EACnB,MAA6B;IAE7B,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;IAC5C,MAAM,OAAO,GAAyD,EAAE,CAAC;IAEzE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QAC3C,MAAM,WAAW,GAAG,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CACV,GAAG,UAAU;aACV,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;aAC7C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,SAAkB,EAAE,CAAC,CAAC,CACpD,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CACV,GAAG,SAAS;aACT,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;aAC7C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,QAAiB,EAAE,CAAC,CAAC,CACnD,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAErD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/src/tools/promoteToShared.d.ts

@@ -0,0 +1,14 @@
+import type { BrainConfig } from '../types.js';
+export interface PromoteParams {
+    id: string;
+    removeProjectSpecific?: string[];
+}
+export interface PromoteResult {
+    sharedId: string;
+    file: string;
+}
+/**
+ * Main promote_to_shared implementation.
+ */
+export declare function promoteToShared(cwd: string, config: BrainConfig, params: PromoteParams): Promise<PromoteResult>;
+//# sourceMappingURL=promoteToShared.d.ts.map

package/dist/src/tools/promoteToShared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promoteToShared.d.ts","sourceRoot":"","sources":["../../../src/tools/promoteToShared.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAiC,MAAM,aAAa,CAAC;AAM9E,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,CAAC,CAgExB"}

package/dist/src/tools/promoteToShared.js

@@ -0,0 +1,63 @@
+// ─── Tool: promote_to_shared — Copy a project entry to shared memory ───
+import { existsSync, mkdirSync } from 'node:fs';
+import { findEntryById, writeEntry } from '../store/markdownStore.js';
+import { upsertIndexEntry } from '../store/indexStore.js';
+import { embed, upsertVector, buildEmbeddingText, isOllamaAvailable } from '../store/vectorStore.js';
+import { resolveMemoryRoot, resolveSharedRoot } from '../config.js';
+/**
+ * Main promote_to_shared implementation.
+ */
+export async function promoteToShared(cwd, config, params) {
+    const projectRoot = resolveMemoryRoot(cwd, config);
+    const sharedRoot = resolveSharedRoot(config);
+    // Read the project entry
+    const entry = findEntryById(projectRoot, params.id, 'project');
+    if (!entry) {
+        throw new Error(`Entry ${params.id} not found in project memory.`);
+    }
+    // Ensure shared root exists
+    if (!existsSync(sharedRoot)) {
+        mkdirSync(sharedRoot, { recursive: true });
+    }
+    // Check for collision: use projectName/id as shared ID
+    const sharedId = `${config.projectName}/${params.id}`;
+    // Build shared frontmatter (add project field, use original ID for file name)
+    const sharedFrontmatter = {
+        ...entry.frontmatter,
+        project: config.projectName,
+    };
+    // Optionally remove project-specific fields (e.g., subsystems that are project-specific)
+    if (params.removeProjectSpecific) {
+        for (const field of params.removeProjectSpecific) {
+            if (field === 'subsystems')
+                sharedFrontmatter.subsystems = [];
+            if (field === 'related-adrs')
+                sharedFrontmatter['related-adrs'] = [];
+        }
+    }
+    // Write to shared memory
+    const relativeFile = writeEntry(sharedRoot, sharedFrontmatter, entry.body);
+    // Update shared index
+    upsertIndexEntry(sharedRoot, {
+        id: entry.frontmatter.id,
+        type: entry.frontmatter.type,
+        file: relativeFile,
+        title: entry.body.title,
+        date: entry.frontmatter.date,
+        subsystems: sharedFrontmatter.subsystems,
+        tags: entry.frontmatter.tags,
+        relatedAdrs: sharedFrontmatter['related-adrs'],
+        status: entry.frontmatter.status,
+        confidence: entry.frontmatter.confidence,
+    });
+    // Generate embedding in shared LanceDB if Ollama available
+    if (await isOllamaAvailable()) {
+        const text = buildEmbeddingText(entry.body.title, entry.body.context, entry.body.result, entry.body.lesson);
+        const vector = await embed(text, config.embedding.model);
+        if (vector) {
+            await upsertVector(sharedRoot, entry.frontmatter.id, vector);
+        }
+    }
+    return { sharedId, file: relativeFile };
+}
+//# sourceMappingURL=promoteToShared.js.map

package/dist/src/tools/promoteToShared.js.map

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

package/dist/src/tools/rebuildIndex.d.ts

@@ -0,0 +1,14 @@
+import type { BrainConfig, MemoryScope } from '../types.js';
+export interface RebuildParams {
+    scope?: MemoryScope;
+}
+export interface RebuildResult {
+    entriesIndexed: number;
+    embeddingsGenerated: number;
+    scope: string;
+}
+/**
+ * Main rebuild_index implementation.
+ */
+export declare function rebuildIndex(cwd: string, config: BrainConfig, params: RebuildParams): Promise<RebuildResult>;
+//# sourceMappingURL=rebuildIndex.d.ts.map

package/dist/src/tools/rebuildIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuildIndex.d.ts","sourceRoot":"","sources":["../../../src/tools/rebuildIndex.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM5D,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,CAAC,CA8BxB"}

package/dist/src/tools/rebuildIndex.js

@@ -0,0 +1,60 @@
+// ─── Tool: rebuild_index — Regenerate index.json + vector embeddings ───
+import { existsSync } from 'node:fs';
+import { readAllEntries, getEntryRelativePath } from '../store/markdownStore.js';
+import { writeIndex, entryToIndexEntry } from '../store/indexStore.js';
+import { embed, upsertVector, buildEmbeddingText, isOllamaAvailable } from '../store/vectorStore.js';
+import { resolveMemoryRoot, resolveSharedRoot } from '../config.js';
+/**
+ * Main rebuild_index implementation.
+ */
+export async function rebuildIndex(cwd, config, params) {
+    const { scope = 'all' } = params;
+    let totalIndexed = 0;
+    let totalEmbeddings = 0;
+    const ollamaAvailable = await isOllamaAvailable();
+    if (scope === 'project' || scope === 'all') {
+        const projectRoot = resolveMemoryRoot(cwd, config);
+        if (existsSync(projectRoot)) {
+            const result = await rebuildForRoot(projectRoot, 'project', config, ollamaAvailable);
+            totalIndexed += result.indexed;
+            totalEmbeddings += result.embeddings;
+        }
+    }
+    if (scope === 'shared' || scope === 'all') {
+        const sharedRoot = resolveSharedRoot(config);
+        if (existsSync(sharedRoot)) {
+            const result = await rebuildForRoot(sharedRoot, 'shared', config, ollamaAvailable);
+            totalIndexed += result.indexed;
+            totalEmbeddings += result.embeddings;
+        }
+    }
+    return {
+        entriesIndexed: totalIndexed,
+        embeddingsGenerated: totalEmbeddings,
+        scope,
+    };
+}
+async function rebuildForRoot(memoryRoot, source, config, ollamaAvailable) {
+    const entries = readAllEntries(memoryRoot, source);
+    // Rebuild index.json
+    const indexEntries = entries.map(entry => {
+        const relFile = getEntryRelativePath(memoryRoot, entry);
+        return entryToIndexEntry(entry, relFile);
+    });
+    writeIndex(memoryRoot, indexEntries);
+    // Rebuild embeddings
+    let embeddings = 0;
+    if (ollamaAvailable) {
+        for (const entry of entries) {
+            const text = buildEmbeddingText(entry.body.title, entry.body.context, entry.body.result, entry.body.lesson);
+            const vector = await embed(text, config.embedding.model);
+            if (vector) {
+                await upsertVector(memoryRoot, entry.frontmatter.id, vector);
+                embeddings++;
+            }
+        }
+    }
+    process.stderr.write(`✓ Rebuilt ${source} index: ${entries.length} entries, ${embeddings} embeddings\n`);
+    return { indexed: entries.length, embeddings };
+}
+//# sourceMappingURL=rebuildIndex.js.map

package/dist/src/tools/rebuildIndex.js.map

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

package/dist/src/tools/recallKnowledge.d.ts

@@ -0,0 +1,36 @@
+import type { BrainConfig, MemoryType, MemoryScope, DegradationInfo } from '../types.js';
+export interface RecallParams {
+    query: string;
+    subsystems?: string[];
+    tags?: string[];
+    type?: MemoryType;
+    limit?: number;
+    scope?: MemoryScope;
+}
+export interface RecallResult {
+    entries: Array<{
+        id: string;
+        type: MemoryType;
+        title: string;
+        date: string;
+        subsystems: string[];
+        tags: string[];
+        status: string;
+        confidence: string;
+        source: 'project' | 'shared';
+        body: {
+            context: string;
+            result: string;
+            reason: string;
+            lesson: string;
+            action: string;
+        };
+    }>;
+    degradation: DegradationInfo;
+    totalMatches: number;
+}
+/**
+ * Main recall_knowledge implementation.
+ */
+export declare function recallKnowledge(cwd: string, config: BrainConfig, params: RecallParams): Promise<RecallResult>;
+//# sourceMappingURL=recallKnowledge.d.ts.map