amalgm 0.1.88 → 0.1.89

package/runtime/scripts/amalgm-mcp/project-context/rest.js

@@ -0,0 +1,100 @@
+'use strict';
+
+/**
+ * /project-context/* REST routes — the canonical UI/API write path for
+ * project memory docs. Not part of the MCP tool surface.
+ */
+
+const store = require('./store');
+
+function cleanString(value) {
+  return typeof value === 'string' && value.trim() ? value.trim() : '';
+}
+
+async function handleGet(query, sendJson) {
+  const targetPath = cleanString(query?.path);
+  if (!targetPath) {
+    sendJson(400, { error: 'path is required' });
+    return;
+  }
+  try {
+    const context = store.getProjectContext(targetPath, { source: 'project-context:rest-read' });
+    if (!context) {
+      sendJson(404, { error: `No registered Amalgm project contains: ${targetPath}` });
+      return;
+    }
+    sendJson(200, { context });
+  } catch (error) {
+    sendJson(500, { error: error instanceof Error ? error.message : 'Failed to read project context' });
+  }
+}
+
+async function handleList(sendJson) {
+  try {
+    sendJson(200, { contexts: store.listProjectContexts() });
+  } catch (error) {
+    sendJson(500, { error: error instanceof Error ? error.message : 'Failed to list project contexts' });
+  }
+}
+
+async function handleAppendChangeLog(body, sendJson) {
+  const targetPath = cleanString(body?.path || body?.projectPath);
+  if (!targetPath) {
+    sendJson(400, { error: 'path is required' });
+    return;
+  }
+  if (!cleanString(body?.body)) {
+    sendJson(400, { error: 'body is required' });
+    return;
+  }
+  try {
+    const result = store.appendChangeLog(targetPath, body.body, {
+      source: cleanString(body?.source) || 'project-context:rest',
+    });
+    sendJson(200, {
+      success: true,
+      entry: result.entry,
+      timestamp: result.timestamp,
+      context: result.record,
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : 'Failed to append change log entry';
+    sendJson(message.startsWith('No registered Amalgm project') ? 404 : 500, { error: message });
+  }
+}
+
+function writeDocHandler(writeFn) {
+  return async (body, sendJson) => {
+    const targetPath = cleanString(body?.path || body?.projectPath);
+    if (!targetPath) {
+      sendJson(400, { error: 'path is required' });
+      return;
+    }
+    if (typeof body?.content !== 'string') {
+      sendJson(400, { error: 'content is required' });
+      return;
+    }
+    try {
+      const result = writeFn(targetPath, body.content, {
+        source: cleanString(body?.source) || 'project-context:rest',
+      });
+      sendJson(200, { success: true, context: result.record });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Failed to write document';
+      sendJson(message.startsWith('No registered Amalgm project') ? 404 : 500, { error: message });
+    }
+  };
+}
+
+const handleWriteProjectState = writeDocHandler(store.writeProjectState);
+const handleWriteInstructions = writeDocHandler(store.writeInstructions);
+const handleWriteChangeLog = writeDocHandler(store.writeChangeLog);
+
+module.exports = {
+  handleAppendChangeLog,
+  handleGet,
+  handleList,
+  handleWriteChangeLog,
+  handleWriteInstructions,
+  handleWriteProjectState,
+};