@sashabogi/foundation 2.0.0 → 2.1.0

package/README.md

@@ -1,16 +1,6 @@
-<p align="center">
-  <img src="docs/foundation-banner.jpg" alt="Foundation - Unified MCP Server" width="100%">
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/@sashabogi/foundation"><img src="https://img.shields.io/npm/v/@sashabogi/foundation.svg" alt="npm version"></a>
-  <a href="https://www.npmjs.com/package/@sashabogi/foundation"><img src="https://img.shields.io/npm/dm/@sashabogi/foundation.svg" alt="npm downloads"></a>
-  <a href="https://github.com/sashabogi/foundation/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@sashabogi/foundation.svg" alt="license"></a>
-</p>
-
 # Foundation v2.0
 
-> **Production-grade MCP server for AI-assisted development with advanced memory**
+> **Production-grade MCP server for AI-assisted development**
 >
 > *"The future is not fixed, but it can be guided."* — Hari Seldon
 
@@ -153,7 +143,6 @@ gaia_save({
   tags: ["auth", "jwt", "security"],
   related_files: ["src/auth/jwt.ts"]
 })
-// Returns: { success: true, memory: { id: "mem_abc123", ... } }
 ```
 
 ### 3. Search Memories
@@ -164,7 +153,6 @@ gaia_search({
   tiers: ["project", "global"],
   limit: 10
 })
-// Returns ranked results with BM25 + composite scoring
 ```
 
 ### 4. Link Memories
@@ -177,7 +165,6 @@ gaia_link({
 })
 
 gaia_graph({ memory_id: "mem_impl_456" })
-// Returns: { depends_on: [{ id: "mem_decision_123", content: "...", ... }] }
 ```
 
 ---
@@ -254,9 +241,9 @@ Gaia provides **workflow patterns and persistent memory**. Version 2.0 transform
 - Searching past conversations
 - Capturing patterns and learnings
 
-**Tools (19 total):**
+**Tools (20 total):**
 
-#### Workflow Tools (12)
+#### Workflow Tools (9)
 ```
 gaia_checkpoint       // Save structured session state
 gaia_status          // Lightweight index card (~150 tokens)
@@ -264,9 +251,6 @@ gaia_query           // Keyword search checkpoint
 gaia_get_decisions   // List architectural decisions
 gaia_get_progress    // Task progress summary
 gaia_get_changes     // Files changed
-gaia_handoff         // Create session handoff document (NEW v2.0)
-gaia_observe         // Auto-detect patterns and observations (NEW v2.0)
-gaia_migrate         // Migrate v1 checkpoint data to v2 (NEW v2.0)
 gaia_learn           // Record correction for CLAUDE.md
 gaia_apply           // Apply learnings to CLAUDE.md
 gaia_review          // Review learnings
@@ -377,30 +361,25 @@ Returns:
 Build **dependency graphs** across memories with 5 typed links:
 
 ```typescript
-// Save a decision
 const decision = gaia_save({
   tier: "project",
   content: "Decision: Use React 18 with TypeScript",
   tags: ["decision", "architecture"]
 })
 
-// Save an implementation
 const impl = gaia_save({
   tier: "project",
   content: "Implementation: Set up Vite with React 18 + TS",
   tags: ["implementation"]
 })
 
-// Link them
 gaia_link({
   from_memory_id: impl.memory.id,
   to_memory_id: decision.memory.id,
   link_type: "depends_on"
 })
 
-// Later - retrieve the graph
 gaia_graph({ memory_id: impl.memory.id })
-// Shows: implementation depends_on decision
 ```
 
 **Link Types:**
