@firfi/huly-mcp 0.38.0 → 0.39.0

package/README.md

@@ -1,13 +1,14 @@
-# @firfi/huly-mcp
+# Huly MCP
 
 [![npm](https://img.shields.io/npm/v/@firfi/huly-mcp)](https://www.npmjs.com/package/@firfi/huly-mcp)
 [![npm downloads](https://img.shields.io/npm/dm/@firfi/huly-mcp)](https://www.npmjs.com/package/@firfi/huly-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg)](https://www.typescriptlang.org/)
+[![Glama score](https://glama.ai/mcp/servers/@dearlordylord/huly-mcp/badges/score.svg)](https://glama.ai/mcp/servers/@dearlordylord/huly-mcp)
 [![MCP Server](https://badge.mcpx.dev?type=server&features=tools)](https://github.com/dearlordylord/huly-mcp)[![cooked at Monadical](https://img.shields.io/endpoint?url=https://monadical.com/static/api/cooked-at-monadical.json)](https://monadical.com)
 
-MCP server for [Huly](https://huly.io/) integration.
+**Huly MCP** is a feature-complete MCP server for [Huly](https://huly.io/) integration. Published on npm as [`@firfi/huly-mcp`](https://www.npmjs.com/package/@firfi/huly-mcp).
 
 ## Installation
 

package/dist/index.cjs

@@ -73778,7 +73778,7 @@ var require_index_cjs4 = __commonJS({
           let canOpen = true;
           let canClose = true;
           pos = t.index + 1;
-          const isSingle2 = t[0] === "'";
+          const isSingle3 = t[0] === "'";
           let lastChar = 32;
           if (t.index - 1 >= 0) {
             lastChar = text2.charCodeAt(t.index - 1);
@@ -73829,7 +73829,7 @@ var require_index_cjs4 = __commonJS({
             canClose = isNextPunctChar;
           }
           if (!canOpen && !canClose) {
-            if (isSingle2) {
+            if (isSingle3) {
               token.content = replaceAt(token.content, t.index, APOSTROPHE);
             }
             continue;
@@ -73840,11 +73840,11 @@ var require_index_cjs4 = __commonJS({
               if (stack[j].level < thisLevel) {
                 break;
               }
-              if (item.single === isSingle2 && stack[j].level === thisLevel) {
+              if (item.single === isSingle3 && stack[j].level === thisLevel) {
                 item = stack[j];
                 let openQuote;
                 let closeQuote;
-                if (isSingle2) {
+                if (isSingle3) {
                   openQuote = state.md.options.quotes[2];
                   closeQuote = state.md.options.quotes[3];
                 } else {
@@ -73868,10 +73868,10 @@ var require_index_cjs4 = __commonJS({
             stack.push({
               token: i,
               pos: t.index,
-              single: isSingle2,
+              single: isSingle3,
               level: thisLevel
             });
-          } else if (canClose && isSingle2) {
+          } else if (canClose && isSingle3) {
             token.content = replaceAt(token.content, t.index, APOSTROPHE);
           }
         }
@@ -158094,6 +158094,30 @@ var validatePersonUuid = (uuid5) => {
 var import_promises = require("node:dns/promises");
 var http = __toESM(require("node:http"), 1);
 var https = __toESM(require("node:https"), 1);
+
+// src/utils/assertions.ts
+var AssertionError = class extends Error {
+  _tag = "AssertionError";
+  constructor(message) {
+    super(message);
+    this.name = "AssertionError";
+  }
+};
+var assertExists = (value3, message) => {
+  if (value3 === null || value3 === void 0) {
+    throw new AssertionError(message ?? "Expected value to exist");
+  }
+  return value3;
+};
+var isExistent = (value3) => value3 !== null && value3 !== void 0;
+var assertAt = (arr, index, message) => {
+  return assertExists(arr[index], message ?? `Expected array item at index ${index}`);
+};
+var isNonEmpty7 = (arr) => arr.length > 0;
+var isSingle2 = (arr) => arr.length === 1;
+var isPair = (arr) => arr.length === 2;
+
+// src/huly/url-fetch.ts
 var FETCH_TIMEOUT_MS = 3e4;
 var HTTP_PROTOCOLS = /* @__PURE__ */ new Set(["http:", "https:"]);
 var IPV4_OCTET_COUNT = 4;
@@ -158150,10 +158174,14 @@ var parseIpv4Address = (hostname3) => {
     return null;
   }
   const octets = parts2.map(Number);
+  const a = assertAt(octets, 0);
+  const b = assertAt(octets, 1);
+  const c = assertAt(octets, 2);
+  const d = assertAt(octets, 3);
   if (octets.some((octet) => !Number.isInteger(octet) || octet < 0 || octet > IPV4_MAX_OCTET)) {
     return null;
   }
-  return [octets[0], octets[1], octets[2], octets[3]];
+  return [a, b, c, d];
 };
 var isBlockedIpv4Address = ([a, b, c]) => {
   if (a === 0) return true;
@@ -158178,8 +158206,10 @@ var ipv4FromMappedIpv6Hextets = (hostname3) => {
   if (match16 === null) {
     return null;
   }
-  const high = Number.parseInt(match16[1], 16);
-  const low = Number.parseInt(match16[2], 16);
+  const highText = assertAt(match16, 1);
+  const lowText = assertAt(match16, 2);
+  const high = Number.parseInt(highText, 16);
+  const low = Number.parseInt(lowText, 16);
   return [
     Math.floor(high / BYTE_BASE),
     high % BYTE_BASE,
@@ -158204,6 +158234,17 @@ var parseIpv6Side = (value3) => {
   });
   return hextets.length === parts2.length ? hextets : null;
 };
+var isIpv6Hextets = (hextets) => hextets.length === IPV6_HEXTET_COUNT;
+var toIpv6Hextets = (hextets) => [
+  assertAt(hextets, 0),
+  assertAt(hextets, 1),
+  assertAt(hextets, 2),
+  assertAt(hextets, 3),
+  assertAt(hextets, 4),
+  assertAt(hextets, 5),
+  assertAt(hextets, 6),
+  assertAt(hextets, 7)
+];
 var parseIpv6Hextets = (hostname3) => {
   if (hostname3.includes(".")) {
     return null;
@@ -158212,26 +158253,29 @@ var parseIpv6Hextets = (hostname3) => {
   if (compressedParts.length > 2) {
     return null;
   }
-  const left3 = parseIpv6Side(compressedParts[0]);
-  const right3 = compressedParts.length === 2 ? parseIpv6Side(compressedParts[1]) : [];
+  const leftText = assertAt(compressedParts, 0);
+  const left3 = parseIpv6Side(leftText);
+  const right3 = compressedParts.length === 2 ? parseIpv6Side(assertAt(compressedParts, 1)) : [];
   if (left3 === null || right3 === null) {
     return null;
   }
   if (compressedParts.length === 1) {
-    return left3.length === IPV6_HEXTET_COUNT ? left3 : null;
+    return isIpv6Hextets(left3) ? left3 : null;
   }
   const zeroCount = IPV6_HEXTET_COUNT - left3.length - right3.length;
   if (zeroCount < 1) {
     return null;
   }
-  return [...left3, ...Array.from({ length: zeroCount }, () => 0), ...right3];
+  const hextets = [...left3, ...Array.from({ length: zeroCount }, () => 0), ...right3];
+  return toIpv6Hextets(hextets);
 };
 var isIpv6InPrefix = (hextets, prefix) => {
   const fullHextetCount = Math.floor(prefix.prefixLength / IPV6_HEXTET_BITS);
   const remainingBits = prefix.prefixLength % IPV6_HEXTET_BITS;
   let index = 0;
   for (const prefixHextet2 of prefix.hextets.slice(0, fullHextetCount)) {
-    if (hextets[index] !== prefixHextet2) {
+    const addressHextet2 = assertAt(hextets, index);
+    if (addressHextet2 !== prefixHextet2) {
       return false;
     }
     index += 1;
@@ -158239,8 +158283,8 @@ var isIpv6InPrefix = (hextets, prefix) => {
   if (remainingBits === 0) {
     return true;
   }
-  const prefixHextet = prefix.hextets[fullHextetCount];
-  const addressHextet = hextets[fullHextetCount];
+  const prefixHextet = assertAt(prefix.hextets, fullHextetCount);
+  const addressHextet = assertAt(hextets, fullHextetCount);
   const mask = IPV6_HEXTET_MAX << IPV6_HEXTET_BITS - remainingBits & IPV6_HEXTET_MAX;
   return (addressHextet & mask) === (prefixHextet & mask);
 };
@@ -158248,7 +158292,7 @@ var requestFirstSuccessfulAddress = async (url4, dependencies, addresses, index
   if (index >= addresses.length) {
     throw new Error(`Request failed for all resolved addresses: ${failures3.join("; ")}`);
   }
-  const address = addresses[index];
+  const address = assertAt(addresses, index);
   try {
     return await dependencies.requestUrl(url4, address);
   } catch (error2) {
@@ -168592,8 +168636,9 @@ var mapParseCauseToMcp = (cause3, toolName) => {
     return mapParseErrorToMcp(cause3.error, toolName);
   }
   const failures3 = Chunk_exports.toArray(Cause_exports.failures(cause3));
-  if (failures3.length > 0) {
-    return mapParseErrorToMcp(failures3[0], toolName);
+  const firstFailure = failures3[0];
+  if (firstFailure !== void 0) {
+    return mapParseErrorToMcp(firstFailure, toolName);
   }
   return createErrorResponse("An unexpected error occurred", McpErrorCode.InternalError);
 };
@@ -168605,8 +168650,9 @@ var mapDomainCauseToMcp = (cause3, warnings = []) => {
     return createErrorResponse("An unexpected error occurred", McpErrorCode.InternalError, "UnexpectedError", warnings);
   }
   const failures3 = Chunk_exports.toArray(Cause_exports.failures(cause3));
-  if (failures3.length > 0) {
-    return mapDomainErrorToMcp(failures3[0], warnings);
+  const firstFailure = failures3[0];
+  if (firstFailure !== void 0) {
+    return mapDomainErrorToMcp(firstFailure, warnings);
   }
   return createErrorResponse("An unexpected error occurred", McpErrorCode.InternalError, void 0, warnings);
 };
@@ -168688,7 +168734,7 @@ var httpStatusForErrorCode = (code) => {
 var acceptsModernResponseTypes = (req) => {
   const accept = firstHeader(req.headers.accept);
   if (accept === void 0) return false;
-  const parts2 = accept.split(",").map((part) => part.split(";")[0].trim().toLowerCase());
+  const parts2 = accept.split(",").map((part) => (part.split(";")[0] ?? "").trim().toLowerCase());
   return parts2.includes("application/json") && parts2.includes("text/event-stream");
 };
 var validateJsonRpcRequest = (body) => {
@@ -178446,10 +178492,44 @@ var makeDiagnosticsScope = Effect_exports.gen(function* () {
 });
 
 // src/version.ts
-var VERSION = true ? "0.38.0" : "0.0.0-dev";
+var VERSION = true ? "0.39.0" : "0.0.0-dev";
+
+// src/mcp/json-schema-refs.ts
+var isJsonObject = (value3) => typeof value3 === "object" && value3 !== null && !Array.isArray(value3);
+var mergeDefinitionRecords = (definitions) => {
+  const merged = definitions.reduce(
+    (acc, definition) => definition === void 0 ? acc : { ...acc, ...definition },
+    {}
+  );
+  return Object.keys(merged).length > 0 ? merged : void 0;
+};
+var collectJsonSchemaDefinitions = (value3) => {
+  if (Array.isArray(value3)) {
+    return mergeDefinitionRecords(value3.map(collectJsonSchemaDefinitions));
+  }
+  if (!isJsonObject(value3)) return void 0;
+  const ownDefinitions = isJsonObject(value3.$defs) ? value3.$defs : void 0;
+  const nestedDefinitions = Object.entries(value3).filter(([key]) => key !== "$defs").map(([, nested6]) => collectJsonSchemaDefinitions(nested6));
+  return mergeDefinitionRecords([...nestedDefinitions, ownDefinitions]);
+};
+var omitJsonSchemaDocumentMetadata = (schema) => Object.fromEntries(Object.entries(schema).filter(([key]) => key !== "$defs" && key !== "$schema"));
 
 // src/mcp/tool-output-schema.ts
 var toolWarningCodeEnum = [...ToolWarningCodeSchema.literals];
+var wrapResultOutputSchema = (resultSchema) => {
+  const resultDefs = collectJsonSchemaDefinitions(resultSchema);
+  const resultJsonSchemaDialect = "$schema" in resultSchema ? resultSchema["$schema"] : void 0;
+  const embeddedResultSchema = omitJsonSchemaDocumentMetadata(resultSchema);
+  return {
+    ...resultJsonSchemaDialect === void 0 ? {} : { $schema: resultJsonSchemaDialect },
+    ...resultDefs === void 0 ? {} : { $defs: resultDefs },
+    type: "object",
+    properties: {
+      result: embeddedResultSchema
+    },
+    required: ["result"]
+  };
+};
 var defaultToolOutputSchema = {
   type: "object",
   properties: {
@@ -178478,27 +178558,15 @@ var defaultToolOutputSchema = {
   },
   required: ["result"]
 };
-var versionToolOutputSchema = {
+var versionToolOutputSchema = wrapResultOutputSchema({
   type: "object",
   properties: {
-    result: {
-      type: "object",
-      properties: {
-        current: { type: "string", minLength: 1 },
-        latest: { type: "string", minLength: 1 }
-      },
-      required: ["current", "latest"]
-    }
+    current: { type: "string", minLength: 1 },
+    latest: { type: "string", minLength: 1 }
   },
-  required: ["result"]
-};
-var hulyContextToolOutputSchema = {
-  type: "object",
-  properties: {
-    result: getHulyContextResultJsonSchema
-  },
-  required: ["result"]
-};
+  required: ["current", "latest"]
+});
+var hulyContextToolOutputSchema = wrapResultOutputSchema(getHulyContextResultJsonSchema);
 
 // src/huly/operations/activity-messages.ts
 var import_core11 = __toESM(require_lib5(), 1);
@@ -178799,7 +178867,7 @@ var findPersonByEmail = (client, email3) => Effect_exports.gen(function* () {
       provider: contact.channelProvider.Email
     }
   );
-  if (channels.length === 0) {
+  if (!isNonEmpty7(channels)) {
     return void 0;
   }
   const channel = channels[0];
@@ -179089,7 +179157,7 @@ var findSpace = (client, params) => Effect_exports.gen(function* () {
       }))
     });
   }
-  return matches[0];
+  return assertAt(matches, 0);
 });
 var updateSpaceDoc = (client, space, operations) => client.updateDoc(
   toClassRef(space._class),
@@ -179299,7 +179367,8 @@ var findDirectMessage = (identifier2) => Effect_exports.gen(function* () {
   if (matches.length > 1) {
     return yield* new DirectMessageIdentifierAmbiguousError({ identifier: identifier2, matches: Count.make(matches.length) });
   }
-  return { client, dm: matches[0] };
+  if (isSingle2(matches)) return { client, dm: matches[0] };
+  return yield* new DirectMessageNotFoundError({ identifier: identifier2 });
 });
 var createDirectMessageSpace = (client, members) => Effect_exports.gen(function* () {
   const dmId = (0, import_core14.generateId)();
@@ -180346,9 +180415,13 @@ var parseIssueIdentifier = (identifier2, projectIdentifier) => {
   const idStr = String(identifier2).trim();
   const match16 = idStr.match(/^([A-Z]+)-(\d+)$/i);
   if (match16) {
+    const [, projectPrefix, issueNumber] = match16;
+    if (projectPrefix === void 0 || issueNumber === void 0) {
+      return { fullIdentifier: `${projectIdentifier}-${idStr}`, number: null };
+    }
     return {
-      fullIdentifier: `${match16[1].toUpperCase()}-${match16[2]}`,
-      number: parseInt(match16[2], 10)
+      fullIdentifier: `${projectPrefix.toUpperCase()}-${issueNumber}`,
+      number: parseInt(issueNumber, 10)
     };
   }
   const numMatch = idStr.match(/^\d+$/);
@@ -181566,12 +181639,12 @@ var resolveBoard = (client, identifier2, options = {}) => Effect_exports.gen(fun
     board.class.Board,
     hulyQuery({ ...baseQuery, _id: toRef(identifier2) })
   );
-  if (idMatches.length > 0) return idMatches[0];
+  if (isNonEmpty7(idMatches)) return idMatches[0];
   const nameMatches = yield* client.findAll(
     board.class.Board,
     hulyQuery({ ...baseQuery, name: identifier2 })
   );
-  if (nameMatches.length === 1) return nameMatches[0];
+  if (isSingle2(nameMatches)) return nameMatches[0];
   if (nameMatches.length > 1) {
     return yield* new BoardIdentifierAmbiguousError({ identifier: identifier2, matches: nameMatches.length });
   }
@@ -181587,7 +181660,7 @@ var resolveBoardProjectType = (client, projectTypeRef) => Effect_exports.gen(fun
   const matches = projectTypeRef === void 0 ? projectTypes.filter(isBoardProjectType) : projectTypes.filter(
     (projectType) => isBoardProjectType(projectType) && (projectType._id === projectTypeRef || projectType.name === projectTypeRef)
   );
-  if (matches.length === 1) return matches[0];
+  if (isSingle2(matches)) return matches[0];
   const identifier2 = projectTypeRef ?? String(board.descriptors.BoardType);
   if (matches.length === 0) return yield* new BoardProjectTypeNotFoundError({ identifier: identifier2 });
   return yield* new BoardProjectTypeIdentifierAmbiguousError({ identifier: identifier2, matches: matches.length });
@@ -181617,7 +181690,7 @@ var resolveBoardTaskType = (client, resolvedBoard, projectType, taskTypeRef) =>
   const taskTypes = yield* getBoardTaskTypes(client, projectType);
   const matches = taskTypeRef === void 0 ? taskTypes.filter(isBoardCardTaskType) : taskTypes.filter((taskType) => taskType._id === taskTypeRef || taskType.name === taskTypeRef);
   const fallbackMatches = taskTypeRef === void 0 && matches.length === 0 && taskTypes.length === 1 ? taskTypes : matches;
-  if (fallbackMatches.length === 1) return fallbackMatches[0];
+  if (isSingle2(fallbackMatches)) return fallbackMatches[0];
   const identifier2 = taskTypeRef ?? "default board card task type";
   if (fallbackMatches.length === 0) {
     return yield* new BoardTaskTypeNotFoundError({ identifier: identifier2, board: resolvedBoard.name });
@@ -181646,7 +181719,7 @@ var getBoardWorkflowStatuses = (client, projectType, taskType) => Effect_exports
 var resolveBoardStatus = (client, resolvedBoard, projectType, taskType, statusRef) => Effect_exports.gen(function* () {
   const statuses = yield* getBoardWorkflowStatuses(client, projectType, taskType);
   const matches = statusRef === void 0 ? statuses.slice(0, 1) : statuses.filter((status) => status.id === statusRef || status.name === statusRef);
-  if (matches.length === 1) return matches[0];
+  if (isSingle2(matches)) return matches[0];
   const identifier2 = statusRef ?? "default board card status";
   if (matches.length === 0) return yield* new BoardStatusNotFoundError({ identifier: identifier2, board: resolvedBoard.name });
   return yield* new BoardStatusIdentifierAmbiguousError({
@@ -181726,14 +181799,14 @@ var resolveBoardCard = (client, resolvedBoard, identifier2) => Effect_exports.ge
     board.class.Card,
     hulyQuery({ space, _id: toRef(identifier2) })
   );
-  if (idMatches.length > 0) return idMatches[0];
+  if (isNonEmpty7(idMatches)) return idMatches[0];
   const number8 = boardCardNumber(identifier2);
   if (number8 !== void 0) {
     const numberMatches = yield* client.findAll(
       board.class.Card,
       hulyQuery({ space, number: number8 })
     );
-    if (numberMatches.length === 1) return numberMatches[0];
+    if (isSingle2(numberMatches)) return numberMatches[0];
     if (numberMatches.length > 1) {
       return yield* new BoardCardIdentifierAmbiguousError({
         identifier: identifier2,
@@ -181746,7 +181819,7 @@ var resolveBoardCard = (client, resolvedBoard, identifier2) => Effect_exports.ge
     board.class.Card,
     hulyQuery({ space, title: identifier2 })
   );
-  if (titleMatches.length === 1) return titleMatches[0];
+  if (isSingle2(titleMatches)) return titleMatches[0];
   if (titleMatches.length > 1) {
     return yield* new BoardCardIdentifierAmbiguousError({
       identifier: identifier2,
@@ -181867,8 +181940,9 @@ var createBoard = (params) => Effect_exports.gen(function* () {
     board.class.Board,
     hulyQuery({ name: params.name, archived: false })
   );
-  if (existing.length === 1) {
-    return { id: BoardId.make(existing[0]._id), name: BoardName.make(existing[0].name), created: false };
+  if (isSingle2(existing)) {
+    const boardDoc = existing[0];
+    return { id: BoardId.make(boardDoc._id), name: BoardName.make(boardDoc.name), created: false };
   }
   if (existing.length > 1) {
     return yield* new BoardIdentifierAmbiguousError({ identifier: params.name, matches: existing.length });
@@ -182508,24 +182582,6 @@ var import_core29 = __toESM(require_lib5(), 1);
 var import_core28 = __toESM(require_lib5(), 1);
 var import_rank3 = __toESM(require_lib35(), 1);
 var import_time2 = __toESM(require_lib38(), 1);
-
-// src/utils/assertions.ts
-var AssertionError = class extends Error {
-  _tag = "AssertionError";
-  constructor(message) {
-    super(message);
-    this.name = "AssertionError";
-  }
-};
-var assertExists = (value3, message) => {
-  if (value3 === null || value3 === void 0) {
-    throw new AssertionError(message ?? "Expected value to exist");
-  }
-  return value3;
-};
-var isExistent = (value3) => value3 !== null && value3 !== void 0;
-
-// src/huly/operations/planner-shared.ts
 var todoLookup = {
   user: contact.class.Person,
   attachedTo: tracker.class.Issue
@@ -182684,7 +182740,7 @@ var findTodo = (client, locator, defaultCompletionState = "open") => Effect_expo
   if (todos.length > 1) {
     return yield* new TodoIdentifierAmbiguousError({ locator: describeLocator(locator), matches: todos.length });
   }
-  return todos[0];
+  return assertAt(todos, 0);
 });
 var todoOwnerSummary = (todo, emailByPersonId) => {
   const ownerId = toRef(todo.user);
@@ -182700,11 +182756,14 @@ var todoAttachmentSummary = (todo) => {
   if (todo.attachedTo === time.ids.NotAttached) return { type: "none" };
   const issue2 = todo.$lookup?.attachedTo;
   if (todo.attachedToClass === tracker.class.Issue && issue2 !== void 0) {
+    const identifier2 = IssueIdentifier.make(issue2.identifier);
+    const segments = identifier2.split("-");
+    const project3 = assertAt(segments, 0);
     return {
       type: "issue",
       id: IssueId.make(issue2._id),
-      project: ProjectIdentifier.make(IssueIdentifier.make(issue2.identifier).split("-")[0]),
-      identifier: IssueIdentifier.make(issue2.identifier),
+      project: ProjectIdentifier.make(project3),
+      identifier: identifier2,
       title: attachmentTitleOrFallback(issue2.title, issue2.identifier)
     };
   }
@@ -183381,7 +183440,7 @@ var HULY_MODEL_ID_SEPARATOR = ":";
 var FINAL_SEGMENT_OFFSET = 1;
 var hulyModelLabelTail = (value3) => {
   const segments = value3.split(HULY_MODEL_ID_SEPARATOR);
-  return segments[segments.length - FINAL_SEGMENT_OFFSET];
+  return assertAt(segments, segments.length - FINAL_SEGMENT_OFFSET);
 };
 var decodeHulyModelLabelTail = (value3) => Either_exports.flatMap(
   Schema_exports.decodeUnknownEither(Schema_exports.String)(value3),
@@ -183827,6 +183886,9 @@ var collectDescendants = (rootIds, descendantsByAncestor) => {
   let nextIndex = 0;
   while (nextIndex < pending3.length) {
     const current = pending3[nextIndex];
+    if (current === void 0) {
+      break;
+    }
     const unvisitedChildren = [...descendantsByAncestor.get(current) ?? []].filter((childId) => !visited.has(childId));
     unvisitedChildren.forEach((childId) => {
       visited.add(childId);
@@ -185357,6 +185419,28 @@ var commentTools = [
   }
 ];
 
+// src/huly/operations/contact-channel-locators.ts
+var channelIdentifier = (locator) => locator._tag === "channelId" ? locator.channelId : `${locator.provider}:${locator.value}`;
+var INVALID_CHANNEL_LOCATOR_REASON = "provide exactly one channel locator: channelId, or provider plus value";
+var validateProviderValue = (provider, value3) => value3.length === 0 || provider === "email" && !Schema_exports.is(Email)(value3) ? Effect_exports.fail(new InvalidContactChannelValueError({ provider, value: value3 })) : Effect_exports.void;
+var validateChannelLocator2 = (ownerIdentifier, locator) => Effect_exports.gen(function* () {
+  const hasChannelId = locator.channelId !== void 0;
+  const hasProvider = locator.provider !== void 0;
+  const hasValue = locator.value !== void 0;
+  if (hasChannelId && !hasProvider && !hasValue) {
+    return { _tag: "channelId", channelId: ChannelId.make(locator.channelId) };
+  }
+  if (!hasChannelId && hasProvider && hasValue) {
+    yield* validateProviderValue(locator.provider, locator.value);
+    return { _tag: "providerValue", provider: locator.provider, value: locator.value };
+  }
+  return yield* new InvalidContactChannelLocatorError({
+    ownerIdentifier,
+    reason: INVALID_CHANNEL_LOCATOR_REASON
+  });
+});
+var requireChannelUpdateFields = (params) => params.newProvider === void 0 && params.newValue === void 0 ? Effect_exports.fail(new NoUpdateFieldsError({ operation: "update_contact_channel", fields: ["newProvider", "newValue"] })) : Effect_exports.void;
+
 // src/huly/operations/contact-channel-providers.ts
 var CONTACT_CHANNEL_PROVIDER_SDK_KEYS = ContactChannelProviderSdkKeys;
 var exactChannelProviderSdkKeys = (value3) => value3;
@@ -185401,13 +185485,11 @@ var channelSummaryWithValue = (channel, provider, value3) => ({
 
 // src/huly/operations/organization-resolvers.ts
 var findOrganizationByIdentifier = (client, identifier2) => Effect_exports.gen(function* () {
-  const byId = Option_exports.fromNullable(
-    yield* client.findOne(
-      contact.class.Organization,
-      hulyQuery({ _id: toRef(identifier2) })
-    )
+  const byId = yield* client.findOne(
+    contact.class.Organization,
+    hulyQuery({ _id: toRef(identifier2) })
   );
-  if (Option_exports.isSome(byId)) return byId;
+  if (byId !== void 0) return Option_exports.some(byId);
   const byName = yield* client.findAll(
     contact.class.Organization,
     hulyQuery({ name: identifier2 })
@@ -185419,7 +185501,8 @@ var findOrganizationByIdentifier = (client, identifier2) => Effect_exports.gen(f
       matches: Count.make(byName.length)
     });
   }
-  return Option_exports.some(byName[0]);
+  if (isSingle2(byName)) return Option_exports.some(byName[0]);
+  return Option_exports.none();
 });
 var resolveOrganizationByIdentifier = (client, identifier2) => Effect_exports.flatMap(findOrganizationByIdentifier(client, identifier2), (organization) => Option_exports.match(organization, {
   onNone: () => Effect_exports.fail(new OrganizationNotFoundError({ identifier: identifier2 })),
@@ -185456,28 +185539,7 @@ var resolveOrganizationOwner = (client, identifier2) => Effect_exports.gen(funct
   return { id: org._id, ownerClass: contact.class.Organization, identifier: identifier2 };
 });
 
-// src/huly/operations/contact-channels.ts
-var listContactChannelProviders = () => Effect_exports.succeed(listContactChannelProviderLabels());
-var channelIdentifier = (locator) => locator._tag === "channelId" ? locator.channelId : `${locator.provider}:${locator.value}`;
-var INVALID_CHANNEL_LOCATOR_REASON = "provide exactly one channel locator: channelId, or provider plus value";
-var validateProviderValue = (provider, value3) => value3.length === 0 || provider === "email" && !Schema_exports.is(Email)(value3) ? Effect_exports.fail(new InvalidContactChannelValueError({ provider, value: value3 })) : Effect_exports.void;
-var validateChannelLocator2 = (ownerIdentifier, locator) => Effect_exports.gen(function* () {
-  const hasChannelId = locator.channelId !== void 0;
-  const hasProvider = locator.provider !== void 0;
-  const hasValue = locator.value !== void 0;
-  if (hasChannelId && !hasProvider && !hasValue) {
-    return { _tag: "channelId", channelId: ChannelId.make(locator.channelId) };
-  }
-  if (!hasChannelId && hasProvider && hasValue) {
-    yield* validateProviderValue(locator.provider, locator.value);
-    return { _tag: "providerValue", provider: locator.provider, value: locator.value };
-  }
-  return yield* new InvalidContactChannelLocatorError({
-    ownerIdentifier,
-    reason: INVALID_CHANNEL_LOCATOR_REASON
-  });
-});
-var requireChannelUpdateFields = (params) => params.newProvider === void 0 && params.newValue === void 0 ? Effect_exports.fail(new NoUpdateFieldsError({ operation: "update_contact_channel", fields: ["newProvider", "newValue"] })) : Effect_exports.void;
+// src/huly/operations/contact-channel-queries.ts
 var findChannelsForOwner = (client, owner) => client.findAll(
   contact.class.Channel,
   hulyQuery({
@@ -185505,6 +185567,9 @@ var findChannelByIdForOwner = (client, owner, channelId) => Effect_exports.map(
   ),
   Option_exports.fromNullable
 );
+
+// src/huly/operations/contact-channels.ts
+var listContactChannelProviders = () => Effect_exports.succeed(listContactChannelProviderLabels());
 var resolveChannelByLocator = (client, owner, locator) => Effect_exports.gen(function* () {
   if (locator._tag === "channelId") {
     return yield* Effect_exports.flatMap(findChannelByIdForOwner(client, owner, locator.channelId), (channel) => Option_exports.match(channel, {
@@ -185531,7 +185596,7 @@ var resolveChannelByLocator = (client, owner, locator) => Effect_exports.gen(fun
       matches: Count.make(matches.length)
     });
   }
-  return matches[0];
+  return assertAt(matches, 0);
 });
 var findRemovableChannel = (client, owner, locator) => Effect_exports.gen(function* () {
   if (locator._tag === "channelId") {
@@ -185565,7 +185630,7 @@ var listOwnerChannels = (client, owner) => Effect_exports.gen(function* () {
 var addOwnerChannel = (client, owner, params) => Effect_exports.gen(function* () {
   yield* validateProviderValue(params.provider, params.value);
   const existing = yield* findExactChannels(client, owner, params.provider, params.value);
-  if (existing.length > 0) {
+  if (isNonEmpty7(existing)) {
     return { added: false, channel: yield* channelSummary(existing[0]) };
   }
   const channelId = yield* client.addCollection(
@@ -185932,8 +185997,9 @@ var formatName = (firstName, lastName) => `${lastName},${firstName}`;
 var parseName = (name) => {
   const parts2 = name.split(",");
   const FIRST_LAST_PARTS = 2;
-  if (parts2.length >= FIRST_LAST_PARTS) {
-    return { lastName: parts2[0], firstName: parts2.slice(1).join(",") };
+  const [lastName, ...firstNameParts] = parts2;
+  if (lastName !== void 0 && parts2.length >= FIRST_LAST_PARTS) {
+    return { lastName, firstName: firstNameParts.join(",") };
   }
   return { firstName: name, lastName: "" };
 };
@@ -187056,7 +187122,7 @@ var findSnapshotByIdentifier = (client, doc, identifier2) => Effect_exports.gen(
     hulyQuery({ attachedTo: doc._id, title: identifier2 }),
     { limit: 2 }
   );
-  if (titleMatches.length === 1) return titleMatches[0];
+  if (isSingle2(titleMatches)) return titleMatches[0];
   if (titleMatches.length > 1) {
     return yield* new HulyError({
       message: `Multiple snapshots on document '${doc.title}' have title '${identifier2}'. Use the snapshotId from list_document_snapshots.`
@@ -187068,7 +187134,7 @@ var findSnapshotByIdentifier = (client, doc, identifier2) => Effect_exports.gen(
     hulyQuery({ attachedTo: doc._id, createdOn }),
     { limit: 2 }
   ) : [];
-  if (dateMatches.length === 1) return dateMatches[0];
+  if (isSingle2(dateMatches)) return dateMatches[0];
   if (dateMatches.length > 1) {
     return yield* new HulyError({
       message: `Multiple snapshots on document '${doc.title}' have createdOn '${identifier2}'. Use the snapshotId from list_document_snapshots.`
@@ -187389,7 +187455,7 @@ var resolveDrive = (client, identifier2) => Effect_exports.gen(function* () {
   );
   if (byId !== void 0) return byId;
   const byName = yield* client.findAll(drive.class.Drive, hulyQuery({ name: identifier2 }));
-  if (byName.length === 1) return byName[0];
+  if (isSingle2(byName)) return byName[0];
   if (byName.length > 1) {
     return yield* Effect_exports.fail(
       new DriveIdentifierAmbiguousError({
@@ -187426,10 +187492,16 @@ var resolvePath = (client, driveSpace, path2) => Effect_exports.gen(function* ()
         })
       );
     }
-    current = candidates[0];
-    currentPath = childPath(currentPath, current.title);
+    if (!isSingle2(candidates)) {
+      return yield* Effect_exports.fail(
+        new DrivePathNotFoundError({ drive: driveSpace.name, path: childPath(currentPath, segment) })
+      );
+    }
+    const currentItem = candidates[0];
+    current = currentItem;
+    currentPath = childPath(currentPath, currentItem.title);
     if (segment !== lastSegment) {
-      if (!isFolder(current)) {
+      if (!isFolder(currentItem)) {
         return yield* Effect_exports.fail(
           new DriveParentNotFolderError({
             drive: driveSpace.name,
@@ -187438,7 +187510,7 @@ var resolvePath = (client, driveSpace, path2) => Effect_exports.gen(function* ()
           })
         );
       }
-      parent = current._id;
+      parent = currentItem._id;
     }
   }
   return { item: current, path: currentPath };
@@ -187524,7 +187596,7 @@ var ensureFolderPath = (client, driveSpace, driveIdentifier, path2) => Effect_ex
         })
       );
     }
-    if (matches.length === 1) {
+    if (isSingle2(matches)) {
       const existing = matches[0];
       if (!isFolder(existing)) {
         return yield* Effect_exports.fail(
@@ -188224,17 +188296,22 @@ var uploadDriveFile = (params) => Effect_exports.gen(function* () {
   const storage = yield* HulyStorageClient;
   const driveSpace = yield* resolveDrive(client, params.drive);
   const normalized = normalizeDrivePath(params.path);
-  if (normalized.segments.length === 0) {
+  if (!isNonEmpty7(normalized.segments)) {
+    return yield* Effect_exports.fail(
+      new DrivePathConflictError({ drive: params.drive, path: normalized.path, existingKind: "folder" })
+    );
+  }
+  const title = normalized.segments.at(-1);
+  if (title === void 0) {
     return yield* Effect_exports.fail(
       new DrivePathConflictError({ drive: params.drive, path: normalized.path, existingKind: "folder" })
     );
   }
-  const title = normalized.segments[normalized.segments.length - 1];
   const parentPath = parentPathOf(normalized);
   const createParents = params.createParents ?? DEFAULT_DRIVE_CREATE_PARENTS;
   const parent = createParents ? yield* ensureFolderPath(client, driveSpace, params.drive, parentPath) : yield* resolveExistingParentFolder(client, driveSpace, params.drive, normalized, parentPath);
   const existing = yield* findChildrenByTitle(client, driveSpace, parent.folder?._id ?? drive.ids.Root, title);
-  if (existing.length > 0) {
+  if (isNonEmpty7(existing)) {
     const existingItem = existing[0];
     return yield* Effect_exports.fail(
       new DrivePathConflictError({
@@ -188782,14 +188859,15 @@ var resolveAssociation = (client, identifier2, filters) => Effect_exports.gen(fu
     )
   );
   const rolePair = identifier2.split(" -> ");
-  if (rolePair.length === 2) {
+  if (isPair(rolePair)) {
+    const [nameA, nameB] = rolePair;
     addCandidates(
       yield* client.findAll(
         core.class.Association,
         hulyQuery({
           ...associationClassFilterQuery(filters),
-          nameA: rolePair[0],
-          nameB: rolePair[1]
+          nameA,
+          nameB
         }),
         { limit: ASSOCIATION_LOOKUP_AMBIGUITY_LIMIT }
       )
@@ -188805,7 +188883,7 @@ var resolveAssociation = (client, identifier2, filters) => Effect_exports.gen(fu
       candidates: candidates.map(toCandidate)
     });
   }
-  return candidates[0];
+  return assertAt(candidates, 0);
 });
 var rejectSystemClass = (className, operation) => isSystemClassName(String(className)) ? Effect_exports.fail(new AssociationSystemClassUnsupportedError({ className, operation })) : Effect_exports.void;
 var systemClassInAssociation = (association) => {
@@ -189084,7 +189162,8 @@ var resolveIssueLocator = (locator, field) => Effect_exports.gen(function* () {
   }
   const match16 = String(locator.issue).match(/^([A-Z]+)-\d+$/i);
   if (match16 !== null) {
-    const { client, project: project3 } = yield* findProject(match16[1].toUpperCase());
+    const projectIdentifier = assertAt(match16, 1);
+    const { client, project: project3 } = yield* findProject(projectIdentifier.toUpperCase());
     const issue2 = yield* findIssueInProject(client, project3, locator.issue);
     return resolvedSummary(issue2, "issue");
   }
@@ -189124,7 +189203,7 @@ var resolveDocumentWithoutTeamspace = (client, identifier2, field) => Effect_exp
       }))
     });
   }
-  return resolvedSummary(byTitle[0], "document");
+  return resolvedSummary(assertAt(byTitle, 0), "document");
 });
 var findCardById = (client, identifier2) => client.findOne(
   cardPlugin.class.Card,
@@ -189161,7 +189240,7 @@ var findCardSpace2 = (client, identifier2, field) => Effect_exports.gen(function
       }))
     });
   }
-  return byName[0];
+  return assertAt(byName, 0);
 });
 var resolveCardInSpace = (client, identifier2, cardSpace, field) => Effect_exports.gen(function* () {
   const byId = yield* client.findOne(
@@ -189194,7 +189273,7 @@ var resolveCardInSpace = (client, identifier2, cardSpace, field) => Effect_expor
       }))
     });
   }
-  return resolvedSummary(byTitle[0], "card");
+  return resolvedSummary(assertAt(byTitle, 0), "card");
 });
 var resolveCardLocator = (client, locator, field) => Effect_exports.gen(function* () {
   if (locator.cardSpace !== void 0) {
@@ -189673,12 +189752,20 @@ var deleteRelation = (params) => Effect_exports.gen(function* () {
   if (matches.length > 1) {
     return yield* new RelationIdentifierAmbiguousError({
       identifier: `${params.association}/${endpoints.docA.id}/${endpoints.docB.id}`,
-      relationIds: matches.map((relation) => RelationId.make(relation._id))
+      relationIds: matches.map((relation2) => RelationId.make(relation2._id))
     });
   }
-  yield* client.removeDoc(core.class.Relation, matches[0].space, matches[0]._id);
+  if (!isSingle2(matches)) {
+    return {
+      associationId: AssociationId.make(association._id),
+      deleted: false,
+      reason: "not_found"
+    };
+  }
+  const relation = matches[0];
+  yield* client.removeDoc(core.class.Relation, relation.space, relation._id);
   return {
-    relationId: RelationId.make(matches[0]._id),
+    relationId: RelationId.make(relation._id),
     associationId: AssociationId.make(association._id),
     deleted: true,
     reason: "deleted"
@@ -190543,7 +190630,7 @@ var resolveCategory = (client, identifier2, parentIdentifier) => Effect_exports.
     (parent) => ({ name: identifier2, attachedTo: parent.id })
   );
   const matches = yield* findAllCategories(client, query);
-  if (matches.length === 1) return matches[0];
+  if (isSingle2(matches)) return matches[0];
   if (matches.length > 1) {
     return yield* new InventoryCategoryIdentifierAmbiguousError({ identifier: identifier2, matches: matches.length });
   }
@@ -190560,7 +190647,7 @@ var resolveProduct = (client, identifier2, categoryIdentifier) => Effect_exports
     (category) => ({ name: identifier2, attachedTo: category._id })
   );
   const matches = yield* findAllProducts(client, query);
-  if (matches.length === 1) return matches[0];
+  if (isSingle2(matches)) return matches[0];
   if (matches.length > 1) {
     return yield* new InventoryProductIdentifierAmbiguousError({ identifier: identifier2, matches: matches.length });
   }
@@ -190578,7 +190665,7 @@ var resolveVariant = (client, identifier2, productIdentifier, categoryIdentifier
   );
   const candidates = yield* findAllVariants(client, query);
   const matches = candidates.filter((variant) => variant.name === identifier2 || variant.sku === identifier2);
-  if (matches.length === 1) return matches[0];
+  if (isSingle2(matches)) return matches[0];
   if (matches.length > 1) {
     return yield* new InventoryVariantIdentifierAmbiguousError({ identifier: identifier2, matches: matches.length });
   }
@@ -191616,7 +191703,7 @@ var blockingIssueFindOptions = {
 var resolveTargetIssue = (client, sourceProject, targetIssueStr) => Effect_exports.gen(function* () {
   const { fullIdentifier } = parseIssueIdentifier(targetIssueStr, sourceProject.identifier);
   const match16 = fullIdentifier.match(/^([A-Z]+)-\d+$/i);
-  const prefix = match16 ? match16[1].toUpperCase() : null;
+  const prefix = match16?.[1]?.toUpperCase() ?? null;
   if (prefix !== null && prefix !== sourceProject.identifier.toUpperCase()) {
     const { client: c, project: targetProject } = yield* findProject(prefix);
     const issue3 = yield* findIssueInProject(c, targetProject, targetIssueStr);
@@ -193004,7 +193091,7 @@ var removeTemplateChild = (params) => Effect_exports.gen(function* () {
       project: params.project
     });
   }
-  const removedChild = template.children[childIndex];
+  const removedChild = assertAt(template.children, childIndex);
   const newChildren = template.children.filter((_, i) => i !== childIndex);
   yield* client.updateDoc(
     tracker.class.IssueTemplate,
@@ -193865,7 +193952,10 @@ var categorySummaryFor = (category) => ({
 });
 var placeholderFieldIds = (markdown) => {
   const regexp = new RegExp(import_templates.templateFieldRegexp.source, import_templates.templateFieldRegexp.flags);
-  const ids3 = [...markdown.matchAll(regexp)].map((match16) => match16[1]).filter((id, index, allIds) => id.length > 0 && allIds.indexOf(id) === index);
+  const ids3 = [...markdown.matchAll(regexp)].flatMap((match16) => {
+    const id = assertAt(match16, 1);
+    return [id];
+  }).filter((id, index, allIds) => id.length > 0 && allIds.indexOf(id) === index);
   return ids3.map((id) => TemplateFieldId.make(id));
 };
 var markdownForTemplate = (template, client) => MessageTemplateMarkdown.make(markupToMarkdownString(template.message, client.markupUrlConfig));
@@ -193913,7 +194003,7 @@ var resolveCategory2 = (client, identifier2) => Effect_exports.gen(function* ()
       matches: Count.make(matches.length)
     });
   }
-  return matches[0];
+  return assertAt(matches, 0);
 });
 var categoryMapFor = (client, categoryIds) => Effect_exports.gen(function* () {
   const diagnostics = yield* Diagnostics;
@@ -193986,7 +194076,7 @@ var resolveTemplate = (client, params) => Effect_exports.gen(function* () {
       matches: Count.make(matches.length)
     });
   }
-  return matches[0];
+  return assertAt(matches, 0);
 });
 var resolveFieldCategory = (client, identifier2) => Effect_exports.gen(function* () {
   const byId = yield* client.findOne(
@@ -194008,7 +194098,7 @@ var resolveFieldCategory = (client, identifier2) => Effect_exports.gen(function*
       matches: Count.make(matches.length)
     });
   }
-  return matches[0];
+  return assertAt(matches, 0);
 });
 var fieldCategoryMapFor = (client, categoryIds) => Effect_exports.gen(function* () {
   const diagnostics = yield* Diagnostics;
@@ -195257,14 +195347,17 @@ var getTimeReport = (params) => Effect_exports.gen(function* () {
     { _id: { $in: employeeIds } }
   ) : [];
   const personMap = new Map(persons.map((p) => [p._id, p.name]));
-  const timeReports = reports.map((r) => ({
-    id: TimeSpendReportId.make(r._id),
-    identifier: IssueIdentifier.make(issue2.identifier),
-    employee: r.employee && personMap.has(r.employee) ? PersonName.make(personMap.get(r.employee)) : void 0,
-    date: r.date,
-    value: r.value,
-    description: r.description
-  }));
+  const timeReports = reports.map((r) => {
+    const employeeName = r.employee == null ? void 0 : personMap.get(r.employee);
+    return {
+      id: TimeSpendReportId.make(r._id),
+      identifier: IssueIdentifier.make(issue2.identifier),
+      employee: employeeName === void 0 ? void 0 : PersonName.make(employeeName),
+      date: r.date,
+      value: r.value,
+      description: r.description
+    };
+  });
   return {
     identifier: IssueIdentifier.make(issue2.identifier),
     totalTime: issue2.reportedTime,
@@ -195386,7 +195479,7 @@ var listWorkSlots = (params) => Effect_exports.gen(function* () {
         contact.class.Channel,
         { value: params.employeeId }
       );
-      if (channels.length > 0) {
+      if (isNonEmpty7(channels)) {
         const channel = channels[0];
         query.user = refAsPersonId(channel.attachedTo);
       }
@@ -195895,7 +195988,7 @@ var resolveProcess = (client, identifier2) => Effect_exports.gen(function* () {
   const matches = [...allProcesses].filter(
     (process4) => normalizeForComparison(process4.name) === normalizeForComparison(identifier2)
   );
-  if (matches.length === 1) return matches[0];
+  if (isSingle2(matches)) return matches[0];
   const data = yield* loadProcessDefinitionData(client, matches.length === 0 ? [...allProcesses] : matches);
   const candidates = data.map(processCandidate);
   return yield* matches.length === 0 ? Effect_exports.fail(new ProcessNotFoundError({ identifier: identifier2, candidates })) : Effect_exports.fail(new ProcessIdentifierAmbiguousError({ identifier: identifier2, candidates }));
@@ -195911,7 +196004,7 @@ var resolveMasterTag = (client, identifier2) => Effect_exports.gen(function* ()
   const matches = allTags.filter(
     (tag2) => normalizeForComparison(masterTagLabel(tag2) ?? "") === normalizeForComparison(identifier2)
   );
-  if (matches.length === 1) return matches[0]._id;
+  if (isSingle2(matches)) return matches[0]._id;
   if (matches.length === 0) {
     return yield* looksLikeMasterTagId(identifier2) ? Effect_exports.succeed(toRef(identifier2)) : Effect_exports.fail(new ProcessMasterTagNotFoundError({ identifier: identifier2 }));
   }
@@ -195929,7 +196022,7 @@ var resolveCardFilter = (client, identifier2) => Effect_exports.gen(function* ()
   const byId = yield* client.findOne(cardPlugin.class.Card, { _id: toRef(identifier2) });
   if (byId !== void 0) return byId._id;
   const byTitle = yield* client.findAll(cardPlugin.class.Card, { title: identifier2 });
-  if (byTitle.length === 1) return byTitle[0]._id;
+  if (isSingle2(byTitle)) return byTitle[0]._id;
   if (byTitle.length > 1) {
     return yield* Effect_exports.fail(
       new ProcessCardIdentifierAmbiguousError({
@@ -196006,8 +196099,8 @@ var listProcesses = (params) => Effect_exports.gen(function* () {
 var getProcess = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
   const process4 = yield* resolveProcess(client, params.process);
-  const [data] = yield* loadProcessDefinitionData(client, [process4]);
-  const [states, transitions] = yield* Effect_exports.all([
+  const [masterTags, states, transitions] = yield* Effect_exports.all([
+    findMasterTagsByIds(client, [process4.masterTag]),
     client.findAll(
       processPlugin.class.State,
       { process: process4._id },
@@ -196019,7 +196112,14 @@ var getProcess = (params) => Effect_exports.gen(function* () {
       { sort: { rank: import_core66.SortingOrder.Ascending } }
     )
   ]);
-  const result = processDetail({ ...data, states: [...states], transitions: [...transitions] });
+  const result = processDetail({
+    process: process4,
+    masterTagName: masterTags.get(process4.masterTag)?.name,
+    stateCount: states.length,
+    transitionCount: transitions.length,
+    states: [...states],
+    transitions: [...transitions]
+  });
   return yield* encodeOrConnectionError(ProcessDetailSchema, result, "getProcess");
 });
 var listExecutions = (params) => Effect_exports.gen(function* () {
@@ -196794,7 +196894,7 @@ var resolveVacancy = (client, identifier2) => Effect_exports.gen(function* () {
       matches: Count.make(byName.length)
     });
   }
-  return byName[0];
+  return assertAt(byName, 0);
 });
 var findApplicant = (client, applicantIdentifier, vacancy, candidate) => Effect_exports.gen(function* () {
   const byId = yield* client.findOne(
@@ -196823,7 +196923,7 @@ var findApplicant = (client, applicantIdentifier, vacancy, candidate) => Effect_
       matches: Count.make(applicants.length)
     });
   }
-  return applicants[0];
+  return assertAt(applicants, 0);
 });
 var applicantRefFromDoc = (client, applicant) => Effect_exports.gen(function* () {
   const vacancy = yield* client.findOne(recruitIds.class.Vacancy, { _id: applicant.space });
@@ -197520,7 +197620,7 @@ var findReview = (client, identifier2, candidate, application) => Effect_exports
   if (reviews.length > 1) {
     return yield* new RecruitingReviewIdentifierAmbiguousError({ identifier: identifier2, matches: Count.make(reviews.length) });
   }
-  return reviews[0];
+  return assertAt(reviews, 0);
 });
 var resolveReviewLocator = (client, params) => Effect_exports.gen(function* () {
   const candidate = yield* optionalCandidate(client, params.candidate);
@@ -197700,7 +197800,7 @@ var findOpinion = (client, identifier2, review) => Effect_exports.gen(function*
   if (opinions.length > 1) {
     return yield* new RecruitingOpinionIdentifierAmbiguousError({ identifier: identifier2, matches: Count.make(opinions.length) });
   }
-  return opinions[0];
+  return assertAt(opinions, 0);
 });
 var resolveReview = (client, review) => review === void 0 ? Effect_exports.succeed(void 0) : findReview(client, review);
 var parentReviewFromOpinion = (client, opinion) => findReview(client, ReviewIdentifier.make(String(opinion.attachedTo)));
@@ -198253,7 +198353,14 @@ var resolveRelatedIssue = (params) => Effect_exports.gen(function* () {
       reason: "issue locator without project must use a full project-prefixed identifier like HULY-123"
     });
   }
-  const { client, project: project3 } = yield* findProject(match16[1].toUpperCase());
+  const [, projectIdentifier] = match16;
+  if (projectIdentifier === void 0) {
+    return yield* new RecruitingIssueLocatorInvalidError({
+      issue: params.issue,
+      reason: "issue locator without project must use a full project-prefixed identifier like HULY-123"
+    });
+  }
+  const { client, project: project3 } = yield* findProject(projectIdentifier.toUpperCase());
   const issue2 = yield* findIssueInProject(client, project3, params.issue);
   return { client, issue: issue2, project: project3 };
 });
@@ -199026,7 +199133,8 @@ var findSpaceType = (client, identifier2) => Effect_exports.gen(function* () {
       }))
     });
   }
-  return byName[0];
+  if (isSingle2(byName)) return byName[0];
+  return yield* new SpaceTypeNotFoundError({ identifier: NonEmptyString2.make(identifier2) });
 });
 var permissionsByIds = (client, permissionIds) => Effect_exports.gen(function* () {
   const uniqueIds = sortStrings([...new Set(permissionIds)]);
@@ -199650,7 +199758,7 @@ var resolveSpaceRole = (client, spaceType, role) => Effect_exports.gen(function*
       }))
     });
   }
-  return matches[0];
+  return assertAt(matches, 0);
 });
 var findSpaceTypeRoles = (client, spaceType) => client.findAll(
   roleClass,
@@ -200239,7 +200347,7 @@ var resolveProjectType = (client, projectTypeRef) => Effect_exports.gen(function
   const selected = projectTypeRef === void 0 ? projectTypes.filter(isDefaultClassicProjectType) : projectTypes.filter(
     (projectType) => projectType._id === projectTypeRef || normalizeForComparison(projectType.name) === normalizeForComparison(projectTypeRef)
   );
-  if (selected.length === 1) {
+  if (isSingle2(selected)) {
     return selected[0];
   }
   const message = projectTypeRef === void 0 ? "Could not select a default Classic project type unambiguously; pass projectType by ID or name." : `Project type '${projectTypeRef}' did not resolve to exactly one project type.`;
@@ -200249,7 +200357,7 @@ var resolveTaskType = (taskTypes, taskTypeRef) => {
   const selected = taskTypes.filter(
     (taskType) => taskType._id === taskTypeRef || normalizeForComparison(taskType.name) === normalizeForComparison(taskTypeRef)
   );
-  return selected.length === 1 ? Effect_exports.succeed(selected[0]) : Effect_exports.fail(new HulyError({ message: `Task type '${taskTypeRef}' did not resolve to exactly one task type.` }));
+  return isSingle2(selected) ? Effect_exports.succeed(selected[0]) : Effect_exports.fail(new HulyError({ message: `Task type '${taskTypeRef}' did not resolve to exactly one task type.` }));
 };
 var existingTaskTypeByName = (taskTypes, name) => taskTypes.find((taskType) => normalizeForComparison(taskType.name) === normalizeForComparison(name));
 var existingStatusByName = (statuses, name) => statuses.find((status) => normalizeForComparison(status.name) === normalizeForComparison(name));
@@ -200270,6 +200378,7 @@ var replaceOrAppendProjectStatus = (statuses, statusId, taskTypeId) => statuses.
 var sameStatusRefList = (left3, right3) => left3.length === right3.length && left3.every((value3, index) => value3 === right3[index]);
 var sameProjectStatusList = (left3, right3) => left3.length === right3.length && left3.every((value3, index) => {
   const rightValue = right3[index];
+  if (rightValue === void 0) return false;
   return sameProjectStatus(value3, rightValue);
 });
 var listProjectTypes = (_params) => Effect_exports.gen(function* () {
@@ -202637,7 +202746,7 @@ var toClientCompatibleInputSchema = (schema) => {
     Object.entries(schema).filter(([key]) => key !== "type" && !ROOT_COMPOSITION_KEYS.has(key))
   );
   const properties = mergedSchemaField(schema, "properties");
-  const defs = mergedSchemaField(schema, "$defs");
+  const defs = collectJsonSchemaDefinitions(schema);
   return {
     ...rootFields,
     type: "object",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@firfi/huly-mcp",
-  "version": "0.38.0",
-  "description": "MCP server for Huly integration",
+  "version": "0.39.0",
+  "description": "Huly MCP: feature-complete MCP server for Huly integration",
   "mcpName": "io.github.dearlordylord/huly-mcp",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -118,7 +118,7 @@
     "check-format": "find src test -name '*.ts' -print0 | xargs -0 eslint --rule '@effect/dprint: error'",
     "check-all": "pnpm build && pnpm typecheck && pnpm circular && pnpm verify-registry-metadata && pnpm verify-sdk-parity && pnpm verify-readme && pnpm lint && pnpm test:coverage",
     "circular": "madge --extensions ts --circular src",
-    "local-release": "pnpm dlx @changesets/cli@2.30.0 version && pnpm sync-registry-metadata && git add package.json CHANGELOG.md server.json .changeset && (git diff --cached --quiet || HUSKY=0 git commit -m \"RELEASING: Releasing 1 package(s)\") && PKG_VERSION=$(node -p \"require('./package.json').version\") && pnpm dlx esbuild@0.27.2 src/index.ts --bundle --platform=node --format=cjs --outfile=dist/index.cjs --external:ws \"--define:PKG_VERSION=\\\"$PKG_VERSION\\\"\" && pnpm verify-version && npm_config_ignore_scripts=true pnpm dlx @changesets/cli@2.30.0 publish",
+    "local-release": "pnpm dlx @changesets/cli@2.30.0 version && pnpm sync-registry-metadata && git add package.json CHANGELOG.md server.json .changeset && (git diff --cached --quiet || HUSKY=0 git commit -m \"RELEASING: Releasing 1 package(s)\") && PKG_VERSION=$(node -p \"require('./package.json').version\") && pnpm dlx esbuild@0.27.2 src/index.ts --bundle --platform=node --format=cjs --outfile=dist/index.cjs --external:ws \"--define:PKG_VERSION=\\\"$PKG_VERSION\\\"\" && pnpm verify-version && npm_config_ignore_scripts=true pnpm dlx @changesets/cli@2.30.0 publish && git push origin \"v$PKG_VERSION\" && gh release create \"v$PKG_VERSION\" --generate-notes --latest",
     "verify-version": "node -e \"const v=require('./package.json').version; const d=require('fs').readFileSync('dist/index.cjs','utf8'); if(!d.includes('\\\"'+v+'\\\"'))throw new Error('dist version mismatch: expected '+v)\"",
     "verify-registry-metadata": "node scripts/sync-registry-metadata.mjs --check",
     "verify-sdk-parity": "node scripts/audit-sdk-parity.mjs",