@mgsoftwarebv/mcp-server-bridge 3.3.6 → 3.3.8

package/README.md

@@ -98,11 +98,11 @@ Use **get-teams** to list the providers you can act on and copy a `teamId`.
 - **get-teams** — list the provider teams (workspaces) you can act on; use a returned id as `teamId` on other tools
 
 ### Tickets, Customers & Projects
-- **get-tickets** — list tickets with filters (status, priority, project, customer, text query)
-- **get-ticket-by-id** — fetch one ticket with comment text, a full attachment listing (ids), and inline images (base64)
-- **create-ticket** — create a new ticket
-- **update-ticket** — update fields (title, description, status, priority, type, project, customer, assignee, estimated hours); `assigneeId: null` unassigns
-- **add-ticket-comment** — add a comment (plain text or TipTap JSON); `isInternal` for internal-only notes
+- **get-tickets** — list tickets with filters (status, priority, project, customer, text query); each result includes the ticket ID (UUID) and ticket number
+- **get-ticket-by-id** — fetch one ticket by UUID or ticket number, with comment text, a full attachment listing (ids), and inline images (base64)
+- **create-ticket** — create a new ticket (returns UUID and ticket number)
+- **update-ticket** — update fields (title, description, status, priority, type, project, customer, assignee, estimated hours); accepts UUID or ticket number; `assigneeId: null` unassigns
+- **add-ticket-comment** — add a comment (plain text or TipTap JSON); accepts UUID or ticket number; `isInternal` for internal-only notes
 - **get-ticket-comments** — read all comments as plain text (author, internal flag, timestamp)
 - **get-ticket-attachment** — get a 1-hour signed download URL for any ticket/comment attachment (any file type)
 - **get-customers** — list/search customers

package/dist/index.js

@@ -92216,13 +92216,13 @@ function construct(client, config3 = {}) {
     };
   }
   const session = new PostgresJsSession(client, dialect, schema, { logger: logger2, cache: config3.cache });
