@gotza02/sequential-thinking 2026.2.30 → 2026.2.32

package/dist/http-server.js

@@ -1,4 +1,19 @@
 #!/usr/bin/env node
+/**
+ * Sequential Thinking HTTP Server
+ *
+ * REST API wrapper for MCP Sequential Thinking components.
+ *
+ * ARCHITECTURE NOTES:
+ * - This server uses in-memory managers (NotesManager, CodeDatabase)
+ * - Each process maintains its own state - NOT suitable for multi-process deployments
+ * - For clustering (PM2 cluster mode, Kubernetes), use a shared database (Redis, PostgreSQL)
+ *
+ * CONCURRENCY WARNING:
+ * - Single process mode: SAFE
+ * - Multi-process mode: DATA WILL BE OUT OF SYNC between processes
+ * - Solution: Use external storage with proper locking for multi-process setups
+ */
 import express from 'express';
 import cors from 'cors';
 import { SequentialThinkingServer } from './lib.js';
@@ -10,16 +25,112 @@ const app = express();
 const PORT = process.env.PORT || 3000;
 app.use(cors());
 app.use(express.json());
-// Initialize MCP components
-const thinkingServer = new SequentialThinkingServer(process.env.THOUGHTS_STORAGE_PATH || 'thoughts_history.json', parseInt(process.env.THOUGHT_DELAY_MS || '0', 10));
-const knowledgeGraph = new ProjectKnowledgeGraph();
-const notesManager = new NotesManager(process.env.NOTES_STORAGE_PATH || 'project_notes.json');
-const codeDb = new CodeDatabase(process.env.CODE_DB_PATH || 'code_database.json');
-// Health check
+/**
+ * ============================================================================
+ * SINGLETON MANAGERS
+ * ============================================================================
+ * Each server instance gets its own managers.
+ * For multi-process deployments, consider using Redis/PostgreSQL as backing store.
+ */
+class ServerManagers {
+    static instance = null;
+    thinking;
+    graph;
+    notes;
+    codeDb;
+    constructor() {
+        this.thinking = new SequentialThinkingServer(process.env.THOUGHTS_STORAGE_PATH || 'thoughts_history.json', parseInt(process.env.THOUGHT_DELAY_MS || '0', 10));
+        this.graph = new ProjectKnowledgeGraph();
+        this.notes = new NotesManager(process.env.NOTES_STORAGE_PATH || 'project_notes.json');
+        this.codeDb = new CodeDatabase(process.env.CODE_DB_PATH || 'code_database.json');
+    }
+    static getInstance() {
+        if (!ServerManagers.instance) {
+            ServerManagers.instance = new ServerManagers();
+        }
+        return ServerManagers.instance;
+    }
+    /**
+     * Reload all managers from disk (useful for external file changes)
+     */
+    async reloadAll() {
+        await this.notes.reload();
+        await this.codeDb.reload();
+    }
+}
+// Get singleton instance
+const managers = ServerManagers.getInstance();
+/**
+ * ============================================================================
+ * HEALTH & METADATA ENDPOINTS
+ * ============================================================================
+ */
 app.get('/health', (req, res) => {
-    res.json({ status: 'ok', service: 'sequential-thinking-http-wrapper' });
+    res.json({
+        status: 'ok',
+        service: 'sequential-thinking-http-wrapper',
+        version: '2.0',
+        timestamp: new Date().toISOString()
+    });
 });
