@sashabogi/foundation 0.1.0

package/dist/tools/demerzel/index.js

@@ -0,0 +1,166 @@
+/**
+ * Demerzel Module Tools
+ *
+ * Codebase intelligence beyond context limits.
+ * Named after R. Daneel Olivaw/Demerzel - 20,000 years of perfect memory,
+ * observing silently, knowing everything about the codebase.
+ *
+ * Tools:
+ * - demerzel_snapshot: Create codebase snapshot
+ * - demerzel_search: Regex search across codebase
+ * - demerzel_find_files: Glob pattern file matching
+ * - demerzel_find_symbol: Locate function/class definitions
+ * - demerzel_find_importers: Find files that import a module
+ * - demerzel_get_deps: Get file dependencies
+ * - demerzel_get_context: Get lines around a location
+ * - demerzel_analyze: AI-powered deep analysis
+ * - demerzel_semantic_search: Natural language code search
+ */
+import { z } from 'zod';
+export function registerDemerzelTools(server) {
+    // demerzel_snapshot
+    server.tool('demerzel_snapshot', 'Create a codebase snapshot for efficient searching and analysis. Enhanced snapshots include import graph and export index. "I have been watching for 20,000 years."', {
+        path: z.string().describe('Path to the codebase directory'),
+        enhanced: z.boolean().optional().describe('Create enhanced snapshot with import graph (default: true)'),
+        output: z.string().optional().describe('Output path for snapshot (default: .foundation/snapshot.txt)'),
+    }, async ({ path, enhanced = true, output: _output }) => {
+        // TODO: Port implementation from argus
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `[Stub] Would create ${enhanced ? 'enhanced' : 'basic'} snapshot for ${path}`,
+                },
+            ],
+        };
+    });
+    // demerzel_search
+    server.tool('demerzel_search', 'Fast regex search across codebase. Zero AI cost. Returns file:line:content matches.', {
+        path: z.string().describe('Path to snapshot file'),
+        pattern: z.string().describe('Regex pattern to search'),
+        maxResults: z.number().optional().describe('Maximum results (default: 50)'),
+        caseInsensitive: z.boolean().optional().describe('Case insensitive search (default: true)'),
+    }, async ({ path, pattern, maxResults: _maxResults = 50, caseInsensitive: _caseInsensitive = true }) => {
+        // TODO: Port implementation from argus
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `[Stub] Would search for "${pattern}" in ${path}`,
+                },
+            ],
+        };
+    });
+    // demerzel_find_files
+    server.tool('demerzel_find_files', 'Find files matching a glob pattern. Zero AI cost.', {
+        path: z.string().describe('Path to snapshot file'),
+        pattern: z.string().describe('Glob pattern (e.g., "*.ts", "src/**/*.tsx")'),
+        limit: z.number().optional().describe('Maximum results (default: 100)'),
+    }, async ({ path, pattern, limit: _limit = 100 }) => {
+        // TODO: Port implementation from argus
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `[Stub] Would find files matching "${pattern}" in ${path}`,
+                },
+            ],
+        };
+    });
+    // demerzel_find_symbol
+    server.tool('demerzel_find_symbol', 'Locate where a function, class, or type is exported. Zero AI cost. Requires enhanced snapshot.', {
+        path: z.string().describe('Path to snapshot file'),
+        symbol: z.string().describe('Symbol name to find (e.g., "AuthProvider", "useAuth")'),
+    }, async ({ path, symbol }) => {
+        // TODO: Port implementation from argus
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `[Stub] Would find symbol "${symbol}" in ${path}`,
+                },
+            ],
+        };
+    });
+    // demerzel_find_importers
+    server.tool('demerzel_find_importers', 'Find all files that import a given module. Zero AI cost. Requires enhanced snapshot.', {
+        path: z.string().describe('Path to snapshot file'),
+        target: z.string().describe('File path to find importers of (e.g., "src/auth.ts")'),
+    }, async ({ path, target }) => {
+        // TODO: Port implementation from argus
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `[Stub] Would find importers of "${target}" in ${path}`,
+                },
+            ],
+        };
+    });
+    // demerzel_get_deps
+    server.tool('demerzel_get_deps', 'Get all dependencies (imports) of a specific file. Zero AI cost. Requires enhanced snapshot.', {
+        path: z.string().describe('Path to snapshot file'),
+        file: z.string().describe('File path to get dependencies for'),
+    }, async ({ path, file }) => {
+        // TODO: Port implementation from argus
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `[Stub] Would get dependencies of "${file}" in ${path}`,
+                },
+            ],
+        };
+    });
+    // demerzel_get_context
+    server.tool('demerzel_get_context', 'Get lines of code around a specific location. Zero AI cost. Use after search to get more context.', {
+        path: z.string().describe('Path to snapshot file'),
+        file: z.string().describe('File path within the snapshot'),
+        line: z.number().describe('Center line number'),
+        before: z.number().optional().describe('Lines before (default: 10)'),
+        after: z.number().optional().describe('Lines after (default: 10)'),
+    }, async ({ path, file, line, before = 10, after = 10 }) => {
+        // TODO: Port implementation from argus
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `[Stub] Would get context around line ${line} in ${file}`,
+                },
+            ],
+        };
+    });
+    // demerzel_analyze
+    server.tool('demerzel_analyze', 'AI-powered deep analysis of codebase. Uses recursive reasoning across entire codebase. ~500 tokens cost.', {
+        path: z.string().describe('Path to snapshot file'),
+        query: z.string().describe('Question about the codebase (be specific for best results)'),
+        maxTurns: z.number().optional().describe('Maximum reasoning turns (default: 15)'),
+    }, async ({ path, query, maxTurns = 15 }) => {
+        // TODO: Port implementation from argus
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `[Stub] Would analyze "${query}" in ${path}`,
+                },
+            ],
+        };
+    });
+    // demerzel_semantic_search
+    server.tool('demerzel_semantic_search', 'Search code using natural language. Uses FTS5 full-text search. More flexible than regex.', {
+        path: z.string().describe('Path to project directory'),
+        query: z.string().describe('Natural language query or code terms'),
+        limit: z.number().optional().describe('Maximum results (default: 20)'),
+    }, async ({ path, query, limit = 20 }) => {
+        // TODO: Port implementation from argus
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `[Stub] Would semantic search "${query}" in ${path}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/demerzel/index.js.map

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

package/dist/tools/gaia/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Gaia Module Tools
+ *
+ * Workflow patterns - shared memory and collective consciousness.
+ * Named after Gaia from Foundation - "We are all one, and one is all."
+ *
+ * Preserves context across sessions, learns from mistakes, enables
+ * seamless handoffs between Claude instances.
+ *
+ * Tools:
+ * - gaia_worktree_create: Create git worktree with session
+ * - gaia_worktree_list: List active worktrees
+ * - gaia_worktree_switch: Navigate between worktrees
+ * - gaia_worktree_cleanup: Remove stale worktrees
+ * - gaia_session_register: Track Claude session purpose
+ * - gaia_session_status: View active sessions
+ * - gaia_session_handoff: Prepare context for handoff
+ * - gaia_session_complete: Mark session as done
+ * - gaia_learn: Record correction for CLAUDE.md
+ * - gaia_apply: Write learnings to CLAUDE.md
+ * - gaia_review: Review accumulated learnings
+ * - gaia_remember: Save context state
+ * - gaia_recall: Restore previous context
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGaiaTools(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/gaia/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/gaia/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8BzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyhBzD"}

package/dist/tools/gaia/index.js

@@ -0,0 +1,466 @@
+/**
+ * Gaia Module Tools
+ *
+ * Workflow patterns - shared memory and collective consciousness.
+ * Named after Gaia from Foundation - "We are all one, and one is all."
+ *
+ * Preserves context across sessions, learns from mistakes, enables
+ * seamless handoffs between Claude instances.
+ *
+ * Tools:
+ * - gaia_worktree_create: Create git worktree with session
+ * - gaia_worktree_list: List active worktrees
+ * - gaia_worktree_switch: Navigate between worktrees
+ * - gaia_worktree_cleanup: Remove stale worktrees
+ * - gaia_session_register: Track Claude session purpose
+ * - gaia_session_status: View active sessions
+ * - gaia_session_handoff: Prepare context for handoff
+ * - gaia_session_complete: Mark session as done
+ * - gaia_learn: Record correction for CLAUDE.md
+ * - gaia_apply: Write learnings to CLAUDE.md
+ * - gaia_review: Review accumulated learnings
+ * - gaia_remember: Save context state
+ * - gaia_recall: Restore previous context
+ */
+import { z } from 'zod';
+import { nanoid } from 'nanoid';
+import { StorageService } from '../../services/storage.service.js';
+import { GitService } from '../../services/git.service.js';
+const SessionTaskTypeSchema = z.enum([
+    'feature',
+    'bugfix',
+    'refactor',
+    'review',
+    'exploration',
+    'documentation',
+]);
+const LearningCategorySchema = z.enum([
+    'code_style',
+    'architecture',
+    'testing',
+    'performance',
+    'security',
+    'documentation',
+    'tooling',
+    'process',
+    'other',
+]);
+const LearningScopeSchema = z.enum(['global', 'project']);
+export function registerGaiaTools(server) {
+    const storage = StorageService.getInstance();
+    const git = GitService.getInstance();
+    // ===========================================================================
+    // Worktree Tools
+    // ===========================================================================
+    // gaia_worktree_create
+    server.tool('gaia_worktree_create', 'Create a git worktree for parallel Claude sessions. Returns shell alias for quick navigation.', {
+        branch: z.string().describe('Branch name for the worktree'),
+        alias: z.string().optional().describe('Single letter alias for quick switching (e.g., "a" for `za`)'),
+        purpose: z.string().optional().describe('Purpose of this worktree'),
+        baseBranch: z.string().optional().describe('Base branch (default: main)'),
+    }, async ({ branch, alias, purpose, baseBranch = 'main' }) => {
+        try {
+            const repoRoot = await git.getRepoRoot();
+            const worktreePath = `${repoRoot}-${alias || branch.split('/').pop()}`;
+            await git.createWorktree(worktreePath, branch, { baseBranch });
+            const worktree = {
+                id: `wt_${nanoid(8)}`,
+                path: worktreePath,
+                branch,
+                baseBranch,
+                alias,
+                purpose,
+                status: 'active',
+                createdAt: Date.now(),
+                lastAccessedAt: Date.now(),
+            };
+            storage.addWorktree(worktree);
+            let output = `✓ Created worktree at ${worktreePath}\n\n`;
+            if (alias) {
+                output += `Shell alias: \`alias z${alias}='cd ${worktreePath} && claude'\`\n`;
+            }
+            output += `\nTo navigate: \`cd ${worktreePath}\``;
+            return {
+                content: [{ type: 'text', text: output }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+            };
+        }
+    });
+    // gaia_worktree_list
+    server.tool('gaia_worktree_list', 'List all active worktrees with their status and session info.', {}, async () => {
+        const worktrees = storage.getWorktrees();
+        if (worktrees.length === 0) {
+            return {
+                content: [{ type: 'text', text: 'No active worktrees.' }],
+            };
+        }
+        let output = '## Active Worktrees\n\n';
+        for (const wt of worktrees) {
+            output += `### ${wt.alias ? `[${wt.alias}] ` : ''}${wt.branch}\n`;
+            output += `- Path: \`${wt.path}\`\n`;
+            output += `- Status: ${wt.status}\n`;
+            if (wt.purpose)
+                output += `- Purpose: ${wt.purpose}\n`;
+            output += '\n';
+        }
+        return {
+            content: [{ type: 'text', text: output }],
+        };
+    });
+    // gaia_worktree_switch
+    server.tool('gaia_worktree_switch', 'Get the command to switch to a worktree by alias or branch.', {
+        target: z.string().describe('Worktree alias or branch name'),
+    }, async ({ target }) => {
+        const worktree = storage.getWorktreeByAlias(target) ||
+            storage.getWorktrees().find((w) => w.branch.includes(target));
+        if (!worktree) {
+            return {
+                content: [{ type: 'text', text: `No worktree found for "${target}"` }],
+            };
+        }
+        storage.updateWorktree(worktree.id, { lastAccessedAt: Date.now() });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `To switch: \`cd ${worktree.path} && claude\``,
+                },
+            ],
+        };
+    });
+    // gaia_worktree_cleanup
+    server.tool('gaia_worktree_cleanup', 'Remove stale or completed worktrees.', {
+        target: z.string().optional().describe('Specific worktree ID or alias to remove'),
+        staleOnly: z.boolean().optional().describe('Only remove stale worktrees (default: false)'),
+    }, async ({ target, staleOnly = false }) => {
+        // TODO: Implement cleanup logic
+        return {
+            content: [{ type: 'text', text: '[Stub] Would cleanup worktrees' }],
+        };
+    });
+    // ===========================================================================
+    // Session Tools
+    // ===========================================================================
+    // gaia_session_register
+    server.tool('gaia_session_register', 'Register a new Claude session with its purpose for tracking. "We are all one."', {
+        purpose: z.string().describe('What this session is working on'),
+        taskType: SessionTaskTypeSchema.describe('Type of task'),
+        project: z.string().optional().describe('Project name'),
+        worktreeId: z.string().optional().describe('Associated worktree ID'),
+    }, async ({ purpose, taskType, project, worktreeId }) => {
+        const session = {
+            id: `sess_${nanoid(8)}`,
+            purpose,
+            taskType,
+            project,
+            worktreeId,
+            status: 'active',
+            notes: [],
+            startedAt: Date.now(),
+            lastActivityAt: Date.now(),
+        };
+        storage.addSession(session);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `✓ Session registered: ${session.id}\n\nPurpose: ${purpose}\nType: ${taskType}`,
+                },
+            ],
+        };
+    });
+    // gaia_session_status
+    server.tool('gaia_session_status', 'View status of active sessions.', {
+        sessionId: z.string().optional().describe('Specific session ID (or show all active)'),
+    }, async ({ sessionId }) => {
+        if (sessionId) {
+            const session = storage.getSession(sessionId);
+            if (!session) {
+                return {
+                    content: [{ type: 'text', text: `Session not found: ${sessionId}` }],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `## Session ${session.id}\n\n- Purpose: ${session.purpose}\n- Status: ${session.status}\n- Type: ${session.taskType}`,
+                    },
+                ],
+            };
+        }
+        const sessions = storage.getActiveSessions();
+        if (sessions.length === 0) {
+            return {
+                content: [{ type: 'text', text: 'No active sessions.' }],
+            };
+        }
+        let output = '## Active Sessions\n\n';
+        for (const s of sessions) {
+            output += `- **${s.id}**: ${s.purpose} (${s.status})\n`;
+        }
+        return {
+            content: [{ type: 'text', text: output }],
+        };
+    });
+    // gaia_session_handoff
+    server.tool('gaia_session_handoff', 'Generate a handoff document for transferring context to another session.', {
+        sessionId: z.string().describe('Session ID to create handoff for'),
+        includeGitStatus: z.boolean().optional().describe('Include git status (default: true)'),
+        includeChanges: z.boolean().optional().describe('Include recent changes (default: true)'),
+        nextSteps: z.array(z.string()).optional().describe('Next steps to include'),
+    }, async ({ sessionId, includeGitStatus = true, includeChanges = true, nextSteps = [] }) => {
+        const session = storage.getSession(sessionId);
+        if (!session) {
+            return {
+                content: [{ type: 'text', text: `Session not found: ${sessionId}` }],
+            };
+        }
+        let handoff = `# Session Handoff: ${session.id}\n\n`;
+        handoff += `## Purpose\n${session.purpose}\n\n`;
+        handoff += `## Type\n${session.taskType}\n\n`;
+        if (includeGitStatus) {
+            try {
+                const status = await git.getStatus();
+                handoff += `## Git Status\n`;
+                handoff += `- Branch: ${status.branch}\n`;
+                if (status.staged.length)
+                    handoff += `- Staged: ${status.staged.length} files\n`;
+                if (status.modified.length)
+                    handoff += `- Modified: ${status.modified.length} files\n`;
+                handoff += '\n';
+            }
+            catch {
+                // Not in a git repo
+            }
+        }
+        if (nextSteps.length > 0) {
+            handoff += `## Next Steps\n`;
+            for (const step of nextSteps) {
+                handoff += `- ${step}\n`;
+            }
+        }
+        return {
+            content: [{ type: 'text', text: handoff }],
+        };
+    });
+    // gaia_session_complete
+    server.tool('gaia_session_complete', 'Mark a session as completed.', {
+        sessionId: z.string().describe('Session ID to complete'),
+        outcome: z.enum(['completed', 'abandoned']).optional().describe('Session outcome'),
+        notes: z.string().optional().describe('Final notes'),
+    }, async ({ sessionId, outcome = 'completed', notes }) => {
+        const session = storage.getSession(sessionId);
+        if (!session) {
+            return {
+                content: [{ type: 'text', text: `Session not found: ${sessionId}` }],
+            };
+        }
+        storage.updateSession(sessionId, {
+            status: outcome,
+            completedAt: Date.now(),
+            notes: notes ? [...session.notes, notes] : session.notes,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `✓ Session ${sessionId} marked as ${outcome}`,
+                },
+            ],
+        };
+    });
+    // ===========================================================================
+    // Learning Tools
+    // ===========================================================================
+    // gaia_learn
+    server.tool('gaia_learn', 'Capture a correction for CLAUDE.md. Gaia learns from mistakes so all future sessions benefit.', {
+        mistake: z.string().describe('What went wrong'),
+        correction: z.string().describe('The correct approach'),
+        category: LearningCategorySchema.describe('Category of the learning'),
+        scope: LearningScopeSchema.optional().describe('Scope: global or project (default: project)'),
+    }, async ({ mistake, correction, category, scope = 'project' }) => {
+        const learning = {
+            id: `learn_${nanoid(8)}`,
+            mistakeDescription: mistake,
+            correction,
+            category,
+            scope,
+            applied: false,
+            createdAt: Date.now(),
+        };
+        storage.addLearning(learning);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `✓ Learning captured: ${learning.id}\n\n**Mistake**: ${mistake}\n**Correction**: ${correction}\n\nUse \`gaia_apply\` to write to CLAUDE.md`,
+                },
+            ],
+        };
+    });
+    // gaia_apply
+    server.tool('gaia_apply', 'Apply captured learnings to CLAUDE.md.', {
+        learningIds: z.array(z.string()).optional().describe('Specific learning IDs to apply (or all pending)'),
+    }, async ({ learningIds }) => {
+        const pending = learningIds
+            ? storage.getLearnings().filter((l) => learningIds.includes(l.id) && !l.applied)
+            : storage.getPendingLearnings();
+        if (pending.length === 0) {
+            return {
+                content: [{ type: 'text', text: 'No pending learnings to apply.' }],
+            };
+        }
+        // Format learnings for CLAUDE.md
+        const byCategory = {};
+        for (const l of pending) {
+            if (!byCategory[l.category])
+                byCategory[l.category] = [];
+            byCategory[l.category].push(l);
+        }
+        for (const [category, learnings] of Object.entries(byCategory)) {
+            const content = learnings
+                .map((l) => `- **${l.mistakeDescription}**: ${l.correction}`)
+                .join('\n');
+            await git.appendToClaudeMdSection(`Learned: ${category}`, content);
+            // Mark as applied
+            for (const l of learnings) {
+                storage.updateLearning(l.id, { applied: true, appliedAt: Date.now() });
+            }
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `✓ Applied ${pending.length} learning(s) to CLAUDE.md`,
+                },
+            ],
+        };
+    });
+    // gaia_review
+    server.tool('gaia_review', 'Review accumulated learnings across all sessions.', {
+        scope: LearningScopeSchema.optional().describe('Filter by scope'),
+        category: LearningCategorySchema.optional().describe('Filter by category'),
+        pendingOnly: z.boolean().optional().describe('Show only unapplied (default: false)'),
+    }, async ({ scope, category, pendingOnly = false }) => {
+        let learnings = scope ? storage.getLearnings(scope) : storage.getLearnings();
+        if (category) {
+            learnings = learnings.filter((l) => l.category === category);
+        }
+        if (pendingOnly) {
+            learnings = learnings.filter((l) => !l.applied);
+        }
+        if (learnings.length === 0) {
+            return {
+                content: [{ type: 'text', text: 'No learnings found matching criteria.' }],
+            };
+        }
+        let output = `## Learnings (${learnings.length})\n\n`;
+        for (const l of learnings) {
+            output += `### ${l.id} [${l.category}] ${l.applied ? '✓' : '○'}\n`;
+            output += `**Mistake**: ${l.mistakeDescription}\n`;
+            output += `**Correction**: ${l.correction}\n\n`;
+        }
+        return {
+            content: [{ type: 'text', text: output }],
+        };
+    });
+    // ===========================================================================
+    // Context Tools (Memory)
+    // ===========================================================================
+    // gaia_remember
+    server.tool('gaia_remember', 'Save current context state for later restoration. Gaia remembers everything.', {
+        name: z.string().describe('Name for this memory'),
+        description: z.string().optional().describe('Description of the context'),
+        includeGit: z.boolean().optional().describe('Include git info (default: true)'),
+        includeClaudeMd: z.boolean().optional().describe('Include CLAUDE.md (default: true)'),
+        notes: z.string().optional().describe('Additional notes'),
+    }, async ({ name, description, includeGit = true, includeClaudeMd = true, notes }) => {
+        const data = { notes };
+        if (includeGit) {
+            try {
+                const status = await git.getStatus();
+                const log = await git.getLog({ count: 5 });
+                data.gitBranch = status.branch;
+                data.gitStatus = JSON.stringify(status);
+                data.gitLog = log.map((l) => `${l.shortHash} ${l.message}`);
+            }
+            catch {
+                // Not in git repo
+            }
+        }
+        if (includeClaudeMd) {
+            try {
+                data.claudeMd = await git.readClaudeMd();
+            }
+            catch {
+                // No CLAUDE.md
+            }
+        }
+        const snapshot = {
+            id: `mem_${nanoid(8)}`,
+            name,
+            description,
+            data,
+            createdAt: Date.now(),
+        };
+        storage.addSnapshot(snapshot);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `✓ Memory saved: ${snapshot.id}\n\nName: ${name}`,
+                },
+            ],
+        };
+    });
+    // gaia_recall
+    server.tool('gaia_recall', 'Restore a previously saved context. Gaia recalls everything.', {
+        memoryId: z.string().optional().describe('Memory ID to restore'),
+        name: z.string().optional().describe('Memory name to restore'),
+    }, async ({ memoryId, name }) => {
+        const snapshot = memoryId
+            ? storage.getSnapshot(memoryId)
+            : name
+                ? storage.getSnapshotByName(name)
+                : null;
+        if (!snapshot) {
+            // List available memories
+            const all = storage.getSnapshots();
+            if (all.length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No memories available.' }],
+                };
+            }
+            let output = '## Available Memories\n\n';
+            for (const s of all) {
+                output += `- **${s.name}** (${s.id}): ${s.description || 'No description'}\n`;
+            }
+            return {
+                content: [{ type: 'text', text: output }],
+            };
+        }
+        let output = `## Recalled: ${snapshot.name}\n\n`;
+        if (snapshot.data.gitBranch) {
+            output += `**Git Branch**: ${snapshot.data.gitBranch}\n\n`;
+        }
+        if (snapshot.data.gitLog) {
+            output += `**Recent Commits**:\n`;
+            for (const log of snapshot.data.gitLog) {
+                output += `- ${log}\n`;
+            }
+            output += '\n';
+        }
+        if (snapshot.data.notes) {
+            output += `**Notes**: ${snapshot.data.notes}\n`;
+        }
+        return {
+            content: [{ type: 'text', text: output }],
+        };
+    });
+}
+//# sourceMappingURL=index.js.map