@getthesis/mcp-server 0.1.0 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getthesis/mcp-server",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for Thesis — gives AI agents direct access to strategic context",
   "type": "module",
   "main": "src/index.js",

package/src/index.js

@@ -32,26 +32,20 @@ async function api(path, options = {}) {
   return text;
 }
 
+function ok(text) {
+  return { content: [{ type: "text", text }] };
+}
+
+function err(msg) {
+  return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+}
+
 // ─── Server ──────────────────────────────────────────────────────────
 
-const server = new McpServer({ name: "thesis", version: "0.1.0" });
+const server = new McpServer({ name: "thesis", version: "0.2.0" });
 
 // ─── Tools ───────────────────────────────────────────────────────────
 
-server.tool(
-  "thesis_get_brief",
-  "Get the full strategic brief for a workbench item. Returns the item's context including linked beliefs, theme, success criteria, constraints, and design principles. Use this before starting work on an item.",
-  { itemId: z.string().describe("The item ID") },
-  async ({ itemId }) => {
-    try {
-      const brief = await api(`/api/v1/items/${itemId}/brief`);
-      return { content: [{ type: "text", text: typeof brief === "string" ? brief : JSON.stringify(brief, null, 2) }] };
-    } catch (err) {
-      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
-    }
-  }
-);
-
 server.tool(
   "thesis_list_items",
   "List items in the Thesis workbench. Shows items ready for agent execution, dispatched, or awaiting review.",
@@ -62,18 +56,31 @@ server.tool(
     try {
       const query = status ? `?agentStatus=${status}` : "";
       const data = await api(`/api/v1/items${query}`);
-      if (!data.items?.length) return { content: [{ type: "text", text: "No items found." }] };
-      const lines = data.items.map((i) => `- [${i.agentStatus || i.status}] ${i.title} (ID: ${i.id})`);
-      return { content: [{ type: "text", text: lines.join("\n") }] };
-    } catch (err) {
-      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
-    }
+      if (!data.items?.length) return ok("No items found.");
+      const lines = data.items.map(
+        (i) => `- [${i.agentStatus || i.status}] ${i.title} (ID: ${i.id})${i.themeName ? ` — Theme: ${i.themeName}` : ""}`
+      );
+      return ok(lines.join("\n"));
+    } catch (e) { return err(e.message); }
+  }
+);
+
+server.tool(
+  "thesis_get_brief",
+  "Get the full strategic brief for a workbench item. Returns the item's strategic context including beliefs, theme, success criteria, constraints, and design principles. Use this before starting work on an item.",
+  { itemId: z.string().describe("The item ID") },
+  async ({ itemId }) => {
+    try {
+      const data = await api(`/api/v1/items/${itemId}/brief`);
+      // Return the markdown version for readability
+      return ok(data.markdown || JSON.stringify(data, null, 2));
+    } catch (e) { return err(e.message); }
   }
 );
 
 server.tool(
   "thesis_dispatch",
-  "Dispatch an item for agent execution. Assembles the strategic brief, marks the item as dispatched, and returns the full brief. Call this when starting work on an item.",
+  "Dispatch an item for agent execution. Assembles the strategic brief, marks the item as dispatched, and returns the full brief. Call this when you are about to start working on an item.",
   { itemId: z.string().describe("The item ID to dispatch") },
   async ({ itemId }) => {
     try {
@@ -81,16 +88,14 @@ server.tool(
         method: "POST",
         body: JSON.stringify({ provider: "claude_code" }),
       });
-      return { content: [{ type: "text", text: data.brief || JSON.stringify(data, null, 2) }] };
-    } catch (err) {
-      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
-    }
+      return ok(data.brief || JSON.stringify(data, null, 2));
+    } catch (e) { return err(e.message); }
   }
 );
 
 server.tool(
   "thesis_report_outcome",
-  "Report the outcome of completed work back to Thesis. This triggers AI analysis against the workspace's strategic beliefs to generate evidence.",
+  "Report the outcome of completed work back to Thesis. Include what you built, key decisions, and anything unexpected. This triggers AI evidence analysis against strategic beliefs.",
   {
     itemId: z.string().describe("The item ID"),
     summary: z.string().describe("What was built"),
@@ -104,26 +109,24 @@ server.tool(
         method: "POST",
         body: JSON.stringify({ summary, decisions, unexpected, successCriteriaMet }),
       });
-      return { content: [{ type: "text", text: `Outcome recorded. Status: ${data.status || "review"}. Evidence analysis running.` }] };
-    } catch (err) {
-      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
-    }
+      return ok(`Outcome recorded. Status: ${data.status || "review"}. Evidence analysis running.`);
+    } catch (e) { return err(e.message); }
   }
 );
 
 server.tool(
   "thesis_get_beliefs",
-  "Get all active strategic beliefs in the workspace with confidence levels. Use this to understand the strategic context.",
+  "Get all active strategic beliefs in the workspace with confidence levels and evidence counts.",
   {},
   async () => {
     try {
       const data = await api("/api/v1/beliefs");
-      if (!data.beliefs?.length) return { content: [{ type: "text", text: "No active beliefs." }] };
-      const lines = data.beliefs.map((b) => `- [${b.confidence}] ${b.statement}`);
-      return { content: [{ type: "text", text: lines.join("\n") }] };
-    } catch (err) {
-      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
-    }
+      if (!data.beliefs?.length) return ok("No active beliefs.");
+      const lines = data.beliefs.map(
+        (b) => `- [${b.confidence}] ${b.statement} (${b.evidenceCount || 0} evidence, ${b.dependentThemeCount || 0} themes)`
+      );
+      return ok(lines.join("\n"));
+    } catch (e) { return err(e.message); }
   }
 );
 
