@rayburst/cc 3.1.4 → 3.1.6

package/hooks/product-context-block.mjs

@@ -1,131 +0,0 @@
-/**
- * XML block builders for Rayburst hook context injection.
- */
-
-/**
- * Build the main Product Context Block injected at session start.
- * Contains rules, feature atlas summary, and board summary.
- */
-export function buildProductContextBlock(features, cards) {
-  const featureList = Array.isArray(features) ? features : features?.data ?? [];
-  const cardList = Array.isArray(cards) ? cards : cards?.data ?? [];
-
-  // Count features by status
-  const counts = { draft: 0, active: 0, completed: 0, archived: 0 };
-  for (const f of featureList) {
-    counts[f.status || "draft"] = (counts[f.status || "draft"] || 0) + 1;
-  }
-  const total = featureList.length;
-
-  // Count cards by status
-  const cardCounts = {};
-  for (const c of cardList) {
-    cardCounts[c.status || "draft"] = (cardCounts[c.status || "draft"] || 0) + 1;
-  }
-
-  // Build feature lines (compact: one line each)
-  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
-      ? `\n    <truncated shown="60" total="${featureList.length}"/>`
-      : "";
-
-  // Build card lines
-  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 — 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>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>
-
-  <atlas summary="${total} features (${counts.draft} draft, ${counts.active} active, ${counts.completed} completed)">
-${featureLines}${truncated}
-  </atlas>
-
-  <board summary="${cardList.length} cards — ${cardCounts["in-progress"] || 0} in-progress, ${cardCounts["validation"] || 0} validation, ${cardCounts["done"] || 0} done">
-${cardLines}
-  </board>
-</rayburst_product_context>`;
-}
-
-/**
- * Build the Active Feature Block injected when a user prompt matches a feature.
- * Contains full criteria for the matched feature(s).
- */
-export function buildActiveFeatureBlock(features) {
-  if (!features || features.length === 0) return "";
-
-  const featureBlocks = features.map((f) => {
-    const criteria = (f.criteria || [])
-      .map((c) => {
-        return `    <criterion id="${c.id}" status="${c.status}">${escapeXml(c.title || "")} — ${escapeXml(c.description || "")}</criterion>`;
-      })
-      .join("\n");
-
-    return `  <feature id="${f.id}" title="${escapeXml(f.title)}" status="${f.status}">
-    <description>${escapeXml(f.description || "")}</description>
-${criteria}
-  </feature>`;
-  });
-
-  return `<rayburst_active_feature>
-${featureBlocks.join("\n")}
-  <guidance>Work against these acceptance criteria. When done, summarize which criteria your changes address and which remain.</guidance>
-</rayburst_active_feature>`;
-}
-
-/**
- * Build the Coding Reminder Block injected before Write/Edit calls.
- */
-export function buildCodingReminderBlock(activeFeature, filePath, relatedFeatures) {
-  if (!activeFeature) return "";
-
-  const criteria = (activeFeature.criteria || [])
-    .map((c) => `  - [ ] ${escapeXml(c.title || c.description || "")}`)
-    .join("\n");
-
-  let relatedNote = "";
-  if (relatedFeatures && relatedFeatures.length > 0) {
-    const names = relatedFeatures
-      .map((f) => `"${escapeXml(f.title)}"`)
-      .join(", ");
-    relatedNote = `\n  <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(activeFeature.title)} (${activeFeature.id})</active_feature>
-  <criteria_checklist>
-${criteria}
-  </criteria_checklist>
-  <file>${escapeXml(filePath || "unknown")}</file>${relatedNote}
-</rayburst_coding_reminder>`;
-}
-
-function escapeXml(str) {
-  return (str || "")
-    .replace(/&/g, "&amp;")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;");
-}

package/hooks/rb-cache.mjs

@@ -1,247 +0,0 @@
-/**
- * Shared utilities for Rayburst hooks.
- * Config parsing, API calls, file caching, and feature matching.
- */
-
-import { readFileSync, writeFileSync, existsSync } from "node:fs";
-import { resolve } from "node:path";
-import { createHash } from "node:crypto";
-
-// ── Project dir & hashing ──
-
-export function getProjectDir() {
-  return (
-    process.env.CLAUDE_PROJECT_DIR ||
-    process.env.CONTEXT_MODE_PROJECT_DIR ||
-    process.cwd()
-  );
-}
-
-export function getProjectHash() {
-  return createHash("md5").update(getProjectDir()).digest("hex").slice(0, 12);
-}
-
-// ── Cache paths ──
-
-export function getCachePath(type) {
-  return `/tmp/rb-${type}-${getProjectHash()}.json`;
-}
-
-export 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;
-  }
-}
-
-export function writeCache(type, data) {
-  try {
-    const path = getCachePath(type);
-    writeFileSync(path, JSON.stringify(data), "utf-8");
-  } catch {
-    /* best effort */
-  }
-}
-
-// ── Config parsing ──
-
-export 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;
-    const lineMatch = sectionMatch[0].match(
-      new RegExp(`-\\s*${key}:\\s*(.+)`, "i")
-    );
-    if (lineMatch) return lineMatch[1].trim();
-    // Fallback: section content on next line (for Project URL)
-    const lines = sectionMatch[0]
-      .split("\n")
-      .filter((l) => l.trim() && !l.startsWith("#"));
-    return lines[0]?.trim() || null;
-  }
-
-  // Read API key: env var takes priority, then config file
-  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);
-
-  return {
-    apiKey,
-    apiUrl,
-    agentId,
-    boardId,
-    boardSlug,
-    frontendProjectId,
-    backendProjectId,
-    projectUrl,
-  };
-}
-
-// ── API calls ──
-
-let requestId = 0;
-
-export async function mcpCall(config, toolName, args = {}) {
-  const headers = {
-    "Content-Type": "application/json",
-    Accept: "application/json, text/event-stream",
-    Authorization: `Bearer ${config.apiKey}`,
-  };
-  if (config.agentId) headers["X-Agent-Id"] = config.agentId;
-
-  const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), 3000);
-
-  try {
-    const res = await fetch(config.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;
-  }
-}
-
-export function extractData(result) {
-  if (!result) return null;
-  if (result.content && Array.isArray(result.content)) {
-    const textItem = result.content.find((c) => c.type === "text");
-    if (textItem) {
-      try {
-        return JSON.parse(textItem.text);
-      } catch {
-        return textItem.text;
-      }
-    }
-  }
-  return result;
-}
-
-// ── Feature matching ──
-
-const STOP_WORDS = new Set([
-  "the", "a", "an", "is", "are", "was", "were", "be", "been", "being",
-  "have", "has", "had", "do", "does", "did", "will", "would", "could",
-  "should", "may", "might", "shall", "can", "to", "of", "in", "for",
-  "on", "with", "at", "by", "from", "as", "into", "through", "during",
-  "before", "after", "above", "below", "between", "out", "off", "over",
-  "under", "again", "further", "then", "once", "here", "there", "when",
-  "where", "why", "how", "all", "each", "every", "both", "few", "more",
-  "most", "other", "some", "such", "no", "nor", "not", "only", "own",
-  "same", "so", "than", "too", "very", "just", "about", "up", "and",
-  "but", "or", "if", "it", "its", "this", "that", "these", "those",
-  "i", "me", "my", "we", "our", "you", "your", "he", "him", "his",
-  "she", "her", "they", "them", "their", "what", "which", "who", "whom",
-  "help", "implement", "add", "create", "make", "build", "fix", "update",
-  "change", "modify", "please", "need", "want", "let", "get",
-]);
-
-function tokenize(text) {
-  return text
-    .toLowerCase()
-    .replace(/[^a-z0-9\s-]/g, " ")
-    .split(/\s+/)
-    .filter((w) => w.length > 1 && !STOP_WORDS.has(w));
-}
-
-/**
- * Match a user prompt against a list of features.
- * Returns matched features sorted by score, or empty array.
- */
-export function matchFeatures(prompt, features) {
-  if (!prompt || !features || features.length === 0) return [];
-
-  const promptTokens = tokenize(prompt);
-  if (promptTokens.length === 0) return [];
-
-  const promptSet = new Set(promptTokens);
-  const promptLower = prompt.toLowerCase();
-
-  const scored = [];
-
-  for (const feature of features) {
-    const titleTokens = tokenize(feature.title || "");
-    const descTokens = tokenize(feature.description || "");
-    const featureTokens = new Set([...titleTokens, ...descTokens]);
-
-    // Count overlapping tokens
-    let overlap = 0;
-    for (const token of promptSet) {
-      if (featureTokens.has(token)) overlap++;
-    }
-
-    // Bonus: consecutive phrase match in title
-    const titleLower = (feature.title || "").toLowerCase();
-    let phraseBonus = 0;
-    if (promptLower.includes(titleLower) || titleLower.includes(promptLower)) {
-      phraseBonus = 0.5;
-    }
-
-    const score = overlap / promptSet.size + phraseBonus;
-
-    if (score >= 0.25) {
-      scored.push({ feature, score });
-    }
-  }
-
-  // Sort by score desc, prefer active features on tie
-  scored.sort((a, b) => {
-    if (b.score !== a.score) return b.score - a.score;
-    const statusOrder = { active: 0, draft: 1, completed: 2, archived: 3 };
-    return (statusOrder[a.feature.status] ?? 9) - (statusOrder[b.feature.status] ?? 9);
-  });
-
-  return scored.slice(0, 3).map((s) => s.feature);
-}