@opsee/mcp-server 0.5.7 → 0.6.1

package/src/utils/format.ts

@@ -1,4 +1,5 @@
-import type { Task, Project, Cycle, DocPage, DocSpace, Milestone, MilestoneTask } from "../../gen/api/v1/models_pb.js";
+import type { Task, Project, Cycle, DocPage, DocSpace, Milestone, MilestoneTask, User, Label, TaskLabel, Comment, TaskDependency } from "../../gen/api/v1/models_pb.js";
+import { TaskDependencyType } from "../../gen/api/v1/models_pb.js";
 
 export function formatProject(p: Project): string {
   const lines = [
@@ -162,6 +163,85 @@ export function formatMilestoneTaskList(milestoneTasks: MilestoneTask[]): string
   return header + milestoneTasks.map((mt, i) => `${i + 1}. ${formatMilestoneTask(mt)}`).join("\n\n");
 }
 
+export function formatUser(u: User): string {
+  const lines = [`${u.fullName} (${u.email})`];
+  lines.push(`  ID: ${u.id}`);
+  if (u.flattenedRoles?.length) lines.push(`  Roles: ${u.flattenedRoles.join(", ")}`);
+  return lines.join("\n");
+}
+
+export function formatUserList(users: User[]): string {
+  if (users.length === 0) return "No users found.";
+  const header = `Found ${users.length} user(s):\n`;
+  return header + users.map((u, i) => `${i + 1}. ${formatUser(u)}`).join("\n\n");
+}
+
+export function formatLabel(l: Label): string {
+  const lines = [`${l.name}`];
+  lines.push(`  Color: ${l.color}`);
+  if (l.description) lines.push(`  Description: ${l.description}`);
+  lines.push(`  Active: ${l.isActive ? "Yes" : "No"}`);
+  lines.push(`  Project ID: ${l.projectId}`);
+  lines.push(`  ID: ${l.id}`);
+  return lines.join("\n");
+}
+
+export function formatLabelList(labels: Label[]): string {
+  if (labels.length === 0) return "No labels found.";
+  const header = `Found ${labels.length} label(s):\n`;
+  return header + labels.map((l, i) => `${i + 1}. ${formatLabel(l)}`).join("\n\n");
+}
+
+export function formatTaskLabelList(taskLabels: TaskLabel[]): string {
+  if (taskLabels.length === 0) return "No labels attached to this task.";
+  const header = `Found ${taskLabels.length} label attachment(s):\n`;
+  return header + taskLabels.map((tl, i) => {
+    const labelName = tl.label?.name || `Label #${tl.labelId}`;
+    return `${i + 1}. ${labelName} (Label ID: ${tl.labelId} | TaskLabel ID: ${tl.id})`;
+  }).join("\n");
+}
+
+export function formatComment(c: Comment): string {
+  const lines = [];
+  const author = c.user?.fullName || `User #${c.userId}`;
+  const created = c.createdAt
+    ? new Date((typeof c.createdAt.seconds === "bigint" ? Number(c.createdAt.seconds) : c.createdAt.seconds) * 1000).toISOString()
+    : "—";
+  lines.push(`${author} @ ${created}${c.isInternal ? " [internal]" : ""}`);
+  lines.push(`  ${c.content}`);
+  lines.push(`  ID: ${c.id}`);
+  return lines.join("\n");
+}
+
+export function formatCommentList(comments: Comment[]): string {
+  if (comments.length === 0) return "No comments found.";
+  const header = `Found ${comments.length} comment(s):\n`;
+  return header + comments.map((c, i) => `${i + 1}. ${formatComment(c)}`).join("\n\n");
+}
+
+function taskDependencyTypeToString(t: TaskDependencyType): string {
+  switch (t) {
+    case TaskDependencyType.BLOCKS: return "BLOCKS";
+    case TaskDependencyType.BLOCKED_BY: return "BLOCKED_BY";
+    case TaskDependencyType.DUPLICATES: return "DUPLICATES";
+    case TaskDependencyType.RELATES_TO: return "RELATES_TO";
+    default: return "UNSPECIFIED";
+  }
+}
+
+export function formatTaskDependency(d: TaskDependency): string {
+  const typeStr = taskDependencyTypeToString(d.type);
+  const from = d.fromTask?.identifier || `Task #${d.fromTaskId}`;
+  const to = d.toTask?.identifier || `Task #${d.toTaskId}`;
+  return `${from} ${typeStr} ${to}\n  ID: ${d.id}`;
+}
+
+export function formatTaskDependencyList(deps: TaskDependency[]): string {
+  if (deps.length === 0) return "No task dependencies found.";
+  return `Found ${deps.length} dependency(ies):\n` +
+    deps.map((d, i) => `${i + 1}. ${formatTaskDependency(d)}`).join("\n\n");
+}
+
 export function formatError(error: unknown): string {
   if (error instanceof Error) {
     const msg = error.message;