-  const db2 = new PostgresJsDatabase(dialect, session, schema);
-  db2.$client = client;
-  db2.$cache = config3.cache;
-  if (db2.$cache) {
-    db2.$cache["invalidate"] = config3.cache?.onMutate;
+  const db3 = new PostgresJsDatabase(dialect, session, schema);
+  db3.$client = client;
+  db3.$cache = config3.cache;
+  if (db3.$cache) {
+    db3.$cache["invalidate"] = config3.cache?.onMutate;
   }
-  return db2;
+  return db3;
 }
 function drizzle(...params) {
   if (typeof params[0] === "string") {
@@ -103378,12 +103378,12 @@ var createJobDb = () => {
     connect_timeout: 10
     // 10 second connection timeout
   });
-  const db2 = drizzle(jobPool, {
+  const db3 = drizzle(jobPool, {
     schema: schema_exports,
     casing: "snake_case"
   });
   return {
-    db: db2,
+    db: db3,
     disconnect: () => jobPool.end()
   };
 };
@@ -105508,6 +105508,10 @@ var teamIdProp = {
   type: "string",
   description: "Provider team ID. Optional when you belong to a single provider; required when you belong to several. Call get-teams to list the providers you can act on."
 };
+var ticketIdentifierProp = {
+  type: "string",
+  description: "Ticket ID (UUID) or ticket number (e.g. 2026-REFRO-116). Pass teamId when using a ticket number across multiple providers."
+};
 var TOOLS = [
   {
     name: "get-teams",
@@ -105520,7 +105524,7 @@ var TOOLS = [
   },
   {
     name: "get-tickets",
-    description: "Get tickets with optional filtering by status, priority, project, customer, tags, or search query. Each ticket includes its tags.",
+    description: "Get tickets with optional filtering by status, priority, project, customer, tags, or search query. Each ticket includes its ID (UUID), ticket number, and tags.",
     inputSchema: {
       type: "object",
       properties: {
@@ -105567,12 +105571,12 @@ var TOOLS = [
   },
   {
     name: "get-ticket-by-id",
-    description: "Get a specific ticket by its ID, including tags, comment text and a full attachment listing (with ids). Images from ticket and comment attachments are downloaded and returned inline as base64. For non-image attachments, call get-ticket-attachment with the listed id to get a download URL.",
+    description: "Get a specific ticket by its ID or ticket number, including tags, comment text and a full attachment listing (with ids). Images from ticket and comment attachments are downloaded and returned inline as base64. For non-image attachments, call get-ticket-attachment with the listed id to get a download URL.",
     inputSchema: {
       type: "object",
       properties: {
         teamId: teamIdProp,
-        id: { type: "string", description: "Ticket ID" }
+        id: ticketIdentifierProp
       },
       required: ["id"]
     }
@@ -105642,7 +105646,7 @@ var TOOLS = [
       type: "object",
       properties: {
         teamId: teamIdProp,
-        id: { type: "string", description: "Ticket ID" },
+        id: ticketIdentifierProp,
         title: { type: "string" },
         description: {
           type: "string",
@@ -105844,7 +105848,7 @@ var TOOLS = [
       type: "object",
       properties: {
         teamId: teamIdProp,
-        ticketId: { type: "string", description: "Ticket ID" },
+        ticketId: ticketIdentifierProp,
         content: { type: "string", description: "Comment body" },
         isInternal: { type: "boolean", default: false }
       },
@@ -105858,7 +105862,7 @@ var TOOLS = [
       type: "object",
       properties: {
         teamId: teamIdProp,
-        ticketId: { type: "string", description: "Ticket ID" }
+        ticketId: ticketIdentifierProp
       },
       required: ["ticketId"]
     }
@@ -105886,8 +105890,8 @@ var TOOLS = [
       properties: {
         teamId: teamIdProp,
         ticketId: {
-          type: "string",
-          description: "Ticket ID (UUID) to attach the file to."
+          ...ticketIdentifierProp,
+          description: "Ticket ID (UUID) or ticket number to attach the file to."
         },
         filePath: {
           type: "string",
@@ -106688,17 +106692,87 @@ async function resolveTeamScope(requestedTeamId) {
 }
 
 // src/tools/ticket-access.ts
-function notFoundResponse(ticketId) {
+var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isUuid(value) {
+  return UUID_REGEX.test(value);
+}
+function notFoundResponse(identifier) {
+  return {
+    content: [
+      {
+        type: "text",
+        text: `Ticket not found or no access: ${identifier}. Call get-tickets to find the correct ticket.`
+      }
+    ]
+  };
+}
+function multipleMatchesResponse(identifier, matches) {
+  const list = matches.map((t8) => `- **${t8.ticketNumber}** (ID: ${t8.id}): ${t8.title}`).join("\n");
   return {
     content: [
       {
         type: "text",
-        text: `Ticket not found or no access: ${ticketId}. Call get-tickets to find the correct ticket.`
+        text: `Multiple tickets match "${identifier}":
+${list}
+
+Pass a more specific ticket number or include \`teamId\` to disambiguate.`
       }
     ]
   };
 }
+var ticketLookupFields = {
+  id: schema_exports.tickets.id,
+  ticketNumber: schema_exports.tickets.ticketNumber,
+  title: schema_exports.tickets.title
+};
+async function resolveTicketIdentifier(requestedTeamId, identifier) {
+  if (isUuid(identifier)) {
+    return { ok: true, id: identifier };
+  }
+  const scope = await resolveTeamScope(requestedTeamId);
+  if (!scope.ok) return scope;
+  const accessPredicate = buildTicketAccessPredicate(
+    scope.teamIds,
+    scope.projectIds,
+    scope.customerIds
+  );
+  const baseFilters = [
+    accessPredicate,
+    eq(schema_exports.tickets.isDeleted, false)
+  ];
+  const exactMatches = await db.select(ticketLookupFields).from(schema_exports.tickets).where(
+    and(
+      ...baseFilters,
+      sql`lower(${schema_exports.tickets.ticketNumber}) = lower(${identifier})`
+    )
+  ).limit(5);
+  let matches = exactMatches;
+  if (matches.length === 0) {
+    matches = await db.select(ticketLookupFields).from(schema_exports.tickets).where(
+      and(...baseFilters, ilike(schema_exports.tickets.ticketNumber, `%${identifier}%`))
+    ).limit(5);
+  }
+  if (matches.length === 0) {
+    return {
+      ok: false,
+      response: {
+        content: [
+          {
+            type: "text",
+            text: `No ticket found with number "${identifier}". Call get-tickets to search by title or keyword.`
+          }
+        ]
+      }
+    };
+  }
+  if (matches.length > 1) {
+    return { ok: false, response: multipleMatchesResponse(identifier, matches) };
+  }
+  return { ok: true, id: matches[0].id };
+}
 async function loadAccessibleTicket(requestedTeamId, ticketId) {
+  const resolved = await resolveTicketIdentifier(requestedTeamId, ticketId);
+  if (!resolved.ok) return resolved;
   const scope = await resolveTeamScope(requestedTeamId);
   if (!scope.ok) return scope;
   const [ticket] = await db.select({
@@ -106712,7 +106786,7 @@ async function loadAccessibleTicket(requestedTeamId, ticketId) {
     priority: schema_exports.tickets.priority,
     type: schema_exports.tickets.type,
     assigneeId: schema_exports.tickets.assigneeId
-  }).from(schema_exports.tickets).where(eq(schema_exports.tickets.id, ticketId)).limit(1);
+  }).from(schema_exports.tickets).where(eq(schema_exports.tickets.id, resolved.id)).limit(1);
   if (!ticket) return { ok: false, response: notFoundResponse(ticketId) };
   const hasAccess = scope.teamIds.includes(ticket.teamId) || !!ticket.projectId && scope.projectIds.includes(ticket.projectId) || !!ticket.customerId && scope.customerIds.includes(ticket.customerId);
   if (!hasAccess) return { ok: false, response: notFoundResponse(ticketId) };
@@ -120144,6 +120218,118 @@ ${created.projectId ? `Project ID: ${created.projectId}
   };
 }
 
+// src/utils/ticket-number.ts
+async function isTicketNumberTaken(ticketDb, teamId, ticketNumber, excludeTicketId) {
+  const conditions = [
+    eq(schema_exports.tickets.teamId, teamId),
+    eq(schema_exports.tickets.ticketNumber, ticketNumber),
+    eq(schema_exports.tickets.isDeleted, false)
+  ];
+  if (excludeTicketId) {
+    conditions.push(ne(schema_exports.tickets.id, excludeTicketId));
+  }
+  const [existing] = await ticketDb.select({ id: schema_exports.tickets.id }).from(schema_exports.tickets).where(and(...conditions)).limit(1);
+  return Boolean(existing);
+}
+async function getMaxProjectSequence(ticketDb, teamId, pattern, excludeTicketId) {
+  const conditions = [
+    eq(schema_exports.tickets.teamId, teamId),
+    like(schema_exports.tickets.ticketNumber, pattern),
+    eq(schema_exports.tickets.isDeleted, false)
+  ];
+  if (excludeTicketId) {
+    conditions.push(ne(schema_exports.tickets.id, excludeTicketId));
+  }
+  const [row] = await ticketDb.select({
+    maxSeq: sql`coalesce(max(
+        case
+          when split_part(${schema_exports.tickets.ticketNumber}, '-', 3) ~ '^[0-9]+$'
+          then split_part(${schema_exports.tickets.ticketNumber}, '-', 3)::integer
+          else null
+        end
+      ), 0)`
+  }).from(schema_exports.tickets).where(and(...conditions));
+  return Number(row?.maxSeq ?? 0);
+}
+async function getMaxSimpleSequence(ticketDb, teamId, currentYear, excludeTicketId) {
+  const conditions = [
+    eq(schema_exports.tickets.teamId, teamId),
+    like(schema_exports.tickets.ticketNumber, `${currentYear}-%`),
+    eq(schema_exports.tickets.isDeleted, false)
+  ];
+  if (excludeTicketId) {
+    conditions.push(ne(schema_exports.tickets.id, excludeTicketId));
+  }
+  const [row] = await ticketDb.select({
+    maxSeq: sql`coalesce(max(
+        case
+          when ${schema_exports.tickets.ticketNumber} ~ ${`^${currentYear}-[0-9]+$`}
+          then split_part(${schema_exports.tickets.ticketNumber}, '-', 2)::integer
+          else null
+        end
+      ), 0)`
+  }).from(schema_exports.tickets).where(and(...conditions));
+  return Number(row?.maxSeq ?? 0);
+}
+async function resolveUniqueTicketNumber(ticketDb, teamId, buildNumber, startSequence, excludeTicketId) {
+  let sequence = startSequence;
+  for (let attempt = 0; attempt < 100; attempt += 1) {
+    const ticketNumber = buildNumber(sequence);
+    const taken = await isTicketNumberTaken(
+      ticketDb,
+      teamId,
+      ticketNumber,
+      excludeTicketId
+    );
+    if (!taken) {
+      return ticketNumber;
+    }
+    sequence += 1;
+  }
+  throw new Error("Failed to generate a unique ticket number");
+}
+async function generateTicketNumber(ticketDb, teamId, projectId, options) {
+  const currentYear = (/* @__PURE__ */ new Date()).getFullYear();
+  const excludeTicketId = options?.excludeTicketId ?? null;
+  if (projectId) {
+    const [project] = await ticketDb.select({ name: schema_exports.projects.name }).from(schema_exports.projects).where(eq(schema_exports.projects.id, projectId)).limit(1);
+    if (project?.name) {
+      const projectAbbreviation = generateProjectAbbreviation(project.name);
+      const pattern = `${currentYear}-${projectAbbreviation}-%`;
+      const maxSequence2 = await getMaxProjectSequence(
+        ticketDb,
+        teamId,
+        pattern,
+        excludeTicketId
+      );
+      let nextSequence = maxSequence2 + 1;
+      if (projectAbbreviation === "MBC" && nextSequence < 100001) {
+        nextSequence = 100001;
+      }
+      return resolveUniqueTicketNumber(
+        ticketDb,
+        teamId,
+        (sequence) => `${currentYear}-${projectAbbreviation}-${String(sequence).padStart(3, "0")}`,
+        nextSequence,
+        excludeTicketId
+      );
+    }
+  }
+  const maxSequence = await getMaxSimpleSequence(
+    ticketDb,
+    teamId,
+    currentYear,
+    excludeTicketId
+  );
+  return resolveUniqueTicketNumber(
+    ticketDb,
+    teamId,
+    (sequence) => `${currentYear}-${String(sequence).padStart(3, "0")}`,
+    maxSequence + 1,
+    excludeTicketId
+  );
+}
+
 // src/tools/ticket-update.ts
 async function handleUpdateTicket(input) {
   const ctx = getAuthContext();
@@ -120179,6 +120365,7 @@ async function handleUpdateTicket(input) {
     updateValues.priority = input.priority;
   }
   if (input.type !== void 0) updateValues.type = input.type;
+  const projectExplicitlyChanged = input.projectId !== void 0 && input.projectId !== ticket.projectId;
   if (input.projectId !== void 0) updateValues.projectId = input.projectId;
   if (input.customerId !== void 0) {
     updateValues.customerId = input.customerId;
@@ -120193,6 +120380,14 @@ async function handleUpdateTicket(input) {
     updateValues.dueDate = input.dueDate;
     updateValues.dueDateAllDay = input.dueDate ? true : false;
   }
+  if (projectExplicitlyChanged) {
+    updateValues.ticketNumber = await generateTicketNumber(
+      db,
+      ticket.teamId,
+      input.projectId,
+      { excludeTicketId: ticket.id }
+    );
+  }
   let deadlineChange = null;
   if (input.dueDate !== void 0) {
     deadlineChange = await syncTicketDeadline(
@@ -120262,7 +120457,11 @@ async function handleUpdateTicket(input) {
     changes.push("title updated");
   }
   if (input.description !== void 0) changes.push("description updated");
-  if (input.projectId !== void 0) changes.push("project updated");
+  if (input.projectId !== void 0) {
+    changes.push(
+      projectExplicitlyChanged ? `project updated (renumbered to ${String(updateValues.ticketNumber ?? ticket.ticketNumber)})` : "project updated"
+    );
+  }
   if (input.customerId !== void 0) changes.push("customer updated");
   if (input.estimatedHours !== void 0) changes.push("estimated hours updated");
   if (deadlineChange) changes.push(deadlineChange);
@@ -120466,6 +120665,7 @@ async function handleGetTickets(input) {
 ${rows.map((t8) => {
           const ticketTags2 = tagsByTicket.get(t8.id) ?? [];
           return `**${t8.ticketNumber}**: ${t8.title}
+ID: ${t8.id}
 Status: ${t8.status} | Priority: ${t8.priority}
 ${ticketTags2.length > 0 ? `Tags: ${formatTagList(ticketTags2)}
 ` : ""}${t8.projectName ? `Project: ${t8.projectName}
@@ -120479,11 +120679,13 @@ ${ticketTags2.length > 0 ? `Tags: ${formatTagList(ticketTags2)}
 }
 async function handleGetTicketById(input) {
   const { id } = input;
+  const resolved = await resolveTicketIdentifier(input.teamId, id);
+  if (!resolved.ok) return resolved.response;
   const scope = await resolveTeamScope(input.teamId);
   if (!scope.ok) return scope.response;
   const { teamIds, projectIds, customerIds } = scope;
   const ticketRow = await db.query.tickets.findFirst({
-    where: eq(schema_exports.tickets.id, id),
+    where: eq(schema_exports.tickets.id, resolved.id),
     with: {
       project: { columns: { id: true, name: true } },
       customer: { columns: { id: true, name: true } },
@@ -120691,13 +120893,10 @@ async function handleCreateTicket(input) {
   } = input;
   const resolved = await resolveTeamId(input.teamId);
   if (!resolved.ok) return resolved.response;
-  const year2 = (/* @__PURE__ */ new Date()).getFullYear();
   let resolvedTeamId = resolved.teamId;
   let resolvedCustomerId = customerId;
-  let projectAbbreviation = "";
   if (projectId) {
     const [project] = await db.select({
-      name: schema_exports.projects.name,
       teamId: schema_exports.projects.teamId,
       customerId: schema_exports.projects.customerId
     }).from(schema_exports.projects).where(eq(schema_exports.projects.id, projectId)).limit(1);
@@ -120710,40 +120909,9 @@ async function handleCreateTicket(input) {
       if (!resolvedCustomerId && project.customerId) {
         resolvedCustomerId = project.customerId;
       }
-      if (project.name) {
-        const upper = project.name.toUpperCase().replace(/[^A-Z0-9\s]/g, "");
-        const words = upper.split(/\s+/).filter(Boolean);
-        if (words.length >= 2) {
-          projectAbbreviation = words.slice(0, 2).map((w2) => w2.substring(0, 3)).join("").substring(0, 5);
-        } else if (words.length === 1 && words[0]) {
-          projectAbbreviation = words[0].substring(0, 5);
-        }
-      }
     }
   }
-  let ticketNumber;
-  if (projectId && projectAbbreviation) {
-    const pattern = `${year2}-${projectAbbreviation}-%`;
-    const [highest] = await db.select({ ticketNumber: schema_exports.tickets.ticketNumber }).from(schema_exports.tickets).where(
-      and(
-        eq(schema_exports.tickets.projectId, projectId),
-        ilike(schema_exports.tickets.ticketNumber, pattern)
-      )
-    ).orderBy(desc(schema_exports.tickets.ticketNumber)).limit(1);
-    let nextSequence = 1;
-    if (highest?.ticketNumber) {
-      const parts = highest.ticketNumber.split("-");
-      if (parts.length === 3 && parts[2]) {
-        const lastSeq = Number.parseInt(parts[2], 10);
-        if (!Number.isNaN(lastSeq)) nextSequence = lastSeq + 1;
-      }
-    }
-    ticketNumber = `${year2}-${projectAbbreviation}-${String(nextSequence).padStart(3, "0")}`;
-  } else {
-    const [countRow] = await db.select({ n: sql`count(*)::int` }).from(schema_exports.tickets).where(eq(schema_exports.tickets.teamId, resolvedTeamId));
-    const count = Number(countRow?.n ?? 0);
-    ticketNumber = `${year2}-${String(count + 1).padStart(3, "0")}`;
-  }
+  const ticketNumber = await generateTicketNumber(db, resolvedTeamId, projectId);
   const [created] = await db.insert(schema_exports.tickets).values({
     teamId: resolvedTeamId,
     ticketNumber,
@@ -120791,7 +120959,7 @@ async function handleCreateTicket(input) {
         text: `\u2705 **Ticket Created Successfully!**
 
 Ticket Number: **${created.ticketNumber}**
-ID: ${created.id}
+Ticket id: ${created.id}
 Title: ${title}
 Status: ${status}
 Priority: ${priority}