@opsee/mcp-server 0.8.1 → 0.8.2

package/src/utils/format.ts

@@ -1,5 +1,6 @@
-import type { Task, Project, Cycle, DocPage, DocSpace, Milestone, MilestoneTask, User, Label, TaskLabel, Comment, TaskDependency } from "../../gen/api/v1/models_pb.js";
+import type { Task, Project, Cycle, DocPage, DocSpace, Milestone, MilestoneTask, User, Label, TaskLabel, Comment, TaskDependency, Initiative, InitiativeMemoryEntry, TaskPullRequest } from "../../gen/api/v1/models_pb.js";
 import { TaskDependencyType } from "../../gen/api/v1/models_pb.js";
+import type { InitiativeGraph, InitiativeSlice } from "../../gen/api/v1/initiative_pb.js";
 
 export function formatProject(p: Project): string {
   const lines = [
@@ -284,6 +285,248 @@ export function formatTaskDependencyList(deps: TaskDependency[]): string {
     deps.map((d, i) => `${i + 1}. ${formatTaskDependency(d)}`).join("\n\n");
 }
 
+// ---------------------------------------------------------------------------
+// BlockNote JSON → Markdown
+// ---------------------------------------------------------------------------
+
+type BNInlineStyle = { bold?: boolean; italic?: boolean; underline?: boolean; strikethrough?: boolean; code?: boolean };
+type BNTextContent = { type: "text"; text: string; styles?: BNInlineStyle };
+type BNLinkContent = { type: "link"; href: string; content: BNTextContent[] };
+type BNInlineContent = BNTextContent | BNLinkContent;
+
+interface BNBlock {
+  type: string;
+  props?: Record<string, unknown>;
+  content?: BNInlineContent[];
+  children?: BNBlock[];
+}
+
+function renderInline(content: BNInlineContent[]): string {
+  return content.map((node) => {
+    if (node.type === "link") {
+      const inner = renderInline(node.content ?? []);
+      return `[${inner}](${node.href})`;
+    }
+    // text node
+    const t = node as BNTextContent;
+    let s = t.text ?? "";
+    if (t.styles?.code) s = `\`${s}\``;
+    if (t.styles?.bold) s = `**${s}**`;
+    if (t.styles?.italic) s = `*${s}*`;
+    return s;
+  }).join("");
+}
+
+function renderBlock(block: BNBlock, indent: string): string[] {
+  const lines: string[] = [];
+  const inline = renderInline(block.content ?? []);
+
+  switch (block.type) {
+    case "heading": {
+      const level = (block.props?.level as number) || 1;
+      const prefix = "#".repeat(Math.min(Math.max(level, 1), 3));
+      lines.push(`${indent}${prefix} ${inline}`);
+      break;
+    }
+    case "bulletListItem":
+      lines.push(`${indent}- ${inline}`);
+      break;
+    case "numberedListItem":
+      lines.push(`${indent}1. ${inline}`);
+      break;
+    case "checkListItem": {
+      const checked = block.props?.checked ? "x" : " ";
+      lines.push(`${indent}- [${checked}] ${inline}`);
+      break;
+    }
+    case "codeBlock": {
+      const lang = (block.props?.language as string) || "";
+      lines.push(`${indent}\`\`\`${lang}`);
+      lines.push(`${indent}${inline}`);
+      lines.push(`${indent}\`\`\``);
+      break;
+    }
+    case "quote":
+      lines.push(`${indent}> ${inline}`);
+      break;
+    case "paragraph":
+    default:
+      lines.push(`${indent}${inline}`);
+      break;
+  }
+
+  if (block.children?.length) {
+    for (const child of block.children) {
+      lines.push(...renderBlock(child, indent + "  "));
+    }
+  }
+
+  return lines;
+}
+
+export function blockNoteToMarkdown(content: string): string {
+  try {
+    const parsed = JSON.parse(content);
+    if (!Array.isArray(parsed)) return content;
+
+    const mdLines: string[] = [];
+    for (let i = 0; i < parsed.length; i++) {
+      const block = parsed[i] as BNBlock;
+      if (typeof block !== "object" || block === null || !block.type) return content;
+      const blockLines = renderBlock(block, "");
+      mdLines.push(...blockLines);
+      // Separate top-level blocks with a blank line (except last)
+      if (i < parsed.length - 1) mdLines.push("");
+    }
+    return mdLines.join("\n");
+  } catch {
+    return content;
+  }
+}
+
+export function formatInitiative(ini: Initiative): string {
+  const lines = [`${ini.title}`];
+  if (ini.summary) lines.push(`  Summary: ${ini.summary}`);
+  lines.push(`  Status: ${ini.status}`);
+  lines.push(`  Anchor: ${ini.anchorType}${ini.anchorId ? ` #${ini.anchorId}` : ""}`);
+  if (ini.coreIdea) {
+    const md = blockNoteToMarkdown(ini.coreIdea);
+    const preview = md.length > 120 ? md.substring(0, 120) + "..." : md;
+    lines.push(`  Core Idea: ${preview}`);
+  }
+  const creator = ini.createdByUser?.fullName || `User #${ini.createdByUserId}`;
+  lines.push(`  Created by: ${creator}`);
+  lines.push(`  Project ID: ${ini.projectId}`);
+  lines.push(`  ID: ${ini.id} | UUID: ${ini.uuid}`);
+  return lines.join("\n");
+}
+
+export function formatInitiativeList(initiatives: Initiative[]): string {
+  if (initiatives.length === 0) return "No initiatives found.";
+  const header = `Found ${initiatives.length} initiative(s):\n`;
+  return header + initiatives.map((ini, i) => `${i + 1}. ${formatInitiative(ini)}`).join("\n\n");
+}
+
+export function formatInitiativeMemoryEntry(e: InitiativeMemoryEntry): string {
+  const lines = [];
+  const who = e.isSystem ? "system" : e.isAgent ? "agent" : (e.authorUser?.fullName || `User #${e.authorUserId}`);
+  const created = e.createdAt
+    ? new Date((typeof e.createdAt.seconds === "bigint" ? Number(e.createdAt.seconds) : e.createdAt.seconds) * 1000).toISOString()
+    : "—";
+  lines.push(`[${e.kind.toUpperCase()}] ${who} @ ${created}`);
+  lines.push(`  ${e.body}`);
+  if (e.sourceType && e.sourceType !== "none") {
+    const src = e.sourceId ? `${e.sourceType} #${e.sourceId}` : e.sourceType;
+    lines.push(`  Source: ${src}${e.sourceUrl ? ` (${e.sourceUrl})` : ""}`);
+  }
+  lines.push(`  ID: ${e.id}`);
+  return lines.join("\n");
+}
+
+export function formatInitiativeMemoryList(entries: InitiativeMemoryEntry[]): string {
+  if (entries.length === 0) return "No memory entries found.";
+  const header = `Found ${entries.length} memory entry(ies) (newest first):\n`;
+  return header + entries.map((e, i) => `${i + 1}. ${formatInitiativeMemoryEntry(e)}`).join("\n\n");
+}
+
+export function formatInitiativeGraph(graph: InitiativeGraph, taskMap?: Map<number, Task>): string {
+  const lines: string[] = [];
+
+  if (graph.tasks.length === 0) {
+    lines.push("No tasks in this initiative yet.");
+  } else {
+    lines.push(`Tasks (${graph.tasks.length}):`);
+    graph.tasks.forEach((t, i) => {
+      const status = t.boardColumn?.name || "Unknown";
+      const priority = t.taskPriority?.name || "None";
+      lines.push(`  ${i + 1}. [${t.identifier || `#${t.id}`}] ${t.title}`);
+      lines.push(`     Status: ${status} | Priority: ${priority} | ID: ${t.id}`);
+    });
+  }
+
+  if (graph.edges.length > 0) {
+    lines.push(`\nDependency Edges (${graph.edges.length}):`);
+    graph.edges.forEach((e) => {
+      const localMap = taskMap || new Map(graph.tasks.map(t => [t.id, t]));
+      const fromTask = localMap.get(e.fromTaskId);
+      const toTask = localMap.get(e.toTaskId);
+      const from = fromTask ? (fromTask.identifier || `#${e.fromTaskId}`) : `#${e.fromTaskId}`;
+      const to = toTask ? (toTask.identifier || `#${e.toTaskId}`) : `#${e.toTaskId}`;
+      lines.push(`  ${from} ${e.type.toUpperCase()} ${to}`);
+    });
+  }
+
+  if (graph.slices.length > 0) {
+    lines.push(`\nParallel Execution Batches:`);
+    const localMap = taskMap || new Map(graph.tasks.map(t => [t.id, t]));
+    const sorted = [...graph.slices].sort((a, b) => a.layer - b.layer);
+    sorted.forEach((slice: InitiativeSlice) => {
+      const taskLabels = slice.taskIds.map((id) => {
+        const t = localMap.get(id);
+        return t ? `[${t.identifier || `#${id}`}] ${t.title}` : `#${id}`;
+      });
+      lines.push(`  Parallel batch ${slice.layer}: ${taskLabels.join(", ")}`);
+    });
+  }
+
+  return lines.join("\n");
+}
+
+export function formatInitiativeContext(
+  initiative: Initiative,
+  graph: InitiativeGraph | undefined,
+  memoryEntries: InitiativeMemoryEntry[],
+  pullRequests: TaskPullRequest[],
+  comments: Comment[],
+): string {
+  const sections: string[] = [];
+
+  sections.push("=== INITIATIVE ===");
+  sections.push(formatInitiative(initiative));
+
+  if (initiative.coreIdea) {
+    sections.push("\n=== CORE IDEA ===");
+    const md = blockNoteToMarkdown(initiative.coreIdea);
+    const body = md.length > 2000
+      ? md.substring(0, 2000) + "\n... [truncated]"
+      : md;
+    sections.push(body);
+  }
+
+  if (graph) {
+    sections.push("\n=== EXECUTION GRAPH ===");
+    sections.push(formatInitiativeGraph(graph));
+  }
+
+  if (memoryEntries.length > 0) {
+    sections.push("\n=== MEMORY LOG (newest first) ===");
+    memoryEntries.forEach((e, i) => {
+      sections.push(`${i + 1}. ${formatInitiativeMemoryEntry(e)}`);
+    });
+  } else {
+    sections.push("\n=== MEMORY LOG ===");
+    sections.push("No memory entries yet.");
+  }
+
+  if (pullRequests.length > 0) {
+    sections.push("\n=== PULL REQUESTS ===");
+    pullRequests.forEach((pr, i) => {
+      const repo = pr.projectRepository?.repositoryFullName || `repo #${pr.projectRepositoryId}`;
+      sections.push(`  ${i + 1}. [${pr.state.toUpperCase()}] #${pr.prNumber} ${pr.title} (${repo})`);
+      sections.push(`     ${pr.url}`);
+    });
+  }
+
+  if (comments.length > 0) {
+    sections.push("\n=== DISCUSSION ===");
+    comments.forEach((c, i) => {
+      sections.push(`${i + 1}. ${formatComment(c)}`);
+    });
+  }
+
+  return sections.join("\n");
+}
+
 export function formatError(error: unknown): string {
   if (error instanceof Error) {
     const msg = error.message;