@getthesis/mcp-server 0.4.0 → 1.0.0

package/package.json

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

package/src/index.js

@@ -1,240 +1,132 @@
-#!/usr/bin/env node
-
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
-
-// ─── Config ──────────────────────────────────────────────────────────
-
-const API_URL = process.env.THESIS_API_URL || "https://www.getthesis.io";
-const API_KEY = process.env.THESIS_API_KEY;
-
-async function api(path, options = {}) {
-  if (!API_KEY) throw new Error("THESIS_API_KEY not set");
-
-  const res = await fetch(`${API_URL}${path}`, {
-    ...options,
-    headers: {
-      Authorization: `Bearer ${API_KEY}`,
-      "Content-Type": "application/json",
-      ...options.headers,
-    },
-  });
-
-  const contentType = res.headers.get("content-type") || "";
-  if (contentType.includes("application/json")) {
-    const data = await res.json();
-    if (!res.ok) throw new Error(data.error || `HTTP ${res.status}`);
-    return data;
-  }
-  const text = await res.text();
-  if (!res.ok) throw new Error(`HTTP ${res.status}`);
-  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.2.0" });
-
-// ─── Tools ───────────────────────────────────────────────────────────
-
-server.tool(
-  "thesis_list_items",
-  "List items in the Thesis workbench. Shows items ready for agent execution, dispatched, or awaiting review.",
-  {
-    status: z.enum(["ready", "dispatched", "in_progress", "review", "completed"]).optional().describe("Filter by agent status"),
-  },
-  async ({ status }) => {
-    try {
-      const query = status ? `?agentStatus=${status}` : "";
-      const data = await api(`/api/v1/items${query}`);
-      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 you are about to start working on an item.",
-  { itemId: z.string().describe("The item ID to dispatch") },
-  async ({ itemId }) => {
-    try {
-      const data = await api(`/api/v1/items/${itemId}/dispatch`, {
-        method: "POST",
-        body: JSON.stringify({ provider: "claude_code" }),
-      });
-      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. 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"),
-    decisions: z.string().optional().describe("Key decisions made and why"),
-    unexpected: z.string().optional().describe("Anything unexpected encountered"),
-    successCriteriaMet: z.boolean().nullable().optional().describe("true = met, false = not met, null = partially"),
-  },
-  async ({ itemId, summary, decisions, unexpected, successCriteriaMet }) => {
-    try {
-      const data = await api(`/api/v1/items/${itemId}/outcome`, {
-        method: "POST",
-        body: JSON.stringify({ summary, decisions, unexpected, successCriteriaMet }),
-      });
-      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 and evidence counts.",
-  {},
-  async () => {
-    try {
-      const data = await api("/api/v1/beliefs");
-      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); }
-  }
-);
-
-server.tool(
-  "thesis_check_shifts",
-  "Check if any beliefs have shifted since items were dispatched. Use this to verify the strategic ground hasn't moved during execution.",
-  {},
-  async () => {
-    try {
-      const data = await api("/api/v1/check");
-      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.affectedItems?.length) {
-        lines.push("Affected dispatched items:");
-        data.affectedItems.forEach((i) => lines.push(`  - ${i.title} (${i.agentStatus})`));
-      }
-      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); }
-  }
-);
-
-server.tool(
-  "thesis_capture_context",
-  "Save a piece of strategic context to Thesis. Use this when the conversation surfaces an insight, observation, or signal worth tracking. The user might say 'save that to Thesis', 'capture that', 'that's worth tracking', or similar.",
-  {
-    title: z.string().describe("Short descriptive title (5-10 words)"),
-    content: z.string().describe("The insight, observation, or signal to capture"),
-    source: z.string().optional().default("Claude conversation").describe("Where this came from"),
-  },
-  async ({ title, content, source }) => {
-    try {
-      const data = await api("/api/v1/context", {
-        method: "POST",
-        body: JSON.stringify({ title, content, source }),
-      });
-      let response = `Captured: "${data.title}"`;
-      if (data.beliefSuggestions?.length > 0) {
-        response += `\n${data.beliefSuggestions.length} belief link${data.beliefSuggestions.length > 1 ? "s" : ""} suggested:`;
-        data.beliefSuggestions.forEach((s) => {
-          const arrow = s.direction === "supports" ? "↑" : s.direction === "challenges" ? "↓" : "→";
-          response += `\n  - ${arrow} ${s.beliefStatement} (${s.strength})`;
-        });
-      }
-      response += `\nReview at: ${API_URL}/context`;
-      return ok(response);
-    } catch (e) { return err(e.message); }
-  }
-);
-
-server.tool(
-  "thesis_generate_spec",
-  "Generate a detailed implementation spec for an item using Opus. Uses the full strategic context — beliefs, theme, design principles, existing items — to produce an agent-ready spec. This is a Pro feature and uses the most capable model.",
-  { itemId: z.string().describe("The item ID to generate a spec for") },
-  async ({ itemId }) => {
-    try {
-      const data = await api(`/api/v1/items/${itemId}/generate-spec`, {
-        method: "POST",
-        body: JSON.stringify({}),
-      });
-      return ok(data.spec || "Spec generated but empty.");
-    } catch (e) { return err(e.message); }
-  }
-);
-
-// ─── Start ───────────────────────────────────────────────────────────
-
-const transport = new StdioServerTransport();
-await server.connect(transport);
-console.error("Thesis MCP server v0.4.0 running");
+#!/usr/bin/env node
+
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+
+const API_URL = process.env.THESIS_API_URL || "https://www.getthesis.io";
+const API_KEY = process.env.THESIS_API_KEY;
+
+async function api(path, options = {}) {
+  if (!API_KEY) throw new Error("THESIS_API_KEY not set");
+  const res = await fetch(`${API_URL}${path}`, {
+    ...options,
+    headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json", ...options.headers },
+  });
+  const ct = res.headers.get("content-type") || "";
+  if (ct.includes("application/json")) {
+    const data = await res.json();
+    if (!res.ok) throw new Error(data.error || `HTTP ${res.status}`);
+    return data;
+  }
+  const text = await res.text();
+  if (!res.ok) throw new Error(`HTTP ${res.status}`);
+  return text;
+}
+
+const ok = (text) => ({ content: [{ type: "text", text }] });
+const err = (msg) => ({ content: [{ type: "text", text: `Error: ${msg}` }], isError: true });
+
+const server = new McpServer({ name: "thesis", version: pkg.version });
+
+server.tool("thesis_get_beliefs", "Get all active strategic beliefs with confidence levels and evidence counts.", {}, async () => {
+  try {
+    const data = await api("/api/v1/beliefs");
+    if (!data.beliefs?.length) return ok("No active beliefs.");
+    return ok(data.beliefs.map((b) => `- [${b.confidence}] ${b.statement} (${b.evidenceCount || 0} evidence)`).join("\n"));
+  } catch (e) { return err(e.message); }
+});
+
+server.tool("thesis_check_beliefs", "Check if any beliefs have changed since a given date.", {
+  since: z.string().optional().describe("ISO date. Defaults to 24h ago."),
+}, async ({ since }) => {
+  const sinceDate = since || new Date(Date.now() - 86400000).toISOString();
+  try {
+    const data = await api(`/api/v1/beliefs/changes?since=${sinceDate}`);
+    if (!data.changes?.length) return ok("No belief changes since " + sinceDate);
+    return ok("Belief changes:\n" + data.changes.map((c) => `- [${c.confidence}] ${c.statement}`).join("\n"));
+  } catch (e) { return err(e.message); }
+});
+
+server.tool("thesis_get_context", "Search context entries in the workspace.", {
+  query: z.string().optional().describe("Search query"),
+  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.");
+    return ok(data.entries.map((e) => `### ${e.title}${e.source ? ` (${e.source})` : ""}\n${e.content}\n`).join("\n"));
+  } catch (e) { return err(e.message); }
+});
+
+server.tool("thesis_get_design_principles", "Get the workspace's design principles.", {}, async () => {
+  try {
+    const data = await api("/api/v1/design-principles");
+    if (!data.principles?.length) return ok("No design principles set.");
+    return ok(data.principles.map((p) => `- ${p.statement}${p.rationale ? ` — ${p.rationale}` : ""}`).join("\n"));
+  } catch (e) { return err(e.message); }
+});
+
+server.tool("thesis_capture_context", "Save a piece of strategic context to Thesis.", {
+  title: z.string().describe("Short descriptive title"),
+  content: z.string().describe("The insight or signal to capture"),
+  source: z.string().optional().default("Claude conversation").describe("Source"),
+}, async ({ title, content, source }) => {
+  try {
+    const data = await api("/api/v1/context", { method: "POST", body: JSON.stringify({ title, content, source }) });
+    let response = `Captured: "${data.title}"`;
+    if (data.beliefSuggestions?.length) {
+      response += `\n${data.beliefSuggestions.length} belief link${data.beliefSuggestions.length > 1 ? "s" : ""} suggested:`;
+      data.beliefSuggestions.forEach((s) => {
+        response += `\n  - ${s.direction === "supports" ? "↑" : s.direction === "challenges" ? "↓" : "→"} ${s.beliefStatement} (${s.strength})`;
+      });
+    }
+    return ok(response);
+  } catch (e) { return err(e.message); }
+});
+
+server.tool("thesis_generate_spec", "Generate a detailed implementation spec grounded in strategic context.", {
+  decisionId: z.string().optional().describe("Decision ID from the decision log"),
+  description: z.string().optional().describe("Free-text description of what to build"),
+}, async ({ decisionId, description }) => {
+  if (!decisionId && !description) return err("Provide either decisionId or description.");
+  try {
+    const data = await api("/api/v1/generate-spec", { method: "POST", body: JSON.stringify({ decisionId, description }) });
+    return ok(data.spec || "Spec generated.");
+  } catch (e) { return err(e.message); }
+});
+
+server.tool("thesis_list_decisions", "List recent decisions from the decision log.", {
+  limit: z.number().optional().default(10).describe("Max results"),
+}, async ({ limit }) => {
+  try {
+    const data = await api(`/api/v1/decisions?limit=${limit}`);
+    if (!data.decisions?.length) return ok("No decisions recorded.");
+    return ok(data.decisions.map((d) => `- [${d.reflectionStatus}] ${d.title}\n  Reasoning: ${(d.reasoning || "").slice(0, 100)}...`).join("\n\n"));
+  } catch (e) { return err(e.message); }
+});
+
+server.tool("thesis_log_decision", "Log a decision with reasoning.", {
+  title: z.string().describe("What was decided"),
+  reasoning: z.string().describe("Why"),
+  alternatives: z.string().optional().describe("Alternatives considered"),
+  assumptions: z.string().optional().describe("Key assumptions"),
+}, async ({ title, reasoning, alternatives, assumptions }) => {
+  try {
+    await api("/api/v1/decisions", { method: "POST", body: JSON.stringify({ title, reasoning, alternatives, assumptions }) });
+    return ok(`Decision logged: "${title}". Reflection due in 30 days.`);
+  } catch (e) { return err(e.message); }
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error(`Thesis MCP server v${pkg.version} running`);