@rayburst/cc 3.1.4 → 3.1.5

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Always-on product context for Claude Code — features, acceptance criteria, and board cards injected automatically.",
-    "version": "3.1.4"
+    "version": "3.1.5"
   },
   "plugins": [
     {
       "name": "rayburst",
       "source": "./",
       "description": "Always-on product context for Claude Code. Automatically injects your Rayburst Product Requirement Registry (features, Gherkin acceptance criteria, board cards) into every coding session.",
-      "version": "3.1.4",
+      "version": "3.1.5",
       "author": {
         "name": "Rayburst"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rayburst",
-  "version": "3.1.4",
+  "version": "3.1.5",
   "description": "Always-on product context for Claude Code. Automatically injects feature atlas and acceptance criteria into every coding session — no slash commands needed.",
   "author": {
     "name": "Rayburst",

package/hooks/pretooluse.mjs

@@ -1,17 +1,53 @@
 #!/usr/bin/env node
 
-/**
- * PreToolUse hook for the Rayburst plugin.
- *
- * Triggered on Write and Edit tool calls. Reads the active feature
- * from cache and injects a coding reminder with criteria checklist.
- */
+// src/hooks/rb-cache.ts
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { createHash } from "node:crypto";
+function getProjectDir() {
+  return process.env["CLAUDE_PROJECT_DIR"] || process.env["CONTEXT_MODE_PROJECT_DIR"] || process.cwd();
+}
+function getProjectHash() {
+  return createHash("md5").update(getProjectDir()).digest("hex").slice(0, 12);
+}
+function getCachePath(type) {
+  return `/tmp/rb-${type}-${getProjectHash()}.json`;
+}
+function readCache(type) {
+  try {
+    const path = getCachePath(type);
+    if (!existsSync(path)) return null;
+    const raw = readFileSync(path, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
 
-import { readCache } from "./rb-cache.mjs";
-import { buildCodingReminderBlock } from "./product-context-block.mjs";
+// src/hooks/product-context-block.ts
+function buildCodingReminderBlock(activeFeature2, filePath2, relatedFeatures2) {
+  if (!activeFeature2) return "";
+  const criteria = (activeFeature2.criteria || []).map((c) => `  - [ ] ${escapeXml(c.title || c.description || "")}`).join("\n");
+  let relatedNote = "";
+  if (relatedFeatures2 && relatedFeatures2.length > 0) {
+    const names = relatedFeatures2.map((f) => `"${escapeXml(f.title)}"`).join(", ");
+    relatedNote = `
+  <related_features>This file may also relate to: ${names}. Check that your changes don't break their criteria.</related_features>`;
+  }
+  return `<rayburst_coding_reminder>
+  <active_feature>${escapeXml(activeFeature2.title)} (${activeFeature2.id})</active_feature>
+  <criteria_checklist>
+${criteria}
+  </criteria_checklist>
+  <file>${escapeXml(filePath2 || "unknown")}</file>${relatedNote}
+  <post_implementation_required>After writing this code, you MUST update Rayburst in the same response: add/update criteria for any new behaviors via rb_add_criterion, update the feature description if it changed via rb_update_feature. Do NOT skip this step.</post_implementation_required>
+</rayburst_coding_reminder>`;
+}
+function escapeXml(str) {
+  return (str || "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
 
-// Read stdin for the hook input
-let input = "";
+// src/hooks/pretooluse.ts
+var input = "";
 try {
   const chunks = [];
   for await (const chunk of process.stdin) {
@@ -21,67 +57,48 @@ try {
 } catch {
   process.exit(0);
 }
-
-let hookInput;
+var hookInput;
 try {
   hookInput = JSON.parse(input);
 } catch {
   process.exit(0);
 }
-
-const toolName = hookInput?.input?.tool_name;
-const toolInput = hookInput?.input?.tool_input;
-
-// Only act on Write and Edit
+var toolName = hookInput?.input?.tool_name;
+var toolInput = hookInput?.input?.tool_input;
 if (toolName !== "Write" && toolName !== "Edit") {
   process.exit(0);
 }
-
-// Read active feature from cache
-const activeFeature = readCache("active-feature");
+var activeFeature = readCache("active-feature");
 if (!activeFeature) {
   process.exit(0);
 }
-
-// Get the file path being edited
-const filePath = toolInput?.file_path || toolInput?.path || "";
-
-// Check if other features mention this file path (basic matching)
-const featureList = readCache("features") || [];
-const relatedFeatures = [];
-
+var filePath = toolInput?.file_path || toolInput?.path || "";
+var featureList = readCache("features") || [];
+var relatedFeatures = [];
 if (filePath) {
   const fileBasename = filePath.split("/").pop() || "";
   const fileDir = filePath.split("/").slice(-2, -1)[0] || "";
-
   for (const f of featureList) {
     if (f.id === activeFeature.id) continue;
     const desc = (f.description || "").toLowerCase();
     const title = (f.title || "").toLowerCase();
-    if (
-      desc.includes(fileBasename.toLowerCase()) ||
-      desc.includes(fileDir.toLowerCase()) ||
-      title.includes(fileBasename.toLowerCase().replace(/\.\w+$/, ""))
-    ) {
+    if (desc.includes(fileBasename.toLowerCase()) || desc.includes(fileDir.toLowerCase()) || title.includes(fileBasename.toLowerCase().replace(/\.\w+$/, ""))) {
       relatedFeatures.push(f);
     }
   }
 }
-
-// Build and inject the Coding Reminder Block
-const contextBlock = buildCodingReminderBlock(
+var contextBlock = buildCodingReminderBlock(
   activeFeature,
   filePath,
   relatedFeatures.slice(0, 3)
 );
-
 if (contextBlock) {
   console.log(
     JSON.stringify({
       hookSpecificOutput: {
         hookEventName: "PreToolUse",
-        additionalContext: contextBlock,
-      },
+        additionalContext: contextBlock
+      }
     })
   );
 }

package/hooks/sessionstart.mjs

@@ -1,59 +1,206 @@
 #!/usr/bin/env node
 
-/**
- * SessionStart hook for the Rayburst plugin.
- *
- * Fetches features + cards from the Rayburst API and injects a
- * Product Context Block as additionalContext. Also writes a feature
- * cache for UserPromptSubmit and PreToolUse hooks to read.
- */
+// src/hooks/rb-cache.ts
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { createHash } from "node:crypto";
+function getProjectDir() {
+  return process.env["CLAUDE_PROJECT_DIR"] || process.env["CONTEXT_MODE_PROJECT_DIR"] || process.cwd();
+}
+function getProjectHash() {
+  return createHash("md5").update(getProjectDir()).digest("hex").slice(0, 12);
+}
+function getCachePath(type) {
+  return `/tmp/rb-${type}-${getProjectHash()}.json`;
+}
+function writeCache(type, data) {
+  try {
+    const path = getCachePath(type);
+    writeFileSync(path, JSON.stringify(data), "utf-8");
+  } catch {
+  }
+}
+function readConfig() {
+  const projectDir = getProjectDir();
+  const configPath = resolve(projectDir, ".claude", "rb-config.md");
+  if (!existsSync(configPath)) return null;
+  const content = readFileSync(configPath, "utf-8");
+  function parseField(section, key) {
+    const sectionMatch = content.match(
+      new RegExp(`## ${section}[\\s\\S]*?(?=\\n## |$)`)
+    );
+    if (!sectionMatch) return null;
+    if (key) {
+      const lineMatch = sectionMatch[0].match(
+        new RegExp(`-\\s*${key}:\\s*(.+)`, "i")
+      );
+      if (lineMatch) return lineMatch[1].trim();
+    }
+    const lines = sectionMatch[0].split("\n").filter((l) => l.trim() && !l.startsWith("#"));
+    return lines[0]?.trim() || null;
+  }
+  const apiKey = process.env["RAYBURST_API_KEY"] || parseField("API", "API Key");
+  const apiUrl = process.env["RAYBURST_API_URL"] || parseField("API", "API URL") || "https://api.rayburst.app/api/v1/mcp";
+  const agentId = process.env["RAYBURST_AGENT_ID"];
+  const boardId = parseField("Board", "ID");
+  const boardSlug = parseField("Board", "Slug");
+  const frontendProjectId = parseField("Projects", "Frontend");
+  const backendProjectId = parseField("Projects", "Backend");
+  const projectUrl = parseField("Project URL", null);
+  if (!apiKey) return null;
+  return {
+    apiKey,
+    apiUrl,
+    agentId: agentId || void 0,
+    boardId: boardId || void 0,
+    boardSlug: boardSlug || void 0,
+    frontendProjectId: frontendProjectId || void 0,
+    backendProjectId: backendProjectId || void 0,
+    projectUrl: projectUrl || void 0
+  };
+}
+var requestId = 0;
+async function mcpCall(config2, toolName, args = {}) {
+  const headers = {
+    "Content-Type": "application/json",
+    Accept: "application/json, text/event-stream",
+    Authorization: `Bearer ${config2.apiKey}`
+  };
+  if (config2.agentId) headers["X-Agent-Id"] = config2.agentId;
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 3e3);
+  try {
+    const res = await fetch(config2.apiUrl, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: ++requestId,
+        method: "tools/call",
+        params: { name: toolName, arguments: args }
+      }),
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    if (!res.ok) return null;
+    const contentType = res.headers.get("content-type") || "";
+    if (contentType.includes("text/event-stream")) {
+      const text = await res.text();
+      const lines = text.split("\n");
+      let lastData = null;
+      for (const line of lines) {
+        if (line.startsWith("data: ")) lastData = line.slice(6);
+      }
+      if (!lastData) return null;
+      try {
+        const parsed = JSON.parse(lastData);
+        return parsed.result ?? parsed;
+      } catch {
+        return null;
+      }
+    }
+    const json = await res.json();
+    return json.result ?? json;
+  } catch {
+    clearTimeout(timeout);
+    return null;
+  }
+}
+function extractData(result) {
+  if (!result) return null;
+  const r = result;
+  if (r.content && Array.isArray(r.content)) {
+    const textItem = r.content.find((c) => c.type === "text");
+    if (textItem) {
+      try {
+        return JSON.parse(textItem.text);
+      } catch {
+        return textItem.text;
+      }
+    }
+  }
+  return result;
+}
+
+// src/hooks/product-context-block.ts
+function buildProductContextBlock(features, cards) {
+  const featureList = Array.isArray(features) ? features : features?.data ?? [];
+  const cardList = Array.isArray(cards) ? cards : cards?.data ?? [];
+  const counts = { draft: 0, active: 0, completed: 0, archived: 0 };
+  for (const f of featureList) {
+    const status = f.status || "draft";
+    counts[status] = (counts[status] || 0) + 1;
+  }
+  const total = featureList.length;
+  const cardCounts = {};
+  for (const c of cardList) {
+    const status = c.status || "draft";
+    cardCounts[status] = (cardCounts[status] || 0) + 1;
+  }
+  const featureLines = featureList.slice(0, 60).map((f) => {
+    const critCount = f.criteriaCount ?? f.criteria?.length ?? "?";
+    return `    <feature id="${f.id}" status="${f.status}" criteria="${critCount}">${escapeXml(f.title)}</feature>`;
+  }).join("\n");
+  const truncated = featureList.length > 60 ? `
+    <truncated shown="60" total="${featureList.length}"/>` : "";
+  const activeCards = cardList.filter(
+    (c) => c.status === "in-progress" || c.status === "validation" || c.status === "ready"
+  );
+  const cardLines = activeCards.slice(0, 20).map((c) => {
+    const featureIds = (c.features || []).map((f) => f.id || f).join(",");
+    return `    <card id="${c.id}" status="${c.status}" features="${featureIds}">${escapeXml(c.title)}</card>`;
+  }).join("\n");
+  return `<rayburst_product_context>
+  <rules>
+    <rule>You have access to a Rayburst feature atlas \u2014 a knowledge graph of product features with Gherkin acceptance criteria. Use it to understand what you're building.</rule>
+    <rule>Before implementing any task, check if a matching feature exists in the atlas below. If found, read its criteria with rb_get_feature and work against them.</rule>
+    <rule>If your changes may affect behaviors described in OTHER features' criteria, flag this to the user before proceeding.</rule>
+    <rule>NEVER create, update, or delete features or criteria in the atlas without explicitly asking the user for confirmation first. Show them what you want to change and wait for approval.</rule>
+    <rule>When implementation is complete, summarize which acceptance criteria were addressed and which remain pending.</rule>
+    <rule>MANDATORY: After every implementation \u2014 in the same response as the code changes \u2014 you MUST update Rayburst without being asked: (1) update affected feature descriptions if behavior changed via rb_update_feature, (2) add new acceptance criteria for every new behavior introduced via rb_add_criterion, (3) update criterion status where applicable via rb_update_criterion. Do NOT wait for the user to ask. Skipping this step is a workflow violation.</rule>
+    <rule>Use mcp__plugin_rayburst_rayburst__rb_* MCP tools to interact with the atlas. Use rb_get_feature to load full criteria for a specific feature.</rule>
+  </rules>
 
-import { readConfig, mcpCall, extractData, writeCache } from "./rb-cache.mjs";
-import { buildProductContextBlock } from "./product-context-block.mjs";
+  <atlas summary="${total} features (${counts["draft"]} draft, ${counts["active"]} active, ${counts["completed"]} completed)">
+${featureLines}${truncated}
+  </atlas>
 
-const config = readConfig();
+  <board summary="${cardList.length} cards \u2014 ${cardCounts["in-progress"] || 0} in-progress, ${cardCounts["validation"] || 0} validation, ${cardCounts["done"] || 0} done">
+${cardLines}
+  </board>
+</rayburst_product_context>`;
+}
+function escapeXml(str) {
+  return (str || "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
 
-// Exit silently if no config — user hasn't run /rb:setup yet
+// src/hooks/sessionstart.ts
+var config = readConfig();
 if (!config || !config.apiKey) {
   process.exit(0);
 }
-
 try {
-  // Fetch features and cards in parallel
   const [featuresRaw, cardsRaw] = await Promise.all([
     mcpCall(config, "list_features", { limit: 100 }),
-    config.boardId
-      ? mcpCall(config, "list_cards", { boardId: config.boardId })
-      : Promise.resolve(null),
+    config.boardId ? mcpCall(config, "list_cards", { boardId: config.boardId }) : Promise.resolve(null)
   ]);
-
   const features = extractData(featuresRaw);
   const cards = extractData(cardsRaw);
-
   if (!features) {
-    // API unreachable — exit silently
     process.exit(0);
   }
-
   const featureList = Array.isArray(features) ? features : features?.data ?? [];
   const cardList = Array.isArray(cards) ? cards : cards?.data ?? [];
-
-  // Write feature cache for downstream hooks
   writeCache("features", featureList);
-
-  // Build and inject the Product Context Block
   const contextBlock = buildProductContextBlock(featureList, cardList);
-
-  // Output as JSON for Claude Code hook system
   console.log(
     JSON.stringify({
       hookSpecificOutput: {
         hookEventName: "SessionStart",
-        additionalContext: contextBlock,
-      },
+        additionalContext: contextBlock
+      }
     })
   );
 } catch {
-  // Silent failure — don't block session startup
   process.exit(0);
 }