@@ -134,20 +137,56 @@ server.tool(
   async () => {
     try {
       const data = await api("/api/v1/check");
-      if (!data.hasShifts) return { content: [{ type: "text", text: "All clear — no belief shifts." }] };
+      if (!data.hasShifts) return ok("All clear — no belief shifts detected.");
       const lines = [];
       if (data.changedBeliefs?.length) {
         lines.push("Changed beliefs:");
         data.changedBeliefs.forEach((b) => lines.push(`  - [${b.confidence}] ${b.statement}`));
       }
-      if (data.shiftedItems?.length) {
-        lines.push("Affected items:");
-        data.shiftedItems.forEach((i) => lines.push(`  - ${i.title} (${i.agentStatus})`));
+      if (data.affectedItems?.length) {
+        lines.push("Affected dispatched items:");
+        data.affectedItems.forEach((i) => lines.push(`  - ${i.title} (${i.agentStatus})`));
       }
-      return { content: [{ type: "text", text: lines.join("\n") }] };
-    } catch (err) {
-      return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
-    }
+      return ok(lines.join("\n"));
+    } catch (e) { return err(e.message); }
+  }
+);
+
+server.tool(
+  "thesis_get_context",
+  "Search context entries in the workspace. Use this to find customer feedback, market signals, or other evidence relevant to your current task.",
+  {
+    query: z.string().optional().describe("Search query to filter entries"),
+    limit: z.number().optional().default(10).describe("Max results"),
+  },
+  async ({ query, limit }) => {
+    try {
+      const params = new URLSearchParams();
+      if (query) params.set("q", query);
+      if (limit) params.set("limit", String(limit));
+      const data = await api(`/api/v1/context?${params}`);
+      if (!data.entries?.length) return ok("No context entries found.");
+      const lines = data.entries.map(
+        (e) => `### ${e.title}${e.source ? ` (${e.source})` : ""}\n${e.content}\n`
+      );
+      return ok(lines.join("\n"));
+    } catch (e) { return err(e.message); }
+  }
+);
+
+server.tool(
+  "thesis_get_design_principles",
+  "Get the workspace's design principles and constraints. Reference these when making implementation decisions.",
+  {},
+  async () => {
+    try {
+      const data = await api("/api/v1/design-principles");
+      if (!data.principles?.length) return ok("No design principles set.");
+      const lines = data.principles.map(
+        (p) => `- ${p.statement}${p.rationale ? ` — ${p.rationale}` : ""}`
+      );
+      return ok(lines.join("\n"));
+    } catch (e) { return err(e.message); }
   }
 );
 
@@ -155,4 +194,4 @@ server.tool(
 
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error("Thesis MCP server running");
+console.error("Thesis MCP server v0.2.0 running");