tlc-claude-code 2.0.1 → 2.1.0

package/server/lib/workspace-api.js

@@ -16,6 +16,8 @@ const { createTestInventory } = require('./test-inventory');
 const { createRoadmapApi } = require('./roadmap-api');
 const { createPlanWriter } = require('./plan-writer');
 const { createBugWriter } = require('./bug-writer');
+const { createMemoryStoreAdapter } = require('./memory-store-adapter');
+const { createCaptureGuard } = require('./capture-guard');
 
 /**
  * Encode a project path to a URL-safe project ID
@@ -62,6 +64,7 @@ function readProjectStatus(projectPath) {
     phaseName: null,
     totalPhases: 0,
     completedPhases: 0,
+    coverage: null,
   };
 
   if (!status.exists) {
@@ -128,6 +131,19 @@ function readProjectStatus(projectPath) {
     }
   }
 
+  // Read coverage from Istanbul coverage-summary.json
+  const coveragePath = path.join(projectPath, 'coverage', 'coverage-summary.json');
+  if (fs.existsSync(coveragePath)) {
+    try {
+      const covData = JSON.parse(fs.readFileSync(coveragePath, 'utf-8'));
+      if (covData.total && covData.total.lines && typeof covData.total.lines.pct === 'number') {
+        status.coverage = covData.total.lines.pct;
+      }
+    } catch {
+      // Malformed coverage file — leave as null
+    }
+  }
+
   return status;
 }
 
@@ -292,7 +308,7 @@ function readProjectBugs(projectPath) {
  * @returns {express.Router} Express router with workspace endpoints
  */
 function createWorkspaceRouter(options = {}) {
-  const { globalConfig, projectScanner } = options;
+  const { globalConfig, projectScanner, memoryApi, memoryDeps = {} } = options;
 
   if (!globalConfig) {
     throw new Error('globalConfig is required');
@@ -302,6 +318,7 @@ function createWorkspaceRouter(options = {}) {
   }
 
   const router = express.Router();
+  const captureGuard = createCaptureGuard();
 
   // =========================================================================
   // GET /config - Returns workspace configuration
@@ -805,6 +822,170 @@ function createWorkspaceRouter(options = {}) {
     }
   });
 
+  // =========================================================================
+  // Memory API routes (Phase 77, fixed per-project in Phase 78)
+  // =========================================================================
+  if (memoryApi) {
+    router.get('/projects/:projectId/memory/decisions', async (req, res) => {
+      try {
+        const roots = globalConfig.getRoots();
+        const project = findProjectById(projectScanner, roots, req.params.projectId);
+        if (!project) return res.status(404).json({ error: 'Project not found' });
+        const adapter = createMemoryStoreAdapter(project.path);
+        const decisions = await adapter.listDecisions();
+        res.json({ decisions });
+      } catch (err) {
+        res.status(500).json({ error: err.message });
+      }
+    });
+
+    router.get('/projects/:projectId/memory/gotchas', async (req, res) => {
+      try {
+        const roots = globalConfig.getRoots();
+        const project = findProjectById(projectScanner, roots, req.params.projectId);
+        if (!project) return res.status(404).json({ error: 'Project not found' });
+        const adapter = createMemoryStoreAdapter(project.path);
+        const gotchas = await adapter.listGotchas();
+        res.json({ gotchas });
+      } catch (err) {
+        res.status(500).json({ error: err.message });
+      }
+    });
+
+    router.get('/projects/:projectId/memory/stats', async (req, res) => {
+      try {
+        const roots = globalConfig.getRoots();
+        const project = findProjectById(projectScanner, roots, req.params.projectId);
+        if (!project) return res.status(404).json({ error: 'Project not found' });
+        const adapter = createMemoryStoreAdapter(project.path);
+        const stats = await adapter.getStats();
+        res.json(stats);
+      } catch (err) {
+        res.status(500).json({ error: err.message });
+      }
+    });
+  }
+
+  // =========================================================================
+  // Memory capture endpoint (Phase 79 Task 5)
+  // =========================================================================
+  router.post('/projects/:projectId/memory/capture', async (req, res) => {
+    try {
+      const projectId = req.params.projectId;
+
+      // Rate limit check
+      const rateCheck = captureGuard.checkRateLimit(projectId);
+      if (!rateCheck.ok) {
+        return res.status(rateCheck.status).json({ error: rateCheck.error });
+      }
+
+      // Payload validation (size + structure)
+      const validation = captureGuard.validate(req.body, projectId);
+      if (!validation.ok) {
+        return res.status(validation.status).json({ error: validation.error });
+      }
+
+      const roots = globalConfig.getRoots();
+      const project = findProjectById(projectScanner, roots, projectId);
+      if (!project) return res.status(404).json({ error: 'Project not found' });
+
+      // Deduplicate exchanges
+      const exchanges = captureGuard.deduplicate(req.body.exchanges, projectId);
+
+      if (exchanges.length === 0) {
+        return res.json({ captured: 0, deduplicated: true });
+      }
+
+      // Process in background — respond immediately
+      let captured = 0;
+      const { observeAndRemember, vectorIndexer } = memoryDeps;
+
+      for (const exchange of exchanges) {
+        try {
+          if (typeof observeAndRemember === 'function') {
+            await observeAndRemember(project.path, exchange);
+          }
+          if (vectorIndexer && typeof vectorIndexer.indexChunk === 'function') {
+            await vectorIndexer.indexChunk(exchange);
+          }
+          captured++;
+        } catch {
+          // Individual exchange failures don't stop the batch
+        }
+      }
+
+      res.json({ captured });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+
+  // =========================================================================
+  // Memory search endpoint (Phase 79 Task 6)
+  // =========================================================================
+  router.get('/projects/:projectId/memory/search', async (req, res) => {
+    try {
+      const roots = globalConfig.getRoots();
+      const project = findProjectById(projectScanner, roots, req.params.projectId);
+      if (!project) return res.status(404).json({ error: 'Project not found' });
+
+      const query = req.query.q;
+      if (!query) {
+        return res.status(400).json({ error: 'Query parameter q is required' });
+      }
+
+      const { semanticRecall } = memoryDeps;
+
+      // Try vector-based semantic recall first
+      if (semanticRecall && typeof semanticRecall.recall === 'function') {
+        try {
+          const results = await semanticRecall.recall(query, { projectRoot: project.path });
+          return res.json({ results: results || [], source: 'vector' });
+        } catch {
+          // Fall through to file-based search
+        }
+      }
+
+      // Fallback: file-based text search
+      try {
+        const { searchMemory } = require('./memory-reader');
+        const results = await searchMemory(project.path, query);
+        return res.json({ results: results || [], source: 'file' });
+      } catch {
+        return res.json({ results: [], source: 'file' });
+      }
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+
+  // =========================================================================
+  // Project file endpoint (Phase 77)
+  // =========================================================================
+  router.get('/projects/:projectId/files/:filename', (req, res) => {
+    try {
+      const roots = globalConfig.getRoots();
+      const project = findProjectById(projectScanner, roots, req.params.projectId);
+      if (!project) return res.status(404).json({ error: 'Project not found' });
+
+      const filename = req.params.filename;
+      // Reject path traversal
+      if (filename.includes('..') || filename.includes('/') || filename.includes('\\')) {
+        return res.status(400).json({ error: 'Invalid filename' });
+      }
+
+      const filePath = path.join(project.path, '.planning', filename);
+      if (!fs.existsSync(filePath)) {
+        return res.status(404).json({ error: 'File not found' });
+      }
+
+      const content = fs.readFileSync(filePath, 'utf-8');
+      res.json({ filename, content });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+
   return router;
 }