-// Sequential Thinking endpoints
+app.get('/', (req, res) => {
+    res.json({
+        name: 'Sequential Thinking HTTP API',
+        version: '2.0',
+        endpoints: {
+            health: 'GET /health',
+            thinking: {
+                create: 'POST /api/thinking/thought',
+                list: 'GET /api/thinking/history',
+                clear: 'DELETE /api/thinking/history',
+                search: 'GET /api/thinking/search?q=query'
+            },
+            graph: {
+                build: 'POST /api/graph/build',
+                summary: 'GET /api/graph/summary',
+                visualization: 'GET /api/graph/visualization',
+                relationships: 'GET /api/graph/relationships?file=path'
+            },
+            notes: {
+                create: 'POST /api/notes',
+                list: 'GET /api/notes',
+                get: 'GET /api/notes/:id',
+                update: 'PUT /api/notes/:id',
+                delete: 'DELETE /api/notes/:id'
+            },
+            codeDb: {
+                create: 'POST /api/codedb',
+                list: 'GET /api/codedb',
+                get: 'GET /api/codedb/:id',
+                update: 'PUT /api/codedb/:id',
+                delete: 'DELETE /api/codedb/:id',
+                search: 'GET /api/codedb/search?q=query',
+                stats: 'GET /api/codedb/stats'
+            }
+        }
+    });
+});
+/**
+ * ============================================================================
+ * SEQUENTIAL THINKING ENDPOINTS
+ * ============================================================================
+ */
+/**
+ * POST /api/thinking/thought
+ * Process a single thought through the sequential thinking engine
+ *
+ * Request Body:
+ * {
+ *   "thought": string | "text": string,  // Text is for TestSprite compatibility
+ *   "thoughtNumber": number,
+ *   "totalThoughts": number,
+ *   "nextThoughtNeeded": boolean,
+ *   "thoughtType": "analysis" | "planning" | "execution" | "observation" | "hypothesis" | "reflexion" | "solution",
+ *   "blockId"?: string,
+ *   "relatedToolCall"?: string,
+ *   "toolResult"?: string
+ * }
+ */
 app.post('/api/thinking/thought', async (req, res) => {
     try {
         // Support both TestSprite format (text) and native format (thought)
@@ -30,37 +141,48 @@ app.post('/api/thinking/thought', async (req, res) => {
             totalThoughts: req.body.totalThoughts || 1,
             nextThoughtNeeded: req.body.nextThoughtNeeded !== undefined ? req.body.nextThoughtNeeded : true,
             thoughtType: req.body.thoughtType || req.body.type || 'analysis',
+            blockId: req.body.blockId,
+            relatedToolCall: req.body.relatedToolCall,
+            toolResult: req.body.toolResult,
             isRevision: req.body.isRevision,
             revisesThought: req.body.revisesThought,
             branchFromThought: req.body.branchFromThought,
             branchId: req.body.branchId
         };
-        const result = await thinkingServer.processThought(payload);
-        // Transform response to match TestSprite expectations
+        const result = await managers.thinking.processThought(payload);
+        // Parse response
         const responseData = result.content[0]?.text ?
             JSON.parse(result.content[0].text) : {};
-        // Generate a unique ID for the thought
         const thoughtId = `${Date.now()}-${responseData.thoughtNumber || 1}`;
+        // Return response compatible with both native and TestSprite formats
         res.json({
             id: thoughtId,
             thought: responseData.thoughtNumber ? `Thought ${responseData.thoughtNumber}` : thoughtText,
-            text: thoughtText, // Add text field for TestSprite compatibility
+            text: thoughtText,
             type: payload.thoughtType,
             thoughtNumber: responseData.thoughtNumber,
             totalThoughts: responseData.totalThoughts,
             nextThoughtNeeded: responseData.nextThoughtNeeded,
             visualization: responseData.visualization,
-            feedback: responseData.feedback
+            feedback: responseData.feedback,
+            currentBlock: responseData.currentBlock,
+            blockContext: responseData.blockContext
         });
     }
     catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error),
+            status: 'error'
+        });
     }
 });
