@mgsoftwarebv/mcp-server-bridge 3.5.21 → 3.5.23

package/dist/index.js

@@ -105607,8 +105607,86 @@ var Server = class extends Protocol {
 };
 
 // src/telemetry.ts
+var UUID_RE = /^[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_RE.test(value);
+}
 var MCP_TELEMETRY_CATEGORY = "mcp_tool_call";
 var MCP_TELEMETRY_SOURCE = "mcp";
+function assignTicketRef(refs, value) {
+  const trimmed = value.trim();
+  if (!trimmed) return;
+  if (isUuid(trimmed)) {
+    refs.ticketId = trimmed;
+    return;
+  }
+  refs.ticketNumber = trimmed;
+}
+function collectTicketRefsFromEntity(entity) {
+  const refs = [];
+  if (entity.ticketId) refs.push(entity.ticketId);
+  if (entity.ticketNumber) refs.push(entity.ticketNumber);
+  return refs;
+}
+async function resolveTicketRefMap(params) {
+  const uuidRefs = /* @__PURE__ */ new Set();
+  const numberRefs = /* @__PURE__ */ new Set();
+  const allRefs = /* @__PURE__ */ new Set();
+  for (const ref of params.refs) {
+    const trimmed = ref.trim();
+    if (!trimmed) continue;
+    allRefs.add(trimmed);
+    if (isUuid(trimmed)) uuidRefs.add(trimmed);
+    else numberRefs.add(trimmed);
+  }
+  if (allRefs.size === 0) {
+    return { byRef: /* @__PURE__ */ new Map(), unresolved: [] };
+  }
+  const lookup = [];
+  if (uuidRefs.size > 0) {
+    lookup.push(inArray(schema_exports.tickets.id, [...uuidRefs]));
+  }
+  for (const num of numberRefs) {
+    lookup.push(sql`lower(${schema_exports.tickets.ticketNumber}) = lower(${num})`);
+  }
+  const ticketRows = await db.select({
+    id: schema_exports.tickets.id,
+    ticketNumber: schema_exports.tickets.ticketNumber,
+    title: schema_exports.tickets.title,
+    projectId: schema_exports.tickets.projectId
+  }).from(schema_exports.tickets).where(
+    and(
+      inArray(schema_exports.tickets.teamId, params.teamIds),
+      eq(schema_exports.tickets.isDeleted, false),
+      or(...lookup)
+    )
+  );
+  const byRef = /* @__PURE__ */ new Map();
+  for (const t9 of ticketRows) {
+    const info = {
+      id: t9.id,
+      ticketNumber: t9.ticketNumber,
+      title: t9.title,
+      projectId: t9.projectId
+    };
+    byRef.set(t9.id, info);
+    if (t9.ticketNumber) {
+      byRef.set(t9.ticketNumber, info);
+      byRef.set(t9.ticketNumber.toLowerCase(), info);
+    }
+  }
+  const unresolved = [...allRefs].filter(
+    (ref) => !byRef.has(ref) && !byRef.has(ref.toLowerCase())
+  );
+  return { byRef, unresolved };
+}
+function lookupResolvedTicket(byRef, entity) {
+  for (const ref of collectTicketRefsFromEntity(entity)) {
+    const hit = byRef.get(ref) ?? byRef.get(ref.toLowerCase());
+    if (hit) return hit;
+  }
+  return void 0;
+}
 var ENTITY_ID_FIELDS = [
   "ticketId",
   "projectId",
@@ -105647,15 +105725,20 @@ function extractSafeEntityRefs(toolName, args2) {
   if (!args2 || typeof args2 !== "object") return refs;
   for (const field of ENTITY_ID_FIELDS) {
     const value = args2[field];
-    if (typeof value === "string" && value.trim()) {
-      refs[field] = value.trim();
+    if (typeof value !== "string" || !value.trim()) continue;
+    const trimmed = value.trim();
+    if (field === "ticketId") {
+      assignTicketRef(refs, trimmed);
+      continue;
     }
+    refs[field] = trimmed;
   }
   const rawId = typeof args2.id === "string" ? args2.id.trim() : "";
   if (rawId) {
     const n3 = toolName.toLowerCase();
-    if (!refs.ticketId && n3.includes("ticket")) refs.ticketId = rawId;
-    else if (!refs.projectId && n3.includes("project")) refs.projectId = rawId;
+    if (!refs.ticketId && !refs.ticketNumber && n3.includes("ticket")) {
+      assignTicketRef(refs, rawId);
+    } else if (!refs.projectId && n3.includes("project")) refs.projectId = rawId;
     else if (!refs.customerId && n3.includes("customer")) refs.customerId = rawId;
     else if (!refs.invoiceId && n3.includes("invoice")) refs.invoiceId = rawId;
     else if (!refs.documentId && n3.includes("document")) refs.documentId = rawId;
@@ -105744,6 +105827,7 @@ async function queryMcpActivityRows(params) {
       durationMs: row.durationMs ?? null,
       entity: {
         ticketId: readString(meta5, "ticketId"),
+        ticketNumber: readString(meta5, "ticketNumber"),
         projectId: readString(meta5, "projectId"),
         customerId: readString(meta5, "customerId"),
         invoiceId: readString(meta5, "invoiceId"),
@@ -106059,6 +106143,20 @@ var TOOLS = [
           items: { type: "string" },
           description: "Filter by tag IDs"
         },
+        projectTag: {
+          type: "string",
+          description: "Filter by project label name \u2014 ticket's project must carry this label"
+        },
+        projectTags: {
+          type: "array",
+          items: { type: "string" },
+          description: "Filter by project label names (OR)"
+        },
+        projectTagIds: {
+          type: "array",
+          items: { type: "string" },
+          description: "Filter by project label tag IDs (OR)"
+        },
         pageSize: { type: "number", default: 20, maximum: 100 }
       },
       required: []
@@ -106072,6 +106170,20 @@ var TOOLS = [
       properties: {
         teamId: teamIdProp,
         projectId: { type: "string", description: "Filter to one project UUID." },
+        projectTag: {
+          type: "string",
+          description: "Filter by project label name on the ticket's project"
+        },
+        projectTags: {
+          type: "array",
+          items: { type: "string" },
+          description: "Filter by project label names (OR)"
+        },
+        projectTagIds: {
+          type: "array",
+          items: { type: "string" },
+          description: "Filter by project label tag IDs (OR)"
+        },
         priority: {
           type: "string",
           enum: ["low", "medium", "high", "critical"]
@@ -106110,6 +106222,9 @@ var TOOLS = [
           description: "When assigneeId='all', group the items per assignee."
         },
         projectId: { type: "string" },
+        projectTag: { type: "string" },
+        projectTags: { type: "array", items: { type: "string" } },
+        projectTagIds: { type: "array", items: { type: "string" } },
         priority: {
           type: "string",
           enum: ["low", "medium", "high", "critical"]
@@ -106148,7 +106263,10 @@ var TOOLS = [
           type: "boolean",
           default: true,
           description: "Include the unassigned bucket in the overview."
-        }
+        },
+        projectTag: { type: "string" },
+        projectTags: { type: "array", items: { type: "string" } },
+        projectTagIds: { type: "array", items: { type: "string" } }
       },
       required: []
     }
@@ -106783,13 +106901,27 @@ var TOOLS = [
   },
   {
     name: "get-projects",
-    description: "Get projects with optional filtering. Each project includes its ID and, when archived, its archive timestamp/reason. Archived projects are hidden by default; pass status 'archived' or 'all' to include them.",
+    description: "Get projects with optional filtering. Each project includes its ID, project labels (tags on the project itself \u2014 not ticket tags), and when archived, its archive timestamp/reason. Archived projects are hidden by default; pass status 'archived' or 'all' to include them.",
     inputSchema: {
       type: "object",
       properties: {
         teamId: teamIdProp,
         customerId: { type: "string", description: "Filter by customer ID" },
         q: { type: "string", description: "Search query for project name" },
+        projectTag: {
+          type: "string",
+          description: "Filter by a single project label name (case-insensitive)"
+        },
+        projectTags: {
+          type: "array",
+          items: { type: "string" },
+          description: "Filter by project label names (OR)"
+        },
+        projectTagIds: {
+          type: "array",
+          items: { type: "string" },
+          description: "Filter by project label tag IDs (OR)"
+        },
         status: {
           type: "string",
           enum: ["active", "archived", "all"],
@@ -106803,7 +106935,7 @@ var TOOLS = [
   },
   {
     name: "create-project",
-    description: "Create a new project",
+    description: "Create a new project. Optionally assign project labels (general team tags for grouping/filtering \u2014 distinct from ticket tags).",
     inputSchema: {
       type: "object",
       properties: {
@@ -106811,6 +106943,16 @@ var TOOLS = [
         name: { type: "string", description: "Project name" },
         description: { type: "string" },
         customerId: { type: "string" },
+        projectTags: {
+          type: "array",
+          items: { type: "string" },
+          description: "Project label names to assign (created if missing)"
+        },
+        projectTagIds: {
+          type: "array",
+          items: { type: "string" },
+          description: "Project label tag IDs to assign"
+        },
         status: {
           type: "string",
           enum: ["active", "on_hold", "completed", "cancelled"],
@@ -106822,7 +106964,7 @@ var TOOLS = [
   },
   {
     name: "update-project",
-    description: "Update an existing project's fields (name, description, customer, rate, currency, billable, estimate, internal). Only provided fields change. Renaming a project renumbers its tickets. To retire a mistakenly-created project use archive-project (reversible) or delete-project (empty projects only). Find the project id via get-projects.",
+    description: "Update an existing project's fields (name, description, customer, rate, currency, billable, estimate, internal, project labels). Only provided fields change. When projectTags/projectTagIds are provided, labels are replaced entirely. Renaming a project renumbers its tickets. To retire a mistakenly-created project use archive-project (reversible) or delete-project (empty projects only). Find the project id via get-projects.",
     inputSchema: {
       type: "object",
       properties: {
@@ -106844,11 +106986,83 @@ var TOOLS = [
         internal: {
           type: "boolean",
           description: "Whether this is an internal (no-customer) project"
+        },
+        projectTags: {
+          type: "array",
+          items: { type: "string" },
+          description: "Replace project labels with these names (creates missing)"
+        },
+        projectTagIds: {
+          type: "array",
+          items: { type: "string" },
+          description: "Replace project labels with these tag IDs"
         }
       },
       required: ["id"]
     }
   },
+  {
+    name: "get-project-tags",
+    description: "List project labels assigned to a project (metadata for grouping/filtering \u2014 not ticket tags).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: teamIdProp,
+        projectId: { type: "string", description: "Project ID" }
+      },
+      required: ["projectId"]
+    }
+  },
+  {
+    name: "set-project-tags",
+    description: "Replace all project labels on a project. Pass projectTags (names) and/or projectTagIds. Missing names are created as general team tags.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: teamIdProp,
+        projectId: { type: "string", description: "Project ID" },
+        projectTags: {
+          type: "array",
+          items: { type: "string" },
+          description: "Project label names"
+        },
+        projectTagIds: {
+          type: "array",
+          items: { type: "string" },
+          description: "Project label tag IDs"
+        }
+      },
+      required: ["projectId"]
+    }
+  },
+  {
+    name: "add-project-tag",
+    description: "Add one project label to a project (merge, does not remove existing labels).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: teamIdProp,
+        projectId: { type: "string", description: "Project ID" },
+        projectTag: { type: "string", description: "Project label name" },
+        projectTagId: { type: "string", description: "Project label tag ID" }
+      },
+      required: ["projectId"]
+    }
+  },
+  {
+    name: "remove-project-tag",
+    description: "Remove one project label from a project.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: teamIdProp,
+        projectId: { type: "string", description: "Project ID" },
+        projectTag: { type: "string", description: "Project label name" },
+        projectTagId: { type: "string", description: "Project label tag ID" }
+      },
+      required: ["projectId"]
+    }
+  },
   {
     name: "archive-project",
     description: "Safely archive (soft-retire) a project \u2014 the recommended way to clean up a mistakenly-created project. Reversible and non-destructive: it keeps all tickets, hours, trips, documents and other data, and only hides the project from get-projects by default. Use this instead of delete-project whenever a project has any history. Find the project id via get-projects. Note: the archive flag is stored in projects.settings.archivedAt; the dashboard UI does not yet read it, so the project still appears there.",
@@ -108559,7 +108773,7 @@ async function resolveTeamScope(requestedTeamId) {
 
 // src/tools/ticket-access.ts
 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) {
+function isUuid2(value) {
   return UUID_REGEX.test(value);
 }
 function notFoundResponse(identifier) {
@@ -108592,7 +108806,7 @@ var ticketLookupFields = {
   title: schema_exports.tickets.title
 };
 async function resolveTicketIdentifier(requestedTeamId, identifier) {
-  if (isUuid(identifier)) {
+  if (isUuid2(identifier)) {
     return { ok: true, id: identifier };
   }
   const scope = await resolveTeamScope(requestedTeamId);
@@ -121962,7 +122176,7 @@ var INVOICE_STATUSES = [
   "scheduled",
   "refunded"
 ];
-var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var UUID_RE2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function textResponse4(text3) {
   return { content: [{ type: "text", text: text3 }] };
 }
@@ -122023,7 +122237,7 @@ function parseStoredLineItems(value) {
 }
 async function loadInvoiceByIdentifier(identifier, teamIds) {
   if (teamIds.length === 0) return null;
-  const byId = UUID_RE.test(identifier);
+  const byId = UUID_RE2.test(identifier);
   const filters = [inArray(schema_exports.invoices.teamId, teamIds)];
   filters.push(
     byId ? eq(schema_exports.invoices.id, identifier) : eq(schema_exports.invoices.invoiceNumber, identifier)
@@ -122802,88 +123016,493 @@ ${JSON.stringify(payload, null, 2)}
   );
 }
 
-// src/tools/project-cleanup-util.ts
-var PROJECT_STATUS_FILTERS = [
-  "active",
-  "archived",
-  "all"
-];
-var DEPENDENCY_LABELS2 = {
-  tickets: "ticket(s)",
-  timesheetEvents: "agenda/time entr(ies)",
-  timesheetTemplates: "timesheet template(s)",
-  trips: "trip(s)",
-  tripTemplates: "trip template(s)"
-};
-function getProjectArchiveState(settings) {
-  const obj = settings && typeof settings === "object" && !Array.isArray(settings) ? settings : {};
-  const archivedAt = typeof obj.archivedAt === "string" && obj.archivedAt.trim().length > 0 ? obj.archivedAt : null;
-  const archiveReason = typeof obj.archiveReason === "string" && obj.archiveReason.trim().length > 0 ? obj.archiveReason : null;
-  return { archived: archivedAt !== null, archivedAt, archiveReason };
-}
-function withArchiveSettings(settings, archivedAt, reason) {
-  const base = settings && typeof settings === "object" && !Array.isArray(settings) ? { ...settings } : {};
-  base.archivedAt = archivedAt;
-  if (reason && reason.trim().length > 0) {
-    base.archiveReason = reason.trim();
-  }
-  return base;
-}
-function totalProjectDependencies(counts) {
-  return counts.tickets + counts.timesheetEvents + counts.timesheetTemplates + counts.trips + counts.tripTemplates;
+// src/tools/ticket-tags.ts
+function normalizeTagName(name21) {
+  return name21.toLowerCase().trim();
 }
-function isProjectEmpty(counts) {
-  return totalProjectDependencies(counts) === 0;
+function formatTagList(tags2) {
+  if (tags2.length === 0) return "";
+  return tags2.map((t9) => t9.name).join(", ");
 }
-function formatProjectDependencies(counts) {
-  const parts = Object.keys(DEPENDENCY_LABELS2).filter((key) => counts[key] > 0).map((key) => `${counts[key]} ${DEPENDENCY_LABELS2[key]}`);
-  return parts.length > 0 ? parts.join(", ") : "no dependencies";
+async function getTagsForTickets(ticketIds) {
+  const result = /* @__PURE__ */ new Map();
+  if (ticketIds.length === 0) return result;
+  const rows = await db.select({
+    ticketId: schema_exports.ticketTags.ticketId,
+    id: schema_exports.tags.id,
+    name: schema_exports.tags.name
+  }).from(schema_exports.ticketTags).innerJoin(schema_exports.tags, eq(schema_exports.tags.id, schema_exports.ticketTags.tagId)).where(inArray(schema_exports.ticketTags.ticketId, ticketIds)).orderBy(schema_exports.tags.name);
+  for (const row of rows) {
+    const existing = result.get(row.ticketId) ?? [];
+    existing.push({ id: row.id, name: row.name });
+    result.set(row.ticketId, existing);
+  }
+  return result;
 }
-
-// src/tools/projects.ts
-async function handleGetProjects(input) {
-  const ctx = getAuthContext();
-  const { customerId, q: q3, pageSize = 20 } = input;
-  const status = input.status ?? "active";
-  if (!PROJECT_STATUS_FILTERS.includes(status)) {
-    return {
-      content: [
-        {
-          type: "text",
-          text: `Error: invalid status "${status}". Allowed: ${PROJECT_STATUS_FILTERS.join(", ")}.`
-        }
-      ]
-    };
+async function resolveTagFilterIds(teamId, input) {
+  const ids = new Set(input.tagIds ?? []);
+  const names = [
+    ...input.tag ? [input.tag] : [],
+    ...input.tags ?? []
+  ].map(normalizeTagName).filter(Boolean);
+  if (names.length > 0) {
+    const nameConditions = names.map(
+      (name21) => sql`lower(${schema_exports.tags.name}) = ${name21}`
+    );
+    const rows = await db.select({ id: schema_exports.tags.id }).from(schema_exports.tags).where(and(eq(schema_exports.tags.teamId, teamId), or(...nameConditions)));
+    for (const row of rows) ids.add(row.id);
   }
-  const resolved = await resolveTeamId(input.teamId);
-  if (!resolved.ok) return resolved.response;
-  const projectIds = await getAccessibleProjectIds(ctx.userId, resolved.teamId);
-  if (projectIds.length === 0) {
-    return {
-      content: [
-        {
-          type: "text",
-          text: "No projects found or no access to any projects."
-        }
-      ]
-    };
+  return [...ids];
+}
+async function resolveTags(teamId, input) {
+  const tags2 = [];
+  const errors = [];
+  const seenIds = /* @__PURE__ */ new Set();
+  if (input.tagIds?.length) {
+    const rows = await db.select({ id: schema_exports.tags.id, name: schema_exports.tags.name }).from(schema_exports.tags).where(
+      and(
+        eq(schema_exports.tags.teamId, teamId),
+        inArray(schema_exports.tags.id, input.tagIds)
+      )
+    );
+    for (const row of rows) {
+      if (seenIds.has(row.id)) continue;
+      seenIds.add(row.id);
+      tags2.push(row);
+    }
+    for (const id of input.tagIds) {
+      if (!seenIds.has(id)) errors.push(`Unknown tag ID: ${id}`);
+    }
   }
-  const filters = [inArray(schema_exports.projects.id, projectIds)];
-  if (customerId) filters.push(eq(schema_exports.projects.customerId, customerId));
-  if (q3) filters.push(ilike(schema_exports.projects.name, `%${q3}%`));
-  if (status === "active") {
-    filters.push(sql`${schema_exports.projects.settings} ->> 'archivedAt' IS NULL`);
-  } else if (status === "archived") {
-    filters.push(sql`${schema_exports.projects.settings} ->> 'archivedAt' IS NOT NULL`);
+  const rawNames = input.tagNames ?? [];
+  if (rawNames.length === 0) return { tags: tags2, errors };
+  const normalizedNames = [
+    ...new Set(rawNames.map(normalizeTagName).filter(Boolean))
+  ];
+  if (normalizedNames.length === 0) return { tags: tags2, errors };
+  const nameConditions = normalizedNames.map(
+    (name21) => sql`lower(${schema_exports.tags.name}) = ${name21}`
+  );
+  const existing = await db.select({ id: schema_exports.tags.id, name: schema_exports.tags.name }).from(schema_exports.tags).where(and(eq(schema_exports.tags.teamId, teamId), or(...nameConditions)));
+  const existingByNorm = /* @__PURE__ */ new Map();
+  for (const tag2 of existing) {
+    existingByNorm.set(normalizeTagName(tag2.name), tag2);
   }
-  const rows = await db.select({
-    id: schema_exports.projects.id,
+  for (const rawName of rawNames) {
+    const norm = normalizeTagName(rawName);
+    if (!norm) continue;
+    const found = existingByNorm.get(norm);
+    if (found) {
+      if (!seenIds.has(found.id)) {
+        seenIds.add(found.id);
+        tags2.push(found);
+      }
+      continue;
+    }
+    if (!input.createMissing) {
+      errors.push(`Tag not found: ${rawName}`);
+      continue;
+    }
+    try {
+      const [created] = await db.insert(schema_exports.tags).values({
+        teamId,
+        name: norm,
+        projectId: input.projectId ?? null
+      }).returning({ id: schema_exports.tags.id, name: schema_exports.tags.name });
+      if (created) {
+        seenIds.add(created.id);
+        tags2.push(created);
+        existingByNorm.set(norm, created);
+      }
+    } catch {
+      const [retry2] = await db.select({ id: schema_exports.tags.id, name: schema_exports.tags.name }).from(schema_exports.tags).where(
+        and(
+          eq(schema_exports.tags.teamId, teamId),
+          sql`lower(${schema_exports.tags.name}) = ${norm}`,
+          input.projectId ? or(
+            eq(schema_exports.tags.projectId, input.projectId),
+            isNull(schema_exports.tags.projectId)
+          ) : isNull(schema_exports.tags.projectId)
+        )
+      ).limit(1);
+      if (retry2 && !seenIds.has(retry2.id)) {
+        seenIds.add(retry2.id);
+        tags2.push(retry2);
+        existingByNorm.set(norm, retry2);
+      } else {
+        errors.push(`Failed to create tag: ${rawName}`);
+      }
+    }
+  }
+  return { tags: tags2, errors };
+}
+async function syncTicketTags(ticketId, teamId, tagIds, mode = "replace") {
+  const current = await db.select({ tagId: schema_exports.ticketTags.tagId }).from(schema_exports.ticketTags).where(eq(schema_exports.ticketTags.ticketId, ticketId));
+  const currentIds = new Set(current.map((row) => row.tagId));
+  let targetIds;
+  if (mode === "remove") {
+    targetIds = new Set(
+      [...currentIds].filter((id) => !tagIds.includes(id))
+    );
+  } else if (mode === "merge") {
+    targetIds = /* @__PURE__ */ new Set([...currentIds, ...tagIds]);
+  } else {
+    targetIds = new Set(tagIds);
+  }
+  const toInsert = [...targetIds].filter((id) => !currentIds.has(id));
+  const toDelete = [...currentIds].filter((id) => !targetIds.has(id));
+  if (toDelete.length > 0) {
+    await db.delete(schema_exports.ticketTags).where(
+      and(
+        eq(schema_exports.ticketTags.ticketId, ticketId),
+        inArray(schema_exports.ticketTags.tagId, toDelete)
+      )
+    );
+  }
+  if (toInsert.length > 0) {
+    await db.insert(schema_exports.ticketTags).values(
+      toInsert.map((tagId) => ({
+        ticketId,
+        tagId,
+        teamId
+      }))
+    );
+  }
+  const tagIdsToDescribe = [.../* @__PURE__ */ new Set([...toInsert, ...toDelete])];
+  const tagNamesById = /* @__PURE__ */ new Map();
+  if (tagIdsToDescribe.length > 0) {
+    const rows = await db.select({ id: schema_exports.tags.id, name: schema_exports.tags.name }).from(schema_exports.tags).where(inArray(schema_exports.tags.id, tagIdsToDescribe));
+    for (const row of rows) tagNamesById.set(row.id, row.name);
+  }
+  return {
+    added: toInsert.map((id) => tagNamesById.get(id) ?? id),
+    removed: toDelete.map((id) => tagNamesById.get(id) ?? id)
+  };
+}
+
+// src/tools/project-tags.ts
+async function getTagsForProjects(projectIds) {
+  const result = /* @__PURE__ */ new Map();
+  if (projectIds.length === 0) return result;
+  const rows = await db.select({
+    projectId: schema_exports.projectTags.projectId,
+    id: schema_exports.tags.id,
+    name: schema_exports.tags.name
+  }).from(schema_exports.projectTags).innerJoin(schema_exports.tags, eq(schema_exports.tags.id, schema_exports.projectTags.tagId)).where(inArray(schema_exports.projectTags.projectId, projectIds)).orderBy(schema_exports.tags.name);
+  for (const row of rows) {
+    const existing = result.get(row.projectId) ?? [];
+    existing.push({ id: row.id, name: row.name });
+    result.set(row.projectId, existing);
+  }
+  return result;
+}
+async function resolveProjectTagFilterIds(teamId, input) {
+  const ids = new Set(input.projectTagIds ?? []);
+  const names = [
+    ...input.projectTag ? [input.projectTag] : [],
+    ...input.projectTags ?? []
+  ].map(normalizeTagName).filter(Boolean);
+  if (names.length > 0) {
+    const nameConditions = names.map(
+      (name21) => sql`lower(${schema_exports.tags.name}) = ${name21}`
+    );
+    const rows = await db.select({ id: schema_exports.tags.id }).from(schema_exports.tags).where(
+      and(
+        eq(schema_exports.tags.teamId, teamId),
+        isNull(schema_exports.tags.projectId),
+        or(...nameConditions)
+      )
+    );
+    for (const row of rows) ids.add(row.id);
+  }
+  if (input.projectTagIds?.length) {
+    const rows = await db.select({ id: schema_exports.tags.id }).from(schema_exports.tags).where(
+      and(
+        eq(schema_exports.tags.teamId, teamId),
+        isNull(schema_exports.tags.projectId),
+        inArray(schema_exports.tags.id, input.projectTagIds)
+      )
+    );
+    for (const row of rows) ids.add(row.id);
+  }
+  return [...ids];
+}
+async function resolveProjectTags(teamId, input) {
+  const tags2 = [];
+  const errors = [];
+  const seenIds = /* @__PURE__ */ new Set();
+  if (input.tagIds?.length) {
+    const rows = await db.select({
+      id: schema_exports.tags.id,
+      name: schema_exports.tags.name,
+      projectId: schema_exports.tags.projectId
+    }).from(schema_exports.tags).where(
+      and(
+        eq(schema_exports.tags.teamId, teamId),
+        inArray(schema_exports.tags.id, input.tagIds)
+      )
+    );
+    for (const row of rows) {
+      if (row.projectId) {
+        errors.push(
+          `Tag "${row.name}" is project-scoped (ticket tag) and cannot be used as a project label`
+        );
+        continue;
+      }
+      if (seenIds.has(row.id)) continue;
+      seenIds.add(row.id);
+      tags2.push({ id: row.id, name: row.name });
+    }
+    for (const id of input.tagIds) {
+      if (!seenIds.has(id) && !errors.some((e6) => e6.includes(id))) {
+        errors.push(`Unknown tag ID: ${id}`);
+      }
+    }
+  }
+  const rawNames = input.tagNames ?? [];
+  if (rawNames.length === 0) return { tags: tags2, errors };
+  const normalizedNames = [
+    ...new Set(rawNames.map(normalizeTagName).filter(Boolean))
+  ];
+  if (normalizedNames.length === 0) return { tags: tags2, errors };
+  const nameConditions = normalizedNames.map(
+    (name21) => sql`lower(${schema_exports.tags.name}) = ${name21}`
+  );
+  const existing = await db.select({
+    id: schema_exports.tags.id,
+    name: schema_exports.tags.name,
+    projectId: schema_exports.tags.projectId
+  }).from(schema_exports.tags).where(and(eq(schema_exports.tags.teamId, teamId), or(...nameConditions)));
+  const existingByNorm = /* @__PURE__ */ new Map();
+  for (const tag2 of existing) {
+    if (tag2.projectId) {
+      existingByNorm.set(normalizeTagName(tag2.name), {
+        id: tag2.id,
+        name: tag2.name,
+        _scoped: true
+      });
+    } else {
+      existingByNorm.set(normalizeTagName(tag2.name), {
+        id: tag2.id,
+        name: tag2.name
+      });
+    }
+  }
+  for (const rawName of rawNames) {
+    const norm = normalizeTagName(rawName);
+    if (!norm) continue;
+    const found = existingByNorm.get(norm);
+    if (found) {
+      if (found._scoped) {
+        errors.push(
+          `Tag "${rawName}" is project-scoped (ticket tag) and cannot be used as a project label`
+        );
+        continue;
+      }
+      if (!seenIds.has(found.id)) {
+        seenIds.add(found.id);
+        tags2.push({ id: found.id, name: found.name });
+      }
+      continue;
+    }
+    if (!input.createMissing) {
+      errors.push(`Project label not found: ${rawName}`);
+      continue;
+    }
+    try {
+      const [created] = await db.insert(schema_exports.tags).values({
+        teamId,
+        name: norm,
+        projectId: null
+      }).returning({ id: schema_exports.tags.id, name: schema_exports.tags.name });
+      if (created) {
+        seenIds.add(created.id);
+        tags2.push(created);
+        existingByNorm.set(norm, created);
+      }
+    } catch {
+      const [retry2] = await db.select({ id: schema_exports.tags.id, name: schema_exports.tags.name }).from(schema_exports.tags).where(
+        and(
+          eq(schema_exports.tags.teamId, teamId),
+          sql`lower(${schema_exports.tags.name}) = ${norm}`,
+          isNull(schema_exports.tags.projectId)
+        )
+      ).limit(1);
+      if (retry2 && !seenIds.has(retry2.id)) {
+        seenIds.add(retry2.id);
+        tags2.push(retry2);
+        existingByNorm.set(norm, retry2);
+      } else {
+        errors.push(`Failed to create project label: ${rawName}`);
+      }
+    }
+  }
+  return { tags: tags2, errors };
+}
+async function syncProjectTags(projectId, teamId, tagIds, mode = "replace") {
+  const current = await db.select({ tagId: schema_exports.projectTags.tagId }).from(schema_exports.projectTags).where(eq(schema_exports.projectTags.projectId, projectId));
+  const currentIds = new Set(current.map((row) => row.tagId));
+  let targetIds;
+  if (mode === "remove") {
+    targetIds = new Set(
+      [...currentIds].filter((id) => !tagIds.includes(id))
+    );
+  } else if (mode === "merge") {
+    targetIds = /* @__PURE__ */ new Set([...currentIds, ...tagIds]);
+  } else {
+    targetIds = new Set(tagIds);
+  }
+  const toInsert = [...targetIds].filter((id) => !currentIds.has(id));
+  const toDelete = [...currentIds].filter((id) => !targetIds.has(id));
+  if (toDelete.length > 0) {
+    await db.delete(schema_exports.projectTags).where(
+      and(
+        eq(schema_exports.projectTags.projectId, projectId),
+        inArray(schema_exports.projectTags.tagId, toDelete)
+      )
+    );
+  }
+  if (toInsert.length > 0) {
+    await db.insert(schema_exports.projectTags).values(
+      toInsert.map((tagId) => ({
+        projectId,
+        tagId,
+        teamId
+      }))
+    );
+  }
+  const tagIdsToDescribe = [.../* @__PURE__ */ new Set([...toInsert, ...toDelete])];
+  const tagNamesById = /* @__PURE__ */ new Map();
+  if (tagIdsToDescribe.length > 0) {
+    const rows = await db.select({ id: schema_exports.tags.id, name: schema_exports.tags.name }).from(schema_exports.tags).where(inArray(schema_exports.tags.id, tagIdsToDescribe));
+    for (const row of rows) tagNamesById.set(row.id, row.name);
+  }
+  return {
+    added: toInsert.map((id) => tagNamesById.get(id) ?? id),
+    removed: toDelete.map((id) => tagNamesById.get(id) ?? id)
+  };
+}
+function projectTagFilterSql(tagIds, ticketsAlias = schema_exports.tickets) {
+  return sql`EXISTS (
+    SELECT 1 FROM ${schema_exports.projectTags} pt
+    WHERE pt.project_id = ${ticketsAlias.projectId}
+    AND pt.tag_id IN (${sql.join(
+    tagIds.map((id) => sql`${id}`),
+    sql`, `
+  )})
+  )`;
+}
+
+// src/tools/project-cleanup-util.ts
+var PROJECT_STATUS_FILTERS = [
+  "active",
+  "archived",
+  "all"
+];
+var DEPENDENCY_LABELS2 = {
+  tickets: "ticket(s)",
+  timesheetEvents: "agenda/time entr(ies)",
+  timesheetTemplates: "timesheet template(s)",
+  trips: "trip(s)",
+  tripTemplates: "trip template(s)"
+};
+function getProjectArchiveState(settings) {
+  const obj = settings && typeof settings === "object" && !Array.isArray(settings) ? settings : {};
+  const archivedAt = typeof obj.archivedAt === "string" && obj.archivedAt.trim().length > 0 ? obj.archivedAt : null;
+  const archiveReason = typeof obj.archiveReason === "string" && obj.archiveReason.trim().length > 0 ? obj.archiveReason : null;
+  return { archived: archivedAt !== null, archivedAt, archiveReason };
+}
+function withArchiveSettings(settings, archivedAt, reason) {
+  const base = settings && typeof settings === "object" && !Array.isArray(settings) ? { ...settings } : {};
+  base.archivedAt = archivedAt;
+  if (reason && reason.trim().length > 0) {
+    base.archiveReason = reason.trim();
+  }
+  return base;
+}
+function totalProjectDependencies(counts) {
+  return counts.tickets + counts.timesheetEvents + counts.timesheetTemplates + counts.trips + counts.tripTemplates;
+}
+function isProjectEmpty(counts) {
+  return totalProjectDependencies(counts) === 0;
+}
+function formatProjectDependencies(counts) {
+  const parts = Object.keys(DEPENDENCY_LABELS2).filter((key) => counts[key] > 0).map((key) => `${counts[key]} ${DEPENDENCY_LABELS2[key]}`);
+  return parts.length > 0 ? parts.join(", ") : "no dependencies";
+}
+
+// src/tools/projects.ts
+async function handleGetProjects(input) {
+  const ctx = getAuthContext();
+  const { customerId, q: q3, pageSize = 20, projectTag, projectTags: projectTags2, projectTagIds } = input;
+  const status = input.status ?? "active";
+  if (!PROJECT_STATUS_FILTERS.includes(status)) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Error: invalid status "${status}". Allowed: ${PROJECT_STATUS_FILTERS.join(", ")}.`
+        }
+      ]
+    };
+  }
+  const resolved = await resolveTeamId(input.teamId);
+  if (!resolved.ok) return resolved.response;
+  const projectIds = await getAccessibleProjectIds(ctx.userId, resolved.teamId);
+  if (projectIds.length === 0) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: "No projects found or no access to any projects."
+        }
+      ]
+    };
+  }
+  const filters = [inArray(schema_exports.projects.id, projectIds)];
+  if (customerId) filters.push(eq(schema_exports.projects.customerId, customerId));
+  if (q3) filters.push(ilike(schema_exports.projects.name, `%${q3}%`));
+  if (status === "active") {
+    filters.push(sql`${schema_exports.projects.settings} ->> 'archivedAt' IS NULL`);
+  } else if (status === "archived") {
+    filters.push(sql`${schema_exports.projects.settings} ->> 'archivedAt' IS NOT NULL`);
+  }
+  const labelFilterIds = await resolveProjectTagFilterIds(resolved.teamId, {
+    projectTag,
+    projectTags: projectTags2,
+    projectTagIds
+  });
+  if (projectTag || projectTags2?.length || projectTagIds?.length) {
+    if (labelFilterIds.length === 0) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: "No projects found (no matching project labels for the given filter)."
+          }
+        ]
+      };
+    }
+    filters.push(
+      sql`EXISTS (
+        SELECT 1 FROM ${schema_exports.projectTags}
+        WHERE ${schema_exports.projectTags.projectId} = ${schema_exports.projects.id}
+        AND ${schema_exports.projectTags.tagId} IN (${sql.join(
+        labelFilterIds.map((id) => sql`${id}`),
+        sql`, `
+      )})
+      )`
+    );
+  }
+  const rows = await db.select({
+    id: schema_exports.projects.id,
     name: schema_exports.projects.name,
     description: schema_exports.projects.description,
     customerId: schema_exports.projects.customerId,
     createdAt: schema_exports.projects.createdAt,
     settings: schema_exports.projects.settings
   }).from(schema_exports.projects).where(and(...filters)).orderBy(asc(schema_exports.projects.name)).limit(Math.min(pageSize, 100));
+  const tagsByProject = await getTagsForProjects(rows.map((p3) => p3.id));
   return {
     content: [
       {
@@ -122892,9 +123511,12 @@ async function handleGetProjects(input) {
 
 ${rows.map((p3) => {
           const archive = getProjectArchiveState(p3.settings);
+          const labels = tagsByProject.get(p3.id) ?? [];
+          const labelLine = labels.length > 0 ? `Labels: ${formatTagList(labels)} (ids: ${labels.map((t9) => t9.id).join(", ")})
+` : "";
           return `**${p3.name}** (ID: ${p3.id})${archive.archived ? " \u2014 ARCHIVED" : ""}
 ${p3.description ? `Description: ${p3.description}
-` : ""}Created: ${new Date(p3.createdAt).toLocaleDateString()}
+` : ""}` + labelLine + `Created: ${new Date(p3.createdAt).toLocaleDateString()}
 ${archive.archived ? `Archived: ${archive.archivedAt}${archive.archiveReason ? ` (${archive.archiveReason})` : ""}
 ` : ""}`;
         }).join("\n") || "No projects found."}`
@@ -122903,15 +123525,41 @@ ${archive.archived ? `Archived: ${archive.archivedAt}${archive.archiveReason ? `
   };
 }
 async function handleCreateProject(input) {
-  const { name: name21, description, customerId } = input;
+  const { name: name21, description, customerId, projectTags: projectTags2, projectTagIds } = input;
   const resolved = await resolveTeamId(input.teamId);
   if (!resolved.ok) return resolved.response;
-  await db.insert(schema_exports.projects).values({
+  const [created] = await db.insert(schema_exports.projects).values({
     teamId: resolved.teamId,
     name: name21,
     description: description ?? null,
     customerId: customerId ?? null
-  });
+  }).returning({ id: schema_exports.projects.id });
+  if (!created) {
+    return textResponse7("Failed to create project.");
+  }
+  let labelLine = "";
+  if (projectTags2?.length || projectTagIds?.length) {
+    const { tags: tags2, errors } = await resolveProjectTags(resolved.teamId, {
+      tagNames: projectTags2,
+      tagIds: projectTagIds,
+      createMissing: true
+    });
+    if (errors.length > 0) {
+      return textResponse7(
+        `Project created (ID: ${created.id}) but label errors:
+${errors.join("\n")}`
+      );
+    }
+    if (tags2.length > 0) {
+      await syncProjectTags(
+        created.id,
+        resolved.teamId,
+        tags2.map((t9) => t9.id)
+      );
+      labelLine = `
+Labels: ${formatTagList(tags2)}`;
+    }
+  }
   return {
     content: [
       {
@@ -122919,8 +123567,9 @@ async function handleCreateProject(input) {
         text: `\u2705 **Project Created Successfully!**
 
 Name: ${name21}
+ID: ${created.id}
 ${description ? `Description: ${description}
-` : ""}`
+` : ""}` + labelLine
       }
     ]
   };
@@ -123192,6 +123841,27 @@ async function handleUpdateProject(input) {
       )
     );
   }
+  let labelSyncNote = "";
+  if (input.projectTags !== void 0 || input.projectTagIds !== void 0) {
+    const { tags: tags2, errors } = await resolveProjectTags(owningTeamId, {
+      tagNames: input.projectTags,
+      tagIds: input.projectTagIds,
+      createMissing: true
+    });
+    if (errors.length > 0) {
+      return textResponse7(`Project label errors:
+${errors.join("\n")}`);
+    }
+    const syncResult = await syncProjectTags(
+      id,
+      owningTeamId,
+      tags2.map((t9) => t9.id)
+    );
+    if (syncResult.added.length || syncResult.removed.length) {
+      labelSyncNote = `
+Labels updated: +${syncResult.added.join(", ") || "none"} / -${syncResult.removed.join(", ") || "none"}`;
+    }
+  }
   const [updated] = await db.select({
     id: schema_exports.projects.id,
     name: schema_exports.projects.name,
@@ -123217,6 +123887,13 @@ async function handleUpdateProject(input) {
     );
   }
   lines.push(`Internal: ${updated.internal ? "yes" : "no"}`);
+  if (labelSyncNote) lines.push(labelSyncNote.trim());
+  const projectLabels = (await getTagsForProjects([id])).get(id) ?? [];
+  if (projectLabels.length > 0) {
+    lines.push(
+      `Labels: ${formatTagList(projectLabels)} (ids: ${projectLabels.map((t9) => t9.id).join(", ")})`
+    );
+  }
   if (willRename) {
     lines.push("", "Note: tickets for this project were renumbered.");
   }
@@ -123479,25 +124156,155 @@ async function handleDeleteProject(input) {
 
 Dependencies: ${summary}.
 
-A hard delete would orphan these records, so it is not allowed. Use archive-project instead to safely retire this project (reversible, keeps all data).`
-    );
-  }
-  if (confirmEmptyOnly !== true) {
-    return textResponse7(
-      `Project "${project.name}" (${project.id}) has no dependencies and can be safely deleted. This is a permanent hard delete. Re-run delete-project with confirmEmptyOnly: true to proceed (or use archive-project to keep the record).`
-    );
+A hard delete would orphan these records, so it is not allowed. Use archive-project instead to safely retire this project (reversible, keeps all data).`
+    );
+  }
+  if (confirmEmptyOnly !== true) {
+    return textResponse7(
+      `Project "${project.name}" (${project.id}) has no dependencies and can be safely deleted. This is a permanent hard delete. Re-run delete-project with confirmEmptyOnly: true to proceed (or use archive-project to keep the record).`
+    );
+  }
+  await db.delete(schema_exports.projects).where(eq(schema_exports.projects.id, project.id));
+  return textResponse7(
+    `\u2705 **Project deleted**
+
+Project: ${project.name}
+ID: ${project.id}
+Action: hard delete (empty project)
+Status: deleted
+Timestamp: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+The project had no tickets, hours, trips, or templates. Any project-scoped config (member access, tags, slack/github links, team rates) was removed with it.`
+  );
+}
+async function resolveProjectForTags(projectId, teamId) {
+  const project = await loadProjectInTeam(projectId, teamId);
+  if (!project) {
+    return {
+      ok: false,
+      response: textResponse7(
+        `Project ${projectId} not found, or it is not owned by this team.`
+      )
+    };
+  }
+  return { ok: true, project };
+}
+async function handleGetProjectTags(input) {
+  const resolved = await resolveTeamId(input.teamId);
+  if (!resolved.ok) return resolved.response;
+  const projectResult = await resolveProjectForTags(
+    input.projectId,
+    resolved.teamId
+  );
+  if (!projectResult.ok) return projectResult.response;
+  const labels = (await getTagsForProjects([input.projectId])).get(input.projectId) ?? [];
+  if (labels.length === 0) {
+    return textResponse7(
+      `Project "${projectResult.project.name}" (${input.projectId}) has no project labels.`
+    );
+  }
+  return textResponse7(
+    `Project labels for **${projectResult.project.name}** (${input.projectId}):
+
+` + labels.map((t9) => `- ${t9.name} (id: ${t9.id})`).join("\n")
+  );
+}
+async function handleSetProjectTags(input) {
+  const resolved = await resolveTeamId(input.teamId);
+  if (!resolved.ok) return resolved.response;
+  const projectResult = await resolveProjectForTags(
+    input.projectId,
+    resolved.teamId
+  );
+  if (!projectResult.ok) return projectResult.response;
+  const owningTeamId = projectResult.project.teamId;
+  const { tags: tags2, errors } = await resolveProjectTags(owningTeamId, {
+    tagNames: input.projectTags,
+    tagIds: input.projectTagIds,
+    createMissing: true
+  });
+  if (errors.length > 0) {
+    return textResponse7(`Project label errors:
+${errors.join("\n")}`);
+  }
+  const syncResult = await syncProjectTags(
+    input.projectId,
+    owningTeamId,
+    tags2.map((t9) => t9.id)
+  );
+  return textResponse7(
+    `\u2705 **Project labels set** for "${projectResult.project.name}" (${input.projectId})
+
+Labels: ${formatTagList(tags2) || "(none)"}
+Added: ${syncResult.added.join(", ") || "none"}
+Removed: ${syncResult.removed.join(", ") || "none"}`
+  );
+}
+async function handleAddProjectTag(input) {
+  if (!input.projectTag && !input.projectTagId) {
+    return textResponse7("Provide projectTag (name) or projectTagId.");
   }
-  await db.delete(schema_exports.projects).where(eq(schema_exports.projects.id, project.id));
+  const resolved = await resolveTeamId(input.teamId);
+  if (!resolved.ok) return resolved.response;
+  const projectResult = await resolveProjectForTags(
+    input.projectId,
+    resolved.teamId
+  );
+  if (!projectResult.ok) return projectResult.response;
+  const owningTeamId = projectResult.project.teamId;
+  const { tags: tags2, errors } = await resolveProjectTags(owningTeamId, {
+    tagNames: input.projectTag ? [input.projectTag] : void 0,
+    tagIds: input.projectTagId ? [input.projectTagId] : void 0,
+    createMissing: true
+  });
+  if (errors.length > 0) {
+    return textResponse7(`Project label errors:
+${errors.join("\n")}`);
+  }
+  if (tags2.length === 0) {
+    return textResponse7("No matching project label to add.");
+  }
+  const syncResult = await syncProjectTags(
+    input.projectId,
+    owningTeamId,
+    tags2.map((t9) => t9.id),
+    "merge"
+  );
   return textResponse7(
-    `\u2705 **Project deleted**
+    `\u2705 **Project label added** to "${projectResult.project.name}"
 
-Project: ${project.name}
-ID: ${project.id}
-Action: hard delete (empty project)
-Status: deleted
-Timestamp: ${(/* @__PURE__ */ new Date()).toISOString()}
+Added: ${syncResult.added.join(", ") || tags2.map((t9) => t9.name).join(", ")}`
+  );
+}
+async function handleRemoveProjectTag(input) {
+  if (!input.projectTag && !input.projectTagId) {
+    return textResponse7("Provide projectTag (name) or projectTagId.");
+  }
+  const resolved = await resolveTeamId(input.teamId);
+  if (!resolved.ok) return resolved.response;
+  const projectResult = await resolveProjectForTags(
+    input.projectId,
+    resolved.teamId
+  );
+  if (!projectResult.ok) return projectResult.response;
+  const owningTeamId = projectResult.project.teamId;
+  const filterIds = await resolveProjectTagFilterIds(owningTeamId, {
+    projectTag: input.projectTag,
+    projectTagIds: input.projectTagId ? [input.projectTagId] : void 0
+  });
+  if (filterIds.length === 0) {
+    return textResponse7("No matching project label found to remove.");
+  }
+  const syncResult = await syncProjectTags(
+    input.projectId,
+    owningTeamId,
+    filterIds,
+    "remove"
+  );
+  return textResponse7(
+    `\u2705 **Project label removed** from "${projectResult.project.name}"
 
-The project had no tickets, hours, trips, or templates. Any project-scoped config (member access, tags, slack/github links, team rates) was removed with it.`
+Removed: ${syncResult.removed.join(", ") || "none"}`
   );
 }
 
@@ -125904,170 +126711,6 @@ ${rendered}`
   };
 }
 
-// src/tools/ticket-tags.ts
-function normalizeTagName(name21) {
-  return name21.toLowerCase().trim();
-}
-function formatTagList(tags2) {
-  if (tags2.length === 0) return "";
-  return tags2.map((t9) => t9.name).join(", ");
-}
-async function getTagsForTickets(ticketIds) {
-  const result = /* @__PURE__ */ new Map();
-  if (ticketIds.length === 0) return result;
-  const rows = await db.select({
-    ticketId: schema_exports.ticketTags.ticketId,
-    id: schema_exports.tags.id,
-    name: schema_exports.tags.name
-  }).from(schema_exports.ticketTags).innerJoin(schema_exports.tags, eq(schema_exports.tags.id, schema_exports.ticketTags.tagId)).where(inArray(schema_exports.ticketTags.ticketId, ticketIds)).orderBy(schema_exports.tags.name);
-  for (const row of rows) {
-    const existing = result.get(row.ticketId) ?? [];
-    existing.push({ id: row.id, name: row.name });
-    result.set(row.ticketId, existing);
-  }
-  return result;
-}
-async function resolveTagFilterIds(teamId, input) {
-  const ids = new Set(input.tagIds ?? []);
-  const names = [
-    ...input.tag ? [input.tag] : [],
-    ...input.tags ?? []
-  ].map(normalizeTagName).filter(Boolean);
-  if (names.length > 0) {
-    const nameConditions = names.map(
-      (name21) => sql`lower(${schema_exports.tags.name}) = ${name21}`
-    );
-    const rows = await db.select({ id: schema_exports.tags.id }).from(schema_exports.tags).where(and(eq(schema_exports.tags.teamId, teamId), or(...nameConditions)));
-    for (const row of rows) ids.add(row.id);
-  }
-  return [...ids];
-}
-async function resolveTags(teamId, input) {
-  const tags2 = [];
-  const errors = [];
-  const seenIds = /* @__PURE__ */ new Set();
-  if (input.tagIds?.length) {
-    const rows = await db.select({ id: schema_exports.tags.id, name: schema_exports.tags.name }).from(schema_exports.tags).where(
-      and(
-        eq(schema_exports.tags.teamId, teamId),
-        inArray(schema_exports.tags.id, input.tagIds)
-      )
-    );
-    for (const row of rows) {
-      if (seenIds.has(row.id)) continue;
-      seenIds.add(row.id);
-      tags2.push(row);
-    }
-    for (const id of input.tagIds) {
-      if (!seenIds.has(id)) errors.push(`Unknown tag ID: ${id}`);
-    }
-  }
-  const rawNames = input.tagNames ?? [];
-  if (rawNames.length === 0) return { tags: tags2, errors };
-  const normalizedNames = [
-    ...new Set(rawNames.map(normalizeTagName).filter(Boolean))
-  ];
-  if (normalizedNames.length === 0) return { tags: tags2, errors };
-  const nameConditions = normalizedNames.map(
-    (name21) => sql`lower(${schema_exports.tags.name}) = ${name21}`
-  );
-  const existing = await db.select({ id: schema_exports.tags.id, name: schema_exports.tags.name }).from(schema_exports.tags).where(and(eq(schema_exports.tags.teamId, teamId), or(...nameConditions)));
-  const existingByNorm = /* @__PURE__ */ new Map();
-  for (const tag2 of existing) {
-    existingByNorm.set(normalizeTagName(tag2.name), tag2);
-  }
-  for (const rawName of rawNames) {
-    const norm = normalizeTagName(rawName);
-    if (!norm) continue;
-    const found = existingByNorm.get(norm);
-    if (found) {
-      if (!seenIds.has(found.id)) {
-        seenIds.add(found.id);
-        tags2.push(found);
-      }
-      continue;
-    }
-    if (!input.createMissing) {
-      errors.push(`Tag not found: ${rawName}`);
-      continue;
-    }
-    try {
-      const [created] = await db.insert(schema_exports.tags).values({
-        teamId,
-        name: norm,
-        projectId: input.projectId ?? null
-      }).returning({ id: schema_exports.tags.id, name: schema_exports.tags.name });
-      if (created) {
-        seenIds.add(created.id);
-        tags2.push(created);
-        existingByNorm.set(norm, created);
-      }
-    } catch {
-      const [retry2] = await db.select({ id: schema_exports.tags.id, name: schema_exports.tags.name }).from(schema_exports.tags).where(
-        and(
-          eq(schema_exports.tags.teamId, teamId),
-          sql`lower(${schema_exports.tags.name}) = ${norm}`,
-          input.projectId ? or(
-            eq(schema_exports.tags.projectId, input.projectId),
-            isNull(schema_exports.tags.projectId)
-          ) : isNull(schema_exports.tags.projectId)
-        )
-      ).limit(1);
-      if (retry2 && !seenIds.has(retry2.id)) {
-        seenIds.add(retry2.id);
-        tags2.push(retry2);
-        existingByNorm.set(norm, retry2);
-      } else {
-        errors.push(`Failed to create tag: ${rawName}`);
-      }
-    }
-  }
-  return { tags: tags2, errors };
-}
-async function syncTicketTags(ticketId, teamId, tagIds, mode = "replace") {
-  const current = await db.select({ tagId: schema_exports.ticketTags.tagId }).from(schema_exports.ticketTags).where(eq(schema_exports.ticketTags.ticketId, ticketId));
-  const currentIds = new Set(current.map((row) => row.tagId));
-  let targetIds;
-  if (mode === "remove") {
-    targetIds = new Set(
-      [...currentIds].filter((id) => !tagIds.includes(id))
-    );
-  } else if (mode === "merge") {
-    targetIds = /* @__PURE__ */ new Set([...currentIds, ...tagIds]);
-  } else {
-    targetIds = new Set(tagIds);
-  }
-  const toInsert = [...targetIds].filter((id) => !currentIds.has(id));
-  const toDelete = [...currentIds].filter((id) => !targetIds.has(id));
-  if (toDelete.length > 0) {
-    await db.delete(schema_exports.ticketTags).where(
-      and(
-        eq(schema_exports.ticketTags.ticketId, ticketId),
-        inArray(schema_exports.ticketTags.tagId, toDelete)
-      )
-    );
-  }
-  if (toInsert.length > 0) {
-    await db.insert(schema_exports.ticketTags).values(
-      toInsert.map((tagId) => ({
-        ticketId,
-        tagId,
-        teamId
-      }))
-    );
-  }
-  const tagIdsToDescribe = [.../* @__PURE__ */ new Set([...toInsert, ...toDelete])];
-  const tagNamesById = /* @__PURE__ */ new Map();
-  if (tagIdsToDescribe.length > 0) {
-    const rows = await db.select({ id: schema_exports.tags.id, name: schema_exports.tags.name }).from(schema_exports.tags).where(inArray(schema_exports.tags.id, tagIdsToDescribe));
-    for (const row of rows) tagNamesById.set(row.id, row.name);
-  }
-  return {
-    added: toInsert.map((id) => tagNamesById.get(id) ?? id),
-    removed: toDelete.map((id) => tagNamesById.get(id) ?? id)
-  };
-}
-
 // src/tools/tags.ts
 async function handleGetTags(input) {
   const resolved = await resolveTeamId(input.teamId);
@@ -127392,6 +128035,9 @@ async function handleGetTickets(input) {
     tag: tag2,
     tags: tags2,
     tagIds,
+    projectTag,
+    projectTags: projectTags2,
+    projectTagIds,
     pageSize = 20
   } = input;
   const resolved = await resolveTeamId(input.teamId);
@@ -127451,6 +128097,24 @@ async function handleGetTickets(input) {
       )`
     );
   }
+  const filterProjectLabelIds = await resolveProjectTagFilterIds(teamId, {
+    projectTag,
+    projectTags: projectTags2,
+    projectTagIds
+  });
+  if (projectTag || projectTags2?.length || projectTagIds?.length) {
+    if (filterProjectLabelIds.length === 0) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: "No tickets found (no matching project labels for the given filter)."
+          }
+        ]
+      };
+    }
+    filters.push(projectTagFilterSql(filterProjectLabelIds));
+  }
   const rows = await db.select({
     id: schema_exports.tickets.id,
     ticketNumber: schema_exports.tickets.ticketNumber,
@@ -127863,7 +128527,7 @@ function workStatesToStatuses(workStates) {
   }
   return [...set3];
 }
-async function loadWorkQueue(scope, assignee, filters) {
+async function loadWorkQueue(scope, assignee, filters, teamId) {
   const conditions = [
     buildTicketAccessPredicate(
       scope.teamIds,
@@ -127894,6 +128558,17 @@ async function loadWorkQueue(scope, assignee, filters) {
   if (filters.projectId) {
     conditions.push(eq(t8.projectId, filters.projectId));
   }
+  const labelFilterIds = await resolveProjectTagFilterIds(teamId, {
+    projectTag: filters.projectTag,
+    projectTags: filters.projectTags,
+    projectTagIds: filters.projectTagIds
+  });
+  if (filters.projectTag || filters.projectTags?.length || filters.projectTagIds?.length) {
+    if (labelFilterIds.length === 0) {
+      return [];
+    }
+    conditions.push(projectTagFilterSql(labelFilterIds, t8));
+  }
   const rows = await db.select({
     id: t8.id,
     ticketNumber: t8.ticketNumber,
@@ -127946,10 +128621,12 @@ async function handleGetMyWorkQueue(input) {
   const ctx = getAuthContext();
   const scope = await resolveTeamScope(input.teamId);
   if (!scope.ok) return scope.response;
+  const teamId = input.teamId ?? ctx.teamId;
   const rows = await loadWorkQueue(
     scope,
     { mode: "one", userId: ctx.userId },
-    input
+    input,
+    teamId
   );
   const items = rows.map(serializeItem);
   return jsonResponse3({
@@ -127972,10 +128649,12 @@ async function handleGetAssigneeWorkQueue(input) {
   const rawAssignee = input.assigneeId?.trim();
   const isAll = rawAssignee === "all";
   const targetUserId = !rawAssignee || rawAssignee === "me" ? ctx.userId : rawAssignee;
+  const teamId = input.teamId ?? ctx.teamId;
   const rows = await loadWorkQueue(
     scope,
     isAll ? { mode: "all" } : { mode: "one", userId: targetUserId },
-    input
+    input,
+    teamId
   );
   const items = rows.map(serializeItem);
   if (isAll && input.groupByAssignee) {
@@ -128011,11 +128690,13 @@ async function handleGetAssigneeWorkQueue(input) {
   });
 }
 async function handleGetTeamWorkloadOverview(input) {
+  const ctx = getAuthContext();
   const scope = await resolveTeamScope(input.teamId);
   if (!scope.ok) return scope.response;
   const staleDays = input.staleDays ?? 7;
   const upcomingDays = input.upcomingDays ?? 7;
   const includeUnassigned = input.includeUnassigned ?? true;
+  const teamId = input.teamId ?? ctx.teamId;
   const conditions = [
     buildTicketAccessPredicate(
       scope.teamIds,
@@ -128028,6 +128709,21 @@ async function handleGetTeamWorkloadOverview(input) {
   if (!includeUnassigned) {
     conditions.push(sql`${t8.assigneeId} IS NOT NULL`);
   }
+  const labelFilterIds = await resolveProjectTagFilterIds(teamId, {
+    projectTag: input.projectTag,
+    projectTags: input.projectTags,
+    projectTagIds: input.projectTagIds
+  });
+  if (input.projectTag || input.projectTags?.length || input.projectTagIds?.length) {
+    if (labelFilterIds.length === 0) {
+      return jsonResponse3({
+        teamScope: scope.teamIds,
+        config: { staleDays, upcomingDays, includeUnassigned },
+        assignees: []
+      });
+    }
+    conditions.push(projectTagFilterSql(labelFilterIds, t8));
+  }
   const rows = await db.select({
     assigneeId: t8.assigneeId,
     assigneeName: schema_exports.users.fullName,
@@ -128969,11 +129665,13 @@ async function handleGetRefrontMcpActivity(input) {
     );
   }
   const userIds = /* @__PURE__ */ new Set();
-  const ticketIds = /* @__PURE__ */ new Set();
+  const ticketRefs = /* @__PURE__ */ new Set();
   const projectIds = /* @__PURE__ */ new Set();
   for (const r6 of rows) {
     if (r6.userId) userIds.add(r6.userId);
-    if (r6.entity.ticketId) ticketIds.add(r6.entity.ticketId);
+    for (const ref of collectTicketRefsFromEntity(r6.entity)) {
+      ticketRefs.add(ref);
+    }
     if (r6.entity.projectId) projectIds.add(r6.entity.projectId);
   }
   const usersById = /* @__PURE__ */ new Map();
@@ -128981,34 +129679,27 @@ async function handleGetRefrontMcpActivity(input) {
     const userRows = await db.select({ id: schema_exports.users.id, name: schema_exports.users.fullName }).from(schema_exports.users).where(inArray(schema_exports.users.id, [...userIds]));
     for (const u2 of userRows) usersById.set(u2.id, u2.name);
   }
-  const ticketsById = /* @__PURE__ */ new Map();
-  if (ticketIds.size > 0) {
-    const ticketRows = await db.select({
-      id: schema_exports.tickets.id,
-      ticketNumber: schema_exports.tickets.ticketNumber,
-      title: schema_exports.tickets.title,
-      projectId: schema_exports.tickets.projectId
-    }).from(schema_exports.tickets).where(
-      and(
-        inArray(schema_exports.tickets.id, [...ticketIds]),
-        inArray(schema_exports.tickets.teamId, scope.teamIds)
-      )
+  const { byRef: ticketsByRef, unresolved: unresolvedTicketRefs } = await resolveTicketRefMap({ refs: ticketRefs, teamIds: scope.teamIds });
+  if (unresolvedTicketRefs.length > 0) {
+    const preview = unresolvedTicketRefs.slice(0, 5).join(", ");
+    const suffix = unresolvedTicketRefs.length > 5 ? ` (+${unresolvedTicketRefs.length - 5} more)` : "";
+    limitations.push(
+      `${unresolvedTicketRefs.length} ticket ref(s) could not be resolved: ${preview}${suffix}.`
     );
-    for (const t9 of ticketRows) {
-      ticketsById.set(t9.id, {
-        ticketNumber: t9.ticketNumber,
-        title: t9.title,
-        projectId: t9.projectId
-      });
-      if (t9.projectId) projectIds.add(t9.projectId);
-    }
+  }
+  for (const info of ticketsByRef.values()) {
+    if (info.projectId) projectIds.add(info.projectId);
   }
   const projectsById = /* @__PURE__ */ new Map();
   if (projectIds.size > 0) {
     const projectRows = await db.select({ id: schema_exports.projects.id, name: schema_exports.projects.name }).from(schema_exports.projects).where(inArray(schema_exports.projects.id, [...projectIds]));
     for (const p3 of projectRows) projectsById.set(p3.id, p3.name);
   }
-  const projectOf = (r6) => r6.entity.projectId ?? ticketsById.get(r6.entity.ticketId ?? "")?.projectId ?? null;
+  const projectOf = (r6) => {
+    const ticket = lookupResolvedTicket(ticketsByRef, r6.entity);
+    return r6.entity.projectId ?? ticket?.projectId ?? null;
+  };
+  const canonicalTicketId = (r6) => lookupResolvedTicket(ticketsByRef, r6.entity)?.id ?? r6.entity.ticketId ?? r6.entity.ticketNumber ?? null;
   const byAction = {};
   const byToolMap = /* @__PURE__ */ new Map();
   const byTicketMap = /* @__PURE__ */ new Map();
@@ -129036,11 +129727,9 @@ async function handleGetRefrontMcpActivity(input) {
       tool2.durationSamples += 1;
     }
     byToolMap.set(r6.toolName, tool2);
-    if (r6.entity.ticketId) {
-      byTicketMap.set(
-        r6.entity.ticketId,
-        (byTicketMap.get(r6.entity.ticketId) ?? 0) + 1
-      );
+    if (canonicalTicketId(r6)) {
+      const key = canonicalTicketId(r6);
+      byTicketMap.set(key, (byTicketMap.get(key) ?? 0) + 1);
     }
     const projectId = projectOf(r6);
     if (projectId) {
@@ -129053,12 +129742,15 @@ async function handleGetRefrontMcpActivity(input) {
     failures: v2.failures,
     avgDurationMs: v2.durationSamples > 0 ? Math.round(v2.durationMsTotal / v2.durationSamples) : null
   })).sort((a6, b7) => b7.count - a6.count).slice(0, TOP_ENTITIES);
-  const byTicket = [...byTicketMap.entries()].map(([ticketId, count2]) => ({
-    ticketId,
-    ticketNumber: ticketsById.get(ticketId)?.ticketNumber ?? null,
-    ticketTitle: ticketsById.get(ticketId)?.title ?? null,
-    count: count2
-  })).sort((a6, b7) => b7.count - a6.count).slice(0, TOP_ENTITIES);
+  const byTicket = [...byTicketMap.entries()].map(([ticketId, count2]) => {
+    const ticket = ticketsByRef.get(ticketId) ?? ticketsByRef.get(ticketId.toLowerCase());
+    return {
+      ticketId: ticket?.id ?? ticketId,
+      ticketNumber: ticket?.ticketNumber ?? null,
+      ticketTitle: ticket?.title ?? null,
+      count: count2
+    };
+  }).sort((a6, b7) => b7.count - a6.count).slice(0, TOP_ENTITIES);
   const byProject = [...byProjectMap.entries()].map(([projectId, count2]) => ({
     projectId,
     projectName: projectsById.get(projectId) ?? null,
@@ -129070,6 +129762,9 @@ async function handleGetRefrontMcpActivity(input) {
   );
   const timeline = rows.slice(0, pageSize).map((r6) => {
     const projectId = projectOf(r6);
+    const ticket = lookupResolvedTicket(ticketsByRef, r6.entity);
+    const ticketId = ticket?.id ?? r6.entity.ticketId ?? null;
+    const ticketNumber = ticket?.ticketNumber ?? r6.entity.ticketNumber ?? null;
     return {
       timestamp: formatIsoWithOffset(new Date(r6.tsUtc), timezone),
       timestampUtc: r6.tsUtc,
@@ -129078,8 +129773,8 @@ async function handleGetRefrontMcpActivity(input) {
       success: r6.success,
       durationMs: r6.durationMs,
       actor: { id: r6.userId, name: r6.userId ? usersById.get(r6.userId) ?? null : null },
-      ticketId: r6.entity.ticketId ?? null,
-      ticketNumber: r6.entity.ticketId ? ticketsById.get(r6.entity.ticketId)?.ticketNumber ?? null : null,
+      ticketId,
+      ticketNumber,
       project: projectId ? { id: projectId, name: projectsById.get(projectId) ?? null } : null,
       entity: r6.entity,
       ...r6.error ? { error: r6.error } : {}
@@ -129409,7 +130104,7 @@ var DEFAULT_PAGE_SIZE4 = 200;
 var MAX_PAGE_SIZE4 = 500;
 var MAX_TIMELINE_SOURCE = 2e3;
 var COMMENT_PREVIEW_LENGTH2 = 140;
-var UUID_RE2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var UUID_RE3 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var STATUS_TRANSITION_TYPES = /* @__PURE__ */ new Set(["status_changed", "status_change"]);
 var DISCLAIMER3 = "Cycle-time and interaction signals are supporting context, not an exact measure of worked time. Time-in-status includes nights/weekends and idle waiting; interpret with ticket complexity, blockers, reviews and dependencies.";
 function textResponse17(text3) {
@@ -129449,9 +130144,9 @@ async function handleGetTicketInteractionTimeline(input) {
   if (scope.teamIds.length === 0) {
     return textResponse17("No accessible teams found.");
   }
-  const isUuid2 = UUID_RE2.test(rawTicket);
+  const isUuid3 = UUID_RE3.test(rawTicket);
   const idBranches = [eq(schema_exports.tickets.ticketNumber, rawTicket)];
-  if (isUuid2) idBranches.push(eq(schema_exports.tickets.id, rawTicket));
+  if (isUuid3) idBranches.push(eq(schema_exports.tickets.id, rawTicket));
   const [ticket] = await db.select({
     id: schema_exports.tickets.id,
     teamId: schema_exports.tickets.teamId,
@@ -130009,6 +130704,22 @@ function createMcpServer() {
             return await handleCreateProject(asToolArgs(toolArgs));
           case "update-project":
             return await handleUpdateProject(asToolArgs(toolArgs));
+          case "get-project-tags":
+            return await handleGetProjectTags(
+              asToolArgs(toolArgs)
+            );
+          case "set-project-tags":
+            return await handleSetProjectTags(
+              asToolArgs(toolArgs)
+            );
+          case "add-project-tag":
+            return await handleAddProjectTag(
+              asToolArgs(toolArgs)
+            );
+          case "remove-project-tag":
+            return await handleRemoveProjectTag(
+              asToolArgs(toolArgs)
+            );
           case "archive-project":
             return await handleArchiveProject(
               asToolArgs(toolArgs)