jujugrowth-mcp 1.0.8 → 1.1.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jujugrowth-mcp",
-  "version": "1.0.8",
-  "description": "MCP server connecting your AI coding assistant (Claude, Cursor, Codex) to jujugrowth — pull recommendations and apply them in your repo.",
+  "version": "1.1.0",
+  "description": "MCP server connecting your AI coding assistant (Claude, Cursor, Codex) to jujugrowth — pull your living marketing plan's dev tasks + recommendations and apply them in your repo.",
   "type": "module",
   "bin": {
     "jujugrowth-mcp": "server.mjs"

package/server.mjs

@@ -58,12 +58,35 @@ const TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        tenantId: { type: "string", description: "the site to list (optional; required when more than one site is connected)" },
+        tenantId: {
+          type: "string",
+          description: "the site to list (optional; required when more than one site is connected)",
+        },
       },
       additionalProperties: false,
     },
     run: async (a) =>
-      call("GET", `/recommendations${a.tenantId ? `?tenantId=${encodeURIComponent(a.tenantId)}` : ""}`),
+      call(
+        "GET",
+        `/recommendations${a.tenantId ? `?tenantId=${encodeURIComponent(a.tenantId)}` : ""}`,
+      ),
+  },
+  {
+    name: "list_plan_tasks",
+    description:
+      "List the dev-AI tasks from this site's LIVING MARKETING PLAN — the roadmap steps the plan assigned to the developer AI (changes to the business's own site/app/code; jujugrowth executes the 'autonomous' marketing steps itself). Each task has a ready-to-run `prompt`, plus why it matters, its priority, and the plan's north-star + strategy for context. This is your growth to-do list for the business: pull it, implement the highest-priority tasks in the repo (verify current state first; show a diff/PR), and the next plan regeneration reflects what you shipped via its evidence-grounded status. Pass `tenantId` to target a site; if more than one is connected and you omit it you get {needsSite:true,...} — ASK the user which site, then call again. Never pick a site for them.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        tenantId: {
+          type: "string",
+          description: "the site (optional; required when more than one site is connected)",
+        },
+      },
+      additionalProperties: false,
+    },
+    run: async (a) =>
+      call("GET", `/plan-tasks${a.tenantId ? `?tenantId=${encodeURIComponent(a.tenantId)}` : ""}`),
   },
   {
     name: "get_recommendation",
@@ -92,7 +115,11 @@ const TOOLS = [
       additionalProperties: false,
     },
     run: async (a) =>
-      call("POST", `/recommendations/${a.tenantId}/${a.recId}/handled`, a.note ? { note: a.note } : undefined),
+      call(
+        "POST",
+        `/recommendations/${a.tenantId}/${a.recId}/handled`,
+        a.note ? { note: a.note } : undefined,
+      ),
   },
   {
     name: "request_site_advice",
@@ -106,6 +133,13 @@ const TOOLS = [
     },
     run: async (a) => call("POST", `/site-advice/${a.tenantId}`),
   },
