@sashabogi/foundation 2.1.0 → 2.3.1

package/dist/vault/sync.js

@@ -0,0 +1,372 @@
+/**
+ * Vault Sync Engine
+ *
+ * Syncs Gaia memories from SQLite to an Obsidian vault as interlinked
+ * markdown files. Supports full and incremental sync, Claude Code memory
+ * file ingestion, and orphan cleanup.
+ */
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, unlinkSync, statSync, } from 'fs';
+import { join } from 'path';
+import { createHash } from 'crypto';
+import { parse as parseYaml } from 'yaml';
+import { MemoriaStorage } from '../tools/gaia/storage.js';
+import { transformMemory, memoryToFilename, memoryToFolderPath, } from './transform.js';
+import { generateDashboard } from './dashboard.js';
+// =============================================================================
+// Folder Scaffold
+// =============================================================================
+const VAULT_FOLDERS = [
+    'Foundation',
+    'Foundation/Global',
+    'Foundation/Projects',
+    'Foundation/Sessions',
+    'Foundation/Notes',
+    'Foundation/Observations',
+    'Knowledge',
+];
+// =============================================================================
+// VaultSync
+// =============================================================================
+export class VaultSync {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    /**
+     * Create the required folder structure in the vault and write an initial
+     * dashboard index file.
+     */
+    async init() {
+        for (const folder of VAULT_FOLDERS) {
+            const fullPath = join(this.config.vaultPath, folder);
+            if (!existsSync(fullPath)) {
+                mkdirSync(fullPath, { recursive: true });
+            }
+        }
+        const dashboardPath = join(this.config.vaultPath, 'Foundation', '_dashboard.md');
+        if (!existsSync(dashboardPath)) {
+            writeFileSync(dashboardPath, generateDashboard(), 'utf8');
+        }
+    }
+    /**
+     * Full sync: reads ALL memories from Gaia DB, transforms and writes every
+     * file, updates sync state. Also syncs Claude Code memory files if
+     * claudeMemoryPath is configured.
+     */
+    async sync() {
+        await this.init();
+        const gaiaResult = await this.syncGaiaMemories(false);
+        let claudeResult = { created: 0, updated: 0, deleted: 0, skipped: 0, errors: [] };
+        if (this.config.claudeMemoryPath) {
+            claudeResult = await this.syncClaudeMemories();
+        }
+        return mergeResults(gaiaResult, claudeResult);
+    }
+    /**
+     * Incremental sync: only writes memories whose rendered content has changed
+     * since the last sync (detected via MD5 hash comparison).
+     */
+    async syncIncremental() {
+        await this.init();
+        const gaiaResult = await this.syncGaiaMemories(true);
+        let claudeResult = { created: 0, updated: 0, deleted: 0, skipped: 0, errors: [] };
+        if (this.config.claudeMemoryPath) {
+            claudeResult = await this.syncClaudeMemories();
+        }
+        return mergeResults(gaiaResult, claudeResult);
+    }
+    /**
+     * Returns the current sync state, or null if no sync has run yet.
+     */
+    getStatus() {
+        if (!existsSync(this.config.syncStatePath))
+            return null;
+        try {
+            return JSON.parse(readFileSync(this.config.syncStatePath, 'utf8'));
+        }
+        catch {
+            return null;
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private: State Management
+    // ---------------------------------------------------------------------------
+    loadSyncState() {
+        const existing = this.getStatus();
+        if (existing)
+            return existing;
+        return {
+            vault_path: this.config.vaultPath,
+            last_full_sync: new Date(0).toISOString(),
+            synced_memories: {},
+        };
+    }
+    saveSyncState(state) {
+        const dir = join(this.config.syncStatePath, '..');
+        // syncStatePath may point to a file whose parent dir doesn't exist yet
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(this.config.syncStatePath, JSON.stringify(state, null, 2), 'utf8');
+    }
+    // ---------------------------------------------------------------------------
+    // Private: Hashing
+    // ---------------------------------------------------------------------------
+    hashContent(content) {
+        return createHash('md5').update(content).digest('hex');
+    }
+    // ---------------------------------------------------------------------------
+    // Private: Gaia Sync
+    // ---------------------------------------------------------------------------
+    async syncGaiaMemories(incremental) {
+        const result = { created: 0, updated: 0, deleted: 0, skipped: 0, errors: [] };
+        const state = this.loadSyncState();
+        let storage = null;
+        try {
+            storage = new MemoriaStorage(this.config.gaiaDbPath);
+            const memories = storage.getAllMemories();
+            const links = storage.getAllLinks();
+            // Build lookup maps
+            const memoryMap = new Map(memories.map(m => [m.id, m]));
+            const linksBySource = new Map();
+            for (const link of links) {
+                const bucket = linksBySource.get(link.from_memory_id) ?? [];
+                bucket.push(link);
+                linksBySource.set(link.from_memory_id, bucket);
+            }
+            const currentIds = new Set();
+            for (const memory of memories) {
+                currentIds.add(memory.id);
+                try {
+                    const memLinks = linksBySource.get(memory.id) ?? [];
+                    const markdown = transformMemory(memory, memLinks, memoryMap);
+                    const hash = this.hashContent(markdown);
+                    // In incremental mode, skip if content unchanged
+                    if (incremental && state.synced_memories[memory.id] === hash) {
+                        result.skipped++;
+                        continue;
+                    }
+                    const folderPath = memoryToFolderPath(memory, this.config.vaultPath);
+                    const filename = memoryToFilename(memory);
+                    const filePath = join(folderPath, filename);
+                    if (!existsSync(folderPath)) {
+                        mkdirSync(folderPath, { recursive: true });
+                    }
+                    const isNew = !state.synced_memories[memory.id];
+                    writeFileSync(filePath, markdown, 'utf8');
+                    state.synced_memories[memory.id] = hash;
+                    if (isNew) {
+                        result.created++;
+                    }
+                    else {
+                        result.updated++;
+                    }
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    result.errors.push(`[${memory.id}] ${msg}`);
+                }
+            }
+            // Clean up orphaned vault files for deleted memories
+            result.deleted = this.cleanOrphans(currentIds, state);
+            // Prune deleted memory ids from state
+            for (const id of Object.keys(state.synced_memories)) {
+                if (!currentIds.has(id)) {
+                    delete state.synced_memories[id];
+                }
+            }
+            state.last_full_sync = new Date().toISOString();
+            this.saveSyncState(state);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            result.errors.push(`[fatal] ${msg}`);
+        }
+        finally {
+            storage?.close();
+        }
+        return result;
+    }
+    // ---------------------------------------------------------------------------
+    // Private: Claude Code Memory Sync
+    // ---------------------------------------------------------------------------
+    async syncClaudeMemories() {
+        const result = { created: 0, updated: 0, deleted: 0, skipped: 0, errors: [] };
+        const claudeMemoryPath = this.config.claudeMemoryPath;
+        if (!claudeMemoryPath || !existsSync(claudeMemoryPath)) {
+            return result;
+        }
+        let files;
+        try {
+            files = readdirSync(claudeMemoryPath).filter(f => f.endsWith('.md'));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            result.errors.push(`[claude-memory] Failed to read directory: ${msg}`);
+            return result;
+        }
+        for (const filename of files) {
+            try {
+                const sourcePath = join(claudeMemoryPath, filename);
+                const rawContent = readFileSync(sourcePath, 'utf8');
+                // Parse YAML frontmatter to extract type for folder routing
+                const { frontmatter, body } = extractFrontmatter(rawContent);
+                let type = 'general';
+                if (frontmatter) {
+                    try {
+                        const parsed = parseYaml(frontmatter);
+                        if (typeof parsed['type'] === 'string') {
+                            type = parsed['type'];
+                        }
+                    }
+                    catch {
+                        // Unparseable frontmatter — fall back to default type
+                    }
+                }
+                // Build enhanced markdown with source field injected into frontmatter
+                const enhanced = injectFrontmatterField(rawContent, 'source', 'claude-code');
+                const targetDir = join(this.config.vaultPath, 'Knowledge', type);
+                if (!existsSync(targetDir)) {
+                    mkdirSync(targetDir, { recursive: true });
+                }
+                const targetPath = join(targetDir, filename);
+                const existed = existsSync(targetPath);
+                writeFileSync(targetPath, enhanced, 'utf8');
+                if (existed) {
+                    result.updated++;
+                }
+                else {
+                    result.created++;
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                result.errors.push(`[claude-memory/${filename}] ${msg}`);
+            }
+        }
+        return result;
+    }
+    // ---------------------------------------------------------------------------
+    // Private: Orphan Cleanup
+    // ---------------------------------------------------------------------------
+    /**
+     * Walk Foundation/ in the vault and remove .md files whose memory id is no
+     * longer in currentIds. Returns the number of files deleted.
+     */
+    cleanOrphans(currentIds, state) {
+        let deleted = 0;
+        const foundationRoot = join(this.config.vaultPath, 'Foundation');
+        if (!existsSync(foundationRoot))
+            return 0;
+        const walkAndClean = (dir) => {
+            let entries;
+            try {
+                entries = readdirSync(dir);
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                const fullPath = join(dir, entry);
+                let isDir = false;
+                try {
+                    isDir = statSync(fullPath).isDirectory();
+                }
+                catch {
+                    continue;
+                }
+                if (isDir) {
+                    walkAndClean(fullPath);
+                }
+                else if (entry.endsWith('.md')) {
+                    // Recover the memory id from the filename.
+                    //
+                    // Filename format: ${memory.id}-${slug}.md where memory.id = mem_${nanoid()}.
+                    // Because nanoid produces hyphens, both the id and the id-to-slug separator
+                    // use '-', making regex-based extraction ambiguous. Instead, we consult
+                    // state.synced_memories — the authoritative record of every id vault-sync
+                    // has ever written — and check whether any of those ids is a prefix of
+                    // this filename's stem. This is unambiguous and never deletes user files
+                    // that vault-sync did not create.
+                    const stem = entry.slice(0, -3); // strip .md
+                    let matchedId = null;
+                    for (const id of Object.keys(state.synced_memories)) {
+                        if (stem === id || stem.startsWith(id + '-')) {
+                            matchedId = id;
+                            break;
+                        }
+                    }
+                    if (matchedId && !currentIds.has(matchedId)) {
+                        try {
+                            unlinkSync(fullPath);
+                            deleted++;
+                        }
+                        catch {
+                            // File may have already been removed — ignore
+                        }
+                    }
+                }
+            }
+        };
+        walkAndClean(foundationRoot);
+        return deleted;
+    }
+}
+// =============================================================================
+// Utility Functions
+// =============================================================================
+function mergeResults(a, b) {
+    return {
+        created: a.created + b.created,
+        updated: a.updated + b.updated,
+        deleted: a.deleted + b.deleted,
+        skipped: a.skipped + b.skipped,
+        errors: [...a.errors, ...b.errors],
+    };
+}
+/**
+ * Split a markdown file into its YAML frontmatter block and body.
+ * Returns { frontmatter: string | null, body: string }.
+ */
+function extractFrontmatter(content) {
+    if (!content.startsWith('---')) {
+        return { frontmatter: null, body: content };
+    }
+    const end = content.indexOf('\n---', 3);
+    if (end === -1) {
+        return { frontmatter: null, body: content };
+    }
+    const frontmatter = content.slice(4, end).trim();
+    const body = content.slice(end + 4).trimStart();
+    return { frontmatter, body };
+}
+/**
+ * Inject a key: value pair into a markdown file's YAML frontmatter.
+ * If no frontmatter exists, one is created. If the key already exists,
+ * it is left unchanged.
+ */
+function injectFrontmatterField(content, key, value) {
+    if (!content.startsWith('---')) {
+        // No frontmatter — prepend one
+        return `---\n${key}: ${value}\n---\n\n${content}`;
+    }
+    const end = content.indexOf('\n---', 3);
+    if (end === -1) {
+        return `---\n${key}: ${value}\n---\n\n${content}`;
+    }
+    const frontmatterBlock = content.slice(0, end + 4);
+    const rest = content.slice(end + 4);
+    // Only inject if key is absent
+    if (new RegExp(`^${key}:`, 'm').test(frontmatterBlock)) {
+        return content;
+    }
+    // Insert before closing ---
+    const insertionPoint = end;
+    return (content.slice(0, insertionPoint) +
+        `\n${key}: ${value}` +
+        content.slice(insertionPoint));
+}
+//# sourceMappingURL=sync.js.map

package/dist/vault/sync.js.map

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

package/dist/vault/transform.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Vault Transform Layer
+ *
+ * Converts Gaia Memory objects into Obsidian-compatible markdown files
+ * with YAML frontmatter and [[wikilink]] cross-references.
+ */
+import type { Memory, MemoryLink } from '../tools/gaia/storage.js';
+/**
+ * Returns a filesystem-safe filename for a memory.
+ * Format: `<id>-<slug>.md`
+ */
+export declare function memoryToFilename(memory: Memory): string;
+/**
+ * Returns the target folder path in the vault for a given memory, based on tier.
+ */
+export declare function memoryToFolderPath(memory: Memory, vaultRoot: string): string;
+/**
+ * Transforms a Memory and its links into a full Obsidian markdown string.
+ *
+ * @param memory      The memory to transform
+ * @param links       All MemoryLink rows where from_memory_id === memory.id
+ * @param allMemories Map of id → Memory for resolving link targets
+ */
+export declare function transformMemory(memory: Memory, links: MemoryLink[], allMemories: Map<string, Memory>): string;
+//# sourceMappingURL=transform.d.ts.map

package/dist/vault/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/vault/transform.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAiDnE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAyB5E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,EAAE,EACnB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CA4ER"}

package/dist/vault/transform.js

@@ -0,0 +1,155 @@
+/**
+ * Vault Transform Layer
+ *
+ * Converts Gaia Memory objects into Obsidian-compatible markdown files
+ * with YAML frontmatter and [[wikilink]] cross-references.
+ */
+import { format } from 'date-fns';
+import { join } from 'path';
+// =============================================================================
+// Internal Helpers
+// =============================================================================
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '')
+        .trim()
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .slice(0, 40)
+        .replace(/-$/, '');
+}
+function unixMsToIso(ms) {
+    return new Date(ms).toISOString();
+}
+function extractFirstLine(content) {
+    const firstLine = content.split('\n')[0] ?? '';
+    // Strip markdown heading markers
+    return firstLine.replace(/^#+\s*/, '').trim();
+}
+function extractProjectName(projectPath) {
+    if (!projectPath)
+        return 'unscoped';
+    // Take the last non-empty path segment as the project name
+    const parts = projectPath.replace(/\/$/, '').split('/');
+    const name = parts[parts.length - 1] ?? 'unscoped';
+    return name || 'unscoped';
+}
+function formatTagsYaml(tags) {
+    if (tags.length === 0)
+        return '[]';
+    return '\n' + tags.map(t => `  - ${t}`).join('\n');
+}
+function formatFilesYaml(files) {
+    if (files.length === 0)
+        return '[]';
+    return '\n' + files.map(f => `  - ${f}`).join('\n');
+}
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Returns a filesystem-safe filename for a memory.
+ * Format: `<id>-<slug>.md`
+ */
+export function memoryToFilename(memory) {
+    const firstLine = extractFirstLine(memory.content);
+    const slug = slugify(firstLine);
+    if (slug) {
+        return `${memory.id}-${slug}.md`;
+    }
+    return `${memory.id}.md`;
+}
+/**
+ * Returns the target folder path in the vault for a given memory, based on tier.
+ */
+export function memoryToFolderPath(memory, vaultRoot) {
+    switch (memory.tier) {
+        case 'global':
+            return join(vaultRoot, 'Foundation', 'Global');
+        case 'project': {
+            const projectName = extractProjectName(memory.project_path);
+            return join(vaultRoot, 'Foundation', 'Projects', projectName);
+        }
+        case 'session': {
+            // Group by YYYY-MM of created_at
+            const monthFolder = format(new Date(memory.created_at), 'yyyy-MM');
+            return join(vaultRoot, 'Foundation', 'Sessions', monthFolder);
+        }
+        case 'note':
+            return join(vaultRoot, 'Foundation', 'Notes');
+        case 'observation':
+            return join(vaultRoot, 'Foundation', 'Observations');
+        default:
+            return join(vaultRoot, 'Foundation', 'Global');
+    }
+}
+/**
+ * Transforms a Memory and its links into a full Obsidian markdown string.
+ *
+ * @param memory      The memory to transform
+ * @param links       All MemoryLink rows where from_memory_id === memory.id
+ * @param allMemories Map of id → Memory for resolving link targets
+ */
+export function transformMemory(memory, links, allMemories) {
+    const title = extractFirstLine(memory.content) || memory.id;
+    const projectName = extractProjectName(memory.project_path);
+    // -------------------------------------------------------------------------
+    // YAML frontmatter
+    // -------------------------------------------------------------------------
+    const frontmatterLines = [
+        '---',
+        `id: ${memory.id}`,
+        `tier: ${memory.tier}`,
+        `tags:${formatTagsYaml(memory.tags)}`,
+        `related_files:${formatFilesYaml(memory.related_files)}`,
+    ];
+    if (memory.project_path) {
+        frontmatterLines.push(`project: ${projectName}`);
+    }
+    if (memory.session_id) {
+        frontmatterLines.push(`session_id: ${memory.session_id}`);
+    }
+    frontmatterLines.push(`created: ${unixMsToIso(memory.created_at)}`, `accessed: ${unixMsToIso(memory.accessed_at)}`, `access_count: ${memory.access_count}`, `source: gaia`);
+    // Include non-empty metadata fields as individual YAML entries
+    if (memory.metadata && Object.keys(memory.metadata).length > 0) {
+        for (const [key, value] of Object.entries(memory.metadata)) {
+            if (value !== null && value !== undefined) {
+                const serialized = typeof value === 'string' ? value : JSON.stringify(value);
+                frontmatterLines.push(`${key}: ${serialized}`);
+            }
+        }
+    }
+    frontmatterLines.push('---');
+    // -------------------------------------------------------------------------
+    // Body
+    // -------------------------------------------------------------------------
+    const bodyLines = [
+        '',
+        `# ${title}`,
+        '',
+        memory.content,
+    ];
+    // -------------------------------------------------------------------------
+    // Links section
+    // -------------------------------------------------------------------------
+    if (links.length > 0) {
+        bodyLines.push('', '## Links');
+        for (const link of links) {
+            const targetMemory = allMemories.get(link.to_memory_id);
+            let targetFilename;
+            if (targetMemory) {
+                // Use filename without .md extension for wikilinks
+                const fullFilename = memoryToFilename(targetMemory);
+                targetFilename = fullFilename.replace(/\.md$/, '');
+            }
+            else {
+                // Target was deleted; link to bare id
+                targetFilename = link.to_memory_id;
+            }
+            bodyLines.push(`- **${link.link_type}** → [[${targetFilename}]]`);
+        }
+    }
+    return [...frontmatterLines, ...bodyLines].join('\n') + '\n';
+}
+//# sourceMappingURL=transform.js.map

package/dist/vault/transform.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sashabogi/foundation",
-  "version": "2.1.0",
+  "version": "2.3.1",
   "description": "Unified MCP server for AI-assisted development: codebase intelligence, multi-agent orchestration, and workflow patterns with advanced memory",
   "type": "module",
   "main": "dist/index.js",
@@ -56,6 +56,7 @@
     "@anthropic-ai/sdk": "^0.71.0",
     "@clack/prompts": "^1.0.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "@mongodb-js/zstd": "^7.0.0",
     "better-sqlite3": "^12.0.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",