@@ -459,7 +438,6 @@ CREATE TABLE memory_links (
 ### Example 1: Building a Knowledge Base
 
 ```typescript
-// Save architectural decisions
 gaia_save({
   tier: "project",
   content: "Decision: Use PostgreSQL with Drizzle ORM for type safety",
@@ -468,7 +446,6 @@ gaia_save({
   metadata: { decision_type: "technical", impact: "high" }
 })
 
-// Save implementation details
 gaia_save({
   tier: "project",
   content: "PostgreSQL connection pool configured with max 20 connections",
@@ -476,7 +453,6 @@ gaia_save({
   related_files: ["src/db/index.ts"]
 })
 
-// Later - search your decisions
 gaia_search({
   query: "database PostgreSQL decision",
   tiers: ["project"],
@@ -487,14 +463,12 @@ gaia_search({
 ### Example 2: Cross-Prompt Dependencies
 
 ```typescript
-// Day 1: Make a decision
 const decision = gaia_save({
   tier: "project",
   content: "Decision: Use tRPC for type-safe API",
   tags: ["decision", "api"]
 })
 
-// Day 2: Implement it
 const impl = gaia_save({
   tier: "project",
   content: "Created tRPC router with user and auth procedures",
@@ -502,35 +476,29 @@ const impl = gaia_save({
   related_files: ["src/server/trpc.ts"]
 })
 
-// Link them
 gaia_link({
   from_memory_id: impl.memory.id,
   to_memory_id: decision.memory.id,
   link_type: "depends_on"
 })
 
-// Day 30: Review decision chain
 gaia_graph({ memory_id: impl.memory.id })
-// Shows the full dependency graph
 ```
 
 ### Example 3: Session Workflow
 
 ```typescript
-// Session start - load context
 gaia_search({
   query: "authentication JWT implementation",
   current_file: "src/auth/verify.ts"
 })
 
-// During session - save observations
 gaia_save({
   tier: "session",
   content: "Bug: JWT verification doesn't handle expired tokens gracefully",
   tags: ["bug", "jwt"]
 })
 
-// Session end - create checkpoint
 gaia_checkpoint({
   summary: "Fixed JWT token expiration handling",
   decisions: [{
@@ -546,127 +514,6 @@ gaia_checkpoint({
 })
 ```
 
-### Example 4: Session Handoff
-
-```typescript
-// At session end - create checkpoint
-gaia_checkpoint({
-  summary: "Implemented user authentication with JWT",
-  purpose: "Build secure auth system",
-  project: "acme-app",
-  decisions: [{
-    topic: "Authentication",
-    decision: "Use JWT with RS256",
-    rationale: "Industry standard, secure, stateless"
-  }],
-  progress: [{
-    task: "Implement login endpoint",
-    status: "completed"
-  }, {
-    task: "Add refresh token logic",
-    status: "in_progress"
-  }],
-  changes: [{
-    file: "src/auth/jwt.ts",
-    action: "created",
-    summary: "JWT token generation and verification"
-  }],
-  context: {
-    branch: "feat/auth",
-    openQuestions: [
-      "Should we implement refresh token rotation?",
-      "What expiration time for access tokens?"
-    ],
-    relevantFiles: ["src/auth/jwt.ts", "src/auth/middleware.ts"]
-  }
-})
-
-// Create handoff document for next session
-gaia_handoff({
-  next_steps: [
-    "Implement refresh token rotation strategy",
-    "Add rate limiting to login endpoint",
-    "Write integration tests for auth flow",
-    "Update API documentation with auth examples"
-  ],
-  context_notes: "Auth system nearly complete. Main work remaining is refresh token security and testing. Consider implementing exponential backoff on failed login attempts.",
-  include_memories: true,
-  memory_query: "authentication JWT security"
-})
-
-// Returns markdown document at ~/.foundation/handoffs/handoff-2026-02-16T10-30-00.md
-// Includes:
-// - Full checkpoint state (decisions, progress, changes)
-// - Relevant memories with BM25 ranking
-// - Next steps
-// - Context notes
-// - Links to related files
-```
-
-### Example 5: Autonomous Observation
-
-```typescript
-// System automatically detects patterns from session activity
-gaia_observe({
-  lookback_days: 30,
-  auto_save: true,
-  min_confidence: "medium"
-})
-
-// Returns analysis like:
-//
-// ## Observations Detected (6)
-//
-// 1. 🔴 **Repeated decision-making on: Authentication**
-//    - Evidence: 3 decisions made about Authentication in current session
-//    - Confidence: high
-//    - Saved: mem_obs_abc123
-//
-// 2. 🔴 **Task blockers detected**
-//    - Evidence: 2 blocked task(s): "Add rate limiting", "Write auth tests"
-//    - Confidence: high
-//    - Saved: mem_obs_def456
-//
-// 3. 🟡 **Frequent modifications to: src/auth/jwt.ts**
-//    - Evidence: 3 changes to src/auth/jwt.ts in current session
-//    - Confidence: medium
-//    - Saved: mem_obs_ghi789
-//
-// 4. 🟡 **Multiple open questions - potential knowledge gaps**
-//    - Evidence: 4 unresolved questions
-//    - Confidence: medium
-//    - Saved: mem_obs_jkl012
-//
-// 5. 🔴 **High activity in areas: authentication, security, jwt**
-//    - Evidence: Frequent tags in recent memories
-//    - Confidence: high
-//    - Saved: mem_obs_mno345
-//
-// 6. 🟡 **File created and deleted: src/temp/test.ts**
-//    - Evidence: May indicate trial-and-error or false start
-//    - Confidence: medium
-//    - Saved: mem_obs_pqr678
-
-// Observations are saved to 'observation' tier
-// Automatically enriched with metadata for pattern analysis
-// Can be searched like any other memory
-
-// Later - search observations
-gaia_search({
-  query: "blocked tasks authentication",
-  tiers: ["observation"],
-  limit: 5
-})
-```
-
-**Pattern types detected:**
-- Repeated topics (same decisions multiple times)
-- Task blockers (blocked status in progress)
-- Frequent file changes (same file modified 3+ times)
-- Knowledge gaps (multiple open questions)
-- Activity hotspots (frequent tags in recent memories)
-- Anti-patterns (created then deleted files)
-
 ---
 
 ## Performance
@@ -704,13 +551,11 @@ Database:
 **Optional:** Start using the new memory tools for persistent knowledge:
 
 ```typescript
-// v1.x approach (still works)
 gaia_checkpoint({
   summary: "Implemented auth",
   decisions: [...]
 })
 
-// v2.0 approach (recommended - searchable + persistent)
 gaia_save({
   tier: "project",
   content: "Auth implementation uses JWT with RS256",

package/dist/cli.js

@@ -14,7 +14,7 @@
 import { Command } from 'commander';
 import chalk from 'chalk';
 import ora from 'ora';
-import { existsSync, mkdirSync, writeFileSync, readFileSync, createReadStream, readdirSync, chmodSync } from 'fs';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, createReadStream, readdirSync } from 'fs';
 import { execSync } from 'child_process';
 import { homedir } from 'os';
 import { join, dirname } from 'path';
@@ -25,6 +25,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 import { ConfigService } from './services/config.service.js';
 import { runSetupWizard, addProvider, testProvider, listProviders, } from './cli/setup-wizard.js';
+import { MemoriaStorage } from './tools/gaia/storage.js';
 // Read version from package.json dynamically
 const packageJson = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
 const VERSION = packageJson.version;
@@ -68,7 +69,7 @@ const FOUNDATION_CLAUDE_MD = `
 
 > **CRITICAL: These tools are ALREADY LOADED. Use them directly without ToolSearch.**
 
-Foundation provides 41 tools for AI-assisted development. All tools use \`mcp__foundation__\` prefix.
+Foundation provides 37 tools for AI-assisted development. All tools use \`mcp__foundation__\` prefix.
 
 ### Demerzel — Codebase Intelligence
 *"I have been watching for 20,000 years."*
@@ -92,16 +93,16 @@ Foundation provides 41 tools for AI-assisted development. All tools use \`mcp__f
 
 | Tool | Purpose |
 |------|---------|
-| \`seldon_invoke\` | Invoke agent role (coder, critic, reviewer, designer) |
+| \`seldon_invoke\` | Invoke agent role (coder, critic, reviewer) |
 | \`seldon_compare\` | Compare multiple agent perspectives |
 | \`seldon_critique\` | Get critical review |
 | \`seldon_review\` | Code review |
 | \`seldon_plan\` | Generate implementation plan |
 | \`seldon_phase_create\` | Break plan into phases |
+| \`seldon_phase_list\` | List phases and status |
 | \`seldon_verify\` | Verify implementation |
 | \`seldon_fix\` | Generate fixes |
 | \`seldon_execute_verified\` | Execute with verification loop |
-| \`seldon_execute_parallel\` | Execute phases in parallel |
 | \`seldon_providers_list\` | List providers |
 | \`seldon_providers_test\` | Test provider health |
 
@@ -110,14 +111,22 @@ Foundation provides 41 tools for AI-assisted development. All tools use \`mcp__f
 
 | Tool | Purpose |
 |------|---------|
-| \`gaia_worktree_create\` | Create git worktree |
-| \`gaia_worktree_list\` | List worktrees |
-| \`gaia_session_register\` | Register session |
-| \`gaia_session_handoff\` | Create handoff document |
-| \`gaia_learn\` | Capture learning |
-| \`gaia_apply\` | Apply learnings to CLAUDE.md |
-| \`gaia_remember\` | Save context |
-| \`gaia_recall\` | Recall context |
+| \`gaia_checkpoint\` | Save structured session state |
+| \`gaia_status\` | Get checkpoint index card (~150 tokens) |
+| \`gaia_query\` | Search checkpoint by keyword |
+| \`gaia_get_decisions\` | Get architectural decisions |
+| \`gaia_get_progress\` | Get task progress |
+| \`gaia_get_changes\` | Get files changed |
+| \`gaia_handoff\` | Create handoff document |
+| \`gaia_observe\` | Analyze session patterns |
+| \`gaia_migrate\` | Migrate v1 checkpoints to v2 |
+| \`gaia_save\` | Save a memory |
+| \`gaia_search\` | Search memories |
+| \`gaia_get\` | Get memory by ID |
+| \`gaia_delete\` | Delete a memory |
+| \`gaia_stats\` | Get memory statistics |
+| \`gaia_link\` | Create typed link between memories |
+| \`gaia_graph\` | Get memory link graph |
 `;
 const program = new Command();
 program
@@ -236,16 +245,6 @@ worktrees:
   max_count: 10
   auto_cleanup: true
   stale_after_hours: 48
-
-learning:
-  auto_apply: false
-  categories:
-    - code_style
-    - architecture
-    - testing
-    - performance
-    - security
-    - documentation
 `;
         writeFileSync(CONFIG_FILE, defaultConfig);
         spinner.succeed('Foundation initialized!');
@@ -339,9 +338,9 @@ mcpCommand
         console.log(chalk.bold('Foundation is now available in all Claude Code sessions.'));
         console.log();
         console.log('Available tools:');
-        console.log(chalk.cyan('  Demerzel (9)') + ' - Codebase intelligence');
-        console.log(chalk.cyan('  Seldon (19)') + '  - Multi-agent orchestration');
-        console.log(chalk.cyan('  Gaia (13)') + '    - Workflow patterns');
+        console.log(chalk.cyan('  Demerzel (9)') + '  - Codebase intelligence');
+        console.log(chalk.cyan('  Seldon (12)') + '   - Multi-agent orchestration');
+        console.log(chalk.cyan('  Gaia (16)') + '     - Workflow patterns + memory');
         console.log();
         console.log(chalk.bold('Optional:'));
         console.log('  Run ' + chalk.cyan('foundation hooks install') + ' in a project to enable');
@@ -384,72 +383,26 @@ mcpCommand
 const hooksCommand = program
     .command('hooks')
     .description('Manage Gaia lifecycle hooks');
-// Hook script templates (embedded so they work when installed from npm)
-const HOOK_SESSION_START = `#!/bin/bash
-# Gaia v2 SessionStart hook
-# Injects the latest checkpoint index card into Claude's context.
-
-find_foundation_dir() {
-  local dir="\${CLAUDE_PROJECT_DIR:-\$PWD}"
-  local count=0
-  while [ \$count -lt 5 ]; do
-    if [ -f "\$dir/.foundation/sessions/latest/index.txt" ]; then
-      echo "\$dir"
-      return 0
-    fi
-    dir="\$(dirname "\$dir")"
-    count=\$((count + 1))
-  done
-  return 1
-}
-
-PROJECT_DIR=\$(find_foundation_dir)
-if [ \$? -eq 0 ]; then
-  INDEX_FILE="\$PROJECT_DIR/.foundation/sessions/latest/index.txt"
-  python3 -c "
-import json, sys
-try:
-    with open(sys.argv[1], 'r') as f:
-        content = f.read().strip()
-    if content:
-        output = {'hookSpecificOutput': {'additionalContext': '[Gaia Checkpoint]\\n' + content}}
-        print(json.dumps(output))
-except Exception:
-    pass
-" "\$INDEX_FILE"
-fi
-`;
-const HOOK_PRE_COMPACT = `#!/bin/bash
-# Gaia v2 PreCompact hook — reminds to checkpoint before context compaction
-printf '{"hookSpecificOutput":{"additionalContext":"[Gaia] Context compaction imminent. If you have unsaved session state (decisions, progress, changes), run gaia_checkpoint now to preserve it before context is lost."}}'
-`;
-const HOOK_POST_TASK = `#!/bin/bash
-# Gaia v2 PostToolUse hook (Task matcher)
-INPUT=\$(cat)
-AGENT_TYPE=\$(echo "\$INPUT" | python3 -c "
-import json, sys
-try:
-    data = json.load(sys.stdin)
-    tool_input = data.get('tool_input', {})
-    print(tool_input.get('subagent_type', ''))
-except Exception:
-    print('')
-" 2>/dev/null)
-
-if [ "\$AGENT_TYPE" = "Explore" ]; then
-  exit 0
-fi
-
-printf '{"hookSpecificOutput":{"additionalContext":"[Gaia] Sub-agent completed. Consider updating your checkpoint if significant progress was made."}}'
-`;
+// Inline hook commands (no external .sh files needed)
 const HOOKS_SETTINGS_CONFIG = {
     hooks: {
         SessionStart: [{
                 matcher: '',
                 hooks: [{
                         type: 'command',
-                        command: '.claude/hooks/gaia-session-start.sh',
-                        timeout: 5,
+                        command: `python3 -c "
+import json, os, pathlib
+d = os.environ.get('CLAUDE_PROJECT_DIR', os.getcwd())
+for _ in range(5):
+    f = os.path.join(d, '.foundation', 'sessions', 'latest', 'index.txt')
+    if os.path.isfile(f):
+        c = pathlib.Path(f).read_text().strip()
+        if c:
+            print(json.dumps({'hookSpecificOutput':{'additionalContext':'[Gaia Checkpoint]\\\\n'+c}}))
+        break
+    d = os.path.dirname(d)
+"`,
+                        timeout: 5000,
                         statusMessage: 'Loading Gaia checkpoint...',
                     }],
             }],
@@ -457,8 +410,8 @@ const HOOKS_SETTINGS_CONFIG = {
                 matcher: '',
                 hooks: [{
                         type: 'command',
-                        command: '.claude/hooks/gaia-pre-compact.sh',
-                        timeout: 5,
+                        command: 'echo \'{"hookSpecificOutput":{"additionalContext":"[Gaia] Context compaction imminent. If you have unsaved session state (decisions, progress, changes), run gaia_checkpoint now to preserve it before context is lost."}}\'',
+                        timeout: 5000,
                         statusMessage: 'Gaia checkpoint reminder',
                     }],
             }],
@@ -466,8 +419,17 @@ const HOOKS_SETTINGS_CONFIG = {
                 matcher: 'Task',
                 hooks: [{
                         type: 'command',
-                        command: '.claude/hooks/gaia-post-task.sh',
-                        timeout: 5,
+                        command: `python3 -c "
+import json, sys
+try:
+    data = json.load(sys.stdin)
+    if data.get('tool_input',{}).get('subagent_type','') == 'Explore':
+        sys.exit(0)
+except Exception:
+    pass
+print(json.dumps({'hookSpecificOutput':{'additionalContext':'[Gaia] Sub-agent completed. Consider updating your checkpoint if significant progress was made.'}}))
+"`,
+                        timeout: 5000,
                     }],
             }],
     },
@@ -479,23 +441,10 @@ hooksCommand
     const spinner = ora('Installing Gaia hooks...').start();
     const cwd = process.cwd();
     try {
-        // 1. Create .claude/hooks/ directory
-        const hooksDir = join(cwd, '.claude', 'hooks');
-        mkdirSync(hooksDir, { recursive: true });
-        spinner.text = 'Created .claude/hooks/ directory';
-        // 2. Write hook scripts
-        const hookFiles = [
-            { name: 'gaia-session-start.sh', content: HOOK_SESSION_START },
-            { name: 'gaia-pre-compact.sh', content: HOOK_PRE_COMPACT },
-            { name: 'gaia-post-task.sh', content: HOOK_POST_TASK },
-        ];
-        for (const hook of hookFiles) {
-            const hookPath = join(hooksDir, hook.name);
-            writeFileSync(hookPath, hook.content);
-            chmodSync(hookPath, 0o755);
-        }
-        spinner.text = 'Wrote hook scripts';
-        // 3. Merge hook configuration into .claude/settings.json
+        // 1. Ensure .claude/ directory exists
+        const claudeDir = join(cwd, '.claude');
+        mkdirSync(claudeDir, { recursive: true });
+        // 2. Merge hook configuration into .claude/settings.json
         const settingsPath = join(cwd, '.claude', 'settings.json');
         let settings = {};
         try {
@@ -512,15 +461,12 @@ hooksCommand
         writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
         spinner.succeed('Gaia hooks installed!');
         console.log();
-        console.log(chalk.bold('Installed hooks:'));
-        console.log(chalk.green('  ✓') + ' ' + chalk.cyan('gaia-session-start.sh') + ' — Injects checkpoint on session start');
-        console.log(chalk.green('  ✓') + ' ' + chalk.cyan('gaia-pre-compact.sh') + '   — Reminds to checkpoint before compaction');
-        console.log(chalk.green('  ✓') + ' ' + chalk.cyan('gaia-post-task.sh') + '      — Reminds to checkpoint after sub-agent tasks');
+        console.log(chalk.bold('Configured hooks (inline commands):'));
+        console.log(chalk.green('  ✓') + ' ' + chalk.cyan('SessionStart') + '  — Injects checkpoint on session start');
+        console.log(chalk.green('  ✓') + ' ' + chalk.cyan('PreCompact') + '    — Reminds to checkpoint before compaction');
+        console.log(chalk.green('  ✓') + ' ' + chalk.cyan('PostToolUse') + '   — Reminds to checkpoint after sub-agent tasks');
         console.log();
-        console.log(chalk.bold('Files written:'));
-        console.log('  ' + chalk.gray(join(hooksDir, 'gaia-session-start.sh')));
-        console.log('  ' + chalk.gray(join(hooksDir, 'gaia-pre-compact.sh')));
-        console.log('  ' + chalk.gray(join(hooksDir, 'gaia-post-task.sh')));
+        console.log(chalk.bold('Updated:'));
         console.log('  ' + chalk.gray(settingsPath));
         console.log();
         console.log(chalk.gray('Hooks will activate on the next Claude Code session in this project.'));
@@ -786,6 +732,89 @@ program
             }
             return;
         }
+        // ---- Memory API endpoints ----
+        if (url.startsWith('/api/memories/stats')) {
+            try {
+                const dbPath = join(homedir(), '.foundation', 'gaia-memory.db');
+                const storage = new MemoriaStorage(dbPath);
+                try {
+                    const gaia = storage.getStats();
+                    const rescue = storage.getRescueStats();
+                    res.writeHead(200, { 'Content-Type': 'application/json', ...corsHeaders });
+                    res.end(JSON.stringify({ gaia, rescue }));
+                }
+                finally {
+                    storage.close();
+                }
+            }
+            catch (err) {
+                res.writeHead(500, { 'Content-Type': 'application/json', ...corsHeaders });
+                res.end(JSON.stringify({ error: err.message }));
+            }
+            return;
+        }
+        if (url.startsWith('/api/memories/recent')) {
+            try {
+                const urlObj = new URL(url, `http://localhost:${port}`);
+                const limit = parseInt(urlObj.searchParams.get('limit') || '50', 10);
+                const tierParam = urlObj.searchParams.get('tier');
+                const tiers = tierParam ? tierParam.split(',') : undefined;
+                const dbPath = join(homedir(), '.foundation', 'gaia-memory.db');
+                const storage = new MemoriaStorage(dbPath);
+                try {
+                    const results = storage.getRecent({ limit, tiers });
+                    res.writeHead(200, { 'Content-Type': 'application/json', ...corsHeaders });
+                    res.end(JSON.stringify(results));
+                }
+                finally {
+                    storage.close();
+                }
+            }
+            catch (err) {
+                res.writeHead(500, { 'Content-Type': 'application/json', ...corsHeaders });
+                res.end(JSON.stringify({ error: err.message }));
+            }
+            return;
+        }
+        if (url.startsWith('/api/memories/search')) {
+            try {
+                const urlObj = new URL(url, `http://localhost:${port}`);
+                const query = urlObj.searchParams.get('q') || '';
+                const tierParam = urlObj.searchParams.get('tier');
+                const tiers = tierParam ? tierParam.split(',') : undefined;
+                const limit = parseInt(urlObj.searchParams.get('limit') || '25', 10);
+                const sourceFilter = urlObj.searchParams.get('source') || 'all';
+                const dbPath = join(homedir(), '.foundation', 'gaia-memory.db');
+                const storage = new MemoriaStorage(dbPath);
+                try {
+                    let results;
+                    if (!query) {
+                        // No query = return recent
+                        results = storage.getRecent({ limit, tiers });
+                    }
+                    else {
+                        results = storage.search({ query, tiers, limit });
+                    }
+                    // Apply source filter client-side
+                    if (sourceFilter === 'gaia') {
+                        results = results.filter(r => !r.memory.id.startsWith('rescue_'));
+                    }
+                    else if (sourceFilter === 'rescued') {
+                        results = results.filter(r => r.memory.id.startsWith('rescue_'));
+                    }
+                    res.writeHead(200, { 'Content-Type': 'application/json', ...corsHeaders });
+                    res.end(JSON.stringify(results));
+                }
+                finally {
+                    storage.close();
+                }
+            }
+            catch (err) {
+                res.writeHead(500, { 'Content-Type': 'application/json', ...corsHeaders });
+                res.end(JSON.stringify({ error: err.message }));
+            }
+            return;
+        }
         // Serve static files
         let filePath = join(uiDistPath, url === '/' ? 'index.html' : url);
         // Handle SPA routing - serve index.html for non-file paths