@vailent/pulse-mcp 1.7.0 → 1.8.1

package/dist/server.js

@@ -41675,6 +41675,51 @@ function cleanEscapedString(input) {
   return matched[1].replace(doubleQuoteRegExp, "'");
 }
 
+// lib/work-item-state.ts
+var PRE_DEV_PHASES = ["discovery", "framing", "prototyping", "deep_design"];
+function normalizeWorkItemState(updates, current) {
+  const result = { ...updates };
+  const status = result.status ?? current?.status;
+  const phase = result.phase ?? current?.phase;
+  const track = result.track ?? current?.track;
+  const step = result.implementation_step ?? current?.implementation_step;
+  const hasBlocker = result.has_blocker ?? current?.has_blocker;
+  if (result.status === "shipped") {
+    result.track = "dev";
+    result.phase = "implementation";
+    result.implementation_step = "deploy";
+    result.has_blocker = false;
+    result.blocker_text = null;
+  }
+  if (result.status === "missed" || result.status === "killed" || result.status === "resolved") {
+    result.has_blocker = false;
+    result.blocker_text = null;
+  }
+  if ("phase" in result && result.phase !== "implementation") {
+    result.implementation_step = null;
+    if (PRE_DEV_PHASES.includes(result.phase)) {
+      result.track = "pre_dev";
+    }
+  }
+  if (result.phase === "implementation") {
+    result.track = "dev";
+    const effectiveStep = result.implementation_step ?? current?.implementation_step;
+    if (!effectiveStep && !("implementation_step" in result)) {
+      result.implementation_step = "build";
+    }
+  }
+  if ("implementation_step" in result && result.implementation_step != null) {
+    result.phase = "implementation";
+    result.track = "dev";
+  }
+  if (result.has_blocker === true) {
+    if (status === "shipped" || status === "missed") {
+      result.status = "in_progress";
+    }
+  }
+  return result;
+}
+
 // tools/features.ts
 async function handleFeatures(params) {
   const supabase = getAdminClient();
@@ -41758,10 +41803,12 @@ async function handleFeatures(params) {
         prdFileName: "prd_file_name",
         prdSummary: "prd_summary"
       };
-      const updates = { updated_at: (/* @__PURE__ */ new Date()).toISOString() };
+      const raw = { updated_at: (/* @__PURE__ */ new Date()).toISOString() };
       for (const [key, col] of Object.entries(allowedFields)) {
-        if (params[key] !== void 0) updates[col] = params[key];
+        if (params[key] !== void 0) raw[col] = params[key];
       }
+      const { data: current } = await supabase.from("work_items").select("status, phase, track, implementation_step, has_blocker").eq("id", featureId).single();
+      const updates = normalizeWorkItemState(raw, current || void 0);
       const { error: error2 } = await supabase.from("work_items").update(updates).eq("id", featureId);
       if (error2) return err(error2.message);
       return ok({ id: featureId, ...updates }, `Updated feature ${featureId}`);
@@ -41907,6 +41954,7 @@ async function handleRequests(params) {
       const title = params.title;
       if (!podId || !title?.trim()) return err("podId and title are required", "MISSING_PARAM");
       const { data, error: error2 } = await supabase.from("work_items").insert({
+        id: `f-${Date.now().toString(36)}`,
         title: title.trim(),
         description: params.description || null,
         pod_id: podId,
@@ -41986,6 +42034,7 @@ async function handleBugs(params) {
       const title = params.title;
       if (!podId || !title?.trim()) return err("podId and title are required", "MISSING_PARAM");
       const { data, error: error2 } = await supabase.from("work_items").insert({
+        id: `f-${Date.now().toString(36)}`,
         title: title.trim(),
         description: params.description || null,
         pod_id: podId,
@@ -42001,20 +42050,21 @@ async function handleBugs(params) {
     case "update": {
       const bugId = params.bugId;
       if (!bugId) return err("bugId is required", "MISSING_PARAM");
-      const { data: currentBug } = await supabase.from("work_items").select("status, week_start, title, pod_id").eq("id", bugId).single();
-      const updates = { updated_at: (/* @__PURE__ */ new Date()).toISOString() };
-      if (params.title !== void 0) updates.title = params.title;
-      if (params.description !== void 0) updates.description = params.description;
-      if (params.priority !== void 0) updates.priority = params.priority;
-      if (params.status !== void 0) updates.status = params.status;
-      if (params.podId !== void 0) updates.pod_id = params.podId;
-      if (params.projectName !== void 0) updates.project_name = params.projectName;
+      const { data: currentBug } = await supabase.from("work_items").select("status, phase, track, implementation_step, has_blocker, week_start, title, pod_id").eq("id", bugId).single();
+      const raw = { updated_at: (/* @__PURE__ */ new Date()).toISOString() };
+      if (params.title !== void 0) raw.title = params.title;
+      if (params.description !== void 0) raw.description = params.description;
+      if (params.priority !== void 0) raw.priority = params.priority;
+      if (params.status !== void 0) raw.status = params.status;
+      if (params.podId !== void 0) raw.pod_id = params.podId;
+      if (params.projectName !== void 0) raw.project_name = params.projectName;
       let autoPromoted = false;
       if (currentBug?.status === "open" && !currentBug.week_start && !params.status) {
-        updates.status = "in_progress";
-        updates.week_start = getCurrentWeekStart();
+        raw.status = "in_progress";
+        raw.week_start = getCurrentWeekStart();
         autoPromoted = true;
       }
+      const updates = normalizeWorkItemState(raw, currentBug || void 0);
       const { error: error2 } = await supabase.from("work_items").update(updates).eq("id", bugId);
       if (error2) return err(error2.message);
       if (autoPromoted) {
@@ -47230,6 +47280,45 @@ async function handleTeam(params) {
   }
 }
 
+// tools/search.ts
+async function handleSearch(params) {
+  const text = params.text;
+  if (!text?.trim()) return err("text is required", "MISSING_PARAM");
+  const limit = params.limit || 5;
+  const threshold = params.threshold || 0.78;
+  const apiKey = process.env.OPENAI_API_KEY;
+  if (!apiKey) return err("OPENAI_API_KEY not configured \u2014 cannot perform similarity search", "CONFIG_ERROR");
+  let embedding;
+  try {
+    const res = await fetch("https://api.openai.com/v1/embeddings", {
+      method: "POST",
+      headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
+      body: JSON.stringify({ model: "text-embedding-3-small", input: text.slice(0, 8e3) })
+    });
+    if (!res.ok) return err(`OpenAI error: ${res.status}`, "API_ERROR");
+    const data2 = await res.json();
+    embedding = data2.data[0].embedding;
+  } catch (e) {
+    return err(`Embedding failed: ${e}`, "API_ERROR");
+  }
+  const supabase = getAdminClient();
+  const { data, error: error2 } = await supabase.rpc("match_work_items", {
+    query_embedding: JSON.stringify(embedding),
+    match_threshold: threshold,
+    match_count: limit
+  });
+  if (error2) return err(error2.message);
+  const results = data || [];
+  return ok(
+    results.map((r) => ({
+      ...r,
+      similarity: Math.round(r.similarity * 100) / 100
+    })),
+    `${results.length} similar item(s) found`,
+    results.length
+  );
+}
+
 // server.ts
 try {
   await import("./config-V5TD57MJ.js");
@@ -47281,7 +47370,7 @@ server.tool(
 );
 server.tool(
   "pulse_features",
-  "Manage features and tasks. Actions: list (filter by pod/workstream/week/status/size), get, create (feature or task via size param), update (phase/step/status/blocker/week/prdText/prdFileUrl), delete, add_note, reorder.",
+  "Manage features and tasks. Actions: list (filter by pod/workstream/week/status/size), get, create (feature or task via size param), update (auto-corrects state: shipped\u2192dev/implementation/deploy, phase changes update track/step), delete, add_note (auto-promotes backlog bugs to this week), reorder.",
   {
     action: external_exports.enum(["list", "get", "create", "update", "delete", "add_note", "reorder"]),
     featureId: external_exports.string().optional().describe("Feature ID"),
@@ -47349,7 +47438,7 @@ server.tool(
 );
 server.tool(
   "pulse_bugs",
-  "Track bugs. Actions: list (open/in_progress bugs by pod), create, update (status/priority/podId/projectName), delete, schedule (set week_start \u2014 auto-promotes open\u2192in_progress).",
+  "Track bugs. Actions: list (open/in_progress bugs by pod), create, update (auto-promotes backlog bugs to this week, auto-corrects state consistency), delete, schedule (set week_start \u2014 auto-promotes open\u2192in_progress).",
   {
     action: external_exports.enum(["list", "create", "update", "delete", "schedule"]),
     bugId: external_exports.string().optional().describe("Bug ID"),
@@ -47389,6 +47478,16 @@ server.tool(
   },
   async (params) => handleEvents(params)
 );
+server.tool(
+  "pulse_search",
+  "Semantic similarity search across all work items (bugs, features, requests, feedback). Uses embeddings to find related items. Great for checking duplicates before creating.",
+  {
+    text: external_exports.string().describe("Search text \u2014 describe the bug, feature, or issue to find similar items"),
+    limit: external_exports.number().optional().describe("Max results (default 5)"),
+    threshold: external_exports.number().optional().describe("Similarity threshold 0-1 (default 0.78)")
+  },
+  async (params) => handleSearch(params)
+);
 server.tool(
   "pulse_history",
   "Search historical items (shipped features, closed requests, bugs, feedback). Filters: type, pod, project, days.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vailent/pulse-mcp",
-  "version": "1.7.0",
+  "version": "1.8.1",
   "description": "Pulse MCP server — manage pods, features, workstreams, bugs, and more from Claude Code",
   "type": "module",
   "bin": {