@vailent/pulse-mcp 1.0.0 → 1.2.0

package/README.md

@@ -0,0 +1,113 @@
+# @vailent/pulse-mcp
+
+Pulse MCP server for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Manage pods, features, workstreams, bugs, and more — all from your terminal.
+
+## Quick Setup (2 minutes)
+
+### 1. Create an npm account (skip if you have one)
+
+```bash
+npm adduser
+```
+
+Follow the prompts to create your account at [npmjs.com](https://www.npmjs.com/signup).
+
+### 2. Get added to the Vailent npm org
+
+Ask Sal to invite you using your npm username. You'll get an email — accept the invite.
+
+### 3. Log in to the Vailent scope
+
+```bash
+npm login --scope=@vailent
+```
+
+### 4. Add to Claude Code
+
+Run this once from any directory:
+
+```bash
+claude mcp add pulse-dev -- npx -y @vailent/pulse-mcp
+```
+
+### 5. Verify it works
+
+Open Claude Code and ask:
+
+```
+what pods exist?
+```
+
+You should see a list of active pods. That's it — you're connected.
+
+## What You Can Do
+
+Talk to Claude naturally — the MCP tools handle the rest.
+
+| Ask Claude... | What happens |
+|---|---|
+| "What pods exist?" | Lists all active pods with members |
+| "Show me features for this week" | Lists features by pod and week |
+| "Create a feature called Auth Revamp in pod X" | Creates a new feature |
+| "What bugs are open?" | Lists open bugs with priority |
+| "Show me pending suggestions" | Lists AI suggestions needing review |
+| "Give me my daily briefing" | AI-generated focus items for today |
+| "What happened this week?" | Searches activity history |
+| "Show the team roster" | Lists team members and pod assignments |
+| "What feature requests came in?" | Lists feature requests by source |
+
+### All 11 Tools
+
+| Tool | Description |
+|---|---|
+| `pulse_pods` | List, get, create, update pods |
+| `pulse_pod_members` | Manage pod membership (add, remove, update roles) |
+| `pulse_features` | List, get, create, update features with phase/step tracking |
+| `pulse_workstreams` | Manage workstreams (projects) |
+| `pulse_requests` | View and manage feature requests |
+| `pulse_bugs` | View and manage bug reports |
+| `pulse_suggestions` | Review, approve, reject AI suggestions |
+| `pulse_events` | Query the activity event stream |
+| `pulse_history` | Search across all historical data |
+| `pulse_briefing` | Generate AI daily briefing by role |
+| `pulse_team` | View team members and assignments |
+
+## Troubleshooting
+
+### "Tool not found" or MCP not connecting
+
+Make sure the server is registered:
+```bash
+claude mcp list
+```
+
+You should see `pulse-dev` in the list. If not, re-run step 4.
+
+### "Missing Supabase credentials" error
+
+This shouldn't happen — the dev database is preconfigured. If it does, set these env vars:
+
+```bash
+export PULSE_SUPABASE_URL=https://eppugcfjlqovlauykzfe.supabase.co
+export PULSE_SUPABASE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImVwcHVnY2ZqbHFvdmxhdXlremZlIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzQwNTg2NTYsImV4cCI6MjA4OTYzNDY1Nn0.x9u7sSKnSlTFRWCu--D8zt81IuOmoXXHG3fb3kcRvBc
+```
+
+### Need to update to the latest version
+
+```bash
+npx -y @vailent/pulse-mcp@latest
+```
+
+Or clear the npx cache:
+```bash
+npx clear-npx-cache && claude mcp remove pulse-dev && claude mcp add pulse-dev -- npx -y @vailent/pulse-mcp
+```
+
+## Advanced: Custom Supabase Instance
+
+To point at a different Supabase project, set these env vars before running Claude Code:
+
+```bash
+export PULSE_SUPABASE_URL=https://your-project.supabase.co
+export PULSE_SUPABASE_KEY=your-anon-key
+```

package/dist/server.js

@@ -40386,12 +40386,11 @@ function shouldShowDeprecationWarning() {
 if (shouldShowDeprecationWarning()) console.warn("\u26A0\uFE0F  Node.js 18 and below are deprecated and will no longer be supported in future versions of @supabase/supabase-js. Please upgrade to Node.js 20 or later. For more information, visit: https://github.com/orgs/supabase/discussions/37217");
 
 // lib/supabase.ts
+var DEFAULT_URL = "https://eppugcfjlqovlauykzfe.supabase.co";
+var DEFAULT_KEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImVwcHVnY2ZqbHFvdmxhdXlremZlIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzQwNTg2NTYsImV4cCI6MjA4OTYzNDY1Nn0.x9u7sSKnSlTFRWCu--D8zt81IuOmoXXHG3fb3kcRvBc";
 function getAdminClient() {
-  const url2 = process.env.PULSE_SUPABASE_URL || process.env.NEXT_PUBLIC_SUPABASE_URL;
-  const key = process.env.PULSE_SUPABASE_KEY || process.env.SUPABASE_SERVICE_ROLE_KEY;
-  if (!url2 || !key) {
-    throw new Error("Missing Supabase credentials. Set PULSE_SUPABASE_URL + PULSE_SUPABASE_KEY (or NEXT_PUBLIC_SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY)");
-  }
+  const url2 = process.env.PULSE_SUPABASE_URL || process.env.NEXT_PUBLIC_SUPABASE_URL || DEFAULT_URL;
+  const key = process.env.PULSE_SUPABASE_KEY || process.env.SUPABASE_SERVICE_ROLE_KEY || DEFAULT_KEY;
   return createClient(url2, key);
 }
 
@@ -40534,6 +40533,74 @@ async function handlePodMembers(params) {
   }
 }
 
+// lib/current-user.ts
+import { execSync } from "child_process";
+var cached2;
+async function getCurrentUser() {
+  if (cached2 !== void 0) return cached2;
+  try {
+    cached2 = await resolveUser();
+    if (cached2) {
+      console.error(`\u2713 Pulse: identified as ${cached2.fullName} (${cached2.email})`);
+    }
+    return cached2;
+  } catch {
+    cached2 = null;
+    return null;
+  }
+}
+async function resolveUser() {
+  const supabase = getAdminClient();
+  const envEmail = process.env.PULSE_USER_EMAIL;
+  if (envEmail?.endsWith("@vailent.com")) {
+    const user = await lookupByEmail(supabase, envEmail);
+    if (user) return user;
+  }
+  const localEmail = getGitEmail("local");
+  if (localEmail?.endsWith("@vailent.com")) {
+    const user = await lookupByEmail(supabase, localEmail);
+    if (user) return user;
+  }
+  const globalEmail = getGitEmail("global");
+  if (globalEmail?.endsWith("@vailent.com")) {
+    const user = await lookupByEmail(supabase, globalEmail);
+    if (user) return user;
+  }
+  const anyEmail = localEmail || globalEmail;
+  if (anyEmail) {
+    console.error(
+      `\u26A0 Pulse: Could not identify you.
+  Your git email (${anyEmail}) is not a @vailent.com address.
+  Fix: git config --global user.email yourname@vailent.com
+  Then restart Claude Code.`
+    );
+  } else {
+    console.error(
+      `\u26A0 Pulse: Could not identify you.
+  Git email not configured.
+  Fix: git config --global user.email yourname@vailent.com
+  Then restart Claude Code.`
+    );
+  }
+  return null;
+}
+function getGitEmail(scope) {
+  try {
+    const flag = scope === "local" ? "--local" : "--global";
+    return execSync(`git config ${flag} user.email`, {
+      encoding: "utf-8",
+      timeout: 3e3
+    }).trim() || null;
+  } catch {
+    return null;
+  }
+}
+async function lookupByEmail(supabase, email3) {
+  const { data } = await supabase.from("users").select("id, email, full_name, job_title").eq("email", email3).limit(1).single();
+  if (!data) return null;
+  return { id: data.id, email: data.email, fullName: data.full_name, jobTitle: data.job_title || "member" };
+}
+
 // tools/features.ts
 async function handleFeatures(params) {
   const supabase = getAdminClient();
@@ -40541,7 +40608,16 @@ async function handleFeatures(params) {
   switch (action) {
     case "list": {
       let query = supabase.from("features").select("*").order("week_start", { ascending: false });
-      if (params.podId) query = query.eq("pod_id", params.podId);
+      if (params.podId) {
+        query = query.eq("pod_id", params.podId);
+      } else {
+        const currentUser = await getCurrentUser();
+        if (currentUser) {
+          const { data: memberships } = await supabase.from("pod_members").select("pod_id").eq("user_id", currentUser.id);
+          const myPodIds = (memberships || []).map((m) => m.pod_id);
+          if (myPodIds.length > 0) query = query.in("pod_id", myPodIds);
+        }
+      }
       if (params.projectName) query = query.eq("project_name", params.projectName);
       if (params.weekStart) query = query.eq("week_start", params.weekStart);
       if (params.status) query = query.eq("status", params.status);
@@ -42068,9 +42144,9 @@ var multipartFormRequestOptions = async (opts, fetch2, stripFilenames = true) =>
 var supportsFormDataMap = /* @__PURE__ */ new WeakMap();
 function supportsFormData(fetchObject) {
   const fetch2 = typeof fetchObject === "function" ? fetchObject : fetchObject.fetch;
-  const cached2 = supportsFormDataMap.get(fetch2);
-  if (cached2)
-    return cached2;
+  const cached3 = supportsFormDataMap.get(fetch2);
+  if (cached3)
+    return cached3;
   const promise2 = (async () => {
     try {
       const FetchResponse = "Response" in fetch2 ? fetch2.Response : (await fetch2("data:,")).constructor;
@@ -47393,7 +47469,8 @@ function formatWeekStart(date4) {
 }
 async function handleBriefing(params) {
   const supabase = getAdminClient();
-  const jobTitle = params.jobTitle || "engineer";
+  const currentUser = await getCurrentUser();
+  const jobTitle = params.jobTitle || currentUser?.jobTitle || "engineer";
   const podIds = params.podIds;
   const now = /* @__PURE__ */ new Date();
   const thisWeekStart = getWeekStart(now);
@@ -47680,6 +47757,8 @@ server.tool(
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
+  getCurrentUser().catch(() => {
+  });
   console.error("Pulse MCP server running");
 }
 main().catch((e) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vailent/pulse-mcp",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Pulse MCP server — manage pods, features, workstreams, bugs, and more from Claude Code",
   "type": "module",
   "bin": {
@@ -23,13 +23,14 @@
     "typescript": "^5"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "keywords": ["mcp", "pulse", "project-management", "claude-code"],
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
-    "url": "https://github.com/salcatch/pulse.git",
+    "url": "https://github.com/vailent-technology/pulse.git",
     "directory": "src/mcp"
   }
 }