@opsee/mcp-server 0.1.0

package/src/utils/format.ts

@@ -0,0 +1,141 @@
+import type { Task, Project, Cycle, DocPage, DocSpace } from "../../gen/api/v1/models_pb.js";
+
+export function formatProject(p: Project): string {
+  const lines = [
+    `${p.name} (${p.shortName})`,
+    `  Slug: ${p.slug}`,
+  ];
+  if (p.description) lines.push(`  Description: ${p.description}`);
+  lines.push(`  Active: ${p.isActive ? "Yes" : "No"}`);
+  lines.push(`  ID: ${p.id}`);
+  return lines.join("\n");
+}
+
+export function formatProjectList(projects: Project[]): string {
+  if (projects.length === 0) return "No projects found.";
+  const header = `Found ${projects.length} project(s):\n`;
+  return (
+    header +
+    projects.map((p, i) => `${i + 1}. ${formatProject(p)}`).join("\n\n")
+  );
+}
+
+export function formatTask(t: Task): string {
+  const lines = [`[${t.identifier}] ${t.title}`];
+
+  const status = t.boardColumn?.name || "Unknown";
+  const priority = t.taskPriority?.name || "None";
+  const type = t.taskType?.name || "Unknown";
+  lines.push(`  Status: ${status} | Priority: ${priority} | Type: ${type}`);
+
+  const assignee = t.assignedUser?.fullName || "Unassigned";
+  const cycle = t.cycle?.name || "None";
+  lines.push(`  Assignee: ${assignee} | Cycle: ${cycle}`);
+
+  if (t.description) {
+    const desc =
+      t.description.length > 200
+        ? t.description.substring(0, 200) + "..."
+        : t.description;
+    lines.push(`  Description: ${desc}`);
+  }
+
+  if (t.dueDate) {
+    lines.push(`  Due: ${new Date(Number(t.dueDate.seconds) * 1000).toISOString().split("T")[0]}`);
+  }
+
+  lines.push(`  ID: ${t.id}`);
+  return lines.join("\n");
+}
+
+export function formatTaskList(tasks: Task[], projectName?: string): string {
+  if (tasks.length === 0) return "No tasks found.";
+  const header = projectName
+    ? `Found ${tasks.length} task(s) in project "${projectName}":\n`
+    : `Found ${tasks.length} task(s):\n`;
+  return (
+    header + tasks.map((t, i) => `${i + 1}. ${formatTask(t)}`).join("\n\n")
+  );
+}
+
+export function formatCycle(c: Cycle): string {
+  const lines = [`${c.name}`];
+  if (c.description) lines.push(`  Description: ${c.description}`);
+  if (c.goal) lines.push(`  Goal: ${c.goal}`);
+  lines.push(`  Start: ${c.startDate} | End: ${c.endDate}`);
+  lines.push(`  Active: ${c.isActive ? "Yes" : "No"}`);
+  lines.push(`  ID: ${c.id}`);
+  return lines.join("\n");
+}
+
+export function formatCycleList(cycles: Cycle[]): string {
+  if (cycles.length === 0) return "No cycles found.";
+  const header = `Found ${cycles.length} cycle(s):\n`;
+  return (
+    header + cycles.map((c, i) => `${i + 1}. ${formatCycle(c)}`).join("\n\n")
+  );
+}
+
+export function formatDocSpace(s: DocSpace): string {
+  const lines = [`${s.title}`];
+  if (s.description) lines.push(`  Description: ${s.description}`);
+  lines.push(`  Slug: ${s.slug}`);
+  lines.push(`  Default: ${s.isDefault ? "Yes" : "No"}`);
+  lines.push(`  ID: ${s.id}`);
+  return lines.join("\n");
+}
+
+export function formatDocSpaceList(spaces: DocSpace[]): string {
+  if (spaces.length === 0) return "No doc spaces found.";
+  const header = `Found ${spaces.length} doc space(s):\n`;
+  return (
+    header +
+    spaces.map((s, i) => `${i + 1}. ${formatDocSpace(s)}`).join("\n\n")
+  );
+}
+
+export function formatDocPage(p: DocPage): string {
+  const lines = [`${p.title}`];
+  lines.push(`  Slug: ${p.slug}`);
+  if (p.currentContent) {
+    const content =
+      p.currentContent.length > 500
+        ? p.currentContent.substring(0, 500) + "..."
+        : p.currentContent;
+    lines.push(`  Content: ${content}`);
+  }
+  lines.push(`  Version: ${p.currentVersionNumber}`);
+  if (p.createdByUser) lines.push(`  Author: ${p.createdByUser.fullName}`);
+  lines.push(`  ID: ${p.id}`);
+  return lines.join("\n");
+}
+
+export function formatDocPageList(pages: DocPage[]): string {
+  if (pages.length === 0) return "No doc pages found.";
+  const header = `Found ${pages.length} doc page(s):\n`;
+  return (
+    header +
+    pages
+      .map(
+        (p, i) =>
+          `${i + 1}. ${p.title} (slug: ${p.slug}, ID: ${p.id})`
+      )
+      .join("\n")
+  );
+}
+
+export function formatError(error: unknown): string {
+  if (error instanceof Error) {
+    if (error.message.includes("401") || error.message.includes("Unauthenticated")) {
+      return "Not authenticated. Run `npx opsee-mcp login` to connect your Opsee account.";
+    }
+    if (error.message.includes("not found") || error.message.includes("404")) {
+      return `Not found. ${error.message}`;
+    }
+    if (error.message.includes("ECONNREFUSED") || error.message.includes("ENOTFOUND")) {
+      return "Could not reach Opsee API. Check your connection and OPSEE_API_URL.";
+    }
+    return error.message;
+  }
+  return String(error);
+}