+/**
+ * GET /api/thinking/history
+ * Get all thoughts from history
+ */
 app.get('/api/thinking/history', async (req, res) => {
     try {
-        const history = await thinkingServer.searchHistory('');
-        // Transform to include id and text fields for TestSprite compatibility
+        const history = await managers.thinking.searchHistory('');
         const transformedHistory = history.map((t, index) => ({
             id: `thought-${index}-${t.thoughtNumber}`,
             text: t.thought,
@@ -69,42 +191,89 @@ app.get('/api/thinking/history', async (req, res) => {
             thoughtNumber: t.thoughtNumber,
             totalThoughts: t.totalThoughts,
             nextThoughtNeeded: t.nextThoughtNeeded,
+            blockId: t.blockId,
+            relatedToolCall: t.relatedToolCall,
             isRevision: t.isRevision,
             revisesThought: t.revisesThought,
             branchFromThought: t.branchFromThought,
-            branchId: t.branchId,
-            blockId: t.blockId
+            branchId: t.branchId
         }));
         res.json(transformedHistory);
     }
     catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+});
+/**
+ * GET /api/thinking/search
+ * Search thoughts by query
+ */
+app.get('/api/thinking/search', async (req, res) => {
+    try {
+        const query = req.query.q || '';
+        const results = await managers.thinking.searchHistory(query);
+        const transformedResults = results.map((t, index) => ({
+            id: `thought-${index}-${t.thoughtNumber}`,
+            text: t.thought,
+            thought: t.thought,
+            type: t.thoughtType,
+            thoughtNumber: t.thoughtNumber,
+            totalThoughts: t.totalThoughts,
+            blockId: t.blockId
+        }));
+        res.json(transformedResults);
+    }
+    catch (error) {
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
     }
 });
+/**
+ * DELETE /api/thinking/history
+ * Clear all thought history
+ */
 app.delete('/api/thinking/history', async (req, res) => {
     try {
-        await thinkingServer.clearHistory();
+        await managers.thinking.clearHistory();
         res.json({ success: true });
     }
     catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
     }
 });
-// Knowledge Graph endpoints
+/**
+ * ============================================================================
+ * KNOWLEDGE GRAPH ENDPOINTS
+ * ============================================================================
+ */
+/**
+ * POST /api/graph/build
+ * Build or rebuild the project knowledge graph
+ *
+ * Request Body:
+ * {
+ *   "path"?: string,  // Project path (default: current directory)
+ *   "directory"?: string  // Alias for path
+ * }
+ */
 app.post('/api/graph/build', async (req, res) => {
     try {
-        // Support both 'path' and 'directory' parameter names
         const pathParam = req.body.path || req.body.directory || '.';
-        console.log(`[DEBUG] Build Graph request for path: ${pathParam}`);
+        console.log(`[Graph] Building for path: ${pathParam}`);
         const safePath = validatePath(pathParam);
-        console.log(`[DEBUG] Safe Path: ${safePath}`);
-        const result = await knowledgeGraph.build(safePath);
-        // Return status field for TestSprite compatibility
+        const result = await managers.graph.build(safePath);
         res.json({
             status: 'success',
             success: true,
             nodeCount: result.nodeCount,
-            totalFiles: result.totalFiles
+            totalFiles: result.totalFiles,
+            cachedFiles: result.cachedFiles,
+            parsedFiles: result.parsedFiles
         });
     }
     catch (error) {
@@ -117,35 +286,78 @@ app.post('/api/graph/build', async (req, res) => {
         });
     }
 });
+/**
+ * POST /api/graph/rebuild
+ * Force rebuild the graph (clears cache first)
+ */
+app.post('/api/graph/rebuild', async (req, res) => {
+    try {
+        const pathParam = req.body.path || req.body.directory || '.';
+        const safePath = validatePath(pathParam);
+        const result = await managers.graph.forceRebuild(safePath);
+        res.json({
+            status: 'success',
+            success: true,
+            nodeCount: result.nodeCount,
+            totalFiles: result.totalFiles,
+            cachedFiles: 0,
+            parsedFiles: result.totalFiles
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const status = message.includes('Access denied') ? 403 : 500;
+        res.status(status).json({
+            status: 'error',
+            error: message
+        });
+    }
+});
+/**
+ * GET /api/graph/summary
+ * Get graph summary statistics
+ */
 app.get('/api/graph/summary', async (req, res) => {
     try {
-        const summary = knowledgeGraph.getSummary();
+        const summary = managers.graph.getSummary();
         res.json(summary);
     }
     catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
     }
 });
+/**
+ * GET /api/graph/visualization
+ * Get Mermaid diagram of the graph
+ */
 app.get('/api/graph/visualization', async (req, res) => {
     try {
-        const viz = knowledgeGraph.toMermaid();
-        // Return as text/plain for TestSprite compatibility
+        const viz = managers.graph.toMermaid();
         res.type('text/plain').send(viz);
     }
     catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
     }
 });
+/**
+ * GET /api/graph/relationships
+ * Get relationships for a specific file
+ *
+ * Query Parameters:
+ * - file: File path (relative or absolute)
+ */
 app.get('/api/graph/relationships', async (req, res) => {
     try {
         const filePath = req.query.file;
         if (!filePath) {
-            // If no file specified, return empty list for TestSprite compatibility
             return res.json([]);
         }
-        // Ensure path is safe
         validatePath(filePath);
-        const relationships = knowledgeGraph.getRelationships(filePath);
+        const relationships = managers.graph.getRelationships(filePath);
         res.json(relationships || null);
     }
     catch (error) {
@@ -154,13 +366,45 @@ app.get('/api/graph/relationships', async (req, res) => {
         res.status(status).json({ error: message });
     }
 });
-// Notes endpoints
+/**
+ * GET /api/graph/deep-context
+ * Get deep context for a specific file
+ */
+app.get('/api/graph/deep-context', async (req, res) => {
+    try {
+        const filePath = req.query.file;
+        if (!filePath) {
+            return res.status(400).json({ error: 'File parameter is required' });
+        }
+        validatePath(filePath);
+        const context = managers.graph.getDeepContext(filePath);
+        res.json(context || null);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const status = message.includes('Access denied') ? 403 : 500;
+        res.status(status).json({ error: message });
+    }
+});
+/**
+ * ============================================================================
+ * NOTES ENDPOINTS
+ * ============================================================================
+ */
+/**
+ * POST /api/notes
+ * Create a new note
+ */
 app.post('/api/notes', async (req, res) => {
     try {
         const { title, content, tags, priority, expiresAt, expiration_date } = req.body;
-        const note = await notesManager.addNote(title, content, tags || [], priority, expiration_date || expiresAt);
-        // Return 200 for compatibility with some test runners
-        res.status(200).json({
+        if (!title || !content) {
+            return res.status(400).json({
+                error: 'Title and content are required'
+            });
+        }
+        const note = await managers.notes.addNote(title, content, tags || [], priority, expiration_date || expiresAt);
+        res.status(201).json({
             id: note.id,
             _id: note.id,
             title: note.title,
@@ -168,19 +412,30 @@ app.post('/api/notes', async (req, res) => {
             tags: note.tags,
             priority: note.priority,
             expiration_date: note.expiresAt,
-            expiresAt: note.expiresAt
+            expiresAt: note.expiresAt,
+            createdAt: note.createdAt,
+            updatedAt: note.updatedAt
         });
     }
     catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
     }
 });
+/**
+ * GET /api/notes
+ * List all notes with optional filtering
+ *
+ * Query Parameters:
+ * - tag: Filter by tag
+ * - includeExpired: Include expired notes (default: false)
+ */
 app.get('/api/notes', async (req, res) => {
     try {
         const tag = req.query.tag;
         const includeExpired = req.query.includeExpired === 'true';
-        const notes = await notesManager.listNotes(tag, includeExpired);
-        // Transform notes to include both id formats
+        const notes = await managers.notes.listNotes(tag, includeExpired);
         const transformedNotes = notes.map(note => ({
             id: note.id,
             _id: note.id,
@@ -189,22 +444,53 @@ app.get('/api/notes', async (req, res) => {
             tags: note.tags,
             priority: note.priority,
             expiration_date: note.expiresAt,
+            expiresAt: note.expiresAt,
+            createdAt: note.createdAt,
+            updatedAt: note.updatedAt
+        }));
+        res.json(transformedNotes);
+    }
+    catch (error) {
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+});
+/**
+ * GET /api/notes/search
+ * Search notes by query
+ */
+app.get('/api/notes/search', async (req, res) => {
+    try {
+        const query = req.query.q || '';
+        const results = await managers.notes.searchNotes(query);
+        const transformedNotes = results.map(note => ({
+            id: note.id,
+            _id: note.id,
+            title: note.title,
+            content: note.content,
+            tags: note.tags,
+            priority: note.priority,
             expiresAt: note.expiresAt
         }));
         res.json(transformedNotes);
     }
     catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
     }
 });
+/**
+ * GET /api/notes/:id
+ * Get a specific note by ID
+ */
 app.get('/api/notes/:id', async (req, res) => {
     try {
-        const notes = await notesManager.listNotes();
-        const note = notes.find(n => n.id === req.params.id);
+        const note = await managers.notes.getNote(req.params.id);
         if (!note) {
             return res.status(404).json({ error: 'Note not found' });
         }
-        // Transform note to include both id formats
         res.json({
             id: note.id,
             _id: note.id,
@@ -213,29 +499,93 @@ app.get('/api/notes/:id', async (req, res) => {
             tags: note.tags,
             priority: note.priority,
             expiration_date: note.expiresAt,
-            expiresAt: note.expiresAt
+            expiresAt: note.expiresAt,
+            createdAt: note.createdAt,
+            updatedAt: note.updatedAt
         });
     }
     catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
     }
 });
+/**
+ * PUT /api/notes/:id
+ * Update a note
+ */
+app.put('/api/notes/:id', async (req, res) => {
+    try {
+        const { title, content, tags } = req.body;
+        const note = await managers.notes.updateNote(req.params.id, {
+            title,
+            content,
+            tags
+        });
+        if (!note) {
+            return res.status(404).json({ error: 'Note not found' });
+        }
+        res.json({
+            id: note.id,
+            _id: note.id,
+            title: note.title,
+            content: note.content,
+            tags: note.tags,
+            priority: note.priority,
+            expiresAt: note.expiresAt,
+            updatedAt: note.updatedAt
+        });
+    }
+    catch (error) {
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+});
+/**
+ * DELETE /api/notes/:id
+ * Delete a note
+ */
 app.delete('/api/notes/:id', async (req, res) => {
     try {
-        await notesManager.deleteNote(req.params.id);
-        res.status(200).json({ success: true });
+        const deleted = await managers.notes.deleteNote(req.params.id);
+        if (!deleted) {
+            return res.status(404).json({ error: 'Note not found' });
+        }
+        res.json({ success: true });
     }
     catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
     }
 });
-// Code Database endpoints
+/**
+ * ============================================================================
+ * CODE DATABASE ENDPOINTS
+ * ============================================================================
+ */
+/**
+ * POST /api/codedb
+ * Create a new code snippet
+ */
 app.post('/api/codedb', async (req, res) => {
     try {
-        const { title, code, language, description, tags } = req.body;
-        const snippet = await codeDb.addSnippet({ title, code, language, description, tags: tags || [] });
-        // Return 200 for compatibility
-        res.status(200).json({
+        const { title, code, language, description, tags, context } = req.body;
+        if (!title || !code || !language) {
+            return res.status(400).json({
+                error: 'Title, code, and language are required'
+            });
+        }
+        const snippet = await managers.codeDb.addSnippet({
+            title,
+            code,
+            language,
+            description: description || '',
+            tags: tags || [],
+            context
+        });
+        res.status(201).json({
             id: snippet.id,
             _id: snippet.id,
             title: snippet.title,
@@ -243,19 +593,128 @@ app.post('/api/codedb', async (req, res) => {
             language: snippet.language,
             description: snippet.description,
             tags: snippet.tags,
+            context: snippet.context,
             updatedAt: snippet.updatedAt
         });
     }
     catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
     }
 });
+/**
+ * GET /api/codedb
+ * List all code snippets (legacy endpoint - uses search)
+ *
+ * Query Parameters:
+ * - q: Search query
+ * - title: Search by title (alias for q)
+ * - code: Search by code (alias for q)
+ * - tag: Search by tag (alias for q)
+ */
 app.get('/api/codedb', async (req, res) => {
     try {
-        const query = req.query.q || req.query.title || req.query.code || req.query.tag || '';
-        const results = await codeDb.searchSnippets(query);
-        // Transform snippets to include both id formats
-        const transformedSnippets = results.map(snippet => ({
+        const query = req.query.q ||
+            req.query.title ||
+            req.query.code ||
+            req.query.tag || '';
+        const searchResults = await managers.codeDb.searchSnippets(query, {
+            fuzzy: true,
+            threshold: 0,
+            limit: 100,
+            includeCode: true
+        });
+        const transformedSnippets = searchResults.map(r => ({
+            id: r.snippet.id,
+            _id: r.snippet.id,
+            title: r.snippet.title,
+            code: r.snippet.code,
+            language: r.snippet.language,
+            description: r.snippet.description,
+            tags: r.snippet.tags,
+            context: r.snippet.context,
+            updatedAt: r.snippet.updatedAt,
+            relevance: r.relevance
+        }));
+        res.json(transformedSnippets);
+    }
+    catch (error) {
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+});
+/**
+ * GET /api/codedb/search
+ * Search code snippets with advanced options
+ *
+ * Query Parameters:
+ * - q: Search query
+ * - fuzzy: Enable fuzzy matching (default: true)
+ * - threshold: Minimum relevance score 0-1 (default: 0.1)
+ * - limit: Max results (default: 50)
+ * - includeCode: Include code in search (default: true)
+ */
+app.get('/api/codedb/search', async (req, res) => {
+    try {
+        const query = req.query.q || '';
+        if (!query.trim()) {
+            return res.json([]);
+        }
+        const options = {
+            fuzzy: req.query.fuzzy !== 'false',
+            threshold: parseFloat(req.query.threshold) || 0.1,
+            limit: parseInt(req.query.limit) || 50,
+            includeCode: req.query.includeCode !== 'false'
+        };
+        const results = await managers.codeDb.searchSnippets(query, options);
+        const transformedResults = results.map(r => ({
+            id: r.snippet.id,
+            _id: r.snippet.id,
+            title: r.snippet.title,
+            code: r.snippet.code,
+            language: r.snippet.language,
+            description: r.snippet.description,
+            tags: r.snippet.tags,
+            context: r.snippet.context,
+            updatedAt: r.snippet.updatedAt,
+            relevance: r.relevance
+        }));
+        res.json(transformedResults);
+    }
+    catch (error) {
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+});
+/**
+ * GET /api/codedb/stats
+ * Get code database statistics
+ */
+app.get('/api/codedb/stats', async (req, res) => {
+    try {
+        const stats = await managers.codeDb.getStats();
+        res.json(stats);
+    }
+    catch (error) {
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+});
+/**
+ * GET /api/codedb/:id
+ * Get a specific code snippet by ID
+ */
+app.get('/api/codedb/:id', async (req, res) => {
+    try {
+        const snippet = await managers.codeDb.getSnippet(req.params.id);
+        if (!snippet) {
+            return res.status(404).json({ error: 'Code snippet not found' });
+        }
+        res.json({
             id: snippet.id,
             _id: snippet.id,
             title: snippet.title,
@@ -263,25 +722,228 @@ app.get('/api/codedb', async (req, res) => {
             language: snippet.language,
             description: snippet.description,
             tags: snippet.tags,
+            context: snippet.context,
             updatedAt: snippet.updatedAt
-        }));
-        res.json(transformedSnippets);
+        });
     }
     catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
     }
 });
-// DELETE endpoint for codedb (for TestSprite compatibility - no actual delete in CodeDatabase)
+/**
+ * PUT /api/codedb/:id
+ * Update a code snippet
+ */
+app.put('/api/codedb/:id', async (req, res) => {
+    try {
+        const { title, code, description, tags, context } = req.body;
+        const snippet = await managers.codeDb.updateSnippet(req.params.id, {
+            title,
+            code,
+            description,
+            tags,
+            context
+        });
+        if (!snippet) {
+            return res.status(404).json({ error: 'Code snippet not found' });
+        }
+        res.json({
+            id: snippet.id,
+            _id: snippet.id,
+            title: snippet.title,
+            code: snippet.code,
+            language: snippet.language,
+            description: snippet.description,
+            tags: snippet.tags,
+            context: snippet.context,
+            updatedAt: snippet.updatedAt
+        });
+    }
+    catch (error) {
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+});
+/**
+ * DELETE /api/codedb/:id
+ * Delete a code snippet (FIXED - now actually deletes!)
+ */
 app.delete('/api/codedb/:id', async (req, res) => {
     try {
-        // CodeDatabase doesn't have delete method, just return success for testing
-        res.status(200).json({ success: true });
+        const deleted = await managers.codeDb.deleteSnippet(req.params.id);
+        if (!deleted) {
+            return res.status(404).json({ error: 'Code snippet not found' });
+        }
+        res.json({ success: true, deleted: true });
     }
     catch (error) {
-        res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+});
+/**
+ * ============================================================================
+ * PATTERNS ENDPOINTS
+ * ============================================================================
+ */
+/**
+ * POST /api/patterns
+ * Learn a new architectural pattern
+ */
+app.post('/api/patterns', async (req, res) => {
+    try {
+        const { name, description } = req.body;
+        if (!name || !description) {
+            return res.status(400).json({
+                error: 'Name and description are required'
+            });
+        }
+        await managers.codeDb.learnPattern(name, description);
+        res.status(201).json({ success: true, name, description });
+    }
+    catch (error) {
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+});
+/**
+ * GET /api/patterns
+ * List all patterns
+ */
+app.get('/api/patterns', async (req, res) => {
+    try {
+        const patterns = await managers.codeDb.listAllPatterns();
+        res.json(patterns);
+    }
+    catch (error) {
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+});
+/**
+ * GET /api/patterns/search
+ * Search patterns
+ */
+app.get('/api/patterns/search', async (req, res) => {
+    try {
+        const query = req.query.q || '';
+        const limit = parseInt(req.query.limit) || 20;
+        const results = await managers.codeDb.searchPatterns(query, limit);
+        res.json(results);
+    }
+    catch (error) {
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+});
+/**
+ * GET /api/patterns/:name
+ * Get a specific pattern
+ */
+app.get('/api/patterns/:name', async (req, res) => {
+    try {
+        // Decode URL-encoded name
+        const name = decodeURIComponent(req.params.name);
+        const pattern = await managers.codeDb.getPattern(name);
+        if (!pattern) {
+            return res.status(404).json({ error: 'Pattern not found' });
+        }
+        res.json({ name, description: pattern });
+    }
+    catch (error) {
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+});
+/**
+ * DELETE /api/patterns/:name
+ * Delete a pattern
+ */
+app.delete('/api/patterns/:name', async (req, res) => {
+    try {
+        const name = decodeURIComponent(req.params.name);
+        const deleted = await managers.codeDb.deletePattern(name);
+        if (!deleted) {
+            return res.status(404).json({ error: 'Pattern not found' });
+        }
+        res.json({ success: true });
+    }
+    catch (error) {
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+});
+/**
+ * ============================================================================
+ * ADMIN ENDPOINTS
+ * ============================================================================
+ */
+/**
+ * POST /api/admin/reload
+ * Reload all managers from disk
+ */
+app.post('/api/admin/reload', async (req, res) => {
+    try {
+        await managers.reloadAll();
+        res.json({
+            success: true,
+            message: 'All managers reloaded from disk'
+        });
+    }
+    catch (error) {
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+});
+/**
+ * GET /api/admin/stats
+ * Get overall system statistics
+ */
+app.get('/api/admin/stats', async (req, res) => {
+    try {
+        const codeStats = await managers.codeDb.getStats();
+        const notesList = await managers.notes.listNotes();
+        const thoughts = await managers.thinking.searchHistory('');
+        res.json({
+            codeDatabase: {
+                snippetCount: codeStats.snippetCount,
+                patternCount: codeStats.patternCount,
+                languages: codeStats.languages
+            },
+            notes: {
+                count: notesList.length
+            },
+            thoughts: {
+                count: thoughts.length
+            },
+            uptime: process.uptime(),
+            memory: process.memoryUsage(),
+            timestamp: new Date().toISOString()
+        });
+    }
+    catch (error) {
+        res.status(500).json({
+            error: error instanceof Error ? error.message : String(error)
+        });
     }
 });
+// Start server
 app.listen(PORT, () => {
     console.log(`Sequential Thinking HTTP Server running on port ${PORT}`);
     console.log(`Health check: http://localhost:${PORT}/health`);
+    console.log(`API docs: http://localhost:${PORT}/`);
+    console.log('');
+    console.log('CONCURRENCY WARNING:');
+    console.log('This server uses in-memory storage. Do NOT run in cluster mode');
+    console.log('without external storage (Redis/PostgreSQL) for data persistence.');
 });