+  {
+    name: "list_capability_gaps",
+    description:
+      "ADMIN/OPERATOR TOKEN ONLY. The jujugrowth system's OWN dev backlog: platform rules it has LEARNED (from docs + real platform responses) but cannot yet check because no collector observes the property the rule needs. Each item names the generic tool to build — `subject.attribute` per platform — with an example rule. Build that collector in the jujugrowth repo (make it write the property as a flat dotted attribute key on the synced entity); the gap auto-resolves once the fact is observable. The list is generated from real learned rules, never a hardcoded checklist. Returns 403 for non-admin tokens.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    run: async () => call("GET", "/capability-gaps"),
+  },
 ];
 
 function send(msg) {
@@ -129,13 +163,16 @@ async function handle(msg) {
         // Workflow the AI should follow unprompted (so the human never has to
         // say "now mark it handled"). Surfaced to the model by MCP clients.
         instructions:
-          `This server provides growth recommendations for ${SITE_LABEL ? `the site "${SITE_LABEL}"` : "the user's site(s)"} and connects them to your code work. Standard loop:\n` +
-          "1) list_recommendations.\n" +
-          "2) get_recommendation for one you'll act on.\n" +
-          "3) Before changing anything, VERIFY the brief's current-state claims against the actual code — they can be stale; skip what's already done.\n" +
-          "4) Implement in the user's repo, scoped to wording/structure/SEO. Never change checkout, auth, or analytics events. Show a diff / open a PR for the user to review.\n" +
-          "5) ALWAYS call mark_recommendation_handled with a short note of what you changed once it's shipped — don't wait to be told.\n" +
-          "Skip GA4-console toggles and business-judgment items — flag those for the user instead of editing code. Campaigns and ad budgets are NOT here — those are owner decisions in the jujugrowth web UI. This server is bound to ONE site; never act on another.",
+          `This server connects ${SITE_LABEL ? `the site "${SITE_LABEL}"` : "the user's site(s)"} growth work to your coding. Two task sources:\n` +
+          "• list_plan_tasks — the dev-AI steps of the business's LIVING MARKETING PLAN (the strategic roadmap). Start here: these are the prioritized site/app/code changes the growth plan needs (each has a ready-to-run prompt + the north-star for context).\n" +
+          "• list_recommendations — individual one-off growth recommendations.\n" +
+          "Standard loop:\n" +
+          "1) list_plan_tasks (and/or list_recommendations).\n" +
+          "2) get_recommendation for any rec you'll act on.\n" +
+          "3) Before changing anything, VERIFY current-state claims against the actual code — they can be stale; skip what's already done.\n" +
+          "4) Implement in the user's repo, scoped to wording/structure/SEO/tracking the plan asks for. Show a diff / open a PR for the user to review.\n" +
+          "5) ALWAYS call mark_recommendation_handled with a short note once a recommendation is shipped — don't wait to be told. (Plan-task progress is reflected automatically by the next plan regeneration's evidence-grounded status.)\n" +
+          "Campaigns and ad budgets are NOT here — those are owner decisions the jujugrowth system runs itself. This server is bound to ONE site; never act on another.",
       },
     });
   }
@@ -144,14 +181,22 @@ async function handle(msg) {
     return send({
       jsonrpc: "2.0",
       id,
-      result: { tools: TOOLS.map(({ name, description, inputSchema }) => ({ name, description, inputSchema })) },
+      result: {
+        tools: TOOLS.map(({ name, description, inputSchema }) => ({
+          name,
+          description,
+          inputSchema,
+        })),
+      },
     });
   }
   if (method === "tools/call") {
     const tool = TOOLS.find((t) => t.name === params?.name);
-    if (!tool) return send({ jsonrpc: "2.0", id, error: { code: -32601, message: "unknown tool" } });
+    if (!tool)
+      return send({ jsonrpc: "2.0", id, error: { code: -32601, message: "unknown tool" } });
     try {
-      if (!TOKEN) throw new Error("JUJUGROWTH_TOKEN not set — generate one in Settings → Developer");
+      if (!TOKEN)
+        throw new Error("JUJUGROWTH_TOKEN not set — generate one in Settings → Developer");
       const result = await tool.run(params.arguments ?? {});
       return send({
         jsonrpc: "2.0",
@@ -168,17 +213,19 @@ async function handle(msg) {
       });
     }
   }
-  if (id !== undefined) send({ jsonrpc: "2.0", id, error: { code: -32601, message: "method not found" } });
+  if (id !== undefined)
+    send({ jsonrpc: "2.0", id, error: { code: -32601, message: "method not found" } });
 }
 
 let buf = "";
 process.stdin.setEncoding("utf8");
 process.stdin.on("data", (chunk) => {
   buf += chunk;
-  let nl;
-  while ((nl = buf.indexOf("\n")) >= 0) {
+  let nl = buf.indexOf("\n");
+  while (nl >= 0) {
     const line = buf.slice(0, nl).trim();
     buf = buf.slice(nl + 1);
     if (line) handle(JSON.parse(line)).catch((e) => process.stderr.write(`${e}\n`));
+    nl = buf.indexOf("\n");
   }
 });